diff --git a/translations/de-DE/content/actions/building-and-testing-code-with-continuous-integration/about-continuous-integration.md b/translations/de-DE/content/actions/building-and-testing-code-with-continuous-integration/about-continuous-integration.md deleted file mode 100644 index 0f714487e451..000000000000 --- a/translations/de-DE/content/actions/building-and-testing-code-with-continuous-integration/about-continuous-integration.md +++ /dev/null @@ -1,62 +0,0 @@ ---- -title: Informationen zur fortlaufenden Integration -intro: 'Sie können benutzerdefinierte Continuous Integration (CI) und Continuous Deployment (CD)-Workflows direkt in Ihrem {% data variables.product.prodname_dotcom %} Repository mit {% data variables.product.prodname_actions %}erstellen.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/about-continuous-integration - - /github/automating-your-workflow-with-github-actions/about-continuous-integration - - /actions/automating-your-workflow-with-github-actions/about-continuous-integration -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Informationen zur fortlaufenden Integration - -Bei der Softwarepraktik der fortlaufenden Integration (CI) erfolgen häufige Code-Commits an ein gemeinsames Repository. Code-Commits in kurzen Abständen tragen dazu bei, Fehler frühzeitiger aufzudecken, und verringern die Codemenge, die ein Entwickler auf der Suche nach der Fehlerursache debuggen muss. Durch häufige Code-Aktualisierungen lassen sich zudem Änderungen von verschiedenen Mitgliedern eines Software-Entwicklungsteams leichter zusammenführen. Dies bedeutet einen erheblichen Vorteil für die Entwickler, die sich damit stärker auf das Schreiben des Codes konzentrieren können, statt Fehler debuggen oder Mergekonflikte beheben zu müssen. - -Durch einen Code-Commit an das Repository können Sie den Code fortlaufend erstellen und testen, sodass gewährleistet ist, dass der Commit keine Fehler einbringt. Die Tests können beispielsweise Code-Linters (überprüfen Stilformatierungen), Sicherheitsprüfungen, Code-Abdeckung, Funktionstests und andere benutzerdefinierte Prüfungen umfassen. - -Zum Erstellen und Testen des Codes ist ein Server erforderlich. Sie können Aktualisierungen lokal erstellen und testen, bevor Sie den Code per Push an ein Repository senden, oder auch einen CI-Server heranziehen, der neue Code-Commits in einem Repository prüft. - -### Informationen zur kontinuierlichen Integration mit {% data variables.product.prodname_actions %} - -CI mit {% data variables.product.prodname_actions %} bietet Workflows, die den Code in Ihrem Repository erstellen und Ihre Tests ausführen können. Workflows können auf {% data variables.product.prodname_dotcom %}gehosteten virtuellen Maschinen oder auf Computern ausgeführt werden, die Sie selbst hosten. Weitere Informationen finden Sie unter "[Virtuelle Umgebungen für {% data variables.product.prodname_dotcom %}gehostete Läufer](/actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)" und "[über selbst gehostete Läufer](/actions/automating-your-workflow-with-github-actions/about-self-hosted-runners)". - -Sie können Ihren CI-Workflow so konfigurieren, dass er ausgeführt wird, wenn ein {% data variables.product.product_name %} Ereignis auftritt (z. B. wenn neuer Code an Ihr Repository übertragen wird), nach einem festgelegten Zeitplan oder wenn ein externes Ereignis mithilfe des Repository-Dispatch-Webhooks auftritt. - -{% data variables.product.product_name %} führt die CI-Tests aus und stellt die Ergebnisse jedes Tests in der Pullanforderung bereit, sodass Sie sehen können, ob die Änderung in Ihrem Zweig einen Fehler verursacht. Sobald alle CI-Tests in einem Workflow bestanden wurden, können die per Push übermittelten Änderungen von einem Teammitglied geprüft oder zusammengeführt werden. Wenn ein Test nicht bestanden wird, liegt die Ursache eventuell in einer Ihrer Änderungen. - -Wenn Sie CI in Ihrem Repository einrichten, analysiert {% data variables.product.product_name %} den Code in Ihrem Repository und empfiehlt CI-Workflows basierend auf der Sprache und dem Framework in Ihrem Repository. Wenn Sie beispielsweise [Node.js](https://nodejs.org/en/)verwenden, schlägt {% data variables.product.product_name %} eine Vorlagendatei vor, die Ihre Node.js-Pakete installiert und Ihre Tests ausführt. Sie können die von {% data variables.product.product_name %}vorgeschlagene CI-Workflowvorlage verwenden, die vorgeschlagene Vorlage anpassen oder eine eigene benutzerdefinierte Workflowdatei zum Ausführen der CI-Tests erstellen. - -![Screenshot mit vorgeschlagenen Vorlagen für die fortlaufende Integration](/assets/images/help/repository/ci-with-actions-template-picker.png) - -Sie können nicht nur ci-Workflows für Ihr Projekt einrichten, sondern auch {% data variables.product.prodname_actions %} verwenden, um Workflows über den gesamten Softwareentwicklungslebenszyklus hinweg zu erstellen. Sie können Ihr Projekt beispielsweise mithilfe von Aktionen bereitstellen, packen oder veröffentlichen. Weitere Informationen finden Sie unter "[über {% data variables.product.prodname_actions %}](/articles/about-github-actions)". - -Eine Definition von gebräuchliche Begriffe finden Sie unter "[Kernkonzepte für {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)". - -### Unterstützte Sprachen - -{% data variables.product.product_name %} bietet CI-Workflowvorlagen für eine Vielzahl von Sprachen und Frameworks. - -Weitere Informationen findest Du unter „[Einen Workflow konfigurieren](/articles/configuring-a-workflow)“. - -### Benachrichtigungen für Workflow-Läufe - -{% data reusables.repositories.workflow-notifications %} - -### Status-Badges für Workflow-Läufe - -{% data reusables.repositories.actions-workflow-status-badge-into %} - -Weitere Informationen finden Sie unter „[Einen Workflow konfigurieren](/articles/configuring-a-workflow)“. - -### Weiterführende Informationen - -- "[Einrichtung einer kontinuierlichen Integration mit {% data variables.product.prodname_actions %}](/articles/setting-up-continuous-integration-using-github-actions)" -{% if currentVersion == "free-pro-team@latest" %} -- „[Abrechnung für {% data variables.product.prodname_actions %} verwalten](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)“ -{% endif %} diff --git a/translations/de-DE/content/actions/building-and-testing-code-with-continuous-integration/index.md b/translations/de-DE/content/actions/building-and-testing-code-with-continuous-integration/index.md deleted file mode 100644 index 70945050c850..000000000000 --- a/translations/de-DE/content/actions/building-and-testing-code-with-continuous-integration/index.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: Code mittels kontinuierlicher Integration bauen und testen -shortTitle: Kontinuierliche Integration -intro: 'Du kannst {% data variables.product.prodname_actions %} verwenden, um in Deinem Repository angepasste Workflows für kontinuierliche Integration (CI) und kontinuierliches Deployment (CD) zu erstellen.' -redirect_from: - - /articles/setting-up-continuous-integration-on-github - - /github/automating-your-workflow-with-github-actions/setting-up-continuous-integration-on-github - - /github/automating-your-workflow-with-github-actions/creating-continuous-integration-workflows - - /actions/automating-your-workflow-with-github-actions/creating-continuous-integration-workflows -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -{% link_in_list /about-continuous-integration %} -{% link_in_list /setting-up-continuous-integration-using-github-actions %} diff --git a/translations/de-DE/content/actions/building-and-testing-code-with-continuous-integration/setting-up-continuous-integration-using-github-actions.md b/translations/de-DE/content/actions/building-and-testing-code-with-continuous-integration/setting-up-continuous-integration-using-github-actions.md deleted file mode 100644 index 788e236febd7..000000000000 --- a/translations/de-DE/content/actions/building-and-testing-code-with-continuous-integration/setting-up-continuous-integration-using-github-actions.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Fortlaufende Integration mit GitHub Actions einrichten -intro: 'Du kannst die fortlaufende Integration für Dein Projekt mithilfe einer Workflow-Vorlage einrichten, die der Sprache und den Tools entspricht, die Du verwenden möchtest.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/setting-up-continuous-integration-using-github-actions - - /github/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions - - /actions/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -Jeder Benutzer mit Schreibberechtigung für ein Repository kann mit {% data variables.product.prodname_actions %} eine fortlaufende Integration (CI) einrichten. - -Nach der Einrichtung der CI können Sie den Workflow an Ihre Bedürfnisse anpassen. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -3. Wähle die Vorlage aus, die der Sprache und den Tools entspricht, die Du verwenden möchtest, und klicke dann auf **Set up this workflow** (Diesen Workflow einrichten). ![Schaltfläche „Setup workflow“ (Workflow einrichten)](/assets/images/help/repository/setup-workflow-button.png) -5. Klicke auf **Start commit** (Commit starten). ![Schaltfläche „Start commit“ (Commit starten)](/assets/images/help/repository/start-commit.png) -{% data reusables.files.write_commit_message %} -{% data reusables.files.choose_commit_branch %} -{% data reusables.files.propose_new_file %} - -Sobald ein Push an Ihr Repository erfolgt ist, können Sie den Status und die detaillierten Protokolle Ihres fortlaufenden Integrationsworkflows verfolgen, der auf {% data variables.product.prodname_dotcom %} ausgeführt wird, und angepasste Benachrichtigungen erhalten. Weitere Informationen findest Du unter „[Benachrichtigungen konfigurieren](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)“ und „[Workflowausführung verwalten](/articles/managing-a-workflow-run)“. - -{% data reusables.repositories.actions-workflow-status-badge-into %} - -Weitere Informationen finden Sie unter „[Einen Workflow konfigurieren](/articles/configuring-a-workflow)“. - -### Weiterführende Informationen - -- „[Informationen zur kontinuierlichen Integration](/articles/about-continuous-integration)“ -- „[Einen Workflow-Lauf verwalten](/articles/managing-a-workflow-run)“ -{% if currentVersion == "free-pro-team@latest" %} -- „[Abrechnung für {% data variables.product.prodname_actions %} verwalten](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)“ -{% endif %} diff --git a/translations/de-DE/content/actions/configuring-and-managing-workflows/about-service-containers.md b/translations/de-DE/content/actions/configuring-and-managing-workflows/about-service-containers.md deleted file mode 100644 index 54cb8149c7f2..000000000000 --- a/translations/de-DE/content/actions/configuring-and-managing-workflows/about-service-containers.md +++ /dev/null @@ -1,116 +0,0 @@ ---- -title: Informationen zu Service-Containern -intro: 'Du kannst Service-Container verwenden, um Datenbanken, Webdienste, Speicher-Caches und andere Tools mit Deinem Workflow zu verbinden.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/about-service-containers -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Informationen zu Service-Containern - -Service-Container sind Docker-Container, die Dir eine einfache und portable Möglichkeit bieten, Dienste zu hosten, um Deine Anwendung in einem Workflow zu testen oder zu betreiben. Beispielsweise muss Dein Workflow möglicherweise Integrationstests ausführen, die Zugriff auf eine Datenbank und einen Speicher-Cache erfordern. - -Du kannst Service-Container für jeden Job in einem Workflow konfigurieren. Für jeden Service, der im Workflow konfiguriert ist, erstellt {% data variables.product.prodname_dotcom %} einen neuen Docker-Container und löscht den Service Container, wenn der Auftrag abgeschlossen ist. Steps (Schritte) in einem Job können mit allen Service-Containern kommunizieren, die Teil des gleichen Jobs sind. - -{% data reusables.github-actions.docker-container-os-support %} - -### Mit Service-Containern kommunizieren - -Du kannst Jobs in einem Workflow so konfigurieren, dass sie direkt auf einer Runner-Maschine oder in einem Docker-Container laufen. Die Kommunikation zwischen einem Job und seinen Service-Containern ist unterscherschiedlich, je nachdem, ob ein Job direkt auf der Runner-Maschine oder in einem Container läuft. - -#### Jobs in einem Container ausführen - -Wenn Du Jobs in einem Container ausführst, verbindet {% data variables.product.prodname_dotcom %} die Service-Container mit dem Job über die benutzerdefinierten Bridge-Netzwerke von Docker. Weitere Informationen findest Du unter "[Bridge-Netzwerke verwenden](https://docs.docker.com/network/bridge/)" in der Docker-Dokumentation. - -Jobs und der Services in einem Container laufen zu lassen, vereinfacht den Netzwerkzugriff. Du kannst auf einen Service-Container mittels des Labels (Bezeichnung) zugreifen, den Du im Workflow konfigurierst. Der Hostname des Service-Containers wird automatisch dem Labelnamen zugeordnet. Wenn Du z.B. einen Service-Container mit der Bezeichnung `Redis` erstellst, ist auch der Hostname des Service-Containers `Redis`. - -Du brauchst für Service-Container keine Ports zu konfigurieren. Standardmäßig machen alle Container, die Teil desselben Docker-Netzwerks sind, alle Ports füreinander verfügbar, und außerhalb des Docker-Netzwerks werden keine Ports verfügbar gemacht. - -#### Jobs auf der Runner-Maschine ausführen - -Wenn Du Jobs direkt auf der Runner-Maschine ausführst, kannst Du auf Service-Container mit `localhost:` oder `127.0.0.1:` zugreifen. {% data variables.product.prodname_dotcom %} konfiguriert das Container-Netzwerk, um die Kommunikation vom Service-Container zum Docker-Host zu ermöglichen. - -Wenn ein Job direkt auf einer Runner-Maschine läuft, macht der im Docker-Container laufende Dienst seine Ports nicht standardmäßig dem Job auf dem Runner verfügbar. Du musst Ports auf dem Service-Container dem Docker Host zuordnen. Weitere Informationen findest Du unter "[Ports auf Docker-Host und Service-Container zuordnen](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)." - -### Service-Container erstellen - -Du kannst das Schlüsselwort `Services` verwenden, um Service-Container zu erstellen, die Teil eines Jobs in Deinem Workflow sind. Weitere Informationen findest Du unter [`jobs..services`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idservices). - -Dieses Beispiel erstellt einen Dienst namens `redis` in einem Job namens `container-job`. Der Docker-Host in diesem Beispiel ist der Container `node:10.18-jessie`. - -{% raw %} -```yaml -name: Redis container example -on: push - -jobs: - # Label des Container-Jobs - container-job: - # Container müssen in Linux-basierten Betriebssystemen laufen - runs-on: ubuntu-latest - # Docker-Hub-Image in dem `container-job` laeuft - container: node:10.18-jessie - - # Service-Container, mit denen `container-job` laeuft - services: - # Label zum Zugriff auf den Service--Container - redis: - # Docker-Hub-Image - image: redis -``` -{% endraw %} - -### Ports von Docker-Host und Service-Container zuordnen - -Wenn Dein Job in einem Docker-Container läuft, brauchst Du keine Ports auf dem Host oder dem Service-Container zuzuordnen. Wenn Dein Job direkt auf der Runner-Maschine läuft, musst Du alle benötigten Service-Container-Ports zu Ports der Host-Runner-Maschine zuordnen. - -Du kannst Service-Container-Ports mit Hilfe des Schlüsseworts `ports` dem Docker-Host zuordnen. Weitere Informationen findest Du unter [`jobs..services`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idservices). - -| Wert von `ports` | Beschreibung | -| ---------------- | ----------------------------------------------------------------------------------------------- | -| `8080:80` | Ordnet TCP-Port 80 im Container dem Port 8080 auf dem Docker-Host zu. | -| `8080:80/udp` | Ordnet UDP-Port 80 im Container dem Port 8080 auf dem Docker-Host zu. | -| `8080/udp` | Ordnet einen zufällig gewählten UDP-Port im Container dem UDP-Port 8080 auf dem Docker-Host zu. | - -Wenn Du Ports mittels `ports` zuordnest, publiziert {% data variables.product.prodname_dotcom %} die Ports des Containers auf dem Docker-Host mit dem Befehl `--publish`. Weitere Informationen findest Du unter "[Vernetzung von Docker-Containern](https://docs.docker.com/config/containers/container-networking/)" in der Docker Dokumentation. - -Wenn Du den Port des Docker-Hosts angibst, aber nicht den des Containers, dann wird der Container-Port zufällig einem freien Port zugewiesen. {% data variables.product.prodname_dotcom %} setzt den zugewiesenen Container-Port im Kontext des Service-Containers. Wenn Du beispielsweise den Port 5432 für den Docker-Host konfiguriert hast, kannst Du für einen Service Container `redis` mit dem Kontext code>job.services.redis.ports[5432] auf den entsprechenden Port des Containers zugreifen. Weitere Informationen findest Du unter "[Kontext- und Ausdrucks-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions#job-context)." - -#### Beispiel zur Zuordnung von Redis-Ports - -Dieses Beispiel ordnet den Port 6379 des Service-Containers `redis` dem Port 6379 des Docker-Hosts zu. - -{% raw %} -```yaml -name: Redis Service Example -on: push - -jobs: - # Label des Container-Jobs - runner-job: - # Fuer Service-Containers oder Container-Jobs musst Du eine Linux-Umgebung benutzen - runs-on: ubuntu-latest - - # Service-Container, die mit `runner-job` laufen sollen - services: - # Label zum Zugriff auf den Service-Container - redis: - # Docker-Hub-Image - image: redis - # - ports: - # Oeffnet TCP-Port 6379 auf dem Host und Service-Container - - 6379:6379 -``` -{% endraw %} - -### Weiterführende Informationen - -- "[Redis-Service-Container erstellen](/actions/automating-your-workflow-with-github-actions/creating-redis-service-containers)" -- "[PostgreSQL-Service-Container erstellen](/actions/automating-your-workflow-with-github-actions/creating-postgresql-service-containers)" diff --git a/translations/de-DE/content/actions/configuring-and-managing-workflows/authenticating-with-the-github_token.md b/translations/de-DE/content/actions/configuring-and-managing-workflows/authenticating-with-the-github_token.md deleted file mode 100644 index 46285fb099dd..000000000000 --- a/translations/de-DE/content/actions/configuring-and-managing-workflows/authenticating-with-the-github_token.md +++ /dev/null @@ -1,99 +0,0 @@ ---- -title: Authentifizieren mit dem „GITHUB_TOKEN“ -intro: '{% data variables.product.prodname_dotcom %} stellt ein Token zur Verfügung, mit dem Du Dich im Namen von {% data variables.product.prodname_actions %} authentifizieren kannst.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /github/automating-your-workflow-with-github-actions/authenticating-with-the-github_token - - /actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -Jeder mit `write`(schreiben)-Zugriff auf ein Repository kann Geheimnisse erstellen, lesen und verwenden. - -### Informationen zum `GITHUB_TOKEN`-Geheimnis - -{% data variables.product.prodname_dotcom %} erstellt automatisch ein `GITHUB_TOKEN`-Geheimnis für Deinen Workflow. Du kannst den `GITHUB_TOKEN` verwenden, um Dich in einem Workflow zu authentifizieren. - -Wenn Du {% data variables.product.prodname_actions %} aktivierst, installiert {% data variables.product.prodname_dotcom %} eine {% data variables.product.prodname_github_app %} in Deinem Repository. Das `GITHUB_TOKEN`-Geheimnis ist ein {% data variables.product.prodname_github_app %}-Token für Installations-Zugriff. Du kannst das Installationszugriffs-Token verwenden, um Dich im Namen der auf Deinem Repository installierten {% data variables.product.prodname_github_app %} zu authentifizieren. Die Berechtigungen des Tokens sind auf das Repository beschränkt, in dem sich der Workflow befindet. Weitere Informationen findest Du unter "[Berechtigungen für das `GITHUB_TOKEN`](#permissions-for-the-github_token)." - -Bevor jeder Auftrag beginnt, ruft {% data variables.product.prodname_dotcom %} ein Installationszugriffstoken für den Auftrag ab. Das Token läuft ab, wenn der Auftrag abgeschlossen ist. - -Das Token ist auch im `github.token`-Kontext verfügbar. Weitere Informationen findest Du unter "[Kontext- und Ausdrucks-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)". - -### Das `GITHUB_TOKEN` in einem Workflow verwenden - -Um das `GITHUB_TOKEN`-Geheimnis zu verwenden, musst Du es in Deiner Workflow-Datei referenzieren. Hierbei musst Du das Token ggf. als Eingabe für eine Aktion übergeben, für die dieses Token erforderlich ist, oder authentifizierte Aufrufe der {% data variables.product.prodname_dotcom %}-API ausführen. - -{% data reusables.github-actions.actions-do-not-trigger-workflows %} - -#### Beispiel: Das `GITHUB_TOKEN` als Eingabe übergeben - -Dieser Beispielworkflow verwendet die [Labeler-Aktion](https://github.com/actions/labeler), wofür das `GITHUB_TOKEN` als Wert für den Eingabeparameter `repo-token` benötigt wird: - - {% raw %} - ```yaml - name: Pull request labeler - on: - - pull_request - jobs: - triage: - runs-on: ubuntu-latest - steps: - - uses: actions/labeler@v2 - with: - repo-token: ${{ secrets.GITHUB_TOKEN }} - ``` - {% endraw %} - -#### Beispiel zum Aufrufen der REST-API - -Du kannst das `GITHUB_TOKEN` verwenden, um authentifizierte API-Aufrufe durchzuführen. Dieser Beispiel-Workflow erzeugt eine Lieferung („issue“) mittels der {% data variables.product.prodname_dotcom %}-REST-API: - - {% raw %} - ```yaml - name: Create issue on commit - on: - - push - jobs: - create_commit: - runs-on: ubuntu-latest - steps: - - name: Create issue using REST API - run: | - curl --request POST \ - --url https://api.github.com/repos/${{ github.repository }}/issues \ - --header 'authorization: Bearer ${{ secrets.GITHUB_TOKEN }}' \ - --header 'content-type: application/json' \ - --data '{ - "title": "Automated issue for commit: ${{ github.sha }}", - "body": "This issue was automatically created by the GitHub Action workflow **${{ github.workflow }}**. \n\n Der Commit-Hash lautete: _'{{ github.sha }}_." - }' - ``` - {% endraw %} - -### Berechtigungen für das `GITHUB_TOKEN` - -Informationen zu den API-Endpunkten, auf die {% data variables.product.prodname_github_apps %} mit jeder Berechtigung zugreifen können, finden Sie unter "[{% data variables.product.prodname_github_app %} Berechtigungen](/v3/apps/permissions/)". - -| Berechtigung | Zugriffstyp | Zugriff durch geforktes Repository | -| ------------------------ | --------------- | ---------------------------------- | -| actions | Lesen/Schreiben | Lesen | -| checks (Prüfungen) | Lesen/Schreiben | Lesen | -| contents (Inhalte) | Lesen/Schreiben | Lesen | -| deployments | Lesen/Schreiben | Lesen | -| Issues (Lieferungen) | Lesen/Schreiben | Lesen | -| Metadaten | Lesen | Lesen | -| Pakete | Lesen/Schreiben | Lesen | -| pull requests | Lesen/Schreiben | Lesen | -| repository projects | Lesen/Schreiben | Lesen | -| statuses (Statusangaben) | Lesen/Schreiben | Lesen | - -Wenn Du ein Token benötigst, für das Berechtigungen erforderlich sind, die nicht im `GITHUB_TOKEN`-Geheimnis vorhanden sind, kannst Du ein persönliches Zugangstoken erstellen und als Geheimnis im Repository festlegen: - -1. Verwende oder erstelle ein Token mit den entsprechenden Berechtigungen für dieses Repository. Weitere Informationen finden Sie unter "[Erstellen eines persönlichen Zugriffstokens](/github/authenticating-to-github/creating-a-personal-access-token)." -1. Füge das Token als Geheimnis in das Repository Deines Workflows ein, und verweise darauf mit der Syntax {%raw%}`${{ secrets.SECRET_NAME }}`{% endraw %}. Weitere Informationen findest Du unter "[Verschlüsselte Geheimnisse erstellen und verwenden](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". diff --git a/translations/de-DE/content/actions/configuring-and-managing-workflows/caching-and-storing-workflow-data.md b/translations/de-DE/content/actions/configuring-and-managing-workflows/caching-and-storing-workflow-data.md deleted file mode 100644 index d39697f10425..000000000000 --- a/translations/de-DE/content/actions/configuring-and-managing-workflows/caching-and-storing-workflow-data.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Workflow-Daten speichern und zwischenspeichern -intro: 'Abhängigkeiten zwischenspeichern und Artefakte speichern, um Deinen Workflow effizienter ablaufen zu lassen.' -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/de-DE/content/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows.md b/translations/de-DE/content/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows.md deleted file mode 100644 index 9deec460f114..000000000000 --- a/translations/de-DE/content/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows.md +++ /dev/null @@ -1,190 +0,0 @@ ---- -title: Abhängigkeiten zwischenspeichern um Workflows zu beschleunigen -intro: 'Um Deine Workflows schneller und effizienter zu gestalten, kannst Du Caches für Abhängigkeiten und andere häufig wiederverwendete Dateien erstellen und verwenden.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /github/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows - - /actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows -versions: - free-pro-team: '*' ---- - -### Informationen zum Zwischenspeichern von Workflow-Abhängigkeiten - -Workflow-Läufe verwenden häufig dieselben Ausgaben oder heruntergeladenen Abhängigkeiten in aufeinanderfolgenden Durchläufen. Tools zur Verwaltung von Paketen und Abhängigkeiten wie beispielsweise Maven, Gradle, npm und Yarn halten einen lokalen Cache mit heruntergeladenen Abhängigkeiten. - -Jobs bei {% data variables.product.prodname_dotcom %}-gehosteten Läufern beginnen in einer sauberen virtuellen Umgebung und müssen Abhängigkeiten jedes Mal herunterladen. Dies führt zu erhöhter Netzwerkauslastung, längerer Laufzeit und erhöhten Kosten. Um die Zeit zum Neuerstellen dieser Dateien einzusparen, kann {% data variables.product.prodname_dotcom %} in Workflows häufig verwendete Abhängigkeiten zwischenspeichern. - -Um Abhängigkeiten für einen Job zu cachen, musst du die `Cache`-Aktion von {% data variables.product.prodname_dotcom %} verwenden. Die Aktion ruft einen Cache ab, der durch einen eindeutigen Schlüssel identifiziert wurde. Weitere Informationen findest Du unter [`Aktionen/Cache`](https://github.com/actions/cache). - -{% warning %} - -**Warnung**: Wir empfehlen Ihnen, keine sensiblen Informationen im Cache von öffentlichen Repositories zu speichern. Sensible Informationen umfassen beispielsweise Zugriffstoken oder Anmeldedaten, die in einer Datei im Cache-Pfad gespeichert sind. Auch Kommandozeilen-Programme (CLI) wie `docker login` können Zugangsdaten in einer Konfigurationsdatei speichern. Jeder mit Lesezugriff kann einen Pull-Request auf ein Repository erstellen und auf den Inhalt des Caches zugreifen. Forks eines Repositorys können auch Pull-Requests auf den base branch (Basiszweig) erstellen und auf Caches im Basiszweig zugreifen. - -{% endwarning %} - -### Vergleich: Artefakte v/s Zwischenspeicherung von Abhängigkeiten - -Artefakte und Caching sind ähnlich, da sie die Möglichkeit bieten, Dateien auf {% data variables.product.prodname_dotcom %} zu speichern, aber die beiden Funktionalitäten bieten verschiedene Anwendungsfälle und dürfen nicht miteinander verwechselt werden. - -- Verwende Caching, wenn Du Dateien wiederverwenden willst, die sich zwischen Jobs oder Workflow-Läufen nicht oft ändern. -- Verwende Artefakte, wenn Du die von einem Job erzeugten Dateien speichern willst, um sie nach dem Ende eines Workflows anzuzeigen. Weitere Informationen findest Du unter "[Workflow-Daten mittels Artefakten persistieren](/github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)." - -### Einschränkungen für den Zugriff auf einen Cache - -Mit `v2-` der `Cache-` -Aktion können Sie in Workflows auf den Cache zugreifen, die von jedem Ereignis ausgelöst werden, das über eine `GITHUB_REF`verfügt. Wenn Sie `v1-` der `-Cache-` -Aktion verwenden, können Sie nur in Workflows auf den Cache zugreifen, `durch pushen` - und `pull_request` -Ereignisse ausgelöst werden, mit Ausnahme des `pull_request` `` -Ereignis geschlossen. Weitere Informationen findest Du unter "[Ereignisse, die Workflows auslösen](/actions/reference/events-that-trigger-workflows)." - -Ein Workflow kann auf einen Cache zugreifen und ihn wiederherstellen, wenn dieser im aktuellen Zweig, im Basis-Zweig (einschließlich Basiszweige von geforkten Repositories) oder im Standard-Zweig (normalerweise `master`) erstellt wurde. Zum Beispiel wäre ein Cache, der auf dem Standardzweig `master` erstellt wurde, von beliebigen Pull-Requests zugänglich. Ebenso, wenn der Zweig `feature-b` den Basiszweig `feature-a` hat, hätte ein auf `feature-b` angestoßener Workflow Zugriff auf Caches, die im Standard-Zweig code>master), `feature-a` und `feature-b` erstellt wurden. - -Zugriffsbeschränkungen bieten Cache-Isolation und Sicherheit durch Ziehen einer logischen Grenze zwischen verschiedenen Workflows und Zweigen. Beispielsweise wäre ein für den Zweig `feature-a` (mit der Basis `master`) erstellter Cache für eine Pull-Anfrage auf den Zweig `feature-b` (mit der Basis `master`) nicht zugreifbar. - -### Verwenden der `-Cache-` -Aktion - -Die Aktion `-cache-` wird versuchen, einen Cache basierend auf dem `key` (Schlüssel), den Du angibst, wiederherzustellen. Wenn die Aktion einen Cache findet, stellt die Aktion die zwischengespeicherten Dateien in dem `path` wieder her, den Du konfigurierst. - -Wenn es keine exakte Übereinstimmung gibt, erzeugt die Aktion einen neuen Cache-Eintrag, wenn der Job erfolgreich abgeschlossen wird. Der neue Cache wird den `key` verwenden, den Du angegeben hast, und enthält die Dateien im Verzeichnis `path`. - -Optional kannst Du eine Liste von `restore-keys` angeben, die verwendet werden sollen, wenn der `key` nicht mit einem vorhandenen Cache übereinstimmt. Eine Liste der `restore-keys` ist nützlich, wenn Du einen Cache aus einem anderen Zweig wiederherstellst, da `restore-keys` auch teilweise mit Cache-Schlüsseln übereinstimmen dürfen. Weitere Informationen zum Abgleich von `restore-keys`, siehe "[Einen Cache-Schlüssel abgleichen](#matching-a-cache-key)." - -Weitere Informationen findest Du unter [`Aktionen/Cache`](https://github.com/actions/cache). - -#### Eingabeparameter für die `-Cache-` -Aktion - -- `key`: **Erforderlich** Der Schlüssel, der beim Speichern eines Caches erstellt wurde, und der Schlüssel, der zum Suchen nach einem Cache verwendet wird. Kann eine beliebige Kombination von Variablen, Kontextwerten, statischen Strings und Funktionen sein. Schlüssel haben eine maximale Länge von 512 Zeichen und Schlüssel, die die maximale Länge überschreiten, lassen die Aktion fehlschlagen. -- `path`: **Erforderlich** Der Dateipfad auf dem Runner zum Anlegen oder Wiederherstellen des Caches. Der Pfad kann ein absoluter Pfad oder relativ zum Arbeitsverzeichnis sein. - - Mit `v2-` der `-Cache-` -Aktion können Sie einen einzelnen Pfad oder mehrere Pfade als Liste angeben. Pfade können entweder Verzeichnisse oder einzelne Dateien sein, und Glob-Muster werden unterstützt. - - Bei `v1-` der `-Cache-` -Aktion wird nur ein einzelner Pfad unterstützt, und es muss sich um ein Verzeichnis handeln. Eine einzelne Datei kannst Du nicht cachen. -- `restore-keys`: **Optional** Eine geordnete Liste der alternativen Schlüssel, die zum Finden des Caches verwendet werden sollen, falls `key` keinen Treffer gebracht hat. - -#### Ausgangsparameter für die Cache-Aktion - -- `Cache-Treffer`: Ein boolescher Wert, um eine genaue Übereinstimmung für den Schlüssel anzugeben. - -#### Beispiel für die Verwendung der `-Cache-` -Aktion - -Dieses Beispiel erzeugt einen neuen Cache, wenn sich die Pakete in `package-lock.json` ändern oder wenn das Betriebssystem des Runners wechselt. Das folgende Beispiel verwendet Kontexte und Ausdrücke, um einen Schlüssel zu erzeugen, der eine Kennung des Runner-Betriebssystems und einen SHA-256-Hash der Datei `package-lock.json` enthält. - -{% raw %} -```yaml -name: Caching mit npm - -on: push - -jobs: - build: - runs-on: ubuntu-latest - - schritte: - - verwendet: actions/checkout@v2 - - - name: Cache node modules - uses: actions/cache@v2 - env: - cache-name: cache-node-modules - with: - -npm-Cache-Dateien werden in ''/.npm' auf dem Linux/macOS- - -Pfad gespeichert: '/.npm - -Schlüssel: '{{ runner.os }}-build-'{{ env.cache-name }}-' hashFiles('**/package-lock.json') ' - Restore-Keys: | - -{{ runner.os }}-build--{{ env.cache-name }}- - -{{ runner.os }}-build- - -{{ runner.os }}- - - - Name: Installieren sie abhängigkeiten - ausführen: npm install - - - Name: Build - ausführen: npm build - - - Name: Test - -Test: npm-Test - -``` -{% endraw %} - -Wenn `key` mit einem existierenden Cache übereinstimmt, wird das als „cache hit“ (Cache-Treffer) bezeichnet, und die Aktion stellt die zwischengespeicherten Dateien wieder her und legt sie in den `path`. - -Wenn `key` nicht mit einem existierenden Cache übereinstimmt, wird das als „cache miss“ (Cache-Fehlschlag) bezeichnet. Wenn der Job erfolgreich abgeschlossen ist, wird ein neuer Cache erstellt. Wenn ein Cache-Fehlschlag auftritt, sucht die Aktion mittels der alternativen Schlüssel gemäß `restore-keys` weiter. - -1. Wenn du `restore-keys` bereitstellst, sucht die `cache`-Aktion sequentiell nach Caches, die mit der Liste `restore-keys` übereinstimmen. - - Wenn es eine exakte Übereinstimmung gibt, stellt die Aktion die Dateien aus dem Cache in das Verzeichnis `path` wieder her. - - Wenn es keine exakten Übereinstimmungen gibt, sucht die Aktion nach partiellen Übereinstimmungen der „restore keys“ (Wiederherstellungs-Scvhlüssel). Wenn die Aktion eine partielle Übereinstimmung findet, wird der aktuellste Cache in das Verzeichnis `path` wiederhergestellt. -1. Die `Cache-` Aktion abgeschlossen wird, und der nächste Workflowschritt im Auftrag wird ausgeführt. -1. Wenn der Job erfolgreich abgeschlossen ist, erstellt die Aktion einen neuen Cache mit dem Inhalt des Verzeichnisses `path`. - -Um Dateien in mehr als einem Verzeichnis zu cachen, benötigst Du einen step (Schritt), der die Aktion [`cache`](https://github.com/actions/cache) für jedes Verzeichnis verwendet. Sobald Du einen Cache erstellt hast, kannst Du den Inhalt eines bereits existierenden Caches nicht ändern, aber Du kannst einen neuen Cache mit einem neuen key (Schlüssel) erstellen. - -#### Cache-Keys aus Kontexten erstellen - -Ein Cache-Key (Cache-Schlüssel) kann Kontexte, Funktionen, Literale und Operatoren enthalten, die von {% data variables.product.prodname_actions %} unterstützt werden. Weitere Informationen findest Du unter "[Kontext- und Ausdrucks-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)". - -Wenn Du zum Erstellen eines `key`s Ausdrücke verwendest, kannst Du automatisch einen neuen Cache zu erstellen, sobald sich die Abhängigkeiten geändert haben. Zum Beispiel kannst Du einen `key` mittels eines Ausdrucks erstellen, der den Hash-Code einer npm-Datei `package-lock.json` errechnet. - -{% raw %} -``` -npm-${{ hashFiles('package-lock.json') }} -``` -{% endraw %} - -{% data variables.product.prodname_dotcom %} wertet den Ausdruck aus `hash "package-lock.json"` um daraus den endgültigen `key` abzuleiten. - -``` -npm-d5ea0750 -``` - -### Einen Cache-Key abgleichen - -Der `-Cache` Aktion sucht zuerst nach Cachetreffern nach `Schlüssel` und `Wiederherstellungsschlüssel n` in der Verzweigung, die die Workflowausführung enthält. Wenn in der aktuellen Verzweigung keine Treffer vorhanden sind, sucht der `-Cache` Aktion nach `Schlüssel` und `Wiederherstellungsschlüssel, die in den übergeordneten Zweigen und vorgelagerten Zweigen` . - -Du kannst eine Liste der `restore-keys` angeben, die verwendet werden sollen, wenn auf `key` ein Cache-Fehler auftritt. Du kannst mehrere `restore-keys` erstellen, die von den spezifischsten zum am wenigsten spezifischen sortiert sind. Die Aktion `cache` sucht nach `restore-keys` in sequenzieller Reihenfolge. Wenn ein Schlüssel nicht direkt übereinstimmt, sucht die Aktion nach Schlüsseln denen der Restore-Key vorangestellt ist. Wenn mehrere Teiltreffer für einen Restore-Key vorhanden sind, gibt die Aktion den zuletzt erstellten Cache zurück. - -#### Beispiel für die Verwendung mehrerer Restore-Keys - -{% raw %} -``` -restore-keys: | - npm-foobar-${{ hashFiles('package-lock.json') }} - npm-foobar- - npm- -``` -{% endraw %} - -Der Runner bewertet die Ausdrücke, die sich in folgende `restore-keys` auflösen lassen: - -{% raw %} -``` -restore-keys: | - npm-foobar-d5ea0750 - npm-foobar- - npm- -``` -{% endraw %} - -Der Restore-Key `npm-foobar-` passt auf jeden Schlüssel, der mit dem String `npm-foobar-` beginnt. Zum Beispiel passen zu ihm die beiden Schlüssel `npm-foobar-fd3052de` und `npm-foobar-a9b253ff`. Der Cache mit dem neuesten Erstellungsdatum wird verwendet. Die Schlüssel in diesem Beispiel werden in der folgenden Reihenfolge durchsucht: - -1. **`npm-foobar-d5ea0750`** passt zu einem bestimmten Hash. -1. **`npm-foobar-`** deckt alle Cache-Schlüssel ab, die mit `npm-foobar-` beginnen. -1. **`npm-`** deckt alle Cache-Schlüssel ab, die mit `npm-` beginnen. - -##### Beispiel für die Suchpriorität - -```yaml -key: - npm-feature-d5ea0750 -restore-keys: | - npm-feature- - npm- -``` - -Wenn zum Beispiel ein Pull-Request einen Zweig `feature` enthält (der aktuelle Zweig) und auf den Standardzweig (`Master`) abzielt, sucht die Aktion in der folgenden Reihenfolge nach `key` und `restore-keys`: - -1. Schlüssel `npm-feature-d5eaa0750` im Zweig `feature` -1. Schlüssel `npm-feature-` im Zweig `feature` -2. Schlüssel `npm-` im Zweig `feature` -1. Schlüssel `npm-feature-d5eaa0750` im Zweig `master` -3. Schlüssel `npm-feature-` im Zweig `master` -4. Schlüssel `npm-` im Zweig `master` - -### Nutzungsbeschränkungen und Räumungsrichtlinien - -{% data variables.product.prodname_dotcom %} wird alle Cache-Einträge entfernen, auf die seit mehr als 7 Tagen nicht zugegriffen wurde. Es gibt keine Grenze für die Anzahl der Caches, die du speichern kannst, aber die Gesamtgröße aller Caches in einem Repository ist auf 5 GB begrenzt. Wenn du dieses Limit überschreitest, wird {% data variables.product.prodname_dotcom %} deinen Cache speichern, aber damit beginnen, Caches zu löschen, bis die Gesamtgröße kleiner als 5 GB ist. diff --git a/translations/de-DE/content/actions/configuring-and-managing-workflows/configuring-a-workflow.md b/translations/de-DE/content/actions/configuring-and-managing-workflows/configuring-a-workflow.md deleted file mode 100644 index 8d6be9cc12b4..000000000000 --- a/translations/de-DE/content/actions/configuring-and-managing-workflows/configuring-a-workflow.md +++ /dev/null @@ -1,465 +0,0 @@ ---- -title: Konfigurieren eines Workflows -intro: 'Sie können benutzerdefinierte Workflows erstellen, um die Lebenszyklusprozesse der Softwareentwicklung Ihres Projekts zu automatisieren.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/creating-a-github-action/ - - /articles/creating-a-workflow-with-github-actions/ - - /articles/configuring-a-workflow - - /github/automatisieren-ihren-workflow-mit-github-aktionen/configuring-a-workflow - - /actions/automating-your-workflow-with-github-actions/configuring-a-workflow - - /actions/creating-workflows/workflow-configuration-options -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -Personen mit Schreib- oder Administratorberechtigungen für ein Repository können Workflows erstellen, bearbeiten oder anzeigen. - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Informationen zu Workflows - -Workflows sind benutzerdefinierte automatisierte Prozesse, die Sie in Ihrem Repository einrichten können, um ein Projekt auf {% data variables.product.prodname_dotcom %}zu erstellen, zu testen, zu verpacken, freizugeben oder bereitzustellen. Mit Workflows können Sie Ihren Softwareentwicklungslebenszyklus mit einer Vielzahl von Tools und Services automatisieren. Weitere Informationen finden Sie unter "[über {% data variables.product.prodname_actions %}](/articles/about-github-actions)". - -Sie können mehr als einen Workflow in einem Repository erstellen. Sie müssen Workflows im `.github/workflows` Verzeichnis im Stammverzeichnis Ihres Repositorys speichern. - -Workflows müssen über mindestens einen Auftrag verfügen, und Aufträge enthalten eine Reihe von Schritten, die einzelne Aufgaben ausführen. Steps können Befehle ausführen oder eine Aktion verwenden. Sie können eigene Aktionen erstellen oder Aktionen verwenden, die von der {% data variables.product.prodname_dotcom %} Community gemeinsam genutzt werden, und sie nach Bedarf anpassen. - -Sie können einen Workflow so konfigurieren, dass er gestartet wird, wenn ein {% data variables.product.prodname_dotcom %} Ereignis, nach einem Zeitplan oder von einem externen Ereignis aus auftritt. - -Sie müssen Workflows mithilfe der YAML-Syntax konfigurieren und als Workflowdateien in Ihrem Repository speichern. Nachdem Sie erfolgreich eine YAML-Workflowdatei erstellt und den Workflow ausgelöst haben, werden die Buildprotokolle, Testergebnisse, Artefakte und Status für jeden Schritt Ihres Workflows angezeigt. Weitere Informationen finden Sie unter "[Verwalten eines Workflows, der](/articles/managing-a-workflow-run)ausgeführt wird." - - ![Annotiertes Workflow-Ausführungsbild](/assets/images/help/repository/annotated-workflow.png) - -Sie können auch Benachrichtigungen für Workflowstatusaktualisierungen erhalten. Weitere Informationen zu Benachrichtigungsoptionen finden Sie unter "[Konfigurieren von Benachrichtigungen](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)". - -Nutzungsbeschränkungen gelten für einzelne Workflows. Weitere Informationen finden Sie unter "[Verwendungsgrenzen für Workflows](/articles/workflow-syntax-for-github-actions#usage-limits)." - -### Erstellen einer Workflowdatei - -Auf einer hohen Ebene sind dies die Schritte zum Hinzufügen einer Workflowdatei. Spezifische Konfigurationsbeispiele finden Sie in den folgenden Abschnitten. - -1. Erstellen Sie im Stammverzeichnis Ihres Repositorys ein Verzeichnis mit dem Namen `.github/workflows` , um Ihre Workflowdateien zu speichern. - -1. Fügen Sie in `.github/workflows`eine `.yml-` oder `.yaml-` -Datei für Ihren Workflow hinzu. Beispielsweise `.github/workflows/continuous-integration-workflow.yml`. - -1. Verwenden Sie die "[Workflowsyntax für {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions)" Referenzdokumentation, um Ereignisse auszuwählen, um eine Aktion auszulösen, Aktionen hinzuzufügen und Ihren Workflow anzupassen. - -1. Übertragen Sie Ihre Änderungen in der Workflowdatei an die Verzweigung, in der der Workflow ausgeführt werden soll. - -#### Beispiel für Workflowdateien - -{% raw %} -```yaml -name: Greet Everyone -- Dieser Workflow wird bei Pushes in das Repository ausgelöst. -on: [push] - -Jobs: - build: - ' Jobname ist Greeting - name: Greeting - ' Dieser Job läuft unter Linux - läuft auf: ubuntu-latest - steps: - - Dieser Schritt verwendet GitHubs hello-world-javascript-action: https://github.com/actions/hello-world-javascript-action - - Name: Hello world - verwendet: actions/hello-world-javascript-action@v1.1 - mit: - who-to-greet: 'Mona the Octocat' - id: hello - - Dieser Schritt druckt eine Ausgabe (Zeit) von der Aktion des vorherigen Schritts. - - Name: Echo der Begrüßungszeit - Laufen: Echo 'Die Zeit war '{{ steps.hello.outputs.time }}.' -``` -{% endraw %} - -{% data reusables.github-actions.invalid-workflow-files %} - -### Auslösen eines Workflows mit Ereignissen - -Sie können einen Workflow so konfigurieren, dass er einmal gestartet wird: -- Ein Ereignis auf {% data variables.product.prodname_dotcom %} tritt auf, z. B. wenn jemand einen Commit an ein Repository überträgt oder wenn ein Problem oder eine Pull-Anforderung erstellt wird. -- Ein geplantes Ereignis beginnt. -- Ein externes Ereignis tritt auf. - -Um einen Workflow auszulösen, nachdem ein Ereignis auf {% data variables.product.prodname_dotcom %}passiert, fügen Sie `zu:` und einen Ereigniswert nach dem Workflownamen hinzu. Dieser Workflow wird beispielsweise ausgelöst, wenn Änderungen an eine Verzweigung im Repository übertragen werden. - -```yaml -Name: descriptive-workflow-name -on: push -``` - -Zum Planen eines Workflows können Sie die POSIX-Cron-Syntax in Ihrer Workflowdatei verwenden. Das kürzeste Intervall, in dem Sie geplante Workflows ausführen können, ist einmal alle 5 Minuten. Dieser Workflow wird z. B. stündlich ausgelöst. - -```yaml -zu: - Zeitplan: - - cron: '0 * * * *' -``` - -#### Manuelle Ausführung eines Workflows - -Um einen Workflow manuell auszuführen, müssen Sie zuerst den Workflow so konfigurieren, dass er das `workflow_dispatch` -Ereignis verwendet. Sie können benutzerdefinierte Eingabeeigenschaften, Standardeingabewerte und erforderliche Eingaben direkt in Ihrem Workflow konfigurieren. Wenn der Workflow ausgeführt wird, können Sie auf die Eingabewerte im `github.event.inputs` Kontextzugreifen. Weitere Informationen finden Sie unter "[Ereignisse, die Workflows](/actions/reference/events-that-trigger-workflows/#workflow_dispatch)auslösen" und "[Kontext- und Ausdruckssyntax für {% data variables.product.prodname_dotcom %} Aktionen](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)." - -In diesem Beispiel wird der `Name` definiert und ein- und `zu Hause verwendet, und sie werden mit den Kontexten github.event.inputs.name` und `github.event.inputs.home` gedruckt. Wenn ein `Name` nicht angegeben wird, wird der Standardwert 'Mona the Octocat' gedruckt. - -{% raw %} -```yaml -Name: Manuell ausgelöster Workflow -auf: - workflow_dispatch: - Eingaben: - Name: - Beschreibung: 'Person zu grüßen' - erforderlich: true - Standard: 'Mona the Octocat' - Home: - Beschreibung: 'Standort' - erforderlich: falsche - -Jobs: - say_hello: - läuft auf: ubuntu-latest - Schritte: - - laufen: | - Echo "Hallo{{ github.event.inputs.name }}!" - echo "- in{{ github.event.inputs.home }}!" -``` -{% endraw %} - -Sie können das `workflow_dispatch` -Ereignis über die Registerkarte Aktionen auf {% data variables.product.prodname_dotcom %} oder mithilfe der REST-API auslösen. Weitere Informationen zur Verwendung der REST-API finden Sie unter "[Erstellen eines Workflow-Dispatch-Ereignisses](/rest/reference/actions/#create-a-workflow-dispatch-event)." Wenn Sie die REST-API verwenden, konfigurieren Sie die `eingaben` und `ref` als Anforderungstextparameter. Wenn die Eingaben weggelassen werden, werden die in der Workflowdatei definierten Standardwerte verwendet. - -Um das `workflow_dispatch` Ereignis auf {% data variables.product.prodname_dotcom %}auszulösen, muss sich Ihr Workflow in der Standardverzweigung befinden. Führen Sie die folgenden Schritte aus, um eine Workflowausführung manuell auszulösen. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -1. Klicken Sie in der linken Seitenleiste auf den Workflow, den Sie ausführen möchten. ![Aktionen auswählen Workflow](/assets/images/actions-select-workflow.png) -1. Wählen Sie über der Liste der Workflowausführungen **Workflow ausführen**. ![Aktionsworkflow-Dispatch](/assets/images/actions-workflow-dispatch.png) -1. Wählen Sie die Verzweigung aus, in der der Workflow ausgeführt wird, und geben Sie die Eingabeparameter ein, die vom Workflow verwendet werden. Klicken Sie auf **Workflow ausführen**. ![Aktionen manuell ausgeführt Workflow](/assets/images/actions-manually-run-workflow.png) - -#### Auslösen von Workflows aus externen Ereignissen - -Um einen Workflow auszulösen, nachdem ein externes Ereignis auftritt, können Sie ein `repository_dispatch` Webhook-Ereignis aufrufen, indem Sie den REST-API-Endpunkt "Erstellen eines Repository-Dispatch-Ereignisses" aufrufen. Weitere Informationen finden Sie unter "[Erstellen eines Repository-Dispatchereignisses](/v3/repos/#create-a-repository-dispatch-event)." - -Weitere Informationen und Beispiele finden Sie unter "[Ereignisse, die Workflows](/articles/events-that-trigger-workflows#webhook-events)auslösen". - -### Filtern nach bestimmten Zweigen, Tags und Pfaden - -Sie können Ihren Workflow so einrichten, dass er nur für bestimmte Verzweigungen ausgeführt wird. - -Dieser Workflow wird z. B. ausgeführt, wenn ein Push, der Dateien im `Test` Verzeichnis enthält, auf dem `Master-` -Zweig ausgeführt wird oder an das `v1-` -Tag überführt wird. - -```yaml -auf: - push: - verzweigt: - - Master- - -Tags: - - v1 - - Dateipfade, die im Ereignis zu berücksichtigen sind. Optional; Standardeinstellungen für alle. - Pfade: - - 'test/*' -``` - -Weitere Informationen zur Zweig-, Tag- und Pfadfiltersyntax finden Sie unter "[`weiter..`](/articles/workflow-syntax-for-github-actions#onpushpull_requestbranchestags)" und "[`weiter..paths`](/articles/workflow-syntax-for-github-actions#onpushpull_requestpaths)." - -### Die Wahl eines Läufers - -Sie können Workflows auf {% data variables.product.prodname_dotcom %}-gehosteten Läufern oder selbst gehosteten Läufern ausführen. Aufträge können direkt auf dem Computer oder in einem Docker-Container ausgeführt werden. - -Sie können den Läufer für jeden Auftrag in einem Workflow mithilfe `ausläuften`angeben. Weitere Informationen zu `ausgeführten`finden Sie unter "[Workflowsyntax für {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idruns-on)". - -{% data reusables.actions.enterprise-github-hosted-runners %} - -#### Verwenden eines {% data variables.product.prodname_dotcom %}-gehosteten Läufers - -Sie können aus verschiedenen Typen und Versionen virtueller Host-Maschinen auswählen, einschließlich Linux, Windows und macOS. Jeder Auftrag in einem Workflow wird in einer neuen Instanz der virtuellen Umgebung ausgeführt, und Schritte innerhalb eines Auftrags können Informationen mithilfe des Dateisystems freigeben. Weitere Informationen finden Sie unter "virtuelle Umgebungen für {% data variables.product.prodname_actions %}gehostete Läufer" -.

- -Sie können z. B. `neuesten` verwenden, um die neueste Version eines Ubuntu- {% data variables.product.prodname_dotcom %}-gehosteten Läufers anzugeben. - - - -```yaml -Runs-on: ubuntu-latest -``` - - - - -#### Verwenden eines selbst gehosteten Läufers - -Sie können Beschriftungen verwenden, um Aufträge an bestimmte Arten von selbst gehosteten Läufern weiterzuleiten. Alle selbst gehosteten Läufer erhalten die `selbst gehosteten` Label und jeder selbst gehostete Läufer hat Labels für sein Betriebssystem und seine Systemarchitektur. Weitere Informationen finden Sie unter "[Verwenden von selbst gehosteten Läufern in einem Workflow](/actions/automating-your-workflow-with-github-actions/using-self-hosted-runners-in-a-workflow)." - -Wenn Sie beispielsweise einen selbst gehosteten Läufer mit einem Linux-Betriebssystem und einer ARM32-Architektur hinzugefügt haben, können Sie diesen Läufer mithilfe der `selbst gehosteten`, `Linux-`und `ARM32-` -Beschriftungen auswählen. - - - -```yaml -Runs-on: [selbst gehostet, linux, ARM32] -``` - - - - -### Konfigurieren einer Buildmatrix - -Um mehrere Betriebssysteme, Plattformen und Sprachversionen gleichzeitig zu testen, können Sie eine Buildmatrix konfigurieren. - -Mit einer Buildmatrix können Sie Ihren Code mit unterschiedlichen Software- und Betriebssystemkonfigurationen testen. Ein Workflow kann z. B. einen Auftrag für mehr als eine unterstützte Version einer Sprache, eines Betriebssystems oder eines Tools ausführen. Für jede Konfiguration wird eine Kopie des Auftrags ausgeführt und ein Status meldet. - -Sie können eine Buildmatrix in Ihrer Workflowdatei mit einem Array angeben, das die Konfigurationsoptionen unter `Strategie auflistet:`. Diese Buildmatrix führt z. B. einen Auftrag mit verschiedenen Versionen von Node.js und Ubuntu, einem Linux-Betriebssystem, aus. - -{% data reusables.repositories.actions-matrix-builds-os %} - -{% raw %} - - -```yaml -{{ matrix.os }} --Strategie: - Matrix: - os: [ubuntu-16.04, ubuntu-18.04] - Knoten: [6, 8, 10] -``` - - -{% endraw %} - -Weitere Informationen finden Sie unter "[Workflowsyntax für {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix)." - - - -### Verwenden der Auscheckaktion - -Es gibt mehrere Standardaktionen, die Sie in Ihrem Workflow verwenden können. Die Auscheckaktion ist eine Standardaktion, die Sie in Ihren Workflow einbeziehen müssen, bevor andere Aktionen ausgeführt werden, wenn: - -- Ihr Workflow erfordert eine Kopie des Codes Ihres Repositorys, z. B. beim Erstellen und Testen des Repositorys oder mithilfe einer kontinuierlichen Integration. -- Es gibt mindestens eine Aktion in Ihrem Workflow, die im selben Repository definiert ist. Weitere Informationen finden Sie unter "[Verweisen auf Aktionen in Ihrem Workflow](#referencing-actions-in-your-workflow)." - -Um die Standard-Checkout-Aktion ohne weitere Spezifikationen zu verwenden, fügen Sie diesen Schritt hinzu: - - -```yaml -- verwendet: Aktionen/checkout@v2 -``` - - -Durch die Verwendung `v2-` in diesem Beispiel wird sichergestellt, dass Sie eine stabile Version der Auscheckaktion verwenden. Weitere Informationen finden Sie unter [der](https://github.com/actions/checkout). - - - -### Auswählen des Typs der Aktionen für Ihren Workflow - -Es gibt verschiedene Arten von Aktionen, die Sie in Ihrem Workflow verwenden können, um den Anforderungen Ihres Projekts gerecht zu werden: - -- Docker-Containeraktionen -- JavaScript-Aktionen -- Zusammengesetzte Ausführungsschritte Aktionen - -Weitere Informationen finden Sie unter "[über Aktionen](/articles/about-actions#types-of-actions)". - -Wenn Sie die Art der Aktionen auswählen, die in Ihrem Workflow verwendet werden sollen, empfehlen wir, vorhandene Aktionen in öffentlichen Repositorys oder auf Docker Hub zu untersuchen und diese Aktionen möglicherweise an Ihr Projekt anzupassen. - -Sie können Aktionen durchsuchen und verwenden, die von {% data variables.product.prodname_dotcom %} in der [github.com/actions](https://github.com/actions) -Organisation erstellt wurden. Informationen zum Besuch von Docker Hub finden Sie unter "[Docker Hub](https://www.docker.com/products/docker-hub)" auf der Docker-Site. - - - -### Verweisen auf Aktionen in Ihrem Workflow - -Um Aktionen in Ihrer Workflowdatei mit der richtigen Syntax zu referenzieren, müssen Sie berücksichtigen, wo die Aktion definiert ist. - -Workflows können Aktionen verwenden, die in: - -- Ein öffentliches Repository -- Das gleiche Repository, in dem Ihre Workflowdatei auf die Aktionen verweist -- Ein veröffentlichtes Docker-Containerimage auf Docker Hub - -Um eine in einem privaten Repository definierte Aktion zu verwenden, müssen sich sowohl die Workflowdatei als auch die Aktion im selben Repository befinden. Ihr Workflow kann keine Aktionen verwenden, die in anderen privaten Repositorys definiert sind, auch wenn sich das andere private Repository in derselben Organisation befindet. - -Um Ihren Workflow auch dann stabil zu halten, wenn Aktualisierungen an einer Aktion vorgenommen werden, können Sie auf die Version der Aktion verweisen, die Sie verwenden, indem Sie in Ihrer Workflowdatei eine Git-Ref- oder Docker-Tag-Nummer angeben. Beispiele finden Sie unter "[Workflowsyntax für {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idstepsuses)". - -{% if currentVersion == "free-pro-team@latest" %} - - - -{% data reusables.dependabot.version-updates-for-actions %} - - - -{% endif %} - -Ausführlichere Konfigurationsoptionen finden Sie unter "[Workflowsyntax für {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)". - - - -#### Verweisen auf eine Aktion aus einem öffentlichen Repository - -Wenn eine Aktion in einem öffentlichen Repository definiert ist, müssen Sie auf die Aktion verweisen, indem Sie die Syntax `{owner}/{repo}{ref}` oder `{owner}/{repo}/{path}-{ref}`verwenden. - - - -```yaml -jobs: - my_first_job: - Name: Mein Jobname - Schritte: - - verwendet: aktionen/setup-node@v1 - mit: - Node-Version: 10.x -``` - - -Ein vollständiges Workflowbeispiel finden Sie im [Setupknoten](https://github.com/actions/setup-node) Vorlagen-Repository. - - - -#### Verweisen auf eine Aktion im selben Repository, in dem eine Workflowdatei die Aktion verwendet - -Wenn eine Aktion im selben Repository definiert ist, in dem Ihre Workflowdatei die Aktion verwendet, können Sie auf die Aktion mit der`{owner}/{repo}-{ref}` oder `./path/to/dir-` Syntax in ihrer Workflowdatei verweisen. - -Beispiel-Repository-Dateistruktur: - - - -``` -|-- hello-world (Repository) -| |__ .github -| Workflows -| My-First-Workflow.yml -| • Maßnahmen -| |__ hello-world-action -| • action.yml -``` - - -Beispiel-Workflowdatei: - - - -```yaml -jobs: - build: - läuft auf: ubuntu-latest - Schritte: - - Dieser Schritt checkt eine Kopie Ihres Repositorys aus. - - verwendet: actions/checkout@v2 - - Dieser Schritt verweist auf das Verzeichnis, das die Aktion enthält. - - verwendet: ./.github/actions/hello-world-action -``` - - - - -#### Verweisen auf einen Container auf Docker Hub - -Wenn eine Aktion in einem veröffentlichten Docker-Containerimage auf Docker Hub definiert ist, müssen Sie auf die Aktion mit der `docker://{image}:{tag}` Syntax in Ihrer Workflowdatei verweisen. Zum Schutz Ihres Codes und Ihrer Daten wird dringend empfohlen, die Integrität des Docker-Containerimages von Docker Hub zu überprüfen, bevor Sie es in Ihrem Workflow verwenden. - - - -```yaml -jobs: - my_first_job: - Schritte: - - Name: Mein erster Schritt - verwendet: docker://alpine:3.8 -``` - - -Einige Beispiele für Docker-Aktionen finden Sie im [Docker-image.yml-Workflow](https://github.com/actions/starter-workflows/blob/master/ci/docker-image.yml) und "[Erstellen einer Docker-Containeraktion](/articles/creating-a-docker-container-action)." - -Weitere Informationen finden Sie unter "[Workflowsyntax für {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idstepsuses)." - - - -### Hinzufügen eines Workflowstatus-Badges zu Ihrem Repository - -{% data reusables.repositories.actions-workflow-status-badge-into %} - -Wenn Ihr Workflow den `Namen` Schlüsselwort verwendet, müssen Sie auf den Workflow anhand des Namens verweisen. Wenn der Name Ihres Workflows Leerraum enthält, müssen Sie das Leerzeichen durch die URL codierte Zeichenfolge `%20`ersetzen. Weitere Informationen zum Schlüsselwort `Name` finden Sie unter "[Workflowsyntax für {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#name)". - - - -``` -https://github.com///Workflows//badge.svg -``` - - -Wenn Ihr Workflow keinen `Namen`hat, müssen Sie auch auf die Workflowdatei verweisen, indem Sie den Dateipfad relativ zum Stammverzeichnis des Repositorys verwenden. - -{% note %} - -**Hinweis:** Verweisen auf die Workflowdatei mithilfe des Dateipfads funktioniert nicht, wenn der Workflow einen `Namen`hat. - -{% endnote %} - - - -``` -https://github.com///Workflows//badge.svg -``` - - - - -#### Beispiel für die Verwendung eines Workflownamens - -In diesem Markdown-Beispiel wird ein Status-Badge für einen Workflow mit dem Namen "Greet Everyone" hinzugefügt. Die `owner` des Repositorys sind die `Aktionen` Organisation, und der name `REPOSITORY` ist `hello-world`. - - - -``` -! [Beispiel-Workflowname] (https://github.com/actions/hello-world/workflows/Greet%20Everyone/badge.svg) -``` - - - - -#### Beispiel für die Verwendung eines Workflowdateipfads - -In diesem Markdown-Beispiel wird ein Status-Badge für einen Workflow mit dem Dateipfad `.github/workflows/main.yml`hinzugefügt. Die `owner` des Repositorys sind die `Aktionen` Organisation, und der name `REPOSITORY` ist `hello-world`. - - - -``` -! [Beispiel Workflowdateipfad] (https://github.com/actions/hello-world/workflows/.github/workflows/main.yml/badge.svg) -``` - - - - -#### Beispiel für die Verwendung des `-Zweig-` -Parameters - -In diesem Markdown-Beispiel wird ein Status-Badge für eine Verzweigung mit dem Namen `Feature-1-`hinzugefügt. - - - -``` -! [Beispiel-Zweigparameter] (https://github.com/actions/hello-world/workflows/Greet%20Everyone/badge.svg?branch=feature-1) -``` - - - - -#### Beispiel für die Verwendung des Parameters `-Ereignis` - -In diesem Markdown-Beispiel wird ein Badge hinzugefügt, das den Status von Workflowausführungen anzeigt, die durch das `pull_request` -Ereignis ausgelöst werden. - - - -``` -! [Beispielereignisparameter] (https://github.com/actions/hello-world/workflows/Greet%20Everyone/badge.svg?event=pull_request) -``` - - -{% if currentVersion == "free-pro-team@latest" %} - - -### Weiterführende Informationen - -- "[Verwalten der Abrechnung für {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)" - - {% endif %} diff --git a/translations/de-DE/content/actions/configuring-and-managing-workflows/configuring-and-managing-workflow-files-and-runs.md b/translations/de-DE/content/actions/configuring-and-managing-workflows/configuring-and-managing-workflow-files-and-runs.md deleted file mode 100644 index 5ebc54a52d01..000000000000 --- a/translations/de-DE/content/actions/configuring-and-managing-workflows/configuring-and-managing-workflow-files-and-runs.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: Workflow-Dateien und -Läufe konfigurieren und verwalten -intro: 'Erstelle und konfiguriere Workflows, um Deine Projektentwicklung teilweise zu automatisieren.' -mapTopic: true -redirect_from: - - /articles/configuring-workflows - - /github/automating-your-workflow-with-github-actions/configuring-workflows - - /actions/automating-your-workflow-with-github-actions/configuring-workflows -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/de-DE/content/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets.md b/translations/de-DE/content/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets.md deleted file mode 100644 index ed8a7c008476..000000000000 --- a/translations/de-DE/content/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets.md +++ /dev/null @@ -1,220 +0,0 @@ ---- -title: Verschlüsselte Geheimnisse erstellen und speichern -intro: 'Verschlüsselte Geheimnisse ermöglichen es Ihnen, vertrauliche Informationen in Ihrem Repository oder Ihrer Organisation zu speichern.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets - - /actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Informationen zu verschlüsselten Geheimnissen - -Geheimnisse sind verschlüsselte Umgebungsvariablen, die Sie in einem Repository oder einer Organisation erstellen. Die von Ihnen erstellten Geheimnisse können in {% data variables.product.prodname_actions %} Workflows verwendet werden. {% data variables.product.prodname_dotcom %} verwendet eine [versiegelte Libsodium-Box](https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes) um sicherzustellen, dass Geheimnisse verschlüsselt werden, bevor sie {% data variables.product.prodname_dotcom %} erreichen, und verschlüsselt bleiben, bis Du sie in einem Workflow verwendest. - -{% data reusables.github-actions.secrets-org-level-overview %} - -#### Benennen Ihrer Geheimnisse - -Die folgenden Regeln gelten für geheime Namen: - -* Geheime Namen dürfen nur alphanumerische Zeichen (`[a-z]`, `[A-Z]`, `[0-9]`) oder Unterstriche (`_`) enthalten. Leerzeichen sind nicht zulässig. -* Geheime Namen dürfen nicht mit dem `GITHUB_` -Präfix beginnen. -* Geheime Namen dürfen nicht mit einer Zahl beginnen. -* Geheime Namen müssen auf der Ebene eindeutig sein, auf der sie erstellt werden. Beispielsweise muss ein geheimer Schlüssel, der auf Organisationsebene erstellt wird, einen eindeutigen Namen auf dieser Ebene haben, und ein geheimer Schlüssel, der auf Repository-Ebene erstellt wird, muss einen eindeutigen Namen in diesem Repository haben. Wenn ein Geheimschlüssel auf Organisationsebene denselben Namen wie ein Geheimschlüssel auf Repository-Ebene hat, hat der geheime Schlüssel auf Repository-Ebene Vorrang. - -Um sicherzustellen, dass {% data variables.product.prodname_dotcom %} Ihr Geheimnis in Protokollen redisiert, vermeiden Sie die Verwendung strukturierter Daten als Werte von Geheimnissen. Vermeide beispielsweise Geheimnisse zu erstellen, die JSON oder codierte Git-Blobs enthalten. - -#### Zugriff auf Ihre Geheimnisse - -Um ein Geheimnis für eine Aktion verfügbar zu machen, legen Sie das Geheimnis als Eingabe oder Umgebungsvariable in der Workflow-Datei fest. In der README-Datei der Aktion erfahren Sie, welche Eingaben und Umgebungsvariablen die Aktion erwartet. Weitere Informationen finden Sie unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepsenv)“. - -Du kannst verschlüsselte Geheimnisse in einer Workflow-Datei verwenden und lesen, wenn Du auf die Datei Bearbeitungs-Zugriff hast. Weitere Informationen findest Du unter „[Zugriffsberechtigungen auf {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/access-permissions-on-github)“. - -{% warning %} - -**Warnung:** {% data variables.product.prodname_dotcom %} redigiert Geheimnisse zwar automatisch bei Ausgabe ins Log, aber Du solltest nicht vorsätzlich Geheimnisse ins Log schreiben. - -{% endwarning %} - -Sie können Geheimnisse auch mit der REST-API verwalten. Weitere Informationen finden Sie unter "[Secrets](/v3/actions/secrets/)". - -#### Einschränken von Anmeldeinformationsberechtigungen - -Beim Generieren von Anmeldeinformationen wird empfohlen, möglichst geringe Berechtigungen zu erteilen. Anstatt z.B. persönliche Anmeldeinformationen zu verwenden, solltest Du [Bereitstellen von Schlüsseln](/v3/guides/managing-deploy-keys/#deploy-keys) oder einen „Service-Account“ (Dienstkonto) benuzen. Ziehe in Erwägung, Nur-Lese-Berechtigungen zu gewähren, wenn dies ausreicht, und schränke den Zugriff so weit wie möglich ein. Wähle beim Generieren eines persönlichen Zugriffstokens („personal access token“, PAT) die geringsmöglichen Anwendungsbereiche („scopes“) aus. - -### Erstellen verschlüsselter Geheimnisse für ein Repository - -{% data reusables.github-actions.permissions-statement-secrets-repository %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -{% data reusables.github-actions.sidebar-secret %} -1. Klicken Sie auf **Add a new secret** (Neues Geheimnis hinzufügen). -1. Geben Sie einen Namen für Ihr Geheimnis in das Eingabefeld **Name** ein. -1. Geben Sie den Wert für Ihr Geheimnis ein. -1. Klicken Sie auf **Add secret** (Geheimnis hinzufügen). - -Wenn Ihr Repository auf Geheimnisse der übergeordneten Organisation zugreifen kann, werden diese Geheimnisse auch auf dieser Seite aufgeführt. - -### Erstellen verschlüsselter Geheimnisse für eine Organisation - -Beim Erstellen eines geheimen Schlüssels in einer Organisation können Sie eine Richtlinie verwenden, um einzuschränken, welche Repositorys auf diesen geheimen Schlüssel zugreifen können. Sie können z. B. Zugriff auf alle Repositorys gewähren oder den Zugriff auf nur private Repositorys oder eine angegebene Liste von Repositorys beschränken. - -{% data reusables.github-actions.permissions-statement-secrets-organization %} - -{% data reusables.organizations.navigate-to-org %} -{% data reusables.organizations.org_settings %} -{% data reusables.github-actions.sidebar-secret %} -1. Klicken Sie auf **Neue geheime**. -1. Geben Sie einen Namen für Ihr Geheimnis in das Eingabefeld **Name** ein. -1. Geben Sie den **Value** für Ihr Geheimnis ein. -1. Wählen Sie im **Repository-Zugriff** Dropdownliste eine Zugriffsrichtlinie aus. -1. Klicken Sie auf **Add secret** (Geheimnis hinzufügen). - -### Überprüfen des Zugriffs auf Geheimnisse auf Organisationsebene - -Sie können überprüfen, welche Zugriffsrichtlinien auf einen geheimen Schlüssel in Ihrer Organisation angewendet werden. - -{% data reusables.organizations.navigate-to-org %} -{% data reusables.organizations.org_settings %} -{% data reusables.github-actions.sidebar-secret %} -1. Die Liste der Geheimnisse enthält alle konfigurierten Berechtigungen und Richtlinien. Ein Beispiel: ![Geheimliste](/assets/images/help/settings/actions-org-secrets-list.png) -1. Weitere Informationen zu den konfigurierten Berechtigungen für jeden geheimen Schlüssel finden Sie unter **Aktualisieren**. - -### Verschlüsselte Geheimnisse in einem Workflow verwenden - -Mit Ausnahme von `GITHUB_TOKEN` werden Geheimnisse nicht an den Runner übergeben, wenn ein Workflow von einem geforkten Repository aus ausgelöst wird. - -Um eine Aktion mit einem Geheimnis als Eingabe- oder Umgebungsvariable zu versehen, kannst Du den `secrets` Kontext verwenden, um auf Geheimnisse zuzugreifen, die Du in Deinem Repository erstellt hast. Weitere Informationen findest Du unter "[Kontext und Ausdrucks-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)" und "[Workflow-Syntax für {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)." - -{% raw %} -```yaml -steps: - - name: Hello world action - with: # Das Geheimnis als Eingabe setzen - super_secret: ${{ secrets.SuperSecret }} - env: # Oder als Umgebunsvariable ("environment variable") - super_secret: ${{ secrets.SuperSecret }} -``` -{% endraw %} - -Wann immer dies möglich ist, vermeide die Übergabe von Geheimnissen zwischen Prozessen von der Befehlszeile aus. Befehlszeilen-Prozesse können für andere Benutzer (mithilfe des Befehls `ps`) sichtbar sein oder von [„security audit events“ (Ereignissen zur Sicherheits-Überprüfung)](https://docs.microsoft.com/en-us/windows-server/identity/ad-ds/manage/component-updates/command-line-process-auditing) erfasst werden. Um den Schutz von Geheimnissen zu unterstützen, solltest Du die Verwendung von Umgebungsvariablen, `STDIN` oder andere vom Zielprozess unterstützte Mechanismen in Betracht ziehen. - -Wenn Sie Geheimnisse innerhalb einer Kommandozeile übergeben müssen, umschließe sie im Rahmen der gültigen Quotierungsregeln. Geheimnisse enthalten oft Sonderzeichen, die in Deiner Shell unbeabsichtigte Wirkungen entfalten können. Um diese Sonderzeichen zu vermeiden, verwende Deine Umgebungsvariablen mit Anführungszeichen. Ein Beispiel: - -#### Beispiel mit Bash - -{% raw %} -```yaml -steps: - - shell: bash - env: - SUPER_SECRET: ${{ secrets.SuperSecret }} - run: | - example-command "$SUPER_SECRET" -``` -{% endraw %} - -#### Beispiel mit PowerShell - -{% raw %} -```yaml -steps: - - shell: pwsh - env: - SUPER_SECRET: ${{ secrets.SuperSecret }} - run: | - example-command "$env:SUPER_SECRET" -``` -{% endraw %} - -#### Beispiel mit Cmd.exe - -{% raw %} -```yaml -steps: - - shell: cmd - env: - SUPER_SECRET: ${{ secrets.SuperSecret }} - run: | - example-command "%SUPER_SECRET%" -``` -{% endraw %} - -### Einschränkungen für Geheimnisse - -Dein Workflow kann bis zu 100 Geheimnisse haben. Die Namen von Geheimnis-Umgebungsvariablen müssen Repository-weit eindeutig sein. - -Geheimnisse sind auf 64 KB beschränkt. Um Geheimnisse zu verwenden, die größer als 64 KB sind, können Sie verschlüsselte Geheimnisse in Ihrem Repository speichern und die Passphrase zur Entschlüsselung als Geheimnis auf {% data variables.product.prodname_dotcom %} speichern. Sie können beispielsweise `gpg` verwenden, um Ihre Anmeldeinformationen lokal zu verschlüsseln, bevor Sie die Datei in Ihrem Repository auf {% data variables.product.prodname_dotcom %} einchecken. Weitere Informationen finden Sie auf der „[gpg-Manpage](https://www.gnupg.org/gph/de/manual/r1023.html)“. - -{% warning %} - -**Warnung**: Achte darauf, dass Deine Geheimnisse nicht gedruckt werden, wenn Deine Aktion ausgeführt wird. Wenn Sie diesen Workaround verwenden, redigiert {% data variables.product.prodname_dotcom %} keine Geheimnisse, die in Protokollen gedruckt werden. - -{% endwarning %} - -1. Führe den folgenden Befehl von Deinem Terminal aus, um die Datei `my_secret.json` mit `gpg` und dem Verschlüsselungs-Algorithmus AES256 zu verschlüsseln. - - ``` shell - $ gpg --symmetric --cipher-algo AES256 my_secret.json - ``` - -1. Du wirst aufgefordert, eine Passphrase einzugeben. Merke Dir die Passphrase, denn Du musst ein neues Geheimnis auf {% data variables.product.prodname_dotcom %} mit der Passphrase als Wert erstellen. - -1. Erstellen Sie einen neuen Geheimschlüssel, der die Passphrase enthält. Erstelle beispielsweise ein neues Geheimnis mit dem Namen `LARGE_SECRET_PASSPHRASE` und setze den Wert des Geheimnisses auf die Passphrase, die Du im obigen Schritt ausgewählt hast. - -1. Kopiere Deine verschlüsselte Datei in Dein Repository und committe sie. In diesem Beispiel ist die verschlüsselte Datei `my_secret.json.gpg`. - -1. Erstellen Sie ein Shell-Skript, um das Passwort zu entschlüsseln. Speichern Sie diese Datei als `decrypt_secret.sh`. - - ``` shell - - - Die Datei - mkdir $HOME/secrets - --batch entschlüsseln, um den interaktiven Befehl - zu verhindern - --ja, um "Ja" für Fragen - gpg --quiet --batch --yes --decrypt --passphrase="$LARGE_SECRET_PASSPHRASE" - --output $HOME/secrets/my_secret.json my_secret.json.gp - ``` - -1. Stellen Sie sicher, dass Ihr Shell-Skript ausführbar ist, bevor Sie es in Ihrem Repository einchecken. - - ``` shell - $ chmod +x decrypt_secret.sh - $ git add decrypt_secret.sh - $ git commit -m "Add new decryption script" - $ git push - ``` - -1. Verwenden Sie in Ihrem Workflow einen `step`, um das Shell-Skript aufzurufen und das Geheimnis zu entschlüsseln. Um in der Umgebung, in der Dein Workflow läuft, eine Kopie Deines Projektarchivs zu haben, musst Du die Aktion [`actions/checkout`](https://github.com/actions/checkout) verwenden. Referenzieren Sie Ihr Shell-Skript mit dem Befehl `run` relativ zum Root Ihres Repositorys. - -{% raw %} - ```yaml - name: Workflows with large secrets - - on: push - - jobs: - my-job: - name: My Job - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - - name: Decrypt large secret - run: ./.github/scripts/decrypt_secret.sh - env: - LARGE_SECRET_PASSPHRASE: ${{ secrets.LARGE_SECRET_PASSPHRASE }} - # Dieser Befehl ist nur ein Beispiel, um zu zeigen, dass Dein Geheimnis ausgegeben wird - # Stelle sicher, dass Du alle Druckanweisungen Deiner Geheimnisse entfernst. Github - # verbirgt keine Geheimnisse, die diese Umgehung verwenden. - - name: Test printing your secret (Remove this step in production) - run: cat $HOME/secrets/my_secret.json - ``` -{% endraw %} diff --git a/translations/de-DE/content/actions/configuring-and-managing-workflows/creating-postgresql-service-containers.md b/translations/de-DE/content/actions/configuring-and-managing-workflows/creating-postgresql-service-containers.md deleted file mode 100644 index d70b650058d2..000000000000 --- a/translations/de-DE/content/actions/configuring-and-managing-workflows/creating-postgresql-service-containers.md +++ /dev/null @@ -1,335 +0,0 @@ ---- -title: PostgreSQL-Service-Container erstellen -intro: 'Du kannst einen PostgreSQL-Service-Container zur Verwendung in Deinem Workflow erstellen. Dieser Leitfaden zeigt Beispiele für die Erstellung eines PostgreSQL-Dienstes für Jobs, die in Containern oder direkt auf der Runner-Maschine laufen.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/creating-postgresql-service-containers -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Einführung - -Diese Anleitung zeigt Dir Workflow-Beispiele, die einen Service-Container mit dem `postgres`-Bild vom Docker-Hub konfigurieren. Der Workflow führt ein Skript aus, um einen PostgreSQL-Client zu erstellen und den Client mit Daten zu füllen. Um zu testen, ob der Workflow den PostgreSQL-Client erstellt und mit Daten füllt, gibt das Skript die Daten des Clients in der Konsole aus. - -{% data reusables.github-actions.docker-container-os-support %} - -### Vorrausetzungen - -{% data reusables.github-actions.service-container-prereqs %} - -Es kann Dir auch helfen, YAML, die Syntax für {% data variables.product.prodname_actions %} und PostgreSQL grundlegende zu verstehen. Weitere Informationen findest Du unter: - -- "[Einen Workflow konfigurieren](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)" -- "[PostgreSQL-Tutorial](https://www.postgresqltutorial.com/)" in der PostgreSQL-Dokumentation -- „[Kernkonzepte für {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)“ -- "[Umgebungsvariablen verwenden](/actions/automating-your-workflow-with-github-actions/using-environment-variables)" - -### Jobs in Containern ausführen - -{% data reusables.github-actions.container-jobs-intro %} - -{% data reusables.github-actions.copy-workflow-file %} - -{% raw %} -```yaml -name: PostgreSQL service example -on: push - -jobs: - # Label des Container-Jobs - container-job: - # Container muessen auf Linux-basierten Betriebssystemen laufen - runs-on: ubuntu-latest - # Docker-Hub-Image, welches `container-job` in - container: node:10.18-jessie ausfuehrt - - # Service-Containers, der mit Diensten von `container-job` - laufen soll: - # Label fuer den Zugrieff auf den Service-Container - postgres: - # Docker-Hub-Image - image: postgres - # Das Passwort fuer Postgres bereitstellen - env: - POSTGRES_PASSWORD: postgres - # health checks (Gesundheitstests) so einstellen, dass sie warten, bis Postgres gestarted ist - options: >- - --health-cmd pg_isready - --health-interval 10s - --health-timeout 5s - --health-retries 5 - - steps: - # Laedt eine Kopie des Codes in Dein Repository herunter, bevor CI-Tests starten - - name: Check out repository code - uses: actions/checkout@v2 - - # Fuehrt eine saubere Installation aller Abhaengigkeiten in der Datei `package.json` durch - # Weitere Information findest Du unter https://docs.npmjs.com/cli/ci.html - - name: Install dependencies - run: npm ci - - - name: Connect to PostgreSQL - # Startet ein Skript, das einen PostgreSQL-Client erzeugt, - # Den Client mit Daten befuellt, und Daten abruft - run: node client.js - # Umgebungsvariable, die vom Skript `client.js` benutzt wird, um einen neuen PostgreSQL-Client zu erzeugen. - env: - # Der Name des Hosts fuer die Kommunikation mit dem PostgreSQL-Servicecontainer - POSTGRES_HOST: postgres - # The default PostgreSQL port - POSTGRES_PORT: 5432 -``` -{% endraw %} - -#### Runner-Job konfigurieren - -{% data reusables.github-actions.service-container-host %} - -{% data reusables.github-actions.postgres-label-description %} - -```yaml -jobs: - # Label des Container-Jobs - container-job: - # Container muessen in Linux-basierten Betriebssystemen laufen - runs-on: ubuntu-latest - # Docker-Hub-Image, das `container-job` in - container: node:10.18-jessie ausfuehrt - - # Service-Container, die mit `container-job` laufen sollen - services: - # Label fuer den Zugriff auf den Service-Container - postgres: - # Docker-Hub-Image - image: postgres - # Passwort fuer postgres bereitstellen - env: - POSTGRES_PASSWORD: postgres - # Health checks so einstellen, dass sie warten, bis Postgres gestarted ist - options: >- - --health-cmd pg_isready - --health-interval 10s - --health-timeout 5s - --health-retries 5 -``` - -#### „Steps“ (Schritte) konfigurieren - -{% data reusables.github-actions.service-template-steps %} - -```yaml -steps: - # Laedt eine Kopie des Codes in Dein Repository herunter, bevor CI-Tests starten - - name: Check out repository code - uses: actions/checkout@v2 - - # Fuehrt eine saubere Installation aller Anhängigkeiten in der Datei `package.json` durch - # Weitere Informationen findest Du unter https://docs.npmjs.com/cli/ci.html - - name: Install dependencies - run: npm ci - - - name: Connect to PostgreSQL - # Startet ein Skript, das einen PostgreSQL-Client erzeugt, - # den Client mit Daten befuellt und Daten abruft - run: node client.js - # Environment variable used by the `client.js` script to create - # a new PostgreSQL client. - env: - # Der Name des Hosts fuer die Kommunikation mit dem PostgreSQL-Servicecontainer - POSTGRES_HOST: postgres - # Der standardmaessige PostgreSQL-Port - POSTGRES_PORT: 5432 -``` - -{% data reusables.github-actions.postgres-environment-variables %} - -Der Hostname des PostgreSQL-Dienstes ist der Label, den Du in Deinem Workflow konfiguriert hast, in diesem Fall `postgres`. Da Docker-Container im gleichen benutzerdefinierten Bridge-Netzwerk standardmäßig alle Ports öffnen, kannst Du auf den Service-Container durch den standardmäßigen PostgreSQL-Port 5432 zugreifen. - -### Jobs direkt auf der Runner-Maschine ausführen - -Wenn Du einen Job direkt auf der Runner-Maschine ausführst, musst Du die Ports des Service-Containers den Ports des Docker-Hosts zuordnen. Du kannst über den Docker-Host auf den Service-Container zugreifen, indem Du `localhost` und die Port-Nummer des Docker-Hosts verwendest. - -{% data reusables.github-actions.copy-workflow-file %} - -{% raw %} -```yaml -name: PostgreSQL Service Example -on: push - -jobs: - # Label des Runner-Jobs - runner-job: - # Du musst fuer Service-Container oder Container-Jobs eine Linux-Umgebung verwenden - runs-on: ubuntu-latest - - # Service-Container zum Betrieb mit `runner-job` - services: - # Label fuer den Zugriff auf den Service-Container - postgres: - # Docker-Hub-Image - image: postgres - # Das Passwort fuer Postgres bereitstellen - env: - POSTGRES_PASSWORD: postgres - # Health checks einstellen, dass sie warten, bis Postgres gestarted ist - options: >- - --health-cmd pg_isready - --health-interval 10s - --health-timeout 5s - --health-retries 5 - ports: - # Maps tcp port 5432 on service container to the host - - 5432:5432 - - steps: - # Laedt eine Kopie des Codes in Dein Repository herunter, bevor CI tests laufen - - name: Check out repository code - uses: actions/checkout@v2 - - # Fuehrt eine saubere Installation aller Abhaengigkeiten in der Datei `package.json` durch - # Weitere Information finsest Du unter https://docs.npmjs.com/cli/ci.html - - name: Install dependencies - run: npm ci - - - name: Connect to PostgreSQL - # Startet ein Skript, das einen PostgreSQL-Client erzeugt, - # den client mit Daten befuellt und Daten abruft - run: node client.js - # Umgebungsvariable, die das Skript `client.js` benutzt, um - # einen neuen PostgreSQL-Client zu erzeugen. - env: - # Der Hostname fuer die Kommunikation mit dem PostgreSQL-Service-Container - POSTGRES_HOST: localhost - # Standardmaessiger PostgreSQL-Port - POSTGRES_PORT: 5432 -``` -{% endraw %} - -#### Runner-Job konfigurieren - -{% data reusables.github-actions.service-container-host-runner %} - -{% data reusables.github-actions.postgres-label-description %} - -Der Workflow ordnet Port 5432 des PostgreSQL-Service-Containers dem Docker-Host zu. Weitere Informationen über das Schlüsselwort `ports` findest Du unter "[Informationen über Service-Container](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)." - -```yaml -jobs: - # Label des Runner-Jobs - runner-job: - # Du musst fuer Service-Containers oder Container-Jobs eine Linux-Umgebung verwenden - runs-on: ubuntu-latest - - # Service-Containers zum Betrieb mit `runner-job` - services: - # Label fier den Zugriff auf den Service-Container - postgres: - # Docker-Hub-Image - image: postgres - # Das Passwort fuer Postgres bereitstellen - env: - POSTGRES_PASSWORD: postgres - # Health-Checks einstellen, dass sie warten, bis Postgres gestarted ist - options: >- - --health-cmd pg_isready - --health-interval 10s - --health-timeout 5s - --health-retries 5 - ports: - # Ordnet TCP-Port 5432 des Service-Containers dem Host zu - - 5432:5432 -``` - -#### „Steps“ (Schritte) konfigurieren - -{% data reusables.github-actions.service-template-steps %} - -```yaml -steps: - # Laedt eine Kopie des Codes in Dein Repository herunter, bevor CI-Tests starten - - name: Check out repository code - uses: actions/checkout@v2 - - # Fuehrt eine saubere Installation aller Anhängigkeiten in der Datei `package.json` durch - # Weitere Informationen findest Du unter https://docs.npmjs.com/cli/ci.html - - name: Install dependencies - run: npm ci - - - name: Connect to PostgreSQL - # Startet ein Skript, das einen PostgreSQL-Client erzeugt, - # den Client mit Daten befuellt und Daten abruft - run: node client.js - # Environment variable used by the `client.js` script to create - # a new PostgreSQL client. - env: - # Der Hostname zur Kommunikation with the PostgreSQL-Service-Container - POSTGRES_HOST: localhost - # Der standardmaessige PostgreSQL-Port - POSTGRES_PORT: 5432 -``` - -{% data reusables.github-actions.postgres-environment-variables %} - -{% data reusables.github-actions.service-container-localhost %} - -### Den PostgreSQL-Service-Container testen - -Du kannst Deinen Workflow mit dem folgenden Skript testen, das einen PostgreSQL-Client erstellt und eine neue Tabelle mit Platzhalter-Daten hinzufügt. Das Skript gibt dann die im PostgreSQL-Client gespeicherten Werte auf dem Terminal aus. Dein Skript kann jede beliebige Sprache verwenden, aber in diesem Beispiel wird Node.js mit dem npm-Modul `pg` genutzt. Weitere Informationen findest Du unter [npm-Modul pg](https://www.npmjs.com/package/pg). - -Du kannst *client.js* anpassen, um alle PostgreSQL-Vorgänge einzuschließen, die für Deinen Workflow erforderlich sind. In diesem Beispiel erstellt das Skript die Instanz des PostgreSQL-Clients, erstellt eine Tabelle, fügt Platzhalter-Daten hinzu und ruft dann die Daten ab. - -{% data reusables.github-actions.service-container-add-script %} - -```javascript -const { Client } = require('pg'); - -const pgclient = new Client({ - host: process.env.POSTGRES_HOST, - port: process.env.POSTGRES_PORT, - user: 'postgres', - password: 'postgres', - database: 'postgres' -}); - -pgclient.connect(); - -const table = 'CREATE TABLE student(id SERIAL PRIMARY KEY, firstName VARCHAR(40) NOT NULL, lastName VARCHAR(40) NOT NULL, age INT, address VARCHAR(80), email VARCHAR(40))' -const text = 'INSERT INTO student(firstname, lastname, age, address, email) VALUES($1, $2, $3, $4, $5) RETURNING *' -const values = ['Mona the', 'Octocat', 9, '88 Colin P Kelly Jr St, San Francisco, CA 94107, United States', 'octocat@github.com'] - -pgclient.query(table, (err, res) => { - if (err) throw err -}); - -pgclient.query(text, values, (err, res) => { - if (err) throw err -}); - -pgclient.query('SELECT * FROM student', (err, res) => { - if (err) throw err - console.log(err, res.rows) // Print the data in student table - pgclient.end() -}); -``` - -Das Skript erstellt einen neuen PostgreSQL-`Client`, der einen `host`- und einen `port`-Parameter akzeptiert. Das Skript verwendet die Umgebungsvariablen `POSTGRES_HOST` und `POSTGRES_PORT`, um die IP-Adresse und den Port des Clients festzulegen. Wenn `host` Und `port` nicht definiert sind, ist der Standard-Host `localhost` und der Standard-Port 5432. - -Das Skript erstellt eine Tabelle und füllt sie mit Platzhalterdaten auf. Um zu testen, ob die PostgreSQL-Datenbank die Daten enthält, gibt das Skript den Inhalt der Tabelle in das Konsolenprotokoll aus. - -Wenn Du diesen Workflow ausführst, solltest Du im Schritt „Mit PostgreSQL verbinden“ die folgende Ausgabe sehen, welche zeigt, dass Du den PostgreSQL-Client erstellt und Daten hinzugefügt hast: - -``` -null [ { id: 1, - firstname: 'Mona the', - lastname: 'Octocat', - age: 9, - address: - '88 Colin P Kelly Jr St, San Francisco, CA 94107, United States', - email: 'octocat@github.com' } ] -``` diff --git a/translations/de-DE/content/actions/configuring-and-managing-workflows/creating-redis-service-containers.md b/translations/de-DE/content/actions/configuring-and-managing-workflows/creating-redis-service-containers.md deleted file mode 100644 index 5c43175345b9..000000000000 --- a/translations/de-DE/content/actions/configuring-and-managing-workflows/creating-redis-service-containers.md +++ /dev/null @@ -1,325 +0,0 @@ ---- -title: Redis-Service-Container erstellen -intro: 'Du kannst Service-Container verwenden, um einen Redis-Client in Deinem Workflow zu erstellen. Dieser Leitfaden zeigt Beispiele für die Erstellung eines Redis-Dienstes für Jobs, die in Containern oder direkt auf der Runner-Maschine ausgeführt werden.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/creating-redis-service-containers -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Einführung - -Diese Anleitung zeigt Dir Workflow-Beispiele, die einen Service-Container mit dem Docker-Hub-`redis`-Image konfigurieren. Der Workflow führt ein Skript aus, um einen Redis-Client zu erstellen und den Client mit Daten zu füllen. Um zu testen, ob der Workflow den Redis-Client erstellt und mit Daten füllt, gibt das Skript die Daten des Clients auf der Konsole aus. - -{% data reusables.github-actions.docker-container-os-support %} - -### Vorrausetzungen - -{% data reusables.github-actions.service-container-prereqs %} - -Es kannst Dir helfen, wenn Du ein grundlegendes Verständnis von YAML, der Syntax für {% data variables.product.prodname_actions %} und Redis hast. Weitere Informationen findest Du unter: - -- "[Einen Workflow konfigurieren](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)" -- „[Erste Schritte mit Redis](https://redislabs.com/get-started-with-redis/)“ in der Redis-Dokumentation -- „[Kernkonzepte für {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)“ -- "[Umgebungsvariablen verwenden](/actions/automating-your-workflow-with-github-actions/using-environment-variables)" - -### Jobs in Containern ausführen - -{% data reusables.github-actions.container-jobs-intro %} - -{% data reusables.github-actions.copy-workflow-file %} - -{% raw %} -```yaml -name: Redis container example -on: push - -jobs: - # Label des Container-Jobs - container-job: - # Container muessen in Linux-basierten Betriebssystemen laufen - runs-on: ubuntu-latest - # Docker-Hub-Image, in dem der `container-job` laeuft - container: node:10.18-jessie - - # Service-Container, die mit dem `container-job` laufen - services: - # Label zum Zugriff auf den Service-Container - redis: - # Docker-Hub-Image - image: redis - # Health-Checks so einstellen, dass sie warten, bis redis gestarted ist - options: >- - --health-cmd "redis-cli ping" - --health-interval 10s - --health-timeout 5s - --health-retries 5 - - steps: - # Laedt eine Kopie des Codes in Dein Repository herunter, bevor CI tests gestartet werden - - name: Check out repository code - uses: actions/checkout@v2 - - # Fuehrt eine saubere Installation aller abhaengigkeiten in der Datei `package.json` aus - # Weitere Informationen findest Du unter https://docs.npmjs.com/cli/ci.html - - name: Install dependencies - run: npm ci - - - name: Connect to Redis - # fuehrt ein Skript aus, das einen Redis-Cient erzeugt, - # Den Client mit Daten fuellt, und Daten abruft - run: node client.js - # Umgebungsvariable, mittels der das Skript `client.js` einen neuen Redis-Client erzeugt. - env: - # Der Hostname fuer die Kommunikation mit dem Redis-Service-Container - REDIS_HOST: redis - # Standarmaessiger Redis-Port - REDIS_PORT: 6379 -``` -{% endraw %} - -#### Den Container-Job konfigurieren - -{% data reusables.github-actions.service-container-host %} - -{% data reusables.github-actions.redis-label-description %} - -```yaml -jobs: - # Label des Container-Jobs - container-job: - # Container muessen in Linux-basierten Betriebssystemen laufen - runs-on: ubuntu-latest - # Docker-Hub-Image, in dem der `container-job` laeuft - container: node:10.18-jessie - - # Service-Container, die mit dem `container-job` laufen - services: - # Label zum Zugriff auf den Service-Container - redis: - # Docker-Hub-Image - image: redis - # Health-Checks so einstellen, dass sie warten, bis redis gestarted ist - options: >- - --health-cmd "redis-cli ping" - --health-interval 10s - --health-timeout 5s - --health-retries 5 -``` - -#### „Steps“ (Schritte) konfigurieren - -{% data reusables.github-actions.service-template-steps %} - -```yaml -steps: - # Laedt eine Kopie des Codes in Dein Repository herunter, bevor CI tests gestartet werden - - name: Check out repository code - uses: actions/checkout@v2 - - # Fuehrt eine saubere Installation aller abhaengigkeiten in der Datei `package.json` aus - # Weitere Informationen findest Du unter https://docs.npmjs.com/cli/ci.html - - name: Install dependencies - run: npm ci - - - name: Connect to Redis - # Fuehrt ein Skript aus, das einen Redis-Cient erzeugt, - # den Client mit Daten fuellt, und Daten abruft - run: node client.js - # Umgebungsvariable, mittels der das Skript `client.js` einen neuen Redis-Client erzeugt. - env: - # Der Hostname fuer die Kommunikation mit dem Redis-Service-Container - REDIS_HOST: redis - # Standarmaessiger Redis-Port - REDIS_PORT: 6379 -``` - -{% data reusables.github-actions.redis-environment-variables %} - -Der Hostname des Redis-Dienstes ist das Label, das Du in Deinem Workflow konfiguriert hast, in diesem Fall `redis`. Da Docker-Container im selben benutzerdefinierten Bridge-Netzwerk standardmäßig alle Ports öffnen, kannst Du auf den Service-Container über den Standard-Redis-Port 6379 zugreifen. - -### Jobs direkt auf der Runner-Maschine ausführen - -Wenn Du einen Job direkt auf der Runner-Maschine ausführst, musst Du die Ports des Service-Containers den Ports des Docker-Hosts zuordnen. Du kannst über den Docker-Host auf den Service-Container zugreifen, indem Du `localhost` und die Port-Nummer des Docker-Hosts verwendest. - -{% data reusables.github-actions.copy-workflow-file %} - -{% raw %} -```yaml -name: Redis runner example -on: push - -jobs: - # Label des Runner-Jobs - runner-job: - # Du brauchst eine Linux-Umgebung fuer Service-Container oder Container-Jobs - runs-on: ubuntu-latest - - # Service-Container, die mit dem `runner-job` laufen - services: - # Label zum Zugriff auf den Service-Container - redis: - # Docker-Hub-Image - image: redis - # Health-Checks so einstellen, dass sie warten, bis redis gestarted ist - options: >- - --health-cmd "redis-cli ping" - --health-interval 10s - --health-timeout 5s - --health-retries 5 - ports: - # Ordnet Port 6379 des Service-Containers dem Host zu - - 6379:6379 - - steps: - # Laedt eine Kopie des Codes in Dein Repository herunter, bevor CI tests gestartet werden - - name: Check out repository code - uses: actions/checkout@v2 - - # Fuehrt eine saubere Installation aller abhaengigkeiten in der Datei `package.json` aus - # Weitere Informationen findest Du unter https://docs.npmjs.com/cli/ci.html - - name: Install dependencies - run: npm ci - - - name: Connect to Redis - # Fuehrt ein Skript aus, das einen Redis-Cient erzeugt, - # den Client mit Daten fuellt, und Daten abruft - run: node client.js - # Umgebungsvariable, mittels der das Skript `client.js` - # einen neuen Redis-Client erzeugt. - env: - # Der Hostname fuer die Kommunikation mit dem Redis-Service-Container - REDIS_HOST: localhost - # Standarmaessiger Redis-Port - REDIS_PORT: 6379 -``` -{% endraw %} - -#### Runner-Job konfigurieren - -{% data reusables.github-actions.service-container-host-runner %} - -{% data reusables.github-actions.redis-label-description %} - -Der Workflow ordnet Port 6379 des Redis-Service-Containers dem Docker-Host zu. Weitere Informationen über das Schlüsselwort `ports` findest Du unter "[Informationen über Service-Container](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)." - -```yaml -jobs: - # Label des Runner-Jobs - runner-job: - # Fuer Service-Containers oder Container-Jobs brauchst Du eine Linux-Umgebung - runs-on: ubuntu-latest - - # Service-Container, die mit dem `runner-job` laufen - services: - # Label zum Zugriff auf den Service-Container - redis: - # Docker-Hub-Image - image: redis - # Health-Checks so einstellen, dass sie warten, bis redis gestarted ist - options: >- - --health-cmd "redis-cli ping" - --health-interval 10s - --health-timeout 5s - --health-retries 5 - ports: - # Ordnet Port 6379 des Service-Containers dem Host zu - - 6379:6379 -``` - -#### „Steps“ (Schritte) konfigurieren - -{% data reusables.github-actions.service-template-steps %} - -```yaml -steps: - # Laedt eine Kopie des Codes in Dein Repository herunter, bevor CI tests gestartet werden - - name: Check out repository code - uses: actions/checkout@v2 - - # Fuehrt eine saubere Installation aller abhaengigkeiten in der Datei `package.json` durch - # Weitere Informationen findest Du unter https://docs.npmjs.com/cli/ci.html - - name: Install dependencies - run: npm ci - - - name: Connect to Redis - # Fuehrt ein Skript aus, das einen Redis-Cient erzeugt, - # den Client mit Daten fuellt, und Daten abruft - run: node client.js - # Umgebungsvariable, mittels der das Skript `client.js` - # einen neuen Redis-Client erzeugt. - env: - # Der Hostname fuer die Kommunikation mit dem Redis-Service-Container - REDIS_HOST: localhost - # Standarmaessiger Redis-Port - REDIS_PORT: 6379 -``` - -{% data reusables.github-actions.redis-environment-variables %} - -{% data reusables.github-actions.service-container-localhost %} - -### Redis-Sercive-Container testen - -Du kannst Deinen Workflow mit dem folgenden Skript testen, das einen Redis-Client erstellt und den Client mit Platzhalter-Daten füllt. Das Skript gibt dann die im Redis-Client gespeicherten Werte auf dem Terminal aus. Dein Skript kann jede beliebige Sprache verwenden, aber dieses Beispiel verwendet Node.js und das `redis`-npm-Modul. Weitere Informationen findest Du unter [npm-Redis-Modul](https://www.npmjs.com/package/redis). - -Du kannst *client.js* anpassen, um alle Redis-Operationen abzudecken, die Dein Workflow braucht. In diesem Beispiel erstellt das Skript die Redis-Client-Instanz, fügt Platzhalter-Daten hinzu und ruft dann die Daten ab. - -{% data reusables.github-actions.service-container-add-script %} - -```javascript -const redis = require("redis"); - -// Erzeugt einen neuen Redis-Client -// Falls REDIS_HOST nicht definiert ist, ist der Host standarmaessig localhost -// Falls REDIS_PORT nicht definiert ist, ist der Standard-Port 6379 -const redisClient = redis.createClient({ - host: process.env.REDIS_HOST, - port: process.env.REDIS_PORT -}); - -redisClient.on("error", function(err) { - console.log("Error " + err); -}); - -// Setzt den Schluessel "octocat" auf den Wert "Mona the octocat" -redisClient.set("octocat", "Mona the Octocat", redis.print); -// Setzt einen Schluessel auf "octocat", Feld auf "species", und "value" auf "Cat and Octopus" -redisClient.hset("species", "octocat", "Cat and Octopus", redis.print); -// Setzt einen Schluessel auf "octocat", Feld auf "species", und "value" auf "Dinosaur and Octopus" -redisClient.hset("species", "dinotocat", "Dinosaur and Octopus", redis.print); -// Setzt einen Schluessel auf "octocat", Feld auf "species", und "value" auf "Cat and Robot" -redisClient.hset(["species", "robotocat", "Cat and Robot"], redis.print); -// Holt alle Felder vom Schluessel "species" - -redisClient.hkeys("species", function (err, replies) { - console.log(replies.length + " replies:"); - replies.forEach(function (reply, i) { - console.log(" " + i + ": " + reply); - }); - redisClient.quit(); -}); -``` - -Das Skript erstellt einen neuen Redis-Client mit der Methode `createClient`, welche die Parameter `host` und `port` akzeptiert. Das Skript verwendet die Umgebungsvariablen `REDIS_HOST` und `REDIS_PORT`, um die IP-Adresse und den Port des Clients festzulegen. Wenn `host` und `port` nicht definiert sind, ist der Standard-Host `localhost` und der Standard-Port 6379. - -Das Skript verwendet die Methoden `set` und `hset`, um die Datenbank mit einigen Schlüsseln, Feldern und Werten zu füllen. Um zu bestätigen, dass der Redis-Client die Daten enthält, gibt das Skript den Inhalt der Datenbank in das Konsolen-Log aus. - -Wenn Du diesen Workflow ausführst, solltest Du im Schritt „Mit Redis verbinden“ die folgende Ausgabe sehen, welche zeigt, dass Du den Redis-Client erstellt und Daten hinzugefügt hast: - -``` -Reply: OK -Reply: 1 -Reply: 1 -Reply: 1 -3 replies: - 0: octocat - 1: dinotocat - 2: robotocat -``` diff --git a/translations/de-DE/content/actions/configuring-and-managing-workflows/index.md b/translations/de-DE/content/actions/configuring-and-managing-workflows/index.md deleted file mode 100644 index eb39c0671a6f..000000000000 --- a/translations/de-DE/content/actions/configuring-and-managing-workflows/index.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Workflows konfigurieren und verwalten -shortTitle: Workflows -intro: 'Du kannst benutzerdefinierte Workflows erstellen und Läufe verwalten, um die Lebenszyklus-Prozesse der Softwareentwicklung in Deinem Projekt zu kontrollieren.' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -{% topic_link_in_list /configuring-and-managing-workflow-files-and-runs %} - {% link_in_list /configuring-a-workflow %} - {% link_in_list /managing-a-workflow-run %} - %link_in_list /sharing-workflow-templates-innerhalb-Ihrer-Organisation %" -{% topic_link_in_list /using-variables-and-secrets-in-a-workflow %} - {% link_in_list /creating-and-storing-encrypted-secrets %} - {% link_in_list /using-environment-variables %} - {% link_in_list /authenticating-with-the-github_token %} -{% topic_link_in_list /caching-and-storing-workflow-data %} - {% link_in_list /persisting-workflow-data-using-artifacts %} - {% link_in_list /caching-dependencies-to-speed-up-workflows %} -{% topic_link_in_list /using-databases-and-service-containers %} - {% link_in_list /about-service-containers %} - {% link_in_list /creating-redis-service-containers %} - {% link_in_list /creating-postgresql-service-containers %} diff --git a/translations/de-DE/content/actions/configuring-and-managing-workflows/managing-a-workflow-run.md b/translations/de-DE/content/actions/configuring-and-managing-workflows/managing-a-workflow-run.md deleted file mode 100644 index 7e1d3b8449a2..000000000000 --- a/translations/de-DE/content/actions/configuring-and-managing-workflows/managing-a-workflow-run.md +++ /dev/null @@ -1,186 +0,0 @@ ---- -title: Einen Workflow-Lauf verwalten -intro: 'Sie können den Status und die Ergebnisse der einzelnen Schritte in Ihrem Workflow anzeigen, einen ausstehenden Workflow abbrechen, fakturierbare Auftragsausführungsminuten anzeigen, einen fehlgeschlagenen Workflow debuggen und erneut ausführen, Protokolle suchen und herunterladen und Artefakte herunterladen.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/viewing-your-repository-s-workflows - - /articles/viewing-your-repositorys-workflows - - /articles/managing-a-workflow-run - - /github/automating-your-workflow-with-github-actions/managing-a-workflow-run - - /actions/automating-your-workflow-with-github-actions/managing-a-workflow-run -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Informationen zur Workflow-Verwaltung - -Auf der Workflow-Lauf-Seite können sie sehen, ob ein Workflow-Lauf ausgeführt wird oder abgeschlossen ist. Wenn der Lauf ausgeführt wird, können Sie den Lauf abbrechen. Sie müssen mit einem {% data variables.product.prodname_dotcom %}-Konto angemeldet sein, um Workflow-Informationen anzuzeigen, auch für öffentliche Repositories. Weitere Informationen finden Sie unter „[Zugriffsberechtigungen auf GitHub](/articles/access-permissions-on-github)“. - -Wenn der Lauf abgeschlossen ist, können Sie sehen, ob das Ergebnis erfolgreich, fehlerhaft, abgebrochen oder neutral war. Wenn der Lauf fehlgeschlagen ist, können Sie die Build-Protokolle anzeigen und durchsuchen, um den Fehler zu diagnostizieren und den Workflow erneut auszuführen. Sie können auch fakturierbare Auftragsausführungsminuten anzeigen oder Protokolle herunterladen und Artefakte erstellen. - - ![Annotiertes Workflow-Ausführungsbild](/assets/images/help/repository/annotated-workflow.png) - -{% data variables.product.prodname_actions %} verwenden die Checks API, um Status, Ergebnisse und Protokolle für einen Workflow auszugeben. {% data variables.product.prodname_dotcom %} erstellt eine neue Prüfsuite für jeden Workflow-Lauf. Die Prüfsuite enthält einen Prüflauf für jeden Auftrag im Workflow, und jeder Auftrag enthält Schritte. {% data variables.product.prodname_actions %} werden als Schritt in einem Workflow ausgeführt. Weitere Informationen zur Prüf-API finden Sie unter "[](/v3/checks/)". - -{% data reusables.github-actions.invalid-workflow-files %} - -### Ihren Workflow-Verlauf anzeigen - -Sie können jeden Auftrag in einem Workflow-Lauf und jeden Schritt in einem Auftrag anzeigen. Weitere Informationen findest Du unter „[Kernkonzepte für {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions#job)“. {% data reusables.repositories.permissions-statement-read %} - -Zusätzlich zu den in der Workflowdatei konfigurierten Schritten enthält jeder Auftrag auch zusätzliche Aufgaben zum Initiieren und Abschließen der Ausführung des Auftrags. Diese Schritte werden im Workflow als "Einrichtungsauftrag" und "Auftrags abschließen" protokolliert. - -Bei Aufträgen, die auf {% data variables.product.prodname_dotcom %}-gehosteten Läufern ausgeführt werden, zeichnet "Job einrichten" Details der virtuellen Umgebung des Läufers auf und enthält einen Link zur Liste der vorinstallierten Tools, die auf dem Läufercomputer vorhanden waren. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -6. Wenn der Lauf fehlgeschlagen ist, kannst Du den Workflow optional erneut ausführen, indem Du das Dropdownmenü **Re-run checks** (Prüfungen erneut durchführen) in der oberen rechten Ecke des Workflows verwendest und **Re-run all checks** (Alle Prüfungen erneut durchführen) auswählst. ![Dropdownmenü zum erneuten Durchführen der Prüfungen](/assets/images/help/repository/rerun-checks-drop-down.png) - -### Einen Workflow-Lauf abbrechen - -Wenn Sie einen Workflowlauf abbrechen, bricht {% data variables.product.prodname_dotcom %} alle Aufträge und Schritte ab, die Teil dieses Workflows sind. {% data reusables.repositories.permissions-statement-write %} - -Beim Abbrechen der Workflowausführung führen Sie möglicherweise andere Software aus, die Ressourcen verwendet, die mit der Workflowausführung zusammenhängen. Um Ihnen zu helfen, Ressourcen im Zusammenhang mit der Workflowausführung freizugeben, kann es hilfreich sein, die Schritte zu verstehen, {% data variables.product.prodname_dotcom %} zum Abbrechen einer Workflowausführung ausführt. Weitere Informationen finden Sie unter "[Schritte, die {% data variables.product.prodname_dotcom %} zum Abbrechen eines Workflowlaufs](#steps-github-takes-to-cancel-a-workflow-run). - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -1. Klicke in der oberen rechten Ecke des Workflows auf **Cancel check suite** (Prüfsuite abbrechen). ![Schaltfläche zum Abbrechen der Prüfsuite](/assets/images/help/repository/cancel-check-suite.png) -1. Nachdem Sie auf **Check Suite**" . - -#### Schritte {% data variables.product.prodname_dotcom %} zum Abbrechen einer Workflowausführung führt - -1. Um die Workflowausführung abzubrechen, wertet der Server `neu aus, wenn` Bedingungen für alle derzeit ausgeführten Aufträge. Wenn die Bedingung als true`wird, wird der Auftrag nicht abgebrochen. Beispielsweise die Bedingung, ob: always()` als true ausgewertet wird und der Auftrag weiterhin ausgeführt wird. Wenn keine Bedingung vorhanden ist, entspricht dies der Bedingung `wenn: success()`, die nur ausgeführt wird, wenn der vorherige Schritt erfolgreich abgeschlossen wurde. -2. Bei Aufträgen, die abgebrochen werden müssen, sendet der Server eine Abbruchnachricht an alle Läufercomputer mit Aufträgen, die abgebrochen werden müssen. -3. Bei Aufträgen, die weiterhin ausgeführt werden, wertet der Server `neu aus, ob` Bedingungen für die unvollendeten Schritte. Wenn die Bedingung als true`wird, wird der Schritt weiterhin ausgeführt. -
  • Für Schritte, die abgebrochen werden müssen, sendet die Läufermaschine SIGINT/Ctrl-C-` an den Schritteingabeprozess (`Knoten` für Javascript-Aktion, `docker` für Containeraktion und `bash/cmd/pwd` , wenn sie in einem Schritt verwenden `ausführen). Wenn der Prozess nicht innerhalb von 7500 ms beendet wird, sendet der Läufer SIGTERM/Ctrl-Break-` an den Prozess, und wartet dann 2500 ms, bis der Prozess beendet wird. Wenn der Prozess noch ausgeführt wird, tötet der Läufer den Prozessbaum. -5. Nach ablaufen 5 Minuten Abbruchzeit zeitoutt der Server das Beenden aller Aufträge und Schritte, die die Ausführung nicht beenden oder den Abbruchvorgang nicht abschließen können. - -### Löschen einer Workflowausführung - -Sie können eine Workflowausführung löschen, die abgeschlossen wurde oder mehr als 2 Wochen alt ist. {% data reusables.repositories.permissions-statement-write %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -1. Um eine Workflowausführung zu löschen, verwenden Sie das Dropdownmenü {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} , und wählen Sie **Workflow löschen**. - - ![Löschen einer Workflowausführung](/assets/images/help/settings/workflow-delete-run.png) -1. Überprüfen Sie die Bestätigungsaufforderung, und klicken Sie auf **Ja, löschen Sie diesen Workflow, der**ausgeführt wird. - - ![Löschen einer Workflowausführungsbestätigung](/assets/images/help/settings/workflow-delete-run-confirmation.png) - -{% if currentVersion == "free-pro-team@latest" %} - -### Anzeigen von abrechnungsfähigen Auftragsausführungsminuten - -Sie können die Ausführungszeit eines Auftrags anzeigen, einschließlich der fakturierbaren Minuten, die ein Einzelvorgang angesammelt hat. - -Fakturierbare Auftragsausführungsminuten werden nur für Aufträge angezeigt, die auf privaten Repositorys ausgeführt werden, die {% data variables.product.prodname_dotcom %}gehosteten Läufer verwenden. Es gibt keine fakturierbaren Minuten, wenn {% data variables.product.prodname_actions %} in öffentlichen Repositorys oder für Aufträge verwendet werden, die auf selbst gehosteten Läufern ausgeführt werden. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -1. Klicken Sie in der Auftragszusammenfassung auf **Ausführen und fakturierbare Zeitdetails**. ![Link zu Den Ausführungs- und Abrechnungsdetails](/assets/images/help/repository/view-run-billable-time.png) - - {% note %} - - **Hinweis:** Die angezeigte Abrechnungszeit enthält keine Rundungen oder Minutenmultiplikatoren. Informationen zum Anzeigen der gesamten {% data variables.product.prodname_actions %} Nutzung, einschließlich Rundungs- und Minutenmultiplikatoren, finden Sie unter "[Anzeigen Ihrer {% data variables.product.prodname_actions %} Nutzung](/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage)". - - {% endnote %} - -{% endif %} - -### Protokolle zur Fehlerdiagnose anzeigen - -Wenn Ihr Workflow-Lauf fehlschlägt, können Sie sehen, welcher Schritt den Fehler verursacht hat, und die Build-Protokolle des fehlgeschlagenen Schrittes zur Fehlerbehebung überprüfen. Sie sehen, wie lange es gedauert hat, bis jeder Schritt ausgeführt wurde. Sie können außerdem einen Permalink in eine bestimmte Zeile in der Protokolldatei kopieren, um ihn mit Ihrem Team zu teilen. {% data reusables.repositories.permissions-statement-read %} - -{% data variables.product.product_name %} speichert vollständige Buildprotokolle und Artefakte 90 Tage lang. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -{% data reusables.repositories.navigate-to-job %} -6. Um das Protokoll für einen fehlgeschlagenen Schritt einzublenden, klicken Sie auf den Schritt. ![Name des fehlgeschlagenen Schrittes](/assets/images/help/repository/failed-check-step.png) -7. Klicke bei Bedarf auf die Zeilennummer des Schritts, um einen Link zu einer bestimmten Zeile in den Logs zu erhalten. Den Link kannst Du aus der Adressleiste Deines Webbrowsers kopieren. ![Schaltfläche zum Kopieren des Links](/assets/images/help/repository/copy-link-button.png) - -### Protokolle durchsuchen - -Sie können die Build-Protokolle für einen bestimmten Schritt durchsuchen. Beim Durchsuchen von Protokollen werden nur eingeblendete Schritte in die Ergebnisse einbezogen. {% data reusables.repositories.permissions-statement-read %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -{% data reusables.repositories.navigate-to-job %} -6. Um jeden Schritt, den Sie in Ihre Suche einbeziehen möchten, einzublenden, klicken Sie auf den Schritt. ![Name des Schrittes](/assets/images/help/repository/failed-check-step.png) -7. Gib in der oberen rechten Ecke der Protokollausgabe im Suchfeld **Search logs** (Protokolle durchsuchen) eine Suchanfrage ein. ![Suchfeld zum Durchsuchen von Protokollen](/assets/images/help/repository/search-log-box.png) - -### Herunterladen von Protokollen - -Sie können die Protokolldateien von Ihrem Workflowlauf herunterladen. Sie können auch die Artefakte eines Workflows herunterladen. Weitere Informationen findest Du unter „[Workflow-Daten mittels Artefakten persistieren](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)“. {% data reusables.repositories.permissions-statement-read %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -5. Um Protokolle herunterzuladen, verwende das Dropdownmenü **Download logs** (Protokolle herunterladen), und wähle die Protokolle aus, die Du herunterladen möchtest. ![Dropdownmenü zum Herunterladen von Protokollen](/assets/images/help/repository/download-logs-drop-down.png) - -### Logs löschen - -Du kannst die Logdateien aus Deiner Workflow-Ausführung löschen. {% data reusables.repositories.permissions-statement-write %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -5. Um die Logdateien zu löschen, klicke auf **Delete all logs** (Alle Logs löschen) und überprüfe die Bestätigungsanfrage. ![Delete all logs](/assets/images/help/repository/delete-all-logs.png) Nach die Protokolle gelöscht sind, verschwindet die Schaltfläche **Delete all logs**, um anzuzeigen, dass keine Protokolldateien mehr im Workflowlauf verbleiben. - -### Debug-Protokollierung aktivieren - -Wenn die Workflow-Logs nicht genügend Details zur Diagnose enthalten, warum ein Workflow, ein Job oder ein Schritt nicht wie erwartet abläuft, können Sie die zusätzliche Debug-Protokollierung aktivieren. - -Diese zusätzlichen Protokolle werden aktiviert, indem Geheimnisse im Repository, die den Workflow enthalten, gesetzt werden, sodass die gleichen Berechtigungsanforderungen gelten: - -- {% data reusables.github-actions.permissions-statement-secrets-organization %} -- {% data reusables.github-actions.permissions-statement-secrets-repository %} -- {% data reusables.github-actions.permissions-statement-secrets-api %} - -Weitere Informationen zum Festlegen von Geheimnissen finden Sie unter "[Erstellen und Verwenden verschlüsselter Geheimnisse](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". - -#### Diagnose-Protokollierung des Runners aktivieren - -Die Runner-Diagnoseprotokollierung stellt zusätzliche Protokolldateien bereit, die Informationen darüber enthalten, wie ein Läufer einen Auftrag ausführt. In das Protokollarchiv werden zwei weitere Protokolldateien aufgenommen: - -* das Runner-Prozessprotokoll mit Informationen zur Koordinierung und Einrichtung von Runnern für die Ausführung von Aufträgen -* das Worker-Prozessprotokoll, in dem die Ausführung eines Auftrags protokolliert wird - -1. Zum Aktivieren der Runner-Diagnoseprotokollierung legen Sie das folgende Geheimnis im Repository fest, in dem sich der Workflow befindet: `ACTIONS_RUNNER_DEBUG` auf `true`. - -1. Sollen die Runner-Diagnoseprotokolle heruntergeladen werden, laden Sie das Protokollarchiv des Workflow-Laufs herunter. Die Runner-Diagnoseprotokolle befinden sich im Ordner `runner-diagnostic-logs`. Weitere Informationen zum Herunterladen von Protokollen finden Sie unter "[Herunterladen von Protokollen](#downloading-logs)". - -#### Debug-Schrittprotokollierung aktivieren - -Bei der Debug-Schrittprotokollierung werden ausführlichere Protokolle während und nach der Ausführung eines Auftrags erstellt. - -1. Zum Aktivieren der Debug-Schrittprotokollierung legen Sie das folgende Geheimnis im Repository fest, in dem sich der Workflow befindet: `ACTIONS_STEP_DEBUG` auf `true`. - -1. Sobald Sie das Geheimnis festgelegt haben, werden weitere Debug-Ereignisse in den Schrittprotokollen aufgeführt. Weitere Informationen finden Sie unter [„Protokolle zur Fehlerdiagnose anzeigen“](#viewing-logs-to-diagnose-failures). - - -### Weiterführende Informationen - -- „[Informationen zu {% data variables.product.prodname_actions %}](/articles/about-github-actions)“ -- „[Einen Workflow konfigurieren](/articles/configuring-a-workflow)“ -- „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions)“ -- „[Ereignisse, die Workflows auslösen](/articles/events-that-trigger-workflows)“ -- „[Virtuelle Umgebungen für {% data variables.product.prodname_dotcom %}-gehostete Runner](/actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)“ diff --git a/translations/de-DE/content/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts.md b/translations/de-DE/content/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts.md deleted file mode 100644 index 23b6ff11272a..000000000000 --- a/translations/de-DE/content/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts.md +++ /dev/null @@ -1,249 +0,0 @@ ---- -title: Workflow-Daten mit Artefakten als dauerhaft festlegen -intro: Mit Artefakten kannst Du Daten zwischen Aufträgen in einem Workflow freigeben und Daten nach Abschluss des Workflows speichern. -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/persisting-workflow-data-using-artifacts - - /github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts - - /actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Informationen zu Workflow-Artefakten - -Artefakte erlauben es dir, Daten nach dem Job-Abschluss abzuspeichern und diese Daten an einen anderen Job im selben Workflow weiterzugeben. Ein Artefakt ist eine Datei oder eine Dateisammlung, die während einer Workflow-Ausführung erstellt wird. Zum Beispiel kannst Du Artefakte verwenden, um Deine Build- und Testausgabe zu speichern, nachdem ein Workflow-Lauf beendet ist. Für Pushes und Pull-Requests speichert {% data variables.product.product_name %} Artefakte für 90 Tage. Die Aufbewahrungsfrist für einen Pull-Request beginnt jedes Mal neu, wenn jemand an den Pull-Request pusht. - -Dies sind einige der gängigen Artefakte, die du hochladen kannst: - -- Protokolldateien und Coredumps -- Testergebnisse, Fehler und Screenshots -- Binäre oder komprimierte Dateien -- Ergebnisse zur Stresstest-Leistungsausgabe und Codeabdeckung - -{% if currentVersion == "free-pro-team@latest" %} - -Das Speichern von Artefakten verwendet Speicherplatz auf {% data variables.product.product_name %}. {% data reusables.github-actions.actions-billing %} Weitere Informationen findest Du unter „[Abrechnung für {% data variables.product.prodname_actions %} verwalten](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)“. - -{% else %} - -Artefakte verfallen automatisch nach 90 Tagen, aber du kannst jederzeit den verwendeten Speicher auf {% data variables.product.prodname_actions %} wieder verfügbar machen, indem du Artefakte löschst, bevor sie auf {% data variables.product.product_name %} ablaufen. - -{% endif %} - -Artefakte werden während eines Workflow-Laufs hochgeladen und Du kannst den Namen und die Größe eines Artefakts in der Benutzeroberfläche anzeigen. Wenn ein Artefakt mit der {% data variables.product.product_name %}-Oberfläche heruntergeladen wird, werden alle Dateien, die als Teil des Artefakts einzeln hochgeladen wurden, zusammen in eine einzige Datei gezippt. Die Abrechnung erfolgt anhand der Größe des hochgeladenen Artefakts und nicht der Größe der Zip-Datei erfolgt. - -{% data variables.product.product_name %} bietet zwei Aktionen, über die Sie Build-Artefakte hoch- und herunterladen können. Weitere Informationen finden Sie in den Themen zu den Aktionen [actions/upload-artifact](https://github.com/actions/upload-artifact) und [download-artifact](https://github.com/actions/download-artifact). - -Daten zwischen Aufträgen freigeben: - -* **Dateien hochladen**: Gib der hochgeladenen Datei einen Namen und lade die Daten hoch, bevor der Job endet. -* **Dateien herunterladen**: Du kannst nur Artefakte herunterladen, die während des gleichen Workflow-Laufs hochgeladen wurden. Wenn Du eine Datei herunterlädst, kannst Du sie mit Namen referenzieren. - -Die Steps („Schritte“) eines Jobs teilen sich die selbe Umgebung auf der Runner-Maschine, laufen aber in ihren eigenen individuellen Prozessen. Mithilfe von Ein- und Ausgaben können Sie Daten zwischen den Schritten in einem Auftrag weitergeben. Weitere Informationen zu Ein- und Ausgaben finden Sie unter „[Metadatensyntax für {% data variables.product.prodname_actions %}](/articles/metadata-syntax-for-github-actions)“. - -### Daten zwischen Aufträgen in einem Workflow weitergeben - -Du kannst die Aktionen `upload-artifact` und `download-artifact` verwenden, um innerhalb eines Workflows Daten zwischen Jobs auszutauschen. In diesem Beispiel-Workflow wird veranschaulicht, wie Daten zwischen Aufträgen im selben Workflow weitergegeben werden. Weitere Informationen finden Sie in den Themen zu den Aktionen [actions/upload-artifact](https://github.com/actions/upload-artifact) und [download-artifact](https://github.com/actions/download-artifact). - -Von den Artefakten eines vorherigen Auftrags abhängige Aufträge müssen auf den erfolgreichen Abschluss des abhängigen Auftrags warten. Bei diesem Workflow kommt das Stichwort `needs` zum Einsatz, um sicherzustellen, dass `job_1`, `job_2` und `job_3` sequenziell ausgeführt werden. Beispielsweise schreibt `job_2` vor, dass `job_1` die Syntax `needs: job_1` verwendet. - -Auftrag 1 führt die folgenden Schritte durch: -- Führt eine mathematische Berechnung aus und speichert das Ergebnis in einer Textdatei namens `math-homework.txt`. -- Verwendet die Aktion `upload-artifact`, um die Datei `math-homework.txt` mit dem Namen `homework` hochzuladen. Die Aktion platziert die Datei in einem Verzeichnis mit dem Namen `homework`. - -Auftrag 2 verwendet das Ergebnis des vorherigen Auftrags: -- Lädt das im vorherigen Auftrag hochgeladene `homework`-Artefakt herunter. Die Aktion `download-artifact` lädt die Artefakte standardmäßig in das Verzeichnis der Arbeitsoberfläche, in dem der Schritt ausgeführt wird. Du kannst den Eingabeparameter `path` verwenden, um ein anderes Download-Verzeichnis anzugeben. -- Liest den Wert in der Datei `homework/math-homework.txt`, führt eine mathematische Berechnung durch und speichert das Ergebnis in `math-homework.txt`. -- Lädt die Datei `math-homework.txt` hoch. Dieser Upload überschreibt den vorherigen Upload, da beide Uploads den gleichen Namen haben. - -Auftrag 3 zeigt das im vorherigen Auftrag hochgeladene Ergebnis an: -- Lädt das `homework`-Artefakt herunter. -- Gibt das Ergebnis der mathematischen Gleichung im Protokoll aus. - -Die vollständige, in diesem Workflow-Beispiel durchgeführte mathematische Operation lautet `(3 + 7) x 9 = 90`. - -```yaml -name: Daten zwischen Jobs - -teilen: [push] - -Jobs: - job_1: - Name: Hinzufügen von 3 und 7 - -Runs-on: ubuntu-latest - Schritte: - - shell: bash - run: | - expr 3 + 7 > math-homework.txt - - Name: Math-Ergebnis für Job 1 - verwendet: Aktionen/Upload-artifact@v2 - mit: - Name: Hausaufgaben - Pfad: math-homework.txt - - job_2: - Name: Multiplizieren mit 9 - benötigt: job_1 - -Run-on: Windows-neueste - Schritte: - - Name: Download Mathe-Ergebnis für Job 1 - verwendet: Aktionen - - - artifact@v2 - / - value='cat math-homework.txt' - expr $value '* 9 > math-homework.txt - - Name: Math-Ergebnis für Job 2 - verwendet: aktionen/upload-artifact@v2 - mit: - Name: Hausaufgaben - Pfad: math-homework.txt - - job_3: - Name: Anzeigeergebnisse - Bedürfnisse: job_2 - -Auslauf: macOS-neueste - Schritte: - - Name: Mathematisches Ergebnis für Job 2 - verwendet: Aktionen/Download-artifact@v2 - mit: - Name: Hausaufgaben - - Name: Drucken sie das Endergebnis - Shell: bash - run: | - value='cat math-homework.txt' - echo Das Ergebnis ist $value -``` - -![Workflow, der zum Durchführen mathematischer Operationen Daten zwischen Aufträgen weitergibt](/assets/images/help/repository/passing-data-between-jobs-in-a-workflow.png) - -### Daten zwischen Workflow-Ausführungen freigeben - -Nach dem Ende eines Workflows kannst Du eine komprimiert Datei der hochgeladenen Artefakte auf {% data variables.product.product_name %} herunterladen. Suche dazu auf der Registerkarte **Actions** (Aktionen) nach dem gewünschten Workflow-Lauf. Sie können auch die {% data variables.product.prodname_dotcom %} REST-API verwenden, um Artefakte herunterzuladen. Weitere Informationen finden Sie unter "[Artefakte](/v3/actions/artifacts/)". - -{% data variables.product.product_name %} bietet zwei Aktionen, über die Sie Build-Artefakte hoch- und herunterladen können. Weitere Informationen findest Du in den Themen zu den Aktionen [actions/upload-artifact](https://github.com/actions/upload-artifact) und [download-artifact](https://github.com/actions/download-artifact). - -### Build- und Testartefakte hochladen - -Du kannst einen Workflow für kontinuierliche Integration (CI) erstellen, um Deinen Code zu bauen und zu testen. Weitere Informationen zur Verwendung von {% data variables.product.prodname_actions %} zum Ausführen von CI finden Sie unter "[Über kontinuierliche Integration](/articles/about-continuous-integration)." - -Durch die Ergebnisse der Erstellung und des Tests Deines Codes werden oft zum Debuggen von Testfehlern einsetzbare Dateien und bereitstellbarer Produktionscode erstellt. Du kannst einen Workflow konfigurieren, um den per Push-Vorgang an Dein Repository übertragenen Code zu erstellen und zu testen und um einen erfolgreichen oder fehlerhaften Status zu melden. Du kannst die Build- und Testausgabe hochladen, um sie für Bereitstellungen, zum Debuggen fehlerhafter Tests oder von Abstürzen und zum Anzeigen der Testsuite-Abdeckung zu verwenden. - -Du kannst die Aktion `upload-artifact` verwenden um Artefakte hochzuladen. Beim Hochladen eines Artefakts können Sie eine einzelne Datei oder ein Verzeichnis oder mehrere Dateien oder Verzeichnisse angeben. Sie können auch bestimmte Dateien oder Verzeichnisse ausschließen und Platzhaltermuster verwenden. Es wird empfohlen, einen Namen für ein Artefakt bereitzustellen, aber wenn kein Name angegeben wird, wird `Artefakt` als Standardname verwendet. For more information on syntax, see the [actions/upload-artifact](https://github.com/actions/upload-artifact) action. - -#### Beispiel - -Zum Beispiel kann Dein Projektarchiv oder eine Webanwendung SASS- und TypeScript-Dateien enthalten, die Du in CSS und JavaScript konvertieren musst. Falls Dein Build-Konfiguration die kompilierten Dateien im Verzeichnis `dist` ausgibt, würdest Du die im Verzeichnis `dist` enthaltenen Dateien auf Deinem Webanwendungsserver bereitstellen, sofern alle Tests erfolgreich abgeschlossen werden. - -``` -|-- hello-world (repository) -| └── dist -| └── tests -| └── src -| └── sass/app.scss -| └── app.ts -| └── output -| └── test -| -``` - -In diesem Beispiel wird gezeigt, wie Du einen Workflow für ein Node.js-Projekt erstellst, das den Code im `src`-Verzeichnis `erstellt` und die Tests im `tests`-Verzeichnis ausführt. Wenn `npm test` ausgeführt wird, wird im Verzeichnis `output/test/` ein Bericht zur Codeabdeckung mit dem Namen `code-coverage.html` erstellt und gespeichert. - -Der Workflow lädt die Produktionsartefakte in das `dist` Verzeichnis, schließt jedoch alle Markdowndateien aus. Es lädt auch die `code-coverage.html` Bericht als ein weiteres Artefakt. - -```yaml -Name: Node CI - -on: [push] - -jobs: - build_and_test: - läuft auf: ubuntu-latest - schritte: - - name: Checkout repository - verwendet: actions/checkout@v2 - - name: npm install, build, and test - run: | - npm installieren sie - npm run build --if-present - npm test - - name: Archiv production artifacts - uses: actions/upload-artifact@v2 - with: - name: dist-without-markdown - path: | - dist - !dist/**/*md - - Name: Archivcodeabdeckungsergebnisse - verwendet: Aktionen/Upload-artifact@v2 - mit: - Name: code-coverage-report - pfad: output/test/code-coverage.html -``` - -![Bild mit Workflow-Ausführung des Workflow-Upload-Artefakts](/assets/images/help/repository/upload-build-test-artifact.png) - -### Artefakte herunterladen oder löschen - -Während einer Workflowausführung können Sie Artefakte herunterladen, die zuvor in derselben Workflowausführung hochgeladen wurden. Nachdem eine Workflowausführung abgeschlossen wurde, können Sie Artefakte auf GitHub mithilfe des Workflowausführungsverlaufs herunterladen oder löschen. - -#### Herunterladen von Artefakten während einer Workflowausführung - -Die [Aktionen/Download-Artefakt](https://github.com/actions/download-artifact) Aktion können verwendet werden, um zuvor hochgeladene Artefakte während eines Workflowlaufs herunterzuladen. - -{% note %} - -**Hinweis:** Sie können nur Artefakte in einem Workflow herunterladen, die während desselben Workflowlaufs hochgeladen wurden. - -{% endnote %} - -Geben Sie den Namen eines Artefakts an, um ein einzelnes Artefakt herunterzuladen. Wenn Sie ein Artefakt hochgeladen haben, ohne einen Namen anzugeben, lautet der Standardname `Artefakt`. - -```yaml -- Name: Laden Sie ein einzelnes Artefakt - verwendet: Aktionen/Download-artifact@v2 - mit: - Name: my-artifact -``` - -Sie können auch alle Artefakte in einem Workflow herunterladen, der ausgeführt wird, indem Sie keinen Namen angeben. Dies kann nützlich sein, wenn Sie mit vielen Artefakten arbeiten. - -```yaml -- Name: Laden Sie alle Workflow-Ausführungsartefakte - verwendet: Aktionen/Download-artifact@v2 -``` - -Wenn Sie alle Artefakte einer Workflowausführung herunterladen, wird ein Verzeichnis für jedes Artefakt mit seinem Namen erstellt. - -For more information on syntax, see the [actions/download-artifact](https://github.com/actions/download-artifact) action. - -#### Herunterladen und Löschen von Artefakten nach Abschluss eines Workflowlaufs - -Artefakte verfallen automatisch nach 90 Tagen, aber du kannst jederzeit den verwendeten Speicher auf {% data variables.product.prodname_actions %} wieder verfügbar machen, indem du Artefakte löschst, bevor sie auf {% data variables.product.product_name %} ablaufen. - -{% warning %} - -**Warnung:** Sobald Du ein Artefakt löschst, kann es nicht wiederhergestellt werden. - -{% endwarning %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -1. Um Artefakte herunterzuladen, verwendest Du das Dropdownmenü **Artifacts** (Artefakte), und wählst die Artefakte aus, die Du herunterladen möchtest. ![Dropdown-Menü zum Herunterladen von Artefakten](/assets/images/help/repository/artifact-drop-down.png) -1. Um Artefakte zu löschen, benutze das Dropdown-Menü **Artifacts** und klicke auf {% octicon "trashcan" aria-label="The trashcan icon" %}. ![Dropdown-Menü zum Löschen von Artefakten](/assets/images/help/repository/actions-delete-artifact.png) - -{% if currentVersion == "free-pro-team@latest" %} - -### Weiterführende Informationen - -- "[ Abrechnung für {% data variables.product.prodname_actions %} verwalten](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)". - -{% endif %} diff --git a/translations/de-DE/content/actions/configuring-and-managing-workflows/sharing-workflow-templates-within-your-organization.md b/translations/de-DE/content/actions/configuring-and-managing-workflows/sharing-workflow-templates-within-your-organization.md deleted file mode 100644 index f56d93065a4e..000000000000 --- a/translations/de-DE/content/actions/configuring-and-managing-workflows/sharing-workflow-templates-within-your-organization.md +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: Freigeben von Workflowvorlagen in Ihrer Organisation -intro: Sie können einen standardisierten Satz von Workflowvorlagen speziell für Ihre Organisation erstellen. Organisationsmitglieder können die Vorlagen dann beim Erstellen neuer Workflows in den Organisations-Repositorys verwenden. -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -Workflowvorlagen können von Benutzern mit Schreibzugriff auf die `.github` Repository der Organisation erstellt werden. Die Vorlagen können dann von Organisationsmitgliedern verwendet werden, die über die Berechtigung zum Erstellen von Workflows verfügen. - -Workflowvorlagen können verwendet werden, um neue Workflows in öffentlichen Repositorys einer Organisation zu erstellen. Um Vorlagen zum Erstellen von Workflows in privaten Repositorys zu verwenden, muss die Organisation Teil eines Unternehmens- oder GitHub One-Plans sein. - -### Erstellen einer Workflowvorlage - -In diesem Verfahren wird veranschaulicht, wie eine Workflowvorlage und eine Metadatendatei erstellt werden. Die Metadatendatei beschreibt, wie die Vorlage benutzern beim Erstellen eines neuen Workflows angezeigt wird. - -1. Wenn es noch nicht vorhanden ist, erstellen Sie ein neues öffentliches Repository mit dem Namen `.github` in Ihrer Organisation. -1. Erstellen Sie ein Verzeichnis mit dem Namen `Workflowvorlagen`. -1. Erstellen Sie Ihre neue Workflowdatei im `Workflow-Vorlagen` Verzeichnis. - - Wenn Sie auf den Standardzweig eines Repositorys verweisen müssen, können Sie den `$default-branch` Platzhalter verwenden. Wenn ein Workflow mit Ihrer Vorlage erstellt wird, wird der Platzhalter automatisch durch den Namen der Standardverzweigung des Repositorys ersetzt. - - Diese Datei mit dem Namen `octo-organization-ci.yml` veranschaulicht beispielsweise einen grundlegenden Workflow. - - ```yaml - Name: Octo Organization CI - - on: - push: - branch: [ $default-branch ] - pull_request: - branches: [ $default-branch ] - - jobs: - build: - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - - name: Run a one-line script - run: echo Hello from Octo Organization - ``` -1. Erstellen Sie eine Metadatendatei im `Workflow-Vorlagen` Verzeichnis. Die Metadatendatei muss denselben Namen wie die Workflowdatei haben, aber anstelle der Erweiterung `.yml` muss sie mit `.properties.json`angehängt werden. Diese Datei mit dem Namen `octo-organization-ci.properties.json enthält` beispielsweise die Metadaten für eine Workflowdatei mit dem Namen `octo-organization-ci.yml`: - ```yaml - • - "Name": "Octo Organization Workflow", - "beschreibung": "Octo Organization CI workflow template.", - "iconName": "example-icon", - "categories": [ - "Go" - ], - "filePatterns": [ - "package.json - - - - " - ``` - * `Name` - **erforderlich.** Der Name der Workflowvorlage. Dies wird in der Liste der verfügbaren Vorlagen angezeigt. - * `Beschreibung` - **erforderlich.** Die Beschreibung der Workflowvorlage. Dies wird in der Liste der verfügbaren Vorlagen angezeigt. - * `iconName` - **Erforderlich.** Definiert ein Symbol für den Eintrag des Workflows in der Vorlagenliste. Der `iconName` muss ein SVG-Symbol mit demselben Namen sein und in den `Workflow-Vorlagen` Verzeichnis gespeichert werden. Beispielsweise wird eine SVG-Datei mit dem Namen `example-icon.svg` als `Beispielsymbol`referenziert. - * `Kategorien` - **Optional.** Definiert die Sprachkategorie des Workflows. Wenn ein Benutzer die verfügbaren Vorlagen anzeigt, werden die Vorlagen, die derselben Sprache entsprechen, stärker in den Vordergrund gerückt. Informationen zu den verfügbaren Sprachkategorien finden Sie unter https://github.com/github/linguist/blob/master/lib/linguist/languages.yml. - * `filePatterns` - **Optional.** Ermöglicht die Verwendung der Vorlage, wenn das Repository des Benutzers eine Datei im Stammverzeichnis enthält, die einem definierten regulären Ausdruck entspricht. - -Um eine weitere Workflowvorlage hinzuzufügen, fügen Sie Ihre Dateien `Workflow-Vorlagen` -Verzeichnis hinzu. Ein Beispiel: - -![Workflow-Vorlagendateien](/assets/images/help/images/workflow-template-files.png) - -### Verwenden einer Workflowvorlage - -In diesem Verfahren wird veranschaulicht, wie ein Mitglied Ihrer Organisation eine Workflowvorlage finden und verwenden kann, um einen neuen Workflow zu erstellen. Die Workflowvorlagen einer Organisation können von jedem Benutzer verwendet werden, der Mitglied der Organisation ist. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -1. Wenn Ihr Repository bereits über vorhandene Workflows verfügt: Klicken Sie in der linken oberen Ecke auf **Neuer Workflow**. ![Erstelle einen neuen Workflow](/assets/images/help/repository/actions-new-workflow.png) -1. Die Workflowvorlagen Ihrer Organisation befinden sich in ihrem eigenen Abschnitt mit dem Titel "Workflows, die von _Organisationsnamen_erstellt wurden". Klicke unter dem Namen der zu verwendenden Vorlage auf **Set up this workflow** (Workflow einrichten). ![Einrichten dieses Workflows](/assets/images/help/settings/actions-create-starter-workflow.png) diff --git a/translations/de-DE/content/actions/configuring-and-managing-workflows/using-databases-and-service-containers.md b/translations/de-DE/content/actions/configuring-and-managing-workflows/using-databases-and-service-containers.md deleted file mode 100644 index 584278c7c198..000000000000 --- a/translations/de-DE/content/actions/configuring-and-managing-workflows/using-databases-and-service-containers.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Datenbanken und Service-Container verwenden -intro: 'Verbinde Datenbanken und Service-Container, um Workflow-Tools zu verwalten.' -mapTopic: true -redirect_from: - - /actions/automating-your-workflow-with-github-actions/using-databases-and-services -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/de-DE/content/actions/configuring-and-managing-workflows/using-environment-variables.md b/translations/de-DE/content/actions/configuring-and-managing-workflows/using-environment-variables.md deleted file mode 100644 index 28218ab36ad8..000000000000 --- a/translations/de-DE/content/actions/configuring-and-managing-workflows/using-environment-variables.md +++ /dev/null @@ -1,68 +0,0 @@ ---- -title: Umgebungsvariablen benutzen -intro: '{% data variables.product.prodname_dotcom %} setzt Standard-Umgebungsvariablen für jeden {% data variables.product.prodname_actions %}-Workflow-Lauf. Du kannst auch benutzerdefinierte Umgebungsvariablen in Deiner Workflow-Datei festlegen.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /github/automating-your-workflow-with-github-actions/using-environment-variables - - /actions/automating-your-workflow-with-github-actions/using-environment-variables -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Informationen zu Umgebungsvariablen - -{% data variables.product.prodname_dotcom %} setzt Standard-Umgebungsvariablen, die für jeden Schritt in einem Workflow-Lauf verfügbar sind. Bei Umgebungsvariablen wird die Groß-/Kleinschreibung berücksichtigt. Befehle, die in Aktionen oder „Steps“ (Schritten) ausgeführt werden, können Umgebungsvariablen erstellen, lesen und ändern. - -Um benutzerdefinierte Umgebungsvariablen festzulegen, musst Du die Variablen in der Workflow-Datei angeben. Du kannst Umgebungsvariablen für einen „Step“ (Schritt), Job, oder ganzen Workflow festlegen, indem Du die Schlüsselworte [`jobs..steps.env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsenv), [`jobs..env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idenv) oder [`env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#env) verwendest. Weitere Informationen findest Du unter „[Workflow-Syntax für {% data variables.product.prodname_dotcom %}](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepsenv)“. - -```yaml -steps: - - name: Hello world - run: echo Hello world $FIRST_NAME $middle_name $Last_Name! - env: - FIRST_NAME: Mona - middle_name: The - Last_Name: Octocat -``` - -Du kannst auch den Workflow-Befehl `set-env` benutzen, um eine Umgebungsvariable festzulegen, die in späteren Schritten ides Workflows verwendet werden kann. Der Befehl `set-env` kann von einer Aktion direkt oder als Shell-Befehl in einer Workflow-Datei mit dem Schlüsselwort `run` verwendet werden. Weitere Informationen findest Du unter „[Workflow-Befehle für {% data variables.product.prodname_actions %}](/actions/reference/workflow-commands-for-github-actions/#setting-an-environment-variable)“. - -### Standard-Umgebungsvariablen - -Es wird dringend empfohlen, dass Aktionen Umgebungsvariablen verwenden, um auf das Dateisystem zuzugreifen, anstatt hartcodierte Dateipfade zu verwenden. {% data variables.product.prodname_dotcom %} legt Umgebungsvariablen für Aktionen fest, die in allen Runner-Umgebungen verwendet werden sollen. - -| Umgebungsvariable | Beschreibung | -| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `CI` | Immer auf `true` gesetzt. | -| `HOME` | Pfad zum {% data variables.product.prodname_dotcom %}-Startverzeichnis, in dem die Benutzerdaten gespeichert werden. Beispiel: `/github/home`. | -| `GITHUB_WORKFLOW` | Der Name des Workflows. | -| `GITHUB_RUN_ID` | {% data reusables.github-actions.run_id_description %} | -| `GITHUB_RUN_NUMBER` | {% data reusables.github-actions.run_number_description %} | -| `GITHUB_ACTION` | Die eindeutige Kennung (`id`) der Aktion. | -| `GITHUB_ACTIONS` | Immer auf `true` gesetzt, wenn {% data variables.product.prodname_actions %} den Workflow ausführt. Du kannst diese Variable verwenden, um zu differenzieren, wann Tests lokal oder von {% data variables.product.prodname_actions %} durchgeführt werden. | -| `GITHUB_ACTOR` | Name der Person oder App, die den Workflow initiiert hat. Beispiel: `octocat`. | -| `GITHUB_REPOSITORY` | Der Inhaber- und Repository-Name, Beispiel: `octocat/Hello-World`. | -| `GITHUB_EVENT_NAME` | Name des Webhook-Ereignisses, das den Workflow ausgelöst hat. | -| `GITHUB_EVENT_PATH` | Pfad der Datei mit der gesamten Nutzlast des Webhook-Ereignisses. Beispiel: `/github/workflow/event.json`. | -| `GITHUB_WORKSPACE` | Pfad zum Verzeichnis der Arbeitsoberfläche von {% data variables.product.prodname_dotcom %}. Das Arbeitsoberflächen-Verzeichnis enthält ein Unterverzeichnis mit einer Kopie Deines Repositorys, wenn Dein Workflow die Aktion [actions/checkout](https://github.com/actions/checkout) verwendet. Wenn Du die Aktion `actions/checkout` nicht verwendest, ist das Verzeichnis leer. Beispiel: `/home/runner/work/my-repo-name/my-repo-name`. | -| `GITHUB_SHA` | Commit-SHA, die den Workflow ausgelöst hat. Beispiel: `ffac537e6cbbf934b08745a378932722df287a53`. | -| `GITHUB_REF` | Branch- oder Tag-Ref, das den Workflow ausgelöst hat. Beispiel: `refs/heads/feature-branch-1`. Wenn für den Ereignistyp weder ein Branch noch ein Tag vorliegt, ist die Variable nicht vorhanden. | -| `GITHUB_HEAD_REF` | Nur für geforkte Repositorys festgelegt. Der Branch des Head-Repositorys. | -| `GITHUB_BASE_REF` | Nur für geforkte Repositorys festgelegt. Der Branch des Basis-Repositorys. | -| `GITHUB_SERVER_URL` | Gibt die URL des {% data variables.product.product_name %} -Servers zurück. For example: `https://github.com`. | -| `GITHUB_API_URL` | Gibt die API-URL zurück. For example: `https://api.github.com`. | -| `GITHUB_GRAPHQL_URL` | Gibt die GraphQL-API-URL zurück. For example: `https://api.github.com/graphql`. | - -### Namens-Konventionen für Umgebungsvariablen - -{% note %} - -**Hinweis:** In {% data variables.product.prodname_dotcom %} ist das Umgebungsvariablen-Präfix `GITHUB_` für den internen Gebrauch durch {% data variables.product.prodname_dotcom %} reserviert. Wenn Sie eine Umgebungsvariable oder ein Geheimnis mit dem Präfix `GITHUB_` anlegen, tritt ein Fehler auf. - -{% endnote %} - -Alle neuen Umgebungsvariablen, die auf einen Speicherort im Dateisystem verweisen, müssen das Suffix `_PATH` erhalten. Die Standardvariablen `HOME` und `GITHUB_WORKSPACE` sind von dieser Konvention ausgenommen, da die Bezeichnungen „home“ und „workspace“ bereits einen Speicherort implizieren. diff --git a/translations/de-DE/content/actions/configuring-and-managing-workflows/using-variables-and-secrets-in-a-workflow.md b/translations/de-DE/content/actions/configuring-and-managing-workflows/using-variables-and-secrets-in-a-workflow.md deleted file mode 100644 index a903ee4f490a..000000000000 --- a/translations/de-DE/content/actions/configuring-and-managing-workflows/using-variables-and-secrets-in-a-workflow.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Variablen und Geheimnisse in einem Workflow verwenden -intro: 'Verwende verschlüsselte Geheimnisse, Variablen und Token in Deinen Workflows, um Dein Repository zu schützen.' -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/de-DE/content/actions/getting-started-with-github-actions/about-github-actions.md b/translations/de-DE/content/actions/getting-started-with-github-actions/about-github-actions.md deleted file mode 100644 index 005a7c2490dd..000000000000 --- a/translations/de-DE/content/actions/getting-started-with-github-actions/about-github-actions.md +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: Informationen zu GitHub Actions -intro: 'Mit {% data variables.product.prodname_actions %} kannst Du benutzerdefinierte Workflows für den gesamten Lebenszyklus der Softwareentwicklung direkt im {% data variables.product.prodname_dotcom %}-Repository erstellen.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/migrating-github-actions-from-hcl-syntax-to-yaml-syntax/ - - /articles/about-github-actions - - /github/automating-your-workflow-with-github-actions/about-github-actions - - /actions/automating-your-workflow-with-github-actions/about-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Informationen zu {% data variables.product.prodname_actions %} - -{% data reusables.repositories.about-github-actions %}-Workflows sind benutzerdefinierte automatisierte Prozesse, die Sie in Ihrem Repository einrichten können, um ein Code-Projekt auf {% data variables.product.prodname_dotcom %} zu erstellen, zu testen, zu packen, freizugeben oder bereitzustellen. - -{% data variables.product.prodname_actions %} von {% data reusables.repositories.actions-ci-cd %} aktivieren den eingebauten Dienst für kontinuierliche Integrations von {% data variables.product.prodname_dotcom %}. Weitere Informationen finden Sie unter „[Informationen zur fortlaufenden Integration](/articles/about-continuous-integration)“. - -Workflows laufen unter Linux, macOS, Windows und in Containern auf {% data variables.product.prodname_dotcom %}-gehosteten Rechnern, ‚Runners‘ genannt. Alternativ kannst Du auch Deine eigenen Runner betreiben, um Workflows auf Maschinen auszuführen, die Du besitzt oder verwaltest. Weitere Informationen findest Du unter "[Informationen zu selbst-gehosteten Runnnern](/actions/automating-your-workflow-with-github-actions/about-self-hosted-runners)." - -Sie können Workflows mithilfe von Aktionen erstellen, die im Repository definiert sind, mit Open-Source-Aktionen in einem öffentlichen Repository in {% data variables.product.prodname_dotcom %} oder mithilfe eines veröffentlichten Docker-Container-Images. Workflows in geforkten Repositorys werden standardmäßig nicht ausgeführt. - -Sie können mögliche Aktionen für Ihren Workflow auf {% data variables.product.prodname_dotcom %} erkunden und Aktionen für die Freigabe in der {% data variables.product.prodname_dotcom %}-Community erstellen. For more information on creating a custom action, see "[Creating actions](/actions/creating-actions)." - -Sie können eine Workflow-Datei erstellen und für die Ausführung bei bestimmten Ereignissen konfigurieren. Weitere Informationen finden Sie unter „[Einen Workflow konfigurieren](/articles/configuring-a-workflow)“ und „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions)“. - -Eine Definition von gebräuchlichen Begriffen findest Du unter "[Kernkonzepte für {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)." - -### Aktionen in der {% data variables.product.prodname_dotcom %}-Community - -{% data variables.product.prodname_marketplace %} ist eine zentrale Stelle, an der Du Aktionen der {% data variables.product.prodname_dotcom %}-Gemeinschaft finden, zur Verfügung stellen und nutzen kannst. Weitere Informationen findest Du unter "[Aktionen vom {% data variables.product.prodname_marketplace %} in Deinem Workflow verwenden](/actions/automating-your-workflow-with-github-actions/using-actions-from-github-marketplace-in-your-workflow)." - -Du kannst Dein Projekt auch mit Open-Source-Aktionen aus öffentlichen Repositorys auf {% data variables.product.prodname_dotcom %} anpassen und Aktionen verwenden , die von {% data variables.product.prodname_dotcom %} in der Organisation [Aktionen](https://github.com/actions) gebaut wurden. - -### {% data variables.product.prodname_actions %} für Dein Repository oder Deine Organisation deaktivieren oder beschränken - -{% data reusables.github-actions.disabling-github-actions %} - -Weitere Information findest Du unter „[{% data variables.product.prodname_actions %} für ein Repository deaktivieren oder beschränken](/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository)“ oder „[{% data variables.product.prodname_actions %} für Deine Organisation deaktivieren oder beschränken](/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization)“. - -### Benachrichtigungen für Workflow-Läufe - -{% data reusables.repositories.workflow-notifications %} - -### Nutzungseinschränkungen - -{% data reusables.github-actions.github-actions-usage-limits %} - -{% if currentVersion == "free-pro-team@latest" %} - -### Nutzungsrichtlinien - -Neben den Nutzungsbeschränkungen musst Du auch sicherstellen, dass Du {% data variables.product.prodname_actions %} innerhalb der [GitHub-Nutzungsbedingungen](/articles/github-terms-of-service/) verwendest. Weitere Informationen zu {% data variables.product.prodname_actions %}-spezifischen Bedingungen findest Du unter [Zusätzliche Produktbedingungen für GitHub](/github/site-policy/github-additional-product-terms#a-actions-usage). - -### Informationen zur Abrechnung für {% data variables.product.prodname_actions %} - -{% data reusables.github-actions.actions-billing %} Weitere Informationen findest Du unter „[Informationen zur Abrechnung für {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions)“. - -### Support kontaktieren - -{% data reusables.github-actions.contacting-support %} - -{% endif %} - -### Weiterführende Informationen - -- „[Einen Workflow-Lauf verwalten](/articles/managing-a-workflow-run)“ -- „[Ereignisse, die Workflows auslösen](/articles/events-that-trigger-workflows)“ -- „[Virtuelle Umgebungen für {% data variables.product.prodname_dotcom %}-gehostete Runner](/actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)“ -„[Abrechnung für {% data variables.product.prodname_actions %} verwalten](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)“ diff --git a/translations/de-DE/content/actions/getting-started-with-github-actions/core-concepts-for-github-actions.md b/translations/de-DE/content/actions/getting-started-with-github-actions/core-concepts-for-github-actions.md deleted file mode 100644 index 94421ab8f037..000000000000 --- a/translations/de-DE/content/actions/getting-started-with-github-actions/core-concepts-for-github-actions.md +++ /dev/null @@ -1,76 +0,0 @@ ---- -title: Kernkonzepte für GitHub-Aktionen -shortTitle: Kernkonzepte -intro: 'Nachfolgend findest Du eine Liste der gängigen {% data variables.product.prodname_actions %}-Begriffe, die wir auf unseren Webseiten und in der {% data variables.product.prodname_actions %}-Dokumentation verwenden.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions - - /actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Aktion - -Einzelne Aufgaben, die als Schritte zu einem Auftrag kombiniert werden. Aktionen sind der kleinste portable Baustein eines Workflows. Sie können eigene Aktionen erstellen, veröffentlichte Aktionen aus der {% data variables.product.prodname_dotcom %}-Community heranziehen und öffentliche Aktionen anpassen. Soll eine Aktion in einem Workflow verwendet werden, müssen Sie sie als Schritt einfügen. - -### Artefakt - -Artefakte sind die Dateien, die erstellt werden, wenn Sie Ihren Code erstellen und testen. Artefakte können beispielsweise Binär- oder Paketdateien, Testergebnisse, Screenshots oder Protokolldateien sein. Artefakte sind mit dem Workflow-Lauf verknüpft, in dem sie erstellt wurden, und können von einem anderen Auftrag verwendet oder auch bereitgestellt werden. - -### Fortlaufende Integration („continuous integration“, CI) - -Praktik in der Softwareentwicklung, bei der häufige Commits kleiner Codeänderungen an ein gemeinsames Repository erfolgen. Bei {% data variables.product.prodname_actions %} können Sie benutzerdefinierte CI-Workflows erstellen, die automatisierte Builds und Tests der Codes ausführen. Im Repository sehen Sie den Status Ihrer Codeänderungen sowie ausführliche Protokolle für die einzelnen Aktionen im Workflow. Die CI bedeutet eine Zeitersparnis für die Entwickler: Die CI liefert sofortiges Feedback zu Codeänderungen, sodass Bugs rascher erkannt und behoben werden können. - -### Fortlaufende Bereitstellung („continuous deployment“, CD) - -Die fortlaufende Bereitstellung baut auf der fortlaufenden Integration auf. Wenn neuer Code nach dem Commit die CI-Tests besteht, wird der Code automatisch in der Produktionsumgebung bereitgestellt. Mit {% data variables.product.prodname_actions %} können Sie benutzerdefinierte CD-Workflows erstellen und damit den Code aus dem Repository heraus automatisch in einer Cloud, in einem selbst gehosteten Dienst oder auf einer Plattform bereitstellen. Die CD bedeutet eine Zeitersparnis für die Entwickler: Sie automatisiert den Bereitstellungsprozess, sodass getestete, stabile Codeänderungen schneller für die Kunden bereitgestellt werden. - -### Ereignis - -Bestimmte Aktivität, die einen Workflow-Lauf auslöst. Die Aktivität kann beispielsweise von {% data variables.product.prodname_dotcom %} stammen, wenn ein Commit an Repository gepusht oder wenn ein Issue oder ein Pull Request erstellt wird. Mit dem Sende-Webhook des Repositorys können Sie einen Workflow außerdem so konfigurieren, dass er ausgeführt wird, wenn ein externes Ereignis eintritt. - -### {% data variables.product.prodname_dotcom %}-gehostete Runner -{% data variables.product.prodname_dotcom %} hostet Linux-, Windows- und macOS-Runner. Jobs laufen in einer frischen Instanz einer virtuellen Maschine, auf der übliche Software vorinstalliert ist. {% data variables.product.prodname_dotcom %} führt alle Upgrades von {% data variables.product.prodname_dotcom %}-gehosteten Runnern durch und wartet diese auch. Du kannst die Hardwarekonfiguration von {% data variables.product.prodname_dotcom %}-gehosteten Runnern nicht anpassen. Weitere Informationen findest Du unter "[Virtuelle Umgebungen für {% data variables.product.prodname_dotcom %}-gehostete Runner](/github/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)." - -### Job - -Eine Reihe von „Steps“ (Schritten), die auf dem gleichen Runner ausgeführt werden. Sie können die Abhängigkeitsregeln für die Ausführung der Aufträge in einer Workflow-Datei definieren. Jobs können parallel oder sequentiell ausgeführt werden, je nach Status eines vorherigen Jobs. Ein Workflow kann beispielsweise zwei sequentielle Aufträge umfassen, in denen der Code erstellt und getestet wird, wobei der Testauftrag vom Status des Build-Auftrags abhängig ist. Wenn der Build-Auftrag fehlschlägt, wird der Testauftrag nicht ausgeführt. Für {% data variables.product.prodname_dotcom %}-gehostete Runner läuft jeder Job eines Workflows in einer frischen Instanz einer virtuellen Umgebung. - -### Runner - -Beliebeige Maschine, auf der die {% data variables.product.prodname_actions %}-Runner-Anwendung installiert ist. Du kannst einen von {% data variables.product.prodname_dotcom %} gehosteten Runner verwenden oder Deinen eigenen Runner betreiben. Ein Runner wartet auf verfügbare Jobs. Wenn ein Runner einen Job aufgreift, führt er die Aktionen aus und meldet den Fortschritt, Protokolle und Endergebnisse zurück an {% data variables.product.prodname_dotcom %}. Runner führen immer nur einen Auftrag aus, nicht mehrere Aufträge gleichzeitig. Weitere Informationen findest Du unter "[{% data variables.product.prodname_dotcom %}-gehosteter Runner](#github-hosted-runner)" und "[Selbst-gehosteter Runner](#self-hosted-runner)." - -{% note %} - -**Hinweis:** {% data reusables.github-actions.runner-app-open-source %} - -{% endnote %} - -### Selbst-gehosteter Runner - -Ein Computer, den Sie selbst verwalten und warten, auf dem die „self-hosted runner application“ (Anwenung für selbst-gehostete Runner) installiert ist. {% data reusables.github-actions.self-hosted-runner-description %} Weitere Informationenfindest Du unter „[Deinen eigenen Runner hosten](/github/automating-your-workflow-with-github-actions/hosting-your-own-runners)“. - -### Schritt - -Ein Step ist eine individuelle Aufgabe, die Befehle oder Aktionen ausführen kann. Ein Job konfiguriert einen oder mehrere Steps. Alle Steps in einem Job werden auf dem selben Runner ausgeführt, so dass die Aktionen in diesem Job Informationen über das Dateisystem austauschen können. - -### Virtuelle Umgebung - -Die virtuelle Umgebung eines {% data variables.product.prodname_dotcom %}-gehosteten Runners umfasst die Hardware-Konfiguration, das Betriebssystem und die installierte Software der virtuellen Maschine. Weitere Informationen findest Du unter "[Virtuelle Umgebungen für {% data variables.product.prodname_dotcom %}-gehostete Runner](/github/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)." - -### Workflow - -Konfigurierbarer automatisierter Prozess, den Sie in Ihrem Repository einrichten können, um ein Projekt auf {% data variables.product.prodname_dotcom %} zu erstellen, zu testen, zu packen, freizugeben oder bereitzustellen. Workflows bestehen aus mindestens einem Auftrag und können geplant oder auch durch ein Ereignis ausgelöst werden. - -### Workflow-Datei - -YAML-Datei, mit der die Workflow-Konfiguration mit mindestens einem Auftrag definiert wird. Diese Datei befindet sich im Root des {% data variables.product.prodname_dotcom %}-Repositorys im Verzeichnis `.github/workflows`. - -### Workflow-Lauf - -Instanz des Workflows, die ausgeführt wird, wenn das vorkonfigurierte Ereignis eintritt. Sie können die Aufträge, Aktionen, Protokolle und Statusangaben für die einzelnen Workflow-Läufe einsehen. diff --git a/translations/de-DE/content/actions/getting-started-with-github-actions/index.md b/translations/de-DE/content/actions/getting-started-with-github-actions/index.md deleted file mode 100644 index 83ab0e4ac0be..000000000000 --- a/translations/de-DE/content/actions/getting-started-with-github-actions/index.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: Erste Schritte mit GitHub Actions -shortTitle: Erste Schritte -intro: '{% data variables.product.prodname_actions %} umfassen eine leistungsstarke Ausführungsumgebung, die in jeden Schritt Deines Workflows integriert ist. Du kannst {% data variables.product.prodname_actions %} entdecken, erstellen und freigeben, um jeden beliebigen Auftrag auszuführen.' -redirect_from: - - /articles/getting-started-with-github-actions - - /github/automating-your-workflow-with-github-actions/getting-started-with-github-actions - - /actions/automating-your-workflow-with-github-actions/getting-started-with-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -{% topic_link_in_list /overview %} - {% link_in_list /about-github-actions %} - {% link_in_list /core-concepts-for-github-actions %} - {% link_in_list /security-hardening-for-github-actions %} -{% topic_link_in_list /using-community-workflows-and-actions %} - {% link_in_list /starting-with-preconfigured-workflow-templates %} - {% link_in_list /using-actions-from-github-marketplace %} diff --git a/translations/de-DE/content/actions/getting-started-with-github-actions/overview.md b/translations/de-DE/content/actions/getting-started-with-github-actions/overview.md deleted file mode 100644 index eea5b39859a6..000000000000 --- a/translations/de-DE/content/actions/getting-started-with-github-actions/overview.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Übersicht -intro: 'Erfahre mehr über Konzepte und Terminologie von {% data variables.product.prodname_actions %}.' -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/de-DE/content/actions/getting-started-with-github-actions/security-hardening-for-github-actions.md b/translations/de-DE/content/actions/getting-started-with-github-actions/security-hardening-for-github-actions.md deleted file mode 100644 index c8f72bf1dacb..000000000000 --- a/translations/de-DE/content/actions/getting-started-with-github-actions/security-hardening-for-github-actions.md +++ /dev/null @@ -1,93 +0,0 @@ ---- -title: Security hardening for GitHub Actions -shortTitle: Security hardening -intro: 'Good security practices for using {% data variables.product.prodname_actions %} features.' -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -This guide explains how to configure security hardening for certain {% data variables.product.prodname_actions %} features. If the {% data variables.product.prodname_actions %} concepts are unfamiliar, see "[Core concepts for GitHub Actions](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)." - -### Using secrets - -Sensitive values should never be stored as plaintext in workflow files, but rather as secrets. [Secrets](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets) can be configured at the organization or repository level, and allow you to store sensitive information in {% data variables.product.product_name %}. - -Secrets use [Libsodium sealed boxes](https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes), so that they are encrypted before reaching {% data variables.product.product_name %}. This occurs when the secret is submitted [using the UI](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets#creating-encrypted-secrets-for-a-repository) or through the [REST API](/rest/reference/actions#secrets). This client-side encryption helps the minimize risks related to accidental logging (for example, exception logs and request logs, among others) within {% data variables.product.product_name %}'s infrastructure. Once the secret is uploaded, {% data variables.product.product_name %} is then able to decrypt it so that it can be injected into the workflow runtime. - -To help prevent accidental disclosure, {% data variables.product.product_name %} uses a mechanism that attempts to redact any secrets that appear in run logs. This redaction looks for exact matches of any configured secrets, as well as common encodings of the values, such as Base64. However, because there are multiple ways a secret value can be transformed, this redaction is not guaranteed. As a result, there are certain proactive steps and good practices you should follow to help ensure secrets are redacted, and to limit other risks associated with secrets: - -- **Never use structured data as a secret** - - Unstructured data can cause secret redaction within logs to fail, because redaction largely relies on finding an exact match for the specific secret value. For example, do not use a blob of JSON, XML, or YAML (or similar) to encapsulate a secret value, as this significantly reduces the probability the secrets will be properly redacted. Instead, create individual secrets for each sensitive value. -- **Register all secrets used within workflows** - - If a secret is used to generate another sensitive value within a workflow, that generated value should be formally [registered as a secret](https://github.com/actions/toolkit/tree/master/packages/core#setting-a-secret), so that it will be redacted if it ever appears in the logs. For example, if using a private key to generate a signed JWT to access a web API, be sure to register that JWT as a secret or else it won’t be redacted if it ever enters the log output. - - Registering secrets applies to any sort of transformation/encoding as well. If your secret is transformed in some way (such as Base64 or URL-encoded), be sure to register the new value as a secret too. -- **Audit how secrets are handled** - - Audit how secrets are used, to help ensure they’re being handled as expected. You can do this by reviewing the source code of the repository executing the workflow, and checking any actions used in the workflow. For example, check that they’re not sent to unintended hosts, or explicitly being printed to log output. - - View the run logs for your workflow after testing valid/invalid inputs, and check that secrets are properly redacted, or not shown. It's not always obvious how a command or tool you’re invoking will send errors to `STDOUT` and `STDERR`, and secrets might subsequently end up in error logs. As a result, it is good practice to manually review the workflow logs after testing valid and invalid inputs. -- **Use credentials that are minimally scoped** - - Make sure the credentials being used within workflows have the least privileges required, and be mindful that any user with write access to your repository has read access to all secrets configured in your repository. -- **Audit and rotate registered secrets** - - Periodically review the registered secrets to confirm they are still required. Remove those that are no longer needed. - - Rotate secrets periodically to reduce the window of time during which a compromised secret is valid. - -### Using third-party actions - -The individual jobs in a workflow can interact with (and compromise) other jobs. For example, a job querying the environment variables used by a later job, writing files to a shared directory that a later job processes, or even more directly by interacting with the Docker socket and inspecting other running containers and executing commands in them. - -This means that a compromise of a single action within a workflow can be very significant, as that compromised action would have access to all secrets configured on your repository, and can use the `GITHUB_TOKEN` to write to the repository. Consequently, there is significant risk in sourcing actions from third-party repositories on {% data variables.product.prodname_dotcom %}. You can help mitigate this risk by following these good practices: - -* **Pin actions to a full length commit SHA** - - Pinning an action to a full length commit SHA is currently the only way to use an action as an immutable release. Pinning to a particular SHA helps mitigate the risk of a bad actor adding a backdoor to the action's repository, as they would need to generate a SHA-1 collision for a valid Git object payload. - - {% warning %} - - **Warning:** The short version of the commit SHA is insecure and should never be used for specifying an action's Git reference. Because of how repository networks work, any user can fork the repository and push a crafted commit to it that collides with the short SHA. This causes subsequent clones at that SHA to fail because it becomes an ambiguous commit. As a result, any workflows that use the shortened SHA will immediately fail. - - {% endwarning %} -* **Audit the source code of the action** - - Ensure that the action is handling the content of your repository and secrets as expected. For example, check that secrets are not sent to unintended hosts, or are not inadvertently logged. - -* **Pin actions to a tag only if you trust the creator** - - Although pinning to a commit SHA is the most secure option, specifying a tag is more convenient and is widely used. If you’d like to specify a tag, then be sure that you trust the action's creators. The ‘Verified creator’ badge on {% data variables.product.prodname_marketplace %} is a useful signal, as it indicates that the action was written by a team whose identity has been verified by {% data variables.product.prodname_dotcom %}. Note that there is risk to this approach even if you trust the author, because a tag can be moved or deleted if a bad actor gains access to the repository storing the action. - -### Considering cross-repository access - -{% data variables.product.product_name %} is intentionally scoped for a single repository at a time. The `GITHUB_TOKEN` used in the workflow environment grants the same level of access as a write-access user, because any write-access user can access this token by creating or modifying workflow files. Users have specific permissions for each repository, so having the `GITHUB_TOKEN` for one repository grant access to another would impact the {% data variables.product.prodname_dotcom %} permission model if not implemented carefully. Similarly, caution must be taken when adding {% data variables.product.prodname_dotcom %} authentication tokens to the workflow environment, because this can also affect the {% data variables.product.prodname_dotcom %} permission model by inadvertently granting broad access to collaborators. - -We have [a plan on the {% data variables.product.prodname_dotcom %} roadmap](https://github.com/github/roadmap/issues/74) to support a flow that allows cross-repository access within {% data variables.product.product_name %}, but this is not yet a supported feature. Currently, the only way to perform privileged cross-repository interactions is to place a {% data variables.product.prodname_dotcom %} authentication token or SSH key as a secret within the workflow environment. Because many authentication token types do not allow for granular access to specific resources, there is significant risk in using the wrong token type, as it can grant much broader access than intended. - -This list describes the recommended approaches for accessing repository data within a workflow, in descending order of preference: - -1. **The `GITHUB_TOKEN` in the workflow environment** - - This token is intentionally scoped to the single repository that invoked the workflow, and has the same level of access as a write-access user on the repository. The token is created before each job begins and expires when the job is finished. Weitere Informationen findest Du unter „[Authentifizierung mit dem GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)." - - The `GITHUB_TOKEN` should be used whenever possible. -2. **Repository deploy key** - - Deploy keys are one of the only credential types that grant read or write access to a single repository, and can be used to interact with another repository within a workflow. For more information, see "[Managing deploy keys](/developers/overview/managing-deploy-keys#deploy-keys)." - - Note that deploy keys can only clone and push to the repository using Git, and cannot be used to interact with the REST or GraphQL API, so they may not be appropriate for your requirements. -3. **{% data variables.product.prodname_github_app %} tokens** - - {% data variables.product.prodname_github_apps %} can be installed on select repositories, and even have granular permissions on the resources within them. You could create a {% data variables.product.prodname_github_app %} internal to your organization, install it on the repositories you need access to within your workflow, and authenticate as the installation within your workflow to access those repositories. -4. **Persönliche Zugriffsstokens** - - You should never use personal access tokens from your own account. These tokens grant access to all repositories within the organizations that you have access to, as well as all personal repositories in your user account. This indirectly grants broad access to all write-access users of the repository the workflow is in. In addition, if you later leave an organization, workflows using this token will immediately break, and debugging this issue can be challenging. - - If a personal access token is used, it should be one that was generated for a new account that is only granted access to the specific repositories that are needed for the workflow. Note that this approach is not scalable and should be avoided in favor of alternatives, such as deploy keys. -5. **SSH keys on a user account** - - Workflows should never use the SSH keys on a user account. Similar to personal access tokens, they grant read/write permissions to all of your personal repositories as well as all the repositories you have access to through organization membership. This indirectly grants broad access to all write-access users of the repository the workflow is in. If you're intending to use an SSH key because you only need to perform repository clones or pushes, and do not need to interact with public APIs, then you should use individual deploy keys instead. - -### Hardening for self-hosted runners - -**{% data variables.product.prodname_dotcom %}-hosted** runners execute code within ephemeral and clean isolated virtual machines, meaning there is no way to persistently compromise this environment, or otherwise gain access to more information than was placed in this environment during the bootstrap process. - -**Self-hosted** runners on {% data variables.product.product_name %} do not have guarantees around running in ephemeral clean virtual machines, and can be persistently compromised by untrusted code in a workflow. - -As a result, self-hosted runners should almost [never be used for public repositories](/actions/hosting-your-own-runners/about-self-hosted-runners#self-hosted-runner-security-with-public-repositories) on {% data variables.product.product_name %}, because any user can open pull requests against the repository and compromise the environment. Similarly, be cautious when using self-hosted runners on private repositories, as anyone who can fork the repository and open a PR (generally those with read-access to the repository) are able to compromise the self-hosted runner environment, including gaining access to secrets and the more privileged `GITHUB_TOKEN` which grants write-access permissions on the repository. - -You should also consider the environment of the self-hosted runner machines: -- What sensitive information resides on the machine configured as a self-hosted runner? For example, private SSH keys, API access tokens, among others. -- Does the machine have network access to sensitive services? For example, Azure or AWS metadata services. The amount of sensitive information in this environment should be kept to a minimum, and you should always be mindful that any user capable of invoking workflows has access to this environment. diff --git a/translations/de-DE/content/actions/getting-started-with-github-actions/starting-with-preconfigured-workflow-templates.md b/translations/de-DE/content/actions/getting-started-with-github-actions/starting-with-preconfigured-workflow-templates.md deleted file mode 100644 index 014fa58b4cc1..000000000000 --- a/translations/de-DE/content/actions/getting-started-with-github-actions/starting-with-preconfigured-workflow-templates.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: Einstieg mit vorkonfigurierten Workflow-Vorlagen -intro: '{% data variables.product.prodname_dotcom %} bietet vorkonfigurierte Workflow-Vorlagen, um Deinen Workflow zu automatisieren oder einen CI-Workflow für bestimmte Sprachen und Frameworks zu erstellen.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/starting-with-preconfigured-workflow-templates -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Informationen zu Workflow-Vorlagen - -{% data variables.product.product_name %} analysiert Deinen Code und zeigt Dir die CI-Vorlagen an, die am besten zu Deinem Repository passen. Wenn Dein Repository beispielsweise Node.js-Code enthält, werden Vorschläge für Node.js-Projekte angezeigt. Du kannst Workflow-Vorlagen als Ausgangspunkt verwenden, um Deinen benutzerdefinierten Workflow zu erstellen, oder Du kannst sie unverändert zu verwenden. - -Du kannst die komplette Liste der CI-Vorlagen im Repository [actions/starter-workflows](https://github.com/actions/starter-workflows/tree/master/ci) durchsuchen. Du findest auch Vorlagen zur Automatisierung Deines Workflows. Du findest auch Vorlagen zur Automatisierung Deines Workflows. - -### Deine erste Workflow-Vorlage hinzufügen - -Wenn Du Deinem Repository noch keinen Workflow hinzugefügt hast, wird eine Liste der Workflow-Vorlagen angezeigt, aus denen Du auswählen kannst. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.actions-set-up-workflow-template %} - -### Zusätzliche Workflow-Vorlagen hinzufügen - -Wenn Du bereits über einen Workflow verfügst und eine neue Workflow-Vorlagen hinzufügen möchtest, kannst Du zu den Workflow-Vorlagen navigieren. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.actions-new-workflow %} -{% data reusables.repositories.actions-set-up-workflow-template %} diff --git a/translations/de-DE/content/actions/getting-started-with-github-actions/using-actions-from-github-marketplace.md b/translations/de-DE/content/actions/getting-started-with-github-actions/using-actions-from-github-marketplace.md deleted file mode 100644 index 561c90bf18a3..000000000000 --- a/translations/de-DE/content/actions/getting-started-with-github-actions/using-actions-from-github-marketplace.md +++ /dev/null @@ -1,51 +0,0 @@ ---- -title: Verwenden von Aktionen aus dem GitHub Marketplace -intro: 'Du kannst {% data variables.product.prodname_marketplace %} durchgehen und darin nach Aktionen suchen, um sie in Deinen Workflows zu verwenden.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/using-github-marketplace-actions - - /actions/automating-your-workflow-with-github-actions/using-actions-from-github-marketplace-in-your-workflow -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Informationen zu Aktionen in {% data variables.product.prodname_marketplace %} - -{% data variables.product.prodname_marketplace %} ist eine zentrale Stelle, an der Du Aktionen findest, die von der {% data variables.product.prodname_dotcom %}-Community erstellt wurden. Aktionen mit einem „Badge“ (Abzeichen) zeigen, dass {% data variables.product.prodname_dotcom %} den Ersteller der Aktion als Partnerorganisation überprüft hat. - -{% data reusables.actions.enterprise-marketplace-actions %} - -Neue Aktionen findest Du im Workflow-Editor auf {% data variables.product.prodname_dotcom %}und auf der Seite [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace/actions/). - -Aktionen direkt im Workflow-Editor anzuzeigen ermöglicht einen schnellen Zugriff auf alle Aktionen auf dem {% data variables.product.prodname_marketplace %}. Die Aktionsseite von {% data variables.product.prodname_marketplace %} bietet mehr Flexibilität, um Aktionen nach Kategorien zu filtern. - -### Aktionen im Workflow-Editor durchsuchen - -Direkt im Workflow-Editor Deines Repositorys kannst Du Aktionen suchen und durchstöbern und auch suchen. In der Seitenleiste kannst Du nach einer bestimmten Aktion suchen, vorgestellte Aktionen anzeigen und vorgestellte Kategorien durchsuchen. Du kannst auch nach der Anzahl der Sterne schauen, die eine Aktion von der {% data variables.product.prodname_dotcom %}-Community erhalten hat. - -1. Navigiere in Deinem Repository zu der Workflow-Datei, die Du bearbeiten möchtest. -1. Um den Workflow-Editor zu öffnen, klickst Du in der oberen rechten Ecke der Dateiansicht auf {% octicon "pencil" aria-label="The edit icon" %}. ![Schaltfläche zum Editieren der Workflow-Datei](/assets/images/help/repository/actions-edit-workflow-file.png) -1. Rechts vom Editor befindet sich die Seitenleiste {% data variables.product.prodname_marketplace %} , um Aktionen zu durchsuchen. ![Seitenleiste für den Marktplatz-Workflow](/assets/images/help/repository/actions-marketplace-sidebar.png) - -### Aktionen in {% data variables.product.prodname_marketplace %} durchsuchen - -Die gleichen Aktionen findest Du auf der [{% data variables.product.prodname_marketplace %}-Aktionsseite](https://github.com/marketplace/actions/). Auf der {% data variables.product.prodname_marketplace %}-Seite kannst Du noch flexibler Aktionen nach Kategorie und Überprüfung zu filtern. - -### Vom Worflow-Editor aus eine Aktion zu Deinem Workflow hinzufügen - -Die Listing-Seite einer Aktion enthält die Version der Aktion und die erforderliche Workflow-Syntax, um die Aktion zu benutzen. - -1. Navigiere zu der Aktion, die Du in Deinem Workflow verwenden möchtest. -1. Klicke unter „Installation“ auf {% octicon "clippy" aria-label="The edit icon" %} , um die Workflow-Syntax zu kopieren. ![Aktionsliste anzeigen](/assets/images/help/repository/actions-sidebar-detailed-view.png) -1. Füge die Syntax als neuen Schritt in Deinen Workflow ein. Weitere Informationen findest Du unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idsteps)“. -1. Wenn für die Aktion Variablen zur Verfügung gestellt werden müssen, lege diese in Deinem Workflow fest. Informationen dazu, welche Variablen eine Aktion benötigen könnte, findest Du in der vollständigen Auflistung der Aktion im {% data variables.product.prodname_marketplace %}. - -{% if currentVersion == "free-pro-team@latest" %} - -{% data reusables.dependabot.version-updates-for-actions %} - -{% endif %} diff --git a/translations/de-DE/content/actions/getting-started-with-github-actions/using-community-workflows-and-actions.md b/translations/de-DE/content/actions/getting-started-with-github-actions/using-community-workflows-and-actions.md deleted file mode 100644 index 9688aa5789e9..000000000000 --- a/translations/de-DE/content/actions/getting-started-with-github-actions/using-community-workflows-and-actions.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Workflows und Aktionen der Community verwenden -intro: 'Verwende Aktionen und Workflows, die von anderen Personen und Organisationen, einschließlich {% data variables.product.prodname_dotcom %}, erstellt wurden.' -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/de-DE/content/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners.md b/translations/de-DE/content/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners.md deleted file mode 100644 index b33c5cf5bf0a..000000000000 --- a/translations/de-DE/content/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: Zugriff auf selbst-gehostete Runner verwalten -intro: 'Du kannst bestimmen, welche Repositories Jobs an die selbst-gehosteten Runner einer Organisation senden können.' -versions: - free-pro-team: '*' ---- - -Selbst gehostete Runner, die auf Organisationsebene hinzugefügt wurden, können Jobs für alle Repositories der Organisation verarbeiten. Wenn Du den Zugriff auf deine selbst-gehosteten Runner beschränken möchtest, kannst Du die Richtlinie so konfigurieren, dass sie nur Jobs für private Repositories verarbeiten, oder Du kannst eine Liste berechtigter Repositories definieren. - -### Steuern, welche Repositories Zugriff auf die Runner einer Organisation haben - -{% data reusables.organizations.navigate-to-org %} -{% data reusables.organizations.org_settings %} -{% data reusables.organizations.settings-sidebar-actions %} -1. Klicke neben „selbst-gehostete Runner“ **Repository-Berechtigungen verwalten**. ![Repository-Berechtigungen verwalten](/assets/images/help/settings/actions-runner-manage-permissions.png) - -1. Wähle aus dem Dropdown-Menü eine der folgenden Optionen: - - * **Alle Repositories** - Alle öffentlichen und privaten Repositories in der Organisation können Jobs an die selbst-gehosteten Runner der Organisation senden. - * **Private Repositories** - Nur private Repositories in der Organisation können Jobs an die selbst-gehosteten Runner der Organisation senden. - * **Ausgewählte Repositories** - Benutze das Repository-Auswahlmenü, um auszuwählen, welche Repositories in der Organisation Aufträge an die selbst-gehosteten Runner senden können. diff --git a/translations/de-DE/content/actions/language-and-framework-guides/building-and-testing-java-with-ant.md b/translations/de-DE/content/actions/language-and-framework-guides/building-and-testing-java-with-ant.md deleted file mode 100644 index 00c5ab5c6da9..000000000000 --- a/translations/de-DE/content/actions/language-and-framework-guides/building-and-testing-java-with-ant.md +++ /dev/null @@ -1,107 +0,0 @@ ---- -title: Java bauen und testen mit Ant -intro: 'Du kannst einen Workflow für kontinuierliche Integration (CI) in GitHub-Aktionen erstellen, um Dein Java-Projekt mit Ant zu bauen und zu testen.' -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Einführung - -Dieser Leitfaden zeigt Dir, wie Du einen Workflow erstellen kannst, der eine kontinuierliche Integration (CI) für Dein Java-Projekt mit Hilfe des Build-Systems Ant durchführt. Der Workflow, den Du erstellst, zeigt Dir, wenn Commits zu einem Pull-Request zu Build- oder Testfehlern für deinen Standard-Zweig führen. Dieser Ansatz kann dazu beitragen, dass Dein Code immer brauchbar ist. Du kannst Deinen CI-Workflow so erweitern, dass er Artefakte von einem Workflow-Lauf hochlädt. - -{% data variables.product.prodname_dotcom %}-gehostete Runnner haben einen Tools-Cache mit vorinstallierter Software, einschließlich Java Development Kits (JDKs) und Ant. Eine Liste der Software und der vorinstallierten Versionen für JDK und Ant findest Du unter „[Software auf {% data variables.product.prodname_dotcom %}-gehosteten Runnern](/actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners)“. - -### Vorrausetzungen - -Du solltest mit YAML und der Syntax für {% data variables.product.prodname_actions %} vertraut sein. Weitere Informationen findest Du unter: -- „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)“ -- "[Einen Workflow konfigurieren](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)" - -Du solltest ein grundlegendes Verständnis von Java und dem Framework Ant haben. Weitere Informationen findest Du im [Handbuch zu Apache Ant](https://ant.apache.org/manual/). - -{% data reusables.actions.enterprise-setup-prereq %} - -### Einstieg mit einer Ant-Workflow-Vorlage - -{% data variables.product.prodname_dotcom %} bietet eine Ant-Workflow-Vorlage, die für die meisten Ant-basierten Java-Projekte funktionieren wird. Weitere Informationen findest Du im [Workflow-Template für Ant](https://github.com/actions/starter-workflows/blob/master/ci/maven.yml). - -Um schnell loszulegen, kannst Du beim Erstellen eines neuen Workflows die vorkonfigurierte Ant-Vorlage auswählen. Weitere Informationen findest Du unter „[Mit vorkonfigurierten Workflow-Vorlagen beginnen](/actions/automating-your-workflow-with-github-actions/starting-with-preconfigured-workflow-templates)“. - -Du kannst auch manuell diesen Workflow hinzufügen, indem Du eine neue Datei im Verzeichnis `.github/workflows` Deines Reporitorys erstellst. - -{% raw %} -```yaml -name: Java CI - -on: [push] - -jobs: - build: - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - name: Set up JDK 1.8 - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Build with Ant - run: ant -noinput -buildfile build.xml -``` -{% endraw %} - -Dieser Workflow führt die folgenden Schritte aus: - -1. Der Schritt `checkout` lädt eine Kopie Deines Repositorys auf den Runner herunter. -2. Der Schritt `setup-java` konfiguriert das Java 1.8 JDK. -3. Der Schritt „Build with Ant“ (mittels Ant bauen) führt das standardmäßige „Target“ (Ziel) in Deiner `build.xml` im nicht-interaktiven Modus aus. - -Die Standard-Workflow-Vorlagen sind ausgezeichnete Ausgangspunkte beim Erstellen des Build- und Testworkflows, und Du kannst die Vorlage an die Anforderungen Deines Projekts anpassen. - -{% data reusables.github-actions.example-github-runner %} - -{% data reusables.github-actions.java-jvm-architecture %} - -### Deinen Code bauen und testen - -Du kannst die gleichen Befehle verwenden, die Du auch lokal verwendest, um Deinen Code zu erstellen und zu testen. - -Der Starter-Workflow führt das in der Datei _build.xml_ angegebene „default target“ (Standardziel) aus. Dein Standard-Ziel wird normalerweise eingestellt, um Klassen zu bauen, Tests durchzuführen und Klassen in ihr verteilbares Format (z.B . eine JAR-Datei) zu paketieren. - -Wenn Du zum Bauen Deines Projekts andere Befehle verwenden oder ein anderes Ziel auszuführen möchtest, kannst Du dies angeben. Vielleicht möchtest Du beispielsweise das Ziel `jar` ausführen, das in Deiner Datei _build-ci.xml_ konfiguriert ist. - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Run the Ant jar target - run: ant -noinput -buildfile build-ci.xml jar -``` -{% endraw %} - -### Workflow-Daten als Artefakte paketieren - -Nachdem sowohl Build erfolgreich war und Deine Tests bestanden hat, wirst Du die resultierenden Java-Pakete als Build-Artefakt hochladen wollen. Dies speichert die gebauten Pakete als Teil der Workflow-Ausführung und ermöglicht Dir, sie herunterzuladen. Artefakte können Dir helfen, Pull-Requests in Deiner lokalen Umgebung zu testen und zu debuggen, bevor sie zusammengeführt werden („merge“). Weitere Informationen findest Du unter „[Workflow-Daten mittels Artefakten persistieren](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)“. - -Ant erstellt normalerweise Ausgabedateien wie JARs, EARs oder WARs im Verzeichnis `build/jar`. Du kannst den Inhalt dieses Verzeichnisses mit der Aktion `upload-artifact` hochladen. - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - - run: ant -noinput -buildfile build.xml - - uses: actions/upload-artifact@v2 - with: - name: Package - path: build/jar -``` -{% endraw %} diff --git a/translations/de-DE/content/actions/language-and-framework-guides/building-and-testing-java-with-gradle.md b/translations/de-DE/content/actions/language-and-framework-guides/building-and-testing-java-with-gradle.md deleted file mode 100644 index 9222a8fbfef0..000000000000 --- a/translations/de-DE/content/actions/language-and-framework-guides/building-and-testing-java-with-gradle.md +++ /dev/null @@ -1,132 +0,0 @@ ---- -title: Java bauen und testen mit Gradle -intro: 'Du kannst einen Workflow für kontinuierliche Integration (CI) in GitHub-Aktionen erstellen, um Dein Java-Projekt mit Gradle zu bauen und zu testen.' -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Einführung - -Dieser Leitfaden zeigt Dir, wie Du einen Workflow erstellen kannst, der eine kontinuierliche Integration (CI) für Dein Java-Projekt mit Hilfe des Build-Systems Gradle durchführt. Der Workflow, den Du erstellst, zeigt Dir, wenn Commits zu einem Pull-Request zu Build- oder Testfehlern für deinen Standard-Zweig führen. Dieser Ansatz kann dazu beitragen, dass Dein Code immer brauchbar ist. Du kannst Deinen CI-Workflow so erweitern, dass er Dateien im Cache zwischenspeichert und Artefakte von einem Workflow-Lauf hochlädt. - -{% data variables.product.prodname_dotcom %}-gehostete Runnner haben einen Tools-Cache mit vorinstallierter Software, einschließlich Java Development Kits (JDKs) und Gradle. Eine Liste der Software und der vorinstallierten Versionen für JDK und Gradle findest Du unter „[Software auf {% data variables.product.prodname_dotcom %}-gehosteten Runnern](/actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners)“. - -### Vorrausetzungen - -Du solltest mit YAML und der Syntax für {% data variables.product.prodname_actions %} vertraut sein. Weitere Informationen findest Du unter: -- „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)“ -- "[Einen Workflow konfigurieren](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)" - -Du solltest ein grundlegendes Verständnis von Java und dem Framework Gradle haben. Weitere Informationen findest Du unter [Erste Schritte](https://docs.gradle.org/current/userguide/getting_started.html) in der Gradle-Dokumentation. - -{% data reusables.actions.enterprise-setup-prereq %} - -### Einstieg mit einer Gradle-Workflow-Vorlage - -{% data variables.product.prodname_dotcom %} bietet eine Gradle-Workflow-Vorlage, die für die meisten Gradle-basierten Java-Projekte funktionieren wird. Weitere Informationen findest Du im [Workflow-Template für Gradle](https://github.com/actions/starter-workflows/blob/master/ci/maven.yml). - -Um schnell loszulegen, kannst Du beim Erstellen eines neuen Workflows die vorkonfigurierte Gradle-Vorlage auswählen. Weitere Informationen findest Du unter „[Mit vorkonfigurierten Workflow-Vorlagen beginnen](/actions/automating-your-workflow-with-github-actions/starting-with-preconfigured-workflow-templates)“. - -Du kannst auch manuell diesen Workflow hinzufügen, indem Du eine neue Datei im Verzeichnis `.github/workflows` Deines Reporitorys erstellst. - -{% raw %} -```yaml -name: Java CI - -on: [push] - -jobs: - build: - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - name: Set up JDK 1.8 - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Build with Gradle - run: ./gradlew build -``` -{% endraw %} - -Dieser Workflow führt die folgenden Schritte aus: - -1. Der Schritt `checkout` lädt eine Kopie Deines Repositorys auf den Runner herunter. -2. Der Schritt `setup-java` konfiguriert das Java 1.8 JDK. -3. Der Schritt "Build with Gradle" führt das Wrapper-Skript `gradlew` aus, um sicherzustellen, dass dein Code gebaut, Tests bestanden und ein Paket erstellt werden kann. - -Die Standard-Workflow-Vorlagen sind ausgezeichnete Ausgangspunkte beim Erstellen des Build- und Testworkflows, und Du kannst die Vorlage an die Anforderungen Deines Projekts anpassen. - -{% data reusables.github-actions.example-github-runner %} - -{% data reusables.github-actions.java-jvm-architecture %} - -### Deinen Code bauen und testen - -Du kannst die gleichen Befehle verwenden, die Du auch lokal verwendest, um Deinen Code zu erstellen und zu testen. - -Der Starter-Workflow führt standardmäßig den Task `build` aus. In der Standard-Gradle-Konfiguration lädt dieser Befehl Abhängigkeiten herunter, baut Klassen, führt Tests durch und paketiert Klassen in ihr verteilbares Format, zum Beispiel eine JAR-Datei. - -Wenn Du zum Bauen Deines Projekts andere Befehle verwenden oder einen anderen Task auszuführen möchtest, kannst Du dies angeben. Vielleicht möchtest Du beispielsweise den Task `package` ausführen, der in Deiner Datei _ci.gradle_ konfiguriert ist. - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Run the Gradle package task - run: ./gradlew -b ci.gradle package -``` -{% endraw %} - -### Abhängigkeiten „cachen“ (zwischenspeichern) - -Du kannst Deine Abhängigkeiten zwischenspeichern, um die Workflow-Ausführungen zu beschleunigen. Nach einem erfolgreichen Lauf wird Dein lokaler Paket-Cache von Gradle in der Aktions-Infrastruktur auf GitHub gespeichert. Bei zukünftigen Workflow-Ausführungen wird der Cache wiederhergestellt, so dass Abhängigkeiten nicht aus entfernten Paket-Repositories heruntergeladen werden müssen. Weitere Informationen findest Du unter „[Caching-Abhängigkeiten zur Beschleunigung von Workflows](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)“ und der [Aktion `cache`](https://github.com/marketplace/actions/cache). - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - name: Set up JDK 1.8 - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Cache Gradle packages - uses: actions/cache@v2 - with: - path: ~/.gradle/caches - key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle') }} - restore-keys: ${{ runner.os }}-gradle - - name: Build with Gradle - run: ./gradlew build -``` -{% endraw %} - -Dieser Workflow speichert den Inhalt Deines lokalen Gradle-Package-Caches im Verzeichnis `.gradle/caches` des Home-Verzeichnisses auf dem Runner. Der Cache-Schlüssel wird der gehashte Inhalt der Gradle-Build-Dateien sein, so dass Änderungen an ihnen den Cache ungültig machen. - -### Workflow-Daten als Artefakte paketieren - -Nachdem sowohl Build erfolgreich war und Deine Tests bestanden hat, wirst Du die resultierenden Java-Pakete als Build-Artefakt hochladen wollen. Dies speichert die gebauten Pakete als Teil der Workflow-Ausführung und ermöglicht Dir, sie herunterzuladen. Artefakte können Dir helfen, Pull-Requests in Deiner lokalen Umgebung zu testen und zu debuggen, bevor sie zusammengeführt werden („merge“). Weitere Informationen findest Du unter „[Workflow-Daten mittels Artefakten persistieren](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)“. - -Gradle erstellt normalerweise Ausgabedateien wie JARs, EARs oder WARs im Verzeichnis `build/libs`. Du kannst den Inhalt dieses Verzeichnisses mit der Aktion `upload-artifact` hochladen. - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - - run: ./gradlew build - - uses: actions/upload-artifact@v2 - with: - name: Package - path: build/libs -``` -{% endraw %} diff --git a/translations/de-DE/content/actions/language-and-framework-guides/building-and-testing-java-with-maven.md b/translations/de-DE/content/actions/language-and-framework-guides/building-and-testing-java-with-maven.md deleted file mode 100644 index c6309369b9aa..000000000000 --- a/translations/de-DE/content/actions/language-and-framework-guides/building-and-testing-java-with-maven.md +++ /dev/null @@ -1,133 +0,0 @@ ---- -title: Java bauen und testen mit Maven -intro: 'Du kannst einen Workflow für kontinuierliche Integration (CI) in GitHub-Aktionen erstellen, um Dein Java-Projekt mit Maven zu bauen und zu testen.' -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Einführung - -Dieser Leitfaden zeigt Dir, wie Du einen Workflow erstellen kannst, der eine kontinuierliche Integration (CI) für Dein Java-Projekt mit Hilfe des Software-Projektmanagement-Tools Maven durchführt. Der Workflow, den Du erstellst, zeigt Dir, wenn Commits zu einem Pull-Request zu Build- oder Testfehlern für deinen Standard-Zweig führen. Dieser Ansatz kann dazu beitragen, dass Dein Code immer brauchbar ist. Du kannst Deinen CI-Workflow so erweitern, dass er Dateien im Cache zwischenspeichert und Artefakte von einem Workflow-Lauf hochlädt. - -{% data variables.product.prodname_dotcom %}-gehostete Runnner haben einen Tools-Cache mit vorinstallierter Software, einschließlich Java Development Kits (JDKs) und Maven. Eine Liste der Software und der vorinstallierten Versionen für JDK und Maven findest Du unter „[Software auf {% data variables.product.prodname_dotcom %}-gehosteten Runnern](/actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners)“. - -### Vorrausetzungen - -Du solltest mit YAML und der Syntax für {% data variables.product.prodname_actions %} vertraut sein. Weitere Informationen findest Du unter: -- „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)“ -- "[Einen Workflow konfigurieren](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)" - -Du solltest ein grundlegendes Verständnis von Java und dem Framework Maven haben. Weitere Informationen findest Du in der [Anleitung für erste Schritte mit Maven](http://maven.apache.org/guides/getting-started/index.html) in der Maven-Dokumentation. - -{% data reusables.actions.enterprise-setup-prereq %} - -### Einstieg mit einer Maven-Workflow-Vorlage - -{% data variables.product.prodname_dotcom %} bietet eine Maven-Workflow-Vorlage, die für die meisten Maven-basierten Java-Projekte funktionieren wird. Weitere Informationen findest Du im [Workflow-Template für Maven](https://github.com/actions/starter-workflows/blob/master/ci/maven.yml). - -Um schnell loszulegen, kannst Du beim Erstellen eines neuen Workflows die vorkonfigurierte Maven-Vorlage auswählen. Weitere Informationen findest Du unter „[Mit vorkonfigurierten Workflow-Vorlagen beginnen](/actions/automating-your-workflow-with-github-actions/starting-with-preconfigured-workflow-templates)“. - -Du kannst auch manuell diesen Workflow hinzufügen, indem Du eine neue Datei im Verzeichnis `.github/workflows` Deines Reporitorys erstellst. - -{% raw %} -```yaml -name: Java CI - -on: [push] - -jobs: - build: - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - name: Set up JDK 1.8 - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Build with Maven - run: mvn -B package --file pom.xml -``` -{% endraw %} - -Dieser Workflow führt die folgenden Schritte aus: - -1. Der Schritt `checkout` lädt eine Kopie Deines Repositorys auf den Runner herunter. -2. Der Schritt `setup-java` konfiguriert das Java 1.8 JDK. -3. Der Schritt "Build with Maven" führt das Maven-„Target“ (Ziel) `package` im nicht-interaktiven Modus aus, um sicherzustellen, dass der Code gebaut, Tests bestanden und ein Paket erstellt werden kann. - -Die Standard-Workflow-Vorlagen sind ausgezeichnete Ausgangspunkte beim Erstellen des Build- und Testworkflows, und Du kannst die Vorlage an die Anforderungen Deines Projekts anpassen. - -{% data reusables.github-actions.example-github-runner %} - -{% data reusables.github-actions.java-jvm-architecture %} - -### Deinen Code bauen und testen - -Du kannst die gleichen Befehle verwenden, die Du auch lokal verwendest, um Deinen Code zu erstellen und zu testen. - -Der Starter-Workflow führt standardmäßig das „target“ (Ziel) `package` aus. In der Standard-Maven-Konfiguration lädt dieser Befehl Abhängigkeiten herunter, baut Klassen, führt Tests durch und paketiert Klassen in ihr verteilbares Format, zum Beispiel eine JAR-Datei. - -Wenn Du zum Bauen Deines Projekts andere Befehle verwenden oder ein anderes Ziel auszuführen möchtest, kannst Du dies angeben. Vielleicht möchtest Du beispielsweise das Ziel `verify` ausführen, das in Deiner Datei _pom-ci.xml_ konfiguriert ist. - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Run the Maven verify phase - run: mvn -B verify --file pom-ci.xml -``` -{% endraw %} - -### Abhängigkeiten „cachen“ (zwischenspeichern) - -Du kannst Deine Abhängigkeiten zwischenspeichern, um die Workflow-Ausführungen zu beschleunigen. Nach einem erfolgreichen Lauf wird Dein lokales Maven-Repository in der Aktions-Infrastruktur auf GitHub gespeichert. Bei zukünftigen Workflow-Ausführungen wird der Cache wiederhergestellt, so dass Abhängigkeiten nicht aus entfernten Maven-Repositories heruntergeladen werden müssen. Weitere Informationen findest Du unter „[Caching-Abhängigkeiten zur Beschleunigung von Workflows](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)“ und der [Aktion `cache`](https://github.com/marketplace/actions/cache). - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - name: Set up JDK 1.8 - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Cache Maven packages - uses: actions/cache@v2 - with: - path: ~/.m2 - key: ${{ runner.os }}-m2-${{ hashFiles('**/pom.xml') }} - restore-keys: ${{ runner.os }}-m2 - - name: Build with Maven - run: mvn -B package --file pom.xml -``` -{% endraw %} - -Dieser Workflow speichert den Inhalt Deines lokalen Maven-Repositiorys im Verzeichnis `.m2` des Home-Verzeichnisses auf dem Runner. Der Cache-Schlüssel wird der gehashte Inhalt von _pom.xml_sein, so dass Änderungen an _pom.xml_ den Cache ungültig machen. - -### Workflow-Daten als Artefakte paketieren - -Nachdem sowohl Build erfolgreich war und Deine Tests bestanden hat, wirst Du die resultierenden Java-Pakete als Build-Artefakt hochladen wollen. Dies speichert die gebauten Pakete als Teil der Workflow-Ausführung und ermöglicht Dir, sie herunterzuladen. Artefakte können Dir helfen, Pull-Requests in Deiner lokalen Umgebung zu testen und zu debuggen, bevor sie zusammengeführt werden („merge“). Weitere Informationen findest Du unter „[Workflow-Daten mittels Artefakten persistieren](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)“. - -Maven erstellt normalerweise Ausgabedateien wie JARs, EARs oder WARs im Verzeichnis `target`. Um diese als Artefakte hochzuladen, kannst du sie in ein neues Verzeichnis kopieren, welches Artefakte zum Hochladen enthält. Zum Beispiel kannst Du ein Verzeichnis namens `staging` erstellen. Dann kannst Du den Inhalt dieses Verzeichnisses mit der Aktion `upload-artifact` hochladen. - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - - run: mvn -B package --file pom.xml - - run: mkdir staging && cp target/*.jar staging - - uses: actions/upload-artifact@v2 - with: - name: Package - path: staging -``` -{% endraw %} diff --git a/translations/de-DE/content/actions/language-and-framework-guides/github-actions-for-docker.md b/translations/de-DE/content/actions/language-and-framework-guides/github-actions-for-docker.md deleted file mode 100644 index 225e41a9e4e1..000000000000 --- a/translations/de-DE/content/actions/language-and-framework-guides/github-actions-for-docker.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: GitHub-Aktionen für Docker -intro: 'Erstelle Workflows, die Docker Projekte bauen und veröffentlichen.' -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/de-DE/content/actions/language-and-framework-guides/github-actions-for-java.md b/translations/de-DE/content/actions/language-and-framework-guides/github-actions-for-java.md deleted file mode 100644 index b370d5c1a240..000000000000 --- a/translations/de-DE/content/actions/language-and-framework-guides/github-actions-for-java.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: GitHub-Aktionen für Java -intro: 'Erstelle Workflows, die in Java geschriebene Projekte bauen und testen.' -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/de-DE/content/actions/language-and-framework-guides/github-actions-for-javascript-and-typescript.md b/translations/de-DE/content/actions/language-and-framework-guides/github-actions-for-javascript-and-typescript.md deleted file mode 100644 index 4d6e4f7445c4..000000000000 --- a/translations/de-DE/content/actions/language-and-framework-guides/github-actions-for-javascript-and-typescript.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: GitHub-Aktionen für JavaScript und TypeScript -intro: 'Erstelle Workflows, die in JavaScript- und TypeScript-Bibliotheken geschriebene Projekte bauen und testen.' -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/de-DE/content/actions/language-and-framework-guides/github-actions-for-python.md b/translations/de-DE/content/actions/language-and-framework-guides/github-actions-for-python.md deleted file mode 100644 index 8aee3afc085b..000000000000 --- a/translations/de-DE/content/actions/language-and-framework-guides/github-actions-for-python.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: GitHub-Aktionen für Python -intro: 'Workflows, die in Python geschriebene Projekte bauen und testen.' -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/de-DE/content/actions/language-and-framework-guides/index.md b/translations/de-DE/content/actions/language-and-framework-guides/index.md deleted file mode 100644 index 8e294bd5c744..000000000000 --- a/translations/de-DE/content/actions/language-and-framework-guides/index.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Sprach- und Framework-Anleitungen -intro: 'Du kannst Workflows für kontinuierliche Integration (CI) erstellen, die Projekte in verschiedenen Programmiersprachen bauen und testen.' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -{% topic_link_in_list /github-actions-for-javascript-and-typescript %} - {% link_in_list /using-nodejs-with-github-actions %} - {% link_in_list /publishing-nodejs-packages %} -{% topic_link_in_list /github-actions-for-python %} - {% link_in_list /using-python-with-github-actions %} -{% topic_link_in_list /github-actions-for-java %} - {% link_in_list /building-and-testing-java-with-maven %} - {% link_in_list /building-and-testing-java-with-gradle %} - {% link_in_list /building-and-testing-java-with-ant %} - {% link_in_list /publishing-java-packages-with-maven %} - {% link_in_list /publishing-java-packages-with-gradle %} -{% topic_link_in_list /github-actions-for-docker %} - {% link_in_list /publishing-docker-images %} diff --git a/translations/de-DE/content/actions/language-and-framework-guides/publishing-docker-images.md b/translations/de-DE/content/actions/language-and-framework-guides/publishing-docker-images.md deleted file mode 100644 index dd6b02c961c1..000000000000 --- a/translations/de-DE/content/actions/language-and-framework-guides/publishing-docker-images.md +++ /dev/null @@ -1,157 +0,0 @@ ---- -title: Docker-Images veröffentlichen -intro: 'Du kannst Docker-Images im Rahmen Deines Workflows zur kontinuierlichen Integration (CI) in einer Registry wie zum Beispiel „Docker Hub“ oder {% data variables.product.prodname_registry %} veröffentlichen.' -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Einführung - -Diese Anleitung zeigt Dir, wie Du einen Workflow erstellen kannst, der einen Docker-Build ausführt und dann Docker-Images auf „Docker Hub“ oder {% data variables.product.prodname_registry %} veröffentlicht. Mit einem einzelnen Workflow kannst Du Images in einer einzigen Registry oder in mehreren Registries veröffentlichen. - -{% note %} - -**Hinweis:** Wenn Du auf eine andere Docker-Registriery eines Drittanbieters pushen möchtest, kann das Beispiel im Abschnitt [Veröffentlichen von Images auf {% data variables.product.prodname_registry %}](#publishing-images-to-github-packages)" als gute Vorlage dienen. - -{% endnote %} - -### Vorrausetzungen - -Wir empfehlen, dass Du ein grundlegendes Verständnis von Workflowkonfigurations-Optionen hast und darüber, wie Du eine Workflow-Datei erstellst. Weitere Informationen findest Du unter „[Einen Workflow konfigurieren](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)“. - -Vielleicht findest Du es auch hilfreich, ein grundlegendes Verständnis von Folgendem zu haben: - -- „[Kernkonzepte für {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)“ -- „[Verschlüsselte Geheimnisse erzeugen und verwenden](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)“ -- „[Authentifizierung mit dem GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)“ -- „[Docker für den Einsatz mit {% data variables.product.prodname_registry %} konfigurieren](/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages)“ - -### Informationen zur Image-Konfiguration - -In dieser Anleitung wird davon ausgegangen, dass Du eine vollständige Definition für ein Docker-Image in einem {% data variables.product.prodname_dotcom %}-Repository gespeichert hast. Dein Projektarchiv muss beispielsweise eine _Dockerdatei_ und alle anderen Dateien enthalten, die benötigt werden, um einen Docker-Build zum Erstellen eines Images durchzuführen. - -In dieser Anleitung wir werden die Docker-Aktion `build-push-action` verwenden, um das Docker-Image zu bauen und es auf eine oder mehrere Docker-Registries zu übertragen. Weitere Informationen findest Du unter [`build-push-action`](https://github.com/marketplace/actions/build-and-push-docker-images). - -{% data reusables.actions.enterprise-marketplace-actions %} - -### Images auf dem „Docker Hub“ veröffentlichen - -{% data reusables.github-actions.release-trigger-workflow %} - -Im folgenden Beispiel-Workflow verwenden wir die Docker-Aktion `build-push-action`, um das Docker-Image zu bauen und, wenn der Build erfolgreich ist, das gebaute Image auf „Docker Hub“ zu übertragen. - -Um zum „Docker Hub“ zu pushen, benötigst Du ein Benutzerkonto auf „Docker Hub“ und musst ein „Docker Hub“-Repository erstellt haben. Weitere Informationen findest Du unter „[Images auf ‚Docker Hub‘ freigeben](https://docs.docker.com/get-started/part3/)“ in der Docker-Dokumentation. - -„Docker Hub“ benötigt für `build-push-action` die folgenden Optionen: - -* `username` und `password`: Dies ist Dein Benutzername und Passwort auf „Docker Hub“. Wir empfehlen Dir, Deinen „Docker Hub“-Benutzernamen und das -Passwort als verschlüsselte Geheimnisse in Deinem {% data variables.product.prodname_dotcom %}-Repository zu speichern, damit diese nicht in Deiner Workflow-Datei enthüllt werden. Weitere Informationen findest Du unter „[Verschlüsselte Geheimnisse erstellen und verwenden](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)“. -* `repository`: Dein „Docker Hub“-Repository im Format `DOCKER-HUB-NAMESPACE/DOCKER-HUB-REPOSITORY`. - -{% raw %} -```yaml -name: Publish Docker image -on: - release: - types: [published] -jobs: - push_to_registry: - name: Push Docker image to Docker Hub - runs-on: ubuntu-latest - steps: - - name: Check out the repo - uses: actions/checkout@v2 - - name: Push to Docker Hub - uses: docker/build-push-action@v1 - with: - username: ${{ secrets.DOCKER_USERNAME }} - password: ${{ secrets.DOCKER_PASSWORD }} - repository: my-docker-hub-namespace/my-docker-hub-repository - tag_with_ref: true -``` -{% endraw %} - -{% data reusables.github-actions.docker-tag-with-ref %} - -### Images in {% data variables.product.prodname_registry %} veröffentlichen - -{% data reusables.github-actions.release-trigger-workflow %} - -Im folgenden Beispiel-Workflow verwenden wir die Docker-Aktion `build-push-action`, um das Docker-Image zu bauen und, wenn der Build erfolgreich ist, das gebaute Image nach {% data variables.product.prodname_registry %} zu übertragen. - -Die für {% data variables.product.prodname_registry %} erforderlichen `build-push-action`-Optionen sind: - -* `username`: Du kannst mithilfe des Kontexts von {% raw %}`${{ github.actor }}`{% endraw %} automatisch den Benutzernamen des Benutzers zu verwenden, der die Workflow-Ausführung angestoßen hat. Weitere Informationen findest Du unter „[Kontext- und Ausdrucks-Syntax für GitHub-Aktionen](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)“. -* `password`: Du kannst das automatisch generierte Geheimnis `GITHUB_TOKEN` als Passwort verwenden. Weitere Informationen findest Du unter „[Authentifizierung mit dem GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)". -* `registry`: Muss auf `docker.pkg.github.com` gesetzt werden. -* `repository`: Muss im Format `OWNER/REPOSITORY/IMAGE_NAME` gesetzt werden. Beispiel: Für ein Bild namens `octo-image` auf {% data variables.product.prodname_dotcom %} unter `http://github. om/octo-org/octo-repo` sollte die Option `repository` auf `octo-org/octo-repo/octo-image` gesetzt werden. - -{% raw %} -```yaml -name: Publish Docker image -on: - release: - types: [published] -jobs: - push_to_registry: - name: Push Docker image to GitHub Packages - runs-on: ubuntu-latest - steps: - - name: Check out the repo - uses: actions/checkout@v2 - - name: Push to GitHub Packages - uses: docker/build-push-action@v1 - with: - username: ${{ github.actor }} - password: ${{ secrets.GITHUB_TOKEN }} - registry: docker.pkg.github.com - repository: my-org/my-repo/my-image - tag_with_ref: true - -``` -{% endraw %} - -{% data reusables.github-actions.docker-tag-with-ref %} - -### Images auf dem „Docker Hub“ und in der {% data variables.product.prodname_registry %} veröffentlichen - -In einem einzigen Workflow kannst Du Dein Docker-Image in mehreren Registries veröffentlichen, indem Du die Aktion `build-push-action` auf jede Registry anwendest. - -Der folgende Beispiel-Workflow verwendet die Schritte der `build-push-action` aus den vorherigen Abschnitten („[Veröffentlichung von Bildern auf ‚Docker Hub‘](#publishing-images-to-docker-hub)“ und „[Veröffentlichung von Bildern in {% data variables.product.prodname_registry %}](#publishing-images-to-github-packages)“), um einen einzigen Workflow zu erstellen, der in beide Registries pusht. - -{% raw %} -```yaml -name: Publish Docker image -on: - release: - types: [published] -jobs: - push_to_registries: - name: Push Docker image to multiple registries - runs-on: ubuntu-latest - steps: - - name: Check out the repo - uses: actions/checkout@v2 - - name: Push to Docker Hub - uses: docker/build-push-action@v1 - with: - username: ${{ secrets.DOCKER_USERNAME }} - password: ${{ secrets.DOCKER_PASSWORD }} - repository: my-docker-hub-namespace/my-docker-hub-repository - tag_with_ref: true - - name: Push to GitHub Packages - uses: docker/build-push-action@v1 - with: - username: ${{ github.actor }} - password: ${{ secrets.GITHUB_TOKEN }} - registry: docker.pkg.github.com - repository: my-org/my-repo/my-image - tag_with_ref: true -``` -{% endraw %} - -Der obige Workflow checkt das {% data variables.product.prodname_dotcom %}-Repository aus und verwendet die Aktion `build-push-action` zweimal, um das Docker-Image zu erstellen und sowohl auf den „Docker Hub“ als auch in die {% data variables.product.prodname_registry %} zu übertragen. Für beide Schritte, setzt er die Option `build-push-action` auf [`tag_with_ref`](https://github.com/marketplace/actions/build-and-push-docker-images#tag_with_ref) um das gebaute Docker-Image automatisch mit der Git-Referenz des Workflow-Ereignisses zu kennzeichnen. Dieser Workflow wird bei der Veröffentlichung eines {% data variables.product.prodname_dotcom %}-Releases ausgelöst, so dass die Referenz für beide Registries das Git-Tag des Releases ist. diff --git a/translations/de-DE/content/actions/language-and-framework-guides/publishing-java-packages-with-gradle.md b/translations/de-DE/content/actions/language-and-framework-guides/publishing-java-packages-with-gradle.md deleted file mode 100644 index e1e85331b23b..000000000000 --- a/translations/de-DE/content/actions/language-and-framework-guides/publishing-java-packages-with-gradle.md +++ /dev/null @@ -1,218 +0,0 @@ ---- -title: Java-Pakete mit Gradle veröffentlichen -intro: 'Du kannst Gradle verwenden, um Java-Pakete als Teil Deines Workflows zur kontinuierlichen Integration (CI) in einer Registry zu veröffentlichen.' -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Einführung - -{% data reusables.github-actions.publishing-java-packages-intro %} - -### Vorrausetzungen - -Wir empfehlen Dir, ein grundlegendes Verständnis von Workflow-Dateien und Konfigurationsoptionen zu haben. Weitere Informationen findest Du unter „[Einen Workflow konfigurieren](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)“. - -Weitere Informationen zum Erstellen eines CI-Workflows für Dein Java-Projekt mit Gradle findest Du unter „[Java bauen und testen mit Gradle](/actions/language-and-framework-guides/building-and-testing-java-with-gradle)“. - -Vielleicht findest Du es auch hilfreich, ein grundlegendes Verständnis von Folgendem zu haben: - -- „[Kernkonzepte für {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)“ -- „[Konfiguration von npm für die Verwendung mit {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)“ -- "[Umgebungsvariablen verwenden](/actions/automating-your-workflow-with-github-actions/using-environment-variables)" -- „[Verschlüsselte Geheimnisse erzeugen und verwenden](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)“ -- „[Authentifizierung mit dem GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)“ - -### Informationen zur Paketkonfiguration - -Die Felder `groupId` und `artifactId` im Abschnitt `MavenPublication` der Datei _build.gradle_ bilden eine eindeutige Kennung für Dein Paket. Registries verwenden diese Kennung, um Dein Paket mit einer Registry zu verknüpfen. Dies ist so ähnlich wie bei den Feldern `groupId` und `artifactId` der Maven-Datei _pom.xml_. Weitere Informationen findest Du unter „[‚Maven Publish Plugin‘](https://docs.gradle.org/current/userguide/publishing_maven.html)“ in der Gradle-Dokumentation. - -Die Datei _build.gradle_ enthält auch die Konfiguration für die Distributionsverwaltungs-Repositories, zu denen Gradle dann Pakete veröffentlicht. Jedes Repository braucht einen Namen, eine Deployment-URL und Anmeldeinformationen zur Authentifizierung. - -### Pakete im „Maven Central Repository“ veröffentlichen - -Jedes Mal, wenn Du ein neues Release erstellst, kannst Du einen Workflow anstoßen, um Dein Paket zu veröffentlichen. Der Workflow im folgenden Beispiel wird von dem Ereignis `release` vom Typ `created` angestoßen. Der Workflow veröffentlicht das Paket im „Maven Central Repository“, sofern es die CI-Tests besteht. Weitere Informationen zum Ereignis `release` findest Du unter „[Ereignisse, die Workflows anstoßen](/actions/reference/events-that-trigger-workflows#release)“. - -Du kannst ein neues Maven-Repository im Block `publishing` Deiner Datei _build.gradle_ definieren, das auf Dein Paket-Repository verweist. Wenn Du zum Beispiel über das OSSRH-Hosting-Projekt in das „Maven Central Repository“ deployst, kann Deine _build.gradle_ ein Repository mit dem Namen `"OSSRH"` bestimmen. - -{% raw %} -```groovy -publishing { - ... - - repositories { - maven { - name = "OSSRH" - url = "https://oss.sonatype.org/service/local/staging/deploy/maven2/" - credentials { - username = System.getenv("MAVEN_USERNAME") - password = System.getenv("MAVEN_PASSWORD") - } - } - } -} -``` -{% endraw %} - -Mit dieser Konfiguration kannst Du einen Workflow erstellen, der mithilfe des Befehls `gradle publish` Dein Paket im „Maven Central Repository“ veröffentlicht. Du musst auch Umgebungsvariablen bereitstellen, die den Benutzernamen und das Kennwort enthalten, um Dich im Repository zu authentifizieren. - -Im Deploy-Schritt musst Du Umgebungsvariablen für den Benutzernamen und das Passwort oder für den Token festlegen, mit dem Du Dich im Maven-Repository authentifizierst. Weitere Informationen findest Du unter "[Verschlüsselte Geheimnisse erstellen und verwenden](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". - - -{% raw %} -```yaml -name: Publish package to the Maven Central Repository -on: - release: - types: [created] -jobs: - publish: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - - name: Set up Java - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Publish package - run: gradle publish - env: - MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }} - MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }} -``` -{% endraw %} - -{% data reusables.github-actions.gradle-workflow-steps %} -1. Führt den Befehl `gradle publish` aus, um im Maven-Repository `OSSRH` zu veröffentlichen. Die Umgebungsvariable `MAVEN_USERNAME` wird mit dem Inhalt Deines Geheimnisses `OSSRH_USERNAME` gefüllt, und die Umgebungsvariable `MAVEN_PASSWORD` wird mit dem Inhalt Deines Geheimnisses `OSSRH_TOKEN` gefüllt. - - Weitere Informationen zur Verwendung von Geheimnissen in Deinem Workflow findest Du unter „[Verschlüsselte Geheimnisse erstellen und verwenden](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)“. - -### Pakete in der {% data variables.product.prodname_registry %} veröffentlichen - -Jedes Mal, wenn Du ein neues Release erstellst, kannst Du einen Workflow anstoßen, um Dein Paket zu veröffentlichen. Der Workflow im folgenden Beispiel wird von dem Ereignis `release` vom Typ `created` angestoßen. Der Workflow veröffentlicht das Paket in {% data variables.product.prodname_registry %} , wenn die CI-Tests bestanden wurden. Weitere Informationen zum Ereignis `release` findest Du unter „[Ereignisse, die Workflows anstoßen](/actions/reference/events-that-trigger-workflows#release)“. - -Du kannst ein neues Maven-Repository im Block `publishing` Deiner Datei _build.gradle_ definieren, das auf {% data variables.product.prodname_registry %} verweist. In dieser Repository-Konfiguration kannst Du auch die in Deinem CI-Workflow-Lauf eingestellten Umgebungsvariablen nutzen. Du kannst die Umgebungsvariable `GITHUB_ACTOR` als Benutzernamen verwenden und die Umgebungsvariable `GITHUB_TOKEN` auf Dein `GITHUB_TOKEN`-Geheimnis setzen. - -Der `GITHUB_TOKEN` existiert standardmäßig in Deinem Repository und hat Lese- und Schreibrechte für Pakete in dem Repository, in dem der Workflow läuft. Weitere Informationen findest Du unter „[Authentifizierung mit dem GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)." - -Wenn beispielsweise Deine Organisation „octocat“ und Dein Repository „hello-world“ heißt, sieht die {% data variables.product.prodname_registry %}-Konfiguration in _build.gradle_ so ähnlich wie im folgenden Beispiel aus. - -{% raw %} -```groovy -publishing { - ... - - repositories { - maven { - name = "GitHubPackages" - url = "https://maven.pkg.github.com/octocat/hello-world" - credentials { - username = System.getenv("GITHUB_ACTOR") - password = System.getenv("GITHUB_TOKEN") - } - } - } -} -``` -{% endraw %} - -Mit dieser Konfiguration kannst Du einen Workflow erstellen, der mithilfe des Befehls `gradle publish` Dein Paket im „Maven Central Repository“ veröffentlicht. - -{% raw %} -```yaml -name: Publish package to GitHub Packages -on: - release: - types: [created] -jobs: - publish: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Publish package - run: gradle publish - env: - GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} - -{% data reusables.github-actions.gradle-workflow-steps %} -1. Führt den Befehl `gradle publish` aus, um in {% data variables.product.prodname_registry %} zu veröffentlichen. Die Umgebungsvariable `GITHUB_TOKEN` wird mit dem Inhalt des `GITHUB_TOKEN`-Geheimnisses gefüllt. - - Weitere Informationen zur Verwendung von Geheimnissen in Deinem Workflow findest Du unter „[Verschlüsselte Geheimnisse erstellen und verwenden](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)“. - -### Pakete im Maven Central Repository und in der {% data variables.product.prodname_registry %} veröffentlichen - -Du kannst Deine Pakete sowohl im Maven Central Repository als auch in der {% data variables.product.prodname_registry %} veröffentlichen, indem Du beides in Deiner Datei _build.gradle_ konfigurierst. - -Stelle sicher, dass Deine Datei _build.gradle_ ein Repository sowohl für Dein {% data variables.product.prodname_dotcom %}-Repository als auch Deinen „Maven Central Repository“-Provider enthält. - -Wenn Du beispielsweise über das OSSRH-Hosting-Projekt in das Central Repository deployen willst, kannst Du das in einem Distributionsverwaltungs-Repository angeben, wobei Du den `-name` auf `OSSRH` setzt. Wenn Du in die {% data variables.product.prodname_registry %} deployen willst, kannst Du das in einem Distributionsverwaltungs-Repository angeben, wobei Du den `-name` auf `GitHubPackages` setzt. - -Wenn Deine Organisation „octocat“ und Dein Repository „hello-world“ heißt, sieht die {% data variables.product.prodname_registry %}-Konfiguration in _build.gradle_ so ähnlich wie im folgenden Beispiel aus. - -{% raw %} -```groovy -publishing { - ... - - repositories { - maven { - name = "OSSRH" - url = "https://oss.sonatype.org/service/local/staging/deploy/maven2/" - credentials { - username = System.getenv("MAVEN_USERNAME") - password = System.getenv("MAVEN_PASSWORD") - } - } - maven { - name = "GitHubPackages" - url = "https://maven.pkg.github.com/octocat/hello-world" - credentials { - username = System.getenv("GITHUB_ACTOR") - password = System.getenv("GITHUB_TOKEN") - } - } - } -} -``` -{% endraw %} - -Mit dieser Konfiguration kannst Du einen Workflow erstellen, der mithilfe des Befehls `gradle publish` Dein Paket sowohl im „Maven Central Repository“ als auch in der {% data variables.product.prodname_registry %} veröffentlicht. - -{% raw %} -```yaml -name: Publish package to the Maven Central Repository and GitHub Packages -on: - release: - types: [created] -jobs: - publish: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - - name: Set up Java - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Publish to the Maven Central Repository - run: gradle publish - env: - MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }} - MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }} - GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} - -{% data reusables.github-actions.gradle-workflow-steps %} -1. Führt den Befehl `gradle publish` aus, um im Maven-Repository `OSSRH` und in der {% data variables.product.prodname_registry %} zu veröffentlichen. Die Umgebungsvariable `MAVEN_USERNAME` wird mit dem Inhalt Deines Geheimnisses `OSSRH_USERNAME` gefüllt, und die Umgebungsvariable `MAVEN_PASSWORD` wird mit dem Inhalt Deines Geheimnisses `OSSRH_TOKEN` gefüllt. Die Umgebungsvariable `GITHUB_TOKEN` wird mit dem Inhalt des `GITHUB_TOKEN`-Geheimnisses gefüllt. - - Weitere Informationen zur Verwendung von Geheimnissen in Deinem Workflow findest Du unter „[Verschlüsselte Geheimnisse erstellen und verwenden](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)“. diff --git a/translations/de-DE/content/actions/language-and-framework-guides/publishing-java-packages-with-maven.md b/translations/de-DE/content/actions/language-and-framework-guides/publishing-java-packages-with-maven.md deleted file mode 100644 index 75d2485cfef9..000000000000 --- a/translations/de-DE/content/actions/language-and-framework-guides/publishing-java-packages-with-maven.md +++ /dev/null @@ -1,209 +0,0 @@ ---- -title: Java-Pakete mit Maven veröffentlichen -intro: 'Du kannst Maven verwenden, um Java-Pakete als Teil Deines Workflows zur kontinuierlichen Integrations (CI) in eine Registry zu veröffentlichen.' -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Einführung - -{% data reusables.github-actions.publishing-java-packages-intro %} - -### Vorrausetzungen - -Wir empfehlen Dir, ein grundlegendes Verständnis von Workflow-Dateien und Konfigurationsoptionen zu haben. Weitere Informationen findest Du unter „[Einen Workflow konfigurieren](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)“. - -Weitere Informationen zum Erstellen eines CI-Workflows für Dein Java-Projekt mit Maven findest Du unter "[Java mit Maven erstellen und testen](/actions/language-and-framework-guides/building-and-testing-java-with-maven)." - -Vielleicht findest Du es auch hilfreich, ein grundlegendes Verständnis von Folgendem zu haben: - -- „[Kernkonzepte für {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)“ -- „[Konfiguration von npm für die Verwendung mit {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)“ -- "[Umgebungsvariablen verwenden](/actions/automating-your-workflow-with-github-actions/using-environment-variables)" -- „[Verschlüsselte Geheimnisse erzeugen und verwenden](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)“ -- „[Authentifizierung mit dem GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)“ - -### Informationen zur Paketkonfiguration - -Die Felder `groupId` und `artifactId` in der Datei _pom.xml_ bilden eine eindeutige Kennung für Dein Paket. Registries verwenden diese Kennung, um Dein Paket mit einer Registry zu verknüpfen. Weitere Informationen findest Du unter [Leitfaden zum Hochladen von Artefakten in das Central Repository](http://maven.apache.org/repository/guide-central-repository-upload.html) in der „Apache Maven“-Dokumentation. - -Die Datei _pom.xml_ enthält auch die Konfiguration für die Distributionsverwaltungs-Repositories, in denen Maven Pakete veröffentlicht. Jedes Repository braucht einen Namen und eine „Deployment-URL“ (Bereitstellungs-URL). Die Authentifizierung für diese Repositories kann in der Datei _.m2/settings.xml_ im Home-Verzeichnis des Benutzers konfiguriert werden, der Maven verwendet. - -Du kannst die Aktion `setup-java` verwenden, um das Deployment-Repository sowie die Authentifizierung für dieses Repository zu konfigurieren. Weitere Informationen findest Du unter [`setup-java`](https://github.com/actions/setup-java). - -### Pakete im „Maven Central Repository“ veröffentlichen - -Jedes Mal, wenn Du ein neues Release erstellst, kannst Du einen Workflow anstoßen, um Dein Paket zu veröffentlichen. Der Workflow im folgenden Beispiel wird von dem Ereignis `release` vom Typ `created` angestoßen. Der Workflow veröffentlicht das Paket im „Maven Central Repository“, sofern es die CI-Tests besteht. Weitere Informationen zum Ereignis `release` findest Du unter „[Ereignisse, die Workflows anstoßen](/actions/reference/events-that-trigger-workflows#release)“. - -In diesem Workflow kannst Du die Aktion `setup-java` verwenden. Diese Aktion installiert die angegebene JDK-Version in den `PATH`, aber sie konfiguriert auch eine _settings.xml_ für Maven, um Pakete zu veröffentlichen. Standardmäßig wird die Settings-Datei für {% data variables.product.prodname_registry %} konfiguriert, aber sie kann dazu konfiguriert werden, in eine andere Paket-Registry wie z.B. das „Maven Central Repository“ zu deployen. Wenn Du bereits ein Distributions-Management-Repository im _pom.xml_ konfiguriert hast, dann kannst Du beim Aufruf der Aktion `setup-java` diese `id` angeben. - -Wenn Du zum Beispiel über das OSSRH-Hosting-Projekt ins „Maven Central Repository“ deployst, kann Deine _pom.xml_ ein Distributions-Management-Repository mit `ossrh` als `id` angeben. - -{% raw %} -```xml - - ... - - - ossrh - Central Repository OSSRH - https://oss.sonatype.org/service/local/staging/deploy/maven2/ - - - -``` -{% endraw %} - -Mit dieser Konfiguration kannst Du einen Workflow erstellen, der Dein Paket im „Maven Central Repository“ veröffentlicht, indem Du die Repository-Verwaltungs-`id` in der Aktion `setup-java` angibst. Du musst auch Umgebungsvariablen bereitstellen, die den Benutzernamen und das Kennwort enthalten, um Dich im Repository zu authentifizieren. - -Im Deploy-Schritt musst Du die Umgebungsvariablen auf den Benutzernamen setzen, mit dem Du Dich im Repository anmeldest, und auf ein Geheimnis, das Du mit dem Passwort oder dem Token konfiguriert hast, mit dem Du Dich authentifizierst. Weitere Informationen findest Du unter "[Verschlüsselte Geheimnisse erstellen und verwenden](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". - - -{% raw %} -```yaml -name: Publish package to the Maven Central Repository -on: - release: - types: [created] -jobs: - publish: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - - name: Set up Maven Central Repository - uses: actions/setup-java@v1 - with: - java-version: 1.8 - server-id: ossrh - server-username: MAVEN_USERNAME - server-password: MAVEN_PASSWORD - - name: Publish package - run: mvn -B deploy - env: - MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }} - MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }} -``` -{% endraw %} - -Dieser Workflow führt die folgenden Schritte aus: - -1. Checkt eine Kopie des Projekt-Repositorys aus. -1. Richtet das „Java JDK“ ein und konfiguriert die Maven-Datei _settings.xml_, um die Authentifizierung für das Repository `ossrh` mit den Umgebungsvariablen `MAVEN_USERNAME` und `MAVEN_PASSWORD` hinzuzufügen. -1. {% data reusables.github-actions.publish-to-maven-workflow-step %} - - Weitere Informationen zur Verwendung von Geheimnissen in Deinem Workflow findest Du unter „[Verschlüsselte Geheimnisse erstellen und verwenden](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)“. - -### Pakete in der {% data variables.product.prodname_registry %} veröffentlichen - -Jedes Mal, wenn Du ein neues Release erstellst, kannst Du einen Workflow anstoßen, um Dein Paket zu veröffentlichen. Der Workflow im folgenden Beispiel wird von dem Ereignis `release` vom Typ `created` angestoßen. Der Workflow veröffentlicht das Paket in {% data variables.product.prodname_registry %} , wenn die CI-Tests bestanden wurden. Weitere Informationen zum Ereignis `release` findest Du unter „[Ereignisse, die Workflows anstoßen](/actions/reference/events-that-trigger-workflows#release)“. - -In diesem Workflow kannst Du die Aktion `setup-java` verwenden. Diese Aktion installiert die angegebene JDK-Version in den `PATH` und stellt auch Maven- _settings.xml_ ein, um Paket in der {% data variables.product.prodname_registry %} zu veröffentlichen. Die generierte _settings.xml_ definiert die Authentifizierung für einen Server mit einer `id` von `github` und verwendet die Umgebungsvariable `GITHUB_ACTOR` als Benutzername und die Umgebungsvariable `GITHUB_TOKEN` als Passwort. - -Der `GITHUB_TOKEN` existiert standardmäßig in Deinem Repository und hat Lese- und Schreibrechte für Pakete in dem Repository, in dem der Workflow läuft. Weitere Informationen findest Du unter „[Authentifizierung mit dem GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)." - -Für ein Maven-basiertes Projekt kannst Du diese Einstellungen nutzen, indem Du ein Distributions-Repository in Deiner Datei _pom.xml_ mit einer `id` von `Github` erstellst, das auf Deinen {% data variables.product.prodname_registry %}-Endpunkt zeigt. - -Wenn beispielsweise Deine Organisation „octocat“ und Dein Repository „hello-world“ heißt, sieht die {% data variables.product.prodname_registry %}-Konfiguration in _pom.xml_ so ähnlich wie im folgenden Beispiel aus. - -{% raw %} -```xml - - ... - - - github - GitHub Packages - https://maven.pkg.github.com/octocat/hello-world - - - -``` -{% endraw %} - -Mit dieser Konfiguration kannst Du einen Workflow erstellen, der Dein Paket in der {% data variables.product.prodname_registry %} veröffentlicht, indem Du die automatisch generierte _settings.xml_ verwendest. - -{% raw %} -```yaml -name: Publish package to GitHub Packages -on: - release: - types: [created] -jobs: - publish: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Publish package - run: mvn -B deploy - env: - GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} - -Dieser Workflow führt die folgenden Schritte aus: - -1. Checkt eine Kopie des Projekt-Repositorys aus. -1. Richtet das Java JDK ein und konfiguriert auch automatisch die Maven-Datei _settings.xml_, um Authentifizierung für das `github`-Maven-Repository hinzuzufügen, um die Umgebungsvariable `GITHUB_TOKEN` zu verwenden. -1. {% data reusables.github-actions.publish-to-packages-workflow-step %} - - Weitere Informationen zur Verwendung von Geheimnissen in Deinem Workflow findest Du unter „[Verschlüsselte Geheimnisse erstellen und verwenden](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)“. - -### Pakete im Maven Central Repository und in der {% data variables.product.prodname_registry %} veröffentlichen - -Du kannst Deine Pakete sowohl im Maven Central Repository als auch in der {% data variables.product.prodname_registry %} veröffentlichen, indem Du die Aktion `setup-java` für jede Registry verwendest. - -Stelle sicher, dass Deine Datei _pom.xml_ ein Distributionsmanagement-Repository sowohl für Dein {% data variables.product.prodname_dotcom %}-Repository als auch Deinen „Maven Central Repository“-Provider enthält. Wenn Du z.B. über das Hosting-Projekt OSSRH in das Central Repository deployst, solltest Du es vielleicht in einem Distributionsverwaltungs-Repository mit `ossrh` als `id` angeben, und Du solltest {% data variables.product.prodname_registry %} in einem Distributionsverwaltungs-Repository mit `github` als `id` setzen. - -{% raw %} -```yaml -name: Publish package to the Maven Central Repository and GitHub Packages -on: - release: - types: [created] -jobs: - publish: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - - name: Set up Java for publishing to Maven Central Repository - uses: actions/setup-java@v1 - with: - java-version: 1.8 - server-id: ossrh - server-username: MAVEN_USERNAME - server-password: MAVEN_PASSWORD - - name: Publish to the Maven Central Repository - run: mvn -B deploy - env: - MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }} - MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }} - - name: Set up Java for publishing to GitHub Packages - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Publish to GitHub Packages - run: mvn -B deploy - env: - GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} - -Dieser Workflow ruft die Aktion `setup-java` zweimal auf. Jedes Mal, wenn die Aktion `setup-java` ausgeführt wird, überschriebt sie die Maven-Datei _settings.xml_ zum Publizieren von Paketen. Für die Authentifizierung im Repository verweist die Datei _settings.xml_ auf die `id` des Distributionsverwaltungs-Repositorys sowie den Benutzernamen und das Kennwort. - -Dieser Workflow führt die folgenden Schritte aus: - -1. Checkt eine Kopie des Projekt-Repositorys aus. -1. Ruft `setup-java` zum ersten Mal auf. Dies konfiguriert die Maven-Datei _settings.xml_ für das Repository `ossrh` und setzt die Authentifizierungsoptionen auf Umgebungsvariablen, die im nächsten Schritt definiert werden. -1. {% data reusables.github-actions.publish-to-maven-workflow-step %} -1. Ruft `setup-java` zum zweiten Mal auf. Dies konfiguriert automatisch die Maven-Datei _settings.xml_ für {% data variables.product.prodname_registry %}. -1. {% data reusables.github-actions.publish-to-packages-workflow-step %} - - Weitere Informationen zur Verwendung von Geheimnissen in Deinem Workflow findest Du unter „[Verschlüsselte Geheimnisse erstellen und verwenden](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)“. diff --git a/translations/de-DE/content/actions/language-and-framework-guides/publishing-nodejs-packages.md b/translations/de-DE/content/actions/language-and-framework-guides/publishing-nodejs-packages.md deleted file mode 100644 index c98df66d5b6c..000000000000 --- a/translations/de-DE/content/actions/language-and-framework-guides/publishing-nodejs-packages.md +++ /dev/null @@ -1,210 +0,0 @@ ---- -title: Node.js-Pakete veröffentlichen -intro: Du kannst Node.js-Pakete als Teil Deines Workflows zur kontinuierlichen Integrations (CI) in einer Registry veröffentlichen. -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Einführung - -Dieser Leitfaden zeigt Dir, wie Du einen Workflow erstellen kannst, der Node.js Pakete nach den Tests der fortlaufenden Integration (CI) in die {% data variables.product.prodname_registry %} und npm Registrierungen veröffentlicht. Mit einem einzigen Workflow kannst Du Pakete in einer einzigen Registry oder in mehreren Registries veröffentlichen. - -### Vorrausetzungen - -Wir empfehlen, dass Du ein grundlegendes Verständnis von Workflowkonfigurations-Optionen hast und darüber, wie Du eine Workflow-Datei erstellst. Weitere Informationen findest Du unter „[Einen Workflow konfigurieren](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)“. - -Weitere Informationen zum Erstellen eines CI-Workflows für Dein Node.js-Projekt findest Du unter „[Node.js mit {% data variables.product.prodname_actions %} verwenden](/actions/automating-your-workflow-with-github-actions/using-nodejs-with-github-actions)“. - -Vielleicht findest Du es auch hilfreich, ein grundlegendes Verständnis von Folgendem zu haben: - -- „[Kernkonzepte für {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)“ -- „[Konfiguration von npm für die Verwendung mit {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)“ -- "[Umgebungsvariablen verwenden](/actions/automating-your-workflow-with-github-actions/using-environment-variables)" -- „[Verschlüsselte Geheimnisse erzeugen und verwenden](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)“ -- „[Authentifizierung mit dem GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)“ - -### Informationen zur Paketkonfiguration - - Die Felder `name` und `version` in der Datei *package.json* bilden eine eindeutige Kennung. Registries verwenden diese Kennung, um Dein Paket mit einer Registry zu verknüpfen. Du kannst eine Zusammenfassung für die Paketlisten-Seite hinzufügen, indem Du in die Datei *package.json* ein Feld `description` einfügst. Weitere Informationen findest Du unter „[Eine Datei package.json erstellen](https://docs.npmjs.com/creating-a-package-json-file)“ und „[Node.js-Module erstellen](https://docs.npmjs.com/creating-node-js-modules)“ in der npm-Dokumentation. - -Wenn eine lokale Datei *.npmrc* existiert, in der ein Wert `registry` angegeben ist, dann verwendet der Befehl `npm publish` die in der Datei *.npmrc* konfigurierte Registry. {% data reusables.github-actions.setup-node-intro %} - -Du kannst die auf dem Runner installierte Node.js-Version mit der Aktion `setup-node` angeben. - -Wenn Du Schritte in Deinen Workflow einfügst, um die `publishConfig`-Felder in Deiner *package.json*-Datei zu konfigurieren, brauchst Du die Registry-URL nicht mittels der Aktion `setup-node` anzugeben, aber Du kannst das Paket in nur einer einzigen Registry veröffentlichen. Weitere Informationen finden Sie unter „[publishConfig](https://docs.npmjs.com/files/package.json#publishconfig)“ in der NPM-Dokumentation. - -### Pakete in der npm-Registry veröffentlichen - -Jedes Mal, wenn Du ein neues Release erstellst, kannst Du einen Workflow anstoßen, um Dein Paket zu veröffentlichen. Der Workflow im folgenden Beispiel wird von dem Ereignis `release` vom Typ `created` angestoßen. Der Workflow veröffentlicht das Paket im npm-Registry sofern es die CI-Tests besteht. - -Um in Deinem Workflow authentifizierte Operationen gegenüber der npm-Registry durchzuführen, musst Du Dein npm-Authentifizierungstoken als Geheimnis in Deinen Repository-Einstellungen ablegen. Erstelle z.B. ein Geheimnis namens `NPM_TOKEN`. Weitere Informationen findest Du unter „[Verschlüsselte Geheimnisse erstellen und verwenden](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)“. - -Standardmäßig verwendet npm das Feld `name` der Datei *package.json*, um die npm-Registry zu ermitteln. Wenn Du in einem globalen Namespace veröffentlichst, brauchst Du nur den Paketnamen anzugeben. Zum Beispiel würdest Du ein Paket namens `npm-hello-world-test` auf `https://www.npmjs.com/package/npm-hello-world-test` veröffentlichen. - -Wenn Du ein Paket veröffentlichst, das einen Präfix für den „scope“ (Geltungsbereich) enthält, dann füge den Geltungsbereich als `name` in Deine Datei *package.json* ein. Wenn beispielsweise Dein Präfix für den npm-scope „octocat“ und der Paketname „hello-world“ ist, dann sollte der `name` in Deiner Datei *package.json* auf `@octocat/hallo-world` gesetzt sein. Wenn Dein npm-Paket einen Scope-Präfix verwendet und das Paket öffentlich ist, musst Du die Option `npm publish --access public` verwenden. Dies ist eine Option, die npm verlangt, um zu verhindern, dass jemand versehentlich ein privates Paket veröffentlicht. - -Dieses Beispiel speichert das Geheimnis `NPM_TOKEN` in der Umgebungsvariablen `NODE_AUTH_TOKEN`. Wenn die Aktion `setup-node` eine Datei *.npmrc* erzeugt, referenziert sie das Token aus der Umgebungsvariable `NODE_AUTH_TOKEN`. - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # Datei .npmrc zur Veroeffentlichung auf npm einrichten - - uses: actions/setup-node@v1 - with: - node-version: '12.x' - registry-url: 'https://registry.npmjs.org' - - run: npm install - - run: npm publish - env: - NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} -``` -{% endraw %} - -Im obigen Beispiel erzeugt die Aktion `setup-node` auf dem Runner eine Datei *.npmrc* mit folgendem Inhalt: - -``` -//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN} -registry=https://registry.npmjs.org/ -always-auth=true -``` - -### Pakete in der {% data variables.product.prodname_registry %} veröffentlichen - -Jedes Mal, wenn Du ein neues Release erstellst, kannst Du einen Workflow anstoßen, um Dein Paket zu veröffentlichen. Der Workflow im folgenden Beispiel läuft jedes Mal, wenn das Ereignis `release` vom Typ `created` auftritt. Der Workflow veröffentlicht das Paket in {% data variables.product.prodname_registry %} , wenn die CI-Tests bestanden wurden. - -Standardmäßig veröffentlicht die {% data variables.product.prodname_registry %} ein Paket in dem Repository auf {% data variables.product.prodname_dotcom %}, das Du im Feld `name` der Datei *package.json* angibst. Ein Paket namens `@my-org/test` würde beispielsweise im Repository `my-org/test` auf {% data variables.product.prodname_dotcom %} veröffentlicht. Weitere Informationen finden Sie unter [„`npm-scope`“ (npm-Gültigkeitsbereich)](https://docs.npmjs.com/misc/scope) in der npm-Dokumentation. - -Um authentifizierte Vorgänge für die Registry {% data variables.product.prodname_registry %} in Deinem Workflow kannst Du den `GITHUB_TOKEN` verwenden. Der `GITHUB_TOKEN` existiert standardmäßig in Deinem Repository und hat Lese- und Schreibrechte für Pakete in dem Repository, in dem der Workflow läuft. Weitere Informationen findest Du unter „[Verschlüsselte Geheimnisse erstellen und verwenden](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)“. - -Dieses Beispiel speichert das Geheimnis `GITHUB_TOKEN` in der Umgebungsvariablen `NODE_AUTH_TOKEN`. Wenn die Aktion `setup-node` eine Datei *.npmrc* erzeugt, referenziert sie das Token aus der Umgebungsvariable `NODE_AUTH_TOKEN`. - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # Setup .npmrc file to publish to GitHub Packages - - uses: actions/setup-node@v1 - with: - node-version: '12.x' - registry-url: 'https://npm.pkg.github.com' - # Defaults to the user or organization that owns the workflow file - scope: '@octocat' - - run: npm install - - run: npm publish - env: - NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} - -Die Aktion `setup-node` erzeugt eine Datei *.npmrc* auf dem Runner. Wenn Du für die Aktion `setup-node` die Eingabe `scope` verwendest, enthält die Datei *.npmrc* das Präfix „scope“. Standardmäßig legt die Aktion `setup-node` den „Scope“ (Geltungsbereich) in der Datei *.npmrc* auf das Konto fest, das diese Workflow-Datei enthält. - -``` -//npm.pkg.github.com/:_authToken=${NODE_AUTH_TOKEN} -@octocat:registry=https://npm.pkg.github.com -always-auth=true -``` - -### Pakete mittels „Yarn“ veröffentlichen - -Wenn Du den Paketmanager „Yarn“ verwendest, kannst Du mit Yarn Pakete installieren und veröffentlichen. - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # Setup .npmrc file to publish to npm - - uses: actions/setup-node@v1 - with: - node-version: '12.x' - registry-url: 'https://registry.npmjs.org' - # Defaults to the user or organization that owns the workflow file - scope: '@octocat' - - run: yarn - - run: yarn publish - env: - NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} -``` -{% endraw %} - -### Pakete auf npm und in der {% data variables.product.prodname_registry %} veröffentlichen - -{% note %} - -**Hinweis:** Wenn Du in Registries mit unterschiedlichen „Scope“-Präfixen publizieren musst, dann musst Du die Datei *package.json* auf dem Runner anpassen, um das „Scope“-Präfix zu ändern. Wenn Du beispielsweise ein Paket im Geltungsbereich `@mona` für npm und `@octocat` für {% data variables.product.prodname_registry %}veröffentlichst, kannst Du nach der Veröffentlichung auf npm und vor der Veröffentlichung in der {% data variables.product.prodname_registry %} auf dem Runner in der Datei *package.json* den Geltungsbereich `@mona` durch `@octocat` ersetzen. - -{% endnote %} - -Du kannst Deine Pakete sowohl in der npm-Registry als auch in {% data variables.product.prodname_registry %} veröffentlichen, indem Du die Aktion `setup-node` für jede Registry verwendest. - -Wenn Du ein Paket in beiden Registries veröffentlichst, musst Du sicherstellen, dass Dein „Scope“-Präfix auf npm mit Deinem Benutzer- oder Organisationsnamen in {% data variables.product.prodname_dotcom %} übereinstimmt. Um Pakete in einer öffentlichen Registry mit einem „Scope“-Präfix zu veröffentlichen, kannst Du den Befehl `npm publish --access public` verwenden. Weitere Informationen findest Du unter [`npm-scope`](https://docs.npmjs.com/misc/scope) und „[Öffentliche Pakete mit „Scope“ (Geltungsbereich) anlegen und veröffentlichen](https://docs.npmjs.com/creating-and-publishing-scoped-public-packages)“ in der npm-Dokumentation. - -Stelle sicher, dass in Deiner Datei *package.json* den Geltungsbereich Deines {% data variables.product.prodname_dotcom %}-Repositorys und der npm-Registry angegeben ist. Wenn Du beispielsweise ein Paket im Repository `octocat/npm-hello-world-test` auf {% data variables.product.prodname_dotcom %} und https://www.npmjs.com/package/@octocat/npm-hello-world-test veröffentlichen willst, dann sollte in Deiner Datei *package.json* der Name `"name": "@octocat/npm-hello-world-test"` stehen. - -Um authentifizierte Vorgänge für die Registry {% data variables.product.prodname_registry %} in Deinem Workflow kannst Du den `GITHUB_TOKEN` verwenden. Der `GITHUB_TOKEN` existiert standardmäßig in Deinem Repository und hat Lese- und Schreibrechte für Pakete in dem Repository, in dem der Workflow läuft. Weitere Informationen findest Du unter „[Verschlüsselte Geheimnisse erstellen und verwenden](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)“. - -Wenn Du für die Aktion `setup-node` die Eingabe `scope` verwendest, erstellt die Aktion eine Datei *.npmrc* mit dem Präfix „scope“. Standardmäßig legt die Aktion `setup-node` den Geltungsbereich in der Datei *.npmrc* auf den Benutzer oder die Organisation fest, der die Workflow-Datei gehört. - -Dieser Workflow ruft die Aktion `setup-node` zweimal auf. Jedes Mal, wenn die Aktion `setup-node` ausgeführt wird, überschreibt sie die Datei *.npmrc*. Die Datei *.npmrc* referenziert den Token, mit dem Du authentifizierte Operationen in der Paket-Registry durchführen kannst, durch die Umgebungsvariable `NODE_AUTH_TOKEN`. Der Workflow setzt die Umgebungsvariable `NODE_AUTH_TOKEN` jedes Mal, wenn der Befehl `npm publish` ausgeführt wird; zuerst mit einem Token zum Veröffentlichen auf npm (`NPM_TOKEN`) und dann mit einem Token zum Veröffentlichen in der {% data variables.product.prodname_registry %} (`GITHUB_TOKEN`). - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # Setup .npmrc file to publish to npm - - uses: actions/setup-node@v1 - with: - node-version: '10.x' - registry-url: 'https://registry.npmjs.org' - - run: npm install - # Publish to npm - - run: npm publish --access public - env: - NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} - # Setup .npmrc file to publish to GitHub Packages - - uses: actions/setup-node@v1 - with: - registry-url: 'https://npm.pkg.github.com' - # Defaults to the user or organization that owns the workflow file - scope: '@octocat' - # Publish to GitHub Packages - - run: npm publish - env: - NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} diff --git a/translations/de-DE/content/actions/language-and-framework-guides/using-nodejs-with-github-actions.md b/translations/de-DE/content/actions/language-and-framework-guides/using-nodejs-with-github-actions.md deleted file mode 100644 index a66c787b3f2c..000000000000 --- a/translations/de-DE/content/actions/language-and-framework-guides/using-nodejs-with-github-actions.md +++ /dev/null @@ -1,277 +0,0 @@ ---- -title: Node.js mit GitHub-Aktionen verwenden -intro: 'Du kannst einen Workflow für kontinuierliche Integration (CI) erstellen, um Dein Node.js-Projekt zu bauen und zu testen.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/using-nodejs-with-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Einführung - -Diese Anleitung zeigt Dir, wie Du einen Workflow für fortlaufende Integration (CI) erstellen kannst, der Node.js-Code baut und testet. Wenn Deine CI-Tests erfolgreich durchlaufen, kannst Du Deinen Code deployen (bereitstellen) oder ein Paket veröffentlichen. - -### Vorrausetzungen - -Wir empfehlen, dass Du ein grundlegendes Verständnis von Node.js, YAML, Workflowkonfigurations-Optionen und die Erstellung einer Workflow-Datei hast. Weitere Informationen findest Du unter „[Einen Workflow konfigurieren](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)“ und „[Einführung in Node.js](https://nodejs.org/en/docs/guides/getting-started-guide/)“. - -Vielleicht findest Du es auch hilfreich, ein grundlegendes Verständnis von Folgendem zu haben: - -- „[Kernkonzepte für {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)“ -- "[Umgebungsvariablen verwenden](/actions/automating-your-workflow-with-github-actions/using-environment-variables)" - -{% data reusables.actions.enterprise-setup-prereq %} - -### Einstieg mit einer Node.js-Workflow-Vorlage - -{% data variables.product.prodname_dotcom %} bietet eine Node.js-Workflow-Vorlage, die für die meisten Node.js-basierten Projekte funktionieren wird. Diese Anleitung enthält npm und Yarn Beispiele, mit denen Du die Vorlage anpassen kannst. Weitere Informationen findest Du in der [Node.js-Workflow-Vorlage](https://github.com/actions/starter-workflows/blob/master/ci/node.js.yml). - -Um schnell loszulegen, füge die Vorlage in das Verzeichnis `.github/workflows` Deines Repositorys ein. - -{% raw %} -```yaml -name: Node.js CI - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - - strategy: - matrix: - node-version: [8.x, 10.x, 12.x] - - steps: - - uses: actions/checkout@v2 - - name: Use Node.js ${{ matrix.node-version }} - uses: actions/setup-node@v1 - with: - node-version: ${{ matrix.node-version }} - - run: npm install - - run: npm run build --if-present - - run: npm test - env: - CI: true -``` -{% endraw %} - -{% data reusables.github-actions.example-github-runner %} - -### Die Node.js-Version angeben - -Der einfachste Weg, eine Node.js-Version anzugeben, ist die Aktion `setup-node` von {% data variables.product.prodname_dotcom %} zu verwenden. Weitere Informationen findest Du unter [`setup-node`](https://github.com/actions/setup-node/). - -Die Aktion `setup-node` nimmt eine Node.js-Version als Eingabe und konfiguriert diese Version auf dem Runner. Die Aktion `setup-node` findet auf jedem Runner eine bestimmte Version von Node.js aus dem Tools-Cache und legt die notwendigen Binärdateien im `PATH` ab, wo sie für den Rest des Jobs bestehen bleiben. Für Node.js mit {% data variables.product.prodname_actions %} wird empfohlen, die Aktion `setup-node` zu verwenden, weil dadurch über verschiedenen Runner und verschiedenen Versionen von Node.js hinweg ein konsistentes Verhalten sicherstellt wird. Wenn Du einen selbst gehosteten Runner verwendest, musst Du Node.js installieren und zum `PATH` hinzufügen. - -Die Vorlage enthält eine Matrix-Strategie, die Deinen Code mit drei Node.js-Versionen baut und testet: 8.x, 10.x und 12.x. Das 'x' ist ein Platzhalterzeichen, für das neueste Minor- und Patch-Release des jeweiligen Major-Releases steht. The 'x' is a wildcard character that matches the latest minor and patch release available for a version. Jede Version von Node.js, die im Array `node-version` festgelegt ist, erstellt einen Job, der die gleichen Schritte ausführt. - -Jeder Job in der Matrix kann mithilfe des `Matrix`-Kontexts auf den im Array `node-version` definierten Wert zugreifen. Die Aktion `setup-node` verwendet den Kontext als Eingabe für `node-version`. Die Aktion `setup-node` konfiguriert jeden Job mit einer anderen Node.js-Version bevor sie den Code baut und testet. Weitere Informationen zu Matrix-Strategien und Kontexten findest Du unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix)“ und „[Kontext- und Ausdruckssyntax für {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)“. - -{% raw %} -```yaml -strategy: - matrix: - node-version: [8.x, 10.x, 12.x] - -steps: -- uses: actions/checkout@v2 -- name: Use Node.js ${{ matrix.node-version }} - uses: actions/setup-node@v1 - with: - node-version: ${{ matrix.node-version }} -``` -{% endraw %} - -Alternativ kannnst Du auch mit genauen Node.js-Versionen bauen und testen. - -```yaml -strategy: - matrix: - node-version: [8.16.2, 10.17.0] -``` - -Oder Du kannst auch mithilfe einer einzelnen Version von Node.js bauen und testen. - -{% raw %} -```yaml -name: Node.js CI - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - name: Use Node.js - uses: actions/setup-node@v1 - with: - node-version: '12.x' - - run: npm install - - run: npm run build --if-present - - run: npm test - env: - CI: true -``` -{% endraw %} - -Wenn Du keine Node.js Version festlegst, verwendet {% data variables.product.prodname_dotcom %} die standardmäßige Node.js Version der Umgebung. Weitere Informationen findest Du unter „[Auf {% data variables.product.prodname_dotcom %}-gehosteten Runnern installierte Software](/actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners)“. - -### Abhängigkeiten installieren - -Auf {% data variables.product.prodname_dotcom %}-gehosteten Runnern sind die Abhängigkeitsmanager npm und Yarn installiert. Du kannst npm und Yarn verwenden, um in Ihrem Workflow Abhängigkeiten zu installieren, bevor Du Deinen Code baust und testest. Die auf {% data variables.product.prodname_dotcom %} gehosteten Windows- und Linux-Runner haben auch Grunt, Gulp und Bower installiert. - -Du kannst Abhängigkeiten auch im Cache zwischenspeichern, um Deinen Workflow zu beschleunigen. Weitere Informationen findest Du unter „[Abhängigkeiten im Cache zwischenspeichern, um Deinen Workflow zu beschleunigen](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)“. - -#### Beispiel mit npm - -Dieses Beispiel installiert die Abhängigkeiten, die in der Datei *package.json* definiert sind. Weitere Informationen findest Du unter [`npm install`](https://docs.npmjs.com/cli/install). - -```yaml -steps: -- uses: actions/checkout@v2 -- name: Use Node.js - uses: actions/setup-node@v1 - with: - node-version: '12.x' -- name: Install dependencies - run: npm install -``` - -Du kannst mithilfe `npm ci` die Versionen in der Datei *package-lock.json* oder *npm-shrinkwrap.json* installieren und Aktualisierungen der Sperrdatei verhindern. `npm ci` zu verwenden ist gewöhnlich schneller als `npm install` laufen zu lassen. Weitere Informationen findest Du unter [`npm ci`](https://docs.npmjs.com/cli/ci.html) und „[Einführung in `npm ci` für schnellere und zuverlässigere Builds](https://blog.npmjs.org/post/171556855892/introducing-npm-ci-for-faster-more-reliable)“. - -{% raw %} -```yaml -steps: -- uses: actions/checkout@v2 -- name: Use Node.js - uses: actions/setup-node@v1 - with: - node-version: '12.x' -- name: Install dependencies - run: npm ci -``` -{% endraw %} - -#### Beispiel mit Yarn - -Dieses Beispiel installiert die Abhängigkeiten, die in der Datei *package.json* definiert sind. Weitere Informationen findest Du unter [`Yarn-Installation`](https://yarnpkg.com/en/docs/cli/install). - -```yaml -steps: -- uses: actions/checkout@v2 -- name: Use Node.js - uses: actions/setup-node@v1 - with: - node-version: '12.x' -- name: Install dependencies - run: yarn -``` - -Alternativ kannst Du `--frozen-lockfile` übergeben, um die Versionen in der Datei *yarn.lock* zu installieren und Aktualisierungen der Datei *yarn.lock* zu verhindern. - -```yaml -steps: -- uses: actions/checkout@v2 -- name: Use Node.js - uses: actions/setup-node@v1 - with: - node-version: '12.x' -- name: Install dependencies - run: yarn --frozen-lockfile -``` - -#### Beispiel mit einer privaten Registry und Erstellung der Datei .npmrc - -{% data reusables.github-actions.setup-node-intro %} - -Um Dich bei Deiner privaten Registry zu authentifizieren, musst Du in Deinen Repository-Einstellungen Dein npm-Authentifizierungs-Token als Geheimnis ablegen. Erstelle z.B. ein Geheimnis namens `NPM_TOKEN`. Weitere Informationen findest Du unter „[Verschlüsselte Geheimnisse erstellen und verwenden](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)“. - -Im folgenden Beispiel enthält das Geheimnis `NPM_TOKEN` den npm-Authentifizierungs-Token. Die Aktion `setup-node` konfiguriert die Datei *.npmrc*, um den npm-Authentifizierung-Token aus der Umgebungsvariablen `NODE_AUTH_TOKEN` zu lesen. Wenn Du die Aktion `setup-node` verwendest, um eine Datei *.npmrc* zu erstellen, musst Du die Umgebungsvariable `NPM_AUTH_TOKEN` auf das Geheimnis setzen, das Deinen npm-Authentifizierungs-Token enthält. - -Bevor Du Abhängigkeiten installierst, verwende die Aktion `setup-node`, um die Datei *.npmrc* zu erstellen. Die Aktion hat zwei Eingabeparameter. Der Parameter `node-version` legt die Version von Node.js fest und der Parameter `registry-url` bestimmt die Standard-Registry. Wenn Deine Paket-Registry Geltungsbereiche verwendet, musst Du den Parameter `scope` verwenden. Weitere Informationen findest Du unter [`npm-scope`](https://docs.npmjs.com/misc/scope). - -{% raw %} -```yaml -steps: -- uses: actions/checkout@v2 -- name: Use Node.js - uses: actions/setup-node@v1 - with: - always-auth: true - node-version: '12.x' - registry-url: https://registry.npmjs.org - scope: '@octocat' -- name: Install dependencies - run: npm ci - env: - NODE_AUTH_TOKEN: ${{secrets.NPM_TOKEN}} -``` -{% endraw %} - -Das obige Beispiel erzeugt eine *.npmrc* Datei mit folgendem Inhalt: - -``` -//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN} -@octocat:registry=https://registry.npmjs.org/ -always-auth=true -``` - -#### Beispiel zum Zwischenspeichern von Abhängigkeiten im Cache - -Du kannst Abhängigkeiten mit einem eindeutigen Schlüssel im Cache zwischenspeichern und sie später wiederherstellen, wenn Du zukünftige Workflows mit der Aktion `-cache-` ausführst. Weitere Informationen findest Du unter „[Caching-Abhängigkeiten zur Beschleunigung von Workflows](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)“ und der [Aktion `cache`](https://github.com/marketplace/actions/cache). - -{% raw %} -```yaml -steps: -- uses: actions/checkout@v2 -- name: Use Node.js - uses: actions/setup-node@v1 - with: - node-version: '12.x' -- name: Cache Node.js modules - uses: actions/cache@v2 - with: - # npm cache files are stored in `~/.npm` on Linux/macOS - path: ~/.npm - key: ${{ runner.OS }}-node-${{ hashFiles('**/package-lock.json') }} - restore-keys: | - ${{ runner.OS }}-node- - ${{ runner.OS }}- -- name: Install dependencies - run: npm ci -``` -{% endraw %} - -### Deinen Code bauen und testen - -Du kannst die gleichen Befehle verwenden, die Du auch lokal verwendest, um Deinen Code zu erstellen und zu testen. Wenn Du beispielsweise `npm run build` ausführst, um die in Deinem *package.json* definierten Build-Schritte zu durchlaufen, und `npm test`, um Deine Testsuite laufen zu lassen, dann fügst Di diese Befehle in Deine Workflow-Datei ein. - -```yaml -steps: -- uses: actions/checkout@v2 -- name: Use Node.js - uses: actions/setup-node@v1 - with: - node-version: '12.x' -- run: npm install -- run: npm run build --if-present -- run: npm test -``` - -### Workflow-Daten als Artefakte paketieren - -Du kannst Artefakte aus deinen Build- und Testschritten speichern, um sie nach dem Abschluss eines Jobs anzuzeigen. Zum Beispiel kann es notwendig sein, Logdateien, Core Dumps, Testergebnisse oder Screenshots zu speichern. Weitere Informationen findest Du unter „[Workflow-Daten mittels Artefakten persistieren](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)“. - -### In Paket-Registries veröffentlichen - -Du kannst Deinen Workflow so konfigurieren, dass Dein Node.js-Paket nach Bestehen Deiner CI-Tests in einer Paket-Registry veröffentlicht wird. Weitere Informationen zum Veröffentlichen in npm und {% data variables.product.prodname_registry %} findest Du unter „[Node.js Pakete veröffentlichen](/actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages)“. diff --git a/translations/de-DE/content/actions/language-and-framework-guides/using-python-with-github-actions.md b/translations/de-DE/content/actions/language-and-framework-guides/using-python-with-github-actions.md deleted file mode 100644 index ac4d936ed2c2..000000000000 --- a/translations/de-DE/content/actions/language-and-framework-guides/using-python-with-github-actions.md +++ /dev/null @@ -1,426 +0,0 @@ ---- -title: Python mit GitHub-Aktionen verwenden -intro: 'Du kannst einen Workflow für kontinuierliche Integration (CI) erstellen, um Dein Python-Projekt zu bauen und zu testen.' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/using-python-with-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Einführung - -Diese Anleitung zeigt Dir, wie Du ein Python-Paket baust, testest und veröffentlichst. - -{% data variables.product.prodname_dotcom %}-gehostete Runner haben einen Tools-Cache mit vorinstallierter Software, einschließlich Python und PyPy. Du brauchst nichts zu installieren! Eine vollständige Liste der aktuellen Software und der vorinstallierten Versionen von Python und PyPy findest Du unter [Auf {% data variables.product.prodname_dotcom %}-gehosteten Runnern installierte Software](/actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners). - -### Vorrausetzungen - -Du solltest mit YAML und der Syntax für {% data variables.product.prodname_actions %} vertraut sein. Weitere Informationen findest Du unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)“. - -Du solltest ein grundlegendes Verständnis von Python, PyPy und pip haben. Weitere Informationen findest Du unter: -- [Erste Schritte mit Python](https://www.python.org/about/gettingstarted/) -- [PyPy](https://pypy.org/) -- [Paketmanager pip](https://pypi.org/project/pip/) - -{% data reusables.actions.enterprise-setup-prereq %} - -### Einstieg mit der Python-Workflow-Vorlage - -{% data variables.product.prodname_dotcom %} bietet eine Python-Workflow-Vorlage, die für die meisten Python-Projekte funktionieren sollte. Diese Anleitung enthält Beispiele, mit denen Du die Vorlage anpassen kannst. Weitere Informationen findest Du in der [Python-Workflow-Vorlage](https://github.com/actions/starter-workflows/blob/master/ci/python-package.yml). - -Um schnell loszulegen, füge die Vorlage in das Verzeichnis `.github/workflows` Deines Repositorys ein. - -{% raw %} -```yaml -name: Python package - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - strategy: - matrix: - python-version: [2.7, 3.5, 3.6, 3.7, 3.8] - - steps: - - uses: actions/checkout@v2 - - name: Set up Python ${{ matrix.python-version }} - uses: actions/setup-python@v2 - with: - python-version: ${{ matrix.python-version }} - - name: Install dependencies - run: | - python -m pip install --upgrade pip - pip install flake8 pytest - if [ -f requirements.txt ]; then pip install -r requirements.txt; fi - - name: Lint with flake8 - run: | - # stop the build if there are Python syntax errors or undefined names - flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics - # exit-zero behandelt alle Fehler als Warnungen. Der GitHub-Editor ist 127 Zeichen breit - flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics - - name: Test with pytest - run: | - pytest -``` -{% endraw %} - -### Eine Python-Version angeben - -Benutze die Aktion `setup-python`, um eine vorinstallierte Version von Python oder PyPy auf einem {% data variables.product.prodname_dotcom %}-gehosteten Runner zu verwenden. Diese Aktion findet aus dem Tool-Cache auf jedem Runner eine bestimmte Version von Python oder PyPy und fügt die benötigten Binärdateien zum `PATH`hinzu, der für den Rest des Jobs bestehen bleibt. Wenn eine bestimmte Version von Python nicht im Tools-Cache vorinstalliert ist, lädt die Aktion `setup-python` die entsprechende Version vom [Repository `python-versions`](https://github.com/actions/python-versions) herunter und richtet sie ein. - -Die `setup-action` ist die empfohlene Methode, Python mit {% data variables.product.prodname_actions %} zu verwenden, da dadurch ein einheitliches Verhalten der verschiedenen Runner und verschiedenen Versionen von Python gewährleistet wird. Wenn Du einen selbst gehosteten Runner verwendest, musst Du Python installieren und zum `PATH` hinzufügen. Weitere Informationen findest Du in der [Aktion `setup-python`](https://github.com/marketplace/actions/setup-python). - -Die folgende Tabelle zeigt für jeden {% data variables.product.prodname_dotcom %}-gehosteten Runner, wo der Tools-Cache liegt. - -| | Ubuntu | Mac | Windows | -| -------------------------- | ------------------------------- | ---------------------------------------- | ------------------------------------------ | -| **Tool-Cache-Verzeichnis** | `/opt/hostedtoolcache/*` | `/Users/runner/hostedtoolcache/*` | `C:\hostedtoolcache\windows\*` | -| **Tool-Cache für Python** | `/opt/hostedtoolcache/Python/*` | `/Users/runner/hostedtoolcache/Python/*` | `C:\hostedtoolcache\windows\Python\*` | -| **Tool-Cache für PyPy** | `/opt/hostedtoolcache/PyPy/*` | `/Users/runner/hostedtoolcache/PyPy/*` | `C:\hostedtoolcache\windows\PyPy\*` | - -Wenn Du einen selbst gehosteten Runner verwendest, kannst Du den Runner so konfigurieren, dass er mithilfe der Aktion `setup-python` Deine Abhängigkeiten verwaltet. Weitere Informationen findest Du unter [setup-python mit einem selbst-gehosteten Runner verwenden](https://github.com/actions/setup-python#using-setup-python-with-a-self-hosted-runner) in der README von `setup-python`. - -{% data variables.product.prodname_dotcom %} unterstützt dir Syntax für semantische Versionierung. Weitere Informationen findest Du unter „[Semantische Versionierung verwenden](https://docs.npmjs.com/about-semantic-versioning#using-semantic-versioning-to-specify-update-types-your-package-can-accept)“ und „[Spezifikation für semantische Versionierung](https://semver.org/)“. - -#### Mehrere Python-Versionen verwenden - -{% raw %} -```yaml -name: Python package - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - strategy: - # Du kannst in python-version die PyPy-Versionen angeben, - # For example, pypy2 and pypy3 - matrix: - python-version: [2.7, 3.5, 3.6, 3.7, 3.8] - - steps: - - uses: actions/checkout@v2 - - name: Set up Python ${{ matrix.python-version }} - uses: actions/setup-python@v2 - with: - python-version: ${{ matrix.python-version }} - # You can test your matrix by printing the current Python version - - name: Display Python version - run: python -c "import sys; print(sys.version)" -``` -{% endraw %} - -#### Eine bestimmten Python-Version verwenden - -Du kannst eine bestimmte Version von Python konfigurieren, For example, 3.8. Alternativ kannst Du auch Syntax für semantische Versionierung verwenden, um das neuste Minor Release zu erhalten. Dieses Beispiel verwendet das neueste Minor Release von Python 3. - -{% raw %} -```yaml -name: Python package - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - name: Set up Python 3.x - uses: actions/setup-python@v2 - with: - # Semantic version range syntax or exact version of a Python version - python-version: '3.x' - # Optional - x64 or x86 architecture, defaults to x64 - architecture: 'x64' - # You can test your matrix by printing the current Python version - - name: Display Python version - run: python -c "import sys; print(sys.version)" -``` -{% endraw %} - -#### Eine Version ausschließen - -Wenn du eine Version von Python angibst, die nicht verfügbar ist, schlägt `setup-python` fehl und meldet in etwa: `##[error]Version 3.4 with arch x64 not found`. Die Fehlermeldung enthält die verfügbaren Versionen. - -Du kannst in Deinem Workflow auch das Schlüsselwort `exclude` verwenden, wenn Du eine bestimmte Konfiguration von Python nicht laufen lassen möchtest. Weitere Informationen findest Du unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategy)“. - -{% raw %} -```yaml -name: Python package - -on: [push] - -jobs: - build: - - runs-on: ${{ matrix.os }} - strategy: - matrix: - os: [ubuntu-latest, macos-latest, windows-latest] - python-version: [2.7, 3.6, 3.7, 3.8, pypy2, pypy3] - exclude: - - os: macos-latest - python-version: 3.6 - - os: windows-latest - python-version: 3.6 -``` -{% endraw %} - -#### Die Standard-Version von Python verwenden - -Wir empfehlen, `setup-python` zu verwenden, um die Version von Python zu konfigurieren, die in deinen Workflows verwendet wird, da es hilft, deine Abhängigkeiten explizit zu machen. Wenn du `setup-python` nicht verwendest, wird in jeder Shell, wenn Du `python` aufrufst, die Standardversion von Python verwendet, die in `PATH` gesetzt wurde. Die Standardversion von Python variiert zwischen den {% data variables.product.prodname_dotcom %}-gehosteten Runnern. Dies kann zu unerwarteten Abweichungen führen oder es kann unerwartet eine ältere Version verwendet werden. - -| {% data variables.product.prodname_dotcom %}-gehostete Runner | Beschreibung | -| ------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Ubuntu | Auf Ubuntu-Runnern sind mehrere Versionen von System-Python unter `/usr/bin/python` und `/usr/bin/python3` installiert. Die Python-Versionen, die mit Ubuntu mitgeliefert werden, sind zusätzlich zu den Versionen, die {% data variables.product.prodname_dotcom %} im Tools-Cache installiert. | -| Windows | Neben den Python-Versionen, die sich im Tools-Cache befinden, kommt Windows nicht mit einer entsprechenden Version von System-Python. Um das mit anderen Runnern konsistente Verhalten sicherzustellen und um Python „out-of-the-box“ ohne die Aktion `setup-python` nutzen zu können fügt {% data variables.product.prodname_dotcom %} ein paar Versionen aus dem Tools-Cache zum `PATH` hinzu. | -| macOS | Auf macOS-Runnern sind zusätzlich zu den Versionen im Tool-Cache noch mehrere Versionen von System-Python installiert. Die Python-Versionen des Systems befinden sich im Verzeichnis `/usr/local/Cellar/python/*`. | - -### Abhängigkeiten installieren - -Auf {% data variables.product.prodname_dotcom %}-gehosteten Runnern ist der Paketmanager pip installiert. Du kannst pip verwenden, um Abhängigkeiten von der PyPI-Paket-Registry zu installieren, bevor Du Deinen Code baust und testest. Zum Beispiel installiert oder aktualisiert der folgende YAML den Paket-Installierer `pip` sowie die Pakete `setuptools` und `wheel`. - -Du kannst Abhängigkeiten auch im Cache zwischenspeichern, um Deinen Workflow zu beschleunigen. Weitere Informationen findest Du unter „[Abhängigkeiten im Cache zwischenspeichern, um Deinen Workflow zu beschleunigen](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)“. - -{% raw %} -```yaml -steps: -- uses: actions/checkout@v2 -- name: Set up Python - uses: actions/setup-python@v2 - with: - python-version: '3.x' -- name: Install dependencies - run: python -m pip install --upgrade pip setuptools wheel -``` -{% endraw %} - -#### Datei für „Requirements“ (Anforderungen) - -Nach dem Update von `pip` werden üblicherweise im nächsten Schritt die Abhängigkeiten aus *requirements.txt* installiert. - -{% raw %} -```yaml -steps: -- uses: actions/checkout@v2 -- name: Set up Python - uses: actions/setup-python@v2 - with: - python-version: '3.x' -- name: Install dependencies - run: | - python -m pip install --upgrade pip - pip install -r requirements.txt -``` -{% endraw %} - -#### Abhängigkeiten im Cache zwischenspeichern - -You can cache pip dependencies using a unique key, and restore the dependencies when you run future workflows using the [`cache`](https://github.com/marketplace/actions/cache) action. For more information, see "[Caching dependencies to speed up workflows](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)." - -Pip caches dependencies in different locations, depending on the operating system of the runner. The path you'll need to cache may differ from the Ubuntu example below depending on the operating system you use. For more information, see [Python caching examples](https://github.com/actions/cache/blob/master/examples.md#python---pip). - -{% raw %} -```yaml -steps: -- uses: actions/checkout@v2 -- name: Setup Python - uses: actions/setup-python@v2 - with: - python-version: '3.x' -- name: Cache pip - uses: actions/cache@v2 - with: - # This path is specific to Ubuntu - path: ~/.cache/pip - # Look to see if there is a cache hit for the corresponding requirements file - key: ${{ runner.os }}-pip-${{ hashFiles('requirements.txt') }} - restore-keys: | - ${{ runner.os }}-pip- - ${{ runner.os }}- -- name: Install dependencies - run: pip install -r requirements.txt -``` -{% endraw %} - -{% note %} - -**Note:** Depending on the number of dependencies, it may be faster to use the dependency cache. Projects with many large dependencies should see a performance increase as it cuts down the time required for downloading. Projects with fewer dependencies may not see a significant performance increase and may even see a slight decrease due to how pip installs cached dependencies. The performance varies from project to project. - -{% endnote %} - -### Deinen Code testen - -Du kannst die gleichen Befehle verwenden, die Du auch lokal verwendest, um Deinen Code zu erstellen und zu testen. - -#### Mit pytest und pytest-cov testen - -This example installs or upgrades `pytest` and `pytest-cov`. Tests are then run and output in JUnit format while code coverage results are output in Cobertura. For more information, see [JUnit](https://junit.org/junit5/) and [Cobertura](https://cobertura.github.io/cobertura/). - -{% raw %} -```yaml -steps: -- uses: actions/checkout@v2 -- name: Set up Python - uses: actions/setup-python@v2 - with: - python-version: '3.x' -- name: Install dependencies - run: | - python -m pip install --upgrade pip - pip install -r requirements.txt -- name: Test with pytest - run: | - pip install pytest - pip install pytest-cov - pytest tests.py --doctest-modules --junitxml=junit/test-results.xml --cov=com --cov-report=xml --cov-report=html -``` -{% endraw %} - -#### Mit Flake8 den Code von „Fusseln“ reinigen - -The following example installs or upgrades `flake8` and uses it to lint all files. For more information, see [Flake8](http://flake8.pycqa.org/en/latest/). - -{% raw %} -```yaml -steps: -- uses: actions/checkout@v2 -- name: Set up Python - uses: actions/setup-python@v2 - with: - python-version: '3.x' -- name: Install dependencies - run: | - python -m pip install --upgrade pip - pip install -r requirements.txt -- name: Lint with flake8 - run: | - pip install flake8 - flake8 . -``` -{% endraw %} - -#### Tests mit Tox ausführen - -With {% data variables.product.prodname_actions %}, you can run tests with tox and spread the work across multiple jobs. You'll need to invoke tox using the `-e py` option to choose the version of Python in your `PATH`, rather than specifying a specific version. For more information, see [tox](https://tox.readthedocs.io/en/latest/). - -{% raw %} -```yaml -name: Python package - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - strategy: - matrix: - python: [2.7, 3.7, 3.8] - - steps: - - uses: actions/checkout@v2 - - name: Setup Python - uses: actions/setup-python@v2 - with: - python-version: ${{ matrix.python }} - - name: Install Tox and any other packages - run: pip install tox - - name: Run Tox - # Run tox using the version of Python in `PATH` - run: tox -e py -``` -{% endraw %} - -### Workflow-Daten als Artefakte paketieren - -You can upload artifacts to view after a workflow completes. Zum Beispiel kann es notwendig sein, Logdateien, Core Dumps, Testergebnisse oder Screenshots zu speichern. Weitere Informationen findest Du unter "[Workflow-Daten mittels Artefakten persistieren](/github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)." - -The following example demonstrates how you can use the `upload-artifact` action to archive test results from running `pytest`. For more information, see the [`upload-artifact` action](https://github.com/actions/upload-artifact). - -{% raw %} -```yaml -name: Python package - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - strategy: - matrix: - python-version: [2.7, 3.5, 3.6, 3.7, 3.8] - - steps: - - uses: actions/checkout@v2 - - name: Setup Python # Set Python version - uses: actions/setup-python@v2 - with: - python-version: ${{ matrix.python-version }} - # Install pip and pytest - - name: Install dependencies - run: | - python -m pip install --upgrade pip - pip install pytest - - name: Test with pytest - run: pytest tests.py --doctest-modules --junitxml=junit/test-results-${{ matrix.python-version }}.xml - - name: Upload pytest test results - uses: actions/upload-artifact@v2 - with: - name: pytest-results-${{ matrix.python-version }} - path: junit/test-results-${{ matrix.python-version }}.xml - # Use always() to always run this step to publish test results when there are test failures - if: ${{ always() }} -``` -{% endraw %} - -### In Paket-Registries veröffentlichen - -You can configure your workflow to publish your Python package to any package registry you'd like when your CI tests pass. - -You can store any access tokens or credentials needed to publish your package using repository secrets. The following example creates and publishes a package to PyPI using `twine` and `dist`. Weitere Informationen findest Du unter "[Verschlüsselte Geheimnisse erstellen und verwenden](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". - -{% raw %} -```yaml -name: Upload Python Package - -on: - release: - types: [created] - -jobs: - deploy: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - - name: Set up Python - uses: actions/setup-python@v2 - with: - python-version: '3.x' - - name: Install dependencies - run: | - python -m pip install --upgrade pip - pip install setuptools wheel twine - - name: Build and publish - env: - TWINE_USERNAME: ${{ secrets.PYPI_USERNAME }} - TWINE_PASSWORD: ${{ secrets.PYPI_PASSWORD }} - run: | - python setup.py sdist bdist_wheel - twine upload dist/* -``` -{% endraw %} - -For more information about the template workflow, see [`python-publish`](https://github.com/actions/starter-workflows/blob/master/ci/python-publish.yml). diff --git a/translations/de-DE/content/actions/migrating-to-github-actions/index.md b/translations/de-DE/content/actions/migrating-to-github-actions/index.md deleted file mode 100644 index cef5eb52d52d..000000000000 --- a/translations/de-DE/content/actions/migrating-to-github-actions/index.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: Zu GitHub-Aktionen migrieren -intro: 'Migriere von anderen Anbietern der Kontinuierlichen Integration (CI) zu {% data variables.product.prodname_actions %}.' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -{% link_in_list /migrating-from-circleci-to-github-actions %} -{% link_in_list /migrating-from-azure-pipelines-to-github-actions %} -{% link_in_list /migrating-from-jenkins-to-github-actions %} diff --git a/translations/de-DE/content/actions/migrating-to-github-actions/migrating-from-azure-pipelines-to-github-actions.md b/translations/de-DE/content/actions/migrating-to-github-actions/migrating-from-azure-pipelines-to-github-actions.md deleted file mode 100644 index 6743a7ebcf86..000000000000 --- a/translations/de-DE/content/actions/migrating-to-github-actions/migrating-from-azure-pipelines-to-github-actions.md +++ /dev/null @@ -1,325 +0,0 @@ ---- -title: Von Azure-Pipelines zu GitHub-Aktionen migrieren -intro: '{% data variables.product.prodname_actions %} und Azure-Pipelines haben mehrere Ähnlichkeiten in der Konfiguration, was die Migration zu {% data variables.product.prodname_actions %} relativ einfach macht.' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Einführung - -Azure-Pipelines und {% data variables.product.prodname_actions %} ermöglichen es Dir, Workflows zu erstellen, die automatisch Code bauen, testen, publizieren, freigeben und bereitstellen. Azure-Pipelines und {% data variables.product.prodname_actions %} haben einige Ähnlichkeiten in der Workflow-Konfiguration: - -- Workflow-Konfigurationsdateien werden in YAML geschrieben und im Code-Repository gespeichert. -- Workflows umfassen einen oder mehrere Jobs. -- Jobs beinhalten einen oder mehrere Schritte oder einzelne Befehle. -- Schritte oder Aufgaben können wiederverwendet und in der Community gemeinsam genutzt werden. - -Weitere Informationen findest Du unter „[Kernkonzepte für {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)“. - -### Wesentliche Unterschiede - -Bei der Migration von Azure-Pipelines sollten die folgenden Unterschiede beachtet werden: - -- Azure Pipelines unterstützt einen veralteten _klassischen Editor_, mit dem Du Deine CI-Konfiguration in einem GUI-Editor definieren kannst, anstatt die Pipeline-Definition in einer YAML-Datei zu erstellen. {% data variables.product.prodname_actions %} verwendet YAML-Dateien, um Workflows zu definieren, und unterstützt keinen grafischen Editor. -- Azure Pipelines erlaubt Dir, einige Strukturen in Job-Definitionen zu weglassen. Wenn Du zum Beispiel nur einen einzigen Job hast, brauchst Du den Job an sich nicht zu definieren, sondern nur seine Schritte. {% data variables.product.prodname_actions %} erfordert eine explizite Konfiguration und die YAML-Struktur kann nicht weggelassen werden. -- Azure Pipelines unterstützt _„stages“ (Phasen)_ die in der YAML-Datei definiert sind, welche verwendet werden kann, um Workflows für die Bereitstellung zu erstellen. {% data variables.product.prodname_actions %} erfordert, die Phasen in separate YAML-Workflowdateien zu aufzuteilen. -- Bei Azure-Pipelines können lokale Build-Agenten nach Funktionalität ausgewählt werden. Bei {% data variables.product.prodname_actions %} können selbst-gehostete Runner nach Labels ausgewählt werden. - -### Jobs und Schritte migrieren - -Jobs und Schritte in Azure-Pipelines sind sehr ähnlich zu Jobs und Schritten in {% data variables.product.prodname_actions %}. In beiden Systemen haben Jobs folgende Merkmale: - -* Jobs enthalten eine Reihe von Schritten, die nacheinander ausgeführt werden. -* Jobs laufen auf separaten virtuellen Maschinen oder in separaten Containern. -* Jobs werden standardmäßig parallel ausgeführt, können aber so konfiguriert werden, dass sie sequentiell laufen. - -### Skriptschritte migrieren - -Du kannst in einem Workflow ein Skript oder einen Shell-Befehl als Schritt ausführen. In Azure-Pipelines können Skriptschritte mit dem Schlüssel `script`, `bash`, `powershell` oder `pwsh` festgelegt werden. Skripte können auch als Eingabe für den [Bash-Task](https://docs.microsoft.com/en-us/azure/devops/pipelines/tasks/utility/bash?view=azure-devops) oder den [PowerShell-Task](https://docs.microsoft.com/en-us/azure/devops/pipelines/tasks/utility/powershell?view=azure-devops) angegeben werden. - -In {% data variables.product.prodname_actions %} sind alle Skripte mit dem Schlüssel `run` spezifiziert. Um eine bestimmte Shell auszuwählen, kannst Du den Schlüssel `shell` angeben, wenn Du das Skript zur Verfügung stellst. Weitere Informationen findest Du unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)“. - -Nachfolgend ein Beispiel für die Syntax in jedem System: - - - - - - - - - - -
    -Azure-Pipelines - -{% data variables.product.prodname_actions %} -
    -{% raw %} -```yaml -jobs: -- job: scripts - pool: - vmImage: 'windows-latest' - steps: - - script: echo "This step runs in the default shell" - - bash: echo "This step runs in bash" - - pwsh: Write-Host "This step runs in PowerShell Core" - - task: PowerShell@2 - inputs: - script: Write-Host "This step runs in PowerShell" -``` -{% endraw %} - -{% raw %} -```yaml -jobs: - scripts: - runs-on: windows-latest - steps: - - run: echo "This step runs in the default shell" - - run: echo "This step runs in bash" - shell: bash - - run: Write-Host "This step runs in PowerShell Core" - shell: pwsh - - run: Write-Host "This step runs in PowerShell" - shell: powershell -``` -{% endraw %} -
    - -### Unterschiede in der Behandlung von Skriptfehlern - -In Azure-Pipelines können Skripte dazu konfiguriert werden, fehlzuschlagen, wenn irgendeine Ausgabe an `stderr` gesendet wird. {% data variables.product.prodname_actions %} unterstützt diese Konfiguration nicht. - -{% data variables.product.prodname_actions %} konfiguriert Shells zum "schnellen Scheitern" wann immer möglich , was das Skript sofort beendet, wenn einer der Befehle in einem Skript mit einem Fehlercode endet. Im Gegensatz dazu erfordern Azure-Pipelines explizite Konfiguration, um bei einem Fehler sofort abzubrechen. Weitere Informationen findest Du unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#exit-codes-and-error-action-preference)“. - -### Unterschiede in der Standard-Shell unter Windows - -In Azure-Pipelines ist die Standard-Shell für Skripte auf Windows-Plattformen die Command-Shell (_cmd.exe_). In {% data variables.product.prodname_actions %} ist die Standard-Shell für Skripte auf Windows-Plattformen die PowerShell. PowerShell hat mehrere Unterschiede in internen Befehlen, Auswertung von Variablen und Flusssteuerung. - -Wenn Du einen einfachen Befehl ausführst, kannst Du in PowerShell möglicherweise ein Skript der Command Shell ohne Änderungen laufen lassen. Aber in den meisten Fällen musst Du entweder Dein Skript zur Syntax der PowerShell aktualisieren oder {% data variables.product.prodname_actions %} anweisen, das Skript mit der Command Shell statt mit PowerShell auszuführen. Dies kannst Du tun, indem Du unter `shell` den Wert `cmd` angibst. - -Nachfolgend ein Beispiel für die Syntax in jedem System: - - - - - - - - - - -
    -Azure-Pipelines - -{% data variables.product.prodname_actions %} -
    -{% raw %} -```yaml -jobs: -- job: run_command - pool: - vmImage: 'windows-latest' - steps: - - script: echo "This step runs in CMD on Windows by default" -``` -{% endraw %} - -{% raw %} -```yaml -jobs: - run_command: - runs-on: windows-latest - steps: - - run: echo "This step runs in PowerShell on Windows by default" - - run: echo "This step runs in CMD on Windows explicitly" - shell: cmd -``` -{% endraw %} -
    - -Weitere Informationen findest Du unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#using-a-specific-shell)“. - -### Syntax für Bedingungen und Ausdrücke migrieren - -Sowohl Azure-Pipelines als auch {% data variables.product.prodname_actions %} können Schritte bedingt ausführen. In Azure-Pipelines werden bedingte Ausdrücke mit dem Schlüssel `condition` angegeben. In {% data variables.product.prodname_actions %} werden bedingte Ausdrücke mit dem Schlüssel `if` angegeben. - -Azure-Pipelines verwenden Funktionen innerhalb von Ausdrücken, um Schritte bedingt auszuführen. Im Gegensatz dazu verwenden {% data variables.product.prodname_actions %} eine Infix-Notation. Zum Beispiel musst Du die Funktion `eq` in Azure-Pipelines durch den Operator `==` in {% data variables.product.prodname_actions %} ersetzen. - -Nachfolgend ein Beispiel für die Syntax in jedem System: - - - - - - - - - - -
    -Azure-Pipelines - -{% data variables.product.prodname_actions %} -
    -{% raw %} -```yaml -jobs: -- job: conditional - pool: - vmImage: 'ubuntu-latest' - steps: - - script: echo "This step runs with str equals 'ABC' and num equals 123" - condition: and(eq(variables.str, 'ABC'), eq(variables.num, 123)) -``` -{% endraw %} - -{% raw %} -```yaml -jobs: - conditional: - runs-on: ubuntu-latest - steps: - - run: echo "This step runs with str equals 'ABC' and num equals 123" - if: ${{ env.str == 'ABC' && env.num == 123 }} -``` -{% endraw %} -
    - -Weitere Informationen findest Du unter "[Kontext- und Ausdrucks-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)". - -### Abhängigkeiten zwischen Jobs - -Sowohl bei Azure-Pipelines als auch bei {% data variables.product.prodname_actions %} kannst Du Abhängigkeiten für einen Job festlegen. In beiden Systemen laufen Jobs standardmäßig parallel, aber Jobabhängigkeiten können explizit angegeben werden. In Azure-Pipelines erfolgt dies mit dem Schlüssel `dependsOn`. In {% data variables.product.prodname_actions %}wird dies mit dem Schlüssel `needs` getan. - -Nachfolgend ein Beispiel für die Syntax in jedem System. Die Workflows starten einen ersten Job namens `initial` und wenn dieser Job beendet ist, laufen zwei Jobs namens `fanout1` und `fanout2`. Schließlich, wenn diese Jobs abgeschlossen sind, läuft der Job `fanin`. - - - - - - - - - - -
    -Azure-Pipelines - -{% data variables.product.prodname_actions %} -
    -{% raw %} -```yaml -jobs: -- job: initial - pool: - vmImage: 'ubuntu-latest' - steps: - - script: echo "This job will be run first." -job: fanout1 - pool: - vmImage: 'ubuntu-latest' - dependsOn: initial - steps: - - script: echo "This job will run after the initial job, in parallel with fanout2." -job: fanout2 - pool: - vmImage: 'ubuntu-latest' - dependsOn: initial - steps: - - script: echo "This job will run after the initial job, in parallel with fanout1." -job: fanin: - pool: - vmImage: 'ubuntu-latest' - dependsOn: [fanout1, fanout2] - steps: - - script: echo "This job will run after fanout1 and fanout2 have finished." -``` -{% endraw %} - -{% raw %} -```yaml -jobs: - initial: - runs-on: ubuntu-latest - steps: - - run: echo "This job will be run first." - fanout1: - runs-on: ubuntu-latest - needs: initial - steps: - - run: echo "This job will run after the initial job, in parallel with fanout2." - fanout2: - runs-on: ubuntu-latest - needs: initial - steps: - - run: echo "This job will run after the initial job, in parallel with fanout1." - fanin: - runs-on: ubuntu-latest - needs: [fanout1, fanout2] - steps: - - run: echo "This job will run after fanout1 and fanout2 have finished." -``` -{% endraw %} -
    - -Weitere Informationen findest Du unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)“. - -### „Tasks“ (Aufgaben) zu Aktionen migrieren - -Azure-Pipelines verwenden _tasks_. Das sind Anwendungskomponenten, die in mehreren Workflows wiederverwendet werden können. {% data variables.product.prodname_actions %} verwenden _Aktionen_, Diese können verwendet werden, um Aufgaben auszuführen und Ihren Workflow anzupassen. In beiden Systemen kannst Du den Namen der zu ausführenden Aufgabe oder Aktion sowie alle erforderlichen Eingaben als Schlüssel/Wert-Paare angeben. - -Nachfolgend ein Beispiel für die Syntax in jedem System: - - - - - - - - - - -
    -Azure-Pipelines - -{% data variables.product.prodname_actions %} -
    -{% raw %} -```yaml -jobs: -- job: run_python - pool: - vmImage: 'ubuntu-latest' - steps: - - task: UsePythonVersion@0 - inputs: - versionSpec: '3.7' - architecture: 'x64' - - script: python script.py -``` -{% endraw %} - -{% raw %} -```yaml -jobs: - run_python: - runs-on: ubuntu-latest - steps: - - uses: actions/setup-python@v2 - with: - python-version: '3.7' - architecture: 'x64' - - run: python script.py -``` -{% endraw %} -
    - -Aktionen zur Verwendung in Deinem Workflow findest du entweder auf dem [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace?type=actions) oder Du kannst eigene Aktionen erstellen. For more information, see "[Creating actions](/actions/creating-actions)." - diff --git a/translations/de-DE/content/actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions.md b/translations/de-DE/content/actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions.md deleted file mode 100644 index dd49b3bba319..000000000000 --- a/translations/de-DE/content/actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions.md +++ /dev/null @@ -1,445 +0,0 @@ ---- -title: Von CircleCI zu GitHub-Aktionen migrieren -intro: 'GitHub-Aktionen und CircleCI haben mehrere Ähnlichkeiten in der Konfiguration, was die Migration zu GitHub-Aktionen relativ einfach macht.' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Einführung - -CircleCI und {% data variables.product.prodname_actions %} ermöglichen es Dir, Workflows zu erstellen, die Code automatisch bauen, testen, veröffentlichen, freigeben und bereitstellen. CircleCI und {% data variables.product.prodname_actions %} haben einige Ähnlichkeiten in der Workflow-Konfiguration: - -- Workflow-Konfigurationsdateien werden in YAML geschrieben und im Repository gespeichert. -- Workflows umfassen einen oder mehrere Jobs. -- Jobs beinhalten einen oder mehrere Schritte oder einzelne Befehle. -- Schritte oder Aufgaben können wiederverwendet und in der Community gemeinsam genutzt werden. - -Weitere Informationen findest Du unter „[Kernkonzepte für {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)“. - -### Wesentliche Unterschiede - -Betrachte bei der Migration von CircleCI folgende Unterschiede: - -- Die automatische Testparallelität des CircleCI gruppiert die Tests automatisch nach benutzerdefinierten Regeln oder historischen Zeitinformationen. Diese Funktionalität ist in {% data variables.product.prodname_actions %} nicht eingebaut. -- Aktionen, die in Docker-Containern ausgeführt werden, sind sensibel für Berechtigungsprobleme, da Container eine andere Zuordnung von Benutzern haben. Du kannst viele dieser Probleme vermeiden, indem Du die Anweisung `USER` in Deinem *Dockerfile* nicht verwendest. Weitere Informationen über das Docker-Dateisystem findest Du unter „[Virtuelle Umgebungen für {% data variables.product.product_name %}-gehostete Runner](/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem)“. - -### Workflows und Jobs migrieren - -CircleCI definiert `Workflows` in der Datei *config.yml*, wodurch Du mehrere Workflows konfigurieren kannst. {% data variables.product.product_name %} benötigt pro Workflow eine Workflow-Datei und erfordert daher nicht `Workflows` zu deklarieren. Du musst für jeden Workflow, der in *config.yml* konfiguriert ist, eine neue Workflow-Datei erstellen. - -Sowohl CircleCI als auch {% data variables.product.prodname_actions %} konfigurieren `Jobs` in der Konfigurationsdatei, und das mit ähnlicher Syntax. Wenn Du Abhängigkeiten zwischen Jobs in Deinem CircleCI-Workflow mit `requires` konfigurierst, kannst Du in {% data variables.product.prodname_actions %} die äquivalente Syntax `needs` verwenden. Weitere Informationen findest Du unter „[Workflow-Syntax für {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)“. - -### „Orbs“ (Gestirne) zu Aktionen migrieren - -Sowohl CircleCI als auch {% data variables.product.prodname_actions %} bieten einen Mechanismus, um Aufgaben in einem Workflow wiederzuverwenden und weiterzugeben. CircleCI verwendet ein Konzept namens „Orbs“ (Gestirne), das in YAML geschrieben ist, um Aufgaben bereitzustellen, die man in einem Workflow wiederverwenden kann. {% data variables.product.prodname_actions %} hat mächtige und flexible wiederverwendbare Komponenten namens Aktionen, die man entweder mit JavaScript-Dateien oder mit Docker-Images erstellt. Um Aktionen zu erstellen, kannst Du eigenen Code schreiben, der mit Deinem Repository auf die gewünschte Weise interagiert und dabei beispielsweise in die APIs von {% data variables.product.product_name %} und beliebige öffentlich zugänglichen Drittanbieter-APIs integriert. Mit einer Aktion können Sie beispielsweise npm-Module veröffentlichen, SMS-Nachrichten bei dringenden Problemen senden oder produktionsreifen Code bereitstellen. For more information, see "[Creating actions](/actions/creating-actions)." - -CircleCI kann Workflows mit YAML-Ankern und Aliasen wiederverwenden. {% data variables.product.prodname_actions %} unterstützen den üblichen Bedarf an Wiederverwendbarkeit durch Build-Matrizen. Weitere Informationen zu Build-Matrizen findest Du unter „[Einen Workflow konfigurieren](/actions/configuring-and-managing-workflows/configuring-a-workflow#configuring-a-build-matrix)“. - -### Docker-Images verwenden - - -Sowohl CircleCI als auch {% data variables.product.prodname_actions %} können Schritte innerhalb eines Docker-Images ausführen. - -CircleCI stellt eine Reihe von vordefinierten Images mit üblichen Abhängigkeiten zur Verfügung. Diese Images haben `circleci` als `USER` gesetzt, was zu Konflikten mit {% data variables.product.prodname_actions %} führt. - -Wir empfehlen Dir, von vordefinierten CircleCI-Images zu wegzugehen, wenn Du zu {% data variables.product.prodname_actions %} migrierst. In vielen Fällen kannst Du die zusätzlich benötigten Abhängigkeiten mithilfe von Aktionen installieren. - -Weitere Informationen über das Docker-Dateisystem findest Du unter „[Virtuelle Umgebungen für {% data variables.product.product_name %}-gehostete Runner](/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem)“. - -Weitere Informationen zu den Tools und Paketen auf {% data variables.product.prodname_dotcom %}-gehosteten virtuellen Umgebungen findest Du unter „[Auf GitHub-gehosteten Runnern installierte Software](/actions/reference/software-installed-on-github-hosted-runners)“. - -### Variablen und Geheimnisse verwenden - -CircleCI und {% data variables.product.prodname_actions %} unterstützen das Setzen von Umgebungsvariablen in der Konfigurationsdatei und das Erstellen von Geheimnissen mit der Benutzeroberfläche von entweder CircleCI oder {% data variables.product.product_name %}. - -Weitere Informationen findest Du unter „[Umgebungsvariablen verwenden](/actions/configuring-and-managing-workflows/using-environment-variables)“ und „[Verschlüsselte Geheimnisse erstellen und verwenden](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)“. - -### Im Cache zwischenspeichern - -CircleCI und {% data variables.product.prodname_actions %} bieten in der Konfigurationsdatei eine Methode an, um Dateien manuell im Cache zwischenzuspeichern. - -Nachfolgend ein Beispiel für die Syntax in jedem System. - - - - - - - - - - -
    -CircleCI - -GitHub Actions -
    -{% raw %} -```yaml -- restore_cache: - keys: - - v1-npm-deps-{{ checksum "package-lock.json" }} - - v1-npm-deps- -``` -{% endraw %} - -{% raw %} -```yaml -- name: Cache node modules - uses: actions/cache@v2 - with: - path: ~/.npm - key: v1-npm-deps-${{ hashFiles('**/package-lock.json') }} - restore-keys: v1-npm-deps- -``` -{% endraw %} -
    - -Weitere Informationen findest Du unter „[Abhängigkeiten zur Beschleunigung von Workflows im Cache zwischenspeichern](/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows)“. - -{% data variables.product.prodname_actions %} hat kein Äquivalent zum „Docker Layer Caching“ („DLC“, im Cache auf Docker-Ebene zwischenspeichern). - -### Daten zwischen Jobs persistieren - -Sowohl CircleCI als auch {% data variables.product.prodname_actions %} bieten Mechanismen für die Persistierung von Daten zwischen Jobs. - -Nachfolgend siehst Du ein Beispiel in der Konfigurationssyntax von CircleCI und {% data variables.product.prodname_actions %}. - - - - - - - - - - -
    -CircleCI - -GitHub Actions -
    -{% raw %} -```yaml -- persist_to_workspace: - root: workspace - paths: - - math-homework.txt - -... - -- attach_workspace: - at: /tmp/workspace -``` -{% endraw %} - -{% raw %} -```yaml -- name: Upload math result for job 1 - uses: actions/upload-artifact@v2 - with: - name: homework - path: math-homework.txt - -... - -- name: Download math result for job 1 - uses: actions/download-artifact@v2 - with: - name: homework -``` -{% endraw %} -
    - -Weitere Informationen findest Du unter „[Workflow-Daten mittels Artefakten persistieren](/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts)“. - -### Datenbanken und Service-Container verwenden - -Mit beiden Systemen kannst Du zusätzliche Container für Datenbanken, Zwischenspeicherung im Cache oder andere Abhängigkeiten einbinden. - -In CircleCI ist das erste in der *config.yaml* aufgelistete Image, das primäre Image, welches benutzt wird, um Befehle auszuführen. {% data variables.product.prodname_actions %} verwendet explizite Abschnitte: `container` für den primären Container und zusätzliche Container aufgelistet in `services`. - -Nachfolgend siehst Du ein Beispiel in der Konfigurationssyntax von CircleCI und {% data variables.product.prodname_actions %}. - - - - - - - - - - -
    -CircleCI - -GitHub Actions -
    -{% raw %} -```yaml ---- -version: 2.1 - -jobs: - - ruby-26: - docker: - - image: circleci/ruby:2.6.3-node-browsers-legacy - environment: - PGHOST: localhost - PGUSER: administrate - RAILS_ENV: test - - image: postgres:10.1-alpine - environment: - POSTGRES_USER: administrate - POSTGRES_DB: ruby26 - POSTGRES_PASSWORD: "" - - working_directory: ~/administrate - - steps: - - checkout - - # Abhaengigkeiten gebuendelt installieren - - run: bundle install --path vendor/bundle - - # auf DB warten - - run: dockerize -wait tcp://localhost:5432 -timeout 1m - - # Umgebung einrichten - - run: cp .sample.env .env - - # Datenbank einrichten - - run: bundle exec rake db:setup - - # Tests durchfuehren - - run: bundle exec rake - - -workflows: - version: 2 - build: - jobs: - - ruby-26 -... - -- attach_workspace: - at: /tmp/workspace -``` -{% endraw %} - -{% raw %} -```yaml -name: Containers - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - container: circleci/ruby:2.6.3-node-browsers-legacy - - env: - PGHOST: postgres - PGUSER: administrate - RAILS_ENV: test - - services: - postgres: - image: postgres:10.1-alpine - env: - POSTGRES_USER: administrate - POSTGRES_DB: ruby25 - POSTGRES_PASSWORD: "" - ports: - - 5432:5432 - # einen Gesundheitscheck zufuegen - options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 5 - - steps: - # Diese Docker-Datei Setzt USER auf circleci statt dem Standardbenutzer, daher muessen wir die Datei-Berechtigungen fuer dieses Image aktualisieren, um auf GH-Aktionen arbeiten zu koennen. - # See https://docs.github.com/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem - - name: Setup file system permissions - run: sudo chmod -R 777 $GITHUB_WORKSPACE /github /__w/_temp - - uses: actions/checkout@v2 - - name: Install dependencies - run: bundle install --path vendor/bundle - - name: Setup environment configuration - run: cp .sample.env .env - - name: Setup database - run: bundle exec rake db:setup - - name: Run tests - run: bundle exec rake -``` -{% endraw %} -
    - -Weitere Informationen findest Du unter „[Informationen zu Servicecontainern](/actions/configuring-and-managing-workflows/about-service-containers)“. - -### Vollständiges Beispiel - -Nachfolgend siehst Du ein Beispiel aus der realen Welt. Die linke Seite zeigt die tatsächliche *config.yml* unter CircleCI für das Repository [thoughtbot/administrator](https://github.com/thoughtbot/administrate). Die rechte Seite zeigt das Äquivalent unter {% data variables.product.prodname_actions %}. - - - - - - - - - - -
    -CircleCI - -GitHub Actions -
    -{% raw %} -```yaml ---- -version: 2.1 - -commands: - shared_steps: - steps: - - checkout - - # Abhaengigkeiten aus dem Cache wiederherstellen - - restore_cache: - name: Restore bundle cache - key: administrate-{{ checksum "Gemfile.lock" }} - - # Abhaengigkeiten gebuendelt installieren - - run: bundle install --path vendor/bundle - - # Abhaengigkeiten im Cache zwischenspeichern - - save_cache: - name: Store bundle cache - key: administrate-{{ checksum "Gemfile.lock" }} - paths: - - vendor/bundle - - # auf DB warten - - run: dockerize -wait tcp://localhost:5432 -timeout 1m - - # Umgebung einrichten - - run: cp .sample.env .env - - # Datenbank einrichten - - run: bundle exec rake db:setup - - # Tests durchfuehren - - run: bundle exec rake - -default_job: &default_job - working_directory: ~/administrate - steps: - - shared_steps - # Test mit verschiedenen Versionen von Rails durchfuehren - - run: bundle exec appraisal install - - run: bundle exec appraisal rake - -jobs: - ruby-25: - <<: *default_job - docker: - - image: circleci/ruby:2.5.0-node-browsers - environment: - PGHOST: localhost - PGUSER: administrate - RAILS_ENV: test - - image: postgres:10.1-alpine - environment: - POSTGRES_USER: administrate - POSTGRES_DB: ruby25 - POSTGRES_PASSWORD: "" - - ruby-26: - <<: *default_job - docker: - - image: circleci/ruby:2.6.3-node-browsers-legacy - environment: - PGHOST: localhost - PGUSER: administrate - RAILS_ENV: test - - image: postgres:10.1-alpine - environment: - POSTGRES_USER: administrate - POSTGRES_DB: ruby26 - POSTGRES_PASSWORD: "" - - -workflows: - version: 2 - multiple-rubies: - jobs: - - ruby-26 - - ruby-25 -``` -{% endraw %} - -{% raw %} -```yaml -name: Containers - -on: [push] - -jobs: - build: - - strategy: - matrix: - ruby: [2.5, 2.6.3] - - runs-on: ubuntu-latest - - env: - PGHOST: localhost - PGUSER: administrate - RAILS_ENV: test - - services: - postgres: - image: postgres:10.1-alpine - env: - POSTGRES_USER: administrate - POSTGRES_DB: ruby25 - POSTGRES_PASSWORD: "" - ports: - - 5432:5432 - # Add a health check - options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 5 - - steps: - - uses: actions/checkout@v2 - - name: Setup Ruby - uses: eregon/use-ruby-action@master - with: - ruby-version: ${{ matrix.ruby }} - - name: Cache dependencies - uses: actions/cache@v2 - with: - path: vendor/bundle - key: administrate-${{ matrix.image }}-${{ hashFiles('Gemfile.lock') }} - - name: Install postgres headers - run: sudo apt-get install libpq-dev - - name: Install dependencies - run: bundle install --path vendor/bundle - - name: Setup environment configuration - run: cp .sample.env .env - - name: Setup database - run: bundle exec rake db:setup - - name: Run tests - run: bundle exec rake - - name: Install appraisal - run: bundle exec appraisal install - - name: Run appraisal - run: bundle exec appraisal rake -``` -{% endraw %} -
    diff --git a/translations/de-DE/content/actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions.md b/translations/de-DE/content/actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions.md deleted file mode 100644 index 52183255fd1a..000000000000 --- a/translations/de-DE/content/actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions.md +++ /dev/null @@ -1,291 +0,0 @@ ---- -title: Von Jenkins zu GitHub-Aktionen migrieren -intro: '{% data variables.product.prodname_actions %} und Jenkins haben mehrere Ähnlichkeiten, was die Migration zu {% data variables.product.prodname_actions %} relativ einfach macht.' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Einführung - -Jenkins und {% data variables.product.prodname_actions %} ermöglichen es Dir, Workflows zu erstellen, die automatisch Code bauen, testen, publizieren, freigeben und bereitstellen. Jenkins und {% data variables.product.prodname_actions %} haben einige Ähnlichkeiten in der Workflow-Konfiguration: - -- Jenkins erstellt Workflows mit _Deklarativen Pipelines_, die den Workflow-Dateien in {% data variables.product.prodname_actions %} ähnlich sind. -- Jenkins verwendet _„Stages“ (Phasen)_, um eine Gruppe von Schritten auszuführen, während {% data variables.product.prodname_actions %} Jobs verwenden, um einen oder mehrere Schritte oder einzelne Befehle zu gruppieren. -- Jenkins und {% data variables.product.prodname_actions %} unterstützen Container-basierte Builds. Weitere Informationen finden Sie unter „[Eine Docker-Container-Aktion erstellen](/articles/creating-a-docker-container-action)“. -- Schritte oder Aufgaben können wiederverwendet und in der Community gemeinsam genutzt werden. - -Weitere Informationen findest Du unter „[Kernkonzepte für {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)“. - -### Wesentliche Unterschiede - -- Jenkins hat zwei Arten von Syntax zur Erzeugung von Pipelines: Deklarative Pipeline und „Scripted“ (Skript-basierte) Pipeline. {% data variables.product.prodname_actions %} verwendet YAML, um Workflows und Konfigurationsdateien zu erstellen. Weitere Informationen findest Du unter „[Workflow-Syntax für GitHub-Aktionen](/actions/reference/workflow-syntax-for-github-actions)." -- Die Deployments von Jenkins ist üblicherweise selbst-gehosted, wobei die Benutzer die Server in ihren eigenen Rechenzentren betreuen. {% data variables.product.prodname_actions %} bieten einen hybriden Cloud-Ansatz, indem sie ihre eigenen Runner betreiben, die du zum Ausführen von Jobs verwenden kannst, während sie auch selbst-gehostete Läufer unterstützen. Weitere Informationen findest Du unter [Informationen zu selbst-gehosteten Runnnern](/actions/hosting-your-own-runners/about-self-hosted-runners). - -### Funktionaltäten im Vergleich - -#### Deine Builds verteilen - -Mit Jenkins kannst Du Builds an einen einzelnen Build-Agenten senden oder sie über mehrere Agenten verteilen. Du kannst diese Agenten auch nach verschiedenen Attributen klassifizieren, wie zum Beispiel Arten von Betriebssystemen. - -In ähnlicher Weise können {% data variables.product.prodname_actions %} Jobs an {% data variables.product.prodname_dotcom %}-gehostete oder selbst-gehostete Runner senden und Du kannst Labels verwenden, um die Runner nach verschiedenen Attributen zu klassifizieren. Die folgende Tabelle vergleicht, wie das Konzept für verteilte Builds sowohl bei Jenkins als auch bei {% data variables.product.prodname_actions %} umgesetzt ist. - -| Jenkins | {% data variables.product.prodname_actions %} | -| ----------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [`Agenten`](https://wiki.jenkins.io/display/JENKINS/Distributed+builds) | [`Runner`](/actions/getting-started-with-github-actions/core-concepts-for-github-actions#runner)
    [`selbst-gehostete Runner`](/actions/hosting-your-own-runners/about-self-hosted-runners) | - -#### Sektionen verwenden, um Pipelines zu organisieren - -Jenkins teilt seine Deklarative Pipelines in mehrere Sektionen auf. In ähnlicher Weise organisieren {% data variables.product.prodname_actions %} ihre Workflows in separaten Sektionen. Die folgende Tabelle vergleicht Sektionen bei Jenkins mit dem Workflow bei {% data variables.product.prodname_actions %}. - -| Anweisungen in Jenkins | {% data variables.product.prodname_actions %} | -| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| [`agent`](https://jenkins.io/doc/book/pipeline/syntax/#agent) | [`jobs..runs-on`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idruns-on)
    [`jobs..container`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idcontainer) | -| [`Beitrag`](https://jenkins.io/doc/book/pipeline/syntax/#post) | | -| [`stages`](https://jenkins.io/doc/book/pipeline/syntax/#stages) | [`jobs`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobs) | -| [`steps`](https://jenkins.io/doc/book/pipeline/syntax/#steps) | [`jobs..steps`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idsteps) | - - -### Anweisungen verwenden - -Jenkins verwendet Anweisungen um _Deklarative Pipelines_ zu verwalten. Diese Anweisungen definieren die Merkmale Deines Workflows und die Art und weise, wie dieser ausgeführt wird. Die folgende Tabelle zeigt, wie diese Anweisungen den Konzepten innerhalb von {% data variables.product.prodname_actions %} entsprechen. - -| Anweisungen in Jenkins | {% data variables.product.prodname_actions %} | -| ------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [`environment`](https://jenkins.io/doc/book/pipeline/syntax/#environment) | [`jobs..env`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#env)
    [`jobs..steps.env`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsenv) | -| [`options`](https://jenkins.io/doc/book/pipeline/syntax/#parameters) | [`jobs..strategy`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategy)
    [`jobs..strategy.fail-fast`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategyfail-fast)
    [`jobs..timeout-minutes`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idtimeout-minutes) | -| [`parameters`](https://jenkins.io/doc/book/pipeline/syntax/#parameters) | [`inputs`](/actions/creating-actions/metadata-syntax-for-github-actions#inputs)
    [`outputs`](/actions/creating-actions/metadata-syntax-for-github-actions#outputs) | -| [`triggers`](https://jenkins.io/doc/book/pipeline/syntax/#triggers) | [`on`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#on)
    [`on..types`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onevent_nametypes)
    [on..](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onpushpull_requestbranchestags)
    [on..paths](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onpushpull_requestpaths) | -| [`triggers { upstreamprojects() }`](https://jenkins.io/doc/book/pipeline/syntax/#triggers) | [`jobs..needs`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idneeds) | -| [Cron-Syntax in Jenkins](https://jenkins.io/doc/book/pipeline/syntax/#cron-syntax) | [`on.schedule`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onschedule) | -| [`Phase`](https://jenkins.io/doc/book/pipeline/syntax/#stage) | [`jobs.`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_id)
    [`jobs..name`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idname) | -| [`tools`](https://jenkins.io/doc/book/pipeline/syntax/#tools) | [auf GitHub-gehosteten Runnern installierte Software](/actions/reference/software-installed-on-github-hosted-runners) | -| [`input`](https://jenkins.io/doc/book/pipeline/syntax/#input) | [`inputs`](/actions/automating-your-workflow-with-github-actions/metadata-syntax-for-github-actions#inputs) | -| [`when`](https://jenkins.io/doc/book/pipeline/syntax/#when) | [`jobs..if`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idif) | - - -### Sequenzielle „Stages“ (Phasen) verwenden - -#### Parallele Verarbeitungvon Jobs - -Jenkins kann die `Phasen` und `Schritte` parallel ausführen, wohingegen {% data variables.product.prodname_actions %} derzeit nur Jobs parallel ausführen. - -| Jenkins Parallel | {% data variables.product.prodname_actions %} | -| ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [`parallel`](https://jenkins.io/doc/book/pipeline/syntax/#parallel) | [`jobs..strategy.max-parallel`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymax-parallel) | - -#### Build-Matrix - -Sowohl {% data variables.product.prodname_actions %} als auch Jenkins lassen Dich eine Build-Matrix verwenden, um verschiedene Systemkombinationen zu definieren. - -| Jenkins | {% data variables.product.prodname_actions %} | -| ------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [`axis`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-axes) | [`strategy/matrix`](/actions/configuring-and-managing-workflows/configuring-a-workflow#configuring-a-build-matrix)
    [`context`](/actions/reference/context-and-expression-syntax-for-github-actions) | -| [`stages`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-stages) | [`steps-context`](/actions/reference/context-and-expression-syntax-for-github-actions#steps-context) | -| [`excludes`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-stages) | | - -#### Schritte verwenden, um „Tasks“ (Aufgaben) auszuführen - -Jenkins gruppiert `„Steps“ (Schritte)` zusammen in `„Stages“ (Phasen)`. Jeder dieser Schritte kann unter anderem ein Skript, eine Funktion oder ein Befehl sein. In ähnlicher Weise verwenden {% data variables.product.prodname_actions %} `Jobs`, um bestimmte Gruppen von `Schritten` auszuführen. - -| Jenkins-Schritte | {% data variables.product.prodname_actions %} | -| --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | -| [`script`](https://jenkins.io/doc/book/pipeline/syntax/#script) | [`jobs..steps`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idsteps) | - -### Beispiele für häufige Aufgaben - -#### Zeitplanung einer Pipeline mit `cron` - - - - - - - - - - -
    -Jenkins-Pipeline - -{% data variables.product.prodname_actions %}-Workflow -
    - - ```yaml - pipeline { - agent any - triggers { - cron('H/15 * * * 1-5') - } - } - ``` - - - - ```yaml - on: - schedule: - - cron: '*/15 * * * 1-5' - ``` - -
    - -#### Umgebungsvariablen in einer Pipeline konfigurieren - - - - - - - - - - -
    -Jenkins-Pipeline - -{% data variables.product.prodname_actions %}-Workflow -
    - - ```yaml - pipeline { - agent any - environment { - MAVEN_PATH = '/usr/local/maven' - } - } - ``` - - - - ```yaml - jobs: - maven-build: - env: - MAVEN_PATH: '/usr/local/maven' - - ``` - -
    - -#### Aus „Upstream“ (vorgelagerten) Projekten bauen - - - - - - - - - - -
    -Jenkins-Pipeline - -{% data variables.product.prodname_actions %}-Workflow -
    - - ```yaml - pipeline { - triggers { - upstream( - upstreamProjects: 'job1,job2', - threshold: hudson.model.Result.SUCCESS) - } - } - } - - ``` - - - - ```yaml - jobs: - job1: - job2: - needs: job1 - job3: - needs: [job1, job2] - - ``` - -
    - -#### Mit mehreren Betriebssystemen bauen - - - - - - - - - - -
    -Jenkins-Pipeline - -{% data variables.product.prodname_actions %}-Workflow -
    - - ```yaml -pipeline { - agent none - stages { - stage('Run Tests') { - parallel { - stage('Test On MacOS') { - agent { label "macos" } - tools { nodejs "node-12" } - steps { - dir("scripts/myapp") { - sh(script: "npm install -g bats") - sh(script: "bats tests") - } - } - } - stage('Test On Linux') { - agent { label "linux" } - tools { nodejs "node-12" } - steps { - dir("script/myapp") { - sh(script: "npm install -g bats") - sh(script: "bats tests") - } - } - } - } - } - } -} - ``` - - - -{% raw %} - ```yaml - name: demo-workflow - on: - push: - jobs: - test: - runs-on: ${{ matrix.os }} - strategy: - fail-fast: false - matrix: - os: [macos-latest, ubuntu-latest] - steps: - - uses: actions/checkout@v1 - - uses: actions/setup-node@v1 - with: - node-version: 12 - - run: npm install -g bats - - run: bats tests - working-directory: scripts/myapp - ``` -{% endraw %} - -
    diff --git a/translations/de-DE/content/actions/publishing-packages-with-github-actions/about-packaging-with-github-actions.md b/translations/de-DE/content/actions/publishing-packages-with-github-actions/about-packaging-with-github-actions.md deleted file mode 100644 index c526a02df188..000000000000 --- a/translations/de-DE/content/actions/publishing-packages-with-github-actions/about-packaging-with-github-actions.md +++ /dev/null @@ -1,45 +0,0 @@ ---- -title: Informationen zum Paketieren mit GitHub-Aktionen -intro: 'In {% data variables.product.prodname_actions %}kannst Du Workflows einrichten, um Pakete zu erstellen und sie zu {% data variables.product.prodname_registry %} oder einem anderen Paket-Hosting-Anbieter hochzuladen.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/about-packaging-with-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Informationen zu Paketierungsschritten - -Die Paket-Erstellung ist ein üblicher Bestandteil des Workflows bei der kontinuierlichen Integration oder bei der kontinuierlichen Auslieferung. Nach dem Erstellen und Testen der Anwendung wird ein lauf- oder bereitstellungsfähiges Artefakt als Paket erstellt. Beispielsweise kann ein Workflow zur kontinuierlichen Integration für ein Java-Projekt `mvn package` ausführen, um eine JAR-Datei zu erstellen. Oder ein CI-Workflow für eine Node.js-Anwendung kann einen Docker-Container erzeugen. - -Je nach Art der Anwendung, die Du erstellst, kann dieses Paket für manuelle Tests lokal heruntergeladen, Benutzern zum Herunterladen zur Verfügung gestellt oder in einer Staging- oder Produktionsumgebung bereitgestellt werden. - -### Paket-Erstellung in Workflows zur kontinuierlichen Integration - -Das Erstellen eines Pakets am Ende eines Workflows zur kontinuierlichen Integration kann während des Code-Reviews bei einem Pull-Request hilfreich sein. Nach dem Erstellen und Testen Deines Codes kann ein Paketierungsschritt ein lauf- oder bereitstellungsfähiges Artefakt erzeugen. Dein Workflow kann dieses Artefakt dann übernehmen und als Teil des Workflows hochladen. - -Wenn Du nun einen Pull-Request überprüfst, kannst Du Dir den Ablauf des Workflows ansehen und das erzeugte Artefakt herunterladen. - -![Dropdown-Menü zum Herunterladen von Artefakten](/assets/images/help/repository/artifact-drop-down.png) - -Dadurch kannst Du den Code im Pull-Request auf Deinem Rechner ausführen, was beim Debuggen oder Testen des Pull-Requests helfen kann. - -### Workflows zum Veröffentlichen von Paketen - -Außer Paket-Artefakte zum Testen in einem Workflow zur kontinuierlichen Integration zum Testen hochzuladen, kannst Du auch Workflows erstellen, die Dein Projekt bauen und Pakete in einer Paket-Registry veröffentlichen. - -* **Pakete auf {% data variables.product.prodname_registry %} publizieren** {% data variables.product.prodname_registry %} kann als Paket-Hosting-Dienst für viele Paket-Arten fungieren. Du kannst Deine Pakete entweder an alle auf {% data variables.product.prodname_dotcom %} oder private Pakete nur an Mitarbeiter oder an eine Organisation weitergeben. Weitere Informationen findest Du unter „[Informationen zu {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/about-github-packages)“. - - Vielleicht willst Du Pakete bei jedem Push in den Master-Brach in {% data variables.product.prodname_registry %} veröffentlichen. Auf diese Weise können Entwickler in Deinem Projekt immer den neuesten Build aus Master ausführen und testen, indem sie ihn von {% data variables.product.prodname_registry %} installieren. - -* **Pakete in einer Paket-Registry veröffentlichen** Bei vielen Projekten werden neue Versionen immer in einer Paket-Registry veröffentlicht. Beispielsweise kann ein Projekt, das eine JAR-Datei erstellt, neue Versionen in das Zentral-Repository von Maven hochladen. Oder ein .NET-Projekt kann ein NuGet-Paket erzeugen und es in die NuGet-Galerie hochladen. - - Du kannst dies automatisieren, indem Du einen Workflow erstellst, der bei jeder Release-Erstellung Pakete in einer Paket-Registry veröffentlicht. Weitere Informationen findest Du unter „[Releases erstellen](/github/administering-a-repository/creating-releases)“. - -### Weiterführende Informationen - -- „[Node.js-Pakete veröffentlichen](/actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages)“ diff --git a/translations/de-DE/content/actions/publishing-packages-with-github-actions/index.md b/translations/de-DE/content/actions/publishing-packages-with-github-actions/index.md deleted file mode 100644 index ecb4b41c8787..000000000000 --- a/translations/de-DE/content/actions/publishing-packages-with-github-actions/index.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: Pakete mit GitHub-Aktionen veröffentlichen -shortTitle: Pakete veröffentlichen -intro: 'Erstelle Pakete und veröffentliche sie in {% data variables.product.prodname_registry %} oder bei einem anderen Paket-Hosting-Anbieter.' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -{% link_in_list /about-packaging-with-github-actions %} diff --git a/translations/de-DE/content/actions/reference/software-installed-on-github-hosted-runners.md b/translations/de-DE/content/actions/reference/software-installed-on-github-hosted-runners.md deleted file mode 100644 index 456851b60564..000000000000 --- a/translations/de-DE/content/actions/reference/software-installed-on-github-hosted-runners.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: auf GitHub-gehosteten Runnern installierte Software -intro: 'Dieser Artikel verweist auf Referenzen für die Pakete und Tools, die in {% data variables.product.prodname_dotcom %}-gehosteten virtuellen Umgebungen verfügbar sind.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/software-in-virtual-environments-for-github-actions - - /github/automating-your-workflow-with-github-actions/software-in-virtual-environments-for-github-actions - - /github/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners - - /actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -Die Tools, die auf {% data variables.product.prodname_dotcom %}-gehosteten Runnern enthalten sind, werden wöchentlich aktualisiert. Die neueste Liste der mitgelieferten Werkzeuge für jedes Runner-Betriebssystem findest Du unter den folgenden Links: - -* [Ubuntu 20.04 LTS](https://github.com/actions/virtual-environments/blob/master/images/linux/Ubuntu2004-README.md) -* [Ubuntu 18.04 LTS](https://github.com/actions/virtual-environments/blob/master/images/linux/Ubuntu1804-README.md) -* [Ubuntu 16.04 LTS](https://github.com/actions/virtual-environments/blob/master/images/linux/Ubuntu1604-README.md) -* [Windows Server 2019](https://github.com/actions/virtual-environments/blob/master/images/win/Windows2019-Readme.md) -* [Windows Server 2016](https://github.com/actions/virtual-environments/blob/master/images/win/Windows2016-Readme.md) -* [MacOS 10.15](https://github.com/actions/virtual-environments/blob/master/images/macos/macos-10.15-Readme.md) - -{% data reusables.github-actions.ubuntu-runner-preview %} - -{% data variables.product.prodname_dotcom %}-gehostete Runner enthalten zusätzlich zu den oben aufgeführten Paketen die standardmäßig integrierten Tools des Betriebssystems. Zum Beispiel beinhalten Ubuntu und macOS Läufer `grep`, `find`, und `which` neben anderen Standard-Tools. - -Wenn Sie ein bestimmtes Tool anfordern möchten, öffnen Sie bitte einen Issue unter [actions/virtual-environments](https://github.com/actions/virtual-environments). diff --git a/translations/de-DE/content/actions/reference/virtual-environments-for-github-hosted-runners.md b/translations/de-DE/content/actions/reference/virtual-environments-for-github-hosted-runners.md deleted file mode 100644 index ad4d00ba837d..000000000000 --- a/translations/de-DE/content/actions/reference/virtual-environments-for-github-hosted-runners.md +++ /dev/null @@ -1,131 +0,0 @@ ---- -title: Virtuelle Umgebungen für GitHub-gehostete Runner -intro: '{% data variables.product.prodname_dotcom %} bietet gehostete virtuelle Maschinen, um Workflows auszuführen. Die virtuelle Maschine umfasst eine Umgebung mit Tools, Paketen und Einstellungen für {% data variables.product.prodname_actions %}.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/virtual-environments-for-github-actions - - /github/automating-your-workflow-with-github-actions/virtual-environments-for-github-actions - - /github/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners - - /actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Informationen zu {% data variables.product.prodname_dotcom %}-gehosteten Runnern - -Ein {% data variables.product.prodname_dotcom %}-gehosteter Runner ist eine virtuelle Maschine, die von {% data variables.product.prodname_dotcom %} gehostet wird und auf der die Runner-Anwendung der {% data variables.product.prodname_actions %} installiert ist. {% data variables.product.prodname_dotcom %} bietet Runner mit den Betriebssystemen Linux, Windows und MacOS. - -Wenn Du einen {% data variables.product.prodname_dotcom %}-gehosteten Runner verwendest, werden Wartung und Upgrade der Maschine für Dich erledigt. Sie können Workflows direkt auf der virtuellen Maschine oder in einem Docker-Container ausführen. - -Du kannst in einem Workflow für jeden Job die Art des Runners festlegen. Jeder Job in einem Workflow wird in einer neuen Instanz der virtuellen Maschine ausgeführt. Alle Schritte des Jobs werden in derselben Instanz der virtuellen Maschine ausgeführt, sodass die Aktionen in diesem Job über das Dateisystem Informationen austauschen können. - -{% data reusables.github-actions.runner-app-open-source %} - -#### Cloud-Hosts für {% data variables.product.prodname_dotcom %}-gehostete Runner - -{% data variables.product.prodname_dotcom %} betreibt Linux- und Windows-Runner auf den virtuellen Maschinen nach Standard_DS2_v2 in Microsoft Azure, auf denen die Runner-Anwendung der {% data variables.product.prodname_actions %} installiert ist. Die Runner-Anwendung auf {% data variables.product.prodname_dotcom %}-gehosteten Runnern ist eine Fork-Kopie des Azure-Pipelines-Agenten. Bei Azure werden eingehende ICMP-Pakete werden für alle virtuellen Maschinen blockiert, so dass die Befehle ping und traceroute möglicherweise nicht funktionieren. Weitere Informationen zu den Ressourcen der Standard_DS2_v2-Maschinen findest Du unter „[Serien Dv2 und DSv2](https://docs.microsoft.com/en-us/azure/virtual-machines/dv2-dsv2-series#dsv2-series)“ in der Dokumentation zu Microsoft Azure. - -{% data variables.product.prodname_dotcom %} verwendet [MacStadium](https://www.macstadium.com/), um die virtuellen macOS-Runner zu betreiben. - -#### Administrative Rechte von {% data variables.product.prodname_dotcom %}-gehosteten Runnern - -Die virtuellen Maschinen unter Linux und macOS werden beide mit dem passwortlosen Befehl `sudo` ausgeführt. Wenn Sie Befehle ausführen oder Tools installieren müssen, die höhere Berechtigungen als der aktuelle Benutzer erfordern, können Sie `sudo` verwenden, ohne ein Passwort angeben zu müssen. Weitere Informationen findest Du im „[Sudo-Handbuch](https://www.sudo.ws/man/1.8.27/sudo.man.html)“. - -Die virtuellen Windows-Maschinen sind so konfiguriert, dass sie als Administratoren laufen, wobei die Benutzerkonten-Steuerung (UAC) deaktiviert ist. Weitere Informationen findest Du unter „[Funktionsweise der Benutzerkonten-Steuerung](https://docs.microsoft.com/de-de/windows/security/identity-protection/user-account-control/how-user-account-control-works)“ in der Dokumentation zu Windows. - -### Unterstützte Runner und Hardwareressourcen - -Für jede virtuelle Maschine stehen die gleichen Hardware-Ressourcen zur Verfügung. - -- CPU mit 2 Kernen -- 7 GB RAM-Speicher -- 14 GB SSD-Festplattenspeicher - -{% data reusables.github-actions.supported-github-runners %} - -{% data reusables.github-actions.ubuntu-runner-preview %} - -Eine Liste der unterstützten Software, Tools und Pakete für jeden Runner findest Du unter "[Auf {% data variables.product.prodname_dotcom %}-gehosteten Runnern installierte Software](/actions/reference/software-installed-on-github-hosted-runners)." - -In den Protokollen für einen Workflow-Lauf findest Du die genaue Runner-Umgebung, die für einen Job verwendet wurde, sowie einen Link zu den vorinstallierten Tools, die sich auf dem Runner befanden. Weitere Informationen findest Du unter „[Eine Workflow-Ausführung verwalten](/actions/configuring-and-managing-workflows/managing-a-workflow-run#viewing-your-workflow-history)“. - - -#### IP-Adressen von {% data variables.product.prodname_dotcom %}-gehosteten Runnern - -{% note %} - -**Notiz:** Wenn Du eine Liste mit erlaubten IP-Adressen für Dein Organisations- oder Unternehmenskonto auf {% data variables.product.prodname_dotcom %} verwendest, kannst Du keine {% data variables.product.prodname_dotcom %}-gehosteten Runner verwenden, sondern benötigst stattdessen selbst-gehostete Runner. Weitere Informationen findest Du unter „[Informationen zu selbst-gehosteten Runnern](/actions/hosting-your-own-runners/about-self-hosted-runners)“. - -{% endnote %} - -Windows- und Ubuntu-Runner werden in Azure gehostet und haben die gleichen IP-Adressbereiche wie Azure-Rechenzentren. Derzeit befinden sich alle {% data variables.product.prodname_dotcom %}-gehosteten Windows- und Ubuntu-Runner in den folgenden Azure-Regionen: - -- Ost-USA (`eastus`) -- Ost-USA 2 (`eastus`) -- West-US 2 (`westus2`) -- Zentral-USA (`centralus`) -- Süd-Zentral-USA (`southcentralus`) - -Microsoft aktualisiert die Azure-IP-Adressbereiche wöchentlich in einer JSON-Datei. Diese können Sie auf der Website [Azure IP Ranges and Service Tags - Public Cloud](https://www.microsoft.com/en-us/download/details.aspx?id=56519) herunterladen. Sie können diesen IP-Adressbereich verwenden, falls Sie eine Positivliste vorschreiben, um den nicht autorisierten Zugriff auf Ihre internen Ressourcen zu verhindern. - -Die JSON-Datei enthält einen Array mit der Bezeichnung `values`. Innerhalb dieses Arrays findest Du die unterstützten IP-Adressen in einem Objekt mit `name` und `id` der Azure-Region, z.B. `"AzureCloud.eastus2"`. - -Die unterstützten IP-Adressbereiche befinden sich im Objekt `"addressPrefixes"`. Dies ist ein komprimiertes Beispiel der JSON-Datei. - -```json -{ - "changeNumber": 84, - "cloud": "Public", - "values": [ - { - "name": "AzureCloud.eastus2", - "id": "AzureCloud.eastus2", - "properties": { - "changeNumber": 33, - "region": "eastus2", - "platform": "Azure", - "systemService": "", - "addressPrefixes": [ - "13.68.0.0/17", - "13.77.64.0/18", - "13.104.147.0/25", - ... - ] - } - } - ] -} -``` - -### Dateisysteme auf {% data variables.product.prodname_dotcom %}-gehosteten Runnern - -{% data variables.product.prodname_dotcom %} führt Aktionen und Shell-Befehle in bestimmten Verzeichnissen auf der virtuellen Maschine aus. Die Dateipfade auf virtuellen Maschinen sind nicht statisch. Verwende die von {% data variables.product.prodname_dotcom %} bereitgestellten Umgebungsvariablen zum Erstellen von Dateipfaden für die Verzeichnisse `home`, `workspace`und `workflow`. - -| Verzeichnis | Umgebungsvariable | Beschreibung | -| --------------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `home` | `HOME` | Enthält benutzerbezogene Daten. In diesem Verzeichnis können sich beispielsweise die Anmeldeinformation aus einem Anmeldeversuch befinden. | -| `workspace` | `GITHUB_WORKSPACE` | Aktionen und Shell-Befehle werden in diesem Verzeichnis ausgeführt. Eine Aktion kann den Inhalt dieses Verzeichnisses ändern, auf den dann nachfolgende Aktionen zugreifen können. | -| `workflow/event.json` | `GITHUB_EVENT_PATH` | Die `POST`-Nutzlast des Webhook-Ereignisses, das den Workflow ausgelöst hat. {% data variables.product.prodname_dotcom %} schreibt dies bei jeder ausgeführten Aktion neu, sodass der Dateiinhalt zwischen den Aktionen isoliert wird. | - -Eine Liste der von {% data variables.product.prodname_dotcom %} für jeden Workflow erstellten Umgebungsvariablen findest Du unter „[Umgebungsvariablen verwenden](/github/automating-your-workflow-with-github-actions/using-environment-variables)“. - -#### Docker-Container-Dateisystem - -Für Aktionen, die in Docker-Containern ausgeführt werden, befinden sich statische Verzeichnisse im Pfad `/github`. Wir empfehlen jedoch dringend, die Standard-Umgebungsvariablen zu verwenden, um Dateipfade in Docker-Containern zu erstellen. - -In {% data variables.product.prodname_dotcom %} wird das Pfadpräfix `/github` reserviert, und es werden drei Verzeichnisse für Aktionen erstellt. - -- `/github/home` -- `/github/workspace` - {% data reusables.repositories.action-root-user-required %} -- `/github/workflow` - -{% if currentVersion == "free-pro-team@latest" %} - -### Weiterführende Informationen -- "[Verwalten der Abrechnung für {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)" - -{% endif %} diff --git a/translations/de-DE/content/admin/articles/README.md b/translations/de-DE/content/admin/articles/README.md deleted file mode 100644 index d7c0781ca241..000000000000 --- a/translations/de-DE/content/admin/articles/README.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -redirect_from: - - /enterprise/admin/articles/README ---- -# Hidden Enterprise Admin articles - -Enterprise Admin articles that have `hidden: true` frontmatter live in this directory. - -See [`content/README`](../../README.md#hidden-pages) for more about hidden pages. diff --git a/translations/de-DE/content/admin/articles/configuring-unified-contributions-between-github-enterprise-and-githubcom.md b/translations/de-DE/content/admin/articles/configuring-unified-contributions-between-github-enterprise-and-githubcom.md deleted file mode 100644 index 31f4ab2049ec..000000000000 --- a/translations/de-DE/content/admin/articles/configuring-unified-contributions-between-github-enterprise-and-githubcom.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: Einheitliche Beiträge zwischen GitHub Enterprise und GitHub konfigurieren -intro: 'Wenn Sie als ein Websiteadministrator {% data variables.product.prodname_github_connect %} aktiviert haben, können Sie zulassen, dass Endbenutzer in ihrem {% data variables.product.prodname_dotcom_the_website %}-Beteiligungsdiagramm anonymisierte Beitragsanzahlen für ihre Arbeit auf {% data variables.product.prodname_enterprise %} sehen.' -hidden: true -redirect_from: - - /enterprise/admin/articles/configuring-unified-contributions-between-github-enterprise-and-github-com - - /enterprise/admin/articles/configuring-unified-contributions-between-github-enterprise-and-githubcom -versions: - enterprise-server: '*' ---- - - -Nachdem Sie {% data variables.product.prodname_github_connect %} und {% data variables.product.prodname_unified_contributions %} in beiden Umgebungen aktiviert haben, können Endbenutzer auf Ihrer Instanz eine Verbindung mit ihren {% data variables.product.prodname_dotcom_the_website %}-Konten herstellen und Beitragsanzahlen von {% data variables.product.prodname_enterprise %} an {% data variables.product.prodname_dotcom_the_website %} senden. Weitere Informationen finden Sie unter „[{% data variables.product.prodname_unified_contributions %} zwischen {% data variables.product.prodname_enterprise %} und {% data variables.product.prodname_dotcom_the_website %}](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/enabling-unified-contributions-between-github-enterprise-server-and-github-com) aktivieren“ und "[Ihre {% data variables.product.prodname_ghe_server %}-Beiträge an Ihr {% data variables.product.prodname_dotcom_the_website %}-Profil senden](/articles/sending-your-github-enterprise-server-contributions-to-your-github-com-profile/)“. - -Wenn der Websiteadministrator die Funktion deaktiviert oder Entwickler die Verbindung abbrechen, werden die {% data variables.product.prodname_enterprise %}-Beitragsanzahlen auf {% data variables.product.prodname_dotcom_the_website %} gelöscht. Wenn der Entwickler seine Profile nach ihrer Deaktivierung erneut verbindet, werden die Beitragsanzahlen für die letzten 90 Tage wiederhergestellt. - -1. Aktivieren Sie in der Verwaltungsshell die {% data variables.product.prodname_unified_contributions %}-Konfiguration auf {% data variables.product.product_location_enterprise %}: - ```shell - $ ghe-config 'app.github.dotcom-contributions-configurable' 'true' - $ ghe-config-apply - ``` -2. Kehren Sie zu {% data variables.product.prodname_enterprise %} zurück. -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.business-settings %} -{% data reusables.enterprise-accounts.github-connect-tab %} -7. Verwenden Sie unter „Users can share contribution counts to {% data variables.product.prodname_dotcom_the_website %}“ (Benutzer können ihre Beitragsanzahlen auf GitHub.com freigeben) das Dropdownmenü, und klicken Sie auf **Enabled** (Aktiviert). -8. Nach der Weiterleitung zu {% data variables.product.prodname_dotcom_the_website %} müssen Sie ein Upgrade der {% data variables.product.prodname_github_app %} vornehmen, wenn {% data variables.product.prodname_enterprise %}-Beitragskonten in verbundene Benutzerkonten geschrieben werden sollen. Ein Organisationsadministrator für die verbundene {% data variables.product.prodname_dotcom_the_website %}-Organisation muss das Upgrade der {% data variables.product.prodname_github_app %} mit `external_contributions`-Berechtigungen genehmigen. - diff --git a/translations/de-DE/content/admin/articles/including-github-enterprise-contributions-in-your-githubcom-profile.md b/translations/de-DE/content/admin/articles/including-github-enterprise-contributions-in-your-githubcom-profile.md deleted file mode 100644 index b7c3946661a0..000000000000 --- a/translations/de-DE/content/admin/articles/including-github-enterprise-contributions-in-your-githubcom-profile.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: GitHub Enterprise-Beiträge in Ihr GitHub.com-Profil aufnehmen -redirect_from: - - /enterprise/admin/articles/including-github-enterprise-contributions-in-your-github-com-profile - - /enterprise/admin/articles/including-github-enterprise-contributions-in-your-githubcom-profile -intro: 'Als Teil des geschlossenen Early Access Program können Sie {% data variables.product.product_location_enterprise %} mit {% data variables.product.prodname_dotcom_the_website %} verbinden und Endbenutzern ermöglichen, Beiträge von {% data variables.product.product_location_enterprise %} an ihre {% data variables.product.prodname_dotcom_the_website %}-Profile zu senden.' -hidden: true -versions: - enterprise-server: '*' ---- - -Das Aufnehmen von {% data variables.product.prodname_enterprise %}-Beiträgen in Ihr {% data variables.product.prodname_dotcom_the_website %}-Profil ist Bestandteil eines geschlossenen Early Access Program für {% data variables.product.prodname_enterprise %} 2.14. Weitere Informationen finden Sie unter „[{% data variables.product.prodname_enterprise %}-Beiträge in Ihr {% data variables.product.prodname_dotcom_the_website %}-Profil aufnehmen](/enterprise/2.14/admin/hidden/including-github-enterprise-contributions-in-your-github-com-profile/)“. diff --git a/translations/de-DE/content/admin/articles/using-github-task-runner.md b/translations/de-DE/content/admin/articles/using-github-task-runner.md deleted file mode 100644 index a00c2f003c15..000000000000 --- a/translations/de-DE/content/admin/articles/using-github-task-runner.md +++ /dev/null @@ -1,109 +0,0 @@ ---- -title: GitHub Task Runner verwenden -intro: 'Sie können {% data variables.product.prodname_dotcom %} Task Runner verwenden, wenn Ihr CI/CD-integriertes System Bestandteil des geschlossenen Early Access Program ist. Mit {% data variables.product.product_name %} Task Runner können Sie auf Basis einer Konfigurationsdatei in Ihrem Repository Ihren Code automatisch in einer {% data variables.product.prodname_github_app %} entwickeln, testen und bereitstellen.' -hidden: true -redirect_from: - - /enterprise/admin/articles/using-github-task-runner -versions: - enterprise-server: '*' ---- - - -{% note %} - -**Hinweis:** Bevor Sie den Zugriff auf {% data variables.product.prodname_dotcom %} Task Runner anfordern können, müssen Sie den Haftungsausschluss und die Haftungsbegrenzung des Early Access Program unter `EARLY ACCESS-LINK` für {% data variables.product.product_location_enterprise %} lesen und akzeptieren. Diese Dokumentation wird durch diese Bedingungen abgedeckt. - -{% endnote %} - -### In diesem Handbuch -- [Informationen zu {% data variables.product.prodname_dotcom %} Task Runner](#about-github-task-runner) -- [{% data variables.product.prodname_dotcom %} Task Runner-Binärdatei herunterladen](#downloading-the-github-task-runner-binary) -- [{% data variables.product.prodname_github_app %} für {% data variables.product.prodname_dotcom %} Task Runner auf Ihrer Appliance erstellen](#creating-the-github-task-runner-github-app-on-your-appliance) -- [App für {% data variables.product.prodname_dotcom %} Task Runner installieren](#installing-the-github-task-runner-app) -- [Aufgaben für ein Projekt ausführen](#running-tasks-for-a-project) - -### Informationen zu {% data variables.product.prodname_dotcom %} Task Runner - -{% data variables.product.product_name %} muss Aufgaben ausführen, die vom Dispatcher in die Warteschlange versetzt wurden. Hierbei handelt es sich um einen getrennten Dienst, der Webhook-Push-Ereignisse verarbeitet und Aufgaben in die Warteschlange versetzt. - -Dispatcher ist standardmäßig in {% data variables.product.product_location_enterprise %} enthalten. Demgegenüber müssen Sie {% data variables.product.product_name %} Task Runner manuell auf Ihrer Appliance installieren. Zum Einrichten von {% data variables.product.product_name %} Task Runner müssen Sie die Runner-Binärdatei herunterladen, eine {% data variables.product.prodname_github_app %} auf Ihrer Appliance erstellen und einen Server so einrichten, dass er mit Dispatcher interagiert. - -### {% data variables.product.prodname_dotcom %} Task Runner-Binärdatei herunterladen - -Die Binärdatei der {% data variables.product.product_name %} Task Runner-Anwendung muss sich auf {% data variables.product.product_location_enterprise %} befinden. Besuchen Sie `https://HOSTNAME/_dispatcher/downloads/`, und ersetzen Sie `hostname` durch den {% data variables.product.product_location_enterprise %}-Hostnamen oder die -IP-Adresse, um die Binärdatei für die gewünschte Plattform herunterzuladen: - -Führen Sie den Befehl `chmod` aus, um die Berechtigungen für die Verwendung von {% data variables.product.product_name %} Task Runner an der Befehlszeile zu ändern. - -{% mac %} - -```shell -$ chmod +x task-runner_darwin_amd64 -``` - -{% endmac %} - -{% windows %} - -```shell -$ move task-runner_windows_amd64 task-runner_windows_amd64.exe -``` - -{% endwindows %} - -{% linux %} - -```shell -$ chmod +x task-runner_linux_amd64 -``` - -{% endlinux %} - -### {% data variables.product.prodname_github_app %} für {% data variables.product.prodname_dotcom %} Task Runner auf Ihrer Appliance erstellen - -1. Erstellen Sie die Konfigurationsdatei `.task-runner.yaml` in Ihrem aktuellen Verzeichnis. Sie können das Flag `--config` verwenden, um die Datei in ein anderes Verzeichnis zu verschieben. - -```shell -Task Runner-Einrichtung -``` - -2. Geben Sie den Hostnamen von {% data variables.product.product_location_enterprise %} ein. -3. Geben Sie ein persönliches Zugriffstoken ein, das mit spezialisierten Berechtigungen konfiguriert ist. Weitere Informationen finden Sie unter „[Einen persönlichen Zugriffstoken für die Befehlszeile erstellen](/articles/creating-a-personal-access-token-for-the-command-line/)“. Sie können `user`-Berechtigungen verwenden, wenn Sie die {% data variables.product.prodname_github_app %} für Ihr Konto erstellen. Alternativ können Sie `admin:org` verwenden, wenn Sie die {% data variables.product.prodname_github_app %} für eine Organisation erstellen. -4. Geben Sie einen Namen für die {% data variables.product.prodname_github_app %} ein, beispielsweise `Octocat Task Runner`. -5. Wenn Sie eine {% data variables.product.prodname_github_app %} für eine Organisation erstellen, geben Sie den Namen der Organisation ein. -6. Starten Sie Task Runner. - -```shell -Task Runner-Start -``` - -### App für {% data variables.product.prodname_dotcom %} Task Runner installieren - -1. Klicken Sie in der oberen rechten Ecke einer beliebigen Seite auf Ihr Profilfoto und anschließend auf „Settings“ (Einstellungen). ![Symbol für Einstellungen auf der Benutzerleiste](/assets/images/help/images/userbar-account-settings.png) -2. Klicken Sie auf der linken Seitenleiste auf **Developer settings** (Entwicklereinstellungen). ![Abschnitt „Developer settings“ (Entwicklereinstellungen)](/assets/images/help/images/developer_settings.png) -3. Klicken Sie auf der linken Seitenleiste auf **{% data variables.product.prodname_dotcom %} Apps**. ![Abschnitt „GitHub Apps“](/assets/images/help/images/github_apps.png) -4. Klicken Sie auf die App, die Sie installieren möchten. -5. Klicken Sie auf der linken Seitenleiste auf **Public page** (Öffentliche Seite). ![Abschnitt „Public page“ (Öffentliche Seite)](/assets/images/help/images/public-page-tab.png) -6. Klicken Sie auf **Install** (Installieren). ![Schaltfläche „Install“ (Installieren) auf der öffentlichen Seite von GitHub App](/assets/images/help/images/install-runner-public-page.png) -7. Wählen Sie **Only select repositories** (Nur Repositorys auswählen) aus, und geben Sie die Repository-Namen ein, wo Sie {% data variables.product.prodname_dotcom %} Task Runner installieren möchten. ![Repositorys für die Installation auswählen](/assets/images/help/images/repositories-install-task-runner.png) -8. Klicken Sie auf **Install** (Installieren). ![Schaltfläche „Install“ (Installieren) auf der Installationsseite von GitHub App](/assets/images/help/images/install-runner-installation-page.png) -9. Navigieren Sie zu einem Repository, in dem Sie die App installiert haben. -10. Erstellen Sie die Datei `github/tasks.gf`, die Folgendem ähnelt: - - ``` -task "my task" { -command = "command-to-run" -runnerType = "Shell" -env = { - FOO="bar", - BAR="baz" -} -} - ``` -12. Öffnen Sie einen Pull Request, um Ihrem Repository die Datei hinzuzufügen. -13. Übertragen Sie die Änderungen per Push-Vorgang, um die ausgeführten CI-Aufgaben anzuzeigen. - -### Aufgaben für ein Projekt ausführen - -Nach der Erstellung des Pull Requests überträgt die {% data variables.product.prodname_github_app %} das Ereignis per Push-Vorgang an Dispatcher, wo die Aufgabe in die Warteschlange versetzt und an {% data variables.product.prodname_dotcom %} Task Runner gesendet wird. Sobald {% data variables.product.prodname_dotcom %} Task Runner die Aufgaben empfängt und ausführt, werden sie Dispatcher gemeldet, der den Pull Request mit den Ergebnissen aktualisiert. - -![CI-Testergebnisse des Pull Requests](/assets/images/help/images/task-results.png) diff --git a/translations/de-DE/content/admin/clustering/about-cluster-nodes.md b/translations/de-DE/content/admin/clustering/about-cluster-nodes.md deleted file mode 100644 index 617c272b2bcc..000000000000 --- a/translations/de-DE/content/admin/clustering/about-cluster-nodes.md +++ /dev/null @@ -1,69 +0,0 @@ ---- -title: Informationen zu Clusterknoten -intro: '*Knoten* sind {% data variables.product.prodname_ghe_server %}-Instanzen, die in einem Cluster arbeiten. Jeder Knoten führt eine Reihe an Diensten aus, die dem Cluster und schließlich den Benutzern bereitgestellt werden.' -redirect_from: - - /enterprise/admin/clustering/about-cluster-nodes -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_clustering.clustering-requires-https %} - -### Mindesthardwareempfehlungen -Jeder Knoten muss ein Root-Volume und ein separates Datenvolumen aufweisen. Es gibt Mindestempfehlungen. Entsprechend Ihrer Nutzung, beispielsweise in Bezug auf die Benutzeraktivität und die ausgewählten Integrationen, sind möglicherweise mehr Ressourcen erforderlich. - -| Dienste | Minimaler Arbeitsspeicherbedarf | Minimaler freier Speicherplatz auf dem Datenvolume | -|:----------------------------------------------------------------------------:|:-------------------------------:|:--------------------------------------------------:| -| `job-server`,
    `memcache-server`,
    `web-server` | 14 GB | 1 GB | -| `consul-server`,
    `mysql-server`,
    `redis-server` | 14 GB | 10 GB | -| `git-server`,
    `metrics-server`,
    `pages-server`,
    `storage-server` | 7 GB | 10 GB | -| `elasticsearch-server` | 14 GB | 10 GB | - -### Für das Clustering erforderliche Dienste -Verwenden Sie zum Erzielen der angemessenen Redundanz diese Mindestanforderungen an Knoten, die jeden Dienst betreiben. - -{% tip %} - -**Hinweis:** Die Skalierbarkeitsanforderungen Ihrer Organisation hängen von vielen Faktoren ab, einschließlich der Größe und der Anzahl der Repositorys, der Anzahl der Benutzer und der Gesamtauslastung. - -{% endtip %} - -| Dienste | Minimaler Knotenbedarf | -|:---------------------------------------------------------------------------:|:----------------------:| -| `job-server`,
    `memcache-server`,
    `metrics-server`,
    `web-server` | 2 | -| `mysql-server`,
    `redis-server` | 2 | -| `consul-server` | 3 | -| `git-server`,
    `pages-server`,
    `storage-server` | 3 | -| `elasticsearch-server` | 3 | - -### Empfehlungen zum Clusterdesign - -Mittels Clustering können Dienste, die den {% data variables.product.prodname_ghe_server %} bilden, unabhängig voneinander per Scale-out erweitert werden. Diese Flexibilität kann genutzt werden, um einen Cluster zu konzipieren und zu implementieren, der zu Organisationen mit unterschiedlichen Skalierbarkeitsanforderungen passt. Beispielsweise benötigen einige Organisationen möglicherweise Speicherdurchsätze für große oder häufige Abrufe, die Webservernutzung ist jedoch relativ gering. Eine andere Organisation besitzt möglicherweise eine gute Leistung bei weniger Speicherressourcen, benötigt jedoch viele Knoten, auf denen `pages-server` oder `elasticsearch-server` ausgeführt wird. Es sind viele verschiedene Kombinationen möglich. Wenden Sie sich an Ihren Kundenbetreuer, um die beste Clusterkonfiguration für Ihre speziellen Anforderungen zu bestimmen. - -- Verteilen Sie redundante Knoten über unabhängige Hardware hinweg. Wenn Sie CPU, Arbeitsspeicher oder Speichergeräte gemeinsam verwenden, wird die Leistung reduziert und Single Points of Failure ermöglicht. Gemeinsam verwendete Netzwerkkomponenten können ebenfalls den Durchsatz reduzieren und im Falle eines Ausfalls das Risiko des Konnektivitätsverlusts erhöhen. -- Verwenden Sie schnellen Speicher. Storage-Area-Networks (SAN) sind oftmals für die maximale Speicherauslastung, Verfügbarkeit und Fehlertoleranz optimiert und nicht für den absoluten Durchsatz. {% data variables.product.prodname_ghe_server %}-Clustering bietet Redundanz und Verfügbarkeit und funktioniert am besten auf dem schnellsten Speicher, der verfügbar ist. Lokaler SSD-Speicher wird empfohlen. -- Erstellen Sie die Knotenstufen, die für Ihre Organisation sinnvoll sind. Beispielkonfiguration: - - Front-End-Ebene mit zwei Knoten und den folgenden Diensten: - - `web-server` - - `jobs-server` - - `memcache-server` - - Datenbank-Ebene mit drei Knoten und den folgenden Diensten: - - `consul-server` - - `mysql-server` - - `redis-server` - - Suchebene mit drei Knoten und dem folgenden Dienst: - - `elasticsearch-server` - - Speicherebene mit drei Knoten und den folgenden Diensten: - - `git-server` - - `pages-server` - - `storage-server` - - `metrics-server` - -#### Beispielclusterdiagramm -{% note %} - -**Hinweis: Dies ist nur ein Beispiel.** Das optimale Clusterdesign Ihrer Organisation hängt von Ihren individuellen Anforderungen ab. Kontaktiere Deinen engagierten Ansprechpartner oder {% data variables.contact.contact_enterprise_sales %} damit wir Dir helfen können, die beste Clusterkonfiguration zu bestimmen. - -{% endnote %} - -Beispielcluster diff --git a/translations/de-DE/content/admin/clustering/about-clustering.md b/translations/de-DE/content/admin/clustering/about-clustering.md deleted file mode 100644 index d81ac0f6df5e..000000000000 --- a/translations/de-DE/content/admin/clustering/about-clustering.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Informationen zu Clustering -intro: 'Mittels {% data variables.product.prodname_ghe_server %}-Clustering können Dienste, die den {% data variables.product.prodname_ghe_server %} bilden, knotenübergreifend per Scale-out erweitert werden.' -redirect_from: - - /enterprise/admin/clustering/clustering-overview/ - - /enterprise/admin/clustering/about-clustering -versions: - enterprise-server: '*' ---- - -### Clustering-Architektur - -{% data variables.product.prodname_ghe_server %} besteht aus einer Reihe an Diensten. In einem Cluster werden diese Dienste knotenübergreifend ausgeführt, und die Last der Anforderungen wird zwischen ihnen ausgeglichen. Änderungen werden automatisch mit redundanten Kopien auf separaten Knoten gespeichert. Die meisten Dienste sind gleichwertige Peers mit anderen Instanzen desselben Diensts. Die Dienste `mysql-server` und `redis-server` bilden hierzu die Ausnahmen. Diese werden mit einem einzelnen _primären_ Knoten betrieben, der mindestens einen _Replikatknoten_ aufweist. - -Weitere Informationen finden Sie unter „[Für das Clustering erforderliche Dienste](/enterprise/{{ currentVersion }}/admin/guides/clustering/about-cluster-nodes#services-required-for-clustering)“. - -### Ist Clustering die richtige Lösung für meine Organisation? - -{% data reusables.enterprise_clustering.clustering-scalability %} Das Einrichten eines redundanten und skalierbaren Clusters kann jedoch komplex sein und erfordert eine genaue Planung. Diese zusätzliche Komplexität muss bei der Installation, bei Disaster Recovery-Szenarien und bei Upgrades berücksichtigt werden. - -{% data variables.product.prodname_ghe_server %} erfordert eine niedrige Latenz zwischen den Knoten und ist nicht für die Redundanz über geografische Standorte hinweg vorgesehen. - -Clustering bietet Redundanz, ist jedoch nicht dazu vorgesehen, eine Hochverfügbarkeitskonfiguration zu ersetzen. Weitere Informationen finden Sie unter „[Hochverfügbarkeitskonfiguration](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-github-enterprise-server-for-high-availability)“. Eine Konfiguration mit einer primären/sekundären Failover-Instanz ist viel einfacher als Clustering und erfüllt die Anforderungen vieler Organisationen. Weitere Informationen finden Sie unter „[Unterschiede zwischen Clustering und Hochverfügbarkeit](/enterprise/{{ currentVersion }}/admin/guides/clustering/differences-between-clustering-and-high-availability-ha/)“. - -### Wie kann ich auf Clustering zugreifen? - -Clustering ist für bestimmte Skalierungssituationen vorgesehen, nicht aber für jede Organisation. Wenn Du Clustering in Betracht ziehen möchtest, wende Dich bitte an Deinen {% data variables.contact.contact_enterprise_sales %}. diff --git a/translations/de-DE/content/admin/clustering/cluster-network-configuration.md b/translations/de-DE/content/admin/clustering/cluster-network-configuration.md deleted file mode 100644 index 682df1dc155e..000000000000 --- a/translations/de-DE/content/admin/clustering/cluster-network-configuration.md +++ /dev/null @@ -1,122 +0,0 @@ ---- -title: Clusternetzwerk-Konfiguration -intro: '{% data variables.product.prodname_ghe_server %} Clustering basiert auf der richtigen DNS-Namensauflösung, dem Lastausgleich und der Kommunikation zwischen den Knoten, um ordnungsgemäß zu funktionieren.' -redirect_from: - - /enterprise/admin/clustering/network-configuration - - /enterprise/admin/clustering/cluster-network-configuration -versions: - enterprise-server: '*' ---- - -### Grundlegendes zu Netzwerken - -Das einfachste Netzwerkdesign für Clustering besteht darin, die Knoten in einem einzelnen LAN zu platzieren. Wenn ein redundanter Cluster mehrere Subnetze abdecken muss, sollten zwischen den Subnetzen entsprechende Routen verfügbar sein. Zudem sollte die Latenz kleiner als 1 ms sein. - -#### Anwendungsports für Endbenutzer - -Mit Anwendungsports können Endbenutzer auf Webanwendungen und Git zugreifen. - -| Port | Beschreibung | Verschlüsselt | -|:-------- |:-------------------------------------------------------------- |:----------------------------------------------------------------------------- | -| 22/TCP | Git über SSH | Ja | -| 25/TCP | SMTP | Erfordert STARTTLS | -| 80/TCP | HTTP | Nein
    (Wenn SSL aktiviert ist, leitet dieser Port Elemente an HTTPS weiter) | -| 443/TCP | HTTPS | Ja | -| 9418/TCP | Einfacher Git-Protokollport
    (Im privaten Modus deaktiviert) | Nein | - -#### Verwaltungsports - -Verwaltungsports sind für die einfache Verwendung von Anwendungen durch Endbenutzer nicht erforderlich. - -| Port | Beschreibung | Verschlüsselt | -|:-------- |:--------------------------- |:----------------------------------------------------------------------------- | -| ICMP | ICMP Ping | Nein | -| 122/TCP | Verwaltungs-SSH | Ja | -| 161/UDP | SNMP | Nein | -| 8080/TCP | HTTP für Managementkonsole | Nein
    (Wenn SSL aktiviert ist, leitet dieser Port Elemente an HTTPS weiter) | -| 8443/TCP | HTTPS für Managementkonsole | Ja | - -#### Clusterkommunikationsports - -Wenn sich zwischen Knoten eine Firewall auf Netzwerkebene befindet, müssen diese Ports zugänglich sein. Die Kommunikation zwischen Knoten ist nicht verschlüsselt. Diese Ports sollten extern nicht zugänglich sein. - -| Port | Beschreibung | -|:--------- |:---------------------------- | -| 1336/TCP | Interne API | -| 3033/TCP | Interner SVN-Zugriff | -| 3037/TCP | Interner SVN-Zugriff | -| 3306/TCP | MySQL | -| 4486/TCP | Governor-Zugriff | -| 5115/TCP | Storage-Back-End | -| 5208/TCP | Interner SVN-Zugriff | -| 6379/TCP | Redis | -| 8001/TCP | Grafana | -| 8090/TCP | Interner GPG-Zugriff | -| 8149/TCP | GitRPC-Dateiserverzugriff | -| 8300/TCP | Consul | -| 8301/TCP | Consul | -| 8302/TCP | Consul | -| 9000/TCP | Git-Daemon | -| 9102/TCP | Pages-Dateiserver | -| 9105/TCP | LFS-Server | -| 9200/TCP | ElasticSearch | -| 9203/TCP | Dienst für semantischen Code | -| 9300/TCP | ElasticSearch | -| 11211/TCP | Memcache | -| 161/UDP | SNMP | -| 8125/UDP | Statsd | -| 8301/UDP | Consul | -| 8302/UDP | Consul | -| 25827/UDP | Collectd | - - -### Load-Balancer konfigurieren - - Sie sollten einen externen TCP-basierten Load-Balancer verwenden, der das PROXY-Protokoll unterstützt, um den Traffic auf die Knoten zu verteilen. Beachten Sie die folgenden Load-Balancer-Konfigurationen: - - - TCP-Ports (siehe unten) sollten an Knoten weitergeleitet werden, auf denen der Dienst `web-server` ausgeführt wird. Dies sind die einzigen Knoten, die externe Clientanfragen verarbeiten. - - Sticky Sessions sollten nicht aktiviert werden. - -{% data reusables.enterprise_installation.terminating-tls %} - -### Clientverbindungsinformationen verarbeiten - -Da Clientverbindungen zum Cluster vom Load-Balancer stammen, kann die Client-IP-Adresse verloren gehen. Zum entsprechenden Erfassen der Clientverbindungsinformationen sind zusätzliche Überlegungen nötig. - -{% data reusables.enterprise_clustering.proxy_preference %} - -{% data reusables.enterprise_clustering.proxy_xff_firewall_warning %} - -#### PROXY-Unterstützung auf {% data variables.product.prodname_ghe_server %} aktivieren - -Es wird dringend empfohlen, die PROXY-Unterstützung für Ihre Instanz und für den Load-Balancer zu aktivieren. - - - Führen Sie für Ihre Instanz den folgenden Befehl aus: - ```shell - $ ghe-config 'loadbalancer.proxy-protocol' 'true' && ghe-cluster-config-apply - ``` - - Verwenden Sie für den Load-Balancer die von Ihrem Anbieter bereitgestellten Anweisungen. - - {% data reusables.enterprise_clustering.proxy_protocol_ports %} - -#### X-Forwarded-For-Unterstützung für {% data variables.product.prodname_ghe_server %} aktivieren - -{% data reusables.enterprise_clustering.x-forwarded-for %} - -Führen Sie zum Aktivieren des Headers `X-Fowarded-For` den folgenden Befehl aus: - -```shell -$ ghe-config 'loadbalancer.http-forward' 'true' && ghe-cluster-config-apply -``` - -{% data reusables.enterprise_clustering.without_proxy_protocol_ports %} - -#### Zustandsprüfungen konfigurieren -Zustandsprüfungen ermöglichen einem Load-Balancer, das Senden von Traffic an einen nicht antwortenden Knoten zu stoppen, wenn eine vorkonfigurierte Prüfung auf diesem Knoten fehlschlägt. Wenn ein Clusterknoten fehlschlägt, bieten die mit den redundanten Knoten gekoppelten Zustandsprüfungen Hochverfügbarkeit. - -{% data reusables.enterprise_clustering.health_checks %} -{% data reusables.enterprise_site_admin_settings.maintenance-mode-status %} - -### DNS-Anforderungen - -{% data reusables.enterprise_clustering.load_balancer_dns %} diff --git a/translations/de-DE/content/admin/clustering/differences-between-clustering-and-high-availability-ha.md b/translations/de-DE/content/admin/clustering/differences-between-clustering-and-high-availability-ha.md deleted file mode 100644 index dd4cd7f256e8..000000000000 --- a/translations/de-DE/content/admin/clustering/differences-between-clustering-and-high-availability-ha.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: Unterschiede zwischen Clustering und Hochverfügbarkeit -intro: 'Die {% data variables.product.prodname_ghe_server %}-Hochverfügbarkeitskonfiguration ist eine Konfiguration mit einer primären/sekundären Failover-Instanz, die Redundanz bereitstellt. Demgegenüber bietet Clustering Redundanz und Skalierbarkeit, indem die Last für Lese- und Schreibvorgänge auf mehrere Knoten verteilt wird.' -redirect_from: - - /enterprise/admin/clustering/differences-between-clustering-and-high-availability-ha -versions: - enterprise-server: '*' ---- - -### Fehlerszenarien - -Hochverfügbarkeit und Clustering bieten Redundanz, indem der einzelne Knoten als ein Point of Failure beseitigt wird. In den folgenden Szenarien können sie Verfügbarkeit bieten: - -{% data reusables.enterprise_installation.ha-and-clustering-failure-scenarios %} - -### Skalierbarkeit - -{% data reusables.enterprise_clustering.clustering-scalability %} in der Hochverfügbarkeitskonfiguration ist die Größe der Appliance nur vom primären Knoten abhängig, und die Last wird nicht an den Replikatserver verteilt. - -### Unterschiede bei der Failover-Methode und -Konfiguration - -| Feature | Failover-Konfiguration | Failover-Methode | -|:------------------------------- |:------------------------------------------------------------------------------------------------------------ |:-------------------------------------------------------------------------------------------------------------------------------- | -| Hochverfügbarkeitskonfiguration | DNS-Eintrag mit einem niedrigen TTL-Wert, der auf die primäre Appliance oder auf den Load-Balancer verweist. | Sie müssen die Replikat-Appliance in den DNS-Failover- und Load-Balancer-Konfigurationen manuell hochstufen. | -| Clustering | Der DNS-Eintrag muss auf einen Load-Balancer verweisen. | Wenn ein Knoten hinter dem Load-Balancer ausfällt, wird der Traffic automatisch an die anderen funktionierenden Knoten gesendet. | - -### Backups und Disaster Recovery - -Weder die Hochverfügbarkeit noch Clustering sollten als ein Ersatz für regelmäßige Backups angesehen werden. Weitere Informationen finden Sie unter „[Backups auf Ihrer Appliance konfigurieren](/enterprise/admin/guides/installation/configuring-backups-on-your-appliance)“. - -### Überwachung - -Verfügbarkeitsfeatures, insbesondere mit einem automatischen Failover, beispielsweise Clustering, können einen Fehler maskieren, da der Dienst in der Regel nicht unterbrochen wird, wenn etwas fehlschlägt. Unabhängig davon, ob Sie Hochverfügbarkeit oder Clustering verwenden, ist es wichtig, den Zustand jeder Instanz zu überwachen, damit Sie wissen, wann ein Fehler auftritt. Weitere Informationen finden Sie unter „[Empfohlene Schwellenwerte für Meldungen](/enterprise/{{ currentVersion }}/admin/guides/installation/recommended-alert-thresholds/)“ und „[Clusterknoten überwachen](/enterprise/{{ currentVersion}}/admin/guides/clustering/monitoring-cluster-nodes/)“. - -### Weiterführende Informationen -- Weitere Informationen zum {% data variables.product.prodname_ghe_server %}-Clustering, findest Du unter „[Informationen zum Clustering](/enterprise/{{ currentVersion}}/admin/guides/clustering/about-clustering/)“. -- Weitere Informationen zur Hochverfügbarkeit finden Sie unter „[{% data variables.product.prodname_ghe_server %} für Hochverfügbarkeit konfigurieren](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-github-enterprise-server-for-high-availability/)“. diff --git a/translations/de-DE/content/admin/clustering/evacuating-a-cluster-node.md b/translations/de-DE/content/admin/clustering/evacuating-a-cluster-node.md deleted file mode 100644 index 9de5e2f31004..000000000000 --- a/translations/de-DE/content/admin/clustering/evacuating-a-cluster-node.md +++ /dev/null @@ -1,52 +0,0 @@ ---- -title: Clusterknoten evakuieren -intro: Sie können Datendienste auf einem Clusterknoten evakuieren. -redirect_from: - - /enterprise/admin/clustering/evacuating-a-cluster-node -versions: - enterprise-server: '*' ---- - -Wenn auf Ihrem Datendienstcluster nur drei Knoten vorhanden sind, können Sie die Knoten nicht evakuieren, da `ghe-spokes` keinen anderen Platz besitzt, um eine Kopie vorzunehmen. Bei mindestens vier Knoten verschiebt `ghe-spokes` alle Repositorys vom evakuierten Knoten. - -Wenn Sie einen Knoten offline nehmen, der Datendienste aufweist (wie Git, Pages oder Storage), evakuieren Sie jeden Knoten, bevor Sie ihn offline nehmen. - -1. Finde die `uuid` des Knotens mit dem Befehl `ghe-config` heraus. - - ``` - $ ghe-config cluster._hostname_.uuid - ``` - -2. Sie müssen den Status Ihres Knotens überwachen, während die Daten geöffnet werden. Im Idealfall sollte der Knoten nicht offline genommen werden, bis der Kopiervorgang abgeschlossen ist. Führen Sie einen der folgenden Befehle aus, um den Status Ihres Knotens zu überwachen: - - Für Git - ``` - ghe-spokes evac-status - ``` - Für {% data variables.product.prodname_pages %} - ``` - echo "select count(*) from pages_replicas where host = 'pages-server-'" | ghe-dbconsole -y - ``` - Für Storage - ``` - ghe-storage evacuation-status - ``` - -3. Nach Abschluss des Kopiervorgangs können Sie den Speicherdienst evakuieren. Führen Sie einen der folgenden Befehle aus: - - Für Git - ``` - ghe-spokes server evacuate git-server- - ``` - Für {% data variables.product.prodname_pages %} - ``` - ghe-dpages evacuate pages-server- - ``` - Nehmen Sie für Storage den Knoten offline. - ``` - ghe-storage offline storage-server- - ``` - Evakuieren Sie anschließend - ``` - ghe-storage evacuate storage-server- - ``` diff --git a/translations/de-DE/content/admin/clustering/index.md b/translations/de-DE/content/admin/clustering/index.md deleted file mode 100644 index 37d1d2c66153..000000000000 --- a/translations/de-DE/content/admin/clustering/index.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Cluster für GitHub Enterprise Server einrichten und verwalten -shortTitle: Clustering -intro: 'Dieser Leitfaden beschreibt, wie Du gemeinsam mit dem für Dein Konto zuständigen Ansprechpartner herausfindest, ob sich {% data variables.product.prodname_enterprise %}-Clustering für Deine Organisation eignet, und auch wie ein Cluster dann eingerichtet wird.' -redirect_from: - - /enterprise/admin/clustering -versions: - enterprise-server: '*' ---- - -### Inhaltsverzeichnis - -{% topic_link_in_list /overview %} - {% link_in_list /about-clustering %} - {% link_in_list /differences-between-clustering-and-high-availability-ha %} -{% topic_link_in_list /setting-up-the-cluster-instances %} - {% link_in_list /about-cluster-nodes %} - {% link_in_list /cluster-network-configuration %} - {% link_in_list /initializing-the-cluster %} -{% topic_link_in_list /managing-a-github-enterprise-server-cluster %} - {% link_in_list /upgrading-a-cluster %} - {% link_in_list /replacing-a-cluster-node %} - {% link_in_list /evacuating-a-cluster-node %} - {% link_in_list /monitoring-cluster-nodes %} diff --git a/translations/de-DE/content/admin/clustering/initializing-the-cluster.md b/translations/de-DE/content/admin/clustering/initializing-the-cluster.md deleted file mode 100644 index 48e001f342be..000000000000 --- a/translations/de-DE/content/admin/clustering/initializing-the-cluster.md +++ /dev/null @@ -1,113 +0,0 @@ ---- -title: Cluster initialisieren -intro: 'Ein {% data variables.product.prodname_ghe_server %}-Cluster muss mit einer Lizenz eingerichtet und mithilfe der Verwaltungsshell (SSH) initialisiert werden.' -redirect_from: - - /enterprise/admin/clustering/initializing-the-cluster -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_clustering.clustering-requires-https %} - -### {% data variables.product.prodname_ghe_server %} installieren - -1. Stellen Sie auf jedem Clusterknoten {% data variables.product.prodname_ghe_server %} bereit, und installieren Sie es. Weitere Informationen finden Sie unter „[{% data variables.product.prodname_ghe_server %}-Instanz einrichten](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-github-enterprise-server-instance)“. -2. Konfigurieren Sie mithilfe der Verwaltungsshell oder DHCP **nur** die IP-Adresse jedes Knotens. Konfigurieren Sie keine anderen Einstellungen. - -### Ersten Knoten konfigurieren - -1. Stellen Sie eine Verbindung zum Knoten her, der als `mysql-master` in `cluster.conf` vorgesehen ist. Weitere Informationen findest Du unter „[Informationen zur Clusterkonfigurations-Datei](/enterprise/{{ currentVersion }}/admin/guides/clustering/initializing-the-cluster/#about-the-cluster-configuration-file)“. -2. Rufen Sie in Ihrem Webbrowser `https://:8443/setup/` auf. -{% data reusables.enterprise_installation.upload-a-license-file %} -{% data reusables.enterprise_installation.save-settings-in-web-based-mgmt-console %} -{% data reusables.enterprise_installation.instance-will-restart-automatically %} - -### Cluster initialisieren - -Zum Initialisieren des Clusters benötigen Sie eine Clusterkonfigurationsdatei (`cluster.conf`). Weitere Informationen finden Sie unter „[Informationen zur Clusterkonfigurationsdatei](/enterprise/{{ currentVersion }}/admin/guides/clustering/initializing-the-cluster/#about-the-cluster-configuration-file)“. - -1. Führen Sie auf dem ersten Knoten, der konfiguriert wurde, `ghe-cluster-config-init` aus. Dadurch wird der Cluster initialisiert, wenn in der Clusterkonfigurationsdatei nicht konfigurierte Knoten vorhanden sind. -2. Führen Sie `ghe-cluster-config-apply` aus. Dadurch wird die Datei `cluster.conf` validiert, die Konfiguration auf jede Knotendatei angewendet und die konfigurierten Dienste auf jedem Knoten angezeigt. - -Führen Sie den Befehl `ghe-cluster-status` aus, um den Status eines in Ausführung befindlichen Clusters zu überprüfen. - -### Informationen zur Clusterkonfigurationsdatei - -Die Clusterkonfigurationsdatei (`cluster.conf`) definiert die Knoten im Cluster und welche Dienste sie ausführen. Weitere Informationen findest Du unter [„About cluster nodes“ (Informationen zu Cluster-Knoten)](/enterprise/{{ currentVersion }}/admin/guides/clustering/about-cluster-nodes). - -Diese Beispieldatei `cluster.conf` definiert einen Cluster mit fünf Knoten. - - - Auf zwei Knoten (namens `ghe-app-node-\*`) laufen die Dienste `web-server` und `job-server` deren Aufgabe es ist, die Clientanfragen zu beantworten. - - Drei Knoten (namens `ghe-data-node-\*`) führen die Dienste aus, die zum Speichern und Abrufen der {% data variables.product.prodname_ghe_server %}-Daten verantwortlich sind. - -Die Namen der Knoten können beliebige gültige Hostnamen sein. Die Namen werden als der Hostname jedes Knotens festgelegt und zudem `/etc/hosts` auf jedem Knoten hinzugefügt, damit die Knoten untereinander lokal auflösbar sind. - -Geben Sie den ersten Clusterknoten an, den Sie als den MySQL-Master über `mysql-server` und `mysql-master` konfiguriert haben. - -``` -[cluster] - mysql-master = ghe-data-node-1 - redis-master = ghe-data-node-1 - primary-datacenter = default -[cluster "ghe-app-node-1"] - hostname = ghe-app-node-1 - ipv4 = 192.168.0.2 - # ipv6 = fd12:3456:789a:1::2 - web-server = true - job-server = true -[cluster "ghe-app-node-2"] - hostname = ghe-app-node-2 - ipv4 = 192.168.0.3 - # ipv6 = fd12:3456:789a:1::3 - web-server = true - job-server = true -[cluster "ghe-data-node-1"] - hostname = ghe-data-node-1 - ipv4 = 192.168.0.4 - # ipv6 = fd12:3456:789a:1::4 - consul-server = true - consul-datacenter = default - git-server = true - pages-server = true - mysql-server = true - elasticsearch-server = true - redis-server = true - memcache-server = true - metrics-server = true - storage-server = true -[cluster "ghe-data-node-2"] - hostname = ghe-data-node-2 - ipv4 = 192.168.0.5 - # ipv6 = fd12:3456:789a:1::5 - consul-server = true - consul-datacenter = default - git-server = true - pages-server = true - mysql-server = true - elasticsearch-server = true - redis-server = true - memcache-server = true - metrics-server = true - storage-server = true -[cluster "ghe-data-node-3"] - hostname = ghe-data-node-3 - ipv4 = 192.168.0.6 - # ipv6 = fd12:3456:789a:1::6 - consul-server = true - consul-datacenter = default - git-server = true - pages-server = true - mysql-server = true - elasticsearch-server = true - redis-server = true - memcache-server = true - metrics-server = true - storage-server = true -``` - -Erstellen Sie die Datei `/data/user/common/cluster.conf` auf dem konfigurierten ersten Knoten. Führen Sie beispielsweise mit `vim` Folgendes aus: - - ```shell - ghe-data-node-1:~$ sudo vim /data/user/common/cluster.conf - ``` - diff --git a/translations/de-DE/content/admin/clustering/managing-a-github-enterprise-server-cluster.md b/translations/de-DE/content/admin/clustering/managing-a-github-enterprise-server-cluster.md deleted file mode 100644 index 77b96bcae709..000000000000 --- a/translations/de-DE/content/admin/clustering/managing-a-github-enterprise-server-cluster.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: GitHub Enterprise Server-Cluster verwalten -intro: 'Planen Sie Wartungsvorgänge für einen {% data variables.product.prodname_ghe_server %}-Cluster, beispielsweise Upgrades, das Hinzufügen von Kapazität und das Ersetzen fehlgeschlagener Knoten.' -redirect_from: - - /enterprise/admin/guides/clustering/managing-a-github-enterprise-cluster/ - - /enterprise/admin/clustering/managing-a-github-enterprise-server-cluster -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/de-DE/content/admin/clustering/monitoring-cluster-nodes.md b/translations/de-DE/content/admin/clustering/monitoring-cluster-nodes.md deleted file mode 100644 index 6b4336304a0e..000000000000 --- a/translations/de-DE/content/admin/clustering/monitoring-cluster-nodes.md +++ /dev/null @@ -1,105 +0,0 @@ ---- -title: Clusterknoten überwachen -intro: 'Ein {% data variables.product.prodname_ghe_server %}-Cluster besteht aus redundanten Diensten, die auf mindestens zwei Knoten verteilt sind. Wenn ein einzelner Dienst oder ein gesamter Knoten fehlschlägt, sollte dies den Benutzern des Clusters sofort auffallen. Da jedoch Leistung und Redundanz betroffen sind, ist es wichtig, den Zustand eines {% data variables.product.prodname_ghe_server %}-Clusters zu überwachen.' -redirect_from: - - /enterprise/admin/clustering/monitoring-cluster-nodes -versions: - enterprise-server: '*' ---- - -### Clusterstatus manuell überprüfen - -{% data variables.product.prodname_ghe_server %} besitzt ein integriertes Befehlszeilendienstprogramm zum Überwachen des Clusterzustands. Wenn in der Verwaltungsshell der Befehl `ghe-cluster-status` ausgeführt wird, werden einige Zustandsprüfungen auf jedem Knoten ausgeführt, darunter die Verifizierung der Konnektivität und des Dienststatus. Die Ausgabe enthält alle Testergebnisse, darunter der Text `ok` oder `error`. Führen Sie beispielsweise Folgendes aus, um nur fehlgeschlagene Tests anzuzeigen: - -```shell -admin@ghe-data-node-0:~$ ghe-cluster-status | grep error -> mysql-replication ghe-data-node-0: error Stopped -> mysql cluster: error -``` -{% note %} - -**Hinweis:** Wenn keine fehlgeschlagenen Tests vorliegen, gibt dieser Befehl nichts aus. Dies gibt an, dass der Cluster fehlerfrei ist. - -{% endnote %} - -### Clusterstatus mit Nagios überwachen - -Sie können [Nagios](https://www.nagios.org/) für die Überwachung von {% data variables.product.prodname_ghe_server %} konfigurieren. Zusätzlich zur Überwachung der grundlegenden Konnektivität jedes Clusterknotens können Sie den Clusterstatus überprüfen, indem Sie Nagios für die Verwendung des Befehls `ghe-cluster-status -n` konfigurieren. Dadurch wird eine für Nagios verständliche Ausgabe zurückgegeben. - -#### Voraussetzungen -* Linux-Host, auf dem Nagios ausgeführt wird. -* Netzwerkzugriff auf den {% data variables.product.prodname_ghe_server %}-Cluster. - -#### Nagios-Host konfigurieren -1. Generieren Sie einen SSH-Schlüssel mit einer leeren Passphrase. Nagios verwendet diese, um sich beim {% data variables.product.prodname_ghe_server %}-Cluster zu authentifizieren. - ```shell - nagiosuser@nagios:~$ ssh-keygen -t rsa -b 4096 - > Generating public/private rsa key pair. - > Enter file in which to save the key (/home/nagiosuser/.ssh/id_rsa): - > Enter passphrase (empty for no passphrase): leave blank by pressing enter - > Enter same passphrase again: press enter again - > Your identification has been saved in /home/nagiosuser/.ssh/id_rsa. - > Your public key has been saved in /home/nagiosuser/.ssh/id_rsa.pub. - ``` - {% danger %} - - **Sicherheitswarnung:** Ein SSH-Schlüssel ohne eine Passphrase kann ein Sicherheitsrisiko darstellen, wenn er für den vollen Zugriff auf einen Host berechtigt ist. Begrenzen Sie die Autorisierung dieses Schlüssels auf einen einzelnen schreibgeschützten Befehl. - - {% enddanger %} -2. Kopieren Sie den privaten Schlüssel (`id_rsa`) in den Startordner `nagios`, und legen Sie die entsprechende Inhaberschaft fest. - ```shell - nagiosuser@nagios:~$ sudo cp .ssh/id_rsa /var/lib/nagios/.ssh/ - nagiosuser@nagios:~$ sudo chown nagios:nagios /var/lib/nagios/.ssh/id_rsa - ``` - -3. Verwenden Sie das Präfix `command=` in der Datei `/data/user/common/authorized_keys`, um den öffentlichen Schlüssel *nur* für den Befehl `ghe-cluster-status -n` zu autorisieren. Ändern Sie in der Verwaltungsshell oder auf einem beliebigen Knoten diese Datei, um den in Schritt 1 generierten öffentlichen Schlüssel hinzuzufügen. Zum Beispiel: `command="/usr/local/bin/ghe-cluster-status -n" ssh-rsa AAAA....` - -4. Validieren und kopieren Sie die Konfiguration auf jeden Knoten im Cluster. Führen Sie dazu `ghe-cluster-config-apply` auf dem Knoten aus, auf dem Sie die Datei `/data/user/common/authorized_keys` geändert haben. - - ```shell - admin@ghe-data-node-0:~$ ghe-cluster-config-apply - > Validating configuration - > ... - > Finished cluster configuration - ``` - -5. Um zu testen, ob das Nagios-Plug-in den Befehl erfolgreich ausführen kann, führen Sie es auf dem Nagios-Host interaktiv aus. - ```shell - nagiosuser@nagios:~$ /usr/lib/nagios/plugins/check_by_ssh -l admin -p 122 -H hostname -C "ghe-cluster-status -n" -t 30 - > OK - No errors detected - ``` - -6. Erstellen Sie eine Befehlsdefinition in Ihrer Nagios-Konfiguration. - - ###### Beispieldefinition - - ``` - define command { - command_name check_ssh_ghe_cluster - command_line $USER1$/check_by_ssh -H $HOSTADDRESS$ -C "ghe-cluster-status -n" -l admin -p 122 -t 30 - } - ``` -7. Fügen Sie diesen Befehl zu einer Dienstdefinition für einen Knoten im {% data variables.product.prodname_ghe_server %}-Cluster hinzu. - - - ###### Beispieldefinition - - ``` - define host{ - use generic-host - host_name ghe-data-node-0 - alias ghe-data-node-0 - address 10.11.17.180 - } - - define service{ - use generic-service - host_name ghe-data-node-0 - service_description GitHub Cluster Status - check_command check_ssh_ghe_cluster - } - ``` - -Nachdem Sie Nagios die Definition hinzugefügt haben, wird die Dienstüberprüfung entsprechend Ihrer Konfiguration ausgeführt. Sie sollten den neu konfigurierten Dienst auf der Nagios-Weboberfläche anzeigen können. - -![Nagios-Beispiel](/assets/images/enterprise/cluster/nagios-example.png) diff --git a/translations/de-DE/content/admin/clustering/overview.md b/translations/de-DE/content/admin/clustering/overview.md deleted file mode 100644 index 2a3ae9e06553..000000000000 --- a/translations/de-DE/content/admin/clustering/overview.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Übersicht -intro: Erfahre mehr über Clustering und die Abgrenzung zu Hoch-Verfügbarkeit. -mapTopic: true -redirect_from: - - /enterprise/admin/clustering/overview -versions: - enterprise-server: '*' ---- - diff --git a/translations/de-DE/content/admin/clustering/replacing-a-cluster-node.md b/translations/de-DE/content/admin/clustering/replacing-a-cluster-node.md deleted file mode 100644 index 59d5c17f84a0..000000000000 --- a/translations/de-DE/content/admin/clustering/replacing-a-cluster-node.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: Clusterknoten ersetzen -intro: 'Zum Ersetzen eines {% data variables.product.prodname_ghe_server %}-Knotens müssen Sie die betroffenen Knoten in der Clusterkonfigurationsdatei („cluster.conf“) als offline markieren und die Ersatzknoten hinzufügen. Dies ist ggf. erforderlich, wenn ein Knoten fehlschlägt oder um einen Knoten mit mehr Ressourcen hinzuzufügen, um die Leistung zu erhöhen.' -redirect_from: - - /enterprise/admin/clustering/replacing-a-cluster-node -versions: - enterprise-server: '*' ---- - -{% warning %} - -**Warnung:** Zum Vermeiden von Konflikten muss der Ersatzknoten einen Hostnamen verwenden, der noch nicht im Cluster verwendet wurde. - -{% endwarning %} - -### Funktionierenden Knoten ersetzen -{% data reusables.enterprise_clustering.replacing-a-cluster-node-provision %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-admin-configure-ip %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-modify-cluster-conf %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-initialize-new-node %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-config-node %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-need-three-nodes %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-mark-offline %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-validate-config %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-replacement-name %} - -### Knoten in einem Notfall ersetzen -{% data reusables.enterprise_clustering.replacing-a-cluster-node-provision %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-admin-configure-ip %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-mark-offline %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-validate-config %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-modify-cluster-conf %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-replacement-name %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-initialize-new-node %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-config-node %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-need-three-nodes %} diff --git a/translations/de-DE/content/admin/clustering/setting-up-the-cluster-instances.md b/translations/de-DE/content/admin/clustering/setting-up-the-cluster-instances.md deleted file mode 100644 index d5fb76f8eae0..000000000000 --- a/translations/de-DE/content/admin/clustering/setting-up-the-cluster-instances.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Clusterinstanzen einrichten -intro: 'Für das {% data variables.product.prodname_ghe_server %} Clustering müssen mehrere Instanzen für die Ausführung von {% data variables.product.prodname_ghe_server %}-Diensten eingerichtet und konfiguriert sein.' -mapTopic: true -redirect_from: - - /enterprise/admin/clustering/setting-up-the-cluster-instances -versions: - enterprise-server: '*' ---- - diff --git a/translations/de-DE/content/admin/clustering/upgrading-a-cluster.md b/translations/de-DE/content/admin/clustering/upgrading-a-cluster.md deleted file mode 100644 index 236cc8b53171..000000000000 --- a/translations/de-DE/content/admin/clustering/upgrading-a-cluster.md +++ /dev/null @@ -1,76 +0,0 @@ ---- -title: Cluster-Upgrade -intro: 'Verwenden Sie die Verwaltungsshell (SSH), um ein {% data variables.product.prodname_ghe_server %}-Cluster auf die neueste Version zu aktualisieren.' -redirect_from: - - /enterprise/admin/clustering/upgrading-a-cluster -versions: - enterprise-server: '*' ---- - -### Upgrade mit einem Hotpatch -{% data reusables.enterprise_installation.hotpatching-explanation %} Das Hotpatch-Installationsskript installiert den Hotpatch auf jedem Knoten im Cluster und startet die Dienste zum Vermeiden von Ausfallzeiten in ihrer entsprechenden Abfolge neu. - -1. Sichern Sie Ihre Daten mit [{% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils#readme). -2. Führen Sie an der Verwaltungsshell auf einem beliebigen Knoten den Befehl `ghe-cluster-hotpatch` aus, um den neuesten Hotpatch zu installieren. Sie können eine URL für einen Hotpatch bereitstellen oder den Hotpatch manuell herunterladen und einen lokalen Dateinamen angeben. - ```shell - $ ghe-cluster-hotpatch https://HOTPATCH-URL/FILENAME.hpkg - ``` - -### Upgrade mit einem Upgrade-Paket -Verwenden Sie ein Upgrade-Paket, um ein Upgrade eines {% data variables.product.prodname_ghe_server %}-Clusters auf die neueste Feature-Veröffentlichung vorzunehmen. Beispielsweise können Sie ein Upgrade von `2.11` auf `2.13` vornehmen. - -#### Upgrade vorbereiten - -1. Überprüfe [Clusternetzwerk-Konfiguration](/enterprise/admin/guides/clustering/cluster-network-configuration) bezüglich der Version, auf die Du ein Upgrade durchführst, und aktualisiere Deine Konfiguration nach Bedarf. -2. Sichern Sie Ihre Daten mit [{% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils#readme). -3. Planen Sie ein Wartungsfenster für Endbenutzer Ihres {% data variables.product.prodname_ghe_server %}-Clusters, da er während des Upgrades für die normale Nutzung nicht verfügbar ist. Der Wartungsmodus blockiert den Benutzerzugriff und verhindert Datenänderungen, während das Cluster-Upgrade ausgeführt wird. -4. Kopieren Sie auf der [{% data variables.product.prodname_ghe_server %}-Downloadseite](https://enterprise.github.com/download) die URL für die upzugradende *.pkg*-Datei in die Zwischenablage. -5. Führen Sie an der Verwaltungsshell eines beliebigen Knotens den Befehl `ghe-cluster-each` in Kombination mit `curl` aus, um das Versionspaket in einem einzelnen Schritt auf jeden Knoten herunterzuladen. Verwenden Sie die im vorherigen Schritt von Ihnen kopierte URL als ein Argument. - ```shell - $ ghe-cluster-each -- "cd /home/admin && curl -L -O https://PACKAGE-URL.pkg" - > ghe-app-node-1: % Total % Received % Xferd Average Speed Time Time Time Current - > ghe-app-node-1: Dload Upload Total Spent Left Speed - > 100 496M 100 496M 0 0 24.2M 0 0:00:20 0:00:20 --:--:-- 27.4M - > ghe-data-node-2: % Total % Received % Xferd Average Speed Time Time Time Current - > ghe-data-node-2: Dload Upload Total Spent Left Speed - > 100 496M 100 496M 0 0 21.3M 0 0:00:23 0:00:23 --:--:-- 25.8M - > ghe-data-node-1: % Total % Received % Xferd Average Speed Time Time Time Current - > ghe-data-node-1: Dload Upload Total Spent Left Speed - > 100 496M 100 496M 0 0 19.7M 0 0:00:25 0:00:25 --:--:-- 25.6M - > ghe-app-node-2: % Total % Received % Xferd Average Speed Time Time Time Current - > ghe-app-node-2: Dload Upload Total Spent Left Speed - > 100 496M 100 496M 0 0 19.8M 0 0:00:25 0:00:25 --:--:-- 17.6M - > ghe-data-node-3: % Total % Received % Xferd Average Speed Time Time Time Current - > ghe-data-node-3: Dload Upload Total Spent Left Speed - > 100 496M 100 496M 0 0 19.7M 0 0:00:25 0:00:25 --:--:-- 25.5M - ``` -6. Identifizieren Sie den primären MySQL-Knoten, der in `cluster.conf` als `mysql-master = ` definiert ist. Dieser Knoten wird zuletzt upgegradet. - -#### Clusterknoten upgraden - -1. Aktivieren Sie den Wartungsmodus entsprechend Ihrem geplanten Fenster. Verbinden Sie sich dazu mit der Verwaltungsshell auf einem beliebigen Clusterknoten, und führen Sie `ghe-cluster-maintenance -s` aus. -2. Stellen Sie **mit Ausnahme des primären MySQL-Knotens** eine Verbindung zur Verwaltungsshell der jeweiligen {% data variables.product.prodname_ghe_server %}-Knoten her. Führen Sie den Befehl `ghe-upgrade` aus, und geben Sie den Namen der Paketdatei an, die Sie in Schritt 4 [Upgrade vorbereiten](#preparing-to-upgrade) heruntergeladen haben: - ```shell - $ ghe-upgrade PACKAGE-FILENAME.pkg - > *** verifying upgrade package signature... - > 497MB 0:00:04 [ 117MB/s] [==========================================>] 100% - > gpg: Signature made Fri 19 Feb 2016 02:33:50 PM UTC using RSA key ID 0D65D57A - > gpg: checking the trustdb - > gpg: 3 marginal(s) needed, 1 complete(s) needed, PGP trust model - > gpg: depth: 0 valid: 1 signed: 0 trust: 0-, 0q, 0n, 0m, 0f, 1u - > gpg: Good signature from "GitHub Enterprise (Upgrade Package Key) > " - ``` -3. Der Upgrade-Prozess startet den Knoten nach dem Abschluss neu. Verifizieren Sie, dass Sie jeden Knoten nach dem Neustart `pingen` können. -4. Stellen Sie auf dem primären MySQL-Knoten eine Verbindung zur Verwaltungsshell her. Führen Sie den Befehl `ghe-upgrade` aus, und geben Sie den Namen der Paketdatei an, die Sie in Schritt 4 [Upgrade vorbereiten](#preparing-to-upgrade) heruntergeladen haben: - ```shell - $ ghe-upgrade PACKAGE-FILENAME.pkg - > *** verifying upgrade package signature... - > 497MB 0:00:04 [ 117MB/s] [==========================================>] 100% - > gpg: Signature made Fri 19 Feb 2016 02:33:50 PM UTC using RSA key ID 0D65D57A - > gpg: checking the trustdb - > gpg: 3 marginal(s) needed, 1 complete(s) needed, PGP trust model - > gpg: depth: 0 valid: 1 signed: 0 trust: 0-, 0q, 0n, 0m, 0f, 1u - > gpg: Good signature from "GitHub Enterprise (Upgrade Package Key) > " - ``` -5. Der Upgrade-Prozess startet den primären MySQL-Knoten nach dem Abschluss neu. Verifizieren Sie, dass Sie jeden Knoten nach dem Neustart `pingen` können. -6. Führen Sie an der Verwaltungsshell eines beliebigen Knotens den Befehl `ghe-cluster-maintenance -u` aus, um den Wartungsmodus zu beenden. diff --git a/translations/de-DE/content/admin/configuration/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md b/translations/de-DE/content/admin/configuration/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md deleted file mode 100644 index b977230b514c..000000000000 --- a/translations/de-DE/content/admin/configuration/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: Sicherheitsmeldungen für angreifbare Abhängigkeiten auf GitHub Enterprise Server aktivieren -intro: 'Sie können zwischen {% data variables.product.product_location_enterprise %} und {% data variables.product.prodname_ghe_cloud %} eine Verbindung herstellen und Sicherheitsmeldungen für angreifbare Abhängigkeiten in Repositorys auf Ihrer Instanz aktivieren.' -redirect_from: - - /enterprise/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server - - /enterprise/admin/configuration/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server -permissions: 'Site-Administratoren für {% data variables.product.prodname_ghe_server %} , die auch Inhaber der angeschlossenen Organisation oder des angeschlossenen Unternehmenskontos in der {% data variables.product.prodname_ghe_cloud %} sind, können Sicherheitswarnungen für ungeschützte Abhängigkeiten auf {% data variables.product.prodname_ghe_server %} aktivieren.' -versions: - enterprise-server: '*' ---- - -### About alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %} - -{% data reusables.repositories.tracks-vulnerabilities %} For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)." - -Sie können zwischen {% data variables.product.product_location_enterprise %} und {% data variables.product.prodname_dotcom_the_website %} eine Verbindung herstellen, dann die Schwachstellendaten mit Ihrer Instanz synchronisieren und Sicherheitsmeldungen in Repositorys generieren, die eine angreifbare Abhängigkeit aufweisen. - -Nachdem Sie {% data variables.product.product_location_enterprise %} mit {% data variables.product.prodname_dotcom_the_website %} verbunden und Sicherheitsmeldungen für angreifbare Abhängigkeiten aktiviert haben, werden die Schwachstellendaten stündlich von {% data variables.product.prodname_dotcom_the_website %} mit Ihrer Instanz synchronisiert. Sie können die Schwachstellendaten auch jederzeit manuell synchronisieren. Es werden weder Code noch Informationen zu Code von {% data variables.product.product_location_enterprise %} auf {% data variables.product.prodname_dotcom_the_website %} hochgeladen. - -Wenn {% data variables.product.product_location_enterprise %} Informationen zu einer Schwachstelle empfängt, werden die Repositorys in Ihrer Instanz identifiziert, welche die betroffene Version der Abhängigkeit verwenden. Zudem werden Sicherheitsmeldungen an Inhaber und Personen gesendet, die in diesen Repositorys über Administratorzugriff verfügen. Sie können anpassen, wie sie Sicherheitsmeldungen empfangen möchten. For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies/#configuring-notifications-for-security-alerts)." - -### Sicherheitsmeldungen für angreifbare Abhängigkeiten auf {% data variables.product.prodname_ghe_server %} aktivieren - -Bevor Sie Sicherheitsmeldungen für angreifbare Abhängigkeiten auf {% data variables.product.product_location_enterprise %} aktivieren, müssen Sie {% data variables.product.product_location_enterprise %} mit {% data variables.product.prodname_dotcom_the_website %} verbinden. Weitere Informationen finden Sie unter „[{% data variables.product.prodname_ghe_server %} mit {% data variables.product.prodname_ghe_cloud %} verbinden](/enterprise/{{ currentVersion }}/admin/guides/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)“. - -{% if currentVersion ver_gt "enterprise-server@2.20" %} We recommend configuring security alerts without notifications for the first few days to avoid an overload of emails. After a few days, you can enable notifications to receive security alerts as usual.{% endif %} - -{% data reusables.enterprise_site_admin_settings.sign-in %} -2. Aktivieren Sie in der Verwaltungsshell die Sicherheitsmeldungen für angreifbare Abhängigkeiten auf {% data variables.product.product_location_enterprise %}: - ``` shell -$ ghe-dep-graph-enable -``` -3. Kehren Sie zu {% data variables.product.prodname_ghe_server %} zurück. -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %}{% if currentVersion ver_gt "enterprise-server@2.20" %} -5. Under "Repositories can be scanned for vulnerabilities", use the drop-down menu and select **Enabled without notifications**. Optionally, to enable alerts with notifications, select **Enabled with notifications**.{% else %} -5. Verwenden Sie unter „Repositories can be scanned for vulnerabilities“ (Repositorys können auf Schwachstellen überprüft werden) das Dropdownmenü, und wählen Sie **Enabled** (Aktiviert) aus. -{% endif %} - ![Dropdownmenü zum Aktivieren der Überprüfung von Repositorys auf Schwachstellen](/assets/images/enterprise/site-admin-settings/enable-vulnerability-scanning-in-repositories.png) - -### Angreifbare Abhängigkeiten auf {% data variables.product.prodname_ghe_server %} anzeigen - -Sie können alle Schwachstellen in {% data variables.product.product_location_enterprise %} anzeigen und Schwachstellendaten von {% data variables.product.prodname_dotcom_the_website %} manuell synchronisieren, um die Liste zu aktualisieren. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -2. Klicken Sie auf der linken Seitenleiste auf **Vulnerabilities** (Schwachstellen). ![Registerkarte „Vulnerabilities“ (Schwachstellen) auf der Seitenleiste für Websiteadministratoren](/assets/images/enterprise/business-accounts/vulnerabilities-tab.png) -3. Klicken Sie zum Synchronisieren von Schwachstellendaten auf **Sync Vulnerabilities now** (Schwachstellen jetzt synchronisieren). ![Schaltfläche „Sync vulnerabilities now“ (Schwachstellen jetzt synchronisieren)](/assets/images/enterprise/site-admin-settings/sync-vulnerabilities-button.png) diff --git a/translations/de-DE/content/admin/developer-workflow/about-pre-receive-hooks.md b/translations/de-DE/content/admin/developer-workflow/about-pre-receive-hooks.md deleted file mode 100644 index c9d00e335915..000000000000 --- a/translations/de-DE/content/admin/developer-workflow/about-pre-receive-hooks.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: Informationen zu Pre-Receive-Hooks -intro: '*Pre-Receive-Hooks* sind Skripts, die auf der {% data variables.product.prodname_ghe_server %}-Appliance ausgeführt werden, die Sie zum Implementieren von Qualitätsprüfungen verwenden können.' -redirect_from: - - /enterprise/admin/developer-workflow/about-pre-receive-hooks -versions: - enterprise-server: '*' ---- - -Wenn ein Push vorgenommen wird, wird jedes Skript in einer isolierten Umgebung ausgeführt und kann den Inhalt der Pushs überprüfen. Die Skripts sorgen dafür, dass der Push bei dem Beendigungsstatus 0 akzeptiert und bei einem Beendigungsstatus ungleich 0 abgelehnt wird. - -### Nutzungsszenarien -Verwenden Sie Pre-Receive-Hooks, um Geschäftsregeln zu erfüllen, Regelüberwachungen durchzusetzen und bestimmte allgemeine Fehler zu verhindern. - -Beispiele zur möglichen Verwendungsweise von Pre-Receive-Hooks: - -- Legen Sie fest, dass Commit-Mitteilungen einem bestimmtem Muster oder Format folgen, also dass sie beispielsweise eine gültige Ticketnummer enthalten oder eine bestimmte Länge aufweisen. -- Sperren Sie einen Branch oder ein Repository, indem Sie alle Push-Vorgänge ablehnen. -- Verhindern Sie, dass dem Repository sensible Daten hinzugefügt werden, indem Sie Stichwörter, Muster oder Dateitypen blockieren. -- Verhindern Sie, dass der Autor eines privaten Repositorys seine eigenen Änderungen mergen kann. - -### Auswirkung auf die Leistung und Workflows -Die Auswirkung auf Entwickler und auf deren Workflows kann erheblich sein und muss sorgsam durchdacht werden. Von Pre-Receive-Hooks, die auf Geschäftsanforderungen basieren und durchdacht implementiert werden, kann die Organisation als Ganzes am meisten profitieren. - -Pre-Receive-Hooks können unerwünschte Auswirkungen auf die Leistung von {% data variables.product.product_location_enterprise %} haben und sollten sorgsam implementiert und überprüft werden. diff --git a/translations/de-DE/content/admin/developer-workflow/about-protected-branches-and-required-status-checks.md b/translations/de-DE/content/admin/developer-workflow/about-protected-branches-and-required-status-checks.md deleted file mode 100644 index babf01470156..000000000000 --- a/translations/de-DE/content/admin/developer-workflow/about-protected-branches-and-required-status-checks.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Informationen zu geschützten Branches und erforderlichen Statuschecks -intro: 'Mit geschützten Branches wird sichergestellt, dass Mitarbeiter an einem Repository keine unwiderruflichen Änderungen an Branches vornehmen. Mithilfe von erforderlichen Statuschecks wird sichergestellt, dass alle erforderlichen CI-Tests bestanden werden, bevor Mitarbeiter Änderungen an einem geschützten Branch vornehmen können. Branches in Repositorys, die Organisationen gehören, können so konfiguriert werden, dass nur bestimmte Benutzer{% if currentVersion ver_gt "enterprise-server@2.18" %}{% else %} oder{% endif %} Teams{% if currentVersion ver_gt "enterprise-server@2.18" %} oder Apps{% endif %} Pushes an den Branch durchführen können.' -redirect_from: - - /enterprise/admin/developer-workflow/about-protected-branches-and-required-status-checks -versions: - enterprise-server: '*' ---- - -*Geschützte Branches* blockieren verschiedene Git-Features auf einem Branch, dessen Schutz ein Repository-Administrator ausgewählt hat. Ein geschützter Branch kann nicht - -* per Push-Vorgang zwangsweise übertragen werden, -* gelöscht werden, -* mit Änderungen gemergt werden, bis die [erforderlichen Statuschecks](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/configuring-protected-branches-and-required-status-checks#enabling-required-status-checks) bestanden sind. - -Personen mit Administratorberechtigungen für ein Repository sind immer in der Lage, einen Push-Vorgang für einen geschützten Branch durchzuführen. Wenn Sie *Branch-Einschränkungen* aktivieren, können nur bestimmte Benutzer{% if currentVersion ver_gt "enterprise-server@2.18" %}{% else %} oder{% endif %} Teams{% if currentVersion ver_gt "enterprise-server@2.18" %} oder Apps{% endif %} mit einer entsprechenden Berechtigung Pushes an den geschützten Branch durchführen. Weitere Informationen finden Sie unter „[Geschützte Branches und erforderliche Statuschecks konfigurieren](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/configuring-protected-branches-and-required-status-checks)“. - -![Eingeschränkte Branchberechtigungen](/assets/images/help/repository/restrict-branch-users.png). - -{% tip %} - -**Hinweis:** Wenn „Include administrators“ (Administratoren einbeziehen) aktiviert ist und Sie die [erforderlichen Statuschecks](/articles/enabling-required-status-checks) für den Branch aktiviert haben und diese fehlschlagen, schlägt auch jeder Versuch, Änderungen an den geschützten Branch zu pushen, fehl, selbst für Benutzer{% if currentVersion ver_gt "enterprise-server@2.18" %} und Apps{% endif %} mit Administratorberechtigungen. - -{% endtip %} diff --git a/translations/de-DE/content/admin/developer-workflow/blocking-force-pushes-on-your-appliance.md b/translations/de-DE/content/admin/developer-workflow/blocking-force-pushes-on-your-appliance.md deleted file mode 100644 index 4cc1f6ce8414..000000000000 --- a/translations/de-DE/content/admin/developer-workflow/blocking-force-pushes-on-your-appliance.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: Erzwungene Push-Vorgänge auf Ihrer Appliance blockieren -redirect_from: - - /enterprise/admin/articles/blocking-force-pushes-on-your-appliance/ - - /enterprise/admin/developer-workflow/blocking-force-pushes-on-your-appliance -intro: 'Websiteadministratoren können alle erzwungenen Push-Vorgänge („git push --force“) auf einer {% data variables.product.prodname_ghe_server %}-Appliance blockieren.' -versions: - enterprise-server: '*' ---- - -Jedes Repository übernimmt eine standardmäßige Einstellung für erzwungene Push-Vorgänge des Benutzerkontos oder der Organisation, zu dem bzw. zu der es gehört. Entsprechend übernimmt jede Organisation und jedes Benutzerkonto eine standardmäßige Einstellung für erzwungene Push-Vorgänge aus der Einstellung für erzwungene Push-Vorgänge für die gesamte Appliance. Wenn Sie die Einstellung für erzwungene Push-Vorgänge für die Appliance ändern, wird sie für alle Repositorys für jeden Benutzer in der Organisation geändert. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -4. Verwenden Sie unter „Force pushes“ (Erzwungene Push-Vorgänge) das Dropdownmenü, und klicken Sie auf **Allow** (Zulassen), **Block** (Blockieren) oder **Block to the default branch** (Übertragungen an Standardbranch blockieren). ![Dropdownmenü „Force pushes“ (Erzwungene Push-Vorgänge)](/assets/images/enterprise/site-admin-settings/force-pushes-dropdown.png) -5. Wählen Sie optional **Enforce on all repositories** (Auf allen Repositorys erzwungen) aus, wodurch die Einstellungen für erzwungene Push-Vorgänge auf Organisations- und Repository-Ebene überschrieben werden. - -### Weiterführende Informationen - -- „[Erzwungene Push-Vorgänge an Repositorys blockieren, die einem Benutzerkonto oder einer Organisation gehören](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization)“ -- „[Erzwungene Push-Vorgänge an ein Repository blockieren](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository)“ diff --git a/translations/de-DE/content/admin/developer-workflow/blocking-force-pushes-to-a-repository.md b/translations/de-DE/content/admin/developer-workflow/blocking-force-pushes-to-a-repository.md deleted file mode 100644 index 05fe537b6157..000000000000 --- a/translations/de-DE/content/admin/developer-workflow/blocking-force-pushes-to-a-repository.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Erzwungene Push-Vorgänge an ein Repository blockieren -redirect_from: - - /enterprise/admin/articles/blocking-force-pushes-to-a-repository/ - - /enterprise/admin/articles/block-force-pushes/ - - /enterprise/admin/developer-workflow/blocking-force-pushes-to-a-repository -intro: Sie können erzwungene Push-Vorgänge („git push --force“) auf allen Branches – oder einfach an den Standardbranch – eines Repositorys blockieren. -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_site_admin_settings.override-policy %} - -{% data reusables.enterprise_site_admin_settings.sign-in %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -4. Wählen Sie **Block** (Blockieren) oder **Block to the default branch** (Übertragung an Standardbranch blockieren) unter **Push and Pull** (Übertragen und abrufen) aus. ![Erzwungene Push-Vorgänge blockieren](/assets/images/enterprise/site-admin-settings/repo/repo-block-force-pushes.png) - -Die Änderung wird sofort wirksam. Wenn Sie Ihre Meinung später ändern, können Sie erzwungene Push-Vorgänge ohne Weiteres wieder zulassen. - -## Weiterführende Informationen - -- „[Erzwungene Push-Vorgänge an Repositorys blockieren, die einem Benutzerkonto oder einer Organisation gehören](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization)“ -- „[Erzwungene Push-Vorgänge an Ihre Appliance blockieren](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-on-your-appliance)“ diff --git a/translations/de-DE/content/admin/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization.md b/translations/de-DE/content/admin/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization.md deleted file mode 100644 index db59e76a88f3..000000000000 --- a/translations/de-DE/content/admin/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: 'Erzwungene Push-Vorgänge an Repositorys blockieren, die einem Benutzerkonto oder einer Organisation gehören' -redirect_from: - - /enterprise/admin/articles/blocking-force-pushes-for-a-user-account/ - - /enterprise/admin/articles/blocking-force-pushes-for-an-organization/ - - /enterprise/admin/articles/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization/ - - /enterprise/admin/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization -intro: 'Sie können erzwungene Push-Vorgänge („git push --force“) auf allen Branches oder einfach an den Standardbranch der Repositorys blockieren, die einem Benutzerkonto oder einer Organisation gehören.' -versions: - enterprise-server: '*' ---- - -Repositorys übernehmen die Einstellungen für erzwungene Push-Vorgänge vom Benutzerkonto oder von der Organisation, zu dem bzw. zu der sie gehören. Benutzerkonten und Organisationen übernehmen wiederum die Einstellungen für erzwungene Push-Vorgänge von den Einstellungen für erzwungene Push-Vorgänge der gesamten Appliance. - -Sie können die standardmäßig übernommenen Einstellungen überschreiben, indem Sie die Einstellungen für ein Benutzerkonto oder für eine Organisation konfigurieren. - -{% data reusables.enterprise_site_admin_settings.sign-in %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.search-user-or-org %} -{% data reusables.enterprise_site_admin_settings.click-user-or-org %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -5. Wählen Sie unter „Repository default settings“ (Repository-Standardeinstellungen) im Abschnitt in the „Force pushes“ (Erzwungene Push-Vorgänge) Folgendes aus: - - **Block** (Blockieren), um alle erzwungenen Push-Vorgänge an alle Branches zu blockieren. - - **Block to the default branch** (Übertragung an den Standardbranch blockieren), damit die an den Standardbranch übertragenen erzwungenen Push-Vorgänge blockiert werden. ![Erzwungene Push-Vorgänge blockieren](/assets/images/enterprise/site-admin-settings/user/user-block-force-pushes.png) -6. Wählen Sie optional **Enforce on all repositories** (Auf allen Repositorys erzwingen) aus, um Repository-spezifische Einstellungen zu überschreiben. Appliance-weite Richtlinien werden dadurch **nicht** überschrieben. ![Erzwungene Push-Vorgänge blockieren](/assets/images/enterprise/site-admin-settings/user/user-block-all-force-pushes.png) Die Änderung wird sofort wirksam. Wenn Sie Ihre Meinung ändern, können Sie erzwungene Push-Vorgänge wieder zulassen. - -### Weiterführende Informationen - -- „[Erzwungene Push-Vorgänge an ein Repository blockieren](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository)“ -- „[Erzwungene Push-Vorgänge an Ihre Appliance blockieren](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-on-your-appliance)“ diff --git a/translations/de-DE/content/admin/developer-workflow/blocking-force-pushes.md b/translations/de-DE/content/admin/developer-workflow/blocking-force-pushes.md deleted file mode 100644 index 2e9ea2659321..000000000000 --- a/translations/de-DE/content/admin/developer-workflow/blocking-force-pushes.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Erzwungene Push-Vorgänge blockieren -intro: 'Sie können erzwungene Push-Vorgänge auf allen Repositorys auf der {% data variables.product.prodname_ghe_server %}-Appliance, auf allen Repositorys einer Organisation oder auf einem bestimmten Repository blockieren.' -mapTopic: true -redirect_from: - - /enterprise/admin/developer-workflow/blocking-force-pushes -versions: - enterprise-server: '*' ---- - diff --git a/translations/de-DE/content/admin/developer-workflow/configuring-protected-branches-and-required-status-checks.md b/translations/de-DE/content/admin/developer-workflow/configuring-protected-branches-and-required-status-checks.md deleted file mode 100644 index 9d4f52ae6a55..000000000000 --- a/translations/de-DE/content/admin/developer-workflow/configuring-protected-branches-and-required-status-checks.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: Geschützte Branches und erforderliche Statuschecks konfigurieren -intro: 'Sie können zum Begrenzen von Branch-Änderungen geschützte Branches aktivieren und erforderliche Statuschecks erzwingen, bevor ein Branch in einem Pull Request gemergt wird oder bevor Commits auf einem lokalen Branch per Push-Vorgang an den geschützten Remote-Branch übertragen werden können.' -redirect_from: - - /enterprise/admin/developer-workflow/configuring-protected-branches-and-required-status-checks -versions: - enterprise-server: '*' ---- - -Jeder, der über Administratorberechtigungen für ein Repository verfügt, kann Branch-Einschränkungen aktivieren. - -### Geschützten Branch für ein Repository aktivieren - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -{% data reusables.repositories.repository-branches %} -{% data reusables.repositories.add-branch-protection-rules %} -5. Klicke auf **Create** (Erstellen). - -### Arten von erforderlichen Statuschecks - -| Art des erforderlichen Statuschecks | Einstellung | Merge-Anforderungen | Hinweise | -| ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **Streng** | Das Kontrollkästchen **Require branches to be up-to-date before merging** (Aktualität der Branches vor dem Mergen erzwingen) ist aktiviert. | Der Branch **muss** vor dem Mergen auf dem Stand des Basis-Branches sein. | Dies ist das Standardverhalten für erforderliche Statuschecks. Weitere Builds können erforderlich sein, da Sie den Head-Branch auf den neuesten Stand bringen müssen, nachdem andere Mitarbeiter Pull Requests in den geschützten Basis-Branch gemergt haben. | -| **Locker** | Das Kontrollkästchen **Require branches to be up-to-date before merging** (Aktualität der Branches vor dem Mergen erzwingen) ist **nicht** aktiviert. | Der Branch muss vor dem Mergen **nicht** auf dem Stand des Basis-Branches sein. | Es sind weniger Builds erforderlich, da Sie den Head-Branch nicht auf den neuesten Stand bringen müssen, nachdem andere Mitarbeiter Pull Requests gemergt haben. Statuschecks schlagen nach dem Mergen Ihres Branches möglicherweise fehl, wenn inkompatible Änderungen am Basis-Branch vorliegen. | -| **Deaktiviert** | Das Kontrollkästchen **Require status checks to pass before merging** (Statuschecks müssen vor dem Mergen bestanden werden) ist **deaktiviert**. | Für den Branch gelten keine Merge-Einschränkungen. | Wenn die erforderlichen Statuschecks nicht aktiviert sind, können Mitarbeiter den Branch unabhängig von seinem Stand gegenüber dem Basis-Branch jederzeit mergen. Die Wahrscheinlich inkompatibler Änderungen erhöht sich dadurch jedoch. | - -### Erforderliche Statuschecks aktivieren - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -{% data reusables.repositories.repository-branches %} -{% data reusables.repositories.add-branch-protection-rules %} -5. Aktivieren Sie **Require status checks to pass before merging** (Statuschecks müssen vor dem Mergen bestanden werden). ![Option für erforderliche Statuschecks](/assets/images/help/repository/required-status-checks.png) -6. Wählen Sie in der Liste der verfügbaren Statuschecks die Checks aus, die als erforderlich festgelegt werden sollen. ![Liste der verfügbaren Statuschecks](/assets/images/help/repository/required-statuses-list.png) -{% data reusables.repositories.include-administrators %} -8. Deaktivieren Sie optional **Require branches to be up to date before merging** (Erzwingen, dass Branches vor dem Mergen aktuell sein müssen). Wenn diese Option ausgewählt ist, wird der Branch mit dem neuesten Code auf dem Basis-Branch getestet. ![Kontrollkästchen für lockere oder strenge erforderliche Statuschecks](/assets/images/help/repository/protecting-branch-loose-status-new.png) -9. Optional wählst Du {% if currentVersion ver_gt "enterprise-server@2.18" %}**Beschränken, wer per Push in die passenden Zweige übertragen kann**{% else %}**Beschränken, wer per Push in diesen Zweig übertragen kann**{% endif %}. ![Branch restriction checkbox]{% if currentVersion ver_gt "enterprise-server@2.18" %}(/assets/images/help/repository/restrict-branch.png){% else %}(/assets/images/help/repository/restrict-branch-push.png){% endif %} -10. Suche und wähle Personen{% if currentVersion ver_gt "enterprise-server@2.18" %},{% else %} oder{% endif %} Teams{% if currentVersion ver_gt "enterprise-server@2.18" %} oder Apps{% endif %} aus, welche berechtigt sind, per Push in geschützte Branches zu übertragen. ![Suche für die Branch-Einschränkung](/assets/images/help/repository/restrict-branch-search.png) -11. Klicke auf **Create** (Erstellen). - -{% data reusables.repositories.required-status-merge-tip %} diff --git a/translations/de-DE/content/admin/developer-workflow/continuous-integration-using-jenkins.md b/translations/de-DE/content/admin/developer-workflow/continuous-integration-using-jenkins.md deleted file mode 100644 index 2100423f8021..000000000000 --- a/translations/de-DE/content/admin/developer-workflow/continuous-integration-using-jenkins.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: Fortlaufende Integration mit Jenkins -intro: 'Sie können Build-Aufträge auf einem Jenkins-Server automatisch auslösen, wenn Push-Vorgänge an ein Repository in {% data variables.product.product_location_enterprise %} übertragen werden.' -redirect_from: - - /enterprise/admin/developer-workflow/continuous-integration-using-jenkins -versions: - enterprise-server: '*' ---- - -### Anforderungen - -- Lesen Sie unser Whitepaper „[Practical guide to CI with Jenkins and GitHub (Praktische Anleitung zur fortlaufenden Integration mit Jenkins und GitHub)](https://resources.github.com/whitepapers/practical-guide-to-CI-with-Jenkins-and-GitHub/)“, um schrittweise Anleitungen dahingehend zu erhalten, wie Sie Build-Aufträge auf einem Jenkins-Server automatisch auslösen können, wenn Push-Vorgänge an ein Repository in {% data variables.product.product_location_enterprise %} übertragen werden. diff --git a/translations/de-DE/content/admin/developer-workflow/creating-a-pre-receive-hook-environment.md b/translations/de-DE/content/admin/developer-workflow/creating-a-pre-receive-hook-environment.md deleted file mode 100644 index b6f26267d045..000000000000 --- a/translations/de-DE/content/admin/developer-workflow/creating-a-pre-receive-hook-environment.md +++ /dev/null @@ -1,135 +0,0 @@ ---- -title: Pre-Receive-Hooks-Umgebung erstellen -intro: 'Verwenden Sie zum Ausführen von Pre-Receive-Hooks die standardmäßige Pre-Receive-Umgebung, oder erstellen Sie eine benutzerdefinierte Umgebung.' -redirect_from: - - /enterprise/admin/developer-workflow/creating-a-pre-receive-hook-environment -versions: - enterprise-server: '*' ---- - -Eine Pre-Receive-Umgebung für {% data variables.product.prodname_ghe_server %} ist eine Linux-chroot    -Umgebung. Da Pre-Receive-Hooks bei jedem Push-Ereignis ausgeführt werden, sollten sie schnell und kompakt sein. Die für solche Überprüfungen benötigte Umgebung ist in der Regel minimal.

    - -{% data variables.product.prodname_ghe_server %} bietet eine Standardumgebung. Diese enthält die folgenden Pakete: `awk`, `bash`, `coreutils`, `curl`, `find`, `gnupg`, `grep`, `jq`, `sed`. - -Wenn eine bestimmte Anforderung vorliegt, die von dieser Umgebung nicht erfüllt wird, beispielsweise die Unterstützung einer bestimmten Sprache, können Sie Ihre eigene 64-Bit-Linux-`chroot`-Umgebung erstellen und hochladen. - - - -### Pre-Receive-Hook-Umgebung mit Docker erstellen - -Sie können ein Linux-Containerverwaltungstool zum Erstellen einer Pre-Receive-Hook-Umgebung verwenden. In diesem Beispiel werden [Alpine Linux](http://www.alpinelinux.org/) und [Docker](https://www.docker.com/) verwendet. - -{% data reusables.linux.ensure-docker %} - -2. Erstellen Sie die Datei `Dockerfile.alpine-3.3`, welche die folgenden Informationen enthält: - - - - ``` - FROM gliderlabs/alpine:3.3 - RUN apk add --no-cache git bash - ``` - - -3. Erstellen Sie im Verzeichnis, in dem die `Dockerfile.alpine-3.3` enthalten ist, ein Image: - - - - ```shell - $ docker build -f Dockerfile.alpine-3.3 -t pre-receive.alpine-3.3 . - > Sending build context to Docker daemon 12.29 kB - > Step 1 : FROM gliderlabs/alpine:3.3 - > ---> 8944964f99f4 - > Step 2 : RUN apk add --no-cache git bash - > ---> Using cache - > ---> 0250ab3be9c5 - > Successfully built 0250ab3be9c5 - ``` - - -4. Erstellen Sie einen Container: - - - - ```shell - $ docker create --name pre-receive.alpine-3.3 pre-receive.alpine-3.3 /bin/true - ``` - - -5. Exportieren Sie den Docker-Container in eine `gzip`-komprimierte `TAR`-Datei: - - - - ```shell - $ docker export pre-receive.alpine-3.3 | gzip > alpine-3.3.tar.gz - ``` - - -Diese Datei `alpine-3.3.tar.gz` kann auf die Appliance {% data variables.product.prodname_ghe_server %} hochgeladen werden. - - - -### Pre-Receive-Hook-Umgebung mit chroot erstellen - -1. Erstellen Sie eine Linux-`chroot`-Umgebung. -2. Erstellen Sie eine `gzip`-komprimierte `TAR`-Datei des Verzeichnisses `chroot`. - - - ```shell - $ cd /path/to/chroot - $ tar -czf /path/to/pre-receive-environment.tar.gz . - ``` - - -{% note %} - -**Hinweise:** - - - Schließe keine führenden Verzeichnispfade von Dateien innerhalb des tar-Archivs ein, wie beispielsweise `/path/to/chroot`. - - `/bin/sh` muss existieren und als Einstiegspunkt in die chroot-Umgebung ausführbar sein. - - Im Gegensatz zu herkömmlichen Chroots ist das Verzeichnis `dev` für Vorempfang-Hooks nicht erforderlich. -{% endnote %} - -Weitere Informationen zum Erstellen einer chroot-Umgebung finden Sie unter „[Chroot](https://wiki.debian.org/chroot)“ aus dem *Debian-Wiki*, „[BasicChroot](https://help.ubuntu.com/community/BasicChroot)“ aus dem *Hilfe-Wiki der Ubuntu-Community* oder „[Installing Alpine Linux in a chroot (Alpine Linux in einem chroot installieren](http://wiki.alpinelinux.org/wiki/Installing_Alpine_Linux_in_a_chroot)“ aus dem *Alpine Linux-Wiki*. - - - -### Pre-Receive-Hook-Umgebung auf {% data variables.product.prodname_ghe_server %} hochladen - -{% data reusables.enterprise_site_admin_settings.access-settings %} - - - -{% data reusables.enterprise_site_admin_settings.business %} - - - -{% data reusables.enterprise-accounts.settings-tab %} - - - -{% data reusables.enterprise-accounts.hooks-tab %} - -5. Klicken Sie auf **Manage environments** (Umgebungen verwalten). ![Umgebungen verwalten](/assets/images/enterprise/site-admin-settings/manage-pre-receive-environments.png) - -6. Klicken Sie auf **Add environment** (Umgebung hinzufügen). ![Add Environment (Umgebung hinzufügen)](/assets/images/enterprise/site-admin-settings/add-pre-receive-environment.png) - -7. Geben Sie den gewünschten Namen in das Feld **Environment name** (Name der Umgebung) ein. ![Environment name (Name der Umgebung)](/assets/images/enterprise/site-admin-settings/pre-receive-environment-name.png) - -8. Geben Sie die URL der `*.tar.gz`-Datei ein, in der Ihre Umgebung enthalten ist. ![Upload environment from a URL (Umgebung über eine URL hochladen)](/assets/images/enterprise/site-admin-settings/upload-environment-from-url.png) - -9. Klicken Sie auf **Add environment** (Umgebung hinzufügen). ![Schaltfläche „Add environment“ (Umgebung hinzufügen)](/assets/images/enterprise/site-admin-settings/add-environment-button.png) - - - -### Pre-Receive-Hook-Umgebung über die Verwaltungsshell hochladen - -1. Laden Sie eine lesbare `*.tar.gz`-Datei, die Ihre Umgebung enthält, auf einen Webhost hoch, und kopieren Sie die URL, oder übertragen Sie die Datei über `scp` an die {% data variables.product.prodname_ghe_server %}-Appliance. Wenn Sie `scp` verwenden, müssen Sie die `*.tar.gz`-Dateiberechtigungen ggf. anpassen, damit die Datei allgemein lesbar ist. -1. Stellen Sie eine Verbindung zur Verwaltungsshell her. -2. Führen Sie den Befehl `ghe-hook-env-create` aus, und geben Sie den gewünschten Namen für die Umgebung als das erste Argument und den vollständigen lokalen Pfad oder die URL einer `*.tar.gz`-Datei, die Ihre Umgebung enthält, als das zweite Argument ein. - - - ```shell - admin@ghe-host:~$ ghe-hook-env-create AlpineTestEnv /home/admin/alpine-3.3.tar.gz - > Pre-receive hook environment 'AlpineTestEnv' (2) has been created. - ``` diff --git a/translations/de-DE/content/admin/developer-workflow/creating-a-pre-receive-hook-script.md b/translations/de-DE/content/admin/developer-workflow/creating-a-pre-receive-hook-script.md deleted file mode 100644 index 2fac5e0135f1..000000000000 --- a/translations/de-DE/content/admin/developer-workflow/creating-a-pre-receive-hook-script.md +++ /dev/null @@ -1,199 +0,0 @@ ---- -title: Pre-Receive-Hook-Skript erstellen -intro: 'Verwenden Sie Pre-Receive-Hook-Skripts, um Anforderungen zum Akzeptieren oder Ablehnen eines Push-Vorgangs anhand der Inhalte zu erstellen.' -redirect_from: - - /enterprise/admin/developer-workflow/creating-a-pre-receive-hook-script -versions: - enterprise-server: '*' ---- - -Im [`github/platform-samples`-Repository](https://github.com/github/platform-samples/tree/master/pre-receive-hooks) finden Sie Beispiele von Pre-Receive-Hooks für {% data variables.product.prodname_ghe_server %}. - -### Pre-Receive-Hook-Skript schreiben -Ein Pre-Receive-Hook-Skript wird auf der {% data variables.product.prodname_ghe_server %}-Appliance in einer Pre-Receive-Hook-Umgebung ausgeführt. Beachten Sie beim Erstellen eines Pre-Receive-Hook-Skripts die verfügbaren Variablen „input“, „output“, „exit-status“ und Umgebungsvariablen. - -#### Input (stdin) -Nach einem Push und vor der Aktualisierung der Refs auf dem Remote-Repository ruft der Prozess `git-receive-pack` das Pre-Receive-Hook-Skript mit der Standardeingabe von einer Zeile pro Ref ab, die aktualisiert werden soll. - -` SP SP LF` - -Dieser String steht für die folgenden Argumente: - -| Argument | Beschreibung | -|:------------------- |:--------------------------------------------------------------------------------------------------------------------------- | -| `` | Der alte Objektname, der in `ref` gespeichert ist.
    Wenn Sie einen neuen `ref` *erstellen*, entspricht dieser 40 Nullen. | -| `` | Der neue Objektname, der in `ref` gespeichert werden soll.
    Wenn Sie einen `ref` *löschen*, entspricht dieser 40 Nullen. | -| `` | Der vollständige `ref`-Name. | - -Weitere Informationen zu `git-receive-pack` finden Sie unter „[git-receive-pack](https://git-scm.com/docs/git-receive-pack)“ in der Git-Dokumentation. Weitere Informationen zu `refs` finden Sie unter „[Git-Referenzen](https://git-scm.com/book/en/v2/Git-Internals-Git-References)“ in *Pro Git*. - -#### Output (stdout) - -Die Skriptausgabe (`stdout`) wird an den Client zurückgegeben. Daher sind die `echo`-Anweisungen für Benutzer an der Befehlszeile oder auf der Benutzeroberfläche sichtbar. - -#### Exit-status - -Der `exit-status` eines Pre-Receive-Skripts bestimmt, ob der Push akzeptiert wird. - -| Exit-status-Wert | Aktion | -|:----------------:|:-------------------------:| -| 0 | Der Push wird akzeptiert. | -| ungleich 0 | Der Push wird abgelehnt. | - -#### Umgebungsvariablen -Außerhalb der `stdin` bereitgestellten Werte sind zusätzliche Variablen vorhanden, die für ein Pre-Receive-Hook-Skript verfügbar sind, das auf {% data variables.product.prodname_ghe_server %} ausgeführt wird. - -| Variable | Beschreibung | -|:------------------------------------- |:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| $GITHUB_USER_LOGIN | Die Benutzer-ID, die den `ref` erstellt hat. | -| $GIT_DIR | Der Pfad des Remote-Repositorys auf der Appliance. | -| $GITHUB_USER_IP | Die IP-Adresse des Benutzers, der den Push-Vorgang ausführt. | -| $GITHUB_REPO_NAME | Der Name im Format `owner`/`repo` des Repositorys, das aktualisiert wird. | -| $GITHUB_PULL_REQUEST_AUTHOR_LOGIN | Die Benutzer-ID des Autors eines auf Ihrer Instanz geöffneten Pull Requests. | -| $GITHUB_REPO_PUBLIC | Ein boolescher Wert, der angezeigt wird, wenn `true` für ein öffentliches Repository steht und wenn `false` für ein privates Repository steht. | -| $GITHUB_PUBLIC_KEY_FINGERPRINT | Der öffentliche Schlüssel-Fingerprint des Benutzers. | -| $GITHUB_PULL_REQUEST_HEAD | Ein String im Format `user:branch` für den HEAD des privaten Repositorys.
    Beispiel: `octocat:fix-bug` | -| $GITHUB_PULL_REQUEST_BASE | Ein String im Format: `user:branch` für die BASE des privaten Repositorys.
    Beispiel: `octocat:master` | -| $GITHUB_VIA | Die zum Erstellen des ref-Werts verwendete Methode.
    **Mögliche Werte:**
    - `auto-merge deployment api`
    - `blob edit`
    - `branch merge api`
    - `branches page delete button`
    - `git refs create api`
    - `git refs delete api`
    - `git refs update api`
    - `merge api`
    - `pull request branch delete button`
    - `pull request branch undo button`
    - `pull request merge api`
    - `pull request merge button`
    - `pull request revert button`
    - `releases delete button`
    - `stafftools branch restore`
    - `slumlord (#{sha})` | -| $GIT_PUSH_OPTION_COUNT | Die Anzahl der Push-Optionen, die vom Client gesendet wurden. Weitere Informationen zu den Push-Optionen finden Sie unter „[git-push](https://git-scm.com/docs/git-push#git-push---push-optionltoptiongt)“ in der Git-Dokumentation. | -| $GIT_PUSH_OPTION_N | N entspricht hierbei einer ab 0 beginnenden Ganzzahl. Diese Variable enthält den String der vom Client gesendeten Push-Option. Die erste gesendete Option wird in GIT_PUSH_OPTION_0 gespeichert. Die zweite gesendete Option wird in GIT_PUSH_OPTION_1 gespeichert usw. Weitere Informationen zu den Push-Optionen finden Sie unter „[git-push](https://git-scm.com/docs/git-push#git-push---push-optionltoptiongt)“ in der Git-Dokumentation. | - -### Berechtigungen festlegen und einen Pre-Receive-Hook per Push-Vorgang an {% data variables.product.prodname_ghe_server %} übertragen - -Ein Pre-Receive-Hook-Skript ist in einem Repository auf der {% data variables.product.prodname_ghe_server %}-Appliance enthalten. Ein Websiteadministrator muss die Repository-Berechtigungen beachten und sicherstellen, dass nur die richtigen Benutzer über Zugriff verfügen. - -Es wird empfohlen, Hooks in einem einzelnen Repository zu konsolidieren. Wenn das konsolidierte Hook-Repository öffentlich ist, kann die Datei `README.md` verwendet werden, um die Richtliniendurchsetzungen zu erläutern. Darüber hinaus können Beiträge über Pull Requests akzeptiert werden. Pre-Receive-Hooks können jedoch nur auf dem Standardbranch hinzugefügt werden. Für einen Test-Workflow sollten Forks des Repositorys mit entsprechender Konfiguration verwendet werden. - -1. Stellen Sie für Mac-Benutzer sicher, dass die Skripts über Ausführungsberechtigungen verfügen: - - ```shell - $ sudo chmod +x SCRIPT_FILE.sh - ``` - Stellen Sie für Windows-Benutzer sicher, dass die Skripts über Ausführungsberechtigungen verfügen: - - ```shell - git update-index --chmod=+x SCRIPT_FILE.sh - ``` - -2. Committen und übertragen Sie Ihr vorgesehenes Pre-Receive-Hook-Repository auf der {% data variables.product.prodname_ghe_server %}-Instanz per Push-Vorgang. - - ```shell - $ git commit -m "YOUR COMMIT MESSAGE" - $ git push - ``` - -3. [Erstellen Sie den Pre-Receive-Hook](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance/#creating-pre-receive-hooks) auf der {% data variables.product.prodname_ghe_server %}-Instanz. - -### Pre-Receive-Skripts lokal testen -Sie können ein Pre-Receive-Hook-Skript lokal testen, bevor Sie es auf Ihrer {% data variables.product.prodname_ghe_server %}-Appliance erstellen oder aktualisieren. Eine Methode besteht darin, eine lokale Docker-Umgebung zu erstellen, die als ein Remote-Repository fungiert und als den Pre-Receive-Hook ausführen kann. - -{% data reusables.linux.ensure-docker %} - -2. Erstellen Sie eine Datei namens `Dockerfile.dev`, die Folgendes enthält: - - ``` - FROM gliderlabs/alpine:3.3 - RUN \ - apk add --no-cache git openssh bash && \ - ssh-keygen -A && \ - sed -i "s/#AuthorizedKeysFile/AuthorizedKeysFile/g" /etc/ssh/sshd_config && \ - adduser git -D -G root -h /home/git -s /bin/bash && \ - passwd -d git && \ - su git -c "mkdir /home/git/.ssh && \ - ssh-keygen -t rsa -b 4096 -f /home/git/.ssh/id_rsa -P '' && \ - mv /home/git/.ssh/id_rsa.pub /home/git/.ssh/authorized_keys && \ - mkdir /home/git/test.git && \ - git --bare init /home/git/test.git" - - VOLUME ["/home/git/.ssh", "/home/git/test.git/hooks"] - WORKDIR /home/git - - CMD ["/usr/sbin/sshd", "-D"] - ``` - -3. Erstellen Sie ein Pre-Receive-Testskript namens `always_reject.sh`. Dieses Beispielskript lehnt alle Push-Vorgänge ab, was zum Sperren eines Repositorys nützlich ist: - - ``` - #!/usr/bin/env bash - - echo "error: rejecting all pushes" - exit 1 - ``` - -4. Stellen Sie sicher, dass das Skript `always_reject.sh` über Ausführungsberechtigungen verfügt: - - ```shell - $ chmod +x always_reject.sh - ``` - -5. Erstellen Sie im Verzeichnis, in dem die `Dockerfile.dev` enthalten ist, ein Image: - - ```shell - $ docker build -f Dockerfile.dev -t pre-receive.dev . - > Sending build context to Docker daemon 3.584 kB - > Step 1 : FROM gliderlabs/alpine:3.3 - > ---> 8944964f99f4 - > Step 2 : RUN apk add --no-cache git openssh bash && ssh-keygen -A && sed -i "s/#AuthorizedKeysFile/AuthorizedKeysFile/g" /etc/ssh/sshd_config && adduser git -D -G root -h /home/git -s /bin/bash && passwd -d git && su git -c "mkdir /home/git/.ssh && ssh-keygen -t rsa -b 4096 -f /home/git/.ssh/id_rsa -P ' && mv /home/git/.ssh/id_rsa.pub /home/git/.ssh/authorized_keys && mkdir /home/git/test.git && git --bare init /home/git/test.git" - > ---> Running in e9d79ab3b92c - > fetch http://alpine.gliderlabs.com/alpine/v3.3/main/x86_64/APKINDEX.tar.gz - > fetch http://alpine.gliderlabs.com/alpine/v3.3/community/x86_64/APKINDEX.tar.gz - ....truncated output.... - > OK: 34 MiB in 26 packages - > ssh-keygen: generating new host keys: RSA DSA ECDSA ED25519 - > Password for git changed by root - > Generating public/private rsa key pair. - > Your identification has been saved in /home/git/.ssh/id_rsa. - > Your public key has been saved in /home/git/.ssh/id_rsa.pub. - ....truncated output.... - > Initialized empty Git repository in /home/git/test.git/ - > Successfully built dd8610c24f82 - ``` - -6. Führen Sie einen Datencontainer aus, der einen generierten SSH-Schlüssel enthält: - - ```shell - $ docker run --name data pre-receive.dev /bin/true - ``` - -7. Kopieren Sie den Pre-Receive-Hook `always_reject.sh` in den Datencontainer: - - ```shell - $ docker cp always_reject.sh data:/home/git/test.git/hooks/pre-receive - ``` - -8. Führen Sie einen Anwendungscontainer aus, der `sshd` und den Hook ausführt. Beachten Sie die zurückgegebene Container-ID. - - ```shell - $ docker run -d -p 52311:22 --volumes-from data pre-receive.dev - > 7f888bc700b8d23405dbcaf039e6c71d486793cad7d8ae4dd184f4a47000bc58 - ``` - -9. Kopieren Sie den generierten SSH-Schlüssel aus dem Datencontainer auf den lokalen Computer: - - ```shell - $ docker cp data:/home/git/.ssh/id_rsa . - ``` - -10. Ändern Sie die Remote-Instanz eines Test-Repositorys, und übertragen Sie das Repository `test.git` per Push-Vorgang innerhalb des Docker-Containers. In diesem Beispiel wird `git@github.com:octocat/Hello-World.git` verwendet. Sie können jedoch auch andere Repositorys verwenden. In diesem Beispiel wird davon ausgegangen, dass Ihr lokaler Computer (127.0.0.1) den Port 52311 bindet. Sie können jedoch eine andere IP-Adresse verwenden, wenn Docker auf einem Remote-Computer ausgeführt wird. - - ```shell - $ git clone git@github.com:octocat/Hello-World.git - $ cd Hello-World - $ git remote add test git@127.0.0.1:test.git - $ GIT_SSH_COMMAND="ssh -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no -p 52311 -i ../id_rsa" git push -u test master - > Warning: Permanently added '[192.168.99.100]:52311' (ECDSA) to the list of known hosts. - > Counting objects: 7, done. - > Delta compression using up to 4 threads. - > Compressing objects: 100% (3/3), done. - > Writing objects: 100% (7/7), 700 bytes | 0 bytes/s, done. - > Total 7 (delta 0), reused 7 (delta 0) - > remote: error: rejecting all pushes - > To git@192.168.99.100:test.git - > ! [remote rejected] master -> master (pre-receive hook declined) - > error: failed to push some refs to 'git@192.168.99.100:test.git' - ``` - - Beachten Sie, dass der Push abgelehnt wurde, nachdem Sie den Pre-Receive-Hook ausgeführt und die Ausgabe des Skripts wiedergegeben haben. - -### Weiterführende Informationen - - „[Git anpassen – eine Git-erzwungene Beispielrichtlinie](https://git-scm.com/book/en/v2/Customizing-Git-An-Example-Git-Enforced-Policy)“ von der *Pro Git-Website* diff --git a/translations/de-DE/content/admin/developer-workflow/customizing-your-instance-with-integrations.md b/translations/de-DE/content/admin/developer-workflow/customizing-your-instance-with-integrations.md deleted file mode 100644 index 6d924065d1a2..000000000000 --- a/translations/de-DE/content/admin/developer-workflow/customizing-your-instance-with-integrations.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Instanz mit Integrationen anpassen -intro: 'Sie können Drittanbieteranwendungen in {% data variables.product.product_location_enterprise %} integrieren.' -mapTopic: true -redirect_from: - - /enterprise/admin/developer-workflow/customizing-your-instance-with-integrations -versions: - enterprise-server: '*' ---- - diff --git a/translations/de-DE/content/admin/developer-workflow/establishing-pull-request-merge-conditions.md b/translations/de-DE/content/admin/developer-workflow/establishing-pull-request-merge-conditions.md deleted file mode 100644 index 8fecc452b598..000000000000 --- a/translations/de-DE/content/admin/developer-workflow/establishing-pull-request-merge-conditions.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Bedingungen zum Mergen von Pull Requests erstellen -intro: 'Sie können vorschreiben, dass Pull Requests vor dem Mergen einige Tests bestehen müssen. Sie können beispielsweise Pull Requests blockieren, welche die Statuschecks nicht bestehen.' -mapTopic: true -redirect_from: - - /enterprise/admin/developer-workflow/establishing-pull-request-merge-conditions -versions: - enterprise-server: '*' ---- - diff --git a/translations/de-DE/content/admin/developer-workflow/index.md b/translations/de-DE/content/admin/developer-workflow/index.md deleted file mode 100644 index 552abfbf77eb..000000000000 --- a/translations/de-DE/content/admin/developer-workflow/index.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: Richtlinien erzwingen und den Entwickler-Workflow anpassen -redirect_from: - - /enterprise/admin/guides/installation/integrations/ - - /enterprise/admin/categories/integration/ - - /enterprise/admin/developer-workflow -intro: 'In diesem Leitfaden werden die Tools beschrieben, die auf {% data variables.product.prodname_enterprise %} zum Implementieren eines Entwickler-Workflows und zum Erzwingen von Organisationsrichtlinien verfügbar sind, um das Risiko zu reduzieren und die Qualität zu erhöhen.' -versions: - enterprise-server: '*' ---- - - -### Inhaltsverzeichnis - -{% topic_link_in_list /blocking-force-pushes %} - {% link_in_list /blocking-force-pushes-on-your-appliance %} - {% link_in_list /blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization %} - {% link_in_list /blocking-force-pushes-to-a-repository %} -{% topic_link_in_list /using-webhooks-for-continuous-integration %} - {% link_in_list /continuous-integration-using-jenkins %} - {% link_in_list /troubleshooting-service-hooks %} -{% topic_link_in_list /using-pre-receive-hooks-to-enforce-policy %} - {% link_in_list /about-pre-receive-hooks %} - {% link_in_list /creating-a-pre-receive-hook-environment %} - {% link_in_list /creating-a-pre-receive-hook-script %} - {% link_in_list /managing-pre-receive-hooks-on-the-github-enterprise-server-appliance %} -{% topic_link_in_list /establishing-pull-request-merge-conditions %} - {% link_in_list /about-protected-branches-and-required-status-checks %} - {% link_in_list /configuring-protected-branches-and-required-status-checks %} -{% topic_link_in_list /customizing-your-instance-with-integrations %} - {% link_in_list /managing-projects-using-jira %} diff --git a/translations/de-DE/content/admin/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance.md b/translations/de-DE/content/admin/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance.md deleted file mode 100644 index 9b98ea7c287a..000000000000 --- a/translations/de-DE/content/admin/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance.md +++ /dev/null @@ -1,59 +0,0 @@ ---- -title: Pre-Receive-Hooks auf der GitHub Enterprise Server-Appliance verwalten -intro: 'Konfigurieren Sie, wie Personen Pre-Receive-Hooks in ihrer {% data variables.product.prodname_ghe_server %}-Appliance verwenden.' -redirect_from: - - /enterprise/admin/guides/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-appliance/ - - /enterprise/admin/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance -versions: - enterprise-server: '*' ---- - -### Pre-Receive-Hooks erstellen - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.hooks-tab %} -4. Klicken Sie auf **Add pre-receive hook** (Pre-Receive-Hook hinzufügen). ![„Add pre-receive hook“ (Pre-Receive-Hook hinzufügen)](/assets/images/enterprise/site-admin-settings/add-pre-receive-hook.png) -5. Geben Sie im Feld **Hook name** (Hook-Name) den Namen des Hooks ein, den Sie erstellen möchten. ![Pre-Receive-Hook benennen](/assets/images/enterprise/site-admin-settings/hook-name.png) -6. Wählen Sie im Dropdownmenü **Environment** (Umgebung) die Umgebung aus, in welcher der Hook ausgeführt werden soll. ![Hook-Umgebung](/assets/images/enterprise/site-admin-settings/environment.png) -7. Wählen Sie im Dropdownmenü **Select hook repository** (Hook-Repository auswählen) unter **Script** (Skript) das Repository aus, in dem Ihr Pre-Receive-Hook-Skript enthalten ist. Wählen Sie im Dropdownmenü **Select file** (Datei auswählen) den Dateinamen des Pre-Receive-Hook-Skripts aus. ![Hook-Skript](/assets/images/enterprise/site-admin-settings/hook-script.png) -8. Wählen Sie **Use the exit-status to accept or reject pushes** (Exit-Status zum Akzeptieren oder Ablehnen von Push-Vorgängen verwenden) aus, um Ihr Skript zu erzwingen. Wenn Sie diese Option deaktivieren, können Sie das Skript testen, wobei der Exit-Status-Wert ignoriert wird. In diesem Modus kann der Benutzer die Skriptausgabe an der Befehlszeile, nicht aber auf der Benutzeroberfläche anzeigen. ![Exit-Status verwenden](/assets/images/enterprise/site-admin-settings/use-exit-status.png) -9. Wählen Sie **Enable this pre-receive hook on all repositories by default** (Diesen Pre-Receive-Hook standardmäßig auf allen Repositorys aktivieren) aus, wenn der Pre-Receive-Hook auf allen Repositorys ausgeführt werden soll. ![Option zum Aktivieren des Hooks auf allen Repositorys](/assets/images/enterprise/site-admin-settings/enable-hook-all-repos.png) -10. Wählen Sie **Administrators can enable and disable this hook** (Administratoren können diesen Hook aktivieren und deaktivieren) aus, damit Organisationsmitglieder mit Administrator- oder Inhaberberechtigungen diesen Pre-Receive-Hook aktivieren oder deaktivieren können. ![Option zum Aktivieren oder Deaktivieren des Hooks durch Administratoren](/assets/images/enterprise/site-admin-settings/admins-enable-hook.png) - -### Pre-Receive-Hooks bearbeiten - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.hooks-tab %} -1. Klicken Sie neben dem Pre-Receive-Hook, den Sie bearbeiten möchten, auf {% octicon "pencil" aria-label="The edit icon" %}.![Pre-Receive bearbeiten](/assets/images/enterprise/site-admin-settings/edit-pre-receive-hook.png) - -### Pre-Receive-Hooks löschen - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.hooks-tab %} -2. Klicken Sie neben dem Pre-Receive-Hook, den Sie löschen möchten, auf {% octicon "x" aria-label="X symbol" %}.![Pre-Receive bearbeiten](/assets/images/enterprise/site-admin-settings/delete-pre-receive-hook.png) - -### Pre-Receive-Hooks für eine Organisation konfigurieren - -Ein Organisationsadministrator kann die Hook-Berechtigungen nur dann für eine Organisation konfigurieren, wenn der Websiteadministrator bei der Erstellung des Pre-Receive-Hooks die Option **Administrators can enable or disable this hook** (Administratoren können diesen Hook aktivieren oder deaktivieren) ausgewählt hat. Zum Konfigurieren von Pre-Receive-Hooks für ein Repository müssen Sie ein Organisationsadministrator oder -inhaber sein. - -{% data reusables.profile.enterprise_access_profile %} -{% data reusables.profile.access_org %} -{% data reusables.organizations.org_settings %} -4. Klicken Sie auf der linken Seitenleiste auf **Hooks**. ![Hooks-Seitenleiste](/assets/images/enterprise/orgs-and-teams/hooks-sidebar.png) -5. Klicken Sie neben dem Pre-Receive-Hook, den Sie konfigurieren möchten, auf das Dropdownmenü **Hook permissions** (Hook-Berechtigungen). Wählen Sie aus, ob der Pre-Receive-Hook aktiviert oder deaktiviert werden soll, oder legen Sie fest, dass er vom Repository-Administrator konfiguriert werden kann. ![„Hook permissions“ (Hook-Berechtigungen)](/assets/images/enterprise/orgs-and-teams/hook-permissions.png) - -### Pre-Receive-Hooks für ein Repository konfigurieren - -Ein Repository-Inhaber kann einen Hook nur dann konfigurieren, wenn der Websiteadministrator bei der Erstellung des Pre-Receive-Hooks die Option **Administrators can enable or disable this hook** (Administratoren können diesen Hook aktivieren oder deaktivieren) ausgewählt hat. In einer Organisation muss der Organisationsinhaber zudem die Hook-Berechtigung **Configurable** (Konfigurierbar) ausgewählt haben. Zum Konfigurieren von Pre-Receive-Hooks für ein Repository müssen Sie ein Repository-Inhaber sein. - -{% data reusables.profile.enterprise_access_profile %} -2. Klicken Sie auf **Repositories** (Repositorys), und wählen Sie aus, für welches Repository Sie die Pre-Receive-Hooks konfigurieren möchten. ![Repositorys](/assets/images/enterprise/repos/repositories.png) -{% data reusables.repositories.sidebar-settings %} -4. Klicken Sie auf der linken Seitenleiste auf **Hooks & Services** (Hooks und Dienste). ![„Hooks & services“ (Hooks und Dienste)](/assets/images/enterprise/repos/hooks-services.png) -5. Klicken Sie neben dem Pre-Receive-Hook, den Sie konfigurieren möchten, auf das Dropdownmenü **Hook permissions** (Hook-Berechtigungen). Wählen Sie aus, ob der Pre-Receive-Hook aktiviert oder deaktiviert werden soll. ![Hook-Berechtigungen für das Repository](/assets/images/enterprise/repos/repo-hook-permissions.png) diff --git a/translations/de-DE/content/admin/developer-workflow/managing-projects-using-jira.md b/translations/de-DE/content/admin/developer-workflow/managing-projects-using-jira.md deleted file mode 100644 index 41d225197861..000000000000 --- a/translations/de-DE/content/admin/developer-workflow/managing-projects-using-jira.md +++ /dev/null @@ -1,55 +0,0 @@ ---- -title: Projekte mit JIRA verwalten -intro: 'Sie können JIRA in {% data variables.product.prodname_enterprise %} zur Projektverwaltung integrieren.' -redirect_from: - - /enterprise/admin/guides/installation/project-management-using-jira/ - - /enterprise/admin/articles/project-management-using-jira/ - - /enterprise/admin/developer-workflow/managing-projects-using-jira -versions: - enterprise-server: '*' ---- - -### JIRA mit einer {% data variables.product.prodname_enterprise %}-Organisation verbinden - -1. Melden Sie sich unter „http[s]://[hostname]/login“ bei Ihrem {% data variables.product.prodname_enterprise %}-Konto an. -1. Klicken Sie in der oberen rechten Ecke einer beliebigen Seite auf das Symbol (Zahnrad) mit den Kontoeinstellungen. -1. Klicken Sie auf der linken Seitenleiste auf den Namen Ihrer Organisation. -1. Klicken Sie auf der linken Seitenleiste auf **Applications** (Anwendungen). -1. Klicken Sie in der oberen rechten Ecke des Felds **Organization applications** (Organisationsanwendungen) auf **Register new application** (Neue Anwendung registrieren). -1. Tragen Sie die Anwendungseinstellungen ein: - - Geben Sie „JIRA“ im Feld **Application name** (Anwendungsname) ein. - - Geben Sie die vollständige URL Ihrer JIRA-Instanz im Feld **Homepage URL** (URL für Startseite) ein. - - Geben Sie die vollständige URL Ihrer JIRA-Instanz im Feld **Authorization callback URL** (Autorisierungsrückruf-URL) ein. -1. Klicken Sie auf **Register application** (Anwendung registrieren). -1. Beachten Sie oben auf der Seite die **Client-ID** und das **Clientgeheimnis**. Sie benötigen diese Angaben zum Konfigurieren Ihrer JIRA-Instanz. - -### JIRA mit einem persönlichen {% data variables.product.prodname_enterprise %}-Konto verbinden - -1. Melden Sie sich unter „http[s]://[hostname]/login“ bei Ihrem {% data variables.product.prodname_enterprise %}-Konto an. -1. Klicken Sie in der oberen rechten Ecke einer beliebigen Seite auf das Symbol (Zahnrad) mit den Kontoeinstellungen. -1. Klicken Sie auf der linken Seitenleiste auf **Applications** (Anwendungen). -1. Klicken Sie in der oberen rechten Ecke des Felds **Developer applications** (Entwickleranwendungen) auf **Register new application** (Neue Anwendung registrieren). -1. Tragen Sie die Anwendungseinstellungen ein: - - Geben Sie „JIRA“ im Feld **Application name** (Anwendungsname) ein. - - Geben Sie die vollständige URL Ihrer JIRA-Instanz im Feld **Homepage URL** (URL für Startseite) ein. - - Geben Sie die vollständige URL Ihrer JIRA-Instanz im Feld **Authorization callback URL** (Autorisierungsrückruf-URL) ein. -1. Klicken Sie auf **Register application** (Anwendung registrieren). -1. Beachten Sie oben auf der Seite die **Client-ID** und das **Clientgeheimnis**. Sie benötigen diese Angaben zum Konfigurieren Ihrer JIRA-Instanz. - -### Konfiguration der JIRA-Instanz - -1. Melden Sie sich auf Ihrer JIRA-Instanz mit administrativem Zugriff bei einem Konto an. -1. Klicken Sie im oberen Bereich der Seite auf das Symbol (Zahnrad) für Einstellungen. -1. Wählen Sie im Dropdownmenü für die Einstellungen **Add-Ons** aus. -1. Klicken Sie auf der linken Seitenleiste unter **Source control** (Quellcodeverwaltung) auf **DVCS accounts** (DVCS-Konto). -1. Klicken Sie auf **Link Bitbucket or GitHub account** (Bitbucket oder GitHub-Konto verknüpfen). -1. Tragen Sie im Modalfenster **Add New Account** (Neues Konto hinzufügen) Ihre {% data variables.product.prodname_enterprise %}-Einstellungen ein: - - Wählen Sie **GitHub Enterprise** im Dropdownmenü **Host** aus. - - Geben Sie im Feld **Team or User Account** den Namen Ihrer {% data variables.product.prodname_enterprise %}-Organisation oder Ihres persönlichen Kontos ein. - - Geben Sie im Feld **OAuth Key** (OAuth-Schlüssel) die Client-ID Ihrer {% data variables.product.prodname_enterprise %}-Entwickleranwendung ein. - - Geben Sie im Feld **OAuth Secret** (OAuth-Geheimnis) das Clientgeheimnis für Ihre {% data variables.product.prodname_enterprise %}-Entwickleranwendung ein. - - Deaktivieren Sie **Auto Link New Repositories** (Neue Repositorys automatisch verknüpfen), wenn die Ihrer {% data variables.product.prodname_enterprise %}-Organisation oder Ihrem persönlichen Konto zugehörigen neuen Repositorys nicht verknüpft werden sollen. - - Deaktivieren Sie **Enable Smart Commits** (Intelligente Commits aktivieren), wenn Sie intelligente Commits nicht aktivieren möchten. - - Klicken Sie auf **Add** (Hinzufügen). -1. Überprüfen Sie die Berechtigungen, die Sie Ihrem {% data variables.product.prodname_enterprise %}-Konto erteilen, und klicken Sie auf **Authorize application** (Anwendung autorisieren). -1. Geben Sie zum Fortfahren ggf. Ihr Passwort ein. diff --git a/translations/de-DE/content/admin/developer-workflow/troubleshooting-service-hooks.md b/translations/de-DE/content/admin/developer-workflow/troubleshooting-service-hooks.md deleted file mode 100644 index a81eb9266953..000000000000 --- a/translations/de-DE/content/admin/developer-workflow/troubleshooting-service-hooks.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: Fehlerbehebung bei Dienst-Hooks -intro: 'Wenn Nutzlasten nicht bereitgestellt werden, sollten Sie nach diesen allgemeinen Problemen suchen.' -redirect_from: - - /enterprise/admin/articles/troubleshooting-service-hooks/ - - /enterprise/admin/developer-workflow/troubleshooting-service-hooks -versions: - enterprise-server: '*' ---- - -### Informationen zu Auslieferungen abrufen - -Sie können nach Informationen für die letzte Antwort sämtlicher Dienst-Hook-Auslieferungen auf einem beliebigen Repository suchen. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -2. Navigieren Sie zu dem Repository, das Sie untersuchen. -3. Klicken Sie auf der Navigationsseitenleiste auf den Link **Hooks**. ![Hooks-Seitenleiste](/assets/images/enterprise/settings/Enterprise-Hooks-Sidebar.png) -4. Klicken Sie unter dem Dienst-Hook mit Problemen auf den Link **Latest Delivery** (Letzte Auslieferung). ![Hook-Details](/assets/images/enterprise/settings/Enterprise-Hooks-Details.png) -5. Unter **Remote Calls** (Remote-Aufrufe) werden die beim Senden der POST-Methode an den Remote-Server verwendeten Header und die Antwort angezeigt, die der Remote-Server an Ihre Installation zurückgesendet hat. - -### Nutzlast anzeigen - -{% data reusables.enterprise_site_admin_settings.access-settings %} -2. Navigieren Sie zu dem Repository, das Sie untersuchen. -3. Klicken Sie auf der Navigationsseitenleiste auf den Link **Hooks**. ![Hooks-Seitenleiste](/assets/images/enterprise/settings/Enterprise-Hooks-Sidebar.png) -4. Klicken Sie unter dem Dienst-Hook mit Problemen auf den Link **Latest Delivery** (Letzte Auslieferung). -5. Klicken Sie auf **Delivery** (Auslieferung). ![Nutzlast anzeigen](/assets/images/enterprise/settings/Enterprise-Hooks-Payload.png) - -### Vergangene Auslieferungen anzeigen - -Auslieferungen werden 15 Tage lang gespeichert. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -2. Navigieren Sie zu dem Repository, das Sie untersuchen. -3. Klicken Sie auf der Navigationsseitenleiste auf den Link **Hooks**. ![Hooks-Seitenleiste](/assets/images/enterprise/settings/Enterprise-Hooks-Sidebar.png) -4. Klicken Sie unter dem Dienst-Hook mit Problemen auf den Link **Latest Delivery** (Letzte Auslieferung). -5. Klicken Sie auf **More for this Hook ID** (Mehr für diese Hook-ID), um andere Auslieferungen an diesen spezifischen Hook anzuzeigen: ![Weitere Auslieferungen anzeigen](/assets/images/enterprise/settings/Enterprise-Hooks-More-Deliveries.png) diff --git a/translations/de-DE/content/admin/developer-workflow/using-pre-receive-hooks-to-enforce-policy.md b/translations/de-DE/content/admin/developer-workflow/using-pre-receive-hooks-to-enforce-policy.md deleted file mode 100644 index 587c520a0045..000000000000 --- a/translations/de-DE/content/admin/developer-workflow/using-pre-receive-hooks-to-enforce-policy.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Pre-Receive-Hooks zum Erzwingen der Richtlinie verwenden -intro: 'Mithilfe von Pre-Receive-Hooks können Sie Workflow-Standards in Ihrer Organisation erzwingen. Zum Verwenden von Pre-Receive-Hooks muss der Code einen vordefinierten Satz an Qualitätsprüfungen bestehen, bevor der Push in das Repository akzeptiert wird.' -mapTopic: true -redirect_from: - - /enterprise/admin/developer-workflow/using-pre-receive-hooks-to-enforce-policy -versions: - enterprise-server: '*' ---- - diff --git a/translations/de-DE/content/admin/developer-workflow/using-webhooks-for-continuous-integration.md b/translations/de-DE/content/admin/developer-workflow/using-webhooks-for-continuous-integration.md deleted file mode 100644 index 3a29092e8204..000000000000 --- a/translations/de-DE/content/admin/developer-workflow/using-webhooks-for-continuous-integration.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Webhooks für die fortlaufende Integration verwenden -intro: 'Wenn bereits ein Ökosystem für Entwicklungen und Bereitstellungen vorhanden ist, können Sie es mithilfe von Webhooks in {% data variables.product.prodname_ghe_server %} integrieren.' -mapTopic: true -redirect_from: - - /enterprise/admin/developer-workflow/continuous-integration-using-travis-ci - - /enterprise/admin/developer-workflow/using-webhooks-for-continuous-integration -versions: - enterprise-server: '*' ---- - diff --git a/translations/de-DE/content/admin/enterprise-management/monitoring-using-analytics.md b/translations/de-DE/content/admin/enterprise-management/monitoring-using-analytics.md deleted file mode 100644 index ee9e892edb3b..000000000000 --- a/translations/de-DE/content/admin/enterprise-management/monitoring-using-analytics.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: Monitoring using analytics -intro: 'You can enable web analytics tools to track and analyze traffic for your {% data variables.product.prodname_ghe_server %} instance.' -redirect_from: - - /enterprise/admin/enterprise-management/monitoring-using-analytics -versions: - enterprise-server: '>2.21' ---- - -### Configuring Google Analytics - -To configure Google Analytics, you must have a [Google Analytics ID](https://analytics.google.com/) and authenticate to your {% data variables.product.prodname_ghe_server %} instance with SSH. Weitere Informationen findest Du unter "[Auf die administrative Shell (SSH) zugreifen](/enterprise/admin/configuration/accessing-the-administrative-shell-ssh)." - -```shell -$ ghe-config website-analytics.enabled true -$ ghe-config website-analytics.google-analytics-id GOOGLE-ANALYTICS-ID -$ ghe-config-apply -``` diff --git a/translations/de-DE/content/admin/installation/about-enterprise-accounts.md b/translations/de-DE/content/admin/installation/about-enterprise-accounts.md deleted file mode 100644 index 06738f710afc..000000000000 --- a/translations/de-DE/content/admin/installation/about-enterprise-accounts.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: Informationen zu „Enterprise“ (Unternehmens)-Konten -intro: 'Mit {% data variables.product.prodname_ghe_server %} kannst Du ein Unternehmenskonto erstellen, um Administratoren einen einzigen Sichtbarkeits- und Verwaltungspunkt für ihre Abrechnungs- und Lizenznutzung zu geben.' -redirect_from: - - /enterprise/admin/installation/about-enterprise-accounts -versions: - enterprise-server: '*' ---- - -### Informationen zu Unternehmenskonten auf {% data variables.product.prodname_ghe_server %} - -Mit einem Unternehmens-Konto kannst Du mehrere {% data variables.product.prodname_dotcom %}-Organisationen und {% data variables.product.prodname_ghe_server %}-Instanzen verwalten. Dein Enterprise-Konto benötigt einen Handle, wie zum Beispiel eine Organisation oder ein persönliches Konto auf {% data variables.product.prodname_dotcom %}. Enterprise-Administratoren können Einstellungen und Voreinstellungen verwalten, darunter folgende: - -- Mitgliederzugang und -verwaltung (Organisationsmitglieder, externe Mitarbeiter) -- Abrechnung und Nutzung ({% data variables.product.prodname_ghe_server %}-Instanzen, Benutzerlizenzen, {% data variables.large_files.product_name_short %}-Pakete) -- Sicherheit (Single-Sign-On, Zwei-Faktor-Authentifizierung) -- Anfragen und Support-Paket-Einreichung bei {% data variables.contact.enterprise_support %} - -{% data reusables.enterprise-accounts.enterprise-accounts-billing %} - -Weitere Informationen über die Unterschiede zwischen {% data variables.product.prodname_ghe_cloud %} und {% data variables.product.prodname_ghe_server %} findest Du auf „[Produkte von {% data variables.product.prodname_dotcom %}](/articles/githubs-products)." Um auf {% data variables.product.prodname_enterprise %} zu hochzustufen oder um mit einem Unternehmenskonto einzusteigen, kontaktiere bitte {% data variables.contact.contact_enterprise_sales %}. - -### {% data variables.product.prodname_ghe_server %}-Lizenzen verwalten, die mit Deinem Unternehmens-Konto verknüpft sind - -{% data reusables.enterprise-accounts.admin-managing-licenses %} diff --git a/translations/de-DE/content/admin/installation/about-geo-replication.md b/translations/de-DE/content/admin/installation/about-geo-replication.md deleted file mode 100644 index a1cbf256be53..000000000000 --- a/translations/de-DE/content/admin/installation/about-geo-replication.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Informationen zur Geo-Replikation -intro: 'Die Geo-Replikation auf {% data variables.product.prodname_ghe_server %} verwendet mehrere aktive Replikate, um Anforderungen von geografisch verteilten Rechenzentren zu erfüllen.' -redirect_from: - - /enterprise/admin/installation/about-geo-replication -versions: - enterprise-server: '*' ---- - -Mehrere aktive Replikate können eine kürzere Entfernung zum nächstgelegenen Replikat ermöglichen. Beispielsweise kann eine Organisation mit Niederlassungen in San Francisco, New York und London die primäre Appliance in einem Rechenzentrum in der Nähe von New York und zwei Replikate in Rechenzentren nahe San Francisco und London betreiben. Mittels Geolocation-fähigem DNS können Benutzer an den nächstgelegenen verfügbaren Server weitergeleitet werden und schneller auf Repository-Daten zugreifen. Wenn die Appliance nahe New York als die primäre Instanz festgelegt wird, ist die Latenz zwischen den Hosts niedriger, als dies der Fall wäre, wenn die Appliance nahe San Francisco als die primäre Instanz festgelegt werden würde, deren Verbindung nach London wiederum eine höhere Latenz aufweist. - -Das aktive Replikat vermittelt Anforderungen, die es nicht selbst verarbeiten kann, an die primäre Instanz. Die Replikate fungieren als ein Point of Presence und beenden alle SSL-Verbindungen. Der Traffic zwischen den Hosts wird über eine verschlüsselte VPN-Verbindung gesendet. Dies ähnelt einer Hochverfügbarkeitskonfiguration mit zwei Knoten ohne Geo-Replikation. - -Git-Anforderungen und bestimmte Dateiserveranforderungen, beispielsweise LFS und Dateiuploads, können direkt auf dem Replikat verarbeitet werden, ohne Daten auf die primäre Instanz zu verteilen. Webanforderungen werden immer an die primäre Instanz weitergeleitet. Wenn das Replikat jedoch näher am Benutzer ist, sind die Anforderungen aufgrund der engeren SSL-Terminierung schneller. - -Damit die Geo-Replikation ordnungsgemäß funktioniert, ist Geo DNS, beispielsweise [der Route 53-Dienst von Amazon](http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-geo), erforderlich. Der Hostname für die Instanz sollte im Replikat aufgelöst werden, das dem Standort des Benutzers am nächsten liegt. - -### Einschränkungen - -Zum Senden von Anforderungen an das Replikat müssen die Daten an die primäre Instanz und an alle Replikate gesendet werden. Folglich ist die Leistung sämtlicher Schreibvorgänge auf das langsamste Replikat begrenzt{% if currentVersion ver_gt "enterprise-server@2.17" %}, wobei neue Geo-Replikate ein Seeding für den Großteil ihrer Daten von bestehenden Geo-Replikaten mit gleichem Speicherort aus anstatt von der primären Instanz aus ausführen können{% endif %}. Von der Geo-Replikation werden einer {% data variables.product.prodname_ghe_server %}-Instanz weder Kapazitäten hinzugefügt noch werden Leistungsprobleme in Bezug auf unzureichende CPU- oder Arbeitsspeicherressourcen behoben. Wenn die primäre Appliance offline ist, können aktive Replikate keine Lese- oder Schreibanforderungen verarbeiten. - -### Geo-Replikationskonfiguration überwachen - -{% data reusables.enterprise_installation.monitoring-replicas %} - -### Weiterführende Informationen -- „[Geo-Replikationsreplikate erstellen](/enterprise/{{ currentVersion }}/admin/guides/installation/creating-a-high-availability-replica/#creating-geo-replication-replicas)“ diff --git a/translations/de-DE/content/admin/installation/about-high-availability-configuration.md b/translations/de-DE/content/admin/installation/about-high-availability-configuration.md deleted file mode 100644 index d2be2ef7b1c4..000000000000 --- a/translations/de-DE/content/admin/installation/about-high-availability-configuration.md +++ /dev/null @@ -1,181 +0,0 @@ ---- -title: Informationen zur Hochverfügbarkeitskonfiguration -intro: 'In einer Hochverfügbarkeitskonfiguration bleibt eine voll redundante sekundäre {% data variables.product.prodname_ghe_server %}-Appliance mit der primären Appliance synchron. Dies erfolgt über die Replikation sämtlicher großer Datenspeicher.' -redirect_from: - - /enterprise/admin/installation/about-high-availability-configuration -versions: - enterprise-server: '*' ---- - -Beim Konfigurieren der Hochverfügbarkeit gibt es eine automatisierte Einrichtung einer unidirektionalen asynchronen Replikation sämtlicher Datenspeicher (Git-Repositorys, MySQL, Redis und ElasticSearch) von der primären zur Replikat-Appliance. - -{% data variables.product.prodname_ghe_server %} unterstützt eine aktive/passive Konfiguration, bei der die Replikations-Appliance als Standby-Instanz mit Datenbankdiensten im Replikationsmodus ausgeführt wird, aber die Anwendungsdienste gestoppt werden. - -### Anvisierte Fehlerszenarien - -Verwenden Sie eine Hochverfügbarkeitskonfiguration zum Schutz vor: - -{% data reusables.enterprise_installation.ha-and-clustering-failure-scenarios %} - -Eine Hochverfügbarkeitskonfiguration eignet sich nicht für: - - - **Das horizontale Hochskalieren**. Obwohl Sie den Traffic geografisch mittels Geo-Replikation verteilen können, ist die Leistung von Schreibvorgängen entsprechend der Geschwindigkeit und Verfügbarkeit der primären Appliance begrenzt. Weitere Informationen finden Sie unter „[Informationen zur Geo-Replikation](/enterprise/{{ currentVersion }}/admin/guides/installation/about-geo-replication/)“. - - **Das Sichern der primären Appliance**. Eine Hochverfügbarkeitsreplikat ersetzt keine Off-Site-Backups in Ihrem Disaster Recovery-Plan. Einige Formen von Datenbeschädigungen oder -verlusten werden möglicherweise sofort von der primären Instanz zum Replikat repliziert. Um einen sicheren Rollback auf einen stabilen vergangenen Zustand zu gewährleisten, müssen Sie regelmäßige Backups mit historischen Snapshots durchführen. - - **Upgrades ohne Ausfallzeit**. Platzieren Sie zum Verhindern von Datenverlusten und Split-Brain-Situationen in kontrollierten Hochstufungsszenarien die primäre Appliance in den Wartungsmodus, und warten Sie auf den Abschluss sämtlicher Schreibvorgänge, bevor Sie das Replikat hochstufen. - -### Netzwerk-Traffic-Failover-Strategien - -Während des Failovers müssen Sie den Netzwerk-Traffic separat konfigurieren und ihn manuell von der primären Instanz zum Replikat weiterleiten. - -#### DNS-Failover - -Verwenden Sie mit DNS-Failover kurze TTL-Werte in den DNS-Einträgen, die auf die primäre {% data variables.product.prodname_ghe_server %}-Appliance verweisen. Sie sollten einen TTL-Wert zwischen 60 Sekunden und fünf Minuten verwenden. - -Während des Failovers müssen Sie die primäre Instanz in den Wartungsmodus versetzen und ihre DNS-Einträge an die IP-Adresse der Replikat-Appliance weiterleiten. Die zum Weiterleiten des Traffics von der primären Instanz zum Replikat erforderliche Zeit hängt von der TTL-Konfiguration und der zum Aktualisieren der DNS-Einträge erforderlichen Zeit ab. - -Wenn Sie die Geo-Replikation verwenden, müssen Sie Geo DNS so konfigurieren, dass der Traffic an das nächstgelegene Replikat weitergeleitet wird. Weitere Informationen finden Sie unter „[Informationen zur Geo-Replikation](/enterprise/{{ currentVersion }}/admin/guides/installation/about-geo-replication/)“. - -#### Load-Balancer - -{% data reusables.enterprise_clustering.load_balancer_intro %} {% data reusables.enterprise_clustering.load_balancer_dns %} - -Während des Failovers müssen Sie die primäre Appliance in den Wartungsmodus versetzen. Sie können den Load-Balancer so konfigurieren, dass automatisch erkannt wird, wenn das Replikat auf die primäre Instanz hochgestuft wurde, oder dass eine manuelle Konfigurationsänderung erforderlich ist. Sie müssen das Replikat manuell auf die primäre Instanz hochstufen, bevor es auf den Benutzer-Traffic antwortet. Weitere Informationen finden Sie unter „[{% data variables.product.prodname_ghe_server %} mit einem Load-Balancer verwenden](/enterprise/{{ currentVersion }}/admin/guides/installation/using-github-enterprise-server-with-a-load-balancer/)“. - -{% data reusables.enterprise_installation.monitoring-replicas %} - -### Dienstprogramm zur Replikationsverwaltung - -Verwenden Sie zum Verwalten der Replikation auf {% data variables.product.prodname_ghe_server %} diese Befehlszeilendienstprogramme, indem Sie mittels SSH eine Verbindung zur Replikat-Appliance herstellen. - -#### ghe-repl-setup - -Der Befehl `ghe-repl-setup` versetzt eine {% data variables.product.prodname_ghe_server %}-Appliance in den Replikat-Standbymodus. - - - Ein verschlüsselter {% if currentVersion ver_gt "enterprise-server@2.17" %}WireGuard-VPN{% else %}Open-VPN{% endif %}-Tunnel ist für die Kommunikation zwischen den beiden Appliances konfiguriert. - - Datenbankdienste werden für die Replikation konfiguriert und gestartet. - - Anwendungsdienste werden deaktiviert. Wenn versucht wird, über HTTP, Git oder über andere unterstützte Protokolle auf die Replikat-Appliance zuzugreifen, wird die Wartungsseite „appliance in replica mode“ (Appliance im Replikatmodus) oder eine Fehlermeldung angezeigt. - -```shell -admin@169-254-1-2:~$ ghe-repl-setup 169.254.1.1 -Verifying ssh connectivity with 169.254.1.1 ... -Connection check succeeded. -Configuring database replication against primary ... -Success: Replica mode is configured against 169.254.1.1. -To disable replica mode and undo these changes, run `ghe-repl-teardown'. -Run `ghe-repl-start' to start replicating against the newly configured primary. -``` - -#### ghe-repl-start - -Der Befehl `ghe-repl-start` aktiviert die aktive Replikation sämtlicher Datenspeicher. - -```shell -admin@169-254-1-2:~$ ghe-repl-start{% if currentVersion ver_lt "enterprise-server@2.18" %} -Starting OpenVPN tunnel ... {% endif %} -Starting MySQL replication ... -Starting Redis replication ... -Starting Elasticsearch replication ... -Starting Pages replication ... -Starting Git replication ... -Success: replication is running for all services. -Use `ghe-repl-status' to monitor replication health and progress. -``` - -#### ghe-repl-status - -Der Befehl `ghe-repl-status` gibt den Status `OK`, `WARNING` (Warnung) oder `CRITICAL` (Kritisch) für jeden Datenspeicher-Replikationsstream zurück. Wenn einer der Replikationskanäle den Zustand `WARNING` (Warnung) aufweist, wird der Befehl mit dem Code `1` beendet. Wenn einer der Kanäle den Zustand `CRITICAL` (Kritisch) aufweist, wird der Befehl entsprechend mit dem Code `2`2 beendet. - -```shell -admin@169-254-1-2:~$ ghe-repl-status -OK: mysql replication in sync -OK: redis replication is in sync -OK: elasticsearch cluster is in sync -OK: git data is in sync (10 repos, 2 wikis, 5 gists) -OK: pages data is in sync -``` - -Die Optionen `-v` und `-vv` stellen Details zum Replikationszustand jedes Datenspeichers bereit: - -```shell -$ ghe-repl-status -v -OK: mysql replication in sync - | IO running: Yes, SQL running: Yes, Delay: 0 - -OK: redis replication is in sync - | master_host:169.254.1.1 - | master_port:6379 - | master_link_status:up - | master_last_io_seconds_ago:3 - | master_sync_in_progress:0 - -OK: elasticsearch cluster is in sync - | { - | "cluster_name" : "github-enterprise", - | "status" : "green", - | "timed_out" : false, - | "number_of_nodes" : 2, - | "number_of_data_nodes" : 2, - | "active_primary_shards" : 12, - | "active_shards" : 24, - | "relocating_shards" : 0, - | "initializing_shards" : 0, - | "unassigned_shards" : 0 - | } - -OK: git data is in sync (366 repos, 31 wikis, 851 gists) - | TOTAL OK FAULT PENDING DELAY - | repositories 366 366 0 0 0.0 - | wikis 31 31 0 0 0.0 - | gists 851 851 0 0 0.0 - | total 1248 1248 0 0 0.0 - -OK: pages data is in sync - | Pages are in sync -``` - -#### ghe-repl-stop - -Der Befehl `ghe-repl-stop` deaktiviert die Replikation temporär für alle Datenspeicher und stoppt die Replikationsdienste. Führen Sie den Befehl [ghe-repl-start](#ghe-repl-start) aus, um die Replikation wieder aufzunehmen. - -```shell -admin@168-254-1-2:~$ ghe-repl-stop -Stopping Pages replication ... -Stopping Git replication ... -Stopping MySQL replication ... -Stopping Redis replication ... -Stopping Elasticsearch replication ...{% if currentVersion ver_lt "enterprise-server@2.18" %} -Stopping OpenVPN tunnel ...{% endif %} -Success: replication was stopped for all services. -``` - -#### ghe-repl-promote - -Der Befehl `ghe-repl-promote` deaktiviert die Replikation und wandelt die Replikat-Appliance in eine primäre Instanz um. Die Appliance wird mit denselben Einstellungen wie die ursprüngliche primäre Instanz konfiguriert, und alle Dienste sind aktiviert. - -{% data reusables.enterprise_installation.promoting-a-replica %} - -```shell -admin@168-254-1-2:~$ ghe-repl-promote -Enabling maintenance mode on the primary to prevent writes ... -Stopping replication ... - | Stopping Pages replication ... - | Stopping Git replication ... - | Stopping MySQL replication ... - | Stopping Redis replication ... - | Stopping Elasticsearch replication ...{% if currentVersion ver_lt "enterprise-server@2.18" %} - | Stopping OpenVPN tunnel ...{% endif %} - | Success: replication was stopped for all services. -Switching out of replica mode ... - | Success: Replication configuration has been removed. - | Run `ghe-repl-setup' to re-enable replica mode. -Applying configuration and starting services ... -Success: Replica has been promoted to primary and is now accepting requests. -``` - -#### ghe-repl-teardown - -Der Befehl `ghe-repl-teardown` deaktiviert den Replikationsmodus vollständig und entfernt die Replikatkonfiguration. - -### Weiterführende Informationen - -- „[Hochverfügbarkeitsreplikat erstellen](/enterprise/{{ currentVersion }}/admin/guides/installation/creating-a-high-availability-replica)“ diff --git a/translations/de-DE/content/admin/installation/about-the-github-enterprise-server-api.md b/translations/de-DE/content/admin/installation/about-the-github-enterprise-server-api.md deleted file mode 100644 index a45d842c47ee..000000000000 --- a/translations/de-DE/content/admin/installation/about-the-github-enterprise-server-api.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: Informationen zur GitHub Enterprise Server-API -intro: '{% data variables.product.prodname_ghe_server %} unterstützt dieselbe leistungsstarke API, die auf {% data variables.product.prodname_dotcom_the_website %} verfügbar ist, und den eigenen Satz an API-Endpunkten.' -redirect_from: - - /enterprise/admin/articles/about-the-enterprise-api/ - - /enterprise/admin/articles/using-the-api/ - - /enterprise/admin/categories/api/ - - /enterprise/admin/installation/about-the-github-enterprise-server-api -versions: - enterprise-server: '*' ---- - -The complete documentation for the {% data variables.product.prodname_enterprise_api %} is available at . Mit der API können Sie viele Verwaltungsaufgaben automatisieren. Darunter beispielsweise: - -- Änderungen in der {% data variables.enterprise.management_console %} durchführen. For more information, see "[{% data variables.enterprise.management_console %}](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#management-console)." -- Statistiken zu Ihrer Instanz erfassen. For more information, see "[Admin stats](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#admin-stats)." -- Die LDAP-Synchronisierung konfigurieren. For more information, see "[LDAP](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#ldap)."{% if currentVersion ver_gt "enterprise-server@2.18" %} -- Verwalte Dein Unternehmenskonto. Weitere Informationen findest Du unter „[Unternehmenskonten](/v4/guides/managing-enterprise-accounts).“{% endif %} diff --git a/translations/de-DE/content/admin/installation/accessing-the-administrative-shell-ssh.md b/translations/de-DE/content/admin/installation/accessing-the-administrative-shell-ssh.md deleted file mode 100644 index a5d89838c92f..000000000000 --- a/translations/de-DE/content/admin/installation/accessing-the-administrative-shell-ssh.md +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: Auf die Verwaltungsshell (SSH) zugreifen -redirect_from: - - /enterprise/admin/articles/ssh-access/ - - /enterprise/admin/articles/adding-an-ssh-key-for-shell-access/ - - /enterprise/admin/guides/installation/administrative-shell-ssh-access/ - - /enterprise/admin/articles/troubleshooting-ssh-permission-denied-publickey/ - - /enterprise/admin/2.13/articles/troubleshooting-ssh-permission-denied-publickey/ - - /enterprise/admin/2.14/articles/troubleshooting-ssh-permission-denied-publickey/ - - /enterprise/admin/2.15/articles/troubleshooting-ssh-permission-denied-publickey/ - - /enterprise/admin/installation/accessing-the-administrative-shell-ssh -intro: 'Der SSH-Zugriff ermöglicht Ihnen die Ausführung der {% data variables.product.prodname_ghe_server %}-Befehlszeilendienstprogramme und eignet sich zur Fehlerbehebung, zum Ausführen von Backups und zum Konfigurieren der Replikation.' -versions: - enterprise-server: '*' ---- - -### Informationen zum Verwaltungsshellzugriff - -Wenn Sie über SSH-Zugriff auf die Verwaltungsshell verfügen, können Sie die Befehlszeilendienstprogramme von {% data variables.product.prodname_ghe_server %} ausführen. Der SSH-Zugriff eignet sich zudem zur Fehlerbehebung, zum Ausführen von Backups und zum Konfigurieren der Replikation. Der SSH-Verwaltungszugriff wird getrennt vom Git SSH-Zugriff verwaltet und ist nur über Port 122 zugänglich. - -### Zugriff auf die Verwaltungsshell über SSH aktivieren - -Zum Aktivieren des SSH-Verwaltungszugriffs müssen Sie Ihren öffentlichen SSH-Schlüssel zur Liste der autorisierten Schlüssel Ihrer Instanz hinzufügen. - -{% tip %} - -**Tipp:** Die Änderungen an den autorisierten SSH-Schlüsseln werden sofort wirksam. - -{% endtip %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -3. Fügen Sie unter „SSH access“ (SSH-Zugriff) Ihren Schlüssel in das Textfeld ein, und klicken Sie anschließend auf **Add key** (Schlüssel hinzufügen). ![Textfeld und Schaltfläche zum Hinzufügen eines SSH-Schlüssels](/assets/images/enterprise/settings/add-authorized-ssh-key-admin-shell.png) -{% data reusables.enterprise_management_console.save-settings %} - -### Verbindung zur Verwaltungsshell über SSH herstellen - -Nachdem Sie der Liste Ihren SSH-Schlüssel hinzugefügt haben, verbinden Sie als der Benutzer `admin` auf Port 122 die Instanz über SSH. - -```shell -$ ssh -p 122 admin@github.example.com -Last login: Sun Nov 9 07:53:29 2014 from 169.254.1.1 -admin@github-example-com:~$ █ -``` - -#### Fehlerbehebung bei SSH-Verbindungsproblemen - -Wenn der Fehler `Permission denied (publickey)` (Berechtigung verweigert (öffentlicher Schlüssel)) angezeigt wird, wenn Sie versuchen, über SSH eine Verbindung zu {% data variables.product.product_location_enterprise %} herzustellen, sollten Sie bestätigen, dass Sie die Verbindung über Port 122 vornehmen. Möglicherweise müssen Sie explizit angeben, welcher private SSH-Schlüssel verwendet werden soll. - -Führen Sie zum Angeben eines privaten SSH-Schlüssels an der Befehlszeile `ssh` mit dem Argument `-i` aus. - -```shell -ssh -i /path/to/ghe_private_key -p 122 admin@hostname -``` - -Darüber hinaus können Sie einen privaten SSH-Schlüssel mithilfe der SSH-Konfigurationsdatei (`~/.ssh/config`) angeben. - -```shell -Host hostname - IdentityFile /path/to/ghe_private_key - User admin - Port 122 -``` - -### Auf die Verwaltungsshell mithilfe der lokalen Konsole zugreifen - -In einer Notfallsituation, beispielsweise wenn SSH nicht verfügbar ist, können Sie lokal auf die Verwaltungsshell zugreifen. Melden Sie sich als der Benutzer `admin` mit dem Passwort an, das während der Ersteinrichtung von {% data variables.product.prodname_ghe_server %} festgelegt wurde. - -### Zugriffseinschränkungen für die Verwaltungsshell - -Der Verwaltungsshellzugriff ist nur zur Fehlerbehebung und zum Durchführen dokumentierter Vorgehensweisen zulässig. Ihr Supportvertrag wird ggf. ungültig, wenn Sie System- und Anwendungsdateien ändern, Programme ausführen oder nicht unterstützte Softwarepakete installieren. Kontaktiere bitte den {% data variables.contact.contact_ent_support %} bei Fragen zu den laut Deinem Supportvertrag zulässigen Aktivitäten. diff --git a/translations/de-DE/content/admin/installation/accessing-the-management-console.md b/translations/de-DE/content/admin/installation/accessing-the-management-console.md deleted file mode 100644 index fe9b83abca42..000000000000 --- a/translations/de-DE/content/admin/installation/accessing-the-management-console.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: Auf die Managementkonsole zugreifen -intro: 'Mit der {% data variables.enterprise.management_console %} können Sie {% data variables.product.product_location %} einrichten und konfigurieren, Wartungsfenster planen, Fehler beheben und Ihre Lizenz verwalten.' -redirect_from: - - /enterprise/admin/articles/about-the-management-console/ - - /enterprise/admin/articles/management-console-for-emergency-recovery/ - - /enterprise/admin/articles/web-based-management-console/ - - /enterprise/admin/categories/management-console/ - - /enterprise/admin/articles/accessing-the-management-console/ - - /enterprise/admin/guides/installation/web-based-management-console/ - - /enterprise/admin/installation/accessing-the-management-console -versions: - enterprise-server: '*' ---- - -### Informationen zur {% data variables.enterprise.management_console %} - -{% data variables.enterprise.management_console %} für grundlegende Verwaltungsaktivitäten verwenden: -- **Initial setup** (Ersteinrichtung): Durchlaufen Sie beim ersten Start von {% data variables.product.product_location_enterprise %} den Ersteinrichtungsprozess. Rufen Sie dazu in Ihrem Browser die IP-Adresse Ihrer {% data variables.product.product_location_enterprise %} auf. -- **Configuring basic settings for your instance** (Grundlegende Einstellungen für Ihre Instanz konfigurieren): Auf der Seite „Settings“ (Einstellungen) können Sie DNS, den Hostnamen, SSL, die Benutzerauthentifizierung, E-Mail, Überwachungsdienste und die Protokollweiterleitung konfigurieren. -- **Scheduling maintenance windows** (Wartungsfenster planen): Nehmen Sie Ihre {% data variables.product.product_location_enterprise %} offline, während Sie eine Wartung mithilfe der {% data variables.enterprise.management_console %} oder der Verwaltungsshell durchführen. -- **Troubleshooting** (Fehlerbehebung): Generieren Sie ein Support-Bundle, oder zeigen Sie allgemeine Diagnoseinformationen an. -- **License management** (Lizenzverwaltung): Zeigen Sie Ihre {% data variables.product.prodname_enterprise %}-Lizenz an, oder aktualisieren Sie sie. - -Sie können jederzeit mithilfe der IP-Adresse von {% data variables.product.product_location_enterprise %} auf die {% data variables.enterprise.management_console %} zugreifen, selbst wenn sich die Instanz im Wartungsmodus befindet oder wenn ein kritischer Anwendungsfehler oder eine falsche Hostnamen- oder SSL-Konfiguration vorliegt. - -Verwenden Sie das während der Ersteinrichtung von {% data variables.product.product_location_enterprise %} festgelegte Administratorpasswort, um auf die {% data variables.enterprise.management_console %} zuzugreifen. Zudem müssen Sie auf Port 8443 eine Verbindung zum Host der virtuellen Maschine herstellen können. Wenn Sie Probleme haben, auf {% data variables.enterprise.management_console %} zuzugreifen, sollten Sie die Konfigurationen für die Zwischenfirewall und für die Sicherheitsgruppe überprüfen. - -### Auf die {% data variables.enterprise.management_console %} als ein Websiteadministrator zugreifen - -Wenn Du erstmals als ein Website-Administrator auf die {% data variables.enterprise.management_console %} zugreifst, musst Du Deine {% data variables.product.prodname_enterprise %}-Lizenzdatei hochladen, um Dich in der App zu authentifizieren. Weitere Informationen findest Du unter „[Deine {% data variables.product.prodname_enterprise %}-Lizenz verwalten](/enterprise/{{ currentVersion }}/admin/guides/installation/managing-your-github-enterprise-server-license)“. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.type-management-console-password %} - -### Auf die {% data variables.enterprise.management_console %} als ein nicht authentifizierter Benutzer zugreifen - -1. Besuchen Sie diese URL in Ihrem Browser, und ersetzen Sie `hostname` durch Ihren tatsächlichen {% data variables.product.prodname_ghe_server %}-Hostnamen oder durch Ihre tatsächliche -IP-Adresse. - ```shell - http(s)://HOSTNAME/setup - ``` -{% data reusables.enterprise_management_console.type-management-console-password %} - -### {% data variables.enterprise.management_console %} nach fehlerhaften Anmeldeversuchen entsperren - -Die {% data variables.enterprise.management_console %} wird nach zehn fehlerhaften Anmeldeversuchen gesperrt, die in der Zeitspanne von zehn Minuten vorgenommen wurden. Sie müssen auf die automatische Entsperrung des Anmeldebildschirms warten, bevor Sie versuchen können, sich erneut anzumelden. Der Anmeldebildschirm wird automatisch entsperrt, wenn im Zeitraum der letzten zehn Minuten weniger als zehn fehlerhafte Anmeldeversuche vorlagen. Der Zähler wird nach einer erfolgreichen Anmeldung zurückgesetzt. - -Führen Sie an der Verwaltungsshell den Befehl `ghe-reactivate-admin-login` aus, um die {% data variables.enterprise.management_console %} sofort zu entsperren. Weitere Informationen finden Sie unter „[Befehlszeilenprogramme](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities#ghe-reactivate-admin-login)“ und „[Auf die Verwaltungsshell (SSH) zugreifen](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-administrative-shell-ssh/)“. diff --git a/translations/de-DE/content/admin/installation/accessing-the-monitor-dashboard.md b/translations/de-DE/content/admin/installation/accessing-the-monitor-dashboard.md deleted file mode 100644 index e8eb3931926e..000000000000 --- a/translations/de-DE/content/admin/installation/accessing-the-monitor-dashboard.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: Auf das Überwachungs-Dashboard zugreifen -intro: '{% data variables.product.prodname_ghe_server %} enthält ein webbasiertes Überwachungs-Dashboard, das Verlaufsdaten zu Ihrer {% data variables.product.prodname_ghe_server %}-Appliance anzeigt. Dazu zählen beispielsweise die CPU- und Speichernutzung, Anwendungs- und Authentifizierungsantwortzeiten und der allgemeine Systemzustand.' -redirect_from: - - /enterprise/admin/installation/accessing-the-monitor-dashboard -versions: - enterprise-server: '*' ---- - -### Auf das Überwachungs-Dashboard zugreifen - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -2. Klicken Sie im oberen Bereich der Seite auf **Monitor** (Überwachen). ![Link zum Überwachungs-Dashboard](/assets/images/enterprise/management-console/monitor-dash-link.png) - -### Fehlerbehebung bei allgemeinen Ressourcenzuordnungsproblemen auf Ihrer Appliance - -{% note %} - -**Hinweis**: Da das regelmäßige automatische Abrufen von {% data variables.product.product_location_enterprise %} mittels fortlaufender Integration (CI) oder Build-Servern effektiv zu Denial-of-Service-Angriffen führen kann, die zu Problemen führen, sollten Sie Webhooks verwenden, um Updates per Push-Vorgang zu übertragen. Weitere Informationen finden Sie unter „[Informationen zu Webhooks](/enterprise/{{ currentVersion }}/user/articles/about-webhooks/)“. - -{% endnote %} - -Mit dem Überwachungs-Dashboard können Sie in Bezug auf den Ressourcenzustand Ihrer Appliance auf dem Laufenden bleiben und Entscheidungen treffen, wie Sie Probleme hinsichtlich hoher Nutzungen beheben können. - -| Problem | Mögliche Ursache(n) | Empfehlungen | -| ----------------------------------------- | --------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Hohe CPU-Auslastung | VM-Konflikte von anderen auf demselben Host ausgeführten Diensten oder Programmen | Konfigurieren Sie nach Möglichkeit andere Dienste oder Programme so neu, dass sie weniger CPU-Ressourcen beanspruchen. Informationen zum Erhöhen der CPU-Gesamtressourcen für die VM finden Sie unter „[CPU- und Arbeitsspeicherressourcen erhöhen](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)“. | -| Hohe Arbeitsspeicherauslastung | VM-Konflikte von anderen auf demselben Host ausgeführten Diensten oder Programmen | Konfigurieren Sie nach Möglichkeit andere Dienste oder Programme so, dass sie weniger Arbeitsspeicher beanspruchen. Informationen zum Erhöhen des insgesamt auf der VM verfügbaren Arbeitsspeichers finden Sie unter „[CPU- und Arbeitsspeicherressourcen erhöhen](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)“. | -| Niedrige Festplattenspeicherverfügbarkeit | Große Binärdateien oder Protokolldateien, die Festplattenspeicher nutzen | Hosten Sie große Binärdateien nach Möglichkeit auf einem separaten Server, und komprimieren oder archivieren Sie Protokolldateien. Erhöhen Sie ggf. den Festplattenspeicher auf der VM. Befolgen Sie dazu die unter „[Speicherkapazität erhöhen](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-storage-capacity/)“ für Ihre Plattform angegebenen Schritte. | -| Ungewöhnlich hohe Antwortzeiten | Wird oft durch einen der obigen Issues verursacht | Identifizieren und beheben Sie die zugrunde liegenden Issues. Kontaktieren Sie {% data variables.contact.contact_ent_support %}, falls die Antwortzeiten hoch bleiben. | -| Erhöhte Fehlerraten | Software-Issues | Kontaktieren Sie {% data variables.contact.contact_ent_support %}, und fügen Sie Ihr Support-Bundle hinzu. Weitere Informationen finden Sie unter „[Daten für den {% data variables.product.prodname_enterprise %}-Support bereitstellen](/enterprise/{{ currentVersion}}/admin/guides/enterprise-support/providing-data-to-github-support#creating-and-sharing-support-bundles)“. | diff --git a/translations/de-DE/content/admin/installation/activity-dashboard.md b/translations/de-DE/content/admin/installation/activity-dashboard.md deleted file mode 100644 index f5ba1e36f895..000000000000 --- a/translations/de-DE/content/admin/installation/activity-dashboard.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: Aktivitäts-Dashboard -intro: 'Im Aktivitäts-Dashboard erhalten Sie einen Überblich über alle Aktivitäten auf {% data variables.product.product_location_enterprise %}.' -redirect_from: - - /enterprise/admin/articles/activity-dashboard/ - - /enterprise/admin/installation/activity-dashboard -versions: - enterprise-server: '*' ---- - -Das Aktivitäts-Dashboard bietet wöchentliche, monatliche und jährliche Grafiken zur Anzahl der -- neuen Pull Requests, -- gemergten Pull Requests, -- neuen Issues, -- geschlossenen Issues, -- neuen Issue-Komponenten, -- neuen Repositorys, -- neuen Benutzerkonten, -- neuen Organisationen, -- neuen Teams. - -![Aktivitäts-Dashboard](/assets/images/enterprise/activity/activity-dashboard-yearly.png) - -Für weitere Analysen auf Basis der Daten von {% data variables.product.prodname_enterprise %} kannst Du {% data variables.product.prodname_insights %} erwerben. Weitere Informationen findest Du unter „[Informationen zu {% data variables.product.prodname_insights %}](/insights/installing-and-configuring-github-insights/about-github-insights)“. - -### Auf das Aktivitäts-Dashboard zugreifen - -1. Klicken Sie im oberen Bereich einer beliebigen Seite auf **Explore** (Erkunden). ![Registerkarte „Explore“ (Erkunden)](/assets/images/enterprise/settings/ent-new-explore.png) -2. Klicken Sie in der oberen rechten Ecke auf **Activity** (Aktivität). ![Schaltfläche „Activity“ (Aktivität)](/assets/images/enterprise/activity/activity-button.png) diff --git a/translations/de-DE/content/admin/installation/audit-logging.md b/translations/de-DE/content/admin/installation/audit-logging.md deleted file mode 100644 index 9993b8412fd1..000000000000 --- a/translations/de-DE/content/admin/installation/audit-logging.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: Auditprotokollierung -intro: '{% data variables.product.prodname_enterprise %} speichert Protokolle von überwachten Benutzer-, Organisations-, Repository- und Systemereignissen. Protokolle eignen sich zum Debuggen und für die interne und externe Compliance.' -redirect_from: - - /enterprise/admin/articles/audit-logging/ - - /enterprise/admin/installation/audit-logging -versions: - enterprise-server: '*' ---- - -Eine vollständige Liste finden Sie unter „[Überwachte Aktionen](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions)“. Weitere Informationen zum Auffinden einer bestimmten Aktion finden Sie unter „[Auditprotokoll durchsuchen](/enterprise/{{ currentVersion }}/admin/guides/installation/searching-the-audit-log)“. - -### Push-Protokolle - -Jeder Git-Push-Vorgang wird protokolliert. Weitere Informationen finden Sie unter „[Push-Protokolle anzeigen](/enterprise/{{ currentVersion }}/admin/guides/installation/viewing-push-logs)“. - -### Systemereignisse - -Alle überwachten Systemereignisse, darunter alle Push- und Abrufvorgänge, werden in `/var/log/github/audit.log` protokolliert. Protokolle werden automatisch alle 24 Stunden rotiert und werden für sieben Tage gespeichert. - -Das Support-Bundle enthält Systemprotokolle. Weitere Informationen finden Sie unter „[Daten für den {% data variables.product.prodname_dotcom %}-Support bereitstellen](/enterprise/{{ currentVersion }}/admin/guides/enterprise-support/providing-data-to-github-support)“. - -### Support-Bundles - -Alle Auditinformationen werden in der Datei `audit.log` im Verzeichnis `github-logs` eines beliebigen Support-Bundles protokolliert. Bei aktivierter Protokollweiterleitung können Sie diese Daten an einen externen Syslog-Datenstromconsumer wie [Splunk](http://www.splunk.com/) oder [Logstash](http://logstash.net/) streamen. Alle Einträge aus diesem Protokoll verwenden das Stichwort `github_audit` und können danach gefiltert werden. Weitere Informationen finden Sie unter „[Protokollweiterleitung](/enterprise/{{ currentVersion }}/admin/guides/installation/log-forwarding)“. - -Beispielsweise zeigt der folgende Eintrag, dass ein neues Repository erstellt wurde. - -``` -Oct 26 01:42:08 github-ent github_audit: {:created_at=>1351215728326, :actor_ip=>"10.0.0.51", :data=>{}, :user=>"some-user", :repo=>"some-user/some-repository", :actor=>"some-user", :actor_id=>2, :user_id=>2, :action=>"repo.create", :repo_id=>1, :from=>"repositories#create"} -``` - -Dieses Beispiel zeigt, dass Commits per Push-Vorgang an ein Repository übertragen wurden. - -``` -Oct 26 02:19:31 github-ent github_audit: { "pid":22860, "ppid":22859, "program":"receive-pack", "git_dir":"/data/repositories/some-user/some-repository.git", "hostname":"github-ent", "pusher":"some-user", "real_ip":"10.0.0.51", "user_agent":"git/1.7.10.4", "repo_id":1, "repo_name":"some-user/some-repository", "transaction_id":"b031b7dc7043c87323a75f7a92092ef1456e5fbaef995c68", "frontend_ppid":1, "repo_public":true, "user_name":"some-user", "user_login":"some-user", "frontend_pid":18238, "frontend":"github-ent", "user_email":"some-user@github.example.com", "user_id":2, "pgroup":"github-ent_22860", "status":"post_receive_hook", "features":" report-status side-band-64k", "received_objects":3, "receive_pack_size":243, "non_fast_forward":false, "current_ref":"refs/heads/master" } -``` diff --git a/translations/de-DE/content/admin/installation/audited-actions.md b/translations/de-DE/content/admin/installation/audited-actions.md deleted file mode 100644 index 08edbc5adcba..000000000000 --- a/translations/de-DE/content/admin/installation/audited-actions.md +++ /dev/null @@ -1,133 +0,0 @@ ---- -title: Überwachte Aktionen -intro: Sie können das Auditprotokoll auf eine Vielzahl von Aktionen durchsuchen. -redirect_from: - - /enterprise/admin/articles/audited-actions/ - - /enterprise/admin/installation/audited-actions -versions: - enterprise-server: '*' ---- - -#### Authentifizierung - -| Name | Beschreibung | -| ------------------------------------:| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `oauth_access.create` | Ein [OAuth-Zugriffstoken](/v3/oauth/) wurde für ein Benutzerkonto [generiert](/articles/creating-an-access-token-for-command-line-use). | -| `oauth_access.destroy` | Ein [OAuth-Zugriffstoken](/v3/oauth/) wurde aus einem Benutzerkonto gelöscht. | -| `oauth_application.destroy` | Eine [OAuth-Anwendung](/guides/basics-of-authentication/#registering-your-app) wurde aus einem Benutzer- oder Organisationskonto gelöscht. | -| `oauth_application.reset_secret` | Der geheime Schlüssel einer [OAuth-Anwendung](/guides/basics-of-authentication/#registering-your-app) wurde zurückgesetzt. | -| `oauth_application.transfer` | Eine [OAuth-Anwendung](/guides/basics-of-authentication/#registering-your-app) wurde von einem Benutzer- oder Organisationskonto auf ein anderes übertragen. | -| `public_key.create` | Einem Benutzerkonto wurde ein SSH-Schlüssel [hinzugefügt](/articles/adding-a-new-ssh-key-to-your-github-account), oder einem Repository wurde ein [Deployment-Schlüssel](/guides/managing-deploy-keys/#deploy-keys) hinzugefügt. | -| `public_key.delete` | Ein SSH-Schlüssel wurde aus einem Benutzerkonto entfernt, oder ein [Deployment-Schlüssel](/guides/managing-deploy-keys/#deploy-keys) wurde aus einem Repository entfernt. | -| `public_key.update` | Der SSH-Schlüssel eines Benutzerkontos oder der [Deployment-Schlüssel](/guides/managing-deploy-keys/#deploy-keys) eines Repositorys wurde aktualisiert. | -| `two_factor_authentication.enabled` | Die [Zwei-Faktor-Authentifizierung](/articles/about-two-factor-authentication) wurde für ein Benutzerkonto aktiviert. | -| `two_factor_authentication.disabled` | Die [Zwei-Faktor-Authentifizierung](/articles/about-two-factor-authentication) wurde für ein Benutzerkonto deaktiviert. | - -#### Hooks - -| Name | Beschreibung | -| ---------------------:| ---------------------------------------------------------- | -| `hook.create` | Einem Repository wurde ein neuer Hook hinzugefügt. | -| `hook.config_changed` | Die Konfiguration eines Hooks wurde geändert. | -| `hook.destroy` | Ein Hook wurde gelöscht. | -| `hook.events_changed` | Die konfigurierten Ereignisse eines Hooks wurden geändert. | - -#### Instanzkonfigurationseinstellungen - -| Name | Beschreibung | -| -------------------------------------------------------:| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `business.update_member_repository_creation_permission` | Ein Websiteadministrator schränkt die Repository-Erstellungen in Organisationen auf der Instanz ein. Weitere Informationen finden Sie unter „[Repository-Erstellung auf Ihrer Instanz einschränken](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)“. | -| `business.clear_members_can_create_repos` | Ein Websiteadministrator löscht eine Einschränkung für die Repository-Erstellung in Organisationen auf der Instanz. Weitere Informationen finden Sie unter „[Repository-Erstellung auf Ihrer Instanz einschränken](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)“. | -| `enterprise.config.lock_anonymous_git_access` | Ein Websiteadministrator sperrt den anonymen Git-Lesezugriff, um Repository-Administratoren daran zu hindern, die vorhandenen Einstellungen für den anonymen Git-Lesezugriff für Repositorys auf der Instanz zu ändern. Weitere Informationen finden Sie unter „[Änderung des anonymen Git-Lesezugriffs durch Benutzer verhindern](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)“. | -| `enterprise.config.unlock_anonymous_git_access` | Ein Websiteadministrator entsperrt den anonymen Git-Lesezugriff, um Repository-Administratoren zu ermöglichen, die vorhandenen Einstellungen für den anonymen Git-Lesezugriff für Repositorys auf der Instanz zu ändern. Weitere Informationen finden Sie unter „[Änderung des anonymen Git-Lesezugriffs durch Benutzer verhindern](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)“. | - -#### Issues und Pull Requests - -| Name | Beschreibung | -| ------------------------------------:| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `issue.update` | Der Text eines Issues (erster Kommentar) wurde geändert. | -| `issue_comment.update` | Ein Kommentar zu einem Issue (nicht der ursprüngliche) wurde geändert. | -| `pull_request_review_comment.delete` | Ein Kommentar zu einem Pull Request wurde gelöscht. | -| `issue.destroy` | Ein Issue wurde aus dem Repository gelöscht. Weitere Informationen finden Sie unter „[Issue löschen](/enterprise/{{ currentVersion }}/user/articles/deleting-an-issue)“. | - -#### Organisationen - -| Name | Beschreibung | -| ------------------:| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `org.async_delete` | Ein Benutzer hat einen Hintergrundauftrag zum Löschen einer Organisation initiiert. | -| `org.delete` | Eine Organisation wurde durch einen von einem Benutzer initiierten Hintergrundauftrag gelöscht. | -| `org.transform` | Ein Benutzerkonto wurde in eine Organisation umgewandelt. Weitere Informationen finden Sie unter „[Benutzer in eine Organisation umwandeln](/enterprise/{{ currentVersion}}/user/articles/converting-a-user-into-an-organization/)“. | - -#### geschützte Branches - -| Name | Beschreibung | -| ------------------------------------------------------------------:| ------------------------------------------------------------------------------------------- | -| `protected_branch.create` | Der Branch-Schutz ist auf einem Branch aktiviert. | -| `protected_branch.destroy` | Der Branch-Schutz ist auf einem Branch deaktiviert. | -| `protected_branch.update_admin_enforced` | Der Branch-Schutz wird für Repository-Administratoren erzwungen. | -| `protected_branch.update_require_code_owner_review` | Die Erzwingung erforderlicher Reviews durch Codeinhaber wird auf einem Branch aktualisiert. | -| `protected_branch.dismiss_stale_reviews` | Die Erzwingung des Verwerfens veralteter Pull Requests wird für einen Branch aktualisiert. | -| `protected_branch.update_signature_requirement_enforcement_level` | Die Erzwingung der obligatorischen Commit-Signatur wird für einen Branch aktualisiert. | -| `protected_branch.update_pull_request_reviews_enforcement_level` | Die Erzwingung der erforderlichen Pull-Request-Reviews wird für einen Branch aktualisiert. | -| `protected_branch.update_required_status_checks_enforcement_level` | Die Erzwingung der erforderlichen Statuschecks für einen Branch wird aktualisiert. | -| `protected_branch.rejected_ref_update` | Ein Branch-Aktualisierungsversuch wird abgelehnt. | -| `protected_branch.policy_override` | Eine Branch-Schutzanforderung wird durch einen Repository-Administrator überschrieben. | - -#### Repositorys - -| Name | Beschreibung | -| ------------------------------------------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `repo.access` | Ein privates Repository wurde als öffentlich festgelegt, oder ein öffentliches Repository wurde als privat festgelegt. | -| `repo.archive` | Ein Repository wurde archiviert. Weitere Informationen finden Sie unter „[Repositorys archivieren und deren Archivierung aufheben](/enterprise/{{ currentVersion }}/admin/guides/user-management/archiving-and-unarchiving-repositories/)“. | -| `repo.add_member` | Einem Repository wurde ein Mitarbeiter hinzugefügt. | -| `repo.config` | Ein Websiteadministrator hat erzwungene Push-Vorgänge blockiert. Weitere Informationen finden Sie unter „[Erzwungene Push-Vorgänge an ein Repository blockieren](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository/)“. | -| `repo.create` | Ein Repository wurde erstellt. | -| `repo.destroy` | Ein Repository wurde gelöscht. | -| `repo.remove_member` | Ein Mitarbeiter wurde aus einem Repository entfernt. | -| `repo.rename` | Ein Repository wurde umbenannt. | -| `repo.transfer` | Ein Benutzer hat eine Anfrage akzeptiert, ein übertragenes Repository zu empfangen. | -| `repo.transfer_start` | Ein Benutzer hat eine Anfrage gesendet, ein Repository an einen anderen Benutzer oder an eine andere Organisation zu übertragen. | -| `repo.unarchive` | Die Archivierung eines Repositorys wurde aufgehoben. Weitere Informationen finden Sie unter „[Repositorys archivieren und deren Archivierung aufheben](/enterprise/{{ currentVersion }}/admin/guides/user-management/archiving-and-unarchiving-repositories/)“. | -| `repo.config.disable_anonymous_git_access` | Der anonyme Git-Lesezugriff ist für ein öffentliches Repository deaktiviert. Weitere Informationen finden Sie unter „[Anonymen Git-Lesezugriff für ein Repository aktivieren](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)“. | -| `repo.config.enable_anonymous_git_access` | Der anonyme Git-Lesezugriff ist für ein öffentliches Repository aktiviert. Weitere Informationen finden Sie unter „[Anonymen Git-Lesezugriff für ein Repository aktivieren](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)“. | -| `repo.config.lock_anonymous_git_access` | Die Einstellung für den anonymen Git-Lesezugriff eines Repositorys ist gesperrt, wodurch Repository-Administratoren daran gehindert werden, diese Einstellung zu ändern (zu aktivieren oder zu deaktivieren). Weitere Informationen finden Sie unter „[Änderung des anonymen Git-Lesezugriffs durch Benutzer verhindern](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)“. | -| `repo.config.unlock_anonymous_git_access` | Die Einstellung für den anonymen Git-Lesezugriff ist entsperrt, wodurch Repository-Administratoren diese Einstellung ändern (aktivieren oder deaktivieren) können. Weitere Informationen finden Sie unter „[Änderung des anonymen Git-Lesezugriffs durch Benutzer verhindern](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)“. | - -#### Websiteadministratortools - -| Name | Beschreibung | -| --------------------:| -------------------------------------------------------------------------------------------------------------------------------------- | -| `staff.disable_repo` | Ein Websiteadministrator hat den Zugriff auf ein Repository und auf alle zugehörigen Forks deaktiviert. | -| `staff.enable_repo` | Ein Websiteadministrator hat den Zugriff auf ein Repository und auf alle zugehörigen Forks wieder aktiviert. | -| `staff.fake_login` | Ein Websiteadministrator hat sich als ein anderer Benutzer bei {% data variables.product.prodname_enterprise %} angemeldet. | -| `staff.repo_unlock` | Ein Websiteadministrator hat eines der privaten Repositorys eines Benutzers entsperrt (temporär vollständigen Zugriff darauf erlangt). | -| `staff.unlock` | Ein Websiteadministrator hat alle der privaten Repositorys eines Benutzers entsperrt (temporär vollständigen Zugriff darauf erlangt). | - -#### Teams - -| Name | Beschreibung | -| --------------:| ------------------------------------------------------------------- | -| `team.create` | Einem Team wurde ein Benutzerkonto oder ein Repository hinzugefügt. | -| `team.delete` | Ein Benutzerkonto oder Repository wurde aus einem Team entfernt. | -| `team.destroy` | Ein Team wurde gelöscht. | - -#### Benutzer - -| Name | Beschreibung | -| ---------------------------:| ---------------------------------------------------------------------------------------------------------------------------------- | -| `user.add_email` | Einem Benutzerkonto wurde eine E-Mail-Adresse hinzugefügt. | -| `user.async_delete` | Es wurde ein asynchroner Auftrag gestartet, um ein Benutzerkonto zu vernichten, wodurch schließlich `user.delete` ausgelöst wurde. | -| `user.change_password` | Ein Benutzer hat sein Passwort geändert. | -| `user.create` | Ein neues Benutzerkonto wurde erstellt. | -| `user.delete` | Ein Benutzerkonto wurde durch einen asynchronen Auftrag vernichtet. | -| `user.demote` | Ein Websiteadministrator wurde auf ein gewöhnliches Benutzerkonto zurückgestuft. | -| `user.destroy` | Ein Benutzer hat sein Konto gelöscht, wodurch `user.async_delete` ausgelöst wurde. | -| `user.failed_login` | Ein Benutzer hat versucht, sich mit einem falschen Benutzernamen, Passwort oder Zwei-Faktor-Authentifizierungscode anzumelden. | -| `user.forgot_password` | Ein Benutzer hat über die Anmeldeseite eine Passwortzurücksetzung angefordert. | -| `user.login` | Ein Benutzer hat sich angemeldet. | -| `user.promote` | Ein gewöhnliches Benutzerkonto wurde auf einen Websiteadministrator hochgestuft. | -| `user.remove_email` | Eine E-Mail-Adresse wurde aus einem Benutzerkonto entfernt. | -| `user.rename` | Ein Benutzernamen wurde geändert. | -| `user.suspend` | Ein Benutzerkonto wurde durch einen Websiteadministrator gesperrt. | -| `user.two_factor_requested` | Ein Benutzer wurde zur Eingabe eines Zwei-Faktor-Authentifizierungscodes aufgefordert. | -| `user.unsuspend` | Ein Websiteadministrator hat die Sperrung eines Benutzerkontos aufgehoben. | diff --git a/translations/de-DE/content/admin/installation/command-line-utilities.md b/translations/de-DE/content/admin/installation/command-line-utilities.md deleted file mode 100644 index cc95f67f8f2a..000000000000 --- a/translations/de-DE/content/admin/installation/command-line-utilities.md +++ /dev/null @@ -1,787 +0,0 @@ ---- -title: Befehlszeilenprogramme -intro: '{% data variables.product.prodname_ghe_server %} enthält eine Vielzahl an Dienstprogrammen, mit denen bestimmte Probleme behoben oder bestimmte Aufgaben ausgeführt werden können.' -redirect_from: - - /enterprise/admin/articles/viewing-all-services/ - - /enterprise/admin/articles/command-line-utilities/ - - /enterprise/admin/installation/command-line-utilities -miniTocMaxHeadingLevel: 4 -versions: - enterprise-server: '*' ---- - -Sie können diese Befehle überall in der VM ausführen, nachdem Sie sich als ein SSH-Administratorbenutzer angemeldet haben. Weitere Informationen finden Sie unter „[Auf die Verwaltungsshell (SSH) zugreifen](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-administrative-shell-ssh/)“. - -### Allgemein - -#### ghe-announce - -Dieses Dienstprogramm liegt im oberen Bereich jeder {% data variables.product.prodname_enterprise %}-Seite einen Banner fest. Diesen können Sie verwenden, um Ihren Benutzer eine Mitteilung zu übermitteln. - -```shell -# Legt eine Nachricht fest, die für jedermann sichtbar ist -$ ghe-announce -s MESSAGE -> Announcement message set. -# Entfernt eine zuvor festgelegte Nachricht -$ ghe-announce -u -> Removed the announcement message -``` - -#### ghe-check-disk-usage - -Dieses Dienstprogramm überprüft den Datenträger auf große Dateien oder auf gelöschte Dateien mit weiterhin vorhandenen offenen Datei-Handles. Sie sollten dieses ausführen, wenn Sie versuchen, auf der Root-Partition Speicherplatz freizugeben. - -```shell -ghe-check-disk-usage -``` - -#### ghe-cleanup-caches - -Dieses Dienstprogramm bereinigt eine Vielzahl von Caches auf dem Root-Volume, die potenziell zusätzlichen Speicherplatz beanspruchen. Wenn Sie feststellen, dass sich Ihre Root-Volume-Speicherplatzauslastung mit der Zeit merklich erhöht, empfiehlt es sich, dieses Dienstprogramm auszuführen, um nachzuvollziehen, ob es die Gesamtnutzung reduzieren kann. - -```shell -ghe-cleanup-caches -``` -#### ghe-cleanup-settings - -Dieses Dienstprogramm löscht alle vorhandenen {% data variables.enterprise.management_console %}-Einstellungen. - -{% tip %} - -**Tipp**: {% data reusables.enterprise_enterprise_support.support_will_ask_you_to_run_command %} - -{% endtip %} - -```shell -ghe-cleanup-settings -``` - -#### ghe-config - -Mit diesem Dienstprogramm können Sie die Konfigurationseinstellungen von {% data variables.product.product_location_enterprise %} abrufen und ändern. - -```shell -$ ghe-config core.github-hostname -# Ruft den Konfigurationswert von „core.github-hostname“ ab -$ ghe-config core.github-hostname 'example.com' -# Legt den Konfigurationswert von „core.github-hostname“ auf „example.com“ fest -$ ghe-config -l -# Listet alle Konfigurationswerte auf -``` -Dadurch können Sie den UUID Ihres Knotens in `cluster.conf` ermitteln. - -``` shell - $ ghe-config _hostname_.uuid -``` - -#### ghe-config-apply - -Dieses Dienstprogramm wendet {% data variables.enterprise.management_console %}-Einstellungen an, lädt Systemdienste neu, bereitet ein Speichergerät vor, lädt Anwendungsdienste neu und führt ausstehende Datenbankmigrationen aus. It is equivalent to clicking **Save settings** in the {% data variables.enterprise.management_console %}'s web UI or to sending a POST request to [the `/setup/api/configure` endpoint](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#management-console). - -Sie müssen dies wahrscheinlich niemals manuell ausführen. Es ist jedoch verfügbar, wenn Sie den Prozess zum Speichern Ihrer Einstellungen über die SSH automatisieren möchten. - -```shell -ghe-config-apply -``` - -#### ghe-console - -Dieses Dienstprogramm öffnet die GitHub Rails-Konsole auf Ihrer {% data variables.product.prodname_enterprise %}-Appliance. {% data reusables.command_line.use_with_support_only %} - -```shell -ghe-console -``` - -#### ghe-dbconsole - -Dieses Dienstprogramm öffnet eine MySQL-Datenbanksitzung auf Ihrer {% data variables.product.prodname_enterprise %}-Appliance. {% data reusables.command_line.use_with_support_only %} - -```shell -ghe-dbconsole -``` - -#### ghe-es-index-status -Dieses Dienstprogramm gibt eine Zusammenfassung der ElasticSearch-Indizes im CSV-Format zurück. - -Eine Indexzusammenfassung mit einer Header-Kopfzeile für `STDOUT` ausgeben: -```shell -$ ghe-es-index-status -do -> warning: parser/current is loading parser/ruby23, which recognizes -> warning: 2.3.3-compliant syntax, but you are running 2.3.4. -> warning: please see https://github.com/whitequark/parser#compatibility-with-ruby-mri. -> Name,Primary,Searchable,Writable,UpToDate,RepairProgress,Version -> code-search-1,true,true,true,true,100.0,72e27df7c631b45e026b42bfef059328fa040e17 -> commits-5,true,true,true,true,100.0,7ed28813100c47813ef654c0ee2bb9abf21ab744 -> gists-4,true,true,true,true,100.0,cf8e7d04fcf2564c902e2873c424a279cc41079d -> issues-4,false,false,false,true,100.0,d0bb08f71eebf6e7b070572aa399b185dbdc8a76 -> issues-5,true,true,true,true,100.0,d0bb08f71eebf6e7b070572aa399b185dbdc8a76 -> projects-2,true,true,true,true,100.0,c5cac1c4b3c66d42e609d088d174dbc3dd44469a -> pull-requests-6,true,true,true,true,100.0,6a466ad6b896a3499509990979bf9a18d7d41de3 -> repos-6,true,true,true,true,100.0,6c8b5fbba0fc1e409558db411d05e092c1387082 -> users-5,true,true,true,true,100.0,38984875552bb826c9ec42999f409cb2e95556eb -> wikis-4,true,true,true,true,100.0,2613dec44bd14e14577803ac1f9e4b7e07a7c234 -``` - -Geben Sie eine Indexzusammenfassung und Pipe-Ergebnisse zur besseren Lesbarkeit für `column` aus: - -```shell -$ ghe-es-index-status -do | column -ts, -> warning: parser/current is loading parser/ruby23, which recognizes -> warning: 2.3.3-compliant syntax, but you are running 2.3.4. -> warning: please see https://github.com/whitequark/parser#compatibility-with-ruby-mri. -> Name Primary Searchable Writable UpToDate RepairProgress Version -> code-search-1 true true true true 100.0 72e27df7c631b45e026b42bfef059328fa040e17 -> commits-5 true true true true 100.0 7ed28813100c47813ef654c0ee2bb9abf21ab744 -> gists-4 true true true true 100.0 cf8e7d04fcf2564c902e2873c424a279cc41079d -> issues-4 false false false true 100.0 d0bb08f71eebf6e7b070572aa399b185dbdc8a76 -> issues-5 true true true true 100.0 d0bb08f71eebf6e7b070572aa399b185dbdc8a76 -> projects-2 true true true true 100.0 c5cac1c4b3c66d42e609d088d174dbc3dd44469a -> pull-requests-6 true true true true 100.0 6a466ad6b896a3499509990979bf9a18d7d41de3 -> repos-6 true true true true 100.0 6c8b5fbba0fc1e409558db411d05e092c1387082 -> users-5 true true true true 100.0 38984875552bb826c9ec42999f409cb2e95556eb -> wikis-4 true true true true 100.0 2613dec44bd14e14577803ac1f9e4b7e07a7c234 -``` - -#### ghe-legacy-github-services-report - -Dieses Dienstprogramm listet Repositorys auf Ihrer Appliance auf, die {% data variables.product.prodname_dotcom %} Services verwenden. Hierbei handelt es sich um eine Integrationsmethode, die am 1. Oktober 2018 eingestellt wird. Benutzer auf Ihrer Appliance haben {% data variables.product.prodname_dotcom %} Services möglicherweise so eingerichtet, dass für Push-Vorgänge an bestimmte Repositorys Benachrichtigungen erstellt werden. For more information, see "[Announcing the deprecation of {% data variables.product.prodname_dotcom %} Services](https://developer.github.com/changes/2018-04-25-github-services-deprecation/)" on {% data variables.product.prodname_blog %} or "[Replacing {% data variables.product.prodname_dotcom %} Services](/v3/guides/replacing-github-services/)." For more information about this command or for additional options, use the `-h` flag. - -```shell -ghe-legacy-github-services-report - -``` - -#### ghe-logs-tail - -Mit diesem Dienstprogramm können Sie das Ende aller relevanten Protokolldateien aus Ihrer Installation ausgeben. Sie können Optionen übergeben, um die Protokolle auf bestimmte Sätze zu begrenzen. Verwenden Sie das Flag „-h“, um zusätzliche Optionen anzuzeigen. - -```shell -ghe-logs-tail -``` - -#### ghe-maintenance - -Mit diesem Dienstprogramm können Sie den Wartungsmoduszustand der Installation steuern. Es soll primär von der {% data variables.enterprise.management_console %} im Hintergrund verwendet werden, kann jedoch auch direkt verwendet werden. - -```shell -ghe-maintenance -h -``` - -{% if currentVersion ver_gt "enterprise-server@2.17" %} -#### ghe-motd - -Dieses Dienstprogramm zeigt die Meldung des Tages (MOTD) an, die Administratoren sehen, wenn sie über die administrative Shell auf die Instanz zugreifen. Die Ausgabe enthält einen Überblick über den Status der Instanz. - -```shell -ghe-motd -``` -{% endif %} - -#### ghe-nwo - -Dieses Dienstprogramm gibt den Namen und den Inhaber eines Repositorys basierend auf der Repository-ID zurück. - -```shell -ghe-nwo REPOSITORY_ID -``` - -#### ghe-org-admin-promote - -Führen Sie diesen Befehl aus, um Benutzern mit Websiteadministratorberechtigungen Organisationsinhaberberechtigungen auf der Appliance zu erteilen oder um beliebigen einzelnen Benutzern in einer einzelnen Organisation Organisationsinhaberberechtigungen zu erteilen. Sie müssen einen Benutzer bzw. eine Organisation angeben. Der Befehl `ghe-org-admin-promote` fordert immer zur Bestätigung vor der Ausführung auf, sofern Sie nicht das Flag `-y` verwenden, um die Bestätigung zu umgehen. - -Die folgenden Optionen können Sie mit dem Dienstprogramm verwenden: - -- Das Flag `-u` gibt einen Benutzernamen an. Verwenden Sie dieses Flag, um einem bestimmten Benutzer Organisationsinhaberberechtigungen zu erteilen. Lassen Sie das Flag `-u` weg, um alle Websiteadministratoren für die angegebene Organisation hochzustufen. -- Das Flag `-o` gibt eine Organisation an. Verwenden Sie dieses Flag, um in einer bestimmten Organisation Inhaberberechtigungen zu erteilen. Lassen Sie das Flag `-o` weg, um dem angegebenen Websiteadministrator in allen Organisationen Inhaberberechtigungen zu erteilen. -- Das Flag `-a` erteilt allen Websiteadministratoren in allen Organisationen Inhaberberechtigungen. -- Das Flag `-y` umgeht die manuelle Bestätigung. - -Mit diesem Dienstprogramm ist es nicht möglich, einen Nicht-Websiteadministrator auf einen Inhaber sämtlicher Organisationen hochzustufen. Mit [ghe-user-promote](#ghe-user-promote) können Sie ein gewöhnliches Benutzerkonto auf einen Websiteadministrator hochstufen. - -Einem einzelnen Benutzer in einer bestimmten Organisation Organisationsinhaberberechtigungen erteilen - -```shell -ghe-org-admin-promote -u USERNAME -o ORGANIZATION -``` - -Einem bestimmten Websiteadministrator in allen Organisationen Organisationsinhaberberechtigungen erteilen - -```shell -ghe-org-admin-promote -u USERNAME -``` - -Allen Websiteadministratoren in einer bestimmten Organisation Organisationsinhaberberechtigungen erteilen - -```shell -ghe-org-admin-promote -o ORGANIZATION -``` - -Allen Websiteadministratoren in allen Organisationen Organisationsinhaberberechtigungen erteilen - -```shell -ghe-org-admin-promote -a -``` - -#### ghe-reactivate-admin-login - -Führen Sie diesen Befehl aus, um die {% data variables.enterprise.management_console %} nach 10 fehlerhaften Anmeldeversuchen innerhalb von 10 Minuten sofort zu entsperren. - -```shell -$ ghe-reactivate-admin-login -``` - -#### ghe-resque-info - -Dieses Dienstprogramm zeigt Informationen zu aktiven und zu in der Warteschlange befindlichen Hintergrundaufträgen an. Es zeigt dieselben Auftragszählnummern wie die Leiste mit den Administratorstatistiken im oberen Bereich jeder Seite an. - -Mit diesem Dienstprogramm kann ermittelt werden, ob der Resque-Server beim Verarbeiten der Hintergrundaufträge Probleme hat. Eines der folgenden Szenarien kann auf ein Problem mit Resque hinweisen: - -* Die Anzahl der Hintergrundaufträge wird erhöht, während die aktiven Aufträge identisch bleiben. -* Die Ereignis-Feeds werden nicht aktualisiert. -* Webhooks are not being triggered. -* Die Weboberfläche wird nach einem Git-Push nicht aktualisiert. - -Wenn Sie vermuten, dass Resque fehlschlägt, wenden Sie sich zur Unterstützung an {% data variables.contact.contact_ent_support %}. - -Mit diesem Befehl können Sie Aufträge in der Warteschlange zudem anhalten oder fortsetzen. - -```shell -$ ghe-resque-info -# Listet Warteschlangen und die Anzahl der aktuell in die Warteschlange versetzten Aufträge auf -$ ghe-resque-info -p QUEUE -# Hält die angegebene Warteschlange an -$ ghe-resque-info -r QUEUE -# Setzt die angegebene Warteschlange fort -``` - -#### ghe-saml-mapping-csv - -Dieses Dienstprogramm kann dabei helfen, SAML-Datensätze zuzuordnen. - -Um eine CSV-Datei mit allen SAML-Zuordnungen für Deine {% data variables.product.product_name %}-Benutzer zu erstellen: -```shell -$ ghe-saml-mapping-csv -d -``` - -Um einen Trockenlauf der Aktualisierung von SAML-Zuordnungen mit neuen Werten durchzuführen: -```shell -$ ghe-saml-mapping-csv -u -n -f /path/to/file -``` - -Um SAML-Zuordnungen mit neuen Werten zu aktualisieren: -```shell -$ ghe-saml-mapping-csv -u -f /path/to/file -``` - -#### ghe-service-list - -Mit diesem Dienstprogramm werden alle Dienste aufgelistet, die auf Ihrer Appliance gestartet oder angehalten (oder ausgeführt werden oder warten) wurden. - -```shell -$ ghe-service-list -start/running - - github-resqued, process 12711 - - github-unicorn, process 12726 - - github-gitauth, process 12743 - - git-daemon, process 12755 - - babeld, process 12771 - - github-svn-proxy, process 12802 - - gist-unicorn, process 12832 - - gist-resqued, process 12881 - - render-unicorn, process 12939 - - hookshot-unicorn, process 13076 - - nodeload2, process 13192 - - slumlord-unicorn, process 13304 - - ghe-storage, process 2012 - - enterprise-manage-unicorn, process 2024 - - enterprise-manage-resque, process 2053 - -stop/waiting - - ghe-replica-mode -``` - -{% tip %} - -Die von diesem Befehl zurückgegebenen Dienstnamen können mit „[`systemctl`](https://www.freedesktop.org/software/systemd/man/systemctl.html)“-Befehlen verwendet werden, um diese Dienste bei Bedarf zu beenden, zu starten oder erneut zu starten. Ein Beispiel: - -```shell -$ sudo systemctl restart github-resqued -``` - -Das Beenden von Diensten führt zu Ausfallzeiten Ihrer Installation, daher sollten Sie sich an {% data variables.contact.contact_ent_support %} wenden, bevor Sie einen Dienst beenden oder neu starten. - -{% endtip %} - -#### ghe-set-password - -Mit `ghe-set-password` können Sie ein neues Passwort festlegen, um sich bei der [{% data variables.enterprise.management_console %}](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-management-console) zu authentifizieren. - -```shell -ghe-set-password -``` - -#### ghe-ssh-check-host-keys - -Dieses Dienstprogramm gleicht die vorhandenen SSH-Hostschlüssel mit der Liste der bekannten kompromittierten SSH-Hostschlüssel ab. - -```shell -$ ghe-ssh-check-host-keys -``` - -Wenn ein kompromittierter Hostschlüssel gefunden wird, wird das Dienstprogramm mit dem Status `1` und der folgenden Meldung beendet: -```shell -> One or more of your SSH host keys were found in the blacklist. -> Please reset your host keys using ghe-ssh-roll-host-keys. -``` - -Wenn kein kompromittierter Hostschlüssel gefunden wurde, wird das Dienstprogramm mit dem Status `0` und der folgenden Meldung beendet: -```shell -> The SSH host keys were not found in the SSH host key blacklist. -> No additional steps are needed/recommended at this time. -``` - -#### ghe-ssh-roll-host-keys - -Dieses Dienstprogramm rotiert die SSH-Hostschlüssel und ersetzt sie durch neu generierte Schlüssel. - -```shell -$ sudo ghe-ssh-roll-host-keys -Proceed with rolling SSH host keys? This will delete the -existing keys in /etc/ssh/ssh_host_* and generate new ones. [y/N] - -# Drücken Sie auf „Y“, um den Löschvorgang zu bestätigen, oder verwenden Sie den Switch „-y“, um diese Eingabeaufforderung zu umgehen - -> SSH host keys have successfully been rolled. -``` - -#### ghe-ssh-weak-fingerprints - -Dieses Dienstprogramm gibt einen Bericht der bekannten unsicheren SSH-Schlüssel zurück, die auf der {% data variables.product.prodname_enterprise %}-Appliance gespeichert sind. Optional können Sie Benutzerschlüssel in einer Massenaktion widerrufen. Das Dienstprogramm meldet unsichere Systemschlüssel, die Sie in der [{% data variables.enterprise.management_console %}](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-management-console) manuell widerrufen müssen. - -```shell -# Bericht der unsicheren Benutzer- und SSH-Systemschlüssel ausgeben -$ ghe-ssh-weak-fingerprints - -# Alle unsicheren Benutzerschlüssel widerrufen -$ ghe-ssh-weak-fingerprints --revoke -``` - -#### ghe-ssl-acme - -Mit diesem Dienstprogramm können Sie ein Let's Encrypt-Zertifikat auf Ihrer {% data variables.product.prodname_enterprise %}-Appliance installieren. Weitere Informationen finden Sie unter „[TLS konfigurieren](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-tls)“. - -Du kannst das `-x` Flag verwenden, um die ACME-Konfiguration zu entfernen. - -```shell -ghe-ssl-acme -e -``` - -#### ghe-ssl-ca-certificate-install - -Mit diesem Dienstprogramm können Sie ein benutzerdefiniertes CA-Root-Zertifikat auf Ihrem {% data variables.product.prodname_enterprise %} Server erstellen. Das Zertifikat muss im PEM-Format vorliegen. Wenn Ihr Zertifikatsanbieter darüber hinaus mehrere CA-Zertifikate in eine einzelne Datei aufnimmt, müssen Sie sie in einzelne Dateien trennen, die Sie anschließend jeweils an `ghe-ssl-ca-certificate-install` weitergeben. - -Führen Sie dieses Dienstprogramm aus, um eine Zertifikatskette für die S/MIME-Commit-Signaturverifizierung hinzuzufügen. Weitere Informationen finden Sie unter „[Informationen zur Verifizierung einer Commit-Signatur](/enterprise/{{ currentVersion }}/user/articles/about-commit-signature-verification/)“. - -Führen Sie dieses Dienstprogramm aus, wenn {% data variables.product.product_location_enterprise %} keine Verbindung mit einem anderen Server herstellen kann, da Letzterer ein selbstsigniertes SSL-Zertifikat oder ein SSL-Zertifikat verwendet, wofür kein erforderliches CA-Bundle bereitgestellt wird. Eine Möglichkeit, dies zu bestätigen, besteht darin, `openssl s_client -connect host:port -verify 0 -CApath /etc/ssl/certs` auf {% data variables.product.product_location_enterprise %} auszuführen. Wenn das SSL-Zertifikat des Remote-Servers verifiziert werden kann, sollte Ihre `SSL-Sitzung` den Rückgabecode 0 aufweisen (siehe unten). - -``` -SSL-Session: - Protocol : TLSv1 - Cipher : AES128-SHA - Session-ID: C794EBCC3CBC10F747C9AFC029C03C1048FC99CFC34D13D7444E0F267C58DF4C - Session-ID-ctx: - Master-Key: 02A7C47CFD6EEC87D3C710E9DD87390E04EF82DDD7514AE03127D5DC1945FC0CAEFB5395791AEA598667EFA61B9EA8C5 - Key-Arg : None - Start Time: 1394581597 - Timeout : 300 (sec) - Verify return code: 0 (ok) -``` - -Wenn das SSL-Zertifikat des Remote-Servers *nicht* verifiziert werden kann, sollte Ihre `SSL-Sitzung` einen Rückgabecode ungleich null zurückgeben: - -``` -SSL-Session: - Protocol : TLSv1 - Cipher : AES128-SHA - Session-ID: 82CB288051A6DB66094C50A69CF1292AEE7E54C6B01B659B98AB336F8C33863E - Session-ID-ctx: - Master-Key: 01B025B2F764043A27919A8D1355AAECD8844FF0831B1D664042334790574A6F4025BAB085D4ED71D71AAB3091B849E5 - Key-Arg : None - Start Time: 1394581782 - Timeout : 300 (sec) - Verify return code: 27 (certificate not trusted) -``` - -Sie können die folgenden zusätzlichen Optionen mit dem Dienstprogramm verwenden: -- Mit dem Flag `-r` können Sie ein CA-Zertifikat deinstallieren. -- Mit dem Flag `-h` werden mehr Nutzungsinformationen angezeigt. - -```shell -ghe-ssl-ca-certificate-install -c /path/to/certificate -``` - -#### ghe-ssl-generate-csr - -Mit diesem Dienstprogramm können Sie einen privaten Schlüssel und eine Zertifikatsignierungsanforderung (Certificate Signing Request, CSR) generieren, die Sie für eine kommerzielle oder private Zertifizierungsstelle freigeben können, um ein gültiges Zertifikat abzurufen, das Sie für Ihre Instanz verwenden können. Weitere Informationen finden Sie unter „[TLS konfigurieren](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-tls)“. - -Verwenden Sie das Flag `-h`, um weitere Informationen zu diesem Befehl oder um zusätzliche Informationen anzuzeigen. - -```shell -ghe-ssl-generate-csr -``` - -#### ghe-storage-extend - -Einige Plattformen erfordern dieses Skript, um das Benutzer-Volume zu erweitern. Weitere Informationen finden Sie unter „[Speicherkapazität erhöhen](/enterprise/admin/guides/installation/increasing-storage-capacity/)“. - -```shell -$ ghe-storage-extend -``` - -#### ghe-version - -Dieses Dienstprogramm gibt die Version, Plattform und den Build von {% data variables.product.product_location_enterprise %} aus. - -```shell -$ ghe-version -``` - -#### ghe-webhook-logs - -Dieses Dienstprogramm gibt Webhook-Auslieferungsprotokolle für Administratoren zurück, damit diese Issues überprüfen und ermitteln können. - -```shell -ghe-webhook-logs -``` - -Um alle fehlgeschlagenen Hook-Auslieferungen vom Vortag anzuzeigen: -```shell -ghe-webhook-logs -f -a YYYYMMDD -``` - -Um die vollständige Hook-Nutzlast, das Ergebnis und alle Ausnahmen für die Lieferung anzuzeigen: -```shell -ghe-webhook-logs -g delivery-guid -v -``` - -Um globale Webhook-Lieferungen anzuzeigen: -```shell -ghe-webhook-logs --global -``` - -### Clustering - -#### ghe-cluster-support-bundle - -Dieses Dienstprogramm erstellt eine Support-Bundle-Tarball-Datei, die wichtige Protokolle von jedem Knoten in einer Geo-Replikation oder Clustering-Konfiguration enthält. - -Der Befehl erstellt standardmäßig die Tarball-Datei in */tmp*. Sie können die Tarball-Datei für das einfache Streaming über SSH auch mittels `cat` an `STDOUT` übertragen. Dies ist nützlich, wenn die Webbenutzeroberfläche nicht antwortet oder wenn der Download eines Support-Bundles von */setup/support* nicht funktioniert. Sie müssen diesen Befehl ausführen, wenn Sie ein *erweitertes* Bundle generieren möchten, das ältere Protokolle enthält. Sie können diesen Befehl auch ausführen, um das Cluster-Support-Bundle direkt für den {% data variables.product.prodname_enterprise %}-Support hochzuladen. - -Um ein Standardpaket zu erstellen: -```shell -$ ssh -p 122 admin@hostname -- 'ghe-cluster-support-bundle -o' > cluster-support-bundle.tgz -``` - -Um ein erweitertes Paket zu erstellen: -```shell -$ ssh -p 122 admin@hostname -- 'ghe-cluster-support-bundle -x -o' > cluster-support-bundle.tgz -``` - -Um ein Paket an {% data variables.contact.github_support %} zu senden: -```shell -$ ssh -p 122 admin@hostname -- 'ghe-cluster-support-bundle -u' -``` - -Um ein Paket an {% data variables.contact.github_support %} zu senden und das Paket mit einem Ticket zu verknüpfen: -```shell -$ ssh -p 122 admin@hostname -- 'ghe-cluster-support-bundle -t ticket-id' -``` - -#### ghe-dpages - -Mit diesem Dienstprogramm kannst Du den verteilten {% data variables.product.prodname_pages %} -Server verwalten. - -```shell -ghe-dpages -``` - -Um eine Zusammenfassung des Repository-Standorts und -Zustands anzuzeigen: -```shell -ghe-dpages status -``` - -Um einen {% data variables.product.prodname_pages %}-Speicherdienst zu evakuieren, bevor ein Cluster-Knoten evakuiert wird: -``` shell -ghe-dpages evacuate pages-server- -``` - -#### ghe-spokes - -Mit diesem Dienstprogramm können Sie die drei Kopien jedes Repositorys auf den verteilten Git-Servern verwalten. - -```shell -ghe-spokes -``` - -Um eine Zusammenfassung des Repository-Standorts und -Zustands anzuzeigen: - -```shell -ghe-spokes status -``` - -Um die Server anzuzeigen, auf denen das Repository gespeichert ist: - -```shell -ghe-spokes route -``` - -Um Speicherdienste auf einem Cluster-Knoten zu evakuieren: - -``` shell -ghe-spokes server evacuate git-server- -``` - -#### ghe-storage - -Mit diesem Dienstprogramm können Sie alle Speicherdienste evakuieren, bevor Sie einen Clusterknoten evakuieren. - -``` shell -ghe-storage evacuate storage-server- -``` - -### Git - -#### ghe-btop - -Eine `top`-ähnliche Schnittstelle für alle Git-Vorgänge. - -```shell -ghe-btop [ | --help | --usage ] -``` - -#### ghe-repo - -Mit diesem Dienstprogramm können Sie das Verzeichnis eines Repositorys ändern und als der Benutzer `git` eine interaktive Shell öffnen. Durch Ausführung der Befehle `git-*` oder `git-nw-*` können Sie die manuelle Untersuchung oder Wartung eines Repositorys durchführen. - -```shell -ghe-repo username/reponame -``` - -#### ghe-repo-gc - -Mit diesem Dienstprogramm wird ein Repository-Netzwerk neu gepackt, um den Paketspeicher zu optimieren. Wenn Sie über ein großes Repository verfügen, wird seine Größe durch die Ausführung dieses Befehls ggf. reduziert. {% data variables.product.prodname_enterprise %} führt diesen Befehl automatisch während der gesamten Interaktion mit einem Repository-Netzwerk aus. - -Sie können das optionale Argument `--prune` hinzufügen, um nicht erreichbare Git-Objekte zu entfernen, auf die weder über einen Branch noch über ein Tag oder andere Refs verwiesen wird. Dies ist besonders nützlich zum sofortigen Entfernen [zuvor gelöschter sensibler Informationen](/enterprise/user/articles/remove-sensitive-data/). - -```shell -ghe-repo-gc username/reponame -``` - -### Import und Export - -#### ghe-migrator - -`ghe-migrator` ist ein hochwertiges Tool für die Migration von einer GitHub-Instanz zu einer anderen. Sie können Ihre Instanzen konsolidieren oder Ihre Organisation, Benutzer, Teams und Repositorys von GitHub.com nach {% data variables.product.prodname_enterprise %} verschieben. - -Weitere Informationen finden Sie in unserem Leitfaden [Benutzer-, Organisations- und Repository-Daten migrieren](/enterprise/admin/guides/migrations/). - -#### git-import-detect - -Ermittelt anhand einer URL, welcher Quellcodeverwaltungssystem-Typ sich am anderen Ende befindet. Während eines manuellen Imports ist dieser wahrscheinlich bereits bekannt. Dies kann jedoch bei automatisierten Skripts sehr nützlich sein. -```shell -git-import-detect -``` - -#### git-import-hg-raw - -Dieses Hilfsprogramm importiert ein Mercurial-Repository in dieses Git-Repository. Weitere Informationen findest Du unter „[Daten aus Versionskontroll-Systemen von Drittanbietern importieren](/enterprise/admin/guides/migrations/importing-data-from-third-party-version-control-systems/)“. -```shell -git-import-hg-raw -``` - -#### git-import-svn-raw - -Dieses Dienstprogramm importiert Daten über den Subversion-Verlauf und über Dateien in einen Git-Branch. Dies ist eine direkte Kopie der Struktur, wobei Trunk- oder Branch-Unterscheidungen ignoriert werden. Weitere Informationen findest Du unter „[Daten aus Versionskontroll-Systemen von Drittanbietern importieren](/enterprise/admin/guides/migrations/importing-data-from-third-party-version-control-systems/)“. -```shell -git-import-svn-raw -``` - -#### git-import-tfs-raw - -Dieses Hilfsprogramm importiert von Team Foundation Version Control. Weitere Informationen findest Du unter „[Daten aus Versionskontroll-Systemen von Drittanbietern importieren](/enterprise/admin/guides/migrations/importing-data-from-third-party-version-control-systems/)“. -```shell -git-import-tfs-raw -``` - -#### git-import-rewrite - -Dieses Dienstprogramm schreibt das importierte Repository erneut. Dies gibt Dir die Möglichkeit, Autoren umzubenennen, und erzeugt für Subversion und TFS auf Ordnern basierende Git-Branches. Weitere Informationen findest Du unter „[Daten aus Versionskontroll-Systemen von Drittanbietern importieren](/enterprise/admin/guides/migrations/importing-data-from-third-party-version-control-systems/)“. -```shell -git-import-rewrite -``` - -### Unterstützung - -#### ghe-diagnostics - -Dieses Dienstprogramm führt eine Vielzahl an Überprüfungen durch und erfasst Informationen zu Ihrer Installation, die Sie an den Support senden können, damit der Support Ihre Probleme diagnostizieren kann. - -Derzeit ähnelt die Ausgabe dieses Dienstprogramms dem Herunterladen der Diagnoseinformationen in der {% data variables.enterprise.management_console %}. Im Laufe der Zeit können ihr jedoch zusätzliche Verbesserungen hinzugefügt werden, die auf der Webbenutzeroberfläche nicht verfügbar sind. Weitere Informationen finden Sie unter „[Diagnosedateien erstellen und freigeben](/enterprise/admin/guides/enterprise-support/providing-data-to-github-support#creating-and-sharing-diagnostic-files)“. - -```shell -ghe-diagnostics -``` - -#### ghe-support-bundle - -{% data reusables.enterprise_enterprise_support.use_ghe_cluster_support_bundle %} -Dieses Dienstprogramm erstellt eine Support-Bundle-Tarball-Datei, die wichtige Protokolle aus Ihrer Instanz enthält. - -Der Befehl erstellt standardmäßig die Tarball-Datei in */tmp*. Sie können die Tarball-Datei für das einfache Streaming über SSH auch mittels `cat` an `STDOUT` übertragen. Dies ist nützlich, wenn die Webbenutzeroberfläche nicht antwortet oder wenn der Download eines Support-Bundles von */setup/support* nicht funktioniert. Sie müssen diesen Befehl ausführen, wenn Sie ein *erweitertes* Bundle generieren möchten, das ältere Protokolle enthält. Sie können diesen Befehl auch ausführen, um das Support-Bundle direkt für den {% data variables.product.prodname_enterprise %}-Support hochzuladen. - -Um ein Standardpaket zu erstellen: -```shell -$ ssh -p 122 admin@hostname -- 'ghe-support-bundle -o' > support-bundle.tgz -``` - -Um ein erweitertes Paket zu erstellen: -```shell -$ ssh -p 122 admin@hostname -- 'ghe-support-bundle -x -o' > support-bundle.tgz -``` - -Um ein Paket an {% data variables.contact.github_support %} zu senden: -```shell -$ ssh -p 122 admin@hostname -- 'ghe-support-bundle -u' -``` - -Um ein Paket an {% data variables.contact.github_support %} zu senden und das Paket mit einem Ticket zu verknüpfen: - -```shell -$ ssh -p 122 admin@hostname -- 'ghe-support-bundle -t ticket-id' -``` - -#### ghe-support-upload - -Dieses Dienstprogramm sendet Informationen von Ihrer Appliance an den {% data variables.product.prodname_enterprise %}-Support. Sie können eine lokale Datei oder einen Datenstrom von bis zu 100 MB über `STDIN` angeben. Optional können die hochgeladenen Daten einem Supportticket zugeordnet werden. - -Um eine Datei an {% data variables.contact.github_support %} zu senden und die Datei mit einem Ticket zu verknüpfen: -```shell -ghe-support-upload -f path/to/your/file -t ticket-id -``` - -Um Daten über `STDIN` hochzuladen und die Daten mit einem Ticket verknüpfen: -```shell -ghe-repl-status -vv | ghe-support-upload -t ticket-id -d "Verbose Replication Status" -``` - -In diesem Beispiel sendet `ghe-repl-status -vv` ausführliche Statusinformationen von einer Replikat-Appliance. Sie sollten `ghe-repl-status -vv` durch die bestimmten Daten, die Sie an `STDIN` streamen möchten, und `Verbose Replication Status` (Ausführlicher Replikationsstatus) durch eine kurze Beschreibung der Daten ersetzen. {% data reusables.enterprise_enterprise_support.support_will_ask_you_to_run_command %} - -### Upgrade von {% data variables.product.prodname_ghe_server %} - -#### ghe-upgrade - -Dieses Dienstprogramm installiert oder verifiziert ein Upgrade-Paket. Darüber hinaus können Sie dieses Dienstprogramm verwenden, um ein Rollback einer Patch-Veröffentlichung auszuführen, wenn ein Upgrade fehlschlägt oder unterbrochen wird. Weitere Informationen finden Sie unter „[Upgrade von {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-github-enterprise-server/)“. - -Um ein Upgrade-Paket zu überprüfen: -```shell -ghe-upgrade --verify UPGRADE-PACKAGE-FILENAME -``` - -Um ein Upgrade-Paket zu installieren: -```shell -ghe-upgrade UPGRADE-PACKAGE-FILENAME -``` - -{% data reusables.enterprise_installation.command-line-utilities-ghe-upgrade-rollback %} - -#### ghe-upgrade-scheduler - -Dieses Dienstprogramm verwaltet die geplante Installation von Upgrade-Paketen. Sie können geplante Installationen anzeigen, neu erstellen oder entfernen. Pläne müssen mit Cron-Ausdrücken erstellt werden. Weitere Informationen finden Sie im [Wikipedia-Eintrag zu Cron](https://de.wikipedia.org/wiki/Cron#Overview). - -Um eine neue Installation für ein Paket einzuplanen: -```shell -$ ghe-upgrade-scheduler -c "0 2 15 12 *" UPGRADE-PACKAGE-FILENAME -``` - -Um eingeplante Installationen für ein Paket anzuzeigen: -```shell -$ ghe-upgrade-scheduler -s UPGRADE PACKAGE FILENAME -> 0 2 15 12 * /usr/local/bin/ghe-upgrade -y -s UPGRADE-PACKAGE-FILENAME > /data/user/common/UPGRADE-PACKAGE-FILENAME.log 2>&1 -``` - -Um eingeplante Installationen für ein Paket zu entfernen: -```shell -$ ghe-upgrade-scheduler -r UPGRADE PACKAGE FILENAME -``` - -#### ghe-update-check - -Dieses Dienstprogramm überprüft, ob eine neue Patch-Veröffentlichung von {% data variables.product.prodname_enterprise %} verfügbar ist. Falls dies der Fall und auf Ihrer Instanz Speicherplatz verfügbar ist, wird das Paket heruntergeladen. Es wird standardmäßig unter */var/lib/ghe-updates* gespeichert. Anschließend kann ein Administrator [das Upgrade durchführen](/enterprise/admin/guides/installation/updating-the-virtual-machine-and-physical-resources/). - -Eine Datei mit dem enthaltenen Downloadstatus ist unter */var/lib/ghe-updates/ghe-update-check.status* verfügbar. - -Verwenden Sie den Switch `-i`, um nach der neuesten {% data variables.product.prodname_enterprise %}-Version zu suchen. - -```shell -$ ssh -p 122 admin@hostname -- 'ghe-update-check' -``` - -### Benutzerverwaltung - -#### ghe-license-usage - -Dieses Dienstprogramm exportiert eine Liste von Benutzern der Installation im JSON-Format. Wenn Deine Instanz mit der {% data variables.product.prodname_ghe_cloud %} verbunden ist, verwendet der {% data variables.product.prodname_ghe_server %} diese Informationen, um Lizenzinformationen an die {% data variables.product.prodname_ghe_cloud %} zu melden. Weitere Informationen findest Du unter „[{% data variables.product.prodname_ghe_server %} mit {% data variables.product.prodname_ghe_cloud %} verbinden](/enterprise/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud).“ - -Standardmäßig wird die Liste der Benutzer in der resultierenden JSON-Datei verschlüsselt. Verwenden Sie das Flag `-h`, um weitere Optionen anzuzeigen. - -```shell -ghe-license-usage -``` - -#### ghe-org-membership-update - -Dieses Dienstprogramm erzwingt die standardmäßige Einstellung für die Sichtbarkeit von Mitgliedschaften in der Organisation für alle Mitglieder auf Ihrer Instanz. Weitere Informationen finden Sie unter „[Sichtbarkeit für die Organisationsmitgliedschaft konfigurieren](/enterprise/{{ currentVersion }}/admin/guides/user-management/configuring-visibility-for-organization-membership)“. Die Einstellungsoptionen sind `public` (öffentlich) oder `private` (privat). - -```shell -ghe-org-membership-update --visibility=SETTING -``` - -#### ghe-user-csv - -Dieses Dienstprogramm exportiert eine Liste aller Benutzer in der Installation im CSV-Format. Die CSV-Datei enthält die E-Mail-Adresse, welchen Benutzertyp sie aufweisen (z. B. Administrator, Benutzer), über wie viele Repositorys, SSH-Schlüssel und Organisationsmitgliedschaften sie verfügen, wie die letzte protokollierte IP-Adresse lautet usw. Verwenden Sie das Flag `-h`, um weitere Optionen anzuzeigen. - -```shell -ghe-user-csv -o > users.csv -``` - -#### ghe-user-demote - -Dieses Dienstprogramm stuft den angegebenen Benutzer vom Administratorstatus auf einen gewöhnlichen Benutzer zurück. Sie sollten die Webbenutzeroberfläche verwenden, um diese Aktion durchzuführen, dieses Dienstprogramm jedoch für den Fall bereitstellen, dass das Dienstprogramm `ghe-user-promote` einen fehlerhaften Zustand aufweist und Sie einen Benutzer erneut über die CLI zurückstufen müssen. - -```shell -ghe-user-demote some-user-name -``` - -#### ghe-user-promote - -Dieses Dienstprogramm stuft das angegebene Benutzerkonto auf einen Websiteadministrator hoch. - -```shell -ghe-user-promote some-user-name -``` - -#### ghe-user-suspend - -Dieses Dienstprogramm sperrt den angegebenen Benutzer und hindert ihn daran, sich anzumelden oder Elemente per Push-Vorgang an Ihre Repositorys zu übertragen oder aus diesen abzurufen. - -```shell -ghe-user-suspend some-user-name -``` - -#### ghe-user-unsuspend - -Dieses Dienstprogramm entsperrt den angegebenen Benutzer und gewährt ihm Zugriff, um sich anzumelden und um Elemente per Push-Vorgang an Ihre Repositorys zu übertragen und aus ihnen abzurufen. - -```shell -ghe-user-unsuspend some-user-name -``` diff --git a/translations/de-DE/content/admin/installation/configuring-a-hostname.md b/translations/de-DE/content/admin/installation/configuring-a-hostname.md deleted file mode 100644 index a672a403924f..000000000000 --- a/translations/de-DE/content/admin/installation/configuring-a-hostname.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: Hostname konfigurieren -intro: 'Es wird empfohlen, dass Sie einen Hostnamen für Ihre Appliance festlegen, anstatt eine hartcodierte IP-Adresse zu verwenden.' -redirect_from: - - /enterprise/admin/guides/installation/configuring-hostnames/ - - /enterprise/admin/installation/configuring-a-hostname -versions: - enterprise-server: '*' ---- - -Wenn Sie einen Hostnamen konfigurieren, anstatt eine hartcodierte IP-Adresse zu verwenden, können Sie die physische Hardware ändern, auf der {% data variables.product.product_location_enterprise %} ausgeführt wird, ohne dass sich dies auf die Benutzer oder auf die Clientsoftware auswirkt. - -Die Einstellung des Hostnamens in der {% data variables.enterprise.management_console %} sollte auf einen geeigneten vollqualifizierten Domainnamen (FQDN) gesetzt werden, der im Internet oder in Deinem internen Netzwerk auflösbar ist. So könnte Ihre Hostnameneinstellung beispielsweise `github.companyname.com` lauten. Darüber hinaus wird empfohlen, die Subdomain-Isolation für den gewünschten Hostnamen zu aktivieren, um verschiedene Cross-Site-Scripting-Stilschwachstellen abzuschwächen. Weitere Informationen zu den Hostnameneinstellungen finden Sie in [Abschnitt 2.1 im HTTP RFC](https://tools.ietf.org/html/rfc1123#section-2). - -{% data reusables.enterprise_installation.changing-hostname-not-supported %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.hostname-menu-item %} -4. Geben Sie den Hostnamen ein, den Sie für {% data variables.product.product_location_enterprise %} festlegen möchten.![Feld zum Festlegen eines Hostnamens](/assets/images/enterprise/management-console/hostname-field.png) -5. Klicken Sie zum Testen der DNS- und SSL-Einstellungen für den neuen Hostnamen auf **Test domain settings** (Domain-Einstellungen testen). ![Schaltfläche zum Testen der Domain-Einstellungen](/assets/images/enterprise/management-console/test-domain-settings.png) -{% data reusables.enterprise_management_console.test-domain-settings-failure %} -{% data reusables.enterprise_management_console.save-settings %} - -Nach der Konfiguration eines Hostnamens sollten Sie die Subdomain-Isolation für {% data variables.product.product_location_enterprise %} aktivieren. Weitere Informationen finden Sie unter „[Subdomain-Isolation aktivieren](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-subdomain-isolation/)“. diff --git a/translations/de-DE/content/admin/installation/configuring-an-outbound-web-proxy-server.md b/translations/de-DE/content/admin/installation/configuring-an-outbound-web-proxy-server.md deleted file mode 100644 index 695e11dc0009..000000000000 --- a/translations/de-DE/content/admin/installation/configuring-an-outbound-web-proxy-server.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Ausgehenden Webproxyserver konfigurieren -intro: 'Ein Proxyserver bietet eine zusätzliche Sicherheitsebene für {% data variables.product.product_location_enterprise %}.' -redirect_from: - - /enterprise/admin/guides/installation/configuring-a-proxy-server/ - - /enterprise/admin/installation/configuring-an-outbound-web-proxy-server -versions: - enterprise-server: '*' ---- - -Wenn ein Proxyserver für {% data variables.product.product_location_enterprise %} aktiviert wird, werden ausgehende Nachrichten, die von {% data variables.product.prodname_ghe_server %} gesendet wurden, zunächst über den Proxyserver gesendet, sofern der Zielhost nicht als HTTP-Proxyausschluss hinzugefügt wurde. Zu den Typen ausgehender Nachrichten zählen ausgehende Webhooks, das Hochladen von Bundles und das Abrufen von veralteten Avataren. Die URL des Proxyservers ist das Protokoll, die Domain oder IP-Adresse plus die Portnummer, also beispielsweise `http://127.0.0.1:8123`. - -{% note %} - -**Hinweis:** Um zwischen {% data variables.product.product_location_enterprise %} und {% data variables.product.prodname_dotcom_the_website %} eine Verbindung herzustellen, muss Ihre Proxykonfiguration die Konnektivität zwischen `github.com` und `api.github.com` zulassen. Weitere Informationen finden Sie unter „[{% data variables.product.prodname_ghe_server %} mit {% data variables.product.prodname_dotcom_the_website %}](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/connecting-github-enterprise-server-to-github-com) verbinden“. - -{% endnote %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -4. Geben Sie unter **HTTP Proxy Server** (HTTP-Proxyserver) die URL Ihres Proxyservers ein. ![Feld zur Eingabe der HTTP-Proxyserver-URL](/assets/images/enterprise/management-console/http-proxy-field.png) -5. Geben Sie optional unter **HTTP Proxy Exclusion** (HTTP-Proxyausschluss) die Hosts ein, für die kein Proxyzugriff erforderlich ist. Trennen Sie dabei die Hosts durch Kommas voneinander. ![Feld zur Eingabe von HTTP-Proxyausschlüssen](/assets/images/enterprise/management-console/http-proxy-exclusion-field.png) -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/de-DE/content/admin/installation/configuring-applications.md b/translations/de-DE/content/admin/installation/configuring-applications.md deleted file mode 100644 index de302ce70df2..000000000000 --- a/translations/de-DE/content/admin/installation/configuring-applications.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: Anwendungen konfigurieren -intro: 'Sie können interne Anwendungseinstellungen für {% data variables.product.product_location_enterprise %} konfigurieren.' -redirect_from: - - /enterprise/admin/installation/configuring-applications -versions: - enterprise-server: '*' ---- - -### Bildzwischenspeicherung anpassen - -Sie können auswählen, wie lange {% data variables.product.product_location_enterprise %} Avatare speichert. Beim Erhöhen der Cache-Zeit erhöhen Sie die Zeit, die der Avatar eines Benutzers zum Laden benötigt. Wird die Cache-Zeit mit einem zu niedrigen Wert konfiguriert, kann dies zur Überladung von {% data variables.product.product_location_enterprise %}-Arbeitsprozessen führen. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -3. Klicken Sie auf der linken Seitenleiste auf **Applications** (Anwendungen). ![Registerkarte „Applications“ (Anwendungen) auf der Seitenleiste mit den Einstellungen](/assets/images/enterprise/management-console/sidebar-applications.png) -4. Geben Sie unter „Avatar image cache time (seconds)“ (Avatarbild-Cache-Zeit (Sekunden)) ein, wie viele Sekunden {% data variables.product.product_location_enterprise %} Avatarbilder zwischenspeichern soll. ![Formularfeld für die Zwischenspeicherung von Avatarbildern](/assets/images/enterprise/management-console/add-image-caching-value-field.png) -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/de-DE/content/admin/installation/configuring-backups-on-your-appliance.md b/translations/de-DE/content/admin/installation/configuring-backups-on-your-appliance.md deleted file mode 100644 index 58049c65ac5a..000000000000 --- a/translations/de-DE/content/admin/installation/configuring-backups-on-your-appliance.md +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: Backups auf Ihrer Appliance konfigurieren -redirect_from: - - /enterprise/admin/categories/backups-and-restores/ - - /enterprise/admin/articles/backup-and-recovery/ - - /enterprise/admin/articles/backing-up-github-enterprise/ - - /enterprise/admin/articles/restoring-github-enterprise/ - - /enterprise/admin/articles/backing-up-repository-data/ - - /enterprise/admin/articles/restoring-enterprise-data/ - - /enterprise/admin/articles/restoring-repository-data/ - - /enterprise/admin/articles/backing-up-enterprise-data/ - - /enterprise/admin/guides/installation/backups-and-disaster-recovery/ - - /enterprise/admin/installation/configuring-backups-on-your-appliance -intro: 'Im Rahmen eines Disaster Recovery-Plans können Sie die Produktionsdaten auf {% data variables.product.product_location_enterprise %} schützen, indem Sie automatisierte Backups konfigurieren.' -versions: - enterprise-server: '*' ---- - -### Informationen zu {% data variables.product.prodname_enterprise_backup_utilities %} - -{% data variables.product.prodname_enterprise_backup_utilities %} ist ein Backup-System, das Sie auf einem separaten Host installieren, der in regelmäßigen Intervallen über eine sichere SSH-Netzwerkverbindung Backup-Snapshots von {% data variables.product.product_location_enterprise %} erstellt. Mit einem Snapshot können Sie eine vorhandene {% data variables.product.prodname_ghe_server %}-Instanz in einem vorherigen Zustand auf dem Backup-Host wiederherstellen. - -Nur die seit dem letzten Snapshot hinzugefügten Daten werden über das Netzwerk übertragen und belegen zusätzlichen physischen Speicherplatz. Zum Minimieren der Auswirkung auf die Leistung werden Backups online unter der niedrigsten CPU-/E/A-Priorität durchgeführt. Zum Durchführen eines Backups muss kein Wartungsfenster geplant werden. - -Ausführlichere Informationen zu Features, Anforderungen und zur erweiterten Nutzung finden Sie in der [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#readme). - -### Voraussetzungen - -Sie müssen über ein von {% data variables.product.product_location_enterprise %} getrenntes Linux- oder Unix-Hostsystem verfügen, um {% data variables.product.prodname_enterprise_backup_utilities %} verwenden zu können. - -Sie können {% data variables.product.prodname_enterprise_backup_utilities %} auch zur langfristigen dauerhaften Speicherung von kritischen Daten in eine vorhandene Umgebung integrieren. - -Es wird empfohlen, dass der Backup-Host und {% data variables.product.product_location_enterprise %} geografisch voneinander getrennt sind. Dadurch wird gewährleistet, dass Backups wiederhergestellt werden können, falls am Hauptstandort eine schwere Katastrophe oder ein Netzwerkausfall auftritt. - -Die Anforderungen an den physischen Speicher variieren basierend auf der Git-Repository-Festplattennutzung und den erwarteten Wachstumsmustern: - -| Hardware | Empfehlung | -| ------------------- | ------------------------------------------------------------- | -| **vCPUs** | 2 | -| **Arbeitsspeicher** | 2 GB | -| **Speicher** | Das Fünffache des zugeordneten Speichers der primären Instanz | - -Entsprechend Ihrer Nutzung, beispielsweise in Bezug auf die Benutzeraktivität und die ausgewählten Integrationen, sind möglicherweise mehr Ressourcen erforderlich. - -### {% data variables.product.prodname_enterprise_backup_utilities %} installieren - -{% note %} - -**Hinweis:** Um sicherzustellen, dass eine wiederhergestellte Appliance sofort verfügbar ist, sollten Sie Backups durchführen, die selbst in einer Geo-Replikationskonfiguration auf die primäre Instanz abzielen. - -{% endnote %} - -1. Laden Sie die neueste [{% data variables.product.prodname_enterprise_backup_utilities %}-Version](https://github.com/github/backup-utils/releases) herunter, und extrahieren Sie die Datei mit dem Befehl `tar`. - ```shell - $ tar -xzvf /path/to/github-backup-utils-vMAJOR.MINOR.PATCH.tar.gz - ``` -2. Kopieren Sie die enthaltene Datei `backup.config-example` nach `backup.config`, und öffnen Sie sie in einem Editor. -3. Legen Sie den Wert `GHE_HOSTNAME` auf den Hostnamen oder die IP-Adresse Ihrer primären {% data variables.product.prodname_ghe_server %}-Instanz fest. -4. Legen Sie den Wert `GHE_DATA_DIR` auf den Dateisystempfad fest, unter dem Sie Backup-Snapshots speichern möchten. -5. Öffnen Sie unter `https://HOSTNAME/setup/settings` die Seite mit den Einstellungen Ihrer primären Instanz, und fügen Sie der Liste der autorisierten SSH-Schlüssel den SSH-Schlüssel des Backup-Hosts hinzu. Weitere Informationen finden Sie unter „[Auf die Verwaltungsshell (SSH) zugreifen](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-administrative-shell-ssh/)“. -5. Führen Sie den Befehl `ghe-host-check` aus, um die SSH-Konnektivität mit {% data variables.product.product_location_enterprise %} zu verifizieren. - ```shell - $ bin/ghe-host-check - ``` - 6. Führen Sie den Befehl `ghe-backup` aus, um ein anfängliches vollständiges Backup zu erstellen. - ```shell - $ bin/ghe-backup - ``` - -Weitere Informationen zur erweiterten Nutzung finden Sie in der [{% data variables.product.prodname_enterprise_backup_utilities %}-Datei 'README.md'](https://github.com/github/backup-utils#readme). - -### Backup planen - -Mithilfe des Befehls `cron(8)` oder eines ähnlichen Diensts zum Planen von Befehlen können Sie regelmäßige Backups auf dem Backup-Host planen. Die konfigurierte Backup-Häufigkeit schreibt das Worst Case Recovery Point Objective (RPO) in Ihrem Wiederherstellungsplan vor. Angenommen, Sie haben das Backup so geplant, dass es täglich um Mitternacht ausgeführt wird. In diesem Fall könnten Sie in einem Notfallszenario bis zu 24 Stunden an Daten verlieren. Es wird empfohlen, mit einem stündlichen Backup-Plan zu beginnen. Dadurch wird garantiert, dass schlimmstenfalls maximal eine Stunde an Daten am Hauptstandort vernichtet wird. - -Wenn sich Backup-Versuche überschneiden, wird der Befehl `ghe-backup` mit einer Fehlermeldung abgebrochen. Diese gibt an, dass ein gleichzeitiges Backup vorhanden ist. In diesem Fall wird empfohlen, die Häufigkeit Ihrer geplanten Backups zu verringern. Weitere Informationen finden Sie im Abschnitt „Backups planen“ der [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#scheduling-backups). - -### Backup wiederherstellen - -Im Falle eines längeren Ausfalls oder einer Katastrophe am Hauptstandort können Sie {% data variables.product.product_location_enterprise %} wiederherstellen. Stellen Sie dazu eine andere {% data variables.product.prodname_enterprise %}-Appliance bereit, und führen Sie auf dem Backup-Host eine Wiederherstellung aus. Sie müssen der Ziel-{% data variables.product.prodname_enterprise %}-Appliance den SSH-Schlüssel des Backup-Hosts als einen autorisierten SSH-Schlüssel hinzufügen, bevor Sie eine Appliance wiederherstellen. - -Führen Sie den Befehl `ghe-restore` aus, um den letzten erfolgreichen {% data variables.product.product_location_enterprise %}-Snapshot wiederherzustellen. Es sollte in etwa folgende Ausgabe angezeigt werden: - -```shell -$ ghe-restore -c 169.154.1.1 -> Checking for leaked keys in the backup snapshot that is being restored ... -> * No leaked keys found -> Connect 169.154.1.1:122 OK (v2.9.0) - -> WARNING: All data on GitHub Enterprise appliance 169.154.1.1 (v2.9.0) -> will be overwritten with data from snapshot 20170329T150710. -> Please verify that this is the correct restore host before continuing. -> Type 'yes' to continue: yes - -> Starting restore of 169.154.1.1:122 from snapshot 20170329T150710 -# ...Ausgabe gekürzt -> Completed restore of 169.154.1.1:122 from snapshot 20170329T150710 -> Visit https://169.154.1.1/setup/settings to review appliance configuration. -``` - -{% note %} - -**Hinweis:** Die Netzwerkeinstellungen sind aus dem Backup-Snapshot ausgeschlossen. Sie müssen das Netzwerk auf der Ziel-{% data variables.product.prodname_ghe_server %}-Appliance manuell konfigurieren, wie dies für Ihre Umgebung erforderlich ist. - -{% endnote %} - -Sie können diese zusätzlichen Optionen mit dem Befehl `ghe-restore` verwenden: -- Das Flag `-c` überschreibt die Einstellungen, Zertifikate und Lizenzdaten auf dem Ziel-Host, selbst wenn es bereits konfiguriert ist. Lassen Sie dieses Flag weg, wenn Sie eine Testinstanz für Testzwecke einrichten und Sie die vorhandene Konfiguration auf dem Ziel beibehalten möchten. Weitere Informationen finden Sie unter „Backup- und Wiederherstellungsbefehle verwenden“ der [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#using-the-backup-and-restore-commands). -- Mit dem Flag `-s` können Sie einen anderen Backup-Snapshot auswählen. - diff --git a/translations/de-DE/content/admin/installation/configuring-built-in-firewall-rules.md b/translations/de-DE/content/admin/installation/configuring-built-in-firewall-rules.md deleted file mode 100644 index 2b1622edd10d..000000000000 --- a/translations/de-DE/content/admin/installation/configuring-built-in-firewall-rules.md +++ /dev/null @@ -1,115 +0,0 @@ ---- -title: Integrierte Firewallregeln konfigurieren -intro: 'Sie können standardmäßige Firewallregeln anzeigen und Regeln für {% data variables.product.product_location_enterprise %} anpassen.' -redirect_from: - - /enterprise/admin/guides/installation/configuring-firewall-settings/ - - /enterprise/admin/installation/configuring-built-in-firewall-rules -versions: - enterprise-server: '*' ---- - -### Informationen zur Firewall der {% data variables.product.product_location_enterprise %} - -{% data variables.product.prodname_ghe_server %} verwendet die Uncomplicated Firewall (UFW) von Ubuntu auf der virtuellen Appliance. Weitere Informationen finden Sie unter „[UFW](https://help.ubuntu.com/community/UFW)“ in der Ubuntu-Dokumentation. {% data variables.product.prodname_ghe_server %} automatically updates the firewall allowlist of allowed services with each release. - -Nachdem Sie {% data variables.product.prodname_ghe_server %} installiert haben, werden automatisch alle erforderlichen Netzwerkports zum Akzeptieren der Verbindungen geöffnet. Jeder nicht erforderliche Port wird automatisch als `deny` (verweigern) konfiguriert, und die standardmäßige Richtlinie für ausgehende Verbindungen wird als `allow` (zulassen) konfiguriert. Die Zustandsverfolgung ist für neue Verknüpfungen aktiviert. In der Regel handelt es sich dabei um Netzwerkpakete mit dem Bitsatz `SYN`. Weitere Informationen finden Sie unter „[Netzwerkports](/enterprise/admin/guides/installation/network-ports)“. - -Die UWF-Firewall öffnet zudem verschiedene Ports, die für die ordnungsgemäße Funktion von {% data variables.product.prodname_ghe_server %} erforderlich sind. Weitere Informationen zum UFW-Regelsatz finden Sie in der „[UFW README](https://bazaar.launchpad.net/~jdstrand/ufw/0.30-oneiric/view/head:/README#L213)“. - -### Standardmäßige Firewallregeln anzeigen - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. Führen Sie den Befehl `sudo ufw status` aus, um die standardmäßigen Firewallregeln anzuzeigen. Es sollte in etwa folgende Ausgabe angezeigt werden: - ```shell - $ sudo ufw status - > Status: active - > To Action From - > -- ------ ---- - > ghe-1194 ALLOW Anywhere - > ghe-122 ALLOW Anywhere - > ghe-161 ALLOW Anywhere - > ghe-22 ALLOW Anywhere - > ghe-25 ALLOW Anywhere - > ghe-443 ALLOW Anywhere - > ghe-80 ALLOW Anywhere - > ghe-8080 ALLOW Anywhere - > ghe-8443 ALLOW Anywhere - > ghe-9418 ALLOW Anywhere - > ghe-1194 (v6) ALLOW Anywhere (v6) - > ghe-122 (v6) ALLOW Anywhere (v6) - > ghe-161 (v6) ALLOW Anywhere (v6) - > ghe-22 (v6) ALLOW Anywhere (v6) - > ghe-25 (v6) ALLOW Anywhere (v6) - > ghe-443 (v6) ALLOW Anywhere (v6) - > ghe-80 (v6) ALLOW Anywhere (v6) - > ghe-8080 (v6) ALLOW Anywhere (v6) - > ghe-8443 (v6) ALLOW Anywhere (v6) - > ghe-9418 (v6) ALLOW Anywhere (v6) - ``` - -### Benutzerdefinierte Firewallregeln hinzufügen - -{% warning %} - -**Warnung:** Bevor Sie benutzerdefinierte Firewallregeln hinzufügen, sollten Sie Ihre aktuellen Regeln sichern, falls Sie in einen bekannten Betriebszustand zurückkehren müssen. Falls Ihr Server für Sie gesperrt ist, kontaktieren Sie {% data variables.contact.contact_ent_support %}, um die ursprünglichen Firewallregeln neu zu konfigurieren. Die Wiederherstellung der ursprünglichen Firewallregeln führt zu Ausfallzeiten für Ihren Server. - -{% endwarning %} - -1. Konfigurieren Sie eine benutzerdefinierte Firewallregel. -2. Führen Sie den Befehl `status numbered` aus, um den Status jeder neuen Regel zu überprüfen. - ```shell - $ sudo ufw status numbered - ``` -3. Führen Sie zum Sichern Ihrer benutzerdefinierten Firewallregeln den Befehl `cp` aus, um die Regeln in eine neue Datei zu verschieben. - ```shell - $ sudo cp -r /lib/ufw ~/ufw.backup - ``` - -Nach dem Upgrade von {% data variables.product.product_location_enterprise %} müssen Sie Ihre benutzerdefinierten Firewallregeln erneut anwenden. Sie sollten ein Skript erstellen, um Ihre benutzerdefinierten Firewallregeln erneut anzuwenden. - -### Standardmäßige Firewallregeln wiederherstellen - -Wenn nach dem Ändern der Firewallregeln ein Fehler auftritt, können Sie die Regeln über das ursprüngliche Backup wiederherstellen. - -{% warning %} - -**Warnung:** Falls Sie die ursprünglichen Regeln nicht gesichert haben, bevor Sie Änderungen an der Firewall vorgenommen haben, kontaktieren Sie {% data variables.contact.contact_ent_support %}, um weitere Unterstützung zu erhalten. - -{% endwarning %} - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. Kopieren Sie zum Wiederherstellen der vorherigen Backup-Regeln diese mithilfe des Befehls `cp` zurück zur Firewall. - ```shell - $ sudo cp -f ~/ufw.backup/*rules /lib/ufw - ``` -3. Führen Sie den Befehl `systemctl`aus, um die Firewall neu zu starten. - ```shell - $ sudo systemctl restart ufw - ``` -4. Führen Sie den Befehl `ufw status` aus, um zu bestätigen, dass die Regeln wieder ihre Standardwerte aufweisen. - ```shell - $ sudo ufw status - > Status: active - > To Action From - > -- ------ ---- - > ghe-1194 ALLOW Anywhere - > ghe-122 ALLOW Anywhere - > ghe-161 ALLOW Anywhere - > ghe-22 ALLOW Anywhere - > ghe-25 ALLOW Anywhere - > ghe-443 ALLOW Anywhere - > ghe-80 ALLOW Anywhere - > ghe-8080 ALLOW Anywhere - > ghe-8443 ALLOW Anywhere - > ghe-9418 ALLOW Anywhere - > ghe-1194 (v6) ALLOW Anywhere (v6) - > ghe-122 (v6) ALLOW Anywhere (v6) - > ghe-161 (v6) ALLOW Anywhere (v6) - > ghe-22 (v6) ALLOW Anywhere (v6) - > ghe-25 (v6) ALLOW Anywhere (v6) - > ghe-443 (v6) ALLOW Anywhere (v6) - > ghe-80 (v6) ALLOW Anywhere (v6) - > ghe-8080 (v6) ALLOW Anywhere (v6) - > ghe-8443 (v6) ALLOW Anywhere (v6) - > ghe-9418 (v6) ALLOW Anywhere (v6) - ``` diff --git a/translations/de-DE/content/admin/installation/configuring-collectd.md b/translations/de-DE/content/admin/installation/configuring-collectd.md deleted file mode 100644 index c8293e326a5b..000000000000 --- a/translations/de-DE/content/admin/installation/configuring-collectd.md +++ /dev/null @@ -1,57 +0,0 @@ ---- -title: collectd konfigurieren -intro: '{% data variables.product.prodname_enterprise %} kann Daten mit „collectd“ erfassen und an einen externen „collectd“-Server senden. Neben anderen Kennzahlen erfassen wir einen Standarddatensatz wie CPU-Auslastung, Arbeitsspeicher- und Festplattennutzung, Traffic und Fehler der Netzwerkschnittstelle sowie die Gesamtauslastung der VM.' -redirect_from: - - /enterprise/admin/articles/configuring-collectd/ - - /enterprise/admin/installation/configuring-collectd -versions: - enterprise-server: '*' ---- - -### Externen `collectd`-Server einrichten - -Falls Sie noch keinen externen `collectd`-Server eingerichtet haben, müssen Sie dies erledigen, bevor Sie die `collectd`-Weiterleitung auf {% data variables.product.product_location_enterprise %} aktivieren. Ihr `collectd`-Server muss `collectd` Version 5.x oder höher ausführen. - -1. Melden Sie sich bei Ihrem `collectd`-Server an. -2. Erstellen Sie die `collectd`-Konfigurationsdatei, oder bearbeiten Sie sie so, dass das Netzwerk-Plug-in geladen und in die Server- und Portdirektiven die entsprechenden Werte eingetragen werden. Auf den meisten Distributionen befindet sie sich unter `/etc/collectd/collectd.conf`. - -*collectd.conf*-Beispieldatei zum Ausführen eines `collectd`-Servers: - - LoadPlugin network - ... - ... - - Listen "0.0.0.0" "25826" - - -### collectd-Weiterleitung auf {% data variables.product.prodname_enterprise %} aktivieren - -Die `collectd`-Weiterleitung ist auf {% data variables.product.prodname_enterprise %} standardmäßig deaktiviert. Befolgen Sie die Schritte zum Aktivieren und Konfigurieren der `collectd`-Weiterleitung: - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -1. Wählen Sie unterhalb der Einstellungen für die Protokollweiterleitung **Enable collectd forwarding** (collectd-Weiterleitung aktivieren) aus. -1. Geben Sie im Feld **Server address** (Serveradresse) die Adresse des `collectd`-Servers ein, an den die Statistiken der {% data variables.product.prodname_enterprise %}-Appliance weitergeleitet werden sollen. -1. Geben Sie im Feld **Port** den Port ein, der verwendet wurde, um eine Verbindung zum `collectd`-Server herzustellen. (Der Standardwert ist 25826) -1. Wählen Sie im Dropdownmenü **Cryptographic setup** (Kryptografische Einrichtung) die Sicherheitsebene für die Kommunikationen mit dem `collectd`-Server aus. (Ohne, signierte Pakete oder verschlüsselte Pakete.) -{% data reusables.enterprise_management_console.save-settings %} - -### collectd-Daten mit `ghe-export-graphs` exportieren - -Das Befehlszeilentool `ghe-export-graphs` exportiert die Daten, die von `collectd` in RRD-Datenbanken gespeichert werden. Dieser Befehl wandelt die Daten in das XML-Format um und exportiert sie in einer einzelnen Tarball-Datei (.tgz). - -Sein Hauptzweck besteht darin, dem {% data variables.contact.contact_ent_support %}-Team Daten über die Leistung einer VM zur Verfügung zu stellen, ohne dass ein vollständiges Support-Bundle heruntergeladen werden muss. Er sollte nicht in Ihre regulären Backup-Exporte aufgenommen werden und bietet kein Gegenstück zum Import. Wenn Sie {% data variables.contact.contact_ent_support %} kontaktieren, werden Sie zur Fehlerbehebung ggf. gebeten, diese Daten anzugeben. - -#### Beispiel - -```shell -ssh -p 122 admin@[hostname] -- 'ghe-export-graphs' && scp -P 122 admin@[hostname]:~/graphs.tar.gz . -``` - -### Problemlösungen - -#### Der zentrale collectd-Server empfängt keine Daten. - -{% data variables.product.prodname_enterprise %} enthält standardmäßig `collectd` Version 5.x. `collectd` 5.x ist nicht abwärtskompatibel mit der Reihe der Version 4.x. Ihr zentraler `collectd`-Server muss mindestens Version 5.x aufweisen, um von {% data variables.product.product_location_enterprise %} gesendete Daten zu akzeptieren. - -Unterstützung zu weiteren Fragen oder Problemen erhältst Du vom {% data variables.contact.contact_ent_support %}. diff --git a/translations/de-DE/content/admin/installation/configuring-dns-nameservers.md b/translations/de-DE/content/admin/installation/configuring-dns-nameservers.md deleted file mode 100644 index c0f2c37c8205..000000000000 --- a/translations/de-DE/content/admin/installation/configuring-dns-nameservers.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: DNS-Nameserver konfigurieren -intro: '{% data variables.product.prodname_ghe_server %} verwendet das Dynamic Host Configuration Protocol (DHCP) für DNS-Einstellungen, wenn DHCP-Leases Nameserver bereitstellen. Wenn Nameserver nicht durch einen Dynamic Host Configuration Protocol-Lease (DHCP) bereitgestellt werden oder wenn Sie bestimmte DNS-Einstellungen verwenden müssen, können Sie die Nameserver manuell angeben.' -redirect_from: - - /enterprise/admin/guides/installation/about-dns-nameservers/ - - /enterprise/admin/installation/configuring-dns-nameservers -versions: - enterprise-server: '*' ---- - -Die von Ihnen angegebenen Nameserver müssen den Hostnamen Ihrer {% data variables.product.product_location_enterprise %} auflösen. - -{% data reusables.enterprise_installation.changing-hostname-not-supported %} - -### Nameserver mithilfe der VM-Konsole konfigurieren - -{% data reusables.enterprise_installation.open-vm-console-start %} -2. Konfigurieren Sie Nameserver für Ihre Instanz. -{% data reusables.enterprise_installation.vm-console-done %} - -### Nameserver mithilfe der Verwaltungsshell konfigurieren - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. Geben Sie zum Bearbeiten Ihrer Nameserver Folgendes ein: - ```shell - $ sudo vim /etc/resolvconf/resolv.conf.d/head - ``` -3. Fügen Sie die `nameserver`-Einträge an, und speichern Sie die Datei anschließend. -4. Speichern Sie nach dem Verifizieren Ihrer Änderungen die Datei. -5. Geben Sie Folgendes ein, um {% data variables.product.product_location_enterprise %} Ihre neuen Nameservereinträge hinzuzufügen: - ```shell - $ sudo service resolvconf restart - ``` diff --git a/translations/de-DE/content/admin/installation/configuring-git-large-file-storage-on-github-enterprise-server.md b/translations/de-DE/content/admin/installation/configuring-git-large-file-storage-on-github-enterprise-server.md deleted file mode 100644 index 56d96b6a20ff..000000000000 --- a/translations/de-DE/content/admin/installation/configuring-git-large-file-storage-on-github-enterprise-server.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Git Large File Storage auf GitHub Enterprise Server konfigurieren -intro: '{% data reusables.enterprise_site_admin_settings.configuring-large-file-storage-short-description %}' -redirect_from: - - /enterprise/admin/guides/installation/configuring-git-large-file-storage-on-github-enterprise/ - - /enterprise/admin/installation/configuring-git-large-file-storage-on-github-enterprise-server -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/de-DE/content/admin/installation/configuring-git-large-file-storage-to-use-a-third-party-server.md b/translations/de-DE/content/admin/installation/configuring-git-large-file-storage-to-use-a-third-party-server.md deleted file mode 100644 index 302da8501c4e..000000000000 --- a/translations/de-DE/content/admin/installation/configuring-git-large-file-storage-to-use-a-third-party-server.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: Git Large File Storage zur Verwendung eines Drittanbieterservers konfigurieren -intro: 'Sie können {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) auf einem Drittanbieterserver verwenden. Deaktivieren Sie dazu {% data variables.large_files.product_name_short %} auf der {% data variables.product.prodname_ghe_server %}-Appliance, und konfigurieren Sie den {% data variables.large_files.product_name_short %}-Client mit der URL für den Server, auf dem Sie große Assets speichern möchten.' -redirect_from: - - /enterprise/admin/installation/configuring-git-large-file-storage-to-use-a-third-party-server -versions: - enterprise-server: '*' ---- - -{% data reusables.large_files.storage_assets_location %} -{% data reusables.large_files.rejected_pushes %} - -1. Deaktivieren Sie {% data variables.large_files.product_name_short %} auf der {% data variables.product.prodname_ghe_server %}-Appliance. Weitere Informationen finden Sie unter „[{% data variables.large_files.product_name_long %} konfigurieren](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-git-large-file-storage#configuring-git-large-file-storage-for-your-appliance)“. - -2. Erstellen Sie eine {% data variables.large_files.product_name_short %}-Konfigurationsdatei, die auf den Drittanbieterserver verweist. - ```shell - # Show default configuration - $ git lfs env - > git-lfs/1.1.0 (GitHub; darwin amd64; go 1.5.1; git 94d356c) - > git version 2.7.4 (Apple Git-66) -   - > Endpoint=https://GITHUB-ENTERPRISE-HOST/path/to/repo/info/lfs (auth=basic) -   - # Create .lfsconfig that points to third party server. - $ git config -f .lfsconfig remote.origin.lfsurl https://THIRD-PARTY-LFS-SERVER/path/to/repo - $ git lfs env - > git-lfs/1.1.0 (GitHub; darwin amd64; go 1.5.1; git 94d356c) - > git version 2.7.4 (Apple Git-66) -   - > Endpoint=https://THIRD-PARTY-LFS-SERVER/path/to/repo/info/lfs (auth=none) -   - # Show the contents of .lfsconfig - $ cat .lfsconfig - [remote "origin"] - lfsurl = https://THIRD-PARTY-LFS-SERVER/path/to/repo - ``` - -3. Committen Sie eine benutzerdefinierte `.lfsconfig`-Datei an das Repository, um dieselbe {% data variables.large_files.product_name_short %}-Konfiguration für jeden Benutzer beizubehalten. - ```shell - $ git add .lfsconfig - $ git commit -m "Adding LFS config file" - ``` -3. Migrieren Sie vorhandene {% data variables.large_files.product_name_short %}-Assets. Weitere Informationen finden Sie unter „[Zu einem anderen {% data variables.large_files.product_name_long %}-Server migrieren](/enterprise/{{ currentVersion }}/admin/guides/installation/migrating-to-a-different-git-large-file-storage-server)“. - -### Weiterführende Informationen - -- „[Informationen zu {% data variables.large_files.product_name_long %}](/articles/about-git-large-file-storage/)“ -- „[{% data variables.large_files.product_name_long %} konfigurieren](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-git-large-file-storage)“ -- „[Zu einem anderen {% data variables.large_files.product_name_long %}-Server migrieren](/enterprise/{{ currentVersion }}/admin/guides/installation/migrating-to-a-different-git-large-file-storage-server)“ -- [{% data variables.large_files.product_name_long %}-Projektwebsite](https://git-lfs.github.com/) diff --git a/translations/de-DE/content/admin/installation/configuring-git-large-file-storage.md b/translations/de-DE/content/admin/installation/configuring-git-large-file-storage.md deleted file mode 100644 index d6c3a8406967..000000000000 --- a/translations/de-DE/content/admin/installation/configuring-git-large-file-storage.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: Git Large File Storage konfigurieren -intro: 'Sobald [{% data variables.large_files.product_name_short %} installiert wurde](/articles/installing-git-large-file-storage/), müssen Sie es mit einer großen Datei in Ihrem Repository verknüpfen.' -redirect_from: - - /enterprise/admin/articles/configuring-git-large-file-storage-for-a-repository/ - - /enterprise/admin/articles/configuring-git-large-file-storage-for-every-repository-owned-by-a-user-account-or-organization/ - - /enterprise/admin/articles/configuring-git-large-file-storage-for-your-appliance/ - - /enterprise/admin/installation/configuring-git-large-file-storage -versions: - enterprise-server: '*' ---- - -### Informationen zu {% data variables.large_files.product_name_long %} - -{% data reusables.enterprise_site_admin_settings.configuring-large-file-storage-short-description %} Sie können {% data variables.large_files.product_name_long %} mit einem einzelnen Repository, mit allen Ihren persönlichen oder Organisations-Repositorys oder mit jedem Repository in {% data variables.product.product_location_enterprise %} verwenden. Bevor Sie {% data variables.large_files.product_name_short %} für bestimmte Repositorys oder Organisationen aktivieren können, müssen Sie {% data variables.large_files.product_name_short %} für Ihre Appliance aktivieren. - -{% data reusables.large_files.storage_assets_location %} -{% data reusables.large_files.rejected_pushes %} - -Weitere Informationen finden Sie unter „[Informationen zu {% data variables.large_files.product_name_long %}](/articles/about-git-large-file-storage)“, „[Versionierung von großen Dateien](/enterprise/user/articles/versioning-large-files/)“ und auf der „[{% data variables.large_files.product_name_long %}-Projektwebsite](https://git-lfs.github.com/)“. - -### {% data variables.large_files.product_name_long %} für Ihre Appliance konfigurieren - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -4. Verwenden Sie unter „{% data variables.large_files.product_name_short %} access“ ({% data variables.large_files.product_name_short %}-Zugriff) das Dropdownmenü, und klicken Sie auf **Enabled** (Aktiviert) oder **Disabled** (Deaktiviert). ![Git LFS-Zugriff](/assets/images/enterprise/site-admin-settings/git-lfs-admin-center.png) - -### {% data variables.large_files.product_name_long %} für ein einzelnes Repository konfigurieren - -{% data reusables.enterprise_site_admin_settings.override-policy %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -{% data reusables.enterprise_site_admin_settings.git-lfs-toggle %} - -### {% data variables.large_files.product_name_long %} für jedes einem Benutzerkonto oder einer Organisation gehörende Repository konfigurieren - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.search-user-or-org %} -{% data reusables.enterprise_site_admin_settings.click-user-or-org %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -{% data reusables.enterprise_site_admin_settings.git-lfs-toggle %} diff --git a/translations/de-DE/content/admin/installation/configuring-github-enterprise-server-for-high-availability.md b/translations/de-DE/content/admin/installation/configuring-github-enterprise-server-for-high-availability.md deleted file mode 100644 index b01222054a5b..000000000000 --- a/translations/de-DE/content/admin/installation/configuring-github-enterprise-server-for-high-availability.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: GitHub Enterprise Server für Hochverfügbarkeit konfigurieren -redirect_from: - - /enterprise/admin/guides/installation/high-availability-cluster-configuration/ - - /enterprise/admin/guides/installation/high-availability-configuration/ - - /enterprise/admin/guides/installation/configuring-github-enterprise-for-high-availability/ - - /enterprise/admin/installation/configuring-github-enterprise-server-for-high-availability -intro: '{% data variables.product.prodname_ghe_server %} unterstützt eine Hochverfügbarkeits-Betriebsart, die darauf ausgelegt ist, Dienstunterbrechungen im Falle von Hardwareausfällen oder größeren Netzwerkausfällen, welche die primäre Appliance betreffen, zu minimieren.' -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/de-DE/content/admin/installation/configuring-github-pages-on-your-appliance.md b/translations/de-DE/content/admin/installation/configuring-github-pages-on-your-appliance.md deleted file mode 100644 index c3aac755c7c4..000000000000 --- a/translations/de-DE/content/admin/installation/configuring-github-pages-on-your-appliance.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: GitHub Pages auf Ihrer Appliance konfigurieren -intro: 'Sie können {% data variables.product.prodname_pages %} auf Ihrer Instanz aktivieren oder deaktivieren. Darüber hinaus können Sie festlegen, {% data variables.product.prodname_pages %}-Websites öffentlich zugänglich zu machen.' -redirect_from: - - /enterprise/admin/guides/installation/disabling-github-enterprise-pages/ - - /enterprise/admin/guides/installation/configuring-github-enterprise-pages/ - - /enterprise/admin/installation/configuring-github-pages-on-your-appliance -versions: - enterprise-server: '*' ---- - -### {% data variables.product.prodname_pages %} als öffentlich zugänglich festlegen - -Wenn der private Modus auf Ihrer Instanz aktiviert ist, ist der öffentliche Zugriff auf die auf {% data variables.product.product_location_enterprise %} gehosteten {% data variables.product.prodname_pages %}-Websites nicht möglich. - -{% warning %} - -**Warnung:** Wenn Sie öffentliche {% data variables.product.prodname_pages %}-Websites aktivieren, ist jede {% data variables.product.prodname_pages %}-Website in jedem Repository auf Ihrer Instanz öffentlich zugänglich. - -{% endwarning %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.pages-tab %} -4. Wählen Sie **Public Pages** (Öffentliche Seiten) aus. ![Kontrollkästchen zum Aktivieren von „Public Pages“ (Öffentliche Seiten)](/assets/images/enterprise/management-console/public-pages-checkbox.png) -{% data reusables.enterprise_management_console.save-settings %} - -### {% data variables.product.prodname_pages %} auf {% data variables.product.product_location_enterprise %} deaktivieren - -Wenn für {% data variables.product.product_location_enterprise %} die Subdomain-Isolation deaktiviert ist, sollten Sie auch {% data variables.product.prodname_pages %} deaktivieren, um sich vor potenziellen Sicherheitslücken zu schützen. Weitere Informationen finden Sie unter „[Subdomain-Isolation aktivieren](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-subdomain-isolation)“. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.pages-tab %} -4. Deaktivieren Sie **Enable Pages** (Pages aktivieren). ![Kontrollkästchen zum Deaktivieren von {% data variables.product.prodname_pages %}](/assets/images/enterprise/management-console/pages-select-button.png) -{% data reusables.enterprise_management_console.save-settings %} - -### Weiterführende Informationen - -- „[Privaten Modus aktivieren](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-private-mode)“ diff --git a/translations/de-DE/content/admin/installation/configuring-rate-limits.md b/translations/de-DE/content/admin/installation/configuring-rate-limits.md deleted file mode 100644 index f2503908131b..000000000000 --- a/translations/de-DE/content/admin/installation/configuring-rate-limits.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: Begrenzungen konfigurieren -intro: 'Mithilfe der {% data variables.enterprise.management_console %} können Sie Begrenzungen für {% data variables.product.prodname_ghe_server %} festlegen.' -redirect_from: - - /enterprise/admin/installation/configuring-rate-limits -versions: - enterprise-server: '*' ---- - -### Begrenzungen für {% data variables.product.prodname_enterprise_api %} aktivieren - -Die Aktivierung von Begrenzungen auf {% data variables.product.prodname_enterprise_api %} kann verhindern, dass einzelne oder nicht authentifizierte Benutzer Ressourcen übermäßig verwenden. For more information, see "[Rate Limiting](/enterprise/{{ currentVersion }}/v3/#rate-limiting)." - -{% note %} - -**Hinweis:** In der {% data variables.enterprise.management_console %} wird der Zeitraum (pro Minute oder pro Stunde) für jede Begrenzung aufgelistet. - -{% endnote %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -2. Wählen Sie **Enable API Rate Limiting** (API-Durchsatzratenbegrenzung aktivieren) unter „Rate Limiting“ (Durchsatzratenbegrenzung) aus. ![Kontrollkästchen zum Aktivieren der API-Durchsatzratenbegrenzung](/assets/images/enterprise/management-console/api-rate-limits-checkbox.png) -3. Geben Sie die Begrenzungen für authentifizierte und nicht authentifizierte Anforderungen für jede API ein, oder akzeptieren Sie die vorab ausgefüllten Standardbegrenzungen. -{% data reusables.enterprise_management_console.save-settings %} - -### Missbrauchsbegrenzungen aktivieren - -Durch das Festlegen von Missbrauchsbegrenzungen wird das allgemeine Dienstniveau von {% data variables.product.product_location_enterprise %} geschützt. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -2. Wählen Sie **Enable Abuse Rate Limiting** (Missbrauchsbegrenzung aktivieren) unter „Rate Limiting“ (Durchsatzratenbegrenzung) aus. ![Kontrollkästchen zum Aktivieren der Missbrauchsbegrenzung](/assets/images/enterprise/management-console/abuse-rate-limits-checkbox.png) -3. Geben Sie die Begrenzungen für „Total Requests“ (Gesamtanforderungen), „CPU Limit“ (CPU-Begrenzung) und „CPU Limit for Searching“ (CPU-Begrenzung für Suchvorgänge) ein, oder akzeptieren Sie die vorab ausgefüllten Standardbegrenzungen. -{% data reusables.enterprise_management_console.save-settings %} - -### Git-Begrenzungen aktivieren - -Sie können Git-Begrenzungen pro Repository-Netzwerk oder pro Benutzer-ID anwenden. Git-Begrenzungen werden in gleichzeitigen Vorgängen pro Minute ausgedrückt und sind basierend auf der aktuellen CPU-Auslastung adaptiv. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -2. Wählen Sie **Enable Git Rate Limiting** (Git-Durchsatzratenbegrenzung aktivieren) unter „Rate Limiting“ (Durchsatzratenbegrenzung) aus. ![Kontrollkästchen zum Aktivieren der Git-Durchsatzratenbegrenzung](/assets/images/enterprise/management-console/git-rate-limits-checkbox.png) -3. Geben Sie die Begrenzungen für die jeweiligen Repository-Netzwerke oder Benutzer-IDs ein. ![Felder für Repository-Netzwerk- und Benutzer-ID-Begrenzungen](/assets/images/enterprise/management-console/example-git-rate-limits.png) -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/de-DE/content/admin/installation/configuring-the-default-visibility-of-new-repositories-on-your-appliance.md b/translations/de-DE/content/admin/installation/configuring-the-default-visibility-of-new-repositories-on-your-appliance.md deleted file mode 100644 index 4324eb17061b..000000000000 --- a/translations/de-DE/content/admin/installation/configuring-the-default-visibility-of-new-repositories-on-your-appliance.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: Standardmäßige Sichtbarkeit neuer Repositorys auf Ihrer Appliance konfigurieren -intro: 'Sie können die standardmäßige Sichtbarkeit für alle neuen Repositorys als privat oder öffentlich festlegen, die über die Weboberfläche auf Ihrer {% data variables.product.prodname_ghe_server %}-Appliance erstellt wurden.' -redirect_from: - - /enterprise/admin/installation/configuring-the-default-visibility-of-new-repositories-on-your-appliance -versions: - enterprise-server: '*' ---- - -Jedes Mal, wenn jemand ein neues Repository auf {% data variables.product.product_location_enterprise %} anlegt, muss diese Person eine Sichtbarkeit für das Repository auswählen. Wenn Du eine Standard-Sichtbarkeitseinstellung für die Instanz einstellst, wählst Du aus, welche Sichtbarkeit standardmäßig gilt. Weitere Informationen zu Repository-Sichtbarkeiten findest Du unter „[Informationen zur Sichtbarkeit eines Repositorys](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)“. - -Wenn ein Site-Administrator Mitgliedern das Erstellen bestimmter Arten Repositorys verwehrt, werden Mitglieder nicht in der Lage sein, ein Repository dieser Art zu erstellen, selbst wenn die Einstellung zur Sichtbarkeit diesen Typ als Standard vorgibt. Weitere Informationen finden Sie unter „[Repository-Erstellung auf Ihrer Instanz einschränken](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)“. - -{% tip %} - -**Tipp:** Sie können festlegen, dass nur die Websiteadministratoren die Sichtbarkeit des Repositorys ändern können. Weitere Informationen finden Sie unter „[Benutzerbedingte Änderung der Sichtbarkeit eines Repositorys verhindern](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-a-repository-s-visibility)“. - -{% endnote %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -1. Verwende unter „Default repository visibility“ (Standardmäßige Sichtbarkeit für Repositorys) das Dropdown-Menü und wähle eine Standardsichtbarkeit. ![Dropdownmenü zum Auswählen der standardmäßigen Repository-Sichtbarkeit für Ihre Instanz](/assets/images/enterprise/site-admin-settings/default-repository-visibility-settings.png) - -{% data reusables.enterprise_installation.image-urls-viewable-warning %} diff --git a/translations/de-DE/content/admin/installation/configuring-the-github-enterprise-server-appliance.md b/translations/de-DE/content/admin/installation/configuring-the-github-enterprise-server-appliance.md deleted file mode 100644 index 32558c11073c..000000000000 --- a/translations/de-DE/content/admin/installation/configuring-the-github-enterprise-server-appliance.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: GitHub Enterprise Server-Appliance konfigurieren -intro: 'Sobald {% data variables.product.prodname_ghe_server %} betriebsbereit ist, können Sie die Appliance an die Anforderungen Ihrer Organisation anpassen.' -redirect_from: - - /enterprise/admin/guides/installation/basic-configuration/ - - /enterprise/admin/guides/installation/administrative-tools/ - - /enterprise/admin/articles/restricting-ssh-access-to-specific-hosts/ - - /enterprise/admin/guides/installation/configuring-the-github-enterprise-appliance/ - - /enterprise/admin/installation/configuring-the-github-enterprise-server-appliance -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/de-DE/content/admin/installation/configuring-the-ip-address-using-the-virtual-machine-console.md b/translations/de-DE/content/admin/installation/configuring-the-ip-address-using-the-virtual-machine-console.md deleted file mode 100644 index 0e0774a62928..000000000000 --- a/translations/de-DE/content/admin/installation/configuring-the-ip-address-using-the-virtual-machine-console.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: IP-Adresse mithilfe der VM-Konsole konfigurieren -intro: '{% data variables.product.prodname_ghe_server %} ruft standardmäßig Netzwerkeinstellungen über das Dynamic Host Configuration Protocol (DHCP) ab. Wenn Ihre Plattform sie unterstützt oder falls DHCP nicht verfügbar ist, können Sie die Netzwerkeinstellungen auch mithilfe der VM-Konsole konfigurieren.' -redirect_from: - - /enterprise/admin/installation/configuring-the-ip-address-using-the-virtual-machine-console -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_installation.open-vm-console-start %} -3. Wählen Sie aus, dass `IPv4`- oder `IPv6`-Protokoll zu konfigurieren. ![Auswahloptionen für das IPv4- oder für das IPv6-Protokoll](/assets/images/enterprise/network-configuration/IPv4-or-IPv6-protocol.png) -4. Konfigurieren Sie die Optionen für das gewünschte Protokoll. ![Menü mit IP-Protokolloptionen](/assets/images/enterprise/network-configuration/network-settings-selection.png) -{% data reusables.enterprise_installation.vm-console-done %} diff --git a/translations/de-DE/content/admin/installation/configuring-time-synchronization.md b/translations/de-DE/content/admin/installation/configuring-time-synchronization.md deleted file mode 100644 index 86a1f653a81d..000000000000 --- a/translations/de-DE/content/admin/installation/configuring-time-synchronization.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: Zeitsynchronisierung konfigurieren -intro: '{% data variables.product.prodname_ghe_server %} synchronisiert seine Uhr automatisch, indem Verbindungen zu NTP-Servern hergestellt werden. Sie können die zum Synchronisieren der Uhr verwendeten NTP-Server festlegen. Alternativ können Sie die NTP-Standardserver verwenden.' -redirect_from: - - /enterprise/admin/articles/adjusting-the-clock/ - - /enterprise/admin/articles/configuring-time-zone-and-ntp-settings/ - - /enterprise/admin/articles/setting-ntp-servers/ - - /enterprise/admin/categories/time/ - - /enterprise/admin/installation/configuring-time-synchronization -versions: - enterprise-server: '*' ---- - -### NTP-Standardserver ändern - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -2. Klicken Sie auf der linken Seitenleiste auf **Time** (Zeit). ![Die Schaltfläche „Time“ (Zeit) auf der {% data variables.enterprise.management_console %}-Seitenleiste](/assets/images/enterprise/management-console/sidebar-time.png) -3. Geben Sie unter „Primary NTP server“ (Primärer NTP-Server) den Hostnamen des primären NTP-Servers ein. Geben Sie unter „Secondary NTP server“ (Sekundärer NTP-Server) den Hostnamen des sekundären NTP-Servers ein. ![Die Felder für die primären und sekundären NTP-Server in der {% data variables.enterprise.management_console %}](/assets/images/enterprise/management-console/ntp-servers.png) -4. Klicken Sie im unteren Bereich der Seite auf **Save settings** (Einstellungen speichern). ![Die Schaltfläche „Save settings“ (Einstellungen speichern) in der {% data variables.enterprise.management_console %}](/assets/images/enterprise/management-console/save-settings.png) -5. Warten Sie auf den Abschluss der Konfigurationsausführung. - -### Große Zeitabweichung korrigieren - -Das NTP-Protokoll korrigiert fortlaufend kleine Abweichungen bei der Zeitsynchronisierung. Mit der Verwaltungsshell können Sie die Zeit sofort synchronisieren. - -{% note %} - -**Hinweise:** - - Die UTC-Zone (Coordinated Universal Time, koordinierte Weltzeit) kann nicht geändert werden. - - Sie sollten Ihren Hypervisor am Versuch hindern, die Uhr der virtuellen Maschine festzulegen. Weitere Informationen finden Sie in der vom Virtualisierungsanbieter bereitgestellten Dokumentation. - -{% endnote %} - -- Führen Sie den Befehl `chronyc` aus, um den Server mit dem konfigurierten NTP-Server zu synchronisieren. Ein Beispiel: - -```shell -$ sudo chronyc -a makestep -``` diff --git a/translations/de-DE/content/admin/installation/configuring-tls.md b/translations/de-DE/content/admin/installation/configuring-tls.md deleted file mode 100644 index 2585e033e153..000000000000 --- a/translations/de-DE/content/admin/installation/configuring-tls.md +++ /dev/null @@ -1,69 +0,0 @@ ---- -title: TLS konfigurieren -intro: 'Sie können Transport Layer Security (TLS) auf {% data variables.product.product_location_enterprise %} konfigurieren, damit Sie ein von einer vertrauenswürdigen Zertifizierungsstelle signiertes Zertifikat verwenden können.' -redirect_from: - - /enterprise/admin/articles/ssl-configuration/ - - /enterprise/admin/guides/installation/about-tls/ - - /enterprise/admin/installation/configuring-tls -versions: - enterprise-server: '*' ---- - -### Informationen zu Transport Layer Security - -TLS, das SSL ersetzt hat, wird beim erstmaligen Start von {% data variables.product.prodname_ghe_server %} mit einem selbstsignierten Zertifikat aktiviert und konfiguriert. Da Webbrowser und Git-Clients selbstsignierten Zertifikaten nicht vertrauen, melden diese Clients Zertifikatswarnungen, bis Sie TLS deaktivieren oder ein von einer vertrauenswürdigen Zertifizierungsstelle wie Let's Encrypt signiertes Zertifikat hochladen. - -Die {% data variables.product.prodname_ghe_server %}-Appliance sendet HTTP Strict Transport Security-Header, wenn SSL aktiviert ist. Wenn TLS deaktiviert wird, verlieren die Benutzer den Zugriff auf die Appliance, da ihre Browser eine Protokollherabstufung auf HTTP nicht zulassen. Weitere Informationen finden Sie unter „[HTTP Strict Transport Security (HSTS)](https://de.wikipedia.org/wiki/HTTP_Strict_Transport_Security)“ auf Wikipedia. - -{% data reusables.enterprise_installation.terminating-tls %} - -Sie müssen TLS für Ihre Instanz aktivieren, um Benutzern zu erlauben, FIDO U2F für die Zwei-Faktor-Authentifizierung zu verwenden. Weitere Informationen finden Sie unter „[Zwei-Faktor-Authentifizierung konfigurieren](/articles/configuring-two-factor-authentication)“. - -### Voraussetzungen - -Um TLS in der Produktion zu verwenden, müssen Sie über ein Zertifikat verfügen, das ein unverschlüsseltes PEM-Format aufweist und von einer vertrauenswürdigen Zertifizierungsstelle signiert wurde. - -Darüber hinaus schreibt Ihr Zertifikat Subject Alternative Names vor, die für die in „[Subdomain-Isolation aktivieren](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-subdomain-isolation#about-subdomain-isolation)“ aufgelisteten Subdomains konfiguriert sind, und es muss die gesamte Zertifikatskette enthalten, wenn es von einer zwischengeschalteten Zertifizierungsstelle signiert wurde. Weitere Informationen finden Sie unter „[Subject Alternative Name](http://en.wikipedia.org/wiki/SubjectAltName)“ auf Wikipedia. - -Du kannst mit dem Befehl `ghe-ssl-generate-csr` eine Anfrage zur Signierung des Zertifikats (CSR) für Deine Instanz erzeugen. Weitere Informationen findest Du unter „[Befehlszeilen-Hilfsprogramme](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities/#ghe-ssl-generate-csr)“. - -### Benutzerdefiniertes TLS-Zertifikat hochladen - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -{% data reusables.enterprise_management_console.select-tls-only %} -4. Wählen Sie unter „TLS Protocol support“ (TLS-Protokollunterstützung) die Protokolle aus, die zugelassen werden sollen. ![Optionsfelder mit Optionen zur Auswahl von TLS-Protokollen](/assets/images/enterprise/management-console/tls-protocol-support.png) -5. Klicken Sie unter „Certificate“ (Zertifikat) auf **Choose File** (Datei auswählen), um ein TLS-Zertifikat oder eine Zertifikatskette (im PEM-Format) zur Installation auszuwählen. Diese Datei hat in der Regel eine *.pem*-, *.crt*- oder *.cer*-Erweiterung. ![Schaltfläche zum Suchen der TLS-Zertifikatsdatei](/assets/images/enterprise/management-console/install-tls-certificate.png) -6. Klicken Sie unter „Unencrypted key“ (Unverschlüsselter Schlüssel) auf **Choose File** (Datei auswählen), um einen TLS-Schlüssel (im PEM-Format) zur Installation auszuwählen. Diese Datei hat in der Regel eine *.key*-Erweiterung. ![Schaltfläche zum Suchen der TLS-Schlüsseldatei](/assets/images/enterprise/management-console/install-tls-key.png) - - {% warning %} - - **Warnung**: Ihr TLS-Schlüssel darf keine Passphrase aufweisen. Weitere Informationen finden Sie unter „[Passphrase aus Ihrer Schlüsseldatei entfernen](/enterprise/{{ currentVersion }}/admin/guides/installation/troubleshooting-ssl-errors#removing-the-passphrase-from-your-key-file)“. - - {% endwarning %} -{% data reusables.enterprise_management_console.save-settings %} - -### Informationen zur Let's Encrypt-Unterstützung - -Let's Encrypt ist eine öffentliche Zertifizierungsstelle, die kostenlose, automatisierte TLS-Zertifikate ausstellt, denen Browsern vertrauen, die das ACME-Protokoll verwenden. Sie können Let's Encrypt-Zertifikate auf Ihrer Appliance automatisch abrufen und verlängern, ohne dass eine manuelle Wartung erforderlich ist. - -{% data reusables.enterprise_installation.lets-encrypt-prerequisites %} - -Wenn Sie die Automatisierung der TLS-Zertifikatsverwaltung mit Let's Encrypt aktivieren, kontaktiert {% data variables.product.product_location_enterprise %} die Let's Encrypt-Server, um ein Zertifikat abzurufen. Zum Verlängern eines Zertifikats müssen die Let's Encrypt-Server die Steuerung des konfigurierten Domain-Namens mit eingehenden HTTP-Anforderungen validieren. - -Darüber hinaus können Sie das Befehlszeilenprogramm `ghe-ssl-acme` auf {% data variables.product.product_location_enterprise %} verwenden, um ein Let's Encrypt-Zertifikat automatisch zu generieren. Weitere Informationen finden Sie unter „[Befehlszeilenprogramme](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities#ghe-ssl-acme)“. - -### TLS mit Let's Encrypt konfigurieren - -{% data reusables.enterprise_installation.lets-encrypt-prerequisites %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -{% data reusables.enterprise_management_console.select-tls-only %} -5. Wählen Sie **Enable automation of TLS certificate management using Let's Encrypt** (Automatisierung der TLS-Zertifikatsverwaltung mit Let's Encrypt aktivieren) aus. ![Kontrollkästchen zum Aktivieren von Let's Encrypt](/assets/images/enterprise/management-console/lets-encrypt-checkbox.png) -{% data reusables.enterprise_management_console.save-settings %} -{% data reusables.enterprise_management_console.privacy %} -7. Klicken Sie auf **Request TLS certificate** (TLS-Zertifikat anfordern). ![Schaltfläche „Request TLS certificate“ (TLS-Zertifikat anfordern)](/assets/images/enterprise/management-console/request-tls-button.png) -8. Klicken Sie auf **Save configuration** (Konfiguration speichern). diff --git a/translations/de-DE/content/admin/installation/configuring-your-github-enterprise-server-network-settings.md b/translations/de-DE/content/admin/installation/configuring-your-github-enterprise-server-network-settings.md deleted file mode 100644 index e1743fb490ac..000000000000 --- a/translations/de-DE/content/admin/installation/configuring-your-github-enterprise-server-network-settings.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: Ihre GitHub Enterprise Server-Netzwerkeinstellungen konfigurieren -redirect_from: - - /enterprise/admin/guides/installation/dns-hostname-subdomain-isolation-and-ssl/ - - /enterprise/admin/articles/about-dns-ssl-and-subdomain-settings/ - - /enterprise/admin/articles/configuring-dns-ssl-and-subdomain-settings/ - - /enterprise/admin/guides/installation/configuring-your-github-enterprise-network-settings/ - - /enterprise/admin/installation/configuring-your-github-enterprise-server-network-settings -intro: 'Konfigurieren Sie {% data variables.product.prodname_ghe_server %} die in Ihrem Netzwerk erforderlichen DNS-Nameserver und den Hostnamen. Zudem können Sie einen Proxyserver oder Firewallregeln konfigurieren. Aus Verwaltungs- und Benutzerzwecken müssen Sie zudem den Zugriff auf bestimmte Ports zulassen.' -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/de-DE/content/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud.md b/translations/de-DE/content/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud.md deleted file mode 100644 index 09948c491c1c..000000000000 --- a/translations/de-DE/content/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud.md +++ /dev/null @@ -1,62 +0,0 @@ ---- -title: GitHub Enterprise Server mit GitHub Enterprise Cloud verbinden -intro: 'Nach der Aktivierung von {% data variables.product.prodname_github_connect %} können Sie bestimmte Features und Workflows zwischen {% data variables.product.product_location_enterprise %} und {% data variables.product.prodname_ghe_cloud %} freigeben.' -redirect_from: - - /enterprise/admin/guides/developer-workflow/connecting-github-enterprise-to-github-com/ - - /enterprise/admin/guides/developer-workflow/connecting-github-enterprise-server-to-github-com - - /enterprise/admin/developer-workflow/connecting-github-enterprise-server-to-githubcom/ - - /enterprise/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud -permissions: 'Website-Administratoren für {% data variables.product.prodname_ghe_server %} , die auch Inhaber einer Organisation oder eines Unternehmenskontos in der {% data variables.product.prodname_ghe_cloud %} sind, können {% data variables.product.prodname_github_connect %} aktivieren.' -versions: - enterprise-server: '*' ---- - -### Informationen zu {% data variables.product.prodname_github_connect %} - -Zum Aktivieren von {% data variables.product.prodname_github_connect %} musst Du die Verbindung sowohl in {% data variables.product.product_location_enterprise %} als auch in Deiner Organisation oder Deinem Unternehmenskonto in der {% data variables.product.prodname_ghe_cloud %} konfigurieren. - -Zum Konfigurieren einer Verbindung muss Ihre Proxykonfiguration die Konnektivität mit `github.com` und `api.github.com` zulassen. Weitere Informationen finden Sie unter „[Ausgehenden Webproxyserver konfigurieren](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-an-outbound-web-proxy-server)“. - -Nach der Aktivierung von {% data variables.product.prodname_github_connect %} können Sie Features, beispielsweise die gemeinsame Suche und einheitliche Beiträge, aktivieren. Weitere Informationen zu allen verfügbaren Features finden Sie unter „[Verbindungen zwischen {% data variables.product.prodname_ghe_server %} und {% data variables.product.prodname_ghe_cloud %} verwalten](/enterprise/{{ currentVersion }}/admin/installation/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud)“. - -Wenn Sie zwischen {% data variables.product.product_location_enterprise %} und {% data variables.product.prodname_ghe_cloud %} eine Verbindung herstellen, werden in einem Datensatz auf {% data variables.product.prodname_dotcom_the_website %} Informationen zur Verbindung gespeichert. -- Der Teil des öffentlichen Schlüssels Ihrer {% data variables.product.prodname_ghe_server %}-Lizenz -- Ein Hash Ihrer {% data variables.product.prodname_ghe_server %}-Lizenz -- Der Kundenname auf Ihrer {% data variables.product.prodname_ghe_server %}-Lizenz -- Der Hostname von {% data variables.product.product_location_enterprise %} -- Die Version von {% data variables.product.product_location_enterprise %} -- Die Organisation oder das Unternehmenskonto auf {% data variables.product.prodname_dotcom_the_website %}, die bzw. das mit {% data variables.product.product_location_enterprise %} verbunden ist -- Das Authentifizierungstoken, das von {% data variables.product.product_location_enterprise %} verwendet wird, um Anforderungen an {% data variables.product.prodname_dotcom_the_website %} zu senden. - -Wenn Du {% data variables.product.prodname_github_connect %} aktivierst, wird zudem eine {% data variables.product.prodname_github_app %} erstellt, die Deiner Organisation oder Deinem Unternehmenskonto in der {% data variables.product.prodname_ghe_cloud %} gehört. {% data variables.product.prodname_ghe_server %} verwendet die Anmeldeinformationen der {% data variables.product.prodname_github_app %}, um Anforderungen an {% data variables.product.prodname_dotcom_the_website %} zu senden. - -{% data variables.product.prodname_ghe_server %} speichert die Anmeldeinformationen der {% data variables.product.prodname_github_app %}. Diese Anmeldeinformationen werden mit Hochverfügbarkeits- oder Clustering-Umgebungen repliziert und in von {% data variables.product.prodname_enterprise_backup_utilities %} erstellten Backups, einschließlich Snapshots, gespeichert. -- Ein Authentifizierungstoken, das eine Stunde lang gültig ist -- Ein privater Schlüssel, der zum Generieren eines neuen Authentifizierungstokens verwendet wird - -Wenn {% data variables.product.prodname_github_connect %} aktiviert wird, können {% data variables.product.prodname_dotcom_the_website %}-Benutzer keine Änderungen an {% data variables.product.prodname_ghe_server %} vornehmen. - -{% if currentVersion ver_gt "enterprise-server@2.18" %} -For more information about managing enterprise accounts using the GraphQL API, see "[Enterprise accounts](/v4/guides/managing-enterprise-accounts)." -{% endif %} -### {% data variables.product.prodname_github_connect %} aktivieren - -1. Melden Sie sich bei {% data variables.product.product_location_enterprise %} und {% data variables.product.prodname_dotcom_the_website %} an. -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %} -5. Klicken Sie unter „{% data variables.product.prodname_dotcom_the_website %} is not enabled yet“ ({% data variables.product.prodname_dotcom_the_website %} ist noch nicht aktiviert) auf **Enable {% data variables.product.prodname_github_connect %}** ({% data variables.product.prodname_github_connect %} aktivieren). Wenn Sie auf **Enable {% data variables.product.prodname_github_connect %}** ({% data variables.product.prodname_github_connect %} aktivieren) klicken, stimmen Sie dem {% data variables.product.prodname_github_connect %}-Nachtrag zur {% data variables.product.prodname_enterprise %}-Lizenzvereinbarung zu. ![Schaltfläche „Enable GitHub Connect“ (GitHub Connect aktivieren)](/assets/images/enterprise/business-accounts/enable-github-connect-button.png) -6. Klicken Sie neben dem Enterprise-Konto oder der Organisation, das bzw. die Sie verbinden möchten, auf **Connect** (Verbinden). ![Schaltfläche „Connect“ (Verbinden) neben einem Enterprise-Konto oder Geschäft](/assets/images/enterprise/business-accounts/choose-enterprise-or-org-connect.png) - -### {% data variables.product.prodname_ghe_cloud %}-Organisation oder -Enterprise-Konto von {% data variables.product.product_location_enterprise %} trennen - -Wenn Sie die Verbindung zur {% data variables.product.prodname_ghe_cloud %} trennen, wird die {% data variables.product.prodname_github_connect %} {% data variables.product.prodname_github_app %} aus Ihrem Enterprise-Konto oder Ihrer Organisation gelöscht. Zudem werden die auf {% data variables.product.product_location_enterprise %} gespeicherten Anmeldeinformationen gelöscht. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %} -5. Klicken Sie neben dem Enterprise-Konto oder der Organisation, das bzw. die Sie trennen möchten, auf **Disable {% data variables.product.prodname_github_connect %}** ({% data variables.product.prodname_github_connect %} deaktivieren). ![Schaltfläche „Disable GitHub Connect“ (GitHub Connect deaktivieren) neben dem Namen eines Enterprise-Kontos oder einer Organisation](/assets/images/enterprise/business-accounts/disable-github-connect-button.png) -6. Lesen Sie Informationen zur Trennung, und klicken Sie auf **Disable {% data variables.product.prodname_github_connect %}** ({% data variables.product.prodname_github_connect %} deaktivieren). ![Modalfenster mit Warnhinweisen zur Trennung und Schaltfläche zur Bestätigung](/assets/images/enterprise/business-accounts/confirm-disable-github-connect.png) - diff --git a/translations/de-DE/content/admin/installation/creating-a-high-availability-replica.md b/translations/de-DE/content/admin/installation/creating-a-high-availability-replica.md deleted file mode 100644 index cff8229baca3..000000000000 --- a/translations/de-DE/content/admin/installation/creating-a-high-availability-replica.md +++ /dev/null @@ -1,101 +0,0 @@ ---- -title: Hochverfügbarkeitsreplikat erstellen -intro: 'In einer aktiven/passiven Konfiguration ist die Replikat-Appliance eine redundante Kopie der primären Appliance. Wenn die primäre Appliance ausfällt, ermöglicht der Hochverfügbarkeitsmodus dem Replikat, als primäre Appliance zu fungieren, was eine minimale Dienstunterbrechung ermöglicht.' -redirect_from: - - /enterprise/admin/installation/creating-a-high-availability-replica -versions: - enterprise-server: '*' ---- - -### Hochverfügbarkeitsreplikat erstellen - -1. Richten Sie eine neue {% data variables.product.prodname_ghe_server %}-Appliance auf Ihrer gewünschten Plattform ein. Die Replikat-Appliance sollte die CPU-, RAM- und Speichereinstellungen der primären Appliance spiegeln. Sie sollten die Replikat-Appliance in einer unabhängigen Umgebung installieren. Die zugrunde liegenden Hardware-, Software und Netzwerkkomponenten sollten von denen der primären Appliance isoliert sein. Wenn Sie einen Cloud-Anbieter verwenden, sollten Sie eine separate Region oder Zone verwenden. Weitere Informationen finden Sie unter „[{% data variables.product.prodname_ghe_server %}-Instanz einrichten](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-github-enterprise-server-instance)“. -2. Navigieren Sie in einem Browser zur IP-Adresse der neuen Replikat-Appliance, und laden Sie Ihre {% data variables.product.prodname_enterprise %}-Lizenz hoch. -3. Legen Sie ein Administratorpasswort fest, das dem Passwort auf der primären Appliance entspricht, und setzen Sie den Vorgang fort. -4. Klicken Sie auf **Configure as Replica** (Als Replikat konfigurieren). ![Installationsoptionen mit einem Link zum Konfigurieren Ihrer neuen Instanz als ein Replikat](/assets/images/enterprise/management-console/configure-as-replica.png) -5. Geben Sie unter „Add new SSH key“ (Neuen SSH-Schlüssel hinzufügen) Ihren SSH-Schlüssel ein.![Option zum Hinzufügen eines SSH-Schlüssels](/assets/images/enterprise/management-console/add-ssh-key.png) -6. Klicken Sie auf **Add key** (Schlüssel hinzufügen) und anschließend auf **Continue** (Fortsetzen). -6. Stellen Sie mittels SSH eine Verbindung zur IP-Adresse der Replikat-Appliance her. - ```shell - $ ssh -p 122 admin@REPLICA IP - ``` -7. Führen Sie zum Generieren eines Schlüsselpaars zur Replikation den Befehl `ghe-repl-setup` mit der IP-Adresse der primären Appliance aus, und kopieren Sie den zurückgegebenen öffentlichen Schlüssel. - ```shell - $ ghe-repl-setup PRIMARY IP - ``` -{% data reusables.enterprise_installation.add-ssh-key-to-primary %} -9. Führen Sie den Befehl `ghe-repl-setup` erneut aus, um die Verbindung zur primären Instanz zu verifizieren und um den Replikatmodus für das neue Replikat zu aktivieren. - ```shell - $ ghe-repl-setup PRIMARY IP - ``` -{% data reusables.enterprise_installation.replication-command %} -11. Führen Sie den Befehl `ghe-repl-status` aus, um den Status des Replikationskanals jedes Datenspeichers zu verifizieren. - ```shell - $ ghe-repl-status - ``` - -### Replikate der Geo-Replikation erstellen - -Diese Beispielkonfiguration verwendet eine primäre Instanz und zwei Replikate, die sich in drei unterschiedlichen geografischen Regionen befinden. Obwohl sich die drei Knoten in unterschiedlichen Netzwerken befinden können, müssen alle Knoten über alle anderen Knoten zugänglich sein. Die erforderlichen Verwaltungsports sollten mindestens für alle anderen Knoten geöffnet sein. Weitere Informationen zu den Portanforderungen finden Sie unter „[Netzwerkports](/enterprise/{{ currentVersion }}/admin/guides/installation/network-ports/#administrative-ports)“. - -1. Erstellen Sie das erste Replikat so, wie Sie eine Standardkonfiguration aus zwei Knoten erstellen würden. Führen Sie dazu den Befehl `ghe-repl-setup` auf dem ersten Replikat aus. - ```shell - (replica1)$ ghe-repl-setup PRIMARY IP - (replica1)$ ghe-repl-start - ``` -2. Erstellen Sie ein zweites Replikat, und führen Sie den Befehl `ghe-repl-setup --add` aus. Das Flag `--add` verhindert, dass es die vorhandene Replikationskonfiguration überschreibt, und fügt der Konfiguration das neue Replikat hinzu. - ```shell - (replica2)$ ghe-repl-setup --add PRIMARY IP - (replica2)$ ghe-repl-start - ``` -3. Standardmäßig sind Replikate für das gleiche Rechenzentrum konfiguriert{% if currentVersion ver_gt "enterprise-server@2.17" %} und versuchen nun, ein Seeding von einem vorhandenen Knoten im gleichen Rechenzentrum aus auszuführen{% endif %}. Konfigurieren Sie die Replikate für unterschiedliche Rechenzentren, indem Sie für die Rechenzentrumsoption einen anderen Wert festlegen. Die entsprechenden Werte sind beliebig, sie müssen sich nur voneinander unterscheiden. Führen Sie den Befehl `ghe-repl-node` auf jedem Knoten aus, und geben Sie das Rechenzentrum an. - - Auf der primären Instanz: - ```shell - (primary)$ ghe-repl-node --datacenter [PRIMARY DC NAME] - ``` - Auf dem ersten Replikat: - ```shell - (replica1)$ ghe-repl-node --datacenter [FIRST REPLICA DC NAME] - ``` - Auf dem zweiten Replikat: - ```shell - (replica2)$ ghe-repl-node --datacenter [SECOND REPLICA DC NAME] - ``` - {% tip %} - - **Tipp:** Sie können die Optionen `--datacenter` und `--active` gleichzeitig festlegen. - - {% endtip %} -4. Ein aktiver Replikatknoten speichert Kopien der Appliance-Daten und verarbeitet Anforderungen von Endbenutzern. Ein inaktiver Knoten speichert Kopien der Appliance-Daten, kann die Anforderungen von Endbenutzern jedoch nicht verarbeiten. Aktivieren Sie den aktiven Modus mit dem Flag `--active` oder den inaktiven Modus mit dem Flag `--inactive`. - - Auf dem ersten Replikat: - ```shell - (replica1)$ ghe-repl-node --active - ``` - Auf dem zweiten Replikat: - ```shell - (replica2)$ ghe-repl-node --active - ``` -5. Führen Sie zum Anwenden der Konfiguration auf der primären Instanz den Befehl `ghe-config-apply` aus. - ```shell - (primary)$ ghe-config-apply - ``` - -### DNS für Geo-Replikation konfigurieren - -Konfigurieren Sie Geo DNS mit den IP-Adressen auf der primären Instanz und auf den Replikatknoten. Sie können auch einen DNS CNAME für den primären Knoten (z. B. `primary.github.example.com`) erstellen, um über SSH auf den primären Knoten zuzugreifen oder ihn mit `backup-utils` zu sichern. - -Zu Testzwecken können Sie der Datei `hosts` (z. B. `/etc/hosts`) der lokalen Workstation Einträge hinzufügen. Diese Beispieleinträge lösen Anforderungen für `HOSTNAME` in `replica2` auf. Sie können auf spezifische Hosts abzielen, indem Sie unterschiedliche Zeilen auskommentieren. - -``` -# HOSTNAME -# HOSTNAME - HOSTNAME -``` - -### Weiterführende Informationen - -- „[Informationen zur Hochverfügbarkeitskonfiguration](/enterprise/{{ currentVersion }}/admin/guides/installation/about-high-availability-configuration)“ -- „[Dienstprogramme zur Replikationsverwaltung](/enterprise/{{ currentVersion }}/admin/guides/installation/about-high-availability-configuration/#utilities-for-replication-management)“ -- „[Informationen zur Geo-Replikation](/enterprise/{{ currentVersion }}/admin/guides/installation/about-geo-replication/)“ diff --git a/translations/de-DE/content/admin/installation/disabling-git-ssh-access-on-github-enterprise-server.md b/translations/de-DE/content/admin/installation/disabling-git-ssh-access-on-github-enterprise-server.md deleted file mode 100644 index 1cec5fa6e6da..000000000000 --- a/translations/de-DE/content/admin/installation/disabling-git-ssh-access-on-github-enterprise-server.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: Git-SSH-Zugriff auf GitHub Enterprise Server aktivieren -redirect_from: - - /enterprise/admin/hidden/disabling-ssh-access-for-a-user-account/ - - /enterprise/admin/articles/disabling-ssh-access-for-a-user-account/ - - /enterprise/admin/hidden/disabling-ssh-access-for-your-appliance/ - - /enterprise/admin/articles/disabling-ssh-access-for-your-appliance/ - - /enterprise/admin/hidden/disabling-ssh-access-for-an-organization/ - - /enterprise/admin/articles/disabling-ssh-access-for-an-organization/ - - /enterprise/admin/hidden/disabling-ssh-access-to-a-repository/ - - /enterprise/admin/articles/disabling-ssh-access-to-a-repository/ - - /enterprise/admin/guides/installation/disabling-git-ssh-access-on-github-enterprise/ - - /enterprise/admin/installation/disabling-git-ssh-access-on-github-enterprise-server -intro: 'Sie können Personen daran hindern, für bestimmte oder alle Repositorys auf {% data variables.product.product_location_enterprise %} Git über SSH zu verwenden.' -versions: - enterprise-server: '*' ---- - -### Git-SSH-Zugriff auf ein bestimmtes Repository deaktivieren - -{% data reusables.enterprise_site_admin_settings.override-policy %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -1. Verwenden Sie unter „Git SSH access“ (Git-SSH-Zugriff) das Dropdownmenü, und klicken Sie auf **Disabled** (Deaktiviert). ![Dropdownmenü „Git SSH access“ (Git-SSH-Zugriff) mit ausgewählter Option „Disabled“ (Deaktiviert)](/assets/images/enterprise/site-admin-settings/git-ssh-access-repository-setting.png) - -### Git-SSH-Zugriff auf alle einem Benutzer oder einer Organisation gehörenden Repositorys deaktivieren - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.search-user-or-org %} -{% data reusables.enterprise_site_admin_settings.click-user-or-org %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -7. Verwenden Sie unter „Git SSH access“ (Git-SSH-Zugriff) das Dropdownmenü, und klicken Sie auf **Disabled** (Deaktiviert). Wählen Sie anschließend **Enforce on all repositories** (Auf allen Repositorys erzwingen) aus. ![Dropdownmenü „Git SSH access“ (Git-SSH-Zugriff) mit ausgewählter Option „Disabled“ (Deaktiviert)](/assets/images/enterprise/site-admin-settings/git-ssh-access-organization-setting.png) - -### Git-SSH-Zugriff auf alle Repositorys auf einer Appliance deaktivieren - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -7. Verwenden Sie unter „Git SSH access“ (Git-SSH-Zugriff) das Dropdownmenü, und klicken Sie auf **Disabled** (Deaktiviert). Wählen Sie anschließend **Enforce on all repositories** (Auf allen Repositorys erzwingen) aus. ![Dropdownmenü „Git SSH access“ (Git-SSH-Zugriff) mit ausgewählter Option „Disabled“ (Deaktiviert)](/assets/images/enterprise/site-admin-settings/git-ssh-access-appliance-setting.png) diff --git a/translations/de-DE/content/admin/installation/disabling-the-merge-conflict-editor-for-pull-requests-between-repositories.md b/translations/de-DE/content/admin/installation/disabling-the-merge-conflict-editor-for-pull-requests-between-repositories.md deleted file mode 100644 index e526454cc11f..000000000000 --- a/translations/de-DE/content/admin/installation/disabling-the-merge-conflict-editor-for-pull-requests-between-repositories.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: Editor für Mergekonflikte für Pull Request zwischen Repositorys deaktivieren -intro: 'Sie können festlegen, dass Mergekonflikte lokal aufgelöst werden müssen. Deaktivieren Sie dazu den Editor für Mergekonflikte auf {% data variables.product.prodname_ghe_server %} für Pull Requests, bei denen sich der Basis-Branch und der Head-Branch in unterschiedlichen Repositorys befinden.' -redirect_from: - - /enterprise/admin/installation/disabling-the-merge-conflict-editor-for-pull-requests-between-repositories -versions: - enterprise-server: '*' ---- - -Indem Sie festlegen, dass Benutzer Mergekonflikte lokal auf ihren Computern auflösen müssen, können Sie verhindern, dass sie über ein Fork versehentlich in ein vorgelagertes Repository schreiben. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -1. Verwenden Sie unter „Merge Conflict editor for pull requests between repositories“ (Editor für Mergekonflikte für Pull Requests zwischen Repositorys) das Dropdownmenü, und klicken Sie auf **Disabled** (Deaktiviert). ![Dropdownmenü mit der Option zum Deaktivieren des Editors für Mergekonflikte](/assets/images/enterprise/settings/conflict-editor-settings.png) diff --git a/translations/de-DE/content/admin/installation/enabling-and-scheduling-maintenance-mode.md b/translations/de-DE/content/admin/installation/enabling-and-scheduling-maintenance-mode.md deleted file mode 100644 index 7adfa529fe63..000000000000 --- a/translations/de-DE/content/admin/installation/enabling-and-scheduling-maintenance-mode.md +++ /dev/null @@ -1,61 +0,0 @@ ---- -title: Wartungsmodus aktivieren und planen -intro: 'Für einige Standardwartungsprozeduren, beispielsweise für das Upgrade von {% data variables.product.product_location_enterprise %} oder für das Wiederherstellen von Backups, muss die Instanz für die normale Verwendung offline genommen werden.' -redirect_from: - - /enterprise/admin/maintenance-mode/ - - /enterprise/admin/categories/maintenance-mode/ - - /enterprise/admin/articles/maintenance-mode/ - - /enterprise/admin/articles/enabling-maintenance-mode/ - - /enterprise/admin/articles/disabling-maintenance-mode/ - - /enterprise/admin/guides/installation/maintenance-mode/ - - /enterprise/admin/installation/enabling-and-scheduling-maintenance-mode -versions: - enterprise-server: '*' ---- - -### Informationen zum Wartungsmodus - -Bei einigen Vorgangstypen müssen Sie {% data variables.product.product_location_enterprise %} offline nehmen und in den Wartungsmodus versetzen. -- Upgrade auf eine neue Version von {% data variables.product.prodname_ghe_server %} -- Die der virtuellen Maschine zugeordneten CPU-, Arbeitsspeicher- oder Speicherressourcen erhöhen -- Daten von einer virtuelle Maschine zu einer anderen migrieren -- Daten aus einem {% data variables.product.prodname_enterprise_backup_utilities %}-Snapshot wiederherstellen -- Fehlerbehebung bei bestimmten Typen kritischer Anwendungsprobleme - -Sie sollten ein Wartungsfenster für mindestens 30 Minuten in der Zukunft planen, um Benutzern Vorbereitungszeit zu geben. Nach der Planung eines Wartungsfensters wird allen Benutzern beim Zugriff auf die Website ein Banner angezeigt. - -![Banner zur geplanten Wartung für Endbenutzer](/assets/images/enterprise/maintenance/maintenance-scheduled.png) - -Wenn sich die Instanz im Wartungsmodus befindet, wird der gesamte normale HTTP- und Git-Zugriff abgelehnt. Git-Abruf-, -Klon- und -Push-Vorgänge werden ebenfalls mit einer Fehlermeldung abgelehnt, die angibt, dass die Webseite temporär nicht verfügbar ist. Wenn die Website in einem Browser aufgerufen wird, wird eine Wartungsseite angezeigt. - -![Der Wartungsmodus-Startbildschirm](/assets/images/enterprise/maintenance/maintenance-mode-maintenance-page.png) - -### Wartungsmodus sofort aktiviert oder Wartungsfenster für späteren Zeitpunkt planen - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -2. Klicken Sie im oberen Bereich der {% data variables.enterprise.management_console %} auf **Maintenance** (Wartung). ![Registerkarte „Maintenance“ (Wartung)](/assets/images/enterprise/management-console/maintenance-tab.png) -3. Legen Sie unter „Enable and schedule“ (Aktivieren und planen) fest, ob der Wartungsmodus sofort aktiviert werden soll oder ein Wartungsfenster für einen künftigen Zeitpunkt geplant werden soll. - - Verwenden Sie zum sofortigen Aktivieren des Wartungsmodus das Dropdownmenü, und klicken Sie auf **now** (Jetzt). ![Dropdownmenü mit der ausgewählten Option „now“ (Jetzt) zum Aktivieren des Wartungsmodus](/assets/images/enterprise/maintenance/enable-maintenance-mode-now.png) - - Verwenden Sie das Dropdownmenü, und klicken Sie auf eine Startzeit, wenn Sie das Wartungsfenster für einen künftigen Zeitpunkt planen möchten.![Dropdownmenü mit der ausgewählten Option zum Planen des Wartungsfensters in zwei Stunden](/assets/images/enterprise/maintenance/schedule-maintenance-mode-two-hours.png) -4. Wählen Sie **Enable maintenance mode** (Wartungsmodus aktivieren) aus. ![Kontrollkästchen zum Aktivieren oder Planen des Wartungsmodus](/assets/images/enterprise/maintenance/enable-maintenance-mode-checkbox.png) -{% data reusables.enterprise_management_console.save-settings %} - -### Wartungsmodus mit {% data variables.product.prodname_enterprise_api %} planen - -Mit der {% data variables.product.prodname_enterprise_api %} können Sie die Wartung für unterschiedliche Zeitpunkt oder Datumsangaben planen. For more information, see "[Management Console](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#enable-or-disable-maintenance-mode)." - -### Wartungsmodus für alle Knoten in einem Cluster aktivieren oder deaktivieren - -Mit dem Dienstprogramm `ghe-cluster-maintenance` können Sie den Wartungsmodus für jeden Knoten in einem Cluster festlegen oder dessen Festlegung aufheben. - -```shell -$ ghe-cluster-maintenance -h -# Optionen anzeigen -$ ghe-cluster-maintenance -q -# Abfragen im aktuellen Modus -$ ghe-cluster-maintenance -s -# Legt den Wartungsmodus fest -$ ghe-cluster-maintenance -u -# Hebt die Festlegung des Wartungsmodus auf -``` diff --git a/translations/de-DE/content/admin/installation/enabling-automatic-update-checks.md b/translations/de-DE/content/admin/installation/enabling-automatic-update-checks.md deleted file mode 100644 index a0570358b4e8..000000000000 --- a/translations/de-DE/content/admin/installation/enabling-automatic-update-checks.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: Prüfungen auf automatische Updates aktivieren -intro: 'Sie können Prüfungen auf automatische Updates aktivieren, sodass {% data variables.product.product_location_enterprise %} nach der neuesten {% data variables.product.prodname_ghe_server %}-Version sucht und diese herunterlädt.' -redirect_from: - - /enterprise/admin/installation/enabling-automatic-update-checks -versions: - enterprise-server: '*' ---- - -Wenn ein Upgrade-Pakete für {% data variables.product.product_location_enterprise %} automatisch heruntergeladen wird, wird in einer Meldung angezeigt, dass Sie ein Upgrade von {% data variables.product.prodname_ghe_server %} durchführen können. Pakete werden auf {% data variables.product.product_location_enterprise %} in das Verzeichnis `/var/lib/ghe-updates` heruntergeladen. Weitere Informationen finden Sie unter „[Upgrade von {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-github-enterprise-server)“. - -Wenn für ein Upgrade ein Hotpatch verfügbar ist, wird die Datei `.hpkg` automatisch heruntergeladen. In der Managementkonsole können Sie festlegen, dass der Hotpatch sofort installiert wird. Alternativ können Sie festlegen, dass seine Installation für einen späteren Zeitpunkt geplant wird. Weitere Informationen finden Sie unter „[Upgrade mit einem Hotpatch](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-github-enterprise-server#upgrading-with-a-hotpatch)“. - -{% tip %} - -**Tipp:** Zum Aktivieren von Prüfungen auf automatische Updates muss {% data variables.product.product_location_enterprise %} eine Verbindung zu `https://github-enterprise.s3.amazonaws.com` herstellen können. - -{% endtip %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.updates-tab %} -4. Klicken Sie auf **Yes, automatically check for updates** (Ja, automatisch nach Updates suchen). ![Schaltfläche zum Aktivieren automatischer Updates](/assets/images/enterprise/management-console/enable_updates_button.png) -{% data reusables.enterprise_management_console.save-settings %} - -Überprüfen Sie das Banner auf der Registerkarte „Updates“, um zu sehen, ob Ihre Instanz aktuell ist. - -![Banner mit Ihrer GitHub Enterprise Server-Version](/assets/images/enterprise/management-console/up-to-date-banner.png) - -Unter „**Logs**“ (Protokolle) können Sie den Status der neuesten Prüfung auf Updates anzeigen. - -![Protokolle für das Update](/assets/images/enterprise/management-console/update-log.png) diff --git a/translations/de-DE/content/admin/installation/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud.md b/translations/de-DE/content/admin/installation/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud.md deleted file mode 100644 index 66933ae53f44..000000000000 --- a/translations/de-DE/content/admin/installation/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: Automatische Synchronisierung von Benutzerlizenzen zwischen GitHub Enterprise Server und GitHub Enterprise Cloud aktivieren -intro: 'Sie können zwischen {% data variables.product.product_location_enterprise %} und {% data variables.product.prodname_ghe_cloud %} eine Verbindung herstellen und festlegen, dass {% data variables.product.prodname_ghe_server %} Informationen zu Benutzerlizenzen auf Ihr Enterprise-Konto auf {% data variables.product.prodname_dotcom_the_website %} hochladen kann.' -permissions: 'Site-Administratoren für {% data variables.product.prodname_ghe_server %} , die auch Inhaber der angeschlossenen Organisation oder des angeschlossenen Unternehmenskontos in der {% data variables.product.prodname_ghe_cloud %} sind, können die automatische Synchronisation von Benutzerlizenzen aktivieren.' -redirect_from: - - /enterprise/admin/installation/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud -versions: - enterprise-server: '*' ---- - -### Informationen zur Lizenzsynchronisierung - -After you enable license synchronization, you'll be able to view license usage for your entire enterprise account, across {% data variables.product.prodname_ghe_server %} and {% data variables.product.prodname_ghe_cloud %}. {% data variables.product.prodname_github_connect %} syncs license between {% data variables.product.prodname_ghe_server %} and {% data variables.product.prodname_ghe_cloud %} weekly. Weitere Informationen findest Du unter "[Deine {% data variables.product.prodname_enterprise %}-Lizenz verwalten](/enterprise/{{currentVersion}}/admin/installation/managing-your-github-enterprise-license)." - -Darüber hinaus können Sie Informationen zu {% data variables.product.prodname_ghe_server %}-Benutzerlizenzen manuell auf {% data variables.product.prodname_ghe_cloud %} hochladen. Weitere Informationen finden Sie unter „[{% data variables.product.prodname_ghe_server %} mit {% data variables.product.prodname_ghe_cloud %} verbinden](/enterprise/{{ currentVersion }}/admin/guides/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)“. - -### Lizenzsynchronisierung aktivieren - -Vor der Aktivierung der Lizenzsynchronisierung auf {% data variables.product.product_location_enterprise %} müssen Sie zwischen {% data variables.product.product_location_enterprise %} und {% data variables.product.prodname_dotcom_the_website %} eine Verbindung herstellen. Weitere Informationen finden Sie unter „[{% data variables.product.prodname_ghe_server %} mit {% data variables.product.prodname_ghe_cloud %} verbinden](/enterprise/{{ currentVersion }}/admin/guides/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)“. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %} -5. Verwenden Sie unter „Server can sync user license count and usage“ (Server kann Anzahl und Nutzung der Benutzerlizenzen synchronisieren) das Dropdownmenü, und wählen Sie **Enabled** (Aktiviert) aus. ![Dropdownmenü zum Aktivieren der automatischen Synchronisierung von Benutzerlizenzen](/assets/images/enterprise/site-admin-settings/enable-user-license-drop-down.png) diff --git a/translations/de-DE/content/admin/installation/enabling-private-mode.md b/translations/de-DE/content/admin/installation/enabling-private-mode.md deleted file mode 100644 index 2504e8961fd8..000000000000 --- a/translations/de-DE/content/admin/installation/enabling-private-mode.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: Privaten Modus aktivieren -intro: 'Im privaten Modus erfordert {% data variables.product.prodname_ghe_server %}, dass sich jeder Benutzer anmeldet, um auf die Installation zuzugreifen.' -redirect_from: - - /enterprise/admin/articles/private-mode/ - - /enterprise/admin/guides/installation/security/ - - /enterprise/admin/guides/installation/securing-your-instance/ - - /enterprise/admin/installation/enabling-private-mode -versions: - enterprise-server: '*' ---- - -Sie müssen den privaten Modus aktivieren, wenn {% data variables.product.product_location_enterprise %} über das Internet öffentlich zugänglich ist. Im privaten Modus ist es Benutzern nicht möglich, Repositorys anonym über `git://` zu klonen. Wenn die integrierte Authentifizierung aktiviert ist, muss ein Administrator neue Benutzer einladen, um ein Konto auf der Instanz zu erstellen. Weitere Informationen finden Sie unter „[Integrierte Authentifizierung verwenden](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-built-in-authentication)“. - -{% data reusables.enterprise_installation.image-urls-viewable-warning %} - -Wenn der private Modus aktiviert ist, können Sie festlegen, dass nicht authentifizierte Git-Vorgänge (und jedermann mit Netzwerkzugriff auf {% data variables.product.product_location_enterprise %}) mit aktiviertem anonymem Git-Lesezugriff den Code eines öffentlichen Repositorys auf Ihrer Instanz lesen können. Weitere Informationen finden Sie unter „[Administratoren das Aktivieren des anonymen Git-Lesezugriffs auf öffentliche Repositorys erlauben](/enterprise/{{ currentVersion }}/admin/guides/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories)“. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -4. Wählen Sie **Private mode** (Privater Modus) aus. ![Kontrollkästchen zum Aktivieren des privaten Modus](/assets/images/enterprise/management-console/private-mode-checkbox.png) -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/de-DE/content/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md b/translations/de-DE/content/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md deleted file mode 100644 index 7b76eaefcf63..000000000000 --- a/translations/de-DE/content/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: Sicherheitsmeldungen für angreifbare Abhängigkeiten auf GitHub Enterprise Server aktivieren -intro: 'Sie können zwischen {% data variables.product.product_location_enterprise %} und {% data variables.product.prodname_ghe_cloud %} eine Verbindung herstellen und Sicherheitsmeldungen für angreifbare Abhängigkeiten in Repositorys auf Ihrer Instanz aktivieren.' -permissions: 'Site-Administratoren für {% data variables.product.prodname_ghe_server %} , die auch Inhaber der angeschlossenen Organisation oder des angeschlossenen Unternehmenskontos in der {% data variables.product.prodname_ghe_cloud %} sind, können Sicherheitswarnungen für ungeschützte Abhängigkeiten auf {% data variables.product.prodname_ghe_server %} aktivieren.' -redirect_from: - - /enterprise/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server -versions: - enterprise-server: '*' ---- - -### About alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %} - -{% data reusables.repositories.tracks-vulnerabilities %} For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)." - -Sie können zwischen {% data variables.product.product_location_enterprise %} und {% data variables.product.prodname_dotcom_the_website %} eine Verbindung herstellen, dann die Schwachstellendaten mit Ihrer Instanz synchronisieren und Sicherheitsmeldungen in Repositorys generieren, die eine angreifbare Abhängigkeit aufweisen. - -Nachdem Sie {% data variables.product.product_location_enterprise %} mit {% data variables.product.prodname_dotcom_the_website %} verbunden und Sicherheitsmeldungen für angreifbare Abhängigkeiten aktiviert haben, werden die Schwachstellendaten stündlich von {% data variables.product.prodname_dotcom_the_website %} mit Ihrer Instanz synchronisiert. Sie können die Schwachstellendaten auch jederzeit manuell synchronisieren. Es werden weder Code noch Informationen zu Code von {% data variables.product.product_location_enterprise %} auf {% data variables.product.prodname_dotcom_the_website %} hochgeladen. - -Wenn {% data variables.product.product_location_enterprise %} Informationen zu einer Schwachstelle empfängt, werden die Repositorys in Ihrer Instanz identifiziert, welche die betroffene Version der Abhängigkeit verwenden. Zudem werden Sicherheitsmeldungen an Inhaber und Personen gesendet, die in diesen Repositorys über Administratorzugriff verfügen. Sie können anpassen, wie sie Sicherheitsmeldungen empfangen möchten. For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies/#configuring-notifications-for-security-alerts)." - -### Sicherheitsmeldungen für angreifbare Abhängigkeiten auf {% data variables.product.prodname_ghe_server %} aktivieren - -Bevor Sie Sicherheitsmeldungen für angreifbare Abhängigkeiten auf {% data variables.product.product_location_enterprise %} aktivieren, müssen Sie {% data variables.product.product_location_enterprise %} mit {% data variables.product.prodname_dotcom_the_website %} verbinden. Weitere Informationen finden Sie unter „[{% data variables.product.prodname_ghe_server %} mit {% data variables.product.prodname_ghe_cloud %} verbinden](/enterprise/{{ currentVersion }}/admin/guides/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)“. - -{% if currentVersion ver_gt "enterprise-server@2.20" %} We recommend configuring security alerts without notifications for the first few days to avoid an overload of emails. After a few days, you can enable notifications to receive security alerts as usual.{% endif %} - -{% data reusables.enterprise_site_admin_settings.sign-in %} -2. Aktivieren Sie in der Verwaltungsshell die Sicherheitsmeldungen für angreifbare Abhängigkeiten auf {% data variables.product.product_location_enterprise %}: - ``` shell -$ ghe-dep-graph-enable -``` -3. Kehren Sie zu {% data variables.product.prodname_ghe_server %} zurück. -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %}{% if currentVersion ver_gt "enterprise-server@2.20" %} -5. Under "Repositories can be scanned for vulnerabilities", use the drop-down menu and select **Enabled without notifications**. Optionally, to enable alerts with notifications, select **Enabled with notifications**.{% else %} -5. Verwenden Sie unter „Repositories can be scanned for vulnerabilities“ (Repositorys können auf Schwachstellen überprüft werden) das Dropdownmenü, und wählen Sie **Enabled** (Aktiviert) aus. -{% endif %} - ![Dropdownmenü zum Aktivieren der Überprüfung von Repositorys auf Schwachstellen](/assets/images/enterprise/site-admin-settings/enable-vulnerability-scanning-in-repositories.png) - -### Angreifbare Abhängigkeiten auf {% data variables.product.prodname_ghe_server %} anzeigen - -Sie können alle Schwachstellen in {% data variables.product.product_location_enterprise %} anzeigen und Schwachstellendaten von {% data variables.product.prodname_dotcom_the_website %} manuell synchronisieren, um die Liste zu aktualisieren. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -2. Klicken Sie auf der linken Seitenleiste auf **Vulnerabilities** (Schwachstellen). ![Registerkarte „Vulnerabilities“ (Schwachstellen) auf der Seitenleiste für Websiteadministratoren](/assets/images/enterprise/business-accounts/vulnerabilities-tab.png) -3. Klicken Sie zum Synchronisieren von Schwachstellendaten auf **Sync Vulnerabilities now** (Schwachstellen jetzt synchronisieren). ![Schaltfläche „Sync vulnerabilities now“ (Schwachstellen jetzt synchronisieren)](/assets/images/enterprise/site-admin-settings/sync-vulnerabilities-button.png) diff --git a/translations/de-DE/content/admin/installation/enabling-subdomain-isolation.md b/translations/de-DE/content/admin/installation/enabling-subdomain-isolation.md deleted file mode 100644 index 90029bb322f9..000000000000 --- a/translations/de-DE/content/admin/installation/enabling-subdomain-isolation.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: Subdomain-Isolation aktivieren -intro: 'Sie können die Subdomain-Isolation so festlegen, dass der Benutzerinhalt von anderen Teilen Ihrer {% data variables.product.prodname_ghe_server %}-Appliance sicher getrennt wird.' -redirect_from: - - /enterprise/admin/guides/installation/about-subdomain-isolation/ - - /enterprise/admin/installation/enabling-subdomain-isolation -versions: - enterprise-server: '*' ---- - -### Informationen zur Subdomain-Isolation - -Die Subdomain-Isolation mindert Cross-Site-Scripting und andere verwandte Schwachstellen. Weitere Informationen finden Sie unter „[Cross-Site-Scripting](https://de.wikipedia.org/wiki/Cross-Site-Scripting)“ auf Wikipedia. Es wird dringend empfohlen, die Subdomain-Isolation auf {% data variables.product.product_location_enterprise %} zu aktivieren. - -Bei aktivierter Subdomain-Isolation ersetzt {% data variables.product.prodname_ghe_server %} verschiedene Pfade durch Subdomains. - -| Pfad ohne Subdomain-Isolation | Pfad mit Subdomain-Isolation | -| ------------------------------ | ------------------------------ | -| `http(s)://HOSTNAME/assets/` | `http(s)://assets.HOSTNAME/` | -| `http(s)://HOSTNAME/avatars/` | `http(s)://avatars.HOSTNAME/` | -| `http(s)://HOSTNAME/codeload/` | `http(s)://codeload.HOSTNAME/` | -| `http(s)://HOSTNAME/gist/` | `http(s)://gist.HOSTNAME/` | -| `http(s)://HOSTNAME/media/` | `http(s)://media.HOSTNAME/` | -| `http(s)://HOSTNAME/pages/` | `http(s)://pages.HOSTNAME/` | -| `http(s)://HOSTNAME/raw/` | `http(s)://raw.HOSTNAME/` | -| `http(s)://HOSTNAME/render/` | `http(s)://render.HOSTNAME/` | -| `http(s)://HOSTNAME/reply/` | `http(s)://reply.HOSTNAME/` | -| `http(s)://HOSTNAME/uploads/` | `http(s)://uploads.HOSTNAME/` | - -### Voraussetzungen - -{% data reusables.enterprise_installation.disable-github-pages-warning %} - -Vor der Aktivierung der Subdomain-Isolation müssen Sie Ihre Netzwerkeinstellungen für Ihre neue Domain konfigurieren. - -- Geben Sie anstelle einer IP-Adresse einen gültigen Domain-Namen als Ihren Hostnamen an. Weitere Informationen findest Du unter "[Hostname konfigurieren](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-a-hostname)." - -{% data reusables.enterprise_installation.changing-hostname-not-supported %} - -- Legen Sie einen Domain Name System-Platzhaltereintrag (DNS) oder einzelne DNS-Einträge für die oben aufgelisteten Subdomains fest. Sie sollten einen Eintrag für `*.HOSTNAME` erstellen, der auf die IP-Adresse Ihres Servers verweist, damit Sie nicht für jede Subdomain mehrere Einträge erstellen müssen. -- Rufen Sie ein Transport Layer Security-Platzhalterzertifikat (TLS) für `*.HOSTNAME` mit Subject Alternative Name (SAN) für `HOSTNAME` und für die Platzhalter-Domain `*.HOSTNAME` ab. Wenn Ihr Hostname beispielsweise `github.octoinc.com` lautet, rufen Sie ein Zertifikat mit dem CN-Wert `*.github.octoinc.com` und einem SAN-Wert ab, der auf `github.octoinc.com` und `*.github.octoinc.com` festgelegt ist. -- Aktivieren Sie TLS auf Ihrer Appliance. Weitere Informationen finden Sie unter „[TLS konfigurieren](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-tls/)“. - -### Subdomain-Isolation aktivieren - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.hostname-menu-item %} -4. Wählen Sie **Subdomain isolation (recommended)** (Subdomain-Isolation (empfohlen)) aus. ![Kontrollkästchen zum Aktivieren der Subdomain-Isolation](/assets/images/enterprise/management-console/subdomain-isolation.png) -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/de-DE/content/admin/installation/enabling-unified-contributions-between-github-enterprise-server-and-githubcom.md b/translations/de-DE/content/admin/installation/enabling-unified-contributions-between-github-enterprise-server-and-githubcom.md deleted file mode 100644 index b9f26d390b43..000000000000 --- a/translations/de-DE/content/admin/installation/enabling-unified-contributions-between-github-enterprise-server-and-githubcom.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: Einheitliche Beiträge zwischen GitHub Enterprise Server und GitHub.com aktivieren -intro: 'Nach der Aktivierung von {% data variables.product.prodname_github_connect %} können Sie festlegen, dass {% data variables.product.prodname_ghe_cloud %}-Mitglieder ihre Arbeit auf {% data variables.product.prodname_ghe_server %} hervorheben können, indem sie die Beitragsanzahlen an ihre {% data variables.product.prodname_dotcom_the_website %}-Profile senden.' -redirect_from: - - /enterprise/admin/guides/developer-workflow/enabling-unified-contributions-between-github-enterprise-and-github-com/ - - /enterprise/admin/guides/developer-workflow/enabling-unified-contributions-between-github-enterprise-server-and-github-com/ - - /enterprise/admin/developer-workflow/enabling-unified-contributions-between-github-enterprise-server-and-githubcom/ - - /enterprise/admin/installation/enabling-unified-contributions-between-github-enterprise-server-and-githubcom -permissions: 'Website-Administratoren für {% data variables.product.prodname_ghe_server %} , die auch Inhaber einer Organisation oder eines Unternehmenskontos in der {% data variables.product.prodname_ghe_cloud %} sind, können vereinheitlichte Beiträge zwischen {% data variables.product.prodname_ghe_server %} und {% data variables.product.prodname_dotcom_the_website %} aktivieren.' -versions: - enterprise-server: '*' ---- - -Als Websiteadministrator können Sie zulassen, dass Endbenutzer anonymisierte Beitragsanzahlen für ihre Arbeit auf {% data variables.product.prodname_ghe_server %} an ihr {% data variables.product.prodname_dotcom_the_website %}-Beteiligungsdiagramm senden können. - -Nachdem Sie {% data variables.product.prodname_github_connect %} und {% data variables.product.prodname_unified_contributions %} in beiden Umgebungen aktiviert haben, können sich Endbenutzer auf Ihrer Instanz mit ihren {% data variables.product.prodname_dotcom_the_website %}-Konten verbinden und Beitragsanzahlen von {% data variables.product.prodname_ghe_server %} an {% data variables.product.prodname_dotcom_the_website %} senden. {% data reusables.github-connect.sync-frequency %} Weitere Informationen finden Sie unter „[Ihre {% data variables.product.prodname_ghe_server %}-Beiträge an Ihr {% data variables.product.prodname_dotcom_the_website %}-Profil senden](/articles/sending-your-github-enterprise-server-contributions-to-your-github-com-profile/)“. - -Wenn der Websiteadministrator die Funktion deaktiviert oder Entwickler die Verbindung abbrechen, werden die {% data variables.product.prodname_ghe_server %}-Beitragsanzahlen auf {% data variables.product.prodname_dotcom_the_website %} gelöscht. Wenn der Entwickler seine Profile nach ihrer Deaktivierung erneut verbindet, werden die Beitragsanzahlen für die letzten 90 Tage wiederhergestellt. - -{% data variables.product.prodname_ghe_server %} sendet die Beitragsanzahl und -quelle ({% data variables.product.prodname_ghe_server %}) **nur** für verbundene Benutzer. Es werden weder Informationen zum Beitrag noch dazu gesendet, wie er zustande kam. - -Vor der Aktivierung von {% data variables.product.prodname_unified_contributions %} auf {% data variables.product.product_location_enterprise %} müssen Sie {% data variables.product.product_location_enterprise %} mit {% data variables.product.prodname_dotcom_the_website %} verbinden. Weitere Informationen finden Sie unter „[{% data variables.product.prodname_ghe_server %} mit {% data variables.product.prodname_dotcom_the_website %}](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/connecting-github-enterprise-server-to-github-com) verbinden“. - -{% data reusables.github-connect.access-dotcom-and-enterprise %} -{% data reusables.enterprise_site_admin_settings.access-settings %}{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %} -4. Klicken Sie unter „Users can share contribution counts to {% data variables.product.prodname_dotcom_the_website %}“ (Benutzer können ihre Beitragsanzahlen auf {% data variables.product.prodname_dotcom_the_website %} freigeben) auf **Request access** (Zugriff anfordern). ![Option zum Anfordern des Zugriffs auf einheitliche Beiträge](/assets/images/enterprise/site-admin-settings/dotcom-ghe-connection-request-access.png) -5. Weitere Anweisungen erhalten Sie, wenn Sie sich bei der {% data variables.product.prodname_ghe_server %}-Website [anmelden](https://enterprise.github.com/login). - -Wenn Sie den Zugriff anfordern, werden Sie zur {% data variables.product.prodname_ghe_server %}-Website weitergeleitet, um Ihre aktuellen Nutzungsbedingungen zu überprüfen. Wenn {% data variables.product.product_location_enterprise %} die Standardnutzungsbedingungen verwendet, werden Sie durch die Anforderung automatisch zu den Anweisungen für die Aktivierung von {% data variables.product.prodname_unified_contributions %} weitergeleitet. Wenn Sie benutzerdefinierte Nutzungsbedingungen verwenden, wird Ihre Anforderung protokolliert, und Sie werden zum Einrichten des Zugriffs kontaktiert. diff --git a/translations/de-DE/content/admin/installation/enabling-unified-search-between-github-enterprise-server-and-githubcom.md b/translations/de-DE/content/admin/installation/enabling-unified-search-between-github-enterprise-server-and-githubcom.md deleted file mode 100644 index 3443d9d502e7..000000000000 --- a/translations/de-DE/content/admin/installation/enabling-unified-search-between-github-enterprise-server-and-githubcom.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: Gemeinsame Suche zwischen GitHub Enterprise Server und GitHub.com aktivieren -intro: 'Nachdem Sie {% data variables.product.prodname_github_connect %} aktiviert haben, können Sie die Suche nach {% data variables.product.prodname_dotcom_the_website %} von Ihrer {% data variables.product.product_location_enterprise %} aus zulassen.' -redirect_from: - - /enterprise/admin/guides/developer-workflow/enabling-unified-search-between-github-enterprise-and-github-com/ - - /enterprise/admin/guides/developer-workflow/enabling-unified-search-between-github-enterprise-server-and-github-com/ - - /enterprise/admin/developer-workflow/enabling-unified-search-between-github-enterprise-server-and-githubcom/ - - /enterprise/admin/installation/enabling-unified-search-between-github-enterprise-server-and-githubcom -permissions: 'Website-Administratoren für {% data variables.product.prodname_ghe_server %} , die auch Inhaber einer Organisation oder eines Unternehmenskontos in der {% data variables.product.prodname_ghe_cloud %} sind, können vereinheitlichte Suche zwischen {% data variables.product.prodname_ghe_server %} und {% data variables.product.prodname_dotcom_the_website %} aktivieren.' -versions: - enterprise-server: '*' ---- - -Wenn Sie die gemeinsame Suche aktivieren, können Benutzer Suchergebnisse von öffentlichen und privaten Inhalten auf {% data variables.product.prodname_dotcom_the_website %} anzeigen, wenn sie auf {% data variables.product.product_location_enterprise %} suchen. - -Benutzer können auf {% data variables.product.prodname_dotcom_the_website %} nicht nach {% data variables.product.product_location_enterprise %} suchen, selbst wenn sie auf beide Umgebungen zugreifen können. Benutzer können nur auf die privaten Repositorys zugreifen, für die Sie {% data variables.product.prodname_unified_search %} aktiviert haben und auf die sie in den verbundenen {% data variables.product.prodname_ghe_cloud %}-Organisationen zugreifen können. Weitere Informationen finden Sie unter „[Informationen zur Suche auf {% data variables.product.prodname_dotcom %}](/articles/about-searching-on-github/#searching-across-github-enterprise-and-githubcom-simultaneously)“ und „[Private {% data variables.product.prodname_dotcom_the_website %}-Repository-Suche in Ihrem {% data variables.product.prodname_ghe_server %}-Konto aktivieren](/articles/enabling-private-github-com-repository-search-in-your-github-enterprise-server-account)“. - -Bei der Suche über die REST und GraphQL-APIs sind die {% data variables.product.prodname_dotcom_the_website %}-Suchergebnisse nicht enthalten. Die erweiterte Suche und die Suche nach Wikis in {% data variables.product.prodname_dotcom_the_website %} werden nicht unterstützt. - -{% data reusables.github-connect.access-dotcom-and-enterprise %} -{% data reusables.enterprise_site_admin_settings.access-settings %}{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %} -5. Verwenden Sie unter „Users can search {% data variables.product.prodname_dotcom_the_website %}“ (Benutzer können {% data variables.product.prodname_dotcom_the_website %} durchsuchen) das Dropdownmenü, und klicken Sie auf **Enabled** (Aktiviert). ![Option zum Aktivieren der Suche im Dropdownmenü zum Durchsuchen von GitHub.com](/assets/images/enterprise/site-admin-settings/github-dotcom-enable-search.png) -6. Verwenden Sie optional unter „Users can search private repositories on {% data variables.product.prodname_dotcom_the_website %}“ (Benutzer können private Repositorys auf {% data variables.product.prodname_dotcom_the_website %} durchsuchen) das Dropdownmenü, und klicken Sie auf **Enabled** (Aktiviert). ![Option zum Aktivieren der Suche nach privaten Repositorys im Dropdownmenü zum Durchsuchen von GitHub.com](/assets/images/enterprise/site-admin-settings/enable-private-search.png) - -### Weiterführende Informationen - -- „[{% data variables.product.prodname_ghe_server %} mit {% data variables.product.prodname_dotcom_the_website %} verbinden](/enterprise/admin/guides/developer-workflow/connecting-github-enterprise-server-to-github-com)“ diff --git a/translations/de-DE/content/admin/installation/getting-started-with-github-enterprise-server.md b/translations/de-DE/content/admin/installation/getting-started-with-github-enterprise-server.md deleted file mode 100644 index bd051f41b32f..000000000000 --- a/translations/de-DE/content/admin/installation/getting-started-with-github-enterprise-server.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Erste Schritte mit GitHub Enterprise Server -shortTitle: Erste Schritte -intro: 'Erfahre mehr über {% data variables.product.prodname_ghe_server %} und wie Du Deine Lizenz verwalten kannst.' -mapTopic: true -redirect_from: - - /enterprise/admin/installation/getting-started-with-github-enterprise-server -versions: - enterprise-server: '*' ---- - diff --git a/translations/de-DE/content/admin/installation/increasing-cpu-or-memory-resources.md b/translations/de-DE/content/admin/installation/increasing-cpu-or-memory-resources.md deleted file mode 100644 index fcd22b931872..000000000000 --- a/translations/de-DE/content/admin/installation/increasing-cpu-or-memory-resources.md +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: CPU- und Arbeitsspeicherressourcen erhöhen -intro: 'Um einer vorhandenen {% data variables.product.prodname_ghe_server %}-Instanz CPU- oder Arbeitsspeicherressourcen hinzuzufügen, fahren Sie die Instanz herunter, und verwenden Sie die Tools der zugrunde liegenden virtuellen Plattform, um der virtuellen Maschine die Ressourcen zuzuordnen. Die neu zugeordneten Ressourcen werden beim Start erkannt. Zudem ist keine zusätzliche Konfiguration erforderlich.' -redirect_from: - - /enterprise/admin/installation/increasing-cpu-or-memory-resources -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_installation.warning-on-upgrading-physical-resources %} - -### CPU- oder Arbeitsspeicherressourcen für AWS hinzufügen - -{% note %} - -**Hinweis:** Um CPU- oder Arbeitsspeicherressourcen für AWS hinzuzufügen, müssen Sie zum Verwalten der EC2-Instanzen mit der Verwendung der AWS Management Console oder der `aws ec2`-Befehlszeilenschnittstelle vertraut sein. Hintergründe und Details zur Verwendung der gewünschten AWS-Tools zum Durchführen der Größenanpassung finden Sie in der AWS-Dokumentation unter [Größenanpassung einer Amazon EBS-gestützten Instanz](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-resize.html). - -{% endnote %} - -#### Grundlegendes zur Größenanpassung - -Bevor Sie die CPU- oder Arbeitsspeicherressourcen für {% data variables.product.product_location_enterprise %} erhöhen: -{% if currentVersion != "free-pro-team@latest" %} -- **Arbeitsspeicher mit CPUs skalieren** - {% data reusables.enterprise_installation.increasing-cpus-max %}{% endif %} -- **Verifizieren Sie, dass der Instanz eine Elastic IP zugewiesen ist** - - Falls keine Elastic IP zugewiesen ist, müssen Sie die DNS A-Einträge für Ihren {% data variables.product.prodname_ghe_server %}-Host nach dem Neustart anpassen, damit die an der öffentlichen IP-Adresse vorgenommenen Änderungen berücksichtigt werden. Sobald Ihre Instanz neu gestartet wird, wird die Elastic IP (EIP) automatisch gespeichert, wenn die Instanz in einer VPC gestartet wird. Wenn die Instanz in EC2-Classic gestartet wird, muss die Elastic IP erneut manuell zugeordnet werden. - -#### Unterstützte AWS Instance-Typen - -Sie müssen anhand der CPU-/Arbeitsspeicherspezifikationen den Instanztyp bestimmen, für den Sie ein Upgrade vornehmen möchten. -{% data reusables.enterprise_installation.aws-supported-instance-types %} - -#### Empfohlene AWS Instance-Typen - -{% data reusables.enterprise_installation.aws-recommended-instance-types %} - -{% data reusables.enterprise_installation.warning-on-scaling %} - -#### Größenanpassung für AWS - -{% note %} - -**Hinweis:** Notieren Sie sich für die in EC2-Classic gestarteten Instanzen die der Instanz zugeordnete Elastic IP-Adresse und die ID der Instanz. Ordnen Sie nach dem Neustart der Instanz die Elastic IP-Adresse erneut zu. - -{% endnote %} - -Es ist nicht möglich, einer vorhandenen AWS-/EC2 Instance CPU- oder Arbeitsspeicherressourcen hinzuzufügen. Gehen Sie stattdessen wie folgt vor: - -1. Beenden Sie die Instanz. -2. Ändern Sie den Instanztyp. -3. Starten Sie die Instanz. -{% data reusables.enterprise_installation.configuration-recognized %} - -### CPU- oder Arbeitsspeicherressourcen für OpenStack KVM hinzufügen - -Es ist nicht möglich, einer vorhandenen OpenStack KVM-Instanz CPU- oder Arbeitsspeicherressourcen hinzuzufügen. Gehen Sie stattdessen wie folgt vor: - -1. Erstellen Sie einen Snapshot der aktuellen Instanz. -2. Beenden Sie die Instanz. -3. Wählen Sie eine neue Instanzvariante mit den gewünschten CPU- bzw. Arbeitsspeicherressourcen aus. - -### CPU- oder Arbeitsspeicherressourcen für VMware hinzufügen - -Wenn Vorgänge auf {% data variables.product.product_location_enterprise %} langsam sind, müssen Sie ggf. CPU- oder Arbeitsspeicherressourcen hinzufügen. - -{% data reusables.enterprise_installation.increasing-cpus-max %} - -1. Verwenden Sie vSphere Client, um eine Verbindung zum VMware ESXi-Host herzustellen. -2. Fahren Sie {% data variables.product.product_location_enterprise %} herunter. -3. Wählen Sie die virtuelle Maschine aus, und klicken Sie auf **Edit Settings** (Einstellungen bearbeiten). -4. Passen Sie unter „Hardware“ die der virtuellen Maschine zugeordneten CPU- bzw. Arbeitsspeicherressourcen nach Bedarf an:![VMware-Einrichtungsressourcen](/assets/images/enterprise/vmware/vsphere-hardware-tab.png) -5. Klicken Sie zum Starten der virtuellen Maschine auf **OK**. -{% data reusables.enterprise_installation.configuration-recognized %} diff --git a/translations/de-DE/content/admin/installation/increasing-storage-capacity.md b/translations/de-DE/content/admin/installation/increasing-storage-capacity.md deleted file mode 100644 index ff015c607232..000000000000 --- a/translations/de-DE/content/admin/installation/increasing-storage-capacity.md +++ /dev/null @@ -1,57 +0,0 @@ ---- -title: Speicherkapazität erhöhen -intro: 'Sie können die für Git-Repositorys, Datenbanken, Suchindizes und andere persistente Anwendungsdaten verfügbare Speicherkapazität erhöhen oder ändern.' -redirect_from: - - /enterprise/admin/installation/increasing-storage-capacity -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_installation.warning-on-upgrading-physical-resources %} - -Wenn sich mehr Benutzer {% data variables.product.product_location_enterprise %} anschließen, müssen Sie die Größe Ihres Storage-Volumes anpassen. Informationen zur Storage-Größenanpassung finden Sie in der Dokumentation für Ihre Virtualisierungsplattform. - -### Anforderungen und Empfehlungen - -{% note %} - -**Hinweis:** Versetzen Sie Ihre Instanz in den Wartungsmodus, bevor Sie die Größe des Benutzer-Storage-Volumes anpassen. Weitere Informationen finden Sie unter „[Wartungsmodus aktivieren und planen](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)“. - -{% endnote %} - -{% data reusables.enterprise_installation.hardware-rec-table %} - -### Größe der Datenpartition erhöhen - -1. Passen Sie die Größe der vorhandenen Benutzer-Volume-Disk mithilfe der Tools Ihrer Virtualisierungsplattform an. -{% data reusables.enterprise_installation.ssh-into-instance %} -3. Versetzen Sie die Appliance in den Wartungsmodus. Weitere Informationen finden Sie unter „[Wartungsmodus aktivieren und planen](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)“. -4. Starten Sie die Appliance neu, um die neue Storage-Zuordnung zu ermitteln. -5. Führen Sie den Befehl `ghe-storage-extend` aus, um das Dateisystem `/data` zu erweitern: - ```shell - $ ghe-storage-extend - ``` - -### Größe der Root-Partition mit einer neuen Appliance erhöhen - -1. Richten Sie eine neue {% data variables.product.prodname_ghe_server %}-Instanz mit einer größeren Root-Disk ein. Verwenden Sie dazu dieselbe Version wie Ihre aktuelle Appliance. Weitere Informationen finden Sie unter „[{% data variables.product.prodname_ghe_server %}-Instanz einrichten](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-github-enterprise-server-instance)“. -2. Fahren Sie die aktuelle Appliance herunter. -3. Trennen Sie mithilfe der Tools Ihrer Virtualisierungsplattform die Daten-Disk von der aktuellen Appliance. -4. Fügen Sie die Daten-Disk an die neue Appliance mit der größeren Root-Disk an. - -### Größe der Root-Partition mit einer vorhandenen Appliance erhöhen - -1. Fügen Sie eine neue Disk an Ihre {% data variables.product.prodname_ghe_server %}-Appliance an. -2. Führen Sie den Befehl `parted` aus, um die Disk zu formatieren: - ```shell - $ sudo parted /dev/xvdg mklabel msdos - $ sudo parted /dev/xvdg mkpart primary ext4 0% 50% - $ sudo parted /dev/xvdg mkpart primary ext4 50% 100% - ``` -3. Führen Sie den Befehl `ghe-upgrade` aus, um auf der neu partitionierten Disk ein vollständiges, plattformspezifisches Paket zu installieren. Ein universelles Hotpach-Upgrade-Paket wie `github-enterprise-2.11.9.hpkg` funktioniert nicht erwartungsgemäß. - ```shell - $ ghe-upgrade PACKAGE-NAME.pkg -s -t /dev/xvdg1 - ``` -4. Fahren Sie die Appliance herunter. -5. Entfernen Sie auf dem Hypervisor die alte Root-Disk, und fügen Sie die neue Root-Disk am selben Ort als die alte Root-Disk an. -6. Starten Sie die Appliance. diff --git a/translations/de-DE/content/admin/installation/initiating-a-failover-to-your-replica-appliance.md b/translations/de-DE/content/admin/installation/initiating-a-failover-to-your-replica-appliance.md deleted file mode 100644 index 18aa40c33e7d..000000000000 --- a/translations/de-DE/content/admin/installation/initiating-a-failover-to-your-replica-appliance.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Failover zu Ihrer Replikat-Appliance initiieren -intro: 'Sie können an der Befehlszeile zu Wartungs- und Testzwecken oder beim Fehlschlagen der primären Appliance ein Failover zu einer {% data variables.product.prodname_ghe_server %}-Replikat-Appliance durchführen.' -redirect_from: - - /enterprise/admin/installation/initiating-a-failover-to-your-replica-appliance -versions: - enterprise-server: '*' ---- - -Die für das Failover erforderliche Zeit hängt davon ab, wie lange es dauert, das Replikat manuell hochzustufen und den Traffic weiterzuleiten. Die Durchschnittszeit beträgt zwischen 2 und 10 Minuten. - -{% data reusables.enterprise_installation.promoting-a-replica %} - -1. Versetzen Sie die primäre Appliance in den Wartungsmodus, um den Abschluss der Replikation zuzulassen, bevor Sie die Appliances wechseln. - - Informationen zum Verwenden der Managementkonsole finden Sie unter „[Wartungsmodus aktivieren und planen](/enterprise/admin/guides/installation/enabling-and-scheduling-maintenance-mode/)“. - - Darüber hinaus können Sie den Befehl `ghe-maintenance -s` verwenden. - ```shell - $ ghe-maintenance -s - ``` -2. Wenn die Anzahl der aktiven Git-Vorgänge null erreicht, sollten Sie 30 Sekunden lang warten. -3. Führen Sie den Befehl `ghe-repl-status -vv` aus, um zu verifizieren, dass alle Replikationskanäle `OK` ausgeben. - ```shell - $ ghe-repl-status -vv - ``` -4. Führen Sie den Befehl `ghe-repl-promote` aus, um die Replikation anzuhalten und die Replikations-Appliance auf den primären Status hochzustufen. Dadurch wird der primäre Knoten automatisch in den Wartungsmodus versetzt, sofern er erreichbar ist. - ```shell - $ ghe-repl-promote - ``` -5. Aktualisieren Sie den DNS-Eintrag so, dass er auf die IP-Adresse des Replikats verweist. Nach dem Verstreichen des TTL-Zeitraums wird der Traffic an das Replikat geleitet. Stellen Sie bei der Verwendung eines Load-Balancers sicher, dass er so konfiguriert ist, den Traffic an das Replikat zu senden. -6. Benachrichtigen Sie die Benutzer, dass sie die normalen Vorgänge wieder aufnehmen können. -7. Richten Sie bei Bedarf die Replikation von der neuen primären Instanz auf die bestehenden Appliances und die vorherige primäre Instanz ein. Weitere Informationen finden Sie unter „[Informationen zur Hochverfügbarkeitskonfiguration](/enterprise/{{ currentVersion }}/admin/guides/installation/about-high-availability-configuration/#utilities-for-replication-management)“. - -### Weiterführende Informationen - -- „[Dienstprogramme zur Replikationsverwaltung](/enterprise/{{ currentVersion }}/admin/guides/installation/about-high-availability-configuration/#utilities-for-replication-management)“ diff --git a/translations/de-DE/content/admin/installation/log-forwarding.md b/translations/de-DE/content/admin/installation/log-forwarding.md deleted file mode 100644 index 032cb465a3bf..000000000000 --- a/translations/de-DE/content/admin/installation/log-forwarding.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Protokollweiterleitung -intro: '{% data variables.product.prodname_enterprise %} verwendet „syslog-ng“, um System- und Anwendungsprotokolle an den Server weiterzuleiten, den Sie in den {% data variables.enterprise.management_console %}-Einstellungen angegeben haben.' -redirect_from: - - /enterprise/admin/articles/log-forwarding/ - - /enterprise/admin/installation/log-forwarding -versions: - enterprise-server: '*' ---- - -Unterstützt werden Protokollsammlungssysteme, die Protokollstreams im Syslog-Stil unterstützen (z. B. [Logstash](http://logstash.net/) und [Splunk](http://docs.splunk.com/Documentation/Splunk/latest/Data/Monitornetworkports)). - -### Protokollweiterleitung aktivieren - -1. Klicken Sie auf der Seite mit den Einstellungen der {% data variables.enterprise.management_console %} auf der linken Seitenleiste auf **Monitoring** (Überwachung). -1. Wählen Sie **Enable log forwarding** (Protokollweiterleitung aktivieren) aus. -1. Geben Sie im Feld **Server address** (Serveradresse) die Adresse des Servers ein, an den Sie Protokolle weiterleiten möchten. Sie können mehrere Adressen in einer kommagetrennten Liste angeben. -1. Wählen Sie im Dropdownmenü „Protocol“ (Protokoll) das Protokoll aus, das für die Kommunikation mit dem Protokollserver verwendet werden soll. Das Protokoll wird auf alle angegebenen Protokollziele angewendet. -1. Wählen Sie **Enable TLS** (TLS aktivieren) aus. -1. Klicken Sie auf **Choose File** (Datei auswählen), und wählen Sie ein CA-Zertifikat aus, um die Kommunikation zwischen Syslog-Endpunkten zu verschlüsseln. Die gesamte Zertifikatkette wird validiert und muss in einem Root-Zertifikat beendet werden. Weitere Informationen finden Sie in der Dokumentation zu den „[TLS-Optionen in syslog-ng](https://support.oneidentity.com/technical-documents/syslog-ng-open-source-edition/3.16/administration-guide/56#TOPIC-956599)“. - -### Problemlösungen - -Wenden Sie sich bei Protokollweiterleitungsproblemen an den {% data variables.contact.contact_ent_support %}, und hängen Sie die Ausgabedatei von `http(s)://[hostname]/setup/diagnostics` an Ihre E-Mail an. diff --git a/translations/de-DE/content/admin/installation/managing-billing-for-github-enterprise.md b/translations/de-DE/content/admin/installation/managing-billing-for-github-enterprise.md deleted file mode 100644 index fc1e0e1b46cf..000000000000 --- a/translations/de-DE/content/admin/installation/managing-billing-for-github-enterprise.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: Abrechnung für „GitHub Enterprise“ (GitHub für Unternehmen) verwalten -intro: 'Du kannst die Lizenznutzung, die Rechnungen, den Zahlungsverlauf und andere Abrechnungsinformationen für Dein Unternehmenskonto und Deine {% data variables.product.prodname_ghe_server %}-Instanzen einsehen.' -product: '{% data reusables.gated-features.enterprise-accounts %}' -redirect_from: - - /enterprise/admin/installation/managing-billing-for-github-enterprise -versions: - enterprise-server: '*' ---- - -### Informationen zur Abrechnung für Enterprise-Konten - -Enterprise-Konten sind derzeit für {% data variables.product.prodname_enterprise %}-Kunden verfügbar, die per Rechnung bezahlen. Die Abrechnung für alle Organisationen und {% data variables.product.prodname_ghe_server %}-Instanzen, die mit Deinem Unternehmenskonto verbunden sind, wird in eine einzige Rechnung für alle Deine kostenpflichtigen {% data variables.product.prodname_dotcom_the_website %}-Dienste zusammengefasst (inklusive bezahlte Lizenzen in Organisationen, {% data variables.large_files.product_name_long %}-Datenpakete und Abonnements für {% data variables.product.prodname_marketplace %}-Apps). - -Enterprise-Inhaber und Abrechnungsmanager können auf alle Abrechnungseinstellungen für Enterprise-Konen zugreifen und diese verwalten. Weitere Informationen zu Unternehmenskonten findest Du unter "[Rollen eines Unternehmenskontos](/github/setting-up-and-managing-your-enterprise-account/roles-for-an-enterprise-account)." Weitere Informationen zum Verwalten von Abrechnungsmanagern finden Sie unter „[Personen zur Verwaltung Ihres Enterprise-Kontos einladen](/github/setting-up-and-managing-your-enterprise-account/inviting-people-to-manage-your-enterprise-account)“. - -### Deine aktuelle Rechnung anzeigen - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.billing-tab %} -4. Klicke unter „Schnelle Aktionen“ auf **Rechnung ansehen**. ![Link zum Rechnung-Anzeigen](/assets/images/help/business-accounts/view-invoice-link.png) - -### Deine aktuellen Rechnung bezahlen - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.billing-tab %} -4. Klicke unter „Schnelle Aktionen“ auf **Rechnung bezahlen**. ![Link zum Rechnung-Bezahlen](/assets/images/help/business-accounts/pay-invoice-link.png) -5. Gib unter "Rechnung bezahlen" Deine Kreditkarten-Daten in das sichere Formular ein und klicke dann auf **Rechnung bezahlen**. ![Rechnung bestätigen und bezahlen](/assets/images/help/business-accounts/pay-invoice.png) - -### Deine aktuelle Rechnung herunterladen - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.billing-tab %} -4. Klicke unter „Schnelle Aktionen“ auf **Rechnung herunterladen**. ![Link zum herunterladen der aktuellen Rechnung](/assets/images/help/business-accounts/download-current-invoice.png) - -### Deinen Zahlungsverlauf anzeigen - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.billing-tab %} -4. Klicke unter "Abrechnung" auf den Tab **Frühere Rechnungen** um eine Zusammenfassung Deiner früheren Abrechnungsaktivität zu sehen. ![Tab zum Zahlungsverlauf-Anzeigen](/assets/images/help/business-accounts/view-payment-history.png) diff --git a/translations/de-DE/content/admin/installation/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud.md b/translations/de-DE/content/admin/installation/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud.md deleted file mode 100644 index 9229391fda82..000000000000 --- a/translations/de-DE/content/admin/installation/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: Verbindungen zwischen GitHub Enterprise Server und GitHub Enterprise verwalten -intro: 'Mit {% data variables.product.prodname_github_connect %} können Sie bestimmte Features und Daten zwischen {% data variables.product.product_location_enterprise %} und Ihrer {% data variables.product.prodname_ghe_cloud %}-Organisation oder Ihrem -Enterprise-Konto auf {% data variables.product.prodname_dotcom_the_website %} freigeben.' -mapTopic: true -redirect_from: - - /enterprise/admin/developer-workflow/connecting-github-enterprise-to-github-com - - /enterprise/admin/guides/developer-workflow/connecting-github-enterprise-and-github-com/ - - /enterprise/admin/guides/developer-workflow/connecting-github-enterprise-server-and-github-com/ - - /enterprise/admin/developer-workflow/connecting-github-enterprise-server-and-githubcom/ - - /enterprise/admin/installation/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud -versions: - enterprise-server: '*' ---- - diff --git a/translations/de-DE/content/admin/installation/managing-your-github-enterprise-license.md b/translations/de-DE/content/admin/installation/managing-your-github-enterprise-license.md deleted file mode 100644 index 22d0c3465136..000000000000 --- a/translations/de-DE/content/admin/installation/managing-your-github-enterprise-license.md +++ /dev/null @@ -1,70 +0,0 @@ ---- -title: Deine Lizenz für GitHub Enterprise verwalten -intro: 'Du kannst Deine {% data variables.product.prodname_enterprise %}-Lizenz anzeigen, verwalten und aktualisieren.' -redirect_from: - - /enterprise/admin/categories/licenses/ - - /enterprise/admin/articles/license-files/ - - /enterprise/admin/installation/about-license-files/ - - /enterprise/admin/articles/downloading-your-license/ - - /enterprise/admin/installation/downloading-your-license/ - - /enterprise/admin/articles/upgrading-your-license/ - - /enterprise/admin/installation/updating-your-license/ - - /enterprise/admin/installation/managing-your-github-enterprise-server-license - - /enterprise/admin/installation/managing-your-github-enterprise-license -versions: - enterprise-server: '*' ---- - -### Informationen zu {% data variables.product.prodname_enterprise %}-Lizenzen - -Wenn Sie {% data variables.product.prodname_enterprise %} kaufen oder verlängern, erhalten Sie eine Lizenzdatei zum Validieren Ihrer Anwendung. Eine Lizenzdatei hat ein Ablaufdatum und bestimmt die Anzahl der Benutzerlizenzen, die Du auf {% data variables.product.prodname_enterprise %} hinzufügen kannst. Nachdem Sie {% data variables.product.prodname_enterprise %} heruntergeladen und installiert haben, wird die Anwendung durch das Hochladen der Lizenzdatei zu Ihrer Verwendung entsperrt. - -Sie können die in Ihrer {% data variables.product.prodname_enterprise %}-Lizenz enthaltene Lizenz Benutzern in {% data variables.product.product_location_enterprise %} und einem {% data variables.product.prodname_ghe_cloud %}-Enterprise-Konto zuordnen. Wenn Sie einen Benutzer zu einer der Umgebungen hinzufügen, nimmt er eine Lizenz in Anspruch. Wenn ein Benutzer Konten in beiden Umgebungen hat, muss Deine primäre E-Mail-Adresse in {% data variables.product.prodname_enterprise %} die gleiche sein wie Deine verifizierte E-Mail-Adresse in {% data variables.product.prodname_ghe_cloud %}, um nur eine Lizenz zu verwenden. Du kannst die Anzahl und Nutzung der Lizenzen zwischen den Umgebungen synchronisieren. - -Wenn Ihre {% data variables.product.prodname_ghe_server %}-Lizenz abläuft, ist es Ihnen nicht möglich, über einen Webbrowser oder Git auf {% data variables.product.product_location_enterprise %} zuzugreifen. Bei Bedarf können Sie Befehlszeilenprogramme zum Sichern Ihrer gesamten Daten verwenden. Weitere Informationen finden Sie unter „[Backups auf Ihrer Appliance konfigurieren](/enterprise/admin/guides/installation/configuring-backups-on-your-appliance)“. Wenn Du Fragen zur Erneuerung Deiner Lizenz hast, kontaktiere {% data variables.contact.contact_enterprise_sales %}. - -### Neue Lizenz auf {% data variables.product.prodname_ghe_server %} hochladen - -Nach dem Kauf einer neuen Lizenz oder einem Upgrade einer bestehenden Lizenz von {% data variables.contact.contact_enterprise_sales %} musst Du Deine neue Lizenzdatei herunterladen und dann die Datei auf {% data variables.product.prodname_ghe_server %} hochladen, um Deine neuen Benutzerlizenzen zu entsperren. - -Wenn Du Benutzerlizenzen erneuern oder zu {% data variables.product.prodname_enterprise %} hinzufügen möchtest, kontaktiere {% data variables.contact.contact_enterprise_sales %}. Ihre neue Lizenzdatei steht sofort nach dem Abschluss Ihrer Bestellung zum Download zur Verfügung. - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.enterprise-licensing-tab %} -4. Under "Enterprise Server Instances", click {% octicon "download" aria-label="The download icon" %} to download your license file. ![GitHub Enterprise Server-Lizenz herunterladen](/assets/images/help/business-accounts/download-ghes-license.png) -5. Log into your {% data variables.product.prodname_ghe_server %} instance as a site administrator. -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.license-tab %} -12. Klicken Sie unter „Quick links“ (Schnellzugriff) auf **Update license** (Lizenz aktualisieren). ![Lizenz-Link aktualisieren](/assets/images/enterprise/business-accounts/update-license-link.png) -13. Klicke zum Auswählen Deiner Lizenz auf **Lizenzdatei** oder ziehe Deine Lizenzdatei auf **Lizenzdatei**. ![Lizenzdatei hochladen](/assets/images/enterprise/management-console/upload-license.png) -14. Klicke **Upload**. ![Upgrade-Start](/assets/images/enterprise/management-console/begin-upload.png) - -### Lizenznutzung anzeigen - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.enterprise-licensing-tab %} -4. Überprüfe Deine aktuelle {% data variables.product.prodname_enterprise %}-Lizenz sowie verbrauchte und verfügbare Benutzerlizenzen. - -### Nutzung der Benutzerlizenzen mit {% data variables.product.prodname_ghe_cloud %} automatisch synchronisieren - -Mithilfe von {% data variables.product.prodname_github_connect %} können Sie die Anzahl und Nutzung der Benutzerlizenzen automatisch zwischen {% data variables.product.prodname_ghe_server %} und {% data variables.product.prodname_ghe_cloud %} synchronisieren. Weitere Informationen finden Sie unter „[Automatische Synchronisierung von Benutzerlizenzen zwischen {% data variables.product.prodname_ghe_server %} und {% data variables.product.prodname_ghe_cloud %} aktivieren](/enterprise/{{currentVersion}}/admin/installation/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud)“. - -### Manuelle Synchronisierung der Benutzerlizenz-Nutzung zwischen {% data variables.product.prodname_ghe_server %} und {% data variables.product.prodname_ghe_cloud %} - -Auf {% data variables.product.prodname_ghe_server %} können Sie eine JSON-Datei herunterladen und die Datei auf {% data variables.product.prodname_ghe_cloud %} hochladen, um die Nutzung der Benutzerlizenzen zwischen den zwei Bereitstellungen manuell zu synchronisieren. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.license-tab %} -5. Klicken Sie unter „Quick links“ (Schnellzugriff) auf **Export license usage** (Lizenznutzung exportieren), um eine Datei herunterzuladen, in der Ihre aktuelle Lizenznutzung auf {% data variables.product.prodname_ghe_server %} enthalten ist. ![Link zum Exportieren der Lizenznutzung](/assets/images/enterprise/business-accounts/export-license-usage-link.png) -6. Navigieren Sie zu {% data variables.product.prodname_ghe_cloud %} -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.enterprise-licensing-tab %} -10. Klicke unter "Enterprise Server-Instanzen" auf **Servernutzung hinzufügen**. ![Link zum Hochladen der GitHub Enterprise Server-Nutzung](/assets/images/help/business-accounts/upload-ghe-server-usage-link.png) -11. Laden Sie die JSON-Datei hoch, die Sie von {% data variables.product.prodname_ghe_server %} heruntergeladen haben.![„Drag and drop or select a file to upload“ (Hochzuladende Datei per Drag-and-Drop auswählen oder suchen)](/assets/images/help/business-accounts/upload-ghe-server-usage-file.png) diff --git a/translations/de-DE/content/admin/installation/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later.md b/translations/de-DE/content/admin/installation/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later.md deleted file mode 100644 index d3c97e8e9e0f..000000000000 --- a/translations/de-DE/content/admin/installation/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later.md +++ /dev/null @@ -1,128 +0,0 @@ ---- -title: ElasticSearch-Indizes zu GitHub Enterprise Server 2.14 oder höher migrieren -intro: 'Als Vorbereitung für ein Upgrade auf {% data variables.product.prodname_ghe_server %} 2.14 müssen Sie Ihre Indizes mit unserem Migrationsskript zu ElasticSearch 5.6 migrieren.' -redirect_from: - - /enterprise/admin/guides/installation/migrating-elasticsearch-indices-to-github-enterprise-2-14-or-later/ - - /enterprise/admin/guides/installation/migrating-elasticsearch-indices-to-github-enterprise-server-2-14-or-later - - /enterprise/admin/installation/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later -versions: - enterprise-server: '*' ---- - -{% data variables.product.prodname_ghe_server %} 2.14 enthält ein Upgrade auf ElasticSearch 5.6. Bevor Sie ein Upgrade von {% data variables.product.prodname_ghe_server %} 2.12 oder 2.13 auf 2.14 durchführen, sollten Sie die ElasticSearch-Migrationstools herunterladen, installieren und ausführen, damit Ihre größten Indizes online migriert werden, während Ihre Appliance weiterhin über Online-Zugriff verfügt. - -### Suchindizes - -Das Migrationsskript sucht zunächst nach `Suchindizes`, während die Appliance online ist. Die Migration der `Suchindizes` kann je nach ihrer Größe zwischen wenigen Minuten und einigen Tagen in Anspruch nehmen. Beispielsweise nahm die Migration großer Indizes in unserer Testumgebung mehrere Tage in Anspruch. - -``` -admin@ip-172-31-2-141:~$ curl -s http://localhost:9200/_cat/indices?v | sort -n -k 6 -green open blog-1 1 0 0 0 144b 144b -green open projects-1 1 0 0 0 144b 144b -green open registry-packages-1 1 0 0 0 144b 144b -green open showcases-1 1 0 0 0 144b 144b -health status index pri rep docs.count docs.deleted store.size pri.store.size -green open pull-requests-1 1 0 1 0 9.3kb 9.3kb -green open wikis-1 1 0 2 0 5kb 5kb -green open hookshot-logs-2018-05-29 5 0 25 0 124.2kb 124.2kb -green open repos-1 1 0 1638 1 1.4mb 1.4mb -green open gists-1 1 0 3531 64 291.9kb 291.9kb -green open audit_log-1-2018-06-1 1 0 11108 0 3mb 3mb -green open users-1 1 0 19866 56 2.7mb 2.7mb -green open hookshot-logs-2018-05-31 5 0 20000 0 33.4mb 33.4mb -green open hookshot-logs-2018-06-04 5 0 20000 0 32.6mb 32.6mb -green open issues-1 1 0 26405 6 82.8mb 82.8mb -green open hookshot-logs-2018-05-30 5 0 119744 0 196.8mb 196.8mb -green open audit_log-1-2018-05-1 1 0 191664 0 50mb 50mb -green open code-search-1 1 0 6932626 44 42.9gb 42.9gb -green open commits-1 1 0 63753587 1485 45.4gb 45.4gb -``` - -Die `Suchindizes` beginnen mit: - -- blog- -- code-search- -- commits- -- gists- -- issues- -- labels- -- marketplace-listings- -- non-marketplace-listings- -- projects- -- pull-requests- -- registry-packages- -- repos- -- showcases- -- topics- -- users- - -### Webhook-Indizes - -Nachdem das Migrationsskript die erforderlichen `Suchindizes` online neu erstellt hat, überprüft das Skript, ob `Webhook`-Indizes neu erstellt werden müssen. Wenn die Ausführung Ihrer Appliance mit {% data variables.product.prodname_ghe_server %} 2.12 oder 2.13 mindestens 14 Tage gedauert hat, benötigen Sie Ihre `Webhook`-Indizes wahrscheinlich nicht, da `Webhook`-Indizes eine standardmäßige Aufbewahrungsrichtlinie von sieben Tagen aufweisen. Wenn Sie Ihre Appliance von {% data variables.product.prodname_enterprise %} 2.11 oder früher aktualisieren, dann müssen Sie die `Webhook`-Indizes möglicherweise neu erstellen. - -Wenn `Webhook`-Indizes neu erstellt werden müssen, werden Sie aufgefordert, den Wartungsmodus zu aktivieren, bevor das Skript die `Webhook`-Indizes neu erstellen kann. Obwohl die Migration von `Webhook`-Indizes zu einer gewissen Ausfallzeit führt, sind keine ausgedehnten Wartungsfenster oder Ausfallzeiten nötig. - -Die `Webhook`-Indizes beginnen mit `hookshot-logs-`. - -### Verfügbare Indizes - -Mittels „curl“ können Sie die auf Ihrer Appliance verfügbaren Indizes anzeigen. - -``` -admin@ip-172-31-2-141:~$ curl -s http://localhost:9200/_cat/indices?v | sort -n -k 6 -green open blog-1 1 0 0 0 144b 144b -green open projects-1 1 0 0 0 144b 144b -green open registry-packages-1 1 0 0 0 144b 144b -green open showcases-1 1 0 0 0 144b 144b -health status index pri rep docs.count docs.deleted store.size pri.store.size -green open pull-requests-1 1 0 1 0 9.3kb 9.3kb -green open wikis-1 1 0 2 0 5kb 5kb -green open hookshot-logs-2018-05-29 5 0 25 0 124.2kb 124.2kb -green open repos-1 1 0 1638 1 1.4mb 1.4mb -green open gists-1 1 0 3531 64 291.9kb 291.9kb -green open audit_log-1-2018-06-1 1 0 11108 0 3mb 3mb -green open users-1 1 0 19866 56 2.7mb 2.7mb -green open hookshot-logs-2018-05-31 5 0 20000 0 33.4mb 33.4mb -green open hookshot-logs-2018-06-04 5 0 20000 0 32.6mb 32.6mb -green open issues-1 1 0 26405 6 82.8mb 82.8mb -green open hookshot-logs-2018-05-30 5 0 119744 0 196.8mb 196.8mb -green open audit_log-1-2018-05-1 1 0 191664 0 50mb 50mb -green open code-search-1 1 0 6932626 44 42.9gb 42.9gb -green open commits-1 1 0 63753587 1485 45.4gb 45.4gb -``` - -### {% data variables.product.prodname_ghe_server %}-Appliance der Version 2.12 oder 2.13 vorbereiten - -Wenn Sie ein Upgrade auf {% data variables.product.prodname_ghe_server %} 2.14 oder höher durchführen, ohne die Migrationstools auszuführen, sind die vorhandenen ElasticSearch-Indizes möglicherweise ungültig und funktionieren nicht richtig. Zum Ausführen des ElasticSearch-Migrationsskripts muss Ihre {% data variables.product.prodname_ghe_server %}-Appliance Version 2.12 oder 2.13 von {% data variables.product.prodname_enterprise %} ausführen. - -{% warning %} - -**Warnung:** -- Bei der Verwendung von {% data variables.product.prodname_enterprise_backup_utilities %} werden nach der Wiederherstellung alte ElasticSearch-Indizes vernichtet, die nicht mit 5.X kompatibel sind. In diesem Fall wäre eine manuelle Neuindizierung erforderlich. -- Wenn {% data variables.product.prodname_ghe_server %} für die Hochverfügbarkeit konfiguriert ist, **muss** das Migrationsskript während der Ausführung der Replikation ausgeführt werden. Es muss zugelassen werden, dass die Änderungen vollständig mit der anderen Appliance repliziert werden, bevor das Upgrade gestartet wird. Wenn die Replikation während der Ausführung des Migrationsskripts nicht ausgeführt wird, werden Ihre ElasticSearch-Indizes möglicherweise ungültig. - -{% endwarning %} - -1. Authentifizieren Sie sich mittels SSH mit aktivierter Hochverfügbarkeit bei der primären Appliance. -2. Laden Sie das Migrationsskript auf die Appliance herunter, und installieren Sie es: - ```shell - $ wget https://github-enterprise.s3.amazonaws.com/util/es-5x-transition-tools.tar.gz - $ sudo tar -C / -xvf es-5x-transition-tools.tar.gz - ``` - Wenn Sie einen {% data variables.product.prodname_ghe_server %}-Cluster verwalten, authentifizieren Sie sich mittels SSH bei einem der ElasticSearch-Serverknoten, und installieren Sie dort die Migrationstools. Suchen Sie sie wie folgt: - ```shell - $ ghe-cluster-each -r elasticsearch -p - ghe-test-data-0 - ghe-test-data-1 - ghe-test-data-2 - ``` -2. Führen Sie das Migrationsskript aus: - ```shell - $ /usr/local/share/enterprise/ghe-es-5x-migration -r - ``` - {% note %} - - **Hinweis:** Wenn `Webhook`-Indizes migriert werden sollen, werden Sie nach dem Ausführen der Online-Migrationen aufgefordert, den Wartungsmodus zu aktivieren. - - {% endnote %} -3. Wenn Sie einen {% data variables.product.prodname_ghe_server %}-Cluster ausführen, sollten Sie die offizielle Upgrade-Dokumentation für einzelne VMs oder Hochverfügbarkeitsumgebungen oder den Leitfaden zum Cluster-Upgrade befolgen. Weitere Informationen finden Sie unter „[Upgrade von {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-github-enterprise-server/)“ oder „[Cluster-Upgrade](/enterprise/{{ currentVersion }}/admin/guides/clustering/upgrading-a-cluster/)“. diff --git a/translations/de-DE/content/admin/installation/migrating-from-github-enterprise-1110x-to-2123.md b/translations/de-DE/content/admin/installation/migrating-from-github-enterprise-1110x-to-2123.md deleted file mode 100644 index 5a51330f43ca..000000000000 --- a/translations/de-DE/content/admin/installation/migrating-from-github-enterprise-1110x-to-2123.md +++ /dev/null @@ -1,90 +0,0 @@ ---- -title: GitHub Enterprise von 11.10.x zu 2.1.23 migrieren -redirect_from: - - /enterprise/admin-guide/migrating/ - - /enterprise/admin/articles/migrating-github-enterprise/ - - /enterprise/admin/guides/installation/migrating-from-github-enterprise-v11-10-34x/ - - /enterprise/admin/articles/upgrading-to-a-newer-release/ - - /enterprise/admin/guides/installation/migrating-to-a-different-platform-or-from-github-enterprise-11-10-34x/ - - /enterprise/admin/guides/installation/migrating-from-github-enterprise-11-10-x-to-2-1-23 - - /enterprise/admin/installation/migrating-from-github-enterprise-1110x-to-2123 -intro: 'Um {% data variables.product.prodname_enterprise %} von 11.10.x zu 2.1.23 zu migrieren, müssen Sie eine neue Appliance-Instanz einrichten und Daten aus der vorherigen Instanz migrieren.' -versions: - enterprise-server: '*' ---- - -Migrationen von {% data variables.product.prodname_enterprise %} 11.10.348 und höher werden unterstützt. Migrationen von {% data variables.product.prodname_enterprise %} 11.10.348 und früher werden nicht unterstützt. Sie müssen zunächst in verschiedenen Upgrades ein Upgrade auf die Version 11.10.348 durchführen. Weitere Informationen finden Sie in der 11.10.348-Upgrade-Prozedur „[Upgrade auf die neueste Version durchführen](/enterprise/11.10.340/admin/articles/upgrading-to-the-latest-release/)“. - -Um ein Upgrade auf die neueste Version von {% data variables.product.prodname_enterprise %} durchzuführen, müssen Sie zunächst ein Upgrade auf {% data variables.product.prodname_ghe_server %} 2.1 vornehmen. Anschließend können Sie den normalen Upgrade-Prozess befolgen. Weitere Informationen finden Sie unter „[Upgrade von {% data variables.product.prodname_enterprise %}](/enterprise/admin/guides/installation/upgrading-github-enterprise-server/)“. - -### Migrationsvorbereitung - -1. Konsultieren Sie den Leitfaden „Bereitstellung und Installation“, und überprüfen Sie, ob alle Voraussetzungen erfüllt sind, um {% data variables.product.prodname_enterprise %} 2.1.23 in Ihrer Umgebung bereitzustellen und zu konfigurieren. Weitere Informationen finden Sie unter „[Bereitstellung und Installation](/enterprise/2.1/admin/guides/installation/provisioning-and-installation/)“. -2. Verifizieren Sie, dass die aktuelle Instanz eine unterstützte Upgrade-Version ausführt. -3. Richten Sie die neueste Version von {% data variables.product.prodname_enterprise_backup_utilities %} ein. Weitere Informationen finden Sie unter „[{% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils)“. - - Wenn Sie geplante Backups bereits mit {% data variables.product.prodname_enterprise_backup_utilities %} konfiguriert haben, sollten Sie sicherstellen, dass Sie die neueste Version verwenden. - - Wenn Sie aktuell keine geplanten Backups ausführen, richten Sie {% data variables.product.prodname_enterprise_backup_utilities %} ein. -4. Führen Sie den Befehl `ghe-backup` aus, um einen anfänglichen vollständigen Backup-Snapshot der aktuellen Instanz zu erstellen. Falls Sie bereits geplante Backups für Ihre aktuelle Instanz konfiguriert haben, müssen Sie keinen Snapshot Ihrer Instanz erstellen. - - {% tip %} - - **Tipp:** Während der Snapshot-Erstellung kann die Instanz weiterhin online und aktiv sein. Während der Wartung der Migration erstellen Sie einen anderen Snapshot. Da Backups inkrementell sind, reduziert der anfängliche Snapshot die im finalen Snapshot übertragenen Daten, was wiederum das Wartungsfenster kürzt. - - {% endtip %} - -5. Bestimmen Sie die Methode zum Umleiten des Benutzernetzwerk-Traffics auf die neue Instanz. Nach der Migration wird der gesamte HTTP- und Git-Netzwerk-Traffic an die neue Instanz geleitet. - - **DNS**: Sie sollten diese Methode für alle Umgebungen verwenden, da es einfach ist und selbst dann ordnungsgemäß funktioniert, wenn eine Migration zwischen Rechenzentren vorgenommen wird. Reduzieren Sie vor dem Start der Migration den TTL-Wert der vorhandenen DNS-Einträge auf maximal fünf Minuten, und legen Sie fest, dass die Änderung auf andere Instanzen erweitert werden kann. Aktualisieren Sie nach Abschluss der Migration den DNS-Eintrag bzw. die DNS-Einträge so, dass er bzw. sie auf die IP-Adresse der neuen Instanz verweisen. - - **IP-Adressenzuweisung**: Diese Methode steht nur für die VMware-zu-VMware-Migration zur Verfügung und wird nicht empfohlen, es sei denn, die DNS-Methode ist nicht verfügbar. Vor dem Starten der Migration müssen Sie die alte Instanz herunterfahren und ihre IP-Adresse zur neuen Instanz zuweisen. -6. Planen Sie ein Wartungsfenster. Das Wartungsfenster sollte lang genug sein, um Daten vom Backup-Host auf die neue Instanz zu übertragen. Es variiert entsprechend der Größe des Backup-Snapshots und der verfügbaren Netzwerkbandbreite. In diesem Zeitraum ist Ihre aktuelle Instanz nicht verfügbar und im Wartungsmodus, während Sie zur neuen Instanz migrieren. - -### Führen Sie die Migration durch. - -1. Stellen Sie eine neue {% data variables.product.prodname_enterprise %} 2.1-Instanz bereit. Weitere Informationen finden Sie im Leitfaden „[Bereitstellung und Installation](/enterprise/2.1/admin/guides/installation/provisioning-and-installation/)“ für Ihre Zielplattform. -2. Navigieren Sie in einem Browser zur IP-Adresse der neuen Replikat-Appliance, und laden Sie Ihre {% data variables.product.prodname_enterprise %}-Lizenz hoch. -3. Legen Sie ein Administratorpasswort fest. -5. Klicken Sie auf **Migrate** (Migrieren). ![Installationstyp auswählen](/assets/images/enterprise/migration/migration-choose-install-type.png) -6. Fügen Sie Ihren Backup-Host-SSH-Zugriffschlüssel in „Add new SSH key“ (Neuen SSH-Schlüssel hinzufügen) ein.![Backup-Autorisierung](/assets/images/enterprise/migration/migration-authorize-backup-host.png) -7. Klicken Sie auf **Add key** (Schlüssel hinzufügen) und dann auf **Continue** (Fortsetzen). -8. Kopieren Sie den Befehl `ghe-restore`, den Sie auf dem Backup-Host ausführen, um Daten zur neuen Instanz zu migrieren. ![Migration starten](/assets/images/enterprise/migration/migration-restore-start.png) -9. Aktivieren Sie den Wartungsmodus auf der alten Instanz, und warten Sie auf den Abschluss sämtlicher aktiver Prozesse. Weitere Informationen finden Sie unter „[Wartungsmodus aktivieren und planen](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)“. - - {% note %} - - **Hinweis:** Ab diesem Zeitpunkt steht die Instanz nicht mehr zur normalen Verwendung zur Verfügung. - - {% endnote %} - -10. Führen Sie auf dem Backup-Host den Befehl `ghe-backup` aus, um einen finalen Backup-Snapshot zu erstellen. Dadurch wird sichergestellt, dass alle Daten von der alten Instanz erfasst werden. -11. Führen Sie auf dem Backup-Host den Befehl `ghe-restore` aus, den Sie auf dem Bildschirm mit dem Wiederherstellungsstatus der neuen Instanz kopiert haben, um den neuesten Snapshot wiederherzustellen. - ```shell - $ ghe-restore 169.254.1.1 - The authenticity of host '169.254.1.1:122' can't be established. - RSA key fingerprint is fe:96:9e:ac:d0:22:7c:cf:22:68:f2:c3:c9:81:53:d1. - Are you sure you want to continue connecting (yes/no)? yes - Connect 169.254.1.1:122 OK (v2.0.0) - Starting restore of 169.254.1.1:122 from snapshot 20141014T141425 - Restoring Git repositories ... - Restoring GitHub Pages ... - Restoring asset attachments ... - Restoring hook deliveries ... - Restoring MySQL database ... - Restoring Redis database ... - Restoring SSH authorized keys ... - Restoring Elasticsearch indices ... - Restoring SSH host keys ... - Completed restore of 169.254.1.1:122 from snapshot 20141014T141425 - Visit https://169.254.1.1/setup/settings to review appliance configuration. - ``` - -12. Kehren Sie zum Bildschirm mit dem Wiederherstellungsstatus der neuen Instanz zurück, um zu sehen, dass die Wiederherstellung abgeschlossen ist.![Bildschirm zur abgeschlossenen Wiederherstellung](/assets/images/enterprise/migration/restore-complete-screen.png) -13. Klicken Sie auf **Continue to settings** (Weiter zu den Einstellungen), um die von der vorherigen Instanz importierten Konfigurationsinformationen und -einstellungen zu überprüfen und anzupassen. ![Importierte Einstellungen überprüfen](/assets/images/enterprise/migration/migration-status-complete.png) -14. Klicken Sie auf **Save settings** (Einstellungen speichern). - - {% note %} - - **Hinweis:** Sie können die neue Instanz verwenden, nachdem Sie die Konfigurationseinstellungen angewendet und den Server neu gestartet haben. - - {% endnote %} - -15. Leiten Sie mittels DNS oder IP-Adressenzuweisung den Benutzernetzwerk-Traffic von der alten Instanz zur neuen Instanz. -16. Upgraden Sie auf die neueste Patch-Veröffentlichung von {{ currentVersion }}. Weitere Informationen finden Sie unter „[Upgrade von {% data variables.product.prodname_ghe_server %}](/enterprise/admin/guides/installation/upgrading-github-enterprise-server/)“. diff --git a/translations/de-DE/content/admin/installation/migrating-to-a-different-git-large-file-storage-server.md b/translations/de-DE/content/admin/installation/migrating-to-a-different-git-large-file-storage-server.md deleted file mode 100644 index 2d0e815abb45..000000000000 --- a/translations/de-DE/content/admin/installation/migrating-to-a-different-git-large-file-storage-server.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Zu einem anderen Git Large File Storage-Server migrieren -intro: 'Sie können zu einem neuen {% data variables.large_files.product_name_long %}-Server ({% data variables.large_files.product_name_short %}) migrieren. Verwenden Sie dazu den {% data variables.large_files.product_name_short %}-Client, um Assets vom bestehenden Server abzurufen und sie per Push-Vorgang an den neuen Speicherort zu übertragen.' -redirect_from: - - /enterprise/admin/guides/installation/migrating-to-different-large-file-storage-server/ - - /enterprise/admin/installation/migrating-to-a-different-git-large-file-storage-server -versions: - enterprise-server: '*' ---- - -Bevor Sie eine Migration zu einem anderen {% data variables.large_files.product_name_long %}-Server durchführen, müssen Sie {% data variables.large_files.product_name_short %} für die Verwendung eines Drittanbieterservers konfigurieren. Weitere Informationen finden Sie unter „[{% data variables.large_files.product_name_long %} zur Verwendung eines Drittanbieterservers konfigurieren](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-git-large-file-storage-to-use-a-third-party-server)“. - -1. Konfigurieren Sie das Repository mit einer zweiten Remote-Instanz. - ```shell - $ git remote add NEW-REMOTE https://NEW-REMOTE-HOSTNAME/path/to/repo -   - $ git lfs env - > git-lfs/1.1.0 (GitHub; darwin amd64; go 1.5.1; git 94d356c) - > git version 2.7.4 (Apple Git-66) -   - > Endpoint=https://GITHUB-ENTERPRISE-HOST/path/to/repo/info/lfs (auth=basic) - > Endpoint (NEW-REMOTE)=https://NEW-REMOTE-HOSTNAME/path/to/repo/info/lfs (auth=none) - ``` - -2. Rufen Sie alle Objekte von der alten Remote-Instanz ab. - ```shell - $ git lfs fetch origin --all - > Scanning for all objects ever referenced... - > ✔ 16 objects found - > Fetching objects... - > Git LFS: (16 of 16 files) 48.71 MB / 48.85 MB - ``` - -3. Übertragen Sie alle Objekte per Push-Vorgang auf die neue Remote-Instanz. - ```shell - $ git lfs push NEW-REMOTE --all - > Scanning for all objects ever referenced... - > ✔ 16 objects found - > Pushing objects... - > Git LFS: (16 of 16 files) 48.00 MB / 48.85 MB, 879.10 KB skipped - ``` diff --git a/translations/de-DE/content/admin/installation/migrating-to-internal-repositories.md b/translations/de-DE/content/admin/installation/migrating-to-internal-repositories.md deleted file mode 100644 index 107998bf4120..000000000000 --- a/translations/de-DE/content/admin/installation/migrating-to-internal-repositories.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: Zu internen Repositorys migrieren -intro: 'Du kannst zu internen Repositorys migrieren, um für Entwickler, die sowohl {% data variables.product.prodname_ghe_server %} als auch {% data variables.product.prodname_ghe_cloud %} verwenden, das Erlebnis mit Inner Source zu vereinheitlichen.' -permissions: Site-Administratoren können zu internen Repositorys migrieren. -redirect_from: - - /enterprise/admin/installation/migrating-to-internal-repositories -versions: - enterprise-server: '>=2.20' ---- - -### Informationen zu internen Repositorys - -Interne Repositorys sind in {% data variables.product.prodname_ghe_server %} 2.20+ verfügbar. {% data reusables.repositories.about-internal-repos %} Weitere Informationen findest Du unter „[Informationen zur Sichtbarkeit von Repositorys](/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)." - -In zukünftigen Releases von {% data variables.product.prodname_ghe_server %} werden wir die Sichtbarkeit des Repositorys so einstellen, dass die Begriffe „öffentlich“, „intern“ und „privat“ für Entwickler auf {% data variables.product.prodname_ghe_server %} und {% data variables.product.prodname_ghe_cloud %} eine einheitliche Bedeutung haben. - -Wenn der private Modus aktiviert ist, kannst Du eine Migration auf Deiner Instanz durchführen, um öffentliche Repositories nach intern zu konvertieren und Dich so auf diese Änderungen vorzubereiten. Diese Migration ist derzeit optional, damit Du die Änderungen an einer nicht-produktiven Instanz testen kannst. In Zukunft wird die Migration unumgänglich. - -Wenn Du die Migration ausführst, werden alle öffentlichen Repositories von Organisationen in Deiner Instanz zu internen Repositorys. Wenn irgendwelche dieser Repositories Forks haben, werden die Forks privat. Private Repositorys bleiben privat. - -Alle öffentlichen Repositories im Besitz von Benutzerkonten in Deiner Instanz werden zu privaten Repositorys. Wenn irgendwelche dieser Repositories Forks haben, werden die Forks ebenfalls privat. Der Besitzer jedes Forks erhält Leseberechtigungen für das übergeordnete Element des Forks. - -Der anonyme Git-Lesezugriff wird für jedes öffentliche Repository deaktiviert, das intern oder privat wird. - -Wenn Deine aktuelle Standardsichtbarkeit für Repositorys öffentlich ist, wird die Standardeinstellung intern. Wenn der aktuelle Standardwert privat ist, ändert er sich nicht. Du kannst den Standardwert jederzeit ändern. Weitere Informationen findest Du unter "[Die Standardsichtbarkeit neuer Repositorys auf Deinem Gerät konfigurieren](/enterprise/admin/installation/configuring-the-default-visibility-of-new-repositories-on-your-appliance)." - -Die Repository-Erstellungsrichtlinie für die Instanz wird dahingehend geändert, dass öffentliche Repositorys verhindert und private und interne Repositories ermöglicht werden. Du kannst die Richtlinie jederzeit aktualisieren. Weitere Informationen findest Du unter „[Repository-Erstellung in Deinen Instanzen beschränken](/enterprise/admin/user-management/restricting-repository-creation-in-your-instance).“ - -Wenn Du den private Modus nicht aktiviert hast, hat das Migrationsskript keine Auswirkung. - -### Die Migration durchführen - -1. Stellen Sie eine Verbindung zur Verwaltungsshell her. Weitere Informationen findest Du unter "[Auf die administrative Shell (SSH) zugreifen](/enterprise/admin/installation/accessing-the-administrative-shell-ssh)." -2. Navigiere zum Verzeichnis `/data/github/current`. - ``` - cd /data/github/current - ``` -3. Führe den Migrationsbefehl aus. - ``` - sudo bin/safe-ruby lib/github/transitions/20191210220630_convert_public_ghes_repos_to_internal.rb -v -w | tee -a /tmp/convert_public_ghes_repos_to_internal.log - ``` - -Die Log-Ausgabe erscheint im Terminal und `/tmp/convert_public_ghes_repos_to_internal.log`. - -### Weiterführende Informationen - -- „[Privaten Modus aktivieren](/enterprise/admin/installation/enabling-private-mode)“ diff --git a/translations/de-DE/content/admin/installation/monitoring-activity-on-your-github-enterprise-server-instance.md b/translations/de-DE/content/admin/installation/monitoring-activity-on-your-github-enterprise-server-instance.md deleted file mode 100644 index 1654c5e27c3c..000000000000 --- a/translations/de-DE/content/admin/installation/monitoring-activity-on-your-github-enterprise-server-instance.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Aktivität auf Ihrer GitHub Enterprise Server-Instanz überwachen -mapTopic: true -redirect_from: - - /enterprise/admin/installation/monitoring-activity-on-your-github-enterprise-server-instance -versions: - enterprise-server: '*' ---- - diff --git a/translations/de-DE/content/admin/installation/monitoring-using-snmp.md b/translations/de-DE/content/admin/installation/monitoring-using-snmp.md deleted file mode 100644 index 01e5252b989c..000000000000 --- a/translations/de-DE/content/admin/installation/monitoring-using-snmp.md +++ /dev/null @@ -1,107 +0,0 @@ ---- -title: Überwachung mittels SNMP -intro: '{% data variables.product.prodname_enterprise %} bietet Daten zur Disk-Nutzung, CPU-Auslastung, Arbeitsspeichernutzung und mehr über SNMP.' -redirect_from: - - /enterprise/admin/articles/monitoring-using-snmp/ - - /enterprise/admin/installation/monitoring-using-snmp -versions: - enterprise-server: '*' ---- - -SNMP ist ein allgemeiner Standard zum Überwachen von Geräten über ein Netzwerk. Es wird dringend empfohlen, SNMP zu aktivieren, damit Sie den Zustand von {% data variables.product.product_location_enterprise %} überwachen können und wissen, wann Sie der Host-Maschine Arbeitsspeicher, Storage oder Prozessorleistung hinzufügen müssen. - -{% data variables.product.prodname_enterprise %} weist eine SNMP-Standardinstallation auf. Daher können Sie von [vielen Plug-ins](http://www.monitoring-plugins.org/doc/man/check_snmp.html) profitieren, die für Nagios oder andere Überwachungssysteme verfügbar sind. - -### SNMP v2c konfigurieren - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.access-monitoring %} -{% data reusables.enterprise_management_console.enable-snmp %} -4. Geben Sie im Feld **Community string** (Community-String) einen neuen Community-String ein. Wird das Feld leer gelassen, ist der Standardwert `public` (öffentlich). ![Feld zum Hinzufügen des Community-Strings](/assets/images/enterprise/management-console/community-string.png) -{% data reusables.enterprise_management_console.save-settings %} -5. Testen Sie Ihre SNMP-Konfiguration. Führen Sie dazu den folgenden Befehl auf einer separaten Workstation mit SNMP-Unterstützung in Ihrem Netzwerk aus: - ```shell - # community-string is your community string - # hostname is the IP or domain of your Enterprise instance - $ snmpget -v 2c -c community-string -O e hostname hrSystemDate.0 - ``` - -Hiermit wird die Systemzeit auf dem {% data variables.product.product_location_enterprise %}-Host zurückgegeben. - -### Benutzerbasierte Sicherheit - -Wenn Sie SNMP v3 aktivieren, können Sie durch das Benutzersicherheitsmodell (User Security Model, USM) von der erhöhten benutzerbasierten Sicherheit profitieren. Für jeden eindeutigen Benutzer können Sie eine Sicherheitsebene angeben: -- `noAuthNoPriv`: Diese Sicherheitsebene bietet weder Authentifizierung noch Datenschutz. -- `authNoPriv`: Diese Sicherheitsebene bietet Authentifizierung, aber keinen Datenschutz. Zum Abrufen der Appliance benötigen Sie einen Benutzernamen und ein Passwort (das mindestens aus acht Zeichen bestehen muss). Informationen werden ähnlich wie bei SNMPv2 unverschlüsselt gesendet. Das Authentifizierungsprotokoll kann MD5 oder SHA sein und lautet standardmäßig SHA. -- `authPriv`: Diese Sicherheitsebene bietet Authentifizierung mit Datenschutz. Die Authentifizierung, einschließlich eines mindestens aus acht Zeichen bestehenden Authentifizierungspassworts, ist erforderlich, und Antworten sind verschlüsselt. Ein Datenschutzpasswort ist nicht erforderlich. Wenn es angegeben wird, muss es jedoch mindestens aus acht Zeichen bestehen. Wenn kein Datenschutzpasswort angegeben wird, wird das Authentifizierungspasswort verwendet. Das Datenschutzpasswort kann DES oder AES sein und lautet standardmäßig AES. - -### Benutzer für SNMP v3 konfigurieren - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.access-monitoring %} -{% data reusables.enterprise_management_console.enable-snmp %} -4. Wählen Sie **SNMP v3**. ![Schaltfläche zum Aktivieren von SNMP v3](/assets/images/enterprise/management-console/enable-snmpv3.png) -5. Geben Sie unter „Username“ (Benutzername) den eindeutigen Benutzernamen Ihres SNMP v3-Benutzers ein. ![Feld zur Eingabe des SNMP v3-Benutzernamens](/assets/images/enterprise/management-console/snmpv3-username.png) -6. Klicken Sie im Dropdownmenü **Security Level** (Sicherheitsebene) auf die Sicherheitsebene für Ihren SNMP v3-Benutzer. ![Dropdownmenü für die Sicherheitsebene des SNMP v3-Benutzers](/assets/images/enterprise/management-console/snmpv3-securitylevel.png) -7. Für SNMP v3-Benutzer mit der Sicherheitsebene `authnopriv`: ![Einstellungen für die Sicherheitsebene „authnopriv“](/assets/images/enterprise/management-console/snmpv3-authnopriv.png) - - {% data reusables.enterprise_management_console.authentication-password %} - - {% data reusables.enterprise_management_console.authentication-protocol %} -8. Für SNMP v3-Benutzer mit der Sicherheitsebene `authpriv`: ![Einstellungen für die Sicherheitsebene „authpriv“](/assets/images/enterprise/management-console/snmpv3-authpriv.png) - - {% data reusables.enterprise_management_console.authentication-password %} - - {% data reusables.enterprise_management_console.authentication-protocol %} - - Geben Sie optional unter „Privacy password“ (Datenschutzpasswort) das Datenschutzpasswort ein. - - Klicken Sie auf der rechten Seite von „Privacy password“ (Datenschutzpasswort) im Dropdownmenü **Protocol** (Protokoll) auf die gewünschte Datenschutzprotokollmethode. -9. Klicken Sie auf **Add user** (Benutzer hinzufügen). ![Schaltfläche zum Hinzufügen des SNMP v3-Benutzers](/assets/images/enterprise/management-console/snmpv3-adduser.png) -{% data reusables.enterprise_management_console.save-settings %} - -##### SNMP-Daten abfragen - -Informationen auf Hardware- und Softwareebene zu Ihrer Appliance sind mit SNMP v3 verfügbar. Da die Verschlüsselung und der Datenschutz für die Sicherheitsebenen `noAuthNoPriv` und `authNoPriv` unzureichend ist, wird die Tabelle `hrSWRun` (1.1.3.6.1.2.1.25.41) aus den resultierenden SNMP-Berichten ausgeschlossen. Diese Tabelle wird eingeschlossen, wenn Sie die Sicherheitsebene `authPriv` verwenden. - -Mit SNMP v2c stehen nur Informationen auf Hardwareebene zu Ihrer Appliance zur Verfügung. Die Anwendungen und Dienste innerhalb von {% data variables.product.prodname_enterprise %} weisen keine OIDs auf, die für das Melden von Kennzahlen konfiguriert sind. Es stehen verschiedene MIBs zur Verfügung. Diese können Sie anzeigen, indem Sie `snmpwalk` auf einer separaten Workstation mit SNMP-Unterstützung in Ihrem Netzwerk ausführen: - -```shell -# „community-string“ ist Ihr Community-String -# „hostname“ ist die IP oder Domain Ihrer Enterprise-Instanz -$ snmpwalk -v 2c -c community-string -O e hostname -``` - -`HOST-RESOURCES-MIB` (.1.3.6.1.2.1.25) ist die nützlichste MIB für SNMP. Einige wichtige Informationen in dieser MIB finden Sie in der folgenden Tabelle: - -| Name | OID | Beschreibung | -| -------------------------- | ------------------------- | ---------------------------------------------------------------------------------------- | -| hrSystemDate.2 | .1.3.6.1.2.1.25.1.2 | Die Hostnotation des lokalen Datums und der Tageszeit. | -| hrSystemUptime.0 | .1.3.6.1.2.1.25.1.1.0 | Der Zeitraum seit der letzten Initialisierung des Hosts. | -| hrMemorySize.0 | .1.3.6.1.2.1.25.2.2.0 | Der verfügbare RAM auf dem Host. | -| hrSystemProcesses.0 | .1.3.6.1.2.1.25.1.6.0 | Die Anzahl der derzeit auf dem Host geladenen oder ausgeführten Prozesskontexte. | -| hrStorageUsed.1 | .1.3.6.1.2.1.25.2.3.1.6.1 | Die auf dem Host in Anspruch genommene Speicherkapazität, in „hrStorageAllocationUnits“. | -| hrStorageAllocationUnits.1 | .1.3.6.1.2.1.25.2.3.1.4.1 | Die Größe in Bytes einer „hrStorageAllocationUnit“. | - -Um beispielsweise `hrMemorySize` mit SNMP v3 abzufragen, führen Sie auf einer separaten Workstation mit SNMP-Unterstützung in Ihrem Netzwerk den folgenden Befehl aus: -```shell -# „username“ ist der eindeutige Benutzername Ihres SNMP v3-Benutzers -# „auth password“ ist das Authentifizierungspasswort -# „privacy password“ ist das Datenschutzpasswort -# „hostname“ ist die IP oder Domain Ihrer Enterprise-Instanz -$ snmpget -v 3 -u username -l authPriv \ - -A "auth password" -a SHA \ - -X "privacy password" -x AES \ - -O e hostname HOST-RESOURCES-MIB::hrMemorySize.0 -``` - -Führen Sie mit SNMP v2c, um `hrMemorySize` abzufragen, den folgenden Befehl auf einer separaten Workstation mit SNMP-Unterstützung in Ihrem Netzwerk aus: -```shell -# „community-string“ ist Ihr Community-String -# „hostname“ ist die IP oder Domain Ihrer Enterprise-Instanz -snmpget -v 2c -c community-string hostname HOST-RESOURCES-MIB::hrMemorySize.0 -``` - -{% tip %} - -**Hinweis:** Um zu verhindern, dass Informationen über Dienste, die auf Ihrer Appliance ausgeführt werden, verloren gehen, wird die Tabelle `hrSWRun` (1.1.3.6.1.2.1.25.41) aus den resultierenden SNMP-Berichten ausgeschlossen, es sei denn, Sie verwenden die Sicherheitsebene `authPriv` mit SNMP v3. Bei Verwendung der Sicherheitsebene `authPriv` wird die Tabelle `hrSWRun` einbezogen. - -{% endtip %} - -Weitere Informationen zu OID-Zuordnungen für allgemeine Systemattribute in SNMP finden Sie unter „[Linux SNMP OID’s for CPU, Memory and Disk Statistics](http://www.linux-admins.net/2012/02/linux-snmp-oids-for-cpumemory-and-disk.html)“. diff --git a/translations/de-DE/content/admin/installation/monitoring-your-github-enterprise-server-appliance.md b/translations/de-DE/content/admin/installation/monitoring-your-github-enterprise-server-appliance.md deleted file mode 100644 index 51c2c85332ab..000000000000 --- a/translations/de-DE/content/admin/installation/monitoring-your-github-enterprise-server-appliance.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: Ihre GitHub Enterprise Server-Appliance überwachen -intro: 'Da die Nutzung von {% data variables.product.product_location_enterprise %} mit der Zeit zunimmt, erhöht sich auch die Auslastung der Systemressourcen wie CPU, Arbeitsspeicher und Storage. Sie können die Überwachung und Benachrichtigung so konfigurieren, dass Sie sich über potenzielle Probleme im Klaren sind, bevor sie kritisch genug werden, um sich negativ auf die Leistung oder Verfügbarkeit der Anwendung auszuwirken.' -redirect_from: - - /enterprise/admin/guides/installation/system-resource-monitoring-and-alerting/ - - /enterprise/admin/guides/installation/monitoring-your-github-enterprise-appliance/ - - /enterprise/admin/installation/monitoring-your-github-enterprise-server-appliance -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/de-DE/content/admin/installation/network-ports.md b/translations/de-DE/content/admin/installation/network-ports.md deleted file mode 100644 index aade75bc316c..000000000000 --- a/translations/de-DE/content/admin/installation/network-ports.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: Netzwerkports -redirect_from: - - /enterprise/admin/articles/configuring-firewalls/ - - /enterprise/admin/articles/firewall/ - - /enterprise/admin/guides/installation/network-configuration/ - - /enterprise/admin/guides/installation/network-ports-to-open/ - - /enterprise/admin/installation/network-ports -intro: 'Öffnen Sie Netzwerkports anhand dessen, welche Netzwerkdienste Sie für Administratoren, Endbenutzer und für die E-Mail-Unterstützung bereitstellen müssen.' -versions: - enterprise-server: '*' ---- - -### Verwaltungsports - -Einige Verwaltungsports sind zum Konfigurieren von {% data variables.product.product_location_enterprise %} und zum Ausführen bestimmter Features erforderlich. Verwaltungsports sind für die einfache Verwendung von Anwendungen durch Endbenutzer nicht erforderlich. - -| Port | Dienst | Beschreibung | -| -------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| 8443 | HTTPS | Sichere webbasierte {% data variables.enterprise.management_console %}. Für die grundlegende Installation und Konfiguration erforderlich. | -| 8080 | HTTP | Webbasierte {% data variables.enterprise.management_console %} im Nur-Text-Format. Nur erforderlich, wenn SSL manuell deaktiviert wird. | -| 122 | SSH | Shellzugriff für {% data variables.product.product_location_enterprise %}. Muss für eingehende Verbindungen von allen anderen Knoten in einer Hochverfügbarkeitskonfiguration geöffnet sein. Der standardmäßige SSH-Port (22) ist für den Git- und SSH-Netzwerk-Traffic der Anwendung vorgesehen. | -| 1194/UDP | VPN | Sicherer Replikationsnetzwerktunnel in einer hochverfügbaren Konfiguration. Muss für alle anderen Knoten in der Konfiguration geöffnet sein. | -| 123/UDP | NTP | Für Zeitprotokollvorgänge erforderlich. | -| 161/UDP | SNMP | Für Netzwerküberwachungs-Protokollvorgänge erforderlich. | - -### Anwendungsports für Endbenutzer - -Mit Anwendungsports können Endbenutzer auf Webanwendungen und Git zugreifen. - -| Port | Dienst | Beschreibung | -| ---- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------- | -| 443 | HTTPS | Zugriff auf die Webanwendung und Git über HTTPS. | -| 80 | HTTP | Webanwendungszugriff. Alle Anforderungen werden an den HTTPS-Port weitergeleitet, wenn SSL aktiviert ist. | -| 22 | SSH | Zugriff auf Git über SSH. Unterstützt das Klonen, Abrufen und Übertragen von Vorgängen an öffentliche/private Repositorys. | -| 9418 | Git | Der Git-Protokollport unterstützt das Klonen und Abrufen von Vorgängen für öffentliche Repositorys mit unverschlüsselter Netzwerkkommunikation. | - -{% data reusables.enterprise_installation.terminating-tls %} - -### E-Mail-Ports - -E-Mail-Ports müssen direkt oder über ein Relay für die Unterstützung eingehender E-Mails für Endbenutzer erreichbar sein. - -| Port | Dienst | Beschreibung | -| ---- | ------ | ------------------------------------------------------ | -| 25 | SMTP | Unterstützung für SMTP mit Verschlüsselung (STARTTLS). | diff --git a/translations/de-DE/content/admin/installation/recommended-alert-thresholds.md b/translations/de-DE/content/admin/installation/recommended-alert-thresholds.md deleted file mode 100644 index a6c4e09ef876..000000000000 --- a/translations/de-DE/content/admin/installation/recommended-alert-thresholds.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: Empfohlene Schwellenwerte für Meldungen -intro: 'Sie können eine Meldung so konfigurieren, dass Sie in Bezug auf Systemressourcenprobleme benachrichtigt werden, bevor sie sich auf die Leistung Ihrer {% data variables.product.prodname_ghe_server %}-Appliance auswirken.' -redirect_from: - - /enterprise/admin/guides/installation/about-recommended-alert-thresholds/ - - /enterprise/admin/installation/recommended-alert-thresholds -versions: - enterprise-server: '*' ---- - -### Speicher überwachen - -Sie sollten die Root- und Benutzerspeichergeräte überwachen und eine Meldung mit Werten konfigurieren, die eine ausreichende Antwortzeit gestatten, wenn der verfügbare Disk-Speicher niedrig ist. - -| Schweregrad | Schwellenwert | -| ------------ | ------------------------------------------------------------------- | -| **Warnung** | Disk-Nutzung überschreitet 70 % des insgesamt verfügbaren Speichers | -| **Kritisch** | Disk-Nutzung überschreitet 85 % des insgesamt verfügbaren Speichers | - -Sie können diese Werte basierend auf der insgesamt zugeordneten Speicherkapazität, historischen Wachstumsmustern und der erwarteten Antwortzeit anpassen. Wir empfehlen eine übermäßige Zuordnung an Speicherressourcen, um Wachstum zu ermöglichen und die zum Zuordnen des zusätzlichen Speichers erforderliche Ausfallzeit zu verhindern. - -### CPU- und durchschnittliche Auslastung überwachen - -Obwohl es normal ist, dass die CPU-Nutzung basierend auf ressourcenintensiven Git-Vorgängen schwankt, sollten Sie eine Meldung für ungewöhnlich hohe CPU-Auslastungen konfigurieren, da verlängerte Spitzen darauf hindeuten können, dass Ihre Instanz unterversorgt ist. Es wird empfohlen, die fünfzehnminütige durchschnittliche Auslastung des Systems auf Werte zu überwachen, die der Anzahl der der virtuellen Maschine zugeordneten CPU-Kerne nahekommen oder diese überschreiten. - -| Schweregrad | Schwellenwert | -| ------------ | ------------------------------------------------------------------------ | -| **Warnung** | Fünfzehnminütige durchschnittliche Auslastung überschreitet 1x CPU-Kerne | -| **Kritisch** | Fünfzehnminütige durchschnittliche Auslastung überschreitet 2x CPU-Kerne | - -Darüber hinaus wird empfohlen, dass Sie die „Diebstahlzeit“ der Virtualisierung überwachen, um sicherzustellen, dass andere virtuelle Maschinen, die auf demselben Hostsystem ausgeführt werden, nicht alle Ressourcen der Instanz verwenden. - -### Arbeitsspeicherauslastung überwachen - -Die {% data variables.product.product_location_enterprise %} zugeordnete Menge an physischem Arbeitsspeicher kann eine große Auswirkung auf die Gesamtleistung und Anwendungsreaktionsfähigkeit haben. Zum Beschleunigen von Git-Vorgängen soll das System den Kernel-Disk-Cache intensiv verwenden. Es wird empfohlen, dass der normale RSS-Arbeitssatz bei maximaler Nutzung 50 % des gesamten verfügbaren RAMs abdeckt. - -| Schweregrad | Schwellenwert | -| ------------ | ------------------------------------------------------------------------------------- | -| **Warnung** | Nachhaltige RSS-Nutzung überschreitet 50 % des insgesamt verfügbaren Arbeitsspeichers | -| **Kritisch** | Nachhaltige RSS-Nutzung überschreitet 70 % des insgesamt verfügbaren Arbeitsspeichers | - -Wenn der Arbeitsspeicher erschöpft ist, versucht der OOM-Killer des Kernels Arbeitsspeicherressourcen freizugeben. Dazu werden zwangsweise RAM-intensive Anwendungsprozesse beendet, was zu einer Dienstunterbrechung führen kann. Sie sollten der virtuellen Maschine mehr Arbeitsspeicher zuordnen, als dies im normalen Betriebsablauf erforderlich ist. diff --git a/translations/de-DE/content/admin/installation/recovering-a-high-availability-configuration.md b/translations/de-DE/content/admin/installation/recovering-a-high-availability-configuration.md deleted file mode 100644 index 37231d56bc76..000000000000 --- a/translations/de-DE/content/admin/installation/recovering-a-high-availability-configuration.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Hochverfügbarkeitskonfiguration wiederherstellen -intro: 'Nachdem Sie ein Failover zur {% data variables.product.prodname_ghe_server %}-Appliance durchgeführt haben, sollten Sie schnellstmöglich die Redundanz zurückerlangen, anstatt sich auf eine einzelne Appliance zu verlassen.' -redirect_from: - - /enterprise/admin/installation/recovering-a-high-availability-configuration -versions: - enterprise-server: '*' ---- - -Sie können die vorherige primäre Appliance als neue Replikat-Appliance verwenden, sofern das Failover geplant war oder nicht mit dem Appliance-Zustand in Zusammenhang stand. Wenn das Failover mit einem Problem an der primären Appliance zusammenhing, sollten Sie ggf. eine neue Replikat-Appliance erstellen. Weitere Informationen finden Sie unter „[Hochverfügbarkeitsreplikat erstellen](/enterprise/{{ currentVersion }}/admin/guides/installation/creating-a-high-availability-replica/)“. - -### Vorherige primäre Appliance als neues Replikat konfigurieren - -1. Stellen Sie mittels SSH eine Verbindung zur IP-Adresse der vorherigen primären Appliance her. - ```shell - $ ssh -p 122 admin@FORMER PRIMARY IP - ``` -2. Führen Sie auf der vorherigen primären Appliance den Befehl `ghe-repl-setup` mit der IP-Adresse des vorherigen Replikats aus. - ```shell - $ ghe-repl-setup FORMER REPLICA IP - ``` -{% data reusables.enterprise_installation.add-ssh-key-to-primary %} -4. Führen Sie den Befehl `ghe-repl-setup` erneut aus, um die Verbindung zur neuen primären Instanz zu verifizieren und um den Replikatmodus für das neue Replikat zu aktivieren. - ```shell - $ ghe-repl-setup FORMER REPLICA IP - ``` -{% data reusables.enterprise_installation.replication-command %} diff --git a/translations/de-DE/content/admin/installation/removing-a-high-availability-replica.md b/translations/de-DE/content/admin/installation/removing-a-high-availability-replica.md deleted file mode 100644 index 3dc2b5a79934..000000000000 --- a/translations/de-DE/content/admin/installation/removing-a-high-availability-replica.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: Hochverfügbarkeitsreplikat entfernen -intro: 'Sie können die Replikation zu einem {% data variables.product.prodname_ghe_server %}-Replikat temporär stoppen oder die Replikation dauerhaft entfernen.' -redirect_from: - - /enterprise/admin/installation/removing-a-high-availability-replica -versions: - enterprise-server: '*' ---- - -### Temporäres Stoppen der Replikation - -1. Stoppen Sie bei Bedarf, dass ein Replikat der Geo-Replikation den Benutzer-Traffic bedient, indem Sie die Geo DNS-Einträge für das Replikat entfernen. -2. Führen Sie auf dem Replikat, auf dem Sie die Replikation temporär stoppen möchten, den Befehl „ghe-repl-stop“ aus. - ```shell - $ ghe-repl-stop - ``` -3. Führen Sie den Befehl `ghe-repl-start` aus, um die Replikation erneut zu starten. - ```shell - $ ghe-repl-start - ``` - -### Dauerhaftes Entfernen der Replikation - -1. Stoppen Sie bei Bedarf, dass ein Replikat der Geo-Replikation den Benutzer-Traffic bedient, indem Sie die Geo DNS-Einträge für das Replikat entfernen. -2. Führen Sie auf dem Replikat, auf dem die Replikation entfernt werden soll, den Befehl `ghe-repl-stop` aus. - ```shell - $ ghe-repl-stop - ``` -3. Führen Sie auf dem Replikat zum Entfernen des Replikationszustands den Befehl `ghe-repl-teardown` aus. - ```shell - $ ghe-repl-teardown - ``` diff --git a/translations/de-DE/content/admin/installation/searching-the-audit-log.md b/translations/de-DE/content/admin/installation/searching-the-audit-log.md deleted file mode 100644 index 913673ba9ceb..000000000000 --- a/translations/de-DE/content/admin/installation/searching-the-audit-log.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: Auditprotokoll durchsuchen -intro: 'Websiteadministratoren können eine erweiterte Liste der [überwachten Aktionen](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions) auf {% data variables.product.product_location_enterprise %} durchsuchen.' -redirect_from: - - /enterprise/admin/articles/searching-the-audit-log/ - - /enterprise/admin/installation/searching-the-audit-log -versions: - enterprise-server: '*' ---- - -### Suchabfragesyntax - -Erstellen Sie eine Suchabfrage aus mindestens einem Schlüsselwertpaar, das durch die logischen Operatoren AND/OR getrennt ist. - -| Schlüssel | Wert | -| --------------:| ------------------------------------------------------------------------------------------------------- | -| `actor_id` | ID des Benutzerkontos, das die Aktion initiiert hat | -| `actor` | Name des Benutzerkontos, der die Aktion initiiert hat | -| `oauth_app_id` | ID der mit der Aktion verknüpften OAuth-Anwendung | -| `action` | Name der [überwachten Aktion](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions) | -| `user_id` | ID des von der Aktion betroffenen Benutzers | -| `Benutzer` | Name des von der Aktion betroffenen Benutzers | -| `repo_id` | ID des von der Aktion betroffenen Repositorys (sofern zutreffend) | -| `repo` | Name des von der Aktion betroffenen Repositorys (sofern zutreffend) | -| `actor_ip` | IP-Adresse, über welche die Aktion initiiert wurde | -| `created_at` | Zeitpunkt, an dem die Aktion aufgetreten ist | -| `from` | Ansicht, von wem die Aktion initiiert wurde | -| `note` | Verschiedene ereignisspezifische Informationen (im Nur-Text- oder JSON-Format) | -| `org` | Name der von der Aktion betroffenen Organisation (sofern zutreffend) | -| `org_id` | ID der von der Aktion betroffenen Organisation (sofern zutreffend) | - -So können Sie beispielsweise alle Aktionen anzeigen, die sich seit Anfang 2017 auf das Repository `octocat/Spoon-Knife` ausgewirkt haben: - - `repo:"octocat/Spoon-Knife" AND created_at:[2017-01-01 TO *]` - -Eine vollständige Liste der Aktionen finden Sie unter „[Überwachte Aktionen](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions)“. - -### Auditprotokoll durchsuchen - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.audit-log-tab %} -4. Geben Sie eine Suchabfrage ein.![Suchabfrage](/assets/images/enterprise/site-admin-settings/search-query.png) diff --git a/translations/de-DE/content/admin/installation/setting-git-push-limits.md b/translations/de-DE/content/admin/installation/setting-git-push-limits.md deleted file mode 100644 index 642696a7035a..000000000000 --- a/translations/de-DE/content/admin/installation/setting-git-push-limits.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: Push-Begrenzungen für Git festlegen -intro: Du kannst eine Größenbegrenzung für Git-Objekte in einem Repository erzwingen. -redirect_from: - - /enterprise/admin/guides/installation/git-server-settings/ - - /enterprise/admin/articles/setting-git-push-limits/ - - /enterprise/admin/installation/setting-git-push-limits -versions: - enterprise-server: '*' ---- - -Um die Größe Deines Repositorys handhabbar zu halten und Performance-Probleme zu vermeiden, konfiguriere ein Dateigrößenlimit für Repositorys auf Deiner Instanz. - -Wenn Du Repository-Uploadlimits erzwingst, können Benutzer standardmäßig keine Dateien hinzufügen oder aktualisieren, die größer als 100 MB sind. - -{% if currentVersion ver_lt "enterprise-server@2.20" %} -{% tip %} - -**Hinweis:** Nur Dateien, die größer sind als {% data variables.large_files.warning_size %}, werden mit der Git-Push-Begrenzung abgeglichen. Kontaktieren Sie {% data variables.contact.contact_ent_support %}, wenn Sie eine niedrigere Push-Begrenzung festlegen müssen. - -{% endtip %} -{% endif %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -4. Verwenden Sie unter „Repository upload limit“ (Upload-Begrenzung für Repository) das Dropdownmenü, und klicken Sie auf eine maximale Objektgröße.![Dropdownmenü mit Optionen für die maximale Objektgröße](/assets/images/enterprise/site-admin-settings/repo-upload-limit-dropdown.png) -5. Optional kannst Du **Für alle Repositorys erzwingen** auswählen, um ein maximales Upload-Limit für alle Repositorys auf {% data variables.product.product_location_enterprise %} zu erzwingen. ![Option zur zwangsweisen Begrenzung der Objektgröße für alle Repositorys](/assets/images/enterprise/site-admin-settings/all-repo-upload-limit-option.png) diff --git a/translations/de-DE/content/admin/installation/setting-up-external-monitoring.md b/translations/de-DE/content/admin/installation/setting-up-external-monitoring.md deleted file mode 100644 index 248c5d2603b3..000000000000 --- a/translations/de-DE/content/admin/installation/setting-up-external-monitoring.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: Externe Überwachung festlegen -intro: 'Mit den Statistikerfassungsprotokollen SNMP oder collectd können Sie grundlegende Systemressourcen auf Ihrer {% data variables.product.prodname_ghe_server %}-Appliance überwachen.' -redirect_from: - - /enterprise/admin/installation/setting-up-external-monitoring -versions: - enterprise-server: '*' ---- - -### Informationen zu SNMP - -Simple Network Management Protocol (SNMP) ist eine weithin unterstützte Methode für die Überwachung von Netzwerkgeräten und -servern. SNMP ist standardmäßig deaktiviert, kann jedoch über das {% data variables.product.prodname_enterprise %}-Überwachungs-Dashboard konfiguriert werden. UDP-Port 161 muss offen und über Ihre Network Management Station erreichbar sein. Weitere Informationen finden Sie unter „[Überwachung mittels SNMP](/enterprise/{{ currentVersion }}/admin/guides/installation/monitoring-using-snmp/)“. - -### Informationen zu collectd - -collectd ist ein Open-Source-Daemon zur Statistikerfassung und Berichterstellung mit integrierter Unterstützung zum Schreiben in RRD-Dateien. Die Statistiken zur CPU-Auslastung, zur Arbeitsspeicher- und Disk-Nutzung, zum Traffic und zu den Fehlern der Netzwerkschnittstelle sowie zur Systemauslastung können an einen externen collectd-Server weitergeleitet werden, auf dem Diagramme, Analysen und Meldungen mit einer Vielzahl an Tools und Plug-ins konfiguriert werden können. Informationen zum Konfigurieren der `collectd`-Weiterleitung finden Sie unter „[collectd konfigurieren](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-collectd/)“. - -Zusätzlich werden die in die zugrunde liegenden Virtualisierungsplattformen integrierten Überwachungstools für die grundlegende Überwachung und Alarmierung von Systemressourcen verwendet. Weitere Informationen finden Sie unter „[Amazon CloudWatch](http://aws.amazon.com/cloudwatch/)“ und in der Dokumentation „[VMware vSphere Monitoring](http://pubs.vmware.com/vsphere-50/topic/com.vmware.ICbase/PDF/vsphere-esxi-vcenter-server-50-monitoring-performance-guide.pdf)“. diff --git a/translations/de-DE/content/admin/installation/site-admin-dashboard.md b/translations/de-DE/content/admin/installation/site-admin-dashboard.md deleted file mode 100644 index d86c89dc7076..000000000000 --- a/translations/de-DE/content/admin/installation/site-admin-dashboard.md +++ /dev/null @@ -1,178 +0,0 @@ ---- -title: Websiteadministrator-Dashboard -intro: 'Das Websiteadministrator-Dashboard bietet eine Reihe an Tools zum Verwalten von {% data variables.product.product_location_enterprise %}.' -redirect_from: - - /enterprise/admin/articles/site-admin-dashboard/ - - /enterprise/admin/installation/site-admin-dashboard -versions: - enterprise-server: '*' ---- - -Klicken Sie in der oberen rechten Ecke einer beliebigen Seite auf {% octicon "rocket" aria-label="The rocket ship" %}, um auf das Dashboard zuzugreifen.![Raumschiffsymbol für den Zugriff auf die Einstellungen des Websiteadministrators](/assets/images/enterprise/site-admin-settings/access-new-settings.png) - -### Lizenzinformationen und Suche - -In diesem Abschnitt des Websiteadministrator-Dashboards können Sie Ihre aktuelle {% data variables.product.prodname_enterprise %}-Lizenz überprüfen, nach Benutzern und Repositorys suchen und das [Auditprotokoll](#audit-log) abfragen. - -### {% data variables.enterprise.management_console %} - -Hier können Sie die {% data variables.enterprise.management_console %} starten, um die Einstellungen der virtuellen Appliance zu verwalten, also beispielsweise die Domain, die Authentifizierung und SSL. - -### Erkunden - - Die Daten für die [Seite mit Trends](https://github.com/blog/1585-explore-what-is-trending-on-github) für GitHub wird für Repositorys und Entwickler in täglichen, wöchentlichen und monatlichen Zeiträumen berechnet. Im Abschnitt **Erkunden** können Sie sehen, wann diese Daten letztmals zwischengespeichert wurden. Zudem können Sie darin neue Aufträge zur Berechnung von Trends in die Warteschlange versetzen. - -### Auditprotokoll - -{% data variables.product.prodname_enterprise %} speichert ein Ablaufprotokoll der überwachten Aktionen, die Sie abfragen können. - -Das Auditprotokoll zeigt standardmäßig eine Liste sämtlicher überwachter Aktionen in umgekehrt chronologischer Reihenfolge an. Sie können diese Liste filtern. Geben Sie dazu im Textfeld **Query** (Abfragen) Schlüsselwertpaare ein, und klicken Sie anschließend auf **Search** (Suchen), wie dies unter „[Auditprotokoll durchsuchen](/enterprise/{{ currentVersion }}/admin/guides/installation/searching-the-audit-log)“ erläutert ist. - -Weitere Informationen zur Auditprotokollierung im Allgemeinen finden Sie unter „[Auditprotokollierung](/enterprise/{{ currentVersion }}/admin/guides/installation/audit-logging)“. Eine vollständige Liste der überwachten Aktionen finden Sie unter „[Überwachte Aktionen](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions)“. - -### Berichte - -Zum Abrufen von Informationen zu Benutzern, Organisationen und Repositorys in {% data variables.product.product_location_enterprise %} würden Sie normalerweise über die [GitHub-API](http://developer.github.com/v3/) JSON-Daten abrufen. Leider stellt die API nicht alle gewünschten Daten bereit und erfordert ein gewisses technisches Know-how. Das Websiteadministrator-Dashboard bietet alternativ den Abschnitt **Reports** (Berichte). In diesem können Sie ohne Weiteres CSV-Berichte mit den meisten Informationen herunterladen, die Sie wahrscheinlich für Benutzer, Organisationen und Repositorys benötigen. - -Insbesondere können Sie CSV-Berichte herunterladen, die Folgendes auflisten: - -- alle Benutzer -- alle Benutzer, die im letzten Monat aktiv waren -- alle Benutzer, die mindestens für einen Monat inaktiv waren -- alle Benutzer, die gesperrt wurden -- alle Organisationen -- alle Repositorys - -Darüber hinaus können Sie mit einem Websiteadministratorkonto über die HTTP-Standardauthentifizierung programmatisch auf diese Berichte zugreifen. Du musst ein persönliches Zugangs-Token mit dem „scope“ (Anwendungsbereich) `site_admin` verwenden. For more information, see "[Creating a personal access token](/github/authenticating-to-github/creating-a-personal-access-token)." - -So würden Sie beispielsweise den Bericht „all users“ (alle Benutzer) mit der cURL herunterladen: - -```shell -curl -L -u username:token http(s)://hostname/stafftools/reports/all_users.csv -``` - -Ersetzen Sie für den programmatischen Zugriff auf die anderen Berichte `all_users` durch `active_users`, `dormant_users`, `suspended_users`, `all_organizations` oder `all_repositories`. - -{% note %} - -**Hinweis:** Die anfängliche `curl`-Anforderung gibt eine 202 HTTP-Antwort zurück, wenn keine zwischengespeicherten Berichte verfügbar sind. Im Hintergrund wird ein Bericht generiert. Sie können eine zweite Anforderung senden, um den Bericht herunterzuladen. Sie können ein Passwort oder ein OAuth-Token mit dem Umfang `site_admin` anstelle eines Passworts verwenden. - -{% endnote %} - -#### Benutzerberichte - -| Schlüssel | Beschreibung | -| -----------------:| ------------------------------------------------------------------------------------ | -| `created_at` | Zeitpunkt der Benutzerkontoerstellung (als ein ISO 8601-Zeitstempel) | -| `id` | Konto-ID für den Benutzer oder für die Organisation | -| `login` | Anmeldename des Kontos | -| `E-Mail` | Primäre E-Mail-Adresse des Kontos | -| `Rolle` | Gibt an, ob es sich um ein Administrator- oder um ein normales Benutzerkonto handelt | -| `suspended?` | Gibt an, ob das Konto gesperrt wurde | -| `last_logged_ip` | Neueste IP-Adresse für Kontoanmeldung | -| `repos` | Anzahl der dem Konto gehörenden Repositorys | -| `ssh_keys` | Anzahl der für das Konto registrierten SSH-Schlüssel | -| `org_memberships` | Anzahl der Organisationen, zu denen das Konto gehört | -| `dormant?` | Gibt an, ob das Konto inaktiv ist | -| `last_active` | Gibt den Zeitpunkt der letzten Kontoaktivität an (als ein ISO 8601-Zeitstempel) | -| `raw_login` | Unformatierte Anmeldeinformationen (im JSON-Format) | -| `2fa_enabled?` | Gibt an, ob der Benutzer die Zwei-Faktor-Authentifizierung aktiviert hat | - -#### Organisationsberichte - -| Schlüssel | Beschreibung | -| ---------------:| ----------------------------------------------------------------------------------- | -| `id` | Organisations-ID | -| `created_at` | Zeitpunkt der Organisationserstellung | -| `login` | Anmeldename der Organisation | -| `E-Mail` | Primäre E-Mail-Adresse der Organisation | -| `owners` | Anzahl der Organisationsinhaber | -| `members` | Anzahl der Organisationsmitglieder | -| `teams` | Anzahl der Organisationsteams | -| `repos` | Anzahl der Organisations-Repositorys | -| `2fa_required?` | Gibt an, ob für die Organisation die Zwei-Faktor-Authentifizierung erforderlich ist | - -#### Repository-Berichte - -| Schlüssel | Beschreibung | -| --------------------------:| ------------------------------------------------------------------------ | -| `created_at` | Zeitpunkt der Repository-Erstellung | -| `owner_id` | ID des Repository-Inhabers | -| `owner_type` | Gibt an, ob das Repository einem Benutzer oder einer Organisation gehört | -| `owner_name` | Name des Repository-Inhabers | -| `id` | Repository-ID | -| `name` | Repository-Name | -| `Transparenz/Sichtbarkeit` | Gibt an, ob das Repository öffentlich oder privat ist | -| `readable_size` | Größe des Repositorys in einem visuell lesbaren Format | -| `raw_size` | Größe des Repositorys als eine Zahl | -| `collaborators` | Anzahl der Repository-Mitarbeiter | -| `fork?` | Gibt an, ob das Repository ein Fork ist | -| `deleted?` | Gibt an, ob das Repository gelöscht wurde | - -### Indizierung - - Die GitHub-Features zur [Codesuche](https://github.com/blog/1381-a-whole-new-code-search) werden von [ElasticSearch](http://www.elasticsearch.org/) unterstützt. Dieser Abschnitt des Websiteadministrator-Dashboards zeigt den aktuellen Status Ihres ElasticSearch-Clusters und stellt Ihnen verschiedene Tools bereit, mit denen Sie das Verhalten der Suchvorgänge und Indizierung steuern können. Diese Tools sind in die folgenden drei Kategorien unterteilt. - -#### Codesuche - -Dadurch können Sie Such- und Indizierungsvorgänge im Quellcode aktivieren oder deaktivieren. - -#### Reparatur des Codesuche-Index - -Dadurch wird gesteuert, wie der Index für die Codesuche repariert wird. Sie können - -- Indexreparaturaufträge aktivieren oder deaktivieren, -- einen neuen Indexreparaturauftrag starten, -- den gesamten Indexreparaturzustand zurücksetzen. - -{% data variables.product.prodname_enterprise %} verwendet Reparaturaufträge, um den Zustand des Suchindex mit den in einer Datenbank (Issues, Pull Requests, Repositorys und Benutzer) gespeicherten Daten und mit den in Git-Repositorys (Quellcode) gespeicherten Daten abzustimmen. Dies ist der Fall, wenn - -- ein neuer Suchindex erstellt wird, -- fehlende Daten abgeglichen oder -- alte Suchdaten aktualisiert werden müssen. - -Reparaturaufträge werden demnach nach Bedarf gestartet und im Hintergrund ausgeführt. Sie werden nicht von Websiteadministratoren geplant. - -Zudem verwenden Reparaturaufträge einen „Reparaturversatz“ zur Parallelisierung. Dies ist ein Versatz in der Datenbanktabelle für den abzustimmenden Datensatz. Anhand dieses Versatzes können mehrere Hintergrundaufträge die Arbeit synchronisieren. - -Eine Fortschrittsanzeige zeigt den aktuellen Status eines Reparaturauftrags auf den gesamten Hintergrund-Workern an. Hierbei handelt es sich um die prozentuale Abweichung des Reparaturversatzes mit der höchsten Datensatz-ID in der Datenbank. Machen Sie sich keine Sorgen hinsichtlich des nach Abschluss eines Reparaturauftrags in der Fortschrittsanzeige angezeigten Werts. Dieser zeigt nämlich den Unterschied zwischen dem Reparaturversatz und der höchsten Datensatz-ID in der Datenbank. Der Wert wird kleiner, wenn mehr Repositorys zu {% data variables.product.product_location_enterprise %} hinzugefügt werden, auch wenn diese Repositorys tatsächlich indiziert sind. - -Reparaturaufträge des Codesuche-Index können jederzeit gestartet werden. Diese verwenden eine einzelne CPU und stimmen den Suchindex mit den Datenbank- und Git-Repository-Daten ab. Versuchen Sie, einen Reparaturauftrag zunächst außerhalb der Hauptauslastungszeiten durchzuführen, um die Auswirkungen auf die E/A-Leistung zu minimieren und die Wahrscheinlichkeit von Betriebsunterbrechungen zu verringern. Mit einem Dienstprogramm wie `top` können Sie die durchschnittliche Auslastung und CPU-Auslastung Ihres Systems überwachen. Wenn Sie keine erheblichen Änderungen feststellen, können Sie einen Indexreparaturauftrag auch in Spitzenzeiten ohne Weiteres ausführen. - -#### Indexreparatur für Issues - - Dadurch wird gesteuert, wie der [Issues](https://github.com/blog/831-issues-2-0-the-next-generation)-Index repariert wird. Sie können - -- Indexreparaturaufträge aktivieren oder deaktivieren, -- einen neuen Indexreparaturauftrag starten, -- den gesamten Indexreparaturzustand zurücksetzen. - -### Repositorys - -Dies ist eine Liste der Repositorys auf {% data variables.product.product_location_enterprise %}. Sie können auf einen Repository-Namen klicken und auf Funktionen zum Verwalten des Repositorys zugreifen. - -- [Erzwungene Push-Vorgänge an ein Repository blockieren](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository/) -- [{% data variables.large_files.product_name_long %} konfigurieren](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-git-large-file-storage/#configuring-git-large-file-storage-for-an-individual-repository) -- [Repositorys archivieren und deren Archivierung aufheben](/enterprise/{{ currentVersion }}/admin/guides/user-management/archiving-and-unarchiving-repositories/) - -### Alle Benutzer - -Hier können Sie alle Benutzer auf Ihrer {% data variables.product.product_location_enterprise %} anzeigen und [eine SSH-Schlüsselüberwachung initiieren](/enterprise/{{ currentVersion }}/admin/guides/user-management/auditing-ssh-keys). - -### Websiteadministratoren - -Hier können Sie alle Administratoren auf Ihrer {% data variables.product.product_location_enterprise %} anzeigen und [eine SSH-Schlüsselüberwachung initiieren](/enterprise/{{ currentVersion }}/admin/guides/user-management/auditing-ssh-keys). - -### Inaktive Benutzer - -Hier können Sie alle inaktiven Benutzer auf {% data variables.product.product_location_enterprise %} anzeigen und [sperren](/enterprise/{{ currentVersion }}/admin/guides/user-management/suspending-and-unsuspending-users). In den folgenden Fällen wird ein Benutzerkonto als inaktiv angesehen: - -- Es besteht schon länger als die für {% data variables.product.product_location_enterprise %} festgelegte Inaktivitätsschwelle. -- Es hat in diesem Zeitraum keine Aktivitäten generiert. -- Es ist kein Websiteadministrator. - -{% data reusables.enterprise_site_admin_settings.dormancy-threshold %} Weitere Informationen finden Sie unter „[Inaktive Benutzer verwalten](/enterprise/{{ currentVersion }}/admin/guides/user-management/managing-dormant-users/#configuring-the-dormancy-threshold)“. - -### Gesperrte Benutzer - -Hier können Sie alle Benutzer anzeigen, die auf {% data variables.product.product_location_enterprise %} gesperrt wurden, und [eine SSH-Schlüsselüberwachung initiieren](/enterprise/{{ currentVersion }}/admin/guides/user-management/auditing-ssh-keys). diff --git a/translations/de-DE/content/admin/installation/system-overview.md b/translations/de-DE/content/admin/installation/system-overview.md deleted file mode 100644 index 3cc309bdfdb0..000000000000 --- a/translations/de-DE/content/admin/installation/system-overview.md +++ /dev/null @@ -1,140 +0,0 @@ ---- -title: Systemübersicht -intro: '{% data variables.product.prodname_ghe_server %} ist die private Kopie von {% data variables.product.prodname_dotcom %} in Ihrer Organisation, die in einer virtuellen Appliance enthalten ist, die lokal oder in der Cloud gehostet wird und die Sie konfigurieren und kontrollieren.' -redirect_from: - - /enterprise/admin/installation/system-overview -versions: - enterprise-server: '*' ---- - -### Speicherarchitektur - -Für {% data variables.product.prodname_ghe_server %} sind zwei Storage-Volumes erforderlich. Eines muss am Pfad des *Root-Dateisystems* (`/`) und das andere am Pfade des *Benutzerdateisystems* (`/data/user`) gemountet sein. Diese Architektur vereinfacht die Upgrade-, Rollback und Wiederherstellungsprozeduren, indem die in Ausführung befindliche Softwareumgebung von den persistenten Anwendungsdaten getrennt wird. - -Das Root-Dateisystem ist im verteilten Maschinen-Image enthalten. Es enthält das Basisbetriebssystem und die {% data variables.product.prodname_ghe_server %}-Anwendungsumgebung. Das Root-Dateisystem sollte als flüchtig behandelt werden. Daten auf dem Root-Dateisystem werden beim Upgrade auf künftige {% data variables.product.prodname_ghe_server %}-Versionen ersetzt. - -Das Root-Dateisystem enthält Folgendes: - - benutzerdefinierte Zertifikate der Zertifizierungsstelle (CA) (in */usr/local/share/ca-certificates*) - - benutzerdefinierte Netzwerkkonfigurationen - - benutzerdefinierte Firewallkonfigurationen - - den Replikationszustand - -Das Benutzerdateisystem enthält die Benutzerkonfiguration und -daten, beispielsweise - - Git-Repositorys, - - Datenbanken, - - Suchindizes, - - auf {% data variables.product.prodname_pages %}-Websites veröffentlichte Inhalte, - - große Dateien von {% data variables.large_files.product_name_long %}, - - Pre-Receive-Hook-Umgebungen. - -### Bereitstellungsoptionen - -Sie können {% data variables.product.prodname_ghe_server %} als eine einzelne virtuelle Appliance oder in einer Hochverfügbarkeitskonfiguration bereitstellen. Weitere Informationen finden Sie unter „[{% data variables.product.prodname_ghe_server %} für Hochverfügbarkeit konfigurieren](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-github-enterprise-server-for-high-availability/)“. - -Einige Organisationen mit Zehntausenden Entwicklern können ebenfalls vom {% data variables.product.prodname_ghe_server %} Clustering profitieren. Weitere Informationen findest Du unter „[Informationen zum Clustering](/enterprise/{{ currentVersion }}/admin/guides/clustering/about-clustering)“. - -### Datenaufbewahrung und Rechenzentrumsredundanz - -{% danger %} - -Bevor Sie {% data variables.product.prodname_ghe_server %} in einer Produktionsumgebung verwenden, wird dringend empfohlen, Backups und einen Disaster Recovery-Plan einzurichten. Weitere Informationen finden Sie unter „[Backups auf Ihrer Appliance konfigurieren](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-backups-on-your-appliance)“. - -{% enddanger %} - -{% data variables.product.prodname_ghe_server %} unterstützt Online- und inkrementelle Backups mit den [{% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils). Sie können inkrementelle Snapshots über eine sichere Netzwerkverbindung (den SSH-Verwaltungsport) über weite Entfernungen für den externen oder geografisch verteilten Storage erstellen. Im Falle einer Katastrophe im primären Rechenzentrum können Sie Snapshots über das Netzwerk auf neu verteilten Appliances wiederherstellen. - -Zusätzlich zu Netzwerk-Backups werden AWS- (EBS) und VMware-Disk-Snapshots der Benutzer-Storage-Volumes unterstützt, während die Appliance offline ist oder sich im Wartungsmodus befindet. Regelmäßige Volume-Snapshots können als kostengünstige, unkomplizierte Alternative zu Netzwerk-Backups mit {% data variables.product.prodname_enterprise_backup_utilities %} verwendet werden, wenn Ihre Service Level-Anforderungen eine regelmäßige Offline-Wartung ermöglichen. - -Weitere Informationen finden Sie unter „[Backups auf Ihrer Appliance konfigurieren](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-backups-on-your-appliance)“. - -### Sicherheit - -{% data variables.product.prodname_ghe_server %} wird als virtuelle Appliance in Ihrer Infrastruktur ausgeführt und unterliegt den bestehenden Datensicherheitssteuerungen, z. B. Firewalls, IAM, Überwachung und VPNs. {% data variables.product.prodname_ghe_server %} trägt dazu bei, möglichen Problemen cloudgestützter Lösungen hinsichtlich der Einhaltung gesetzlicher Vorschriften vorzubeugen. - -{% data variables.product.prodname_ghe_server %} umfasst zudem weitere Sicherheitsfunktionen. - -- [Betriebssystem, Software und Patches](#operating-system-software-and-patches) -- [Netzwerksicherheit](#network-security) -- [Anwendungssicherheit](#application-security) -- [Externe Dienste und Supportzugang](#external-services-and-support-access) -- [Verschlüsselte Kommunikation](#encrypted-communication) -- [Benutzer und Zugriffsberechtigungen](#users-and-access-permissions) -- [Authentifizierung](#authentication) -- [Audit- und Zugriffsprotokollierung](#audit-and-access-logging) - -#### Betriebssystem, Software und Patches - -{% data variables.product.prodname_ghe_server %} führt ein angepasstes Linux-Betriebssystem mit den nötigsten Anwendungen und Diensten aus. {% data variables.product.prodname_dotcom %} stellt Patches für das Kernbetriebssystems der Appliance im Rahmen des normalen Produktveröffentlichungszyklus bereit. Die Patches richten sich an Funktions-, Stabilitäts- und nicht kritische Sicherheitsprobleme bei {% data variables.product.prodname_dotcom %}-Anwendungen. Bei Bedarf stellt {% data variables.product.prodname_dotcom %} außerdem kritische Sicherheitspatches außerhalb des normalen Veröffentlichungszyklus bereit. - -#### Netzwerksicherheit - -Die interne Firewall von {% data variables.product.prodname_ghe_server %} schränkt den Netzwerkzugriff auf die Dienste der Appliance ein. Über das Netzwerk sind ausschließlich Dienste verfügbar, die für die Funktionsfähigkeit der Appliance erforderlich sind. Weitere Informationen finden Sie unter „[Netzwerkports](/enterprise/{{ currentVersion }}/admin/guides/installation/network-ports)“. - -#### Anwendungssicherheit - -Das Anwendungssicherheitsteam von {% data variables.product.prodname_dotcom %} konzentriert sich auf die Beurteilung der Sicherheitslücken, auf die Eindringtests und die Codeprüfung für {% data variables.product.prodname_dotcom %} products, including {% data variables.product.prodname_ghe_server %}. {% data variables.product.prodname_dotcom %} hat zusätzlich externe Sicherheitsfirmen mit zeitabhängigen Sicherheitsbeurteilungen der {% data variables.product.prodname_dotcom %}-Produkte beauftragt. - -#### Externe Dienste und Supportzugang - -{% data variables.product.prodname_ghe_server %} lässt sich ohne jeglichen Egress-Zugriff vom Netzwerk auf externe Dienste nutzen. Optional können Sie die Integration in externe Dienste zur E-Mail-Zustellung, zur externen Überwachung und zur Protokollweiterleitung aktivieren. Weitere Informationen finden Sie unter „[E-Mail für Benachrichtigungen konfigurieren](/enterprise/{{ currentVersion }}/admin/user-management/configuring-email-for-notifications)“, „[Externe Überwachung festlegen](/enterprise/{{ currentVersion }}/admin/installation/setting-up-external-monitoring)“ und „[Protokollweiterleitung](/enterprise/{{ currentVersion }}/admin/installation/log-forwarding)“. - -Sie können manuell Fehlerbehebungsdaten sammeln und an den {% data variables.contact.github_support %} senden. Weitere Informationen finden Sie unter „[Daten für den {% data variables.contact.github_support %}-Support bereitstellen](/enterprise/{{ currentVersion }}/admin/enterprise-support/providing-data-to-github-support)“. - -#### Verschlüsselte Kommunikation - -{% data variables.product.prodname_dotcom %} hat {% data variables.product.prodname_ghe_server %} für die Ausführung hinter der Unternehmens-Firewall vorgesehen. Zum Schutz der drahtgebundenen Kommunikation sollten Sie TLS (Transport Layer Security) aktivieren. {% data variables.product.prodname_ghe_server %} unterstützt handelsübliche TLS-Zertifikate mit 2048 Bit und mehr für den HTTPS-Datenverkehr. Weitere Informationen finden Sie unter „[TLS konfigurieren](/enterprise/{{ currentVersion }}/admin/installation/configuring-tls)“. - -Standardmäßig bietet die Appliance auch den SSH-Zugriff (Secure Shell) für den Repository-Zugriff über Git und für Verwaltungszwecke. Weitere Informationen finden Sie unter „[Informationen zu SSH](/enterprise/user/articles/about-ssh)“ und „[Auf die Verwaltungsshell (SSH) zugreifen](/enterprise/{{ currentVersion }}/admin/installation/accessing-the-administrative-shell-ssh)“. - -#### Benutzer und Zugriffsberechtigungen - -{% data variables.product.prodname_ghe_server %} umfasst drei Kontotypen. - -- Das `admin`-Linux-Benutzerkonto besitzt kontrollierten Zugriff auf das zugrundeliegende Betriebssystem mit direktem Dateisystem- und Datenbankzugriff. Eine kleine Gruppe vertrauenswürdiger Administratoren sollte den Zugriff auf dieses Konto erhalten, auf das sie über SSH zugreifen können. Weitere Informationen finden Sie unter „[Auf die Verwaltungsshell (SSH) zugreifen](/enterprise/{{ currentVersion }}/admin/installation/accessing-the-administrative-shell-ssh)“. -- Benutzerkonten in der Webanwendung der Appliance besitzen den uneingeschränkten Zugriff auf die jeweils eigenen Daten sowie auf alle Daten, für die andere Benutzer oder Organisationen den Zugriff ausdrücklich gewähren. -- Websiteadministratoren in der Webanwendung der Appliance sind Benutzerkonten, die die allgemeinen Webanwendungs- und Appliance-Einstellungen, die Einstellungen für Benutzer- und Organisationskonten sowie die Repository-Daten verwalten können. - -Weitere Informationen zu den Benutzerberechtigungen in {% data variables.product.prodname_ghe_server %} finden Sie unter „[Zugriffsrechte auf GitHub](/enterprise/user/articles/access-permissions-on-github)“. - -#### Authentifizierung - -{% data variables.product.prodname_ghe_server %} umfasst vier Authentifizierungsmethoden. - -- Die Authentifizierung mit einem öffentlichen SSH-Schlüssel eröffnet sowohl den Repository-Zugriff mit Git als auch den Zugriff auf die Verwaltungsshell. Weitere Informationen finden Sie unter „[Informationen zu SSH](/enterprise/user/articles/about-ssh)“ und „[Auf die Verwaltungsshell (SSH) zugreifen](/enterprise/{{ currentVersion }}/admin/installation/accessing-the-administrative-shell-ssh)“. -- Die Authentifizierung per Benutzername und Passwort mit HTTP-Cookies eröffnet den Zugriff auf die Webanwendung und auf die Sitzungsverwaltung mit optionaler Zwei-Faktor-Authentifizierung (2FA). Weitere Informationen finden Sie unter „[Integrierte Authentifizierung verwenden](/enterprise/{{ currentVersion }}/admin/user-management/using-built-in-authentication)“. -- Die externe LDAP-, SAML- oder CAS-Authentifizierung mit einem LDAP-Service, einem SAML Identity Provider (IdP) oder anderen kompatiblen Diensten eröffnet den Zugriff auf die Webanwendung. Weitere Informationen finden Sie unter „[Benutzer für Ihre GitHub Enterprise Server-Instanz authentifizieren](/enterprise/{{ currentVersion }}/admin/user-management/authenticating-users-for-your-github-enterprise-server-instance)“. -- OAuth-Token und persönliche Zugriffstoken eröffnen den Zugriff auf Git-Repository-Daten und APIs sowohl für externe Clients als auch für Dienste. For more information, see "[Creating a personal access token](/github/authenticating-to-github/creating-a-personal-access-token)." - -#### Audit- und Zugriffsprotokollierung - -{% data variables.product.prodname_ghe_server %} speichert sowohl herkömmliche Betriebssystem- als auch Anwendungsprotokolle. Die Anwendung führt außerdem detaillierte Audit- und Sicherheitsprotokolle, die {% data variables.product.prodname_ghe_server %} dauerhaft speichert. Sie können beide Protokolltypen über das `syslog-ng`-Protokoll in Echtzeit an mehrere Ziele weiterleiten. Weitere Informationen finden Sie unter „[Protokollweiterleitung](/enterprise/{{ currentVersion }}/admin/installation/log-forwarding)“. - -Zugriffs- und Auditprotokolle enthalten beispielsweise die folgenden Informationen. - -##### Zugriffsprotokolle - -- Vollständige Webserverprotokolle über den Browser- und API-Zugriff -- Vollständige Protokolle über den Zugriff auf Repository-Daten über Git, HTTPS und SSH-Protokolle -- Verwaltungszugriffsprotokolle über HTTPS und SSH - -##### Auditprotokolle - -- Benutzeranmeldungen, Passwortzurücksetzungen, 2FA-Anfragen, Änderungen der E-Mail-Einstellungen und Änderungen an autorisierten Anwendungen und APIs -- Aktionen von Websiteadministratoren wie das Entsperren von Benutzerkonten und Repositorys -- Repository-Push-Events, Zugriffsgewährungen, Übertragungen und Umbenennungen -- Änderungen an der Organisationsmitgliedschaft, u. a. Teamerstellung und -vernichtung - -### Open-Source-Abhängigkeiten für {% data variables.product.prodname_ghe_server %} - -Eine vollständige Liste der Abhängigkeiten in der Version Ihrer Appliance von {% data variables.product.prodname_ghe_server %} sowie die Lizenz jedes Projekts finden Sie unter `http(s)://HOSTNAME/site/credits`. - -Tarballs mit einer vollständigen Liste der Abhängigkeiten und verknüpften Metadaten sind auf Ihrer Appliance verfügbar: -- Plattformübergreifende Abhängigkeiten finden Sie unter `/usr/local/share/enterprise/dependencies--base.tar.gz`. -- Plattformspezifische Abhängigkeiten finden Sie unter `/usr/local/share/enterprise/dependencies--.tar.gz`. - -Tarballs sind mit einer vollständigen Liste der Abhängigkeiten und Metadaten auch unter `https://enterprise.github.com/releases//download.html` verfügbar. - -### Weiterführende Informationen - -- „[Eine Testversion von {% data variables.product.prodname_ghe_server %} einrichten](/articles/setting-up-a-trial-of-github-enterprise-server)“ -- „[{% data variables.product.prodname_ghe_server %}-Instanz einrichten](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-github-enterprise-server-instance)“ diff --git a/translations/de-DE/content/admin/installation/troubleshooting-ssl-errors.md b/translations/de-DE/content/admin/installation/troubleshooting-ssl-errors.md deleted file mode 100644 index 56951c07c176..000000000000 --- a/translations/de-DE/content/admin/installation/troubleshooting-ssl-errors.md +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: Fehlerbehebung bei SSL-Fehlern -intro: 'Bei SSL-Problemen mit Ihrer Appliance können Sie Maßnahmen ergreifen, um diese zu beheben.' -redirect_from: - - /enterprise/admin/articles/troubleshooting-ssl-errors/ - - /enterprise/admin/categories/dns-ssl-and-subdomain-configuration/ - - /enterprise/admin/installation/troubleshooting-ssl-errors -versions: - enterprise-server: '*' ---- - -### Passphrase aus Ihrer Schlüsseldatei entfernen - -Wenn Sie über eine Linux-Maschine mit installiertem OpenSSL verfügen, können Sie Ihre Passphrase entfernen. - -1. Benennen Sie Ihre ursprüngliche Schlüsseldatei um. - ```shell - $ mv yourdomain.key yourdomain.key.orig - ``` -2. Generieren Sie einen neuen Schlüssel ohne eine Passphrase. - ```shell - $ openssl rsa -in yourdomain.key.orig -out yourdomain.key - ``` - -Wenn Sie diesen Befehl ausführen, werden Sie aufgefordert, die Passphrase des Schlüssels einzugeben. - -Weitere Informationen zu OpenSSL finden Sie in der [Dokumentation zu OpenSSL](https://www.openssl.org/docs/). - -### SSL-Zertifikat oder Schlüssel in das PEM-Format umwandeln - -Wenn Sie OpenSSL installiert haben, können Sie den Schlüssel mit dem Befehl `openssl` in das PEM-Format umwandeln. Beispielsweise können Sie einen Schlüssel vom DER- in das PEM-Format umwandeln. - -```shell -$ openssl rsa -in yourdomain.der -inform DER -out yourdomain.key -outform PEM -``` - -Andernfalls können Sie das SSL Converter-Tool verwenden, um Ihr Zertifikat in das PEM-Format umzuwandeln. Weitere Informationen finden Sie in der Dokumentation zum [SSL Converter-Tool](https://www.sslshopper.com/ssl-converter.html). - -### Nicht antwortende Installation nach dem Hochladen eines Schlüssels - -Wenn {% data variables.product.product_location_enterprise %} nach dem Hochladen eines SSL-Schlüssels nicht mehr antwortet, [kontaktieren Sie den {% data variables.product.prodname_enterprise %}-Support](https://enterprise.github.com/support) mit den entsprechenden Details, einschließlich einer Kopie Ihres SSL-Zertifikats. - -### Zertifizierungsgültigkeitsfehler - -Clients wie Webbrowser und die Git-Befehlszeile zeigen eine Fehlermeldung an, wenn die Gültigkeit eines SSL-Zertifikats nicht verifiziert werden kann. Dies ist oftmals bei selbstsignierten Zertifikaten und bei „verketteten Root“-Zertifikaten der Fall, die von einem Root-Zwischenzertifikat ausgestellt wurden, das vom Client nicht anerkannt wird. - -Wenn Sie ein von einer Zertifizierungsstelle (CA) signiertes Zertifikat verwenden, muss die von Ihnen auf {% data variables.product.prodname_ghe_server %} hochgeladene Zertifikatsdatei eine Zertifikatskette mit dem Root-Zertifikat der CA enthalten. Verketten Sie zum Erstellen einer solchen Datei Ihre gesamte Zertifikatskette (oder „Zertifikats-Bundle“) am Ende Ihres Zertifikats, um sicherzustellen, dass das Hauptzertifikat mit Ihrem Hostnamen zuerst angezeigt wird. Auf den meisten Systemen können Sie dazu einen Befehl ausführen, der folgendem ähnelt: - -```shell -$ cat yourdomain.com.crt bundle-certificates.crt > yourdomain.combined.crt -``` - -Sie sollten ein Zertifikats-Bundle (z. B. `bundle-certificates.crt`) von Ihrer Zertifizierungsstelle oder von Ihrem SSL-Anbieter herunterladen können. - -### Selbstsignierte oder Root-Zertifikate von nicht vertrauenswürdigen Zertifizierungsstellen (CA) installieren - -Wenn Ihre {% data variables.product.prodname_ghe_server %}-Appliance mit anderen Maschinen in Ihrem Netzwerk interagiert, die ein selbstsigniertes oder nicht vertrauenswürdiges Zertifikat verwenden, müssen Sie das Root-Zertifikat der signierenden CA in den systemweiten Zertifikatsspeicher importieren, um über HTTPS auf diese Systeme zugreifen zu können. - -1. Rufen Sie das Root-Zertifikat der CA von Ihrer lokalen Zertifizierungsstelle ab, und stellen Sie sicher, dass es im PEM-Format vorliegt. -2. Kopieren Sie über die SSH als der Benutzer „admin“ auf Port 122 die Datei auf Ihre {% data variables.product.prodname_ghe_server %}-Appliance. - ```shell - $ scp -P 122 rootCA.crt admin@HOSTNAME:/home/admin - ``` -3. Stellen Sie über die SSH als der Benutzer „admin“ auf Port 122 eine Verbindung zur {% data variables.product.prodname_ghe_server %}-Verwaltungsshell her. - ```shell - $ ssh -p 122 admin@HOSTNAME - ``` -4. Importieren Sie das Zertifikat in den systemweiten Zertifikatsspeicher. - ```shell - $ ghe-ssl-ca-certificate-install -c rootCA.crt - ``` diff --git a/translations/de-DE/content/admin/installation/updating-the-virtual-machine-and-physical-resources.md b/translations/de-DE/content/admin/installation/updating-the-virtual-machine-and-physical-resources.md deleted file mode 100644 index b51eb27940ad..000000000000 --- a/translations/de-DE/content/admin/installation/updating-the-virtual-machine-and-physical-resources.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: Virtuelle Maschine und physische Ressourcen aktualisieren -intro: 'Sie sollten Ihr Upgrade im Voraus planen, da für das Upgrade der virtuellen Software und virtuellen Hardware eine gewisse Ausfallzeit Ihrer Instanz erforderlich ist.' -redirect_from: - - '/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-the-vm/' - - '/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-physical-resources/' - - /enterprise/admin/installation/updating-the-virtual-machine-and-physical-resources -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/de-DE/content/admin/installation/upgrade-requirements.md b/translations/de-DE/content/admin/installation/upgrade-requirements.md deleted file mode 100644 index db30cad0c168..000000000000 --- a/translations/de-DE/content/admin/installation/upgrade-requirements.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Upgrade-Anforderungen -intro: 'Lesen Sie vor dem Upgrade von {% data variables.product.prodname_ghe_server %} diese Empfehlungen und Anforderungen zum Planen Ihrer Upgrade-Strategie.' -redirect_from: - - /enterprise/admin/guides/installation/finding-the-current-github-enterprise-release/ - - /enterprise/admin/installation/upgrade-requirements -versions: - enterprise-server: '*' ---- - -{% note %} - -**Hinweise:** -- Um ein Upgrade von {% data variables.product.prodname_enterprise %} 11.10.348 bis {% data variables.product.current-340-version %} durchzuführen, müssen Sie zunächst zu {% data variables.product.prodname_enterprise %} 2.1.23 migrieren. Weitere Informationen finden Sie unter „[{% data variables.product.prodname_enterprise %} von 11.10.x zu 2.1.23 migrieren](/enterprise/{{ currentVersion }}/admin/guides/installation/migrating-from-github-enterprise-11-10-x-to-2-1-23)“. -- Upgrade-Pakete stehen unter [enterprise.github.com](https://enterprise.github.com/releases) für unterstützte Versionen zur Verfügung. Verifizieren Sie die Verfügbarkeit der Upgrade-Pakete, die Sie zum Abschließen des Upgrades benötigen. Wenden Sie sich an {% data variables.contact.contact_ent_support %}, falls ein Paket nicht verfügbar ist. -- Wenn Sie {% data variables.product.prodname_ghe_server %} Clustering verwenden, finden Sie im {% data variables.product.prodname_ghe_server %} Clustering-Leitfaden unter „[Cluster-Upgrade](/enterprise/{{ currentVersion }}/admin/guides/clustering/upgrading-a-cluster/)“ Clustering-spezifische Anweisungen. -- Die Versionshinweise für {% data variables.product.prodname_ghe_server %} enthalten eine umfassende Liste der neuen Features jeder Version von {% data variables.product.prodname_ghe_server %}. Weitere Informationen finden Sie auf der [Veröffentlichungsseite](https://enterprise.github.com/releases). - -{% endnote %} - -### Empfehlungen - -- Sie sollten möglichst wenig Upgrades in Ihren Upgrade-Prozess einbeziehen. Anstatt beispielsweise ein Upgrade von {% data variables.product.prodname_enterprise %} {{ enterpriseVersions.supported[2] }} auf {{ enterpriseVersions.supported[1] }} auf {{ enterpriseVersions.latest }} vorzunehmen, können Sie ein Upgrade von {% data variables.product.prodname_enterprise %} {{ enterpriseVersions.supported[2] }} auf {{ enterpriseVersions.latest }} vornehmen. -- Wenn Sie mehrere Versionen zurückliegen, sollten Sie {% data variables.product.product_location_enterprise %} so weit wie möglich mit jedem Schritt Ihres Upgrade-Prozesses upgraden. Wenn Sie die nach Möglichkeit neueste Version für jedes Upgrade verwenden, können Sie von Leistungsverbesserungen und Bug-Korrekturen profitieren. So können Sie beispielsweise ein Upgrade von {% data variables.product.prodname_enterprise %} 2.7 auf 2.8 auf 2.10 vornehmen. Beim Upgrade von {% data variables.product.prodname_enterprise %} 2.7 auf 2.9 auf 2.10 wird im zweiten Schritt jedoch eine neuere Version verwendet. -- Verwenden Sie beim Upgraden die neueste Patch-Veröffentlichung. {% data reusables.enterprise_installation.enterprise-download-upgrade-pkg %} -- Verwenden Sie eine Testinstanz zum Testen der Upgrade-Schritte. Weitere Informationen finden Sie unter „[Testinstanz einrichten](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-staging-instance/)“. -- Warten Sie beim Ausführen mehrerer Upgrades mindestens 24 Stunden zwischen den Feature-Upgrades, damit Datenmigrationen und Upgrade-Hintergrundaufgaben vollständig abgeschlossen werden. - -### Anforderungen - -- Sie müssen ein Upgrade von einer Feature-Veröffentlichung vornehmen, die **höchstens** zwei Versionen zurückliegt. Wenn Sie beispielsweise ein Upgrade auf {% data variables.product.prodname_enterprise %} {{ enterpriseVersions.latest }} vornehmen, müssen Sie {% data variables.product.prodname_enterprise %} {{ enterpriseVersions.supported[1] }} oder {{ enterpriseVersions.supported[2] }} verwenden. -- {% data reusables.enterprise_installation.hotpatching-explanation %} -- Ein Hotpatch kann Ausfallzeiten nach sich ziehen, falls für die betroffenen Dienste (z. B. der Kernel, MySQL oder ElasticSearch) ein VM- oder Dienstneustart erforderlich ist. Sie werden benachrichtigt, falls ein Neustart erforderlich ist. Sie können den Neustart zu einem späteren Zeitpunkt abschließen. -- Beim Upgrade mittels Hotpatching muss zusätzlicher Root-Storage verfügbar sein, da bis zum Abschluss des Upgrades mehrere Versionen bestimmter Dienste installiert werden. Preflight-Checks benachrichtigen Sie, falls nicht genügend Root-Disk-Storage verfügbar ist. -- Beim Upgrade mittels Hotpatching darf Ihre Instanz keine zu große Auslastung aufweisen, da sich dies ggf. auf den Hotpatching-Prozess auswirkt. Bei den Vorflugprüfungen wird die durchschnittliche Auslastung berücksichtigt und das Upgrade schlägt fehl, wenn die durchschnittliche Auslastung zu hoch ist.- Der Upgrade-Vorgang auf {% data variables.product.prodname_ghe_server %} 2.17 migriert Deine Überwachungsprotokolle von Elasticsearch zu MySQL. Diese Migration erhöht die erforderliche Dauer und den Speicherplatz, die bzw. der zum Wiederherstellen eines Snapshots erforderlich ist. Überprüfen Sie vor der Migration die Anzahl an Bytes in Ihren ElasticSearch-Auditprotokollindizes. Führen Sie dazu den folgenden Befehl aus: -``` shell -curl -s http://localhost:9201/audit_log/_stats/store | jq ._all.primaries.store.size_in_bytes -``` -Anhand der Zahl können Sie schätzen, wie viel Speicherplatz die MySQL-Auditprotokolle benötigen werden. Darüber hinaus überwacht das Skript den freien Speicherplatz, während der Import ausgeführt wird. Die Überwachung dieser Zahl ist besonders nützlich, wenn der freie Speicherplatz dem für die Migration erforderlichen Speicherplatz nahekommt. - -Nachdem Sie diese Empfehlungen und Anforderungen gelesen haben, können Sie {% data variables.product.prodname_ghe_server %} upgraden. Weitere Informationen finden Sie unter „[Upgrade von {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-github-enterprise-server/)“. diff --git a/translations/de-DE/content/admin/installation/upgrading-github-enterprise-server.md b/translations/de-DE/content/admin/installation/upgrading-github-enterprise-server.md deleted file mode 100644 index 16ffdeb83d0f..000000000000 --- a/translations/de-DE/content/admin/installation/upgrading-github-enterprise-server.md +++ /dev/null @@ -1,219 +0,0 @@ ---- -title: Upgrade von GitHub Enterprise Server -intro: 'Führen Sie ein {% data variables.product.prodname_ghe_server %}-Upgrade durch, um die neuesten Features und Sicherheitsupdates zu erhalten.' -redirect_from: - - /enterprise/admin/articles/upgrading-to-the-latest-release/ - - /enterprise/admin/articles/migrations-and-upgrades/ - - /enterprise/admin/guides/installation/upgrading-the-github-enterprise-virtual-machine/ - - /enterprise/admin/guides/installation/upgrade-packages-for-older-releases/ - - /enterprise/admin/articles/upgrading-older-installations/ - - /enterprise/admin/hidden/upgrading-older-installations/ - - /enterprise/admin/hidden/upgrading-github-enterprise-using-a-hotpatch-early-access-program/ - - /enterprise/admin/hidden/upgrading-github-enterprise-using-a-hotpatch/ - - /enterprise/admin/guides/installation/upgrading-github-enterprise/ - - /enterprise/admin/installation/upgrading-github-enterprise-server -versions: - enterprise-server: '*' ---- - -### Upgrade vorbereiten - -1. Bestimmen Sie eine Upgrade-Strategie, und wählen Sie eine Version aus, auf die das Upgrade durchgeführt werden soll. Weitere Informationen finden Sie unter „[Upgrade-Anforderungen](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)“. -3. Erstellen Sie mit den {% data variables.product.prodname_enterprise_backup_utilities %} ein neues Backup Ihrer primären Instanz. Weitere Informationen finden Sie in der „[{% data variables.product.prodname_enterprise_backup_utilities %}-Datei 'README.md'](https://github.com/github/backup-utils#readme)“. -4. Wenn Sie mithilfe eines Upgrade-Pakets ein Upgrade durchführen, sollten Sie ein Wartungsfenster für {% data variables.product.prodname_ghe_server %}-Endbenutzer planen. Bei Verwendung eines Hotpatches muss der Wartungsmodus nicht verwendet werden. - - {% note %} - - **Hinweis:** Das Wartungsfenster hängt vom Typ des Upgrades ab, das Sie ausführen. Für Upgrades mittels Hotpatch ist in der Regel kein Wartungsfenster erforderlich. Manchmal ist ein Neustart erforderlich, den Sie später durchführen können. Entsprechend dem Versionierungsschema von MAJOR.FEATURE.PATCH führen Patch-Veröffentlichungen mit einem Upgrade-Paket in der Regel zu weniger als fünf Minuten Ausfallzeit. Feature-Veröffentlichungen mit enthaltenen Datenmigrationen dauern anhand der Speicherleistung und der zu migrierenden Daten entsprechend länger. Weitere Informationen finden Sie unter „[Wartungsmodus aktivieren und planen](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)“. - - {% endnote %} - -### Snapshot erstellen - -Ein Snapshot ist ein Checkpoint einer virtuellen Maschine (VM) zu einem bestimmten Zeitpunkt. Es wird dringend empfohlen, ein Snapshot zu erstellen, bevor Sie Ihre virtuelle Maschine upgraden, damit Sie bei einem Fehlschlagen eines Upgrades Ihre VM auf den Snapshot zurücksetzen können. Wenn Sie ein Upgrade auf eine neue Feature-Veröffentlichung durchführen, müssen Sie einen VM-Snapshot erstellen. Wenn Sie ein Upgrade auf eine Patch-Veröffentlichung durchführen, können Sie die vorhandene Daten-Disk anhängen. - -Es gibt zwei Snapshot-Typen: - -- **VM-Snapshots** speichern den gesamten VM-Zustand, einschließlich der Benutzer- und Konfigurationsdaten. Für diese zeitraubende Snapshot-Methode ist viel Speicherplatz erforderlich. -- **Daten-Disk-Snapshots** speichern nur die Benutzerdaten. - - {% note %} - - **Hinweise:** - - Einige Plattformen ermöglichen es Ihnen nicht, einen Snapshot nur von Ihrer Daten-Disk zu erstellen. Bei diesen Plattformen müssen Sie einen Snapshot der gesamten VM erstellen. - - Wenn von Ihrem Hypervisor keine vollständigen VM-Snapshots unterstützt werden, können Sie in schneller Abfolge einen Snapshot der Root- und Daten-Disk erstellen. - - {% endnote %} - -| Plattform | Snapshot-Methode | URL zur Snapshot-Dokumentation | -| --------------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| Amazon AWS | Disk | | -| Azure | VM | [https://docs.microsoft.com/de-de/azure/backup/backup-azure-vms-first-look-arm](https://azure.microsoft.com/en-us/documentation/articles/backup-azure-vms/) | -| Hyper-V | VM | | -| Google Compute Engine | Disk | | -| VMware | VM | [https://pubs.vmware.com/vsphere-50/topic/com.vmware.wssdk.pg.doc_50/PG_Ch11_VM_Manage.13.3.html](https://pubs.vmware.com/vsphere-50/topic/com.vmware.wssdk.pg.doc_50/PG_Ch11_VM_Manage.13.3.html) | -| XenServer | VM | | - -### Upgrade mit einem Hotpatch - -{% data reusables.enterprise_installation.hotpatching-explanation %} Mit der {% data variables.enterprise.management_console %} können Sie einen Hotpatch sofort installieren oder dessen Installation für einen späteren Zeitpunkt planen. An der Verwaltungsshell können Sie mit dem Dienstprogramm `ghe-upgrade` einen Hotpatch installieren. Weitere Informationen finden Sie unter „[Upgrade-Anforderungen](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)“. - -{% note %} - -**Hinweis:** In Clusterumgebungen ist die Installation eines Hotpatches mittels {% data variables.enterprise.management_console %} nicht verfügbar. Informationen zum Installieren eines Hotpatches in einer Clusterumgebung finden Sie unter „[Cluster-Upgrade](/enterprise/{{ currentVersion }}/admin/clustering/upgrading-a-cluster#upgrading-with-a-hotpatch)“. - -{% endnote %} - -#### Upgrade einer einzelnen Appliance mit einem Hotpatch durchführen - -##### Hotpatch mit der {% data variables.enterprise.management_console %} installieren - -1. Aktivieren Sie automatisch Updates. Weitere Informationen finden Sie unter „[Automatische Updates aktivieren](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-automatic-update-checks/)“. -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.updates-tab %} -4. Verwenden Sie nach dem Download eines neuen Hotpatches das Dropdownmenü für das Installationspaket: - - Wählen Sie zur sofortigen Installation **Now** (Jetzt) aus: - - Wählen Sie für die spätere Installation ein späteres Datum aus.![Dropdownmenü mit Hotpatch-Installationsdatum](/assets/images/enterprise/management-console/hotpatch-installation-date-dropdown.png) -5. Klicken Sie auf **Install** (Installieren). ![Schaltfläche zum Installieren des Hotpatches](/assets/images/enterprise/management-console/hotpatch-installation-install-button.png) - -##### Hotpatch mit der Verwaltungsshell installieren - -{% data reusables.enterprise_installation.download-note %} - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. {% data reusables.enterprise_installation.enterprise-download-upgrade-pkg %} Kopieren Sie die URL für das Upgrade-Hotpackage (Datei *.hpkg*). -{% data reusables.enterprise_installation.download-package %} -4. Führen Sie den Befehl `ghe-upgrade` aus, und verwenden Sie dabei den Paketdateinamen: - ```shell - admin@HOSTNAME:~$ ghe-upgrade GITHUB-UPGRADE.hpkg - *** verifying upgrade package signature... - ``` -5. Wenn für den Kernel, MySQL, ElasticSearch oder andere Programme ein Neustart erforderlich ist, werden Sie vom Hotpatch-Upgrade-Skript dahingehend benachrichtigt. - -#### Upgrade einer über Replikatinstanzen verfügenden Appliance mit einem Hotpatch durchführen - -{% note %} - -**Hinweis:** Zur Installation eines Hotpatches müssen Sie nicht in den Wartungsmodus wechseln oder die Replikation beenden. - -{% endnote %} - -Für die Hochverfügbarkeit und Geo-Replikation konfigurierte Appliances verwenden zusätzlich zu den primären Instanzen Replikatinstanzen. Zum Upgraden dieser Appliances müssen Sie die primäre Instanz und alle Replikatinstanzen nacheinander upgraden. - -##### Upgrade der primären Instanz durchführen - -1. Führen Sie ein Upgrade der primären Instanz durch. Befolgen Sie dazu die unter „[Hotpatch mit der Verwaltungsshell installieren](#installing-a-hotpatch-using-the-administrative-shell)“ beschriebenen Anweisungen. - -##### Upgrade einer Replikatinstanz durchführen - -{% note %} - -**Hinweis:** Wenn Sie als Teil der Geo-Replikation mehrere Replikatinstanzen ausführen, sollten Sie diese Prozedur für jede Replikatinstanz nacheinander wiederholen. - -{% endnote %} - -1. Führen Sie ein Upgrade der Replikatinstanz durch. Befolgen Sie dazu die unter „[Hotpatch mit der Verwaltungsshell installieren](#installing-a-hotpatch-using-the-administrative-shell)“ beschriebenen Anweisungen. Wenn Sie mehrere Replikate für die Geo-Replikation verwenden, müssen Sie diese Prozedur wiederholen, um für jedes Replikat nacheinander ein Upgrade durchzuführen. -{% data reusables.enterprise_installation.replica-ssh %} -{% data reusables.enterprise_installation.replica-verify %} - -### Upgrade mit einem Upgrade-Paket - -Obwohl Sie einen Hotpatch verwenden können, um ein Upgrade auf die neueste Patch-Veröffentlichung in einer Featureserie durchzuführen, müssen Sie ein Upgrade-Paket verwenden, um ein Upgrade auf eine neuere Feature-Veröffentlichung durchzuführen. Wenn Sie beispielsweise ein Upgrade von `2.11.10` auf `2.12.4` durchführen möchten, müssen Sie ein Upgrade-Paket verwenden, da es sich um unterschiedliche Featureserien handelt. Weitere Informationen finden Sie unter „[Upgrade-Anforderungen](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)“. - -#### Upgrade einer einzelnen Appliance mit einem Upgrade-Paket durchführen - -{% data reusables.enterprise_installation.download-note %} - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. {% data reusables.enterprise_installation.enterprise-download-upgrade-pkg %} Wählen Sie die entsprechende Plattform aus, und kopieren Sie die URL für das Upgrade-Paket (Datei *.pkg*). -{% data reusables.enterprise_installation.download-package %} -4. Aktivieren Sie den Wartungsmodus, und warten Sie, bis alle aktiven Prozesse auf der {% data variables.product.prodname_ghe_server %}-Instanz abgeschlossen sind. Weitere Informationen finden Sie unter „[Wartungsmodus aktivieren und planen](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)“. - - {% note %} - - **Hinweis**: Wenn Sie in einer Hochverfügbarkeitskonfiguration ein Upgrade der primären Appliance durchführen, sollte sich die Appliance bereits im Wartungsmodus befinden, sofern Sie die unter „[Upgrade der primären Instanz durchführen](#upgrading-the-primary-instance)“ beschriebenen Anweisungen befolgen. - - {% endnote %} - -5. Führen Sie den Befehl `ghe-upgrade` aus, und verwenden Sie dabei den Paketdateinamen: - ```shell - admin@HOSTNAME:~$ ghe-upgrade GITHUB-UPGRADE.pkg - *** verifying upgrade package signature... - ``` -6. Bestätigen Sie, dass Sie das Upgrade fortsetzen möchten, und führen Sie nach der Überprüfung der Paketsignatur einen Neustart durch. Das neue Root-Dateisystem schreibt in die sekundäre Partition, und die Instanz startet automatisch im Wartungsmodus neu: - ```shell - *** applying update... - This package will upgrade your installation to version version-number - Current root partition: /dev/xvda1 [version-number] - Target root partition: /dev/xvda2 - Proceed with installation? [y/N] - ``` -7. Deaktivieren Sie bei einzelnen Appliance-Upgrades den Wartungsmodus, damit Benutzer {% data variables.product.product_location_enterprise %} verwenden können. - - {% note %} - - **Hinweis**: Wenn Sie in einer Hochverfügbarkeitskonfiguration ein Upgrade der Appliances durchführen, sollten Sie im Wartungsmodus bleiben, bis ein Upgrade sämtlicher Replikate durchgeführt wurde und die Replikation aktuell ist. Weitere Informationen finden Sie unter „[Upgrade einer Replikatinstanz durchführen](#upgrading-a-replica-instance)“. - - {% endnote %} - -#### Upgrade einer über Replikatinstanzen verfügenden Appliance mit einem Upgrade-Paket durchführen - -Für die Hochverfügbarkeit und Geo-Replikation konfigurierte Appliances verwenden zusätzlich zu den primären Instanzen Replikatinstanzen. Zum Upgraden dieser Appliances müssen Sie die primäre Instanz und alle Replikatinstanzen nacheinander upgraden. - -##### Upgrade der primären Instanz durchführen - -{% warning %} - -**Warnung:** Wenn die Replikation angehalten wird, geht im Falle eines Fehlschlagens der primären Instanz die Arbeit verloren, die vor dem Upgrade des Replikats und dem Start der Replikation erledigt wird. - -{% endwarning %} - -1. Aktivieren Sie auf der primären Instanz den Wartungsmodus, und warten Sie auf den Abschluss sämtlicher aktiver Prozesse. Weitere Informationen finden Sie unter „[Wartungsmodus aktivieren](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode/)“. -{% data reusables.enterprise_installation.replica-ssh %} -3. Führen Sie auf der Replikatinstanz oder auf allen Replikatinstanzen, falls Sie als Teil der Geo-Replikation mehrere Replikatinstanzen ausführen, den Befehl `ghe-repl-stop` zum Anhalten der Replikation aus. -4. Führen Sie ein Upgrade der primären Instanz durch. Befolgen Sie dazu die unter „[Upgrade einer einzelnen Appliance mit einem Upgrade-Paket durchführen](#upgrading-a-single-appliance-with-an-upgrade-package)“ beschriebenen Anweisungen. - -##### Upgrade einer Replikatinstanz durchführen - -{% note %} - -**Hinweis:** Wenn Sie als Teil der Geo-Replikation mehrere Replikatinstanzen ausführen, sollten Sie diese Prozedur für jede Replikatinstanz nacheinander wiederholen. - -{% endnote %} - -1. Führen Sie ein Upgrade der Replikatinstanz durch. Befolgen Sie dazu die unter „[Upgrade einer einzelnen Appliance mit einem Upgrade-Paket durchführen](#upgrading-a-single-appliance-with-an-upgrade-package)“ beschriebenen Anweisungen. Wenn Sie mehrere Replikate für die Geo-Replikation verwenden, müssen Sie diese Prozedur wiederholen, um für jedes Replikat nacheinander ein Upgrade durchzuführen. -{% data reusables.enterprise_installation.replica-ssh %} -{% data reusables.enterprise_installation.replica-verify %} - -{% data reusables.enterprise_installation.start-replication %} - -{% data reusables.enterprise_installation.replication-status %} Wenn der Befehl `Replication is not running` zurückgibt, wird die Replikation möglicherweise noch gestartet. Warten Sie etwa eine Minute, bevor Sie `ghe-repl-status` erneut ausführen. - - {% note %} - - **Hinweis:** Während die erneute Synchronisierung verarbeitet wird, gibt der Befehl „ghe-repl-status“ ggf. erwartete Meldungen dahingehend zurück, dass die Replikation im Rückstand ist. - Zum Beispiel: `CRITICAL: git replication is behind the primary by more than 1007 repositories and/or gists` - - {% endnote %} - - Falls der Befehl `ghe-repl-status` nicht den Wert `OK` zurückgibt, sollten Sie die folgenden Schritte befolgen, um die Replikation manuell neu zu starten. - - 1. Führen Sie auf der Replikatinstanz den Befehl `ghe-repl-setup ` erneut aus. - {% data reusables.enterprise_installation.start-replication %} - {% data reusables.enterprise_installation.replication-status %} -6. Deaktivieren Sie nach dem Upgrade-Abschluss des letzten Replikats und nach dem Abschluss der erneuten Synchronisierung den Wartungsmodus, damit Benutzer {% data variables.product.product_location_enterprise %} verwenden können. - -### Wiederherstellung nach einem fehlgeschlagenen Upgrade - -Wenn ein Upgrade fehlschlägt oder unterbrochen wird, sollten Sie Ihre Instanz in ihren vorherigen Zustand zurücksetzen. Der entsprechende Prozess hängt vom Upgrade-Typ ab. - -#### Rollback einer Patch-Veröffentlichung durchführen - -Führen Sie den Befehl `ghe-upgrade` mit der Option `--allow-patch-rollback` aus, um ein Rollback einer Patch-Veröffentlichung durchzuführen. {% data reusables.enterprise_installation.command-line-utilities-ghe-upgrade-rollback %} - -Weitere Informationen finden Sie unter „[Befehlszeilenprogramme](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities/#ghe-upgrade)“. - -#### Rollback einer Feature-Veröffentlichung durchführen - -Um ein Rollback von einer Feature-Veröffentlichung durchzuführen, stellen Sie diese über einen VM-Snapshot wieder her, um sicherzustellen, dass die Root- und Datenpartitionen einen konsistenten Zustand aufweisen. Weitere Informationen finden Sie unter „[Snapshot erstellen](#taking-a-snapshot)“. diff --git a/translations/de-DE/content/admin/installation/using-github-enterprise-server-with-a-load-balancer.md b/translations/de-DE/content/admin/installation/using-github-enterprise-server-with-a-load-balancer.md deleted file mode 100644 index 168033e6224a..000000000000 --- a/translations/de-DE/content/admin/installation/using-github-enterprise-server-with-a-load-balancer.md +++ /dev/null @@ -1,54 +0,0 @@ ---- -title: GitHub Enterprise Server mit einem Load-Balancer verwenden -intro: 'Verwenden Sie einen Load-Balancer vor einer einzelnen {% data variables.product.prodname_ghe_server %}-Appliance oder einem Paar an Appliances in einer Hochverfügbarkeitskonfiguration.' -redirect_from: - - /enterprise/admin/guides/installation/using-github-enterprise-with-a-load-balancer/ - - /enterprise/admin/installation/using-github-enterprise-server-with-a-load-balancer -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_clustering.load_balancer_intro %} - -{% data reusables.enterprise_clustering.load_balancer_dns %} - -### Clientverbindungsinformationen verarbeiten - -Da Clientverbindungen zu {% data variables.product.prodname_ghe_server %} vom Load-Balancer stammen, kann die Client-IP-Adresse verloren gehen. - -{% data reusables.enterprise_clustering.proxy_preference %} - -{% data reusables.enterprise_clustering.proxy_xff_firewall_warning %} - -#### PROXY-Protokollunterstützung auf {% data variables.product.product_location_enterprise %} aktivieren - -Es wird dringend empfohlen, die PROXY-Protokollunterstützung für Ihre Appliance und für den Load-Balancer zu aktivieren. Befolgen Sie die Anweisungen Ihres Anbieters, um das PROXY-Protokoll auf Ihrem Load-Balancer zu aktivieren. Weitere Informationen finden Sie in der Dokumentation zum „[PROXY-Protokoll](http://www.haproxy.org/download/1.6/doc/proxy-protocol.txt)“. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -3. Wählen Sie **Enable support for PROXY protocol** (Unterstützung für PROXY-Protokoll aktivieren) unter **External load balancers** (Externe Load-Balancer) aus. ![Kontrollkästchen zum Aktivieren der Unterstützung für das PROXY-Protokoll](/assets/images/enterprise/management-console/enable-proxy.png) -{% data reusables.enterprise_management_console.save-settings %} - -{% data reusables.enterprise_clustering.proxy_protocol_ports %} - -#### X-Forwarded-For-Unterstützung auf {% data variables.product.product_location_enterprise %} aktivieren - -{% data reusables.enterprise_clustering.x-forwarded-for %} - -{% data reusables.enterprise_installation.terminating-tls %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -3. Wählen Sie **Allow HTTP X-Forwarded-For header** (HTTP X-Forwarded-For-Header zulassen) unter **External load balancers** (Externe Load-Balancer) aus. ![Kontrollkästchen zum Zulassen des HTTP X-Forwarded-For-Header](/assets/images/enterprise/management-console/allow-xff.png) -{% data reusables.enterprise_management_console.save-settings %} - -{% data reusables.enterprise_clustering.without_proxy_protocol_ports %} - -### Zustandsprüfungen konfigurieren - -Zustandsprüfungen ermöglichen einem Load-Balancer, das Senden von Traffic an einen nicht antwortenden Knoten zu stoppen, wenn eine vorkonfigurierte Prüfung auf diesem Knoten fehlschlägt. Wenn die Appliance aufgrund einer Wartung oder eines unerwarteten Ausfalls offline ist, kann der Load-Balancer eine Statusseite anzeigen. In einer Hochverfügbarkeitskonfiguration (HA) kann ein Load-Balancer als Bestandteil einer Failover-Strategie verwendet werden. Das automatische Failover von HA-Paaren wird jedoch nicht unterstützt. Sie müssen die Replikat-Appliance manuell hochstufen, bevor sie Anforderungen verarbeitet. Weitere Informationen finden Sie unter „[{% data variables.product.prodname_ghe_server %} für Hochverfügbarkeit konfigurieren](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-github-enterprise-server-for-high-availability/)“. - -{% data reusables.enterprise_clustering.health_checks %} -{% data reusables.enterprise_site_admin_settings.maintenance-mode-status %} diff --git a/translations/de-DE/content/admin/installation/validating-your-domain-settings.md b/translations/de-DE/content/admin/installation/validating-your-domain-settings.md deleted file mode 100644 index 0cde2b2c9c7b..000000000000 --- a/translations/de-DE/content/admin/installation/validating-your-domain-settings.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: Ihre Domain-Einstellungen validieren -intro: 'Stellen Sie sicher, dass Ihre Domain-Einstellungen ordnungsgemäß konfiguriert sind, bevor Sie {% data variables.product.product_location_enterprise %} erstmals starten.' -redirect_from: - - /enterprise/admin/installation/validating-your-domain-settings -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.hostname-menu-item %} -4. Klicken Sie zum Testen der DNS- und SSL-Einstellungen Ihrer Appliance auf **Test domain settings** (Domain-Einstellungen testen). ![Schaltfläche zum Testen der Domain-Einstellungen](/assets/images/enterprise/management-console/test-domain-settings.png) -{% data reusables.enterprise_management_console.test-domain-settings-failure %} -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/de-DE/content/admin/installation/viewing-push-logs.md b/translations/de-DE/content/admin/installation/viewing-push-logs.md deleted file mode 100644 index 53293a1a0c27..000000000000 --- a/translations/de-DE/content/admin/installation/viewing-push-logs.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: Push-Protokolle anzeigen -intro: 'Websiteadministratoren können eine Liste der Git-Push-Vorgänge für Repositorys auf {% data variables.product.product_location_enterprise %} anzeigen.' -redirect_from: - - /enterprise/admin/articles/viewing-push-logs/ - - /enterprise/admin/installation/viewing-push-logs -versions: - enterprise-server: '*' ---- - -Push-Protokolleinträge zeigen: - -- Wer den Push-Vorgang initiiert hat -- Ob es ein erzwungener Push-Vorgang war -- Den Branch, an den Elemente per Push-Vorgang übertragen wurden -- Das für den Push-Vorgang verwendete Protokoll -- Die IP-Quelladresse -- Der für den Push-Vorgang verwendete Git-Client -- Die SHA-Hashes vor und nach dem Vorgang - -### Push-Protokolle eines Repositorys anzeigen - -1. Navigieren Sie zu einem Repository. -{% data reusables.enterprise_site_admin_settings.access-settings %} -3. Klicken Sie in der oberen rechte Ecke der Seite auf {% octicon "shield" aria-label="The shield" %} **Security** (Sicherheit). ![Registerkarte „Security“ (Sicherheit)](/assets/images/enterprise/site-admin-settings/repo/repo-security-top-tab.png) -4. Klicken Sie auf der linken Seitenleiste auf **Push Log** (Push-Protokoll). ![Registerkarte „Push log“ (Push-Protokoll)](/assets/images/enterprise/site-admin-settings/push-log-tab.png) - -### Push-Protokolle eines Repositorys an der Befehlszeile anzeigen - -1. Stellen Sie eine SSH-Verbindung zu Ihrer Appliance her. Weitere Informationen finden Sie unter „[Auf die Verwaltungsshell (SSH) zugreifen](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-administrative-shell-ssh/)“. -2. Öffnen Sie im entsprechenden Git-Repository die Auditprotokolldatei: - ```shell - ghe-repo owner/repository -c "less audit_log" - ``` diff --git a/translations/de-DE/content/admin/migrations/about-migrations.md b/translations/de-DE/content/admin/migrations/about-migrations.md deleted file mode 100644 index e6df7fe304e0..000000000000 --- a/translations/de-DE/content/admin/migrations/about-migrations.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: Informationen zu Migrationen -intro: 'Bei einer Migration werden Daten von einem *Quell*speicherort (eine {% data variables.product.prodname_dotcom_the_website %}-Organisation oder eine {% data variables.product.prodname_ghe_server %}-Instanz) an eine {% data variables.product.prodname_ghe_server %}-*Ziel*instanz übertragen. Migrationen können verwendet werden, um Ihre Daten zu übertragen, wenn Sie Plattformen ändern oder Hardware auf Ihrer Instanz upgraden.' -redirect_from: - - /enterprise/admin/migrations/about-migrations -versions: - enterprise-server: '*' ---- - -### Migrationstypen - -Es gibt drei Migrationstypen, die von Ihnen durchgeführt werden können: - -- eine Migration von einer {% data variables.product.prodname_ghe_server %}-Instanz zu einer anderen {% data variables.product.prodname_ghe_server %}-Instanz. Sie können eine beliebige Anzahl an Repositorys migrieren, die einem Benutzer oder einer Organisation auf der Instanz gehören. Vor dem Durchführen einer Migration müssen Sie über Websiteadministratorzugriff auf beide Instanzen verfügen. -- eine Migration von einer {% data variables.product.prodname_dotcom_the_website %}-Organisation zu einer {% data variables.product.prodname_ghe_server %}-Instanz. Sie können eine beliebige Anzahl an Repositorys migrieren, die einer Organisation gehören. Vor dem Durchführen einer Migration müssen Sie über [Verwaltungszugriff](/enterprise/user/articles/permission-levels-for-an-organization/) auf die {% data variables.product.prodname_dotcom_the_website %}-Organisation und über Websiteadministratorzugriff auf die Zielinstanz verfügen. -- Bei *Probeläufen* handelt es sich um Migrationen, bei denen Daten in eine [Testinstanz](/enterprise/admin/guides/installation/setting-up-a-staging-instance/) importiert werden. Mit diesen kann nachvollzogen werden, was passieren *würde*, wenn eine Migration auf {% data variables.product.product_location_enterprise %} angewendet werden würde. **Es wird dringend empfohlen, dass Sie einen Probelauf auf einer Testinstanz durchführen, bevor Sie Daten in Ihre Produktionsinstanz importieren.** - -### Migrierte Daten - -In einer Migration dreht sich alles um ein Repository. Die meisten einem Repository zugeordneten Daten können migriert werden. Beispielsweise migriert ein Repository in einer Organisation das Repository *und* die Organisation sowie die dem Repository zugeordneten Benutzer, Teams, Issues und Pull Requests. - -Die Elemente in der folgenden Tabelle können mit einem Repository migriert werden. Elemente, die nicht in der Liste der migrierten Daten angezeigt werden, können nicht migriert werden. - -{% data reusables.enterprise_migrations.fork-persistence %} - -| Einem migrierten Repository zugeordnete Daten | Hinweise: | -| -------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Benutzer | **@Erwähnungen** von Benutzern werden neu geschrieben, um dem Ziel zu entsprechen. | -| Organisationen | Der Name und die Details einer Organisation werden migriert. | -| Repositorys | Links zu Git-Strukturen, Blobs, Commits und Zeilen werden neu geschrieben, um dem Ziel zu entsprechen. Der Migrator folgt maximal drei Repository-Umleitungen. | -| Wikis | Alle Wiki-Daten werden migriert. | -| Teams | **@Erwähnungen** von Teams werden neu geschrieben, um dem Ziel zu entsprechen. | -| Meilensteine | Zeitstempel werden beibehalten. | -| Projektboards | Projektboards, die dem Repository und der Organisation, welcher das Repository gehört, zugeordnet sind, werden migriert. | -| Issues | Issue-Verweise und Zeitstempel werden beibehalten. | -| Issue-Kommentare | Querverweise auf Kommentare werden für die Zielinstanz neu geschrieben. | -| Pull Requests | Querverweise auf Pull Request werden neu geschrieben, um dem Ziel zu entsprechen. Zeitstempel werden beibehalten. | -| Pull-Request-Reviews | Pull-Request-Reviews und zugeordnete Daten werden migriert. | -| Pull-Request-Review-Kommentare | Querverweise auf Kommentare werden für die Zielinstanz neu geschrieben. Zeitstempel werden beibehalten. | -| Commit-Kommentare | Querverweise auf Kommentare werden für die Zielinstanz neu geschrieben. Zeitstempel werden beibehalten. | -| Veröffentlichungen | Die Daten sämtlicher Versionen werden migriert. | -| Bei Pull Requests oder Issues ergriffene Maßnahmen | Alle Änderungen an Pull Requests oder Issues, beispielsweise das Zuweisen von Benutzern, das Umbenennen von Titeln und das Ändern von Kennzeichnungen, werden zusammen mit den Zeitstempeln für die jeweilige Aktion beibehalten. | -| Dateianhänge | [Dateianhänge für Issues und Pull Requests](/articles/file-attachments-on-issues-and-pull-requests) werden migriert. Sie können diese als Bestandteil der Migration deaktivieren. | -| Webhooks | Nur aktive Webhooks werden migriert. | -| Repository-Deployment-Schlüssel | Repository-Deployment-Schlüssel werden migriert. | -| geschützte Branches | Die Einstellungen für geschützte Branches und die zugeordneten Daten werden migriert. | diff --git a/translations/de-DE/content/admin/migrations/applying-the-imported-data-on-github-enterprise-server.md b/translations/de-DE/content/admin/migrations/applying-the-imported-data-on-github-enterprise-server.md deleted file mode 100644 index f182c822518d..000000000000 --- a/translations/de-DE/content/admin/migrations/applying-the-imported-data-on-github-enterprise-server.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Importierte Daten auf GitHub Enterprise Server anwenden -intro: Nach Abschluss der Überprüfung der Migrationsdaten können Sie die Änderungen dauerhaft auf Ihre Zielinstanz anwenden. -redirect_from: - - /enterprise/admin/guides/migrations/applying-the-imported-data-on-github-enterprise/ - - /enterprise/admin/migrations/applying-the-imported-data-on-github-enterprise-server -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_installation.ssh-into-target-instance %} - -2. Führen Sie den Befehl `ghe-migrator import` aus, um den Importprozess zu starten. Sie benötigen Folgendes: - * Ihren Migrations-GUID. - * Dein persönliches Zugangs-Token für die Authentifizierung. Das persönliche Zugriffstoken, das Du verwendest, dient nur der Authentifizierung als Website-Administrator und erfordert keinen bestimmten „Scope“ (Geltungsbereich). For more information, see "[Creating a personal access token](/github/authenticating-to-github/creating-a-personal-access-token)." - - ```shell - $ ghe-migrator import /home/admin/MIGRATION_GUID.tar.gz -g MIGRATION_GUID -u username -p TOKEN - - > Starting GitHub::Migrator - > Import 100% complete / - ``` - - * {% data reusables.enterprise_migrations.specify-staging-path %} diff --git a/translations/de-DE/content/admin/migrations/completing-the-import-on-github-enterprise-server.md b/translations/de-DE/content/admin/migrations/completing-the-import-on-github-enterprise-server.md deleted file mode 100644 index 9529e002871f..000000000000 --- a/translations/de-DE/content/admin/migrations/completing-the-import-on-github-enterprise-server.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Import auf GitHub Enterprise Server abschließen -intro: 'Nachdem Ihre Migration auf Ihre Zielinstanz angewendet wurde und Sie die Migration überprüft haben, entsperren Sie die Repositorys, und löschen Sie sie von der Quelle. Vor dem Löschen Ihrer Quelldaten sollten Sie etwa zwei Wochen warten, um sicherzugehen, dass alles erwartungsgemäß funktioniert.' -redirect_from: - - /enterprise/admin/guides/migrations/completing-the-import-on-github-enterprise/ - - /enterprise/admin/migrations/completing-the-import-on-github-enterprise-server -versions: - enterprise-server: '*' ---- - -### Repositorys auf der Zielinstanz entsperren - -{% data reusables.enterprise_installation.ssh-into-instance %} -{% data reusables.enterprise_migrations.unlocking-on-instances %} - -### Repositorys auf der Quellinstanz entsperren - -#### Repositorys auf einer {% data variables.product.prodname_dotcom_the_website %}-Organisation entsperren - -Um die Repositorys in einer {% data variables.product.prodname_dotcom_the_website %}-Organisation zu entsperren, senden Sie eine `DELETE`-Anforderung an den Endpunkt zum Entsperren der Migration. Sie benötigen Folgendes: - * Ihr Zugriffstoken für die Authentifizierung - * die eindeutige `ID` der Migration - * den Namen des zu entsperrenden Repositorys -```shell -curl -H "Authorization: token GITHUB_ACCESS_TOKEN" -X DELETE \ - -H "Accept: application/vnd.github.wyandotte-preview+json" \ - https://api.github.com/orgs/orgname/migrations/id/repos/repo_name/lock -``` - -#### Repositorys aus einer {% data variables.product.prodname_dotcom_the_website %}-Organisation löschen - -After unlocking the {% data variables.product.prodname_dotcom_the_website %} organization's repositories, you should delete every repository you previously migrated using [the repository delete endpoint](/enterprise/{{ currentVersion }}/v3/repos/#delete-a-repository). Sie benötigen Ihr Zugriffstoken für die Authentifizierung: -```shell -curl -H "Authorization: token GITHUB_ACCESS_TOKEN" -X DELETE \ - https://api.github.com/repos/orgname/repo_name -``` - -#### Repositorys auf einer {% data variables.product.prodname_ghe_server %}-Instanz entsperren - -{% data reusables.enterprise_installation.ssh-into-instance %} -{% data reusables.enterprise_migrations.unlocking-on-instances %} diff --git a/translations/de-DE/content/admin/migrations/exporting-migration-data-from-github-enterprise-server.md b/translations/de-DE/content/admin/migrations/exporting-migration-data-from-github-enterprise-server.md deleted file mode 100644 index d283e824ee4a..000000000000 --- a/translations/de-DE/content/admin/migrations/exporting-migration-data-from-github-enterprise-server.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Migrationsdaten von GitHub Enterprise Server exportieren -intro: 'Um Migrationsdaten von einer {% data variables.product.prodname_ghe_server %}-Instanz zu exportieren, müssen Sie die Instanz vorbereiten, die Repositorys sperren und ein Migrationsarchiv generieren. Sie sollten Daten von einer {% data variables.product.prodname_ghe_server %}-Instanz exportieren, wenn Sie vorhaben, die Plattformen zu wechseln, oder wenn Sie von einer Testinstanz auf eine Produktionsinstanz umsteigen möchten.' -redirect_from: - - /enterprise/admin/guides/migrations/exporting-migration-data-from-github-enterprise/ - - /enterprise/admin/migrations/exporting-migration-data-from-github-enterprise-server -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/de-DE/content/admin/migrations/exporting-migration-data-from-githubcom.md b/translations/de-DE/content/admin/migrations/exporting-migration-data-from-githubcom.md deleted file mode 100644 index 60e574caf71b..000000000000 --- a/translations/de-DE/content/admin/migrations/exporting-migration-data-from-githubcom.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Migrationsdaten von GitHub.com exportieren -intro: 'Um Migrationsdaten von einer {% data variables.product.prodname_dotcom_the_website %}-Organisation zu exportieren, müssen Sie die API verwenden, um die zu migrierenden Repositorys auszuwählen. Danach generieren Sie ein Migrationsarchiv, das Sie in eine {% data variables.product.prodname_ghe_server %}-Instanz importieren können.' -redirect_from: - - /enterprise/admin/guides/migrations/exporting-migration-data-from-github-com - - /enterprise/admin/migrations/exporting-migration-data-from-githubcom -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/de-DE/content/admin/migrations/exporting-the-github-enterprise-server-source-repositories.md b/translations/de-DE/content/admin/migrations/exporting-the-github-enterprise-server-source-repositories.md deleted file mode 100644 index e0846768e272..000000000000 --- a/translations/de-DE/content/admin/migrations/exporting-the-github-enterprise-server-source-repositories.md +++ /dev/null @@ -1,84 +0,0 @@ ---- -title: GitHub Enterprise Server-Quell-Repositorys exportieren -intro: 'Nachdem Sie die Quell-Repositorys gesperrt haben, können Sie sie einzeln oder per Massenvorgang exportieren, indem Sie eine Liste von Repository-URLs in einer Textdatei verwenden. Für den Importprozess erstellen Sie anschließend ein einzelnes Migrationsarchiv.' -redirect_from: - - /enterprise/admin/guides/migrations/exporting-the-github-enterprise-source-repositories/ - - /enterprise/admin/migrations/exporting-the-github-enterprise-server-source-repositories -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_migrations.locking-repositories %} - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. Führen Sie den Befehl `ghe-migrator add` mit der URL des Repositorys aus, um ein Repository auf den Export vorzubereiten: - * Hängen Sie beim Sperren des Repositorys dem Befehl `--lock` an. Wenn Sie einen Probelauf ausführen, ist `--lock` nicht erforderlich. - ```shell - $ ghe-migrator add https://hostname/username/reponame --lock - ``` - * Dateianhänge können ausgeschlossen werden. Hängen Sie dazu dem Befehl `--exclude_attachments` an. {% data reusables.enterprise_migrations.exclude-file-attachments %} - * Um mehrere Repositorys gleichzeitig für den Export vorzubereiten, erstellen Sie eine Textdatei, in der die URL jedes Repositorys in einer separaten Zeile aufgelistet wird, und führen Sie den Befehl `ghe-migrator add` mit dem Flag `-i` und dem Pfad zu Ihrer Textdatei aus. - ```shell - $ ghe-migrator add -i PATH/TO/YOUR/REPOSITORY_URLS.txt - ``` - -3. Geben Sie Ihren {% data variables.product.prodname_ghe_server %}-Benutzernamen ein, wenn Sie dazu aufgefordert werden: - ```shell - Enter username authorized for migration: admin - ``` -4. Geben Sie das unter „[{% data variables.product.prodname_ghe_server %}-Quellinstanz vorbereiten](/enterprise/admin/guides/migrations/preparing-the-github-enterprise-server-source-instance/)“ von Ihnen erstellte Zugriffstoken ein, wenn Sie zur Eingabe eines persönlichen Zugriffstokens aufgefordert werden: - ```shell - Enter personal access token: ************** - ``` -5. Nach Abschluss des Befehls `ghe-migrator add` werden der eindeutige zum Identifizieren dieses Exports generierte „Migrations-GUID“ und eine Liste der dem Export hinzugefügten Ressourcen ausgegeben. Diesen generierten Migrations-GUID verwenden Sie in den nachfolgenden Schritten `ghe-migrator add` und `ghe-migrator export`, um `ghe-migrator` anzuweisen, weiterhin am selben Export zu arbeiten. - ```shell - > 101 models added to export - > Migration GUID: example-migration-guid - > Number of records in this migration: - > users | 5 - > organizations | 1 - > repositories | 1 - > teams | 3 - > protected_branches | 1 - > pull_request_reviews | 1 - > milestones | 1 - > issues | 3 - > pull_requests | 5 - > pull_request_review_comments | 4 - > commit_comments | 2 - > issue_comments | 10 - > issue_events | 63 - > releases | 3 - > attachments | 4 - > projects | 2 - ``` - Sobald Sie ein neues Repository mit einem vorhandenen Migrations-GUID hinzufügen, wird der vorhandene Export aktualisiert. Wenn Sie `ghe-migrator add` erneut ausführen, ohne einen Migrations-GUID zu verwenden, wird ein neuer Export gestartet und ein neuer Migrations-GUID generiert. **Verwenden Sie nicht den während eines Exports generierten Migrations-GUID, wenn Sie Ihre Migration auf den Import vorbereiten**. - -3. Falls Sie das Quell-Repository gesperrt haben, können Sie den Befehl `ghe-migrator target_url` ausführen, um eine benutzerdefinierte Sperrmeldung auf der Repository-Seite festzulegen, die auf den neuen Speicherort des Repositorys verweist. Geben Sie die URL des Quell-Repositorys, die URL des Ziel-Repositorys und den Migrations-GUID aus Schritt 5 weiter: - - ```shell - $ ghe-migrator target_url https://hostname/username/reponame https://target_hostname/target_username/target_reponame -g MIGRATION_GUID - ``` - -6. Führen Sie den Befehl `ghe-migrator add` mit dem Flag `-g` aus, um demselben Export weitere Repositorys hinzuzufügen. Sie übergeben die URL des neuen Repositorys und den Migrations-GUID aus Schritt 5: - ```shell - $ ghe-migrator add https://hostname/username/other_reponame -g MIGRATION_GUID --lock - ``` -7. Generieren Sie nach dem Hinzufügen der Repositorys mit dem Befehl `ghe-migrator export` und dem Flag `-g` sowie dem Migrations-GUID aus Schritt 5 das Migrationsarchiv: - ```shell - $ ghe-migrator export -g MIGRATION_GUID - > Archive saved to: /data/github/current/tmp/MIGRATION_GUID.tar.gz - ``` - * {% data reusables.enterprise_migrations.specify-staging-path %} - -8. Schließen Sie die Verbindung zu {% data variables.product.product_location_enterprise %}: - ```shell - $ exit - > logout - > Connection to hostname closed. - ``` -9. Führen Sie den Befehl [`scp`](https://linuxacademy.com/blog/linux/ssh-and-scp-howto-tips-tricks#scp) aus, um das Migrationsarchiv auf Ihren Computer zu kopieren. Die Archivdatei wird mit dem Migrations-GUID benannt: - ```shell - $ scp -P 122 admin@hostname:/data/github/current/tmp/MIGRATION_GUID.tar.gz ~/Desktop - ``` -{% data reusables.enterprise_migrations.ready-to-import-migrations %} diff --git a/translations/de-DE/content/admin/migrations/exporting-the-githubcom-organizations-repositories.md b/translations/de-DE/content/admin/migrations/exporting-the-githubcom-organizations-repositories.md deleted file mode 100644 index 1b43a994842b..000000000000 --- a/translations/de-DE/content/admin/migrations/exporting-the-githubcom-organizations-repositories.md +++ /dev/null @@ -1,70 +0,0 @@ ---- -title: Repositorys der GitHub.com-Organisation exportieren -intro: 'Mit der API für Migrationen können Sie die Repositorys einer Organisation exportieren. Nach dem Exportieren Ihrer Repositorys laden Sie das Migrationsarchiv herunter, das für den Importprozess verwendet wird.' -redirect_from: - - /enterprise/admin/guides/migrations/exporting-the-github-com-organization-s-repositories - - /enterprise/admin/migrations/exporting-the-githubcom-organizations-repositories -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_migrations.fork-persistence %} - -Verwenden Sie die API für Migrationen, um Repository-Daten von {% data variables.product.prodname_dotcom_the_website %} zu exportieren. - -Die API für Migrationen befindet sich derzeit in einer Vorschauphase, weshalb sich die Endpunkte und Parameter künftig ändern können. Um auf die API für Migrationen zuzugreifen, müssen Sie einen benutzerdefinierten [Medientyp](/v3/media) im Header `Accept` angeben: `application/vnd.github.wyandotte-preview+json`. Die folgenden Beispiele enthalten den benutzerdefinierten Medientyp. - -### Migrationsarchiv generieren - -{% data reusables.enterprise_migrations.locking-repositories %} - -1. Benachrichtigen Sie die Mitglieder Ihrer Organisation, dass Sie eine Migration durchführen werden. Der Export kann entsprechend der Anzahl der zu exportierenden Repositorys mehrere Minuten dauern. Die vollständige Migration, einschließlich des Imports, dauert ggf. mehrere Stunden. Daher wird empfohlen, einen Probelauf durchzuführen, um die Länge des vollständigen Prozesses ermitteln zu können. Weitere Informationen finden Sie unter „[Informationen zu Migrationen](/enterprise/admin/migrations/about-migrations#types-of-migrations)“. - -2. Starten Sie eine Migration. Senden Sie dazu eine `POST`-Anforderung an den Migrationsendpunkt. Sie benötigen Folgendes: - * Ihr Zugriffstoken für die Authentifizierung. - * Eine [Liste der Repositorys](/v3/repos/#list-organization-repositories), die migriert werden sollen: - ```shell - curl -H "Authorization: token GITHUB_ACCESS_TOKEN" -X POST \ - -H "Accept: application/vnd.github.wyandotte-preview+json" \ - -d'{"lock_repositories":true,"repositories":["orgname/reponame", "orgname/reponame"]}' \ - https://api.github.com/orgs/orgname/migrations - ``` - * Wenn Sie die Repositorys sperren möchten, bevor Sie sie migrieren, stellen Sie sicher, dass `lock_repositories` auf `true` festgelegt ist. Dies wird dringend empfohlen. - * Dateianhänge können ausgeschlossen werden. Übergeben Sie dazu `exclude_attachments: true` an den Endpunkt. {% data reusables.enterprise_migrations.exclude-file-attachments %} Die endgültige Archivgröße muss kleiner als 20 GB sein. - - Diese Anforderung gibt eine eindeutige `ID` zurück, die Ihre Migration darstellt. Sie benötigen diese für nachfolgende Aufrufe der API für Migrationen. - -3. Senden Sie eine `GET`-Anforderung an den Endpunkt für den Status der Migration, um den Status einer Migration abzurufen. Sie benötigen Folgendes: - * Ihr Zugriffstoken für die Authentifizierung. - * Die eindeutige `ID` der Migration: - ```shell - curl -H "Authorization: token GITHUB_ACCESS_TOKEN" \ - -H "Accept: application/vnd.github.wyandotte-preview+json" \ - https://api.github.com/orgs/orgname/migrations/id - ``` - - Eine Migration kann einen der folgenden Zustände aufweisen: - * `pending` (ausstehend): Die Migration wurde noch nicht gestartet. - * `exporting` (wird exportiert): Die Migration wird ausgeführt. - * `exported` (exportiert): Die Migration wurde erfolgreich abgeschlossen. - * `failed` (fehlgeschlagen): Die Migration ist fehlgeschlagen. - -4. Laden Sie nach dem Export Ihrer Migration das Migrationsarchiv herunter. Senden Sie dazu eine `GET`-Anforderung an den Endpunkt für den Download der Migration. Sie benötigen Folgendes: - * Ihr Zugriffstoken für die Authentifizierung. - * Die eindeutige `ID` der Migration: - ```shell - curl -H "Accept: application/vnd.github.wyandotte-preview+json" \ - -u GITHUB_USERNAME:GITHUB_ACCESS_TOKEN \ - -L -o migration_archive.tar.gz \ - https://api.github.com/orgs/orgname/migrations/id/archive - ``` - -5. Das Migrationsarchiv wird nach sieben Tagen automatisch gelöscht. Wenn Sie es schneller löschen möchten, senden Sie eine `DELETE`-Anforderung an den Endpunkt zum Löschen des Migrationsarchivs. Sie benötigen Folgendes: - * Ihr Zugriffstoken für die Authentifizierung. - * Die eindeutige `ID` der Migration: - ```shell - curl -H "Authorization: token GITHUB_ACCESS_TOKEN" -X DELETE \ - -H "Accept: application/vnd.github.wyandotte-preview+json" \ - https://api.github.com/orgs/orgname/migrations/id/archive - ``` -{% data reusables.enterprise_migrations.ready-to-import-migrations %} diff --git a/translations/de-DE/content/admin/migrations/generating-a-list-of-migration-conflicts.md b/translations/de-DE/content/admin/migrations/generating-a-list-of-migration-conflicts.md deleted file mode 100644 index 089578cfd742..000000000000 --- a/translations/de-DE/content/admin/migrations/generating-a-list-of-migration-conflicts.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: Liste mit Migrationskonflikten generieren -intro: 'Wenn „ghe-migrator“ bei der Vorbereitung der Daten für den Import Konflikte meldet, müssen Sie eine Liste dieser Konflikte generieren, bevor Sie sich darauf vorbereiten, diese mit benutzerdefinierten Zuordnungen zu beheben.' -redirect_from: - - /enterprise/admin/migrations/generating-a-list-of-migration-conflicts -versions: - enterprise-server: '*' ---- - -1. Führen Sie den Befehl `ghe-migrator conflicts` mit dem Migrations-GUID aus, um die Datei *conflicts.csv* zu generieren: - ```shell - $ ghe-migrator conflicts -g MIGRATION_GUID > conflicts.csv - ``` - - Falls keine Konflikte gemeldet werden, können Sie die Daten ohne Weiteres importieren. Führen Sie dazu die unter „[Importierte Daten auf {% data variables.product.prodname_ghe_server %} anwenden](/enterprise/admin/guides/migrations/applying-the-imported-data-on-github-enterprise-server/)“ beschriebenen Schritte aus. -2. Kopieren Sie bei vorliegenden Konflikten mithilfe des Befehls [`scp`](https://linuxacademy.com/blog/linux/ssh-and-scp-howto-tips-tricks#scp) die Datei *conflicts.csv* auf Ihren lokalen Computer: - ```shell - $ scp -P 122 admin@hostname:conflicts.csv ~/Desktop - ``` -3. Wechseln Sie zu „[Migrationskonflikte beheben oder benutzerdefinierte Zuordnungen einrichten](/enterprise/admin/guides/migrations/resolving-migration-conflicts-or-setting-up-custom-mappings/)“. diff --git a/translations/de-DE/content/admin/migrations/importing-data-from-third-party-version-control-systems.md b/translations/de-DE/content/admin/migrations/importing-data-from-third-party-version-control-systems.md deleted file mode 100644 index 2b578d9ed313..000000000000 --- a/translations/de-DE/content/admin/migrations/importing-data-from-third-party-version-control-systems.md +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: Daten aus Drittanbieter-Quellcodeverwaltungssystemen importieren -intro: 'Mit der Reihe an „git-import“-Tools können Sie in Git-Repositorys auf {% data variables.product.prodname_ghe_server %} Elemente von Subversion, Mercurial und der Team Foundation-Versionskontrolle importieren.' -redirect_from: - - /enterprise/admin/migrations/importing-data-from-third-party-version-control-systems -versions: - enterprise-server: '*' ---- - -### Projekte aus Mercurial importieren - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. Erstellen Sie einen Klon im Rohdatenformat des Projekts. Führen Sie dazu den folgenden Befehl aus. Geben Sie dazu die URL des Quellprojekts und einen Pfad zum temporären Repository an: - ```shell - $ git-import-hg-raw HG-CLONE-URL /PATH/REPO-NAME.git - # Erstellt ein neues Repository mit mindestens einem Git-Ref in „refs/import/“ am angegebenen Pfad. - ``` -{% data reusables.enterprise_migrations.review-the-import-csv %} -4. Schreibt die Autoren und Branches mit der CSV-Datei um: - ```shell - $ git-import-rewrite --flavor hg --authors /PATH/AUTHORS-MAP-FILE.csv /PATH/REPO-NAME.git - ``` -5. [Erstellen Sie ein leeres Repository auf {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/user/articles/creating-a-new-repository), falls Sie dies nicht bereits erledigt haben. -{% data reusables.command_line.switching_directories_procedural %} -7. Übertragen Sie das importierte Repository per Push-Vorgang an {% data variables.product.prodname_ghe_server %}: - ```shell - $ git push --mirror PUSH-URL-ON-GITHUB-ENTERPRISE - ``` - -### Projekte aus Subversion importieren - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. Erstellen Sie einen Klon im Rohdatenformat des Projekts. Führen Sie dazu den folgenden Befehl aus. Geben Sie dazu die URL des Quellprojekts und einen Pfad zum temporären Repository an: - ```shell - $ git-import-svn-raw SVN-CLONE-URL /PATH/REPO-NAME.git - # Erstellt ein neues Repository mit mindestens einem Git-Ref in „refs/import/“ am angegebenen Pfad. - ``` -{% data reusables.enterprise_migrations.review-the-import-csv %} -4. Schreibt die Autoren und Branches mit der CSV-Datei um: - ```shell - $ git-import-rewrite --flavor svn --authors /PATH/AUTHORS-MAP-FILE.csv /PATH/REPO-NAME.git - ``` -5. [Erstellen Sie ein leeres Repository auf {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/user/articles/creating-a-new-repository), falls Sie dies nicht bereits erledigt haben. -{% data reusables.command_line.switching_directories_procedural %} -7. Übertragen Sie das importierte Repository per Push-Vorgang an {% data variables.product.prodname_ghe_server %}: - ```shell - $ git push --mirror PUSH-URL-ON-GITHUB-ENTERPRISE - ``` - -### Projekte aus der Team Foundation-Versionskontrolle importieren - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. Erstellen Sie einen Klon im Rohdatenformat des Projekts. Führen Sie dazu den folgenden Befehl aus. Geben Sie dazu die URL des Quellprojekts und einen Pfad zum temporären Repository an: - ```shell - $ git-import-tfs-raw TEAM-FOUNDATION-CLONE-URL /PATH/REPO-NAME.git - # Erstellt ein neues Repository mit mindestens einem Git-Ref in „refs/import/“ am angegebenen Pfad. - ``` -{% data reusables.enterprise_migrations.review-the-import-csv %} -4. Schreibt die Autoren und Branches mit der CSV-Datei um: - ```shell - $ git-import-rewrite --flavor tfs --authors /PATH/AUTHORS-MAP-FILE.csv /PATH/REPO-NAME.git - ``` -5. [Erstellen Sie ein leeres Repository auf {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/user/articles/creating-a-new-repository), falls Sie dies nicht bereits erledigt haben. -{% data reusables.command_line.switching_directories_procedural %} -7. Übertragen Sie das importierte Repository per Push-Vorgang an {% data variables.product.prodname_ghe_server %}: - ```shell - $ git push --mirror PUSH-URL-ON-GITHUB-ENTERPRISE - ``` - -### Weiterführende Informationen - -- "[Command-line-utilities](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities/#import-and-export)" diff --git a/translations/de-DE/content/admin/migrations/importing-migration-data-to-github-enterprise-server.md b/translations/de-DE/content/admin/migrations/importing-migration-data-to-github-enterprise-server.md deleted file mode 100644 index 02b1ca57c52f..000000000000 --- a/translations/de-DE/content/admin/migrations/importing-migration-data-to-github-enterprise-server.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Migrationsdaten in GitHub Enterprise Server importieren -intro: 'Nachdem Sie ein Migrationsarchiv generiert haben, können Sie die Daten auf Ihrer {% data variables.product.prodname_ghe_server %}-Zielinstanz importieren. Sie können die Änderungen auf potenzielle Konflikte überprüfen, bevor Sie die Änderungen dauerhaft auf Ihre Zielinstanz anwenden.' -redirect_from: - - /enterprise/admin/guides/migrations/importing-migration-data-to-github-enterprise/ - - /enterprise/admin/migrations/importing-migration-data-to-github-enterprise-server -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/de-DE/content/admin/migrations/index.md b/translations/de-DE/content/admin/migrations/index.md deleted file mode 100644 index dc54af3e6fd0..000000000000 --- a/translations/de-DE/content/admin/migrations/index.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: 'Benutzer-, Organisations- und Repository-Daten migrieren' -shortTitle: Daten migrieren -intro: 'Du kannst Benutzer-, Organisations- und Repositorydaten von {% data variables.product.prodname_ghe_server %} oder {% data variables.product.prodname_dotcom_the_website %} exportieren und diese Daten dann in {% data variables.product.product_location_enterprise %} importieren.' -redirect_from: - - /enterprise/admin/articles/moving-a-repository-from-github-com-to-github-enterprise/ - - /enterprise/admin/categories/migrations-and-upgrades/ - - /enterprise/admin/migrations -versions: - enterprise-server: '*' ---- - - -### Inhaltsverzeichnis - -{% topic_link_in_list /overview %} - {% link_in_list /about-migrations %} -{% topic_link_in_list /exporting-migration-data-from-github-enterprise-server %} - {% link_in_list /preparing-the-github-enterprise-server-source-instance %} - {% link_in_list /exporting-the-github-enterprise-server-source-repositories %} -{% topic_link_in_list /exporting-migration-data-from-githubcom %} - {% link_in_list /preparing-the-githubcom-source-organization %} - {% link_in_list /exporting-the-githubcom-organizations-repositories %} -{% topic_link_in_list /importing-migration-data-to-github-enterprise-server %} - {% link_in_list /preparing-the-migrated-data-for-import-to-github-enterprise-server %} - {% link_in_list /generating-a-list-of-migration-conflicts %} - {% link_in_list /reviewing-migration-conflicts %} - {% link_in_list /resolving-migration-conflicts-or-setting-up-custom-mappings %} - {% link_in_list /applying-the-imported-data-on-github-enterprise-server %} - {% link_in_list /reviewing-migration-data %} - {% link_in_list /completing-the-import-on-github-enterprise-server %} - {% topic_link_in_list /exporting-migration-data-from-github-enterprise-server %} diff --git a/translations/de-DE/content/admin/migrations/overview.md b/translations/de-DE/content/admin/migrations/overview.md deleted file mode 100644 index b4e25915cc2f..000000000000 --- a/translations/de-DE/content/admin/migrations/overview.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Übersicht -intro: 'Erfahre mehr über die Migration von Daten nach {% data variables.product.product_location_enterprise %}.' -mapTopic: true -redirect_from: - - /enterprise/admin/migrations/overview -versions: - enterprise-server: '*' ---- - diff --git a/translations/de-DE/content/admin/migrations/preparing-the-github-enterprise-server-source-instance.md b/translations/de-DE/content/admin/migrations/preparing-the-github-enterprise-server-source-instance.md deleted file mode 100644 index 995d1a87e7a7..000000000000 --- a/translations/de-DE/content/admin/migrations/preparing-the-github-enterprise-server-source-instance.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: GitHub Enterprise Server-Quellinstanz vorbereiten -intro: 'Bevor Sie Daten von {% data variables.product.prodname_ghe_server %} migrieren, sollten Sie sicherstellen, dass Sie über den entsprechenden Authentifizierungs- und Verwaltungszugriff auf die Instanz verfügen.' -redirect_from: - - /enterprise/admin/guides/migrations/preparing-the-github-enterprise-source-instance/ - - /enterprise/admin/migrations/preparing-the-github-enterprise-server-source-instance -versions: - enterprise-server: '*' ---- - -1. Verifizieren Sie, dass Sie auf der {% data variables.product.prodname_ghe_server %}-Quelle ein Websiteadministrator sind. Dazu empfiehlt es sich zu verifizieren, dass Sie eine [SSH-Verbindung zur Instanz herstellen können](/enterprise/admin/guides/installation/accessing-the-administrative-shell-ssh/). - -2. {% data reusables.enterprise_migrations.token-generation %} auf der {% data variables.product.prodname_ghe_server %}-Quellinstanz. - -{% data reusables.enterprise_migrations.make-a-list %} diff --git a/translations/de-DE/content/admin/migrations/preparing-the-githubcom-source-organization.md b/translations/de-DE/content/admin/migrations/preparing-the-githubcom-source-organization.md deleted file mode 100644 index 303918e6dd7f..000000000000 --- a/translations/de-DE/content/admin/migrations/preparing-the-githubcom-source-organization.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: GitHub.com-Quellorganisation vorbereiten -intro: 'Bevor Sie Repositorys von einer {% data variables.product.prodname_dotcom_the_website %}-Organisation migrieren, sollten Sie sicherstellen, dass Sie über den entsprechenden Authentifizierungs- und Verwaltungszugriff verfügen.' -redirect_from: - - /enterprise/admin/guides/migrations/preparing-the-github-com-source-organization - - /enterprise/admin/migrations/preparing-the-githubcom-source-organization -versions: - enterprise-server: '*' ---- - -1. Stellen Sie sicher, dass Sie für die Repositorys in der Quellorganisation über [Inhaberberechtigungen](/articles/permission-levels-for-an-organization/) verfügen. - -2. {% data reusables.enterprise_migrations.token-generation %} auf {% data variables.product.prodname_dotcom_the_website %}. - -{% data reusables.enterprise_migrations.make-a-list %} diff --git a/translations/de-DE/content/admin/migrations/preparing-the-migrated-data-for-import-to-github-enterprise-server.md b/translations/de-DE/content/admin/migrations/preparing-the-migrated-data-for-import-to-github-enterprise-server.md deleted file mode 100644 index 2e6e62708fd7..000000000000 --- a/translations/de-DE/content/admin/migrations/preparing-the-migrated-data-for-import-to-github-enterprise-server.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: Migrationsdaten auf den Import zu GitHub Enterprise Server vorbereiten -intro: 'Bevor Sie die Migrationsdaten auf Ihre Zielinstanz anwenden, müssen Sie das Migrationsarchiv auf Ihre Zielinstanz kopieren und es auf den Import vorbereiten.' -redirect_from: - - /enterprise/admin/guides/migrations/preparing-the-migrated-data-for-import-to-github-enterprise/ - - /enterprise/admin/migrations/preparing-the-migrated-data-for-import-to-github-enterprise-server -versions: - enterprise-server: '*' ---- - -1. Kopieren Sie mit dem Befehl [`scp`](https://linuxacademy.com/blog/linux/ssh-and-scp-howto-tips-tricks#scp) das auf Ihrer Quellinstanz oder in Ihrer Organisation generierte Migrationsarchiv auf Ihr {% data variables.product.prodname_ghe_server %}-Ziel: - - ```shell - $ scp -P 122 /path/to/archive/MIGRATION_GUID.tar.gz admin@hostname:/home/admin/ - ``` - -{% data reusables.enterprise_installation.ssh-into-target-instance %} - -3. Führen Sie den Befehl `ghe-migrator prepare` aus, um das Archiv auf den Import auf der Zielinstanz vorzubereiten und einen neuen Migrations-GUID zu generieren, den Sie in den nachfolgenden Schritten verwenden: - - ```shell - ghe-migrator prepare /home/admin/MIGRATION_GUID.tar.gz - ``` - - * Führen Sie zum Starten eines neuen Importversuchs den Befehl `ghe-migrator prepare` erneut aus, und rufen Sie einen neuen Migrations-GUID ab. - * {% data reusables.enterprise_migrations.specify-staging-path %} diff --git a/translations/de-DE/content/admin/migrations/resolving-migration-conflicts-or-setting-up-custom-mappings.md b/translations/de-DE/content/admin/migrations/resolving-migration-conflicts-or-setting-up-custom-mappings.md deleted file mode 100644 index 9e431f691f81..000000000000 --- a/translations/de-DE/content/admin/migrations/resolving-migration-conflicts-or-setting-up-custom-mappings.md +++ /dev/null @@ -1,70 +0,0 @@ ---- -title: Migrationskonflikte beheben und benutzerdefinierte Zuordnungen einrichten -intro: 'Vor dem Importieren von Migrationsdaten können Sie Korrekturen vornehmen, um Konflikte zu beheben, eingehende Datensätze umzubenennen oder eingehende Datensätze vorhandenen Datensätzen zuzuordnen.' -redirect_from: - - /enterprise/admin/migrations/resolving-migration-conflicts-or-setting-up-custom-mappings -versions: - enterprise-server: '*' ---- - -Mit den folgenden Schritten können Konflikte behoben oder Ihrer Migration benutzerdefinierte Zuordnungen hinzugefügt werden. - -### Konflikte beheben - -Wenn Sie der Ansicht sind, dass der Befehl `ghe-migrator` eine falsche Änderung durchführt, können Sie Korrekturen vornehmen. Ändern Sie dazu die Daten in *conflicts.csv*. Sie können Änderungen an allen Zeilen in *conflicts.csv* vornehmen. - -Angenommen, Sie stellen fest, dass der Benutzer `octocat` von der Quellinstanz dem Benutzer `octocat` auf der Zielinstanz zugeordnet ist: - -| `model_name` | `source_url` | `target_url` | `recommended_action` | -| ------------ | ----------------------------------- | ----------------------------------- | -------------------- | -| `Benutzer` | `https://example-gh.source/octocat` | `https://example-gh.target/octocat` | `map` | - -Sie können den Benutzer einem anderen Benutzer auf der Zielinstanz zuordnen. Angenommen, Sie wissen, dass `octocat` auf der Zielinstanz eigentlich `monalisa` heißen sollte. Sie können die Spalte `target_url` in *conflicts.csv* so ändern, dass auf `monalisa` verwiesen wird: - -| `model_name` | `source_url` | `target_url` | `recommended_action` | -| ------------ | ----------------------------------- | ------------------------------------ | -------------------- | -| `Benutzer` | `https://example-gh.source/octocat` | `https://example-gh.target/monalisa` | `map` | - -Falls Sie darüber hinaus beispielsweise das Repository `octo-org/widgets` auf der Zielinstanz in `octo-org/amazing-widgets` umbenennen möchten, ändern Sie den Wert `target_url` in `octo-org/amazing-widgets` und den Wert `recommend_action` in `rename`: - -| `model_name` | `source_url` | `target_url` | `recommended_action` | -| ------------ | -------------------------------------------- | ---------------------------------------------------- | -------------------- | -| `Repository` | `https://example-gh.source/octo-org/widgets` | `https://example-gh.target/octo-org/amazing-widgets` | `rename` | - -### Benutzerdefinierte Zuordnungen hinzufügen - -Während einer Migration geschieht es häufig, dass migrierte Benutzer andere Benutzernamen auf der Zielinstanz als auf der Quellinstanz besitzen. - -Mit einer Liste der Benutzernamen von der Quellinstanz und einer Liste der Benutzernamen von der Zielinstanz können Sie eine CSV-Datei mit benutzerdefinierten Zuordnungen erstellen und anschließend anwenden, um sicherzustellen, dass der Benutzername und Inhalt jedes Benutzers am Ende einer Migration richtig zugeordnet werden. - -Führen Sie den Befehl [`ghe-migrator audit`](/enterprise/admin/guides/migrations/reviewing-migration-data) aus, um im Handumdrehen eine CSV-Datei von Benutzern zu erstellen, die im CSV-Format migriert werden, das für die Anwendung benutzerdefinierter Zuordnungen erforderlich ist. - -```shell -$ ghe-migrator audit -m user -g MIGRATION_GUID > users.csv -``` - -Nun können Sie diese CSV-Datei bearbeiten und eine neue URL für jeden Benutzer eingeben, den Sie zuordnen oder umbenennen möchten. Anschließend können Sie die vierte Spalte entsprechend so bearbeiten, dass sie `map` oder `rename` aufweist. - -Um beispielsweise den Benutzer `octocat` auf der Zielinstanz `https://example-gh.target` in `monalisa` umzubenennen, würden Sie eine Zeile mit dem folgenden Inhalt erstellen: - -| `model_name` | `source_url` | `target_url` | `state` | -| ------------ | ----------------------------------- | ------------------------------------ | -------- | -| `Benutzer` | `https://example-gh.source/octocat` | `https://example-gh.target/monalisa` | `rename` | - -Mit demselben Prozess können Sie Zuordnungen für jeden Datensatz erstellen, der benutzerdefinierte Zuordnungen unterstützt. Weitere Informationen finden Sie in unserer Tabelle zu den „[möglichen Zuordnungen für Datensätze](/enterprise/admin/guides/migrations/reviewing-migration-conflicts#possible-mappings-for-each-record-type)“. - -### Geänderte Migrationsdaten anwenden - -1. Nachdem Sie die Änderungen vorgenommen haben, führen Sie den Befehl [`scp`](https://linuxacademy.com/blog/linux/ssh-and-scp-howto-tips-tricks#scp) aus, um Ihre geänderte Datei *conflicts.csv* (oder eine andere CSV-Datei für Zuordnungen im richtigen Format) auf die Zielinstanz anzuwenden: - - ```shell - $ scp -P 122 ~/Desktop/conflicts.csv admin@hostname:/home/admin/ - ``` - -2. Führen Sie den Befehl `ghe-migrator map` aus, um die Migrationsdaten erneut zuzuordnen. Übergeben Sie dazu den Pfad an Ihre geänderte CSV-Datei und an den Migrations-GUID: - - ```shell - $ ghe-migrator map -i conflicts.csv -g MIGRATION_GUID - ``` - -3. Wenn der Befehl `ghe-migrator map -i conflicts.csv -g MIGRATION_GUID` meldet, dass weiterhin Konflikte vorhanden sind, führen Sie den Prozess zum Beheben von Migrationskonflikten erneut aus. diff --git a/translations/de-DE/content/admin/migrations/reviewing-migration-conflicts.md b/translations/de-DE/content/admin/migrations/reviewing-migration-conflicts.md deleted file mode 100644 index 3e66e525d45b..000000000000 --- a/translations/de-DE/content/admin/migrations/reviewing-migration-conflicts.md +++ /dev/null @@ -1,43 +0,0 @@ ---- -title: Migrationskonflikte überprüfen -intro: 'Nachdem Sie eine Liste der Migrationskonflikte generiert haben, sollten Sie diese überprüfen, um sicherzustellen, dass Sie mit den Standardmaßnahmen einverstanden sind, die „ghe-migrator“ bei der Behebung dieser Konflikte durchführt.' -redirect_from: - - /enterprise/admin/migrations/reviewing-migration-conflicts -versions: - enterprise-server: '*' ---- - -1. Verwenden Sie einen Texteditor oder eine [CSV-kompatible Tabellenkalkulationssoftware](https://en.wikipedia.org/wiki/Comma-separated_values#Application_support), um *conflicts.csv* zu öffnen. -2. Überprüfen Sie die Datei *conflicts.csv*, um sicherzustellen, dass die entsprechenden Aktionen beim Import durchgeführt werden. Berücksichtigen Sie dazu die Anleitung aus den folgenden Beispielen und Referenztabellen. - -Die Datei *conflicts.csv*enthält eine *Migrationszuordnung* der Konflikte und empfohlenen Aktionen. Eine Migrationszuordnung listet auf, welche Daten von der Quellinstanz migriert werden und wie die Daten auf die Zielinstanz angewendet werden. - -| `model_name` | `source_url` | `target_url` | `recommended_action` | -| -------------- | ------------------------------------------------------ | ------------------------------------------------------ | -------------------- | -| `Benutzer` | `https://example-gh.source/octocat` | `https://example-gh.target/octocat` | `map` | -| `organization` | `https://example-gh.source/octo-org` | `https://example-gh.target/octo-org` | `map` | -| `Repository` | `https://example-gh.source/octo-org/widgets` | `https://example-gh.target/octo-org/widgets` | `rename` | -| `Team` | `https://example-gh.source/orgs/octo-org/teams/admins` | `https://example-gh.target/orgs/octo-org/teams/admins` | `mergen` | - -Jede Zeile in *conflicts.csv* enthält die folgenden Informationen: - -| Name | Beschreibung | -| -------------------- | ------------------------------------------------------------------------------- | -| `model_name` | Der Typ der zu ändernden Daten. | -| `source_url` | Die Quell-URL der Daten. | -| `target_url` | Die erwartete Ziel-URL der Daten. | -| `recommended_action` | Die Aktion, die `ghe-migrator` beim Importieren der Daten bevorzugt durchführt. | - -### Mögliche Zuordnungen für jeden Datensatztyp - -Es gibt verschiedene Zuordnungsaktionen, die `ghe-migrator` beim Übertragen von Daten durchführen kann. - -| `action` | Beschreibung | Entsprechende Modelle | -| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- | -| `import` | (Standard) Daten von der Quellinstanz werden auf die Zielinstanz importiert. | Alle Datensatztypen | -| `map` | Daten von der Quellinstanz werden durch vorhandene Daten auf der Zielinstanz ersetzt. | Benutzer, Organisationen, Repositorys | -| `rename` | Daten von der Quellinstanz werden umbenannt und anschließend auf die Zielinstanz kopiert. | Benutzer, Organisationen, Repositorys | -| `map_or_rename` | Bei Vorhandensein der Zielinstanz sollte die Zuordnung zur Zielinstanz erfolgen. Andernfalls sollte das importierte Modell umbenannt werden. | Benutzer | -| `mergen` | Daten von der Quellinstanz werden mit vorhandenen Daten auf der Zielinstanz kombiniert. | Teams | - -**Es wird dringend empfohlen, dass Sie die Datei *conflicts.csv* überprüfen und den Befehl [`ghe-migrator audit`](/enterprise/admin/guides/migrations/reviewing-migration-data) verwenden, um sicherzustellen, dass die entsprechenden Aktionen durchgeführt werden.** Wenn alles ordnungsgemäß aussieht, können Sie „[Importierte Daten auf {% data variables.product.prodname_ghe_server %} anwenden](/enterprise/admin/guides/migrations/applying-the-imported-data-on-github-enterprise-server)“ lesen. diff --git a/translations/de-DE/content/admin/migrations/reviewing-migration-data.md b/translations/de-DE/content/admin/migrations/reviewing-migration-data.md deleted file mode 100644 index 17aaa9fbf2f0..000000000000 --- a/translations/de-DE/content/admin/migrations/reviewing-migration-data.md +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: Migrationsdaten überprüfen -intro: 'Nach den jeweiligen Migrationsschritten können Sie den Zustand der Migrationsdaten überprüfen. Sie können sicherstellen, dass die Datensätze ordnungsgemäß zugeordnet oder umbenannt werden, die neuen URLs für Datensätze nach dem Importschritt abrufen und die Datensätze auflisten, bei deren Migration Fehler auftraten.' -redirect_from: - - '/enterprise/{{ currentVersion }}/admin/guides/migrations/reviewing-the-imported-data/' - - /enterprise/admin/migrations/reviewing-migration-data -versions: - enterprise-server: '*' ---- - -Der Befehl `ghe-migrator audit` gibt standardmäßig jeden Datensatz zurück. Dadurch können Sie die Datensätze zudem filtern nach - - * den Datensatztypen, - * dem Zustand der Datensätze. - -Die Datensatztypen stimmen mit denen der [Migrationsdaten](/enterprise/admin/guides/migrations/about-migrations/#migrated-data) überein. - -### Filter für Datensatztypen - -| Datensatztyp | Filtername | -| -------------------------------------------------- | ----------------------------- | -| Benutzer | `user` | -| Organisationen | `organization` | -| Repositorys | `Repository` | -| Teams | `Team` | -| Meilensteine | `milestone` | -| Projektboards | `project` | -| Issues | `Issue` | -| Issue-Kommentare | `issue_comment` | -| Pull Requests | `pull_request` | -| Pull-Request-Reviews | `pull_request_review` | -| Commit-Kommentare | `commit_comment` | -| Pull-Request-Review-Kommentare | `pull_request_review_comment` | -| Veröffentlichungen | `release` | -| Bei Pull Requests oder Issues ergriffene Maßnahmen | `issue_event` | -| Geschützte Branches | `protected_branch` | - -### Filter für Datensatzzustände - -| Datensatzzustand | Beschreibung | -| ---------------- | ------------------------------------------- | -| `export` | Der Datensatz wird exportiert. | -| `import` | Der Datensatz wird importiert. | -| `map` | Der Datensatz wird zugeordnet. | -| `rename` | Der Datensatz wird umbenannt. | -| `merge` | Der Datensatz wird gemergt. | -| `exported` | Der Datensatz wurde erfolgreich exportiert. | -| `imported` | Der Datensatz wurde erfolgreich importiert. | -| `mapped` | Der Datensatz wurde erfolgreich zugeordnet. | -| `renamed` | Der Datensatz wurde erfolgreich umbenannt. | -| `merged` | Der Datensatz wurde erfolgreich gemergt. | -| `failed_export` | Fehler beim Export des Datensatzes. | -| `failed_import` | Fehler beim Import des Datensatzes. | -| `failed_map` | Fehler beim Zuordnen des Datensatzes. | -| `failed_rename` | Fehler beim Umbenennen des Datensatzes. | -| `failed_merge` | Fehler beim Mergen des Datensatzes. | - -### Überwachte Datensätze filtern - -Wenn Sie den Befehl `ghe-migrator audit` mit dem Flag `-m` ausführen, können Sie anhand des Datensatztyps filtern. Ebenso können Sie mithilfe des Flags `-s` nach dem Importstatus filtern. Der Befehl sieht wie folgt aus: - -```shell -$ ghe-migrator audit -m RECORD_TYPE -s STATE -g MIGRATION_GUID -``` - -Wenn Sie beispielsweise alle erfolgreich importierten Organisationen und Teams anzeigen möchten, würden Sie Folgendes eingeben: -```shell -$ ghe-migrator audit -m organization,team -s mapped,renamed -g MIGRATION_GUID -> model_name,source_url,target_url,state -> organization,https://gh.source/octo-org/,https://ghe.target/octo-org/,renamed -``` - -**Es wird dringend empfohlen, jeden fehlgeschlagenen Import zu überwachen.** Dazu geben Sie Folgendes ein: -```shell -$ ghe-migrator audit -s failed_import,failed_map,failed_rename,failed_merge -g MIGRATION_GUID -> model_name,source_url,target_url,state -> user,https://gh.source/octocat,https://gh.target/octocat,failed -> repository,https://gh.source/octo-org/octo-project,https://ghe.target/octo-org/octo-project,failed -``` - -Kontaktieren Sie {% data variables.contact.contact_ent_support %}, wenn Sie Bedenken in Bezug auf fehlgeschlagene Importvorgänge haben. diff --git a/translations/de-DE/content/admin/user-management/about-global-webhooks.md b/translations/de-DE/content/admin/user-management/about-global-webhooks.md deleted file mode 100644 index 983e85f94120..000000000000 --- a/translations/de-DE/content/admin/user-management/about-global-webhooks.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: Informationen zu globalen Webhooks -intro: Globale Webhooks benachrichtigen Sie zu Ereignissen auf Instanzebene. -redirect_from: - - /enterprise/admin/user-management/about-global-webhooks -versions: - enterprise-server: '*' ---- - -Mithilfe von globalen Webhooks können Sie Regeln für die Benutzer- und Organisationsverwaltung auf Ihrer Instanz automatisch überwachen, darauf antworten oder diese erzwingen. So können Sie Ihre Webhooks beispielsweise so konfigurieren, dass sie ausgeführt werden, sobald -- ein Benutzerkonto erstellt oder gelöscht wird, -- eine Organisation erstellt oder gelöscht wird, -- ein Mitarbeiter zu einem Repository hinzugefügt oder aus diesem entfernt wird, -- ein Repository geforkt wird. - -![Liste der globalen Webhooks](/assets/images/enterprise/site-admin-settings/list-of-global-webhooks.png) - -Weitere Informationen zum Konfigurieren von Webhooks finden Sie unter „[Globale Webhooks verwalten](/enterprise/{{ currentVersion }}/admin/guides/user-management/managing-global-webhooks)“. - -{% data reusables.enterprise_user_management.manage-global-webhooks-api %} diff --git a/translations/de-DE/content/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories.md b/translations/de-DE/content/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories.md deleted file mode 100644 index 84fe5ca1d867..000000000000 --- a/translations/de-DE/content/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: Administratoren das Aktivieren des anonymen Git-Lesezugriffs auf öffentliche Repositorys erlauben -intro: 'Sie können festlegen, dass Repository-Administratoren den anonymen Git-Lesezugriff auf öffentliche Repositorys auf {% data variables.product.product_location_enterprise %} aktivieren können, um die Funktionsweise von benutzerdefinierten Tools auf Ihrer Instanz zu vereinfachen und Authentifizierungsanforderungen zu umgehen.' -redirect_from: - - /enterprise/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_user_management.disclaimer-for-git-read-access %} - -Wenn der private Modus aktiviert ist, können Sie festlegen, dass Repository-Administratoren den anonymen Git-Lesezugriff für öffentliche Repositorys auf {% data variables.product.product_location_enterprise %} aktivieren können. Weitere Informationen zum privaten Modus finden Sie unter „[Privaten Modus aktivieren](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-private-mode/)“. - -Wenn Sie den anonymen Git-Lesezugriff zulassen, können Sie die Authentifizierung für benutzerdefinierte Tools auf Ihrer Instanz umgehen. Wenn Sie oder ein Repository-Administrator diese Zugriffseinstellung für ein Repository aktiviert, verfügen nicht authentifizierte Git-Vorgänge (und jeder mit Netzwerkzugriff auf {% data variables.product.prodname_ghe_server %}) über Lesezugriff auf das Repository, ohne dass eine Authentifizierung erforderlich ist. - -Darüber hinaus können Sie Repository-Administratoren daran hindern, die Einstellungen für den anonymen Git-Zugriff für alle Repositorys oder für ein spezifisches Repository auf {% data variables.product.product_location_enterprise %} zu ändern. Weitere Informationen finden Sie unter „[Änderung des anonymen Git-Lesezugriffs durch Benutzer verhindern](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)“. - -{% data reusables.enterprise_site_admin_settings.list-of-repos-with-anonymous-git-read-access-enabled %} - -{% data reusables.enterprise_user_management.exceptions-for-enabling-anonymous-git-read-access %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -4. Klicken Sie unter „Anonymous Git read access“ (Anonymer Git-Lesezugriff) auf das Dropdownmenü, und klicken Sie auf **Enabled** (Aktiviert). ![Dropdownmenü „Anonymous Git read access“ (Anonymer Git-Lesezugriff) mit den angezeigten Menüoptionen „Enabled“ (Aktiviert) und „Disabled“ (Deaktiviert)](/assets/images/enterprise/site-admin-settings/enable-anonymous-git-read-access.png) -3. Aktivieren Sie optional **Prevent repository admins from changing anonymous Git read access** (Repository-Administratoren daran hindern, den anonymen Git-Lesezugriff zu ändern), um Repository-Administratoren daran zu hindern, die Einstellungen für den anonymen Git-Lesezugriff in allen Repositorys auf Ihrer Instanz zu ändern. ![Durch die Aktivierung des Kontrollkästchens werden Repository-Administratoren daran gehindert, die Einstellungen für den anonymen Git-Lesezugriff für alle Repositorys auf Ihrer Instanz zu ändern](/assets/images/enterprise/site-admin-settings/globally-lock-repos-from-changing-anonymous-git-read-access.png) - -### Anonymen Git-Lesezugriff für ein spezifisches Repository aktivieren - -{% data reusables.enterprise_user_management.exceptions-for-enabling-anonymous-git-read-access %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -6. Klicken Sie unter „Danger Zone“ (Gefahrenzone) neben „Enable Anonymous Git read access“ (Anonymen Git-Lesezugriff aktivieren) auf **Enable** (Aktivieren). ![Schaltfläche „Enabled“ (Aktiviert) unter „Enable anonymous Git read access“ (Anonymen Git-Lesezugriff aktivieren) in der „Danger Zone“ (Gefahrenzone) der Websiteadministratoreinstellungen eines Repositorys ](/assets/images/enterprise/site-admin-settings/site-admin-enable-anonymous-git-read-access.png) -7. Überprüfen Sie die Änderungen. Klicken Sie zur Bestätigung auf **Yes, enable anonymous Git read access** (Ja, anonymen Git-Lesezugriff aktivieren). ![Bestätigung der Einstellung für anonymen Git-Lesezugriff in einem Popup-Fenster](/assets/images/enterprise/site-admin-settings/confirm-anonymous-git-read-access-for-specific-repo-as-site-admin.png) -8. Aktivieren Sie optional **Prevent repository admins from changing anonymous Git read access** (Repository-Administratoren daran hindern, den anonymen Git-Lesezugriff zu ändern), um Repository-Administratoren daran zu hindern, diese Einstellung für dieses Repository zu ändern. ![Durch die Aktivierung des Kontrollkästchens werden Repository-Administratoren daran gehindert, den anonymen Git-Lesezugriff für dieses Repository zu ändern](/assets/images/enterprise/site-admin-settings/lock_anonymous_git_access_for_specific_repo.png) diff --git a/translations/de-DE/content/admin/user-management/allowing-built-in-authentication-for-users-outside-your-identity-provider.md b/translations/de-DE/content/admin/user-management/allowing-built-in-authentication-for-users-outside-your-identity-provider.md deleted file mode 100644 index 3e277d00d9e6..000000000000 --- a/translations/de-DE/content/admin/user-management/allowing-built-in-authentication-for-users-outside-your-identity-provider.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: Integrierte Authentifizierung für Benutzer außerhalb Ihres Identity Providers zulassen -intro: 'Sie können die integrierte Authentifizierung konfigurieren, um Benutzer zu authentifizieren, die keinen Zugriff auf Ihren Identity Provider haben, der LDAP, SAML oder CAS verwendet.' -redirect_from: - - /enterprise/admin/user-management/allowing-built-in-authentication-for-users-outside-your-identity-provider -versions: - enterprise-server: '*' ---- - -### Informationen zur integrierten Authentifizierung für Benutzer außerhalb Ihres Identity Providers - -Sie können die integrierte Authentifizierung für externe Benutzer verwenden, wenn Sie nicht in der Lage sind, Ihrem Identity Provider (IdP) bestimmte Konten, beispielsweise Konten für Vertragsnehmer oder Maschinenbenutzer hinzuzufügen. Darüber hinaus können Sie die integrierte Authentifizierung verwenden, um auf ein Fallback-Konto zuzugreifen, falls der Identity Provider nicht verfügbar ist. - -Nach der Konfiguration der integrierten Authentifizierung und der erfolgreichen Authentifizierung eines Benutzers mit SAML oder CAS kann er sich nicht mehr mittels Benutzername und Passwort authentifizieren. Wenn sich ein Benutzer erfolgreich mit LDAP authentifiziert, werden die Anmeldeinformationen nicht mehr als intern erachtet. - -Die integrierte Authentifizierung für einen spezifischen IdP ist standardmäßig deaktiviert. - -{% warning %} - -**Warnung:** Falls Sie die integrierte Authentifizierung deaktivieren, müssen Sie die Benutzer einzeln sperren, die nicht mehr auf die Instanz zugreifen sollen. Weitere Informationen finden Sie unter „[Benutzer sperren und entsperren](/enterprise/{{ currentVersion }}/admin/guides/user-management/suspending-and-unsuspending-users)“. - -{% endwarning %} - -### Integrierte Authentifizierung für Benutzer außerhalb Ihres Identity Providers konfigurieren - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.authentication %} -4. Wählen Sie den gewünschten Identity Provider aus.![Option zur Auswahl des Identity Providers](/assets/images/enterprise/management-console/identity-provider-select.gif) -5. Wählen Sie **Allow creation of accounts with built-in authentication** (Erstellung von Konten mit integrierter Authentifizierung zulassen) aus. ![Option zur Auswahl der integrierten Authentifizierung](/assets/images/enterprise/management-console/built-in-auth-identity-provider-select.png) -6. Lesen Sie die Warnung, und klicken Sie anschließend auf **Ok**. - -{% data reusables.enterprise_user_management.two_factor_auth_header %} -{% data reusables.enterprise_user_management.2fa_is_available %} - -### Benutzer außerhalb Ihres Identity Providers zur Authentifizierung an Ihrer Instanz einladen - -Wenn ein Benutzer die Einladung akzeptiert, kann er sich anstatt über den IdP mittels Benutzername und Passwort anmelden. - -{% data reusables.enterprise_site_admin_settings.sign-in %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.invite-user-sidebar-tab %} -{% data reusables.enterprise_site_admin_settings.invite-user-reset-link %} - -### Weiterführende Informationen - -- „[LDAP verwenden](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap)“ -- „[SAML verwenden](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-saml)“ -- „[CAS verwenden](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-cas)“ diff --git a/translations/de-DE/content/admin/user-management/archiving-and-unarchiving-repositories.md b/translations/de-DE/content/admin/user-management/archiving-and-unarchiving-repositories.md deleted file mode 100644 index 67abaa4c5df5..000000000000 --- a/translations/de-DE/content/admin/user-management/archiving-and-unarchiving-repositories.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: Repositorys archivieren und deren Archivierung aufheben -intro: Als Websiteadministrator können Sie im Websiteadministrator-Dashboard ein Repository archivieren oder dessen Archivierung aufheben. -redirect_from: - - /enterprise/admin/articles/archiving-and-unarchiving-repositories/ - - /enterprise/admin/user-management/archiving-and-unarchiving-repositories -versions: - enterprise-server: '*' ---- - -### Repository archivieren -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -5. Klicken Sie unter „Danger Zone“ (Gefahrenzone) auf **Archive** (Archivieren). ![Schaltfläche „Archive“ (Archivieren)](/assets/images/enterprise/site-admin-settings/repo-archive.png) -6. Klicken Sie auf **Archive repository** (Repository archivieren). ![Schaltfläche „Archive repository“ (Repository archivieren)](/assets/images/enterprise/site-admin-settings/repo-archive-confirm.png) - -### Archivierung eines Repositorys aufheben -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -5. Klicken Sie unter „Danger Zone“ (Gefahrenzone) auf **Unarchive** (Archivierung aufheben). ![Schaltfläche „Archive“ (Archivieren)](/assets/images/enterprise/site-admin-settings/repo-unarchive.png) -6. Klicken Sie auf **Unarchive repository** (Archivierung des Repositorys aufheben). ![Schaltfläche „Archive repository“ (Repository archivieren)](/assets/images/enterprise/site-admin-settings/repo-unarchive-confirm.png) - -### Weiterführende Informationen -- „[Informationen zur Archivierung von Repositorys](/enterprise/{{ currentVersion }}/user/articles/about-archiving-repositories)“ diff --git a/translations/de-DE/content/admin/user-management/authenticating-users-for-your-github-enterprise-server-instance.md b/translations/de-DE/content/admin/user-management/authenticating-users-for-your-github-enterprise-server-instance.md deleted file mode 100644 index 6c1300e4a4f6..000000000000 --- a/translations/de-DE/content/admin/user-management/authenticating-users-for-your-github-enterprise-server-instance.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: Benutzer für Ihre GitHub Enterprise Server-Instanz authentifizieren -intro: 'Sie können die integrierte Authentifizierung von {% data variables.product.prodname_ghe_server %} verwenden oder zwischen CAS, LDAP oder SAML auswählen, um Ihre vorhandenen Konten zu integrieren und den Benutzerzugriff auf {% data variables.product.product_location_enterprise %} zentral zu verwalten.' -redirect_from: - - /enterprise/admin/categories/authentication/ - - /enterprise/admin/guides/installation/user-authentication/ - - /enterprise/admin/articles/inviting-users/ - - /enterprise/admin/guides/migrations/authenticating-users-for-your-github-enterprise-instance/ - - /enterprise/admin/user-management/authenticating-users-for-your-github-enterprise-server-instance -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/de-DE/content/admin/user-management/basic-account-settings.md b/translations/de-DE/content/admin/user-management/basic-account-settings.md deleted file mode 100644 index e21270729e96..000000000000 --- a/translations/de-DE/content/admin/user-management/basic-account-settings.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Grundlegende Kontoeinstellungen -intro: 'Sobald Benutzer sich bei {% data variables.product.product_location_enterprise %} authentifizieren können, möchten sie ein paar grundlegende Einstellungen für benutzerdefinierte Profile einrichten. Dazu zählen beispielsweise das Festlegen eines Avatars und E-Mail-Benachrichtigungen.' -redirect_from: - - /enterprise/admin/guides/user-management/enabling-avatars-and-identicons/ - - /enterprise/admin/user-management/basic-account-settings -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/de-DE/content/admin/user-management/changing-authentication-methods.md b/translations/de-DE/content/admin/user-management/changing-authentication-methods.md deleted file mode 100644 index 1495c4d4eda3..000000000000 --- a/translations/de-DE/content/admin/user-management/changing-authentication-methods.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: Authentifizierungsmethoden ändern -intro: 'Sie können jederzeit ändern, wie sich {% data variables.product.prodname_ghe_server %} mit Ihren vorhandenen Konten authentifiziert.' -redirect_from: - - /enterprise/admin/user-management/changing-authentication-methods -versions: - enterprise-server: '*' ---- - -Wenn Sie die Authentifizierungsmethode ändern, werden die Benutzerkonten auf {% data variables.product.product_location_enterprise %} beibehalten, und Benutzer melden sich weiterhin beim selben Konto an, sofern ihr Benutzername nicht geändert wird. - -Wenn bei der neuen Authentifizierungsmethode Benutzernamen geändert werden, werden neue Konten erstellt. As an administrator, you can rename users through the site admin settings or by using [the User Administration API](/enterprise/{{currentVersion}}/v3/enterprise-admin/users/#rename-an-existing-user). - -Zudem sollten Sie die folgenden Issues in Betracht ziehen: - -* **Passwörter:** Wenn Sie auf die Verwendung der integrierten Authentifizierung für Ihre Instanz umsteigen, müssen Benutzer nach der erfolgten Änderung ein [Passwort festlegen](/enterprise/user/articles/how-can-i-reset-my-password/) - -* **Websiteadministratoren:** Verwaltungsberechtigungen werden [durch Ihren Identity Provider gesteuert, wenn Sie SAML verwenden](/enterprise/admin/guides/user-management/using-saml/#saml-attributes), und können [durch die Gruppenmitgliedschaft gesteuert werden, wenn Sie LDAP verwenden](/enterprise/admin/guides/user-management/using-ldap/#configuring-ldap-with-your-github-enterprise-server-instance). - -* **Teammitgliedschaft:** Nur mit LDAP können Sie über Ihren Verzeichnisserver die [Teammitgliedschaft steuern](/enterprise/admin/guides/user-management/using-ldap/#configuring-ldap-with-your-github-enterprise-server-instance). - -* **Benutzersperre:** Wenn Sie LDAP zur Authentifizierung verwenden, kann der Zugriff auf {% data variables.product.prodname_ghe_server %} über _eingeschränkte Gruppen_ gesteuert werden. Nach dem Umstieg auf LDAP werden nach der Konfiguration von eingeschränkten Gruppen vorhandene Benutzer gesperrt, die sich in keiner dieser Gruppen befinden. Die Sperre erfolgt, wenn sie sich anmelden, oder während der nächsten LDAP-Synchronisierung. - -* **Gruppenmitgliedschaft:** Wenn Sie LDAP zur Authentifizierung verwenden, werden Benutzer auf Basis der eingeschränkten Gruppenmitgliedschaft und des Kontostatus mit Active Directory automatisch [gesperrt und entsperrt](/enterprise/admin/guides/user-management/suspending-and-unsuspending-users). - -* **Git-Authentifizierung:** SAML und CAS unterstützen die Git-Authentifizierung über HTTP oder HTTPS nur mit einem [persönlichen Zugriffstoken](/articles/creating-an-access-token-for-command-line-use). Die Passwortauthentifizierung über HTTP oder HTTPS wird nicht unterstützt. LDAP unterstützt standardmäßig die passwortbasierte Git-Authentifizierung. Es wird jedoch empfohlen, dass Sie [diese Methode deaktivieren](/enterprise/admin/guides/user-management/using-ldap/#disabling-password-authentication-for-git-operations) und die Authentifizierung über ein persönliches Zugriffstoken oder über einen SSH-Schlüssel erzwingen. - -* **API-Authentifizierung:** SAML und CAS unterstützen die API-Authentifizierung nur mit einem [persönlichen Zugriffstoken](/articles/creating-an-access-token-for-command-line-use). Die einfache Authentifizierung wird nicht unterstützt. - -* **Zwei-Faktor-Authentifizierung:** {% data reusables.enterprise_user_management.external_auth_disables_2fa %} - -* **Integrierte Authentifizierung für Benutzer außerhalb Ihres Identity Providers:** Sie können Benutzer einladen, sich bei {% data variables.product.product_location_enterprise %} zu authentifizieren, ohne sie zu Ihrem Identity Provider hinzuzufügen. Weitere Informationen finden Sie unter „[Integrierte Authentifizierung für Benutzer außerhalb Ihres Identity Providers zulassen](/enterprise/{{ currentVersion }}/admin/guides/user-management/allowing-built-in-authentication-for-users-outside-your-identity-provider)“. diff --git a/translations/de-DE/content/admin/user-management/disabling-unauthenticated-sign-ups.md b/translations/de-DE/content/admin/user-management/disabling-unauthenticated-sign-ups.md deleted file mode 100644 index cf1d09ba7808..000000000000 --- a/translations/de-DE/content/admin/user-management/disabling-unauthenticated-sign-ups.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: Nicht authentifizierte Registrierungen deaktivieren -redirect_from: - - /enterprise/admin/articles/disabling-sign-ups/ - - /enterprise/admin/user-management/disabling-unauthenticated-sign-ups -intro: 'Wenn Sie die integrierte Authentifizierung verwenden, können Sie nicht authentifizierte Personen mittels Blockierung daran hindern, ein Konto zu erstellen.' -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -3. Deaktivieren Sie **Enable sign-up** (Registrierung aktivieren). ![Kontrollkästchen „Enable sign-up“ (Registrierung aktivieren)](/assets/images/enterprise/management-console/enable-sign-up.png) -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/de-DE/content/admin/user-management/organizations-and-teams.md b/translations/de-DE/content/admin/user-management/organizations-and-teams.md deleted file mode 100644 index 40ec03ac53ec..000000000000 --- a/translations/de-DE/content/admin/user-management/organizations-and-teams.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: Organisationen und Teams -redirect_from: - - /enterprise/admin/articles/adding-users-and-teams/ - - /enterprise/admin/categories/admin-bootcamp/ - - /enterprise/admin/user-management/organizations-and-teams -intro: 'Organisationen eignen sich ideal zum Erstellen von getrennten Benutzergruppen in Ihrem Unternehmen, beispielsweise Abteilungen oder Gruppen, die an ähnlichen Projekten arbeiten. Benutzer in anderen Organisationen können auf öffentliche Repositorys zugreifen, die zu einer Organisation gehören. Demgegenüber können auf private Repositorys nur Mitglieder der Organisation zugreifen.' -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/de-DE/content/admin/user-management/preventing-users-from-changing-a-repositorys-visibility.md b/translations/de-DE/content/admin/user-management/preventing-users-from-changing-a-repositorys-visibility.md deleted file mode 100644 index ea179114aa03..000000000000 --- a/translations/de-DE/content/admin/user-management/preventing-users-from-changing-a-repositorys-visibility.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: Benutzerbedingte Änderung der Sichtbarkeit eines Repositorys verhindern -intro: 'Sie können Mitglieder daran hindern, die Sichtbarkeit der organisationseigenen Repositorys auf Ihrer {% data variables.product.prodname_ghe_server %}-Appliance zu ändern.' -redirect_from: - - /enterprise/admin/guides/user-management/preventing-users-from-changing-a-repository-s-visibility - - /enterprise/admin/user-management/preventing-users-from-changing-a-repositorys-visibility -versions: - enterprise-server: '*' ---- - -Wenn Sie Mitglieder daran hindern, die Sichtbarkeit des Repositorys zu ändern, können nur Websiteadministratoren öffentliche Repositorys als privat oder private Repositorys als öffentlich festlegen. - -Falls ein Websiteadministrator die Möglichkeit der Repository-Erstellung auf Organisationsinhaber beschränkt hat, können Mitglieder die Sichtbarkeit eines Repositorys nicht ändern. Hat ein Websiteadministrator dagegen die Möglichkeit von Mitgliedern auf die Erstellung privater Repositorys beschränkt, können Mitglieder die Sichtbarkeit eines Repositorys von öffentlich auf privat festlegen. Weitere Informationen finden Sie unter „[Repository-Erstellung auf Ihrer Instanz einschränken](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)“. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.policies-tab %} -{% data reusables.enterprise-accounts.repositories-tab %} -5. Überprüfen Sie unter „Repository visibility change“ (Änderung der Repository-Sichtbarkeit) die Informationen zum Ändern der Einstellung. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} - -{% data reusables.enterprise-accounts.repository-visibility-policy %} diff --git a/translations/de-DE/content/admin/user-management/preventing-users-from-changing-anonymous-git-read-access.md b/translations/de-DE/content/admin/user-management/preventing-users-from-changing-anonymous-git-read-access.md deleted file mode 100644 index baede0daa856..000000000000 --- a/translations/de-DE/content/admin/user-management/preventing-users-from-changing-anonymous-git-read-access.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Benutzerbedingte Änderung des anonymen Git-Lesezugriffs verhindern -intro: 'Sie können Repository-Administratoren daran hindern, den anonymen Git-Lesezugriff auf ein Repository{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} oder auf alle Repositorys{% endif %} zu ändern.' -redirect_from: - - /enterprise/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access-to-a-repository/ - - /enterprise/admin/user-management/preventing-users-from-changing-anonymous-git-read-access -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_user_management.disclaimer-for-git-read-access %} - -Um Repository-Administratoren daran zu hindern, die Einstellungen für den anonymen Git-Lesezugriff für ein bestimmtes Repository zu ändern, können Sie die Zugriffseinstellungen für das Repository sperren. Nachdem Sie die Einstellung für den Git-Lesezugriff eines Repositorys gesperrt haben, kann nur ein Websiteadministrator die Einstellung ändern. - -Ein Repository-Administrator kann den anonymen Git-Lesezugriff auf ein öffentliches Repository ändern, falls es kein Fork ist. Weitere Informationen finden Sie unter „[Administratoren das Aktivieren des anonymen Git-Lesezugriffs auf öffentliche Repositorys erlauben](/enterprise/{{ currentVersion }}/admin/guides/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories)“. - -{% data reusables.enterprise_site_admin_settings.list-of-repos-with-anonymous-git-read-access-enabled %} - -### Benutzerbedingte Änderung des anonymen Git-Lesezugriffs für ein Repository verhindern - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -6. Aktivieren Sie unter „Danger Zone“ (Gefahrenzone) die Option **Prevent repository admins from enabling anonymous Git read access** (Repository-Administratoren daran hindern, den anonymen Git-Lesezugriff zu aktivieren). ![Durch die Aktivierung des Kontrollkästchens wird verhindert, dass die Einstellung für den anonymen Git-Lesezugriff auf das Repository geändert werden kann](/assets/images/enterprise/site-admin-settings/lock-repo-from-changing-anonymous-git-read-access.png) - -### Benutzerbedingte Änderung des anonymen Git-Lesezugriffs für alle Repositorys verhindern - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -3. Bestätigen Sie unter „Anonymous Git read access“ (Anonymer Git-Lesezugriff), dass die Einstellung aktiviert ist. Aktivieren Sie anschließend **Prevent repository admins from changing anonymous Git read access** (Repository-Administratoren daran hindern, den anonymen Git-Lesezugriff zu ändern). ![Durch die Aktivierung des Kontrollkästchens wird global verhindert, dass die Einstellung für den anonymen Git-Lesezugriff auf das Repository geändert werden kann](/assets/images/enterprise/site-admin-settings/globally-lock-repos-from-changing-anonymous-git-read-access.png) - diff --git a/translations/de-DE/content/admin/user-management/preventing-users-from-deleting-organization-repositories.md b/translations/de-DE/content/admin/user-management/preventing-users-from-deleting-organization-repositories.md deleted file mode 100644 index 94994231c607..000000000000 --- a/translations/de-DE/content/admin/user-management/preventing-users-from-deleting-organization-repositories.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: Benutzerbedingte Löschung von Organisations-Repositorys verhindern -intro: 'Sie können Benutzer daran hindern, Repositorys in Organisationen auf Ihrer {% data variables.product.prodname_ghe_server %}-Appliance zu löschen oder zu übertragen.' -redirect_from: - - /enterprise/admin/user-management/preventing-users-from-deleting-organization-repositories -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.policies-tab %} -{% data reusables.enterprise-accounts.repositories-tab %} -5. Überprüfen Sie unter „Repository deletion and transfer“ (Repository-Löschung und -Übertragung) die Informationen zum Ändern der Einstellung. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} - -{% data reusables.enterprise-accounts.repository-deletion-policy %} diff --git a/translations/de-DE/content/admin/user-management/repositories.md b/translations/de-DE/content/admin/user-management/repositories.md deleted file mode 100644 index 9c8b2060aa36..000000000000 --- a/translations/de-DE/content/admin/user-management/repositories.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Repositorys -intro: 'Sie können die Repository-Administratoren zur Verfügung stehenden Einstellungen auf Ihrer {% data variables.product.prodname_ghe_server %}-Appliance verwalten.' -mapTopic: true -redirect_from: - - /enterprise/admin/user-management/repositories -versions: - enterprise-server: '*' ---- - diff --git a/translations/de-DE/content/admin/user-management/restricting-repository-creation-in-your-instance.md b/translations/de-DE/content/admin/user-management/restricting-repository-creation-in-your-instance.md deleted file mode 100644 index 76621056c62a..000000000000 --- a/translations/de-DE/content/admin/user-management/restricting-repository-creation-in-your-instance.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: Repository-Erstellung auf Ihrer Instanz einschränken -intro: 'Du kannst wählen, ob Organisationsmitglieder auf Deinem {% data variables.product.prodname_ghe_server %}-Gerät Repositorys erstellen können und welche Arten von Repositorys Mitglieder erstellen können.' -redirect_from: - - /enterprise/admin/user-management/restricting-repository-creation-in-your-instance -versions: - enterprise-server: '*' ---- - -{% data reusables.organizations.repo-creation-constants %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.policies-tab %} -{% data reusables.enterprise-accounts.repositories-tab %} -5. Überprüfen Sie unter „Repository creation“ (Repository-Erstellung) die Informationen zum Ändern der Einstellung. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} -{% if currentVersion ver_gt "enterprise-server@2.19" %} -{% data reusables.enterprise-accounts.repo-creation-policy %} -{% data reusables.enterprise-accounts.repo-creation-types %} -{% else %} -6. Wählen Sie im Dropdownmenü unter „Repository creation“ (Repository-Erstellung) eine Richtlinie aus. ![Dropdownmenü mit Richtlinien zur Repository-Erstellung](/assets/images/enterprise/site-admin-settings/repository-creation-drop-down.png) -{% endif %} diff --git a/translations/de-DE/content/admin/user-management/user-security.md b/translations/de-DE/content/admin/user-management/user-security.md deleted file mode 100644 index a3f3b3617c20..000000000000 --- a/translations/de-DE/content/admin/user-management/user-security.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Benutzersicherheit -intro: 'Stellen Sie sicher, dass Ihre {% data variables.product.prodname_ghe_server %}-Benutzer sicher sind. Sie können ihre Sicherheitseinstellungen überwachen oder instanzweite Best Practices erzwingen.' -mapTopic: true -redirect_from: - - /enterprise/admin/user-management/user-security -versions: - enterprise-server: '*' ---- - diff --git a/translations/de-DE/content/admin/user-management/using-built-in-authentication.md b/translations/de-DE/content/admin/user-management/using-built-in-authentication.md deleted file mode 100644 index e73044baf4d8..000000000000 --- a/translations/de-DE/content/admin/user-management/using-built-in-authentication.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: Integrierte Authentifizierung verwenden -intro: 'Wenn Sie die standardmäßige Authentifizierungsmethode verwenden, werden alle Authentifizierungsdetails in {% data variables.product.product_location_enterprise %} gespeichert. Die integrierte Authentifizierung ist die Standardmethode, wenn Sie nicht bereits über einen etablierten Authentifizierungsanbieter wie LDAP, SAML oder CAS verfügen.' -redirect_from: - - /enterprise/admin/user-management/using-built-in-authentication -versions: - enterprise-server: '*' ---- - -Du kannst frei definierbare Nachrichten erstellen, die Benutzern auf den Anmelde- und Abmeldeseiten angezeigt werden. Weitere Informationen finden Sie unter „[Benutzermeldungen auf Ihrer Instanz anpassen](/enterprise/admin/user-management/customizing-user-messages-on-your-instance)“. - -### Integrierte Authentifizierung konfigurieren - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.authentication %} -4. Wählen Sie **Built in authentication** (Integrierte Authentifizierung) aus. ![Option zur Auswahl der integrierten Authentifizierung](/assets/images/enterprise/management-console/built-in-auth-select.png) - -{% data reusables.enterprise_user_management.two_factor_auth_header %} -{% data reusables.enterprise_user_management.2fa_is_available %} - -### Ihr Konto erstellen und Benutzer hinzufügen - -Nachdem Ihre Instanz erstellt wurde, müssen Sie Ihr eigenes Administratorkonto erstellen und es zum Verteilen von Benutzern verwenden. - -1. Wählen Sie auf der Seite „Create Admin Account“ (Administratorkonto erstellen) unter `http(s)://[hostname]/join` Ihren Benutzernamen, Ihr Passwort und Ihre E-Mail-Adresse aus, und klicken Sie anschließend auf **Create an account** (Konto erstellen). ![Admin-Account erstellen](/assets/images/enterprise/site-admin-settings/create-first-admin-acct.png) -{% data reusables.enterprise_site_admin_settings.sign-in %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.invite-user-sidebar-tab %} -{% data reusables.enterprise_site_admin_settings.invite-user-reset-link %} diff --git a/translations/de-DE/content/admin/user-management/using-cas.md b/translations/de-DE/content/admin/user-management/using-cas.md deleted file mode 100644 index b73e07d707e3..000000000000 --- a/translations/de-DE/content/admin/user-management/using-cas.md +++ /dev/null @@ -1,43 +0,0 @@ ---- -title: CAS verwenden -redirect_from: - - /enterprise/admin/articles/configuring-cas-authentication/ - - /enterprise/admin/articles/about-cas-authentication/ - - /enterprise/admin/user-management/using-cas -intro: 'CAS ist ein Single Sign-On-Protokoll (SSO) für mehrere Webanwendungen. Ein CAS-Benutzerkonto übernimmt eine(n) {% if currentVersion ver_gt "enterprise-server@2.16" %}Benutzerlizenz{% else %}Benutzer{% endif %} erst nach Anmeldung des Benutzers.' -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_user_management.built-in-authentication %} - -### Grundlegendes für Benutzernamen bei CAS - -{% data reusables.enterprise_management_console.username_normalization %} - -{% data reusables.enterprise_management_console.username_normalization_sample %} - -{% data reusables.enterprise_user_management.two_factor_auth_header %} -{% data reusables.enterprise_user_management.external_auth_disables_2fa %} - -### CAS-Attribute - -Die folgenden Attribute sind verfügbar. - -| Attributname | Typ | Beschreibung | -| ------------ | ------------ | ------------------------------------------------------------------------- | -| `username` | Erforderlich | Der {% data variables.product.prodname_ghe_server %}-Benutzername. | - -### CAS konfigurieren -{% warning %} - -**Warnung:** Bevor Sie CAS auf {% data variables.product.product_location_enterprise %} konfigurieren, sollten Sie beachten, dass Benutzer ihre CAS-Benutzernamen und -Passwörter nicht verwenden können, um API-Anforderungen oder Git-Vorgänge über HTTP/HTTPS zu authentifizieren. Stattdessen müssen sie ein [Zugriffstoken erstellen](/enterprise/{{ currentVersion }}/user/articles/creating-an-access-token-for-command-line-use). - -{% endwarning %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.authentication %} -3. Wählen Sie **CAS** aus. ![CAS-Auswahl](/assets/images/enterprise/management-console/cas-select.png) -4. {% data reusables.enterprise_user_management.built-in-authentication-option %} ![Aktivierung des Kontrollkästchen für integrierte CAS-Authentifizierung](/assets/images/enterprise/management-console/cas-built-in-authentication.png) -5. Geben Sie im Feld **Server URL** (Server-URL) die vollständige URL Ihres CAS-Servers ein. Wenn Ihr CAS-Server ein Zertifikat verwendet, das von {% data variables.product.prodname_ghe_server %} nicht validiert werden kann, können Sie den Befehl `ghe-ssl-ca-certificate-install` ausführen, um es als ein vertrauenswürdiges Zertifikat zu installieren. diff --git a/translations/de-DE/content/admin/user-management/using-ldap.md b/translations/de-DE/content/admin/user-management/using-ldap.md deleted file mode 100644 index 203b32d3a3dd..000000000000 --- a/translations/de-DE/content/admin/user-management/using-ldap.md +++ /dev/null @@ -1,190 +0,0 @@ ---- -title: LDAP verwenden -redirect_from: - - /enterprise/admin/articles/configuring-ldap-authentication/ - - /enterprise/admin/articles/about-ldap-authentication/ - - /enterprise/admin/articles/viewing-ldap-users/ - - /enterprise/admin/hidden/enabling-ldap-sync/ - - /enterprise/admin/hidden/ldap-sync/ - - /enterprise/admin/user-management/using-ldap -intro: 'Mithilfe von LDAP können Sie {% data variables.product.prodname_ghe_server %} bei Ihren vorhandenen Konten authentifizieren und den Zugriff auf Repositorys zentral verwalten. LDAP ist ein beliebtes Anwendungsprotokoll für den Zugriff auf und die Verwaltung von Verzeichnisinformationsdiensten. Zudem ist es eines der gängigsten Protokolle zur Integration von Drittanbietersoftware in große Benutzerverzeichnisse von Unternehmen.' -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_user_management.built-in-authentication %} - -### Unterstützte LDAP-Dienste - -{% data variables.product.prodname_ghe_server %} lässt sich in die folgenden LDAP-Dienste integrieren: - -* Active Directory -* FreeIPA -* Oracle Directory Server Enterprise Edition -* OpenLDAP -* Open Directory -* 389-ds - -### Grundlegendes für Benutzernamen bei LDAP - -{% data reusables.enterprise_management_console.username_normalization %} - -{% data reusables.enterprise_management_console.username_normalization_sample %} - -{% data reusables.enterprise_user_management.two_factor_auth_header %} -{% data reusables.enterprise_user_management.2fa_is_available %} - -### LDAP für {% data variables.product.product_location_enterprise %} konfigurieren - -Nach der Konfiguration von LDAP können sich Benutzer mit ihren LDAP-Anmeldeinformationen bei Ihrer Instanz anmelden. Wenn sich Benutzer erstmals anmelden, werden ihre Profilnamen, E-Mail-Adressen und SSH-Schlüssel mit den LDAP-Attributen aus Ihrem Verzeichnis festgelegt. - -Wenn Du LDAP-Zugriff für Benutzer über die {% data variables.enterprise.management_console %} konfigurierst, werden Deine Benutzerlizenzen erst verwendet, sobald sich ein Benutzer bei Deiner Instanz zum ersten Mal anmeldet. Wenn Du jedoch ein Konto manuell in den Website-Administratoreinstellungen erstellst, wird die Benutzerlizenz sofort gezählt. - -{% warning %} - -**Warnung:** Stellen Sie sicher, dass Ihr LDAP-Dienst seitenweise Ergebnisse unterstützt, bevor Sie LDAP auf {% data variables.product.product_location_enterprise %} konfigurieren. - -{% endwarning %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.authentication %} -3. Wählen Sie **LDAP** unter „Authentication“ (Authentifizierung) aus. ![LDAP-Auswahl](/assets/images/enterprise/management-console/ldap-select.png) -4. {% data reusables.enterprise_user_management.built-in-authentication-option %} ![Aktivierung des Kontrollkästchen für integrierte LDAP-Authentifizierung](/assets/images/enterprise/management-console/ldap-built-in-authentication.png) -5. Fügen Sie die gewünschten Konfigurationseinstellungen hinzu. - -### LDAP-Attribute -Verwenden Sie die folgenden Attribute, um die Konfiguration von LDAP für {% data variables.product.product_location_enterprise %} abzuschließen. - -| Attributname | Typ | Beschreibung | -| ------------------------------------------------ | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `Host` | Erforderlich | Der LDAP-Host, z. B. `ldap.example.com` oder `10.0.0.30`. Wenn der Hostnamen nur in Ihrem internen Netzwerk verfügbar ist, müssen Sie möglicherweise zunächst den DNS von {% data variables.product.product_location_enterprise %} konfigurieren, damit der Hostname mithilfe Ihrer internen Nameserver aufgelöst werden kann. | -| `Port` | Required | Der Port, der von den LDAP-Diensten des Hosts überwacht wird. Beispiele: 389 und 636 (für LDAPS). | -| `Encryption` | Erforderlich | Die Verschlüsselungsmethode, die verwendet wird, um Kommunikationen zum LDAP-Server zu schützen. Dazu zählen beispielsweise Nur-Text (keine Verschlüsselung), SSL/LDAPS (von Anfang an verschlüsselt) und StartTLS (Upgrade auf verschlüsselte Kommunikation nach dem Herstellen der Verbindung). | -| `Domain search user` | Optional | Der LDAP-Benutzer, der Benutzernachschlagevorgänge durchführt, um andere Benutzer bei ihrer Anmeldung zu authentifizieren. In der Regel handelt es sich dabei um ein Dienstkonto, das speziell für Drittanbieterintegrationen erstellt wird. Verwenden Sie einen vollqualifizierten Namen, beispielsweise `cn=Administrator,cn=Users,dc=Example,dc=com`. Mit Active Directory können Sie zudem die Syntax `[DOMAIN]\[USERNAME]` (z. B. `WINDOWS\Administrator`) für den Benutzer der Domain-Suche mit Active Directory verwenden. | -| `Domain search password` | Optional | Das Passwort für den Benutzer der Domain-Suche. | -| `Administrators group` | Optional | Benutzer in dieser Gruppe werden auf Websiteadministratoren hochgestuft, wenn sie sich bei Ihrer Appliance anmelden. Wenn Sie keine Gruppe für LDAP-Administratoren konfigurieren, wird das erste LDAP-Benutzerkonto, das sich bei Ihrer Appliance anmeldet, automatisch auf einen Websiteadministrator hochgestuft. | -| `Domain base` | Erforderlich | Der vollqualifizierte `Distinguished Name` (DN) einer LDAP-Unterstruktur, die auf Benutzer und Gruppen durchsucht werden soll. Sie können beliebig viele hinzufügen. Jede Gruppe muss jedoch in derselben Domain-Basis definiert sein wie die zugehörigen Benutzer. Wenn Sie eingeschränkte Benutzergruppen angeben, befinden sich nur die diesen Gruppen zugehörigen Benutzer im Geltungsbereich. Zum Steuern des Zugriffs sollten Sie die oberste Ebene Ihrer LDAP-Verzeichnisstruktur als Ihre Domain-Basis angeben und eingeschränkte Benutzergruppen verwenden. | -| `Restricted user groups` | Optional | Wenn diese Option angegeben ist, können sich nur die Benutzer dieser Gruppen anmelden. Sie müssen nur die allgemeinen Namen (Common Names, CNs) der Gruppen angeben. Zudem können Sie beliebig viele Gruppen hinzufügen. Sind keine Gruppen angegeben, können sich *alle* Benutzer im Geltungsbereich der angegebenen Domain-Basis bei Ihrer {% data variables.product.prodname_ghe_server %}-Instanz anmelden. | -| `User ID` | Erforderlich | Das LDAP-Attribut, das den LDAP-Benutzer identifiziert, der versucht, sich zu authentifizieren. Nach dem Herstellen einer Zuordnung können Benutzer ihre {% data variables.product.prodname_ghe_server %}-Benutzernamen ändern. Dieses Feld sollte für die meisten Active Directory-Installationen `sAMAccountName` lauten. Für andere LDAP-Lösungen wie OpenLDAP lautet es ggf. `uid`. Der Standardwert lautet `uid`. | -| `Profilname` | Optional | Der Name, der auf der {% data variables.product.prodname_ghe_server %}-Profilseite des Benutzers angezeigt wird. Sofern die LDAP-Synchronisierung nicht aktiviert ist, können Benutzer ihre Profilnamen ändern. | -| `Emails` | Optional | Die E-Mail-Adressen für das {% data variables.product.prodname_ghe_server %}-Konto eines Benutzers. | -| `SSH keys` | Optional | Die öffentlichen SSH-Schlüssel, die an das {% data variables.product.prodname_ghe_server %}-Konto eines Benutzers angehängt sind. Die Schlüssel müssen im OpenSSH-Format vorliegen. | -| `GPG keys` | Optional | Die GPG-Schlüssel, die an das {% data variables.product.prodname_ghe_server %}-Konto eines Benutzers angehängt sind. | -| `Disable LDAP authentication for Git operations` | Optional | Wenn diese Option ausgewählt ist, wird die Möglichkeit der Benutzer [deaktiviert](#disabling-password-authentication-for-git-operations), LDAP-Passwörter zur Authentifizierung von Git-Vorgängen zu verwenden. | -| `Enable LDAP certificate verification` | Optional | Wenn diese Option ausgewählt ist, wird die LDAP-Zertifikatsverifizierung [aktiviert](#enabling-ldap-certificate-verification). | -| `Synchronization` | Optional | Wenn diese Option ausgewählt ist, wird die LDAP-Synchronisierung [aktiviert](#enabling-ldap-sync). | - -#### Passwortauthentifizierung für Git-Vorgänge deaktivieren - -Aktivieren Sie **Disable username and password authentication for Git operations** (Authentifizierung mittels Benutzername und Passwort für Git-Vorgänge deaktivieren) in Ihren LDAP-Einstellungen, um die Verwendung von persönlichen Zugriffstoken oder SSH-Schlüsseln für den Git-Zugriff zu erzwingen, wodurch verhindert werden kann, dass Ihr Server von LDAP-Authentifizierungsanforderungen überladen wird. Diese Einstellung wird empfohlen, da ein langsam reagierender LDAP-Server, insbesondere in Kombination mit einer Vielzahl an Anforderungen (infolge des automatischen Abrufens) häufig für Leistungsprobleme und Ausfälle verantwortlich ist. - -![Kontrollkästchen zum Deaktivieren der LDAP-Passwortauthentifizierung für Git](/assets/images/enterprise/management-console/ldap-disable-password-auth-for-git.png) - -Wenn ein Benutzer bei Auswahl dieser Option versucht, ein Passwort für Git-Vorgänge an der Befehlszeile zu verwenden, wird die Fehlermeldung `Password authentication is not allowed for Git operations. You must use a personal access token` angezeigt. - -#### LDAP-Zertifikatsverifizierung aktivieren - -Wählen Sie **Enable LDAP certificate verification** (LDAP-Zertifikatsverifizierung aktivieren) in Ihren LDAP-Einstellungen aus, um das von Ihnen verwendete LDAP-Serverzertifikat mit TLS zu validieren. - -![Feld für die LDAP-Zertifikatsverifizierung](/assets/images/enterprise/management-console/ldap-enable-certificate-verification.png) - -Wenn diese Option ausgewählt ist, wird das Zertifikat validiert, um Folgendes sicherzustellen: -- Wenn das Zertifikat mindestens einen Subject Alternative Name (SAN) enthält, stimmt einer der SANs mit dem LDAP-Hostnamen überein. Andernfalls stimmt der allgemeine Name (Common Name, CN) mit dem LDAP-Hostnamen überein. -- Das Zertifikat ist nicht abgelaufen. -- Das Zertifikat wurde von einer vertrauenswürdigen Zertifizierungsstelle (CA) signiert. - -#### LDAP-Synchronisierung aktivieren - -Mithilfe der LDAP-Synchronisierung können Sie {% data variables.product.prodname_ghe_server %}-Benutzer und die -Teammitgliedschaft mit Ihren festgelegten LDAP-Gruppen synchronisieren. Dadurch können Sie eine rollenbasierte Zugriffskontrolle (Role-Based Access Control, RBAC) für Benutzer von Ihrem LDAP-Server aus einrichten, anstatt manuell innerhalb von {% data variables.product.prodname_ghe_server %}. Weitere Informationen finden Sie unter „[Teams erstellen](/enterprise/{{ currentVersion }}/admin/guides/user-management/creating-teams#creating-teams-with-ldap-sync-enabled)“. - -Wählen Sie **Synchronize Emails** (E-Mails synchronisieren), **Synchronize SSH Keys** (SSH-Schlüssel synchronisieren) oder **Synchronize GPG Keys** (GPG-Schlüssel synchronisieren) aus, um die LDAP-Synchronisierung zu aktivieren. - -![Kontrollkästchen für die Synchronisierung](/assets/images/enterprise/management-console/ldap-synchronize.png) - -Nach der Aktivierung der LDAP-Synchronisierung wird ein Synchronisierungsauftrag entsprechend dem angegebenen Zeitintervall ausgeführt, um die folgenden Vorgänge in jedem Benutzerkonto durchzuführen: - -- Wenn Sie die integrierte Authentifizierung für Benutzer außerhalb Ihres Identity Providers erlaubt haben und der Benutzer die integrierte Authentifizierung verwendet, können Sie zum nächsten Benutzer wechseln. -- Wenn für den Benutzer keine LDAP-Zuordnung vorliegt, sollten Sie versuchen, den Benutzer einem LDAP-Eintrag im Verzeichnis zuzuordnen. Wenn es nicht möglich ist, den Benutzer einem LDAP-Eintrag zuzuordnen, sperren Sie den Benutzer, und wechseln Sie zum nächsten Benutzer. -- Wenn eine LDAP-Zuordnung vorliegt, der entsprechende LDAP-Eintrag im Verzeichnis jedoch fehlt, sperren Sie den Benutzer, und wechseln Sie zum nächsten Benutzer. -- Wenn der entsprechende LDAP-Eintrag als deaktiviert markiert wurde und der Benutzer nicht bereits gesperrt ist, sperren Sie den Benutzer, und wechseln Sie zum nächsten Benutzer. -- Wenn der entsprechende LDAP-Eintrag nicht als deaktiviert markiert ist, der Benutzer gesperrt ist und _Reactivate suspended users_ (Gesperrte Benutzer erneut aktivieren) im Admin-Center aktiviert ist, entsperren Sie den Benutzer. -- Wenn der entsprechende LDAP-Eintrag das Attribut `name` enthält, aktualisieren Sie den Profilnamen des Benutzers. -- Wenn sich der entsprechende LDAP-Eintrag in der Gruppe „Administrators“ (Administratoren) befindet, stufen Sie den Benutzer auf einen Websiteadministrator hoch. -- Wenn sich der entsprechende LDAP-Eintrag nicht in der Gruppe „Administrators“ (Administratoren) befindet, stufen Sie den Benutzer auf ein normales Konto zurück. -- Wenn das Feld „LDAP User“ (LDAP-Benutzer) für E-Mails festgelegt ist, synchronisieren Sie die E-Mail-Einstellungen des Benutzers mit dem LDAP-Eintrag. Legen Sie den ersten LDAP-Eintrag vom Typ `mail` als die primäre E-Mail fest. -- Wenn das Feld „LDAP User“ (LDAP-Benutzer) für öffentliche SSH-Schlüssel festgelegt ist, synchronisieren Sie die öffentlichen SSH-Schlüssel des Benutzers mit dem LDAP-Eintrag. -- Wenn das Feld „LDAP User“ (LDAP-Benutzer) für GPG-Schlüssel festgelegt ist, synchronisieren Sie die GPG-Schlüssel des Benutzers mit dem LDAP-Eintrag. - -{% note %} - -**Hinweis**: LDAP-Einträge können nur dann als deaktiviert markiert werden, wenn Sie Active Directory verwenden und das Attribut `userAccountControl` vorhanden und mit `ACCOUNTDISABLE` gekennzeichnet ist. - -{% endnote %} - -Darüber hinaus wird ein Synchronisierungsauftrag im angegebenen Zeitintervall ausgeführt, um die folgenden Aktionen für jedes Team durchzuführen, das einer LDAP-Gruppe zugeordnet wurde: - -- Wenn die entsprechende LDAP-Gruppe eines Teams entfernt wurde, entfernen Sie alle Mitglieder aus dem Team. -- Wenn Einträge von LDAP-Mitgliedern aus der LDAP-Gruppe entfernt wurden, entfernen Sie die entsprechenden Benutzer aus dem Team. Wenn der Benutzer den Zugriff auf die Repositorys verloren hat, löschen Sie die privaten Forks, die der Benutzer für diese Repositorys besitzt. -- Wenn die LDAP-Mitgliedereinträge zur LDAP-Gruppe hinzugefügt wurden, fügen Sie die entsprechenden Benutzer dem Team hinzu. Wenn der Benutzer den Zugriff auf Repositorys zurückerlangt, sollten Sie die privaten Forks der Repositorys wiederherstellen, die gelöscht wurden, weil der Benutzer den Zugriff in den vergangenen 90 Tagen verloren hat. - -{% data reusables.enterprise_user_management.ldap-sync-nested-teams %} - -{% warning %} - -**Sicherheitswarnung:** - -Wenn die LDAP-Synchronisierung aktiviert ist, können Websiteadministratoren und Organisationsinhaber das LDAP-Verzeichnis nach Gruppen durchsuchen, um sie dem Team zuzuordnen. - -Dadurch können sensible Organisationsinformationen potenziell Vertragsnehmern oder anderen nicht privilegierten Benutzern offengelegt werden, darunter - -- die Verfügbarkeit von spezifischen LDAP-Gruppen, die für den *Benutzer der Domain-Suche* sichtbar sind, -- Mitglieder der LDAP-Gruppe, die über {% data variables.product.prodname_ghe_server %}-Benutzerkonten verfügen, die beim Erstellen eines Teams offengelegt werden, das mit dieser LDAP-Gruppe synchronisiert ist. - -Wenn die Offenlegung solcher Informationen nicht gewünscht wird, sollte Ihr Unternehmen oder Ihre Organisation in der Administratorkonsole die Berechtigungen des konfigurierten *Benutzers der Domain-Suche* einschränken. Ist eine solche Einschränkung nicht möglich, wenden Sie sich an {% data variables.contact.contact_ent_support %}. - -{% endwarning %} - -#### Unterstützte LDAP-Gruppenobjektklassen - -{% data variables.product.prodname_ghe_server %} unterstützt die folgenden LDAP-Gruppenobjektklassen. Gruppen können verschachtelt werden. - -- `Gruppe` -- `groupOfNames` -- `groupOfUniqueNames` -- `posixGroup` - -### LDAP-Benutzer anzeigen und erstellen - -Sie können die vollständige Liste der LDAP-Benutzer anzeigen, die Zugriff auf Ihre Instanz besitzen, und neue Benutzer bereitstellen. - -{% data reusables.enterprise_site_admin_settings.sign-in %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -3. Klicken Sie auf der linken Seitenleiste auf **LDAP users** (LDAP-Benutzer). ![Registerkarte „LDAP users“ (LDAP-Benutzer)](/assets/images/enterprise/site-admin-settings/ldap-users-tab.png) -4. Geben Sie bei der Suche nach einem Benutzer einen vollständigen oder den Teil eines Benutzernamens ein, und klicken Sie auf **Search** (Suchen). Die vorhandenen Benutzer werden in den Suchergebnissen angezeigt. Wenn ein Benutzer nicht vorhanden ist, klicken Sie auf **Create** (Erstellen), um das neue Benutzerkonto bereitzustellen. ![LDAP-Suche](/assets/images/enterprise/site-admin-settings/ldap-users-search.png) - -### LDAP-Konten aktualisieren - -Sofern die [LDAP-Synchronisierung nicht aktiviert ist](#enabling-ldap-sync), werden Änderungen an LDAP-Konten nicht automatisch mit {% data variables.product.prodname_ghe_server %} synchronisiert. - -* Zum Verwenden einer neuen LDAP-Administratorgruppe müssen die Benutzer manuell auf {% data variables.product.prodname_ghe_server %} hoch- und zurückgestuft werden, um die Änderungen in LDAP zu berücksichtigen. -* [Stufen Sie die Konten auf {% data variables.product.prodname_ghe_server %} hoch und zurück](/enterprise/{{ currentVersion }}/admin/guides/user-management/promoting-or-demoting-a-site-administrator), um LDAP-Konten in LDAP-Administratorgruppen hinzuzufügen oder zu entfernen. -* [Sperren Sie die {% data variables.product.prodname_ghe_server %}-Konten](/enterprise/{{ currentVersion }}/admin/guides/user-management/suspending-and-unsuspending-users), wenn Sie die LDAP-Konten entfernen möchten. - -#### LDAP-Konten manuell synchronisieren - -{% data reusables.enterprise_site_admin_settings.sign-in %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.search-user %} -{% data reusables.enterprise_site_admin_settings.click-user %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -5. Klicken Sie unter „LDAP“ auf **Sync now** (Jetzt synchronisieren), um das Konto mit den Daten Ihres LDAP-Servers manuell zu aktualisieren. ![Schaltfläche „Sync now“ (Jetzt synchronisieren) für LDAP](/assets/images/enterprise/site-admin-settings/ldap-sync-now-button.png) - -You can also [use the API to trigger a manual sync](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#ldap). - -### Zugriff auf {% data variables.product.product_location_enterprise %} widerrufen - -Bei [aktivierter LDAP-Synchronisierung](#enabling-ldap-sync) wird beim Entfernen der LDAP-Anmeldeinformationen eines Benutzers dessen Konto nach der nächsten Synchronisierungsausführung gesperrt. - -Bei **nicht** aktivierter LDAP-Synchronisierung müssen Sie das {% data variables.product.prodname_ghe_server %}-Konto nach dem Entfernen der LDAP-Anmeldeinformationen manuell sperren. Weitere Informationen finden Sie unter „[Benutzer sperren und entsperren](/enterprise/{{ currentVersion }}/admin/guides/user-management/suspending-and-unsuspending-users)“. diff --git a/translations/de-DE/content/admin/user-management/using-saml.md b/translations/de-DE/content/admin/user-management/using-saml.md deleted file mode 100644 index 043ecc94c716..000000000000 --- a/translations/de-DE/content/admin/user-management/using-saml.md +++ /dev/null @@ -1,137 +0,0 @@ ---- -title: SAML verwenden -redirect_from: - - /enterprise/admin/articles/configuring-saml-authentication/ - - /enterprise/admin/articles/about-saml-authentication/ - - /enterprise/admin/user-management/using-saml -intro: 'SAML ist ein XML-basierter Standard für die Authentifizierung und Autorisierung. {% data variables.product.prodname_ghe_server %} kann als ein Service Provider (SP) mit Ihrem internen SAML Identity Provider (IdP) funktionieren.' -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_user_management.built-in-authentication %} - -### Unterstützte SAML-Dienste - -{% data reusables.saml.saml-supported-idps %} - -{% data reusables.saml.saml-single-logout-not-supported %} - -### Grundlegendes für Benutzernamen bei SAML - -Jeder {% data variables.product.prodname_ghe_server %}-Benutzername wird nach Priorität geordnet durch eine der folgenden Assertions in der SAML-Antwort bestimmt: - -- das benutzerdefinierte Attribut für den Benutzernamen, sofern definiert und vorhanden -- eine ggf. vorhandene Assertion `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name` -- eine ggf. vorhandene Assertion `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress` -- das Element `NameID` - -Das Element `NameID` ist selbst dann erforderlich, wenn andere Attribute vorhanden sind. - -Zwischen `NameID` und dem {% data variables.product.prodname_ghe_server %}-Benutzernamen wird eine Zuordnung erstellt, daher sollte `NameID` persistent, eindeutig und für den Lebenszyklus des Benutzers nicht änderbar sein. - -{% data reusables.enterprise_management_console.username_normalization %} - -{% data reusables.enterprise_management_console.username_normalization_sample %} - -{% data reusables.enterprise_user_management.two_factor_auth_header %} -{% data reusables.enterprise_user_management.external_auth_disables_2fa %} - -### SAML-Metadaten - -Die Service Provider-Metadaten Ihrer {% data variables.product.prodname_ghe_server %}-Instanzen sind unter `http(s)://[hostname]/saml/metadata` verfügbar. - -Wenn Sie Ihren Identity Provider manuell konfigurieren möchten, lautet die Assertionsverbraucherdienst-URL (ACS) `http(s)://[hostname]/saml/consume`. Dafür wird die Bindung `urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST` verwendet. - -### SAML-Attribute - -Die folgenden Attribute sind verfügbar. Mit Ausnahme der `administrator`-Attribute können Sie die Attributnamen in der [Managementkonsole](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-management-console/) ändern. - -| Standardmäßiger Attributname | Typ | Beschreibung | -| ---------------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `NameID` | Erforderlich | Ein persistenter Benutzerkennzeichner. Es kann ein beliebiges Format für persistente Namenskennzeichner verwendet werden. Das Element `NameID` wird für einen {% data variables.product.prodname_ghe_server %}-Benutzernamen verwendet, sofern keine der alternativen Assertions bereitgestellt wird. | -| `administrator` | Optional | Wenn der Wert „true“ lautet, wird der Benutzer automatisch zu einem Administrator hochgestuft. Bei anderen oder nicht vorhandenen Werten wird der Benutzer auf ein normales Benutzerkonto zurückgestuft. | -| `Benutzername` | Optional | Der {% data variables.product.prodname_ghe_server %}-Benutzername. | -| `full_name` | Optional | Der Name des Benutzers, der auf seiner Profilseite angezeigt wird. Nach der Bereitstellung können Benutzer ihre Namen ändern. | -| `emails` | Optional | Die E-Mail-Adressen für den Benutzer. Es können mehrere angegeben werden. | -| `public_keys` | Optional | Die öffentlichen SSH-Schlüssel für den Benutzer. Es können mehrere angegeben werden. | -| `gpg_keys` | Optional | Die GPG-Schlüssel für den Benutzer. Es können mehrere angegeben werden. | - -### SAML-Einstellungen konfigurieren - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.authentication %} -3. Wählen Sie **SAML** aus. ![SAML-Authentifizierung](/assets/images/enterprise/management-console/auth-select-saml.png) -4. {% data reusables.enterprise_user_management.built-in-authentication-option %} ![Aktivierung des Kontrollkästchens für integrierte SAML-Authentifizierung](/assets/images/enterprise/management-console/saml-built-in-authentication.png) -5. Wählen Sie optional zum Aktivieren des Unsolicited-Response-SSOs die Option **IdP initiated SSO** (IdP-initiiertes SSO) aus. {% data variables.product.prodname_ghe_server %} antwortet auf eine von einem Identity Provider (IdP) initiierte unaufgeforderte Anforderung standardmäßig durch das Zurücksenden einer `AuthnRequest` an den IdP. ![IdP-SSO über SAML](/assets/images/enterprise/management-console/saml-idp-sso.png) - - {% tip %} - - **Hinweis**: Der Wert sollte bei **unselected** (Nicht ausgewählt) belassen werden. Sie sollten dieses Feature **nur** dann aktivieren, wenn Ihre SAML-Implementierung das vom Service Provider initiierte SSO nicht unterstützt und Sie vom {% data variables.contact.enterprise_support %} dazu angewiesen werden. - - {% endtip %} - -5. Wählen Sie **Disable administrator demotion/promotion** (Hochstufen/Zurücksetzen des Administrators deaktivieren) aus, wenn Sie **nicht** möchten, dass Ihr SAML-Anbieter die Administratorrechte für Benutzer auf {% data variables.product.product_location_enterprise %} bestimmen kann. ![SAML-Konfiguration zum Deaktivieren der Administratoroption](/assets/images/enterprise/management-console/disable-admin-demotion-promotion.png) -6. Geben Sie im Feld **Single sign-on URL** (Single Sign-On-URL) den HTTP- oder HTTPS-Endpunkt für Ihren IdP für Single Sign-On-Anforderungen ein. Dieser Wert wird durch Ihre IdP-Konfiguration angegeben. Wenn der Host in Ihrem internen Netzwerk nicht verfügbar ist, müssen Sie [{% data variables.product.product_location_enterprise %} ggf. zur Verwendung interner Nameserver konfigurieren](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-dns-nameservers/). ![SAML-Authentifizierung](/assets/images/enterprise/management-console/saml-single-sign-url.png) -7. Geben Sie optional im Feld **Issuer** (Aussteller) den Namen Ihres SAML-Ausstellers ein. Dadurch wird die Authentizität von Nachrichten verifiziert, die an {% data variables.product.product_location_enterprise %} gesendet werden. ![SAML-Aussteller](/assets/images/enterprise/management-console/saml-issuer.png) -8. Wählen Sie in den Dropdownmenüs **Signature Method** (Signaturmethode) und **Digest Method** (Digest-Methode) den von Ihrem SAML-Aussteller verwendeten Hashalgorithmus aus, um die Integrität der Anforderungen von {% data variables.product.product_location_enterprise %} zu verifizieren. Geben Sie das Format mit dem Dropdownmenü **Name Identifier Format** (Format für Namenskennzeichner) an. ![SAML-Methode](/assets/images/enterprise/management-console/saml-method.png) -9. Klicken Sie unter **Verification certificate** (Verifizierungszertifikat) auf **Choose File** (Datei auswählen), und wählen Sie ein Zertifikat aus, um Ihre SAML-Antworten vom IdP zu validieren. ![SAML-Authentifizierung](/assets/images/enterprise/management-console/saml-verification-cert.png) -10. Ändern Sie die SAML-Attributnamen bei Bedarf so, dass sie mit Ihrem IdP übereinstimmen, oder akzeptieren Sie die Standardnamen.![SAML-Attributnamen](/assets/images/enterprise/management-console/saml-attributes.png) - -### Zugriff auf {% data variables.product.product_location_enterprise %} widerrufen - -Wenn Sie einen Benutzer von Ihrem Identity Provider entfernen, müssen Sie ihn zudem manuell sperren. Andernfalls kann er sich weiterhin mithilfe der Zugriffstoken oder SSH-Schlüssel authentifizieren. Weitere Informationen finden Sie unter „[Benutzer sperren und entsperren](/enterprise/admin/guides/user-management/suspending-and-unsuspending-users)“. - -### Anforderungen für die Antwortmeldung - -Die Antwortmeldung muss die folgenden Anforderungen erfüllen: - -- Das Element `` muss im Root-Antwortdokument bereitgestellt werden und mit der ACS-URL übereinstimmen, und zwar genau dann, wenn das Root-Antwortdokument signiert ist. Wenn die Assertion signiert ist, wird es ignoriert. -- Das Element `` muss immer als Bestandteil des Elements `` angegeben werden. Es muss zur {% data variables.product.prodname_ghe_server %}-Entity-ID passen. Dies ist die URL der {% data variables.product.prodname_ghe_server %}-Instanz, wie z.B.`https://ghe.corp.example.com`. -- Jede Assertion in der Antwort **muss** durch eine digitale Signatur geschützt sein. Dies kann erfolgen, indem jedes einzelne ``-Element signiert wird oder indem das ``-Element signiert wird. -- Ein ``-Element muss als Bestandteil des ``-Elements bereitgestellt werden. Es kann ein beliebiges Format für persistente Namenskennzeichner verwendet werden. -- Ein `Recipient`-Attribut muss vorhanden und auf die Assertionsverbraucherdienst-URL festgelegt sein. Ein Beispiel: - -```xml - - - - ... - - - - - - - monalisa - - - - -``` - -### Fehlermeldungen - -Wenn der `Empfänger` nicht mit der Assertionsverbraucherdienst-URL übereinstimmt, wird im Authentifizierungsprotokoll die folgende Fehlermeldung angezeigt: - -``` -Recipient in the SAML response was not valid. -``` - -Wenn `Recipient` kein Bestandteil der Antwortmeldung ist, wird im Authentifizierungsprotokoll die folgende Fehlermeldung angezeigt: - -``` -Recipient in the SAML response must not be blank. -``` - -Wenn die SAML-Antwort nicht signiert ist oder die Signatur nicht mit dem Inhalt übereinstimmt, wird im Authentifizierungsprotokoll die folgende Fehlermeldung angezeigt: - -``` -SAML Response is not signed or has been modified. -``` -Wenn `Audience` fehlt oder nicht mit der {% data variables.product.prodname_ghe_server %}-Entitäts-ID übereinstimmt, wird im Authentifizierungsprotokoll die folgende Fehlermeldung angezeigt: - -``` -Audience is invalid. Audience attribute does not match your_instance_url -``` diff --git a/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/accessing-a-pull-request-locally.md b/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/accessing-a-pull-request-locally.md deleted file mode 100644 index caf973eb29d3..000000000000 --- a/translations/de-DE/content/desktop/contributing-and-collaborating-using-github-desktop/accessing-a-pull-request-locally.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: Lokal auf einen Pull Request zugreifen -intro: 'Du kannst die vorgeschlagenen Änderungen in offenen Pull Requests auf {% data variables.product.prodname_desktop %} anzeigen.' -redirect_from: - - /desktop/contributing-to-projects/accessing-a-pull-request-locally -versions: - free-pro-team: '*' ---- - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.click-pull-requests %} - ![Registerkarte „Pull-Requests“ im Dropdownmenü für den aktuellen Branch](/assets/images/help/desktop/branch-drop-down-pull-request-tab.png) -{% data reusables.desktop.choose-pr-from-list %} - ![Liste der offenen Pull-Requests im Repository](/assets/images/help/desktop/click-pull-request.png) -4. Klicke optional zum Aktualisieren der Liste der Pull-Requests auf {% octicon "sync" aria-label="The sync icon" %}. ![Synchronisierungsschaltfläche für die Aktualisierung](/assets/images/help/desktop/pull-request-list-sync.png) diff --git a/translations/de-DE/content/desktop/contributing-to-projects/accessing-a-pull-request-locally.md b/translations/de-DE/content/desktop/contributing-to-projects/accessing-a-pull-request-locally.md deleted file mode 100644 index c5ffbd2429e2..000000000000 --- a/translations/de-DE/content/desktop/contributing-to-projects/accessing-a-pull-request-locally.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: Lokal auf einen Pull Request zugreifen -intro: 'Du kannst die vorgeschlagenen Änderungen in offenen Pull Requests auf {% data variables.product.prodname_desktop %} anzeigen.' -versions: - free-pro-team: '*' ---- - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.click-pull-requests %} - ![Registerkarte „Pull-Requests“ im Dropdownmenü für den aktuellen Branch](/assets/images/help/desktop/branch-drop-down-pull-request-tab.png) -{% data reusables.desktop.choose-pr-from-list %} - ![Liste der offenen Pull-Requests im Repository](/assets/images/help/desktop/click-pull-request.png) -4. Klicke optional zum Aktualisieren der Liste der Pull-Requests auf {% octicon "sync" aria-label="The sync icon" %}. ![Synchronisierungsschaltfläche für die Aktualisierung](/assets/images/help/desktop/pull-request-list-sync.png) diff --git a/translations/de-DE/content/desktop/contributing-to-projects/adding-a-repository-from-your-local-computer-to-github-desktop.md b/translations/de-DE/content/desktop/contributing-to-projects/adding-a-repository-from-your-local-computer-to-github-desktop.md deleted file mode 100644 index 3527f484104c..000000000000 --- a/translations/de-DE/content/desktop/contributing-to-projects/adding-a-repository-from-your-local-computer-to-github-desktop.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: GitHub Desktop ein Repository von Deinem lokalen Computer hinzufügen -intro: 'Du kannst {% data variables.product.prodname_desktop %} jedes beliebige Git-Repository hinzufügen, selbst wenn es sich nicht um ein {% data variables.product.prodname_dotcom %}-Repository handelt.' -versions: - free-pro-team: '*' ---- - -{% tip %} - -**Tipp:** Du kannst von Deinem lokalen Computer ein Git-Repository auf den GitHub Desktop hinzufügen. Ziehe dazu den Ordner in das {% data variables.product.prodname_desktop %}-Fenster. Wenn Du mehrere Git-Ordner gleichzeitig auf den {% data variables.product.prodname_desktop %} ziehst, wird jeder Ordner als ein separates Git-Repository hinzugefügt. - -{% endtip %} - -{% mac %} - -1. Klicke im Menü **File** (Datei) auf **Add Local Repository** (Lokales Repository hinzufügen). ![Menüoption „Add Local Repository“ (Lokales Repository hinzufügen)](/assets/images/help/desktop/add-local-repository-mac.png) -2. Klicke auf **Choose...** (Auswählen), und navigiere mithilfe des Finder-Fensters zu dem lokalen Repository, das Du hinzufügen möchtest. ![Das Feld „Local Path“ (Lokaler Pfad) in der Mac-App](/assets/images/help/desktop/add-repo-choose-button-mac.png) -4. Klicke auf **Add Repository** (Repository hinzufügen). ![Die Schaltfläche „Add repository“ (Repository hinzufügen) in der Mac-App](/assets/images/help/desktop/add-repository-button-mac.png) - -{% endmac %} - -{% windows %} - -1. Klicke im Menü **File** (Datei) auf **Add local repository** (Lokales Repository hinzufügen). ![Menüoption „Add Local Repository“ (Lokales Repository hinzufügen)](/assets/images/help/desktop/add-local-repository-windows.png) -2. Klicke auf **Choose...** (Auswählen), und navigiere mithilfe des Windows-Explorers zu dem lokalen Repository, das Du hinzufügen möchtest. ![Das Feld „Local Path“ (Lokaler Pfad) in der Windows-App](/assets/images/help/desktop/add-repo-choose-button-win.png) -4. Klicke auf **Add repository** (Repository hinzufügen). ![Die Schaltfläche „Add repository“ (Repository hinzufügen) in der Windows-App](/assets/images/help/desktop/add-repository-button-windows.png) - -{% endwindows %} diff --git a/translations/de-DE/content/desktop/contributing-to-projects/adding-an-existing-project-to-github-using-github-desktop.md b/translations/de-DE/content/desktop/contributing-to-projects/adding-an-existing-project-to-github-using-github-desktop.md deleted file mode 100644 index 83c94c660bb0..000000000000 --- a/translations/de-DE/content/desktop/contributing-to-projects/adding-an-existing-project-to-github-using-github-desktop.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: GitHub mithilfe von GitHub Desktop ein vorhandenes Projekt hinzufügen -intro: 'Mithilfe von {% data variables.product.prodname_desktop %} kannst Du {% data variables.product.prodname_dotcom %} ein vorhandenes Git-Repository hinzufügen.' -versions: - free-pro-team: '*' ---- - -{% mac %} - -{% data reusables.git.remove-git-remote %} -2. [GitHub Desktop das Repository hinzufügen](/desktop/guides/contributing-to-projects/adding-a-repository-from-your-local-computer-to-github-desktop/). -{% data reusables.desktop.publish-repository %} -4. Gib den gewünschten Namen des Repositorys im Feld **Name** ein, oder verwende den standardmäßigen Namen des aktuellen lokalen Repositorys. ![Das Feld „Name“](/assets/images/help/desktop/publish-repository-name-mac.png) -5. Deaktiviere zum Veröffentlichen eines öffentlichen Repositorys **Keep this code private** (Diesen Code privat halten). ![Kontrollkästchen „Keep this code private“ (Diesen Code privat halten)](/assets/images/help/desktop/publish-repository-private-checkbox-mac.png) -6. Wähle im Dropdownmenü **Organization** (Organisation) die Organisation aus, in der Du das Repository veröffentlichen möchtest. Wähle alternativ **None** (Keine) aus, um das Repository in Deinem persönlichen Konto zu veröffentlichen. ![Dropdownmenü „Organization“ (Organisation)](/assets/images/help/desktop/publish-repository-org-dropdown-mac.png) -7. Klicke auf die Schaltfläche **Publish Repository** (Repository veröffentlichen). ![Die Schaltfläche „Publish repository“ (Repository veröffentlichen) im Dialogfeld „Publish Repository“ (Repository veröffentlichen)](/assets/images/help/desktop/publish-repository-dialog-button-mac.png) - -{% endmac %} - -{% windows %} - -{% data reusables.git.remove-git-remote %} -2. [Das Repository zum GitHub Desktop hinzufügen](/desktop/guides/contributing-to-projects/adding-a-repository-from-your-local-computer-to-github-desktop/). -{% data reusables.desktop.publish-repository %} -4. Gib den gewünschten Namen des Repositorys im Feld **Name** ein, oder verwende den standardmäßigen Namen des aktuellen lokalen Repositorys. ![Das Feld „Name“](/assets/images/help/desktop/publish-repository-name-win.png) -5. Deaktiviere zum Veröffentlichen eines öffentlichen Repositorys **Keep this code private** (Diesen Code privat halten). ![Kontrollkästchen „Keep this code private“ (Diesen Code privat halten)](/assets/images/help/desktop/publish-repository-private-checkbox-win.png) -6. Wähle im Dropdownmenü **Organization** (Organisation) die Organisation aus, in der Du das Repository veröffentlichen möchtest. Wähle alternativ **None** (Keine) aus, um das Repository in Deinem persönlichen Konto zu veröffentlichen. ![Dropdownmenü „Organization“ (Organisation)](/assets/images/help/desktop/publish-repository-org-dropdown-win.png) -7. Klicke auf die Schaltfläche **Publish repository** (Repository veröffentlichen). ![Die Schaltfläche „Publish repository“ (Repository veröffentlichen) im Dialogfeld „Publish repository“ (Repository veröffentlichen)](/assets/images/help/desktop/publish-repository-dialog-button-win.png) - -{% endwindows %} diff --git a/translations/de-DE/content/desktop/contributing-to-projects/adding-and-cloning-repositories.md b/translations/de-DE/content/desktop/contributing-to-projects/adding-and-cloning-repositories.md deleted file mode 100644 index 85d39a094041..000000000000 --- a/translations/de-DE/content/desktop/contributing-to-projects/adding-and-cloning-repositories.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: Repositorys hinzufügen und klonen -intro: 'Füge existierende Repositorys von Deinem lokalen Computer zu {% data variables.product.prodname_desktop %} hinzu oder klone Repositorys von {% data variables.product.product_name %}.' -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/de-DE/content/desktop/contributing-to-projects/changing-a-remotes-url-from-github-desktop.md b/translations/de-DE/content/desktop/contributing-to-projects/changing-a-remotes-url-from-github-desktop.md deleted file mode 100644 index 31c9fbfebdc1..000000000000 --- a/translations/de-DE/content/desktop/contributing-to-projects/changing-a-remotes-url-from-github-desktop.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Remote-URL auf GitHub Desktop ändern -intro: 'Du kannst die Remote-URL für ein von Dir verwendetes Repository in {% data variables.product.prodname_desktop %} ändern. Dies ist möglicherweise erforderlich, wenn das Repository umbenannt oder der Benutzername oder die Organisation, dem bzw. der das Repository gehört, geändert wurde.' -redirect_from: - - /desktop/contributing-to-projects/changing-a-remote-s-url-from-github-desktop -versions: - free-pro-team: '*' ---- - -{% mac %} - -1. Klicke im Menü **Repository** auf **Repository Settings...** (Repository-Einstellungen). ![Menüoption „Repository Settings“ (Repository-Einstellungen)](/assets/images/help/desktop/repository-settings-mac.png) -2. Gib im Feld **Primary remote repository** (Primäres Remote-Repository) die gewünschte URL ein. ![Feld „Primary remote repository“ (Primäres Remote-Repository)](/assets/images/help/desktop/repository-settings-remote-mac.png) -3. Klicke auf **Save** (Speichern). ![Die Schaltfläche „Save“ (Speichern)](/assets/images/help/desktop/repository-settings-save-mac.png) - -{% endmac %} - -{% windows %} - -1. Klicke im Menü **Repository** auf **Repository settings...** (Repository-Einstellungen). ![Menüoption „Repository settings“ (Repository-Einstellungen)](/assets/images/help/desktop/repository-settings-win.png) -2. Gib im Feld **Primary remote repository** (Primäres Remote-Repository) die gewünschte URL ein. ![Feld „Primary remote repository“ (Primäres Remote-Repository)](/assets/images/help/desktop/repository-settings-remote-win.png) -3. Klicke auf **Save** (Speichern). ![Die Schaltfläche „Save“ (Speichern)](/assets/images/help/desktop/repository-settings-save-win.png) - -{% endwindows %} diff --git a/translations/de-DE/content/desktop/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop.md b/translations/de-DE/content/desktop/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop.md deleted file mode 100644 index 94bca62aa619..000000000000 --- a/translations/de-DE/content/desktop/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: Repository von GitHub in GitHub Desktop klonen -intro: 'Mit {% data variables.product.prodname_dotcom %} kannst Du Remote-Repositorys zum {% data variables.product.prodname_desktop %} klonen.' -versions: - free-pro-team: '*' ---- - -{% tip %} - -**Tipp:** Darüber hinaus kannst Du {% data variables.product.prodname_desktop %} verwenden, um Repositorys zu klonen, die sich auf {% data variables.product.prodname_dotcom %} befinden. Weitere Informationen findest Du unter „[Repository von {% data variables.product.prodname_desktop %} klonen](/desktop/guides/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop/)“. - -{% endtip %} - -{% mac %} - -1. Melde Dich bei {% data variables.product.product_location %} und {% data variables.product.prodname_desktop %} an, bevor Du den Klonvorgang startest. -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.open-with-github-desktop %} -5. Klicke auf **Choose...** (Auswählen), und navigiere mithilfe des Finder-Fensters zu einem lokalen Pfad, wohin Du das Repository klonen möchtest. ![Die Schaltfläche „choose“ (Auswählen) auf der URL-Registerkarte](/assets/images/help/desktop/clone-choose-button-url-mac.png) - - {% note %} - - **Hinweis:** Wenn das Repository für die Verwendung von LFS konfiguriert ist, wirst Du aufgefordert, {% data variables.large_files.product_name_short %} zu initialisieren. - - {% endnote %} - -5. Klicke auf **Clone** (Klonen). ![Die Schaltfläche „clone“ (Klonen) auf der URL-Registerkarte](/assets/images/help/desktop/clone-button-url-mac.png) - -{% endmac %} - -{% windows %} - -1. Melde Dich bei {% data variables.product.product_location %} und {% data variables.product.prodname_desktop %} an, bevor Du den Klonvorgang startest. -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.open-with-github-desktop %} -5. Klicke auf **Choose...** (Auswählen), und navigiere mithilfe des Windows-Explorers zu einem lokalen Pfad, wohin Du das Repository klonen möchtest. ![Die Schaltfläche „choose“ (Auswählen)](/assets/images/help/desktop/clone-choose-button-url-win.png) - - {% note %} - - **Hinweis:** Wenn das Repository für die Verwendung von LFS konfiguriert ist, wirst Du aufgefordert, {% data variables.large_files.product_name_short %} zu initialisieren. - - {% endnote %} - -5. Klicke auf **Clone** (Klonen). ![Die Schaltfläche „clone“ (Klonen)](/assets/images/help/desktop/clone-button-url-win.png) - -{% endwindows %} diff --git a/translations/de-DE/content/desktop/contributing-to-projects/cloning-and-forking-repositories-from-github-desktop.md b/translations/de-DE/content/desktop/contributing-to-projects/cloning-and-forking-repositories-from-github-desktop.md deleted file mode 100644 index ba5538a0b9b9..000000000000 --- a/translations/de-DE/content/desktop/contributing-to-projects/cloning-and-forking-repositories-from-github-desktop.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: Repositories von GitHub Desktop klonen und per „Fork“ kopieren -intro: 'Du kannst {% data variables.product.prodname_desktop %} verwenden, um Repositorys von {% data variables.product.prodname_dotcom %} zu klonen und per Fork zu kopieren.' -redirect_from: - - /desktop/contributing-to-projects/cloning-a-repository-from-github-desktop -versions: - free-pro-team: '*' ---- - -### Repositorys klonen -Repositorys auf {% data variables.product.prodname_dotcom %} existieren als Remote-Repositorys. Du kannst öffentliche Repositorys klonen, die anderen Personen gehören. Du kannst Dein Repository klonen, um eine lokale Kopie auf Deinem Computer zu erstellen, und die beiden Speicherorte synchronisieren. - -Darüber hinaus kannst Du ein Repository direkt über {% data variables.product.prodname_dotcom %} oder {% data variables.product.prodname_enterprise %} klonen. Weitere Informationen findest Du unter „[Ein Repository von {% data variables.product.prodname_dotcom %} in {% data variables.product.prodname_desktop %} klonen](/desktop/guides/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop/)“. - -{% mac %} - -{% data reusables.desktop.choose-clone-repository %} - ![Menüoption zum Klonen in der Mac-App](/assets/images/help/desktop/clone-file-menu-mac.png) -{% data reusables.desktop.cloning-location-tab %} - ![Standort-Registerkarten im Menü „Clone a repository“ (Repository klonen)](/assets/images/help/desktop/choose-repository-location-mac.png) -{% data reusables.desktop.cloning-repository-list %} - ![Repository-Liste klonen](/assets/images/help/desktop/clone-a-repository-list-mac.png) -4. Klicke auf **Choose...** (Auswählen), und navigiere mithilfe des Finder-Fensters zu einem lokalen Pfad, wo Du das Repository klonen möchtest. ![Die Schaltfläche „choose“ (Auswählen)](/assets/images/help/desktop/clone-choose-button-mac.png) -5. Klicke auf **Clone** (Klonen). ![Die Schaltfläche „clone“ (Klonen)](/assets/images/help/desktop/clone-button-mac.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.choose-clone-repository %} - ![Menüoption zum Klonen in der Windows-App](/assets/images/help/desktop/clone-file-menu-windows.png) -{% data reusables.desktop.cloning-location-tab %} - ![Standort-Registerkarten im Menü „Clone a repository“ (Repository klonen)](/assets/images/help/desktop/choose-repository-location-win.png) -{% data reusables.desktop.cloning-repository-list %} - ![Repository-Liste klonen](/assets/images/help/desktop/clone-a-repository-list-win.png) -4. Klicke auf **Choose...** (Auswählen), und navigiere mithilfe des Windows-Explorers zu einem lokalen Pfad, wohin Du das Repository klonen möchtest. ![Die Schaltfläche „choose“ (Auswählen)](/assets/images/help/desktop/clone-choose-button-win.png) -5. Klicke auf **Clone** (Klonen). ![Die Schaltfläche „clone“ (Klonen)](/assets/images/help/desktop/clone-button-win.png) - -{% endwindows %} - -### Repositorys per Fork kopieren -Um zu einem Projekt beizutragen, in dem Du keinen Schreibzugriff hast, kannst Du mit {% data variables.product.prodname_desktop %} das Repository per Fork kopieren. Änderungen an Deinem Fork wirken sich nicht auf das ursprüngliche Repository aus. Du kannst per Commit Änderungen in deinen Fork übernehmen und dann in dem ursprünglichen Repository einen Pull-Request mit deinen vorgeschlagenen Änderungen öffnen. Weitere Informationen findest Du unter „[Informationen zu Forks](/github/collaborating-with-issues-and-pull-requests/about-forks)“. - -1. Wenn Du ein Repository geklont hast, in dem Du keinen Schreibzugriff hast, und dann versuchst, Änderungen per Commit zu übertragen, warnt {% data variables.product.prodname_desktop %}: „‚You don't have write access to **REPOSITORY**‘ (Du hast keinen Schreibzugriff auf **REPOSITORY**. ‚Click **create a fork**‘ (Klicke **Fork erstellen**).“ ![Einen Fork-Link erstellen](/assets/images/help/desktop/create-a-fork.png) -3. Klicke „**Fork this repository“ (Dieses Repository per Fork kopieren)**. ![Schaltfläche, um dieses Repo per Fork kopieren](/assets/images/help/desktop/fork-this-repo-button.png) -4. Um Deinen Fork auf {% data variables.product.prodname_dotcom %} zu sehen, klickst Du in der oberen rechten Ecke von {% data variables.product.prodname_dotcom %} auf Dein Profilbild und dann auf „**Your Repositories“ (Deine Repositorys)**. ![Link zu Deinen Repositorys](/assets/images/help/profile/your-repositories.png) diff --git a/translations/de-DE/content/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project.md b/translations/de-DE/content/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project.md deleted file mode 100644 index d8623d26c669..000000000000 --- a/translations/de-DE/content/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project.md +++ /dev/null @@ -1,99 +0,0 @@ ---- -title: Änderungen an Deinem Projekt sowohl per Commit übertragen als auch überprüfen -intro: '{% data variables.product.prodname_desktop %} verfolgt alle Änderungen an allen Dateien, während Du sie bearbeitest. Du kannst festlegen, wie die Änderungen gruppiert werden sollen, um aussagekräftige Commits zu erstellen.' -versions: - free-pro-team: '*' ---- - -### Informationen zu Commits - -Bei einem Commit, der dem Speichern einer Datei ähnelt, handelt es sich um eine Änderung an mindestens einer Datei in Deinem Branch. Git weist jedem Commit eine eindeutige ID zu, die als SHA oder Hash bezeichnet wird. Damit wird Folgendes festgehalten: - -- Die jeweiligen Änderungen -- Der Zeitpunkt der Änderungen -- Wer die Änderungen vorgenommen hat - -Wenn Du einen Commit durchführst, musst Du eine Commit-Mitteilung hinzufügen, in der die Änderungen kurz beschrieben werden. Du kannst auch einen Co-Autor zu Commits hinzufügen, an denen Du mitarbeitest. - -### 1. Branch auswählen und Änderungen vornehmen - -1. [Erstelle einen neuen Branch](/desktop/guides/contributing-to-projects/managing-branches), oder wähle einen vorhandenen Branch aus. Klicke dazu auf der Symbolleiste auf {% octicon "git-branch" aria-label="The branch icon" %} **Current Branch** (Aktueller Branch), und wähle den Branch aus der Liste aus. ![Dropdownmenü, um Deinen aktuellen Branch zu wechseln](/assets/images/help/desktop/click-branch-in-drop-down.png) -{% data reusables.desktop.make-changes %} - -### 2. Die in einen Commit einzubeziehenden Änderungen auswählen - -Wenn Du in Deinem Texteditor Änderungen an Dateien vornimmst und Du diese lokal speicherst, werden die Änderungen auch in {% data variables.product.prodname_desktop %} angezeigt. - -* Das rote {% octicon "diff-removed" aria-label="The diff removed icon color-red" %}-Symbol weist auf entfernte Dateien hin. -* Das gelbe {% octicon "diff-modified" aria-label="The diff modified icon color-yellow" %}-Symbol weist auf geänderte Dateien hin. -* Das grüne {% octicon "diff-added" aria-label="The diff added icon color-green" %}-Symbol weist auf hinzugefügte Dateien hin. -* Klicke auf **„Stashed Changes“ (Versteckte Änderungen)**, um auf versteckte Änderungen zuzugreifen. ![Option für versteckte Änderungen](/assets/images/help/desktop/stashed-changes.png) -* {% data reusables.desktop.commit-all-desc %} -![Kontrollkästchen, um allen geänderten Dateien per Commit zu übertragen](/assets/images/help/desktop/commit-all.png) -* {% data reusables.desktop.commit-some-desc %} -![Kontrollkästchen neben den Dateien, die zur Übertragung per Commit ausgewählt werden](/assets/images/help/desktop/commit-some.png) - -#### Partiellen Commit erstellen - -Wenn eine Datei mehrere Änderungen aufweist, Du aber möchtest, dass nur *einige* dieser Änderungen in einem Commit enthalten sind, kannst Du einen partiellen Commit erstellen. Der Rest Deiner Änderungen bleibt erhalten, sodass Du zusätzliche Änderungen und Commits vornehmen kannst. Dadurch kannst Du separate, aussagekräftige Commits erstellen, beispielsweise kannst Du Änderungen der Zeilenumbrüche in einem Commit vom Code oder von Fließtextänderungen getrennt halten. - -Wenn Du den Diff der Datei überprüfst, werden die Zeilen, die in den Commit aufgenommen werden, blau hervorgehoben. Um die Änderung auszuschließen, klickst Du auf die geänderte Zeile, damit das Blau verschwindet. - -![Zeilen in einer Datei aus der Auswahl entfernen](/assets/images/help/desktop/partial-commit.png) - -#### Änderungen verwerfen - -Du kannst alle nicht per Commit übertragenen Änderungen in einer einzelnen Datei, in einer Gruppe von Dateien oder alle Änderungen in allen Dateien seit dem letzten Commit verwerfen. - -{% mac %} - -{% data reusables.desktop.select-discard-files %} -{% data reusables.desktop.click-discard-files %} - ![Option „Discard Changes“ (Änderungen verwerfen) im Kontextmenü](/assets/images/help/desktop/discard-changes-mac.png) -{% data reusables.desktop.confirm-discard-files %} - ![Schaltfläche „Discard Changes“ (Änderungen verwerfen) im Bestätigungsdialog](/assets/images/help/desktop/discard-changes-confirm-mac.png) - -{% tip %} - -**Tipp:** Die von Dir verworfenen Änderungen werden unter „Trash“ (Papierkorb) in einer Datei mit entsprechender Datumsangabe gespeichert. Du kannst diese wiederherstellen, bis der Papierkorb geleert wird. - -{% endtip %} - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.select-discard-files %}{% data reusables.desktop.click-discard-files %} - ![Option „Discard Changes“ (Änderungen verwerfen) im Kontextmenü](/assets/images/help/desktop/discard-changes-win.png) -{% data reusables.desktop.confirm-discard-files %} - ![Schaltfläche „Discard Changes“ (Änderungen verwerfen) im Bestätigungsdialog](/assets/images/help/desktop/discard-changes-confirm-win.png) - -{% tip %} - -**Tipp:** Die von Dir verworfenen Dateien werden im „Recycle Bin“ (Papierkorb) in einer Datei gespeichert. Du kannst diese wiederherstellen, bis der Papierkorb geleert wird. - -{% endtip %} - -{% endwindows %} - -### 3. Eine Commit-Mitteilung schreiben und Deine Änderungen per Push übertragen - -Sobald Du mit den Änderungen zufrieden bist, die Du in Deinen Commit aufnehmen möchtest, schreibest Du Deine Commit-Mitteilung, und überträgst Deine Änderungen per Push. Wenn Du an einem Commit mitgewirkt hast, kannst Du einen Commit auch mehr als einem Autor zuweisen. - -{% note %} - -**Hinweis**: {% data reusables.desktop.tags-push-with-commits %} Weitere Informationen findest Du unter „[Tags verwalten](/desktop/contributing-to-projects/managing-tags)“. - -{% endnote %} - -{% data reusables.desktop.commit-message %} - ![Feld für Commit-Mitteilung](/assets/images/help/desktop/commit-message.png) -2. Um einen Commit einem anderen Autor zuzuweisen, kannst Du optional auf das Symbol zum Hinzufügen von Co-Autoren klicken und den bzw. die Benutzername(n) eingeben, den bzw. die Du hinzufügen möchtest. ![Einen Co-Autor zur Commit-Mitteilung hinzufügen](/assets/images/help/desktop/add-co-author-commit.png) -{% data reusables.desktop.commit-button %} - ![Schaltfläche zur Übertragung per Commit](/assets/images/help/desktop/commit-button.png) -4. Wenn der Branch, zu dem Du per Commit übertragen möchtest, geschützt ist, wirst Du von Desktop benachrichtigt. - - Um Deine Änderungen zu verschieben, klickst Du auf **„switch branches“ (Branches umschalten)**. - - Um Deine Änderungen in den geschützten Branch zu übertragen, klickst Du auf **„Commit to _BRANCH_“ (Per Commit an _BRANCH_ übertragen)**. - - Weitere Informationen über geschützte Branches findest Du unter „[Informationen zu geschützten Branches](/github/administering-a-repository/about-protected-branches)“. ![Warnung wegen geschütztem Branch](/assets/images/help/desktop/protected-branch-warning.png) -{% data reusables.desktop.push-origin %} diff --git a/translations/de-DE/content/desktop/contributing-to-projects/creating-a-branch-for-your-work.md b/translations/de-DE/content/desktop/contributing-to-projects/creating-a-branch-for-your-work.md deleted file mode 100644 index 643860d8f23e..000000000000 --- a/translations/de-DE/content/desktop/contributing-to-projects/creating-a-branch-for-your-work.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: Einen Branch für Deine Arbeit erstellen -intro: 'Wenn Du über Mitarbeiterberechtigungen in einem Repository verfügst, kannst Du einen Branch abseits des Standard-Branches des Repositorys erstellen, um sicher mit Änderungen zu experimentieren.' -versions: - free-pro-team: '*' ---- - -### Branch erstellen - -{% tip %} - -**Tipp:** Der erste neue von Dir erstellte Branch basiert auf dem Standardbranch, für gewöhnlich `master`. Wenn Du mehr als einen Branch besitzt, stehst Du vor der Wahl, ob der neue Branch auf dem aktuell ausgecheckten Branch oder dem Standardbranch basieren soll. - -{% endtip %} - -{% mac %} - -{% data reusables.desktop.click-base-branch-in-drop-down %} - ![Dropdownmenü, um den aktuellen Branch zu wechseln](/assets/images/help/desktop/click-branch-in-drop-down-mac.png) -{% data reusables.desktop.create-new-branch %} - ![Option „New Branch“ (Neuer Branch) im Branch-Menü](/assets/images/help/desktop/new-branch-button-mac.png) -{% data reusables.desktop.name-branch %} - ![Feld zum Erstellen eines Namens für den neuen Branch](/assets/images/help/desktop/create-branch-name-mac.png) -{% data reusables.desktop.select-base-branch %} - ![Optionen für Basis-Branch](/assets/images/help/desktop/create-branch-choose-branch-mac.png) -{% data reusables.desktop.confirm-new-branch-button %} - ![Schaltfläche „Create Branch“ (Branch erstellen)](/assets/images/help/desktop/create-branch-button-mac.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.click-base-branch-in-drop-down %} - ![Dropdownmenü, um den aktuellen Branch zu wechseln](/assets/images/help/desktop/click-branch-in-drop-down-win.png) -{% data reusables.desktop.create-new-branch %} - ![Option „New Branch“ (Neuer Branch) im Branch-Menü](/assets/images/help/desktop/new-branch-button-win.png) -{% data reusables.desktop.name-branch %} - ![Feld zum Erstellen eines Namens für den neuen Branch](/assets/images/help/desktop/create-branch-name-win.png) -{% data reusables.desktop.select-base-branch %} - ![Optionen für Basis-Branch](/assets/images/help/desktop/create-branch-choose-branch-win.png) -{% data reusables.desktop.confirm-new-branch-button %} - ![Schaltfläche „Create branch“ (Branch erstellen)](/assets/images/help/desktop/create-branch-button-win.png) - -{% endwindows %} - -### Weiterführende Informationen - -- „[Repository in {% data variables.product.prodname_desktop %}](/desktop/guides/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop) klonen“ diff --git a/translations/de-DE/content/desktop/contributing-to-projects/creating-an-issue-or-pull-request.md b/translations/de-DE/content/desktop/contributing-to-projects/creating-an-issue-or-pull-request.md deleted file mode 100644 index 617893335a7a..000000000000 --- a/translations/de-DE/content/desktop/contributing-to-projects/creating-an-issue-or-pull-request.md +++ /dev/null @@ -1,56 +0,0 @@ ---- -title: Ein „Issue“ (Problem) oder einen Pull-Request erstellen -intro: 'Du kannst ein „Issue“ (Problem) oder einen Pull-Request erstellen, um Änderungen an einem Projektarchiv vorzuschlagen und gemeinsam daran zu arbeiten.' -redirect_from: - - /desktop/contributing-to-projects/creating-a-pull-request -versions: - free-pro-team: '*' ---- - -### Ein neues „Issue“ (Problem) eröffnen -Wenn du einen Fehler findest oder eine Verbesserung vorschlagen möchtest, während du lokal mit {% data variables.product.prodname_desktop %} arbeitest, kannst Du ein neues „Issue“ (Problem) in dem Repository eröffnen, in dem Du sich befindest, sofern „Issues“ (Probleme) zugelassen sind. Weitere Informationen über die Arbeit mit „Issues“ (Problemen) findest Du unter „[Informationen zu „Issues“ (Problemen)](/github/managing-your-work-on-github/about-issues)“. - -{% mac %} - -1. Wähle in der oberen linken Ecke des Bildschirms das Menü **Repository** aus. ![GitHub-Desktop-Menü in der Mac-Menüleiste](/assets/images/help/desktop/select-repository-menu-mac.png) -2. Klicke auf **„Connect to“ (Verbinden mit) {% data variables.product.prodname_dotcom %}** . ![Repository-Wert im Menü „Branch“](/assets/images/help/desktop/create-issue-mac.png) -3. Auf {% data variables.product.prodname_dotcom %} klickst Du **Get started** (Beginnen), um eine Issue-vorlage zu öffnen oder auf **Open a blank issue** (Leeres Issue öffnen). ![Optionen zum Erstellen eines neuen Issues](/assets/images/help/desktop/create-new-issue.png) - -{% endmac %} - -{% windows %} - -1. Wähle in der oberen linken Ecke des Fensters das Menü **Repository** aus. ![Das GitHub-Desktop-Menü auf der Mac-Menüleiste](/assets/images/help/desktop/select-repository-menu-windows.png) -2. Klicke auf **„Create issue on“ (Ticket erstellen auf) {% data variables.product.prodname_dotcom %}**. ![Der Repository-Wert im Menü „Branch“](/assets/images/help/desktop/create-issue-windows.png) -3. Auf {% data variables.product.prodname_dotcom %} klickst Du **Get started** (Beginnen), um eine Issue-vorlage zu öffnen oder auf **Open a blank issue** (Leeres Issue öffnen). ![Optionen zum Erstellen eines neuen Issues](/assets/images/help/desktop/create-new-issue.png) - -{% endwindows %} - -{% note %} - -**Hinweis**: Wenn in Deinem aktuellen Repository Issue-Vorlagen nicht aktiviert sind, leitet Dich {% data variables.product.prodname_desktop %} zu einem leeren Issue auf {% data variables.product.prodname_dotcom %} weiter. - -{% endnote %} - -### Einen neuen Pull-Request erstellen -Nachdem Sie [einen Branch erstellt haben](/desktop/guides/contributing-to-projects/managing-branches) und [einige Änderungen committen](/desktop/guides/contributing-to-projects/committing-and-reviewing-changes-to-your-project), können Sie einen Pull Request öffnen, um Feedback zu Ihren vorgeschlagenen Änderungen zu erhalten. - -{% mac %} - -1. Wähle in der oberen linken Ecke des Bildschirms das Menü **Branch** aus. ![Das GitHub-Desktop-Menü auf der Mac-Menüleiste](/assets/images/help/desktop/mac-select-branch-menu.png) -2. Klicke auf **Create Pull Request** (Pull-Request erstellen). ![Der Wert „Create pull request“ (Pull-Request erstellen) im Menü „Branch“](/assets/images/help/desktop/create-pull-request-mac.png) -3. Überprüfe auf {% data variables.product.prodname_dotcom %} den standardmäßigen _base_- (Basis-) Branch und den _compare_- (Vergleichs-) Branch in den Dropdown-Menüs und korrigiere falls nötig. ![Dropdown-Menüs zur Auswahl von Basis- und Vergleichs-Branches](/assets/images/help/pull_requests/choose-base-and-compare-branches.png) -{% data reusables.repositories.pr-title-description %} -{% data reusables.repositories.create-pull-request %} - -{% endmac %} - -{% windows %} - -1. Wähle in der oberen linken Ecke Ihres Bildschirms das Menü **Branch** aus. ![Das GitHub-Desktop-Menü auf der Windows-Menüleiste](/assets/images/help/desktop/windows-select-branch-menu.png) -2. Klicke auf **Create pull request** (Pull-Request erstellen). ![Der Wert „Create pull request“ (Pull-Request erstellen) im Menü „Branch“](/assets/images/help/desktop/create-pull-request-win.png) -3. Überprüfe auf {% data variables.product.prodname_dotcom %} den standardmäßigen _base_- (Basis-) Branch und den _compare_- (Vergleichs-) Branch in den Dropdown-Menüs und korrigiere falls nötig. ![Dropdown-Menüs zur Auswahl von Basis- und Vergleichs-Branches](/assets/images/help/pull_requests/choose-base-and-compare-branches.png) -{% data reusables.repositories.pr-title-description %} -{% data reusables.repositories.create-pull-request %} - -{% endwindows %} diff --git a/translations/de-DE/content/desktop/contributing-to-projects/index.md b/translations/de-DE/content/desktop/contributing-to-projects/index.md deleted file mode 100644 index 3acb62adf341..000000000000 --- a/translations/de-DE/content/desktop/contributing-to-projects/index.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: Mit GitHub-Desktop an Projekten mitwirken -shortTitle: Zu Projekten beitragen -intro: 'Mithilfe von GitHub Desktop kannst Du Deine Projekte verwalten, aussagekräftige Commits erstellen und den Projektverlauf in einer App statt an der Befehlszeile nachverfolgen.' -versions: - free-pro-team: '*' ---- - - -### Inhaltsverzeichnis - -{% topic_link_in_list /adding-and-cloning-repositories %} - {% link_in_list /adding-a-repository-from-your-local-computer-to-github-desktop %} - {% link_in_list /adding-an-existing-project-to-github-using-github-desktop %} - {% link_in_list /cloning-and-forking-repositories-from-github-desktop %} - {% link_in_list /cloning-a-repository-from-github-to-github-desktop %} -{% topic_link_in_list /making-changes-in-a-branch %} - {% link_in_list /managing-branches %} - {% link_in_list /committing-and-reviewing-changes-to-your-project %} - {% link_in_list /pushing-changes-to-github %} - {% link_in_list /reverting-a-commit %} - {% link_in_list /managing-tags %} - {% link_in_list /viewing-the-branch-history %} -{% topic_link_in_list /working-with-your-remote-repository-on-github-or-github-enterprise %} - {% link_in_list /syncing-your-branch %} - {% link_in_list /creating-an-issue-or-pull-request %} - {% link_in_list /accessing-a-pull-request-locally %} - {% link_in_list /changing-a-remotes-url-from-github-desktop %} diff --git a/translations/de-DE/content/desktop/contributing-to-projects/making-changes-in-a-branch.md b/translations/de-DE/content/desktop/contributing-to-projects/making-changes-in-a-branch.md deleted file mode 100644 index d119ff45c6c0..000000000000 --- a/translations/de-DE/content/desktop/contributing-to-projects/making-changes-in-a-branch.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: Änderungen an einem Branch vornehmen -intro: 'Nimm mithilfe Deines bevorzugten Texteditors wie z.B. [Atom](https://atom.io/) Änderungen an Deinem Projekt vor und verwende anschließend {% data variables.product.prodname_desktop %}, um nützliche Commits zu visualisieren.' -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/de-DE/content/desktop/contributing-to-projects/managing-branches.md b/translations/de-DE/content/desktop/contributing-to-projects/managing-branches.md deleted file mode 100644 index c5a66abc6946..000000000000 --- a/translations/de-DE/content/desktop/contributing-to-projects/managing-branches.md +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: Managing branches -intro: You can create a branch off of a repository's default branch so you can safely experiment with changes. -redirect_from: - - /desktop/contributing-to-projects/creating-a-branch-for-your-work - - /desktop/contributing-to-projects/switching-between-branches -versions: - free-pro-team: '*' ---- - -### About managing branches -You can use branches to safely experiment with changes to your project. Branches isolate your development work from other branches in the repository. For example, you could use a branch to develop a new feature or fix a bug. - -Du erstellst einen Branch immer aus einem existierenden Branch. Normalerweise würdest Du einen Branch aus dem `master`-Branch deines Repository erstellen. Da kannst dann in diesem Branch unabhängig von Änderungen arbeiten, die andere Personen im Repository machen. - -Once you're satisfied with your work, you can [open a pull request](/desktop/contributing-to-projects/creating-an-issue-or-pull-request) to merge the changes in the current branch into another branch. Weitere Informationen findest Du unter „[Informationen zu Pull Requests](/articles/about-pull-requests).“ - -You can always create a branch in {% data variables.product.prodname_desktop %} if you have read access to a repository, but you can only push the branch to {% data variables.product.prodname_dotcom %} if you have write access to the repository. - -{% data reusables.desktop.protected-branches %} - -### Branch erstellen - -{% tip %} - -**Tipp:** Der erste neue von Dir erstellte Branch basiert auf dem Standardbranch, für gewöhnlich `master`. If you have more than one branch, you can choose to base the new branch on the currently checked out branch or the default branch. - -{% endtip %} - -{% mac %} - -{% data reusables.desktop.click-base-branch-in-drop-down %} - ![Dropdownmenü, um den aktuellen Branch zu wechseln](/assets/images/help/desktop/click-branch-in-drop-down-mac.png) -{% data reusables.desktop.create-new-branch %} - ![Option „New Branch“ (Neuer Branch) im Branch-Menü](/assets/images/help/desktop/new-branch-button-mac.png) -{% data reusables.desktop.name-branch %} - ![Feld zum Erstellen eines Namens für den neuen Branch](/assets/images/help/desktop/create-branch-name-mac.png) -{% data reusables.desktop.select-base-branch %} - ![Optionen für Basis-Branch](/assets/images/help/desktop/create-branch-choose-branch-mac.png) -{% data reusables.desktop.confirm-new-branch-button %} - ![Schaltfläche „Create Branch“ (Branch erstellen)](/assets/images/help/desktop/create-branch-button-mac.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.click-base-branch-in-drop-down %} - ![Dropdownmenü, um den aktuellen Branch zu wechseln](/assets/images/help/desktop/click-branch-in-drop-down-win.png) -{% data reusables.desktop.create-new-branch %} - ![Option „New Branch“ (Neuer Branch) im Branch-Menü](/assets/images/help/desktop/new-branch-button-win.png) -{% data reusables.desktop.name-branch %} - ![Feld zum Erstellen eines Namens für den neuen Branch](/assets/images/help/desktop/create-branch-name-win.png) -{% data reusables.desktop.select-base-branch %} - ![Optionen für Basis-Branch](/assets/images/help/desktop/create-branch-choose-branch-win.png) -{% data reusables.desktop.confirm-new-branch-button %} - ![Schaltfläche „Create branch“ (Branch erstellen)](/assets/images/help/desktop/create-branch-button-win.png) - -{% endwindows %} - -### Zwischen Branches wechseln -Du kannst Commits auf allen Branches Deiner Repositorys anzeigen und durchführen. Wenn Du Änderungen gespeichert hast, die nicht per Commit übertragen wurden, musst Du Dich entscheiden, was mit Deinen Änderungen geschehen soll, bevor Du den Branch wechseln kannst. Du kannst Deine Änderungen per Commit zum aktuellen Branch übertragen, auf dem aktuellen Branch per Stash verbergen oder zu Deinem neuen Branch übertragen. Wenn Du Deine Änderungen per Commit auf den aktuellen Branch übertragen möchtest, solltest Du vor dem Wechseln der Branches die unter „[Änderungen an Deinem Projekt per Commit übertragen und überprüfen](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project)“ beschriebenen Schritte befolgen. - -{% tip %} - -**Tipp**: Du kannst ein Standardverhalten für das Wechseln zwischen Branches in den **Advanced** (Erweiterten) Einstellungen festlegen. For more information, see "[Configuring basic settings](/desktop/getting-started-with-github-desktop/configuring-basic-settings)." - -{% endtip %} - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.switching-between-branches %} - ![Liste der Branches im Repository](/assets/images/help/desktop/click-branch-in-drop-down-mac.png) -3. Wenn Du Änderungen gespeichert, aber noch nicht per Commit übertragen hast, wähle **Leave my changes** (Meine Änderungen vergessen) oder **Bring my changes** (Meine Änderungen mitnehmen) aus, und klicke anschließend auf **Switch Branch** (Branch wechseln). ![Optionen zum Wechseln des Branches mit Änderungen](/assets/images/help/desktop/stash-changes-options.png) - -### Gestashte Änderungen abrufen -Um auf die Änderungen zuzugreifen, die Sie im anderen Branch gestasht haben, wechseln Sie zurück zum Branch, auf dem Sie die Änderungen gestasht haben. - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.switching-between-branches %} - ![Liste der Branches im Repository](/assets/images/help/desktop/click-branch-in-drop-down-mac.png) -3. Klicke auf der linken Seitenleiste auf **Stashed Changes** (Versteckte Änderungen). ![Option für gestashte Änderungen](/assets/images/help/desktop/stashed-changes.png) -4. Klicke zum Löschen Deiner versteckten Änderungen auf **Discard** (Verwerfen). Klicke zum Verwenden Deiner versteckte Änderungen auf **Restore** (Wiederherstellen). ![Versteckte Änderungen verwerfen oder wiederherstellen](/assets/images/help/desktop/discard-restore-stash-buttons.png) - -### Branch löschen - -Du kannst einen Branch nicht löschen, wenn er derzeit einem offenen Pull Request zugeordnet ist. You cannot undo deleting a branch. - -{% mac %} - -{% data reusables.desktop.select-branch-to-delete %} - ![Drop-down menu to select which branch to delete](/assets/images/help/desktop/select-branch-to-delete.png) -{% data reusables.desktop.delete-branch-mac %} - ![Delete... option in the Branch menu](/assets/images/help/desktop/delete-branch-mac.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.select-branch-to-delete %} - ![Drop-down menu to select which branch to delete](/assets/images/help/desktop/select-branch-to-delete.png) -{% data reusables.desktop.delete-branch-win %} - ![Delete... option in the Branch menu](/assets/images/help/desktop/delete-branch-win.png) - -{% endwindows %} - -### Weiterführende Informationen - -- „[Repository in {% data variables.product.prodname_desktop %}](/desktop/guides/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop) klonen“ -- „[Branch](/articles/github-glossary/#branch)“ im {% data variables.product.prodname_dotcom %}-Glossar -- „[Informationen zu Branches](/articles/about-branches)“ -- „[Branches auf einen Blick](https://git-scm.com/book/en/v2/Git-Branching-Branches-in-a-Nutshell)“ in der Git-Dokumentation diff --git a/translations/de-DE/content/desktop/contributing-to-projects/managing-tags.md b/translations/de-DE/content/desktop/contributing-to-projects/managing-tags.md deleted file mode 100644 index 9f2a0dc4e647..000000000000 --- a/translations/de-DE/content/desktop/contributing-to-projects/managing-tags.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: „Tags“ (Schlagworte) verwalten -intro: 'Du kannst {% data variables.product.prodname_desktop %} für die Erstellung, den Push-Zugriff und die Anzeige von „Tags“ (Schlagworten) verwenden.' -versions: - free-pro-team: '*' ---- - -### Informationen zu „Tags“ (Schlagworten) in {% data variables.product.prodname_desktop %} - -{% data variables.product.prodname_desktop %} ermöglicht Dir, kommentierte Tags zu erstellen. Du kannst ein Tag verwenden, um einen einzelnen Punkt im Verlauf Deines Repositorys zu markieren, einschließlich einer Versionsnummer für eine Freigabe („Release“). Weitere Informationen zu Release-Tags findest Du unter „[Informationen zu Releases](https://help.github.com/en/github/administering-a-repository/about-releases)“. - -{% data reusables.desktop.tags-push-with-commits %} - -### Ein Tag erstellen - -{% data reusables.desktop.history-tab %} -{% data reusables.desktop.create-tag %} -{% data reusables.desktop.name-tag %} -{% data reusables.desktop.confirm-tag %} - -### Tags anzeigen - -{% data reusables.desktop.history-tab %} -2. Klicke auf den Commit. - {% note %} - - **Hinweis**: {% data variables.product.prodname_desktop %} zeigt einen Pfeil {% octicon "arrow-up" aria-label="The up arrow icon" %} an, falls das Tag nicht per Push in das Remote-Repository übertragen wurde. - - {% endnote %} - - ![Ein Tag in der Historie anzeigen](/assets/images/help/desktop/viewing-tags-in-history.png) - -3. Alle dem Commit zugeordneten Tags sind in den Metadaten dieses Commits sichtbar. ![Ein Tag im Commit anzeigen](/assets/images/help/desktop/viewing-tags-in-commit.png) diff --git a/translations/de-DE/content/desktop/contributing-to-projects/pushing-changes-to-github.md b/translations/de-DE/content/desktop/contributing-to-projects/pushing-changes-to-github.md deleted file mode 100644 index b6d8d0fd0e83..000000000000 --- a/translations/de-DE/content/desktop/contributing-to-projects/pushing-changes-to-github.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Pushing changes to GitHub -shortTitle: Pushing changes -intro: 'As you commit changes to your project locally, you can push those changes to {% data variables.product.prodname_dotcom %} so that others may access them from the remote repository.' -permissions: People with write permissions can push changes to a repository. -versions: - free-pro-team: '*' ---- - -### About pushing changes to {% data variables.product.prodname_dotcom %} - -When you push changes, you send the committed changes in your local repository to the remote repository on {% data variables.product.prodname_dotcom %}. If you change your project locally and want other people to have access to the changes, you must push the changes to {% data variables.product.prodname_dotcom %}. - -Before pushing changes, you should update your local branch to include any commits that have been added to the remote repository. If someone has made commits on the remote that are not on your local branch, {% data variables.product.prodname_desktop %} will prompt you to fetch the new commits before pushing your changes to avoid merge conflicts. For more information, see "[Syncing your branch](/desktop/contributing-to-projects/syncing-your-branch)." - -{% data reusables.desktop.protected-branches %} - -### Pushing changes to {% data variables.product.prodname_dotcom %} - -{% note %} - -**Note:** {% data variables.product.prodname_desktop %} will reject a push if it exceeds certain limits. - -- A push contains a large file over 100MB in size. -- A push is over 2GB in total size. - -{% endnote %} - -{% data reusables.desktop.push-origin %} -2. If {% data variables.product.prodname_desktop %} prompts you to fetch new commits from the remote, click **Fetch**. ![The Fetch button](/assets/images/help/desktop/fetch-newer-commits.png) -3. Optionally, click **Create Pull Request** to open a pull request and collaborate on your changes. For more information, see "[Creating an issue or pull request](/desktop/contributing-to-projects/creating-an-issue-or-pull-request)" ![The Create Pull Request button](/assets/images/help/desktop/create-pull-request.png) - -### Weiterführende Informationen -- "[Push](/github/getting-started-with-github/github-glossary/#push)" in the {% data variables.product.prodname_dotcom %} glossary -- "[Committing and reviewing changes to your project](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project)" diff --git a/translations/de-DE/content/desktop/contributing-to-projects/reverting-a-commit.md b/translations/de-DE/content/desktop/contributing-to-projects/reverting-a-commit.md deleted file mode 100644 index da827d3cb098..000000000000 --- a/translations/de-DE/content/desktop/contributing-to-projects/reverting-a-commit.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: Einen Commit rückgängig machen -intro: 'Du kannst einen bestimmten Commit zurücksetzen, um dessen Änderungen aus deinem Branch zu entfernen.' -versions: - free-pro-team: '*' ---- - -Wenn Du einen vorherigen Commit rückgängig machst, ist das Rückgängigmachen ebenfalls ein Commit. Der ursprüngliche Commit verbleibt ebenfalls im Verlauf des Repositorys. - -{% tip %} - -**Tipp:** Wenn Du mehrere Commits rückgängig machst, ist es am besten, die Änderungen in der Reihenfolge vom neuesten zum ältesten rückgängig zu machen. Wenn Du Commits in einer anderen Reihenfolge rückgängig machst, werden möglicherweise Merge-Konflikte angezeigt. - -{% endtip %} - -{% mac %} - -{% data reusables.desktop.history-tab %} -{% data reusables.desktop.revert-commit %} - ![Die Option „Revert“ (Rückgängig machen) oberhalb der Diff-Ansicht](/assets/images/help/desktop/commit-revert-mac.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.history-tab %} -{% data reusables.desktop.revert-commit %} - ![Die Option „Revert“ (Rückgängig machen) oberhalb der Diff-Ansicht](/assets/images/help/desktop/commit-revert-win.png) - -{% endwindows %} diff --git a/translations/de-DE/content/desktop/contributing-to-projects/switching-between-branches.md b/translations/de-DE/content/desktop/contributing-to-projects/switching-between-branches.md deleted file mode 100644 index bf588d003f92..000000000000 --- a/translations/de-DE/content/desktop/contributing-to-projects/switching-between-branches.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: Zwischen Branches wechseln -intro: Du kannst Commits auf allen Branches Deiner Repositorys anzeigen und durchführen. -versions: - free-pro-team: '*' ---- - -### Zwischen Branches wechseln -Wenn Du Änderungen gespeichert hast, die nicht per Commit übertragen wurden, musst Du Dich entscheiden, was mit Deinen Änderungen geschehen soll, bevor Du den Branch wechseln kannst. Du kannst Deine Änderungen per Commit zum aktuellen Branch übertragen, auf dem aktuellen Branch per Stash verbergen oder zu Deinem neuen Branch übertragen. Wenn Du Deine Änderungen per Commit auf den aktuellen Branch übertragen möchtest, solltest Du vor dem Wechseln der Branches die unter „[Änderungen an Deinem Projekt per Commit übertragen und überprüfen](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project)“ beschriebenen Schritte befolgen. - -{% tip %} - -**Tipp**: Du kannst ein Standardverhalten für das Wechseln zwischen Branches in den **Advanced** (Erweiterten) Einstellungen festlegen. Weitere Informationen findest Du unter „[Grundeinstellungen konfigurieren](/desktop/getting-started-with-github-desktop/configuring-basic-settings)." - -{% endtip %} - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.switching-between-branches %} - ![Liste der Branches im Repository](/assets/images/help/desktop/click-branch-in-drop-down-mac.png) -3. Wenn Du Änderungen gespeichert, aber noch nicht per Commit übertragen hast, wähle **Leave my changes** (Meine Änderungen vergessen) oder **Bring my changes** (Meine Änderungen mitnehmen) aus, und klicke anschließend auf **Switch Branch** (Branch wechseln). ![Optionen zum Wechseln des Branches mit Änderungen](/assets/images/help/desktop/stash-changes-options.png) - -### Versteckte Änderungen wiedererlangen -Um auf die Änderungen zuzugreifen, die Du in einem anderen Branch versteckt hast, wechselst Du zurück zum Branch mit den versteckten Änderungen. - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.switching-between-branches %} - ![Liste der Branches im Repository](/assets/images/help/desktop/click-branch-in-drop-down-mac.png) -3. Klicke auf der linken Seitenleiste auf **Stashed Changes** (Versteckte Änderungen). ![Option für versteckte Änderungen](/assets/images/help/desktop/stashed-changes.png) -4. Klicke zum Löschen Deiner versteckten Änderungen auf **Discard** (Verwerfen). Klicke zum Verwenden Deiner versteckte Änderungen auf **Restore** (Wiederherstellen). ![Versteckte Änderungen verwerfen oder wiederherstellen](/assets/images/help/desktop/discard-restore-stash-buttons.png) diff --git a/translations/de-DE/content/desktop/contributing-to-projects/syncing-your-branch.md b/translations/de-DE/content/desktop/contributing-to-projects/syncing-your-branch.md deleted file mode 100644 index 7828132c81b2..000000000000 --- a/translations/de-DE/content/desktop/contributing-to-projects/syncing-your-branch.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: Deinen Branch synchronisieren -intro: 'Während Commits an Dein Projekt per Push auf {% data variables.product.prodname_dotcom %} übertragen werden, kannst Du Deine lokale Kopie des Projekts mit dem Remote-Repository synchron halten.' -versions: - free-pro-team: '*' ---- - -Du musst Deinen lokalen Branch mit dem Remote-Repository synchronisieren, um zusätzliche Commits abzurufen, die seit der ursprünglichen [Erstellung Deines Branches](/desktop/guides/contributing-to-projects/managing-branches) dem vorgelagerten Branch hinzugefügt wurden. - -### Deinen lokalen Branch aktualisieren - -1. Wechsle in {% data variables.product.prodname_desktop %} zum lokalen Branch, den Du aktualisieren möchtest. Klicke dazu auf {% octicon "git-branch" aria-label="The branch icon" %} **Current Branch** (Aktueller Branch) und wähle den Branch aus der Liste aus. -2. Klicke auf **Fetch origin** (Ursprung abrufen), um Deinen Branch zu aktualisieren. ![Die Schaltfläche „Fetch origin“ (Ursprung abrufen)](/assets/images/help/desktop/fetch-button.png) -3. Wenn auf dem Remote-Branch Commits vorliegen, kannst Du diese abrufen. Klicke dazu auf **Pull origin** (Ursprung abrufen) oder **Pull origin with rebase** (Ursprung abrufen und neue Basis legen). ![Die Schaltfläche „Pull origin“ (Ursprung abrufen)](/assets/images/help/desktop/pull-button.png) -{% data reusables.desktop.resolve-merge-conflicts %} - -### Anderen Branch per Merge in Deinen Projekt-Branch fusionieren - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.choose-a-branch-to-merge %} -{% data reusables.desktop.confirm-merging-branch %} - - {% note %} - - **Hinweis:** Bei Merge-Konflikten wirst Du oberhalb der Schaltfläche **Merge BRANCH into BRANCH** (BRANCH per Merge in BRANCH fusionieren) von {% data variables.product.prodname_desktop %} gewarnt. Du kannst die Branches erst per Merge fusionieren, nachdem Du alle Konflikte behoben hast. - - {% endnote %} - - ![Die Schaltfläche „Merge“](/assets/images/help/desktop/merge-branch-button.png) -{% data reusables.desktop.push-origin %} - -### Deinen Projekt-Branch per Rebase auf einem anderen Branch basieren lassen -Einige Workflows erfordern es oder profitieren davon, dass Du per Rebasing eine neue Basis legst statt im Gegensatz hierzu per Merge zu fusionieren. Durch das Rebasing kannst Du Commits neu anordnen, bearbeiten oder zusammenzwingen. Weitere Informationen findest Du unter „[Informationen zu Git Rebase](/articles/about-git-rebase)“. - -1. Verwende das Dropdown-Menü **Branch**, und klicke auf **Rebase Current Branch** (Aktuellen Branch auf neue Basis legen). ![„Rebase Current Branch“ (Basis des aktuellen Branches neu setzen) im Dropdown-Menü des Branches](/assets/images/help/desktop/rebase-current-branch.png) -2. Klicke auf den Branch, den Du als neue Basis für den aktuellen Branch setzen möchtest, und klicke anschließend auf **Start rebase** (Rebase starten). ![Schaltfläche „Start rebase“ (Rebase starten)](/assets/images/help/desktop/start-rebase-button.png) -3. Wenn Du sicher bist, dass Du ein Rebasing vornehmen möchtest, klicke auf **Begin rebase** (Rebase beginnen). ![Schaltfläche „Begin rebase“ (Rebase starten)](/assets/images/help/desktop/begin-rebase-button.png) -{% data reusables.desktop.resolve-merge-conflicts %} -4. Klicke zum Übertragen Deiner lokalen Änderungen per Push auf **Force push origin** (Ursprungs-Push erzwingen). ![Force push origin (Ursprungs-Push erzwingen)](/assets/images/help/desktop/force-push-origin.png) diff --git a/translations/de-DE/content/desktop/contributing-to-projects/viewing-the-branch-history.md b/translations/de-DE/content/desktop/contributing-to-projects/viewing-the-branch-history.md deleted file mode 100644 index 10d905e3d501..000000000000 --- a/translations/de-DE/content/desktop/contributing-to-projects/viewing-the-branch-history.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: Branch-Verlauf anzeigen -intro: 'Du kannst Details zu jedem Commit in {% data variables.product.prodname_desktop %} sehen, einschließlich eines Diffs der Änderungen, die der Commit gebracht hat.' -versions: - free-pro-team: '*' ---- - -Jeder Commit zeigt Folgendes: - - - Die Commit-Mitteilung - - Den Erstellungs-Zeitpunkt des Commits - - Den Benutzernamen und das Profilfoto (sofern vorhanden) des Beitragenden - - Den SHA-1-Hash (die eindeutige ID) des Commits - -{% data reusables.desktop.history-tab %} -2. Klick auf der Registerkarte **History** (Verlauf) auf den Commit, den Du überprüfen möchtest. ![Ein Commit auf der Registerkarte „History“ (Verlauf)](/assets/images/help/desktop/branch-history-commit.png) -3. Wenn im Commit mehrere Dateien vorhanden sind, klicke auf eine einzelne Datei, um die Änderungen anzuzeigen, die an dieser Datei in diesem Commit vorgenommen wurden. ![Eine Datei im Commit](/assets/images/help/desktop/branch-history-file.png) - -### Weiterführende Informationen - -- „[Deinen Branch synchronisieren](/desktop/guides/contributing-to-projects/syncing-your-branch/)“ diff --git a/translations/de-DE/content/desktop/contributing-to-projects/working-with-your-remote-repository-on-github-or-github-enterprise.md b/translations/de-DE/content/desktop/contributing-to-projects/working-with-your-remote-repository-on-github-or-github-enterprise.md deleted file mode 100644 index 4fbeb6ef1ec9..000000000000 --- a/translations/de-DE/content/desktop/contributing-to-projects/working-with-your-remote-repository-on-github-or-github-enterprise.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: Mit Deinem Remote-Repository auf GitHub oder GitHub Enterprise arbeiten -intro: 'Während Du Änderungen an Deinem Projekt lokal vornimmst, kannst Du diese mit Deinem Remote-Repository abgeglichen halten. In Git ist eine *Remote*-Instanz der Server, auf dem Dein Code gespeichert ist. In Deinem Fall ist dieser Server ein Repository auf {% data variables.product.prodname_dotcom %} oder {% data variables.product.prodname_enterprise %}.' -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/de-DE/content/desktop/getting-started-with-github-desktop/about-the-github-desktop-windows-installer-package.md b/translations/de-DE/content/desktop/getting-started-with-github-desktop/about-the-github-desktop-windows-installer-package.md deleted file mode 100644 index 3a1549520fb9..000000000000 --- a/translations/de-DE/content/desktop/getting-started-with-github-desktop/about-the-github-desktop-windows-installer-package.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Informationen zum Windows Installer-Paket für GitHub Desktop -intro: 'Als Netzwerkadministrator kannst Du die Windows Installer-Paketdatei („.msi“) mit „Group Policy“ (Gruppenrichtlinie) oder einem anderen Remote-Installationssystem verwenden, um {% data variables.product.prodname_desktop %} auf Computern bereitzustellen, die Microsoft Windows in einem von Active Directory verwalteten Netzwerk ausführen.' -versions: - free-pro-team: '*' ---- - -Das Windows Installer-Paket extrahiert den eigenständigen Installer (`.exe`) und konfiguriert Windows so, dass {% data variables.product.prodname_desktop %} installiert wird, wenn sich ein Benutzer das nächste Mal bei seiner Workstation anmeldet. Benutzer müssen berechtigt sein, {% data variables.product.prodname_desktop %} in ihrem Benutzerverzeichnis zu installieren. - -Wenn ein Benutzer das Windows Installer-Paket für {% data variables.product.prodname_desktop %} direkt ausführt, muss er sich bei seiner Workstation abmelden und erneut anmelden, um die Installation abzuschließen. diff --git a/translations/de-DE/content/desktop/getting-started-with-github-desktop/authenticating-to-github.md b/translations/de-DE/content/desktop/getting-started-with-github-desktop/authenticating-to-github.md deleted file mode 100644 index 613a0224c999..000000000000 --- a/translations/de-DE/content/desktop/getting-started-with-github-desktop/authenticating-to-github.md +++ /dev/null @@ -1,65 +0,0 @@ ---- -title: Sich bei GitHub authentifizieren -intro: 'Verbinde Dein {% data variables.product.product_name %}-Konto mit {% data variables.product.prodname_desktop %}.' -redirect_from: - - /desktop/getting-started-with-github-desktop/authenticating-to-github-using-the-browser -versions: - free-pro-team: '*' ---- - -Vor Deiner Authentifizierung: {% data reusables.desktop.get-an-account %} - -{% mac %} - -### Authenticating to {% data variables.product.prodname_dotcom %} using the browser - -{% data reusables.desktop.mac-select-desktop-menu %} -{% data reusables.desktop.mac-select-accounts %} -4. To the right of "{% data variables.product.prodname_dotcom %}," click **Sign In**. ![Die Schaltfläche „Sign In“ (Anmelden) für GitHub](/assets/images/help/desktop/mac-sign-in-github.png) -5. Klicke im Bereich „Sign in“ (Anmelden) auf **Sign in using your browser** (Mit Deinem Browser anmelden). ![Der Link „Sign in using your browser“ (Mit Deinem Browser anmelden)](/assets/images/help/desktop/mac-sign-in-browser.png) -{% data reusables.desktop.authenticate-in-browser %} -{% data reusables.desktop.retrieve-2fa-in-browser %} -{% data reusables.desktop.enter-2fa-in-browser %} -9. Nachdem {% data variables.product.prodname_dotcom %} Dein Konto authentifiziert hat, kehrst Du zu {% data variables.product.prodname_desktop %} zurück. - -### Authenticating to {% data variables.product.prodname_dotcom %} using your username and password - -{% data reusables.user_settings.password-authentication-deprecation-desktop %} - -{% data reusables.desktop.mac-select-desktop-menu %} -{% data reusables.desktop.mac-select-accounts %} -{% data reusables.desktop.choose-product-authenticate %} -5. Gib zum Hinzufügen eines GitHub Enterprise-Kontos unter „Enterprise server address“ Deine Anmeldeinformationen ein, und klicke anschließend auf **Continue** (Fortfahren). ![Die Schaltfläche „Sign In“ (Anmelden) für GitHub Enterprise](/assets/images/help/desktop/mac-sign-in-button-enterprise.png) -6. Gib zum Hinzufügen eines GitHub-Kontos Deine GitHub.com-Anmeldeinformation ein, und klicke auf **Sign in** (Anmelden). ![Die Schaltfläche „Sign In“ (Anmelden) für GitHub](/assets/images/help/desktop/mac-sign-in-button.png) -{% data reusables.desktop.retrieve-2fa %} -{% data reusables.desktop.return-to-desktop %} Gib bei der Eingabeaufforderung Deinen 2FA-Code ein, und klicke dann auf **Sign in** (Anmelden). ![Die Eingabeaufforderung für den 2FA-Code](/assets/images/help/desktop/mac-2fa-code-prompt.png) - -{% endmac %} - -{% windows %} - -### Authenticating to {% data variables.product.prodname_dotcom %} using the browser - -{% data reusables.desktop.windows-choose-options %} -{% data reusables.desktop.windows-select-accounts %} -4. To the right of "GitHub.com," click **Sign in**. ![Die Schaltfläche „Sign In“ (Anmelden) für GitHub](/assets/images/help/desktop/windows-sign-in-github.png) -5. Klicke im Bereich „Sign in“ (Anmelden) auf **Sign in using your browser** (Mit Deinem Browser anmelden). ![Der Link „Sign in using your browser“ (Mit Deinem Browser anmelden)](/assets/images/help/desktop/windows-sign-in-browser.png) -{% data reusables.desktop.authenticate-in-browser %} -{% data reusables.desktop.retrieve-2fa-in-browser %} -{% data reusables.desktop.enter-2fa-in-browser %} -9. Nachdem {% data variables.product.prodname_dotcom %} Ihr Konto authentifiziert hat, kehren Sie zu {% data variables.product.prodname_desktop %} zurück. - -### Authenticating to {% data variables.product.prodname_dotcom %} using your username and password - - -{% data reusables.user_settings.password-authentication-deprecation-desktop %} - -{% data reusables.desktop.windows-choose-options %} -{% data reusables.desktop.windows-select-accounts %} -{% data reusables.desktop.choose-product-authenticate %} -5. Gib zum Hinzufügen eines GitHub Enterprise-Kontos unter „Enterprise server address“ Deine Anmeldeinformationen ein, und klicke anschließend auf **Continue** (Fortfahren). ![Die Schaltfläche „Sign In“ (Anmelden) für GitHub Enterprise](/assets/images/help/desktop/windows-sign-in-button-enterprise.png) -6. Gib zum Hinzufügen eines GitHub-Kontos Deine GitHub.com-Anmeldeinformation ein, und klicke auf **Sign in** (Anmelden). ![Die Schaltfläche „Sign In“ (Anmelden) für GitHub](/assets/images/help/desktop/windows-sign-in-button.png) -{% data reusables.desktop.retrieve-2fa %} -{% data reusables.desktop.return-to-desktop %} Gib bei der Eingabeaufforderung Deinen 2FA-Code ein, und klicke dann auf **Sign in** (Anmelden). ![Die Eingabeaufforderung für den 2FA-Code](/assets/images/help/desktop/windows-2fa-code-prompt.png) - -{% endwindows %} diff --git a/translations/de-DE/content/desktop/getting-started-with-github-desktop/configuring-a-default-editor.md b/translations/de-DE/content/desktop/getting-started-with-github-desktop/configuring-a-default-editor.md deleted file mode 100644 index c96db33e4180..000000000000 --- a/translations/de-DE/content/desktop/getting-started-with-github-desktop/configuring-a-default-editor.md +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: Standardmäßigen Editor konfigurieren -intro: You can configure GitHub Desktop to open files in your project with your preferred text editor or integrated development environment (IDE). -versions: - free-pro-team: '*' ---- - -### Supported editors - -{% data variables.product.prodname_desktop %} supports the following editors. - -{% mac %} - -- [Atom](https://atom.io/) -- [MacVim](https://macvim-dev.github.io/macvim/) -- [Visual Studio Code](https://code.visualstudio.com/) -- [Visual Studio Codium](https://vscodium.com/) -- [Sublime Text](https://www.sublimetext.com/) -- [BBEdit](http://www.barebones.com/products/bbedit/) -- [JetBrains WebStorm](https://www.jetbrains.com/webstorm/) -- [JetBrains PhpStorm](https://www.jetbrains.com/phpstorm/) -- [JetBrains Rider](https://www.jetbrains.com/rider/) -- [JetBrains PyCharm](https://www.jetbrains.com/pycharm/) -- [JetBrains RubyMine](https://www.jetbrains.com/rubymine/) -- [JetBrains IntelliJ IDEA](https://www.jetbrains.com/idea/) -- [JetBrains GoLand](https://www.jetbrains.com/go/) -- [TextMate](https://macromates.com/) -- [Brackets](http://brackets.io/) - - To use Brackets with {% data variables.product.prodname_desktop %}, you must install the Command Line shortcut. To install the shortcut, open Brackets, click **File** in the menu bar, then click **Install Command Line Shortcut**. -- [Typora](https://typora.io/) -- [CodeRunner](https://coderunnerapp.com/) -- [SlickEdit](https://www.slickedit.com/) -- [Xcode](https://developer.apple.com/xcode/) -- [Android Studio](https://developer.android.com/studio) - -{% endmac %} - -{% windows %} - -- [Atom](https://atom.io/) -- [Visual Studio Code](https://code.visualstudio.com/) -- [Visual Studio Codium](https://vscodium.com/) -- [Sublime Text](https://www.sublimetext.com/) -- [ColdFusion Builder](https://www.adobe.com/products/coldfusion-builder.html) -- [Typora](https://typora.io/) -- [SlickEdit](https://www.slickedit.com/) -- [JetBrains WebStorm](https://www.jetbrains.com/webstorm/) -- [JetBrains PhpStorm](https://www.jetbrains.com/phpstorm/) -- [JetBrains Rider](https://www.jetbrains.com/rider/) -- [Notepad++](https://notepad-plus-plus.org/) - -{% endwindows %} - -### Standardmäßigen Editor konfigurieren - -{% mac %} - -{% data reusables.desktop.mac-select-desktop-menu %} -3. Wähle im Einstellungsfenster **Integrations** (Integrationen). ![Der Bereich „Integrations“ im Fenster „Preferences“ (Voreinstellungen)](/assets/images/help/desktop/mac-select-integrations-pane.png) -4. Use the "External Editor" drop-down menu, and choose the editor you want to set as your default. ![Das Menü „External editor“ auf der Menüleiste „Preferences“ (Voreinstellungen)](/assets/images/help/desktop/mac-editor-menu.png) -5. Klicke auf **Save** (Speichern). - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.windows-choose-options %} -3. Wähle im Optionen-Fenster **Integrations**. ![Der Bereich „Integrations“ im Fenster „Options“](/assets/images/help/desktop/windows-select-integrations-pane.png) -4. Use the "External Editor" drop-down menu, and choose the editor you want to set as your default. ![Das Menü „External editor“ auf der Menüleiste „Options“](/assets/images/help/desktop/windows-editor-menu.png) -5. Klicke auf **Save** (Speichern). - -{% endwindows %} diff --git a/translations/de-DE/content/desktop/getting-started-with-github-desktop/configuring-and-customizing-github-desktop.md b/translations/de-DE/content/desktop/getting-started-with-github-desktop/configuring-and-customizing-github-desktop.md deleted file mode 100644 index 019ce1402a2a..000000000000 --- a/translations/de-DE/content/desktop/getting-started-with-github-desktop/configuring-and-customizing-github-desktop.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: GitHub Desktop konfigurieren und anpassen -intro: 'Richte Git ein, binde Deinen Standard-Editor ein und passe die Einstellungen an, so dass GitHub Desktop mit Deinem Workflow harmoniert.' -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/de-DE/content/desktop/getting-started-with-github-desktop/configuring-basic-settings.md b/translations/de-DE/content/desktop/getting-started-with-github-desktop/configuring-basic-settings.md deleted file mode 100644 index 5f66a181376e..000000000000 --- a/translations/de-DE/content/desktop/getting-started-with-github-desktop/configuring-basic-settings.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: Grundlegende Einstellungen konfigurieren -intro: 'Du kannst auf Einstellungen zugreifen, um Deine Privatsphäre zu schützen, um Konten mit GitHub Desktop zu verbinden und um Git zu konfigurieren.' -versions: - free-pro-team: '*' ---- - -{% mac %} - -{% data reusables.desktop.mac-select-desktop-menu %} -3. Um Deine Einstellungen anzuzeigen oder zu ändern, wechsle zwischen diesen Bereichen: ![Die Navigation im Menü „Preferences“ (Voreinstellungen)](/assets/images/help/desktop/mac-select-accounts-pane.png) -{% data reusables.desktop.preferences-options-tabs %} - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.windows-choose-options %} -2. Um Deine Einstellungen anzuzeigen oder zu ändern, wechsle zwischen diesen Bereichen: ![Die Navigation im Menü „Options“](/assets/images/help/desktop/windows-select-accounts-pane.png) -{% data reusables.desktop.preferences-options-tabs %} - -{% endwindows %} - -### Weiterführende Informationen - -- „[Design für {% data variables.product.prodname_desktop %} festlegen](/desktop/guides/getting-started-with-github-desktop/setting-a-theme-for-github-desktop)“ diff --git a/translations/de-DE/content/desktop/getting-started-with-github-desktop/configuring-git-for-github-desktop.md b/translations/de-DE/content/desktop/getting-started-with-github-desktop/configuring-git-for-github-desktop.md deleted file mode 100644 index cf12ea17e2a0..000000000000 --- a/translations/de-DE/content/desktop/getting-started-with-github-desktop/configuring-git-for-github-desktop.md +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: Git für GitHub Desktop konfigurieren -shortTitle: Configuring Git -intro: 'Wenn Sie Git noch nicht installiert haben, müssen Sie es konfigurieren, bevor Sie GitHub Desktop verwenden.' -versions: - free-pro-team: '*' ---- - -{% data variables.product.prodname_desktop %} uses the email address you set in your local Git configuration to connect commits with your account on {% data variables.product.product_name %}. - -{% data reusables.desktop.update-email-address %} - -{% tip %} - -**Tipp**: Jeder kann die E-Mail-Adresse in der Git-Konfiguration einsehen, wenn Du öffentliche Commits machst. Weitere Informationen finden Sie unter „[Commit-E-Mail-Adresse festlegen](/articles/setting-your-commit-email-address/)“. - -{% endtip %} - -{% mac %} - -{% data reusables.desktop.sign-in-choose-product %} -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.emails %} -{% data reusables.desktop.copy-email-git-config %} -{% data reusables.desktop.return-to-desktop %} -{% data reusables.desktop.mac-select-desktop-menu %} -7. In the Preferences window, click **Git**. ![Der Bereich „Git“ im Menü „Preferences“ (Voreinstellungen)](/assets/images/help/desktop/mac-select-git-pane.png) -{% data reusables.desktop.name-field-git-config %} - ![Das Feld „Name“ (Name) der Git-Konfiguration](/assets/images/help/desktop/mac-name-git-config.png) -{% data reusables.desktop.paste-email-git-config %} - ![In das Git-Konfigurationsfeld eingefügte E-Mail-Adresse](/assets/images/help/desktop/mac-email-git-config.png) -{% data reusables.desktop.click-save-git-config %} - ![Save button in Git configuration field](/assets/images/help/desktop/mac-save-git-config.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.sign-in-choose-product %} -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.emails %} -{% data reusables.desktop.copy-email-git-config %} -{% data reusables.desktop.return-to-desktop %} -{% data reusables.desktop.windows-choose-options %} -8. In the Options window, click **Git**. ![Der Bereich „Git“ im Menü „Options“ (Optionen)](/assets/images/help/desktop/windows-select-git-pane.png) -{% data reusables.desktop.name-field-git-config %} - ![Das Feld „Name“ (Name) der Git-Konfiguration](/assets/images/help/desktop/windows-name-git-config.png) -{% data reusables.desktop.paste-email-git-config %} - ![In das Git-Konfigurationsfeld eingefügte E-Mail-Adresse](/assets/images/help/desktop/windows-email-git-config.png) -{% data reusables.desktop.click-save-git-config %} - ![Save button in Git configuration field](/assets/images/help/desktop/windows-save-git-config.png) - -{% endwindows %} - -### Weiterführende Informationen - -- „[Eine E-Mail-Adresse zum GitHub-Konto hinzufügen](/articles/adding-an-email-address-to-your-github-account/)“ -- „[Commit-E-Mail-Adresse festlegen](/articles/setting-your-commit-email-address/)“ diff --git a/translations/de-DE/content/desktop/getting-started-with-github-desktop/creating-your-first-repository-using-github-desktop.md b/translations/de-DE/content/desktop/getting-started-with-github-desktop/creating-your-first-repository-using-github-desktop.md deleted file mode 100644 index 45d05f09920f..000000000000 --- a/translations/de-DE/content/desktop/getting-started-with-github-desktop/creating-your-first-repository-using-github-desktop.md +++ /dev/null @@ -1,98 +0,0 @@ ---- -title: Erstellen Ihres ersten Repositorys mit GitHub Desktop. -intro: 'Sie können {% data variables.product.prodname_desktop %} verwenden, um schnell mit einem Git-Repository zu arbeiten, ohne die Befehlszeile verwenden zu müssen.' -versions: - free-pro-team: '*' ---- - -### Einführung - -Diese Anleitung führt Sie durch den Prozess der Verwendung von {% data variables.product.prodname_desktop %} für die Arbeit an einem Git-Repository. {% data variables.product.prodname_desktop %} erweitert und vereinfacht Ihren {% data variables.product.prodname_dotcom_the_website %}-Workflow, wobei anstelle von Textbefehlen an der Befehlszeile eine visuelle Oberfläche verwendet wird. Am Ende dieser Anleitung haben Sie {% data variables.product.prodname_desktop %} verwendet, um ein Repository zu erstellen, Änderungen am Repository vorgenommen und die Änderungen an {% data variables.product.prodname_dotcom_the_website %} oder {% data variables.product.prodname_ghe_server %} veröffentlicht. - -Nachdem Sie {% data variables.product.prodname_desktop %} heruntergeladen und sich bei {% data variables.product.prodname_dotcom %} oder {% data variables.product.prodname_enterprise %} angemeldet haben, können Sie ein Tutorial-Repository erstellen und klonen. Das Tutorial erläutert die Grundlagen der Arbeit mit Git und {% data variables.product.prodname_dotcom %}. Abgedeckt werden dabei auch die Installation eines Editorrs, das Erstellen eines Branches, Commits, das Pushen zu {% data variables.product.prodname_dotcom_the_website %} und das Erstellen eines Pull Requests. Das Tutorial ist so lange verfügbar, wie Sie noch keine Repositorys auf {% data variables.product.prodname_desktop %} besitzen. - -### Schritt 1. {% data variables.product.prodname_desktop %}-Installation und -Anmeldung - -1. Laden Sie {% data variables.product.prodname_desktop %} von {% data variables.product.desktop_link %} herunter. {% data variables.product.prodname_desktop %} unterstützt aktuelle Versionen von Windows und macOS. Spezifische Installationsanweisungen für Ihr Betriebssystem finden Sie unter „[{% data variables.product.prodname_desktop %} installieren](/desktop/getting-started-with-github-desktop/installing-github-desktop)“. - -2. Starten Sie {% data variables.product.prodname_desktop %}, und folgen Sie dem Flow mit der anfänglichen Begrüßung, um sich bei Ihrem {% data variables.product.product_name %}-Konto anzumelden. Der Schritt „Configure Git“ (Git konfigurieren) wird angezeigt, wo Sie Ihren Namen und Ihre E-Mail-Adresse festlegen können. Um sicherzustellen, dass Ihre Commits Ihrem {% data variables.product.product_name %}-Konto richtig zugeordnet sind, verwenden Sie die Ihrem {% data variables.product.product_name %}-Konto zugeordnete E-Mail-Adresse. Weitere Informationen zur Commit-Zuordnung finden Sie unter „[Commit-E-Mail-Adresse festlegen](/articles/setting-your-commit-email-address)“. - -### Schritt 2. Neues Repository erstellen - -Es wird die Ansicht „Let's get started!“ (Los geht's!) angezeigt. Hier können Sie ein Tutorial-Repository erstellen und klonen, ein vorhandenes Repository klonen, ein neues Repository erstellen oder ein vorhandenes Repository hinzufügen. - -#### Ein Tutorial-Repository erstellen und klonen - -1. Klicken Sie auf **Create a tutorial repository and clone it** (Tutorial-Repository erstellen und klonen). ![Schaltfläche zum Erstellen und Klonen eines Tutorial-Repositorys](/assets/images/help/desktop/getting-started-guide/create-and-clone-a-tutorial-repository.png) -2. Folgen Sie den Anweisungen im Tutorial. - -#### Neues Repository erstellen - -1. Klicken Sie auf **Create a New Repository on your Hard Drive...** (Neues Repository auf Ihrer Festplatte erstellen). ![Neues Repository erstellen](/assets/images/help/desktop/getting-started-guide/creating-a-repository.png) -2. Um ein neues Repository zu erstellen, füllst Du folgende Felder aus: ![Optionen zum Erstellen eines Repositorys](/assets/images/help/desktop/getting-started-guide/create-a-new-repository-options.png) - - „Name“ definiert den Namen Ihres Repositorys, und zwar lokal und auf {% data variables.product.product_name %}. - - „Description“ (Beschreibung) ist ein optionales Feld, das Sie verwenden können, um weitere Informationen zum Zweck Ihres Repositorys anzugeben. - - „Local path“ (Lokaler Pfad) legt den Speicherort Ihres Repositorys auf Ihrem Computer fest. Standardmäßig erstellt {% data variables.product.prodname_desktop %} einen _GitHub_-Ordner im Ordner _Documents_ (Dokumente), um Ihre Repositorys zu speichern. Sie können aber auch einen anderen Speicherort auf Ihrem Computer auswählen. Ihr neues Repository ist ein Ordner am ausgewählten Speicherort. Wenn Sie Ihr Repository beispielsweise `Tutorial` nennen, wird ein Ordner namens _Tutorial_ im Ordner erstellt, den Sie als Ihren lokalen Pfad ausgewählt haben. {% data variables.product.prodname_desktop %} speichert Ihren ausgewählten Speicherort für das nächste Mal, wenn Sie ein neues Repository erstellen oder klonen. - - Durch Auswahl von **Initialize this repository with a README** (Dieses Repository mit einer README-Datei initialisieren) wird ein anfänglicher Commit mit einer _README.md_-Datei erstellt. Anhand von README-Dateien kann der Zweck Ihres Projekts nachvollzogen werden. Daher sollte diese Option ausgewählt werden und nützliche Informationen in die Datei eingetragen werden. Wenn Ihr Repository auf {% data variables.product.product_name %} aufgerufen wird, wird zunächst die README-Datei angezeigt, in der sich der Besucher mit Ihrem Projekt vertraut machen kann. Weitere Informationen finden Sie unter „[Informationen zu README-Dateien](/articles/about-readmes/)“. - - Mithilfe des Dropdownmenüs **Git ignore** (Git ignorieren) können Sie eine benutzerdefinierte Datei hinzufügen, um bestimmte Dateien in Ihrem lokalen Repository zu ignorieren, die nicht in der Versionskontrolle gespeichert werden sollen. Wenn Sie eine bestimmte Sprache oder ein bestimmtes Framework verwenden, können Sie aus der verfügbaren Liste eine entsprechende Option auswählen. Für den Anfang können Sie diese Auswahl überspringen. Weitere Informationen finden Sie unter „[Dateien ignorieren](/articles/ignoring-files)“. - - Mithilfe des Dropdownmenüs **License** (Lizenz) können Sie einer _LICENSE_-Datei in Ihrem Repository eine Open-Source-Lizenz hinzufügen. Sie müssen sich keine Sorgen machen, dass Sie sofort eine Lizenz hinzufügen können. Weitere Informationen zu verfügbaren Open-Source-Lizenzen und wie Sie diese zu Ihrem Repository hinzufügen können finden Sie unter „[Ein Repository lizenzieren](/articles/licensing-a-repository)“. -3. Klicken Sie auf **Create repository** (Repository erstellen). - -### Schritt 3. {% data variables.product.prodname_desktop %} erkunden - -Nach dem Erstellen eines Repositorys wird oben auf dem Bildschirm das Dateimenü angezeigt. Dort können Sie auf Einstellungen und Aktionen zugreifen, die Sie in {% data variables.product.prodname_desktop %} durchführen können. Die meisten Aktionen besitzen auch Tastenkürzel, die Ihnen bei der effizienteren Arbeit helfen. For a full list of keyboard shortcuts, see "[Keyboard shortcuts](/desktop/getting-started-with-github-desktop/keyboard-shortcuts)." - -1. Unterhalb des Menüs befindet sich eine Leiste, auf welcher der aktuelle Zustand Ihres Repositorys in {% data variables.product.prodname_desktop %} angezeigt wird: - - **Current repository** (Aktuelles Repository) zeigt den Namen des Repositorys, an dem Sie arbeiten. Sie können auf **Current repository** (Aktuelles Repository) klicken, um zu einem anderen Repository in {% data variables.product.prodname_desktop %} zu wechseln. - - **Current branch** (Aktueller Branch) zeigt den Namen des Branches, auf dem Sie arbeiten. Sie können auf **Current branch** (Aktueller Branch) klicken, um alle Branches in Ihrem Repository anzuzeigen, um zu einem anderen Branch zu wechseln oder um einen neuen Branch zu erstellen. Sobald Sie Pull Requests in Ihrem Repository erstellen, können Sie diese auch anzeigen, indem Sie auf **Current branch** (Aktueller Branch) klicken. - - **Publish repository** (Repository veröffentlichen) wird angezeigt, da Sie Ihr Repository noch nicht auf {% data variables.product.product_name %} veröffentlicht haben, was Sie im nächsten Schritt erledigen. - - ![GitHub Desktop erkunden](/assets/images/help/desktop/getting-started-guide/explore-github-desktop.png) - -2. Auf der linken Seitenleiste befinden sich die Ansichten **Changes** (Änderungen) und **History** (Verlauf). - - - In der Ansicht **Changes** (Änderungen) werden die Änderungen angezeigt, die Sie an Dateien auf Ihrem aktuellen Branch vorgenommen haben, jedoch noch nicht an Ihr lokales Repository committed haben. Unten befindet sich ein Feld mit den Textfeldern „Summary“ (Übersicht) und „Description“ (Beschreibung) sowie die Schaltfläche **Commit to master** (An master committen). Hier committen Sie die neuen Änderungen. Mithilfe der Schaltfläche **Commit** können Sie nachvollziehen, auf welchen Branch Sie Ihre Änderungen committen. ![Commit-Bereich](/assets/images/help/desktop/getting-started-guide/commit-area.png) - - - Die Ansicht **History** (Verlauf) zeigt die vorherigen Commits auf dem aktuellen Branch Ihres Repositorys. Nach der Erstellung Ihres Repositorys sollte ein „Initial commit“ (Anfänglicher Commit) angezeigt werden, der von {% data variables.product.prodname_desktop %} erstellt wurde. Abhängig von den Optionen, die Sie beim Erstellen des Repositorys ausgewählt haben, werden rechts neben dem Commit _.gitattributes_-, _.gitignore_-, _LICENSE_- oder _README_-Dateien angezeigt. Sie können auf jede Datei klicken, um ein Diff-Element für die jeweilige Datei anzuzeigen. Hierbei handelt es sich um die Änderungen, die in diesem Commit an der Datei vorgenommen wurden. Der Diff-Wert zeigt nur die Teile der Datei, die sich geändert haben, und nicht den gesamten Dateiinhalt. ![Verlaufsansicht](/assets/images/help/desktop/getting-started-guide/history-view.png) - -### Schritt 4. Repository per Push-Vorgang an {% data variables.product.product_name %} übertragen - -Derzeit befindet sich Ihr Repository nur auf Ihrem Computer, und Sie allein können auf das Repository zugreifen. Wenn Sie Ihr Repository auf {% data variables.product.product_name %} veröffentlichen, bleibt es computer- und teammitgliederübergreifend im selben Projekt synchron. Zum Veröffentlichen des Repositorys übertragen Sie es per Push-Vorgang an {% data variables.product.product_name %}, wodurch es auch auf {% data variables.product.prodname_dotcom_the_website %} zur Verfügung steht. - -1. Klicken Sie auf **Publish repository** (Repository veröffentlichen). ![Repository veröffentlichen](/assets/images/help/desktop/getting-started-guide/publish-repository.png) - - Es werden ein paar bekannte Felder angezeigt. „Name“ und „Description“ (Beschreibung) entspricht den Feldern, die Sie beim Erstellen des Repositorys ausgefüllt haben. - - Die Option **Keep this code private** (Diesen Code privat halten) wird angezeigt. Wählen Sie diese Option aus, wenn Sie Ihren Code nicht öffentlich für andere Benutzer auf {% data variables.product.product_name %} freigeben möchten. - - Mithilfe des ggf. angezeigten Dropdownmenüs **Organization** (Organisation) können Sie Ihr Repository in einer bestimmten Organisation veröffentlichen, zu der Sie auf {% data variables.product.product_name %} gehören. Es ist in Ordnung, wenn Sie noch kein Mitglied einer Organisation sind. ![Schritte zum Veröffentlichen des Repositorys](/assets/images/help/desktop/getting-started-guide/publish-repository-steps.png) -2. Klicken Sie auf **Publish repository** (Repository veröffentlichen). -3. In {% data variables.product.prodname_desktop %} können Sie auf das Repository auf {% data variables.product.prodname_dotcom_the_website %} zugreifen. Klicken Sie im Dateimenü auf **Repository** und anschließend auf **View on GitHub** (Auf GitHub anzeigen). Dadurch gelangen Sie in Ihrem Standardbrowser direkt zum Repository. - -Kehren Sie nach der Veröffentlichung Ihres Repositorys zu {% data variables.product.prodname_desktop %} zurück, und nehmen Sie weitere Änderungen an Ihrem lokalen Repository vor. Zuerst richten wir einen standardmäßigen Texteditor ein. - -### Schritt 5. Texteditor einrichten - -Um den Zeitaufwand für die Einrichtung Ihrer Entwicklungsumgebung zu reduzieren, können Sie direkt in {% data variables.product.prodname_desktop %} mehrere Texteditoren und integrierte Entwicklungsumgebungen starten. In einem Repository in {% data variables.product.prodname_desktop %} können Sie problemlos den Projektordner in Ihrem bevorzugten Texteditor öffnen. - -1. Klicken Sie auf **File** (Datei), dann auf **Options** (Optionen) und anschließend auf **Advanced** (Erweitert). -2. Verwenden Sie das Dropdownmenü **External editor** (Externer Editor), und wählen Sie einen Editor aus der Liste aus. Die von Ihnen installierten Editoren sollten in der Liste angezeigt werden. Falls keine Editoren angezeigt werden, installieren Sie einen unterstützten Editor wie [Atom](https://atom.io). Eine Liste mit den unterstützten Editoren finden Sie in der [Integration „Open External Editor“ (offener externer Editor)](https://github.com/desktop/desktop/blob/development/docs/technical/editor-integration.md#windows) im {% data variables.product.prodname_desktop %}-Repository. ![Externer Editor](/assets/images/help/desktop/mac-editor-menu.png) -3. Starten Sie nach der Installation eines neuen Editors {% data variables.product.prodname_desktop %} neu, damit der Editor im Dropdownmenü **External editor** verfügbar wird. - -### Schritt 6. Änderungen vornehmen, committen und per Push-Vorgang übertragen - -Nach der Konfiguration Ihres standardmäßigen Editors sind Sie bereit, Änderungen an Ihrem Projekt vorzunehmen und den ersten Commit an Ihr Repository zu senden. - -1. Um Ihren externen Editor in {% data variables.product.prodname_desktop %} zu öffnen, klicken Sie auf **Repository** (Repository) und dann auf **Open in EDITOR** (In EDITOR öffnen). ![Im Editor öffnen](/assets/images/help/desktop/getting-started-guide/open-in-editor.png) - -2. Nehmen Sie zunächst einige Änderungen an der von Ihnen zuvor erstellten _README.md_-Datei vor. Fügen Sie Informationen hinzu, die das Projekt beschreiben, also beispielsweise wofür das Projekt steht und weshalb es nützlich ist. Beachten Sie, dass es sich hierbei um die erste Interaktion der Personen mit Ihrem Projekt handelt. Nun sind Sie bereit, Ihren ersten Commit durchzuführen. -3. Wechseln Sie von Ihrem Texteditor zurück zu {% data variables.product.prodname_desktop %}, und navigieren Sie zur Registerkarte **Changes** (Änderungen). In der Dateiliste sollte Ihre _README.md_-Datei angezeigt werden. Das Häkchen neben der Datei _README.md_ gibt an, dass die von Ihnen an der Datei vorgenommenen Änderungen ein Teil des Commits sein werden, den Sie durchführen. Künftig möchten Sie möglicherweise an mehreren Dateien Änderungen vornehmen, gleichzeitig aber nur die Änderungen committen, die Sie an einigen der Dateien vorgenommen haben. Mit {% data variables.product.prodname_desktop %} können Sie bestimmte Änderungen auswählen, die Sie committen möchten. ![Änderungen anzeigen](/assets/images/help/desktop/getting-started-guide/viewing-changes.png) - -4. Geben Sie im unteren Bereich der Liste **Changes** eine Commit-Mitteilung ein. Geben Sie rechts neben Ihrem Profilbild eine kurze Beschreibung zum Commit ein. Da die Datei _README.md_ geändert wird, wäre „Informationen zum Projektzweck hinzufügen“ eine gute Commit-Zusammenfassung. Unterhalb der Zusammenfassung wird das Textfeld „Description“ (Beschreibung) angezeigt, wo Sie eine längere Beschreibung der im Commit vorgenommenen Änderungen eingeben können. Dies ist hilfreich, wenn Sie sich den Projektverlauf ansehen und nachvollziehen, weshalb die Änderungen vorgenommen wurden. Da Sie eine grundlegende Aktualisierung an der Datei _README.md_ vornehmen, können Sie die Beschreibung auslassen. ![Commit-Mitteilung](/assets/images/help/desktop/getting-started-guide/commit-message.png) -5. Klicken Sie auf **Commit to master** (An master committen). Die Commit-Schaltfläche zeigt Ihren aktuellen Branch, in diesem Fall ist dies `master`. So können Sie sichergehen, dass Sie den Commit zum gewünschten Branch durchführen. ![An Master committen](/assets/images/help/desktop/getting-started-guide/click-commit-to-master.png) -6. Klicken Sie auf **Push origin** (Per Push-Vorgang an origin übertragen), um Ihre Änderungen an das Remote-Repository auf {% data variables.product.product_name %} per Push-Vorgang zu übertragen. ![Ursprung pushen](/assets/images/help/desktop/getting-started-guide/push-to-origin.png) - - Erinnern Sie sich an die Schaltfläche vom Typ **Publish** (Veröffentlichen), die Sie verwendet haben, um Ihr Repository auf {% data variables.product.product_name %} zu veröffentlichen? Stattdessen sollte nun `Push origin` (Per Push-Vorgang an origin übertragen) mit einer `1` daneben angezeigt werden. Dies gibt an, dass ein Commit nicht per Push-Vorgang auf {% data variables.product.product_name %} übertragen wurde. - - Das „origin“ (Ursprung) in **Push origin** (Per Push-Vorgang an origin übertragen) bedeutet, dass die Änderungen an die Remote-Instanz namens `origin` per Push-Vorgang übertragen werden. In diesem Fall ist dies das Repository Ihres Projekts auf {% data variables.product.prodname_dotcom_the_website %}. Bis Sie neue Commits per Push-Vorgang an {% data variables.product.product_name %} übertragen, gibt es Unterschiede zwischen dem Repository Ihres Projekts auf Ihrem Computer und dem Repository Ihres Projekts auf {% data variables.product.prodname_dotcom_the_website %}. Dadurch können Sie lokal arbeiten und Ihre Arbeit erst dann per Push-Vorgang an {% data variables.product.prodname_dotcom_the_website %} übertragen, wenn Sie dazu bereit sind. -7. Im offenen Bereich neben der Registerkarte **Changes** (Änderungen) werden Vorschläge für die Aktionen angezeigt, die Sie als Nächstes erledigen können. Klicken Sie auf **View on GitHub** (Auf GitHub anzeigen), um das Repository auf {% data variables.product.product_name %} in Ihrem Browser anzuzeigen. ![Auf GitHub anzeigen](/assets/images/help/desktop/getting-started-guide/view-on-github.png) -8. Klicken Sie in Ihrem Browser auf **2 Commits**. Es wird eine Liste der Commits in diesem Repository auf {% data variables.product.product_name %} angezeigt. Der erste Commit sollte der Commit sein, den Sie gerade in {% data variables.product.prodname_desktop %} durchgeführt haben! ![Auf „2 Commits“ klicken](/assets/images/help/desktop/getting-started-guide/click-two-commits.png) - -### Fazit - -Glückwünsch! Nun haben Sie ein Repository erstellt, das Repository auf {% data variables.product.product_name %} veröffentlicht, einen Commit durchgeführt und Ihre Änderungen per Push-Vorgang übertragen. Es wurden nur einige der Dinge behandelt, die Sie mit {% data variables.product.product_name %} und {% data variables.product.prodname_desktop %} erledigen können. Wir hoffen, diese Übung trägt dazu bei, dass Sie weitere Erkundungen anstellen! diff --git a/translations/de-DE/content/desktop/getting-started-with-github-desktop/index.md b/translations/de-DE/content/desktop/getting-started-with-github-desktop/index.md deleted file mode 100644 index 61e103c0f8f5..000000000000 --- a/translations/de-DE/content/desktop/getting-started-with-github-desktop/index.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: Erste Schritte mit GitHub Desktop -shortTitle: Erste Schritte -intro: 'Richten Sie GitHub Desktop ein, um Ihre Projektarbeit zu verwalten. Authentifizieren Sie sich bei GitHub.com oder GitHub Enterprise Server, halten Sie die App auf dem neuesten Stand, und überprüfen Sie Ihre bevorzugten Einstellungen.' -redirect_from: - - /desktop/getting-started-with-github-desktop/setting-up-github-desktop/ -versions: - free-pro-team: '*' ---- - - -### Inhaltsverzeichnis - -{% topic_link_in_list /overview %} - {% link_in_list /creating-your-first-repository-using-github-desktop %} - {% link_in_list /keyboard-shortcuts %} - {% link_in_list /launching-github-desktop-from-the-command-line %} -{% topic_link_in_list /installing-and-authenticating-to-github-desktop %} - {% link_in_list /installing-github-desktop %} - {% link_in_list /authenticating-to-github %} - {% link_in_list /about-the-github-desktop-windows-installer-package %} - {% link_in_list /updating-github-desktop %} - {% link_in_list /uninstalling-github-desktop %} -{% topic_link_in_list /configuring-and-customizing-github-desktop %} - {% link_in_list /configuring-basic-settings %} - {% link_in_list /configuring-git-for-github-desktop %} - {% link_in_list /configuring-a-default-editor %} - {% link_in_list /setting-a-theme-for-github-desktop %} diff --git a/translations/de-DE/content/desktop/getting-started-with-github-desktop/installing-and-authenticating-to-github-desktop.md b/translations/de-DE/content/desktop/getting-started-with-github-desktop/installing-and-authenticating-to-github-desktop.md deleted file mode 100644 index b5004898a5ec..000000000000 --- a/translations/de-DE/content/desktop/getting-started-with-github-desktop/installing-and-authenticating-to-github-desktop.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: Installation und Authentifizierung auf GitHub Desktop -intro: Installiere GitHub Desktop und stelle die Verbindung zu Deinen Konten auf GitHub oder GitHub Enterprise her. -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/de-DE/content/desktop/getting-started-with-github-desktop/installing-github-desktop.md b/translations/de-DE/content/desktop/getting-started-with-github-desktop/installing-github-desktop.md deleted file mode 100644 index d42007e692c8..000000000000 --- a/translations/de-DE/content/desktop/getting-started-with-github-desktop/installing-github-desktop.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: GitHub Desktop installieren -intro: Du kannst GitHub Desktop auf den unterstützten Betriebssystemen Microsoft Windows und macOS installieren. -versions: - free-pro-team: '*' ---- - -Vor der Einrichtung von {% data variables.product.prodname_desktop %} {% data reusables.desktop.get-an-account %} - -### {% data variables.product.prodname_desktop %} herunterladen und installieren - -{% mac %} - -Sie können {% data variables.product.prodname_desktop %} auf {% data variables.desktop.mac-osx-versions %} installieren. - -{% data reusables.desktop.download-desktop-page %} -2. Wählen Sie **Download for Mac** (Für Mac herunterladen) aus. -3. Doppelklicken Sie im Ordner **Downloads** Ihres Computers auf die ZIP-Datei **{% data variables.product.prodname_desktop %}**. -4. Doppelklicken Sie nach dem Entzippen der Datei auf **{% data variables.product.prodname_desktop %}**. - -{% endmac %} - -{% windows %} - -Sie können {% data variables.product.prodname_desktop %} auf {% data variables.desktop.windows-versions %} installieren. - -{% warning %} - -**Warnung**: Sie müssen über ein 64-Bit-Betriebssystem verfügen, um {% data variables.product.prodname_desktop %} ausführen zu können. - -{% endwarning %} - -{% data reusables.desktop.download-desktop-page %} -2. Wählen Sie **Download for Windows** (Für Windows herunterladen) aus. - - {% note %} - - **Hinweis:** Als Netzwerkadministrator können Sie das [Windows Installer-Paket für {% data variables.product.prodname_desktop %}](/desktop/guides/getting-started-with-github-desktop/about-the-github-desktop-windows-installer-package/) verwenden, um {% data variables.product.prodname_desktop %} bereitzustellen. - - {% endnote %} - -3. Doppelklicken Sie im Ordner **Downloads** Ihres Computers auf **{% data variables.product.prodname_desktop %}**. -4. Klicken Sie im Popup-Fenster auf **Install** (Installieren). -5. Klicken Sie nach der Installation des Programms auf **Run** (Ausführen). - -{% endwindows %} - -### {% data variables.product.prodname_desktop %} einrichten - -Nach dem Start von {% data variables.product.prodname_desktop %} können Sie {% data variables.product.prodname_desktop %} direkt einrichten oder den Einrichtungsprozess überspringen. diff --git a/translations/de-DE/content/desktop/getting-started-with-github-desktop/keyboard-shortcuts-in-github-desktop.md b/translations/de-DE/content/desktop/getting-started-with-github-desktop/keyboard-shortcuts-in-github-desktop.md deleted file mode 100644 index d9cd6e94482e..000000000000 --- a/translations/de-DE/content/desktop/getting-started-with-github-desktop/keyboard-shortcuts-in-github-desktop.md +++ /dev/null @@ -1,115 +0,0 @@ ---- -title: Tastenkürzel in GitHub Desktop -intro: 'Sie können Tastenkürzel in {% data variables.product.prodname_desktop %} verwenden.' -versions: - free-pro-team: '*' ---- - -{% mac %} - -GitHub Desktop-Tastenkürzel auf macOS - -### Seitenweite Tastenkürzel - -| Tastenkürzel | Beschreibung | -| ------------------------------------ | ----------------------------------------------------------------------- | -| ⌘, | Zu „Preferences“ (Voreinstellungen) navigieren | -| ⌘H | {% data variables.product.prodname_desktop %}-Anwendung ausblenden | -| ⌥⌘H | Alle anderen Anwendungen ausblenden | -| ⌘Q | {% data variables.product.prodname_desktop %} beenden | -| ⌃⌘F | Vollbildansicht umschalten | -| ⌘0 | Zoom auf Standardtextgröße zurücksetzen | -| ⌘= | Für größere Texte und Grafiken vergrößern | -| ⌘- | Für kleinere Texte und Grafiken verkleinern | -| ⌥⌘I | Entwicklertools umschalten | - -### Repositorys - -| Tastenkürzel | Beschreibung | -| ------------------------------------ | ------------------------------------------------------------------------------------------------ | -| ⌘N | Neues Repository hinzufügen | -| ⌘O | Lokales Repository hinzufügen | -| ⇧⌘O | Repository in {% data variables.product.prodname_dotcom %} klonen | -| ⌘T | Liste Ihrer Repositorys anzeigen | -| ⌘P | Neueste Commits per Push-Vorgang an {% data variables.product.prodname_dotcom %} übertragen | -| ⇧⌘P | Neueste Änderungen von {% data variables.product.prodname_dotcom %} abrufen | -| ⌘⌫ | Vorhandenes Repository entfernen | -| ⇧⌘G | Repository auf {% data variables.product.prodname_dotcom %} anzeigen | -| ⌃` | Repository in Ihrem bevorzugten Terminaltool öffnen | -| ⇧⌘F | Repository im Finder anzeigen | -| ⇧⌘A | Repository in Ihrem bevorzugten Editor-Tool öffnen | -| ⌘I | Ein „Issue“ (Problemticket) auf {% data variables.product.prodname_dotcom %} erstellen | - -### Branches - -| Tastenkürzel | Beschreibung | -| ------------------------------------ | ------------------------------------------------------------------------------------- | -| ⌘1 | Alle Ihre Änderungen vor dem Committen anzeigen | -| ⌘2 | Commit-Verlauf anzeigen | -| ⌘B | Alle Ihre Branches anzeigen | -| ⌘G | Zum Commit-Zusammenfassungsfeld navigieren | -| space (Leerzeichen) | Select or deselect all highlighted files | -| ⇧⌘N | Neuen Branch erstellen | -| ⇧⌘R | Aktuellen Branch umbenennen | -| ⇧⌘D | Aktuellen Branch löschen | -| ⇧⌘U | Über Standardbranch aktualisieren | -| ⇧⌘B | Mit einem vorhandenen Branch vergleichen | -| ⇧⌘M | In aktuellen Branch mergen | -| ⌃H | Gestashte Änderungen anzeigen oder ausblenden | -| ⇧⌘C | Branches auf {% data variables.product.prodname_dotcom %} vergleichen | -| ⌘R | Aktuellen Pull Request auf {% data variables.product.prodname_dotcom %} anzeigen | - -{% endmac %} - -{% windows %} - -GitHub Desktop-Tastenkürzel auf Windows - -### Websiteweite Tastenkürzel - -| Tastenkürzel | Beschreibung | -| ---------------------------------------------- | ------------------------------------------- | -| STRG, | Zu „Options“ (Optionen) navigieren | -| F11 | Vollbildansicht umschalten | -| STRG0 | Zoom auf Standardtextgröße zurücksetzen | -| STRG= | Für größere Texte und Grafiken vergrößern | -| STRG- | Für kleinere Texte und Grafiken verkleinern | -| STRGUMSCHALTI | Entwicklertools umschalten | - -### Repositorys - -| Tastenkürzel | Beschreibung | -| ---------------------------------------------- | ------------------------------------------------------------------------------------------------ | -| STRGN | Neues Repository hinzufügen | -| STRGO | Lokales Repository hinzufügen | -| STRGUMSCHALTO | Repository von {% data variables.product.prodname_dotcom %} klonen | -| STRGT | Liste Ihrer Repositorys anzeigen | -| STRGP | Neueste Commits per Push-Vorgang an {% data variables.product.prodname_dotcom %} übertragen | -| STRGUMSCHALTP | Neueste Änderungen von {% data variables.product.prodname_dotcom %} abrufen | -| STRGENTF | Vorhandenes Repository entfernen | -| STRGUMSCHALTG | Repository auf {% data variables.product.prodname_dotcom %} anzeigen | -| STRG` | Repository in Ihrem bevorzugten Befehlszeilentool öffnen | -| STRGUMSCHALTF | Repository im Explorer anzeigen | -| STRGUMSCHALTA | Repository in Ihrem bevorzugten Editor-Tool öffnen | -| CtrlI | Ein „Issue“ (Problemticket) auf {% data variables.product.prodname_dotcom %} erstellen | - -### Branches - -| Tastenkürzel | Beschreibung | -| ---------------------------------------------- | ------------------------------------------------------------------------------------- | -| STRG1 | Alle Ihre Änderungen vor dem Committen anzeigen | -| STRG2 | Commit-Verlauf anzeigen | -| STRGB | Alle Ihre Branches anzeigen | -| STRGG | Zum Commit-Zusammenfassungsfeld navigieren | -| space (Leerzeichen) | Select or deselect all highlighted files | -| STRGUMSCHALTN | Neuen Branch erstellen | -| STRGUMSCHALTR | Aktuellen Branch umbenennen | -| STRGUMSCHALTD | Aktuellen Branch löschen | -| STRGUMSCHALTU | Über Standardbranch aktualisieren | -| STRGUMSCHALTB | Mit einem vorhandenen Branch vergleichen | -| STRGUMSCHALTM | In aktuellen Branch mergen | -| STRGH | Gestashte Änderungen anzeigen oder ausblenden | -| STRGUMSCHALTC | Branches auf {% data variables.product.prodname_dotcom %} vergleichen | -| STRGR | Aktuellen Pull Request auf {% data variables.product.prodname_dotcom %} anzeigen | - -{% endwindows %} diff --git a/translations/de-DE/content/desktop/getting-started-with-github-desktop/keyboard-shortcuts.md b/translations/de-DE/content/desktop/getting-started-with-github-desktop/keyboard-shortcuts.md deleted file mode 100644 index 685beccf8b4e..000000000000 --- a/translations/de-DE/content/desktop/getting-started-with-github-desktop/keyboard-shortcuts.md +++ /dev/null @@ -1,117 +0,0 @@ ---- -title: Tastenkürzel -redirect_from: - - /desktop/getting-started-with-github-desktop/keyboard-shortcuts-in-github-desktop/ -intro: 'Sie können Tastenkürzel in {% data variables.product.prodname_desktop %} verwenden.' -versions: - free-pro-team: '*' ---- - -{% mac %} - -GitHub Desktop-Tastenkürzel auf macOS - -### Seitenweite Tastenkürzel - -| Tastenkürzel | Beschreibung | -| ------------------------------------ | ----------------------------------------------------------------------- | -| ⌘, | Zu „Preferences“ (Voreinstellungen) navigieren | -| ⌘H | {% data variables.product.prodname_desktop %}-Anwendung ausblenden | -| ⌥⌘H | Alle anderen Anwendungen ausblenden | -| ⌘Q | {% data variables.product.prodname_desktop %} beenden | -| ⌃⌘F | Vollbildansicht umschalten | -| ⌘0 | Zoom auf Standardtextgröße zurücksetzen | -| ⌘= | Für größere Texte und Grafiken vergrößern | -| ⌘- | Für kleinere Texte und Grafiken verkleinern | -| ⌥⌘I | Entwicklertools umschalten | - -### Repositorys - -| Tastenkürzel | Beschreibung | -| ------------------------------------ | ------------------------------------------------------------------------------------------------ | -| ⌘N | Neues Repository hinzufügen | -| ⌘O | Lokales Repository hinzufügen | -| ⇧⌘O | Repository in {% data variables.product.prodname_dotcom %} klonen | -| ⌘T | Liste Ihrer Repositorys anzeigen | -| ⌘P | Neueste Commits per Push-Vorgang an {% data variables.product.prodname_dotcom %} übertragen | -| ⇧⌘P | Neueste Änderungen von {% data variables.product.prodname_dotcom %} abrufen | -| ⌘⌫ | Vorhandenes Repository entfernen | -| ⇧⌘G | Repository auf {% data variables.product.prodname_dotcom %} anzeigen | -| ⌃` | Repository in Ihrem bevorzugten Terminaltool öffnen | -| ⇧⌘F | Repository im Finder anzeigen | -| ⇧⌘A | Repository in Ihrem bevorzugten Editor-Tool öffnen | -| ⌘I | Ein „Issue“ (Problemticket) auf {% data variables.product.prodname_dotcom %} erstellen | - -### Branches - -| Tastenkürzel | Beschreibung | -| ------------------------------------ | ------------------------------------------------------------------------------------- | -| ⌘1 | Alle Ihre Änderungen vor dem Committen anzeigen | -| ⌘2 | Commit-Verlauf anzeigen | -| ⌘B | Alle Ihre Branches anzeigen | -| ⌘G | Zum Commit-Zusammenfassungsfeld navigieren | -| space (Leerzeichen) | Select or deselect all highlighted files | -| ⇧⌘N | Neuen Branch erstellen | -| ⇧⌘R | Aktuellen Branch umbenennen | -| ⇧⌘D | Aktuellen Branch löschen | -| ⇧⌘U | Über Standardbranch aktualisieren | -| ⇧⌘B | Mit einem vorhandenen Branch vergleichen | -| ⇧⌘M | In aktuellen Branch mergen | -| ⌃H | Gestashte Änderungen anzeigen oder ausblenden | -| ⇧⌘C | Branches auf {% data variables.product.prodname_dotcom %} vergleichen | -| ⌘R | Aktuellen Pull Request auf {% data variables.product.prodname_dotcom %} anzeigen | - -{% endmac %} - -{% windows %} - -GitHub Desktop-Tastenkürzel auf Windows - -### Websiteweite Tastenkürzel - -| Tastenkürzel | Beschreibung | -| ---------------------------------------------- | ------------------------------------------- | -| STRG, | Zu „Options“ (Optionen) navigieren | -| F11 | Vollbildansicht umschalten | -| STRG0 | Zoom auf Standardtextgröße zurücksetzen | -| STRG= | Für größere Texte und Grafiken vergrößern | -| STRG- | Für kleinere Texte und Grafiken verkleinern | -| STRGUMSCHALTI | Entwicklertools umschalten | - -### Repositorys - -| Tastenkürzel | Beschreibung | -| ---------------------------------------------- | ------------------------------------------------------------------------------------------------ | -| STRGN | Neues Repository hinzufügen | -| STRGO | Lokales Repository hinzufügen | -| STRGUMSCHALTO | Repository von {% data variables.product.prodname_dotcom %} klonen | -| STRGT | Liste Ihrer Repositorys anzeigen | -| STRGP | Neueste Commits per Push-Vorgang an {% data variables.product.prodname_dotcom %} übertragen | -| STRGUMSCHALTP | Neueste Änderungen von {% data variables.product.prodname_dotcom %} abrufen | -| STRGENTF | Vorhandenes Repository entfernen | -| STRGUMSCHALTG | Repository auf {% data variables.product.prodname_dotcom %} anzeigen | -| STRG` | Repository in Ihrem bevorzugten Befehlszeilentool öffnen | -| STRGUMSCHALTF | Repository im Explorer anzeigen | -| STRGUMSCHALTA | Repository in Ihrem bevorzugten Editor-Tool öffnen | -| CtrlI | Ein „Issue“ (Problemticket) auf {% data variables.product.prodname_dotcom %} erstellen | - -### Branches - -| Tastenkürzel | Beschreibung | -| ---------------------------------------------- | ------------------------------------------------------------------------------------- | -| STRG1 | Alle Ihre Änderungen vor dem Committen anzeigen | -| STRG2 | Commit-Verlauf anzeigen | -| STRGB | Alle Ihre Branches anzeigen | -| STRGG | Zum Commit-Zusammenfassungsfeld navigieren | -| space (Leerzeichen) | Select or deselect all highlighted files | -| STRGUMSCHALTN | Neuen Branch erstellen | -| STRGUMSCHALTR | Aktuellen Branch umbenennen | -| STRGUMSCHALTD | Aktuellen Branch löschen | -| STRGUMSCHALTU | Über Standardbranch aktualisieren | -| STRGUMSCHALTB | Mit einem vorhandenen Branch vergleichen | -| STRGUMSCHALTM | In aktuellen Branch mergen | -| STRGH | Gestashte Änderungen anzeigen oder ausblenden | -| STRGUMSCHALTC | Branches auf {% data variables.product.prodname_dotcom %} vergleichen | -| STRGR | Aktuellen Pull Request auf {% data variables.product.prodname_dotcom %} anzeigen | - -{% endwindows %} diff --git a/translations/de-DE/content/desktop/getting-started-with-github-desktop/launching-github-desktop-from-the-command-line.md b/translations/de-DE/content/desktop/getting-started-with-github-desktop/launching-github-desktop-from-the-command-line.md deleted file mode 100644 index 45ddc059b957..000000000000 --- a/translations/de-DE/content/desktop/getting-started-with-github-desktop/launching-github-desktop-from-the-command-line.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: GitHub Desktop an der Befehlszeile starten -shortTitle: Launching from the command line -intro: Sie können GitHub Desktop an der Befehlszeile starten. -versions: - free-pro-team: '*' ---- - -{% mac %} - -1. In the menu bar, select the **{% data variables.product.prodname_desktop %}** menu, then click **Install Command Line Tool**. ![Install Command Line Tool option in the {% data variables.product.prodname_desktop %} drop-down menu](/assets/images/help/desktop/mac-install-command-line-tool.png) -2. Öffne das Terminal. -3. {% data reusables.desktop.launch-desktop-from-command-line %} - - ```shell - $ github /path/to/repo - ``` - - You can also change to your repository path and then type `github .` to open that repository. - - ```shell - $ cd /path/to/repo - [repo]$ github . - ``` - -{% endmac %} - -{% windows %} - -1. Öffnen Sie eine Eingabeaufforderung. -2. {% data reusables.desktop.launch-desktop-from-command-line %} - - ```shell - C:\Users\octocat> github path\to\repo - ``` - - You can also change to your repository path and then type `github .` to open that repository. - - ```shell - C:\Users\octocat> cd repo\myrepo - C:\Users\octocat\repo\myrepo> github . - ``` - -{% endwindows %} diff --git a/translations/de-DE/content/desktop/getting-started-with-github-desktop/overview.md b/translations/de-DE/content/desktop/getting-started-with-github-desktop/overview.md deleted file mode 100644 index 6310d6f6269f..000000000000 --- a/translations/de-DE/content/desktop/getting-started-with-github-desktop/overview.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: Übersicht -intro: Erfahre etwas über GitHub Desktop und erstelle schnell Dein erstes Repository. -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/de-DE/content/desktop/getting-started-with-github-desktop/setting-a-theme-for-github-desktop.md b/translations/de-DE/content/desktop/getting-started-with-github-desktop/setting-a-theme-for-github-desktop.md deleted file mode 100644 index 94b7f790de24..000000000000 --- a/translations/de-DE/content/desktop/getting-started-with-github-desktop/setting-a-theme-for-github-desktop.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: Design für GitHub Desktop festlegen -intro: 'Sie können ein Design festlegen, um das Erscheinungsbild von GitHub-Desktop anzupassen.' -versions: - free-pro-team: '*' ---- - -{% mac %} - -{% data reusables.desktop.mac-select-desktop-menu %} -{% data reusables.desktop.choose-a-theme %} - ![Die Optionen für das „Theme“ (Design) auf der Registerkarte „Appearance“ (Erscheinungsbild) beim Mac](/assets/images/help/desktop/mac-appearance-tab-themes.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.windows-choose-options %} -{% data reusables.desktop.choose-a-theme %} - ![Die Optionen für das „Theme“ (Design) auf der Registerkarte „Appearance“ (Erscheinungsbild) bei Windows](/assets/images/help/desktop/windows-appearance-tab-themes.png) - -{% endwindows %} diff --git a/translations/de-DE/content/desktop/getting-started-with-github-desktop/uninstalling-github-desktop.md b/translations/de-DE/content/desktop/getting-started-with-github-desktop/uninstalling-github-desktop.md deleted file mode 100644 index 6c50e5de3dfc..000000000000 --- a/translations/de-DE/content/desktop/getting-started-with-github-desktop/uninstalling-github-desktop.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: GitHub Desktop deinstallieren -intro: You can uninstall GitHub Desktop from your computer at any time. -versions: - free-pro-team: '*' ---- - -{% mac %} - -1. In a Finder window, navigate to the Applications folder. ![Applications folder in the Finder window](/assets/images/help/desktop/applications-folder.png) -2. While pressing the **Control** button on your keyboard, click **{% data variables.product.prodname_desktop %}**. -3. Wählen Sie **Move to Trash** (In Papierkorb verschieben) aus. ![The Move to Trash option](/assets/images/help/desktop/mac-move-to-trash.png) -4. In the menu bar, use the **Finder** drop-down menu, then click **Empty Trash**. ![The Empty Trash option in the menu bar](/assets/images/help/desktop/mac-empty-trash-menu.png) -5. Lesen Sie die Warnung im Popup-Fenster, und klicken Sie auf **Empty Trash** (Papierkorb leeren). ![The Empty Trash button](/assets/images/help/desktop/mac-empty-trash-button.png) - -{% endmac %} - -{% windows %} - -1. Open Control Panel. For more information, see [Where is Control Panel?](https://support.microsoft.com/en-us/help/13764/windows-where-is-control-panel) in Windows Help. -2. Under "Programs", click **Uninstall a program**. ![The Uninstall a Program option in Control Panel](/assets/images/help/desktop/windows-uninstall-a-program.png) -3. Right-click the entry named **{% data variables.product.prodname_desktop %}**, then click **Uninstall**. ![The Uninstall option](/assets/images/help/desktop/windows-click-uninstall.png) - -{% endwindows %} diff --git a/translations/de-DE/content/desktop/getting-started-with-github-desktop/updating-github-desktop.md b/translations/de-DE/content/desktop/getting-started-with-github-desktop/updating-github-desktop.md deleted file mode 100644 index 6d8ab068e52f..000000000000 --- a/translations/de-DE/content/desktop/getting-started-with-github-desktop/updating-github-desktop.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: GitHub Desktop aktualisieren -intro: GitHub Desktop lädt die Updates automatisch herunter und installiert sie beim Neustart. Sie können auch manuell nach Updates suchen. -versions: - free-pro-team: '*' ---- - -{% mac %} - -1. Klicken Sie im Menü **GitHub Desktop** auf **About GitHub Desktop** (Informationen zu GitHub Desktop). ![Menüoption „About GitHub Desktop“ (Informationen zu GitHub Desktop)](/assets/images/help/desktop/desktop-menu-about-desktop-mac.png) -2. Klicken Sie auf **Check for Updates
    • -3 -Wenn ein Update verfügbar ist, beenden Sie {% data variables.product.prodname_desktop %}, und starten Sie es neu, um das Update zu installieren. - -{% endmac %} - -{% windows %} - -1. Klicken Sie im Menü **Help** (Hilfe) auf **About GitHub Desktop** (Informationen zu GitHub Desktop). ![Menüoption „About GitHub Desktop“ (Informationen zu GitHub Desktop)](/assets/images/help/desktop/help-about-desktop-win.png) -2. Klicken Sie auf **Check for Updates -3 -Wenn ein Update verfügbar ist, beenden Sie {% data variables.product.prodname_desktop %}, und starten Sie es neu, um das Update zu installieren. - -{% endwindows %} diff --git a/translations/de-DE/content/github/administering-a-repository/about-github-dependabot.md b/translations/de-DE/content/github/administering-a-repository/about-github-dependabot.md deleted file mode 100644 index ac07ae9f53be..000000000000 --- a/translations/de-DE/content/github/administering-a-repository/about-github-dependabot.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: About GitHub Dependabot -intro: 'You can use {% data variables.product.prodname_dependabot %} to keep the packages you use updated to the latest versions.' -versions: - free-pro-team: '*' ---- - -{% data reusables.dependabot.beta-note %} - -### Informationen zu {% data variables.product.prodname_dependabot %} - -{% data variables.product.prodname_dependabot %} is a {% data variables.product.prodname_dotcom %} App that takes the effort out of maintaining your dependencies. You can use it to ensure that your repository automatically keeps up with the latest releases of the packages and applications it depends on. - -You enable {% data variables.product.prodname_dependabot_version_updates %} by checking a configuration file in to your repository. The configuration file specifies the location of the manifest, or other package definition files, stored in your repository. The app uses this information to check for outdated packages and applications. The {% data variables.product.prodname_dependabot_short %} app determines if there is a new version of a dependency by looking at the semantic versioning ([semver](https://semver.org/)) of the dependency to decide whether it should update to that version. When the app identifies an outdated dependency, it raises a pull request to update the manifest to the latest version of the dependency. You check that your tests pass, review the changelog and release notes included in the pull request summary, and then merge it. For more information, see "[Enabling and disabling version updates](/github/administering-a-repository/enabling-and-disabling-version-updates)." - -If you enable security updates, {% data variables.product.prodname_dependabot %} also raises pull requests to update vulnerable dependencies. For more information, see "[Configuring {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)." - -{% data reusables.dependabot.dependabot-tos %} - -### Frequency of {% data variables.product.prodname_dependabot %} pull requests - -You specify how often to check each ecosystem for new versions in the configuration file: daily, weekly, or monthly. - -{% data reusables.dependabot.initial-updates %} - -If you've enabled security updates, you'll sometimes see extra pull requests for security updates. These are triggered by a Dependabot alert for a dependency on your default branch. {% data variables.product.prodname_dependabot %} automatically raises a pull request to update the vulnerable dependency. - -### Supported repositories and ecosystems - -You can configure version updates for repositories that contain a dependency manifest or lock file for one of the supported package managers. - -{% data reusables.dependabot.supported-package-managers %} - -If your repository already uses an integration for dependency management, you will need to disable this before enabling {% data variables.product.prodname_dependabot %}. For more information, see "[About integrations](/github/customizing-your-github-workflow/about-integrations)." diff --git a/translations/de-DE/content/github/administering-a-repository/setting-the-default-branch.md b/translations/de-DE/content/github/administering-a-repository/setting-the-default-branch.md deleted file mode 100644 index d827643a56e6..000000000000 --- a/translations/de-DE/content/github/administering-a-repository/setting-the-default-branch.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Standardbranch festlegen -intro: 'If you have more than one branch in your repository, you can choose another branch to be the default branch.' -redirect_from: - - /articles/setting-the-default-branch -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -### About the default branch - -{% data reusables.branches.new-repo-default-branch %} {% data reusables.branches.default-branch-automatically-base-branch %} If you have more than one branch in your repository, anyone with admin rights over a repository can select one of these existing branches as the default branch on the repository. - -### Standardbranch festlegen - -{% note %} - -**Note:** To set the default branch you must have more than one branch in your repository. - -{% endnote %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -{% data reusables.repositories.repository-branches %} -4. In the default branch drop-down, choose the new default branch. ![Dropdown-Auswahl für Standardbranch](/assets/images/help/repository/repository-options-defaultbranch.png) -5. Klicke auf **Update** (Aktualisieren). - -Sie können nur zwischen Branches wechseln, die auf {% data variables.product.product_location %} vorhanden sind. Informationen zur Erstellung eines neuen Branch in der Benutzeroberfläche finden Sie unter „[Branches in Ihrem Repository erstellen und löschen](/articles/creating-and-deleting-branches-within-your-repository)“. - -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} - -You can also set the default branch name for any newly created repositories owned by your user account, organization, or enterprise account. For more information, see "[Managing the default branch for your repositories](/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories)", "[Managing the default branch name for repositories in your organization](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization), or "[Enforcing a policy on the default branch name](/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account#enforcing-a-policy-on-the-default-branch-name)." - -{% endif %} - -{% warning %} - -**Warning**: Setting a different default branch affects your `trunk` branch contents on the [Git-Subversion bridge](https://github.com/blog/1178-collaborating-on-github-with-subversion) and the `HEAD` you'd see when you `git ls-remote` this [repository's upstream URL](https://git-scm.com/docs/git-ls-remote.html). - -{% endwarning %} diff --git a/translations/de-DE/content/github/articles/README.md b/translations/de-DE/content/github/articles/README.md deleted file mode 100644 index 1eaef8c78676..000000000000 --- a/translations/de-DE/content/github/articles/README.md +++ /dev/null @@ -1,5 +0,0 @@ -# Hidden GitHub.com articles - -GitHub.com/Enterprise User articles that have `hidden: true` frontmatter live in this directory. - -See [`content/README`](../README.md#hidden-pages) for more about hidden pages. diff --git a/translations/de-DE/content/github/articles/about-the-github-and-visual-studio-bundle.md b/translations/de-DE/content/github/articles/about-the-github-and-visual-studio-bundle.md deleted file mode 100644 index 0fac7a62d216..000000000000 --- a/translations/de-DE/content/github/articles/about-the-github-and-visual-studio-bundle.md +++ /dev/null @@ -1,54 +0,0 @@ ---- -title: Informationen zum Bundle von GitHub und Visual Studio -hidden: true -redirect_from: - - /articles/about-the-github-and-visual-studio-bundle -versions: - free-pro-team: '*' ---- - -{% tip %} - -**Tipps**: -- Nur Organisationsinhaber können Benutzer zu einer Organisation einladen. Weitere Informationen finden Sie unter „[Berechtigungsebenen für eine Organisation](/articles/permission-levels-for-an-organization)". - -{% endtip %} - - -### Inhalt dieses Artikels -- [Informationen zu Lizenzen für das Bundle von {% data variables.product.prodname_enterprise %} und Visual Studio](#about-github-enterprise-and-visual-studio-bundle-licenses) -- [Eine {% data variables.product.prodname_enterprise %}-Benutzerlizenz zuweisen](#assigning-a-github-enterprise-user-license) -- [Überallokation von Benutzerlizenzen](#overallocation-of-user-licenses) - - -### Informationen zu Lizenzen für das Bundle von {% data variables.product.prodname_enterprise %} und Visual Studio - -Kunden, die das Bundle von {% data variables.product.prodname_dotcom %} und Visual Studio erworben haben, haben Anspruch auf eine {% data variables.product.prodname_enterprise %}-Benutzerlizenz. Diese Lizenzen werden in einem {% data variables.product.prodname_dotcom %}-Enterprise-Konto bereitgestellt, das mit dem Microsoft Enterprise Agreement verknüpft ist, und können den Mitgliedern der Organisation zugewiesen werden. - -Wenn Inhaber von Organisationen in Ihrem Unternehmen einen neuen Benutzer einladen, einer Organisation beizutreten, können sie wählen, ob dem neuen Benutzer eine Lizenz entweder von Ihrem Abonnement von {% data variables.product.prodname_enterprise %} oder von Ihrem Abonnement von {% data variables.product.prodname_enterprise %} mit Visual Studio zugewiesen wird. - -### Eine {% data variables.product.prodname_enterprise %}-Benutzerlizenz zuweisen - -{% data reusables.profile.access_profile %} -{% data reusables.profile.access_org %} -{% data reusables.organizations.people %} -{% data reusables.organizations.invite_member_from_people_tab %} -{% data reusables.organizations.invite_to_org %} -{% data reusables.organizations.choose-to-restore-privileges %} -{% data reusables.organizations.choose-user-role %} -{% data reusables.organizations.choose-user-license %} -{% data reusables.organizations.add-user-to-teams %} -{% data reusables.organizations.send-invitation %} -{% data reusables.organizations.user_must_accept_invite_email %} {% data reusables.organizations.cancel_org_invite %} - -### Überallokation von Benutzerlizenzen - -Sie können die Gesamtzahl der Lizenzen, die Sie für Ihr Abonnement von {% data variables.product.prodname_enterprise %} und Ihr Abonnement von {% data variables.product.prodname_enterprise %} mit Visual Studio verwendet haben, in den Abrechnungseinstellungen Ihres Enterprise-Kontos sehen. - -Wenn Organisations- und Enterprise-Inhaber Benutzern mehr Abonnementlizenzen für {% data variables.product.prodname_enterprise %} (Visual Studio) zuweisen, als im Abonnement enthalten sind, enthält Ihre nächste Abschlussrechnung Gebühren für die Anzahl der Benutzer, die über den von Ihrem Abonnement erlaubten Betrag hinausgehen. - -Weitere Informationen finden Sie unter „[Abonnement und Nutzung für Ihr Enterprise-Konto anzeigen](/articles/viewing-the-subscription-and-usage-for-your-enterprise-account)“. - -### Weiterführende Informationen -- „[Organisationsmitglieder zu einem Team hinzufügen](/articles/adding-organization-members-to-a-team)“ -- Wenn Ihr Unternehmen [die Zwei-Faktor-Authentifizierung für Mitglieder vorschreibt](/articles/requiring-two-factor-authentication-in-your-organization), müssen die von Ihnen eingeladenen Benutzer [die Zwei-Faktor-Authentifizierung aktivieren](/articles/securing-your-account-with-two-factor-authentication-2fa), bevor sie die Einladung annehmen können. diff --git a/translations/de-DE/content/github/articles/managing-your-disabled-github-pages-site.md b/translations/de-DE/content/github/articles/managing-your-disabled-github-pages-site.md deleted file mode 100644 index 6f60459446f9..000000000000 --- a/translations/de-DE/content/github/articles/managing-your-disabled-github-pages-site.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: Ihre deaktivierte GitHub Pages-Website verwalten -intro: 'Private Repositorys auf {% data variables.product.prodname_free_user %} unterstützen {% data variables.product.prodname_pages %} nicht. Eine begrenzte Anzahl an {% data variables.product.prodname_pages %}-Websites, die mit kostenlosen privaten Repositorys verbunden sind, wurden fälschlicherweise aktiv belassen. Diese Websites werden nicht mehr aktualisiert, und ihre Veröffentlichung wird am 10. Mai 2019 von {% data variables.product.prodname_dotcom %} zurückgezogen.' -hidden: true -redirect_from: - - /articles/managing-your-disabled-github-pages-site -versions: - free-pro-team: '*' ---- - -{% note %} - -{% data variables.product.prodname_pages %} ist nur in öffentlichen Repositorys mit {% data variables.product.prodname_free_user %} und in öffentlichen und privaten Repositorys mit {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %} und {% data variables.product.prodname_ghe_server %} verfügbar. {% data reusables.gated-features.more-info %} - -{% endnote %} - -Wenn Sie eine veröffentlichte {% data variables.product.prodname_pages %}-Website in einem kostenlosen privaten Repository besitzen, gibt es mehrere Möglichkeiten, Ihre Website weiterhin zu veröffentlichen und zu aktualisieren oder ihre Veröffentlichung manuell zurückzuziehen. Wenn Sie nichts tun, zieht {% data variables.product.prodname_dotcom %} die Veröffentlichung Ihrer Website am 10. Mai 2019 zurück. - -- **Um Ihre {% data variables.product.prodname_pages %}-Website weiterhin zu veröffentlichen und zu aktualisieren**, können Sie das Repository in ein öffentliches Repository umwandeln oder Ihr Konto auf {% data variables.product.prodname_pro %} upgraden. Weitere Informationen dazu, wie Sie Ihr privates Repository in ein öffentliches umwandeln, finden Sie unter „[Sichtbarkeit eines Repositorys festlegen](/articles/setting-repository-visibility#making-a-private-repository-public)“. Weitere Informationen zum Upgraden Ihres Kontos finden Sie unter „[Ihr GitHub-Abonnement upgraden](/articles/upgrading-your-github-subscription)“. - -- **Um Ihre {% data variables.product.prodname_pages %}-Website nicht länger zu veröffentlichen**, können Sie die [Veröffentlichung manuell zurückziehen](#manually-unpublishing-your-github-pages-site) oder nichts tun, woraufhin {% data variables.product.prodname_dotcom %} die Veröffentlichung Ihrer Website am 10. Mai 2019 zurücknimmt. Wenn für Ihre {% data variables.product.prodname_pages %}-Website eine benutzerdefinierte Domain eingerichtet wurde, sollten sie den DNS-Eintrag bei Ihrem DNS-Provider so bald wie möglich aktualisieren oder entfernen, um das Risiko einer Domain-Übernahme zu verhindern. Wenn Sie Ihre benutzerdefinierte Domain bei Ihrem DNS-Provider konfigurieren, während Ihre {% data variables.product.prodname_pages %}-Website deaktiviert ist, könnte ein Dritter eine Website auf einer Ihrer Subdomains hosten. Weitere Informationen finden Sie unter „[Eine benutzerdefinierte Domain mit {% data variables.product.prodname_pages %} verwenden](/articles/using-a-custom-domain-with-github-pages)“. - -### Die Veröffentlichung Ihrer {% data variables.product.prodname_pages %}-Website manuell zurückziehen - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -3. Klicken Sie auf der linken Seitenleiste auf **Unpublish {% data variables.product.prodname_pages %}** (Veröffentlichung von {% data variables.product.prodname_pages %} zurückziehen). ![Repository-Einstellung, um Veröffentlichung der {% data variables.product.prodname_pages %}-Website zurückzuziehen](/assets/images/help/pages/unpublish-pages-button-sidebar.png) -4. Klicken Sie auf **Unpublish this site** (Veröffentlichung dieser Website zurückziehen). ![Schaltfläche, um Veröffentlichung der {% data variables.product.prodname_pages %}-Website zurückzuziehen](/assets/images/help/pages/unpublish-pages-button.png) - -### Weiterführende Informationen - -- „[Veröffentlichung einer Benutzerseiten-Website zurückziehen](articles/unpublishing-a-user-pages-site)“ -- „[Veröffentlichung einer Projektseiten-Website zurückziehen](/articles/unpublishing-a-project-pages-site)“ -- „[Repository übertragen](/articles/transferring-a-repository)“ -- „[Informationen zur Archivierung von Repositorys](/articles/about-archiving-repositories)“ -- „[Repository löschen](/articles/deleting-a-repository)“ diff --git a/translations/de-DE/content/github/articles/searching-and-navigating-code.md b/translations/de-DE/content/github/articles/searching-and-navigating-code.md deleted file mode 100644 index 3e3c644ca9d3..000000000000 --- a/translations/de-DE/content/github/articles/searching-and-navigating-code.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: In Code suchen und navigieren -intro: 'Das Durchsuchen von Code und das Navigieren in Code sind entscheidende Arbeitsschritte des Entwicklungsworkflows, und GitHub hat es sich zur Aufgabe gemacht, diese Bereiche zu optimieren. Wenn Ihre Organisation am Test der privaten Beta-Version von „Code Search and Navigation“ teilnimmt, stehen Ihnen leistungsstarke neue Such- und Navigationstools zur Verfügung. Wenn Sie weitere Informationen zu dieser privaten Beta-Version wünschen, schreiben Sie eine E-Mail an search-beta@github.com.' -hidden: true -redirect_from: - - /articles/searching-and-navigating-code -versions: - free-pro-team: '*' ---- - - -### In diesem Handbuch - -- [Suche nach Literalen](#literal-code-search) -- [Relevanz](#relevancy) -- [„Jump to“-Navigation](#jump-to-navigation) - -### Suche nach Literalen - -Vor der Einführung dieser privaten Beta-Version wurden viele Zeichen aus Suchindizes entfernt. Nach gängigen Idiomen wie `>>` konnte daher nicht gesucht werden. Beispielsweise war die Suche in einem Repository nach `>>` ergebnislos. In der privaten Beta-Version können Sie Idiome wie diese in doppelte Anführungszeichen setzen und erhalten so korrekte Ergebnisse. Dieses Feature geht weit über einzelne Zeichen hinaus. So können Sie auch nach Phrasen in Anführungszeichen wie `"return [] unless"` suchen. Dieses Feature wird bei Suchen in Code in allen Sprachen gleich angewendet. - -### Relevanz - -Bei einigen Programmiersprachen wie Go, JavaScript, Python, Ruby und TypeScript moduliert die Suche in Code die Relevanz der Deklarationen. Die Deklaration der Methode, Funktion, Klasse oder anderen Entität wird vor den Aufrufen oder Kommentaren zurückgegeben, die den jeweiligen Suchstring enthalten. - -### „Jump to“-Navigation - -Bei einigen Programmiersprachen wie Go, JavaScript, Python, Ruby und TypeScript unterstützt GitHub nun weitere Informationen und Navigationen, wenn Sie auf ein Zeichen klicken. Diese Navigation beinhaltet für Ressourcen innerhalb des Repositorys eine „Jump to Definition“-Navigation, wodurch sich die Navigation beschleunigt und mehr Einblicke bietet. - -### Feedback - -Alle Benutzer, die derzeit am Test der privaten Beta-Version von „Code Search and Navigation“ teilnehmen, können uns ihr Feedback über [diese Umfrage](https://www.research.net/r/CodeSearch-Navigation) übermitteln. Für weitere Kommentare und Fragen schreiben Sie eine E-Mail an search-beta@github.com. - -### Weiterführende Informationen -- [Informationen zur Suche auf GitHub](/articles/about-searching-on-github/) -- [Geänderte Methoden und Funktionen in einem Pull Request suchen](/articles/finding-changed-methods-and-functions-in-a-pull-request/) diff --git a/translations/de-DE/content/github/articles/using-gist-playground.md b/translations/de-DE/content/github/articles/using-gist-playground.md deleted file mode 100644 index 872796a58507..000000000000 --- a/translations/de-DE/content/github/articles/using-gist-playground.md +++ /dev/null @@ -1,45 +0,0 @@ ---- -title: Gist Playground verwenden -intro: '' -hidden: true -redirect_from: - - /articles/articles/using-gist-playground -versions: - free-pro-team: '*' ---- - -{% note %} - -**Hinweis:** Gist Playground ist als ein privates Beta-Programm mit eingeschränkten Funktionen verfügbar und unterliegt der Early Access-Vereinbarung. - -{% endnote %} - -### Inhalt dieses Artikels -- [Informationen zu Gist Playground](#about-gist-playground) -- [Neue Gists erstellen](#creating-new-gists) -- [Ihre Änderungen speichern](#saving-your-changes) -- [Mit anderen zusammenarbeiten](#collaborating-with-others) -- [Bugs melden und Feedback senden](#reporting-bugs-and-feedback) - -### Informationen zu Gist Playground -Gist Playground ist eine experimentelle Iteration von [Gist](https://gist.github.com/). Ihre Änderungen werden automatisch gespeichert, während Sie mit Ihren Freunden und Kollegen zusammenarbeiten. - -### Neue Gists erstellen -Wenn Sie Gist Playground besuchen, wird automatisch ein neuer Entwurf erstellt oder Ihr neuester Entwurf angezeigt. Klicken Sie im Header auf **Create gist** (Gist erstellen), wenn Sie bereit sind, Ihren Gist zu erstellen und freizugeben. - -Alle in Gist Playground erstellten Gists sind *geheim*. Derzeit gibt es keine Möglichkeit, Gists in Gist Playgound zu veröffentlichen. Wenn Sie einen Gist veröffentlichen möchten, können Sie dazu den vorhandenen [Gist](https://gist.github.com/) verwenden. - -### Ihre Änderungen speichern -Ihre Änderungen werden während Ihrer Eingabe automatisch gespeichert. Sie können die Registerkarte jederzeit schließen und die Arbeit später wieder aufnehmen, ohne dass Sie Daten verlieren. - -Wenn Sie sich an einem Checkpoint befinden, können Sie den Gist mit den entsprechenden Änderungen aktualisieren. Klicken Sie dazu im Header auf **Update gist** (Gist aktualisieren). - -### Mit anderen zusammenarbeiten -Sie können mit anderen Personen zusammenarbeiten, die Teil des privaten Gist Playground-Beta-Programms sind. Klicken Sie unter „Invite to collaborate“ (Zur Zusammenarbeit einladen) auf die URL zur Zusammenarbeit, um sie zu kopieren. Senden Sie die URL anschließend an einen Freund, um gemeinsam Änderungen vornehmen zu können. - -Wenn Sie sich an einem Checkpoint befinden, kann der Inhaber des Gists die Änderungen beibehalten, indem er auf **Update gist** (Gist aktualisieren) klickt. - -Wenn Sie mit jemandem zusammenarbeiten möchten, der kein Teil des privaten Gist Playground-Beta-Programms ist, senden Sie uns eine E-Mail an [gist-playground@github.com](mailto:gist-playground@github.com), und wir überprüfen, ob wir ihn hinzufügen können. - -### Bugs melden und Feedback senden -Teilen Sie uns gerne mit, was Sie von Gist Playground denken und was verbessert werden sollte! Senden Sie eine E-Mail mit Ihren Gedanken, Ihrem Feedback oder zu gefundenen Bugs an [gist-playground@github.com](mailto:gist-playground@github.com). diff --git a/translations/de-DE/content/github/committing-changes-to-your-project/why-are-my-commits-in-the-wrong-order.md b/translations/de-DE/content/github/committing-changes-to-your-project/why-are-my-commits-in-the-wrong-order.md deleted file mode 100644 index 25cc60517d76..000000000000 --- a/translations/de-DE/content/github/committing-changes-to-your-project/why-are-my-commits-in-the-wrong-order.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: Warum sind Commits in der falschen Reihenfolge? -intro: 'Wenn Du Deinen Commit-Verlauf über den Befehl „git rebase“ oder über einen erzwungenen Push-Vorgang umschreibst, wirst Du beim Öffnen eines Pull Requests feststellen, dass Deine Commit-Abfolge eine abweichende Reihenfolge aufweist.' -redirect_from: - - /articles/why-are-my-commits-in-the-wrong-order -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -GitHub hebt Pull Requests als einen Raum für Diskussionen hervor. Alle Aspekte davon – Kommentare, Referenzen und Commits – werden in chronologischer Reihenfolge dargestellt. Wenn beim [Durchführen von Rebasing-Vorgängen](/articles/about-git-rebase) Dein Git-Commit-Verlauf umgeschrieben wird, ändert sich dadurch das Raum-Zeit-Kontinuum, was bedeutet, dass Commits möglicherweise nicht wie von Dir erwartet auf der GitHub-Oberfläche dargestellt werden. - -Sollen Commits immer in der richtigen Reihenfolge angezeigt werden, solltest Du `git rebase` nicht verwenden. Sei jedoch versichert, dass nichts defekt ist, wenn die Elemente nicht in der chronologischen Reihenfolge angezeigt werden! diff --git a/translations/de-DE/content/github/developing-online-with-codespaces/connecting-to-your-codespace-from-visual-studio-code.md b/translations/de-DE/content/github/developing-online-with-codespaces/connecting-to-your-codespace-from-visual-studio-code.md deleted file mode 100644 index 22d5c091eb57..000000000000 --- a/translations/de-DE/content/github/developing-online-with-codespaces/connecting-to-your-codespace-from-visual-studio-code.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: Aus Visual Studio Code zu Deinem Codespace verbinden -intro: 'Du kannst über {% data variables.product.prodname_vscode %} direkt in Deinem Codespace entwickeln, indem Du die {% data variables.product.prodname_vs_codespaces %}-Erweiterung mit Deinem Konto auf {% data variables.product.product_name %} verbindest.' -product: '{% data reusables.gated-features.codespaces %}' -versions: - free-pro-team: '*' ---- - -{% data reusables.codespaces.release-stage %} - -### Die {% data variables.product.prodname_vs_codespaces %}-Erweiterung zu Deinem {% data variables.product.prodname_dotcom %}-Konto verbinden - -Bevor Du über {% data variables.product.prodname_vscode %} direkt in einem Codespace entwickeln kannst, musst Du die {% data variables.product.prodname_vs_codespaces %}-Erweiterung so konfigurieren, dass sie sich zu Deinem {% data variables.product.product_name %}-Konto verbindet. - -1. Du kannst {% data variables.product.prodname_vs %}-Marketplace verwenden, um die [{% data variables.product.prodname_vs_codespaces %}](https://marketplace.visualstudio.com/items?itemName=ms-vsonline.vsonline)-Erweiterung zu installieren. Weitere Informationen findest Du unter „[Marketplace-Erweiterung](https://code.visualstudio.com/docs/editor/extension-gallery)" in der {% data variables.product.prodname_vscode %}-Dokumentation. -2. Klicke in der linken Seitenleiste in {% data variables.product.prodname_vscode %} auf das Symbol „Extensions" (Erweiterungen). ![Das Symbol „Extensions" (Erweiterungen) in {% data variables.product.prodname_vscode %}](/assets/images/help/codespaces/click-extensions-icon-vscode.png) -3. Klicke unterhalb von {% data variables.product.prodname_vs_codespaces %} auf das Symbol „Manage" (Verwalten), und klicke dann auf **Extension Settings** (Erweiterungseinstellungen). ![Option „Extension Settings" (Erweiterungseinstellungen)](/assets/images/help/codespaces/select-extension-settings.png) -4. Verwende das Dropdownmenü „Vsonline: Account Provider" (Vsonline: Kontoanbieter) und wähle {% data variables.product.prodname_dotcom %}. ![Den Kontoanbieter auf {% data variables.product.prodname_dotcom %} setzen](/assets/images/help/codespaces/select-account-provider-vscode.png) -{% data reusables.codespaces.click-remote-explorer-icon-vscode %} -6. Wenn {% data variables.product.prodname_codespaces %} in der Kopfzeile noch nicht ausgewählt ist, klicke auf **{% data variables.product.prodname_codespaces %}**. ![Die {% data variables.product.prodname_codespaces %}-Kopfzeile](/assets/images/help/codespaces/codespaces-header-vscode.png) -7. Klicke auf **Sign in to view {% data variables.product.prodname_codespaces %}...** (Anmelden zur Anzeige von...). ![Anmelden, um {% data variables.product.prodname_codespaces %} anzuzeigen](/assets/images/help/codespaces/sign-in-to-view-codespaces-vscode.png) -8. Um {% data variables.product.prodname_vscode %} für den Zugriff zu Deinem Konto auf {% data variables.product.product_name %} zu autorisieren, klicke auf **Allow** (Genehmigen). -9. Melde Dich bei {% data variables.product.product_name %} an, um die Erweiterung zu genehmigen. - -### Einen Codespace in {% data variables.product.prodname_vscode %} eröffnen - -Nachdem Du Dein {% data variables.product.product_name %}-Konto mit der {% data variables.product.prodname_vs_codespaces %}-Erweiterung verbunden hast, kannst Du direkt über {% data variables.product.prodname_vscode %} in einem Codespace entwickeln, den Du mit {% data variables.product.product_name %} erstellt hast. - -{% data reusables.codespaces.click-remote-explorer-icon-vscode %} -2. Klicke unter „Codespaces" auf den Codespace, in dem Du entwickeln willst. -3. Klicke auf das Symbol „Connect to Codespace" (Verbinde zu Codespace). ![Symbol „Connect to Codespace" (Verbinde mit Codespace) in {% data variables.product.prodname_vscode %}](/assets/images/help/codespaces/click-connect-to-codespace-icon-vscode.png) diff --git a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-for-compiled-languages.md b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-for-compiled-languages.md deleted file mode 100644 index bf4efc3026be..000000000000 --- a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-for-compiled-languages.md +++ /dev/null @@ -1,137 +0,0 @@ ---- -title: Configuring code scanning for compiled languages -shortTitle: Configuring for compiled languages -intro: 'You can configure how {% data variables.product.prodname_dotcom %} scans code written in compiled languages for vulnerabilities and errors.' -product: '{% data reusables.gated-features.code-scanning %}' -permissions: 'People with write permissions to a repository can configure {% data variables.product.prodname_code_scanning %} for the repository.' -versions: - free-pro-team: '*' ---- - -{% data reusables.code-scanning.beta %} - -{% note %} - -**Note**: This article refers to {% data variables.product.prodname_code_scanning %} powered by {% data variables.product.prodname_codeql %}, not to {% data variables.product.prodname_code_scanning %} resulting from the upload of third-party static analysis tools. - -{% endnote %} - -### About {% data variables.product.prodname_code_scanning %} and compiled languages - -To enable {% data variables.product.prodname_code_scanning %} for your repository, you add to the repository a {% data variables.product.prodname_actions %} workflow which includes {% data variables.product.prodname_codeql %} analysis. For more information, see "[Enabling {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning)." - -{% data reusables.code-scanning.edit-workflow %} -For more information about configuring {% data variables.product.prodname_code_scanning %} and editing workflow files, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)" and "[Configuring a workflow](/actions/configuring-and-managing-workflows/configuring-a-workflow)." - -### About autobuild for {% data variables.product.prodname_codeql %} - -{% data reusables.code-scanning.autobuild-compiled-languages %} - -{% note %} - -**Note**: If you use self-hosted runners for {% data variables.product.prodname_actions %}, you may need to install additional software to use the `autobuild` process. Additionally, if your repository requires a specific version of a build tool, you may need to install it manually. Weitere Informationen findest Du unter „[Auf GitHub-gehosteten Runnern installierte Software](/actions/reference/software-installed-on-github-hosted-runners)". - -{% endnote %} - -#### C/C++ - -| Supported system type | System name | -| --------------------- | ----------------------------------------------------------- | -| Betriebssystem | Windows and Linux | -| Build system | Autoconf, CMake, qmake, Meson, Waf, SCons, and Linux Kbuild | - -The behavior of the `autobuild` step varies according to the operating system that the extraction runs on. On Windows, the step has no default actions. On Linux, this step reviews the files present in the repository to determine the build system used: - -1. Look for a build system in the root directory. -2. If none are found, search subdirectories for a unique directory with a build system for C/C++. -3. Run an appropriate command to configure the system. - -#### C - -| Supported system type | System name | -| --------------------- | ------------------------------------------ | -| Betriebssystem | Windows and Linux | -| Build system | .NET and MSbuild, as well as build scripts | - -The `autobuild` process attempts to autodetect a suitable build method for C# using the following approach: - -1. Invoke `dotnet build` on the solution (`.sln`) or project (`.csproj`) file closest to the root. -2. Invoke `MSbuild` (Linux) or `MSBuild.exe` (Windows) on the solution or project file closest to the root. If `autobuild` detects multiple solution or project files at the same (shortest) depth from the top level directory, it will attempt to build all of them. -3. Invoke a script that looks like a build script—_build_ and _build.sh_ (in that order, for Linux) or _build.bat_, _build.cmd_, _and build.exe_ (in that order, for Windows). - - -#### Java - -| Supported system type | System name | -| --------------------- | ----------------------------------------- | -| Betriebssystem | Windows, macOS and Linux (no restriction) | -| Build system | Gradle, Maven and Ant | - -The `autobuild` process tries to determine the build system for Java codebases by applying this strategy: - -1. Search for a build file in the root directory. Check for Gradle then Maven then Ant build files. -2. Run the first build file found. If both Gradle and Maven files are present, the Gradle file is used. -3. Otherwise, search for build files in direct subdirectories of the root directory. If only one subdirectory contains build files, run the first file identified in that subdirectory (using the same preference as for 1). If more than one subdirectory contains build files, report an error. - -### Adding build steps for a compiled language - -{% data reusables.code-scanning.autobuild-add-build-steps %} For information about editing the workflow, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#editing-a-code-scanning-workflow)." - -After removing the `autobuild` step, uncomment the `run` step and add build commands that are suitable for your repository. The workflow `run` step runs command-line programs using the operating system's shell. You can modify these commands and add more commands to customize the build process. - -``` yaml -- run: | - make bootstrap - make release -``` - -For more information about the `run` keyword, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)." - -You can also use a build matrix to update the workflow to build more than one compiled language, if this is the appropriate approach for your system and doesn't cause conflicts. For more information, see "[Configuring a build matrix](/actions/configuring-and-managing-workflows/configuring-a-workflow#configuring-a-build-matrix)." - - -For example, the workflow below runs one job for C/C++ analysis, and another job for Java analysis. - -```yaml - -name: "Code Scanning - Action" - -on: - pull_request: - branches: [master] - push: - branches: [master] - -jobs: - CodeQL-Build: - - strategy: - fail-fast: false - matrix: - language: [ 'cpp', 'java'] - - # CodeQL runs on ubuntu-latest, windows-latest, and macos-latest - runs-on: ubuntu-latest - - steps: - - name: Checkout repository - uses: actions/checkout@v2 - - # Initializes the CodeQL tools for scanning. - - name: Initialize CodeQL - uses: github/codeql-action/init@v1 - with: - languages: ${{ matrix.language }} - - # Autobuild attempts to build any compiled languages (C/C++, C#, or Java). - # If this step fails, then you should remove it and run the build manually. - - name: Autobuild - uses: github/codeql-action/autobuild@v1 - - - name: Perform CodeQL Analysis - uses: github/codeql-action/analyze@v1 -``` - -For more tips and tricks about why `autobuild` won't build your code, see "[Troubleshooting {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning)". - -If you added manual build steps for compiled languages or used a build matrix and {% data variables.product.prodname_code_scanning %} is still not working on your repository, contact {% data variables.contact.contact_support %}. diff --git a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages.md b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages.md deleted file mode 100644 index 22b7439ae343..000000000000 --- a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages.md +++ /dev/null @@ -1,134 +0,0 @@ ---- -title: Configuring the CodeQL action for compiled languages -shortTitle: Configuring for compiled languages -intro: 'You can configure how {% data variables.product.prodname_dotcom %} uses the {% data variables.product.prodname_codeql_workflow %} to scan code written in compiled languages for vulnerabilities and errors.' -product: '{% data reusables.gated-features.code-scanning %}' -permissions: 'People with write permissions to a repository can configure {% data variables.product.prodname_code_scanning %} for the repository.' -redirect_from: - - /github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-for-compiled-languages -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.code-scanning.beta %} -{% data reusables.code-scanning.enterprise-enable-code-scanning-actions %} - -### About the {% data variables.product.prodname_codeql_workflow %} and compiled languages - -You enable {% data variables.product.prodname_dotcom %} to run {% data variables.product.prodname_code_scanning %} for your repository by adding a {% data variables.product.prodname_actions %} workflow to the repository. **Note**: This article refers to {% data variables.product.prodname_code_scanning %} powered by {% data variables.product.prodname_codeql %}, not to {% data variables.product.prodname_code_scanning %} resulting from the upload of third-party static analysis tools. The default {% data variables.product.prodname_code_scanning %} workflow uses the `on.push` event to trigger a code scan on every push to any branch containing the workflow file. - -{% data reusables.code-scanning.edit-workflow %} -For general information about configuring {% data variables.product.prodname_code_scanning %} and editing workflow files, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)" and "[Configuring a workflow](/actions/configuring-and-managing-workflows/configuring-a-workflow)." - -### About autobuild for {% data variables.product.prodname_codeql %} - -{% data reusables.code-scanning.autobuild-compiled-languages %} - -{% note %} - -**Note**: If you use self-hosted runners for {% data variables.product.prodname_actions %}, you may need to install additional software to use the `autobuild` process. Additionally, if your repository requires a specific version of a build tool, you may need to install it manually. Weitere Informationen findest Du unter „[Auf GitHub-gehosteten Runnern installierte Software](/actions/reference/software-installed-on-github-hosted-runners)". - -{% endnote %} - -#### C/C++ - -| Supported system type | System name | -| --------------------- | ----------------------------------------------------------- | -| Betriebssystem | Windows and Linux | -| Build system | Autoconf, CMake, qmake, Meson, Waf, SCons, and Linux Kbuild | - -The behavior of the `autobuild` step varies according to the operating system that the extraction runs on. On Windows, the step has no default actions. On Linux, this step reviews the files present in the repository to determine the build system used: - -1. Look for a build system in the root directory. -2. If none are found, search subdirectories for a unique directory with a build system for C/C++. -3. Run an appropriate command to configure the system. - -#### C - -| Supported system type | System name | -| --------------------- | ------------------------------------------ | -| Betriebssystem | Windows and Linux | -| Build system | .NET and MSbuild, as well as build scripts | - -The `autobuild` process attempts to autodetect a suitable build method for C# using the following approach: - -1. Invoke `dotnet build` on the solution (`.sln`) or project (`.csproj`) file closest to the root. -2. Invoke `MSbuild` (Linux) or `MSBuild.exe` (Windows) on the solution or project file closest to the root. If `autobuild` detects multiple solution or project files at the same (shortest) depth from the top level directory, it will attempt to build all of them. -3. Invoke a script that looks like a build script—_build_ and _build.sh_ (in that order, for Linux) or _build.bat_, _build.cmd_, _and build.exe_ (in that order, for Windows). - -#### Java - -| Supported system type | System name | -| --------------------- | ----------------------------------------- | -| Betriebssystem | Windows, macOS and Linux (no restriction) | -| Build system | Gradle, Maven and Ant | - -The `autobuild` process tries to determine the build system for Java codebases by applying this strategy: - -1. Search for a build file in the root directory. Check for Gradle then Maven then Ant build files. -2. Run the first build file found. If both Gradle and Maven files are present, the Gradle file is used. -3. Otherwise, search for build files in direct subdirectories of the root directory. If only one subdirectory contains build files, run the first file identified in that subdirectory (using the same preference as for 1). If more than one subdirectory contains build files, report an error. - -### Adding build steps for a compiled language - -{% data reusables.code-scanning.autobuild-add-build-steps %} For information about editing the workflow, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#editing-a-code-scanning-workflow)." - -After removing the `autobuild` step, uncomment the `run` step and add build commands that are suitable for your repository. The workflow `run` step runs command-line programs using the operating system's shell. You can modify these commands and add more commands to customize the build process. - -``` yaml -- run: | - make bootstrap - make release -``` - -For more information about the `run` keyword, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)." - -You can also use a build matrix to update the workflow to build more than one compiled language, if this is the appropriate approach for your system and doesn't cause conflicts. For more information, see "[Configuring a build matrix](/actions/configuring-and-managing-workflows/configuring-a-workflow#configuring-a-build-matrix)." - - -For example, the workflow below runs one job for C/C++ analysis, and another job for Java analysis. - -```yaml - -name: "Code Scanning - Action" - -on: - pull_request: - branches: [master] - push: - branches: [master] - -jobs: - CodeQL-Build: - - strategy: - fail-fast: false - matrix: - language: [ 'cpp', 'java'] - - # CodeQL runs on ubuntu-latest, windows-latest, and macos-latest - runs-on: ubuntu-latest - - steps: - - name: Checkout repository - uses: actions/checkout@v2 - - # Initializes the CodeQL tools for scanning. - name: Initialize CodeQL - uses: github/codeql-action/init@v1 - with: - languages: ${{ matrix.language }} - - # Autobuild attempts to build any compiled languages (C/C++, C#, or Java). - # If this step fails, then you should remove it and run the build manually. - - name: Autobuild - uses: github/codeql-action/autobuild@v1 - - - name: Perform CodeQL Analysis - uses: github/codeql-action/analyze@v1 -``` - -For more tips and tricks about why `autobuild` won't build your code, see "[Troubleshooting {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning)". - -If you added manual build steps for compiled languages or used a build matrix and {% data variables.product.prodname_code_scanning %} is still not working on your repository, contact {% data variables.contact.contact_support %}. diff --git a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning.md b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning.md deleted file mode 100644 index facacd68d4cd..000000000000 --- a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: Enabling code scanning -intro: 'You can enable {% data variables.product.prodname_code_scanning %} for your project''s repository.' -product: '{% data reusables.gated-features.code-scanning %}' -permissions: 'People with write permissions to a repository can enable {% data variables.product.prodname_code_scanning %} for the repository.' -redirect_from: - - /github/managing-security-vulnerabilities/configuring-automated-code-scanning -versions: - free-pro-team: '*' ---- - -{% data reusables.code-scanning.beta %} - -### {% data variables.product.prodname_code_scanning %} aktivieren - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-security %} -3. To the right of "Code scanning", click **Set up code scanning**. !["Set up code scanning" button to the right of "Code scanning" in the Security Overview](/assets/images/help/security/overview-set-up-code-scanning.png) -4. Under "Get started with code scanning", click **Set up this workflow**. !["Set up this workflow" button under "Get started with code scanning" heading](/assets/images/help/repository/code-scanning-set-up-this-workflow.png) -5. Optionally, to customize how {% data variables.product.prodname_code_scanning %} scans your code, edit the workflow. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." -6. Use the **Start commit** drop-down, and type a commit message. ![Start commit](/assets/images/help/repository/start-commit-commit-new-file.png) -7. Choose whether you'd like to commit directly to the default branch, or create a new branch and start a pull request. ![Choose where to commit](/assets/images/help/repository/start-commit-choose-where-to-commit.png) -8. Click **Commit new file** or **Propose new file**. - -After you commit the workflow file or create a pull request, {% data variables.product.prodname_code_scanning %} will analyze your code according to the frequency you specified in your workflow file. If you created a pull request, {% data variables.product.prodname_code_scanning %} will only analyze the code on the pull request's topic branch until you merge the pull request into the default branch of the repository. - -### Nächste Schritte: - -After you enable {% data variables.product.prodname_code_scanning %}, you can monitor analysis, view results, and further customize how you scan your code. - -- You can view the run status of {% data variables.product.prodname_code_scanning %} and get notifications for completed runs. For more information, see "[Managing a workflow run](/actions/configuring-and-managing-workflows/managing-a-workflow-run)" and "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)." -- After a scan completes, you can view alerts from a completed scan. For more information, see "[Managing alerts from {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)." -- You can customize how {% data variables.product.prodname_code_scanning %} scans the code in your repository. For more information, see "[Configuring code scanning](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." diff --git a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning.md b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning.md deleted file mode 100644 index 903cd7f27234..000000000000 --- a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning.md +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: Managing alerts from code scanning -shortTitle: Warnungen verwalten -intro: 'You can view, fix, and close alerts for potential vulnerabilities or errors in your project''s code.' -product: '{% data reusables.gated-features.code-scanning %}' -permissions: 'People with write permissions to a repository can manage {% data variables.product.prodname_code_scanning %} alerts for the repository.' -redirect_from: - - /github/managing-security-vulnerabilities/managing-alerts-from-automated-code-scanning -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.code-scanning.beta %} -{% data reusables.code-scanning.enterprise-enable-code-scanning %} - -### About alerts from {% data variables.product.prodname_code_scanning %} - -After you enable {% data variables.product.prodname_code_scanning %}, {% data variables.product.prodname_dotcom %} displays {% data variables.product.prodname_code_scanning %} alerts in your repository. The default {% data variables.product.prodname_code_scanning %} workflow uses the `on.push` event to trigger a code scan on every push to any branch containing the workflow file. - -Each alert highlights a problem with the code and the name of the tool that identified it. You can see the line of code that triggered the alert, as well as properties of the alert, such as the severity and the nature of the problem. Alerts also tell you when the issue was first introduced. For alerts identified by {% data variables.product.prodname_codeql %} analysis, you will also see information on how to fix the problem. - -![Example alert from {% data variables.product.prodname_code_scanning %}](/assets/images/help/repository/code-scanning-alert.png) - -If you won't take the action that the alert recommends, you can close the alert manually. For example, you can close an alert for code that's used for testing, or if you believe the alert is a false positive. You might also want to close an alert if the effort of fixing the coding error is greater than the potential benefit of improving the code. - -By default, {% data variables.product.prodname_dotcom %} displays alerts for the default branch and any protected branches. You can sort and filter the list of alerts to see only the alerts you're interested in. - -You can see the alerts introduced in a pull request, and take immediate action. When {% data variables.product.prodname_code_scanning %} finds vulnerabilities or errors in a pull request, {% data variables.product.prodname_dotcom %} displays annotations in the timeline and the diff views of the pull request. - -If you enable {% data variables.product.prodname_code_scanning %} using {% data variables.product.prodname_codeql %}, this can also detect data-flow problems in your code. Data-flow analysis finds potential security issues in code, such as: using data insecurely, passing dangerous arguments to functions, and leaking sensitive information. - -When {% data variables.product.prodname_code_scanning %} reports data-flow alerts, {% data variables.product.prodname_dotcom %} shows you how data moves through the code. {% data variables.product.prodname_code_scanning_capc %} allows you to identify the areas of your code that leak sensitive information, and that could be the entry point for attacks by malicious users. - -{% data reusables.code-scanning.you-can-upload-third-party-analysis %} {% data reusables.code-scanning.get-started-uploading-third-party-data %} - -If you scan your code using a third-party tool or scan your code with custom {% data variables.product.prodname_codeql %} queries, {% data variables.product.prodname_dotcom %} will only use the supported SARIF 2.1.0 properties to display alerts. Results from third-party tools or custom queries may not include all of the properties that you see when you scan your code using {% data variables.product.company_short %}'s default {% data variables.product.prodname_codeql %} queries. For more information, see "[SARIF support for {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning)." - -### Viewing an alert - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-security %} -{% data reusables.repositories.sidebar-code-scanning-alerts %} -{% data reusables.code-scanning.click-alert-in-list %} -5. Optionally, if the alert highlights a problem with data flow, click **Show paths** to review the data's path. ![Example data-flow alert](/assets/images/help/repository/code-scanning-show-paths.png) - -### Closing an alert - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-security %} -{% data reusables.repositories.sidebar-code-scanning-alerts %} -{% data reusables.code-scanning.click-alert-in-list %} -5. Use the "Close" drop-down, and click a reason for closing the alert. ![Choosing reason for closing the alert via the "Close" drop-down](/assets/images/help/repository/code-scanning-alert-close-drop-down.png) - -### Weiterführende Informationen - -- "[{% data variables.product.prodname_code_scanning_capc %}](http://developer.github.com/v3/code-scanning)" -- "[{% data variables.product.prodname_code_scanning_capc %} API](/v3/code-scanning)" diff --git a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-results-from-code-scanning.md b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-results-from-code-scanning.md deleted file mode 100644 index 7f83b4dc06e4..000000000000 --- a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-results-from-code-scanning.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Managing results from code scanning -shortTitle: Managing results -intro: 'You can view, triage, understand, and resolve vulnerabilities and errors that {% data variables.product.prodname_code_scanning %} finds.' -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning.md b/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning.md deleted file mode 100644 index 36819579483d..000000000000 --- a/translations/de-DE/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning.md +++ /dev/null @@ -1,130 +0,0 @@ ---- -title: Troubleshooting code scanning -shortTitle: Troubleshooting -intro: 'You can see tips to resolve common issues with {% data variables.product.prodname_code_scanning %}.' -product: '{% data reusables.gated-features.code-scanning %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.code-scanning.beta %} -{% data reusables.code-scanning.enterprise-enable-code-scanning %} - -### Automatic build for a compiled language fails - -If an automatic build of code for a compiled language within your project fails, try the following troubleshooting steps. - -- Remove the `autobuild` step from your {% data variables.product.prodname_code_scanning %} workflow and add specific build steps. For information about editing the workflow, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#editing-a-code-scanning-workflow)." For more information about replacing the `autobuild` step, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." -- If the repository for your project contains code in a specific language that does not build, disable automatic language detection in your {% data variables.product.prodname_code_scanning %} workflow and specify only the languages you want to build. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#overriding-automatic-language-detection)." - -### No code found during the build - -If your workflow fails with an error `No source code was seen during the build` or `The process '/opt/hostedtoolcache/CodeQL/0.0.0-20200630/x64/codeql/codeql' failed with exit code 32`, this indicates that {% data variables.product.prodname_codeql %} was unable to trace your code. Several reasons can explain such a failure: - -1. Automatic language detection identified a supported language, but there is no analyzable code of that language in the repository. A typical example is when our language detection service finds a file associated with a particular programming language like a `.h`, or `.gyp` file, but no corresponding executable code is present in the repository. To solve the problem, you can manually define the languages you want to analyze by updating the `init` step to specify the supported languages that are present in your repository. For example, the following configuration will analyze only Go, and JavaScript. - - ```yaml - - name: Initialize CodeQL - uses: github/codeql-action/init@v1 - with: - languages: go, javascript # Other options are csharp, python, cpp, java - ``` -2. Your {% data variables.product.prodname_code_scanning %} workflow is analyzing a compiled language (C, C++, C#, or Java), but the code was not compiled. By default, the {% data variables.product.prodname_codeql %} analysis workflow contains an `autobuild` step, however, this step represents a best effort process, and may not succeed in building your code, depending on your specific build environment. Compilation may also fail if you have removed the `autobuild` step and did not include build steps manually. For more information about specifying build steps, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." -3. Your workflow is analyzing a compiled language (C, C++, C#, or Java), but portions of your build are cached to improve performance (most likely to occur with build systems like Gradle or Bazel). Since {% data variables.product.prodname_codeql %} observes the activity of the compiler to understand the data flows in a repository, {% data variables.product.prodname_codeql %} requires a complete build to take place in order to perform analysis. -4. Your workflow is analyzing a compiled language (C, C++, C#, or Java), but compilation does not occur between the `init` and `analyze` steps in the workflow. {% data variables.product.prodname_codeql %} requires that your build happens in between these two steps in order to observe the activity of the compiler and perform analysis. -5. Your compiled code (in C, C++, C#, or Java) was compiled successfully, but {% data variables.product.prodname_codeql %} was unable to detect the compiler invocations. The most common causes are certain configuration options like running your build process in a container, if you're building using a distributed build system external to {% data variables.product.prodname_actions %} using a daemon process, or if {% data variables.product.prodname_codeql %} isn't aware of the specific compiler you are using. - 1. For C# projects using either `dotnet build` or `msbuild` which target .NET Core 2, you should specify `/p:UseSharedCompilation=false` in your workflow's `run` step, when you build your code. The `UseSharedCompilation` flag isn't necessary for .NET Core 3.0 and later. - - For example, the following configuration will pass the flag during the first build step. - - ```yaml - - run: | - dotnet build /p:UseSharedCompilation=false - ``` - 2. If you encounter another problem with your specific compiler or configuration, contact {% data variables.contact.contact_support %}. - -For more information about specifying build steps, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." - -### Portions of my repository were not analyzed using `autobuild` - -The {% data variables.product.prodname_codeql %} `autobuild` feature uses heuristics to build the code in a repository, however, sometimes this approach results in incomplete analysis of a repository. For example, when multiple `build.sh` commands exist in a single repository, the analysis may not complete since the `autobuild` step will only execute one of the commands. The solution is to replace the `autobuild` step with build steps which build all of the source code which you wish to analyze. Alternatively, if more than one compiled language is present in your repository and you want {% data variables.product.prodname_code_scanning %} to analyze all these compiled languages, you can use a build matrix in your workflow. {% if currentVersion ver_gt "enterprise-server@2.21" %}To use a build matrix, you should make sure that {% data variables.product.prodname_actions %} is enabled on {% data variables.product.product_location_enterprise %}. {% endif %}For more information, see "[Managing complex workflows](/actions/learn-github-actions/managing-complex-workflows/#using-a-build-matrix)" and -"[Configuring the {% data variables.product.prodname_codeql %} action for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages#adding-build-steps-for-a-compiled-language)." - -### Error: "Server error" - -If the run of a workflow for {% data variables.product.prodname_code_scanning %} fails due to a server error, try running the workflow again. If the problem persists, contact {% data variables.contact.contact_support %}. - -### Error: "Out of disk" or "Out of memory" - -On very large projects, {% data variables.product.prodname_codeql %} may run out of disk or memory on the runner. -{% if currentVersion == "free-pro-team@latest" %}If you encounter this issue on a hosted {% data variables.product.prodname_actions %} runner, contact {% data variables.contact.contact_support %} so that we can investigate the problem. -{% else %}If you encounter this issue, try increasing the memory on the runner.{% endif %} - -### The build takes too long - -If your build with {% data variables.product.prodname_codeql %} analysis takes too long to run, there are several approaches you can try to reduce the build time. - -#### Increase the memory or cores - -If you use self-hosted runners to run {% data variables.product.prodname_codeql %} analysis, you can increase the memory or the number of cores on those runners. - -#### Use matrix builds to parallelize the analysis - -By default, {% data variables.product.prodname_codeql %} performs analysis of each language sequentially, which can impact performance, especially for repositories with more than one language. You can speed analysis up by using a build matrix that splits the analysis by language. {% if currentVersion ver_gt "enterprise-server@2.21" %}To use a build matrix, you should make sure that {% data variables.product.prodname_actions %} is enabled on {% data variables.product.product_location_enterprise %}. {% endif %}For more information, see "[Managing complex workflows](/actions/learn-github-actions/managing-complex-workflows/#using-a-build-matrix)." - -For example, the workflow below will be run with one job for JavaScript analysis, and another job for Go analysis. - -```yaml - -name: "Code Scanning - Action" - -on: - pull_request: - branches: [main] - push: - branches: [main] - -jobs: - CodeQL-Build: - - strategy: - fail-fast: false - matrix: - language: [ 'go', 'javascript'] - - # CodeQL runs on ubuntu-latest, windows-latest, and macos-latest - runs-on: ubuntu-latest - - steps: - - name: Checkout repository - uses: actions/checkout@v2 - - # Initializes the CodeQL tools for scanning. - - name: Initialize CodeQL - uses: github/codeql-action/init@v1 - with: - languages: ${{ matrix.language }} - - # Autobuild attempts to build any compiled languages (C/C++, C#, or Java). - # If this step fails, then you should remove it and run the build manually (see below). - - name: Autobuild - uses: github/codeql-action/autobuild@v1 - - - name: Perform CodeQL Analysis - uses: github/codeql-action/analyze@v1 -``` - -#### Reduce the amount of code being analyzed in a single workflow - -Analysis time is typically proportional to the amount of code being analyzed. You can reduce the analysis time by reducing the amount of code being analyzed at once, for example, by excluding test code, or breaking analysis into multiple workflows that analyze only a subset of your code at a time. - -For compiled languages like Java, C, C++, and C#, {% data variables.product.prodname_codeql %} analyzes all of the code which was built during the workflow run. To limit the amount of code being analyzed, build only the code which you wish to analyze by specifying your own build steps in a `run` block. You can combine specifying your own build steps with using the `paths` or `paths-ignore` filters on the `pull_request` and `push` events to ensure that your workflow only runs when specific code is changed. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)." - -For interpreted languages like Go, JavaScript, Python, and TypeScript, that {% data variables.product.prodname_codeql %} analyzes without a specific build, you can specify additional configuration options to limit the amount of code to analyze. For more information, see "[Specifying directories to scan](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#specifying-directories-to-scan)." - -If you split your analysis into multiple workflows as described above, we still recommend that you have at least one workflow which runs on a `schedule` which analyzes all of the code in your repository. Because {% data variables.product.prodname_codeql %} analyzes data flows between components, some complex security behaviors may only be detected on a complete build. - -#### Run only during a `schedule` event - -If your analysis is still too slow to be run during `push` or `pull_request` events, then you may want to only trigger analysis on the `schedule` event. For more information, see "[Events](/actions/learn-github-actions/introduction-to-github-actions#events)." diff --git a/translations/de-DE/content/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies.md b/translations/de-DE/content/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies.md deleted file mode 100644 index 6daae10096d5..000000000000 --- a/translations/de-DE/content/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies.md +++ /dev/null @@ -1,57 +0,0 @@ ---- -title: Sicherheitswarnungen für angreifbare Abhängigkeiten -intro: '{% data variables.product.product_name %} sendet Sicherheitswarnungen, wenn wir Schwachstellen entdecken, die Dein Repository betreffen.' -redirect_from: - - /articles/about-security-alerts-for-vulnerable-dependencies -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -### Informationen zu Sicherheitslücken - -{% data reusables.repositories.a-vulnerability-is %} Abhängig vom Schweregrad und der Art und Weise, wie Dein Projekt die Abhängigkeit verwendet, können Schwachstellen eine Reihe von Problemen für Dein Projekt verursachen, wie auch für die Personen, die es verwenden. Du kannst Schwachstellen für bestimmte Arten von Abhängigkeiten in Deinem {% data variables.product.product_name %}-Repository verfolgen und beheben. - -Wenn {% data variables.product.prodname_dotcom %} eine Schwachstelle in der {% data variables.product.prodname_advisory_database %} oder auf [WhiteSource](https://www.whitesourcesoftware.com/GitHubSecurityAlerts) in einer der Abhängigkeiten auf dem entsprechenden Diagramm Deines Repositorys entdeckt, senden wir Dir eine Sicherheitswarnung. Weitere Informationen über die {% data variables.product.prodname_advisory_database %} findest Du unter „Sicherheitslücken in der {% data variables.product.prodname_advisory_database %} durchsuchen." - -{% if currentVersion == "free-pro-team@latest" %} -### Warnungen und automatisierte Sicherheitsupdates für angreifbare Abhängigkeiten -{% else %} -### Sicherheitswarnungen für angreifbare Abhängigkeiten -{% endif %} - -Wenn eine Schwachstelle zur GitHub Advisory Database hinzugefügt wird, identifizieren wir{% if currentVersion == "free-pro-team@latest" %} öffentliche{% endif %} Repositorys{% if currentVersion == "free-pro-team@latest" %} (sowie private Repositorys die sich für die Schwachstellenentdeckung angemeldet haben){% endif %}, welche die betroffene Version der Abhängigkeit einsetzen{% if currentVersion == "free-pro-team@latest" %}, senden eine Sicherheitswarnung an die Repository-Betreuer und erstellen ein automatisiertes Sicherheitsupdate{% else %} und senden eine Sicherheitswarnung an die Repository-Betreuer{% endif %}. - -Jede Sicherheitswarnung enthält einen Schweregrad{% if currentVersion == "free-pro-team@latest" %}, einen Link zur betroffenen Datei in Deinem Projekt und einen Link zu einem Pull Request mit einem automatisierten Sicherheitsupdate zur Behebung der Schwachstelle{% else %} sowie einen Link zur betroffenen Datei in Deinem Projekt{% endif %}. Sofern verfügbar enthält die Benachrichtigung weitere Details über die Schwachstelle. - -Du kannst alle Warnungen, die ein bestimmtes Projekt betreffen,{% if currentVersion == "free-pro-team@latest" %} auf der Registerkarte „Alerts“ (Warnungen) des Repositorys oder{% endif %} im Abhängigkeitsdiagramm des Repositorys sehen.{% if currentVersion == "free-pro-team@latest" %}Weitere Informationen findest Du unter „[Angreifbare Abhängigkeiten in Deinem Repository anzeigen und aktualisieren](/articles/viewing-and-updating-vulnerable-dependencies-in-your-repository).“{% endif %} - -Standardmäßig senden wir Sicherheitswarnungen an Personen mit Administratorberechtigungen in den betroffenen Repositorys. {% data variables.product.product_name %} gibt identifizierte Schwachstellen für ein Repository niemals öffentlich bekannt.{% if currentVersion == "free-pro-team@latest" %} Du kannst auch Sicherheitswarnungen für zusätzliche Personen oder Teams aktivieren, die in organisationseigenen Repositorys arbeiten. Weitere Informationen findest Du unter „[Warnungen für angreifbare Abhängigkeiten in den Repositorys Deiner Organisation verwalten](/articles/managing-alerts-for-vulnerable-dependencies-in-your-organization-s-repositories)“.{% endif %} - -{% data reusables.repositories.enable-security-alerts %} -{% if currentVersion == "free-pro-team@latest" %} -Automatisierte Sicherheitsupdates aktualisieren angreifbare Abhängigkeiten auf die Mindestversion, die die Schwachstelle behebt. Automatisierte Sicherheitsupdates werden automatisch in Repositorys aktiviert, die das Abhängigkeitsdiagramm und Sicherheitswarnungen verwenden, Du kannst jedoch automatische Pull Requests deaktivieren und stattdessen Sicherheitsupdates manuell erstellen. Weitere Informationen findest Du unter „[Automatisierte Sicherheitsupdates konfigurieren](/github/managing-security-vulnerabilities/configuring-automated-security-updates).“ - -{% data variables.product.prodname_dotcom %} erkennt angreifbare Abhängigkeiten in _öffentlichen_ Repositorys und warnt standardmäßig vor ihnen. Um Sicherheitswarnungen für angreifbare Abhängigkeiten in einem _privaten_ Repository zu erhalten, muss ein Inhaber oder eine Person mit Administratorberechtigungen für das Repository das Abhängigkeitsdiagramm und Sicherheitswarnungen im Repository aktivieren. Weitere Informationen findest Du unter „[Datennutzung für Dein privates Repository zulassen oder ablehnen](/articles/opting-into-or-out-of-data-use-for-your-private-repository).“ -{% endif %} - -Eine Liste der unterstützten Sprachen, in denen {% data variables.product.product_name %} Schwachstellen und Abhängigkeiten erkennen kann, findest Du unter „[Pakete auflisten, von denen ein Repository abhängig ist](/articles/listing-the-packages-that-a-repository-depends-on).“ - -{% warning %} - -**Hinweis**: Es kann nicht garantiert werden, dass die Sicherheitsfunktionen von {% data variables.product.product_name %}, beispielsweise Sicherheitswarnungen, alle Schwachstellen erkennen können. Obwohl wir immer versuchen, unsere Schwachstellen-Datenbank aktuell zu halten und Dir unsere neuesten Informationen zur Verfügung zu stellen, können wir nicht alles erfassen oder Dich innerhalb eines garantierten Zeitrahmens über bekannte Schwachstellen informieren. Diese Funktionen ersetzen nicht die menschliche Überprüfung jeder Abhängigkeit auf potenzielle Schwachstellen oder andere Issues. Daher empfehlen wir, einen Sicherheitsdienst zu konsultieren oder bei Bedarf einen gründlichen Schwachstellen-Review durchzuführen. - -{% endwarning %} - -### Benachrichtigungen für Sicherheitswarnungen konfigurieren - -Standardmäßig erhältst Du Sicherheitswarnungen per E-Mail{% if currentVersion == "free-pro-team@latest" %}, sortiert nach der spezifischen Schwachstelle{% endif %}. Du kannst Sicherheitswarnungen auch in einer wöchentlichen E-Mail erhalten, die Warnungen für bis zu 10 Deiner Repositorys zusammenfasst, in Deinen Web-Benachrichtigungen oder in der {% data variables.product.product_name %}-Benutzeroberfläche. Weitere Informationen findest Du unter {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}„[Benachrichtigungen konfigurieren](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#security-alert-options){% else %}„[Auslieferungsmethode Deiner Benachrichtigungen wählen](/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications){% endif %}." - -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" % %}{% data reusables.repositories.security-alerts-x-github-severity %} Weitere Informationen findest Du unter {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}„[Benachrichtigungen konfigurieren](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#filtering-email-notifications){% else %}„[Über E-Mail-Benachrichtigungen](/github/receiving-notifications-about-activity-on-github/about-email-notifications){% endif %}.{% endif %} - -### Weiterführende Informationen - -{% if currentVersion == "free-pro-team@latest" %}- „[Automatisierte Sicherheitsupdates konfigurieren](/github/managing-security-vulnerabilities/configuring-automated-security-updates)" -- „[Angreifbare Abhängigkeiten in Deinem Repository anzeigen und aktualisieren](/articles/viewing-and-updating-vulnerable-dependencies-in-your-repository)“ -- „[Grundlegendes zur Verwendung und zum Schutz Deiner Daten in {% data variables.product.product_name %}](/categories/understanding-how-github-uses-and-protects-your-data)“{% endif %} -- [Definition für „Schwachstelle“](https://cve.mitre.org/about/terminology.html#vulnerability) von MITRE diff --git a/translations/de-DE/content/github/managing-security-vulnerabilities/configuring-automated-security-updates.md b/translations/de-DE/content/github/managing-security-vulnerabilities/configuring-automated-security-updates.md deleted file mode 100644 index 4891dbb253af..000000000000 --- a/translations/de-DE/content/github/managing-security-vulnerabilities/configuring-automated-security-updates.md +++ /dev/null @@ -1,92 +0,0 @@ ---- -title: Automatisierte Sicherheitsupdates konfigurieren -intro: 'Du kannst automatisierte oder manuelle Pull Requests nutzen, um angreifbare Abhängigkeiten einfach zu aktualisieren.' -redirect_from: - - /articles/configuring-automated-security-fixes - - /github/managing-security-vulnerabilities/configuring-automated-security-fixes -versions: - free-pro-team: '*' ---- - -### Über automatisierte Sicherheitsupdates - -Du kannst automatisierte Sicherheitsupdates für jedes Repository aktivieren, das Sicherheitswarnungen und das Abhängigkeitsdiagramm nutzt. Du kannst automatisierte Sicherheitsupdates für einzelne Repositorys oder für alle Repositorys Deines Benutzerkontos oder Deiner Organisation deaktivieren. - -Wenn Du eine Sicherheitswarnung zu einer angreifbaren Abhängigkeit in Deinem Repository erhältst, kannst Du die Schwachstelle mit einem automatisierten Sicherheitsupdate in einem Pull Request beheben, das der Sicherheitsmeldung entspricht. Automatisierte Sicherheitsupdates sind für Repositorys mit Abhängigkeitsdiagramm verfügbar. Standardmäßig erstellt {% data variables.product.prodname_dotcom %} automatisch einen Pull Request in Deinem Repository, um die angreifbare Abhängigkeit auf die minimal erforderliche sichere Version zu aktualisieren, damit die Schwachstelle behoben ist. Du kannst automatische Pull Requests auch deaktivieren und manuell Pull Requests nur dann erstellen, wenn Du Abhängigkeiten aktualisieren möchtest. - -Automatisierte Sicherheitsanfragen enthalten alles, was Du zum schnellen und sicheren Prüfen und Zusammenführen einer vorgeschlagenen Fehlerbehebung in Deinem Projekt benötigst. Dazu gehören auch Informationen zur Schwachstelle, wie Releasehinweise, Änderungsprotokolle und Commit-Details. - -Automatisierte Sicherheitsupdates werden von 'Dependabot' im Auftrag von {% data variables.product.prodname_dotcom %} eröffnet. Die Dependabot-{% data variables.product.prodname_github_app %} wird automatisch auf jedem Repository installiert, in dem automatisierte Sicherheitsupdates aktiviert sind. - -Personen mit Zugriff auf die Sicherheitswarnungen Deines Repositorys sehen einen Link zur relevanten Sicherheitswarnung, aber andere Personen mit Zugriff auf den Pull Request können nicht sehen, welche Schwachstelle der Pull Request behebt. - -Wenn Du einen Pull Request zusammenführst, der ein automatisiertes Sicherheitsupdate enthält, wird die zugehörige Sicherheitswarnung für Dein Repository als behoben gekennzeichnet. - -{% note %} - -**Hinweis:** Automatisierte Sicherheitsupdates beheben nur Sicherheitslücken. Automatisierte Sicherheitsupdates werden nicht erstellt, um Schwachstellen in privaten Registries oder in Paketen zu beheben, die in privaten Repositorys gehostet werden. - -{% endnote %} - -### Unterstützte Repositorys - -{% data variables.product.prodname_dotcom %} wird automatisierte Sicherheitsupdates automatisch für alle Repositorys aktivieren, die diese Voraussetzungen erfüllen. - -{% note %} - -**Hinweis**: Für Repositorys, die vor November 2019 erstellt wurden, hat {% data variables.product.prodname_dotcom %} automatisierte Sicherheitsupdates automatisch aktiviert, wenn das Repository die folgenden Voraussetzungen erfüllt und seit 23. Mai 2019 mindestens einen Push erhalten hat. - -{% endnote %} - -| Voraussetzung | Weitere Informationen | -| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Das Repository ist kein Fork | „[Über Forks](/github/collaborating-with-issues-and-pull-requests/about-forks)" | -| Das Repository ist nicht archiviert | „[Repositorys archivieren](/github/creating-cloning-and-archiving-repositories/archiving-repositories)" | -| Das Repository ist öffentlich, oder es ist privat und Du hast Nur-Lesen-Analysen durch {% data variables.product.prodname_dotcom %}, Abhängigkeitsdiagramme und Sicherheitswarnungen in den Repository-Einstellungen aktiviert | „[Datennutzung für ein privates Repository zulassen](/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-data-use-for-your-private-repository#opting-into-data-use-for-your-private-repository)" | -| Das Repository enthält eine Abhängigkeits-Manifestdatei aus einem Paket-Ökosystem, das {% data variables.product.prodname_dotcom %} unterstützt | „[Unterstützte Paket-Ökosysteme](/github/visualizing-repository-data-with-graphs/listing-the-packages-that-a-repository-depends-on#supported-package-ecosystems)" | -| Automatisierte Sicherheitsupdates sind für dieses Repository nicht deaktiviert | „[Automatisierte Sicherheitsupdates für Dein Repository verwalten](#managing-automated-security-updates-for-your-repository)" | -| Das Repository benutzt noch keine Integration für die Abhängigkeits-Verwaltung | „[Informationen zu Integrationen](/github/customizing-your-github-workflow/about-integrations)“ | - -Wenn automatisierte Sicherheitsupdates für Dein Repository nicht aktiviert sind und Du weißt nicht warum, kannst Du [den Support kontaktieren](https://support.github.com/contact). - -### Informationen zu Kompatibilitätsbewertungen - -Automatisierte Sicherheitsupdates enthalten auch Kompatibilitätsbewertungen, damit Du weißt, ob die Behebung einer Schwachstelle erhebliche Änderungen für Dein Projekt mit sich bringen könnte. Wir überprüfen zuvor bestandene CI-Tests von öffentlichen Repositorys, bei denen wir ein bestimmtes automatisiertes Sicherheitsupdate generiert haben, um zu ermitteln, ob das Update zu fehlgeschlagenen Tests führt. Die Kompatibilitätsbewertung eines Update ist der Prozentsatz an CI-Ausführungen, die beim Aktualisieren zwischen relevanten Versionen der Abhängigkeit bestanden wurden. - -### Automatisierte Sicherheitsupdates für Dein Repository verwalten - -Du kannst automatisierte Sicherheitsupdates für ein einzelnes Repository aktivieren oder deaktivieren. - -Automatisierte Sicherheitsupdates erfordern bestimmte Repository-Einstellungen. Weitere Informationen findest Du unter „[Unterstützte Repositorys](#supported-repositories)." - -{% data reusables.repositories.you-can-enable-or-disable-security-features %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-security %} -4. Benutze das Dropdownmenü über der Liste der Warnungen und aktiviere oder deaktiviere die Option **Automated security fixes** (Automatisierte Sicherheitsupdates). ![Dropdownmenü mit der Option, automatisierte Sicherheitsupdates zu aktivieren](/assets/images/help/repository/enable-automated-security-updates-drop-down.png) - -### Automatisierte Sicherheitsupdates für Dein Benutzerkonto verwalten - -Du kannst automatisierte Sicherheitsupdates für all Repository deaktivieren, die Deinem Benutzerkonto gehören. Wenn Du das tust, kannst Du automatisierte Sicherheitsupdates trotzdem noch für individuelle Repositorys im Besitz Deines Benutzerkontos aktivieren. - -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.security %} -{% data reusables.repositories.opt-out-automated-security-updates %} - -### Automatisierte Sicherheitsupdates für Deine Organisation verwalten - -Organisationsinhaber können automatisierte Sicherheitsupdates für alle Repositorys im Besitz der Organisation deaktivieren. Wenn du das machst, können Personen mit Administratorberechtigungen auf ein einzelnes Repository im Besitz der Organisation trotzdem noch automatisierte Sicherheitsupdates für dieses Repository aktivieren. - -{% data reusables.repositories.you-can-enable-or-disable-security-features %} - -{% data reusables.profile.access_profile %} -{% data reusables.profile.access_org %} -{% data reusables.organizations.org_settings %} -{% data reusables.organizations.security %} -{% data reusables.repositories.opt-out-automated-security-updates %} - -### Weiterführende Informationen - -- „[Informationen zu Sicherheitswarnungen für angreifbare Abhängigkeiten](/articles/about-security-alerts-for-vulnerable-dependencies)“ -- „[Datennutzung für ein privates Repository zulassen](/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-data-use-for-your-private-repository#opting-into-data-use-for-your-private-repository)" -- „[Unterstützte Paket-Ökosysteme](/github/visualizing-repository-data-with-graphs/listing-the-packages-that-a-repository-depends-on#supported-package-ecosystems)" diff --git a/translations/de-DE/content/github/managing-security-vulnerabilities/managing-alerts-for-vulnerable-dependencies-in-your-organization.md b/translations/de-DE/content/github/managing-security-vulnerabilities/managing-alerts-for-vulnerable-dependencies-in-your-organization.md deleted file mode 100644 index 0b10eaba255c..000000000000 --- a/translations/de-DE/content/github/managing-security-vulnerabilities/managing-alerts-for-vulnerable-dependencies-in-your-organization.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: Warnungen für angreifbare Abhängigkeiten in Deiner Organisation verwalten -intro: 'Organization owners and repository admins receive {% data variables.product.prodname_dependabot_alerts %} when we detect a vulnerable dependency in an organization''''s repository. You can specify additional organization members or teams with write access to also receive alerts for vulnerable dependencies.' -redirect_from: - - /articles/managing-alerts-for-vulnerable-dependencies-in-your-organization-s-repositories/ - - /articles/managing-alerts-for-vulnerable-dependencies-in-your-organizations-repositories/ - - /articles/managing-alerts-for-vulnerable-dependencies-in-your-organization -versions: - free-pro-team: '*' ---- - -{% if currentVersion == "free-pro-team@latest" %} -{% data reusables.repositories.you-can-manage-access-to-security-alerts %} -{% endif %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -3. In the left sidebar, click **Dependabot alerts**. ![Dependabot alerts tab in the settings sidebar](/assets/images/help/settings/settings-sidebar-dependabot-alerts.png) -4. Type the name of the person or team you'd like to receive {% data variables.product.prodname_dependabot_alerts %} when {% data variables.product.product_name %} detects a vulnerable dependency, then click their username or team name to select it. -5. After you've selected all of the people or teams you'd like to receive {% data variables.product.prodname_dependabot_alerts %}, click **Save changes**. - -### Weiterführende Informationen - -- "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)" -- „[Angreifbare Abhängigkeiten in Deinem Repository anzeigen und aktualisieren](/articles/viewing-and-updating-vulnerable-dependencies-in-your-repository)“ -- "[Managing security and analysis settings for your organization](/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization)" diff --git a/translations/de-DE/content/github/searching-for-information-on-github/searching-code-for-exact-matches.md b/translations/de-DE/content/github/searching-for-information-on-github/searching-code-for-exact-matches.md deleted file mode 100644 index 3fec7ef93a08..000000000000 --- a/translations/de-DE/content/github/searching-for-information-on-github/searching-code-for-exact-matches.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: Code nach exakten Übereinstimmungen durchsuchen -intro: 'Du kannst Code für exakte Übereinstimmungen in Repositorys auf {% data variables.product.prodname_dotcom %} durchsuchen.' -redirect_from: - - /github/searching-for-information-on-github/searching-files-in-a-repository-for-exact-matches -permissions: Personen mit Leseberechtigung auf ein Repository können die Repository-Dateien auf exakte Übereinstimmungen durchsuchen. -versions: - free-pro-team: '*' ---- - -{% note %} - -{% data reusables.search.exact-match-beta %} Um Zugriff auf die Beta-Version zu erhalten, [tritt der Warteliste bei](https://github.com/features/code-search-exact-match/signup). - -{% endnote %} - -### Über die Codesuche nach exakten Übereinstimmungen - -{% data reusables.search.exact-match %} - -Standardmäßig wird bei Suche nach exakten Übereinstimmungen sowohl Gross- und Kleinschreibung wie auch Symbol-Sensitivität beachtet, und die Resultate werden keine teilweisen Übereinstimmungen oder normalisierte Grammatik enthalten. Beispielsweise wird die Suche nach `let ReactDOM*` nur genau `let ReactDOM*` zurückgeben. - -### Code nach exakten Übereinstimmungen durchsuchen - -{% note %} - -Die Suche nach exakten Übereinstimmungen in Dateien in einem Repository funktioniert nur mit indizierten Repositorys für den Beta-Release. - -{% endnote %} - -{% data reusables.repositories.navigate-to-repo %} -2. Gib im Suchfeld die Zeichenkette ein, die Du finden möchtest. ![Suchzeichenfolge für exakte Übereinstimmung](/assets/images/help/search/exact-match-search-string.png) -3. Klicke optional auf das Dropdownmenü **Options** (Optionen), um Deine Suche einzugrenzen. ![Dropdownmenü für Suche nach exakter Übereinstimmung](/assets/images/help/search/exact-match-options.png) -4. Drücke Enter (Eingabetaste) oder Return (Return-Taste) auf Deiner Tastatur. -5. Klicke in der Ergebnisliste auf die Datei. - -### Weiterführende Informationen - -- „[Code durchsuchen](/github/searching-for-information-on-github/searching-code)“ -- „[In Code navigieren auf {% data variables.product.product_name %}](/github/managing-files-in-a-repository/navigating-code-on-github)" diff --git a/translations/de-DE/content/github/site-policy/github-enterprise-cloud-addendum.md b/translations/de-DE/content/github/site-policy/github-enterprise-cloud-addendum.md deleted file mode 100644 index 27797be50fb1..000000000000 --- a/translations/de-DE/content/github/site-policy/github-enterprise-cloud-addendum.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: GitHub Enterprise Cloud-Nachtrag -redirect_from: - - /github-business-cloud-addendum/ - - /articles/github-enterprise-cloud-addendum -versions: - free-pro-team: '*' ---- - -Dies sind die zusätzlichen Bedingungen für GitHub Enterprise Cloud ("Enterprise Cloud-Bedingungen"). Alle in diesen Enterprise Cloud-Begriffen nicht definierten Begriffe werden in den [Nutzungsbedingungen](/articles/github-terms-of-service/) oder den [Unternehmensnutzungsbedingungen Service](/articles/github-corporate-terms-of-service/) definiert. Indem Sie diesen Enterprise Cloud-Bedingungen zustimmen, stimmen Sie auch den Nutzungsbedingungen zu, die durch die Art Ihres Kontos bestimmt werden. - -Enterprise Cloud umfasst ein Organisationskonto, SAML Single Sign-On, Zugriffsbereitstellung und einen 24/5-Support mit einer Antwortzeit von 8 Stunden. Diese Liste an Features und Diensten ist nicht erschöpfend und kann regelmäßig aktualisiert werden. Weitere Informationen finden Sie in der [GitHub Preisübersicht](https://github.com/pricing). - -### Definitionen: -- aktiver Benutzer: ein Benutzer, der versucht, während eines Ausfalls auf unseren Dienst zuzugreifen. -- Kunde: eine Person oder Entität, die Enterprise Cloud von GitHub erworben hat. -- Berechtigter Benutzer: bezeichnet eine Person, die als Mitglied der Enterprise Cloud-Organisation des Kunden festgelegt wird, indem ihr individuelles GitHub-Konto mit dem Enterprise Cloud-Konto des Kunden verknüpft wird -- grundlegende Dienste: die Dienste, die für die Steuerungsfunktionen der GitHub-Basisversion notwendig sind, unter anderem Funktionen und Dienste für die Erstellung, das Forking und das Klonen von Repositorys, die Erstellung, den Commit und das Mergen von Branches, die Erstellung, die Prüfung und das Mergen von Pull Requests und Web-, API- und Git-Client-Schnittstellen zu den Basis-Git-Workflows. Beispiele für nicht enthaltene Peripherie-Features und -Dienste sind Webhooks, Gists, Pages oder E-Mail-Benachrichtigungen. -- Ausfall: die Unterbrechung eines grundlegenden Dienstes, die mehr als 50 % der aktiven Benutzer betrifft. -- Dienstgutschrift: eine Gutschrift in Dollar, die wie unten beschrieben berechnet wird und die wir anspruchsberechtigten Konten gutschreiben können. - -### Enterprise Cloud Verfügbarkeits-SLA - -Programmvorteile: -- Wir garantieren eine Verfügbarkeit des Dienstes von 99,95 % pro Quartal. Das bedeutet, dass die grundlegenden Dienste von GitHub nicht für mehr als 0,05 % eines Quartals durch Ausfälle unterbrochen werden, die mehr als 50 % der aktiven Benutzer betreffen. -- Erfüllen wir die Verfügbarkeitsgarantie von 99,95 % pro Quartal nicht, können wir Kunden Dienstgutschriften ausstellen. - -Wie berechnen wir Verfügbarkeit? -- Unsere Verfügbarkeitsberechnung basiert auf dem Prozentanteil erfolgreicher Anforderungen, die über unsere Web-, API- und Git-Client-Schnittstellen verarbeitet werden. - -Was ist von unserer Verfügbarkeits-Garantie ausgeschlossen? Ausfälle infolge von: -- Handlungen, Unterlassungen oder Missbrauch der Dienste durch den Kunden, einschließlich Verstößen gegen die Nutzungsbedingungen. -- Fehler bei Ihrer Internetverbindung -- Faktoren, die jenseits unserer zumutbaren Kontrolle liegen, einschließlich Probleme im Zusammenhang mit dem Internetzugang, Situationen höherer Gewalt und Dienstleistungen oder Technologien Dritter. -- Ihre Ausrüstung, Dienstleistungen oder andere Technologie - -Was sind Dienstverfügbarkeitsgutschriften, wie kann ich herausfinden, ob ich welche besitze, und wie kann ich sie einlösen? -- Liegt die Verfügbarkeit von GitHub in einem Quartal unter der Verfügbarkeitsgarantie von 99,95 %, hat der Kunde Anspruch auf eine Dienstgutschrift in Höhe des 25-Fachen des Betrags, der für die die Verfügbarkeitsgarantie für ein Quartal überschreitende Ausfalldauer gezahlt wurde (Dienstverfügbarkeitsgutschrit), die bei der nächsten Rechnung des Kunden berücksichtigt wird. Dienstverfügbarkeitsgutschriften werden am Ende jedes Quartals berechnet und werden nur auf Anforderung gewährt. -- Um die Verfügbarkeit von GitHub in Prozent zu ermitteln, können Sie am Ende jedes Quartals einen Verfügbarkeitsbericht anfordern. -- Zur Gewährung von Dienstverfügbarkeitsgutschriften muss ein Kontoinhaber oder Abrechnungsmanager innerhalb von 30 Tagen ab Ende jedes Quartals eine schriftliche Anforderung im Namen des Kunden senden. Dienstverfügbarkeitsgutschriften können nicht kumuliert werden. Gewährte Dienstverfügbarkeitsgutschriften werden automatisch auf die nächste Abrechnung des Kunden angewendet. Schriftliche Anfragen sollten an {% data variables.contact.contact_support %} gesendet werden. - -**Haftungsausschluss und Haftungsbeschränkungen:** Die GitHub-[Statusseite](https://status.github.com/) steht nicht mit der Verfügbarkeitsgarantie-SLA in Verbindung und ist keine genaue Angabe der Verfügbarkeit von GitHub zur Berechnung von Dienstverfügbarkeitsgutschriften. Dienstgutschriften sind auf 30 Tage bezahlten Dienst pro Quartal beschränkt. Dienstgutschriften stellen die einzige Möglichkeit des Kunden zur Abhilfe bei Versäumnissen von GitHub bei der Erfüllung von Verfügbarkeitspflichten nach diesem Nachtrag dar. diff --git a/translations/de-DE/content/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-data-use-for-your-private-repository.md b/translations/de-DE/content/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-data-use-for-your-private-repository.md deleted file mode 100644 index 8f3b9e50ae8b..000000000000 --- a/translations/de-DE/content/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-data-use-for-your-private-repository.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: Datennutzung für Ihr privates Repository zulassen oder ablehnen -intro: 'Damit {% data variables.product.product_name %} Sie besser mit relevanten Tools, Personen, Projekten und Informationen verbinden kann, können Sie die Datennutzung für Ihr privates Repository zulassen. Wenn Sie die Datennutzung für Ihr privates Repository zugelassen haben und nicht mehr möchten, dass {% data variables.product.product_name %} Ihre Daten verwendet, können Sie die Datennutzung wieder ablehnen.' -redirect_from: - - /articles/opting-into-or-out-of-data-use-for-your-private-repository -versions: - free-pro-team: '*' ---- - -### About data use for your private repository - -Wenn Sie die Datennutzung für Ihr privates Repository zulassen, können Sie auf das Abhängigkeitsdiagramm zugreifen. Damit können Sie die Abhängigkeiten Ihres Repositorys verfolgen und Sicherheitsmeldungen erhalten, wenn {% data variables.product.product_name %} angreifbare Abhängigkeiten erkennt. Weitere Informationen finden Sie unter „[Informationen zu Sicherheitsmeldungen für angreifbare Abhängigkeiten](/articles/about-security-alerts-for-vulnerable-dependencies)“. - -{% data reusables.repositories.you-can-enable-or-disable-security-features %} - -### Datennutzung für Ihr privates Repository zulassen - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -3. Wählen Sie unter „Data services“ (Datendienste) **Allow {% data variables.product.prodname_dotcom %} to perform read-only analysis of this repository** ({% data variables.product.prodname_dotcom %} die Durchführung schreibgeschützter Analysen dieses Repositorys erlauben) aus. ![Kontrollkästchen, um {% data variables.product.prodname_dotcom %} die Durchführung schreibgeschützter Analysen dieses Repositorys zu erlauben](/assets/images/help/repository/private-repo-data-use-opt-in.png) -4. Optional können Sie auch das Kontrollkästchen neben den zusätzlichen Diensten aktivieren, für die Sie die Datennutzung zulassen möchten. ![Liste der zusätzlichen Dienste mit eigenen Kontrollkästchen](/assets/images/help/repository/private-repo-data-use-additional-services.png) - -### Datennutzung für Ihr privates Repository ablehnen - -{% tip %} - -**Tipp:** Um die Datennutzung für bestimmte Dienste abzulehnen, heben Sie die Auswahl des Kontrollkästchens neben dem Dienst auf. - -{% endtip %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -3. Heben Sie unter „Data services“ (Datendienste) die Auswahl von **Allow {% data variables.product.prodname_dotcom %} to perform read-only analysis of this repository** ({% data variables.product.prodname_dotcom %} die Durchführung schreibgeschützter Analysen dieses Repositorys erlauben) auf. ![Kontrollkästchen, um {% data variables.product.prodname_dotcom %} die Durchführung schreibgeschützter Analysen dieses Repositorys zu verbieten](/assets/images/help/repository/private-repo-data-use-opt-out.png) - -### Weiterführende Informationen - -- „[Informationen zur Verwendung Ihrer Daten durch {% data variables.product.prodname_dotcom %}](/articles/about-github-s-use-of-your-data)“ -- „[Angreifbare Abhängigkeiten in Ihrem Repository anzeigen und aktualisieren](/articles/viewing-and-updating-vulnerable-dependencies-in-your-repository)“ -- „[Meldungen für angreifbare Abhängigkeiten in den Repositorys Ihrer Organisation verwalten](/articles/managing-alerts-for-vulnerable-dependencies-in-your-organization-s-repositories)“ diff --git a/translations/de-DE/content/github/using-git/changing-author-info.md b/translations/de-DE/content/github/using-git/changing-author-info.md deleted file mode 100644 index f5be96c95103..000000000000 --- a/translations/de-DE/content/github/using-git/changing-author-info.md +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Autoreninformationen ändern -redirect_from: - - /change-author-info/ - - /changing-author-info/ - - /articles/changing-author-info -intro: 'Um den Namen und/oder die E-Mail-Adresse zu ändern, der/die in vorhandenen Commits angegeben ist, musst Du den gesamten Verlauf Deines Git-Repositorys neu schreiben.' -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -{% warning %} - -**Warnung:** Diese Aktion nimmt irreversible Änderungen am Verlauf Deines Repositorys vor. Wenn Du mit anderen zusammen an einem Repository arbeitest, gilt es als unerwünscht, einen veröffentlichten Verlauf umzuschreiben. Du solltest dies nur im Notfall tun. - -{% endwarning %} - -### Den Git-Verlauf eines Repositorys mit einem Skript ändern - -Wir haben ein Skript erstellt, das in allen Commits die alte E-Mail-Adresse in den Autoren- oder Beitragender-Feldern durch den korrekten Namen und die richtige E-Mail-Adresse ersetzt. - -{% tip %} - -**Hinweis:** Durch die Ausführung dieses Skripts wird der Verlauf für alle Repository-Mitarbeiter neu geschrieben. Wenn diese Schritte ausgeführt wurden, müssen alle Personen mit Forks oder Klonen den geänderten Verlauf abrufen und alle lokalen Änderungen in den neuen Verlauf übergeben. - -{% endtip %} - -Für die Ausführung dieses Skripts benötigst Du Folgendes: - -* Die alte E-Mail-Adresse, die in den Autoren-/Freigebenden-Feldern steht und die Du ändern möchtest -* Den richtigen Namen und die richtige E-Mail-Adresse, die mit diesen Commits verknüpft werden sollen - -{% data reusables.command_line.open_the_multi_os_terminal %} -2. Erstelle einen neuen, leeren Klon Deines Repositorys: - ```shell - git clone --bare https://{% data variables.command_line.codeblock %}/user/repo.git - cd repo.git - ``` -3. Kopiere das Skript in das Terminal. Ersetze dabei die folgenden Variablen entsprechend den vorliegenden Informationen: - * `OLD_EMAIL (Alte E-Mail-Adresse)` - * `CORRECT_NAME (richtiger Name)` - * `CORRECT_EMAIL (richtige E-Mail-Adresse)` - - ```shell - #!/bin/sh - - git filter-branch --env-filter ' - - OLD_EMAIL="your-old-email@example.com" - CORRECT_NAME="Your Correct Name" - CORRECT_EMAIL="your-correct-email@example.com" - - if [ "$GIT_COMMITTER_EMAIL" = "$OLD_EMAIL" ] - then - export GIT_COMMITTER_NAME="$CORRECT_NAME" - export GIT_COMMITTER_EMAIL="$CORRECT_EMAIL" - fi - if [ "$GIT_AUTHOR_EMAIL" = "$OLD_EMAIL" ] - then - export GIT_AUTHOR_NAME="$CORRECT_NAME" - export GIT_AUTHOR_EMAIL="$CORRECT_EMAIL" - fi - ' --tag-name-filter cat -- --branches --tags - ``` - -4. Drücke die **Eingabetaste**, um das Skript auszuführen. -5. Überprüfe den neuen Git-Verlauf auf Fehler. -6. Überführe den korrigierten Verlauf zu {% data variables.product.product_name %}: - ```shell - git push --force --tags origin 'refs/heads/*' - ``` -7. Entferne den temporären Klon: - ```shell - cd .. - rm -rf repo.git - ``` diff --git a/translations/de-DE/content/github/using-git/updating-credentials-from-the-osx-keychain.md b/translations/de-DE/content/github/using-git/updating-credentials-from-the-osx-keychain.md deleted file mode 100644 index 4513a55d89c2..000000000000 --- a/translations/de-DE/content/github/using-git/updating-credentials-from-the-osx-keychain.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: Anmeldeinformationen aus der OSX-Keychain aktualisieren -intro: 'You''ll need to update your saved credentials in the `git-credential-osxkeychain` helper if you change your username, password, or personal access token on {% data variables.product.product_name %}.' -redirect_from: - - /articles/updating-credentials-from-the-osx-keychain -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -{% data reusables.user_settings.password-authentication-deprecation %} - -### Anmeldeinformationen über Keychain Access aktualisieren - -1. Suche im Finder die App **Keychain Access**. ![ Suchleiste von Spotlight](/assets/images/help/setup/keychain-access.png) -2. Suche in Keychain Access nach **{% data variables.command_line.backticks %}**. -3. Suche den Eintrag „internet password“ (Internet-Passwort) für `{% data variables.command_line.backticks %}`. ![Eintrag des GitHub-Passworts in Keychain](/assets/images/help/setup/keychain-entry.png) -4. Bearbeite oder lösche den Eintrag je nach Bedarf. - -### Anmeldeinformationen über die Befehlszeile löschen - -In der Befehlszeile kannst Du den Keychain-Eintrag direkt über den Credential-Helfer löschen. - -Gib hierzu den folgenden Befehl ein: - -```shell -$ git credential-osxkeychain erase -host={% data variables.command_line.codeblock %} -protocol=https -> [Press Return] -``` - -Bei erfolgreicher Ausführung des Befehls erhältst Du keine Rückmeldung. Wenn Du testen möchtest, ob der Befehl funktioniert hat, klone ein Repository aus {% data variables.product.product_location %}. Wenn Du nach einem Passwort gefragt wirst, wurde der Keychain-Eintrag gelöscht. - -### Weiterführende Informationen - -- "[Caching your {% data variables.product.prodname_dotcom %} credentials in Git](/github/using-git/caching-your-github-credentials-in-git/)" diff --git a/translations/de-DE/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository.md b/translations/de-DE/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository.md deleted file mode 100644 index b180a6c708c8..000000000000 --- a/translations/de-DE/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository.md +++ /dev/null @@ -1,65 +0,0 @@ ---- -title: Exploring the dependencies and dependents of a repository -intro: 'Using the dependency graph, you can see the packages your project depends on and the repositories that depend on it. In addition, you can see any vulnerabilities detected in its dependencies.' -redirect_from: - - /articles/listing-the-packages-that-a-repository-depends-on - - /github/visualizing-repository-data-with-graphs/listing-the-packages-that-a-repository-depends-on - - /articles/listing-the-projects-that-depend-on-a-repository - - /github/visualizing-repository-data-with-graphs/listing-the-projects-that-depend-on-a-repository -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -### Viewing the dependency graph - -{% data reusables.repositories.enable-security-alerts %} - -The dependency graph has tabs that show the dependencies and dependents of your repository. For information about how these views are populated and which ecosystems are supported, see "[About the dependency graph](about-the-dependency-graph)." - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.accessing-repository-graphs %} -{% data reusables.repositories.click-dependency-graph %} -4. Optionally, under "Dependency graph", click **Dependents**. ![Registerkarte „Dependents“ (Abhängige) auf der Seite „Dependency graph“ (Abhängigkeitsdiagramm)](/assets/images/help/graphs/dependency-graph-dependents-tab.png) - -#### Dependencies view - -Dependencies are grouped by ecosystem. You can expand a dependency to view its dependencies. For dependencies hosted on {% data variables.product.product_name %}, you can also click a dependency to view the repository. If vulnerabilities have been detected in the repository, these are shown at the top of the view for users with access to {% if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %}. - -![Abhängigkeitsdiagramm](/assets/images/help/graphs/dependencies_graph.png) - -#### Dependents view - -For public repositories, the dependents view shows how the repository is used by other repositories. To show only the repositories that contain a library in a package manager, click **NUMBER Packages** immediately above the list of dependent repositories. The dependent counts are approximate and may not always match the dependents listed. - -![Abhängigkeitsdiagramm](/assets/images/help/graphs/dependents_graph.png) - -{% if currentVersion == "free-pro-team@latest" %} -### Enabling and disabling the dependency graph for a private repository - -Repository administrators can enable or disable the dependency graph for private repositories. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -{% data reusables.repositories.navigate-to-security-and-analysis %} -4. Read the message about granting {% data variables.product.product_name %} read-only access to the repository data to enable the dependency graph, then next to "Dependency Graph", click **Enable**. !["Enable" button for the dependency graph](/assets/images/help/repository/dependency-graph-enable-button.png) - -You can disable the dependency graph at any time by clicking **Disable** next to "Dependency Graph" on the Security & analysis tab. -{% endif %} - -### Fehler beim Abhängigkeitsdiagramm beheben - -If your dependency graph is empty, there may be a problem with the file containing your dependencies. Check the file to ensure that it's correctly formatted for the file type. - -{% if currentVersion == "free-pro-team@latest" %} -If the file is correctly formatted, then check its size. The dependency graph ignores individual manifest and lock files that are over 0.5 Mb, unless you are a {% data variables.product.prodname_enterprise %} user. It processes up to 20 manifest or lock files per repository by default, so you can split dependencies into smaller files in subdirectories of the repository.{% endif %} - -If a manifest or lock file is not processed, its dependencies are omitted from the dependency graph and they can't be checked for vulnerable dependencies. - -### Weiterführende Literatur - -- "[About the dependency graph](about-the-dependency-graph)"{% if currentVersion == "free-pro-team@latest" %} -- „[Einblicke für Ihre Organisation anzeigen ](/github/setting-up-and-managing-organizations-and-teams/viewing-insights-for-your-organization)“ -- „[Angreifbare Abhängigkeiten in Ihrem Repository anzeigen und aktualisieren](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository)“ -- „[Grundlegendes zur Verwendung und zum Schutz Ihrer Daten durch {% data variables.product.product_name %}](/github/understanding-how-github-uses-and-protects-your-data)“ -{% endif %} diff --git a/translations/de-DE/content/github/visualizing-repository-data-with-graphs/listing-the-packages-that-a-repository-depends-on.md b/translations/de-DE/content/github/visualizing-repository-data-with-graphs/listing-the-packages-that-a-repository-depends-on.md deleted file mode 100644 index b1df21cbacd7..000000000000 --- a/translations/de-DE/content/github/visualizing-repository-data-with-graphs/listing-the-packages-that-a-repository-depends-on.md +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: 'Pakete auflisten, von denen ein Repository abhängig ist' -intro: Im Abhängigkeitsdiagramm kannst Du die Abhängigkeiten Deines Projekts sowie alle erkannten Schwachstellen sehen. -redirect_from: - - /articles/listing-the-packages-that-a-repository-depends-on -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -### Informationen zum Abhängigkeitsdiagramm - -Das Abhängigkeitsdiagramm ist für jedes{% if currentVersion == "free-pro-team@latest" %} öffentliche{% endif %} Repository verfügbar, das Abhängigkeiten in einem unterstützten Paket-Ökosystem mit einem unterstützten Dateiformat definiert.{% if currentVersion == "free-pro-team@latest" %} Repository-Administratoren können das Abhängigkeitsdiagramm auch für private Repositorys einrichten.{% endif %} - -{% data reusables.repositories.enable-security-alerts %} - -Du kannst angreifbare Abhängigkeiten im Abhängigkeitsdiagramm Deines Repositorys anzeigen und aktualisieren. Das Abhängigkeitsdiagramm listet angreifbare Abhängigkeiten vor allen anderen Abhängigkeiten auf. Weitere Informationen findest Du unter „[Informationen zu Sicherheitswarnungen für angreifbare Abhängigkeiten](/articles/about-security-alerts-for-vulnerable-dependencies).“ - -{% if currentVersion == "free-pro-team@latest" %} -Du kannst Abhängigkeiten, die in Organisations-Repositorys verwendet werden, in einem zentralen Dashboard anzeigen. Weitere Informationen findest Du unter „[Einblicke für Deine Organisation anzeigen ](/articles/viewing-insights-for-your-organization#viewing-organization-dependency-insights)“.{% endif %} - -### Unterstützte Paket-Ökosysteme - -| Paketmanager | Sprachen | Empfohlene Formate | Unterstützte Formate | -| ------------ | ------------------------------- | ------------------------------------------------------ | ------------------------------------------------------------------------- | -| Maven | Java, Scala | `pom.xml` | `pom.xml` | -| npm | JavaScript | `package-lock.json` | `package-lock.json`, `package.json` | -| Yarn | JavaScript | `yarn.lock` | `package.json`, `yarn.lock` | -| `dotnet` CLI | .NET-Sprachen (C#, C++, F#, VB) | `.csproj`, `.vbproj`, `.nuspec`, `.vcxproj`, `.fsproj` | `.csproj`, `.vbproj`, `.nuspec`, `.vcxproj`, `.fsproj`, `packages.config` | -| Python PIP | Python | `requirements.txt`, `pipfile.lock` | `requirements.txt`, `pipfile.lock`, `setup.py`* | -| RubyGems | Ruby | `Gemfile.lock` | `Gemfile.lock`,`Gemfile`, `*.gemspec` | -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}| Composer | PHP | `composer.lock` | `composer.json`, `composer.lock` |{% endif %} - -{% note %} - -**Hinweis:** Wenn Du Deine Python-Abhängigkeiten in einer `setup.py`-Datei auflistest, können wir möglicherweise nicht jede Abhängigkeit in Deinem Projekt analysieren, auflisten und melden. - -{% endnote %} - -### Abhängigkeiten für ein Repository mit aktiviertem Abhängigkeitsdiagramm auflisten - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.accessing-repository-graphs %} -{% data reusables.repositories.click-dependency-graph %} - -{% if currentVersion == "free-pro-team@latest" %} -### Abhängigkeitsdiagramm für ein privates Repository aktivieren - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.accessing-repository-graphs %} -{% data reusables.repositories.click-dependency-graph %} -4. Lies die Mitteilung zum Gewähren des {% data variables.product.product_name %}-Zugriffs auf Repository-Daten zum Aktivieren des Abhängigkeitsdiagramms durch, und klicke dann auf **Allow access** (Zugriff erlauben). ![Schaltfläche, um den Zugriff auf Repository-Daten für die Aktivierung des Abhängigkeitsdiagramms zuzulassen](/assets/images/help/repository/dependency-graph-allow-access-button.png) - -Weitere Informationen findest Du unter „[Grundlegendes zur Verwendung und zum Schutz Deiner Daten durch {% data variables.product.product_name %}](/categories/understanding-how-github-uses-and-protects-your-data).“ - -### Abhängigkeitsdiagramm für ein privates Repository deaktivieren - -{% data reusables.repositories.you-can-enable-or-disable-security-features %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -3. Hebe unter „Data services“ (Datendienste) die Auswahl von **Dependency graph** (Abhängigkeitsdiagramm) auf. ![Kontrollkästchen zum Deaktivieren des Abhängigkeitsdiagramms](/assets/images/help/repository/private-repo-data-use-dependency-graph-disabled.png) - -Informationen zum Ablehnen der Datennutzung für Dein Repository findest Du unter „[Datennutzung für Dein privates Repository zulassen oder ablehnen](/articles/opting-into-or-out-of-data-use-for-your-private-repository).“ -{% endif %} - -### Fehler beim Abhängigkeitsdiagramm beheben - -{% data reusables.repositories.troubleshooting-dependency-graph %} - -### Weiterführende Informationen - -- „[Die von einem Repository abhängigen Projekte auflisten](/articles/listing-the-projects-that-depend-on-a-repository)“{% if currentVersion == "free-pro-team@latest" %} -- „[Grundlegendes zur Verwendung und zum Schutz Deiner Daten durch {% data variables.product.product_name %}](/categories/understanding-how-github-uses-and-protects-your-data)“ -- „[Angreifbare Abhängigkeiten in Deinem Repository anzeigen und aktualisieren](/articles/viewing-and-updating-vulnerable-dependencies-in-your-repository)“{% endif %} diff --git a/translations/de-DE/content/github/visualizing-repository-data-with-graphs/listing-the-projects-that-depend-on-a-repository.md b/translations/de-DE/content/github/visualizing-repository-data-with-graphs/listing-the-projects-that-depend-on-a-repository.md deleted file mode 100644 index 077ac1439166..000000000000 --- a/translations/de-DE/content/github/visualizing-repository-data-with-graphs/listing-the-projects-that-depend-on-a-repository.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: Die von einem Repository abhängigen Projekte auflisten -intro: 'Du kannst die Pakete und Projekte, die von einem Repository abhängen, in einem Abhängigkeitsdiagramm anzeigen.' -redirect_from: - - /articles/listing-the-projects-that-depend-on-a-repository -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -### Informationen zum Abhängigkeitsdiagramm -Das Abhängigkeitsdiagramm enthält Daten zu Paketen und Anwendungen. Pakete sind Repositorys, die eine Bibliothek in einem Paketmanager enthalten, wohingegen Anwendungen Repositorys sind, die vom ausgewählten Repository abhängen. Die Liste der Anwendungen in einem Abhängigkeitsdiagramm ist nach den neuesten Projekten geordnet, die vom Repository abhängen. - -Das Abhängigkeitsdiagramm enthält Daten für die folgenden Sprachen: - -- RubyGems -- NPM -- PyPI -- Maven (nur pom.xml) -- Nuget - -{% data reusables.repositories.enable-security-alerts %} - -{% note %} - -**Hinweis:** Die Abhängigenzahlen sind ungefähre Angaben und stimmen möglicherweise nicht mit den aufgelisteten Abhängigen überein. - -{% endnote %} - -![Abhängige-Diagramm](/assets/images/help/graphs/dependents_graph.png) - -### Auf das Abhängige-Diagramm zugreifen - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.accessing-repository-graphs %} -{% data reusables.repositories.click-dependency-graph %} -4. Klicke unter „Dependency graph“ (Abhängigkeitsdiagramm) auf **Dependents** (Abhängige). ![Registerkarte „Dependents“ (Abhängige) auf der Seite „Dependency graph“ (Abhängigkeitsdiagramm)](/assets/images/help/graphs/dependency-graph-dependents-tab.png) - -### Weiterführende Informationen - -- „[Pakete auflisten, von denen ein Repository abhängig ist](/articles/listing-the-packages-that-a-repository-depends-on)“{% if currentVersion == "free-pro-team@latest" %} -- „[Einblicke für Deine Organisation anzeigen ](/articles/viewing-insights-for-your-organization)“{% endif %} diff --git a/translations/de-DE/content/rest/reference/endpoints-available-for-github-apps.md b/translations/de-DE/content/rest/reference/endpoints-available-for-github-apps.md deleted file mode 100644 index 7444c977520a..000000000000 --- a/translations/de-DE/content/rest/reference/endpoints-available-for-github-apps.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: Endpoints available for GitHub Apps -intro: Your app can make requests to the following REST endpoints. -redirect_from: - - /v3/apps/available-endpoints -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -You must use an installation access token to access endpoints using your {% data variables.product.prodname_github_app %}. For more information, see "[Authenticating with {% data variables.product.prodname_github_apps %}](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)." - -{% include rest_enabled_for_github_apps_in_current_version %} diff --git a/translations/de-DE/data/reusables/actions/actions-app-read-permissions-sh-org.md b/translations/de-DE/data/reusables/actions/actions-app-read-permissions-sh-org.md deleted file mode 100644 index 89cc846f3e23..000000000000 --- a/translations/de-DE/data/reusables/actions/actions-app-read-permissions-sh-org.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_github_app %}s must have the `self-hosted runners:read` organization permission to use this endpoint. \ No newline at end of file diff --git a/translations/de-DE/data/reusables/actions/actions-app-secrets-org-permissions.md b/translations/de-DE/data/reusables/actions/actions-app-secrets-org-permissions.md deleted file mode 100644 index 4f41e05ae20e..000000000000 --- a/translations/de-DE/data/reusables/actions/actions-app-secrets-org-permissions.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_github_app %}s must have the `secrets` organization permission to use this endpoint. \ No newline at end of file diff --git a/translations/de-DE/data/reusables/actions/actions-app-secrets-permissions.md b/translations/de-DE/data/reusables/actions/actions-app-secrets-permissions.md deleted file mode 100644 index 7709eb5b2e53..000000000000 --- a/translations/de-DE/data/reusables/actions/actions-app-secrets-permissions.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_github_app %}s must have the `secrets` repository permission to use this endpoint. \ No newline at end of file diff --git a/translations/de-DE/data/reusables/actions/actions-app-write-permissions-sh-org.md b/translations/de-DE/data/reusables/actions/actions-app-write-permissions-sh-org.md deleted file mode 100644 index f330c2358998..000000000000 --- a/translations/de-DE/data/reusables/actions/actions-app-write-permissions-sh-org.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_github_app %}s must have the `self-hosted runners:write` organization permission to use this endpoint. \ No newline at end of file diff --git a/translations/de-DE/data/reusables/actions/actions-downloads.md b/translations/de-DE/data/reusables/actions/actions-downloads.md deleted file mode 100644 index 0761c8d58dd7..000000000000 --- a/translations/de-DE/data/reusables/actions/actions-downloads.md +++ /dev/null @@ -1 +0,0 @@ -Call this endpoint using the `-v` flag, which enables verbose output and allows you to see the download URL in the header. To download the file into the current working directory, specify the filename using the `-o` flag. \ No newline at end of file diff --git a/translations/de-DE/data/reusables/actions/actions-secret-encyption-examples.md b/translations/de-DE/data/reusables/actions/actions-secret-encyption-examples.md deleted file mode 100644 index 8dfe80aeb64f..000000000000 --- a/translations/de-DE/data/reusables/actions/actions-secret-encyption-examples.md +++ /dev/null @@ -1,75 +0,0 @@ -#### Example encrypting a secret using Node.js - -Encrypt your secret using the [tweetsodium](https://github.com/github/tweetsodium) library. - -```js -const sodium = require('tweetsodium'); - -const key = "base64-encoded-public-key"; -const value = "plain-text-secret"; - -// Convert the message and key to Uint8Array's (Buffer implements that interface) -const messageBytes = Buffer.from(value); -const keyBytes = Buffer.from(key, 'base64'); - -// Encrypt using LibSodium. -const encryptedBytes = sodium.seal(messageBytes, keyBytes); - -// Base64 the encrypted secret -const encrypted = Buffer.from(encryptedBytes).toString('base64'); - -console.log(encrypted); -``` - -#### Example encrypting a secret using Python - -Encrypt your secret using [pynacl](https://pynacl.readthedocs.io/en/stable/public/#nacl-public-sealedbox) with Python 3. - -```py -from base64 import b64encode -from nacl import encoding, public - -def encrypt(public_key: str, secret_value: str) -> str: - """Encrypt a Unicode string using the public key.""" - const sodium = require('tweetsodium'); - -const key = "base64-encoded-public-key"; -const value = "plain-text-secret"; - -// Convert the message and key to Uint8Array's (Buffer implements that interface) -const messageBytes = Buffer.from(value); -const keyBytes = Buffer.from(key, 'base64'); - -// Encrypt using LibSodium. -``` - -#### Example encrypting a secret using C\# - -Encrypt your secret using the [Sodium.Core](https://www.nuget.org/packages/Sodium.Core/) package. - -```csharp -var secretValue = System.Text.Encoding.UTF8.GetBytes("mySecret"); -var publicKey = Convert.FromBase64String("2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvvcCU="); - -var sealedPublicKeyBox = Sodium.SealedPublicKeyBox.Create(secretValue, publicKey); - -Console.WriteLine(Convert.ToBase64String(sealedPublicKeyBox)); -``` - -#### Example encrypting a secret using Ruby - -Encrypt your secret using the [rbnacl](https://github.com/RubyCrypto/rbnacl) gem. - -```ruby -require "rbnacl" -require "base64" - -key = Base64.decode64("+ZYvJDZMHUfBkJdyq5Zm9SKqeuBQ4sj+6sfjlH4CgG0=") -public_key = RbNaCl::PublicKey.new(key) - -box = RbNaCl::Boxes::Sealed.from_public_key(public_key) -encrypted_secret = box.encrypt("my_secret") - -# Print the base64 encoded secret -puts Base64.strict_encode64(encrypted_secret) -``` diff --git a/translations/de-DE/data/reusables/actions/gh-app-actions-read-permissions.md b/translations/de-DE/data/reusables/actions/gh-app-actions-read-permissions.md deleted file mode 100644 index 08998b6efb12..000000000000 --- a/translations/de-DE/data/reusables/actions/gh-app-actions-read-permissions.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_github_app %}s must have the `actions:read` permission to use this endpoint. \ No newline at end of file diff --git a/translations/de-DE/data/reusables/actions/gh-app-actions-write-permissions.md b/translations/de-DE/data/reusables/actions/gh-app-actions-write-permissions.md deleted file mode 100644 index c7c714441f31..000000000000 --- a/translations/de-DE/data/reusables/actions/gh-app-actions-write-permissions.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_github_app %}s must have the `actions:write` permission to use this endpoint. \ No newline at end of file diff --git a/translations/de-DE/data/reusables/actions/workflow-route-param-by-name.md b/translations/de-DE/data/reusables/actions/workflow-route-param-by-name.md deleted file mode 100644 index 54fc63d1fb6e..000000000000 --- a/translations/de-DE/data/reusables/actions/workflow-route-param-by-name.md +++ /dev/null @@ -1 +0,0 @@ -You can also replace `:workflow_id` with `:workflow_file_name`. For example, you could use `main.yml`. \ No newline at end of file diff --git a/translations/de-DE/data/reusables/actions/workflow-usage.md b/translations/de-DE/data/reusables/actions/workflow-usage.md deleted file mode 100644 index 90836167de81..000000000000 --- a/translations/de-DE/data/reusables/actions/workflow-usage.md +++ /dev/null @@ -1 +0,0 @@ -Billable minutes only apply to workflows in private repositories that use {% data variables.product.prodname_dotcom %}-hosted runners. Usage is listed for each {% data variables.product.prodname_dotcom %}-hosted runner operating system in milliseconds. Any job re-runs are also included in the usage. The usage does not include the multiplier for macOS and Windows runners and is not rounded up to the nearest whole minute. For more information, see "[Managing billing for {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)". \ No newline at end of file diff --git a/translations/de-DE/data/reusables/actions/workflow_runs_parameters_table.md b/translations/de-DE/data/reusables/actions/workflow_runs_parameters_table.md deleted file mode 100644 index 3ce65f23e4e3..000000000000 --- a/translations/de-DE/data/reusables/actions/workflow_runs_parameters_table.md +++ /dev/null @@ -1,8 +0,0 @@ -#### Parameters - -| Name | Typ | Beschreibung | -| -------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `actor` | `string` | Returns someone's workflow runs. Use the login for the user who created the `push` associated with the check suite or workflow run. | -| `Branch` | `string` | Returns workflow runs associated with a branch. Use the name of the branch of the `push`. | -| `event` | `string` | Returns workflow run triggered by the event you specify. For example, `push`, `pull_request` or `issue`. Weitere Informationen findest Du unter "[Ereignisse, die Workflows auslösen](/actions/automating-your-workflow-with-github-actions/events-that-trigger-workflows)". | -| `Status` | `string` | Returns workflow runs associated with the check run `status` or `conclusion` you specify. For example, a conclusion can be `success` or a status can be `completed`. For more information, see the `status` and `conclusion` options available in "[Create a check run](/v3/checks/runs/#create-a-check-run)." | diff --git a/translations/de-DE/data/reusables/apps/access_token_parameters_table_and_example.md b/translations/de-DE/data/reusables/apps/access_token_parameters_table_and_example.md deleted file mode 100644 index fac250925fe8..000000000000 --- a/translations/de-DE/data/reusables/apps/access_token_parameters_table_and_example.md +++ /dev/null @@ -1,13 +0,0 @@ -#### Parameters - -| Name | Typ | Beschreibung | -| -------------- | -------- | -------------------------------------------------------------- | -| `access_token` | `string` | The OAuth access token used to authenticate to the GitHub API. | - -#### Beispiel - -```json -{ - "access_token": "e72e16c7e42f292c6912e7710c838347ae178b4a" -} -``` diff --git a/translations/de-DE/data/reusables/apps/app_req_account_deletion.md b/translations/de-DE/data/reusables/apps/app_req_account_deletion.md deleted file mode 100644 index fc8f7cc458bd..000000000000 --- a/translations/de-DE/data/reusables/apps/app_req_account_deletion.md +++ /dev/null @@ -1 +0,0 @@ -Apps must provide customers with a way to delete their account, without having to email or call a support person. diff --git a/translations/de-DE/data/reusables/apps/authenticated_user_access.md b/translations/de-DE/data/reusables/apps/authenticated_user_access.md deleted file mode 100644 index 1318f854e775..000000000000 --- a/translations/de-DE/data/reusables/apps/authenticated_user_access.md +++ /dev/null @@ -1 +0,0 @@ -The authenticated user has explicit permission to access repositories they own, repositories where they are a collaborator, and repositories that they can access through an organization membership. diff --git a/translations/de-DE/data/reusables/apps/authorizations_oauth_tokens_SAML.md b/translations/de-DE/data/reusables/apps/authorizations_oauth_tokens_SAML.md deleted file mode 100644 index 6d057698f4c8..000000000000 --- a/translations/de-DE/data/reusables/apps/authorizations_oauth_tokens_SAML.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -{% warning %} - -**Warning:** Apps must use the [web application flow](/apps/building-oauth-apps/authorizing-oauth-apps/#web-application-flow) to obtain OAuth tokens that work with GitHub SAML organizations. OAuth tokens created using the Authorizations API will be unable to access GitHub SAML organizations. For more information, see the [blog post](https://developer.github.com/changes/2019-11-05-deprecated-passwords-and-authorizations-api). - -{% endwarning %} -{% endif %} diff --git a/translations/de-DE/data/reusables/apps/deprecating_applications_api_endpoints.md b/translations/de-DE/data/reusables/apps/deprecating_applications_api_endpoints.md deleted file mode 100644 index d9a22f21ade8..000000000000 --- a/translations/de-DE/data/reusables/apps/deprecating_applications_api_endpoints.md +++ /dev/null @@ -1,9 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -{% warning %} - -**Deprecation Notice:** {% data variables.product.prodname_dotcom %} will replace and discontinue OAuth endpoints containing `access_token` in the path parameter. We are introducing new endpoints that allow you to securely manage tokens for OAuth Apps by using `access_token` as an input parameter.{% if currentVersion == "free-pro-team@latest" %} The OAuth Application API will be removed on May 5, 2021.{% endif %} For more information,{% if currentVersion == "free-pro-team@latest" %} including scheduled brownouts,{% endif %} see the [blog post](https://developer.github.com/changes/2020-02-14-deprecating-oauth-app-endpoint/). - -{% if currentVersion != "free-pro-team@latest" %} OAuth endpoints using an `access_token` in the path parameter are currently available and not yet deprecated in {% data variables.product.prodname_ghe_server %}. {% data variables.product.prodname_dotcom %} will announce the deprecation and provide advanced notice before removing support for this feature.{% endif %} - -{% endwarning %} -{% endif %} diff --git a/translations/de-DE/data/reusables/apps/deprecating_github_services_ghe_compact.md b/translations/de-DE/data/reusables/apps/deprecating_github_services_ghe_compact.md deleted file mode 100644 index 6ffb0325d760..000000000000 --- a/translations/de-DE/data/reusables/apps/deprecating_github_services_ghe_compact.md +++ /dev/null @@ -1 +0,0 @@ -GitHub Enterprise release 2.17 and higher no longer allows admins to install GitHub Services. Please see the [Replacing GitHub Services guide](/v3/guides/replacing-github-services) for details. \ No newline at end of file diff --git a/translations/de-DE/data/reusables/apps/deprecating_oauth_authorizations.md b/translations/de-DE/data/reusables/apps/deprecating_oauth_authorizations.md deleted file mode 100644 index 1ba5d7242e26..000000000000 --- a/translations/de-DE/data/reusables/apps/deprecating_oauth_authorizations.md +++ /dev/null @@ -1,9 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -{% warning %} - -**Deprecation Notice:** {% data variables.product.prodname_dotcom %} will discontinue the OAuth Authorizations API, which is used by integrations to create personal access tokens and OAuth tokens, and you must now create these tokens using our [web application flow](/apps/building-oauth-apps/authorizing-oauth-apps/#web-application-flow).{% if currentVersion == "free-pro-team@latest" %} The OAuth Authorizations API will be removed on November, 13, 2020.{% endif %} For more information,{% if currentVersion == "free-pro-team@latest" %} including scheduled brownouts,{% endif %} see the [blog post](https://developer.github.com/changes/2020-02-14-deprecating-oauth-auth-endpoint/). - -{% if currentVersion != "free-pro-team@latest" %} The OAuth Authorizations API is currently available and not yet deprecated in {% data variables.product.prodname_ghe_server %}. {% data variables.product.prodname_dotcom %} will announce the deprecation and provide advanced notice before removing support for this feature.{% endif %} - -{% endwarning %} -{% endif %} diff --git a/translations/de-DE/data/reusables/apps/iat_required.md b/translations/de-DE/data/reusables/apps/iat_required.md deleted file mode 100644 index 9f593c964cde..000000000000 --- a/translations/de-DE/data/reusables/apps/iat_required.md +++ /dev/null @@ -1 +0,0 @@ -You must use an [installation access token](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation) to access this endpoint. diff --git a/translations/de-DE/data/reusables/apps/iat_required_multiple_endpoints.md b/translations/de-DE/data/reusables/apps/iat_required_multiple_endpoints.md deleted file mode 100644 index 2147de3e7766..000000000000 --- a/translations/de-DE/data/reusables/apps/iat_required_multiple_endpoints.md +++ /dev/null @@ -1 +0,0 @@ -You must use an [installation access token](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation) to access these endpoints. diff --git a/translations/de-DE/data/reusables/apps/jwt_or_client_secret_required.md b/translations/de-DE/data/reusables/apps/jwt_or_client_secret_required.md deleted file mode 100644 index 13789c2b3e8b..000000000000 --- a/translations/de-DE/data/reusables/apps/jwt_or_client_secret_required.md +++ /dev/null @@ -1 +0,0 @@ -GitHub Apps must use a [JWT](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint. OAuth Apps must use [basic authentication](/v3/auth/#basic-authentication) with their client ID and client secret to access this endpoint. diff --git a/translations/de-DE/data/reusables/apps/jwt_required.md b/translations/de-DE/data/reusables/apps/jwt_required.md deleted file mode 100644 index 732672754e4e..000000000000 --- a/translations/de-DE/data/reusables/apps/jwt_required.md +++ /dev/null @@ -1 +0,0 @@ -You must use a [JWT](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint. diff --git a/translations/de-DE/data/reusables/apps/null-headbranch.md b/translations/de-DE/data/reusables/apps/null-headbranch.md deleted file mode 100644 index b103680d18a2..000000000000 --- a/translations/de-DE/data/reusables/apps/null-headbranch.md +++ /dev/null @@ -1 +0,0 @@ -The Checks API only looks for pushes in the repository where the check suite or check run were created. Pushes to a branch in a forked repository are not detected and return an empty `pull_requests` array and a `null` value for `head_branch`. diff --git a/translations/de-DE/data/reusables/apps/pat_or_ba_required.md b/translations/de-DE/data/reusables/apps/pat_or_ba_required.md deleted file mode 100644 index faa31b84fa9e..000000000000 --- a/translations/de-DE/data/reusables/apps/pat_or_ba_required.md +++ /dev/null @@ -1 +0,0 @@ -You must use a personal access token (which you can create via the [command line](/articles/creating-a-personal-access-token-for-the-command-line/) or the [OAuth Authorizations API](/v3/oauth_authorizations/#create-a-new-authorization)) or [Basic Authentication](/v3/auth/#basic-authentication) to access this endpoint. diff --git a/translations/de-DE/data/reusables/apps/u2s_required.md b/translations/de-DE/data/reusables/apps/u2s_required.md deleted file mode 100644 index 1d4799450325..000000000000 --- a/translations/de-DE/data/reusables/apps/u2s_required.md +++ /dev/null @@ -1 +0,0 @@ -You must use a [user-to-server OAuth access token](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/#identifying-users-on-your-site), created for a user who has authorized your GitHub App, to access this endpoint. diff --git a/translations/de-DE/data/reusables/apps/undetected-pushes-to-a-forked-repository-for-check-runs.md b/translations/de-DE/data/reusables/apps/undetected-pushes-to-a-forked-repository-for-check-runs.md deleted file mode 100644 index 0f3827e0c590..000000000000 --- a/translations/de-DE/data/reusables/apps/undetected-pushes-to-a-forked-repository-for-check-runs.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Note:** The Checks API only looks for pushes in the repository where the check suite or check run were created. Pushes to a branch in a forked repository are not detected and return an empty `pull_requests` array. - -{% endnote %} diff --git a/translations/de-DE/data/reusables/blog/affected_users.md b/translations/de-DE/data/reusables/blog/affected_users.md deleted file mode 100644 index a390a81ab553..000000000000 --- a/translations/de-DE/data/reusables/blog/affected_users.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Note**: This update only affects users of GitHub.com and future versions of GitHub Enterprise. - -{% endnote %} diff --git a/translations/de-DE/data/reusables/branches/apps-permissions.md b/translations/de-DE/data/reusables/branches/apps-permissions.md deleted file mode 100644 index a549fc7d28dd..000000000000 --- a/translations/de-DE/data/reusables/branches/apps-permissions.md +++ /dev/null @@ -1 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}Only installed {% data variables.product.prodname_github_app %}s with `write` access to the `contents` permission can be added as authorized actors on a protected branch.{% endif %} diff --git a/translations/de-DE/data/reusables/branches/limits.md b/translations/de-DE/data/reusables/branches/limits.md deleted file mode 100644 index 1242d37342d9..000000000000 --- a/translations/de-DE/data/reusables/branches/limits.md +++ /dev/null @@ -1 +0,0 @@ -**Note**: The list of users{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, apps,{% endif %} and teams in total is limited to 100 items. diff --git a/translations/de-DE/data/reusables/branches/rename-existing-branch.md b/translations/de-DE/data/reusables/branches/rename-existing-branch.md deleted file mode 100644 index 174a317ddc65..000000000000 --- a/translations/de-DE/data/reusables/branches/rename-existing-branch.md +++ /dev/null @@ -1,3 +0,0 @@ -While you can rename your repository's existing default branch, {% data variables.product.company_short %} plans to provide tools to simplify the process of renaming the default branch. For more information on these plans, see [`github/renaming`](https://github.com/github/renaming). - -If you have already renamed the default branch, {% data variables.product.prodname_dotcom %} will automatically redirect links on {% if currentVersion ver_gt "enterprise-server@2.22" %} {% data variables.product.product_location_enterprise %}{% else %}{% data variables.product.prodname_dotcom_the_website %}{% endif %} that contain a deleted `master` branch name to the equivalent link on the repository's default branch. diff --git a/translations/de-DE/data/reusables/checks/conclusion_values.md b/translations/de-DE/data/reusables/checks/conclusion_values.md deleted file mode 100644 index e4f59199e5ea..000000000000 --- a/translations/de-DE/data/reusables/checks/conclusion_values.md +++ /dev/null @@ -1 +0,0 @@ -**Required if you provide `completed_at` or a `status` of `completed`**. The final conclusion of the check. Can be one of `success`, `failure`, `neutral`, `cancelled`, {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}`skipped`, {% endif %}`timed_out`, or `action_required`. \ No newline at end of file diff --git a/translations/de-DE/data/reusables/checks/requested_actions.md b/translations/de-DE/data/reusables/checks/requested_actions.md deleted file mode 100644 index 3db1eba7f4e9..000000000000 --- a/translations/de-DE/data/reusables/checks/requested_actions.md +++ /dev/null @@ -1 +0,0 @@ -To learn more about check runs and requested actions, see "[Check runs and requested actions](/v3/checks/runs/#check-runs-and-requested-actions)." diff --git a/translations/de-DE/data/reusables/cli/beta.md b/translations/de-DE/data/reusables/cli/beta.md deleted file mode 100644 index 27e3213098ef..000000000000 --- a/translations/de-DE/data/reusables/cli/beta.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_cli %} ist derzeit als Beta-Version verfügbar und kann sich noch ändern. diff --git a/translations/de-DE/data/reusables/collaborators/collaborator-definition.md b/translations/de-DE/data/reusables/collaborators/collaborator-definition.md deleted file mode 100644 index af37fe0d3162..000000000000 --- a/translations/de-DE/data/reusables/collaborators/collaborator-definition.md +++ /dev/null @@ -1 +0,0 @@ -the list of collaborators includes outside collaborators, organization members that are direct collaborators, organization members with access through team memberships, organization members with access through default organization permissions, and organization owners. diff --git a/translations/de-DE/data/reusables/command_line/parameters_filters.md b/translations/de-DE/data/reusables/command_line/parameters_filters.md deleted file mode 100644 index 9854cb0bca10..000000000000 --- a/translations/de-DE/data/reusables/command_line/parameters_filters.md +++ /dev/null @@ -1 +0,0 @@ -You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](/v3/#parameters). \ No newline at end of file diff --git a/translations/de-DE/data/reusables/commits/verification-object-definition.md b/translations/de-DE/data/reusables/commits/verification-object-definition.md deleted file mode 100644 index b5477af1d99d..000000000000 --- a/translations/de-DE/data/reusables/commits/verification-object-definition.md +++ /dev/null @@ -1,28 +0,0 @@ -##### Signature verification object - -The response will include a `verification` object that describes the result of verifying the commit's signature. The following fields are included in the `verification` object: - -| Name | Typ | Beschreibung | -| ----------- | --------- | -------------------------------------------------------------------------------------------------- | -| `verified` | `boolean` | Indicates whether GitHub considers the signature in this commit to be verified. | -| `grund` | `string` | The reason for `verified` value. Possible values and their meanings are enumerated in table below. | -| `signature` | `string` | The signature that was extracted from the commit. | -| `payload` | `string` | The value that was signed. | - -These are the possible values for `reason` in the `verification` object: - -| Wert | Beschreibung | -| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------- | -| `expired_key` | The key that made the signature is expired. | -| `not_signing_key` | The "signing" flag is not among the usage flags in the GPG key that made the signature. | -| `gpgverify_error` | There was an error communicating with the signature verification service. | -| `gpgverify_unavailable` | The signature verification service is currently unavailable. | -| `unsigned` | The object does not include a signature. | -| `unknown_signature_type` | A non-PGP signature was found in the commit. | -| `no_user` | No user was associated with the `committer` email address in the commit. | -| `unverified_email` | The `committer` email address in the commit was associated with a user, but the email address is not verified on her/his account. | -| `bad_email` | The `committer` email address in the commit is not included in the identities of the PGP key that made the signature. | -| `unknown_key` | The key that made the signature has not been registered with any user's account. | -| `malformed_signature` | There was an error parsing the signature. | -| `invalid` | The signature could not be cryptographically verified using the key whose key-id was found in the signature. | -| `valid` | None of the above errors applied, so the signature is considered to be verified. | diff --git a/translations/de-DE/data/reusables/desktop/commit-history-list.md b/translations/de-DE/data/reusables/desktop/commit-history-list.md deleted file mode 100644 index d33b93ab79b5..000000000000 --- a/translations/de-DE/data/reusables/desktop/commit-history-list.md +++ /dev/null @@ -1 +0,0 @@ -1. Klicke in der Liste mit dem Commit-Verlauf auf den Commit, den Du rückgängig machen möchtest. diff --git a/translations/de-DE/data/reusables/desktop/enter-2fa-in-browser.md b/translations/de-DE/data/reusables/desktop/enter-2fa-in-browser.md deleted file mode 100644 index 833fe386a018..000000000000 --- a/translations/de-DE/data/reusables/desktop/enter-2fa-in-browser.md +++ /dev/null @@ -1 +0,0 @@ -1. Kehre zu {% data variables.product.prodname_dotcom %} zurück. Gib an der Eingabeaufforderung Deinen 2FA-Code ein, und klicke anschließend auf **Verify** (Überprüfen). ![Das Feld für den 2FA-Authentifizierungscode](/assets/images/help/desktop/2fa-code-field.png) diff --git a/translations/de-DE/data/reusables/desktop/retrieve-2fa-in-browser.md b/translations/de-DE/data/reusables/desktop/retrieve-2fa-in-browser.md deleted file mode 100644 index cfb417b8fdb6..000000000000 --- a/translations/de-DE/data/reusables/desktop/retrieve-2fa-in-browser.md +++ /dev/null @@ -1,3 +0,0 @@ -1. Gehe wie folgt vor, wenn Du die Zwei-Faktor-Authentifizierung für {% data variables.product.prodname_dotcom %} konfiguriert hast: - - Wenn Du die Zwei-Faktor-Authentifizierung per SMS eingerichtet hast, rufst Du Deinen2FA-Code aus einer SMS ab. - - Wenn Du die Zwei-Faktor-Authentifizierung mit einer TOTP-Anwendung eingerichtet hast, generierst Du einen 2FA-Code. diff --git a/translations/de-DE/data/reusables/desktop/windows-select-file-menu.md b/translations/de-DE/data/reusables/desktop/windows-select-file-menu.md deleted file mode 100644 index 697662ff5f89..000000000000 --- a/translations/de-DE/data/reusables/desktop/windows-select-file-menu.md +++ /dev/null @@ -1 +0,0 @@ -1. Wähle in der oberen linken Ecke Deines Bildschirms das Menü **File** (Datei) aus. ![Das Menü {% data variables.product.prodname_desktop %} auf der Windows-Menüleiste](/assets/images/help/desktop/windows-select-file-menu.png) diff --git a/translations/de-DE/data/reusables/dotcom_billing/cost-management-tab.md b/translations/de-DE/data/reusables/dotcom_billing/cost-management-tab.md deleted file mode 100644 index c3328d64b82b..000000000000 --- a/translations/de-DE/data/reusables/dotcom_billing/cost-management-tab.md +++ /dev/null @@ -1 +0,0 @@ -1. Klicke unter „Billing" (Abrechnung) auf **Cost management** (Kostenverwaltung). ![Registerkarte „Cost Management" (Kostenverwaltung)](/assets/images/help/settings/cost-management-tab.png) diff --git a/translations/de-DE/data/reusables/dotcom_billing/publishing-nodejs-packages.md b/translations/de-DE/data/reusables/dotcom_billing/publishing-nodejs-packages.md deleted file mode 100644 index 53626603442c..000000000000 --- a/translations/de-DE/data/reusables/dotcom_billing/publishing-nodejs-packages.md +++ /dev/null @@ -1,203 +0,0 @@ ---- -title: Node.js-Pakete veröffentlichen -intro: Du kannst Node.js-Pakete als Teil Deines Workflows zur kontinuierlichen Integrations (CI) in einer Registry veröffentlichen. -product: '{% data reusables.gated-features.actions %}' -productVersions: - dotcom: '*' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages ---- - -### Einführung - -Dieser Leitfaden zeigt Dir, wie Du einen Workflow erstellen kannst, der Node.js Pakete nach den Tests der fortlaufenden Integration (CI) in die {% data variables.product.prodname_registry %} und npm Registrierungen veröffentlicht. Mit einem einzigen Workflow kannst Du Pakete in einer einzigen Registry oder in mehreren Registries veröffentlichen. - -### Vorrausetzungen - -Wir empfehlen, dass Du ein grundlegendes Verständnis von Workflowkonfigurations-Optionen hast und darüber, wie Du eine Workflow-Datei erstellst. Weitere Informationen findest Du unter „[Einen Workflow konfigurieren](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)“. - -Weitere Informationen zum Erstellen eines CI-Workflows für Dein Node.js-Projekt findest Du unter „[Node.js mit {% data variables.product.prodname_actions %} verwenden](/actions/automating-your-workflow-with-github-actions/using-nodejs-with-github-actions)“. - -Vielleicht findest Du es auch hilfreich, ein grundlegendes Verständnis von Folgendem zu haben: - -- „[Kernkonzepte für {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)“ -- „[Konfiguration von npm für die Verwendung mit {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)“ -- "[Umgebungsvariablen verwenden](/actions/automating-your-workflow-with-github-actions/using-environment-variables)" -- „[Verschlüsselte Geheimnisse erzeugen und verwenden](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)“ -- „[Authentifizierung mit dem GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)“ - -### Informationen zur Paketkonfiguration - - Die Felder `name` und `version` in der Datei *package.json* bilden eine eindeutige Kennung. Registries verwenden diese Kennung, um Dein Paket mit einer Registry zu verknüpfen. Du kannst eine Zusammenfassung für die Paketlisten-Seite hinzufügen, indem Du in die Datei *package.json* ein Feld `description` einfügst. Weitere Informationen findest Du unter „[Eine Datei package.json erstellen](https://docs.npmjs.com/creating-a-package-json-file)“ und „[Node.js-Module erstellen](https://docs.npmjs.com/creating-node-js-modules)“ in der npm-Dokumentation. - -Wenn eine lokale Datei *.npmrc* existiert, in der ein Wert `registry` angegeben ist, dann verwendet der Befehl `npm publish` die in der Datei *.npmrc* konfigurierte Registry. {% data reusables.github-actions.setup-node-intro %} - -Du kannst die auf dem Runner installierte Node.js-Version mit der Aktion `setup-node` angeben. - -Wenn Du Schritte in Deinen Workflow einfügst, um die `publishConfig`-Felder in Deiner *package.json*-Datei zu konfigurieren, brauchst Du die Registry-URL nicht mittels der Aktion `setup-node` anzugeben, aber Du kannst das Paket in nur einer einzigen Registry veröffentlichen. Weitere Informationen finden Sie unter „[publishConfig](https://docs.npmjs.com/files/package.json#publishconfig)“ in der NPM-Dokumentation. - -### Pakete in der npm-Registry veröffentlichen - -Jedes Mal, wenn Du ein neues Release erstellst, kannst Du einen Workflow anstoßen, um Dein Paket zu veröffentlichen. Der Workflow im folgenden Beispiel wird von dem Ereignis `release` vom Typ `created` angestoßen. Der Workflow veröffentlicht das Paket im npm-Registry sofern es die CI-Tests besteht. - -Um in Deinem Workflow authentifizierte Operationen gegenüber der npm-Registry durchzuführen, musst Du Dein npm-Authentifizierungstoken als Geheimnis in Deinen Repository-Einstellungen ablegen. Erstelle z.B. ein Geheimnis namens `NPM_TOKEN`. Weitere Informationen findest Du unter „[Verschlüsselte Geheimnisse erstellen und verwenden](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)“. - -Standardmäßig verwendet npm das Feld `name` der Datei *package.json*, um die npm-Registry zu ermitteln. Wenn Du in einem globalen Namespace veröffentlichst, brauchst Du nur den Paketnamen anzugeben. Zum Beispiel würdest Du ein Paket namens `npm-hello-world-test` auf `https://www.npmjs.com/package/npm-hello-world-test` veröffentlichen. - -Wenn Du ein Paket veröffentlichst, das einen Präfix für den „scope“ (Geltungsbereich) enthält, dann füge den Geltungsbereich als `name` in Deine Datei *package.json* ein. Wenn beispielsweise Dein Präfix für den npm-scope „octocat“ und der Paketname „hello-world“ ist, dann sollte der `name` in Deiner Datei *package.json* auf `@octocat/hallo-world` gesetzt sein. Wenn Dein npm-Paket einen Scope-Präfix verwendet und das Paket öffentlich ist, musst Du die Option `npm publish --access public` verwenden. Dies ist eine Option, die npm verlangt, um zu verhindern, dass jemand versehentlich ein privates Paket veröffentlicht. - -Dieses Beispiel speichert das Geheimnis `NPM_TOKEN` in der Umgebungsvariablen `NODE_AUTH_TOKEN`. Wenn die Aktion `setup-node` eine Datei *.npmrc* erzeugt, referenziert sie das Token aus der Umgebungsvariable `NODE_AUTH_TOKEN`. - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # Datei .npmrc zur Veroeffentlichung auf npm einrichten - - uses: actions/setup-node@v1 - with: - node-version: '12.x' - registry-url: 'https://registry.npmjs.org' - - run: npm install - - run: npm publish - env: - NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} -``` -{% endraw %} - -Im obigen Beispiel erzeugt die Aktion `setup-node` auf dem Runner eine Datei *.npmrc* mit folgendem Inhalt: - -``` -//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN} -registry=https://registry.npmjs.org/ -always-auth=true -``` - -### Pakete in der {% data variables.product.prodname_registry %} veröffentlichen - -Jedes Mal, wenn Du ein neues Release erstellst, kannst Du einen Workflow anstoßen, um Dein Paket zu veröffentlichen. Der Workflow im folgenden Beispiel läuft jedes Mal, wenn das Ereignis `release` vom Typ `created` auftritt. Der Workflow veröffentlicht das Paket in {% data variables.product.prodname_registry %} , wenn die CI-Tests bestanden wurden. - -Standardmäßig veröffentlicht die {% data variables.product.prodname_registry %} ein Paket in dem Repository auf {% data variables.product.prodname_dotcom %}, das Du im Feld `name` der Datei *package.json* angibst. Ein Paket namens `@my-org/test` würde beispielsweise im Repository `my-org/test` auf {% data variables.product.prodname_dotcom %} veröffentlicht. Weitere Informationen finden Sie unter [„`npm-scope`“ (npm-Gültigkeitsbereich)](https://docs.npmjs.com/misc/scope) in der npm-Dokumentation. - -Um authentifizierte Vorgänge für die Registry {% data variables.product.prodname_registry %} in Deinem Workflow kannst Du den `GITHUB_TOKEN` verwenden. Der `GITHUB_TOKEN` existiert standardmäßig in Deinem Repository und hat Lese- und Schreibrechte für Pakete in dem Repository, in dem der Workflow läuft. Weitere Informationen findest Du unter „[Verschlüsselte Geheimnisse erstellen und verwenden](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)“. - -Dieses Beispiel speichert das Geheimnis `GITHUB_TOKEN` in der Umgebungsvariablen `NODE_AUTH_TOKEN`. Wenn die Aktion `setup-node` eine Datei *.npmrc* erzeugt, referenziert sie das Token aus der Umgebungsvariable `NODE_AUTH_TOKEN`. - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # Datei.npmrc zum veroeffentlichen von GitHub-Paketen einrichten - - uses: actions/setup-node@v1 - with: - node-version: '12.x' - registry-url: 'https://npm.pkg.github.com' - scope: '@octocat' # Ist standardmaessig der Benutzer oder die Organisation, der die Workflow-Datei gehoert - - run: npm install - - run: npm publish - env: - NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} - -Die Aktion `setup-node` erzeugt eine Datei *.npmrc* auf dem Runner. Wenn Du für die Aktion `setup-node` die Eingabe `scope` verwendest, enthält die Datei *.npmrc* das Präfix „scope“. Standardmäßig legt die Aktion `setup-node` den „Scope“ (Geltungsbereich) in der Datei *.npmrc* auf das Konto fest, das diese Workflow-Datei enthält. - -``` -//npm.pkg.github.com/:_authToken=${NODE_AUTH_TOKEN} -@octocat:registry=https://npm.pkg.github.com -always-auth=true -``` - -### Pakete mittels „Yarn“ veröffentlichen - -Wenn Du den Paketmanager „Yarn“ verwendest, kannst Du mit Yarn Pakete installieren und veröffentlichen. - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # Datei .npmrc einrichten, um auf npm zu publizieren - - uses: actions/setup-node@v1 - with: - node-version: '12.x' - registry-url: 'https://registry.npmjs.org' - scope: '@octocat' # Ist standardmaessig der Benutzer oder die Organisation, der die Workflow-Datei gehoert - - run: yarn - - run: yarn publish - env: - NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} -``` -{% endraw %} - -### Pakete auf npm und in der {% data variables.product.prodname_registry %} veröffentlichen - -{% note %} - -**Hinweis:** Wenn Du in Registries mit unterschiedlichen „Scope“-Präfixen publizieren musst, dann musst Du die Datei *package.json* auf dem Runner anpassen, um das „Scope“-Präfix zu ändern. Wenn Du beispielsweise ein Paket im Geltungsbereich `@mona` für npm und `@octocat` für {% data variables.product.prodname_registry %}veröffentlichst, kannst Du nach der Veröffentlichung auf npm und vor der Veröffentlichung in der {% data variables.product.prodname_registry %} auf dem Runner in der Datei *package.json* den Geltungsbereich `@mona` durch `@octocat` ersetzen. - -{% endnote %} - -Du kannst Deine Pakete sowohl in der npm-Registry als auch in {% data variables.product.prodname_registry %} veröffentlichen, indem Du die Aktion `setup-node` für jede Registry verwendest. - -Wenn Du ein Paket in beiden Registries veröffentlichst, musst Du sicherstellen, dass Dein „Scope“-Präfix auf npm mit Deinem Benutzer- oder Organisationsnamen in {% data variables.product.prodname_dotcom %} übereinstimmt. Um Pakete in einer öffentlichen Registry mit einem „Scope“-Präfix zu veröffentlichen, kannst Du den Befehl `npm publish --access public` verwenden. Weitere Informationen findest Du unter [`npm-scope`](https://docs.npmjs.com/misc/scope) und „[Öffentliche Pakete mit „Scope“ (Geltungsbereich) anlegen und veröffentlichen](https://docs.npmjs.com/creating-and-publishing-scoped-public-packages)“ in der npm-Dokumentation. - -Stelle sicher, dass in Deiner Datei *package.json* den Geltungsbereich Deines {% data variables.product.prodname_dotcom %}-Repositorys und der npm-Registry angegeben ist. Wenn Du beispielsweise ein Paket im Repository `octocat/npm-hello-world-test` auf {% data variables.product.prodname_dotcom %} und https://www.npmjs.com/package/@octocat/npm-hello-world-test veröffentlichen willst, dann sollte in Deiner Datei *package.json* der Name `"name": "@octocat/npm-hello-world-test"` stehen. - -Um authentifizierte Vorgänge für die Registry {% data variables.product.prodname_registry %} in Deinem Workflow kannst Du den `GITHUB_TOKEN` verwenden. Der `GITHUB_TOKEN` existiert standardmäßig in Deinem Repository und hat Lese- und Schreibrechte für Pakete in dem Repository, in dem der Workflow läuft. Weitere Informationen findest Du unter „[Verschlüsselte Geheimnisse erstellen und verwenden](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)“. - -Wenn Du für die Aktion `setup-node` die Eingabe `scope` verwendest, erstellt die Aktion eine Datei *.npmrc* mit dem Präfix „scope“. Standardmäßig legt die Aktion `setup-node` den Geltungsbereich in der Datei *.npmrc* auf den Benutzer oder die Organisation fest, der die Workflow-Datei gehört. - -Dieser Workflow ruft die Aktion `setup-node` zweimal auf. Jedes Mal, wenn die Aktion `setup-node` ausgeführt wird, überschreibt sie die Datei *.npmrc*. Die Datei *.npmrc* referenziert den Token, mit dem Du authentifizierte Operationen in der Paket-Registry durchführen kannst, durch die Umgebungsvariable `NODE_AUTH_TOKEN`. Der Workflow setzt die Umgebungsvariable `NODE_AUTH_TOKEN` jedes Mal, wenn der Befehl `npm publish` ausgeführt wird; zuerst mit einem Token zum Veröffentlichen auf npm (`NPM_TOKEN`) und dann mit einem Token zum Veröffentlichen in der {% data variables.product.prodname_registry %} (`GITHUB_TOKEN`). - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # Datei.npmrc zum Veroeffentlichen auf npm einrichten - - uses: actions/setup-node@v1 - with: - node-version: '10.x' - registry-url: 'https://registry.npmjs.org' - - run: npm install - # Auf npm veroeffentlichen - - run: npm publish --access public - env: - NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} - # Datei .npmrc zum Veröffentlichen von GitHub-Paketen einrichten - - uses: actions/setup-node@v1 - with: - registry-url: 'https://npm.pkg.github.com' - scope: '@octocat' # Defaults to the user or organization that owns the workflow file - # Auf GitHub-Pakete veroeffentlichen - - run: npm publish - env: - NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} diff --git a/translations/de-DE/data/reusables/enterprise-accounts/business-settings.md b/translations/de-DE/data/reusables/enterprise-accounts/business-settings.md deleted file mode 100644 index ecdf4350e651..000000000000 --- a/translations/de-DE/data/reusables/enterprise-accounts/business-settings.md +++ /dev/null @@ -1 +0,0 @@ -1. Klicke unter dem Namen Deines Geschäftskontos auf {% octicon "gear" aria-label="The Settings gear" %} **Settings** (Einstellungen). ![Registerkarte „Settings“ (Einstellungen) auf der Geschäftskonto-Profilseite](/assets/images/help/business-accounts/business-account-settings-tab.png) diff --git a/translations/de-DE/data/reusables/enterprise-accounts/github-dotcom-connection-tab.md b/translations/de-DE/data/reusables/enterprise-accounts/github-dotcom-connection-tab.md deleted file mode 100644 index b589ea3a5ad4..000000000000 --- a/translations/de-DE/data/reusables/enterprise-accounts/github-dotcom-connection-tab.md +++ /dev/null @@ -1 +0,0 @@ -1. Klicke auf der linken Seitenleiste auf **{% data variables.product.prodname_dotcom_the_website %} connection** ({% data variables.product.prodname_dotcom_the_website %}-Verbindung). ![Registerkarte „GitHub.com connection“ (GitHub.com-Verbindung) auf der Seitenleiste mit den Einstellungen des Geschäftskontos](/assets/images/enterprise/business-accounts/settings-github-dotcom-connection-tab.png) diff --git a/translations/de-DE/data/reusables/enterprise-accounts/member-privileges-tab.md b/translations/de-DE/data/reusables/enterprise-accounts/member-privileges-tab.md deleted file mode 100644 index a7d0aeb63082..000000000000 --- a/translations/de-DE/data/reusables/enterprise-accounts/member-privileges-tab.md +++ /dev/null @@ -1 +0,0 @@ -1. Klicke auf der Seitenleiste mit den Geschäftseinstellungen auf **Member privileges** (Mitgliederberechtigungen). ![Registerkarte „Member privileges“ (Mitgliederberechtigungen) auf der Seitenleiste mit den Einstellungen des Geschäftskontos](/assets/images/help/business-accounts/settings-member-privileges-tab.png) diff --git a/translations/de-DE/data/reusables/enterprise/ldap_sync_warning.md b/translations/de-DE/data/reusables/enterprise/ldap_sync_warning.md deleted file mode 100644 index 7a7408c64bd8..000000000000 --- a/translations/de-DE/data/reusables/enterprise/ldap_sync_warning.md +++ /dev/null @@ -1,9 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" %} - -{% warning %} - -If your {% data variables.product.prodname_ghe_server %} instance has [LDAP Sync enabled and the option to synchronize emails enabled](/enterprise/admin/guides/user-management/using-ldap/#enabling-ldap-sync), this API is disabled and will return a `403` response. Users managed in LDAP won't be able to add or delete an email address via the API with these options enabled. - -{% endwarning %} - -{% endif %} diff --git a/translations/de-DE/data/reusables/enterprise_enterprise_support/sign-in-to-enterprise-portal.md b/translations/de-DE/data/reusables/enterprise_enterprise_support/sign-in-to-enterprise-portal.md deleted file mode 100644 index c5cff5a0c1f0..000000000000 --- a/translations/de-DE/data/reusables/enterprise_enterprise_support/sign-in-to-enterprise-portal.md +++ /dev/null @@ -1 +0,0 @@ -1. Um Dich im {% data variables.contact.enterprise_portal %} anzumelden, klicke in der oberen rechten Ecke der Seite auf **Sign in** (Anmelden). ![Melden Dich bei {% data variables.contact.enterprise_portal %} an](/assets/images/enterprise/support/sign-in-support-portal.png) diff --git a/translations/de-DE/data/reusables/enterprise_installation/increasing-cpus-max.md b/translations/de-DE/data/reusables/enterprise_installation/increasing-cpus-max.md deleted file mode 100644 index 3698e67c8252..000000000000 --- a/translations/de-DE/data/reusables/enterprise_installation/increasing-cpus-max.md +++ /dev/null @@ -1,3 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" %} - {% data reusables.enterprise_installation.increasing-cpus-req %} Wenn Du mehr als 16 CPUs verwendest, ist es nicht nötig, 6,5 GB Arbeitsspeicher für jede CPU hinzuzufügen. Du solltest jedoch Deine Instanz überwachen, um sicherzustellen, dass sie über genügend Arbeitsspeicher verfügt. -{% endif %} diff --git a/translations/de-DE/data/reusables/enterprise_installation/resizing-root-disk.md b/translations/de-DE/data/reusables/enterprise_installation/resizing-root-disk.md deleted file mode 100644 index 91d8c75e6950..000000000000 --- a/translations/de-DE/data/reusables/enterprise_installation/resizing-root-disk.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Hinweis:** Die Größe der Root-Disk kann geändert werden, indem eine neue Appliance erstellt oder eine vorhandene Appliance verwendet wird. Weitere Informationen findest Du unter „[Speicherkapazität erhöhen](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-storage-capacity)“. - -{% endnote %} diff --git a/translations/de-DE/data/reusables/enterprise_installation/root-and-data-disk-requirement.md b/translations/de-DE/data/reusables/enterprise_installation/root-and-data-disk-requirement.md deleted file mode 100644 index 818ef451e513..000000000000 --- a/translations/de-DE/data/reusables/enterprise_installation/root-and-data-disk-requirement.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_ghe_server %} schreibt eine persistente Data-Disk vor, die von der Root-Disk getrennt ist. Weitere Informationen findest Du unter „[Systemübersicht](/enterprise/admin/guides/installation/system-overview)“. diff --git a/translations/de-DE/data/reusables/enterprise_installation/storage-disk-requirements.md b/translations/de-DE/data/reusables/enterprise_installation/storage-disk-requirements.md deleted file mode 100644 index 11e2e2ad3fa4..000000000000 --- a/translations/de-DE/data/reusables/enterprise_installation/storage-disk-requirements.md +++ /dev/null @@ -1 +0,0 @@ -Für Dein Speichergerät solltest Du ein hochleistungsfähiges SSD verwenden, also entweder Direct Attached Storage (DAS) oder Storage-Area-Network (SAN). diff --git a/translations/de-DE/data/reusables/enterprise_installation/warning-on-polling.md b/translations/de-DE/data/reusables/enterprise_installation/warning-on-polling.md deleted file mode 100644 index 19d131d7a2d4..000000000000 --- a/translations/de-DE/data/reusables/enterprise_installation/warning-on-polling.md +++ /dev/null @@ -1,5 +0,0 @@ -{% warning %} - -**Warnung:** Wir empfehlen Dir Webhooks zu verwenden, um Repository-Änderungen für die fortlaufende Integration (CI) oder für ähnliche Systeme abzurufen. Durch regelmäßige automatische Überprüfungen oder durch das *automatische Abrufen* wird die Skalierbarkeit Deiner Instanz erheblich reduziert. Weitere Informationen findest Du unter „[Informationen zu Webhooks](/enterprise/{{ currentVersion }}/user/articles/about-webhooks/)“. - -{% endwarning %} diff --git a/translations/de-DE/data/reusables/gated-features/actions-api-gated.md b/translations/de-DE/data/reusables/gated-features/actions-api-gated.md deleted file mode 100644 index e76af434a6c5..000000000000 --- a/translations/de-DE/data/reusables/gated-features/actions-api-gated.md +++ /dev/null @@ -1,5 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} - -{% data variables.product.prodname_actions %} ist verfügbar mit {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_free_team %} für Organisationen, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, und {% data variables.product.prodname_ghe_one %}. {% data variables.product.prodname_actions %} ist nicht verfügbar für private Repositorys, die im Besitz von Konten mit älteren Pro-Repository-Plänen sind. {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %} - -{% endif %} diff --git a/translations/de-DE/data/reusables/gated-features/credential-authorizations-org.md b/translations/de-DE/data/reusables/gated-features/credential-authorizations-org.md deleted file mode 100644 index e095cbb82136..000000000000 --- a/translations/de-DE/data/reusables/gated-features/credential-authorizations-org.md +++ /dev/null @@ -1,5 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} - -Listing and deleting credential authorizations is available to organizations with {% data variables.product.prodname_ghe_cloud %}. {% data reusables.gated-features.more-info %} - -{% endif %} diff --git a/translations/de-DE/data/reusables/gated-features/draft-pull-requests.md b/translations/de-DE/data/reusables/gated-features/draft-pull-requests.md deleted file mode 100644 index 6e49d9c9568c..000000000000 --- a/translations/de-DE/data/reusables/gated-features/draft-pull-requests.md +++ /dev/null @@ -1,2 +0,0 @@ - -Entwürfe für Pull Requests sind verfügbar in öffentlichen Repositorys mit {% data variables.product.prodname_free_user %} und {% data variables.product.prodname_free_team %} für Organisationen, {% data variables.product.prodname_pro %}, und älteren Pro-Repository Abrechnungsplänen, und in öffentlichen und privaten Repositorys mit {% data variables.product.prodname_team %}{% if currentVersion != "free-pro-team@latest" %}, {% data variables.product.prodname_ghe_server %} 2.17+,{% endif %} und {% data variables.product.prodname_ghe_cloud %}. {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %} diff --git a/translations/de-DE/data/reusables/gated-features/policies.md b/translations/de-DE/data/reusables/gated-features/policies.md deleted file mode 100644 index f826eda65ff1..000000000000 --- a/translations/de-DE/data/reusables/gated-features/policies.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Note:** {% data variables.product.prodname_policies %} is currently in alpha. This documentation is confidential and made available under NDA. Do not distribute. - -{% endnote %} \ No newline at end of file diff --git a/translations/de-DE/data/reusables/gated-features/sponsors-beta.md b/translations/de-DE/data/reusables/gated-features/sponsors-beta.md deleted file mode 100644 index 3bc3046ecae9..000000000000 --- a/translations/de-DE/data/reusables/gated-features/sponsors-beta.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Hinweis:** {% data variables.product.prodname_sponsors %} für Organisationen befindet sich derzeit in der Beta-Version und kann sich jederzeit verändern. - -{% endnote %} diff --git a/translations/de-DE/data/reusables/gated-features/team-sync-gated.md b/translations/de-DE/data/reusables/gated-features/team-sync-gated.md deleted file mode 100644 index 961574fa206d..000000000000 --- a/translations/de-DE/data/reusables/gated-features/team-sync-gated.md +++ /dev/null @@ -1,5 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} - -Teamsynchronisierung ist für Organisationen verfügbar, welche {% data variables.product.prodname_ghe_cloud %} einsetzen. {% data reusables.gated-features.more-info %} - -{% endif %} diff --git a/translations/de-DE/data/reusables/github-actions/explains-hello-world-example.md b/translations/de-DE/data/reusables/github-actions/explains-hello-world-example.md deleted file mode 100644 index 56b4c1351156..000000000000 --- a/translations/de-DE/data/reusables/github-actions/explains-hello-world-example.md +++ /dev/null @@ -1 +0,0 @@ -The `OWNER` des Repository ist die `octocat` Organisation und der `REPOSITORY` Name is `hello-world`. diff --git a/translations/de-DE/data/reusables/github-actions/github-actions-minutes-change.md b/translations/de-DE/data/reusables/github-actions/github-actions-minutes-change.md deleted file mode 100644 index 29b0094dbd21..000000000000 --- a/translations/de-DE/data/reusables/github-actions/github-actions-minutes-change.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Hinweis:** Nach dem 14. Mai 2020 wird {% data variables.product.prodname_team %} 3'000 {% data variables.product.prodname_actions %} Minuten pro Monat beinhalten. - -{% endnote %} diff --git a/translations/de-DE/data/reusables/github-actions/github-actions-usage-limits.md b/translations/de-DE/data/reusables/github-actions/github-actions-usage-limits.md deleted file mode 100644 index 73bd2f1b4db9..000000000000 --- a/translations/de-DE/data/reusables/github-actions/github-actions-usage-limits.md +++ /dev/null @@ -1,15 +0,0 @@ -Es gibt einige Einschränkungen für die Benutzung von {% data variables.product.prodname_actions %} und es hängt davon ab, ob Du {% data variables.product.prodname_dotcom %}-gehostete oder selbst gehostete Läufer verwendest. Die Einschränkungen können sich jederzeit ändern. - -- **Job execution time** (Auftrags-Ausführungszeit) - Jeder Job in einem Workflow kann bis zu 6 Stunden Ausführungszeit laufen. Wenn ein Auftrag dieses Limit erreicht, wird der Auftrag beendet und kann nicht abgeschlossen werden. Dieses Limit gilt nicht für selbst-gehostete Läufer. -- **Workflow run time** (Workflow-Laufzeit) - Jede Workflow-Ausführung ist auf 72 Stunden begrenzt. Wenn eine Workflow-Ausführung diesen Grenzwert erreicht, wird die Workflow-Ausführung abgebrochen. Dieses Limit gilt auch für selbst-gehostete Läufer. -- **Job queue time** (Job-Warteschlangenzeit) - Jeder Auftrag für selbst-gehostete Läufer kann maximal 24 Stunden lang in die Warteschlange gestellt werden. Wenn ein selbst-gehosteter Läufer die Ausführung des Auftrags nicht innerhalb dieses Limits startet, wird der Auftrag beendet und kann nicht abgeschlossen werden. Dieses Limit gilt nicht für {% data variables.product.prodname_dotcom %}-gehostete Läufer. -- **API requests** (API Anfragen) - Pro Stunde kannst Du bis zu 1000 API-Anfragen über alle Aktionen innerhalb innerhalb eines Repository ausführen. Bei Überschreitung schlagen zusätzliche API-Aufrufe fehl, was dazu führen kann, dass Aufträge fehlschlagen. Dieses Limit gilt auch für selbst-gehostete Läufer. -- **Concurrent Jobs** (parallele Aufträge) - Die Anzahl paralleler Aufträge, die Du in Ihrem Konto ausführen kannst, hängt von Deinem GitHub-Plan ab, wie in der folgenden Tabelle ersichtlich. Bei Überschreitung werden alle zusätzlichen Aufträge in die Warteschlange gestellt. Es gibt keine Parallelitätsgrenzen für selbst-gehostete Läufer. - - | GitHub Plan | Total parallele Aufträge | Maximal parallele macOS-Aufträge | - | ----------- | ------------------------ | -------------------------------- | - | Kostenlos | 20 | 5 | - | Pro | 40 | 5 | - | Team | 60 | 5 | - | Enterprise | 180 | 50 | -- **Auftrags-Matrix** - {% data reusables.github-actions.matrix-limits %} diff --git a/translations/de-DE/data/reusables/github-actions/matrix-limits.md b/translations/de-DE/data/reusables/github-actions/matrix-limits.md deleted file mode 100644 index 48a4accbabe4..000000000000 --- a/translations/de-DE/data/reusables/github-actions/matrix-limits.md +++ /dev/null @@ -1 +0,0 @@ -Eine Auftragsmatrix kann maximal 256 Aufträge pro Workflow-Ausführung generieren. Dieses Limit gilt auch für selbst-gehostete Läufer. \ No newline at end of file diff --git a/translations/de-DE/data/reusables/github-actions/self-hosted-runner-add-new-runner.md b/translations/de-DE/data/reusables/github-actions/self-hosted-runner-add-new-runner.md deleted file mode 100644 index 51c6911d4793..000000000000 --- a/translations/de-DE/data/reusables/github-actions/self-hosted-runner-add-new-runner.md +++ /dev/null @@ -1,20 +0,0 @@ -1. Klicke unter „Self-hosted runners" (selbst-gehostete Läufer) auf **Add runner** (Läufer hinzufügen). - -1. Wähle das Betriebssystem und die Architektur Deiner selbst-gehosteten Läufermaschine aus. ![Selbst-gehostetes Läuferbetriebssystem auswählen](/assets/images/help/settings/actions-runner-architecture-os.png) - - -1. Du wirst Anweisungen sehen, wie Du die Läuferanwendung herunterlädst und sie auf Deiner selbst-gehosteten Läufermaschine installierst. - - Öffne eine Shell auf Deiner selbst-gehosteten Läufermaschine und führe jeden Shell-Befehl in der angezeigten Reihenfolge aus. - - {% note %} - - **Hinweis:** Wenn Du unter Windows die selbst gehostete Läuferanwendung als Dienst installieren möchtest, musst Du eine Shell mit Administratorberechtigungen öffnen. Wir empfehlen auch, dass Du `C:\actions-runner` als Verzeichnis für die selbst-gehostete Läuferanwendung verwendest, damit Windows System-Konten auf das Läuferverzeichnis zugreifen können. - - {% endnote %} - - Die Anweisungen führen Dich durch die Vervollständigung dieser Aufgaben: - - Herunterladen und Extrahieren der selbst-gehosteten Läuferanwendung. - - Ausführen des `config` Skript zum Konfigurieren der selbst-gehosteten Läuferanwendung und die Registrierung mit {% data variables.product.prodname_actions %}. Das `config` Skript benötigt die Ziel-URL und einen automatisch generierten, zeitlich limitierten Token, um die Anfrage zu authentifizieren. - - Unter Windows fragt das `config` Skript auch, ob Du die selbst-gehostete Läuferanwendung als Dienst installieren möchtest. Für Linux und macOS kannst Du einen Dienst installieren, nachdem Du das Hinzufügen des Läufers beendet hast. Weitere Informationen findest Du unter ["Konfigurieren der selbst-gehosteten Läuferanwendung als Dienst".](/actions/automating-your-workflow-with-github-actions/configuring-the-self-hosted-runner-application-as-a-service) - - Ausführen der selbst-gehosteten Läuferanwendung zum Verbinden der Maschine mit {% data variables.product.prodname_actions %}. diff --git a/translations/de-DE/data/reusables/github-component-kit/intro-for-component-kit.md b/translations/de-DE/data/reusables/github-component-kit/intro-for-component-kit.md deleted file mode 100644 index d58b67db5962..000000000000 --- a/translations/de-DE/data/reusables/github-component-kit/intro-for-component-kit.md +++ /dev/null @@ -1 +0,0 @@ -The {% data variables.product.prodname_component_kit %} uses {% data variables.product.prodname_github_app %}s and {% data variables.product.prodname_actions %} to power interactive elements within the {% data variables.product.prodname_dotcom %} UI. For example, you can guide repository users with next steps or prompt them to accept license agreements. diff --git a/translations/de-DE/data/reusables/github-component-kit/opening-explanation-for-component-kit.md b/translations/de-DE/data/reusables/github-component-kit/opening-explanation-for-component-kit.md deleted file mode 100644 index 9e7d48686861..000000000000 --- a/translations/de-DE/data/reusables/github-component-kit/opening-explanation-for-component-kit.md +++ /dev/null @@ -1,3 +0,0 @@ -The {% data variables.product.prodname_component_kit %} enables you to configure an interactive component to appear in a pull request or issue. Interactive components enable people to trigger and manage tasks that appear in the {% data variables.product.prodname_dotcom %} UI while a {% data variables.product.prodname_github_app %} or action performs the requested tasks and shares updates. - -Using the "[Create composable comment](/hidden/github-component-kit/composable-comments#create-composable-comment)" endpoint, a {% data variables.product.prodname_github_app %} or action can create a composable comment in an issue or pull request. The composable comment can include an interactive component, such as a custom button. When someone interacts with the comment, the {% data variables.product.prodname_github_app %} will receive the `interactive_component` webhook event. diff --git a/translations/de-DE/data/reusables/github-insights/no-configuration-file.md b/translations/de-DE/data/reusables/github-insights/no-configuration-file.md deleted file mode 100644 index 0e35facd20a7..000000000000 --- a/translations/de-DE/data/reusables/github-insights/no-configuration-file.md +++ /dev/null @@ -1 +0,0 @@ -Wenn Du keine Konfigurationsdatei hast, folge den Anweisungen zur Erstinstallation von {% data variables.product.prodname_insights %}. Weitere Informationen findest Du unter "[Installieren von {% data variables.product.prodname_insights %}](/insights/installing-and-configuring-github-insights/installing-github-insights#installing-github-insights)." diff --git a/translations/de-DE/data/reusables/identity-and-permissions/about-connected-teams.md b/translations/de-DE/data/reusables/identity-and-permissions/about-connected-teams.md deleted file mode 100644 index 20c973cd4756..000000000000 --- a/translations/de-DE/data/reusables/identity-and-permissions/about-connected-teams.md +++ /dev/null @@ -1,7 +0,0 @@ -Wenn Ihre {% data variables.product.prodname_dotcom %}-Teams mit einer IdP-Gruppe verbunden sind, muss Ihr IdP-Administrator Änderungen an der Teammitgliedschaft über den Identity Provider vornehmen. Wenn ein Team mit einer IdP-Gruppe verbunden ist, kannst Du die Teammitgliedschaft nicht auf {% data variables.product.product_name %} oder mit dem API verwalten. - -Um den Repository-Zugriff für jedes {% data variables.product.prodname_dotcom %}-Team zu verwalten, einschließlich Teams, die mit einer IdP-Gruppe verbunden sind, musst Du Änderungen auf {% data variables.product.product_name %} vornehmen. Weitere Informationen findest Du unter „[Informationen zu Teams](/articles/about-teams)“ und „[Teamzugriff auf ein Organisations-Repository verwalten](/articles/managing-team-access-to-an-organization-repository).“ - -Du kannst die Repositorys auswählen, auf die Deine Teammitglieder standardmäßig Zugriff haben sollen. Verbundene IdP-Gruppen werden automatisch Zugriff auf diese Repositorys haben. Weitere Informationen findest Du unter „[Den Zugriff eines Teams auf ein Repository einer Organisation verwalten](/articles/managing-team-access-to-an-organization-repository).“ - -Alle über den IdP vorgenommenen Änderungen an der Teammitgliedschaft werden im Auditprotokoll von {% data variables.product.product_name %} als Änderungen des Teamsynchronisierungs-Bots angezeigt. Dein IdP wird die Daten der Teammitgliedschaft einmal pro Stunde an {% data variables.product.prodname_dotcom %} senden. \ No newline at end of file diff --git a/translations/de-DE/data/reusables/marketplace/marketplace_RFP_deadline.md b/translations/de-DE/data/reusables/marketplace/marketplace_RFP_deadline.md deleted file mode 100644 index ea1f14d01ef4..000000000000 --- a/translations/de-DE/data/reusables/marketplace/marketplace_RFP_deadline.md +++ /dev/null @@ -1 +0,0 @@ -April 10 \ No newline at end of file diff --git a/translations/de-DE/data/reusables/marketplace/unverified-req.md b/translations/de-DE/data/reusables/marketplace/unverified-req.md deleted file mode 100644 index f7e6e688b552..000000000000 --- a/translations/de-DE/data/reusables/marketplace/unverified-req.md +++ /dev/null @@ -1 +0,0 @@ -Unverified apps do not need to meet the "[Requirements for listing an app on GitHub Marketplace](/marketplace/getting-started/requirements-for-listing-an-app-on-github-marketplace/)" or go through the "[Security review process](/marketplace/getting-started/security-review-process/)." \ No newline at end of file diff --git a/translations/de-DE/data/reusables/nested-teams/include-child-team-members.md b/translations/de-DE/data/reusables/nested-teams/include-child-team-members.md deleted file mode 100644 index 8516cd930109..000000000000 --- a/translations/de-DE/data/reusables/nested-teams/include-child-team-members.md +++ /dev/null @@ -1,5 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.20" %} -If you pass the `hellcat-preview` media type, team members will include the members of child teams. -{% else %} -Team members will include the members of child teams. -{% endif %} diff --git a/translations/de-DE/data/reusables/organizations/org-settings-repository-roles.md b/translations/de-DE/data/reusables/organizations/org-settings-repository-roles.md deleted file mode 100644 index f5e6c3cb09eb..000000000000 --- a/translations/de-DE/data/reusables/organizations/org-settings-repository-roles.md +++ /dev/null @@ -1 +0,0 @@ -4. In the left sidebar, click **Repository roles**. ![Repository roles tab in organization settings](/assets/images/help/organizations/org-settings-repository-roles.png) diff --git a/translations/de-DE/data/reusables/orgs/deprecating_creation_type.md b/translations/de-DE/data/reusables/orgs/deprecating_creation_type.md deleted file mode 100644 index c9c73333c352..000000000000 --- a/translations/de-DE/data/reusables/orgs/deprecating_creation_type.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -{% warning %} - -**Parameter Deprecation Notice:** {% data variables.product.prodname_dotcom %} will replace and discontinue `members_allowed_repository_creation_type` in favor of more granular permissions. The new input parameters are `members_can_create_public_repositories`, `members_can_create_private_repositories` for all organizations and `members_can_create_internal_repositories` for organizations associated with an enterprise account using {% data variables.product.prodname_ghe_cloud %} or {% data variables.product.prodname_ghe_server %} 2.20+. For more information, see the [blog post](https://developer.github.com/changes/2019-12-03-internal-visibility-changes). - -{% endwarning %} -{% endif %} diff --git a/translations/de-DE/data/reusables/orgs/internal_repos.md b/translations/de-DE/data/reusables/orgs/internal_repos.md deleted file mode 100644 index e432538b3738..000000000000 --- a/translations/de-DE/data/reusables/orgs/internal_repos.md +++ /dev/null @@ -1 +0,0 @@ -If your organization is associated with an enterprise account using {% data variables.product.prodname_ghe_cloud %} or {% data variables.product.prodname_ghe_server %} 2.20+, `visibility` can also be `internal`. \ No newline at end of file diff --git a/translations/de-DE/data/reusables/package_registry/about-spending-limits.md b/translations/de-DE/data/reusables/package_registry/about-spending-limits.md deleted file mode 100644 index 1b3d88f84968..000000000000 --- a/translations/de-DE/data/reusables/package_registry/about-spending-limits.md +++ /dev/null @@ -1 +0,0 @@ -Standardmäßig wird Dein Konto ein Ausgabenlimit von $0 für Ihre kombinierte Nutzung von {% data variables.product.prodname_registry %} und {% data variables.product.prodname_actions %} haben. Um Überschreitungen zuzulassen, kannst Du das Ausgabenlimit erhöhen oder unbegrenzte Ausgaben zulassen. diff --git a/translations/de-DE/data/reusables/package_registry/accessing-packages.md b/translations/de-DE/data/reusables/package_registry/accessing-packages.md deleted file mode 100644 index 6f29868c456d..000000000000 --- a/translations/de-DE/data/reusables/package_registry/accessing-packages.md +++ /dev/null @@ -1,4 +0,0 @@ -Du kannst über diese URL auf Ihre Pakete zugreifen, indem Du `OWNER` mit Deinem {% data variables.product.prodname_dotcom %} Benutzer- oder Organisations-Namen und `REPOSITORY` mit Deinem Repository-Namen ersetzt: - ``` - https://github.com/OWNER/REPOSITORY/packages - ``` diff --git a/translations/de-DE/data/reusables/package_registry/authenticate-to-container-registry.md b/translations/de-DE/data/reusables/package_registry/authenticate-to-container-registry.md deleted file mode 100644 index c5db7d7988a6..000000000000 --- a/translations/de-DE/data/reusables/package_registry/authenticate-to-container-registry.md +++ /dev/null @@ -1,18 +0,0 @@ -1. Create a new personal access token (PAT) with the appropriate scopes for the tasks you want to accomplish. If your organization requires SSO, you must enable SSO for your new token. - - Select the `read:packages` scope to download container images and read their metadata. - - Select the `write:packages` scope to download and upload container images and read and write their metadata. - - Select the `delete:packages` scope to delete container images. - - Weitere Informationen findest Du unter „[Ein persönliches Zugriffstoken für die Befehlszeile erstellen](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line).“ - -2. Save your PAT. We recommend saving your PAT as an environment variable. - ```shell - $ export CR_PAT=YOUR_TOKEN - ``` -3. Using the CLI for your container type, sign in to the {% data variables.product.prodname_github_container_registry %} service at `ghcr.io`. - {% raw %} - ```shell - $ echo $CR_PAT | docker login ghcr.io -u USERNAME --password-stdin - > Login Succeeded - ``` - {% endraw %} diff --git a/translations/de-DE/data/reusables/permissions/admin-access-org.md b/translations/de-DE/data/reusables/permissions/admin-access-org.md deleted file mode 100644 index b4f934126644..000000000000 --- a/translations/de-DE/data/reusables/permissions/admin-access-org.md +++ /dev/null @@ -1 +0,0 @@ -You must authenticate using an access token with the `admin:org` scope to use this endpoint. \ No newline at end of file diff --git a/translations/de-DE/data/reusables/permissions/admin-access.md b/translations/de-DE/data/reusables/permissions/admin-access.md deleted file mode 100644 index d35e7e24173c..000000000000 --- a/translations/de-DE/data/reusables/permissions/admin-access.md +++ /dev/null @@ -1 +0,0 @@ -You must authenticate using an access token with the `repo` scope to use this endpoint. \ No newline at end of file diff --git a/translations/de-DE/data/reusables/permissions/code-scanning-app-read-permissions.md b/translations/de-DE/data/reusables/permissions/code-scanning-app-read-permissions.md deleted file mode 100644 index cbee5c312771..000000000000 --- a/translations/de-DE/data/reusables/permissions/code-scanning-app-read-permissions.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_github_app %}s must have the `security_events` read permission to use this endpoint. \ No newline at end of file diff --git a/translations/de-DE/data/reusables/permissions/read-access.md b/translations/de-DE/data/reusables/permissions/read-access.md deleted file mode 100644 index cd27a2d076e2..000000000000 --- a/translations/de-DE/data/reusables/permissions/read-access.md +++ /dev/null @@ -1 +0,0 @@ -Anyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope. \ No newline at end of file diff --git a/translations/de-DE/data/reusables/permissions/security-events-scope.md b/translations/de-DE/data/reusables/permissions/security-events-scope.md deleted file mode 100644 index 814e0f8c92e8..000000000000 --- a/translations/de-DE/data/reusables/permissions/security-events-scope.md +++ /dev/null @@ -1 +0,0 @@ -You must use an access token with the `security_events` scope to use this endpoint. \ No newline at end of file diff --git a/translations/de-DE/data/reusables/permissions/write-access.md b/translations/de-DE/data/reusables/permissions/write-access.md deleted file mode 100644 index d35e7e24173c..000000000000 --- a/translations/de-DE/data/reusables/permissions/write-access.md +++ /dev/null @@ -1 +0,0 @@ -You must authenticate using an access token with the `repo` scope to use this endpoint. \ No newline at end of file diff --git a/translations/de-DE/data/reusables/pre-release-program/ant-man-preview-deployments.md b/translations/de-DE/data/reusables/pre-release-program/ant-man-preview-deployments.md deleted file mode 100644 index 24c3ac126d93..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/ant-man-preview-deployments.md +++ /dev/null @@ -1,11 +0,0 @@ -{% note %} - -**Note:** The `transient_environment` and `production_environment` parameters are currently available for developers to preview. During the preview period, the API may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-04-06-deployment-and-deployment-status-enhancements) for full details. - -To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.ant-man-preview+json -``` - -{% endnote %} diff --git a/translations/de-DE/data/reusables/pre-release-program/ant-man-preview-statuses.md b/translations/de-DE/data/reusables/pre-release-program/ant-man-preview-statuses.md deleted file mode 100644 index 2f8d44e20170..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/ant-man-preview-statuses.md +++ /dev/null @@ -1,11 +0,0 @@ -{% note %} - -**Note:** The `inactive` state and the `log_url`, `environment_url`, and `auto_inactive` parameters are currently available for developers to preview. Please see the [blog post](https://developer.github.com/changes/2016-04-06-deployment-and-deployment-status-enhancements) for full details. - -To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.ant-man-preview+json -``` - -{% endnote %} diff --git a/translations/de-DE/data/reusables/pre-release-program/antiope-preview.md b/translations/de-DE/data/reusables/pre-release-program/antiope-preview.md deleted file mode 100644 index 24ee4c574224..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/antiope-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The Checks API is currently available for developers to preview. During the preview period, the API may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2018-05-07-new-checks-api-public-beta/) for full details. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.antiope-preview+json -``` - -{% endnote %} diff --git a/translations/de-DE/data/reusables/pre-release-program/baptiste-keys-preview.md b/translations/de-DE/data/reusables/pre-release-program/baptiste-keys-preview.md deleted file mode 100644 index 1a309066ba06..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/baptiste-keys-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Note:** The `is_template` and `template_repository` keys are currently available for developer to preview. See [Create a repository using a template](/v3/repos/#create-a-repository-using-a-template) to learn how to create template repositories. To access these new response keys during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.baptiste-preview+json -``` - -{% endnote %} diff --git a/translations/de-DE/data/reusables/pre-release-program/baptiste-preview.md b/translations/de-DE/data/reusables/pre-release-program/baptiste-preview.md deleted file mode 100644 index 850b3f271bb4..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/baptiste-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Note:** Creating and using repository templates is currently available for developers to preview. To access this new endpoint during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.baptiste-preview+json -``` - -{% endnote %} diff --git a/translations/de-DE/data/reusables/pre-release-program/batman-preview.md b/translations/de-DE/data/reusables/pre-release-program/batman-preview.md deleted file mode 100644 index 079a5b57c932..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/batman-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -{% note %} - -**Note:** Using the {% data variables.product.prodname_component_kit %} API is currently available for developers to preview. To access these endpoints during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.batman-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/de-DE/data/reusables/pre-release-program/checks-public-beta.md b/translations/de-DE/data/reusables/pre-release-program/checks-public-beta.md deleted file mode 100644 index 9220bede6270..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/checks-public-beta.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Note:** The Checks API is currently in public beta and only available for use with GitHub Apps. - -{% endnote %} diff --git a/translations/de-DE/data/reusables/pre-release-program/cloak-preview.md b/translations/de-DE/data/reusables/pre-release-program/cloak-preview.md deleted file mode 100644 index ab6a54ac5f08..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/cloak-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The Commit Search API is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2017-01-05-commit-search-api/) for full details. - -To access the API you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.cloak-preview -``` -{% endnote %} diff --git a/translations/de-DE/data/reusables/pre-release-program/code-scanning-beta.md b/translations/de-DE/data/reusables/pre-release-program/code-scanning-beta.md deleted file mode 100644 index f9be785c151b..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/code-scanning-beta.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** {% data variables.product.prodname_code_scanning_capc %} for open source repositories and private repositories is currently in beta and subject to change. To sign up, see [Advanced Security beta](https://github.com/features/security/advanced-security/signup). - -{% endnote %} -{% endif %} diff --git a/translations/de-DE/data/reusables/pre-release-program/comfort-fade-preview.md b/translations/de-DE/data/reusables/pre-release-program/comfort-fade-preview.md deleted file mode 100644 index 17e2464a7d19..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/comfort-fade-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** Multi-line comments in a pull request diff is currently available for developers to preview. To access the new response fields during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.comfort-fade-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/de-DE/data/reusables/pre-release-program/doctor-strange-preview.md b/translations/de-DE/data/reusables/pre-release-program/doctor-strange-preview.md deleted file mode 100644 index 488fa5418a94..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/doctor-strange-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion == "enterprise-server@2.20" %} -{% note %} - -**Note:** New endpoints using OAuth tokens as input parameters instead of path parameters are available for developers to preview in the [OAuth Applications API](/v3/apps/oauth_applications/). To access these endpoints during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.doctor-strange-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/de-DE/data/reusables/pre-release-program/dorian-preview.md b/translations/de-DE/data/reusables/pre-release-program/dorian-preview.md deleted file mode 100644 index d4141e00a5ab..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/dorian-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Note:** Enabling and disabling dependency alerts for a repository using the REST API is currently available for developers to preview. To access these new endpoints during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.dorian-preview+json -``` - -{% endnote %} diff --git a/translations/de-DE/data/reusables/pre-release-program/drax-preview.md b/translations/de-DE/data/reusables/pre-release-program/drax-preview.md deleted file mode 100644 index 720c942e5f60..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/drax-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.13" %} -{% note %} - -**Note:** The [Licenses API](https://developer.github.com/changes/2015-03-09-licenses-api/) is currently available for developers to preview. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.drax-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/de-DE/data/reusables/pre-release-program/echo-preview.md b/translations/de-DE/data/reusables/pre-release-program/echo-preview.md deleted file mode 100644 index d6897f7f1d82..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/echo-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -{% note %} - -**Note:** The team discussions API is currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2018-02-07-team-discussions-api) for full details. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.echo-preview+json -``` -{% endnote %} -{% endif %} diff --git a/translations/de-DE/data/reusables/pre-release-program/flash-preview.md b/translations/de-DE/data/reusables/pre-release-program/flash-preview.md deleted file mode 100644 index b0b2485fab83..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/flash-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% note %} - -**Note:** New features in the Deployments API on {% data variables.product.product_name %} are currently available during a public beta. Please see the [blog post](https://developer.github.com/changes/2018-10-16-deployments-environments-states-and-auto-inactive-updates/) for full details. - -To access the new `environment` parameter, the two new values for the `state` parameter (`in_progress` and `queued`), and use `auto_inactive` on production deployments during the public beta period, you must provide the following custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.flash-preview+json -``` - -{% endnote %} diff --git a/translations/de-DE/data/reusables/pre-release-program/gambit-preview.md b/translations/de-DE/data/reusables/pre-release-program/gambit-preview.md deleted file mode 100644 index ae67b941174b..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/gambit-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.21" %} -{% note %} - -**Note:** Uninstalling {% data variables.product.prodname_github_app %}s and revoking an app's installation token are currently available for developers to preview. To access the new endpoint during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.gambit-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/de-DE/data/reusables/pre-release-program/giant-sentry-fist-pre-release.md b/translations/de-DE/data/reusables/pre-release-program/giant-sentry-fist-pre-release.md deleted file mode 100644 index 6ea06379025f..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/giant-sentry-fist-pre-release.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "2.8" %} -{% note %} - -**Note:** {% data variables.giant-sentry-fist.product_name_long %} on {% data variables.product.product_name %} is currently available for developers to preview. To access the API, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.giant-sentry-fist-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/de-DE/data/reusables/pre-release-program/github-actions-public-beta.md b/translations/de-DE/data/reusables/pre-release-program/github-actions-public-beta.md deleted file mode 100644 index f5a413149737..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/github-actions-public-beta.md +++ /dev/null @@ -1,11 +0,0 @@ -{% warning %} - -**New release:** {% data variables.product.prodname_actions %} is now available in a new limited public beta. This version offers a new workflow configuration and built-in continuous integration and continuous deployment capabilities. We strongly recommend you avoid using it for high-value workflows and content during this public beta period. To request to join the limited public beta, see the [GitHub Actions page](https://github.com/features/actions). For more information, see "[About GitHub Actions](/articles/about-github-actions)". - -GitHub Support will only provide support for the YAML syntax and no longer provides support for the HCL syntax. - -Wenn Sie an der öffentlichen Beta-Version mit eingeschränkten Funktionen teilgenommen und Workflows mit der HCL-Syntax in {% data variables.product.prodname_actions %} erstellt haben, müssen Sie ein Upgrade auf die neue öffentliche Beta-Version mit eingeschränkten Funktionen durchführen, in der die YAML-Syntax verwendet wird. Wenn Ihr Repository für ein Upgrade geeignet ist, wird eine Einladung im Repository angezeigt. Sie müssen die Einladung annehmen, bevor Sie die neue öffentliche Beta-Version mit eingeschränkten Funktionen nutzen können. - -Once you've upgraded, any workflows that you created with the HCL syntax will need to be updated to the new YAML syntax. To automatically convert your workflows, see "[Migrating {% data variables.product.prodname_actions %} from HCL syntax to YAML syntax](/articles/migrating-github-actions-from-hcl-syntax-to-yaml-syntax)". - -{% endwarning %} diff --git a/translations/de-DE/data/reusables/pre-release-program/github-components-public-beta.md b/translations/de-DE/data/reusables/pre-release-program/github-components-public-beta.md deleted file mode 100644 index 2c242acbc08b..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/github-components-public-beta.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -{% note %} - -**Note:** The {% data variables.product.prodname_component_kit %} API is currently in private beta and subject to change. - -{% endnote %} -{% endif %} diff --git a/translations/de-DE/data/reusables/pre-release-program/groot-preview.md b/translations/de-DE/data/reusables/pre-release-program/groot-preview.md deleted file mode 100644 index 944243de7c52..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/groot-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Note:** Listing branches or pull requests for a commit in the Commits API is currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2019-04-11-pulls-branches-for-commit/) for more details. To access the new endpoints during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.groot-preview+json -``` - -{% endnote %} diff --git a/translations/de-DE/data/reusables/pre-release-program/hagar-preview.md b/translations/de-DE/data/reusables/pre-release-program/hagar-preview.md deleted file mode 100644 index e1cf318f3cc3..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/hagar-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -{% note %} - -**Note:** You can now retrieve someone's hovercard information in different contexts using the Hovercard API. This feature is currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2018-03-21-hovercard-api-preview) for full details. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.hagar-preview+json -``` -{% endnote %} -{% endif %} diff --git a/translations/de-DE/data/reusables/pre-release-program/hellcat-preview.md b/translations/de-DE/data/reusables/pre-release-program/hellcat-preview.md deleted file mode 100644 index b2268faa5418..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/hellcat-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.20" %} -{% note %} - -**Note:** The Nested Teams API is currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2017-08-30-preview-nested-teams) for full details. To access the API, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.hellcat-preview+json -``` -{% endnote %} - -{% endif %} diff --git a/translations/de-DE/data/reusables/pre-release-program/inertia-preview.md b/translations/de-DE/data/reusables/pre-release-program/inertia-preview.md deleted file mode 100644 index c6641c35a95f..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/inertia-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The Projects API is currently available for developers to preview. During the preview period, the API may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-10-27-changes-to-projects-api) for full details. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.inertia-preview+json -``` - -{% endnote %} diff --git a/translations/de-DE/data/reusables/pre-release-program/london-preview.md b/translations/de-DE/data/reusables/pre-release-program/london-preview.md deleted file mode 100644 index 4fa608045abb..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/london-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** Enabling or disabling automated security fixes is currently available for developers to preview. To access this new endpoint during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.london-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/de-DE/data/reusables/pre-release-program/luke-cage-preview.md b/translations/de-DE/data/reusables/pre-release-program/luke-cage-preview.md deleted file mode 100644 index a4a7cfe32bbb..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/luke-cage-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The Protected Branches API now has a setting for requiring a specified number of approving pull request reviews before merging. This feature is currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2018-03-16-protected-branches-required-approving-reviews) for full details. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.luke-cage-preview+json -``` - -{% endnote %} diff --git a/translations/de-DE/data/reusables/pre-release-program/lydian-preview.md b/translations/de-DE/data/reusables/pre-release-program/lydian-preview.md deleted file mode 100644 index fa5a34527bea..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/lydian-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Note:** Updating the pull request branch with latest upstream changes is currently available for developers to preview. To access this new endpoint during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.lydian-preview+json -``` - -{% endnote %} diff --git a/translations/de-DE/data/reusables/pre-release-program/mercy-pre-release-replace.md b/translations/de-DE/data/reusables/pre-release-program/mercy-pre-release-replace.md deleted file mode 100644 index c49f66c4dba1..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/mercy-pre-release-replace.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** Repository topics on {% data variables.product.product_name %} are currently available for developers to preview. To use this endpoint, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.mercy-preview+json -``` - -{% endnote %} diff --git a/translations/de-DE/data/reusables/pre-release-program/mercy-pre-release.md b/translations/de-DE/data/reusables/pre-release-program/mercy-pre-release.md deleted file mode 100644 index fa26dc8969ed..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/mercy-pre-release.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** {% data variables.mercy.product_name_long %} on {% data variables.product.product_name %} is currently available for developers to preview. To view the `topics` property in calls that return repository results, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.mercy-preview+json -``` - -{% endnote %} diff --git a/translations/de-DE/data/reusables/pre-release-program/mister-fantastic-pre-release.md b/translations/de-DE/data/reusables/pre-release-program/mister-fantastic-pre-release.md deleted file mode 100644 index 4918b1477ee0..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/mister-fantastic-pre-release.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -{% note %} - -**Note:** {% data variables.mister-fantastic.product_name_long %} contains two additional fields in responses, which developers can preview: `html_url` and `source`. To see these two new fields, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.mister-fantastic-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/de-DE/data/reusables/pre-release-program/mockingbird-preview.md b/translations/de-DE/data/reusables/pre-release-program/mockingbird-preview.md deleted file mode 100644 index 6ad3a875e33a..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/mockingbird-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The API to get issue timeline events is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2016-05-23-timeline-preview-api/) for full details. To access the API you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.mockingbird-preview -``` - -{% endnote %} diff --git a/translations/de-DE/data/reusables/pre-release-program/multi-line-comments-public-beta.md b/translations/de-DE/data/reusables/pre-release-program/multi-line-comments-public-beta.md deleted file mode 100644 index 5aeea167477b..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/multi-line-comments-public-beta.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** Multi-line comments on pull requests are currently in public beta and subject to change. - -{% endnote %} -{% endif %} diff --git a/translations/de-DE/data/reusables/pre-release-program/nebula-preview.md b/translations/de-DE/data/reusables/pre-release-program/nebula-preview.md deleted file mode 100644 index d2ef0fb00908..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/nebula-preview.md +++ /dev/null @@ -1,14 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} - -{% note %} - -**Note:** You can set the visibility of a repository using the new `visibility` parameter in the [Repositories API](/v3/repos/), and get a repository's visibility with a new response key. For more information, see the [blog post](https://developer.github.com/changes/2019-12-03-internal-visibility-changes/). - -To access repository visibility during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.nebula-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/de-DE/data/reusables/pre-release-program/nightshade-preview.md b/translations/de-DE/data/reusables/pre-release-program/nightshade-preview.md deleted file mode 100644 index 22172eba6443..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/nightshade-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.20" %} -{% note %} - -**Note:** The [Repository Transfer API](https://developer.github.com/changes/2017-11-09-repository-transfer-api-preview) is currently available for developers to preview. To access the API, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.nightshade-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/de-DE/data/reusables/pre-release-program/org-self-hosted-runner-beta.md b/translations/de-DE/data/reusables/pre-release-program/org-self-hosted-runner-beta.md deleted file mode 100644 index 14ca625d132f..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/org-self-hosted-runner-beta.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% warning %} - -**Warning:** The self-hosted runners API for organizations is currently in public beta and subject to change. - -{% endwarning %} -{% endif %} diff --git a/translations/de-DE/data/reusables/pre-release-program/performed-by-integration-deployment.md b/translations/de-DE/data/reusables/pre-release-program/performed-by-integration-deployment.md deleted file mode 100644 index 6a888df13e51..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/performed-by-integration-deployment.md +++ /dev/null @@ -1,13 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** If a deployment is created via a {% data variables.product.prodname_github_app %}, the response will include the `performed_via_github_app` object with information about the {% data variables.product.prodname_github_app %}. For more information, see the [related blog post](https://developer.github.com/changes/2016-09-14-Integrations-Early-Access). - -To receive the `performed_via_github_app` object in the response, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.machine-man-preview -``` - -{% endnote %} -{% endif %} diff --git a/translations/de-DE/data/reusables/pre-release-program/performed-by-integration-issue-comment.md b/translations/de-DE/data/reusables/pre-release-program/performed-by-integration-issue-comment.md deleted file mode 100644 index ad67d849dd85..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/performed-by-integration-issue-comment.md +++ /dev/null @@ -1,13 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** If an issue comment is created via a {% data variables.product.prodname_github_app %}, the response will include the `performed_via_github_app` object with information about the {% data variables.product.prodname_github_app %}. For more information, see the [related blog post](https://developer.github.com/changes/2016-09-14-Integrations-Early-Access). - -To receive the `performed_via_github_app` object in the response, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.machine-man-preview -``` - -{% endnote %} -{% endif %} diff --git a/translations/de-DE/data/reusables/pre-release-program/performed-by-integration-issue-event.md b/translations/de-DE/data/reusables/pre-release-program/performed-by-integration-issue-event.md deleted file mode 100644 index 54e004859064..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/performed-by-integration-issue-event.md +++ /dev/null @@ -1,13 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** If an issue event is created via a {% data variables.product.prodname_github_app %}, the response will include the `performed_via_github_app` object with information about the {% data variables.product.prodname_github_app %}. For more information, see the [related blog post](https://developer.github.com/changes/2016-09-14-Integrations-Early-Access). - -To receive the `performed_via_github_app` object in the response, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.machine-man-preview -``` - -{% endnote %} -{% endif %} diff --git a/translations/de-DE/data/reusables/pre-release-program/performed-by-integration-issue.md b/translations/de-DE/data/reusables/pre-release-program/performed-by-integration-issue.md deleted file mode 100644 index ee0240792f4a..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/performed-by-integration-issue.md +++ /dev/null @@ -1,13 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** If an issue is opened via a {% data variables.product.prodname_github_app %}, the response will include the `performed_via_github_app` object with information about the {% data variables.product.prodname_github_app %}. For more information, see the [related blog post](https://developer.github.com/changes/2016-09-14-Integrations-Early-Access). - -To receive the `performed_via_github_app` object in the response, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.machine-man-preview -``` - -{% endnote %} -{% endif %} diff --git a/translations/de-DE/data/reusables/pre-release-program/scarlet-witch-key-preview.md b/translations/de-DE/data/reusables/pre-release-program/scarlet-witch-key-preview.md deleted file mode 100644 index a82019b82319..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/scarlet-witch-key-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** Developers can preview a new `code_of_conduct` key in responses. For more information, see [Codes of Conduct API](/v3/codes_of_conduct/). - -To access this new response key during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.scarlet-witch-preview+json -``` -{% endnote %} diff --git a/translations/de-DE/data/reusables/pre-release-program/scarlet-witch-preview.md b/translations/de-DE/data/reusables/pre-release-program/scarlet-witch-preview.md deleted file mode 100644 index 860b30d517dc..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/scarlet-witch-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The Codes of Conduct API is currently available for developers to preview. - -To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.scarlet-witch-preview+json -``` -{% endnote %} diff --git a/translations/de-DE/data/reusables/pre-release-program/shadow-cat-preview.md b/translations/de-DE/data/reusables/pre-release-program/shadow-cat-preview.md deleted file mode 100644 index 3d95ab9ccae5..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/shadow-cat-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.21" %} -{% note %} - -**Note:** The Draft Pull Request API is currently available for developers to preview. You can use this API to create a draft pull request or see whether a pull request is in draft state. See the [blog post](https://developer.github.com/changes/2019-02-14-draft-pull-requests) preview for more details. To access the new `draft` parameter during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.shadow-cat-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/de-DE/data/reusables/pre-release-program/sombra-preview.md b/translations/de-DE/data/reusables/pre-release-program/sombra-preview.md deleted file mode 100644 index 9298dfa844f5..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/sombra-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** The Interactions API is currently in public preview. See the [blog post](https://developer.github.com/changes/2018-12-18-interactions-preview) preview for more details. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.sombra-preview -``` - -{% endnote %} -{% endif %} diff --git a/translations/de-DE/data/reusables/pre-release-program/squirrel-girl-preview.md b/translations/de-DE/data/reusables/pre-release-program/squirrel-girl-preview.md deleted file mode 100644 index 52bd9558fc3b..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/squirrel-girl-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Note:** APIs for managing reactions are currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - - ``` - application/vnd.github.squirrel-girl-preview+json - ``` - {% endnote %} diff --git a/translations/de-DE/data/reusables/pre-release-program/squirrel-girl-response-preview.md b/translations/de-DE/data/reusables/pre-release-program/squirrel-girl-response-preview.md deleted file mode 100644 index 18d162292a2d..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/squirrel-girl-response-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The [reactions API](/v3/reactions/) is available for developers to preview. The `url` can be used to construct the API location for [listing and creating](/v3/reactions) reactions. See the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details. To receive the `reactions` object in the response for this endpoint you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.squirrel-girl-preview -``` - -{% endnote %} diff --git a/translations/de-DE/data/reusables/pre-release-program/superpro-preview.md b/translations/de-DE/data/reusables/pre-release-program/superpro-preview.md deleted file mode 100644 index f0878ed234c6..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/superpro-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The [Global Webhooks API](/rest/reference/enterprise-admin#global-webhooks) is currently available for developers to preview. To access the API during the preview period, you must provide a custom [media type](/rest/overview/media-types) in the `Accept` header: - -``` -application/vnd.github.superpro-preview+json -``` - -{% endnote %} diff --git a/translations/de-DE/data/reusables/pre-release-program/surtur-preview.md b/translations/de-DE/data/reusables/pre-release-program/surtur-preview.md deleted file mode 100644 index 9cfdfe8ad8dc..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/surtur-preview.md +++ /dev/null @@ -1,21 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -{% note %} - -**Note:** New repository creation permissions are available to preview. You can now use `members_can_create_public_repositories`, `members_can_create_private_repositories`, and `members_can_create_internal_repositories`. You can only allow members to create internal repositories if your organization is associated with an enterprise account using {% data variables.product.prodname_ghe_cloud %} or {% data variables.product.prodname_ghe_server %} 2.20+. These parameters provide more granular permissions to configure the type of repositories organization members can create. - -To access these new parameters during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.surtur-preview+json -``` -{% endnote %} -{% else %} -{% note %} - -**Note:** New repository creation permissions are available to preview. You can now set the `members_allowed_repository_creation_type` parameter to configure whether organization members can create repositories and the type of repositories they can create. - -To access this new parameter during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.surtur-preview+json -``` -{% endnote %} -{% endif %} diff --git a/translations/de-DE/data/reusables/pre-release-program/switcheroo-preview.md b/translations/de-DE/data/reusables/pre-release-program/switcheroo-preview.md deleted file mode 100644 index fbbbe3817bd9..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/switcheroo-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Note:** Enabling and disabling Pages in the Pages API is currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2019-03-14-enabling-disabling-pages/) preview for more details. To access the new endpoints during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.switcheroo-preview+json -``` - -{% endnote %} diff --git a/translations/de-DE/data/reusables/pre-release-program/symmetra-preview.md b/translations/de-DE/data/reusables/pre-release-program/symmetra-preview.md deleted file mode 100644 index c578f33898be..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/symmetra-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% if currentVersion != ‘dotcom’ and currentVersion ver_lt "enterprise-server@2.20" %} -{% note %} - -**Note:** You can add or edit descriptions in labels. See the [blog post](https://developer.github.com/changes/2018-02-22-label-description-search-preview) for full details. To access this feature during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.symmetra-preview+json -``` -{% endnote %} -{% endif %} diff --git a/translations/de-DE/data/reusables/pre-release-program/thor-pre-release.md b/translations/de-DE/data/reusables/pre-release-program/thor-pre-release.md deleted file mode 100644 index e034ce622e48..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/thor-pre-release.md +++ /dev/null @@ -1,13 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.13" %} -{% note %} - -**Note:** Team-based review requests in the Review Requests API on {% data variables.product.product_name %} are currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2017-07-26-team-review-request-thor-preview) for full details. - -To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.thor-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/de-DE/data/reusables/pre-release-program/usage-api-beta.md b/translations/de-DE/data/reusables/pre-release-program/usage-api-beta.md deleted file mode 100644 index 0fb7989fc11c..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/usage-api-beta.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% warning %} - -**Warning:** This {% data variables.product.prodname_actions %} usage endpoint is currently in public beta and subject to change. For more information, see "[GitHub Actions API workflow usage](https://developer.github.com/changes/2020-05-15-actions-api-workflow-usage)." - -{% endwarning %} -{% endif %} diff --git a/translations/de-DE/data/reusables/pre-release-program/wyandotte-preview.md b/translations/de-DE/data/reusables/pre-release-program/wyandotte-preview.md deleted file mode 100644 index 2d5c90f982c3..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/wyandotte-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** To access the Migrations API, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.wyandotte-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/de-DE/data/reusables/pre-release-program/x-ray-preview.md b/translations/de-DE/data/reusables/pre-release-program/x-ray-preview.md deleted file mode 100644 index c09b481483ca..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/x-ray-preview.md +++ /dev/null @@ -1,13 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" %} -{% note %} - -**Note:** When a GitHub Enterprise instance is in private mode, site and repository administrators can enable anonymous Git access for a public repository. This feature is currently available for developers to preview. See the [blog post](https://blog.github.com/2018-07-12-introducing-enterprise-2-14/) for full details. - -To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.x-ray-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/de-DE/data/reusables/pre-release-program/zzzax-preview.md b/translations/de-DE/data/reusables/pre-release-program/zzzax-preview.md deleted file mode 100644 index 1614b2e1532d..000000000000 --- a/translations/de-DE/data/reusables/pre-release-program/zzzax-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.12" %} -{% note %} - -**Note:** Protected Branches API can now manage a setting for requiring signed commits. This feature is currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2018-02-22-protected-branches-required-signatures) for full details. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.zzzax-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/de-DE/data/reusables/pulls/diff_location.md b/translations/de-DE/data/reusables/pulls/diff_location.md deleted file mode 100644 index b39b5e3f0697..000000000000 --- a/translations/de-DE/data/reusables/pulls/diff_location.md +++ /dev/null @@ -1,7 +0,0 @@ -{% note %} - -**Note:** To comment on a specific line in a file, you need to first determine the _position_ of that line in the diff. The GitHub REST API offers the `application/vnd.github.v3.diff` [media type](/v3/media/#commits-commit-comparison-and-pull-requests). To see a pull request diff, add this media type to the `Accept` header of a call to the [single pull request](/v3/pulls/#get-a-pull-request) endpoint. - -The `position` value equals the number of lines down from the first "@@" hunk header in the file you want to add a comment. The line just below the "@@" line is position 1, the next line is position 2, and so on. The position in the diff continues to increase through lines of whitespace and additional hunks until the beginning of a new file. - -{% endnote %} diff --git a/translations/de-DE/data/reusables/pulls/multiline_comments_summary_for_responses.md b/translations/de-DE/data/reusables/pulls/multiline_comments_summary_for_responses.md deleted file mode 100644 index 4255e9ce0a63..000000000000 --- a/translations/de-DE/data/reusables/pulls/multiline_comments_summary_for_responses.md +++ /dev/null @@ -1,21 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} - -##### Multi-line comment summary - -{% note %} - -**Note:** New parameters and response fields are available for developers to preview. During the preview period, these response fields may change without advance notice. Please see the [blog post](https://developer.github.com/changes/2019-10-03-multi-line-comments) for full details. - -{% endnote %} - -Use the `comfort-fade` preview header and the `line` parameter to show multi-line comment-supported fields in the response. - -If you use the `comfort-fade` preview header, your response will show: -- For multi-line comments, values for `start_line`, `original_start_line`, `start_side`, `line`, `original_line`, and `side`. -- For single-line comments, values for `line`, `original_line`, and `side` and a `null` value for `start_line`, `original_start_line`, and `start_side`. - -If you don't use the `comfort-fade` preview header, multi-line and single-line comments will appear the same way in the response with a single `position` attribute. Your response will show: -- For multi-line comments, the last line of the comment range for the `position` attribute. -- For single-line comments, the diff-positioned way of referencing comments for the `position` attribute. For more information, see `position` in the [input parameters](/v3/pulls/comments/#parameters-2) table. - -{% endif %} diff --git a/translations/de-DE/data/reusables/pulls/pull_request_access.md b/translations/de-DE/data/reusables/pulls/pull_request_access.md deleted file mode 100644 index 932bf1e5e5e3..000000000000 --- a/translations/de-DE/data/reusables/pulls/pull_request_access.md +++ /dev/null @@ -1,5 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} - -To open or update a pull request in a public repository, you must have write access to the head or the source branch. For organization-owned repositories, you must be a member of the organization that owns the repository to open or update a pull request. - -{% endif %} diff --git a/translations/de-DE/data/reusables/pulls/pull_request_mergeability.md b/translations/de-DE/data/reusables/pulls/pull_request_mergeability.md deleted file mode 100644 index 20d5d12edc94..000000000000 --- a/translations/de-DE/data/reusables/pulls/pull_request_mergeability.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Note:** You need to explicitly [request a pull request](/v3/pulls/#get-a-pull-request) to trigger a test merge commit, which checks the mergeability of pull requests. For more information, see "[Checking mergeability of pull requests](/v3/git/#checking-mergeability-of-pull-requests)". - -{% endnote %} diff --git a/translations/de-DE/data/reusables/pulls/pullrequests_as_issues.md b/translations/de-DE/data/reusables/pulls/pullrequests_as_issues.md deleted file mode 100644 index 0505ebbeb128..000000000000 --- a/translations/de-DE/data/reusables/pulls/pullrequests_as_issues.md +++ /dev/null @@ -1,7 +0,0 @@ -{% note %} - -**Note**: GitHub's REST API considers every pull request an issue, but not every issue is a pull request. For this reason, "Issues" endpoints may return both issues and pull requests in the response. You can identify pull requests by the `pull_request` key. - -Be aware that the `id` of a pull request returned from "Issues" endpoints will be an _issue id_. To find out the pull request id, use the "[List pull requests](/v3/pulls/#list-pull-requests)" endpoint. - -{% endnote %} diff --git a/translations/de-DE/data/reusables/reminders/install-slack.md b/translations/de-DE/data/reusables/reminders/install-slack.md deleted file mode 100644 index 60c297d6e238..000000000000 --- a/translations/de-DE/data/reusables/reminders/install-slack.md +++ /dev/null @@ -1 +0,0 @@ -Wenn Du Slack auf all Deinen Repositorys installieren möchtest, wähle **All repositories** (Alle Repositorys). Wenn Du Slack nur auf ausgewählten Repositories installieren möchtest, wähle **Only select repositories** (Nur Repositories auswählen). Lies dann die Liste der Berechtigungen, für die Du Slack Zugriff erlaubst und klicke auf **Install** (Installieren). ![Schaltfläche „Install Slack" (Slack installieren)](/assets/images/help/settings/scheduled-reminders-install-slack.png) diff --git a/translations/de-DE/data/reusables/reminders/scheduled-reminders-beta.md b/translations/de-DE/data/reusables/reminders/scheduled-reminders-beta.md deleted file mode 100644 index c189199d4252..000000000000 --- a/translations/de-DE/data/reusables/reminders/scheduled-reminders-beta.md +++ /dev/null @@ -1 +0,0 @@ -Geplante Erinnerungen für Pull Requests befinden sich derzeit in der Beta-Version und können jederzeit geändert werden. Um Zugriff auf die nächste Beta-Version für geplante Erinnerungen anzufordern, trittst Du der Warteliste unter [GitHub Scheduled Reminders](https://github.com/features/reminders/signup) (GitHub Geplante Erinnerungen) bei. diff --git a/translations/de-DE/data/reusables/repositories/actions-new-workflow.md b/translations/de-DE/data/reusables/repositories/actions-new-workflow.md deleted file mode 100644 index 9fbf946acd50..000000000000 --- a/translations/de-DE/data/reusables/repositories/actions-new-workflow.md +++ /dev/null @@ -1,2 +0,0 @@ -1. Klicke in der oberen linken Ecke auf **New workflow** (Neuer Workflow). ![Erstelle einen neuen Workflow](/assets/images/help/repository/actions-new-workflow.png) - \ No newline at end of file diff --git a/translations/de-DE/data/reusables/repositories/actions-set-up-workflow-template.md b/translations/de-DE/data/reusables/repositories/actions-set-up-workflow-template.md deleted file mode 100644 index 7c2fa99dc467..000000000000 --- a/translations/de-DE/data/reusables/repositories/actions-set-up-workflow-template.md +++ /dev/null @@ -1 +0,0 @@ -1. Klicke unter dem Namen der zu verwendenden Vorlage auf **Set up this workflow** (Workflow einrichten). ![Empfehlungen für Node.js-Vorlage](/assets/images/help/repository/actions-recommended-workflow-template.png) diff --git a/translations/de-DE/data/reusables/repositories/opt-out-automated-security-updates.md b/translations/de-DE/data/reusables/repositories/opt-out-automated-security-updates.md deleted file mode 100644 index a697b0dfb720..000000000000 --- a/translations/de-DE/data/reusables/repositories/opt-out-automated-security-updates.md +++ /dev/null @@ -1,2 +0,0 @@ -1. Aktiviere oder deaktiviere unter „Automated security updates" (Automatische Sicherheitsaktualisierungen) die Option **Opt out of automated security updates** (auf automatische Sicherheitsaktualisierungen verzichten). ![Kontrollkästchen für den Verzicht auf automatische Sicherheitsaktualisierungen](/assets/images/help/repository/opt-out-automated-security-updates.png) -2. Klicke auf **Save** (Speichern). diff --git a/translations/de-DE/data/reusables/repositories/opt-out-dependabot-security-updates.md b/translations/de-DE/data/reusables/repositories/opt-out-dependabot-security-updates.md deleted file mode 100644 index 3a68c3c20731..000000000000 --- a/translations/de-DE/data/reusables/repositories/opt-out-dependabot-security-updates.md +++ /dev/null @@ -1 +0,0 @@ -1. To the right of "{% data variables.product.prodname_dependabot_short %} security updates", click **Disable all** or **Enable all**. !["Disable all" or "Enable all" button for {% data variables.product.prodname_dependabot_short %} security updates](/assets/images/help/repository/opt-out-dependabot-security-updates.png) diff --git a/translations/de-DE/data/reusables/repositories/settings-security-and-analysis-tab-beta.md b/translations/de-DE/data/reusables/repositories/settings-security-and-analysis-tab-beta.md deleted file mode 100644 index 8b82316db94a..000000000000 --- a/translations/de-DE/data/reusables/repositories/settings-security-and-analysis-tab-beta.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Hinweis**: Die neue Erfahrung für die Verwaltung von Sicherheits- und Analyseeinstellungen befindet sich in der Beta-Phase und kann jederzeit geändert werden. - -{% endnote %} diff --git a/translations/de-DE/data/reusables/repositories/sidebar-integrations-and-services.md b/translations/de-DE/data/reusables/repositories/sidebar-integrations-and-services.md deleted file mode 100644 index 681eafb22a07..000000000000 --- a/translations/de-DE/data/reusables/repositories/sidebar-integrations-and-services.md +++ /dev/null @@ -1 +0,0 @@ -1. Klicke auf **Integrations & Services** (Integrationen und Dienstleistungen). ![Auswahl „Integrations and services" (Integrationen und Dienstleistungen)](/assets/images/help/settings/integrations_and_services_menu.png) diff --git a/translations/de-DE/data/reusables/repositories/troubleshooting-dependency-graph.md b/translations/de-DE/data/reusables/repositories/troubleshooting-dependency-graph.md deleted file mode 100644 index 7afc2ddb1b0b..000000000000 --- a/translations/de-DE/data/reusables/repositories/troubleshooting-dependency-graph.md +++ /dev/null @@ -1 +0,0 @@ -Wenn Dein Projekt Abhängigkeiten hat, aber keine Abhängigkeiten in Deinem Diagramm entdeckt werden, kann es ein Problem mit der Datei sein, die Deine Abhängigkeiten enthält. Überprüfe Deine Projektdatei, um sicherzustellen, dass sie für diesen Dateityp korrekt formatiert ist. diff --git a/translations/de-DE/data/reusables/repositories/you-can-enable-or-disable-security-features.md b/translations/de-DE/data/reusables/repositories/you-can-enable-or-disable-security-features.md deleted file mode 100644 index ce70639e21b6..000000000000 --- a/translations/de-DE/data/reusables/repositories/you-can-enable-or-disable-security-features.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Note**: The code scanning and secret scanning beta includes a new experience for managing security and analysis settings. If you're participating in the beta, skip the following steps and see "[Managing security and analysis settings for your repository](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository)." - -{% endnote %} diff --git a/translations/de-DE/data/reusables/repositories/you-can-manage-access-to-security-alerts.md b/translations/de-DE/data/reusables/repositories/you-can-manage-access-to-security-alerts.md deleted file mode 100644 index bbacc95cf1bf..000000000000 --- a/translations/de-DE/data/reusables/repositories/you-can-manage-access-to-security-alerts.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Hinweis:**Die Betaversionen von 'code scanning' (Scannen von Code) und 'secret scanning' (Durchsuchen nach Geheimnissen) bieten eine neue Erfahrung für die Verwaltung von Personen und Teams mit Zugriff auf die Sicherheitswarnungen. Wenn Du an der Beta-Phase teilnimmst, überspringe die folgenden Schritte und finde weitere Informationen auf „[Sicherheits- und Analyseeinstellungen für Dein Repository verwalten](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository#granting-access-to-github-dependabot-alerts)." - -{% endnote %} diff --git a/translations/de-DE/data/reusables/saml/scim-unavailable-for-enterprise-accounts.md b/translations/de-DE/data/reusables/saml/scim-unavailable-for-enterprise-accounts.md deleted file mode 100644 index 9163c78a2872..000000000000 --- a/translations/de-DE/data/reusables/saml/scim-unavailable-for-enterprise-accounts.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Notiz**: SCIM-Unterstützung ist derzeit für Enterprise-Konten auf {% data variables.product.prodname_dotcom %} nicht verfügbar. - -{% endnote %} diff --git a/translations/de-DE/data/reusables/scim/complete_user_example.md b/translations/de-DE/data/reusables/scim/complete_user_example.md deleted file mode 100644 index e444e167ecc8..000000000000 --- a/translations/de-DE/data/reusables/scim/complete_user_example.md +++ /dev/null @@ -1,7 +0,0 @@ -<%= json \ "schemas":["urn:ietf:params:scim:schemas:core:2.0:User"], "userName":"mona.octocat@okta.example.com", "name":{ "familyName":"Octocat", "givenName":"Mona" }, "emails":[ - { - "value":"mona.octocat@okta.example.com", - "type":"work", - "primary": true - } - ] %> diff --git a/translations/de-DE/data/reusables/scim/user_required_values.md b/translations/de-DE/data/reusables/scim/user_required_values.md deleted file mode 100644 index 51c40e6da7df..000000000000 --- a/translations/de-DE/data/reusables/scim/user_required_values.md +++ /dev/null @@ -1 +0,0 @@ -As shown in the following example, you must at least provide the required values for the user: `userName`, `name`, and `emails`. diff --git a/translations/de-DE/data/reusables/search/exact-match-beta.md b/translations/de-DE/data/reusables/search/exact-match-beta.md deleted file mode 100644 index 6034a1ee9553..000000000000 --- a/translations/de-DE/data/reusables/search/exact-match-beta.md +++ /dev/null @@ -1 +0,0 @@ -Genaue Übereinstimmung in der Code-Suche ist für eine begrenzte Anzahl von Benutzern und Repositorys auf {% data variables.product.prodname_dotcom %} in der Beta-Version verfügbar und kann sich jederzeit ändern. diff --git a/translations/de-DE/data/reusables/search/exact-match.md b/translations/de-DE/data/reusables/search/exact-match.md deleted file mode 100644 index f279d5c21196..000000000000 --- a/translations/de-DE/data/reusables/search/exact-match.md +++ /dev/null @@ -1 +0,0 @@ -Du kannst Code nach genauen Übereinstimmungen durchsuchen, welche eine beliebige Kombination aus Buchstaben, Zahlen und Symbolen enthalten. diff --git a/translations/de-DE/data/reusables/shortdesc/2fa.md b/translations/de-DE/data/reusables/shortdesc/2fa.md deleted file mode 100644 index dc66b8be6501..000000000000 --- a/translations/de-DE/data/reusables/shortdesc/2fa.md +++ /dev/null @@ -1 +0,0 @@ -If you have two-factor authentication setup, Basic Authentication for this endpoint requires that you use a one-time password (OTP) and your username and password instead of tokens. For more information, see "[Working with two-factor authentication](/v3/auth/#working-with-two-factor-authentication)." \ No newline at end of file diff --git a/translations/de-DE/data/reusables/shortdesc/content_reference_body.md b/translations/de-DE/data/reusables/shortdesc/content_reference_body.md deleted file mode 100644 index 4b89190d30bf..000000000000 --- a/translations/de-DE/data/reusables/shortdesc/content_reference_body.md +++ /dev/null @@ -1 +0,0 @@ -You have used an email that already exists for the user_email_uniq field.\n \## DETAILS:\n\nThe (email)=(Octocat@github.com) already exists.\n\n The error was found in core/models.py in get_or_create_user at line 62.\n\n\ self.save() \ No newline at end of file diff --git a/translations/de-DE/data/reusables/shortdesc/content_reference_title.md b/translations/de-DE/data/reusables/shortdesc/content_reference_title.md deleted file mode 100644 index 531d7aabf6de..000000000000 --- a/translations/de-DE/data/reusables/shortdesc/content_reference_title.md +++ /dev/null @@ -1 +0,0 @@ -[A-1234] Error found in core/models.py file \ No newline at end of file diff --git a/translations/de-DE/data/reusables/sponsors/email-submit-bank-info.md b/translations/de-DE/data/reusables/sponsors/email-submit-bank-info.md deleted file mode 100644 index bd7c01283337..000000000000 --- a/translations/de-DE/data/reusables/sponsors/email-submit-bank-info.md +++ /dev/null @@ -1 +0,0 @@ -Nachdem Du {% data variables.product.prodname_sponsors %} beigetreten bist, erhältst Du eine E-Mail mit Anleitungen zum Einreichen Deiner Bank- und Steuerdaten. diff --git a/translations/de-DE/data/reusables/sponsors/matching-period.md b/translations/de-DE/data/reusables/sponsors/matching-period.md deleted file mode 100644 index d41a5a262b2a..000000000000 --- a/translations/de-DE/data/reusables/sponsors/matching-period.md +++ /dev/null @@ -1 +0,0 @@ -Sponsoring kann für Verdoppelung berechtigt sein, innerhalb der hier genannten Einschränkungen für das erste Jahr, in dem eine Einzelperson Teilnehmer bei {% data variables.product.prodname_sponsors %} ist. Die Berechtigung zur Verdoppelung beginnt nachdem {% data variables.product.company_short %} ein Konto zu {% data variables.product.prodname_sponsors %} zugelassen hat, welche das Sponsoring-Profil für das Konto veröffentlicht. Der Verdoppelungszeitraum kann aus keinem Grund verlängert werden. Wenn Du {% data variables.product.prodname_sponsors %} verlässt und später wieder beitrittst, kann die Zeit zwischen den beiden Teilnahmeperioden an den Verdoppelungszeitraum angerechnet werden und der Verdoppelungszeitraum kann auslaufen. diff --git a/translations/de-DE/data/reusables/sponsors/org-sponsorship-dashboard.md b/translations/de-DE/data/reusables/sponsors/org-sponsorship-dashboard.md deleted file mode 100644 index eb3aed2a9fae..000000000000 --- a/translations/de-DE/data/reusables/sponsors/org-sponsorship-dashboard.md +++ /dev/null @@ -1 +0,0 @@ -1. Klicke rechts neben Deiner Organisation auf **Sponsorship dashboard** (Sponsoring-Dashboard). ![Schaltfläche „Sponsorship dashboard" (Sponsoring-Dashboard)](/assets/images/help/sponsors/org-sponsorship-dashboard.png) diff --git a/translations/de-DE/data/reusables/support/advanced-security-support-terms-differ.md b/translations/de-DE/data/reusables/support/advanced-security-support-terms-differ.md deleted file mode 100644 index d722226dd5d5..000000000000 --- a/translations/de-DE/data/reusables/support/advanced-security-support-terms-differ.md +++ /dev/null @@ -1 +0,0 @@ -Die Bedingungen dieses Artikels gelten nicht für die Unterstützung für {% data variables.product.prodname_advanced_security %}. Weitere Informationen findest Du unter „[Unterstützung für {% data variables.product.prodname_advanced_security %}](/enterprise/admin/enterprise-support/about-support-for-advanced-security)." diff --git a/translations/de-DE/data/reusables/support/ghec-premium-priority-high-description.md b/translations/de-DE/data/reusables/support/ghec-premium-priority-high-description.md deleted file mode 100644 index 4046ceacdfaa..000000000000 --- a/translations/de-DE/data/reusables/support/ghec-premium-priority-high-description.md +++ /dev/null @@ -1 +0,0 @@ -Konten- oder Sicherheitsprobleme mit Deiner Organisation oder Deinem Unternehmen auf {% data variables.product.prodname_ghe_cloud %} haben nur begrenzte Auswirkungen auf Dein Unternehmen. \ No newline at end of file diff --git a/translations/de-DE/data/reusables/support/ghec-premium-priority-high-examples.md b/translations/de-DE/data/reusables/support/ghec-premium-priority-high-examples.md deleted file mode 100644 index 1707fc6768a6..000000000000 --- a/translations/de-DE/data/reusables/support/ghec-premium-priority-high-examples.md +++ /dev/null @@ -1 +0,0 @@ -
    • Ein Organisations- oder Unternehmensinhaber hat unbeabsichtigt eine Organisation gelöscht
    • Ein Organisations- oder Unternehmensmitglied hat sensitive Daten in einem Commit, einem Issue, einem Pull Request oder einem Issueanhang hochgeladen
    \ No newline at end of file diff --git a/translations/de-DE/data/reusables/support/ghec-premium-priority-low-description.md b/translations/de-DE/data/reusables/support/ghec-premium-priority-low-description.md deleted file mode 100644 index a3dee1e2e212..000000000000 --- a/translations/de-DE/data/reusables/support/ghec-premium-priority-low-description.md +++ /dev/null @@ -1 +0,0 @@ -Du hast Fragen oder Vorschläge zu Deiner Organisation oder Deinem Unternehmen auf {% data variables.product.prodname_ghe_cloud %}, die weder zeitkritisch sind noch anderweitig die Produktivität Deines Teams blockieren. \ No newline at end of file diff --git a/translations/de-DE/data/reusables/support/ghec-premium-priority-low-examples.md b/translations/de-DE/data/reusables/support/ghec-premium-priority-low-examples.md deleted file mode 100644 index 3dd225bc677d..000000000000 --- a/translations/de-DE/data/reusables/support/ghec-premium-priority-low-examples.md +++ /dev/null @@ -1 +0,0 @@ -
    • Übermäßige Ressourcennutzung für Deine Organisation oder Dein Unternehmen
    • Anträge auf Systemdiagnosen
    • Hilfe bei der Verwendung von Gists, Benachrichtigungen, Wikis, {% data variables.product.prodname_pages %}, {% data variables.product.prodname_desktop %}, Atom, oder anderen peripheren Diensten oder Features mit Deiner Organisation oder Deinem Unternehmen
    • Feature-Anfragen
    • Produkt Feedback
    \ No newline at end of file diff --git a/translations/de-DE/data/reusables/support/ghec-premium-priority-normal-description.md b/translations/de-DE/data/reusables/support/ghec-premium-priority-normal-description.md deleted file mode 100644 index d321b4e35d60..000000000000 --- a/translations/de-DE/data/reusables/support/ghec-premium-priority-normal-description.md +++ /dev/null @@ -1 +0,0 @@ -Mitglieder Deiner Organisation oder Deines Unternehmens auf {% data variables.product.prodname_ghe_cloud %} erfahren begrenzte oder moderate Probleme mit {% data variables.product.prodname_dotcom_the_website %}, oder Du hast allgemeine Bedenken oder Fragen über Deine Organisation oder Dein Unternehmen. \ No newline at end of file diff --git a/translations/de-DE/data/reusables/support/ghec-premium-priority-normal-examples.md b/translations/de-DE/data/reusables/support/ghec-premium-priority-normal-examples.md deleted file mode 100644 index 7fdd79802753..000000000000 --- a/translations/de-DE/data/reusables/support/ghec-premium-priority-normal-examples.md +++ /dev/null @@ -1 +0,0 @@ -
    • Fragen zur Verwendung von APIs und Features für Deine Organisation oder Dein Unternehmen
    • Issues mit Werkzeugen für die Migration von Organisationsdaten, welche von {% data variables.product.company_short %} zur Verfügung gestellt werden
    • Features im Zusammenhang mit Deiner Organisation oder Deinem Unternehmen funktionieren nicht wir erwartet
    • Allgemeine Sicherheitsfragen zu Deiner Organisation oder Deinem Unternehmen
    \ No newline at end of file diff --git a/translations/de-DE/data/reusables/support/ghec-premium-priority-urgent-description.md b/translations/de-DE/data/reusables/support/ghec-premium-priority-urgent-description.md deleted file mode 100644 index fa3c486e5c1d..000000000000 --- a/translations/de-DE/data/reusables/support/ghec-premium-priority-urgent-description.md +++ /dev/null @@ -1 +0,0 @@ -Produktions-Workflows für Deine Organisation oder Dein Unternehmen auf {% data variables.product.prodname_ghe_cloud %} schlagen aufgrund kritischer Servicefehler oder -Ausfälle fehl, und der Fehler wirkt sich direkt auf den Betrieb Deines Unternehmens aus. \ No newline at end of file diff --git a/translations/de-DE/data/reusables/support/ghec-premium-priority-urgent-examples.md b/translations/de-DE/data/reusables/support/ghec-premium-priority-urgent-examples.md deleted file mode 100644 index 5076fecc08f0..000000000000 --- a/translations/de-DE/data/reusables/support/ghec-premium-priority-urgent-examples.md +++ /dev/null @@ -1 +0,0 @@ -
    • Fehler oder Ausfälle bei {% data variables.product.prodname_dotcom_the_website %}, welche die Kernfunktionen von Git- oder Web-Anwendungen für alle Mitglieder Deiner Organisation oder Deines Unternehmens betreffen
    \ No newline at end of file diff --git a/translations/de-DE/data/reusables/support/github-one-premium-plus-response-times-differ.md b/translations/de-DE/data/reusables/support/github-one-premium-plus-response-times-differ.md deleted file mode 100644 index b837b048ed99..000000000000 --- a/translations/de-DE/data/reusables/support/github-one-premium-plus-response-times-differ.md +++ /dev/null @@ -1 +0,0 @@ -Für Kunden, welche {% data variables.product.prodname_ghe_one %} kaufen, ist der Support für {% data variables.product.prodname_actions %}, {% data variables.product.prodname_insights %}, {% data variables.product.prodname_learning %} und {% data variables.product.prodname_registry %} während 24 Stunden am Tag an 5 Tage pro Woche verfügbar, außer an Wochenenden und nationalen Feiertagen. Die Standardantwortzeit ist 1 Werktag. diff --git a/translations/de-DE/data/reusables/support/github-one-premium-plus-sla-differs.md b/translations/de-DE/data/reusables/support/github-one-premium-plus-sla-differs.md deleted file mode 100644 index 091063a7c681..000000000000 --- a/translations/de-DE/data/reusables/support/github-one-premium-plus-sla-differs.md +++ /dev/null @@ -1 +0,0 @@ -Für Kunden, die {% data variables.product.prodname_ghe_one %} kaufen, gilt das SLA für die erste Reaktionszeit von {% data variables.contact.premium_support %} nicht für Tickets für {% data variables.product.prodname_actions %}, {% data variables.product.prodname_insights %}, {% data variables.product.prodname_learning %}, oder {% data variables.product.prodname_registry %}. \ No newline at end of file diff --git a/translations/de-DE/data/reusables/support/github-one-premium-plus-support-terms-differ.md b/translations/de-DE/data/reusables/support/github-one-premium-plus-support-terms-differ.md deleted file mode 100644 index 30865956acce..000000000000 --- a/translations/de-DE/data/reusables/support/github-one-premium-plus-support-terms-differ.md +++ /dev/null @@ -1 +0,0 @@ -Für Kunden, die {% data variables.product.prodname_ghe_one %} kaufen, unterscheiden sich die Supportbedingungen für den {% data variables.product.premium_plus_support_plan %} für{% data variables.product.prodname_actions %}, {% data variables.product.prodname_insights %}, {% data variables.product.prodname_learning %} und {% data variables.product.prodname_registry %}. \ No newline at end of file diff --git a/translations/de-DE/data/reusables/teams/team-sync.md b/translations/de-DE/data/reusables/teams/team-sync.md deleted file mode 100644 index 3855eaaa1587..000000000000 --- a/translations/de-DE/data/reusables/teams/team-sync.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - - **Note:** When you have team synchronization set up for a team with your organization's identity provider (IdP), you will see an error if you attempt to use the API for making changes to the team's membership. If you have access to manage group membership in your IdP, you can manage GitHub team membership through your identity provider, which automatically adds and removes team members in an organization. For more information, see "[Synchronizing teams between your identity provider and GitHub](/articles/synchronizing-teams-between-your-identity-provider-and-github/)." - -{% endnote %} -{% endif %} diff --git a/translations/de-DE/data/reusables/user-settings/throttling-notice.md b/translations/de-DE/data/reusables/user-settings/throttling-notice.md deleted file mode 100644 index 77985ece017c..000000000000 --- a/translations/de-DE/data/reusables/user-settings/throttling-notice.md +++ /dev/null @@ -1 +0,0 @@ -This endpoint triggers [notifications](/articles/about-notifications/). Creating content too quickly using this endpoint may result in abuse rate limiting. See "[Abuse rate limits](/v3/#abuse-rate-limits)"{% if currentVersion == "free-pro-team@latest" %} and "[Dealing with abuse rate limits](/v3/guides/best-practices-for-integrators/#dealing-with-abuse-rate-limits)"{% endif %} for details. diff --git a/translations/de-DE/data/reusables/webhooks/interactive_component_short_desc.md b/translations/de-DE/data/reusables/webhooks/interactive_component_short_desc.md deleted file mode 100644 index 6ec63523f5cd..000000000000 --- a/translations/de-DE/data/reusables/webhooks/interactive_component_short_desc.md +++ /dev/null @@ -1 +0,0 @@ -Triggered when a user clicks an interactive element that was created using the {% data variables.product.prodname_component_kit %}. {% data variables.product.prodname_github_app %}s are automatically subscribed to the `interactive_component` event so there's no need to manually subscribe to this event. Unlike other webhook events, the `interactive_component` event is only sent to the {% data variables.product.prodname_github_app %} that a user interacted with through an interactive component, such as in a composable comment. {% data variables.product.prodname_oauth_app %}s cannot subscribe to the `interactive_component` event and other installed {% data variables.product.prodname_github_app %}s will not receive the webhook event even if they subscribed to `interactive_component`. \ No newline at end of file diff --git a/translations/de-DE/data/reusables/webhooks/issue_comment_event_api_properties.md b/translations/de-DE/data/reusables/webhooks/issue_comment_event_api_properties.md deleted file mode 100644 index 84f4f4805e6a..000000000000 --- a/translations/de-DE/data/reusables/webhooks/issue_comment_event_api_properties.md +++ /dev/null @@ -1,3 +0,0 @@ -| Schlüssel | Typ | Beschreibung | -| --------- | -------- | ---------------------------------------------------------------------- | -| `action` | `string` | The action that was performed on the comment. Can be one of `created`. | \ No newline at end of file diff --git a/translations/de-DE/data/reusables/webhooks/package_short_desc.md b/translations/de-DE/data/reusables/webhooks/package_short_desc.md deleted file mode 100644 index 9b2e7ed32efb..000000000000 --- a/translations/de-DE/data/reusables/webhooks/package_short_desc.md +++ /dev/null @@ -1 +0,0 @@ -Activity related to GitHub Packages. {% data reusables.webhooks.action_type_desc %} For more information, see "[GitHub Packages](/packages)". \ No newline at end of file diff --git a/translations/de-DE/data/reusables/webhooks/pull_request_forked_repos_link.md b/translations/de-DE/data/reusables/webhooks/pull_request_forked_repos_link.md deleted file mode 100644 index 0fad1bebc3a1..000000000000 --- a/translations/de-DE/data/reusables/webhooks/pull_request_forked_repos_link.md +++ /dev/null @@ -1 +0,0 @@ -See [below](#pull-request-events-for-forked-repositories) to learn how this event works with forked repositories. \ No newline at end of file diff --git a/translations/de-DE/data/variables/ant-man.yml b/translations/de-DE/data/variables/ant-man.yml deleted file mode 100644 index fd9020681ae1..000000000000 --- a/translations/de-DE/data/variables/ant-man.yml +++ /dev/null @@ -1,3 +0,0 @@ ---- -deployments-ant-man-parameter-note: >- - {% if currentVersion == "free-pro-team@latest" %}**Note:** This parameter requires you to use the [`application/vnd.github.ant-man-preview+json`](/v3/previews/#enhanced-deployments) custom media type.{% endif %} diff --git a/translations/de-DE/data/variables/cloud-9.yml b/translations/de-DE/data/variables/cloud-9.yml deleted file mode 100644 index 514cc607691b..000000000000 --- a/translations/de-DE/data/variables/cloud-9.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: The SCIM API diff --git a/translations/de-DE/data/variables/giant-sentry-fist.yml b/translations/de-DE/data/variables/giant-sentry-fist.yml deleted file mode 100644 index ae3a16bbeb72..000000000000 --- a/translations/de-DE/data/variables/giant-sentry-fist.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: The User Blocking API diff --git a/translations/de-DE/data/variables/korra.yml b/translations/de-DE/data/variables/korra.yml deleted file mode 100644 index a0e37a535b50..000000000000 --- a/translations/de-DE/data/variables/korra.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: The Organization Membership API diff --git a/translations/de-DE/data/variables/mercy.yml b/translations/de-DE/data/variables/mercy.yml deleted file mode 100644 index 0076f284e63b..000000000000 --- a/translations/de-DE/data/variables/mercy.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: The `topics` property for repositories diff --git a/translations/de-DE/data/variables/mister-fantastic.yml b/translations/de-DE/data/variables/mister-fantastic.yml deleted file mode 100644 index 5040343f790d..000000000000 --- a/translations/de-DE/data/variables/mister-fantastic.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: The GitHub Pages API diff --git a/translations/de-DE/data/variables/performed-via-integration.yml b/translations/de-DE/data/variables/performed-via-integration.yml deleted file mode 100644 index c2d523e86a75..000000000000 --- a/translations/de-DE/data/variables/performed-via-integration.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: An additional `performed_via_github_app` object in the issue payload diff --git a/translations/de-DE/data/variables/valkyrie.yml b/translations/de-DE/data/variables/valkyrie.yml deleted file mode 100644 index 7b921d5113e1..000000000000 --- a/translations/de-DE/data/variables/valkyrie.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: The GitHub Marketplace API diff --git a/translations/es-XL/content/actions/building-and-testing-code-with-continuous-integration/about-continuous-integration.md b/translations/es-XL/content/actions/building-and-testing-code-with-continuous-integration/about-continuous-integration.md deleted file mode 100644 index df966b90f1dc..000000000000 --- a/translations/es-XL/content/actions/building-and-testing-code-with-continuous-integration/about-continuous-integration.md +++ /dev/null @@ -1,62 +0,0 @@ ---- -title: Acerca de la integración continua -intro: 'Puedes crear flujos de trabajo de intgraciones contínuas (IC) personalizadas y despliegues contínuos (DC) directamente en tu repositorio de {% data variables.product.prodname_dotcom %} con las {% data variables.product.prodname_actions %}.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/about-continuous-integration - - /github/automating-your-workflow-with-github-actions/about-continuous-integration - - /actions/automating-your-workflow-with-github-actions/about-continuous-integration -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Acerca de la integración continua - -La integración continua (CI) es una práctica de software que requiere la confirmación de código de forma periódica en un repositorio compartido. La confirmación de código con mayor frecuencia detecta errores más rápido y reduce la cantidad de código que un desarrollador necesita depurar al encontrar la fuente de un error. Las actualizaciones frecuentes de código facilitan también la fusión de cambios de diferentes miembros de un equipo de desarrollo de software. Esto es excelente para los desarrolladores, que pueden dedicar más tiempo a escribir código y menos tiempo a depurar errores o resolver conflictos de fusión. - -Al confirmar el código en tu repositorio, puedes crear y probar el código continuamente para asegurarte de que la confirmación no introduzca errores. Tus pruebas pueden incluir limpiadores de código (que verifican el formato de estilo), verificaciones de seguridad, cobertura de código, pruebas funcionales y otras verificaciones personalizadas. - -Para crear y probar tu código es necesario un servidor. Puedes crear y probar las actualizaciones localmente antes de subir un código a un repositorio o puedes usar un servidor CI que verifique las nuevas confirmaciones de código en un repositorio. - -### Acerca de la integración contínua utilizando {% data variables.product.prodname_actions %} - -La IC utilizando {% data variables.product.prodname_actions %} ofrece flujos de trabajo que pueden compilar el código en tu repositorio y ejecutar tus pruebas. Los flujos de trabajo pueden ejecutarse en máquinas virtuales hospedadas en {% data variables.product.prodname_dotcom %}, o en máquinas que hospedes tú mismo. Para obtener más información, consulta las secciones "[Ambientes virtuales para los ejecutores hospedados en {% data variables.product.prodname_dotcom %}](/actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)", y "[Acerca de los ejecutores auto-programados](/actions/automating-your-workflow-with-github-actions/about-self-hosted-runners)". - -Puedes configurar tu flujo de trabajo de IC para que se ejecute cuando ocurre un evento de {% data variables.product.product_name %} (por ejemplo, cuando se sube código nuevo a tu repositorio), en una programación configurada, o cuando ocurre un evento externo utilizando el webhook de envío del repositorio. - -{% data variables.product.product_name %} ejecuta tus pruebas de IC y proporciona los resultados de cada prueba en la solicitud de extracción para que puedas ver si el cambio en tu rama introduce un error. Cuando se aprueban todas las pruebas de CI en un flujo de trabajo, los cambios que subiste están listos para su revisión por parte de un miembro del equipo o para su fusión. Cuando una prueba falla, es posible que uno de tus cambios haya causado la falla. - -Cuando configuras la IC en tu repositorio, {% data variables.product.product_name %} analiza el código en el mismo y recomienda flujos de trabajo de IC con base en el lenguaje y marco de trabajo de tu repositorio. Por ejemplo, si utilizas [Node.js](https://nodejs.org/en/), {% data variables.product.product_name %} te sugerirá un archivo de plantilla que instala tus paquetes de Node.js y ejecuta tus pruebas. Puedes utilizar la plantilla de flujo de trabajo de IC que {% data variables.product.product_name %} te sugiere, personalizarla, o crear tu propio archivo de flujo de trabajo personalizado para que ejecute tus pruebas de IC. - -![Captura de pantalla de plantillas de integración continua sugeridas](/assets/images/help/repository/ci-with-actions-template-picker.png) - -Adicionalmente a ayudarte a configurar los flujos de trabajo de IC para tu proyecto, puedes utilizar las {% data variables.product.prodname_actions %} para crear flujos de trabajo através de todo el ciclo de vida de desarrollo de software. Por ejemplo, puedes usar acciones para implementar, empaquetar o lanzar tu proyecto. Para obtener más información, consulta la sección "[Acerca de las {% data variables.product.prodname_actions %}](/articles/about-github-actions)". - -Para obtener una definición de los términos comunes, consulta la sección "[Conceptos nucleares para las {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)". - -### Lenguajes compatibles - -{% data variables.product.product_name %} ofrece plantillas de flujo de trabajo de IC para varios lenguajes y marcos de trabajo. - -Para obtener más información, consulta "[ Configuración de flujo de trabajo](/articles/configuring-a-workflow)". - -### Notificaciones para ejecuciones de flujo de trabajo - -{% data reusables.repositories.workflow-notifications %} - -### Distintivos de estado para ejecuciones de flujos de trabajo - -{% data reusables.repositories.actions-workflow-status-badge-into %} - -Para obtener más información, consulta "[ Configuración de flujo de trabajo](/articles/configuring-a-workflow)". - -### Leer más - -- "[Configurar la integración contínua utilizando {% data variables.product.prodname_actions %}](/articles/setting-up-continuous-integration-using-github-actions)" -{% if currentVersion == "free-pro-team@latest" %} -- "[Administrar la facturación para {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)" -{% endif %} diff --git a/translations/es-XL/content/actions/building-and-testing-code-with-continuous-integration/index.md b/translations/es-XL/content/actions/building-and-testing-code-with-continuous-integration/index.md deleted file mode 100644 index 7775f1781af7..000000000000 --- a/translations/es-XL/content/actions/building-and-testing-code-with-continuous-integration/index.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: Código de construcción y prueba con integración continua -shortTitle: Integración continua -intro: 'Puedes usar las {% data variables.product.prodname_actions %} para crear flujos de trabajo personalizados de integración continua (CI) y de implementación continua (CD) en tu repositorio.' -redirect_from: - - /articles/setting-up-continuous-integration-on-github - - /github/automating-your-workflow-with-github-actions/setting-up-continuous-integration-on-github - - /github/automating-your-workflow-with-github-actions/creating-continuous-integration-workflows - - /Actions/Automating-Your-Workflow-with-GitHub-Actions/Creating-Continuous-Integration-workflows -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -{% link_in_list /about-continuous-integration %} -{% link_in_list /setting-up-continuous-integration-using-github-actions %} diff --git a/translations/es-XL/content/actions/building-and-testing-code-with-continuous-integration/setting-up-continuous-integration-using-github-actions.md b/translations/es-XL/content/actions/building-and-testing-code-with-continuous-integration/setting-up-continuous-integration-using-github-actions.md deleted file mode 100644 index 481230cb328a..000000000000 --- a/translations/es-XL/content/actions/building-and-testing-code-with-continuous-integration/setting-up-continuous-integration-using-github-actions.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Configurar la integración continua usando las acciones de GitHub -intro: Puedes configurar una integración continua para tu proyecto mediante el uso de una plantilla de flujo de trabajo que coincida con el idioma y las herramientas que deseas utilizar. -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/setting-up-continuous-integration-using-github-actions - - /github/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions - - /actions/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -Cualquier persona con permiso de escritura en un repositorio puede configurar la integración continua (CI) utilizando {% data variables.product.prodname_actions %}. - -Una vez que hayas configurado la IC, puedes personalizar el flujo de trabajo para satisfacer tus necesidades. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -3. Busca la plantilla que coincida con el idioma y las herramientas que deseas utilizar; a continuación, haz clic en **Configurar este flujo de trabajo**. ![Configurar el botón de flujo de trabajo](/assets/images/help/repository/setup-workflow-button.png) -5. Haz clic en **Iniciar confirmación**. ![Botón Start commit (Iniciar confirmación)](/assets/images/help/repository/start-commit.png) -{% data reusables.files.write_commit_message %} -{% data reusables.files.choose_commit_branch %} -{% data reusables.files.propose_new_file %} - -Una vez que se hace una inserción en tu repositorio, puedes seguir el estado y los registros detallados de tu flujo de trabajo de integración continua ejecutado en {% data variables.product.prodname_dotcom %} y recibir notificaciones personalizadas. Para obtener más información, consulta la sección "[Configurar notificaciones](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)" y "[Administrar una ejecución de flujo de trabajo](/articles/managing-a-workflow-run)". - -{% data reusables.repositories.actions-workflow-status-badge-into %} - -Para obtener más información, consulta "[ Configuración de flujo de trabajo](/articles/configuring-a-workflow)". - -### Leer más - -- "[Acerca de la integración continua](/articles/about-continuous-integration)" -- "[Administrar una ejecución de flujo de trabajo](/articles/managing-a-workflow-run)" -{% if currentVersion == "free-pro-team@latest" %} -- "[Administrar la facturación para {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)" -{% endif %} diff --git a/translations/es-XL/content/actions/configuring-and-managing-workflows/about-service-containers.md b/translations/es-XL/content/actions/configuring-and-managing-workflows/about-service-containers.md deleted file mode 100644 index bc3a856ed091..000000000000 --- a/translations/es-XL/content/actions/configuring-and-managing-workflows/about-service-containers.md +++ /dev/null @@ -1,114 +0,0 @@ ---- -title: Acerca de los contenedores de servicios -intro: 'Puedes usar los contenedores de servicios para conectar las bases de datos, los servicios Web, las memorias caché y otras herramientas a tu flujo de trabajo.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /Actions/Automating-Your-Workflow-with-GitHub-Actions/about-Service-containers -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Acerca de los contenedores de servicios - -Los contenedores de servicios son contenedores de Docker que ofrecen una manera sencilla y portátil de alojar servicios que probablemente necesites para probar o usar tu aplicación en un flujo de trabajo. Por ejemplo, es posible que tu flujo de trabajo tenga que ejecutar pruebas de integración que requieran acceso a una base de datos y a una memoria caché. - -Puedes configurar contenedores de servicios para cada trabajo en un flujo de trabajo. {% data variables.product.prodname_dotcom %} crea un contenedor de Docker nuevo para cada servicio configurado en el flujo de trabajo y destruye el contenedor de servicios cuando se termina el trabajo. Los pasos de un trabajo pueden comunicarse con todos los contenedores de servicios que son parte del mismo trabajo. - -{% data reusables.github-actions.docker-container-os-support %} - -### Comunicarse con contenedores de servicios - -Puedes configurar trabajos en un flujo de trabajo para que se ejecuten directamente en una máquina del ejecutor o en un contenedor de Docker. La comunicación entre un trabajo y sus contenedores de servicios cambia en función de si un trabajo se ejecuta directamente en la máquina del ejecutor o en un contenedor. - -#### Ejecutar trabajos en un contenedor - -Cuando ejecutas trabajos en un contenedor, {% data variables.product.prodname_dotcom %} conecta los contenedores de servicios al trabajo mediante las redes de puente definidas por el usuario de Docker. Para obtener más información, consulta "[Usar redes de puente](https://docs.docker.com/network/bridge/)" en la documentación de Docker. - -Al ejecutar el trabajo y los servicios en un contenedor, se simplifica el acceso a la red. Puedes acceder a un contenedor de servicios usando la etiqueta que configuraste en el flujo de trabajo. El nombre del host del contenedor de servicios se correlaciona automáticamente con el nombre de la etiqueta. Por ejemplo, si creas un contenedor de servicios con la etiqueta `redis`, el nombre del host del contenedor de servicio será `redis`. - -No es necesario configurar ningún puerto para los contenedores de servicios. Por defecto, todos los contenedores que forman parte de la misma red de Docker se exponen los puertos entre sí, y no se exponen puertos por fuera de la red de Docker. - -#### Ejecutar trabajos en la máquina del ejecutor - -Cuando ejecutas trabajos directamente en la máquina del ejecutor, puedes acceder a los contenedores de servicios usando `localhost:` o `127.0.0.1`. {% data variables.product.prodname_dotcom %} configura la red de contenedores para habilitar la comunicación desde el contenedor de servicios hasta el host de Docker. - -Cuando un trabajo se ejecuta directamente en una máquina del ejecutor, el servicio que se ejecuta en el contenedor de Docker no expone sus puertos al trabajo del ejecutor por defecto. Debes asignar los puertos del contenedor de servicios al host de Docker. Para obtener más información, consulta "[Asignar puertos del host de Docker y del contenedor de servicios](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)". - -### Crear contenedores de servicios - -Puedes usar la palabra clave `services` para crear contenedores de servicios que sean parte de un trabajo en tu flujo de trabajo. Para obtener más información, consulta [`jobs..services`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idservices). - -Este ejemplo crea un servicio llamado `redis` en un trabajo llamado `container-job`. El host de Docker en este ejemplo es el contenedor `node: 10.18-jessie`. - -{% raw %} -```yaml -name: Redis container example -on: push - -jobs: - # Etiqueta del trabajo del contenedor - container-job: - # Los contenedores deben ejecutarse en sistemas operativos basados en Linux - runs-on: ubuntu-latest - # Imagen de Docker Hub que 'container-job' ejecuta en - el contendor: node:10.18-jessie - - # Contenedores de servicios para ejecutar con servicios de 'container-job': - # Etiqueta usada para acceder al contenedor de servicios - redis: - # Imagen de Docker Hub - image: redis -``` -{% endraw %} - -### Asignar puertos del host de Docker y del contenedor de servicios - -Si tu trabajo se ejecuta en un contenedor de Docker, no necesitas asignar puertos en el host o en el contenedor de servicios. Si tu trabajo se ejecuta directamente en la máquina del ejecutor, tendrás que asignar cualquier puerto requerido del contenedor de servicios a los puertos de la máquina del ejecutor del host. - -Puedes asignar puertos de contenedores de servicios al host de Docker utilizando la palabra clave `ports`. Para obtener más información, consulta [`jobs..services`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idservices). - -| Valor de `ports` | Descripción | -| ---------------- | ------------------------------------------------------------------------------------------------- | -| `8080:80` | Asigna el puerto TCP 80 del contenedor al puerto 8080 del host de Docker. | -| `8080:80/UDP` | Asigna el puerto UDP 80 del contenedor al puerto 8080 del host de Docker. | -| `8080/UDP` | Asigna un puerto UDP elegido aleatoriamente del contenedor al puerto UDP 8080 del host de Docker. | - -Cuando asignas puertos utilizando la palabra clave `ports`, {% data variables.product.prodname_dotcom %} utiliza el comando `--publish` para publicar los puertos del contenedor en el host de Docker. Para obtener más información, consulta "[Redes de contenedores de Docker](https://docs.docker.com/config/containers/container-networking/)"en la documentación de Docker. - -Cuando especificas el puerto del host de Docker pero no el puerto del contenedor, el puerto del contenedor se asigna aleatoriamente a un puerto gratuito. {% data variables.product.prodname_dotcom %} establece el puerto del contenedor asignado en el contexto del contenedor de servicios. Por ejemplo, para un contenedor de servicios `redis`, si configuraste el puerto del host de Docker 5432, puedes acceder al puerto del contenedor correspondiente utilizando el contexto `job.services.redis.ports[5432]`. Para obtener más información, consulta "[Sintaxis de contexto y expresión para {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions#job-context)". - -#### Ejemplo de asignación de puertos Redis - -Este ejemplo asigna el puerto 6379 del contenedor de servicios `redis` al puerto 6379 del host de Docker. - -{% raw %} -```yaml -name: Redis Service Example -on: push - -Jobs: - # Etiqueta del trabajo del contenedor - runner-job: - # Debes usar un entorno Linux cuando uses contenedores de servicios o trabajos del contenedor - runs-on: ubuntu-latest - - # Contenedores de servicios para ejecutar con servicios de 'runner-job': - # Etiqueta usada para acceder al contenedor de servicios - redis: - # Imagen de Docker Hub - image: redis - # - puertos: - # Abre el puerto tcp 6379 en el host y el contenedor de servicios - -6379:6379 -``` -{% endraw %} - -### Leer más - -- "[Crear contenedores de servicios Redis](/actions/automating-your-workflow-with-github-actions/creating-redis-service-containers)" -- "[Crear contenedores de servicios PostgreSQL](/actions/automating-your-workflow-with-github-actions/creating-postgresql-service-containers)" diff --git a/translations/es-XL/content/actions/configuring-and-managing-workflows/authenticating-with-the-github_token.md b/translations/es-XL/content/actions/configuring-and-managing-workflows/authenticating-with-the-github_token.md deleted file mode 100644 index b59582bde006..000000000000 --- a/translations/es-XL/content/actions/configuring-and-managing-workflows/authenticating-with-the-github_token.md +++ /dev/null @@ -1,99 +0,0 @@ ---- -title: Autenticar con el ' GITHUB_TOKEN ' -intro: '{% data variables.product.prodname_dotcom %} proporciona un token que puedes usar para autenticar en nombre de {% data variables.product.prodname_actions %}.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /github/automating-your-workflow-with-github-actions/authenticating-with-the-github_token - - /actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -Cualquier persona con acceso de `escritura` en un repositorio puede crear, leer y usar secretos. - -### Acerca del secreto del `GITHUB_TOKEN` - -{% data variables.product.prodname_dotcom %} automáticamente crea un secreto de `GITHUB_TOKEN` para utilizar en tu flujo de trabajo. Puedes usar el `GITHUB_TOKEN` para autenticarte en una ejecución de flujo de trabajo. - -Cuando habilitas {% data variables.product.prodname_actions %}, {% data variables.product.prodname_dotcom %} instala una {% data variables.product.prodname_github_app %} en tu repositorio. El secreto del `GITHUB_TOKEN` es un token de acceso de instalación de {% data variables.product.prodname_github_app %}. Puedes usar el token de acceso de instalación para autenticarte en nombre de la {% data variables.product.prodname_github_app %} instalado en tu repositorio. Los permisos del token están limitados al repositorio que contiene tu flujo de trabajo. Para obtener más información, consulta "[Permisos para el `GITHUB_TOKEN`](#permissions-for-the-github_token)." - -Antes de que comience cada job, {% data variables.product.prodname_dotcom %} extrae un token de acceso de instalación para éste. El token expira cuando el trabajo termina. - -El token también está disponible en el contexto `github.token`. Para obtener más información, consulta "[Sintaxis de contexto y expresión para las {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)." - -### Usar el `GITHUB_TOKEN` en un flujo de trabajo - -Para usar el secreto del `GITHUB_TOKEN`, debes hacer referencia a él en tu archivo de flujo de trabajo. Usar un token puede incluir pasar el token como una entrada a una acción que la requiera o hacer llamadas autenticadas de la API de {% data variables.product.prodname_dotcom %}. - -{% data reusables.github-actions.actions-do-not-trigger-workflows %} - -#### Ejemplo de pase de `GITHUB_TOKEN` como una entrada - -Este flujo de trabajo de ejemplo usa la [acción de etiquetadora](https://github.com/actions/labeler), que necesita el `GITHUB_TOKEN` como el valor para el parámetro de entrada `repo-token`: - - {% raw %} - ```yaml - name: Pull request labeler - on: - - pull_request - jobs: - triage: - runs-on: ubuntu-latest - steps: - - uses: actions/labeler@v2 - with: - repo-token: ${{ secrets.GITHUB_TOKEN }} - ``` - {% endraw %} - -#### Ejemplo de llamada a la API REST - -Puedes usar el `GITHUB_TOKEN` para realizar llamadas API autenticadas. Este flujo de trabajo de ejemplo crea una propuesta mediante la API REST de {% data variables.product.prodname_dotcom %}: - - {% raw %} - ```yaml - name: Create issue on commit - on: - - push - jobs: - create_commit: - runs-on: ubuntu-latest - steps: - - name: Create issue using REST API - run: | - curl --request POST \ - --url https://api.github.com/repos/${{ github.repository }}/issues \ - --header 'authorization: Bearer ${{ secrets.GITHUB_TOKEN }}' \ - --header 'content-type: application/json' \ - --data '{ - "title": "Automated issue for commit: ${{ github.sha }}", - "body": "This issue was automatically created by the GitHub Action workflow **${{ github.workflow }}**. \n\n The commit hash was: _${{ github.sha }}_." - }' - ``` - {% endraw %} - -### Permisos para el `GITHUB_TOKEN` - -Para obtener información sobre los puntos finales de la API a los que {% data variables.product.prodname_github_apps %} puede acceder con cada permiso, consulta la sección "[ Permisos de {% data variables.product.prodname_github_app %}](/v3/apps/permissions/)". - -| Permiso | Tipo de acceso | Acceso por repositorios bifurcados | -| ------------------------- | ----------------- | ---------------------------------- | -| acciones | lectura/escritura | lectura | -| verificaciones | lectura/escritura | lectura | -| contenidos | lectura/escritura | lectura | -| implementaciones | lectura/escritura | lectura | -| propuestas | lectura/escritura | lectura | -| metadatos | lectura | lectura | -| paquetes | lectura/escritura | lectura | -| solicitudes de extracción | lectura/escritura | lectura | -| proyectos de repositorio | lectura/escritura | lectura | -| estados | lectura/escritura | lectura | - -Si necesitas un token que requiere permisos que no están disponibles en el `GITHUB_TOKEN`, puedes crear un token de acceso personal y establecerlo como un secreto en tu repositorio: - -1. Usa o crea un token con los permisos adecuados para ese repositorio. Para obtener más información, consulta la sección "[Crear un token de acceso personal](/github/authenticating-to-github/creating-a-personal-access-token)". -1. Añade el token como un secreto en el repositorio de tu flujo de trabajo y haz referencia a él mediante la sintaxis {%raw%}`${{ secrets.SECRET_NAME }}`{% endraw %}. Para obtener más información, consulta "[Crear y usar secretos cifrados](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)." diff --git a/translations/es-XL/content/actions/configuring-and-managing-workflows/caching-and-storing-workflow-data.md b/translations/es-XL/content/actions/configuring-and-managing-workflows/caching-and-storing-workflow-data.md deleted file mode 100644 index 07ec3d2aa89e..000000000000 --- a/translations/es-XL/content/actions/configuring-and-managing-workflows/caching-and-storing-workflow-data.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Almacenar en caché y almacenar datos de flujo de trabajo -intro: Almacena en caché las dependencias y almacena los artefactos para hacer que tus flujos de trabajo sean más eficientes. -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/es-XL/content/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows.md b/translations/es-XL/content/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows.md deleted file mode 100644 index ebf28a43fcee..000000000000 --- a/translations/es-XL/content/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows.md +++ /dev/null @@ -1,190 +0,0 @@ ---- -title: Almacenar en caché las dependencias para agilizar los flujos de trabajo -intro: 'Para hacer que tus flujos de trabajo sean más rápidos y eficientes, puedes crear y usar cachés para las dependencias y otros archivos comúnmente reutilizados.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /github/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows - - /actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows -versions: - free-pro-team: '*' ---- - -### Acerca de almacenar en caché las dependencias de flujo de trabajo - -Las ejecuciones de flujo de trabajo a menudo reutilizan las mismas salidas o dependencias descargadas de una ejecución a otra. Por ejemplo, las herramientas de administración de paquetes y dependencias como Maven, Gradle, npm y Yarn mantienen una caché local de las dependencias descargadas. - -Los trabajos en los ejecutores alojados {% data variables.product.prodname_dotcom %} se inician en un entorno virtual limpio y deben descargar dependencias cada vez, lo que provoca una mayor utilización de la red, un tiempo de ejecución más largo y un mayor costo. Para ayudar a acelerar el tiempo que se tarda en volver a crear estos archivos, {% data variables.product.prodname_dotcom %} puede almacenar en caché las dependencias que utilizas con frecuencia en los flujos de trabajo. - -Para almacenar en caché las dependencias de un trabajo, deberás usar la acción de `caché` de {% data variables.product.prodname_dotcom %}. La acción recupera una caché identificada por una clave única. Para más información, consulta [`actions/cache`](https://github.com/actions/cache). - -{% warning %} - -**Advertencia**: Te recomendamos que no almacenes ninguna información confidencial en la caché de los repositorios públicos. Por ejemplo, la información confidencial puede incluir tokens de acceso o credenciales de inicio de sesión almacenados en un archivo en la ruta de la caché. Además, los programas de interfaz de línea de comando (CLI) como `docker login` pueden guardar las credenciales de acceso en un archivo de configuración. Cualquier persona con acceso de lectura puede crear una solicitud de extracción en un repositorio y acceder a los contenidos de la caché. Las bifurcaciones de un repositorio también pueden crear solicitudes de extracción en la rama base y acceder a las cachés en la rama base. - -{% endwarning %} - -### Comparar artefactos y caché de dependencias - -Los artefactos y el almacenamiento en caché son similares porque brindan la posibilidad de almacenar archivos en {% data variables.product.prodname_dotcom %}, pero cada característica ofrece diferentes casos de uso y no se puede usar indistintamente. - -- Usa el almacenamiento en caché cuando quieras reutilizar archivos que no cambien a menudo entre trabajos o ejecuciones de flujo de trabajo. -- Usa artefactos cuando quieras guardar los archivos producidos por un trabajo para ver después de que haya finalizado un flujo de trabajo. Para obtener más información, consulta "[Conservar datos de flujo de trabajo mediante artefactos](/github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)". - -### Restricciones para acceder a una caché - -Con la `v2` de la acción `cache`, puedes acceder al caché en en los flujos de trabajo que cualquier evento que tenga un `GITHUB_REF` active. Si estás utilizando la `v1` de la acción `cache`, únicamente podrás acceder al caché en los flujos de trabajo que activen los eventos `push` y `pull_request`, con excepción de aquellos eventos `pull_request` `closed`. Para obtener más información, consulta "[Eventos que activan los flujos de trabajo](/actions/reference/events-that-trigger-workflows)". - -Un flujo de trabajo puede acceder y restaurar una caché creada en la rama actual, la rama base (incluidas las ramas base de los repositorios bifurcados) o la rama predeterminada (por lo general `master`). Por ejemplo, una caché creada en la rama predeterminada `master` sería accesible desde cualquier solicitud de extracción. También, si la rama `feature-b` tiene la rama base `feature-a`, un flujo de trabajo activado en `feature-b` tendría acceso a las cachés creadas en la rama predeterminada (`master`), `feature-a` y `feature-b`. - -Las restricciones de acceso proporcionan seguridad y aislamiento de caché al crear un límite lógico entre diferentes flujos de trabajo y ramas. Por ejemplo, una caché creada para la rama `feature-a` (con la base `master`) no sería accesible para una solicitud de extracción para la rama `feature-b` (con la base `master`). - -### Usando la acción `cache` - -La acción `cache` intentará restaurar una memoria caché basada en la `key` (clave) que proporciones. Cuando la acción encuentra una memoria caché, la acción restaura los archivos almacenados en la caché al `path` (ruta) que configures. - -Si no hay una coincidencia exacta, la acción crea una nueva entrada de caché si el trabajo se completa correctamente. La nueva memoria caché usará la `key` que proporcionaste y contiene los archivos en el directorio del `path`. - -De manera opcional, puedes proporcionar una lista de `restore-keys` para usar cuando la `key` no coincida con una memoria caché existente. Una lista de `restore-keys` es útil cuando estás restaurando una caché desde otra rama porque `restore-keys` pueden coincidir parcialmente con claves de caché. Para obtener más información acerca de la coincidencia `restore-keys`, consulta [Hacer coincidir una clave de caché](#matching-a-cache-key)". - -Para más información, consulta [`actions/cache`](https://github.com/actions/cache). - -#### Parámetros de entrada para la acción `chache` - -- `key`: **Obligatorio** La clave que se crea cuando se guarda una memoria caché y la clave utilizada para buscar una caché. Puede ser cualquier combinación de variables, valores de contexto, cadenas estáticas y funciones. Las claves tienen una longitud máxima de 512 caracteres y las claves más largas que la longitud máxima provocarán un error en la acción. -- `path`: **Obligatorio** La ruta del archivo en el ejecutor para almacenar en caché o restaurar. La ruta debe ser absoluta o relativa al directorio de trabajo. - - Con la `v2` de la acción `cache`, puedes especificar una ruta única, o rutas múltiples en forma de lista. Las rutas pueden ser tanto directorios o solo archivos, y los patrones estilo glob son compatibles. - - Con la `v1` de la acción `cache`, solo se puede utilizar una ruta única, la cual debe ser un directorio. No puedes almacenar en caché un archivo único. -- `restore-keys`: **Opcional** Una lista ordenada de claves alternativas que se usan para encontrar la caché si no se ha producido ningún hit de caché para `key`. - -#### Parámetros de salida para la acción `cache` - -- `cache-hit`: Un valor booleano para indicar que se encontró una coincidencia exacta para la llave. - -#### Ejemplo de uso para la acción `cache` - -Este ejemplo crea una nueva memoria caché cuando los paquetes en el archivo `package-lock.json` cambian o cuando cambia el sistema operativo del ejecutor. La clave de caché usa contextos y expresiones para generar una clave que incluye el sistema operativo del ejecutor y un hash SHA-256 del archivo `package-lock.json`. - -{% raw %} -```yaml -name: Caching with npm - -on: push - -jobs: - build: - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - - name: Cache node modules - uses: actions/cache@v2 - env: - cache-name: cache-node-modules - with: - # npm cache files are stored in `~/.npm` on Linux/macOS - path: ~/.npm - key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('**/package-lock.json') }} - restore-keys: | - ${{ runner.os }}-build-${{ env.cache-name }}- - ${{ runner.os }}-build- - ${{ runner.os }}- - - - name: Install Dependencies - run: npm install - - - name: Build - run: npm build - - - name: Test - run: npm test - -``` -{% endraw %} - -Cuando `key` coincide con una caché existente, se denomina hit de caché y la acción restaura los archivos almacenados en la caché al directorio `path`. - -Cuando `key` no coincide con una caché existente, se denomina una falta de caché y se crea una nueva memoria caché si el trabajo se completa correctamente. Cuando se produce una falta de caché, la acción busca claves alternativas llamadas `restore-keys`. - -1. Si proporcionas `restore-Keys`, la acción `cache` busca cualquier caché en forma secuencial que coincida con la lista de `restore-keys`. - - Cuando hay una coincidencia exacta, la acción restaura los archivos en la memoria caché al directorio `path`. - - Si no hay coincidencias exactas, la acción busca coincidencias parciales de las claves de restauración. Cuando la acción encuentra una coincidencia parcial, se restaura la caché más reciente al directorio `path`. -1. La acción `cache` se completa y el siguiente paso en el flujo de trabajo del job se ejecuta. -1. Si el trabajo se completa correctamente, la acción crea una nueva memoria caché con los contenidos del directorio `path`. - -Para almacenar en caché los archivos en más de un directorio, necesitarás un paso que use la acción [`cache`](https://github.com/actions/cache) para cada directorio. Una vez que creas una caché, no puedes cambiar los contenidos de una memoria caché existente, pero puedes crear una nueva caché con una clave nueva. - -#### Usar contextos para crear claves de caché - -Una clave de caché puede incluir cualquiera de los contextos, funciones, literales y operadores admitidos por {% data variables.product.prodname_actions %}. Para obtener más información, consulta "[Sintaxis de contexto y expresión para {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)". - -Usar expresiones para crear una `key` te permite crear automáticamente una nueva caché cuando las dependencias han cambiado. Por ejemplo, puedes crear una `key` utilizando una expresión que calcule el hash de un archivo `package-lock.json` de npm. - -{% raw %} -``` -npm-${{ hashFiles('package-lock.json') }} -``` -{% endraw %} - -{% data variables.product.prodname_dotcom %} evalúa la expresión `hash "package-lock.json"` para obtener la última `key`. - -``` -npm-d5ea0750 -``` - -### Hacer coincidir una clave de caché - -La acción `cache` busca primero las coincidencias de caché para `key` y `restore-keys` en la rama que contiene la ejecución del flujo de trabajo. Si no hay coincidencias en la rama actual, la acción `chache` busca a `key` y `restore-keys` en la rama padre y en las ramas ascendentes. - -Puedes proporcionar una lista de claves de restauración para usar cuando haya una falta de caché en `key`. Puedes crear múltiples claves de restauración ordenadas desde las más específicas hasta las menos específicas. La acción `cache` busca `restore-keys` en orden secuencial. Cuando una clave no coincide directamente, la acción busca las claves prefijadas con la clave de restauración. Si hay múltiples coincidencias parciales para una clave de restauración, la acción devuelve la caché que se creó más recientemente. - -#### Ejemplo usando múltiples claves de restauración - -{% raw %} -``` -restore-keys: | - npm-foobar-${{ hashFiles('package-lock.json') }} - npm-foobar- - npm- -``` -{% endraw %} - -El ejecutor evalúa las expresiones, que resuelven estas `restore-keys`: - -{% raw %} -``` -restore-keys: | - npm-foobar-d5ea0750 - npm-foobar- - npm- -``` -{% endraw %} - -La clave de restauración `npm-foobar-` coincide con cualquier clave que empiece con la cadena `npm-foobar-`. Por ejemplo, ambas claves `npm-foobar-fd3052de` y `npm-foobar-a9b253ff` coinciden con la clave de restauración. Se utilizará la caché con la fecha de creación más reciente. Las claves en este ejemplo se buscan en el siguiente orden: - -1. **`npm-foobar-d5ea0750`** coincide con un hash específico. -1. **`npm-foobar-`** coincide con claves de caché prefijadas con `npm-foobar-`. -1. **`npm`** coincide con cualquier clave prefijada con `npm`. - -##### Ejemplo de prioridad de búsqueda - -```yaml -key: - npm-feature-d5ea0750 -restore-keys: | - npm-feature- - npm- -``` - -Por ejemplo, si una solicitud de extracción contiene una rama `feature` (el alcance actual) y se dirige a la rama predeterminada (`master`), la acción busca `key` y `restore-keys` en el siguiente orden: - -1. Clave `npm-feature-d5ea0750` en el alcance de la rama `feature` -1. Clave `npm-feature-` en el alcance de la rama `feature` -2. Clave `npm` en el alcance de la rama `feature` -1. Clave `npm-feature-d5ea0750` en el alcance de la rama `master` -3. Clave `npm-d5ea0750` en el alcance de la rama `master` -4. Clave `npm` en el alcance de la rama `master` - -### Límites de uso y política de desalojo - -{% data variables.product.prodname_dotcom %} eliminará todas las entradas de caché a las que no se haya accedido en más de 7 días. No hay límite en la cantidad de cachés que puedes almacenar, pero el tamaño total de todas las cachés en un repositorio está limitado a 5 GB. Si excedes este límite, {% data variables.product.prodname_dotcom %} guardará tu caché, pero comenzará a desalojar las cachés hasta que el tamaño total sea inferior a 5 GB. diff --git a/translations/es-XL/content/actions/configuring-and-managing-workflows/configuring-a-workflow.md b/translations/es-XL/content/actions/configuring-and-managing-workflows/configuring-a-workflow.md deleted file mode 100644 index e61749c01f4c..000000000000 --- a/translations/es-XL/content/actions/configuring-and-managing-workflows/configuring-a-workflow.md +++ /dev/null @@ -1,383 +0,0 @@ ---- -title: Configurar un flujo de trabajo -intro: Puedes crear flujos de trabajo personalizados para automatizar los procesos del ciclo de vida de desarrollo de software de tu proyecto. -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/creating-a-github-action/ - - /articles/creating-a-workflow-with-github-actions/ - - /articles/configuring-a-workflow - - /github/automating-your-workflow-with-github-actions/configuring-a-workflow - - /actions/automating-your-workflow-with-github-actions/configuring-a-workflow - - /actions/creating-workflows/workflow-configuration-options -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -Las personas con permisos de escritura o de administración a un repositorio pueden crear, editar o ver flujos de trabajo. - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Acerca de los flujos de trabajo - -Los flujos de trabajo son procesos automatizados personalizados que puedes configurar en tu repositorio para crear, probar, empaquetar, lanzar o implementar cualquier proyecto en {% data variables.product.prodname_dotcom %}. Con los flujos de trabajo, puedes automatizar el ciclo de vida de tu desarrollo de software con una amplia gama de herramientas y servicios. Para obtener más información, consulta "[Acerca de {% data variables.product.prodname_actions %}](/articles/about-github-actions)". - -Puedes crear más de un flujo de trabajo en un repositorio. Debes almacenar los flujos de trabajo en el directorio `.github/workflows` en la raíz de su repositorio. - -Los flujos de trabajo deben tener al menos un trabajo, y los trabajos deben contener un conjunto de pasos que ejecuten tareas individuales. Los pasos pueden ejecutar comandos o utilizar una acción. Puedes crear tus propias acciones o usar acciones compartidas por la comunidad {% data variables.product.prodname_dotcom %} y personalizarlas según sea necesario. - -Puedes configurar un flujo de trabajo para que comience cuando se produce un evento {% data variables.product.prodname_dotcom %}, en un horario o desde un evento externo. - -Debes configurar los flujos de trabajo mediante la sintaxis YAML y guardarlos como archivos de flujo de trabajo en tus repositorios. Una vez que hayas creado con éxito un archivo de flujo de trabajo YAML y activado el flujo de trabajo, verás los registros de construcción, los resultados de las pruebas, los artefactos y los estados de cada paso de tu flujo de trabajo. Para obtener más información, consulta "[Administrar una ejecución de flujo de trabajo](/articles/managing-a-workflow-run)". - - ![Imagen de ejecución de flujo de trabajo anotado](/assets/images/help/repository/annotated-workflow.png) - -También puedes recibir notificaciones de actualizaciones de estado del flujo de trabajo. Para obtener más información acerca de las opciones de notificación, consulta la sección "[Configurar notificaciones](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)". - -Los límites de uso se aplican a los flujos de trabajo individuales. Para obtener más información, consulta "[Límites de uso para flujos de trabajo](/articles/workflow-syntax-for-github-actions#usage-limits)". - -### Crear un archivo de flujo de trabajo - -En un nivel alto, estos son los pasos para agregar un archivo de flujo de trabajo. Puedes encontrar ejemplos de configuración específicos en las secciones a continuación. - -1. En la raíz de tu repositorio, crea un directorio denominado `.github/workflows` para almacenar tus archivos de flujo de trabajo. - -1. En `.github/workflows`, agrega un archivo `.yml` o `.yaml` a tu flujo de trabajo. Por ejemplo, `.github/workflows/continuous-integration-workflow.yml`. - -1. Utiliza la documentación de referencia "[Sintaxis de flujo de trabajo para {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions)" para elegir eventos a fin de activar una acción, agregar acciones y personalizar tu flujo de trabajo. - -1. Confirma tus cambios en el archivo de flujo de trabajo en la rama donde deseas que se ejecute tu flujo de trabajo. - -#### Ejemplo de archivo de flujo de trabajo - -{% raw %} -```yaml -nombre: Greet Everyone -# Este flujo de trabajo se desencadena en los envíos al repositorio. -on: [push] - -jobs: - build: - # Job name is Greeting - name: Greeting - # This job runs on Linux - runs-on: ubuntu-latest - steps: - # This step uses GitHub's hello-world-javascript-action: https://github.com/actions/hello-world-javascript-action - - name: Hello world - uses: actions/hello-world-javascript-action@v1.1 - with: - who-to-greet: 'Mona the Octocat' - id: hello - # This step prints an output (time) from the previous step's action. - - name: Echo the greeting's time - run: echo 'The time was ${{ steps.hello.outputs.time }}.' -``` -{% endraw %} - -{% data reusables.github-actions.invalid-workflow-files %} - -### Activar un flujo de trabajo con eventos - -Puedes configurar un flujo de trabajo para comenzar una vez: -- Se produce un evento en {% data variables.product.prodname_dotcom %}, como cuando alguien envía una confirmación a un repositorio o cuando se crea una propuesta o una solicitud de extracción -- Comienza un evento programado. -- Se produce un evento externo. - -Para activar un flujo de trabajo después de que ocurra un evento en {% data variables.product.prodname_dotcom %}, agrega `on:` y un valor de evento después del nombre del flujo de trabajo. Por ejemplo, este flujo de trabajo se activa cuando los cambios se envían a cualquier rama en el repositorio. - -```yaml -name: descriptive-workflow-name -on: push -``` - -Para programar un flujo de trabajo, puedes usar la sintaxis cron POSIX en tu archivo de flujo de trabajo. El intervalo más corto en el que puedes ejecutar flujos de trabajo programados es una vez cada 5 minutos. Por ejemplo, este flujo de trabajo se activa cada hora. - -```yaml -on: - schedule: - - cron: '0 * * * *' -``` - -#### Ejecutar un flujo de trabajo manualmente - -Para ejecutar un flujo de trabajo manualmente, primero debes configurarlo para que utilice el evento `workflow_dispatch`. Puedes configurar las propiedades de entrada definidas conforme a tu personalización, los valores de entrada predeterminados, y las entradas requeridas, directamente en tu flujo de trabajo. Cuando se ejecuta el flujod e trabajo, puedes acceder a los valores de entrada en el contexto de `github.event.inputs`. Para obtener más información, consulta la sección "[Eventos que activan los flujos de trabajo](/actions/reference/events-that-trigger-workflows/#workflow_dispatch)" y "[Sintaxis de contexto y expresión para {% data variables.product.prodname_dotcom %} Actions](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)". - -Este ejemplo define las entradas `name` y `home` y las imprime utilizando los contextos `github.event.inputs.name` y `github.event.inputs.home`. Si no se proporciona un `name`, se imprimirá el valor predeterminado 'Mona the Octocat'. - -{% raw %} -```yaml -name: Manually triggered workflow -on: - workflow_dispatch: - inputs: - name: - description: 'Person to greet' - required: true - default: 'Mona the Octocat' - home: - description: 'location' - required: false - -jobs: - say_hello: - runs-on: ubuntu-latest - steps: - - run: | - echo "Hello ${{ github.event.inputs.name }}!" - echo "- in ${{ github.event.inputs.home }}!" - echo "- in ${{ github.event.inputs.home }}!" -``` -{% endraw %} - -Puedes activar el evento de `workflow_dispatch` desde la pestaña de Acciones en {% data variables.product.prodname_dotcom %} o utilizar la API de REST. Puedes activar el evento de `workflow_dispatch` desde la pestaña de Acciones en {% data variables.product.prodname_dotcom %} o utilizar la API de REST. Para obtener más información acerca de cómo utilizar la API de REST, consulta la sección [Crear un evento de envío de flujo de trabajo](/rest/reference/actions/#create-a-workflow-dispatch-event)". Si omites las entradas, se utilizarán los valores predeterminados que se hayan definido en el flujo de trabajo. - -Para activar el evento `workflow_dispatch` en {% data variables.product.prodname_dotcom %}, tu flujo de trabajo deberá estar en la rama predeterminada. Sigue estos pasos para activar una ejecución de flujo de trabajo manualmente. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -1. En la barra lateral izquierda, da clic ene l flujo de trabajo que quieras ejecutar. ![flujo de trabajo de la selección en las acciones](/assets/images/actions-select-workflow.png) -1. Sobre la lista de ejecuciones de flujo de trabajo, selecciona **Ejecutar flujo de trabajo**. ![envío del flujo de trabajo de las acciónes](/assets/images/actions-workflow-dispatch.png) -1. Selecciona la rama en donde el flujo de trabajo se ejecutará y teclea los parámetros de entrada que éste utiliza. Da clic en **Ejecutar flujo de trabajo**. ![flujo de trabajo de la ejecución manual de las acciones](/assets/images/actions-manually-run-workflow.png) - -#### Activar flujos de trabajo desde eventos externos - -Para activar un flujo de trabajo después de que se produce un evento externo, puedes invocar un evento de webhook `repository_dispatch` llamando al punto final API REST "Create a repository dispatch event" (Crear un evento de despacho de repositorio). Para obtener más información, consulta la sección "[Crear un evento de envío de repositorio](/v3/repos/#create-a-repository-dispatch-event)". - -Para obtener más información y ejemplos, consulta "[Eventos que desencadenan flujos de trabajo](/articles/events-that-trigger-workflows#webhook-events)". - -### Filtrar por ramas, etiquetas y rutas específicas - -Puedes configurar tu flujo de trabajo para que se ejecute solo en ciertas ramas. - -Por ejemplo, este flujo de trabajo se ejecuta cuando una subida que incluye archivos en el directorio `test` se realiza en la rama `master` o sube a la etiqueta `v1`. - -```yaml -on: - push: - branches: - - master - tags: - - v1 - # file paths to consider in the event. Opcional; por defecto a todos. - paths: - - 'test/*' -``` - -Para obtener más información acerca de la sintaxis de filtro de ramas, de etiquetas y de rutas, consulta "[`on..`](/articles/workflow-syntax-for-github-actions#onpushpull_requestbranchestags)" y "[`on..paths`](/articles/workflow-syntax-for-github-actions#onpushpull_requestpaths)." - -### Elegir un ejecutor - -Puedes ejecutar flujos de trabajo en ejecutores alojados en {% data variables.product.prodname_dotcom %} o ejecutores autoalojados. Los trabajos se pueden ejecutar directamente en la máquina o en un contenedor Docker. - -Puedes especificar el ejecutor para cada trabajo en un flujo de trabajo usando `runs-on`. Para obtener más información acerca de `runs-on`, consulta "[Sintaxis de flujo de trabajo para {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idruns-on)". - -{% data reusables.actions.enterprise-github-hosted-runners %} - -#### Usar un ejecutor alojado en {% data variables.product.prodname_dotcom %} - -Puedes seleccionar entre diferentes tipos y versiones de máquinas host virtuales, incluidos Linux, Windows y macOS. Cada trabajo en un flujo de trabajo se ejecuta en una nueva instancia del entorno virtual y los pasos dentro de un trabajo pueden compartir información usando el sistema de archivos. Para obtener más información, consulta "[Entornos virtuales para ejecutores alojados en {% data variables.product.prodname_actions %}](/articles/virtual-environments-for-github-actions)." - -Por ejemplo, puedes usar `ubuntu-latest` para especificar la última versión de un ejecutor Ubuntu alojado en {% data variables.product.prodname_dotcom %}. - -```yaml -runs-on: ubuntu-latest -``` - -#### Usar un ejecutor autoalojado - -Puedes utilizar etiquetas para rutear los jobs a tipos diferentes de ejecutores auto-hospedados. Todos los ejecutores autoalojados obtienen la etiqueta `autoalojado` y cada ejecutor autoalojado tiene etiquetas para su sistema operativo y la arquitectura del sistema. Para obtener más información, consulta "[Usar ejecutores autoalojados en un flujo de trabajo](/actions/automating-your-workflow-with-github-actions/using-self-hosted-runners-in-a-workflow)." - -Por ejemplo, si agregaste un ejecutor autoalojado con un sistema operativo Linux y una arquitectura ARM32, puedes seleccionar ese ejecutor mediante las etiquetas `self-hosted`, `Linux` y `ARM32`. - -```yaml -runs-on: [autoalojado, linux, ARM32] -``` - -### Configurar una matriz de construcción - -Para probar en múltiples sistemas operativos, plataformas y versiones de idiomas al mismo tiempo, puedes configurar una matriz de construcción. - -Una matriz de construcción te permite probar tu código con diferentes configuraciones de software y de sistema operativo. Por ejemplo, un flujo de trabajo puede ejecutar un trabajo para más de una versión compatible de idioma, sistema operativo o herramienta. Para cada configuración, se ejecuta una copia del trabajo y se informa un estado. - -Puedes especificar una matriz de construcción en tu archivo de flujo de trabajo con una matriz que enumere las opciones de configuración en `estrategia:`. Por ejemplo, esta matriz de construcción ejecutará un trabajo con diferentes versiones de Node.js y Ubuntu, un sistema operativo Linux. - -{% data reusables.repositories.actions-matrix-builds-os %} - -{% raw %} -```yaml -runs-on: ${{ matrix.os }} -strategy: - matrix: - os: [ubuntu-16.04, ubuntu-18.04] - node: [6, 8, 10] -``` -{% endraw %} - -Para obtener más información, consulta [Sintaxis de flujo de trabajo para {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix). - -### Usar la acción de control - -Existen varias acciones estándar que puedes utilizar en tu flujo de trabajo. La acción de control es una acción estándar que debes incluir en tu flujo de trabajo antes que otras acciones cuando: -- Tu flujo de trabajo requiere una copia del código de tu repositorio, como cuando estás construyendo y probando tu repositorio o usando una integración continua. -- Hay al menos una acción en tu flujo de trabajo que se define en el mismo repositorio. Para obtener más información, consulta "[Hacer referencia a acciones en tu flujo de trabajo](#referencing-actions-in-your-workflow)". - -Para usar la acción de control estándar sin más especificaciones, incluye este paso: -```yaml -- uses: actions/checkout@v2 -``` -Si usas `v2` en este ejemplo te aseguras de estar usando una versión estable de la acción de control. Para obtener más información, consulta [la acción de control](https://github.com/jekyll/jemoji). - -### Elegir el tipo de acciones para tu flujo de trabajo - -Existen diferentes tipos de acciones que puedes usar en tu flujo de trabajo para satisfacer las necesidades de tu proyecto: -- Acciones del contenedor Docker -- Acciones de JavaScript -- Acciones compuestas de los pasos de ejecución - -Para obtener más información, consulta "[Acerca de acciones](/articles/about-teams/#team-pages)." - -Cuando elijas el tipo de acciones para utilizar en tu flujo de trabajo, te recomendamos que explores las acciones existentes en los repositorios públicos o en Docker Hub y puedas personalizar estas acciones para tu proyecto. - -Puedes explorar y usar acciones creadas por {% data variables.product.prodname_dotcom %} en la organización [github.com/actions](https://github.com/actions). Para visitar Docker Hub, consulta "[Docker Hub](https://www.docker.com/products/docker-hub)" en el sitio de Docker. - -### Hacer referencia a acciones en tu flujo de trabajo - -Para hacer referencia a acciones en tu archivo de flujo de trabajo con la sintaxis correcta, debes tener en cuentas dónde se define la acción. - -Los flujos de trabajo pueden usar acciones definidas en: -- Un repositorio público -- El mismo repositorio donde tu archivo de flujo de trabajo hace referencia a las acciones -- Una imagen del contenedor Docker publicada en Docker Hub - -Para usar una acción definida en un repositorio privado, tanto el archivo de flujo de trabajo como la acción deben estar en el mismo repositorio. Tu flujo de trabajo no puede utilizar acciones definidas en otros repositorios privados, incluso si el otro repositorio privado está en la misma organización. - -Para mantener estable tu flujo de trabajo, incluso cuando se actualiza una acción, puedes hacer referencia a la versión de la acción que estás utilizando y especificar un número de etiqueta de Git ref o Docker en tu archivo de flujo de trabajo. Para ver ejemplos, consulta "[Sintaxis del flujo de trabajo para {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idstepsuses)". - -{% if currentVersion == "free-pro-team@latest" %} -{% data reusables.dependabot.version-updates-for-actions %} -{% endif %} - -Para obtener opciones de configuración más detalladas, consulta "[Sintaxis del flujo de trabajo para {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)". - -#### Hacer referencia a una acción desde un repositorio público - -Si una acción se define en un repositorio público, debes hacer referencia a la acción utilizando la sintaxis `{owner}/{repo}@{ref}` o `{owner}/{repo}/{path}@{ref}`. - -```yaml -jobs: - my_first_job: - name: My Job Name - steps: - - uses: actions/setup-node@v1 - with: - node-version: 10.x -``` - -Para ver un ejemplo de flujo de trabajo completo, consulta el repositorio de plantillas del [nodo de configuración](https://github.com/actions/setup-node). - -#### Hacer referencia a una acción en el mismo repositorio en el que un archivo de flujo de trabajo usa la acción - -Si se define una acción en el mismo repositorio en el que tu archivo de flujo de trabajo usa la acción, puedes hacer referencia a la acción con ‌`{owner}/{repo}@{ref}` o la sintaxis `./path/to/dir` en tu archivo de flujo de trabajo. - -Ejemplo de estructura de archivo de repositorio: - -``` -|-- hello-world (repository) -| |__ .github -| └── workflows -| └── my-first-workflow.yml -| └── actions -| |__ hello-world-action -| └── action.yml -``` - -Ejemplo de archivo de flujo de trabajo: - -```yaml -jobs: - build: - runs-on: ubuntu-latest - steps: - # Este paso revisa una copia de tu repositorio. - - uses: actions/checkout@v2 - # Este paso hace referencia al directorio que contiene la acción. - - uses: ./.github/actions/hello-world-action -``` - -#### Hacer referencia a un contenedor en Docker Hub - -Si se define una acción en una imagen de contenedor Docker publicada en Docker Hub, debes hacer referencia a la acción con la sintaxis `docker://{image}:{tag}` en tu archivo de flujo de trabajo. Para proteger tu código y tus datos, te recomendamos que verifiques la integridad de la imagen del contenedor Docker de Docker Hub antes de usarla en tu flujo de trabajo. - -```yaml -jobs: - my_first_job: - steps: - - name: My first step - uses: docker://alpine:3.8 -``` - -Para ver algunos ejemplos de acciones de Docker, consulta el [Flujo de trabajo Docker-image.yml](https://github.com/actions/starter-workflows/blob/master/ci/docker-image.yml) y "[Crear una acción de contenedor Docker](/articles/creating-a-docker-container-action)". - -Para obtener más información, consulta "[Sintaxis del flujo de trabajo para {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idstepsuses)". - -### Agregar una credencial de estado de flujo de trabajo a tu repositorio - -{% data reusables.repositories.actions-workflow-status-badge-into %} - -Si tu flujo de trabajo usa la palabra clave `Nombre`, debes hacer referencia al flujo de trabajo por nombre. Si el nombre de tu flujo de trabajo contiene un espacio en blanco, deberás reemplazar el espacio con la cadena que codifica la URL `%20`. Para obtener más información sobre la palabra clave `name` (nombre), consulta "[Sintaxis de flujo de trabajo para {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#name)". - -``` -https://github.com///workflows//badge.svg -``` - -Como alternativa, si tu flujo de trabajo no tiene un `name`, debes hacer referencia al archivo de flujo de trabajo usando la ruta del archivo en relación con el directorio raíz del repositorio. - -{% note %} - -**Nota:** Hacer referencia al archivo de flujo de trabajo mediante la ruta del archivo no funciona si el flujo de trabajo tiene un `name`. - -{% endnote %} - -``` -https://github.com///workflows//badge.svg -``` - -#### Ejemplo de cómo usar un nombre de flujo de trabajo - -Este ejemplo de Markdown agrega una credencial de estado para un flujo de trabajo con el nombre "Greet Everyone". El `PROPIETARIO` del repositorio es la organización `actions` y el nombre del `REPOSITORIO` es `hello-world`. - -``` -![example workflow name](https://github.com/actions/hello-world/workflows/Greet%20Everyone/badge.svg) -``` - -#### Ejemplo de cómo usar una ruta de archivo de flujo de trabajo - -Este ejemplo de Markdown agrega una credencial de estado para un flujo de trabajo con la ruta de archivo `.github/workflows/main.yml`. El `PROPIETARIO` del repositorio es la organización `actions` y el nombre del `REPOSITORIO` es `hello-world`. - -``` -![example workflow file path](https://github.com/actions/hello-world/workflows/.github/workflows/main.yml/badge.svg) -``` - -#### Ejemplo con el parámetro `branch` - -Este ejemplo de Markdown añade un distintivo de estado para una rama con el nombre `feature-1`. - -``` -![example branch parameter](https://github.com/actions/hello-world/workflows/Greet%20Everyone/badge.svg?branch=feature-1) -``` - -#### Ejemplo con el parámetro `event` - -Este ejemplo de Markdown agrega un distintivo que muestra el estado de las ejecuciones de flujo de trabajo activadas por el evento `pull_request`. - -``` -![example event parameter](https://github.com/actions/hello-world/workflows/Greet%20Everyone/badge.svg?event=pull_request) -``` - -{% if currentVersion == "free-pro-team@latest" %} -### Leer más - -- "[Administrar la facturación para {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)" -{% endif %} diff --git a/translations/es-XL/content/actions/configuring-and-managing-workflows/configuring-and-managing-workflow-files-and-runs.md b/translations/es-XL/content/actions/configuring-and-managing-workflows/configuring-and-managing-workflow-files-and-runs.md deleted file mode 100644 index dd9ccccdfe23..000000000000 --- a/translations/es-XL/content/actions/configuring-and-managing-workflows/configuring-and-managing-workflow-files-and-runs.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: Configurar y administrar archivos de flujo de trabajo y ejecuciones -intro: Crea y configura flujos de trabajo para automatizar partes del desarrollo de tu proyecto. -mapTopic: true -redirect_from: - - /articles/configuring-workflows - - /github/automating-your-workflow-with-github-actions/configuring-workflows - - /actions/automating-your-workflow-with-github-actions/configuring-workflows -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/es-XL/content/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets.md b/translations/es-XL/content/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets.md deleted file mode 100644 index 93fdf8f142fb..000000000000 --- a/translations/es-XL/content/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets.md +++ /dev/null @@ -1,220 +0,0 @@ ---- -title: Crear y almacenar secretos cifrados -intro: Los secretos cifrados te permiten almacenar información sensible en tu repositorio u organización. -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets - - /actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Acerca de los secretos cifrados - -Los secretos son variables de ambiente cifradas que creas en un repositorio u organización. Los secretos que crees se encuentran disponibles para su uso en los flujos de trabajo de {% data variables.product.prodname_actions %}. {% data variables.product.prodname_dotcom %} utiliza una [caja sellada de libsodium](https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes) para ayudar a garantizar que los secretos se cifren antes de que lleguen a {% data variables.product.prodname_dotcom %} y que permanezcan cifrados hasta que los uses en un flujo de trabajo. - -{% data reusables.github-actions.secrets-org-level-overview %} - -#### Nombrar tus secretos - -Las siguientes reglas aplican a los nombres secretos: - -* Los nombres secretos solo contienen caracteres alfanuméricos (`[a-z]`, `[A-Z]`, `[0-9]`) o guiones bajos (`_`). No se permiten espacios. -* Los nombres secretos no deben comenzar con el prefijo `GITHUB_`. -* Los nombres secretos no deben comenzar con un número. -* Los nombres secretos deben ser únicos en el nivel en el que se hayan creado. Por ejemplo, un secreto que se crea a nivel de la organización debe tener un nombre único en ese nivel, y un secreto que se crea a nivel de un repositorio debe tener un nombre único en ese repositorio. Si un secreto a nivel de organización tiene el mismo nombre que uno a nivel de repositorio, entonces el que está a nivel del repositorio tomará precedencia. - -Para ayudarte a garantizar que {% data variables.product.prodname_dotcom %} redacta tus secretos en bitácoras, evita utilizar datos estructurados como los valores de los secretos. Por ejemplo, evita crear secretos que contengan JSON o blobs de Git codificados. - -#### Acceder a tus secretos - -Para hacer que un secreto esté disponible para una acción, debes configurar el secreto como una variable de entrada o de entorno en tu archivo de flujo de trabajo. Revisa el archivo README de la acción para saber qué variables de entrada y de entorno espera la acción. Para obtener más información, consulta "[Sintaxis del flujo de trabajo para{% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepsenv)". - -Puedes usar y leer secretos cifrados en un archivo de flujo de trabajo si tienes acceso para editar el archivo. Para obtener más información, consulta "[Permisos de acceso en {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/access-permissions-on-github)." - -{% warning %} - -**Advertencia:** {% data variables.product.prodname_dotcom %} redacta automáticamente secretos impresos en el registro, pero debes evitar imprimir secretos en el registro intencionalmente. - -{% endwarning %} - -También puedes administrar secretos utilizando la API de REST. Para obtener más información, consulta la sección "[Secretos](/v3/actions/secrets/)". - -#### Limitar permisos de credenciales - -Cuando generes credenciales, te recomendamos que otorgues los mínimos permisos posibles. Por ejemplo, en lugar de usar credenciales personales, usa [implementar claves](/v3/guides/managing-deploy-keys/#deploy-keys) o una cuenta de servicio. Considera otorgar permisos de solo lectura si eso es todo lo que se necesita, y limita el acceso lo máximo posible. Cuando generes un token de acceso personal (PAT), selecciona el menor número de ámbitos necesarios. - -### Crear secretos cifrados para un repositorio - -{% data reusables.github-actions.permissions-statement-secrets-repository %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -{% data reusables.github-actions.sidebar-secret %} -1. Haz clic en **Agregar secreto nuevo**. -1. Teclea un nombre para tu secreto en el cuadro de entrada **Name**. -1. Ingresa el valor de tu secreto. -1. Haz clic en **Agregar secreto** (Agregar secreto). - -Si tu repositorio puede acceder a secretos de la organización padre, entonces estos también se listarán en esta página. - -### Crear secretos cifrados para una organización - -Cuando creas un secreto en una organización, puedes utilizar una política para limitar el acceso de los repositorios a este. Por ejemplo, puedes otorgar acceso a todos los repositorios, o limitarlo a solo los repositorios privados o a una lista específica de estos. - -{% data reusables.github-actions.permissions-statement-secrets-organization %} - -{% data reusables.organizations.navigate-to-org %} -{% data reusables.organizations.org_settings %} -{% data reusables.github-actions.sidebar-secret %} -1. Da clic en **Secreto nuevo**. -1. Teclea un nombre para tu secreto en el cuadro de entrada **Name**. -1. Ingresa el **Valor** para tu secreto. -1. Desde la lista desplegable **Acceso de los repositorios**, elige una política de acceso. -1. Haz clic en **Agregar secreto** (Agregar secreto). - -### Revisar el acceso a los secretos de nivel organizacional - -Puedes revisar qué políticas de acceso se están aplicando a un secreto en tu organización. - -{% data reusables.organizations.navigate-to-org %} -{% data reusables.organizations.org_settings %} -{% data reusables.github-actions.sidebar-secret %} -1. La lista de secretos incluye cualquier política y permiso configurado. Por ejemplo: ![Lista de secretos](/assets/images/help/settings/actions-org-secrets-list.png) -1. Para encontrar más detalles sobre los permisos configurados para cada secreto, da clic en **Actualizar**. - -### Usar secretos cifrados en un flujo de trabajo - -Con la excepción de `GITHUB_TOKEN`, los secretos no se pasan al ejecutador cuando un flujo de trabajo se dispara desde un repositorio bifurcado. - -Para proporcionar una acción con un secreto como variable de entrada o de entorno, puedes usar el contexto de `secrets` para acceder a los secretos que has creado en tu repositorio. Para obtener más información, consulta "[Sintaxis de contexto y de expresiones para {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions) y [Sintaxis de flujo de trabajo para {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)". - -{% raw %} -```yaml -steps: - - name: Hello world action - with: # Set the secret as an input - super_secret: ${{ secrets.SuperSecret }} - env: # Or as an environment variable - super_secret: ${{ secrets.SuperSecret }} -``` -{% endraw %} - -Evita pasar secretos entre procesos desde la línea de comando, siempre que sea posible. Los procesos de la línea de comando pueden ser visibles para otros usuarios (utilizando el comando `ps`) o ser capturados por [eventos de auditoría de seguridad](https://docs.microsoft.com/en-us/windows-server/identity/ad-ds/manage/component-updates/command-line-process-auditing). Para ayudar a proteger los secretos, considera usar variables de entorno, `STDIN` u otros mecanismos admitidos por el proceso de destino. - -Si debes pasar secretos dentro de una línea de comando, enciérralos usando las normas de uso de comillas adecuadas. Los secretos suelen contener caracteres especiales que pueden afectar involuntariamente a tu shell. Para evitar estos caracteres especiales, usa comillas en tus variables de entorno. Por ejemplo: - -#### Ejemplo usando Bash - -{% raw %} -```yaml -steps: - - shell: bash - env: - SUPER_SECRET: ${{ secrets.SuperSecret }} - run: | - example-command "$SUPER_SECRET" -``` -{% endraw %} - -#### Ejemplo usando PowerShell - -{% raw %} -```yaml -steps: - - shell: pwsh - env: - SUPER_SECRET: ${{ secrets.SuperSecret }} - run: | - example-command "$env:SUPER_SECRET" -``` -{% endraw %} - -#### Ejemplo usando Cmd.exe - -{% raw %} -```yaml -steps: - - shell: cmd - env: - SUPER_SECRET: ${{ secrets.SuperSecret }} - run: | - example-command "%SUPER_SECRET%" -``` -{% endraw %} - -### Límites para los secretos - -Tu flujo de trabajo puede tener hasta 100 secretos. Los nombres de las variables de entorno secretas deben ser únicos en un repositorio. - -Los secretos tienen un tamaño máximo de 64 KB. Para usar secretos de un tamaño mayor a 64 KB, puedes almacenar los secretos cifrados en tu repositorio y guardar la contraseña de descifrado como un secreto en {% data variables.product.prodname_dotcom %}. Por ejemplo, puedes usar `gpg` para cifrar tus credenciales de manera local antes de verificar el archivo en tu repositorio en {% data variables.product.prodname_dotcom %}. Para obtener más información, consulta la página del manual "[gpg](https://www.gnupg.org/gph/de/manual/r1023.html)". - -{% warning %} - -**Advertencia**: Evita que tus secretos se impriman cuando se ejecute tu acción. Cuando usas esta solución, {% data variables.product.prodname_dotcom %} no redacta los secretos que están impresos en los registros. - -{% endwarning %} - -1. Ejecuta el siguiente comando en tu terminal para cifrar el archivo `my_secret.json` usando `gpg` y el algoritmo de cifras AES256. - - ``` shell - $ gpg --symmetric --cipher-algo AES256 my_secret.json - ``` - -1. Se te pedirá que ingreses una contraseña. Recuerda la contraseña, porque deberás crear un nuevo secreto en {% data variables.product.prodname_dotcom %} que use esa contraseña como valor. - -1. Crear un nuevo secreto que contiene la frase de acceso. Por ejemplo, crea un nuevo secreto con el nombre `LARGE_SECRET_PASSPHRASE` y establece el valor del secreto para la contraseña que seleccionaste en el paso anterior. - -1. Copia tu archivo cifrado en tu repositorio y confírmalo. En este ejemplo, el archivo cifrado es `my_secret.json.gpg`. - -1. Crea un script shell para descifrar la contraseña. Guarda este archivo como `decrypt_secret.sh`. - - ``` shell - #!/bin/sh - - # Decrypt the file - mkdir $HOME/secrets - # --batch to prevent interactive command - # --yes to assume "yes" for questions - gpg --quiet --batch --yes --decrypt --passphrase="$LARGE_SECRET_PASSPHRASE" \ - --output $HOME/secrets/my_secret.json my_secret.json.gpg - ``` - -1. Asegúrate de que tu shell script sea ejecutable antes de verificarlo en tu repositorio. - - ``` shell - $ chmod +x decrypt_secret.sh - $ git add decrypt_secret.sh - $ git commit -m "Add new decryption script" - $ git push - ``` - -1. En tu flujo de trabajo, usa un `step` para llamar al shell script y descifrar el secreto. Para tener una copia de tu repositorio en el entorno en el que se ejecuta tu flujo de trabajo, deberás usar la acción [`code>actions/checkout`](https://github.com/actions/checkout). Haz referencia a tu shell script usando el comando `run` relacionado con la raíz de tu repositorio. - -{% raw %} - ```yaml - name: Workflows with large secrets - - on: push - - jobs: - my-job: - name: My Job - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - - name: Decrypt large secret - run: ./.github/scripts/decrypt_secret.sh - env: - LARGE_SECRET_PASSPHRASE: ${{ secrets.LARGE_SECRET_PASSPHRASE }} - # Este comando es solo un ejemplo para mostrar cómo se imprime tu secreto. - # Asegúrate de eliminar las declaraciones impresas de tus secretos. GitHub - # no oculta los secretos que usan esta solución. - - name: Test printing your secret (Elimina este paso en la producción) - run: cat $HOME/secrets/my_secret.json - ``` -{% endraw %} diff --git a/translations/es-XL/content/actions/configuring-and-managing-workflows/creating-postgresql-service-containers.md b/translations/es-XL/content/actions/configuring-and-managing-workflows/creating-postgresql-service-containers.md deleted file mode 100644 index c4b01bff0796..000000000000 --- a/translations/es-XL/content/actions/configuring-and-managing-workflows/creating-postgresql-service-containers.md +++ /dev/null @@ -1,327 +0,0 @@ ---- -title: Crear contenedores de servicios PostgreSQL -intro: 'Puedes crear un contenedor de servicios PostgreSQL para usar en tu flujo de trabajo. En esta guía se muestran ejemplos de cómo crear un servicio PostgreSQL para trabajos que se ejecutan en contenedores o, directamente, en la máquina del ejecutor.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /Actions/Automating-Your-Workflow-with-GitHub-Actions/Creating-PostgreSQL-Service-containers -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Introducción - -En esta guía se muestran ejemplos de flujos de trabajo que configuran un contenedor de servicios mediante la imagen `postgres` de Docker Hub. El flujo de trabajo ejecuta un script para crear un cliente de PostgreSQL y rellenarlo con datos. Para probar que el flujo de trabajo crea y rellena el cliente de PostgreSQL, el script imprime los datos del cliente en la consola. - -{% data reusables.github-actions.docker-container-os-support %} - -### Prerrequisitos - -{% data reusables.github-actions.service-container-prereqs %} - -También puede ser útil tener un conocimiento básico de YAML, la sintaxis para las {% data variables.product.prodname_actions %}, y de PostgreSQL. Para obtener más información, consulta: - -- "[Configurar un flujo de trabajo](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)" -- "[Tutorial de PostgreSQL](https://www.postgresqltutorial.com/)" en la documentación de PostgreSQL -- "[Conceptos básicos para {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)" -- "[Usar variables de entorno](/actions/automating-your-workflow-with-github-actions/using-environment-variables)" - -### Ejecutar trabajos en contenedores - -{% data reusables.github-actions.container-jobs-intro %} - -{% data reusables.github-actions.copy-workflow-file %} - -{% raw %} -```yaml -name: PostgreSQL service example -on: push - -Jobs: - # Etiqueta del trabajo del contenedor - container-job: - # Los contenedores deben ejecutarse en sistemas operativos basados en Linux - runs-on: Ubuntu-latest - # Imagen de Docker Hub que ejecuta 'container-job ' en - el contenedor: node:10.18-jessie - - # Contenedores de servicios para ejecutar con servicios de 'container-job ': - # Etiqueta usada para acceder al contenedor de servicios - Postgres: - # Imagen de Docker Hub - image: postgres - # Proporciona la contraseña para Postgres - env: - POSTGRES_PASSWORD: postgres - # Establece chequeos de estado para esperar hasta que postgres inicie las - opciones: >- - --health-cmd pg_isready - --health-interval 10s - --health-timeout 5s - --health-retries 5 - - Steps: - # Descarga una copia del código en tu repositorio antes de ejecutar pruebas de CI - - name: Check out repository code - uses: actions/checkout@v2 - - # Realiza una instalación limpia de todas las dependencias en el archivo 'package.json' - # Para obtener más información, consulta https://docs.npmjs.com/cli/ci.html - - name: Install dependencies - run: npm ci - - - name: Connect to PostgreSQL - # Ejecuta un script que crea un cliente de PostgreSQL, rellena - # el cliente con datos y recupera datos - run: node client.js - # Variable de entorno utilizada por el script 'client.js' para crear un nuevo cliente de PostgreSQL. - env: - # Nombre del host utilizado para comunicarse con el contenedor de servicios PostgreSQL - POSTGRES_HOST: Postgres - # Puerto PostgreSQL predeterminado - POSTGRES_PORT: 5432 -``` -{% endraw %} - -#### Configurar el trabajo del ejecutador - -{% data reusables.github-actions.service-container-host %} - -{% data reusables.github-actions.postgres-label-description %} - -```yaml -jobs: - # Etiqueta del trabajo del contenedor - container-job: - # Los contenedores deben ejecutarse en sistemas operativos basados en Linux - runs-on: ubuntu-latest - # Imagen de Docker Hub que `container-job` ejecuta en el contenedor: node:10.18-jessie - - # Contenedores de servicios para ejecutar con servicios de `container-job`: - # Etiqueta utilizada para acceder al contenedor de servicios - redis: - # Imagen de Docker Hub - image: redis - # Establece revisiones de estado para esperar hasta que Redis inicie las - opciones: >- - --health-cmd "redis-cli ping" - --health-interval 10s - --health-timeout 5s - --health-retries 5 -``` - -#### Configurar los pasos - -{% data reusables.github-actions.service-template-steps %} - -```yaml -steps: - # Descarga una copia del código en tu repositorio antes de ejecutar pruebas de CI - - name: Check out repository code - uses: actions/checkout@v2 - - # Realiza una instalación limpia de todas las dependencias en el archivo 'package.json' - # Para obtener más información, consulta https://docs.npmjs.com/cli/ci.html - - name: Install dependencies - run: npm ci - - - name: Connect to PostgreSQL - # Ejecuta un script que crea un cliente de PostgreSQL, rellena - # el cliente con datos y recupera datos - run: node client.js - # Variable de entorno utilizada por el script 'client.js ' para crear - # un nuevo cliente de PostgreSQL. - env: - # Nombre del host utilizado para comunicarse con el contenedor de servicios PostgreSQL - POSTGRES_HOST: Postgres - # Puerto PostgreSQL predeterminado - POSTGRES_PORT: 5432 -``` - -{% data reusables.github-actions.postgres-environment-variables %} - -El nombre del host del servicio PostgreSQL es la etiqueta que configuraste en tu flujo de trabajo, en este caso, `postgres`. Dado que los contenedores de Docker de la misma red de puentes definida por el usuario abren todos los puertos por defecto, podrás acceder al contenedor de servicios en el puerto 5432 PostgreSQL predeterminado. - -### Ejecutar trabajos directamente en la máquina del ejecutor - -Cuando ejecutes un trabajo directamente en la máquina del ejecutor, deberás asignar los puertos del contenedor de servicios a los puertos del host de Docker. Puedes acceder a los contenedores de servicios desde el host de Docker utilizando `localhost` y el número de puerto del host de Docker. - -{% data reusables.github-actions.copy-workflow-file %} - -{% raw %} -```yaml -name: PostgreSQL Service Example -on: push - -Jobs: - # Etiqueta del trabajo del ejecutador - runner-job: - # Debes usar un entorno Linux cuando uses contenedores de servicios o trabajos del contenedor - runs-on: ubuntu-latest - - # Contenedores de servicios para ejecutar con servicios de 'runner-job': - # Etiqueta usada para acceder al contenedor de servicios - postgres: - # Imagen de Docker Hub - image: postgres - # Proporciona la contraseña para postgres - env: - POSTGRES_PASSWORD: Postgres - # Establece chequeos de estado para esperar hasta que postgres inicie las - opciones: >- - --health-cmd pg_isready - --health-interval 10s - --health-timeout 5s - --health-retries 5 - ports: - # Asigna el puerto tcp 5432 del contenedor de servicios al host - -5432:5432 - - Steps: - # Descarga una copia del código en tu repositorio antes de ejecutar pruebas de CI - - name: Check out repository code - uses: actions/checkout@v2 - - # Realiza una instalación limpia de todas las dependencias en el archivo 'package.json' - # Para obtener más información, consulta https://docs.npmjs.com/cli/ci.html - - name: Install dependencies - run: npm ci - - - name: Connect to PostgreSQL - # Ejecuta un script que crea un cliente de PostgreSQL, rellena - # el cliente con datos y recupera datos - Run: node client.js - # Variable de entorno utilizada por el script 'client.js' para crear - # un nuevo cliente de PostgreSQL. - env: - # Nombre del host utilizado para comunicarse con el contenedor de servicios PostgreSQL - POSTGRES_HOST: localhost - # Puerto PostgreSQL predeterminado - POSTGRES_PORT: 5432 -``` -{% endraw %} - -#### Configurar el trabajo del ejecutador - -{% data reusables.github-actions.service-container-host-runner %} - -{% data reusables.github-actions.postgres-label-description %} - -El flujo de trabajo asigna el puerto 5432 del contenedor de servicios PostgreSQL al host de Docker. Para obtener más información acerca de la palabra clave `ports`, consulta "[Acerca de los contenedores de servicio](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)". - -```yaml -jobs: - # Etiqueta del trabajo del ejecutador - Runner-Job: - # Debes usar un entorno Linux cuando uses contenedores de servicios o trabajos del contenedor - runs-on: ubuntu-latest - - # Contenedores de servicios para ejecutar con servicios 'runner-job': - # Etiqueta usada para acceder al contenedor de servicios - Postgres: - # Imagen de Docker Hub - image: postgres - # Proporciona la contraseña para postgres - Env: - POSTGRES_PASSWORD: postgres - # Establece chequeos de estado para esperar hasta que postgres inicie las - opciones: >- - --health-cmd pg_isready - --health-interval 10s - --health-timeout 5s - --health-retries 5 - Ports: - # Asigna el puerto tcp 5432 del contenedor de servicios al host - -5432:5432 -``` - -#### Configurar los pasos - -{% data reusables.github-actions.service-template-steps %} - -```yaml -steps: - # Descarga una copia del código en tu repositorio antes de ejecutar pruebas de CI - - name: Check out repository code - uses: actions/checkout@v2 - - # Realiza una instalación limpia de todas las dependencias en el archivo 'package.json' - # Para obtener más información, consulta https://docs.npmjs.com/cli/ci.html - - name: Install dependencies - run: npm ci - - - name: Connect to PostgreSQL - # Ejecuta un script que crea un cliente de PostgreSQL, rellena - # el cliente con datos y recupera datos - run: node client.js - # Variable de entorno utilizada por el script 'client.js ' para crear - # un nuevo cliente de PostgreSQL. - env: - # Nombre del host utilizado para comunicarse con el contenedor de servicios PostgreSQL - POSTGRES_HOST: localhost - # Puerto PostgreSQL predeterminado - POSTGRES_PORT: 5432 -``` - -{% data reusables.github-actions.postgres-environment-variables %} - -{% data reusables.github-actions.service-container-localhost %} - -### Probar el contenedor de servicios de PostgreSQL - -Puedes probar tu flujo de trabajo usando el siguiente script, que crea un cliente de PostgreSQL y agrega una tabla nueva con algunos datos de marcador de posición. Luego, el script le imprime los valores almacenados en el cliente de PostgreSQL al terminal. Tu script puede usar el lenguaje que quieras, pero este ejemplo usa Node.js y el módulo npm de `pg`. Para obtener más información, consulta el [módulo npm de pg](https://www.npmjs.com/package/pg). - -Puedes modificar *client.js* para incluir cualquier operación de PostgreSQL que necesite tu flujo de trabajo. En este ejemplo, el script crea la instancia de cliente de PostgreSQL, crea una tabla, agrega datos de marcador de posición y luego recupera los datos. - -{% data reusables.github-actions.service-container-add-script %} - -```javascript -const { Client } = require('pg'); - -const pgclient = new Client({ - host: process.env.POSTGRES_HOST, - port: process.env.POSTGRES_PORT, - user: 'postgres', - password: 'postgres', - database: 'postgres' -}); - -pgclient.connect(); - -const table = 'CREATE TABLE student(id SERIAL PRIMARY KEY, firstName VARCHAR(40) NOT NULL, lastName VARCHAR(40) NOT NULL, age INT, address VARCHAR(80), email VARCHAR(40))' -const text = 'INSERT INTO student(firstname, lastname, age, address, email) VALUES($1, $2, $3, $4, $5) RETURNING *' -const values = ['Mona the', 'Octocat', 9, '88 Colin P Kelly Jr St, San Francisco, CA 94107, United States', 'octocat@github.com'] - -pgclient.query(table, (err, res) => { - if (err) throw err -}); - -pgclient.query(text, values, (err, res) => { - if (err) throw err -}); - -pgclient.query('SELECT * FROM student', (err, res) => { - if (err) throw err - console.log(err, res.rows) // Print the data in student table - pgclient.end() -}); -``` - -El script crea un nuevo `Client` (cliente) de PostgreSQL, que acepta un `host` y un parámetro de `port` (puerto). El script usa las variables de entorno `POSTGRES_HOST` y `POSTGRES_PORT` para establecer la dirección IP y el puerto del cliente. Si `host` y `port` no están definidos, el host predeterminado es `localhost` y el puerto predeterminado es 5432. - -El script crea una tabla y la rellena con datos de marcador de posición. Para probar que la base de datos de PostgreSQL contenga los datos, el script imprime los contenidos de la tabla en el registro de la consola. - -Cuando ejecutes este flujo de trabajo, debes ver el siguiente resultado en el paso "Connect to PostgreSQL" (Conectar con PostgreSQL) que confirma que creaste el cliente de PostgreSQL y agregaste los datos: - -``` -null [ { id: 1, - firstname: 'Mona the', - lastname: 'Octocat', - age: 9, - address: - '88 Colin P Kelly Jr St, San Francisco, CA 94107, United States', - email: 'octocat@github.com' } ] -``` diff --git a/translations/es-XL/content/actions/configuring-and-managing-workflows/creating-redis-service-containers.md b/translations/es-XL/content/actions/configuring-and-managing-workflows/creating-redis-service-containers.md deleted file mode 100644 index ea5792da15f1..000000000000 --- a/translations/es-XL/content/actions/configuring-and-managing-workflows/creating-redis-service-containers.md +++ /dev/null @@ -1,322 +0,0 @@ ---- -title: Crear contenedores de servicio Redis -intro: Puedes usar los contenedores de servicio para crear un cliente Redis en tu flujo de trabajo. En esta guía se muestran ejemplos de cómo crear un servicio Redis para los trabajos que se ejecutan en contenedores o directamente en la máquina ejecutor. -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/creating-redis-service-containers -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Introducción - -En esta guía se muestran ejemplos de flujo de trabajo que configuran un contenedor de servicio mediante la imagen `redis` de Docker Hub. El flujo de trabajo ejecuta un script para crear un cliente Redis y rellenar el cliente con datos. Para probar que el flujo de trabajo crea y rellena el cliente Redis, el script imprime los datos del cliente en la consola. - -{% data reusables.github-actions.docker-container-os-support %} - -### Prerrequisitos - -{% data reusables.github-actions.service-container-prereqs %} - -También puede ser útil tener una comprensión básica de YAML, la sintaxis para {% data variables.product.prodname_actions %}, y Redis. Para obtener más información, consulta: - -- "[Configurar un flujo de trabajo](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)" -- "[Comenzar con Redis](https://redislabs.com/get-started-with-redis/)"en la documentación de Redis -- "[Conceptos básicos para {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)" -- "[Usar variables de entorno](/actions/automating-your-workflow-with-github-actions/using-environment-variables)" - -### Ejecutar trabajos en contenedores - -{% data reusables.github-actions.container-jobs-intro %} - -{% data reusables.github-actions.copy-workflow-file %} - -{% raw %} -```yaml -name: Redis container example -on: push - -jobs: - # Etiqueta del trabajo del contenedor - container-job: - # Los contenedores deben ejecutarse en sistemas operativos basados en Linux - runs-on: ubuntu-latest - # Imagen de Docker Hub que `container-job` ejecuta en el contenedor: node:10.18-jessie - - # Contenedores de servicio para ejecutar con `container-job` - services: - # Etiqueta usada para acceder al contenedor de servicio redis: - # Imagen del contenedor Docker Hub - image: redis - # Establece revisiones de estado para esperar hasta que Redis haya comenzado - options: >- - --health-cmd "redis-cli ping" - --health-interval 10s - --health-timeout 5s - --health-retries 5 - - steps: - # Descarga una copia del código en tu repositorio antes de ejecutar pruebas de CI - - name: Check out repository code - uses: actions/checkout@v2 - - # Realiza una instalación limpia de todas las dependencias en el archivo `package.json` - # Para obtener más información, consulta https://docs.npmjs.com/cli/ci.html - - name: Install dependencies - run: npm ci - - - name: Connect to Redis - # Ejecuta un script que crea un cliente Redis, rellena - # el cliente con datos y recupera datos - run: node client.js - # Variable de entorno utilizada por el script `client.js` para crear un nuevo cliente Redis. - env: - # El nombre del host utilizado para comunicarse con el contenedor de servicio Redis - REDIS_HOST: redis - # El puerto Redis predeterminado - REDIS_PORT: 6379 -``` -{% endraw %} - -#### Configurar el trabajo del contenedor - -{% data reusables.github-actions.service-container-host %} - -{% data reusables.github-actions.redis-label-description %} - -```yaml -jobs: - # Etiqueta del trabajo del contenedor - container-job: - # Los contenedores deben ejecutarse en sistemas operativos basados en Linux - runs-on: ubuntu-latest - # Imagen de Docker Hub que `container-job` ejecuta en el contenedor: node:10.18-jessie - - # Contenedores de servicio para ejecutar con `container-job` - services: - # Etiqueta utilizada para acceder al contenedor de servicio - redis: - # Imagen de Docker Hub - image: redis - # Establece revisiones de estado para esperar hasta que Redis haya comenzado - options: >- - --health-cmd "redis-cli ping" - --health-interval 10s - --health-timeout 5s - --health-retries 5 -``` - -#### Configurar los pasos - -{% data reusables.github-actions.service-template-steps %} - -```yaml -steps: - # Descarga una copia del código en tu repositorio antes de ejecutar pruebas de CI - - name: Check out repository code - uses: actions/checkout@v2 - - # Realiza una instalación limpia de todas las dependencias en el archivo `package.json` - # Para obtener más información, consulta https://docs.npmjs.com/cli/ci.html - - name: Install dependencies - run: npm ci - - - name: Connect to Redis - # Ejecuta un script que crea un cliente Redis, rellena - # el cliente con datos y recupera datos - run: node client.js - # Variable de entorno utilizada por el script `client.js` para crear un nuevo cliente Redis. - env: - # El nombre del host utilizado para comunicarse con el contenedor del servicio Redis - REDIS_HOST: redis - # El puerto Redis predeterminado - REDIS_PORT: 6379 -``` - -{% data reusables.github-actions.redis-environment-variables %} - -El nombre del host del servicio Redis es la etiqueta que configuraste en tu flujo de trabajo, en este caso, `redis`. Dado que los contenedores Docker en la misma red de puentes definida por el usuario abren todos los puertos por defecto, podrás acceder al contenedor del servicio en el puerto Redis predeterminado 6379. - -### Ejecutar trabajos directamente en la máquina del ejecutor - -Cuando ejecutes un trabajo directamente en la máquina del ejecutor, deberás asignar los puertos del contenedor de servicios a los puertos del host de Docker. Puedes acceder a los contenedores de servicios desde el host de Docker utilizando `localhost` y el número de puerto del host de Docker. - -{% data reusables.github-actions.copy-workflow-file %} - -{% raw %} -```yaml -name: Redis runner example -on: push - -jobs: - # Etiqueta del trabajo del ejecutor - runner-job: - # Debes usar un entorno Linux cuando utilices contenedores de servicio o trabajos de contenedor - runs-on: ubuntu-latest - - # Contenedores de servicio para ejecutar con `runner-job` - services: - # Etiqueta usada para acceder al contenedor de servicio - redis: - # Imagen de Docker Hub - image: redis - # Establece revisiones de estado para esperar hasta que Redis haya comenzado - options: >- - --health-cmd "redis-cli ping" - --health-interval 10s - --health-timeout 5s - --health-retries 5 - ports: - # Asigna el puerto 6379 en el contenedor de servicio al host - - 6379:6379 - - steps: - # Descarga una copia del código en tu repositorio antes de ejecutar pruebas de CI - - name: Check out repository code - uses: actions/checkout@v2 - - # Realiza una instalación limpia de todas las dependencias en el archivo `package.json` - # Para obtener más información, consulta https://docs.npmjs.com/cli/ci.html - - name: Install dependencies - run: npm ci - - - name: Connect to Redis - # Ejecuta un script que crea un cliente Redis, rellena - # el cliente con datos y recupera datos - run: node client.js - # Variable de entorno utilizada por el script `client.js` para crear - # un nuevo cliente Redis. - env: - # El nombre del host utilizado para comunicarse con el contenedor del servicio Redis - REDIS_HOST: localhost - # El puerto Redis predeterminado - REDIS_PORT: 6379 -``` -{% endraw %} - -#### Configurar el trabajo del ejecutador - -{% data reusables.github-actions.service-container-host-runner %} - -{% data reusables.github-actions.redis-label-description %} - -El flujo de trabajo asigna el puerto 6379 en el contenedor del servicio Redis al host Docker. Para obtener más información acerca de la palabra clave `ports`, consulta "[Acerca de los contenedores de servicio](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)". - -```yaml -jobs: - # Etiqueta del trabajo del ejecutor - runner-job: - # Debes usar un entorno Linux cuando utilices contenedores de servicio o trabajos de contenedor - runs-on: ubuntu-latest - - # Contenedores de servicio para ejecutar con `runner-job` - services: - # Etiqueta usada para acceder al contenedor de servicio - redis: - # Imagen de Docker Hub - image: redis - # Establece revisiones de estado para esperar hasta que Redis haya comenzado - options: >- - --health-cmd "redis-cli ping" - --health-interval 10s - --health-timeout 5s - --health-retries 5 - ports: - # Asigna el puerto 6379 en el contenedor de servicio al host - - 6379:6379 -``` - -#### Configurar los pasos - -{% data reusables.github-actions.service-template-steps %} - -```yaml -steps: - # Descarga una copia del código en tu repositorio antes de ejecutra pruebas de CI - - name: Check out repository code - uses: actions/checkout@v2 - - # Realiza una instalación limpia de todas las dependencias en el archivo `package.json` - # Para obtener más información, consulta https://docs.npmjs.com/cli/ci.html - - name: Install dependencies - run: npm ci - - - name: Connect to Redis - # Ejecuta un script que crea un cliente Redis, rellena - # el cliente con datos y recupera datos - run: node client.js - # Variable de entorno utilizada por el script `client.js` para crear - # un nuevo cliente Redis. - env: - # El nombre del host utilizado para comunicarse con el contenedor del servicio Redis - REDIS_HOST: localhost - # El puerto Redis predeterminado - REDIS_PORT: 6379 -``` - -{% data reusables.github-actions.redis-environment-variables %} - -{% data reusables.github-actions.service-container-localhost %} - -### Probar el contenedor de servicio Redis - -Puedes probar tu flujo de trabajo usando el siguiente script, que crea un cliente Redis y rellena el cliente con algunos datos del marcador de posición. Luego, el script imprime los valores almacenados en el cliente Redis en el terminal. Tu script puede usar cualquier lenguaje que desees, pero este ejemplo usa Node.js y el módulo de npm `redis`. Para obtener más información, consulta el [Módulo Redis de npm](https://www.npmjs.com/package/redis). - -Puedes modificar *client.js* para incluir cualquier operación de Redis que necesite tu flujo de trabajo. En este ejemplo, el script crea la instancia del cliente Redis, agrega datos de marcador de posición y luego recupera los datos. - -{% data reusables.github-actions.service-container-add-script %} - -```javascript -const redis = require("redis"); - -// Crea un nuevo cliente Redis -// Si no se establece REDIS_HOST, el host predeterminado es localhost -// Si no se establece REDIS_PORT, el puerto predeterminado es 6379 -const redisClient = redis.createClient({ - host: process.env.REDIS_HOST, - port: process.env.REDIS_PORT -}); - -redisClient.on("error", function(err) { - console.log("Error " + err); -}); - -// Establece la clave "octocat" para un valor de "Mona the octocat" -redisClient.set("octocat", "Mona the Octocat", redis.print); -// Establece una clave "octocat", campo para "species" y "value" para "Cat and Octopus" -redisClient.hset("species", "octocat", "Cat and Octopus", redis.print); -// Establece una clave para "octocat", campo para "species" y "value" para "Dinosaur and Octopus" -redisClient.hset("species", "dinotocat", "Dinosaur and Octopus", redis.print); -// Establece una clave para "octocat", campo para "species" y "value" para "Cat and Robot" -redisClient.hset(["species", "robotocat", "Cat and Robot"], redis.print); -// Obtiene todos los campos en la clave "species" - -redisClient.hkeys("species", function (err, replies) { - console.log(replies.length + " replies:"); - replies.forEach(function (reply, i) { - console.log(" " + i + ": " + reply); - }); - redisClient.quit(); -}); -``` - -El script crea un nuevo cliente Redis utilizando el método `createClient`, que acepta un parámetro de `host` y `port`. El script usa el `REDIS_HOST` y variables de entorno `REDIS_PORT` para establecer la dirección IP y el puerto del cliente. Si `host` y `port` no están definidos, el host predeterminado es `localhost` y el puerto predeterminado es 6379. - -El script usa los métodos `set` y `hset` para rellenar la base de datos con algunas claves, campos y valores. Para confirmar que el cliente Redis contiene los datos, el script imprime los contenidos de la base de datos en el registro de la consola. - -Cuando ejecutas este flujo de trabajo, deberías ver el siguiente resultado en el paso "Conectar con Redis" que confirma que creaste el cliente Redis y agregaste datos: - -``` -Reply: OK -Reply: 1 -Reply: 1 -Reply: 1 -3 replies: - 0: octocat - 1: dinotocat - 2: robotocat -``` diff --git a/translations/es-XL/content/actions/configuring-and-managing-workflows/index.md b/translations/es-XL/content/actions/configuring-and-managing-workflows/index.md deleted file mode 100644 index 8462b818caa7..000000000000 --- a/translations/es-XL/content/actions/configuring-and-managing-workflows/index.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Configurar y administrar flujos de trabajo -shortTitle: Flujos de trabajo -intro: Puedes crear flujos de trabajo personalizados y administrar ejecuciones para controlar los procesos del ciclo de vida de desarrollo de software de tu proyecto. -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -{% topic_link_in_list /configuring-and-managing-workflow-files-and-runs %} - {% link_in_list /configuring-a-workflow %} - {% link_in_list /managing-a-workflow-run %} - {% link_in_list /sharing-workflow-templates-within-your-organization %} -{% topic_link_in_list /using-variables-and-secrets-in-a-workflow %} - {% link_in_list /creating-and-storing-encrypted-secrets %} - {% link_in_list /using-environment-variables %} - {% link_in_list /authenticating-with-the-github_token %} -{% topic_link_in_list /caching-and-storing-workflow-data %} - {% link_in_list /persisting-workflow-data-using-artifacts %} - {% link_in_list /caching-dependencies-to-speed-up-workflows %} -{% topic_link_in_list /using-databases-and-service-containers %} - {% link_in_list /about-service-containers %} - {% link_in_list /creating-redis-service-containers %} - {% link_in_list /creating-postgresql-service-containers %} diff --git a/translations/es-XL/content/actions/configuring-and-managing-workflows/managing-a-workflow-run.md b/translations/es-XL/content/actions/configuring-and-managing-workflows/managing-a-workflow-run.md deleted file mode 100644 index 93c1fcf675d3..000000000000 --- a/translations/es-XL/content/actions/configuring-and-managing-workflows/managing-a-workflow-run.md +++ /dev/null @@ -1,186 +0,0 @@ ---- -title: Administrar una ejecución de flujo de trabajo -intro: 'Puedes ver el estado y resultados de cada paso en tu flujo de trabajo, cancelar un flujo de trabajo pendiente, ver los minutos de ejecución facturables para jobs, depurar y volver a ejecutar un flujo de trabajo fallido, buscar y descargar bitácoras y descargar artefactos.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/viewing-your-repository-s-workflows - - /articles/viewing-your-repositorys-workflows - - /articles/managing-a-workflow-run - - /github/automating-your-workflow-with-github-actions/managing-a-workflow-run - - /actions/automating-your-workflow-with-github-actions/managing-a-workflow-run -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Acerca de la administración del flujo de trabajo - -Puedes ver si una ejecución de flujo de trabajo está en curso o completa desde la página de ejecución del flujo de trabajo. Si la ejecución está en curso, puedes cancelarla. Debes haber iniciado sesión en una cuenta de {% data variables.product.prodname_dotcom %} para ver la información de ejecución del flujo de trabajo, incluyendo los casos de repositorios públicos. Para obtener más información, consulta "[Permisos de acceso en GitHub](/articles/access-permissions-on-github)". - -Si la ejecución está completa, puedes ver si el resultado fue exitoso, fallido, cancelado o neutral. Si la ejecución falló, puedes ver y buscar en los registros de construcción para diagnosticar la falla y volver a ejecutar el flujo de trabajo. También puedes ver los minutos de ejecución facturables para jobs, o descargar bitácoras y artefactos de compilación. - - ![Imagen de ejecución de flujo de trabajo anotado](/assets/images/help/repository/annotated-workflow.png) - -{% data variables.product.prodname_actions %} usa la API de verificaciones para generar estados, resultados y registros para un flujo de trabajo. {% data variables.product.prodname_dotcom %} crea una nueva comprobación de suite para cada ejecución de flujo de trabajo. La comprobación de suite contiene una ejecución de comprobación para cada trabajo en el flujo de trabajo, y cada trabajo incluye diferentes pasos. {% data variables.product.prodname_actions %} se ejecutan como un paso en un flujo de trabajo. Para obtener más información acerca de la API de Verificaciones, consulta la sección "[Verificaciones](/v3/checks/)". - -{% data reusables.github-actions.invalid-workflow-files %} - -### Ver el historial de tu flujo de trabajo - -Puedes ver cada trabajo en una ejecución de flujo de trabajo y cada paso en un trabajo. Para obtener más información, consulta "[Conceptos básicos para {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions#job)." {% data reusables.repositories.permissions-statement-read %} - -Adicionalmente a los pasos configurados en el archivo de flujo de trabajo, cada job también incluye tareas adicionales para iniciar y completar la ejecución del job. Estos pasos se registran en la ejecución de flujo de trabajo como "Set up job" y "Complete job". - -Para jobs que se ejecutan en ejecutores hospedados en {% data variables.product.prodname_dotcom %}, "Set up job" registra los detalles del ambiente virtual del ejecutor, e incluye un enlace a la lista de herramientas pre-instaladas que estuvieron presentes en la máquina del ejecutor. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -6. De manera opcional, si la ejecución falló, para volver a ejecutar el flujo de trabajo, en la esquina superior derecha del flujo de trabajo, usa el menú desplegable **Re-run checks** (Volver a ejecutar verificaciones) y selecciona **Re-run all checks** (Volver a ejecutar todas las verificaciones). ![Volver a ejecutar el menú desplegable de verificaciones](/assets/images/help/repository/rerun-checks-drop-down.png) - -### Cancelar una ejecución de flujo de trabajo - -Cuando cancelas una ejecución de flujo de trabajo, {% data variables.product.prodname_dotcom %} cancela todsos los jobs y pasos que son parte de ésta. {% data reusables.repositories.permissions-statement-write %} - -Cuando cancelas una ejecución de flujo de trabajo, tal vez estés ejecutando otro software que utiliza recursos que se relacionan con ésta. Para ayudarte a liberar los recursos relacionados con dicha ejecución de flujo de trabajo, podría ser útil entender los pasos que realiza {% data variables.product.prodname_dotcom %} para cancelar una ejecución de flujo de trabajo. Para obtener más información, consulta la sección "[ pasos que toma {% data variables.product.prodname_dotcom %} para cancelar una ejecución de flujo de trabajo](#steps-github-takes-to-cancel-a-workflow-run)". - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -1. En la esquina superior derecha del flujo de trabajo, haz clic en **Cancelar el conjunto de verificaciones**. ![Botón de cancelar el conjunto de verificaciones](/assets/images/help/repository/cancel-check-suite.png) -1. Después de dar clic en **Cancelar suite de verificación**. - -#### Pasos que toma {% data variables.product.prodname_dotcom %} para cancelar una ejecución de flujo de trabajo - -1. Para cancelar una ejecución de flujo de trabajo, el servidor vuelve a evaluar las condiciones `if` para todos los jobs que se ejecutan actualmente. Si la condición se evalúa como `true`, el job no se cancelará. Por ejemplo, la condición `if: always()` se evaluaría como "true" y el job continuaría ejecutándose. Cuando no hay condición, esto es equivalente a una condición `if: success()`, la cual solo se ejecutará si el paso anterior finalizó con éxito. -2. Para los jobs que necesitan cancelarse, el servidor envía un mensaje de cancelación a todas las máquinas ejecutoras con jobs que necesitan cancelarse. -3. Para los jobs que siguen ejecutándose, el servidor vuelve a evaluar las condiciones `if` para los pasos sin finalizar. Si la condición se evalúa como `true`, el paso seguirá ejecutándose. -4. Para los pasos que necesitan cancelarse, la máquina ejecutora manda un `SIGINT/Ctrl-C` al proceso de entrada del paso (`node` para una acción de javascript, `docker` para una acción de contenedor, y `bash/cmd/pwd` cuando se utiliza `run` en un paso). Si el proceso no sale en 7500 ms, el ejecutor mandará un `SIGTERM/Ctrl-Break` al proceso y luego esperará por 2500 ms para que el proceso salga. Si el proceso aún está ejecutándose, el ejecutor finalizará abruptamente el árbol de proceso. -5. Después de los 5 minutos del periodo de expiración de plazo de cancelación, el servidor forzará la terminación de todos los jobs y pasos que no hayan finalizado la ejecución o que hayan fallado en completar el proceso de cancelación. - -### Borrar una ejecución de flujo de trabajo - -Puedes borrar una ejecución de flujo de trabajo que se haya completado, o que tenga más de 2 semanas. {% data reusables.repositories.permissions-statement-write %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -1. Para eliminar una ejecución de flujo de trabajo, utiliza el menú desplegable de {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} y selecciona **Borrar una ejecución de flujo de trabajo**. - - ![Borrar una ejecución de flujo de trabajo](/assets/images/help/settings/workflow-delete-run.png) -1. Revisa el mensaje de confirmación y da clic en **Sí, borrar esta ejecución de flujo de trabajo permanentemente**. - - ![Borrar una confirmación de ejecución de flujo de trabajo](/assets/images/help/settings/workflow-delete-run-confirmation.png) - -{% if currentVersion == "free-pro-team@latest" %} - -### Visualizar los minutos de ejecución facturables para jobs - -Puedes ver el tiempo de ejecución de un job, incluyendo los minutos facturables que este job ha acumulado. - -Los minutos de ejecución facturables para un job solo se muestran en aquellos jobs que se ejecutan en repositorios privados que utilizan ejecutores hospedados en {% data variables.product.prodname_dotcom %}. No hay minutos facturables cuando se utiliza {% data variables.product.prodname_actions %} en repositorios públicos o para trabajos que se ejecutan en ejecutores auto-hospedados. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -1. Debajo del resumen del job, da clic en **Detalles de tiempo facturable y de ejecución**. ![Enlace para los detalles de tiempo facturable y de ejecución](/assets/images/help/repository/view-run-billable-time.png) - - {% note %} - - **Nota:** El tiempo facturable que se muestra no incluye ningún multiplicador de minutos o de redondeo. Para ver tu uso total de {% data variables.product.prodname_actions %}, incluyendo los multiplicadores de minutos y de redondeo, consulta la sección "[Visualizar tu uso de {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage)". - - {% endnote %} - -{% endif %} - -### Ver registros para diagnosticar fallas - -Si falla la ejecución de su flujo de trabajo, puedes ver qué paso provocó el error y revisar los registros de construcción del paso que falló para solucionar el problema. Puedes ver el tiempo que demoró cada paso en ejecutarse. También puedes copiar un enlace permanente a una línea específica en el archivo de registro para compartir con tu equipo. {% data reusables.repositories.permissions-statement-read %} - -{% data variables.product.product_name %} almacena registros y artefactos de construcción completos durante 90 días. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -{% data reusables.repositories.navigate-to-job %} -6. Para expandir el registro de un paso fallido, haz clic en el paso. ![Nombre de paso fallido](/assets/images/help/repository/failed-check-step.png) -7. De manera opcional, para obtener un enlace a una línea específica de los registros, haz clic en el número de línea del paso. Puedes copiar el enlace desde la barra de direcciones de tu navegador web. ![Botón para copiar enlace](/assets/images/help/repository/copy-link-button.png) - -### Buscar registros - -Puedes buscar en los registros de construcción un paso en particular. Cuando buscas registros, solo los pasos ampliados se incluyen en los resultados. {% data reusables.repositories.permissions-statement-read %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -{% data reusables.repositories.navigate-to-job %} -6. Para expandir cada paso que deseas incluir en tu búsqueda, haz clic en el paso. ![Nombre del paso](/assets/images/help/repository/failed-check-step.png) -7. En el cuadro de búsqueda **Buscar registros** en la esquina superior derecha de la salida del registro, escribe una consulta de búsqueda. ![Cuadro de búsqueda para buscar registros](/assets/images/help/repository/search-log-box.png) - -### Descargar las bitácoras - -Puedes descargar los archivos de registro desde tu ejecución de flujo de trabajo. También puedes descargar los artefactos de un flujo de trabajo. Para obtener más información, consulta "[Conservar datos de flujo de trabajo mediante artefactos](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)." {% data reusables.repositories.permissions-statement-read %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -5. Para descargar registros, usa el menú desplegable **Descargar registros** y selecciona los registros que deseas descargar. ![Menú desplegable para descargar registros](/assets/images/help/repository/download-logs-drop-down.png) - -### Borrar bitácoras - -Puedes borrar los archivos de bitácora de tu ejecución de flujo de trabajo. {% data reusables.repositories.permissions-statement-write %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -5. Para borrar los archivos de bitácora, da clic en el botón **Borrar todas las bitácoras** y revisa el aviso de confirmación. ![Delete all logs](/assets/images/help/repository/delete-all-logs.png)Después de borrar las bitácoras, el botón **Borrar todas las bitácoras** se elimina para indicar que no quedan archivos de bitácora en la ejecución del flujo de trabajo. - -### Habilitar registro de depuración - -Si los registros de flujo de trabajo no proporcionan suficiente detalle para diagnosticar por qué un flujo de trabajo o paso no funciona como se espera, puedes habilitar más registros de depuración. - -Estas bitácoras extra se habilitan configurando los secretos en el repositorio que contiene el flujo de trabajo, así que aplicarán los mismos requisitos de los permisos: - -- {% data reusables.github-actions.permissions-statement-secrets-organization %} -- {% data reusables.github-actions.permissions-statement-secrets-repository %} -- {% data reusables.github-actions.permissions-statement-secrets-api %} - -Para obtener más información sobre cómo establecer secretos, consulta "<0">Crear y usar secretos cifrados." - -#### Habilitar el registro de diagnóstico del ejecutor - -El crear bitácoras de diagnóstico del ejecutor proporciona archivos de bitácora adicionales que contienen información acerca de cómo un ejecutor efectúa un job. Los archivos de registro adicionales se agregan al archivo de registro: - -* El registro del proceso del ejecutor, que incluye información acerca de la coordinación y la configuración de los ejecutores para ejecutar tareas. -* El registro del proceso del trabajador, que registra la ejecución de una tarea. - -1. Para habilitar el registro de diagnóstico del ejecutor, establece el siguiente secreto en el repositorio que contiene el flujo de trabajo: `ACTIONS_RUNNER_DEBUG` en `true`. - -1. Para descargar los registros de diagnóstico del ejecutor, descarga el archivo de registro del flujo de trabajo. Los registros de diagnóstico del ejecutor se encuentran en la carpeta `correner-diagnostic-logs`. Para obtener más información sobre cómo descargar bitácoras, consulta la sección "[Descargar bitácoras](#downloading-logs)". - -#### Habilitar el registro de depuración del paso - -El registro de depuración del paso aumenta el nivel de detalle de los registros de una tarea durante y después de la ejecución de una tarea. - -1. Para habilitar el registro de depuración del paso, debes establecer el siguiente secreto en el repositorio que contiene el flujo de trabajo: `ACTIONS_RUNNER_DEBUG` en `true`. - -1. Después de establecer el secreto, se muestran más eventos de depuración en los registros del paso. Para obtener más información, consulta ["Ver registros para diagnosticar fallas"](#viewing-logs-to-diagnose-failures). - - -### Leer más - -- [Acerca de {% data variables.product.prodname_actions %}](/articles/about-github-actions)" -- "[Configurar un flujo de trabajo](/articles/configuring-a-workflow)" -- "[Sintaxis de flujo de trabajo para {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions)" -- "[Eventos que desencadenan flujos de trabajo](/articles/events-that-trigger-workflows)" -- "[Entornos virtuales para ejecutores alojados en {% data variables.product.prodname_dotcom %}](/actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)" diff --git a/translations/es-XL/content/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts.md b/translations/es-XL/content/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts.md deleted file mode 100644 index 6e284c2718b4..000000000000 --- a/translations/es-XL/content/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts.md +++ /dev/null @@ -1,249 +0,0 @@ ---- -title: Almacenar datos de flujo de trabajo mediante artefactos -intro: Los artefactos te permiten compartir datos entre puestos en un flujo de trabajo y almacenar los datos una vez que se ha completado ese flujo de trabajo. -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/persisting-workflow-data-using-artifacts - - /GitHub/Automating-Your-Workflow-with-GitHub-Actions/Persisting-Workflow-Data-using-Artifacts - - /Actions/Automating-Your-Workflow-with-GitHub-Actions/Persisting-Workflow-Data-using-Artifacts -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Acerca de los artefactos de flujo de trabajo - -Los artefactos te permiten hacer datos persistentes después de que se complete un job y comparten estos datos con otro job en el mismo flujo de trabajo. Un artefacto es un archivo o recopilación de archivos producidos durante una ejecución de flujo de trabajo. Por ejemplo, puedes utilizar artefactos para guardar tu compilación y probar el resultado después de que haya terminado una ejecución de flujo de trabajo. Para cargas y solicitudes de extracción, {% data variables.product.product_name %} almacena artefactos por 90 días. El periodo de retención para una solicitud de extracción se restablece cada vez que alguien sube una confirmación nueva a la solicitud de extracción. - -Estos son algunos de los artefactos comunes que puedes subir: - -- Archivos de registro y vaciados de memoria -- Resultados de prueba, fallas y capturas de pantalla -- Archivos binarios o comprimidos -- Resultados de la prueba de rendimiento y resultados de cobertura del código - -{% if currentVersion == "free-pro-team@latest" %} - -Almacenar artefactos consume espacio de almacenamiento en {% data variables.product.product_name %}. {% data reusables.github-actions.actions-billing %} Para obtener más información, consulta "[Administrar la facturación para {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)". - -{% else %} - -Los artefactos caducan automáticamente después de 90 días, pero siempre puedes reclamar el almacenamiento utilizado de {% data variables.product.prodname_actions %} si borras artefactos antes de que caduquen en {% data variables.product.product_name %}. - -{% endif %} - -Los artefactos se cargan durante una ejecución de flujo de trabajo y puedes ver el nombre y tamaño de estos en la IU. Cuando se descarga un artefacto utilizando la IU de {% data variables.product.product_name %}, todos los archivos que se hayan subido de manera individual como parte del mismo se comprimirán en un solo archivo. Esto significa que los costos se calcularán con base en el tamaño del artefacto cargado y no en aquél del archivo comprimido. - -{% data variables.product.product_name %} proporciona dos acciones que puedes usar para cargar y descargar artefactos de construcción. Para obtener más informaicón, consulta las acciones [actions/upload-artifact](https://github.com/actions/upload-artifact) and [download-artifact](https://github.com/actions/download-artifact). - -Para compartir datos entre puestos: - -* **Cargar archivos**: Asigna un nombre al archivo cargado y sube los datos antes de que termine el job. -* **Descargar archivos**: Solo puedes descargar artefactos que se hayan subido durante la misma ejecución del flujo de trabajo. Cuando descargas un archivo, puedes referenciarlo por su nombre. - -Los pasos de un job comparten el mismo ambiente en la máquina ejecutora, pero se ejecutan en su propio proceso individual. Para pasar datos entre pasos en un trabajo, puedes usar entradas y salidas. Para obtener más información sobre entradas y salidas, consulta "[Sintaxis de metadatos para {% data variables.product.prodname_actions %}](/articles/metadata-syntax-for-github-actions)". - -### Pasar datos entre puestos en un flujo de trabajo - -Puedes usar las acciones `upload-artifact` y `download-artifact` para compartir datos entre trabajos en un flujo de trabajo. Este flujo de trabajo de ejemplo ilustra cómo pasar datos entre trabajos en el mismo flujo de trabajo. Para obtener más informaicón, consulta las acciones [actions/upload-artifact](https://github.com/actions/upload-artifact) and [download-artifact](https://github.com/actions/download-artifact). - -Los trabajos que dependen de los artefactos de un trabajo anterior deben esperar que el trabajo dependiente se complete exitosamente. Este flujo de trabajo usa la palabra clave `needs` para garantizar que `job_1`, `job_2` y `job_3` se ejecuten secuencialmente. Por ejemplo, `job_2` requiere `job_1` mediante la sintaxis `needs: job_1`. - -El Trabajo 1 realiza estos pasos: -- Realiza un cálculo matemático y guarda el resultado en un archivo de texto llamado `math-homework.txt`. -- Usa la acción `upload-artifact` para cargar el archivo `math-homework.txt` con el nombre `homework`. La acción coloca el archivo en un directorio denominado `homework`. - -El Trabajo 2 usa el resultado del trabajo anterior: -- Descarga el artefacto `homework` cargado en el trabajo anterior. De manera predeterminada, la acción `download-artifact` descarga artefactos en el directorio del espacio de trabajo que ejecuta el paso. Puedes utilizar el parámetro de entrada `path` para especificar un directorio de descarga diferente. -- Lee el valor en el archivo `homework/math-homework.txt`, realiza un cálculo matemático, y guarda el resultado en `math-homework.txt`. -- Carga el archivo `math-homework.txt`. Esta carga sobrescribe la carga anterior porque ambas cargas comparten el mismo nombre. - -El Trabajo 3 muestra el resultado cargado en el trabajo anterior: -- Descarga el artefacto `homework`. -- Imprime el resultado de la ecuación matemática en el registro. - -La operación matemática completa realizada en este ejemplo de flujo de trabajo es `(3 + 7) x 9 = 90`. - -```yaml -name: Share data between jobs - -on: [push] - -jobs: - job_1: - name: Add 3 and 7 - runs-on: ubuntu-latest - steps: - - shell: bash - run: | - expr 3 + 7 > math-homework.txt - - name: Upload math result for job 1 - uses: actions/upload-artifact@v2 - with: - name: homework - path: math-homework.txt - - job_2: - name: Multiply by 9 - needs: job_1 - runs-on: windows-latest - steps: - - name: Download math result for job 1 - uses: actions/download-artifact@v2 - with: - name: homework - - shell: bash - run: | - value=`cat math-homework.txt` - expr $value \* 9 > math-homework.txt - - name: Upload math result for job 2 - uses: actions/upload-artifact@v2 - with: - name: homework - path: math-homework.txt - - job_3: - name: Display results - needs: job_2 - runs-on: macOS-latest - steps: - - name: Download math result for job 2 - uses: actions/download-artifact@v2 - with: - name: homework - - name: Print the final result - shell: bash - run: | - value=`cat math-homework.txt` - echo The result is $value -``` - -![Flujo de trabajo que pasa datos entre trabajos para realizar cálculos matemáticos](/assets/images/help/repository/passing-data-between-jobs-in-a-workflow.png) - -### Compartir datos entre ejecuciones de flujo de trabajo - -Una vez que termina un flujo de trabajo, puedes descargar un archivo comprimido de los artefactos cargados en {% data variables.product.product_name %} si encuentras la ejecución del flujo de trabajo en la pestaña de **Acciones**. También puedes utilizar la API REST de {% data variables.product.prodname_dotcom %} para descargar artefactos. Para obtener más información, consulta la sección "[Artefactos](/v3/actions/artifacts/)". - -{% data variables.product.product_name %} proporciona dos acciones que puedes usar para cargar y descargar artefactos de construcción. Para obtener más informaicón, consulta las acciones [actions/upload-artifact](https://github.com/actions/upload-artifact) and [download-artifact](https://github.com/actions/download-artifact). - -### Cargar artefactos de construcción y prueba - -Puedes crear un flujo de trabajo de integración continua (CI) para construir y probar tu código. Para obtener más información acerca de cómo utilizar {% data variables.product.prodname_actions %} para realizar la IC, consulta la sección "[Acerca de la integración contínua](/articles/about-continuous-integration)". - -El resultado de la construcción y la prueba de tu código frecuentemente produce archivos que puedes usar para depurar fallas de prueba y códigos de producción que puedes implementar. Puedes configurar un flujo de trabajo para construir y probar el código subido a tu repositorio e informar un estado satisfactorio o de falla. Puedes cargar los resultados de construcción y prueba para usar en implementaciones, pruebas de depuración fallidas o fallos, y para visualizar la cobertura del conjunto de prueba. - -Puedes usar la acción `upload-Artifact` para cargar artefactos. Cuando cargues un artefacto, puedes especificar un archivo sencillo o un directorio, o varios archivos o directorios. También puedes excluir ciertos archivos o directorios y utilizar patrones de comodín. Te recomendamos que proporciones un nombre para cada artefacto pero, si no se lo das, entonces el nombre predeterminado que se utilizará será `artifact`. For more information on syntax, see the {% if currentVersion == "free-pro-team@latest" %}[actions/upload-artifact](https://github.com/actions/upload-artifact) action{% else %} `actions/upload-artifact` action on {% data variables.product.product_location %}{% endif %}. - -#### Ejemplo - -Por ejemplo, tu repositorio o una aplicación web podrían contener archivos de SASS y TypeScript que debes convertir a CSS y JavaScript. Teniendo en cuenta que tu configuración de construcción envía los archivos compilados al directorio `dist`, puedes implementar los archivos en el directorio `dist` para tu servidor de aplicación web si todas las pruebas se completaron satisfactoriamente. - -``` -|-- hello-world (repository) -| └── dist -| └── tests -| └── src -| └── sass/app.scss -| └── app.ts -| └── output -| └── test -| -``` - -En este ejemplo se muestra cómo crear un flujo de trabajo para un proyecto Node.js que `construye` el código en el directorio `src` y ejecuta las pruebas en el directorio `tests`. Puedes suponer que la ejecución `npm test` produce un informe de cobertura de código denominado `code-coverage.html` almacenada en el directorio `output/test/`. - -El flujo de trabajo carga los artefactos de producción en el directorio `dist`, pero excluye cualquier archivo de markdown. También carga el reporte `code-coverage.html` como otro artefacto. - -```yaml -name: Node CI - -on: [push] - -jobs: - build_and_test: - runs-on: ubuntu-latest - steps: - - name: Checkout repository - uses: actions/checkout@v2 - - name: npm install, build, and test - run: | - npm install - npm run build --if-present - npm test - - name: Archive production artifacts - uses: actions/upload-artifact@v2 - with: - name: dist-without-markdown - path: | - dist - !dist/**/*.md - - name: Archive code coverage results - uses: actions/upload-artifact@v2 - with: - name: code-coverage-report - path: output/test/code-coverage.html -``` - -![Imagen de la ejecución del flujo de trabajo del artefacto de carga de flujos de trabajo](/assets/images/help/repository/upload-build-test-artifact.png) - -### Descargar o eliminar artefactos - -Durante una ejecución de flujo de trabajo, puedes descargar artefactos que se hayan cargado previamente en la misma ejecución. Después de que se haya completado esta ejecución de flujo de trabajo, puedes descargar o eliminar artefactos en GitHub si utilizas el historial de ejecuciones de flujo de trabajo. - -#### Descargar artefactos durante una ejecución de flujo de trabajo - -La acción [actions/download-artifact](https://github.com/actions/download-artifact) puede utilizarse para descargar artefactos que se hayan cargado previamente durante una ejecución de flujo de trabajo. - -{% note %} - -**Nota:** Solo podrás descargar los artefactos que se hayan cargado durante la misma ejecución de flujo de trabajo. - -{% endnote %} - -Especificar el nombre de un artefacto para descargar un artefacto individual. Si cargaste un artefacto sin especificar un nombre, el nombre predeterminado de éste será `artifact`. - -```yaml -- name: Download a single artifact - uses: actions/download-artifact@v2 - with: - name: my-artifact -``` - -También puedes descargar todos los artefactos en una ejecución de flujo de trabajo si no especificas un nombre para éstos. Esto puede ser útil si estás trabajando con muchos artefactos. - -```yaml -- name: Download all workflow run artifacts - uses: actions/download-artifact@v2 -``` - -Si descargas todos los artefactos de una ejecución de flujo de trabajo, se creará un directorio para cada uno de ellos utilizando su nombre. - -For more information on syntax, see the [actions/download-artifact](https://github.com/actions/download-artifact) action. - -#### Descargar y borrar los artefactos después de que se complete una ejecución de flujo de trabajo - -Los artefactos caducan automáticamente después de 90 días, pero siempre puedes reclamar el almacenamiento utilizado de {% data variables.product.prodname_actions %} si borras artefactos antes de que caduquen en {% data variables.product.product_name %}. - -{% warning %} - -**Advertencia:** Una vez que eliminas un artefacto, no se puede restaurar. - -{% endwarning %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -1. Para descargar artefactos, usa el menú desplegable **Artifacts** (Artefactos) y selecciona el artefacto que deseas descargar. ![Menú desplegable Download artifact (Descargar artefacto)](/assets/images/help/repository/artifact-drop-down.png) -1. Para eliminar artefactos, usa el menú desplegable **Artifacts** (Artefactos) y haz clic en {% octicon "trashcan" aria-label="The trashcan icon" %}. ![Menú desplegable Delete artifact (Eliminar artefacto)](/assets/images/help/repository/actions-delete-artifact.png) - -{% if currentVersion == "free-pro-team@latest" %} - -### Leer más - -- "[Administrar la facturación para {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)". - -{% endif %} diff --git a/translations/es-XL/content/actions/configuring-and-managing-workflows/sharing-workflow-templates-within-your-organization.md b/translations/es-XL/content/actions/configuring-and-managing-workflows/sharing-workflow-templates-within-your-organization.md deleted file mode 100644 index 6100ba1e0d01..000000000000 --- a/translations/es-XL/content/actions/configuring-and-managing-workflows/sharing-workflow-templates-within-your-organization.md +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: Compartir plantillas de flujo de trabajo dentro de tu organización -intro: Puedes crear un conjunto estandarizado de plantillas de flujo de trabajo específicamente para tu organización. Los miembros de la organización pueden entonces utilizar estas plantillas cuando creen flujos de trabajo nuevos en los repositorios de dicha organización. -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -Los usuarios con acceso de escritura en el repositorio `.github` de la organización pueden crear plantillas de flujo de trabajo. Los miembros de la organización que tengan permisos para crear flujos de trabajo podrán entonces utilizar estas plantillas. - -Las plantillas de flujo de trabajo pueden utilizarse para crear flujos de trabajo nuevos en los repositorios públicos de una organización; para utilizar estas plantillas para crear flujos de trabajo en repositorios privados, la organización deberá pertenecer a un plan empresarial o a un plan de GitHub One. - -### Crear una plantilla de flujo de trabajo - -Este procedimiento muestra cómo crear una plantilla de flujo de trabajo y un archivo de metadatos. El archivo de metadatos describe cómo se presenta la plantilla a los usuarios cuando están creando un flujo de trabajo nuevo. - -1. En caso de que no exista previamente, crea en tu organización un repositorio público nuevo que se llame `.github`. -1. Crea un directorio que se llame `workflow-templates`. -1. Crea tu nuevo archivo de flujo de trabajo dentro del directorio `workflow-templates`. - - Si necesitas referirte a la rama predeterminada de un repositorio, puedes utilizar el marcador de posición `$default-branch`. Cuando se crea un flujo de trabajo utilizando tu plantilla, el marcador de posición se reemplazará automáticamente con el nombre de la rama predeterminada del repositorio. - - Por ejemplo, este archivo de nombre `octo-organization-ci.yml` ilustra un flujo de trabajo básico. - - ```yaml - name: Octo Organization CI - - on: - push: - branches: [ $default-branch ] - pull_request: - branches: [ $default-branch ] - - jobs: - build: - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - - name: Run a one-line script - run: echo Hello from Octo Organization - ``` -1. Crea un archivo de metadatos dentro del directorio `workflow-templates`. El archivo de metadatos debe tener el mismo nombre que el archivo de flujo de trabajo, pero en vez de tener la extensión `.yml`, este deberá encontrarse adjunto en `.properties.json`. Por ejemplo, este archivo que se llama `octo-organization-ci.properties.json` contiene los metadatos para un archivo de flujo de trabajo de nombre `octo-organization-ci.yml`: - ```yaml - { - "name": "Octo Organization Workflow", - "description": "Octo Organization CI workflow template.", - "iconName": "example-icon", - "categories": [ - "Go" - ], - "filePatterns": [ - "package.json$", - "^Dockerfile", - ".*\\.md$" - ] - } - ``` - * `name` - **Requerido.** El nombre de la plantilla de flujo de trabajo. Este se muestra en la lista de plantillas disponibles. - * `description` - **Requerido.** La descripción de la plantilla de flujo de trabajo. Este se muestra en la lista de plantillas disponibles. - * `iconName` - **Requerido.** Define un icono en la lista de plantillas para la entrada del flujo de trabajo. El `iconName` debe ser un icono en SVG del mismo nombre y se debe almacenar en el directorio `workflow-templates`. Por ejemplo, un archivo de tipo SVG que se nombre `example-icon.svg` se referenciará como `example-icon`. - * `categories` - **Opcional.** Define la categoría de lenguaje del flujo de trabajo. Cuando un usuario visualiza las plantillas disponibles, aquellas que empaten con el mismo lenguaje se presentarán con mayor prominencia. Para obtener información sobre las categorías de lenguaje disponibles, consulta https://github.com/github/linguist/blob/master/lib/linguist/languages.yml. - * `filePatterns` - **Opcional.** Permite que se utilice la plantilla si el repositorio del usuario contiene un archivo en su directorio raíz, el cual empate con una expresión regular definida. - -Para agregar otra plantilla de flujo de trabajo, agrega tus archivos al mismo directorio de `workflow-templates`. Por ejemplo: - -![Archivos de plantilla de flujo de trabajo](/assets/images/help/images/workflow-template-files.png) - -### Utilizar una plantilla de flujo de trabajo - -Este procedimiento ilustra cómo un miembro de tu organización puede encontrar y utilizar una plantilla de flujo de trabajo para crear un flujo de trabajo nuevo. Cualquiera que sea un miembro de la organización podrá utilizar las plantillas de flujo de trabajo de ésta. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -1. Si tu repositorio ya cuenta con flujos de trabajo: En la esquina superior izquierda, da clic sobre **Flujo de trabajo nuevo**. ![Crear un nuevo flujo de trabajo](/assets/images/help/repository/actions-new-workflow.png) -1. Tus plantillas de flujo de trabajo de la organización se ubican en su propia sección, la cual se titula "Flujos de trabajo creados por _nombre de la organización_". Debajo del nombre de la plantilla que deseas utilizar, da clic en **Configurar este flujo de trabajo**. ![Configurar este flujo de trabajo](/assets/images/help/settings/actions-create-starter-workflow.png) diff --git a/translations/es-XL/content/actions/configuring-and-managing-workflows/using-databases-and-service-containers.md b/translations/es-XL/content/actions/configuring-and-managing-workflows/using-databases-and-service-containers.md deleted file mode 100644 index 92b3a6f20060..000000000000 --- a/translations/es-XL/content/actions/configuring-and-managing-workflows/using-databases-and-service-containers.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Usar bases de datos y contenedores de servicio -intro: Conectar bases de datos y contenedores de servicios para administrar herramientas de flujo de trabajo. -mapTopic: true -redirect_from: - - /Actions/Automating-Your-Workflow-with-GitHub-Actions/Using-Databases-and-Services -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/es-XL/content/actions/configuring-and-managing-workflows/using-environment-variables.md b/translations/es-XL/content/actions/configuring-and-managing-workflows/using-environment-variables.md deleted file mode 100644 index 1bacc0c265e1..000000000000 --- a/translations/es-XL/content/actions/configuring-and-managing-workflows/using-environment-variables.md +++ /dev/null @@ -1,68 +0,0 @@ ---- -title: Usar variables de entorno -intro: '{% data variables.product.prodname_dotcom %} establece variables de entorno predeterminadas para cada ejecución de flujo de trabajo de {% data variables.product.prodname_actions %}. También puedes establecer variables de entorno personalizadas en tu archivo de flujo de trabajo.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /github/automating-your-workflow-with-github-actions/using-environment-variables - - /actions/automating-your-workflow-with-github-actions/using-environment-variables -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Acerca de las variables de entorno - -{% data variables.product.prodname_dotcom %} establece las variables de entorno predeterminadas que están disponibles para cada paso en una ejecución de flujo de trabajo. Las variables de entorno distinguen mayúsculas de minúsculas. Los comandos que se ejecutan en acciones o pasos pueden crear, leer y modificar variables de entorno. - -Para establecer variables de entorno personalizadas, debes especificar las variables en el archivo de flujo de trabajo. Puedes definir variables de entorno para un paso, trabajo o flujo de trabajo completo utilizando las palabras clave [`jobs.. steps.env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsenv), [`jobs.. env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idenv) y [`env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#env). Para obtener más información, consulta "[Sintaxis del flujo de trabajo para {% data variables.product.prodname_dotcom %}](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepsenv)". - -```yaml -steps: - - name: Hello world - run: echo Hello world $FIRST_NAME $middle_name $Last_Name! - env: - FIRST_NAME: Mona - middle_name: The - Last_Name: Octocat -``` - -También puedes usar el comando de flujo de trabajo `Set-env` para establecer una variable de entorno que pueden usar los pasos posteriores en un flujo de trabajo. El comando `set-env` puede ser usado directamente por una acción o se puede usar un comando de shell en un archivo de flujo de trabajo mediante la palabra clave `run (ejecutar)`. Para obtener más información, consulta "[Comandos de flujo de trabajo para las {% data variables.product.prodname_actions %}](/actions/reference/workflow-commands-for-github-actions/#setting-an-environment-variable)." - -### Variables de entorno predeterminadas - -Te recomendamos encarecidamente que las acciones usen variables de entorno para acceder al sistema de archivos en lugar de usar rutas de archivo codificadas de forma rígida. {% data variables.product.prodname_dotcom %} establece variables de entorno para que las acciones se utilicen en todos los entornos del ejecutador. - -| Variable de entorno | Descripción | -| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `CI` | Siempre configurar en `true`. | -| `HOME` | La ruta al directorio de inicio de {% data variables.product.prodname_dotcom %} utilizado para almacenar datos del usuario. Por ejemplo, `/github/home`. | -| `GITHUB_WORKFLOW` | El nombre del flujo de trabajo. | -| `GITHUB_RUN_ID` | {% data reusables.github-actions.run_id_description %} | -| `GITHUB_RUN_NUMBER` | {% data reusables.github-actions.run_number_description %} | -| `GITHUB_ACTION` | El único identificador (`id`) de la acción. | -| `GITHUB_ACTIONS` | Siempre establecido en `true` cuando {% data variables.product.prodname_actions %} está ejecutando el flujo de trabajo. Puedes usar esta variable para diferenciar cuando las pruebas se ejecutan de forma local o mediante {% data variables.product.prodname_actions %}. | -| `GITHUB_ACTOR` | El nombre de la persona o de la aplicación que inició el flujo de trabajo. Por ejemplo, `octocat`. | -| `GITHUB_REPOSITORY` | El nombre del repositorio y del propietario. Por ejemplo, `octocat/Hello-World`. | -| `GITHUB_EVENT_NAME` | El nombre del evento webhook que activó el flujo de trabajo. | -| `GITHUB_EVENT_PATH` | La ruta del archivo con la carga completa del evento webhook. Por ejemplo, `/github/workflow/event.json`. | -| `GITHUB_WORKSPACE` | La ruta del directorio del espacio de trabajo de {% data variables.product.prodname_dotcom %}. El directorio del espacio de trabajo contiene un subdirectorio con una copia de tu repositorio si tu flujo de trabajo usa la acción [actions/checkout](https://github.com/actions/checkout). Si no usas la acción `actions/checkout`, el directorio estará vacío. Por ejemplo, `/home/runner/work/my-repo-name/my-repo-name`. | -| `GITHUB_SHA` | El SHA de confirmación que activó el flujo de trabajo. Por ejemplo, `ffac537e6cbbf934b08745a378932722df287a53`. | -| `GITHUB_REF` | La referencia de etiqueta o rama que activó el flujo de trabajo. Por ejemplo, `refs/heads/feature-branch-1`. Si no hay una rama o una etiqueta disponible para el tipo de evento, la variable no existirá. | -| `GITHUB_HEAD_REF` | Solo establecida para repositorios bifurcados. La rama del repositorio principal. | -| `GITHUB_BASE_REF` | Solo establecida para repositorios bifurcados. La rama del repositorio base. | -| `GITHUB_SERVER_URL` | Devuelve la URL del servidor de {% data variables.product.product_name %}. Por ejemplo: `https://github.com`. | -| `GITHUB_API_URL` | Devuelve la URL de la API. Por ejemplo: `https://api.github.com`. | -| `GITHUB_GRAPHQL_URL` | Devuelve la URL de la API de GraphQL. Por ejemplo: `https://api.github.com/graphql`. | - -### Convenciones de nomenclatura para las variables de entorno - -{% note %} - -**Nota:**{% data variables.product.prodname_dotcom %} reserva el prefijo de la variable de ambiente `GITHUB_` para uso interno de {% data variables.product.prodname_dotcom %}. Configurar una variable de entorno o secreto con el prefijo `GITHUB_` dará como resultado un error. - -{% endnote %} - -Toda variable de entorno nueva que configures y que apunte a una ubicación en el sistema de archivos debe tener un sufijo `_PATH`. Las variables predeterminadas `HOME` y `GITHUB_WORKSPACE` son excepciones a esta convención, porque las palabras "inicio" (home) y "espacio de trabajo" (workspace) ya implican una ubicación. diff --git a/translations/es-XL/content/actions/configuring-and-managing-workflows/using-variables-and-secrets-in-a-workflow.md b/translations/es-XL/content/actions/configuring-and-managing-workflows/using-variables-and-secrets-in-a-workflow.md deleted file mode 100644 index a1a87f43d8c7..000000000000 --- a/translations/es-XL/content/actions/configuring-and-managing-workflows/using-variables-and-secrets-in-a-workflow.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Usar variables y secretos en un flujo de trabajo -intro: 'Usa secretos, variables y tokens cifrados en tus flujos de trabajo para proteger tu repositorio.' -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/es-XL/content/actions/getting-started-with-github-actions/about-github-actions.md b/translations/es-XL/content/actions/getting-started-with-github-actions/about-github-actions.md deleted file mode 100644 index 62d56631b384..000000000000 --- a/translations/es-XL/content/actions/getting-started-with-github-actions/about-github-actions.md +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: Acerca de Acciones de GitHub -intro: '{% data variables.product.prodname_actions %} te permite crear flujos de trabajo de ciclo de vida (SDLC) de software personalizados directamente en tu repositorio {% data variables.product.prodname_dotcom %}.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/migrating-github-actions-from-hcl-syntax-to-yaml-syntax/ - - /articles/about-github-actions - - /GitHub/Automating-Your-Workflow-with-GitHub-Actions/about-GitHub-Actions - - /Actions/Automating-Your-Workflow-with-GitHub-Actions/about-GitHub-Actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Acerca de {% data variables.product.prodname_actions %} - -Los flujos de trabajo de {% data reusables.repositories.about-github-actions %} son procesos automatizados personalizados que puedes configurar en tu repositorio para crear, probar, empaquetar, lanzar o implementar cualquier proyecto de código en {% data variables.product.prodname_dotcom %}. - -{% data reusables.repositories.actions-ci-cd %} {% data variables.product.prodname_actions %} potencia el servicio integrado de integración continua de {% data variables.product.prodname_dotcom %}. Para obtener más información, consulta "[Acerca de la integración continua](/articles/about-continuous-integration)". - -Los flujos de trabajo se ejecutan en Linux, macOS, Windows y contenedores en máquinas hospedadas en {% data variables.product.prodname_dotcom %}, denominadas ' runners ' (ejecutores). Como alternativa, también puedes hospedar tus propios ejecutores para ejecutar flujos de trabajo en las máquinas que posees o administras. Para obtener más información, consulta "[Acerca de los ejecutores autoalojados](/actions/automating-your-workflow-with-github-actions/about-self-hosted-runners)." - -Puedes crear flujos de trabajo utilizando acciones definidas en tu repositorio, acciones de código abierto en un repositorio público en {% data variables.product.prodname_dotcom %} o una imagen de contenedor Docker publicada. Los flujos de trabajo en repositorios bifurcados no se ejecutan por defecto. - -Puedes descubrir acciones para utilizar en tu flujo de trabajo en {% data variables.product.prodname_dotcom %} y crear acciones para compartir con la comunidad de {% data variables.product.prodname_dotcom %}. Para obtener más información sobre cómo crear una acción personalizada, consulta la sección "[Crear acciones](/actions/creating-actions)". - -Puedes crear un archivo de flujo de trabajo configurado para ejecutarse en eventos específicos. Para obtener más información, consulta "[Configurar un flujo de trabajo](/articles/configuring-a-workflow)" y "[Sintaxis de flujo de trabajo para {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions)". - -Para obtener una definición de términos comunes, consulta "[Conceptos básicos para {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)." - -### Descubrir acciones en la comunidad de {% data variables.product.prodname_dotcom %} - -{% data variables.product.prodname_marketplace %} es una ubicación central para que encuentres, compartas y uses acciones creadas por la comunidad de {% data variables.product.prodname_dotcom %}. Para obtener más información, consulta "[Usar acciones desde {% data variables.product.prodname_marketplace %} en tu flujo de trabajo](/actions/automating-your-workflow-with-github-actions/using-actions-from-github-marketplace-in-your-workflow)." - -También puedes personalizar tu proyecto con acciones de código abierto compartidas en repositorios públicos en {% data variables.product.prodname_dotcom %} y utilizar acciones construidas por {% data variables.product.prodname_dotcom %} en la organización de [acciones](https://github.com/actions). - -### Inhabilitar o limitar {% data variables.product.prodname_actions %} para tu repositorio u organización - -{% data reusables.github-actions.disabling-github-actions %} - -Para obtener más información, consulta la sección "[Inhabilitar o limitar {% data variables.product.prodname_actions %} para un repositorio](/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository)" o "[Inhabilitar o limitar {% data variables.product.prodname_actions %} para tu organización](/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization)". - -### Notificaciones para ejecuciones de flujo de trabajo - -{% data reusables.repositories.workflow-notifications %} - -### Límites de uso - -{% data reusables.github-actions.github-actions-usage-limits %} - -{% if currentVersion == "free-pro-team@latest" %} - -### Política de uso - -Además de los límites de uso, debes asegurarte de usar las {% data variables.product.prodname_actions %} dentro de los [Términos de servicio de GitHub](/articles/github-terms-of-service/). Para obtener más información sobre los términos específicos de las {% data variables.product.prodname_actions %}, consulta los [Términos adicionales de producto de GitHub](/github/site-policy/github-additional-product-terms#a-actions-usage). - -### Acerca de la facturación para {% data variables.product.prodname_actions %} - -{% data reusables.github-actions.actions-billing %} Para obtener más información, consulta "[Acerca de la facturación de {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions)". - -### Contactar con soporte técnico - -{% data reusables.github-actions.contacting-support %} - -{% endif %} - -### Leer más - -- "[Administrar una ejecución de flujo de trabajo](/articles/managing-a-workflow-run)" -- "[Eventos que desencadenan flujos de trabajo](/articles/events-that-trigger-workflows)" -- "[Entornos virtuales para ejecutores alojados en {% data variables.product.prodname_dotcom %}](/actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)" -"[Administrar la facturación de {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)" diff --git a/translations/es-XL/content/actions/getting-started-with-github-actions/core-concepts-for-github-actions.md b/translations/es-XL/content/actions/getting-started-with-github-actions/core-concepts-for-github-actions.md deleted file mode 100644 index d99e1b700eee..000000000000 --- a/translations/es-XL/content/actions/getting-started-with-github-actions/core-concepts-for-github-actions.md +++ /dev/null @@ -1,76 +0,0 @@ ---- -title: Conceptos básicos para GitHub Actions -shortTitle: Conceptos básicos -intro: 'A continuación se muestra una lista de términos comunes de {% data variables.product.prodname_actions %} que utilizamos en nuestros sitios y documentación de {% data variables.product.prodname_actions %}.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions - - /actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Acción - -Las tareas individuales que combinas como pasos para crear un trabajo. Las acciones son el componente portable más pequeño de un flujo de trabajo. Puedes crear tus propias acciones, usar acciones compartidas de la comunidad de {% data variables.product.prodname_dotcom %} y personalizar las acciones públicas. Para utilizar una acción en un flujo de trabajo, debes incluirla como paso. - -### Artefacto - -Los artefactos son los archivos que se crean cuando desarrollas y pruebas tu código. Por ejemplo, los artefactos podrían incluir archivos binarios o de paquete, resultados de pruebas, capturas de pantalla o archivos de registro. Los artefactos se asocian con la ejecución de flujo de trabajo en la que se crearon, y los puede usar o implementar otro trabajo. - -### Integración continua (CI) - -El ejercicio de desarrollo de software relacionado con la frecuente confirmación de pequeños cambios de código en un repositorio compartido. Con {% data variables.product.prodname_actions %}, puedes crear flujos de trabajo de CI personalizados que automaticen el desarrollo y la prueba de tu código. Desde el repositorio, puedes ver el estado de los cambios de código y los registros detallados de cada acción de tu flujo de trabajo. La CI les ahorra tiempo a los programadores al ofrecer comentarios inmediatos sobre los cambios de código para detectar y resolver errores más rápido. - -### Implementación continua (CD) - -La implementación continua se desarrolla sobre la integración continua. Cuando se confirma el código nuevo y pasa las pruebas de CI, el código se implementa de manera automática en la producción. Con {% data variables.product.prodname_actions %}, puedes crear flujos de trabajo de CD personalizados para implementar de manera automática tu código en cualquier nube, servicio de almacenamiento propio o plataforma directamente desde tu repositorio. La CD les ahorra tiempo a los programadores al automatizar el proceso de implementación y permite implementar más rápido los cambios de código estables ya probados para tus clientes. - -### Evento - -Una actividad específica que activa una ejecución de flujo de trabajo. Por ejemplo, la actividad se puede originar desde {% data variables.product.prodname_dotcom %} cuando alguien sube una confirmación a un repositorio o cuando se crea una propuesta o solicitud de extracción. También puedes configurar un flujo de trabajo para que se ejecute cuando ocurre un evento externo usando el webhook de envío de repositorios. - -### Ejecutor alojado de {% data variables.product.prodname_dotcom %} -{% data variables.product.prodname_dotcom %} aloja los ejecutores de Linux, Windows y macOS. Los trabajos se ejecutan en una nueva instancia de una máquina virtual que incluye el software preinstalado de uso común. {% data variables.product.prodname_dotcom %} realiza todas las actualizaciones y el mantenimiento de los ejecutores alojados de {% data variables.product.prodname_dotcom %}. No puedes personalizar la configuración de hardware de los ejecutores alojados de {% data variables.product.prodname_dotcom %}. Para obtener más información, consulta "[Entornos virtuales para ejecutores alojados de {% data variables.product.prodname_dotcom %}](/github/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)". - -### Trabajo - -Un conjunto de pasos que se ejecutan en el mismo ejecutor. Puedes definir reglas de dependencia para cómo se deben ejecutar los trabajos en un archivo de flujo de trabajo. Los trabajos se pueden ejecutar al mismo tiempo en paralelo o en forma secuencial en función del estado de un trabajo anterior. Por ejemplo, un flujo de trabajo puede tener dos trabajos consecutivos para desarrollar y probar el código. El trabajo de prueba depende del estado del trabajo de desarrollo. Si el trabajo de desarrollo falla, no se ejecutará el trabajo de prueba. Para los ejecutores alojados {% data variables.product.prodname_dotcom %}, cada trabajo en un flujo de trabajo se ejecuta en una nueva instancia de un entorno virtual. - -### Ejecutor - -Cualquier máquina con la aplicación del ejecutor {% data variables.product.prodname_actions %} instalada. Puedes usar un ejecutor alojado por {% data variables.product.prodname_dotcom %} o alojar tu propio ejecutor. Un ejecutor espera los trabajos disponibles. Cuando un ejecutor recoge un trabajo, ejecuta las acciones del trabajo e informa el progreso, los registros y los resultados finales a {% data variables.product.prodname_dotcom %}. Los runners ejecutan un trabajo por vez. Para obtener más información, consulta "[Ejecutor alojado y ejecutor autoalojado de {% data variables.product.prodname_dotcom %}](#github-hosted-runner)[](#self-hosted-runner)". - -{% note %} - -**Nota:** {% data reusables.github-actions.runner-app-open-source %} - -{% endnote %} - -### Ejecutor autoalojado - -Una máquina que administras y mantienes con la aplicación del ejecutor autoalojado instalada. {% data reusables.github-actions.self-hosted-runner-description %} Para obtener más información, consulta "[Alojar tus propios ejecutores](/github/automating-your-workflow-with-github-actions/hosting-your-own-runners)". - -### Paso - -Un paso es una tarea individual que puede ejecutar comandos o acciones. Un trabajo configura uno o más pasos. Cada paso en un trabajo se ejecuta en el mismo ejecutor, lo que permite que las acciones en ese trabajo compartan información usando el sistema de archivos. - -### Entorno virtual - -El entorno virtual de un ejecutor alojado de {% data variables.product.prodname_dotcom %} incluye la configuración de hardware, el sistema operativo y el software instalado de la máquina virtual. Para obtener más información, consulta "[Entornos virtuales para ejecutores alojados de {% data variables.product.prodname_dotcom %}](/github/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)". - -### Flujo de trabajo - -Un proceso automático configurable que puedes configurar en tu repositorio para elaborar, probar, empaquetar, lanzar o implementar cualquier proyecto en {% data variables.product.prodname_dotcom %}. Los flujos de trabajo constan de uno o más trabajos y se pueden programar o activar mediante un evento. - -### Archivo de flujo de trabajo - -El archivo YAML que define tu configuración de flujo de trabajo con un trabajo como mínimo. Este archivo se aloja en la raíz de tu repositorio {% data variables.product.prodname_dotcom %} en el directorio de `.github/workflows`. - -### Ejecución de flujo de trabajo - -Una instancia de tu flujo de trabajo que se ejecuta cuando ocurre el evento previamente configurado. Puedes ver los trabajos, acciones, registros y estados de cada ejecución de flujo de trabajo. diff --git a/translations/es-XL/content/actions/getting-started-with-github-actions/index.md b/translations/es-XL/content/actions/getting-started-with-github-actions/index.md deleted file mode 100644 index b8d26b33fd93..000000000000 --- a/translations/es-XL/content/actions/getting-started-with-github-actions/index.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: Comenzar con Acciones de GitHub -shortTitle: Empezar -intro: '{% data variables.product.prodname_actions %} presenta un poderoso entorno de ejecución integrado en todos los pasos de tu flujo de trabajo. Puedes descubrir, crear y compartir {% data variables.product.prodname_actions %} para realizar todos los trabajos que desees.' -redirect_from: - - /articles/getting-started-with-github-actions - - /github/automating-your-workflow-with-github-actions/getting-started-with-github-actions - - /actions/automating-your-workflow-with-github-actions/getting-started-with-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -{% topic_link_in_list /overview %} - {% link_in_list /about-github-actions %} - {% link_in_list /core-concepts-for-github-actions %} - {% link_in_list /security-hardening-for-github-actions %} -{% topic_link_in_list /using-community-workflows-and-actions %} - {% link_in_list /starting-with-preconfigured-workflow-templates %} - {% link_in_list /using-actions-from-github-marketplace %} diff --git a/translations/es-XL/content/actions/getting-started-with-github-actions/overview.md b/translations/es-XL/content/actions/getting-started-with-github-actions/overview.md deleted file mode 100644 index b55fccb337b8..000000000000 --- a/translations/es-XL/content/actions/getting-started-with-github-actions/overview.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Resumen -intro: 'Obtener más información acerca de conceptos y terminología de {% data variables.product.prodname_actions %}.' -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/es-XL/content/actions/getting-started-with-github-actions/security-hardening-for-github-actions.md b/translations/es-XL/content/actions/getting-started-with-github-actions/security-hardening-for-github-actions.md deleted file mode 100644 index e543898a2fa9..000000000000 --- a/translations/es-XL/content/actions/getting-started-with-github-actions/security-hardening-for-github-actions.md +++ /dev/null @@ -1,93 +0,0 @@ ---- -title: Fortalecimiento de seguridad para GitHub Actions -shortTitle: Fortalecimiento de seguridad -intro: 'Buenas prácticas de seguridad para utilizar las características de las {% data variables.product.prodname_actions %}.' -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -Esta guía explica cómo configurar el fortalecimiento de seguridad para ciertas características de las {% data variables.product.prodname_actions %}. Si no estás familiarizado con los conceptos de las {% data variables.product.prodname_actions %}, consulta la sección "[Conceptos principales para GitHub Actions](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)". - -### Utilizar secretos - -Los valores sensibles jamás deben almacenarse como texto simple e archivos de flujo de trabajo, sino más bien como secretos. Los [Secretos](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets) pueden configurarse a nivel de la organización o del repositorio, y te permiten almacenar información sensible en {% data variables.product.product_name %}. - -Los secretos utilizan [Cajas selladas de libsodium](https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes) de manera que se cifran antes de llegar a {% data variables.product.product_name %}. Esto ocurre cuando el secreto se emite [utilizando la IU](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets#creating-encrypted-secrets-for-a-repository) o a través de la [API de REST](/rest/reference/actions#secrets). Este cifrado del lado del cliente ayuda a minimizar los riesgos relacionados con el registro accidental (por ejemplo, bitácoras de exepción y de solicitud, entre otras) dentro de la infraestructura de {% data variables.product.product_name %}. Una vez que se carga el secreto, {% data variables.product.product_name %} puede entonces descifrarlo para que se pueda inyectar en el tiempo de ejecución del flujo de trabajo. - -Para ayudar a prevenir la divulgación accidental, {% data variables.product.product_name %} utiliza un mecanismo que intenta redactar cualquier secreto que aparezca en las bitácoras de ejecución. La redacción busca coincidencias exactas de cualquier secreto configurado, así como los cifrados comunes de los valores, tales como Base64. Sin embargo, ya que hay varias formas en las que se puede transformar el valor de un secreto, esta redacción no está garantizada. Como resultado, hay ciertos pasos proactivos y buenas prácticas que debes seguir para ayudarte a garantizar que se redacten los secretos, y para limitar otros riesgos asociados con ellos: - -- **Nunca uses datos estructurados como un secreto** - - Los datos inestructurados pueden causar que falle la redacción de secretos dentro de las bitácoras, ya que la redacción depende ampliamente en el encontrar una coincidencia exacta para el valor específico del secreto. Por ejemplo, no utilices un blob de JSON, XML, o YAML (o similares) para encapsular el valor de un secreto, ya que esto reduce significativamente la probablidad de que los secretos se redacten adecuadamente. En vez de esto, crea secretos individuales para cada valor sensible. -- **Registra todos los secretos que se utilizan dentro de los flujos de trabajo** - - Si los secretos se utilizan para generar otro valor sensible dentro de un flujo de trabajo, este valor generado debe [registrarse como un secreto](https://github.com/actions/toolkit/tree/master/packages/core#setting-a-secret) formalmente para que se pueda redactar si llega a aparecer en las bitácoras. Por ejemplo, si utilizas una llave privada para generar un JWT firmado para acceder a una API web, asegúrate registrar este JWT como un secreto, de lo contrario, este no se redactará si es que llega a ingresar en la salida de la bitácora. - - El registrar secretos aplica también a cualquier tipo de transformación/cifrado. Si tu secreto se transforma de alguna manera (como en el cifrado URL o de Base64), asegúrate de registrar el valor nuevo como un secreto también. -- **Audita cómo se manejan los secretos** - - Audita cómo se utilizan los secretos para ayudarte a garantizar que se manejan como lo esperas. Puedes hacer esto si revisas el código fuente del rpositorio que ejecuta el flujo de trabajo y verificas cualquier acción que se utilice en dicho flujo de trabajo. Por ejemplo, verifica que no se estén enviando a hosts no deseados, o que no se estén imprimiendo explícitamente en la salida de una bitácora. - - Visualiza las bitácoras de ejecución de tu flujo de trabajo después de probar las entradas válidas/no válidas y verifica que los secretos se redacten adecuadamente o que no se muestren. No siempre es obvio la forma en la que una herramienta o un comando que estés invocando enviará los errores a `STDOUT` o a `STDERR`, y los secretos pueden terminar siendo bitácoras de errores después. Por consiguiente, es una buena práctica el revisar manualmente las bitácoras de flujo de trabajo después de probar las entradas válidas y no válidas. -- **Utiliza credenciales que tengan alcances mínimos** - - Asegúrate de que las credenciales que estás utilizando dentro de los flujos de trabajo tengan los menores privilegios requeridos y ten en mente que cualquier usuario con acceso de escritura en tu repositorio tiene acceso de lectura para todos los secretos que has configurado en éste. -- **Audita y rota los secretos registrados** - - Revisa con frecuencia los secretos que se han registrado para confirmar que aún se requieran. Elimina aquellos que ya no se necesiten. - - Rota los secretos con frecuencia para reducir la ventana de tiempo en la que un secreto puesto en riesgo es aún válido. - -### Utilizar acciones de terceros - -Los jobs individuales en un flujo de trabajo pueden interactuar con (y ponerse enriesgo con) otros jobs. Por ejemplo, un job que consulta las variables de mabiente que se utilizan por otro job subsecuente, escribir archivos en un directorio compartido que el job subsecuente procesa, o aún de forma ás directa si interactúa con el conector de Docker e inspecciona a otros contenedores en ejecución y ejecuta comandos en ellos. - -Esto significa que el poner en riesgo una sola acción dentro de un flujo de trabajo puede ser bastante significativo, ya que dicha acción en riesgo tendrá acceso a todos los secretos que configuras en tu repositorio, y puede utilizar el `GITHUB_TOKEN` para escribir en el repositorio. Por consiguiente, hay un riesgo significativo en suministrar acciones de repositorios de terceros en {% data variables.product.prodname_dotcom %}. Puedes ayudar a mitigar este riesgo si sigues estas buenas prácticas: - -* **Fija las acciones a un SHA de confirmación de longitud completa** - - Fijar una acción a un SHA de confirmación de longitud completa es actualmente la única forma de utilizar una acción como un lanzamiento inmutable. Fijar las acciones a un SHA en particular ayuda a mitigar el riesgo de que un actor malinencionado agregue una puerta trasera al repositorio de la acción, ya que necesitarían generar una colisión de SHA-1 para una carga útil vlálida de un objeto de Git. - - {% warning %} - - **Advertencia:** La versión corta del SHA de confirmación no es segura y jamás debería utilizarse para especificar la referencia de Git de una acción. Debido a cómo funcionan las redes de los repositorios, cualquier usuario puede bifurcar el repositorio y cargar una confirmación creada a éste, la cual colisione con el SHA corto. Esto causa que fallen los clones subsecuentes a ese SHA, debido a que se convierte en una confirmación ambigua. Como resultado, cualquier flujo de trabajo que utilice el SHA acortado fallará de inmediato. - - {% endwarning %} -* **Audita el código fuente de la acción** - - Asegúrate de que la acción está manejando los secretos y el contenido de tu repositorio como se espera. Por ejemplo, verifica que los secretos no se envíen a hosts no deseados, o que no se registren inadvertidamente. - -* **Fija las acciones a una etiqueta únicamente si confías en el creador** - - Aunque fijar el SHA de una confirmación es la opción más segura, especificar una etiqueta es más conveniente y se utiliza ampliamente. Si te gustaría especificar una etiqueta, entonces asegúrate de que confías en los creadores de la acción. La insignia de ‘Verified creator’ en {% data variables.product.prodname_marketplace %} es una señal útil, ya que te indica que la acción viene de un equipo cuya identidad verificó {% data variables.product.prodname_dotcom %}. Nota que este acercamiento sí tiene riesgos aún si confías en el autor, ya que una etiqueta se puede mover o borrar en caso de que un actor malicioso consiga acceso al repositorio que almacena la acción. - -### Considerar acceso entre repositorios - -{% data variables.product.product_name %} tiene un alcance intencional para un solo repositorio por vez. El `GITHUB_TOKEN` que se utiliza en el ambiente de trabajo otorga el mismo nivel de acceso que un usuario con acceso de escritura, ya que cualquier usuario con acceso de escritura podrá acceder a este token si crea o modifica los archivos de flujo de trabajo. Los usuarios tienen permisos específicos para cada repositorio, así que, el hacer que el `GITHUB_TOKEN` para un repositorio otorgue acceso a otro impactaría el modelo de permisos de {% data variables.product.prodname_dotcom %} si no se implementa cuidadosamente. De forma similar, se debe tener cuidado cuando se agreguen tokens de autenticación de {% data variables.product.prodname_dotcom %} al ambiente de flujo de trabajo, ya que esto puede afectar el permiso de {% data variables.product.prodname_dotcom %} al otorgar acceso amplio a los colaboradores de forma inadvertida. - -Tenemos [un plan en el itinerario de {% data variables.product.prodname_dotcom %}](https://github.com/github/roadmap/issues/74) para compatibilizar un flujo que permita acceso entre repositorios dentro de {% data variables.product.product_name %}, pero aún no es una característica compatible. Actualmente, la única forma de llevar a cabo las interacciones privilegiadas entre repositorios es colocar un token de autenticación de {% data variables.product.prodname_dotcom %} o una llave SSH en forma de secreto dentro del ambiente del flujo de trabajo. Ya que muchos tipos de tokens de autenticación no permiten el acceso granular a recursos específicos, existe un riesgo significativo en el utilizar el tipo incorrecto de token, ya que puede otorgr un acceso mucho más amplio que lo que se espera. - -Esta lista describe los acercamientos recomendatos para acceder alos datos de un repositorio dentro de un flujo de trabjajo, en orden descendente de preferencia: - -1. **El `GITHUB_TOKEN` en el ambiente del fujo de trabajo** - - Este token tiene un alcance intencional para el repositorio único que invocó el flujo de trabajo, y tiene el mismo nivel de acceso que el de un usuario con acceso de escritura en el repositorio. El token se crea antes de que inicie cada job y caduca cuando dicho job finaliza. Para más información, consulta la sección "[Autenticarse con el GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)." - - El `GITHUB_TOKEN` debe utilizarse cada que sea posible. -2. **Llave de despliegue del repositorio** - - Las llaves de despliegue son uno de los únicos tipos de credenciales que otorgan acceso de lectura o escritura en un solo repositorio, y pueden utilizarse para interactuar con otro repositorio dentro de un flujo de trabajo. Para obtener más información, consulta la sección "[Administrar las llaves de despliegue](/developers/overview/managing-deploy-keys#deploy-keys)". - - Nota que las llaves de despliegue solo pueden clonarse y subirse al repositorio utilizando Git, y no pueden utilizarse para interactuar con las API de REST o de GraphQL, así que puede no sean adecuadas para tus necesidades. -3. **Tokens de {% data variables.product.prodname_github_app %}** - - Las {% data variables.product.prodname_github_apps %} pueden instalarse en los repositorios seleccionados, e incluso tienen permisos granulares en los recursos dentro de ellos. Puedes crear una {% data variables.product.prodname_github_app %} interna a tu organización, instalarla en los repositorios a los que necesites tener acceso dentro de tu flujo de trabajo, y autenticarte como la instalación dentro del flujo de trabajo para acceder a esos repositorios. -4. **Tokens de acceso personal** - - Jamás debes utilizar tokens de acceso personal desde tu propia cuenta. Estos tokens otorgan acceso a todos los repositorios dentro de las organizaciones a las cuales tienes acceso, así como a los repositorios en tu cuenta de usuario. Esto otorga indirectamente un acceso amplio a todos los usuarios con acceso de escritura en el repositorio en el cual está el flujo de trabajo. Adicionalmente, si sales de una organización más adelante, los flujos de trabajo que utilicen este token fallarán inmediatamente, y depurar este problema puede ser difícil. - - Si se utiliza un token de acceso personal, debe ser uno que se haya generado para una cuenta nueva a la que solo se le haya otorgado acceso para los repositorios específicos que se requieren para el flujo de trabajo. Nota que este acercamiento no es escalable y debe evitarse para favorecer otras alternativas, tales como las llaves de despliegue. -5. **Llaves SSH en una cuenta de usuario** - - Los flujos de trabajo nunca deben utilizar las llaves SSH en una cuenta de usuario. De forma similar a los tokens de acceso personal, estas otorgan permisos de lectura/escritura a todos tus repositorios personales así como a todos los repositorios a los que tengas acceso mediante la membercía de organización. Esto otorga indirectamente un acceso amplio a todos los usuarios con acceso de escritura en el repositorio en el cual está el flujo de trabajo. Si pretendes utilizar una llave SSH porque solo necesitas llevar a cabo clonados de repositorio o subidas a éste, y no necesitas interactuar con una API pública, entonces mejor deberías utilizar llaves de despliegue individuales. - -### Fortalecimiento para los ejecutores auto-hospedados - -Los ejecutores **hospedados en {% data variables.product.prodname_dotcom %}** ejecutan código dentro de máquinas virtuales aisladas, limpias y efímeras, lo cual significa que no hay forma de poner este ambiente en riesgo de forma persistente, o de obtener acceso de otra forma a más información de la que se colocó en este ambiente durante el proceso de arranque. - -Los ejecutores **auto-hospedados** eb {% data variables.product.product_name %} no tienen garantías sobre la ejecución en máquinas virtuales limpias y efímeras, y pueden estar en riesgo persistentemente debido al código no confiable en un flujo de trabajo. - -Como resultado, los ejecutores auto-hospedados no deberán [utilizarse casi nunca para repositorios públicos](/actions/hosting-your-own-runners/about-self-hosted-runners#self-hosted-runner-security-with-public-repositories) en {% data variables.product.product_name %}, ya que cualquier usuario puede abrir solicitudes de extracción contra este repositorio y poner en riesgo el ambiente. De forma similar, ten cuidado cuando utilices ejecutores auto-hospedados en repositorios privados, ya que cualquiera que pueda bifurcar el repositorio y abrir una solicitud de extracción (generalmente aquellos con acceso de lectura en el repositorio) podrá también poner en riesgo el ambiente del ejecutor auto-hospedado, incluyendo el obtener acceso a los secretos y al `GITHUB_TOKEN` más privilegiado que otorga permisos de acceso de escritura en el repositorio. - -También deberás considerar el ambiente de las máquinas del ejecutor auto-hospedado: -- ¿Qué información sensible reside en la máquina configurada como el ejecutor auto-hospedado? Por ejemplo, llaves SSH privadas, tokens de acceso a la API, entre otros. -- ¿La máquina tiene acceso a la red para servicios sensibles? Por ejemplo, servicios de metadatos de Azure o de AWS. La cantidad de información sensible en este ambiente debe ser mínima, y siempre debes estar consciente de que cualquier usuario capaz de invocar flujos de trabajo tendrá acceso a este ambiente. diff --git a/translations/es-XL/content/actions/getting-started-with-github-actions/starting-with-preconfigured-workflow-templates.md b/translations/es-XL/content/actions/getting-started-with-github-actions/starting-with-preconfigured-workflow-templates.md deleted file mode 100644 index 80e75ce8685e..000000000000 --- a/translations/es-XL/content/actions/getting-started-with-github-actions/starting-with-preconfigured-workflow-templates.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: Comenzar con plantillas de flujo de trabajo preconfiguradas -intro: '{% data variables.product.prodname_dotcom %} ofrece plantillas de flujo de trabajo preconfiguradas para automatizar tu flujo de trabajo o crear un flujo de trabajo de CI para lenguajes y marcos específicos.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/starting-with-preconfigured-workflow-templates -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Acerca de plantillas de flujo de trabajo - -{% data variables.product.product_name %} analiza tu código y te muestra las plantillas de CI que mejor se ajustan a tu repositorio. Por ejemplo, si tu repositorio contiene un código Node.js, verás sugerencias para los proyectos de Node.js. Puedes usar plantillas de flujo de trabajo como lugar de inicio para crear tu flujo de trabajo personalizado o usarlos tal como están. - -Puedes examinar la lista completa de plantillas de CI en el repositorio [actions/starter-workflows](https://github.com/actions/starter-workflows/tree/master/ci). También puedes encontrar plantillas para automatizar tu flujo de trabajo. También puedes encontrar plantillas para automatizar tu flujo de trabajo. - -### Agregar tu primera plantilla de flujo de trabajo - -Si aún no has agregado un flujo de trabajo a tu repositorio, verás una lista de plantillas de flujo de trabajo para elegir. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.actions-set-up-workflow-template %} - -### Agregar plantillas de flujo de trabajo adicionales - -Si ya tienes un flujo de trabajo y deseas agregar un nuevo flujo de trabajo de plantilla, puedes navegar hasta las plantillas de flujo de trabajo. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.actions-new-workflow %} -{% data reusables.repositories.actions-set-up-workflow-template %} diff --git a/translations/es-XL/content/actions/getting-started-with-github-actions/using-actions-from-github-marketplace.md b/translations/es-XL/content/actions/getting-started-with-github-actions/using-actions-from-github-marketplace.md deleted file mode 100644 index f055c7bb5a70..000000000000 --- a/translations/es-XL/content/actions/getting-started-with-github-actions/using-actions-from-github-marketplace.md +++ /dev/null @@ -1,51 +0,0 @@ ---- -title: Usar acciones de GitHub Marketplace -intro: 'Puedes explorar y buscar acciones en {% data variables.product.prodname_marketplace %} para usar en tus flujos de trabajo.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/using-github-marketplace-actions - - /actions/automating-your-workflow-with-github-actions/using-actions-from-github-marketplace-in-your-workflow -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Acerca de las acciones en {% data variables.product.prodname_marketplace %} - -{% data variables.product.prodname_marketplace %} es una ubicación central para que encuentres las acciones que crea la comunidad de {% data variables.product.prodname_dotcom %}. Las acciones con una insignia indican que {% data variables.product.prodname_dotcom %} ha verificado al creador de la misma como una organización asociada. - -{% data reusables.actions.enterprise-marketplace-actions %} - -Puedes descubrir nuevas acciones desde el editor de flujo de trabajo en {% data variables.product.prodname_dotcom %}, y desde la [ página de {% data variables.product.prodname_marketplace %}](https://github.com/marketplace/actions/). - -El ver las acciones directamente en el editor de flujo de datos proporciona un acceso rápido a todas las acciones en {% data variables.product.prodname_marketplace %}. La página de acciones de {% data variables.product.prodname_marketplace %} ofrece más flexibilidad para filtrar acciones por categoría. - -### Acciones de navegación en el editor de flujo de trabajo - -Puedes buscar y explorar acciones directamente en el editor de flujo de trabajo de tu repositorio. Desde la barra lateral, puedes buscar una acción específica, ver acciones destacadas y explorar las categorías destacadas. También puedes ver la cantidad de estrellas que una acción ha recibido desde la comunidad {% data variables.product.prodname_dotcom %}. - -1. En tu repositorio, navega hasta el archivo de flujo de trabajo que deseas editar. -1. En el ángulo superior derecho de la vista del archivo, para abrir el editor de flujo de trabajo, haz clic en {% octicon "pencil" aria-label="The edit icon" %}.![Botón para editar un archivo de flujo de trabajo](/assets/images/help/repository/actions-edit-workflow-file.png) -1. A la derecha del editor, usa la barra lateral de {% data variables.product.prodname_marketplace %} para explorar acciones.![Barra lateral del flujo de trabajo de Marketplace](/assets/images/help/repository/actions-marketplace-sidebar.png) - -### Acciones de navegación en {% data variables.product.prodname_marketplace %} - -Puedes encontrar las mismas acciones en [la página de acciones de {% data variables.product.prodname_marketplace %}](https://github.com/marketplace/actions/). En la página de {% data variables.product.prodname_marketplace %}, tienes más flexibilidad para filtrar acciones por categoría y verificación. - -### Agregar una acción a tu flujo de trabajo desde el editor de flujo de trabajo - -La página de descripción de una acción incluye la versión de la acción y la sintaxis de flujo de trabajo que se necesita para usar la acción. - -1. Navega hasta la acción que deseas usar en tu flujo de trabajo. -1. En "Installation" (Instalación), haz clic en {% octicon "clippy" aria-label="The edit icon" %} para copiar la sintaxis del flujo de trabajo. ![Ver descripción de la acción](/assets/images/help/repository/actions-sidebar-detailed-view.png) -1. Pega la sintaxis como un nuevo paso en tu flujo de trabajo. Para obtener más información, consulta "[Sintaxis de flujo de trabajo para {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idsteps)." -1. Si la acción requiere que proporciones variables, establécelas en tu flujo de trabajo. Para obtener más información sobre las variables que puede requerir una acción, consulta la descripción completa de la acción en {% data variables.product.prodname_marketplace %}. - -{% if currentVersion == "free-pro-team@latest" %} - -{% data reusables.dependabot.version-updates-for-actions %} - -{% endif %} diff --git a/translations/es-XL/content/actions/getting-started-with-github-actions/using-community-workflows-and-actions.md b/translations/es-XL/content/actions/getting-started-with-github-actions/using-community-workflows-and-actions.md deleted file mode 100644 index 7c6b2e2521b3..000000000000 --- a/translations/es-XL/content/actions/getting-started-with-github-actions/using-community-workflows-and-actions.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Usar flujos de trabajo y acciones de la comunidad -intro: 'Usa acciones y flujos de trabajo creados por otras personas y organizaciones, incluidos {% data variables.product.prodname_dotcom %}.' -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/es-XL/content/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners.md b/translations/es-XL/content/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners.md deleted file mode 100644 index 530c81ab00be..000000000000 --- a/translations/es-XL/content/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: Administrar el acceso a los ejecutores auto-hopsedados -intro: Puedes controlar qué repositorios pueden mandar jobs a los ejecutores auto-hospedados de una organización. -versions: - free-pro-team: '*' ---- - -Los ejecutores auto-hospedados que se agreguen a nivel organizacional pueden procesar jobs para todos los repositorios en la misma. Si necesitas limitar el acceso a tus ejecutores auto-hospedados, puedes configurar la política para procesar únicamente los jobs para repositorios privados, o puedes definir un listado de repositorios permitidos. - -### Controlar qué repositorios tienen acceso a los ejecutores de una organización - -{% data reusables.organizations.navigate-to-org %} -{% data reusables.organizations.org_settings %} -{% data reusables.organizations.settings-sidebar-actions %} -1. Junto a "Ejecutores auto-hospedados", da clic en **Administrar permisos del repositorio**. ![Administrar permisos del repositorio](/assets/images/help/settings/actions-runner-manage-permissions.png) - -1. Desde el menú desplegable, escoge alguna de las siguientes opciones: - - * **Todos los repositorios** - Todos los repositorios públicos y privados en la organización pueden mandar jobs a los ejecutores auto-hospedados de la misma. - * **Repositorios privados** - Solo los repositorios privados en la organización pueden mandar jobs a los ejecutores auto-hospedados. - * **Repositorios seleccionados** - Utiliza el menú de selección de repositorios para escoger aquellos repositorios de la organización que pueden enviar jobs a los ejecutores auto-hospedados de la misma. diff --git a/translations/es-XL/content/actions/language-and-framework-guides/building-and-testing-java-with-ant.md b/translations/es-XL/content/actions/language-and-framework-guides/building-and-testing-java-with-ant.md deleted file mode 100644 index 80b85398a9a6..000000000000 --- a/translations/es-XL/content/actions/language-and-framework-guides/building-and-testing-java-with-ant.md +++ /dev/null @@ -1,107 +0,0 @@ ---- -title: Construir y probar Java con Ant -intro: Puedes crear un flujo de trabajo de integración continua (CI) en Acciones de GitHub para construir y probar tu proyecto Java con Ant. -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Introducción - -Esta guía te muestra cómo crear un flujo de trabajo que realiza integración continua (CI) para tu proyecto de Java por medio del sistema de construcción Ant. El flujo de trabajo que creas te permitirá ver cuándo las confirmaciones de una solicitud de extracción causan la construcción o las fallas de prueba en tu rama por defecto; este enfoque puede ayudar a garantizar que tu código siempre sea correcto. Puedes ampliar tu flujo de trabajo de CI para cargar artefactos desde una ejecución de flujo de trabajo. - -Los ejecutores alojados en {% data variables.product.prodname_dotcom %} tienen un caché de herramientas con software preinstalado, que incluye Java Development Kits (JDK) y Ant. Para obtener una lista de software y versiones preinstaladas para JDK y Ant, consulta "[Software instalado en ejecutores alojados en {% data variables.product.prodname_dotcom %}](/actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners)". - -### Prerrequisitos - -Deberías estar familiarizado con YAML y la sintaxis para las {% data variables.product.prodname_actions %}. Para obtener más información, consulta: -- "[Sintaxis de flujo de trabajo para las {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)" -- "[Configurar un flujo de trabajo](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)" - -Recomendamos que tengas un conocimiento básico de Java y de la estructura de Ant. Para obtener más información, consulta el [Manual de Apache Ant](https://ant.apache.org/manual/). - -{% data reusables.actions.enterprise-setup-prereq %} - -### Comenzar con una plantilla de flujo de trabajo de Ant - -{% data variables.product.prodname_dotcom %} proporciona una plantilla de flujo de trabajo de Ant que funcionará para la mayoría de los proyectos de Java basados en Ant. Para obtener más información, consulta la [Plantilla de flujo de trabajo de Ant](https://github.com/actions/starter-workflows/blob/master/ci/ant.yml). - -Para comenzar rápidamente, puedes elegir la plantilla de Ant preconfigurada cuando crees un nuevo flujo de trabajo. Para obtener más información, consulta "[Comenzar con plantillas de flujo de trabajo preconfiguradas](/actions/automating-your-workflow-with-github-actions/starting-with-preconfigured-workflow-templates)." - -También puedes agregar este flujo de trabajo de forma manual al crear un archivo nuevo en el directorio de tu repositorio `.github/workflows`. - -{% raw %} -```yaml -name: Java CI - -on: [push] - -jobs: - build: - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - name: Set up JDK 1.8 - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Build with Ant - run: ant -noinput -buildfile build.xml -``` -{% endraw %} - -Este flujo de trabajo realiza los siguientes pasos: - -1. El paso `checkout (comprobación)` descarga una copia de tu repositorio en el ejecutor. -2. El paso `setup-java` configura el JDK de Java 1.8. -3. El paso "Build with Ant" (Construir con Ant) ejecuta el objetivo predeterminado en tu `build.xml` en el modo no interactivo. - -Las plantillas de flujo de trabajo predeterminadas son excelentes puntos de inicio cuando creas tu flujo de trabajo de construcción y prueba, y puedes personalizar la plantilla para adaptarla a las necesidades de tu proyecto. - -{% data reusables.github-actions.example-github-runner %} - -{% data reusables.github-actions.java-jvm-architecture %} - -### Construir y probar tu código - -Puedes usar los mismos comandos que usas de forma local para construir y probar tu código. - -El flujo de trabajo de inicio ejecutará el destino predeterminado especificado en tu archivo _build.xml_. Normalmente, tu objetivo predeterminado se configurará para crear clases, ejecutar pruebas y empaquetar clases en su formato distribuible, por ejemplo, un archivo JAR. - -Si usas diferentes comandos para construir tu proyecto, o si deseas ejecutar un objetivo diferente, puedes especificarlos. Por ejemplo, es posible que desees ejecutar el destino `jar` que está configurado en tu archivo _build-ci.xml_. - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Run the Ant jar target - run: ant -noinput -buildfile build-ci.xml jar -``` -{% endraw %} - -### Empaquetar datos de flujo de trabajo como artefactos - -Una vez que tu compilación haya tenido éxito y tus pruebas hayan pasado, es posible que desees cargar los paquetes Java resultantes como un artefacto de construcción. Esto almacenará los paquetes construidos como parte de la ejecución del flujo de trabajo y te permitirá descargarlos. Los artefactos pueden ayudarte a probar y depurar solicitudes de extracción en tu entorno local antes de que se fusionen. Para obtener más información, consulta "[Conservar datos de flujo de trabajo mediante artefactos](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)." - -Por lo general, Ant crea archivos de salida como JAR, EAR o WAR en el directorio `build/jar`. Puedes cargar los contenidos de ese directorio utilizando la acción `upload-Artifact`. - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - - run: ant -noinput -buildfile build.xml - - uses: actions/upload-artifact@v2 - with: - name: Package - path: build/jar -``` -{% endraw %} diff --git a/translations/es-XL/content/actions/language-and-framework-guides/building-and-testing-java-with-gradle.md b/translations/es-XL/content/actions/language-and-framework-guides/building-and-testing-java-with-gradle.md deleted file mode 100644 index 89e6f317fc40..000000000000 --- a/translations/es-XL/content/actions/language-and-framework-guides/building-and-testing-java-with-gradle.md +++ /dev/null @@ -1,132 +0,0 @@ ---- -title: Construir y probar Java con Gradle -intro: Puedes crear un flujo de trabajo de integración continua (CI) en acciones de GitHub para construir y probar tu proyecto Java con Gradle. -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Introducción - -Esta guía te muestra cómo crear un flujo de trabajo que realiza la integración continua (CI) para tu proyecto Java usando el sistema de construcción Gradle. El flujo de trabajo que creas te permitirá ver cuándo las confirmaciones de una solicitud de extracción causan la construcción o las fallas de prueba en tu rama por defecto; este enfoque puede ayudar a garantizar que tu código siempre sea correcto. Puedes extender tu flujo de trabajo de CI para almacenar en caché los archivos y cargar artefactos desde una ejecución de flujo de trabajo. - -Los ejecutores alojados {% data variables.product.prodname_dotcom %} tienen una caché de herramientas con software preinstalado, que incluye kits de desarrollo de Java (JDK) y Gradle. Para obtener una lista de software y las versiones preinstaladas para JDK y Gradle, consulta "[Software instalado en ejecutores alojados {% data variables.product.prodname_dotcom %} ](/actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners)". - -### Prerrequisitos - -Deberías estar familiarizado con YAML y la sintaxis para las {% data variables.product.prodname_actions %}. Para obtener más información, consulta: -- "[Sintaxis de flujo de trabajo para las {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)" -- "[Configurar un flujo de trabajo](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)" - -Te recomendamos que tengas una comprensión básica de Java y del marco de Gradle. Para obtener más información, consulta [Empezar](https://docs.gradle.org/current/userguide/getting_started.html) en la documentación de Gradle. - -{% data reusables.actions.enterprise-setup-prereq %} - -### Comenzar con una plantilla de flujo de trabajo de Gradle - -{% data variables.product.prodname_dotcom %} proporciona una plantilla de flujo de trabajo de Gradle que funcionará para la mayoría de los proyectos Java basados en Gradle. Para obtener más información, consulta la [Plantilla de flujo de trabajo de Gradle](https://github.com/actions/starter-workflows/blob/master/ci/gradle.yml). - -Para comenzar rápidamente, puedes elegir la plantilla de Gradle preconfigurada cuando creas un nuevo flujo de trabajo. Para obtener más información, consulta "[Comenzar con plantillas de flujo de trabajo preconfiguradas](/actions/automating-your-workflow-with-github-actions/starting-with-preconfigured-workflow-templates)." - -También puedes agregar este flujo de trabajo de forma manual al crear un archivo nuevo en el directorio de tu repositorio `.github/workflows`. - -{% raw %} -```yaml -name: Java CI - -on: [push] - -jobs: - build: - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - name: Set up JDK 1.8 - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Build with Gradle - run: ./gradlew build -``` -{% endraw %} - -Este flujo de trabajo realiza los siguientes pasos: - -1. El paso `checkout (comprobación)` descarga una copia de tu repositorio en el ejecutor. -2. El paso `setup-java` configura el JDK de Java 1.8. -3. El paso "Build with Gradle" (construir con Gradle) ejecuta el script contenedor `gradlew` para asegurar que tu código se cree, las pruebas pasen y se pueda crear un paquete. - -Las plantillas de flujo de trabajo predeterminadas son excelentes puntos de inicio cuando creas tu flujo de trabajo de construcción y prueba, y puedes personalizar la plantilla para adaptarla a las necesidades de tu proyecto. - -{% data reusables.github-actions.example-github-runner %} - -{% data reusables.github-actions.java-jvm-architecture %} - -### Construir y probar tu código - -Puedes usar los mismos comandos que usas de forma local para construir y probar tu código. - -El flujo de trabajo de inicio ejecutará la tarea `build` por defecto. En la configuración de Gradle predeterminada, este comando descargará las dependencias, construirá clases, ejecutará pruebas y empaquetará las clases en su formato distribuible, por ejemplo, un archivo JAR. - -Si usas diferentes comandos para construir tu proyecto, o si quieres usar una tarea diferente, puedes especificarlo. Por ejemplo, es posible que desees ejecutar la tarea `package` que está configurada en tu archivo _ci.gradle_. - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Run the Gradle package task - run: ./gradlew -b ci.gradle package -``` -{% endraw %} - -### Almacenar dependencias en caché - -Puedes almacenar en caché tus dependencias para acelerar tus ejecuciones de flujo de trabajo. Después de una ejecución exitosa, tu caché de paquete de Gradle local se almacenará en la infraestructura de acciones de GitHub. En las ejecuciones de flujo de trabajo futuras, la caché se restaurará para que las dependencias no necesiten ser descargadas desde los repositorios de paquetes remotos. Para obtener más información, consulta "[Almacenar en caché las dependencias para agilizar los flujos de trabajo](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)" y la acción [`cache`](https://github.com/marketplace/actions/cache). - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - name: Set up JDK 1.8 - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Cache Gradle packages - uses: actions/cache@v2 - with: - path: ~/.gradle/caches - key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle') }} - restore-keys: ${{ runner.os }}-gradle - - name: Build with Gradle - run: ./gradlew build -``` -{% endraw %} - -Este flujo de trabajo guardará los contenidos de tu caché de paquete Gradle local, que se encuentra en el directorio `.gradle/caches` del directorio de inicio del ejecutor. La clave de caché será el contenido con hash de los archivos de construcción de Gradle, por lo que los cambios en ellos invalidarán la memoria caché. - -### Empaquetar datos de flujo de trabajo como artefactos - -Una vez que tu compilación haya tenido éxito y tus pruebas hayan pasado, es posible que desees cargar los paquetes Java resultantes como un artefacto de construcción. Esto almacenará los paquetes construidos como parte de la ejecución del flujo de trabajo y te permitirá descargarlos. Los artefactos pueden ayudarte a probar y depurar solicitudes de extracción en tu entorno local antes de que se fusionen. Para obtener más información, consulta "[Conservar datos de flujo de trabajo mediante artefactos](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)." - -Por lo general, Gradle creará archivos de salida como JAR, EAR o WAR en el directorio `build/libs`. Puedes cargar los contenidos de ese directorio utilizando la acción `upload-Artifact`. - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - - run: ./gradlew build - - uses: actions/upload-artifact@v2 - with: - name: Package - path: build/libs -``` -{% endraw %} diff --git a/translations/es-XL/content/actions/language-and-framework-guides/building-and-testing-java-with-maven.md b/translations/es-XL/content/actions/language-and-framework-guides/building-and-testing-java-with-maven.md deleted file mode 100644 index 3b0b714c9141..000000000000 --- a/translations/es-XL/content/actions/language-and-framework-guides/building-and-testing-java-with-maven.md +++ /dev/null @@ -1,133 +0,0 @@ ---- -title: Construir y probar Java con Maven -intro: Puedes crear un flujo de trabajo de integración continua (CI) en acciones de GitHub para construir y probar tu proyecto Java con Maven. -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Introducción - -Esta guía te muestra cómo crear un flujo de trabajo que realiza la integración continua (CI) para tu proyecto Java utilizando la herramienta de gestión de proyectos de software Maven. El flujo de trabajo que creas te permitirá ver cuándo las confirmaciones de una solicitud de extracción causan la construcción o las fallas de prueba en tu rama por defecto; este enfoque puede ayudar a garantizar que tu código siempre sea correcto. Puedes extender tu flujo de trabajo de CI para almacenar en caché los archivos y cargar artefactos desde una ejecución de flujo de trabajo. - -Los ejecutores alojados en {% data variables.product.prodname_dotcom %} tienen una caché de herramientas con un software preinstalado, que incluye kits de desarrollo de Java (JDK) y Maven. Para obtener una lista de software y las versiones preinstaladas para JDK y Maven, consulta "[Software instalado en {% data variables.product.prodname_dotcom %}-Runners hospedados](/actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners)". - -### Prerrequisitos - -Deberías estar familiarizado con YAML y la sintaxis para las {% data variables.product.prodname_actions %}. Para obtener más información, consulta: -- "[Sintaxis de flujo de trabajo para las {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)" -- "[Configurar un flujo de trabajo](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)" - -Te recomendamos que tengas una comprensión básica de Java y del marco de Maven. Para obtener más información, consulta el [Guía de introducción a Maven](http://maven.apache.org/guides/getting-started/index.html) en la documentación de Maven. - -{% data reusables.actions.enterprise-setup-prereq %} - -### Comenzar con una plantilla de flujo de trabajo de Maven - -{% data variables.product.prodname_dotcom %} proporciona una plantilla de flujo de trabajo de Maven que funcionará para la mayoría de los proyectos Java basados en Maven. Para obtener más información, consulta la [Plantilla de flujo de trabajo Maven](https://github.com/actions/starter-workflows/blob/master/ci/maven.yml). - -Para comenzar rápidamente, puedes elegir la plantilla Maven preconfigurada cuando creas un nuevo flujo de trabajo. Para obtener más información, consulta "[Comenzar con plantillas de flujo de trabajo preconfiguradas](/actions/automating-your-workflow-with-github-actions/starting-with-preconfigured-workflow-templates)." - -También puedes agregar este flujo de trabajo de forma manual al crear un archivo nuevo en el directorio de tu repositorio `.github/workflows`. - -{% raw %} -```yaml -name: Java CI - -on: [push] - -jobs: - build: - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - name: Set up JDK 1.8 - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Build with Maven - run: mvn -B package --file pom.xml -``` -{% endraw %} - -Este flujo de trabajo realiza los siguientes pasos: - -1. El paso `checkout (comprobación)` descarga una copia de tu repositorio en el ejecutor. -2. El paso `setup-java` configura el JDK de Java 1.8. -3. El paso "Build with Maven" (Construir con Maven) ejecuta el `paquete` destino de Maven en modo no interactivo para garantizar que tu código se compile, se superen las pruebas y se pueda crear un paquete. - -Las plantillas de flujo de trabajo predeterminadas son excelentes puntos de inicio cuando creas tu flujo de trabajo de construcción y prueba, y puedes personalizar la plantilla para adaptarla a las necesidades de tu proyecto. - -{% data reusables.github-actions.example-github-runner %} - -{% data reusables.github-actions.java-jvm-architecture %} - -### Construir y probar tu código - -Puedes usar los mismos comandos que usas de forma local para construir y probar tu código. - -El flujo de trabajo de inicio ejecutará el `paquete` destino por defecto. En la configuración predeterminada de Maven, este comando descargará dependencias, construirá clases, ejecutar pruebas y las clases de paquetes en su formato distribuible, por ejemplo, un archivo JAR. - -Si usas diferentes comandos para compilar tu proyecto, o si quieres usar un destino diferente, puedes especificarlos. Por ejemplo, es posible que desees ejecutar el objetivo `verify (verificar)` que está configurado en un archivo _pom-ci.xml_. - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Run the Maven verify phase - run: mvn -B verify --file pom-ci.xml -``` -{% endraw %} - -### Almacenar dependencias en caché - -Puedes almacenar en caché tus dependencias para acelerar tus ejecuciones de flujo de trabajo. Después de una ejecución exitosa, tu repositorio Maven local se almacenará en la infraestructura de acciones de GitHub. En las ejecuciones de flujo de trabajo futuras, el caché se restaurará para que las dependencias no necesiten descargarse desde los repositorios remotos de Maven. Para obtener más información, consulta "[Almacenar en caché las dependencias para agilizar los flujos de trabajo](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)" y la acción [`cache`](https://github.com/marketplace/actions/cache). - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - name: Set up JDK 1.8 - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Cache Maven packages - uses: actions/cache@v2 - with: - path: ~/.m2 - key: ${{ runner.os }}-m2-${{ hashFiles('**/pom.xml') }} - restore-keys: ${{ runner.os }}-m2 - - name: Build with Maven - run: mvn -B package --file pom.xml -``` -{% endraw %} - -Este flujo de trabajo guardará los contenidos de tu repositorio local de Maven, ubicado en el directorio `.m2` del directorio de inicio del ejecutor. La clave de caché será el contenido con hash de _pom.xml_, por lo que los cambios en _pom.xml_ invalidará el caché. - -### Empaquetar datos de flujo de trabajo como artefactos - -Una vez que tu compilación haya tenido éxito y tus pruebas hayan pasado, es posible que desees cargar los paquetes Java resultantes como un artefacto de construcción. Esto almacenará los paquetes construidos como parte de la ejecución del flujo de trabajo y te permitirá descargarlos. Los artefactos pueden ayudarte a probar y depurar solicitudes de extracción en tu entorno local antes de que se fusionen. Para obtener más información, consulta "[Conservar datos de flujo de trabajo mediante artefactos](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)." - -Por lo general, Maven creará archivos de salida como tarros, orejas o guerras en el `Objetivo` Directorio. Para cargarlos como artefactos, puedes copiarlos en un nuevo directorio que contenga artefactos para cargar. Por ejemplo, puedes crear un directorio llamado `staging` (preparación). Luego puedes cargar los contenidos de ese directorio usando la acción `upload-artifact (cargar artefacto)`. - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - - run: mvn -B package --file pom.xml - - run: mkdir staging && cp target/*.jar staging - - uses: actions/upload-artifact@v2 - with: - name: Package - path: staging -``` -{% endraw %} diff --git a/translations/es-XL/content/actions/language-and-framework-guides/github-actions-for-docker.md b/translations/es-XL/content/actions/language-and-framework-guides/github-actions-for-docker.md deleted file mode 100644 index dd1df8c328ce..000000000000 --- a/translations/es-XL/content/actions/language-and-framework-guides/github-actions-for-docker.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: GitHub Actions para Docker -intro: Crear flujos de trabajo que construyen y publican proyectos de Docker. -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/es-XL/content/actions/language-and-framework-guides/github-actions-for-java.md b/translations/es-XL/content/actions/language-and-framework-guides/github-actions-for-java.md deleted file mode 100644 index 6fc062bb72d3..000000000000 --- a/translations/es-XL/content/actions/language-and-framework-guides/github-actions-for-java.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Acciones de GitHub para Java -intro: Crea flujos de trabajo que construyan y prueben proyectos escritos en Java. -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/es-XL/content/actions/language-and-framework-guides/github-actions-for-javascript-and-typescript.md b/translations/es-XL/content/actions/language-and-framework-guides/github-actions-for-javascript-and-typescript.md deleted file mode 100644 index e37976d2ee41..000000000000 --- a/translations/es-XL/content/actions/language-and-framework-guides/github-actions-for-javascript-and-typescript.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Acciones de GitHub para JavaScript y TypeScript -intro: Crea flujos de trabajo que compilen y prueben proyectos escritos en bibliotecas de JavaScript y TypeScript. -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/es-XL/content/actions/language-and-framework-guides/github-actions-for-python.md b/translations/es-XL/content/actions/language-and-framework-guides/github-actions-for-python.md deleted file mode 100644 index 7a09020b4223..000000000000 --- a/translations/es-XL/content/actions/language-and-framework-guides/github-actions-for-python.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Acciones de GitHub para Python -intro: Crea flujos de trabajo que construyan y prueben proyectos escritos en Python. -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/es-XL/content/actions/language-and-framework-guides/index.md b/translations/es-XL/content/actions/language-and-framework-guides/index.md deleted file mode 100644 index 0851644b8713..000000000000 --- a/translations/es-XL/content/actions/language-and-framework-guides/index.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Guías de lenguajes y marcos -intro: Puedes crear flujos de trabajo de integración continua (CI) que compilen y prueben proyectos escritos en diferentes lenguajes de programación. -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -{% topic_link_in_list/GitHub-Actions-for-JavaScript-and-typescript%} - {% link_in_list/Using-NodeJS-with-GitHub-Actions%} - {% link_in_list/Publishing-NodeJS-packages%} -{% topic_link_in_list/GitHub-Actions-for-Python%} - {% link_in_list/Using-Python-with-GitHub-Actions%} -{% topic_link_in_list/GitHub-Actions-for-Java%} - {% link_in_list/Building-and-Testing-Java-with-Maven%} - {% link_in_list/Building-and-Testing-Java-with-Gradle%} - {% link_in_list/Building-and-Testing-Java-with-ANT%} - {% link_in_list/Publishing-Java-Packages-with-Maven%} - {% link_in_list/Publishing-Java-Packages-with-Gradle%} -{% topic_link_in_list /github-actions-for-docker %} - {% link_in_list /publishing-docker-images %} diff --git a/translations/es-XL/content/actions/language-and-framework-guides/publishing-docker-images.md b/translations/es-XL/content/actions/language-and-framework-guides/publishing-docker-images.md deleted file mode 100644 index 7543f4749498..000000000000 --- a/translations/es-XL/content/actions/language-and-framework-guides/publishing-docker-images.md +++ /dev/null @@ -1,157 +0,0 @@ ---- -title: Publicar imágenes de Docker -intro: 'Puedes publicar imágenes de Docker en un registro, tale como Docker Hub o {% data variables.product.prodname_registry %}, como parte de tu flujo de trabajo de integración continua (IC).' -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Introducción - -Esta guía te muestra cómo crear un flujo de trabajo que realiza una compilación de Docker y posteriormente publica las imágenes de Docker en Docker Hub o {% data variables.product.prodname_registry %}. Con un solo flujo de trabajo, puedes publicar imágenes a un solo registro o a varios de ellos. - -{% note %} - -**Nota:** Si quieres subir otro registro de terceros de Docker, el ejemplo en la sección "[Publicar imágenes en {% data variables.product.prodname_registry %}](#publishing-images-to-github-packages)" puede servir como plantilla. - -{% endnote %} - -### Prerrequisitos - -Recomendamos que tengas un conocimiento básico de las opciones de configuración de flujo de trabajo y de cómo crear un archivo de flujo de trabajo. Para obtener más información, consulta "[Configurar un flujo de trabajo](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)." - -También puede que encuentres útil el tener un entendimiento básico de lo siguiente: - -- "[Conceptos básicos para {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)" -- "[Crear y usar secretos cifrados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)" -- "[Autenticar con el GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)" -- "[Configurar Docker para su uso con {% data variables.product.prodname_registry %}](/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages)" - -### Acerca de la configuración de imágenes - -Esta guía asume que tienes una definición completa de una imagen de Docker almacenada en un repositorio de {% data variables.product.prodname_dotcom %}. Por ejemplo, tu repositorio debe contener un _Dockerfile_, y cualquier otro archivo que se necesite para realizar una compilación de Docker para crear una imagen. - -En esta guía, utilizaremos la acción `build-push-action` de Docker para compilar la imagen de Docker y cargarla a uno o más registros de Docker. Para obtener más información, consulta la sección [`build-push-action`](https://github.com/marketplace/actions/build-and-push-docker-images). - -{% data reusables.actions.enterprise-marketplace-actions %} - -### Publicar imágenes en Docker Hub - -{% data reusables.github-actions.release-trigger-workflow %} - -En el siguiente ejemplo de flujo de trabajo, utilizamos la acción `build-push-action` de Docker para compilar la imagen de Docker y, si la compilación es exitosa, cargar la imagen compilada a Docker Hub. - -Para hacer una carga en Docker hub, necesitarás tener una cuenta de Docker Hub y haber creado un repositorio ahí mismo. Para obtener más información, consulta la sección "[Share images on Docker Hub](https://docs.docker.com/get-started/part3/)" en la documentación de Docker. - -Las opciones de `build-push-action` que se requieren para Docker Hub son: - -* `username` y `password`: Este es tu nombre de usuario y contraseña de Docker Hub. Te recomendamos almacenar tu nombre de usuario y contraseña de Docker Hub como secretos cirfrados el repositorio tu {% data variables.product.prodname_dotcom %} para que no se expongan en tu archivo de flujo de trabajo. Para obtener más información, consulta "[Crear y usar secretos cifrados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". -* `repository`: Tu repositorio de Docker hub en el formato `DOCKER-HUB-NAMESPACE/DOCKER-HUB-REPOSITORY`. - -{% raw %} -```yaml -name: Publish Docker image -on: - release: - types: [published] -jobs: - push_to_registry: - name: Push Docker image to Docker Hub - runs-on: ubuntu-latest - steps: - - name: Check out the repo - uses: actions/checkout@v2 - - name: Push to Docker Hub - uses: docker/build-push-action@v1 - with: - username: ${{ secrets.DOCKER_USERNAME }} - password: ${{ secrets.DOCKER_PASSWORD }} - repository: my-docker-hub-namespace/my-docker-hub-repository - tag_with_ref: true -``` -{% endraw %} - -{% data reusables.github-actions.docker-tag-with-ref %} - -### Publicar imágenes en {% data variables.product.prodname_registry %} - -{% data reusables.github-actions.release-trigger-workflow %} - -En el flujo de trabajo de ejemplo que se encuentra a continuación, utilizamos la acción `build-push-action` para compilar la imagen de Docker y, si la compilación es exitosa, cargar la imagen compilada a {% data variables.product.prodname_registry %}. - -Las opciones de `build-push-action` requeridas para {% data variables.product.prodname_registry %} son: - -* `username`: Puedes utilizar el contexto {% raw %}`${{ github.actor }}`{% endraw %} para utilizar automáticamente el nombre de usuario del usuario que desencadenó la ejecución del flujo de trabajo. Para obtener más información, consulta la sección "[Sintaxis de contexto y expresión para GitHub Actions](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)". -* `password`: Puedes utilizar el secreto generado automáticamente `GITHUB_TOKEN` para la contraseña. Para más información, consulta "[Autenticando con el GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)." -* `registry`: Debe configurarse como `docker.pkg.github.com`. -* `repository`: Debe configurarse en el formato `OWNER/REPOSITORY/IMAGE_NAME`. Por ejemplo, para una imagen nombrada como `octo-image` almacenada en {% data variables.product.prodname_dotcom %} en `http://github.com/octo-org/octo-repo`, la opción de `repository` debe configurarse como `octo-org/octo-repo/octo-image`. - -{% raw %} -```yaml -name: Publish Docker image -on: - release: - types: [published] -jobs: - push_to_registry: - name: Push Docker image to GitHub Packages - runs-on: ubuntu-latest - steps: - - name: Check out the repo - uses: actions/checkout@v2 - - name: Push to GitHub Packages - uses: docker/build-push-action@v1 - with: - username: ${{ github.actor }} - password: ${{ secrets.GITHUB_TOKEN }} - registry: docker.pkg.github.com - repository: my-org/my-repo/my-image - tag_with_ref: true - -``` -{% endraw %} - -{% data reusables.github-actions.docker-tag-with-ref %} - -### Publicar imágenes en Docker Hub y en {% data variables.product.prodname_registry %} - -En un solo flujo de trabajo, puedes publicar tu imagen de Docker en varios registros utilizando la acción `build-push-action` para cada uno. - -El siguiente flujo de trabajo de ejemplo utiliza los pasos de `build-push-action` de las secciones anteriores ("[Publicar imágenes en Docker Hub](#publishing-images-to-docker-hub)" y "[Publicar imágenes en {% data variables.product.prodname_registry %}](#publishing-images-to-github-packages)") para crear un solo flujo de trabajo que cargue ambos registros. - -{% raw %} -```yaml -name: Publish Docker image -on: - release: - types: [published] -jobs: - push_to_registries: - name: Push Docker image to multiple registries - runs-on: ubuntu-latest - steps: - - name: Check out the repo - uses: actions/checkout@v2 - - name: Push to Docker Hub - uses: docker/build-push-action@v1 - with: - username: ${{ secrets.DOCKER_USERNAME }} - password: ${{ secrets.DOCKER_PASSWORD }} - repository: my-docker-hub-namespace/my-docker-hub-repository - tag_with_ref: true - - name: Push to GitHub Packages - uses: docker/build-push-action@v1 - with: - username: ${{ github.actor }} - password: ${{ secrets.GITHUB_TOKEN }} - registry: docker.pkg.github.com - repository: my-org/my-repo/my-image - tag_with_ref: true -``` -{% endraw %} - -El flujo de trabajo anterior revisa el repositorio de {% data variables.product.prodname_dotcom %} y utiliza la acción `build-push-action` dos veces para crear y cargar la imagen de Docker a Docker Hub y {% data variables.product.prodname_registry %}. Para ambos pasos, configura la opción `build-push-action` [`tag_with_ref`](https://github.com/marketplace/actions/build-and-push-docker-images#tag_with_ref) para etiquetar automáticamente la imagen de Docker con la referencia de Git para el evento del flujo de trabajo. Este flujo de trabajo se desencadena cuando se publica un lanzamiento de {% data variables.product.prodname_dotcom %}, así que la referencia para ambos registros será la etiqueta de Git para el lanzamiento. diff --git a/translations/es-XL/content/actions/language-and-framework-guides/publishing-java-packages-with-gradle.md b/translations/es-XL/content/actions/language-and-framework-guides/publishing-java-packages-with-gradle.md deleted file mode 100644 index 1b2f42b4b2ee..000000000000 --- a/translations/es-XL/content/actions/language-and-framework-guides/publishing-java-packages-with-gradle.md +++ /dev/null @@ -1,218 +0,0 @@ ---- -title: Publicar paquetes Java con Gradle -intro: Puedes usar Gradle para publicar paquetes Java en un registro como parte de tu flujo de trabajo de integración continua (CI). -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Introducción - -{% data reusables.github-actions.publishing-java-packages-intro %} - -### Prerrequisitos - -Te recomendamos que tengas una comprensión básica de los archivos de flujo de trabajo y las opciones de configuración. Para obtener más información, consulta "[Configurar un flujo de trabajo](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)." - -Para obtener más información acerca de la creación de un flujo de trabajo de CI para tu proyecto Java con Gradle, consulta "[Construir y probar Java con Gradle](/actions/language-and-framework-guides/building-and-testing-java-with-gradle)". - -También puede ser útil tener un entendimiento básico de lo siguiente: - -- "[Conceptos básicos para {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)" -- "[Configurar npm para usar con {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)" -- "[Usar variables de entorno](/actions/automating-your-workflow-with-github-actions/using-environment-variables)" -- "[Crear y usar secretos cifrados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)" -- "[Autenticar con el GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)" - -### Acerca de la configuración del paquete - -Los campos `groupId` y `artifactId` en la sección `MavenPublication` del archivo _build.gradle_ crean un identificador único para tu paquete que los registros usan para vincular tu paquete a un registro. Esto es similar a los campos `groupId` y `artifactId` del archivo _pom.xml_ de Maven. Para obtener más información, consulta "[Maven Publish Plugin](https://docs.gradle.org/current/userguide/publishing_maven.html)" en la documentación de Gradle. - -El archivo _build.gradle_ también contiene la configuración de los repositorios de administración de distribución en los que Gradle publicará los paquetes. Cada repositorio debe tener un nombre, una URL de implementación y credenciales para la autenticación. - -### Publicar paquetes en el repositorio central de Maven - -Cada vez que creas un lanzamiento nuevo, puedes desencadenar un flujo de trabajo para publicar tu paquete. El flujo de trabajo en el ejemplo a continuación se ejecuta cuando el evento `lanzamiento` desencadena con tipo `creado`. El flujo de trabajo publica el paquete en el repositorio central de Maven si se pasan las pruebas de CI. Para obtener más información acerca del evento `release`, consulta "[Eventos que activan flujos de trabajo](/actions/reference/events-that-trigger-workflows#release)". - -Puedes definir un nuevo repositorio de Maven en el bloque de publicación de tu archivo _build.gradle_ que apunta al repositorio de tu paquete. Por ejemplo, si estás desplegando en el repositorio central de Maven a través del proyecto de alojamiento OSSRH, tu _build.gradle_ podría especificar un repositorio con el nombre `"OSSRH"`. - -{% raw %} -```groovy -publishing { - ... - - repositories { - maven { - name = "OSSRH" - url = "https://oss.sonatype.org/service/local/staging/deploy/maven2/" - credentials { - username = System.getenv("MAVEN_USERNAME") - password = System.getenv("MAVEN_PASSWORD") - } - } - } -} -``` -{% endraw %} - -Con esta configuración, puedes crear un flujo de trabajo que publique tu paquete en el repositorio central de Maven al ejecutar el comando `gradle publish`. También deberás proporcionar variables de entorno que contengan el nombre de usuario y la contraseña para autenticarse en el repositorio. - -En el paso de implementación, necesitarás establecer variables de entorno para el nombre de usuario y la contraseña o token que usas para autenticar en el repositorio de Maven. Para obtener más información, consulta "[Crear y usar secretos cifrados](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)." - - -{% raw %} -```yaml -name: Publish package to the Maven Central Repository -on: - release: - types: [created] -jobs: - publish: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - - name: Set up Java - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Publish package - run: gradle publish - env: - MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }} - MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }} -``` -{% endraw %} - -{% data reusables.github-actions.gradle-workflow-steps %} -1. Ejecuta el comando `gradle publish` para publicar en el repositorio Maven `OSSRH`. La variable de entorno `MAVEN_USERNAME` se establecerá con los contenidos de tu `OSSRH_USERNAME` secreto, y la variable de entorno `MAVEN_PASSWORD` se establecerá con los contenidos de tu `OSSRH_TOKEN` secreto. - - Para obtener más información acerca del uso de secretos en tu flujo de trabajo, consulta "[Crear y usar secretos cifrados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". - -### Sube paquetes al {% data variables.product.prodname_registry %} - -Cada vez que creas un lanzamiento nuevo, puedes desencadenar un flujo de trabajo para publicar tu paquete. El flujo de trabajo en el ejemplo a continuación se ejecuta cuando el evento `lanzamiento` desencadena con tipo `creado`. El flujo de trabajo publica el paquete en el {% data variables.product.prodname_registry %} si se pasan las pruebas de CI. Para obtener más información acerca del evento `release`, consulta "[Eventos que activan flujos de trabajo](/actions/reference/events-that-trigger-workflows#release)". - -Puedes definir un nuevo repositorio de Maven en el bloque de publicación de tu _build.gradle_ que apunte a {% data variables.product.prodname_registry %}. En esa configuración de repositorio, también puedes aprovechar las variables de entorno establecidas en tu ejecución de flujo de trabajo de CI. Puedes usar la variable de entorno `GITHUB_ACTOR` como nombre de usuario y puedes establecer la variable de entorno `GITHUB_TOKEN` con tu `GITHUB_TOKEN` secreto. - -El `GITHUB_TOKEN` existe en tu repositorio por defecto y tiene permisos de lectura y escritura para paquetes en el repositorio donde se ejecuta el flujo de trabajo. Para más información, consulta la sección "[Autenticarse con el GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)." - -Por ejemplo, si tu organización se llama "octocat" y tu repositorio se llama "hello-world", entonces la configuración {% data variables.product.prodname_registry %} en _build.gradle_ tendría un aspecto similar al ejemplo a continuación. - -{% raw %} -```groovy -publishing { - ... - - repositories { - maven { - name = "GitHubPackages" - url = "https://maven.pkg.github.com/octocat/hello-world" - credentials { - username = System.getenv("GITHUB_ACTOR") - password = System.getenv("GITHUB_TOKEN") - } - } - } -} -``` -{% endraw %} - -Con esta configuración, puedes crear un flujo de trabajo que publique tu paquete en el repositorio central de Maven al ejecutar el comando `gradle publish`. - -{% raw %} -```yaml -name: Publish package to GitHub Packages -on: - release: - types: [created] -jobs: - publish: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Publish package - run: gradle publish - env: - GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} - -{% data reusables.github-actions.gradle-workflow-steps %} -1. Ejecuta el comando `gradle publish` comando para publicar en {% data variables.product.prodname_registry %}. La variable de entorno `GITHUB_TOKEN` se establecerá con el contenido del `GITHUB_TOKEN` secreto. - - Para obtener más información acerca del uso de secretos en tu flujo de trabajo, consulta "[Crear y usar secretos cifrados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". - -### Publicar paquetes en el repositorio central de Maven y {% data variables.product.prodname_registry %} - -Puedes publicar tus paquetes en el repositorio central de Maven y {% data variables.product.prodname_registry %} al configurar cada uno de ellos en tu archivo _build.gradle_. - -Asegúrate de que tu archivo _build.gradle_ incluya un repositorio para tu repositorio {% data variables.product.prodname_dotcom %} y para tu proveedor de repositorios centrales de Maven. - -Por ejemplo, si implementas el repositorio central a través del proyecto de alojamiento OSSRH, es posible que desees especificarlo en un repositorio de administración de distribución con el `name` establecido en `OSSRH`. Si implementas para {% data variables.product.prodname_registry %}, es posible que desees especificarlo en un repositorio de administración de distribución con el `name` establecido en `GitHubPackages`. - -Si tu organización se llama "octocat" y tu repositorio se llama "hello-world", entonces la configuración {% data variables.product.prodname_registry %} en _build.gradle_ tendría un aspecto similar al ejemplo a continuación. - -{% raw %} -```groovy -publishing { - ... - - repositories { - maven { - name = "OSSRH" - url = "https://oss.sonatype.org/service/local/staging/deploy/maven2/" - credentials { - username = System.getenv("MAVEN_USERNAME") - password = System.getenv("MAVEN_PASSWORD") - } - } - maven { - name = "GitHubPackages" - url = "https://maven.pkg.github.com/octocat/hello-world" - credentials { - username = System.getenv("GITHUB_ACTOR") - password = System.getenv("GITHUB_TOKEN") - } - } - } -} -``` -{% endraw %} - -Con esta configuración, puedes crear un flujo de trabajo que publique tu paquete en el repositorio central de Maven y {% data variables.product.prodname_registry %} al ejecutar el comando `gradle publish`. - -{% raw %} -```yaml -name: Publish package to the Maven Central Repository and GitHub Packages -on: - release: - types: [created] -jobs: - publish: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - - name: Set up Java - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Publish to the Maven Central Repository - run: gradle publish - env: - MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }} - MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }} - GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} - -{% data reusables.github-actions.gradle-workflow-steps %} -1. Ejecuta el comando `gradle publish` para publicar en el repositorio Maven `OSSRH` y {% data variables.product.prodname_registry %}. La variable de entorno `MAVEN_USERNAME` se establecerá con los contenidos de tu `OSSRH_USERNAME` secreto, y la variable de entorno `MAVEN_PASSWORD` se establecerá con los contenidos de tu `OSSRH_TOKEN` secreto. La variable de entorno `GITHUB_TOKEN` se establecerá con el contenido del `GITHUB_TOKEN` secreto. - - Para obtener más información acerca del uso de secretos en tu flujo de trabajo, consulta "[Crear y usar secretos cifrados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". diff --git a/translations/es-XL/content/actions/language-and-framework-guides/publishing-java-packages-with-maven.md b/translations/es-XL/content/actions/language-and-framework-guides/publishing-java-packages-with-maven.md deleted file mode 100644 index aa0718eada93..000000000000 --- a/translations/es-XL/content/actions/language-and-framework-guides/publishing-java-packages-with-maven.md +++ /dev/null @@ -1,209 +0,0 @@ ---- -title: Publicar paquetes Java con Maven -intro: Puedes usar Maven para publicar paquetes Java en un registro como parte de tu flujo de trabajo de integración continua (CI). -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Introducción - -{% data reusables.github-actions.publishing-java-packages-intro %} - -### Prerrequisitos - -Te recomendamos que tengas una comprensión básica de los archivos de flujo de trabajo y las opciones de configuración. Para obtener más información, consulta "[Configurar un flujo de trabajo](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)." - -Para obtener más información acerca de la creación de un flujo de trabajo de CI para tu proyecto Java con Maven, consulta "[Construir y probar Java con Maven](/actions/language-and-framework-guides/building-and-testing-java-with-maven)". - -También puede ser útil tener un entendimiento básico de lo siguiente: - -- "[Conceptos básicos para {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)" -- "[Configurar npm para usar con {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)" -- "[Usar variables de entorno](/actions/automating-your-workflow-with-github-actions/using-environment-variables)" -- "[Crear y usar secretos cifrados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)" -- "[Autenticar con el GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)" - -### Acerca de la configuración del paquete - -Los campos `groupld` y `artifactId` del archivo _pom.xml_ crea un identificador único para tu paquete que los registros usan para vincular tu paquete a un registro. Para obtener más información, consulta [Guía para cargar artefactos en el repositorio central](http://maven.apache.org/repository/guide-central-repository-upload.html) en la documentación de Apache Maven. - -El archivo _pom.xml_ también contiene la configuración de los repositorios de administración de distribución en los que Maven implementará los paquetes. Cada repositorio debe tener un nombre y una URL de implementación. La autenticación para estos repositorios se puede configurar en el archivo _.m2/settings.xml_ del directorio de inicio del usuario que ejecuta Maven. - -Puedes usar la acción `setup-java` para configurar el repositorio de implementación, así como la autenticación para ese repositorio. Para obtener más información, consulta [`setup-java`](https://github.com/actions/setup-java). - -### Publicar paquetes en el repositorio central de Maven - -Cada vez que creas un lanzamiento nuevo, puedes desencadenar un flujo de trabajo para publicar tu paquete. El flujo de trabajo en el ejemplo a continuación se ejecuta cuando el evento `lanzamiento` desencadena con tipo `creado`. El flujo de trabajo publica el paquete en el repositorio central de Maven si se pasan las pruebas de CI. Para obtener más información acerca del evento `release`, consulta "[Eventos que activan flujos de trabajo](/actions/reference/events-that-trigger-workflows#release)". - -En este flujo de trabajo, puedes usar la acicón `setup-java`. Esta acción instala la versión dada del JDK en el `PATH`, pero también configura un Maven _settings.xml_ para publicar paquetes. Por defecto, el archivo de configuraciones se configurará para {% data variables.product.prodname_registry %}, pero se puede configurar para que se implemente en otro registro de paquetes, como el repositorio central de Maven. Si ya tienes un repositorio de administración de distribución configurado en _pom.xml_, puedes especificar que `id` durante la acción de invocación `setup-java`. - -Por ejemplo, si estás desplegando en el repositorio central de Maven a través del proyecto de alojamiento OSSRH, tu _pom.xml_ podría especificar un repositorio de administración de distribución con el `id` de `ossrh`. - -{% raw %} -```xml - - ... - - - ossrh - Central Repository OSSRH - https://oss.sonatype.org/service/local/staging/deploy/maven2/ - - - -``` -{% endraw %} - -Con esta configuración, puedes crear un flujo de trabajo que publique tu paquete en el repositorio central de Maven especificando la administración del repositorio `id` para la acción `setup-java`. También deberás proporcionar variables de entorno que contengan el nombre de usuario y la contraseña para autenticarse en el repositorio. - -En el paso de implementación, necesitarás establecer las variables de entorno para el nombre de usuario con el que te autenticaste en el repositorio y para el secreto que hayas configurado con la contraseña o el token con que autenticarse. Para obtener más información, consulta "[Crear y usar secretos cifrados](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)." - - -{% raw %} -```yaml -name: Publish package to the Maven Central Repository -on: - release: - types: [created] -jobs: - publish: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - - name: Set up Maven Central Repository - uses: actions/setup-java@v1 - with: - java-version: 1.8 - server-id: ossrh - server-username: MAVEN_USERNAME - server-password: MAVEN_PASSWORD - - name: Publish package - run: mvn -B deploy - env: - MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }} - MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }} -``` -{% endraw %} - -Este flujo de trabajo realiza los siguientes pasos: - -1. Revisa una copia del repositorio del proyecto. -1. Configura el JDK de Java y también el archivo _settings. xml_ de Maven para agregarle autenticación al repositorio de `ossrh` utilizando las variables de entorno `MAVEN_USERNAME` y `MAVEN_PASSWORD`. -1. {% data reusables.github-actions.publish-to-maven-workflow-step %} - - Para obtener más información acerca del uso de secretos en tu flujo de trabajo, consulta "[Crear y usar secretos cifrados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". - -### Sube paquetes al {% data variables.product.prodname_registry %} - -Cada vez que creas un lanzamiento nuevo, puedes desencadenar un flujo de trabajo para publicar tu paquete. El flujo de trabajo en el ejemplo a continuación se ejecuta cuando el evento `lanzamiento` desencadena con tipo `creado`. El flujo de trabajo publica el paquete en el {% data variables.product.prodname_registry %} si se pasan las pruebas de CI. Para obtener más información acerca del evento `release`, consulta "[Eventos que activan flujos de trabajo](/actions/reference/events-that-trigger-workflows#release)". - -En este flujo de trabajo, puedes usar la acicón `setup-java`. Esta acción instala la versión determinada del JDK en el `PATH` y configura un _settings.xml_ de Maven para publicar el paquete en el {% data variables.product.prodname_registry %}. El _settings.sml_ generado define la autenticación para un servidor con una `id` de `github`, utilizando la variable de entorno `GITHUB_ACTOR` como nombre de usuario y la variable de entorno `GITHUB_TOKEN` como contraseña. - -El `GITHUB_TOKEN` existe en tu repositorio por defecto y tiene permisos de lectura y escritura para paquetes en el repositorio donde se ejecuta el flujo de trabajo. Para más información, consulta la sección "[Autenticarse con el GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)." - -Para un proyecto basado en Maven, puedes hacer uso de estas configuraciones creando un repositorio de distribución en tu archivo _pom.xml_ con una `id` de `github` que apunta a tu extremo {% data variables.product.prodname_registry %}. - -Por ejemplo, si tu organización se llama "octocat", y tu repositorio se llama "hello-world", la configuración de {% data variables.product.prodname_registry %} en _pom.xml_ sería parecida al siguiente ejemplo. - -{% raw %} -```xml - - ... - - - github - GitHub Packages - https://maven.pkg.github.com/octocat/hello-world - - - -``` -{% endraw %} - -Con esta configuración, puedes crear un flujo de trabajo que publique tu paquete en {% data variables.product.prodname_registry %} haciendo uso del _settings.xml_ generado automáticamente. - -{% raw %} -```yaml -name: Publish package to GitHub Packages -on: - release: - types: [created] -jobs: - publish: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Publish package - run: mvn -B deploy - env: - GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} - -Este flujo de trabajo realiza los siguientes pasos: - -1. Revisa una copia del repositorio del proyecto. -1. Configura el JDK de Java y configura automáticamente el archivo _settings.xml_ de Maven para agregar autenticación para que el repositorio `github` de Maven utilice la variable de entorno `GITHUB_TOKEN`. -1. {% data reusables.github-actions.publish-to-packages-workflow-step %} - - Para obtener más información acerca del uso de secretos en tu flujo de trabajo, consulta "[Crear y usar secretos cifrados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". - -### Publicar paquetes en el repositorio central de Maven y {% data variables.product.prodname_registry %} - -Puedes publicar tus paquetes en el repositorio central de Maven y en el {% data variables.product.prodname_registry %} usando la acción `setup-java` para cada registro. - -Asegúrate de que tu archivo _pom.xml_ incluya un repositorio de administración de distribución para tu repositorio de {% data variables.product.prodname_dotcom %} y para tu proveedor de repositorios centrales de Maven. Por ejemplo, si implementas el repositorio central a través del proyecto de alojamiento de OSSRH, es posible que desees especificarlo en un repositorio de administración de distribución con la `id` establecida en `ossrh`, y que desees especificar el {% data variables.product.prodname_registry %} en un repositorio de administración de distribución con la `id` establecida en `github`. - -{% raw %} -```yaml -name: Publish package to the Maven Central Repository and GitHub Packages -on: - release: - types: [created] -jobs: - publish: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - - name: Set up Java for publishing to Maven Central Repository - uses: actions/setup-java@v1 - with: - java-version: 1.8 - server-id: ossrh - server-username: MAVEN_USERNAME - server-password: MAVEN_PASSWORD - - name: Publish to the Maven Central Repository - run: mvn -B deploy - env: - MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }} - MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }} - - name: Set up Java for publishing to GitHub Packages - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Publish to GitHub Packages - run: mvn -B deploy - env: - GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} - -Este flujo de trabajo llama a la acción `setup-java` dos veces. Cada vez que la acción `setup-java` se ejecuta, sobrescribe el archivo _settings.xml_ de Maven para publicar paquetes. Para la autenticación en el repositorio, el archivo _settings.xml_ hace referencia a la `id` del repositorio de administración de distribución y al nombre de usuario y contraseña. - -Este flujo de trabajo realiza los siguientes pasos: - -1. Revisa una copia del repositorio del proyecto. -1. Llama al `setup-java` la primera vez. Esto configura el archivo _settings.xml_ de Maven para el repositorio `ossrh` y establece las opciones de autenticación en las variables de entorno que se definen en el siguiente paso. -1. {% data reusables.github-actions.publish-to-maven-workflow-step %} -1. Llama al `setup-java` la segunda vez. Esto configura automáticamente el archivo _settings.xml_ de Maven para el {% data variables.product.prodname_registry %}. -1. {% data reusables.github-actions.publish-to-packages-workflow-step %} - - Para obtener más información acerca del uso de secretos en tu flujo de trabajo, consulta "[Crear y usar secretos cifrados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". diff --git a/translations/es-XL/content/actions/language-and-framework-guides/publishing-nodejs-packages.md b/translations/es-XL/content/actions/language-and-framework-guides/publishing-nodejs-packages.md deleted file mode 100644 index 65d11e1446c9..000000000000 --- a/translations/es-XL/content/actions/language-and-framework-guides/publishing-nodejs-packages.md +++ /dev/null @@ -1,210 +0,0 @@ ---- -title: Publicar paquetes Node.js -intro: Puedes publicar paquetes Node.js en un registro como parte de tu flujo de trabajo de integración continua (CI). -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Introducción - -Esta guía te muestra cómo crear un flujo de trabajo que publique paquetes Node.js en el {% data variables.product.prodname_registry %} y registros npm después de que se aprueben las pruebas de integración continua (CI). Con un solo flujo de trabajo, puedes publicar paquetes en un solo registro o varios registros. - -### Prerrequisitos - -Recomendamos que tengas un conocimiento básico de las opciones de configuración de flujo de trabajo y de cómo crear un archivo de flujo de trabajo. Para obtener más información, consulta "[Configurar un flujo de trabajo](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)." - -Para obtener más información acerca de la creación de un flujo de trabajo de CI para tu proyecto Node.js, consulta "[Usar Node.js con las {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/using-nodejs-with-github-actions)." - -También puede ser útil tener un entendimiento básico de lo siguiente: - -- "[Conceptos básicos para {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)" -- "[Configurar npm para usar con {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)" -- "[Usar variables de entorno](/actions/automating-your-workflow-with-github-actions/using-environment-variables)" -- "[Crear y usar secretos cifrados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)" -- "[Autenticar con el GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)" - -### Acerca de la configuración del paquete - - Los campos `Nombre` y `Versión` en el archivo *package.json* crean un identificador único que los registros usan para vincular tu paquete a un registro. Puedes agregar un resumen para la página de descripción del paquete al incluir un campo `Descripción` en el archivo *package.json*. Para obtener más información, consulta "[Crear un archivo package.json](https://docs.npmjs.com/creating-a-package-json-file) y [Crear módulos Node.js](https://docs.npmjs.com/creating-node-js-modules)"en la documentación de npm. - -Cuando existe un archivo *.npmrc* local y tiene un valor especificado de `registro`, el comando `npm publish` usa el registro configurado en el archivo *.npmrc*. {% data reusables.github-actions.setup-node-intro %} - -Puedes especificar la versión de Node.js instalada en el ejecutor utilizando la acción `setup-node`. - -Si agregas pasos en tu flujo de trabajo para configurar los campos `publishConfig` en tu archivo *package.json*, no es necesario que especifiques la URL del registro utilizando la acción `setup-node`, pero estarás limitado a publicar el paquete en un solo registro. Para obtener más información, consulta "[publishConfig](https://docs.npmjs.com/files/package.json#publishconfig)" en la documentación de npm. - -### Publicar paquetes en el registro npm - -Cada vez que creas un lanzamiento nuevo, puedes desencadenar un flujo de trabajo para publicar tu paquete. El flujo de trabajo en el ejemplo a continuación se ejecuta cuando el evento `lanzamiento` desencadena con tipo `creado`. El flujo de trabajo publica el paquete en el registro npm si se pasan las pruebas de CI. - -Para realizar operaciones autenticadas frente al registro npm en tu flujo de trabajo, necesitarás almacenar tu token de autenticación npm como un secreto en los parámetros de tu repositorio. Por ejemplo, crea un secreto llamado `NPM_TOKEN`. Para obtener más información, consulta "[Crear y usar secretos cifrados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". - -Por defecto, npm usa el campo `Nombre` del archivo *package.json* para determinar el registro npm. Al publicar en un espacio de nombres global, solo necesitas incluir el nombre del paquete. Por ejemplo, publicarías un paquete llamado `npm-hello-world-test` en `https://www.npmjs.com/package/npm-hello-world-test`. - -Si estás publicando un paquete que incluye un prefijo de alcance, incluye el ámbito en el nombre de tu archivo *package.json*. Por ejemplo, si el prefijo del ámbito npm es octocat y el nombre del paquete es hello-world, el `nombre` en tu archivo *package.json* debe ser `@octocat/hello-world`. Si su paquete npm usa un prefijo de ámbito y el paquete es público, debes usar la opción `npm publish --access public`. Esta es una opción que npm requiere para evitar que alguien publique un paquete privado involuntariamente. - -Este ejemplo almacena el secreto `NPM_TOKEN` en la variable de entorno `NODE_AUTH_TOKEN`. Cuando la acción `setup-node` crea un archivo *.npmrc*, hace referencia al token de la variable de entorno `NODE_AUTH_TOKEN`. - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # Configura el archivo .npmrc para publicar en npm - - uses: actions/setup-node@v1 - with: - node-version: '12.x' - registry-url: 'https://registry.npmjs.org' - - run: npm install - - run: npm publish - env: - NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} -``` -{% endraw %} - -En el ejemplo anterior, la acción `setup-node` crea un archivo *.npmrc* en el ejecutor con el siguiente contenido: - -``` -//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN} -registry=https://registry.npmjs.org/ -always-auth=true -``` - -### Sube paquetes al {% data variables.product.prodname_registry %} - -Cada vez que creas un lanzamiento nuevo, puedes desencadenar un flujo de trabajo para publicar tu paquete. El flujo de trabajo en el ejemplo a continuación se ejecuta cada vez que se produce el evento `lanzamiento` con tipo `creado`. El flujo de trabajo publica el paquete en el {% data variables.product.prodname_registry %} si se pasan las pruebas de CI. - -Por defecto, {% data variables.product.prodname_registry %} publica un paquete en el repositorio {% data variables.product.prodname_dotcom %} que especifiques en el campo `Nombre` del archivo *package.json*. Por ejemplo, publicarías un paquete denominado `@my-org/test` al repositorio de {% data variables.product.prodname_dotcom %} `My-org/test`. Para obtener más información, consulta [`npm-Scope`](https://docs.npmjs.com/misc/scope) en la documentación de npm. - -Para realizar operaciones autenticadas contra el registro {% data variables.product.prodname_registry %} en tu flujo de trabajo, puedes utilizar el `GITHUB_TOKEN`. El `GITHUB_TOKEN` existe en tu repositorio por defecto y tiene permisos de lectura y escritura para paquetes en el repositorio donde se ejecuta el flujo de trabajo. Para obtener más información, consulta "[Crear y usar secretos cifrados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". - -Este ejemplo almacena el secreto `GITHUB_TOKEN` en la variable de entorno `NODE_AUTH_TOKEN`. Cuando la acción `setup-node` crea un archivo *.npmrc*, hace referencia al token de la variable de entorno `NODE_AUTH_TOKEN`. - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # Setup .npmrc file to publish to GitHub Packages - - uses: actions/setup-node@v1 - with: - node-version: '12.x' - registry-url: 'https://npm.pkg.github.com' - # Defaults to the user or organization that owns the workflow file - scope: '@octocat' - - run: npm install - - run: npm publish - env: - NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} - -La acción `setup-node` crea un archivo *.npmrc* en el ejecutor. Cuando utilizas la entrada `scope` a la acción `setup-node`, el archivo *.npmrc* incluye el prefijo de alcance. Por defecto, la acción `setup-node` establece el ámbito en el archivo *.npmrc* en la cuenta que contiene ese archivo de flujo de trabajo. - -``` -//npm.pkg.github.com/:_authToken=${NODE_AUTH_TOKEN} -@octocat:registry=https://npm.pkg.github.com -always-auth=true -``` - -### Publicar paquetes mediante yarn - -Si usas el gestor de paquetes Yarn, puedes instalar y publicar paquetes mediante Yarn. - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # Setup .npmrc file to publish to npm - - uses: actions/setup-node@v1 - with: - node-version: '12.x' - registry-url: 'https://registry.npmjs.org' - # Defaults to the user or organization that owns the workflow file - scope: '@octocat' - - run: yarn - - run: yarn publish - env: - NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} -``` -{% endraw %} - -### Publicar paquetes en npm y {% data variables.product.prodname_registry %} - -{% note %} - -**Nota:** Si necesitas publicar en los registros que tienen diferentes prefijos de ámbito, deberás modificar el archivo *package.json* en el ejecutor para cambiar el prefijo de ámbito. Por ejemplo, si publicas un paquete en el ámbito `@mona` para npm y `@octocat` para {% data variables.product.prodname_registry %}, puedes reemplazar el ámbito `@mona` por `@octocat` en el archivo *package.json* del ejecutor después de publicar en npm y antes de publicar en {% data variables.product.prodname_registry %}. - -{% endnote %} - -Puedes publicar tus paquetes tanto en el registro npm como en {% data variables.product.prodname_registry %} mediante la acción `setup-node` para cada registro. - -Si publicas un paquete en ambos registros, tendrás que asegurarte de que tu prefijo de ámbito en npm coincida con tu nombre de usuario u organización de {% data variables.product.prodname_dotcom %}. Para publicar paquetes en un registro público con un prefijo de ámbito, puedes utilizar el comando `npm publish --access public`. Para obtener más información, consulta [`npm-scope`](https://docs.npmjs.com/misc/scope) y "[Crear y publicar paquetes públicos con ámbitos](https://docs.npmjs.com/creating-and-publishing-scoped-public-packages)" en la documentación de npm. - -Asegúrate de que tu archivo *package.json* incluya el ámbito de tu repositorio de {% data variables.product.prodname_dotcom %} y el registro de npm. Por ejemplo, si planeas publicar un paquete en el repositorio `octocat/npm-hello-world-test` en {% data variables.product.prodname_dotcom %} y https://www.npmjs. om/package/@octocat/npm-hello-world-test, el nombre en tu archivo *package.json* debería ser `"name": "@octocat/npm-hello-world-test"`. - -Para realizar operaciones autenticadas contra el registro {% data variables.product.prodname_registry %} en tu flujo de trabajo, puedes utilizar el `GITHUB_TOKEN`. El `GITHUB_TOKEN` existe en tu repositorio por defecto y tiene permisos de lectura y escritura para paquetes en el repositorio donde se ejecuta el flujo de trabajo. Para obtener más información, consulta "[Crear y usar secretos cifrados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". - -Cuando utilizas la entrada `scope` a la acción `setup-node`, la acción crea un archivo *.npmrc* que incluye el prefijo de alcance. Por defecto, la acción `setup-node` establece el ámbito en el archivo *.npmrc* al usuario u organización que posee el archivo de flujo de trabajo. - -Este flujo de trabajo llama a la acción `setup-node` dos veces. Cada vez que se ejecuta la acción `setup-node`, sobrescribe el archivo *.npmrc*. El archivo *.npmrc* hace referencia al token que te permite realizar operaciones autenticadas frente al registro del paquete desde la variable de entorno `NODE_AUTH_TOKEN`. El flujo de trabajo establece la variable de entorno `NODE_AUTH_TOKEN` cada vez que se ejecuta el comando `npm publish`, primero con un token para publicar en npm (`NPM_TOKEN`) y luego con un token para publicar en el {% data variables.product.prodname_registry %} (`GITHUB_TOKEN`). - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # Setup .npmrc file to publish to npm - - uses: actions/setup-node@v1 - with: - node-version: '10.x' - registry-url: 'https://registry.npmjs.org' - - run: npm install - # Publish to npm - - run: npm publish --access public - env: - NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} - # Setup .npmrc file to publish to GitHub Packages - - uses: actions/setup-node@v1 - with: - registry-url: 'https://npm.pkg.github.com' - # Defaults to the user or organization that owns the workflow file - scope: '@octocat' - # Publish to GitHub Packages - - run: npm publish - env: - NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} diff --git a/translations/es-XL/content/actions/language-and-framework-guides/using-nodejs-with-github-actions.md b/translations/es-XL/content/actions/language-and-framework-guides/using-nodejs-with-github-actions.md deleted file mode 100644 index a8ead518491d..000000000000 --- a/translations/es-XL/content/actions/language-and-framework-guides/using-nodejs-with-github-actions.md +++ /dev/null @@ -1,277 +0,0 @@ ---- -title: Usar Node.js con Acciones de GitHub -intro: Puedes crear un flujo de trabajo de integración continua (CI) para construir y probar tu proyecto Node.js. -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/using-nodejs-with-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Introducción - -Esta guía te muestra cómo crear un flujo de trabajo de integración continua (CI) que construye y prueba código Node.js. Si tus pruebas de CI se superan, es posible que desees implementar tu código o publicar un paquete. - -### Prerrequisitos - -Te recomendamos que tengas una comprensión básica de Node.js, YAML, las opciones de configuración de flujo de trabajo y cómo crear un archivo de flujo de trabajo. Para obtener más información, consulta "[Configurar un flujo de trabajo](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)" y "[Comenzar con Node.js](https://nodejs.org/en/docs/guides/getting-started-guide/)." - -También puede ser útil tener un entendimiento básico de lo siguiente: - -- "[Conceptos básicos para {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)" -- "[Usar variables de entorno](/actions/automating-your-workflow-with-github-actions/using-environment-variables)" - -{% data reusables.actions.enterprise-setup-prereq %} - -### Comenzar con una plantilla de flujo de trabajo de Node.js - -{% data variables.product.prodname_dotcom %} proporciona una plantilla de flujo de trabajo de Node.js que funcionará para la mayoría de los proyectos Node.js. Esta guía incluye ejemplos de npm y Yarn que puedes usar para personalizar la plantilla. Para obtener más información, consulta la [Plantilla de flujo de trabajo Node.js](https://github.com/actions/starter-workflows/blob/master/ci/node.js.yml). - -Para comenzar rápidamente, agrega la plantilla al directorio `.github/workflows` de tu repositorio. - -{% raw %} -```yaml -name: Node.js CI - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - - strategy: - matrix: - node-version: [8.x, 10.x, 12.x] - - steps: - - uses: actions/checkout@v2 - - name: Use Node.js ${{ matrix.node-version }} - uses: actions/setup-node@v1 - with: - node-version: ${{ matrix.node-version }} - - run: npm install - - run: npm run build --if-present - - run: npm test - env: - CI: true -``` -{% endraw %} - -{% data reusables.github-actions.example-github-runner %} - -### Especificar la versión de Node.js - -La forma más fácil de especificar una versión de Node.js es por medio de la acción `setup-node` proporcionada por {% data variables.product.prodname_dotcom %}. Para obtener más información, consulta [`setup-node`](https://github.com/actions/setup-node/). - -La acción `setup-node` toma una versión de Node.js como una entrada y configura esa versión en el ejecutor. La acción `setup-node` encuentra una versión específica de Node.js de la caché de herramientas en cada ejecutor y añade los binarios necesarios a `PATH`, que continúan para el resto del trabajo. Usar la acción `setup-node` es la forma recomendada de usar Node.js con {% data variables.product.prodname_actions %} porque asegura un comportamiento consistente a través de diferentes ejecutores y diferentes versiones de Node.js. Si estás usando un ejecutor autoalojado, debes instalar Node.js y añadirlo a `PATH`. - -La plantilla incluye una estrategia de matriz que construye y prueba tu código con tres versiones de Node.js: 8.x, 10.x y 12.x. La 'x' es un carácter comodín que coincide con el último lanzamiento menor y de parche disponible para una versión. Cada versión de Node.js especificada en la matriz `node-version` crea un trabajo que ejecuta los mismos pasos. - -Cada trabajo puede acceder al valor definido en la matriz `node-version` por medio del contexto `matrix`. La acción `setup-node` utiliza el contexto como la entrada `node-version`. La acción `setup-node` configura cada trabajo con una versión diferente de Node.js antes de construir y probar código. Para obtener más información acerca de las estrategias y los contextos de la matriz, consulta "[Sintaxis de flujo de trabajo para {% data variables.product.prodname_actions %}"](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix) y "[Sintaxis de contexto y expresión para {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)". - -{% raw %} -```yaml -strategy: - matrix: - node-version: [8.x, 10.x, 12.x] - -steps: -- uses: actions/checkout@v2 -- name: Use Node.js ${{ matrix.node-version }} - uses: actions/setup-node@v1 - with: - node-version: ${{ matrix.node-version }} -``` -{% endraw %} - -Como alternativa, puedes construir y probar con las versiones exactas de Node.js. - -```yaml -strategy: - matrix: - node-version: [8.16.2, 10.17.0] -``` - -O bien, puedes construir y probar mediante una versión única de Node.js. - -{% raw %} -```yaml -name: Node.js CI - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - name: Use Node.js - uses: actions/setup-node@v1 - with: - node-version: '12.x' - - run: npm install - - run: npm run build --if-present - - run: npm test - env: - CI: true -``` -{% endraw %} - -Si no especificas una versión de Node.js, {% data variables.product.prodname_dotcom %} utiliza la versión de Node.js por defecto del entorno. Para obtener más información, consulta "[Software instalado en ejecutores alojados en {% data variables.product.prodname_dotcom %}](/actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners)." - -### Instalar dependencias - -Los ejecutores alojados en {% data variables.product.prodname_dotcom %} tienen instalados administradores de dependencias de npm y Yarn. Puedes usar npm y Yarn para instalar dependencias en tu flujo de trabajo antes de construir y probar tu código. Los ejecutores Windows y Linux alojados en {% data variables.product.prodname_dotcom %} también tienen instalado Grunt, Gulp y Bower. - -También puedes almacenar en caché las dependencias para acelerar tu flujo de trabajo. Para obtener más información, consulta "[Almacenar en caché las dependencias para acelerar tu flujo de trabajo](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)." - -#### Ejemplo con npm - -Este ejemplo instala las dependencias definidas en el archivo *package.json*. Para obtener más información, consulta [`Instalar npm`](https://docs.npmjs.com/cli/install). - -```yaml -steps: -- uses: actions/checkout@v2 -- name: Use Node.js - uses: actions/setup-node@v1 - with: - node-version: '12.x' -- name: Install dependencies - run: npm install -``` - -Mediante `npm ci` se instalan las versiones en el archivo *package-lock.json* o *npm-shrinkwrap.json* y se evitan las actualizaciones al archivo de bloqueo. Usar `npm ci` generalmente es más rápido que ejecutar `npm install`. Para obtener más información, consulta [`npm ci`](https://docs.npmjs.com/cli/ci.html) e [Introducir `npm ci` para construcciones más rápidas y confiables](https://blog.npmjs.org/post/171556855892/introducing-npm-ci-for-faster-more-reliable)." - -{% raw %} -```yaml -steps: -- uses: actions/checkout@v2 -- name: Use Node.js - uses: actions/setup-node@v1 - with: - node-version: '12.x' -- name: Install dependencies - run: npm ci -``` -{% endraw %} - -#### Ejemplo con Yarn - -Este ejemplo instala las dependencias definidas en el archivo *package.json*. Para obtener más información, consulta [`Instalar yarn`](https://yarnpkg.com/en/docs/cli/install). - -```yaml -steps: -- uses: actions/checkout@v2 -- name: Use Node.js - uses: actions/setup-node@v1 - with: - node-version: '12.x' -- name: Install dependencies - run: yarn -``` - -De forma alternativa, puede pasar `--frozen-lockfile` para instalar las versiones en el archivo *yarn.lock* y evitar actualizaciones al archivo *yarn.lock*. - -```yaml -steps: -- uses: actions/checkout@v2 -- name: Use Node.js - uses: actions/setup-node@v1 - with: - node-version: '12.x' -- name: Install dependencies - run: yarn --frozen-lockfile -``` - -#### Ejemplo de uso de un registro privado y la creación del archivo .npmrc - -{% data reusables.github-actions.setup-node-intro %} - -Para autenticarte en tu registro privado, deberás almacenar tu token de autenticación npm como un secreto en los parámetros de tu repositorio. Por ejemplo, crea un secreto llamado `NPM_TOKEN`. Para obtener más información, consulta "[Crear y usar secretos cifrados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". - -En el siguiente ejemplo, el secreto `NPM_TOKEN` almacena el token de autenticación npm. La acción `setup-node` configura el archivo *.npmrc* para leer el token de autenticación npm desde la variable de entorno `NODE_AUTH_TOKEN`. Cuando se usa la acción `setup-node` para crear un archivo *.npmrc*, debes establecer la variable de entorno `NPM_AUTH_TOKEN` con el secreto que contiene tu token de autenticación npm. - -Antes de instalar dependencias, utiliza la acción `setup-node` para crear el archivo *.npmrc*. La acción tiene dos parámetros de entrada. El parámetro `node-version` establece la versión de Node.js y el parámetro `registry-url` establece el registro predeterminado. Si tu registro de paquetes usa ámbitos, debes usar el parámetro `scope`. Para obtener más información, consulta [`npm-scope`](https://docs.npmjs.com/misc/scope). - -{% raw %} -```yaml -steps: -- uses: actions/checkout@v2 -- name: Use Node.js - uses: actions/setup-node@v1 - with: - always-auth: true - node-version: '12.x' - registry-url: https://registry.npmjs.org - scope: '@octocat' -- name: Install dependencies - run: npm ci - env: - NODE_AUTH_TOKEN: ${{secrets.NPM_TOKEN}} -``` -{% endraw %} - -El ejemplo anterior crea un archivo *.npmrc* con el siguiente contenido: - -``` -//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN} -@octocat:registry=https://registry.npmjs.org/ -always-auth=true -``` - -#### Ejemplo de dependencias en caché - -Puedes almacenar en caché las dependencias utilizando una clave única y restaurar las dependencias cuando ejecutes flujos de trabajo futuros utilizando la acción `cache`. Para obtener más información, consulta "[Almacenar en caché las dependencias para agilizar los flujos de trabajo](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)" y la acción [`cache`](https://github.com/marketplace/actions/cache). - -{% raw %} -```yaml -steps: -- uses: actions/checkout@v2 -- name: Use Node.js - uses: actions/setup-node@v1 - with: - node-version: '12.x' -- name: Cache Node.js modules - uses: actions/cache@v2 - with: - # npm cache files are stored in `~/.npm` on Linux/macOS - path: ~/.npm - key: ${{ runner.OS }}-node-${{ hashFiles('**/package-lock.json') }} - restore-keys: | - ${{ runner.OS }}-node- - ${{ runner.OS }}- -- name: Install dependencies - run: npm ci -``` -{% endraw %} - -### Construir y probar tu código - -Puedes usar los mismos comandos que usas de forma local para construir y probar tu código. Por ejemplo, si ejecutas `npm run build` para ejecutar pasos de construcción definidos en tu archivo *package.json* y `npm test` para ejecutar tu conjunto de pruebas, añadirías esos comandos en tu archivo de flujo de trabajo. - -```yaml -steps: -- uses: actions/checkout@v2 -- name: Use Node.js - uses: actions/setup-node@v1 - with: - node-version: '12.x' -- run: npm install -- run: npm run build --if-present -- run: npm test -``` - -### Empaquetar datos de flujo de trabajo como artefactos - -Puedes guardar los artefactos de tus pasos de construcción y prueba para verlos después de que se complete un trabajo. Por ejemplo, es posible que debas guardar los archivos de registro, los vaciados de memoria, los resultados de las pruebas o las capturas de pantalla. Para obtener más información, consulta "[Conservar datos de flujo de trabajo mediante artefactos](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)." - -### Publicar en registros de paquetes - -Puedes configurar tu flujo de trabajo para que publique tu paquete Node.js en un registro de paquete después de que se aprueben tus pruebas de CI. Para obtener más información acerca de la publicación a npm y {% data variables.product.prodname_registry %}, consulta [Publicar paquetes Node.js](/actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages)." diff --git a/translations/es-XL/content/actions/language-and-framework-guides/using-python-with-github-actions.md b/translations/es-XL/content/actions/language-and-framework-guides/using-python-with-github-actions.md deleted file mode 100644 index b4f3fce35e11..000000000000 --- a/translations/es-XL/content/actions/language-and-framework-guides/using-python-with-github-actions.md +++ /dev/null @@ -1,426 +0,0 @@ ---- -title: Usar Python con acciones de GitHub -intro: Puedes crear un flujo de trabajo de integración continua (CI) para construir y probar tu proyecto de Python. -redirect_from: - - /actions/automating-your-workflow-with-github-actions/using-python-with-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Introducción - -Esta guía te muestra cómo construir, probar y publicar un paquete de Python. - -Los ejecutores alojados {% data variables.product.prodname_dotcom %} tienen una caché de herramientas con un software preinstalado, que incluye Python y PyPy. ¡No tienes que instalar nada! Para obtener una lista completa de software actualizado y las versiones preinstaladas de Python y PyPy, consulta [software instalado en ejecutores alojados {% data variables.product.prodname_dotcom %}](/actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners). - -### Prerrequisitos - -Deberías estar familiarizado con YAML y la sintaxis para las {% data variables.product.prodname_actions %}. Para obtener más información, consulta "[Sintaxis de flujo de trabajo para {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)." - -Te recomendamos que tengas una comprensión básica de Python, PyPy y pip. Para obtener más información, consulta: -- [Comenzar con Python](https://www.python.org/about/gettingstarted/) -- [PyPy](https://pypy.org/) -- [Administrador de paquetes pip](https://pypi.org/project/pip/) - -{% data reusables.actions.enterprise-setup-prereq %} - -### Comenzar con la plantilla de flujo de trabajo de Python - -{% data variables.product.prodname_dotcom %} proporciona una plantilla de flujo de trabajo de Python que debería funcionar para la mayoría de los proyectos de Python. Esta guía incluye ejemplos que puedes usar para personalizar la plantilla. Para obtener más información, consulta la [Plantilla de flujo de trabajo de Python](https://github.com/actions/starter-workflows/blob/master/ci/python-package.yml). - -Para comenzar rápidamente, agrega la plantilla al directorio `.github/workflows` de tu repositorio. - -{% raw %} -```yaml -name: Python package - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - strategy: - matrix: - python-version: [2.7, 3.5, 3.6, 3.7, 3.8] - - steps: - - uses: actions/checkout@v2 - - name: Set up Python ${{ matrix.python-version }} - uses: actions/setup-python@v2 - with: - python-version: ${{ matrix.python-version }} - - name: Install dependencies - run: | - python -m pip install --upgrade pip - pip install flake8 pytest - if [ -f requirements.txt ]; then pip install -r requirements.txt; fi - - name: Lint with flake8 - run: | - # stop the build if there are Python syntax errors or undefined names - flake8 . --Count--Select = E9, F63, F7, F82--show-Source--Statistics - # exit-zero trata todos los errores como advertencias. El editor de GitHub es 127 chars de ancho - flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics - - name: Test with pytest - run: | - pytest -``` -{% endraw %} - -### Especificar una versión de Python - -Para usar una versión preinstalada de Python o PyPy en un ejecutor alojado {% data variables.product.prodname_dotcom %}, usa la acción `setup-python`. Esta acción encuentra una versión específica de Python o PyPy desde la caché de herramientas en cada ejecutor y agrega los binarios necesarios para `PATH`, que persiste durante el resto del trabajo. Si una versión específica de Python no está pre-instalada en el cache de herramientas, la acción `setup-python` se descargará y configurará la versión adecuada desde el repositorio `python-versions`. - -Usar el `setup-action` es la forma recomendada de usar Python con {% data variables.product.prodname_actions %} porque garantiza un comportamiento consistente a través de diferentes ejecutores y diferentes versiones de Python. Si estás usando un ejecutor alojado, debes instalar Python y añadirlo a `PATH`. Para obtener más información, consulta la acción [`setup-python`](https://github.com/marketplace/actions/setup-python). - -La tabla que aparece a continuación describe las ubicaciones de la caché de herramientas en cada ejecutor alojado {% data variables.product.prodname_dotcom %}. - -| | Ubuntu | Mac | Windows | -| --------------------------------------- | ------------------------------- | ---------------------------------------- | ------------------------------------------ | -| **Directorio de caché de herramientas** | `/opt/hostedtoolcache/*` | `/Users/runner/hostedtoolcache/*` | `C:\hostedtoolcache\windows\ *` | -| **Caché de herramientas de Python** | `/opt/hostedtoolcache/Python/*` | `/Users/runner/hostedtoolcache/Python/*` | `C:\hostedtoolcache\windows\Python\ *` | -| **Caché de la herramienta de PyPy** | `/opt/hostedtoolcache/PyPy/*` | `/Users/runner/hostedtoolcache/PyPy/*` | `C:\hostedtoolcache\windows\PyPy\ *` | - -Si estás utilizando un ejecutor auto-hospedado, puedes configurarlo para utilizar la acción `setup-python` para administrar tus dependencias. Para obtener más información, consulta la sección [utilizar setup-python con un ejecutor auto-hospedado](https://github.com/actions/setup-python#using-setup-python-with-a-self-hosted-runner) en el README de `setup-python`. - -{% data variables.product.prodname_dotcom %} admite la sintaxis de control de versiones semántico. Para obtener más información, consulta "[Usar versiones semánticas](https://docs.npmjs.com/about-semantic-versioning#using-semantic-versioning-to-specify-update-types-your-package-can-accept)" y "[Especificación de control de versiones semántico](https://semver.org/)." - -#### Usar múltiples versiones de Python - -{% raw %} -```yaml -name: Python package - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - strategy: - # Puedes usar las versiones de PyPy en python-version. - # For example, pypy2 and pypy3 - matrix: - python-version: [2.7, 3.5, 3.6, 3.7, 3.8] - - steps: - - uses: actions/checkout@v2 - - name: Set up Python ${{ matrix.python-version }} - uses: actions/setup-python@v2 - with: - python-version: ${{ matrix.python-version }} - # You can test your matrix by printing the current Python version - - name: Display Python version - run: python -c "import sys; print(sys.version)" -``` -{% endraw %} - -#### Usar una versión de Python específica - -Puedes configurar una versión específica de Python. Por ejemplo, 3.8. Como alternativa, puedes usar la sintaxis de versión semántica para obtener el último lanzamiento menor. En este ejemplo se usa el último lanzamiento menor de Python 3. - -{% raw %} -```yaml -name: Python package - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - name: Set up Python 3.x - uses: actions/setup-python@v2 - with: - # Semantic version range syntax or exact version of a Python version - python-version: '3.x' - # Optional - x64 or x86 architecture, defaults to x64 - architecture: 'x64' - # You can test your matrix by printing the current Python version - - name: Display Python version - run: python -c "import sys; print(sys.version)" -``` -{% endraw %} - -#### Excluir una versión - -Si especificas una versión de Python que no está disponible, `setup-python` falla con un error como: `##[error]Versión 3.4 con Arch x64 not found`. El mensaje de error incluye las versiones disponibles. - -También puedes usar la palabra clave `exclude` en tu flujo de trabajo si hay una configuración de Python que no deseas ejecutar. Para obtener más información, consulta "[Sintaxis de flujo de trabajo para {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategy)". - -{% raw %} -```yaml -name: Python package - -on: [push] - -jobs: - build: - - runs-on: ${{ matrix.os }} - strategy: - matrix: - os: [ubuntu-latest, macos-latest, windows-latest] - python-version: [2.7, 3.6, 3.7, 3.8, pypy2, pypy3] - exclude: - - os: macos-latest - python-version: 3.6 - - os: windows-latest - python-version: 3.6 -``` -{% endraw %} - -#### Usar la versión de Python predeterminada - -Recomendamos usar `setup-python` para configurar la versión de Python que se usa en tus flujos de trabajo porque ayuda a hacer que tus dependencias sean explícitas. Si no usas `setup-python`, la versión predeterminada de Python establecida en `PATH` se usa en cualquier shell cuando llamas `python`. La versión predeterminada de Python varía entre los ejecutores alojados {% data variables.product.prodname_dotcom %}, que pueden causar cambios inesperados o usar una versión anterior a la esperada. - -| Ejecutor alojado de {% data variables.product.prodname_dotcom %} | Descripción | -| --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| Ubuntu | Los ejecutores de Ubuntu tienen múltiples versiones de Python del sistema instaladas bajo `/usr/bin/python` y `/usr/bin/python3`. Las versiones de Python que vienen empaquetadas con Ubuntu se suman a las versiones que {% data variables.product.prodname_dotcom %} instala en la caché de herramientas. | -| Windows | Excluyendo las versiones de Python que están en la caché de herramientas, Windows no se envía con una versión equivalente de Python del sistema. Para mantener un comportamiento consistente con otros ejecutores y para permitir que Python se use de forma integrada sin la acción `setup-python`, {% data variables.product.prodname_dotcom %} agrega algunas versiones desde la caché de herramientas a `PATH`. | -| macOS | Los ejecutores de macOS tienen más de una versión de Python del sistema instalada, además de las versiones que son parte de la caché de las herramientas. Las versiones de Python del sistema se encuentran en el directorio `/usr/local/Cellar/python/*`. | - -### Instalar dependencias - -Los ejecutores alojados {% data variables.product.prodname_dotcom %} tienen instalado el administrador del paquete pip. Puedes usar pip para instalar dependencias desde el registro del paquete de PyPI antes de construir y probar tu código. Por ejemplo, el YAML que aparece a continuación instala o actualiza el instalador del paquete `pip` y los paquetes `setuptools` y `wheel`. - -También puedes almacenar en caché las dependencias para acelerar tu flujo de trabajo. Para obtener más información, consulta "[Almacenar en caché las dependencias para acelerar tu flujo de trabajo](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)." - -{% raw %} -```yaml -steps: -- uses: actions/checkout@v2 -- name: Set up Python - uses: actions/setup-python@v2 - with: - python-version: '3.x' -- name: Install dependencies - run: python -m pip install --upgrade pip setuptools wheel -``` -{% endraw %} - -#### Archivo de requisitos - -Después de actualizar `pip`, un siguiente paso típico es instalar dependencias desde *requirements.txt*. - -{% raw %} -```yaml -steps: -- uses: actions/checkout@v2 -- name: Set up Python - uses: actions/setup-python@v2 - with: - python-version: '3.x' -- name: Install dependencies - run: | - python -m pip install --upgrade pip - pip install -r requirements.txt -``` -{% endraw %} - -#### Dependencias de almacenamiento en caché - -Puedes almacenar en caché las dependencias de pip utilizando una clave única y restaurar las dependencias cuando ejecutas flujos de trabajo futuros utilizando la acción [`cache`](https://github.com/marketplace/actions/cache). Para obtener más información, consulta "[Almacenar en caché las dependencias para agilizar los flujos de trabajo](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)". - -Pip almacena en caché las dependencias en diferentes ubicaciones, en función del sistema operativo del ejecutor. La ruta que necesitarás para almacenar en caché puede diferir del ejemplo de Ubuntu que aparece a continuación, según el sistema operativo que uses. Para obtener más información, consulta [Ejemplos de almacenamiento en caché de Python](https://github.com/actions/cache/blob/master/examples.md#python---pip). - -{% raw %} -```yaml -steps: -- uses: actions/checkout@v2 -- name: Setup Python - uses: actions/setup-python@v2 - with: - python-version: '3.x' -- name: Cache pip - uses: actions/cache@v2 - with: - # This path is specific to Ubuntu - path: ~/.cache/pip - # Look to see if there is a cache hit for the corresponding requirements file - key: ${{ runner.os }}-pip-${{ hashFiles('requirements.txt') }} - restore-keys: | - ${{ runner.os }}-pip- - ${{ runner.os }}- -- name: Install dependencies - run: pip install -r requirements.txt -``` -{% endraw %} - -{% note %} - -**Nota:** Dependiendo de la cantidad de dependencias, puede ser más rápido usar la caché de dependencias. Los proyectos con muchas dependencias de gran tamaño deberían ver un aumento del rendimiento, ya que reduce el tiempo necesario para la descarga. Los proyectos con menos dependencias pueden no ver un aumento significativo del rendimiento e incluso pueden ver una ligera disminución debido a la manera en que pip instala las dependencias almacenadas en caché. El rendimiento varía de un proyecto a otro. - -{% endnote %} - -### Probar tu código - -Puedes usar los mismos comandos que usas de forma local para construir y probar tu código. - -#### Pruebas con pytest y pytest-cov - -Este ejemplo instala o actualiza `pytest` y `pytest-cov`. A continuación, se ejecutan y se emiten pruebas en formato JUnit, mientras que los resultados de la cobertura de código se emiten en Cobertura. Para obtener más información, consulta [JUnit](https://junit.org/junit5/) y [Cobertura](https://cobertura.github.io/Cobertura/). - -{% raw %} -```yaml -steps: -- uses: actions/checkout@v2 -- name: Set up Python - uses: actions/setup-python@v2 - with: - python-version: '3.x' -- name: Install dependencies - run: | - python -m pip install --upgrade pip - pip install -r requirements.txt -- name: Test with pytest - run: | - pip install pytest - pip install pytest-cov - pytest tests.py --doctest-modules --junitxml=junit/test-results.xml --cov=com --cov-report=xml --cov-report=html -``` -{% endraw %} - -#### Usar Flake8 para el código lint - -En el siguiente ejemplo se instala o actualiza `flake8` y se usa para limpiar todos los archivos. Para obtener más información, consulta [Flake8](http://flake8.pycqa.org/en/latest/). - -{% raw %} -```yaml -steps: -- uses: actions/checkout@v2 -- name: Set up Python - uses: actions/setup-python@v2 - with: - python-version: '3.x' -- name: Install dependencies - run: | - python -m pip install --upgrade pip - pip install -r requirements.txt -- name: Lint with flake8 - run: | - pip install flake8 - flake8 . -``` -{% endraw %} - -#### Ejecutar pruebas con tox - -Con {% data variables.product.prodname_actions %}, puedes ejecutar pruebas con tox y repartir el trabajo a través de múltiples trabajos. Necesitarás invocar tox utilizando la opción `-e py` para elegir la versión de Python en tu `PATH`, en lugar de especificar una versión específica. Para obtener más información, consulta [tox](https://tox.readthedocs.io/en/latest/). - -{% raw %} -```yaml -name: Python package - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - strategy: - matrix: - python: [2.7, 3.7, 3.8] - - steps: - - uses: actions/checkout@v2 - - name: Setup Python - uses: actions/setup-python@v2 - with: - python-version: ${{ matrix.python }} - - name: Install Tox and any other packages - run: pip install tox - - name: Run Tox - # Run tox using the version of Python in `PATH` - run: tox -e py -``` -{% endraw %} - -### Empaquetar datos de flujo de trabajo como artefactos - -Puedes cargar artefactos para ver después de que se complete un flujo de trabajo. Por ejemplo, es posible que debas guardar los archivos de registro, los vaciados de memoria, los resultados de las pruebas o las capturas de pantalla. Para obtener más información, consulta "[Conservar datos de flujo de trabajo mediante artefactos](/github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)". - -En el siguiente ejemplo se muestra cómo puedes usar la acción `upload-artifact` para archivar los resultados de las pruebas de ejecución `pytest`. Para obtener más información, consulta la acción [`upload-artifact`](https://github.com/actions/upload-artifact). - -{% raw %} -```yaml -name: Python package - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - strategy: - matrix: - python-version: [2.7, 3.5, 3.6, 3.7, 3.8] - - steps: - - uses: actions/checkout@v2 - - name: Setup Python # Set Python version - uses: actions/setup-python@v2 - with: - python-version: ${{ matrix.python-version }} - # Install pip and pytest - - name: Install dependencies - run: | - python -m pip install --upgrade pip - pip install pytest - - name: Test with pytest - run: pytest tests.py --doctest-modules --junitxml=junit/test-results-${{ matrix.python-version }}.xml - - name: Upload pytest test results - uses: actions/upload-artifact@v2 - with: - name: pytest-results-${{ matrix.python-version }} - path: junit/test-results-${{ matrix.python-version }}.xml - # Use always() to always run this step to publish test results when there are test failures - if: ${{ always() }} -``` -{% endraw %} - -### Publicar en registros de paquetes - -Puedes configurar tu flujo de trabajo para que publique tu paquete de Python en cualquier registro de paquete que desees cuando pasen tus pruebas de CI. - -Puedes almacenar todos los tokens de acceso o credenciales necesarios para publicar tu paquete utilizando secretos del repositorio. En el siguiente ejemplo, se crea y se publica un paquete para PyPI mediante `twine` y `dist`. Para obtener más información, consulta "[Crear y usar secretos cifrados](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)." - -{% raw %} -```yaml -name: Upload Python Package - -on: - release: - types: [created] - -jobs: - deploy: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - - name: Set up Python - uses: actions/setup-python@v2 - with: - python-version: '3.x' - - name: Install dependencies - run: | - python -m pip install --upgrade pip - pip install setuptools wheel twine - - name: Build and publish - env: - TWINE_USERNAME: ${{ secrets.PYPI_USERNAME }} - TWINE_PASSWORD: ${{ secrets.PYPI_PASSWORD }} - run: | - python setup.py sdist bdist_wheel - twine upload dist/* -``` -{% endraw %} - -Para obtener más información acerca del flujo de trabajo de la plantilla, consulta [`python-publish`](https://github.com/actions/starter-workflows/blob/master/ci/python-publish.yml). diff --git a/translations/es-XL/content/actions/migrating-to-github-actions/index.md b/translations/es-XL/content/actions/migrating-to-github-actions/index.md deleted file mode 100644 index fde6aba7f003..000000000000 --- a/translations/es-XL/content/actions/migrating-to-github-actions/index.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: Migrar a GitHub Actions -intro: 'Migrar de otros proveedores de integración continua (IC) hacia {% data variables.product.prodname_actions %}.' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -{% link_in_list /migrating-from-circleci-to-github-actions %} -{% link_in_list /migrating-from-azure-pipelines-to-github-actions %} -{% link_in_list /migrating-from-jenkins-to-github-actions %} diff --git a/translations/es-XL/content/actions/migrating-to-github-actions/migrating-from-azure-pipelines-to-github-actions.md b/translations/es-XL/content/actions/migrating-to-github-actions/migrating-from-azure-pipelines-to-github-actions.md deleted file mode 100644 index e4b4fa4d86b4..000000000000 --- a/translations/es-XL/content/actions/migrating-to-github-actions/migrating-from-azure-pipelines-to-github-actions.md +++ /dev/null @@ -1,325 +0,0 @@ ---- -title: Migrar de Azure Pipelines a GitHub Actions -intro: '{% data variables.product.prodname_actions %} y Azure Pipelines comparten varias configuraciones similares, lo cual hace que migrar a {% data variables.product.prodname_actions %} sea relativamente sencillo.' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Introducción - -Tanto Azure Pipelines como {% data variables.product.prodname_actions %} te permiten crear flujos de trabajo que compilan, prueban, publican, lanzan y despliegan código automáticamente. Azure Pipelines y {% data variables.product.prodname_actions %} comparten algunas similaridades en la configuración del flujo de trabajo: - -- Los archivos de configuración de flujo de trabajo están escritas en YAML y se almacenan en el repositorio del código. -- Los flujos de trabajo incluyen uno o más jobs. -- Los jobs incluyen uno o más pasos o comandos individuales. -- Los pasos o tareas pueden reutilizarse y compartirse con la comunidad. - -Para obtener más información, consulta la sección "[Conceptos esenciales para {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)". - -### Diferencias clave - -Cuando migres desde Azure Pipelines, considera las siguientes diferencias: - -- Azure Pipelines soporta un _editor clásico_ tradicional, lo cual te permite definir tu configuración de IC en un editor de GUI en vez de crear la definición de mapa en un archivo YAML. {% data variables.product.prodname_actions %} utiliza archivos YAML para definir flujos de trabajo y no es compatible con un editor gráfico. -- Azure Pipelines te permite omitir parte de la estructura en las definiciones de jobs. Por ejemplo, si solo tienes un job, no necesitas definirlo y solo necesitas definir sus pasos. {% data variables.product.prodname_actions %} requiere una configuración específica y no se puede omitir la estructura de YAML. -- Azure Pipelines es compatible con las _etapas_ que se definen en el archivo YAML, las cuales se pueden utilizar para crear flujos de trabajo de despliegue. {% data variables.product.prodname_actions %} necesita que separes las etapas en archivos de flujo de trabajo de YAML diferentes. -- Azure Pipelines instalado localmente compila agentes que pueden seleccionarse con capacidades. Los ejecutores auto-hospedados de {% data variables.product.prodname_actions %} pueden seleccionarse con etiquetas. - -### Migrar jobs y pasos - -Los jobs y los pasos en Azure Pipelines son muy similares a aquellos en {% data variables.product.prodname_actions %}. En ambos sistemas, los jobs tienen las siguientes características: - -* Los jobs contienen una serie de pasos que se ejecutan en secuencia. -* Los jobs se ejecutan en máquinas virtuales separadas o en contenedores separados. -* Los jobs se ejecutan en paralelo predeterminadamente, pero pueden configurarse para ejecutarse en secuencia. - -### Migrar los pasos de un script - -Puedes ejecutar un script o comando de shell como un paso en un flujo de trabajo. En Azure Pipelines, los pasos de un script pueden especificarse utilizando la clave `script`, o con las claves `bash`, `powershell`, o `pwsh`. Los scripts también pueden especificarse como una entrada a la [tarea Bash](https://docs.microsoft.com/en-us/azure/devops/pipelines/tasks/utility/bash?view=azure-devops) o la [tarea PowerShell](https://docs.microsoft.com/en-us/azure/devops/pipelines/tasks/utility/powershell?view=azure-devops). - -En {% data variables.product.prodname_actions %}, todos los scripts se especifican utilizando la clave `run`. Para seleccionar un shell en particular, puedes especificar la clave `shell` cuando proporciones el script. Para obtener más información, consulta la sección "[Sintaxis de flujo de trabajo para {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)". - -Puedes encontrar un ejemplo de la sintaxis para cada sistema: - - - - - - - - - - -
    -Azure Pipelines - -{% data variables.product.prodname_actions %} -
    -{% raw %} -```yaml -jobs: -- job: scripts - pool: - vmImage: 'windows-latest' - steps: - - script: echo "This step runs in the default shell" - - bash: echo "This step runs in bash" - - pwsh: Write-Host "This step runs in PowerShell Core" - - task: PowerShell@2 - inputs: - script: Write-Host "This step runs in PowerShell" -``` -{% endraw %} - -{% raw %} -```yaml -jobs: - scripts: - runs-on: windows-latest - steps: - - run: echo "This step runs in the default shell" - - run: echo "This step runs in bash" - shell: bash - - run: Write-Host "This step runs in PowerShell Core" - shell: pwsh - - run: Write-Host "This step runs in PowerShell" - shell: powershell -``` -{% endraw %} -
    - -### Diferencias en el manejo de errores de los scripts - -En Azure Pipelines, los scripts se pueden configurar para generar un error si cualquier salida se envía a `stderr`. {% data variables.product.prodname_actions %} no es compatible con esta configuración. - -{% data variables.product.prodname_actions %} configura shells para que "fallen rápidamente" cuando sea posible, lo cual detiene el script inmediatamente si alguno de los comandos en éste sale con un código de error. En contraste, Azure Pipelines requiere de una configuración explícita para salir inmediatamente en caso de error. Para obtener más información, consulta la sección "[Sintaxis de flujo de trabajo para {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#exit-codes-and-error-action-preference)". - -### Diferencias con el shell predeterminado de Windows - -En Azure Pipelines, el shell predeterminado para los scripts en plataformas Windows es el Símbolo de Sistema (_cmd.exe_). En {% data variables.product.prodname_actions %}, el shell predeterminado para los scripts en plataformas Windows es PowerShell. PowerShell tiene varias diferencias en comandos integrados, expansión de variables y control de flujo. - -Si estás utilizando un comando simple, es posible que puedas ejecutar un script de Símbolo de Sistema en PowerShell sin tener que realizar cambios. Pero en la mayoría de los casos, tendrás que actualizar tu script con la sintaxis de PowerShell o dar la instrucción a {% data variables.product.prodname_actions %} para ejecutar el script con el Símbolo de Sistema en vez de con PowerShell. Puedes hacer esto especificando `shell` como `cmd`. - -Puedes encontrar un ejemplo de la sintaxis para cada sistema: - - - - - - - - - - -
    -Azure Pipelines - -{% data variables.product.prodname_actions %} -
    -{% raw %} -```yaml -jobs: -- job: run_command - pool: - vmImage: 'windows-latest' - steps: - - script: echo "This step runs in CMD on Windows by default" -``` -{% endraw %} - -{% raw %} -```yaml -jobs: - run_command: - runs-on: windows-latest - steps: - - run: echo "This step runs in PowerShell on Windows by default" - - run: echo "This step runs in CMD on Windows explicitly" - shell: cmd -``` -{% endraw %} -
    - -Para obtener más información, consulta la sección "[Sintaxis de flujo de trabajo para {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#using-a-specific-shell)". - -### Migrar la sintaxis de expresión y los condicionales - -Tanto Azure Pipelines como {% data variables.product.prodname_actions %} pueden ejecutar pasos condicionalmente. En Azure Pipelines, las expresiones condicionales se especifican utilizando la clave `condition`. En {% data variables.product.prodname_actions %}, las expresiones condicionales se especifican utilizando la clave `if`. - -Azure Pipelines utiliza funciones dentro de las expresiones para ejecutar los pasos condicionalmente. En contraste, {% data variables.product.prodname_actions %} utiliza una notación infija. Por ejemplo, puedes reemplazar la función `eq` en Azure Pipelines con el operador `==` en {% data variables.product.prodname_actions %}. - -Puedes encontrar un ejemplo de la sintaxis para cada sistema: - - - - - - - - - - -
    -Azure Pipelines - -{% data variables.product.prodname_actions %} -
    -{% raw %} -```yaml -jobs: -- job: conditional - pool: - vmImage: 'ubuntu-latest' - steps: - - script: echo "This step runs with str equals 'ABC' and num equals 123" - condition: and(eq(variables.str, 'ABC'), eq(variables.num, 123)) -``` -{% endraw %} - -{% raw %} -```yaml -jobs: - conditional: - runs-on: ubuntu-latest - steps: - - run: echo "This step runs with str equals 'ABC' and num equals 123" - if: ${{ env.str == 'ABC' && env.num == 123 }} -``` -{% endraw %} -
    - -Para obtener más información, consulta "[Sintaxis de contexto y expresión para {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)". - -### Dependencias entre jobs - -Tanto Azure Pipelines como {% data variables.product.prodname_actions %} te permiten configurar dependencias par un job. En ambos sistemas, los jobs se ejecutan en paralelo predeterminadamente, pero las dependencias de estos pueden especificarse explícitamente. En Azure Pipelines, esto se hace con la clave `dependsOn`. En {% data variables.product.prodname_actions %}, esto se hace con la clave `needs`. - -Puedes encontrar un ejemplo de la sintaxis para cada sistema. El flujo de trabajo comienza un primer job llamado `initial`, y cuando este job se completa, se ejecutarán dos jobs llamados `fanout1` y `fanout2`. Finalmente, cuando se completen estos dos jobs, se ejecutará el job `fanin`. - - - - - - - - - - -
    -Azure Pipelines - -{% data variables.product.prodname_actions %} -
    -{% raw %} -```yaml -jobs: -- job: initial - pool: - vmImage: 'ubuntu-latest' - steps: - - script: echo "This job will be run first." -- job: fanout1 - pool: - vmImage: 'ubuntu-latest' - dependsOn: initial - steps: - - script: echo "This job will run after the initial job, in parallel with fanout2." -- job: fanout2 - pool: - vmImage: 'ubuntu-latest' - dependsOn: initial - steps: - - script: echo "This job will run after the initial job, in parallel with fanout1." -- job: fanin: - pool: - vmImage: 'ubuntu-latest' - dependsOn: [fanout1, fanout2] - steps: - - script: echo "This job will run after fanout1 and fanout2 have finished." -``` -{% endraw %} - -{% raw %} -```yaml -jobs: - initial: - runs-on: ubuntu-latest - steps: - - run: echo "This job will be run first." - fanout1: - runs-on: ubuntu-latest - needs: initial - steps: - - run: echo "This job will run after the initial job, in parallel with fanout2." - fanout2: - runs-on: ubuntu-latest - needs: initial - steps: - - run: echo "This job will run after the initial job, in parallel with fanout1." - fanin: - runs-on: ubuntu-latest - needs: [fanout1, fanout2] - steps: - - run: echo "This job will run after fanout1 and fanout2 have finished." -``` -{% endraw %} -
    - -Para obtener más información, consulta la sección "[Sintaxis de flujo de trabajo para {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)". - -### Migrar las tareas a acciones - -Azure Pipelines utiliza _tareas_, que son componentes de las aplicaciones que pueden reutilizarse en varios flujos de trabajo. {% data variables.product.prodname_actions %} utiliza_acciones_, que se pueden utilizar para realizar tareas y personalizar tu flujo de trabajo. En ambos sistemas, puedes especificar el nombre de la tarea o acción a ejecutar junto con cualquier entrada requerida como pares de clave/valor. - -Puedes encontrar un ejemplo de la sintaxis para cada sistema: - - - - - - - - - - -
    -Azure Pipelines - -{% data variables.product.prodname_actions %} -
    -{% raw %} -```yaml -jobs: -- job: run_python - pool: - vmImage: 'ubuntu-latest' - steps: - - task: UsePythonVersion@0 - inputs: - versionSpec: '3.7' - architecture: 'x64' - - script: python script.py -``` -{% endraw %} - -{% raw %} -```yaml -jobs: - run_python: - runs-on: ubuntu-latest - steps: - - uses: actions/setup-python@v2 - with: - python-version: '3.7' - architecture: 'x64' - - run: python script.py -``` -{% endraw %} -
    - -Puedes encontrar acciones que puedas utilizar en tu flujo de trabajo en [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace?type=actions), o puedes crear tus propias acciones. Para obtener más información, consulta la sección "[Crear acciones](/actions/creating-actions)". - diff --git a/translations/es-XL/content/actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions.md b/translations/es-XL/content/actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions.md deleted file mode 100644 index 2fd08690da40..000000000000 --- a/translations/es-XL/content/actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions.md +++ /dev/null @@ -1,445 +0,0 @@ ---- -title: Migrar de CircleCI a GitHub Actions -intro: 'GitHub Actions y CircleCi comparten varias configuraciones similares, lo cual hace que migrar a GitHub Actions sea relativamente fácil.' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Introducción - -Tanto CircleCi como {% data variables.product.prodname_actions %} te permiten crear flujos de trabajo que compilan, prueban, publican, lanzan y despliegan código automáticamente. CircleCI y {% data variables.product.prodname_actions %} comparten algunas similaridades en la configuración del flujo de trabajo: - -- Los archivos de configuración de flujo de trabajo están escritos en YAML y se almacenan en el repositorio. -- Los flujos de trabajo incluyen uno o más jobs. -- Los jobs incluyen uno o más pasos o comandos individuales. -- Los pasos o tareas pueden reutilizarse y compartirse con la comunidad. - -Para obtener más información, consulta la sección "[Conceptos esenciales para {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)". - -### Diferencias clave - -Cuando migres desde CircleCI, considera las siguientes diferencias: - -- El paralelismo automático de pruebas de CircleCI agrupa las pruebas automáticamente de acuerdo con las reglas que el usuario haya especificado o el historial de información de tiempos. Esta funcionalidad no se incluye en {% data variables.product.prodname_actions %}. -- Las acciones que se ejecutan en los contenedores de Docker distinguen entre problemas de permisos, ya que los contenedores tienen un mapeo de usuarios diferente. Puedes evitar muchos de estos problemas si no utilizas la instrucción `USER` en tu *Dockerfile*. Para obtener más información acerca del sistema de archivos de Docker, consulta la sección "[Ambientes virtuales para los ejecutores hospedados en {% data variables.product.product_name %}](/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem)". - -### Migrar flujos de trabajo y jobs - -CircleCi define los `workflows` en el archivo *config.yml*, lo cual te permite configurar más de un flujo de trabajo. {% data variables.product.product_name %} requiere tratar los flujos de trabajo uno por uno y, como consecuencia, no necesita que declares los `workflows`. Necesitarás crear un nuevo archivo de flujo de trabajo para cada flujo que se haya configurado en *config.yml*. - -Tanto CircleCI como {% data variables.product.prodname_actions %} configuran `jobs` en el archivo de configuración utilizando una sintaxis similar. Si configurars cualquier dependencia entre jobs utilizando `requires` en tu flujo de trabajo de CircleCI, puedes utilizar la sintaxis de {% data variables.product.prodname_actions %} equivalente "`needs`". Para obtener más información, consulta la sección "[Sintaxis de flujo de trabajo para {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)". - -### Mirgrar orbes a acciones - -Tanto CircleCI como {% data variables.product.prodname_actions %} proporcionan un mecanismo para reutilizar y compartir tareas en un flujo de trabajo. CircleCi utiliza un concepto llamado orbes (orbs), escrito en YAML, que proporciona tareas que las personas pueden reutilizar en un flujo de trabajo. {% data variables.product.prodname_actions %} cuenta con componentes reutilizables poderosos y flexibles llamados acciones (actions), los cuales compilas ya sea con archivos de JavaScript o con imagenes de Docker. Puedes crear acciones escribiendo un código personalizado que interactúe con tu repositorio de la manera que desees, incluida la integración con las API de {% data variables.product.product_name %} y cualquier API de terceros disponible públicamente. Por ejemplo, una acción puede publicar módulos npm, enviar alertas por SMS cuando se crean propuestas urgentes o implementar un código listo para producción. Para obtener más información, consulta la sección "[Crear acciones](/actions/creating-actions)". - -Circle CI puede reutilizar partes de los flujos de trabajo con anclas y alias. {% data variables.product.prodname_actions %} es compatible con las necesidades de reutilización más comunes utilizando matrices de compilación. Para obtener más información acerca de matrices de compilación, consulta la sección "[Configurar un flujo de trabajo](/actions/configuring-and-managing-workflows/configuring-a-workflow#configuring-a-build-matrix)". - -### Utilizar imágenes de Docker - - -Tanto CircleCi como {% data variables.product.prodname_actions %} son compatibles con la ejecución de pasos dentro de una imagen de Docker. - -CircleCi proporciona un conjunto de imágenes pre-compiladas con dependencias comunes. Estas imágenes cuentan con el `USER` configurado como `circleci`, lo cual ocasiona que los permisos choquen con {% data variables.product.prodname_actions %}. - -Recomendamos que te retires de las imágenes pre-compiladas de CircleCi cuando migres a {% data variables.product.prodname_actions %}. En muchos casos, puedes utilizar acciones para instalar dependencias adicionales que necesites. - -Para obtener más información acerca del sistema de archivos de Docker, consulta la sección "[Ambientes virtuales para los ejecutores hospedados en {% data variables.product.product_name %}](/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem)". - -Para obtener más información acerca de las herramientas y paquetes disponibles en los ambientes virtuales hospedados en {% data variables.product.prodname_dotcom %}, consulta la sección "[Software instalado en los ejecutores hospedados en GitHub](/actions/reference/software-installed-on-github-hosted-runners)". - -### Utilizar variables y secretos - -CircleCi y {% data variables.product.prodname_actions %} son compatibles con la configuración de variables de ambiente en el archivo de configuración y con la creación de secretos utilizando la IU de CircleCI o de {% data variables.product.product_name %}. - -Para obtener más información, consulta la sección "[Utilizar variables de ambiente](/actions/configuring-and-managing-workflows/using-environment-variables)" y "[Crear y utilizar secretos cifrados](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)". - -### Almacenamiento en caché - -CircleCI y {% data variables.product.prodname_actions %} proporcionan un método para almacenar archivos en cahcé manualmente en el archivo de configuración. - -Puedes encontrar un ejemplo de la sintaxis para cada sistema. - - - - - - - - - - -
    -CircleCI - -GitHub Actions -
    -{% raw %} -```yaml -- restore_cache: - keys: - - v1-npm-deps-{{ checksum "package-lock.json" }} - - v1-npm-deps- -``` -{% endraw %} - -{% raw %} -```yaml -- name: Cache node modules - uses: actions/cache@v2 - with: - path: ~/.npm - key: v1-npm-deps-${{ hashFiles('**/package-lock.json') }} - restore-keys: v1-npm-deps- -``` -{% endraw %} -
    - -Para obtener más información, consulta "[Almacenar en caché las dependencias para agilizar los flujos de trabajo](/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows)". - -{% data variables.product.prodname_actions %} no tiene un equivalente al Almacenamiento en Caché por Capas de Docker (o DLC, por sus siglas en inglés) que tiene CircleCI. - -### Datos persistentes entre jobs - -Tanto CircleCi como {% data variables.product.prodname_actions %} proporcionan mecanismos para persistir datos entre jobs. - -A continuación encontrarás un ejemplo en la sintaxis de configuración tanto de CircleCi como de {% data variables.product.prodname_actions %}. - - - - - - - - - - -
    -CircleCI - -GitHub Actions -
    -{% raw %} -```yaml -- persist_to_workspace: - root: workspace - paths: - - math-homework.txt - -... - -- attach_workspace: - at: /tmp/workspace -``` -{% endraw %} - -{% raw %} -```yaml -- name: Upload math result for job 1 - uses: actions/upload-artifact@v2 - with: - name: homework - path: math-homework.txt - -... - -- name: Download math result for job 1 - uses: actions/download-artifact@v2 - with: - name: homework -``` -{% endraw %} -
    - -Para obtener más información, consulta "[Conservar datos de flujo de trabajo mediante artefactos](/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts)." - -### Usar bases de datos y contenedores de servicio - -Ambos sistemas te permiten incluir contenedores adicionales para bases de datos, almacenamiento en caché, u otras dependencias. - -En CircleCi, la primera imagen listada en el *config.yaml* es la imagen primaria que se utiliza para ejecutar comandos. {% data variables.product.prodname_actions %} utiliza secciones explícitas: utiliza `container` para el contenedor primario, y lista contenedores adicionales en `services`. - -A continuación encontrarás un ejemplo en la sintaxis de configuración tanto de CircleCi como de {% data variables.product.prodname_actions %}. - - - - - - - - - - -
    -CircleCI - -GitHub Actions -
    -{% raw %} -```yaml ---- -version: 2.1 - -jobs: - - ruby-26: - docker: - - image: circleci/ruby:2.6.3-node-browsers-legacy - environment: - PGHOST: localhost - PGUSER: administrate - RAILS_ENV: test - - image: postgres:10.1-alpine - environment: - POSTGRES_USER: administrate - POSTGRES_DB: ruby26 - POSTGRES_PASSWORD: "" - - working_directory: ~/administrate - - steps: - - checkout - - # Bundle install dependencies - - run: bundle install --path vendor/bundle - - # Wait for DB - - run: dockerize -wait tcp://localhost:5432 -timeout 1m - - # Setup the environment - - run: cp .sample.env .env - - # Setup the database - - run: bundle exec rake db:setup - - # Run the tests - - run: bundle exec rake - - -workflows: - version: 2 - build: - jobs: - - ruby-26 -... - -- attach_workspace: - at: /tmp/workspace -``` -{% endraw %} - -{% raw %} -```yaml -name: Containers - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - container: circleci/ruby:2.6.3-node-browsers-legacy - - env: - PGHOST: postgres - PGUSER: administrate - RAILS_ENV: test - - services: - postgres: - image: postgres:10.1-alpine - env: - POSTGRES_USER: administrate - POSTGRES_DB: ruby25 - POSTGRES_PASSWORD: "" - ports: - - 5432:5432 - # Add a health check - options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 5 - - steps: - # This Docker file changes sets USER to circleci instead of using the default user, so we need to update file permissions for this image to work on GH Actions. - # See https://docs.github.com/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem - - name: Setup file system permissions - run: sudo chmod -R 777 $GITHUB_WORKSPACE /github /__w/_temp - - uses: actions/checkout@v2 - - name: Install dependencies - run: bundle install --path vendor/bundle - - name: Setup environment configuration - run: cp .sample.env .env - - name: Setup database - run: bundle exec rake db:setup - - name: Run tests - run: bundle exec rake -``` -{% endraw %} -
    - -Para obtener más información, consulta la sección "[Acerca de los contenedores de servicio](/actions/configuring-and-managing-workflows/about-service-containers)". - -### Ejemplo Completo - -A continuación encontrarás un ejemplo real. A la izquierda puedes ver el *config.yml* real de CircleCi para el repositorio [thoughtbot/administrator](https://github.com/thoughtbot/administrate). La derecha muestra el equivalente en {% data variables.product.prodname_actions %}. - - - - - - - - - - -
    -CircleCI - -GitHub Actions -
    -{% raw %} -```yaml ---- -version: 2.1 - -commands: - shared_steps: - steps: - - checkout - - # Restore Cached Dependencies - - restore_cache: - name: Restore bundle cache - key: administrate-{{ checksum "Gemfile.lock" }} - - # Bundle install dependencies - - run: bundle install --path vendor/bundle - - # Cache Dependencies - - save_cache: - name: Store bundle cache - key: administrate-{{ checksum "Gemfile.lock" }} - paths: - - vendor/bundle - - # Wait for DB - - run: dockerize -wait tcp://localhost:5432 -timeout 1m - - # Setup the environment - - run: cp .sample.env .env - - # Setup the database - - run: bundle exec rake db:setup - - # Run the tests - - run: bundle exec rake - -default_job: &default_job - working_directory: ~/administrate - steps: - - shared_steps - # Run the tests against multiple versions of Rails - - run: bundle exec appraisal install - - run: bundle exec appraisal rake - -jobs: - ruby-25: - <<: *default_job - docker: - - image: circleci/ruby:2.5.0-node-browsers - environment: - PGHOST: localhost - PGUSER: administrate - RAILS_ENV: test - - image: postgres:10.1-alpine - environment: - POSTGRES_USER: administrate - POSTGRES_DB: ruby25 - POSTGRES_PASSWORD: "" - - ruby-26: - <<: *default_job - docker: - - image: circleci/ruby:2.6.3-node-browsers-legacy - environment: - PGHOST: localhost - PGUSER: administrate - RAILS_ENV: test - - image: postgres:10.1-alpine - environment: - POSTGRES_USER: administrate - POSTGRES_DB: ruby26 - POSTGRES_PASSWORD: "" - - -workflows: - version: 2 - multiple-rubies: - jobs: - - ruby-26 - - ruby-25 -``` -{% endraw %} - -{% raw %} -```yaml -name: Containers - -on: [push] - -jobs: - build: - - strategy: - matrix: - ruby: [2.5, 2.6.3] - - runs-on: ubuntu-latest - - env: - PGHOST: localhost - PGUSER: administrate - RAILS_ENV: test - - services: - postgres: - image: postgres:10.1-alpine - env: - POSTGRES_USER: administrate - POSTGRES_DB: ruby25 - POSTGRES_PASSWORD: "" - ports: - - 5432:5432 - # Add a health check - options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 5 - - steps: - - uses: actions/checkout@v2 - - name: Setup Ruby - uses: eregon/use-ruby-action@master - with: - ruby-version: ${{ matrix.ruby }} - - name: Cache dependencies - uses: actions/cache@v2 - with: - path: vendor/bundle - key: administrate-${{ matrix.image }}-${{ hashFiles('Gemfile.lock') }} - - name: Install postgres headers - run: sudo apt-get install libpq-dev - - name: Install dependencies - run: bundle install --path vendor/bundle - - name: Setup environment configuration - run: cp .sample.env .env - - name: Setup database - run: bundle exec rake db:setup - - name: Run tests - run: bundle exec rake - - name: Install appraisal - run: bundle exec appraisal install - - name: Run appraisal - run: bundle exec appraisal rake -``` -{% endraw %} -
    diff --git a/translations/es-XL/content/actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions.md b/translations/es-XL/content/actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions.md deleted file mode 100644 index c5754a02a383..000000000000 --- a/translations/es-XL/content/actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions.md +++ /dev/null @@ -1,291 +0,0 @@ ---- -title: Migrar de Jenkins a GitHub Actions -intro: '{% data variables.product.prodname_actions %} y Jenkins comparten varias similaridades, lo cual hace que migrar a {% data variables.product.prodname_actions %} sea relativamente sencillo.' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Introducción - -Tanto Jenkins como {% data variables.product.prodname_actions %} te permiten crear flujos de trabajo que compilan, prueban, publican, lanzan y despliegan código automáticamente. Jenkins y {% data variables.product.prodname_actions %} comparten algunas similaridades en la configuración del flujo de trabajo: - -- Jenkins crea flujos de trabajo utilizando _Mapas Declarativos_, los cuales son similares a los archivos de flujo de trabajo de {% data variables.product.prodname_actions %}. -- Jenkins utiliza _etapas_ para ejecutar un conjunto de pasos, mientras que {% data variables.product.prodname_actions %} utiliza jobs para agrupar uno o mas pasos o comandos individuales. -- Jenkins y {% data variables.product.prodname_actions %} son compatibles con compilaciones basadas en el contenedor. Para obtener más información, consulta "[Crear una acción de contenedor Docker](/articles/creating-a-docker-container-action)". -- Los pasos o tareas pueden reutilizarse y compartirse con la comunidad. - -Para obtener más información, consulta la sección "[Conceptos esenciales para {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)". - -### Diferencias clave - -- Jenkins tiene dos tipos de sintaxis para crear mapas: Mapa Declarativo y Mapa de Script. {% data variables.product.prodname_actions %} utiliza YAML para crear flujos de trabajo y archivos de configuración. Para obtener más información, consultala sección "[Sintaxis de flujo de trabajo para GitHub Actions](/actions/reference/workflow-syntax-for-github-actions)". -- Los despliegues de jenkins son típicamente auto-hospedados y los usuarios mantienen los servidores en sus propios centros de datos. {% data variables.product.prodname_actions %} ofrece un acercamiento híbrido en la nube, hospedando sus propios ejecutores que puedes utilizar para ejecutar jobs, mientras que también son compatibles con ejecutores auto-hospedados. Para obtener más información, consulta la sección [Acerca de los ejecutores auto-hospedados](/actions/hosting-your-own-runners/about-self-hosted-runners). - -### Comparación de capacidades - -#### Distribuir tus compilaciones - -Jenkis te permite enviar compilaciones a un agente de compilación sencilla, o puedes distribuirlas a través de varios agentes. También puedes clasificar estos agentes de acuerdo con diversos atributos, tales como los tipos de sistema operativo. - -De manera similar, {% data variables.product.prodname_actions %} puede enviar jobs a los ejecutores hospedatos en {% data variables.product.prodname_dotcom %} o autohospedados, y puedes utilizar etiquetas para clasificarlos de acuerdo a diversos atributos. La siguiente tabla compara cómo se implementa el concepto de compilación distribuido tanto para Jenkins como para {% data variables.product.prodname_actions %}. - -| Jenkins | {% data variables.product.prodname_actions %} | -| ---------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [`agents`](https://wiki.jenkins.io/display/JENKINS/Distributed+builds) | [`runners`](/actions/getting-started-with-github-actions/core-concepts-for-github-actions#runner)
    [`self-hosted runners`](/actions/hosting-your-own-runners/about-self-hosted-runners) | - -#### Utilizar secciones para organizar mapas - -Jenkins divide sus Mapas Declarativos en varias secciones. De manera similar, {% data variables.product.prodname_actions %} organiza sus flujos de trabajo en secciones diferentes. En esta tabla se comparan las secciones de Jenkins con el flujo de trabajo de {% data variables.product.prodname_actions %}. - -| Directivas de Jenkins | {% data variables.product.prodname_actions %} | -| ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| [`agent`](https://jenkins.io/doc/book/pipeline/syntax/#agent) | [`jobs..runs-on`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idruns-on)
    [`jobs..container`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idcontainer) | -| [`publicación`](https://jenkins.io/doc/book/pipeline/syntax/#post) | | -| [`stages`](https://jenkins.io/doc/book/pipeline/syntax/#stages) | [`Trabajos`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobs) | -| [`pasos`](https://jenkins.io/doc/book/pipeline/syntax/#steps) | [`jobs..steps`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idsteps) | - - -### Utilizar directivas - -Jenkins utiliza directivas para administrar los _Mapas Declarativos_. Estas directivas definen las características de tu flujo de trabajo y la manera en que se ejecuta. La tabla siguiente demuestra cómo dichas directivas mapean los conceptos en {% data variables.product.prodname_actions %}. - -| Directivas de Jenkins | {% data variables.product.prodname_actions %} | -| ------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [`entorno`](https://jenkins.io/doc/book/pipeline/syntax/#environment) | [`jobs..env`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#env)
    [`jobs..steps.env`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsenv) | -| [`opciones`](https://jenkins.io/doc/book/pipeline/syntax/#parameters) | [`jobs..strategy`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategy)
    [`jobs..strategy.fail-fast`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategyfail-fast)
    [`jobs..timeout-minutes`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idtimeout-minutes) | -| [`parámetros`](https://jenkins.io/doc/book/pipeline/syntax/#parameters) | [`inputs`](/actions/creating-actions/metadata-syntax-for-github-actions#inputs)
    [`outputs`](/actions/creating-actions/metadata-syntax-for-github-actions#outputs) | -| [`triggers`](https://jenkins.io/doc/book/pipeline/syntax/#triggers) | [`on`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#on)
    [`on..types`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onevent_nametypes)
    [on..](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onpushpull_requestbranchestags)
    [on..paths](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onpushpull_requestpaths) | -| [`triggers { upstreamprojects() }`](https://jenkins.io/doc/book/pipeline/syntax/#triggers) | [`jobs..needs`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idneeds) | -| [Sintaxis de Jenkins cron](https://jenkins.io/doc/book/pipeline/syntax/#cron-syntax) | [`on.schedule`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onschedule) | -| [`etapa`](https://jenkins.io/doc/book/pipeline/syntax/#stage) | [`jobs.`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_id)
    [`jobs..name`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idname) | -| [`tools`](https://jenkins.io/doc/book/pipeline/syntax/#tools) | [Software instalado en los ejecutores alojados en GitHub](/actions/reference/software-installed-on-github-hosted-runners) | -| [`entrada`](https://jenkins.io/doc/book/pipeline/syntax/#input) | [`inputs (entradas)`](/actions/automating-your-workflow-with-github-actions/metadata-syntax-for-github-actions#inputs) | -| [`when`](https://jenkins.io/doc/book/pipeline/syntax/#when) | [`jobs..if`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idif) | - - -### Utilizar etapas secuenciales - -#### Proceso paralelo de jobs - -Jenkins puede ejecutar las `stages` y `steps` en paralelo, mientras que, actualmente, {% data variables.product.prodname_actions %} solo ejecuta jobs en paralelo. - -| Jenkins en Paralelo | {% data variables.product.prodname_actions %} | -| ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [`parallel`](https://jenkins.io/doc/book/pipeline/syntax/#parallel) | [`jobs..strategy.max-parallel`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymax-parallel) | - -#### Matriz de compilaciones - -Tanto {% data variables.product.prodname_actions %} como Jenkins te permiten utilizar una matriz de compilaciones para definir diversas combinaciones de sistema. - -| Jenkins | {% data variables.product.prodname_actions %} | -| ------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [`axis`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-axes) | [`strategy/matrix`](/actions/configuring-and-managing-workflows/configuring-a-workflow#configuring-a-build-matrix)
    [`context`](/actions/reference/context-and-expression-syntax-for-github-actions) | -| [`stages`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-stages) | [`steps-context`](/actions/reference/context-and-expression-syntax-for-github-actions#steps-context) | -| [`excludes`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-stages) | | - -#### Utilizar pasos para ejecutar tareas - -Jenkins agrupa los `steps` en `stages`. Cada uno de estos pasos puede ser un script, función, o comando, entre otros. De manera similar, {% data variables.product.prodname_actions %} utiliza `jobs` para ejecutar grupos específicos de `steps`. - -| Pasos de Jenkins | {% data variables.product.prodname_actions %} | -| --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | -| [`script`](https://jenkins.io/doc/book/pipeline/syntax/#script) | [`jobs..steps`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idsteps) | - -### Ejemplos de tareas comunes - -#### Programar un mapa para ejecutarse con `cron` - - - - - - - - - - -
    -Mapa de Jenkins - -Flujo de trabajo de {% data variables.product.prodname_actions %} -
    - - ```yaml - pipeline { - agent any - triggers { - cron('H/15 * * * 1-5') - } - } - ``` - - - - ```yaml - on: - schedule: - - cron: '*/15 * * * 1-5' - ``` - -
    - -#### Configurar variables de ambiente en un mapa - - - - - - - - - - -
    -Mapa de Jenkins - -Flujo de trabajo de {% data variables.product.prodname_actions %} -
    - - ```yaml - pipeline { - agent any - environment { - MAVEN_PATH = '/usr/local/maven' - } - } - ``` - - - - ```yaml - jobs: - maven-build: - env: - MAVEN_PATH: '/usr/local/maven' - - ``` - -
    - -#### Compilar desde proyectos ascendentes - - - - - - - - - - -
    -Mapa de Jenkins - -Flujo de trabajo de {% data variables.product.prodname_actions %} -
    - - ```yaml - pipeline { - triggers { - upstream( - upstreamProjects: 'job1,job2', - threshold: hudson.model.Result.SUCCESS) - } - } - } - - ``` - - - - ```yaml - jobs: - job1: - job2: - needs: job1 - job3: - needs: [job1, job2] - - ``` - -
    - -#### Compilar con sistemas operativos múltiples - - - - - - - - - - -
    -Mapa de Jenkins - -Flujo de trabajo de {% data variables.product.prodname_actions %} -
    - - ```yaml -pipeline { - agent none - stages { - stage('Run Tests') { - parallel { - stage('Test On MacOS') { - agent { label "macos" } - tools { nodejs "node-12" } - steps { - dir("scripts/myapp") { - sh(script: "npm install -g bats") - sh(script: "bats tests") - } - } - } - stage('Test On Linux') { - agent { label "linux" } - tools { nodejs "node-12" } - steps { - dir("script/myapp") { - sh(script: "npm install -g bats") - sh(script: "bats tests") - } - } - } - } - } - } -} - ``` - - - -{% raw %} - ```yaml - name: demo-workflow - on: - push: - jobs: - test: - runs-on: ${{ matrix.os }} - strategy: - fail-fast: false - matrix: - os: [macos-latest, ubuntu-latest] - steps: - - uses: actions/checkout@v1 - - uses: actions/setup-node@v1 - with: - node-version: 12 - - run: npm install -g bats - - run: bats tests - working-directory: scripts/myapp - ``` -{% endraw %} - -
    diff --git a/translations/es-XL/content/actions/publishing-packages-with-github-actions/about-packaging-with-github-actions.md b/translations/es-XL/content/actions/publishing-packages-with-github-actions/about-packaging-with-github-actions.md deleted file mode 100644 index 701254bce57f..000000000000 --- a/translations/es-XL/content/actions/publishing-packages-with-github-actions/about-packaging-with-github-actions.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: Acerca del empaquetado con acciones de GitHub -intro: 'Puedes configurar flujos de trabajo en {% data variables.product.prodname_actions %} para generar paquetes y cargarlos en {% data variables.product.prodname_registry %} u otro proveedor de alojamiento del paquete.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/about-packaging-with-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Acerca de los pasos de empaquetado - -Un paso de empaquetado es una parte común de un flujo de trabajo de integración continua o entrega continua. Después de construir y probar tu aplicación, se produce un artefacto ejecutable o desplegable en la forma de un paquete. Por ejemplo, un flujo de trabajo de integración continua para un proyecto Java puede ejecutar `mvn package` para generar un archivo JAR. O un flujo de trabajo de CI para una aplicación Node.js puede crear un contenedor Docker. - -Según el tipo de aplicación que estás construyendo, este paquete se puede descargar de forma local para pruebas manuales, disponible para que los usuarios los descarguen o se implementen en un entorno de ensayo o producción. - -### Empaquetado en flujos de trabajo de integración continua - -Crear un paquete al final de un flujo de trabajo de integración continua puede ayudar durante las revisiones de código en una solicitud de extracción. Después de construir y probar tu código, un paso de empaquetado puede generar un artefacto ejecutable o desplegable. Luego, tu flujo de trabajo puede tomar ese artefacto y cargarlo como parte del flujo de trabajo. - -Ahora, cuando revises una solicitud de extracción, podrás ver la ejecución del flujo de trabajo y descargar el artefacto que se produjo. - -![Menú desplegable Download artifact (Descargar artefacto)](/assets/images/help/repository/artifact-drop-down.png) - -Esto te permitirá ejecutar el código en la solicitud de extracción en tu máquina, lo que puede ayudar con la depuración o la prueba de la solicitud de extracción. - -### Flujos de trabajo para publicar paquetes - -Además de cargar artefactos de empaquetado para las pruebas en un flujo de trabajo de integración continua, puedes crear flujos de trabajo que construyan tu proyecto y publiquen paquetes en un registro de paquete. - -* **Publicar paquetes para {% data variables.product.prodname_registry %}** - {% data variables.product.prodname_registry %} puede actuar como un servicio de alojamiento de paquetes para muchos tipos de paquetes. Puedes elegir compartir tus paquetes con todos los {% data variables.product.prodname_dotcom %}, o paquetes privados para compartir con los colaboradores o una organización. Para obtener más información, consulta "[Acerca de {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/about-github-packages)". - - Es posible que desees publicar paquetes para {% data variables.product.prodname_registry %} en cada subida a la rama principal. Esto permitirá que los programadores en tu proyecto siempre puedan ejecutar y probar la última construcción fuera del principal fácilmente, instalándolo desde {% data variables.product.prodname_registry %}. - -* **Publicar paquetes en un registro de paquetes** - Para muchos proyectos, publicar en un registro de paquete se realiza cada vez que se lanza una nueva versión de un proyecto. Por ejemplo, un proyecto que produce un archivo JAR puede cargar nuevos lanzamientos en el repositorio central de Maven. O bien, un proyecto de .NET puede generar un paquete NuGet y cargarlo en la galería de NuGet. - - Puedes automatizar esto creando un flujo de trabajo que publique paquetes en un registro de paquetes en cada creación de lanzamiento. Para obtener más información, consulta "[Crear lanzamientos](/github/administering-a-repository/creating-releases)." - -### Leer más - -- "[Publicar paquetes Node.js](/actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages)" diff --git a/translations/es-XL/content/actions/publishing-packages-with-github-actions/index.md b/translations/es-XL/content/actions/publishing-packages-with-github-actions/index.md deleted file mode 100644 index 69604df694dd..000000000000 --- a/translations/es-XL/content/actions/publishing-packages-with-github-actions/index.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: Publicar paquetes con acciones de GitHub -shortTitle: Publicar paquetes -intro: 'Crear y publicar paquetes para {% data variables.product.prodname_registry %} u otro proveedor de alojamiento del paquete.' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -{% link_in_list /about-packaging-with-github-actions %} diff --git a/translations/es-XL/content/actions/reference/software-installed-on-github-hosted-runners.md b/translations/es-XL/content/actions/reference/software-installed-on-github-hosted-runners.md deleted file mode 100644 index 9144a2b3ccb0..000000000000 --- a/translations/es-XL/content/actions/reference/software-installed-on-github-hosted-runners.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: Software instalado en los ejecutores alojados en GitHub -intro: 'Este artículo se vincula con las referencias para los paquetes y las herramientas disponibles en los entornos virtuales alojados en {% data variables.product.prodname_dotcom %}.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/software-in-virtual-environments-for-github-actions - - /github/automating-your-workflow-with-github-actions/software-in-virtual-environments-for-github-actions - - /github/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners - - /actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -Las herramientas incluidas en los ejecutores alojados en {% data variables.product.prodname_dotcom %} se actualizan semanalmente. Para obtener la lista más reciente de herramientas incluidas para cada sistema operativo de ejecutor, consulta los enlaces que figuran a continuación: - -* [Ubuntu 20.04 LTS](https://github.com/actions/virtual-environments/blob/master/images/linux/Ubuntu2004-README.md) -* [Ubuntu 18.04 LTS](https://github.com/actions/virtual-environments/blob/master/images/linux/Ubuntu1804-README.md) -* [Ubuntu 16.04 LTS](https://github.com/actions/virtual-environments/blob/master/images/linux/Ubuntu1604-README.md) -* [Windows Server 2019](https://github.com/actions/virtual-environments/blob/master/images/win/Windows2019-Readme.md) -* [Windows Server 2016](https://github.com/actions/virtual-environments/blob/master/images/win/Windows2016-Readme.md) -* [MacOS 10.15](https://github.com/actions/virtual-environments/blob/master/images/macos/macos-10.15-Readme.md) - -{% data reusables.github-actions.ubuntu-runner-preview %} - -Los ejecutores alojados en {% data variables.product.prodname_dotcom %} incluyen las herramientas integradas predeterminadas del sistema operativo, además de los paquetes enumerados en las referencias anteriores. Por ejemplo, los ejecutores de Ubuntu y macOS incluyen `grep`, `find` y `which`, entre otras herramientas predeterminadas. - -Si hay alguna herramienta que quieras solicitar, abre una propuesta en [actions/virtual-environments](https://github.com/actions/virtual-environments). diff --git a/translations/es-XL/content/actions/reference/virtual-environments-for-github-hosted-runners.md b/translations/es-XL/content/actions/reference/virtual-environments-for-github-hosted-runners.md deleted file mode 100644 index 2e5fed6d93fd..000000000000 --- a/translations/es-XL/content/actions/reference/virtual-environments-for-github-hosted-runners.md +++ /dev/null @@ -1,131 +0,0 @@ ---- -title: Entornos virtuales para los ejecutores alojados en GitHub -intro: '{% data variables.product.prodname_dotcom %} ofrece máquinas virtuales alojadas para ejecutar flujos de trabajo. La máquina virtual contiene un entorno de herramientas, paquetes y configuraciones disponibles para que {% data variables.product.prodname_actions %} los utilice.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/virtual-environments-for-github-actions - - /github/automating-your-workflow-with-github-actions/virtual-environments-for-github-actions - - /github/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners - - /actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Acerca de ejecutores alojados en {% data variables.product.prodname_dotcom %} - -Un ejecutor alojado en {% data variables.product.prodname_dotcom %} es una máquina virtual alojada por {% data variables.product.prodname_dotcom %} con la aplicación del ejecutor {% data variables.product.prodname_actions %} instalada. {% data variables.product.prodname_dotcom %} ofrece ejecutores con sistemas operativos Linux, Windows y macOS. - -Cuando usas un ejecutor alojado en {% data variables.product.prodname_dotcom %}, se contemplan el mantenimiento de la máquina y las actualizaciones. Puedes ejecutar flujos de trabajo directamente en la máquina virtual o en un contenedor Docker. - -Puedes especificar el tipo de ejecutor para cada puesto en un flujo de trabajo. Cada puesto en un flujo de trabajo se ejecuta en una instancia nueva de la máquina virtual. Todos los pasos del trabajo se ejecutan en la misma instancia de la máquina virtual, lo que permite que las acciones de ese trabajo compartan información usando el sistema de archivos. - -{% data reusables.github-actions.runner-app-open-source %} - -#### Hosts en la nube para ejecutores alojados en {% data variables.product.prodname_dotcom %} - -{% data variables.product.prodname_dotcom %} aloja ejecutores de Linux y Windows en máquinas virtuales Standard_DS2_v2 en Microsoft Azure con la aplicación del ejecutor de {% data variables.product.prodname_actions %} instalada. La aplicación del ejecutor alojada en {% data variables.product.prodname_dotcom %} es una bifurcación del agente de Azure Pipelines. Los paquetes ICMP entrantes están bloqueados para todas las máquinas virtuales de Azure, por lo tanto, es posible que los comandos ping o traceroute no funcionen. Para obtener más información acerca de los recursos de la máquina Standard_DS2_v2, consulta "[Dv2 y DSv2-series](https://docs.microsoft.com/en-us/azure/virtual-machines/dv2-dsv2-series#dsv2-series)"en la documentación de Microsoft Azure. - -{% data variables.product.prodname_dotcom %} utiliza [MacStadium](https://www.macstadium.com/) para alojar a los ejecutores de macOS. - -#### Privilegios administrativos de los ejecutores alojados en {% data variables.product.prodname_dotcom %} - -Las máquinas virtuales Linux y macPS se ejecutan sin la contraseña `sudo`. Cuando necesitas ejecutar comandos o instalar herramientas que requieren más privilegios que el usuario actual, puedes usar `sudo` sin la necesidad de brindar una contraseña. Para obtener más información, consulta "[Manual de sudo](https://www.sudo.ws/man/1.8.27/sudo.man.html)." - -Las máquinas virtuales de Windows están configuradas para ejecutarse como administradores con el control de cuentas de usuario (UAC) inhabilitado. Para obtener más información, consulta "[Cómo funciona el control de cuentas de usuario](https://docs.microsoft.com/en-us/windows/security/identity-protection/user-account-control/how-user-account-control-works)" en la documentación de Windows. - -### Ejecutores y recursos de hardware compatibles - -Cada máquina virtual tiene los mismos recursos de hardware disponibles. - -- CPU de 2 núcleos -- 7 GB de memoria RAM -- 14 GB de espacio en el disco SSD - -{% data reusables.github-actions.supported-github-runners %} - -{% data reusables.github-actions.ubuntu-runner-preview %} - -Para obtener una lista de software, herramientas y paquetes compatibles con cada ejecutor, consulta "[Software instalado en ejecutores alojados en {% data variables.product.prodname_dotcom %}](/actions/reference/software-installed-on-github-hosted-runners)". - -Puedes ver las bitácoras para una ejecución de flujo de trabajo para ver el ambiente del ejecutor exacto que se utilizó para un job, así como un enlace a las herramientas preinstaladas que estaban en dicho ejecutor. Para obtener más información, consulta la sección "[Administrar la ejecución de un flujo de trabajo](/actions/configuring-and-managing-workflows/managing-a-workflow-run#viewing-your-workflow-history)". - - -#### Direcciones IP de ejecutores alojados en {% data variables.product.prodname_dotcom %} - -{% note %} - -**Nota:** Si usas una lista de direcciones IP permitidas para tu cuenta de organización o de empresa {% data variables.product.prodname_dotcom %}, no puedes usar ejecutores alojados en {% data variables.product.prodname_dotcom %} y, en su lugar, debes usar ejecutores autoalojados. Para obtener más información, consulta "[Acerca de los ejecutores autoalojados](/actions/hosting-your-own-runners/about-self-hosted-runners)." - -{% endnote %} - -Los ejecutores de Windows y Ubuntu se alojan en Azure y tienen los mismos rangos de direcciones IP que los centros de datos de Azure. Actualmente, todos los ejecutores elojados en {% data variables.product.prodname_dotcom %} de Windows y Ubuntu están en las siguientes regiones de Azure: - -- Este de EE. UU. (`eastus`) -- Este de EE. UU. 2 (`eastus2`) -- Oeste de EE. UU. 2 (`westus2`) -- Centro de EE. UU. (`centralus`) -- Centro sur de EE. UU. (`southcentralus`) - -Microsoft actualiza los rangos de dirección IP de Azure semanalmente en un archivo JSON que puedes descargar desde los rangos de IP de Azure [ y el sitio web de Etiquetas de servicio - Nube pública](https://www.microsoft.com/en-us/download/details.aspx?id=56519). Puedes usar este rango de direcciones IP si requieres una lista de permisos para impedir el acceso no autorizado a tus recursos internos. - -El archivo JSON contiene una matriz denominada `values` (valores). Dentro de esa matriz, puedes encontrar las direcciones IP admitidas en un objeto con un `name` e `Id` de la región de Azure, por ejemplo, `"AzureCloud. eastus2"`. - -Puedes buscar los rangos de direcciones IP compatibles en el objeto `"addressPrefixes"`. Este es un ejemplo condensado del archivo JSON. - -```json -{ - "changeNumber": 84, - "cloud": "Public", - "values": [ - { - "name": "AzureCloud.eastus2", - "id": "AzureCloud.eastus2", - "properties": { - "changeNumber": 33, - "region": "eastus2", - "platform": "Azure", - "systemService": "", - "addressPrefixes": [ - "13.68.0.0/17", - "13.77.64.0/18", - "13.104.147.0/25", - ... - ] - } - } - ] -} -``` - -### Sistemas de archivos en ejecutores alojados en {% data variables.product.prodname_dotcom %} - -{% data variables.product.prodname_dotcom %} ejecuta acciones y comandos de shell en directorios específicos en la máquina virtual. Las rutas de archivo en las máquinas virtuales no son estáticas. Usa las variables de entorno que proporciona {% data variables.product.prodname_dotcom %} para construir rutas de archivo para los directorios `home`, `workspace` y `workflow`. - -| Directorio | Variable de entorno | Descripción | -| --------------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `hogar` | `HOME` | Contiene datos relacionados con el usuario. Por ejemplo, este directorio podría contener las credenciales de un intento de inicio de sesión. | -| `workspace` | `GITHUB_WORKSPACE` | Las acciones y los comandos del shell se ejecutan en este directorio. Una acción puede modificar los contenidos de este directorio, al que pueden tener acceso acciones posteriores. | -| `workflow/event.json` | `GITHUB_EVENT_PATH` | La carga `POST` del evento de webhook que activó el flujo de trabajo. {% data variables.product.prodname_dotcom %} reescribe esto cada vez que se ejecuta una acción para aislar el contenido del archivo entre acciones. | - -Para obtener una lista de las variables de entorno que crea {% data variables.product.prodname_dotcom %} para cada flujo de trabajo, consulta "[Usar variables de entorno](/github/automating-your-workflow-with-github-actions/using-environment-variables)". - -#### Sistema de archivos del contenedor de Docker - -Las acciones que se ejecutan en contenedores Docker tienen directorios estáticos en la ruta `/github`. Sin embargo, te recomendamos encarecidamente que uses las variables de entorno predeterminadas para construir rutas de archivos en contenedores de Docker. - -{% data variables.product.prodname_dotcom %} se reserva el prefijo de ruta `/github` y crea tres directorios para acciones. - -- `/github/home` -- `/github/workspace` - {% data reusables.repositories.action-root-user-required %} -- `/github/workflow` - -{% if currentVersion == "free-pro-team@latest" %} - -### Leer más -- "[Administrar la facturación para {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)" - -{% endif %} diff --git a/translations/es-XL/content/admin/articles/README.md b/translations/es-XL/content/admin/articles/README.md deleted file mode 100644 index d0a577435287..000000000000 --- a/translations/es-XL/content/admin/articles/README.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -redirect_from: - - /enterprise/admin/articles/README - - /enterprise/admin/articles/README ---- -# Hidden Enterprise Admin articles - -Enterprise Admin articles that have `hidden: true` frontmatter live in this directory. - -See [`content/README`](../../README.md#hidden-pages) for more about hidden pages. diff --git a/translations/es-XL/content/admin/articles/configuring-unified-contributions-between-github-enterprise-and-githubcom.md b/translations/es-XL/content/admin/articles/configuring-unified-contributions-between-github-enterprise-and-githubcom.md deleted file mode 100644 index 6242d854d846..000000000000 --- a/translations/es-XL/content/admin/articles/configuring-unified-contributions-between-github-enterprise-and-githubcom.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: Configurar contribuciones unificadas entre GitHub Enterprise y GitHub.com -intro: 'Como administrador del sitio, si tienes habilitado {% data variables.product.prodname_github_connect %}, puedes permitir que los usuarios finales vean los recuentos de contribuciones anónimas para su trabajo desde {% data variables.product.prodname_enterprise %} en su gráfico de contribución de {% data variables.product.prodname_dotcom_the_website %}.' -hidden: true -redirect_from: - - /enterprise/admin/articles/configuring-unified-contributions-between-github-enterprise-and-github-com - - /enterprise/admin/articles/configuring-unified-contributions-between-github-enterprise-and-githubcom -versions: - enterprise-server: '*' ---- - - -Después de habilitar {% data variables.product.prodname_github_connect %} y de habilitar {% data variables.product.prodname_unified_contributions %} en ambos entornos, los usuarios finales en tu instancia pueden conectarse con sus cuentas de {% data variables.product.prodname_dotcom_the_website %} y enviar los recuentos de contribución de {% data variables.product.prodname_enterprise %} a {% data variables.product.prodname_dotcom_the_website %}. Para obtener más información, consulta "[Habilitar {% data variables.product.prodname_unified_contributions %} entre {% data variables.product.prodname_enterprise %} y {% data variables.product.prodname_dotcom_the_website %}](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/enabling-unified-contributions-between-github-enterprise-server-and-github-com)" y "[Enviar tus contribuciones de {% data variables.product.prodname_ghe_server %} a tu perfil {% data variables.product.prodname_dotcom_the_website %}](/articles/sending-your-github-enterprise-server-contributions-to-your-github-com-profile/)." - -Si el administrador del sitio inhabilita la funcionalidad o los programadores salen de la conexión, los recuentos de contribución de {% data variables.product.prodname_enterprise %} se eliminarán en {% data variables.product.prodname_dotcom_the_website %}. Si el programador vuelve a conectar sus perfiles luego de inhabilitarlos, se restablecerán los recuentos de contribución para los últimos 90 días. - -1. En el shell administrativo, habilita la configuración de {% data variables.product.prodname_unified_contributions %} en {% data variables.product.product_location_enterprise %}: - ```shell - $ ghe-config 'app.github.dotcom-contributions-configurable' 'true' - $ ghe-config-apply - ``` -2. Vuelve a {% data variables.product.prodname_enterprise %}. -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.business-settings %} -{% data reusables.enterprise-accounts.github-connect-tab %} -7. En "Los usuarios pueden compartir recuentos de contribuciones {% data variables.product.prodname_dotcom_the_website %}", utiliza el menú desplegable y haz clic en **Enabled** (Habilitado). -8. Posteriormente, serás redirigido a {% data variables.product.prodname_dotcom_the_website %}, para escribir recuentos de contribuciones para las cuentas de usuarios conectados, debes actualizar {% data variables.product.prodname_enterprise %}. Un administrador de la organización para la organización {% data variables.product.prodname_dotcom_the_website %} conectada debe aprobar la actualización de {% data variables.product.prodname_github_app %} con permisos de `external_contributions`. - diff --git a/translations/es-XL/content/admin/articles/including-github-enterprise-contributions-in-your-githubcom-profile.md b/translations/es-XL/content/admin/articles/including-github-enterprise-contributions-in-your-githubcom-profile.md deleted file mode 100644 index d684270a7ad3..000000000000 --- a/translations/es-XL/content/admin/articles/including-github-enterprise-contributions-in-your-githubcom-profile.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: Incluir contribuciones de GitHub Enterprise en tu perfil GitHub.com -redirect_from: - - /enterprise/admin/articles/including-github-enterprise-contributions-in-your-github-com-profile - - /enterprise/admin/articles/including-github-enterprise-contributions-in-your-githubcom-profile -intro: 'Puedes conectar {% data variables.product.product_location_enterprise %} a {% data variables.product.prodname_dotcom_the_website %} y habilitar a los usuarios finales para que envíen contribuciones de {% data variables.product.product_location_enterprise %} a sus perfiles {% data variables.product.prodname_dotcom_the_website %} como parte de un Programa de acceso temprano.' -hidden: true -versions: - enterprise-server: '*' ---- - -Incluir contribuciones de {% data variables.product.prodname_enterprise %} en tu perfil {% data variables.product.prodname_dotcom_the_website %} es parte de un Programa de acceso temprano cerrado para {% data variables.product.prodname_enterprise %} 2.14. Para obtener más información, consulta "[Incluir {% data variables.product.prodname_enterprise %} contribuciones en tu perfil {% data variables.product.prodname_dotcom_the_website %}](/enterprise/2.14/admin/hidden/including-github-enterprise-contributions-in-your-github-com-profile/)". diff --git a/translations/es-XL/content/admin/articles/using-github-task-runner.md b/translations/es-XL/content/admin/articles/using-github-task-runner.md deleted file mode 100644 index f53d3fa721c3..000000000000 --- a/translations/es-XL/content/admin/articles/using-github-task-runner.md +++ /dev/null @@ -1,111 +0,0 @@ ---- -title: Uso del ejecutor de tareas de GitHub -intro: 'Puedes usar el ejecutor de tareas de {% data variables.product.prodname_dotcom %} como tu sistema integrado CI/CD como parte del Programa de acceso temprano cerrado. El ejecutor de tareas de {% data variables.product.product_name %} te permite desarrollar, probar e implementar automáticamente tu código desde un {% data variables.product.prodname_github_app %}, de acuerdo con un archivo de configuración en tu repositorio.' -hidden: true -redirect_from: - - /enterprise/admin/articles/using-github-task-runner -versions: - enterprise-server: '*' ---- - - -{% note %} - -**Nota:** Antes de solicitar el acceso al ejecutor de tareas de {% data variables.product.prodname_dotcom %}, debes leer y aceptar nuestro Descargo de Programa de acceso temprano y Limitación de responsabilidad en `ENLACE DE ACCESO RÁPIDO` para {% data variables.product.product_location_enterprise %}. Esta documentación está cubierta por esos términos. - -{% endnote %} - -### En esta guía -- [Acerca del ejecutor de tareas de {% data variables.product.prodname_dotcom %}](#about-github-task-runner) -- [Descarga el ejecutor de tareas binario de {% data variables.product.prodname_dotcom %}](#downloading-the-github-task-runner-binary) -- [Crear el ejecutor de tareas de {% data variables.product.prodname_dotcom %} {% data variables.product.prodname_github_app %} en tu aparato](#creating-the-github-task-runner-github-app-on-your-appliance) -- [Instalar la app del ejecutor de tareas de {% data variables.product.prodname_dotcom %}](#installing-the-github-task-runner-app) -- [Ejecutar tareas para un proyecto](#running-tasks-for-a-project) - -### Acerca del ejecutor de tareas de {% data variables.product.prodname_dotcom %} - -El ejecutor de tareas de {% data variables.product.product_name %} es responsable de ejecutar las tareas que el Despachador puso en cola, un servicio separado que maneja eventos de subida webhook y tareas puestas en cola. - -Si bien el Despachador viene con {% data variables.product.product_location_enterprise %}, debes instalar el ejecutor de tareas de {% data variables.product.product_name %} manualmente en tu aparato. Para configurar el ejecutor de tareas de {% data variables.product.product_name %}, debes descargar el ejecutor binario, crear un {% data variables.product.prodname_github_app %} en tu aparato y configurar un servidor para que interactúe con el Despachador. - -### Descarga el ejecutor de tareas binario de {% data variables.product.prodname_dotcom %} - -Debes descargar el archivo binario de la aplicación del ejecutor de tareas de {% data variables.product.product_name %} en {% data variables.product.product_location_enterprise %}. Para descargar el archivo binario para la plataforma que elijas, visita `https://HOSTNAME/_dispatcher/downloads/`, reemplazando el `nombre del host` con {% data variables.product.product_location_enterprise %} el nombre de host o la dirección IP: - -Usa el comando `chmod` para cambiar los permisos para usar el ejecutor de tareas de {% data variables.product.product_name %} en la línea de comandos. - -{% mac %} - -```shell -$ chmod +x task-runner_darwin_amd64 -``` - -{% endmac %} - -{% windows %} - -```shell -$ move task-runner_windows_amd64 task-runner_windows_amd64.exe -``` - -{% endwindows %} - -{% linux %} - -```shell -$ chmod +x task-runner_linux_amd64 -``` - -{% endlinux %} - -### Crear el ejecutor de tareas de {% data variables.product.prodname_dotcom %} {% data variables.product.prodname_github_app %} en tu aparato - -1. Crea el archivo de configuración `.task-runner.yaml` en tu directorio actual. Puedes usar el marcador `--config` para mover el archivo a un directorio diferente. - -```shell -task-runner setup -``` - -2. Introduce el nombre de host de {% data variables.product.product_location_enterprise %}. -3. Escribe un token de acceso personal, configurado con permisos especializados. Para obtener más información, consulta [Crear un token de acceso personal para la línea de comando](/articles/creating-a-personal-access-token-for-the-command-line/). Puedes usar los permisos del `usuario` si estás creando el {% data variables.product.prodname_github_app %} para tu cuenta, o `admin:org` si estás creando el {% data variables.product.prodname_github_app %} para una organización. -4. Escribe el nombre para {% data variables.product.prodname_github_app %}, por ejemplo, `ejecutor de tareas de Octocat`. -5. Si estás creando un {% data variables.product.prodname_github_app %} para una organización, escribe el nombre de la organización. -6. Inicia el ejecutor de tareas. - -```shell -task-runner start -``` - -### Instalar la app del ejecutor de tareas de {% data variables.product.prodname_dotcom %} - -1. En el ángulo superior derecho de cualquier página, haz clic en tu foto de perfil, y luego haz clic en Settings (Parámetros). ![Icono Settings (Parámetros) en la barra de usuario](/assets/images/help/images/userbar-account-settings.png) -2. En la barra lateral izquierda, haz clic en **Developer settings** (Parámetros del desarrollador). ![Sección Developer settings (Parámetros del programador)](/assets/images/help/images/developer_settings.png) -3. En la barra lateral izquierda, haz clic en ****{% data variables.product.prodname_dotcom %} Apps**. ![Sección GitHub Apps](/assets/images/help/images/github_apps.png) -4 Haz clic en la app que deseas instalar. -5 En la barra lateral izquierda, haz clic en **Public page** (Página pública). ![Sección Public page (Página pública)](/assets/images/help/images/public-page-tab.png) -6 Haz clic en **Install** (Instalar). ![Botón Install (Instalar) en la página pública de la app de GitHub](/assets/images/help/images/install-runner-public-page.png) -7 Selecciona **Only select repositories** (Solo seleccionar repositorios) y escribe los nombres de los repositorios donde seas instalar el ejecutor de tareas de {% data variables.product.prodname_dotcom %}. ![Seleccionar repositorios para instalar en](/assets/images/help/images/repositories-install-task-runner.png) -8 Haz clic en **Install** (Instalar). ![Botón Install (Instalar) en la página de instalación de la app de GitHub](/assets/images/help/images/install-runner-installation-page.png) -9 Desplázate hasta el repositorio donde instalaste la app. -10 -Crea un archivo `github/tasks.gf`, similar a: - - ``` -task "my task" { -command = "command-to-run" -runnerType = "Shell" -env = { - FOO="bar", - BAR="baz" -} -} - ``` -12 -Abre una solicitud de extracción para agregar el archivo a tu repositorio. -13 Sube los cambios para ver cómo se ejecutan las tareas de CI. - -### Ejecutar tareas para un proyecto - -Una vez que has creado la solicitud de extracción, tu {% data variables.product.prodname_github_app %} subirá el evento al Despachador, donde se coloca la tarea en cola y se envía al ejecutor de tareas de {% data variables.product.prodname_dotcom %}. Una vez que el ejecutor de tareas de {% data variables.product.prodname_dotcom %}{% data variables.product.prodname_dotcom %} recibe y ejecuta las tareas, luego le envía el informe al Despachador, que actualizará las solicitudes de extracción con los resultados. - -![Resultados de la prueba de CI de la solicitud de extracción](/assets/images/help/images/task-results.png) diff --git a/translations/es-XL/content/admin/clustering/about-cluster-nodes.md b/translations/es-XL/content/admin/clustering/about-cluster-nodes.md deleted file mode 100644 index f5e7524c6408..000000000000 --- a/translations/es-XL/content/admin/clustering/about-cluster-nodes.md +++ /dev/null @@ -1,69 +0,0 @@ ---- -title: Acerca de los nodos de agrupación -intro: 'Los "nodos" son instancias de {% data variables.product.prodname_ghe_server %} que operan en una agrupación. Cada nodo ejecuta un conjunto de servicios que se suministra a la agrupación y; por último, a los usuarios.' -redirect_from: - - /enterprise/admin/clustering/about-cluster-nodes -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_clustering.clustering-requires-https %} - -### Recomendaciones mínimas de hardware -Cada nodo debe tener un volumen raíz, así como un volumen de datos separado. Estas son las recomendaciones mínimas. Es posible que se requieran más recursos según su uso, como la actividad del usuario y las integraciones seleccionadas. - -| Servicios | Mínimo de memoria requerida | Mínimo de espacio libre de volumen de datos requerido | -|:----------------------------------------------------------------------------:|:---------------------------:|:-----------------------------------------------------:| -| `job-server`,
    `memcache-server`,
    `web-server` | 14 GB | 1 GB | -| `consul-server`,
    `mysql-server`,
    `redis-server` | 14 GB | 10 GB | -| `git-server`,
    `metrics-server`,
    `pages-server`,
    `storage-server` | 7 GB | 10 GB | -| `elasticsearch-server` | 14 GB | 10 GB | - -### Servicios requeridos para agrupamiento -Para una redundancia adecuada, usa estos nodos mínimos para poner en funcionamiento cada servicio. - -{% tip %} - -**Nota:** Las necesidades de escalabilidad de tu organización dependerán de muchos factores, entre los que se incluyen el tamaño y la cantidad de repositorios, la cantidad de usuarios y la utilización general. - -{% endtip %} - -| Servicios | Mínimo de nodos requeridos | -|:---------------------------------------------------------------------------:|:--------------------------:| -| `job-server`,
    `memcache-server`,
    `metrics-server`,
    `web-server` | 2 | -| `mysql-server`,
    `redis-server` | 2 | -| `consul-server` | 3 | -| `git-server`,
    `pages-server`,
    `storage-server` | 3 | -| `elasticsearch-server` | 3 | - -### Recomendaciones de diseño de agrupación - -La agrupación permite que los servicios que constituyen {% data variables.product.prodname_ghe_server %} experimenten un aumento gradual independientemente de los demás. Esta flexibilidad puede usarse para diseñar e implementar una agrupación que se adapta a las organizaciones con diferentes requisitos de escalabilidad. Por ejemplo, es posible que algunas organizaciones necesiten una mayor capacidad de almacenamiento para extracciones frecuentes o de gran tamaño, pero el uso del servidor web puede ser relativamente bajo. Otra organización puede tener un buen rendimiento con menos recursos de almacenamiento, pero se necesitan más nodos que ejecuten `pages-server` or `elasticsearch-server`. Hay muchas combinaciones diferentes posibles. Trabaja con tu representante de cuenta para determinar la mejor configuración de agrupación para tus necesidades específicas. - -- Esparcir nodos redundantes por todo el hardware independiente. Si compartes su CPU, memoria o dispositivos de almacenamiento, reducirás el rendimiento e introducirás puntos de falla únicos. Los componentes de trabajo en red compartidos también pueden reducir la capacidad y aumentar el riesgo de pérdida de conectividad en caso de una interrupción. -- Uso de almacenamiento rápido. Por lo general, las redes del área de almacenamiento (SAN, por sus siglas en inglés) se optimizan para obtener una máxima utilización de espacio, disponibilidad y tolerancia a fallas, y no un rendimiento absoluto. La agrupación de {% data variables.product.prodname_ghe_server %} brinda redundancia y disponibilidad, y ofrecerá un mejor rendimiento en el almacenamiento más rápido disponible. Se recomienda el almacenamiento SSD local. -- Establecer niveles de nodos que tengan sentido para tu organización. Un ejemplo de configuración: - - Nivel de cara al usuario con dos nodos y los siguientes servicios: - - `web-server` - - `jobs-server` - - `memcache-server` - - Nivel de base de datos con tres nodos y los siguientes servicios: - - `consul-server` - - `mysql-server` - - `redis-server` - - Nivel de búsqueda con tres nodos y el siguiente servicio: - - `elasticsearch-server` - - Nivel de almacenamiento con tres nodos y los siguientes servicios: - - `git-server` - - `pages-server` - - `storage-server` - - `metrics-server` - -#### Ejemplo del diagrama de agrupación -{% note %} - -**Nota: Este es solo un ejemplo.** El diseño de agrupamiento óptimo de tu organización dependerá de tus necesidades exclusivas. Habla con tu representante dedicado o con {% data variables.contact.contact_enterprise_sales %} para que te podamos ayudar a determinar la mejor configuración del clúster. - -{% endnote %} - -Ejemplo de agrupamiento diff --git a/translations/es-XL/content/admin/clustering/about-clustering.md b/translations/es-XL/content/admin/clustering/about-clustering.md deleted file mode 100644 index 4ca75d64277d..000000000000 --- a/translations/es-XL/content/admin/clustering/about-clustering.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Acerca de las agrupaciones -intro: 'La agrupación {% data variables.product.prodname_ghe_server %} permite que los servicios que la componen {% data variables.product.prodname_ghe_server %} sean escalados a múltiples nodos.' -redirect_from: - - /enterprise/admin/clustering/clustering-overview/ - - /enterprise/admin/clustering/about-clustering -versions: - enterprise-server: '*' ---- - -### Arquitectura de agrupación - -{% data variables.product.prodname_ghe_server %} está compuesto por un conjunto de servicios. En una agrupación, estos servicios se ejecutan en múltiples nodos y las solicitudes son un balanceador de carga entre ellos. Los cambios se almacenan automáticamente con copias redundantes en nodos separados. La mayoría de los servicios son pares iguales con otras instancias del mismo servicio. Las excepciones a esto son los servicios `mysql-server` and `redis-server`. Estos operan con un solo nodo _principal_ o más nodos _réplica_. - -Obtén más información sobre los servicios about [ requeridos para agrupación](/enterprise/{{ currentVersion }}/admin/guides/clustering/about-cluster-nodes#services-required-for-clustering). - -### ¿Es adecuada la agrupación para mi organización? - -{% data reusables.enterprise_clustering.clustering-scalability %} Sin embargo, la configuración de un agrupación redundante y escalable puede ser compleja y requiere de una planificación cuidadosa. Se deberá planificar esta complejidad adicional para situaciones durante la instalación, situaciones de recuperación ante desastre y actualizaciones. - -{% data variables.product.prodname_ghe_server %} requiere una baja latencia entre los nodos y no está hecho para redundancia en todas las ubicaciones geográficas. - -La agrupación brinda redundancia, pero no pretende reemplazar una configuración de Alta disponibilidad. Para obtener más información, consulta [Configuración de alta disponibilidad](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-github-enterprise-server-for-high-availability). Una configuración de conmutación primaria/secundaria es mucho más simple que la agrupación y permitirá satisfacer las necesidades de muchas organizaciones. Para obtener más información, consulta [Diferencias entre agrupación y alta disponibilidad](/enterprise/{{ currentVersion }}/admin/guides/clustering/differences-between-clustering-and-high-availability-ha/). - -### ¿Cómo obtengo acceso a la agrupación? - -La agrupación está diseñada para situaciones de escalada específica y no pretende ser usada para cada organización. Si te gustaría considerar la agrupación, por favor contacta a tu representante dedicado o a {% data variables.contact.contact_enterprise_sales %}. diff --git a/translations/es-XL/content/admin/clustering/cluster-network-configuration.md b/translations/es-XL/content/admin/clustering/cluster-network-configuration.md deleted file mode 100644 index c8d287520c7e..000000000000 --- a/translations/es-XL/content/admin/clustering/cluster-network-configuration.md +++ /dev/null @@ -1,122 +0,0 @@ ---- -title: Configuración de la red de agrupaciones -intro: 'La agrupación de {% data variables.product.prodname_ghe_server %} se basa en la resolución de nombre de DNS pertinente, balanceo de carga y comunicación entre los nodos para operar de manera adecuada.' -redirect_from: - - /enterprise/admin/clustering/network-configuration - - /enterprise/admin/clustering/cluster-network-configuration -versions: - enterprise-server: '*' ---- - -### Consideraciones de red - -El diseño de red más simple para una agrupación es colocar los nodos en una LAN única. Si una agrupación redundante debe abarcar varias subredes, las rutas apropiadas deben estar disponibles entre las subredes y la latencia debería ser menor que 1ms. - -#### Puertos de la aplicación para usuarios finales - -Los puertos de la aplicación permiten que los usuarios finales accedan a Git y a la aplicación web. - -| Puerto | Descripción | Cifrado | -|:-------- |:------------------------------------------------------------------- |:---------------------------------------------------------------- | -| 22/TCP | Git sobre SSH | Sí | -| 25/TCP | SMTP | Requiere STARTTLS | -| 80/TCP | HTTP | No
    (Cuando SSL está habilitado, este puerto redirige a HTTPS) | -| 443/TCP | HTTPS | Sí | -| 9418/TCP | Puerto de protocolo de Git simple
    (Inhabilitado en modo privado) | No | - -#### Puertos administrativos - -No se requieren puertos administrativos para el uso de la aplicación base por parte de los usuarios finales. - -| Puerto | Descripción | Cifrado | -|:-------- |:--------------------------- |:---------------------------------------------------------------- | -| ICMP | Ping de ICMP | No | -| 122/TCP | SSH administrativo | Sí | -| 161/UDP | SNMP | No | -| 8080/TCP | Consola de gestión HTTP | No
    (Cuando SSL está habilitado, este puerto redirige a HTTPS) | -| 8443/TCP | Consola de gestión de HTTPS | Sí | - -#### Puertos de comunicación de agrupación - -Si un cortafuego de nivel de red se coloca entre los nodos estos puertos deberán estar accesibles. La comunicación entre los nodos no está cifrada. Estos puertos no deberían estar accesibles externamente. - -| Puerto | Descripción | -|:--------- |:------------------------------------- | -| 1336/TCP | API interna | -| 3033/TCP | Acceso SVN interno | -| 3037/TCP | Acceso SVN interno | -| 3306/TCP | MySQL | -| 4486/TCP | Acceso del gobernador | -| 5115/TCP | Respaldo de almacenamiento | -| 5208/TCP | Acceso SVN interno | -| 6379/TCP | Redis | -| 8001/TCP | Grafana | -| 8090/TCP | Acceso a GPG interno | -| 8149/TCP | Acceso al servidor de archivos GitRPC | -| 8300/TCP | Consul | -| 8301/TCP | Consul | -| 8302/TCP | Consul | -| 9000/TCP | Git Daemon | -| 9102/TCP | Servidor de archivos de páginas | -| 9105/TCP | Servidor LFS | -| 9200/TCP | ElasticSearch | -| 9203/TCP | Servicio de código semántico | -| 9300/TCP | ElasticSearch | -| 11211/TCP | Memcache | -| 161/UDP | SNMP | -| 8125/UDP | Statsd | -| 8301/UDP | Consul | -| 8302/UDP | Consul | -| 25827/UDP | Collectd | - - -### Configurar un balanceador de carga - - Recomendamos un balanceador de carga externo basado en TCP que respalde el protocolo PROXY para distribuir el tráfico a través de los nodos. Considera estas configuraciones del balanceador de carga: - - - Los puertos TCP (que se muestra a continuación) deberán ser reenviados a los nodos que ejecutan el servicio `web-server`. Estos son los únicos nodos que sirven a las solicitudes de clientes externos. - - Las sesiones pegajosas no deberían habilitarse. - -{% data reusables.enterprise_installation.terminating-tls %} - -### Manejar información de conexión de clientes - -Dado que las conexiones de clientes con el agrupamiento provienen del balanceador de carga, no se puede perder la dirección IP de cliente. Para capturar adecuadamente la información de la conexión de clientes, se requiere una consideración adicional. - -{% data reusables.enterprise_clustering.proxy_preference %} - -{% data reusables.enterprise_clustering.proxy_xff_firewall_warning %} - -#### Habilitar el soporte PROXY en {% data variables.product.prodname_ghe_server %} - -Recomendamos firmemente habilitar el soporte PROXY para tu instancia y el balanceador de carga. - - - Para tu instancia, usa este comando: - ```shell - $ ghe-config 'loadbalancer.proxy-protocol' 'true' && ghe-cluster-config-apply - ``` - - Para el balanceador de carga, usa las instrucciones proporcionadas por tu proveedor. - - {% data reusables.enterprise_clustering.proxy_protocol_ports %} - -#### Habilitar el soporte X-Forwarded-For en {% data variables.product.prodname_ghe_server %} - -{% data reusables.enterprise_clustering.x-forwarded-for %} - -Para habilitar el encabezado `X-Fowarded-For`, usa este comando: - -```shell -$ ghe-config 'loadbalancer.http-forward' 'true' && ghe-cluster-config-apply -``` - -{% data reusables.enterprise_clustering.without_proxy_protocol_ports %} - -#### Configurar revisiones de estado -Las comprobaciones de estado permiten que un balanceador de carga deje de enviar tráfico a un nodo que no responde si una comprobación preconfigurada falla en ese nodo. Si un nodo de agrupación falla, las revisiones de estado emparejadas con nodos redundantes brindan alta disponibilidad. - -{% data reusables.enterprise_clustering.health_checks %} -{% data reusables.enterprise_site_admin_settings.maintenance-mode-status %} - -### Requisitos de DNS - -{% data reusables.enterprise_clustering.load_balancer_dns %} diff --git a/translations/es-XL/content/admin/clustering/differences-between-clustering-and-high-availability-ha.md b/translations/es-XL/content/admin/clustering/differences-between-clustering-and-high-availability-ha.md deleted file mode 100644 index 53365bc14de3..000000000000 --- a/translations/es-XL/content/admin/clustering/differences-between-clustering-and-high-availability-ha.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Diferencias entre Agrupamiento y Alta disponibilidad (HA) -intro: '{% data variables.product.prodname_ghe_server %} La configuración de alta disponibilidad es una configuración de conmutación primaria/secundaria que brinda redundancia mientras que el agrupamiento brinda redundancia y escalabilidad al distribuir cargas de lectura y escritura entre múltiples nodos.' -redirect_from: - - /enterprise/admin/clustering/differences-between-clustering-and-high-availability-ha -versions: - enterprise-server: '*' ---- - -### Escenarios de fallas - -Tanto la alta disponibilidad (HA, por sus siglas en inglés) como el agrupamiento brindan redundancia al eliminar el nodo único como punto de falla. Pueden brindar disponibilidad en estos escenarios: - -{% data reusables.enterprise_installation.ha-and-clustering-failure-scenarios %} - -### Escalabilidad - -{% data reusables.enterprise_clustering.clustering-scalability %} En HA, la escala de este aparato depende exclusivamente del nodo principal y la cara no se distribuye al servidor de réplica. - -### Diferencias en el método de conmutación y configuración - -| Característica | Configuración de conmutación | Método de conmutación | -|:------------------------------------ |:--------------------------------------------------------------------------------------- |:---------------------------------------------------------------------------------------------------------------------------- | -| Configuración de alta disponibilidad | Registro de DNS con un TTL bajo que apunta al aparato principal o balanceador de carga. | Debes impulsar manualmente el aparato de réplica en las configuraciones de conmutación DNS y balanceador de carga. | -| Agrupación | El registro DNS debe apuntar a un balanceador de carga. | Si falla un nodo detrás de un balanceador de carga, el tráfico se envía automáticamente a los otros nodos de funcionamiento. | - -### Copias de seguridad y recuperación ante desastres - -HA y Clustering no deben ser considerados como un reemplazo para copias de seguridad regulares. Para obtener más información, consulta "[Configurar copias de seguridad en tu aparato](/enterprise/admin/guides/installation/configuring-backups-on-your-appliance)" - -### Supervisar - -Las características de disponibilidad, especialmente las que tienen conmutación automática como Agrupación, pueden enmascarar una falla dado que el servicio generalmente no se ve interrumpido cuando algo falla. Ya sea que esté usando HA o Agrupación, supervisar el estado de cada instancia es importante para que puedas estar al tanto cuando se produce una falla. Para obtener más información sobre la supervisión, consulta " -[Umbrales de alerta recomendados](/enterprise/{{ currentVersion }}/admin/guides/installation/recommended-alert-thresholds/)" y [Supervisar nodos de agrupación](/enterprise/{{ currentVersion}}/admin/guides/clustering/monitoring-cluster-nodes/)".

    - - - -### Leer más - -- Para obtener más información acerca del {% data variables.product.prodname_ghe_server %} Agrupamiento, visite la sección de "[Acerca del agrupamiento](/enterprise/{{ currentVersion}}/admin/guides/clustering/about-clustering/)." -- Para obtener más información sobre HA, consulta "[Configurar {% data variables.product.prodname_ghe_server %} para alta disponibilidad](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-github-enterprise-server-for-high-availability/)". diff --git a/translations/es-XL/content/admin/clustering/evacuating-a-cluster-node.md b/translations/es-XL/content/admin/clustering/evacuating-a-cluster-node.md deleted file mode 100644 index 4a5db7d9480d..000000000000 --- a/translations/es-XL/content/admin/clustering/evacuating-a-cluster-node.md +++ /dev/null @@ -1,52 +0,0 @@ ---- -title: Evacuar un nodo de agrupación -intro: Puedes evacuar los servicios de datos en un nodo de agrupación. -redirect_from: - - /enterprise/admin/clustering/evacuating-a-cluster-node -versions: - enterprise-server: '*' ---- - -Si solo tienes tres nodos en tu agrupación de servicios de datos, no puedes evacuar los nodos, porque `ghe-spokes` no tiene otro lugar para realizar una copia. Si tienes cuatro o más, `ghe-spokes` moverá todos los repositorios del nodo evacuado. - -Si colocas fuera de línea un nodo que tiene otros servicios de datos (como git, páginas o almacenamiento), debes evacuar cada nodo antes de ponerlo fuera de línea. - -1. Encuentra la `uuid` del nodo con el comando `ghe-config`. - - ``` - $ ghe-config cluster._hostname_.uuid - ``` - -2. Deberás supervisar el estado de tu nodo mientras se copian los datos. Idealmente, el nodo no debería estar fuera de línea hasta que se complete la copia. Para supervisar el estado de tu nodo, ejecuta alguno de los siguientes comandos: - - Para Git - ``` - ghe-spokes evac-status - ``` - Para {% data variables.product.prodname_pages %} - ``` - echo "select count(*) from pages_replicas where host = 'pages-server-'" | ghe-dbconsole -y - ``` - Para almacenamiento - ``` - ghe-storage evacuation-status - ``` - -3. Una vez que la copia esté completa, puedes evacuar el servicio de almacenamiento. Ejecuta alguno de los siguientes comandos: - - Para Git - ``` - ghe-spokes server evacuate git-server- - ``` - Para {% data variables.product.prodname_pages %} - ``` - ghe-dpages evacuate pages-server- - ``` - Para almacenamiento, coloca el nodo fuera de línea - ``` - ghe-storage offline storage-server- - ``` - luego evacúa - ``` - ghe-storage evacuate storage-server- - ``` diff --git a/translations/es-XL/content/admin/clustering/index.md b/translations/es-XL/content/admin/clustering/index.md deleted file mode 100644 index 7c42bd63cadc..000000000000 --- a/translations/es-XL/content/admin/clustering/index.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Configurar y administrar una agrupación para GitHub Enterprise Server -shortTitle: Agrupación -intro: 'En esta guía, se describe el trabajo con el representante de cuenta para determinar si la agrupación de {% data variables.product.prodname_enterprise %} es una buena solución para tu organización, además de la configuración de una agrupación.' -redirect_from: - - /enterprise/admin/clustering -versions: - enterprise-server: '*' ---- - -### Índice - -{% topic_link_in_list /overview %} - {% link_in_list /about-clustering %} - {% link_in_list /differences-between-clustering-and-high-availability-ha %} -{% topic_link_in_list /setting-up-the-cluster-instances %} - {% link_in_list /about-cluster-nodes %} - {% link_in_list /cluster-network-configuration %} - {% link_in_list /initializing-the-cluster %} -{% topic_link_in_list /managing-a-github-enterprise-server-cluster %} - {% link_in_list /upgrading-a-cluster %} - {% link_in_list /replacing-a-cluster-node %} - {% link_in_list /evacuating-a-cluster-node %} - {% link_in_list /monitoring-cluster-nodes %} diff --git a/translations/es-XL/content/admin/clustering/initializing-the-cluster.md b/translations/es-XL/content/admin/clustering/initializing-the-cluster.md deleted file mode 100644 index 16475e2c0ca7..000000000000 --- a/translations/es-XL/content/admin/clustering/initializing-the-cluster.md +++ /dev/null @@ -1,113 +0,0 @@ ---- -title: Inicializar la agrupación -intro: 'Una agrupación de {% data variables.product.prodname_ghe_server %} se debe configurar con una licencia y se debe inicializar mediante un shell administrativo (SSH).' -redirect_from: - - /enterprise/admin/clustering/initializing-the-cluster -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_clustering.clustering-requires-https %} - -### Instalar {% data variables.product.prodname_ghe_server %} - -1. En cada nodo de agrupación, suministra e instala {% data variables.product.prodname_ghe_server %}. Para obtener más información, consulta "[Configurar una instancia {% data variables.product.prodname_ghe_server %} ](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-github-enterprise-server-instance)." -2. Mediante el shell administrativo o DHCP, configura **solo** la dirección IP de cada nodo. No configures los otros parámetros. - -### Configurar el primer nodo - -1. Realiza una conexión con el nodo que será designado como `mysqu.-master` en `clussster.conf`. Para obtener más información, consulta "[Acerca del archivo de configuración de agrupación](/enterprise/{{ currentVersion }}/admin/guides/clustering/initializing-the-cluster/#about-the-cluster-configuration-file)." -2. En tu navegador web, visita `https://:8443/setup/`. -{% data reusables.enterprise_installation.upload-a-license-file %} -{% data reusables.enterprise_installation.save-settings-in-web-based-mgmt-console %} -{% data reusables.enterprise_installation.instance-will-restart-automatically %} - -### Inicializar la agrupación - -Para inicializar la agrupación, necesitas un archivo de configuración de agrupación (`cluster.conf`). Para obtener más información, consulta "[Acerca del archivo de configuración de agrupación](/enterprise/{{ currentVersion }}/admin/guides/clustering/initializing-the-cluster/#about-the-cluster-configuration-file)". - -1. Desde el primer nodo que se configuró, ejecuta `ghe-cluster-config. init`. De esta manera, se inicializará la agrupación si existen nodos en el archivo de configuración de la agrupación que no están configurados. -2. Ejecuta `ghe-cluster-config-apply`. Esto validará el archivo `cluster.conf`, aplicará la configuración a cada archivo del nodo y traerá los servicios configurados en cada nodo. - -Para comprobar el estado de una agrupación en funcionamiento, usa el comando `ghe-cluster-status`. - -### Acerca del archivo de configuración de la agrupación - -El archivo de configuración de la agrupación (`cluster.conf`) define los nodos en la agrupación, y los servicios que ejecutan. Para obtener más información, consulta "[Acerca de los nodos de agrupación](/enterprise/{{ currentVersion }}/admin/guides/clustering/about-cluster-nodes)". - -Este ejemplo `cluster.conf` define una agrupación con cinco nodos. - - - Dos nodos (llamados `ghe-app-node-\*`) ejecutan los servicios `web-server` y `job-server` responsables de atender las solicitudes de los clientes. - - Tres nodos (llamados `ghe-data-node-\*`) ejecutan los servicios responsables del almacenamiento y la recuperación de los datos de {% data variables.product.prodname_ghe_server %}. - -Los nombres de los nodos pueden ser cualquier nombre de host válido que elijas. Los nombres son conjuntos de nombres de host de cada nodo y también se agregarán a `/etc/hosts` en cada nodo, de manera que los nodos puedan ser resolubles localmente entre sí. - -Especifica el primer nodo de agrupación que configuraste como MySQL principal mediante `mysql-server` y `mysql-master`. - -``` -[cluster] - mysql-master = ghe-data-node-1 - redis-master = ghe-data-node-1 - primary-datacenter = default -[cluster "ghe-app-node-1"] - hostname = ghe-app-node-1 - ipv4 = 192.168.0.2 - # ipv6 = fd12:3456:789a:1::2 - web-server = true - job-server = true -[cluster "ghe-app-node-2"] - hostname = ghe-app-node-2 - ipv4 = 192.168.0.3 - # ipv6 = fd12:3456:789a:1::3 - web-server = true - job-server = true -[cluster "ghe-data-node-1"] - hostname = ghe-data-node-1 - ipv4 = 192.168.0.4 - # ipv6 = fd12:3456:789a:1::4 - consul-server = true - consul-datacenter = default - git-server = true - pages-server = true - mysql-server = true - elasticsearch-server = true - redis-server = true - memcache-server = true - metrics-server = true - storage-server = true -[cluster "ghe-data-node-2"] - hostname = ghe-data-node-2 - ipv4 = 192.168.0.5 - # ipv6 = fd12:3456:789a:1::5 - consul-server = true - consul-datacenter = default - git-server = true - pages-server = true - mysql-server = true - elasticsearch-server = true - redis-server = true - memcache-server = true - metrics-server = true - storage-server = true -[cluster "ghe-data-node-3"] - hostname = ghe-data-node-3 - ipv4 = 192.168.0.6 - # ipv6 = fd12:3456:789a:1::6 - consul-server = true - consul-datacenter = default - git-server = true - pages-server = true - mysql-server = true - elasticsearch-server = true - redis-server = true - memcache-server = true - metrics-server = true - storage-server = true -``` - -Crea el archivo `/data/user/common/cluster.conf` en el primer nodo configurado. Por ejemplo, usando `vim`: - - ```shell - ghe-data-node-1:~$ sudo vim /data/user/common/cluster.conf - ``` - diff --git a/translations/es-XL/content/admin/clustering/managing-a-github-enterprise-server-cluster.md b/translations/es-XL/content/admin/clustering/managing-a-github-enterprise-server-cluster.md deleted file mode 100644 index d7fc28269f4f..000000000000 --- a/translations/es-XL/content/admin/clustering/managing-a-github-enterprise-server-cluster.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Gestionar una agrupación de GitHub Enterprise Server -intro: 'Planificar operaciones de mantenimiento para una agrupación de {% data variables.product.prodname_ghe_server %}, como actualizaciones, incorporación de capacidad y reemplazo de nodos fallidos.' -redirect_from: - - /enterprise/admin/guides/clustering/managing-a-github-enterprise-cluster/ - - /enterprise/admin/clustering/managing-a-github-enterprise-server-cluster -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/es-XL/content/admin/clustering/monitoring-cluster-nodes.md b/translations/es-XL/content/admin/clustering/monitoring-cluster-nodes.md deleted file mode 100644 index 6d2e51ef9c23..000000000000 --- a/translations/es-XL/content/admin/clustering/monitoring-cluster-nodes.md +++ /dev/null @@ -1,105 +0,0 @@ ---- -title: Supervisar los nodos de agrupación -intro: 'Una agrupación de {% data variables.product.prodname_ghe_server %} está compuesta por servicios redundantes que se distribuyen entre dos o más nodos. Si un servicio individual o un nodo completo falla, los usuarios de la agrupación no deberían percibirlo inmediatamente. Sin embargo, si el rendimiento y la redundancia se ven afectados, es importante supervisar el estado de una agrupación de {% data variables.product.prodname_ghe_server %}.' -redirect_from: - - /enterprise/admin/clustering/monitoring-cluster-nodes -versions: - enterprise-server: '*' ---- - -### Comprobación manual del estado de la agrupación - -{% data variables.product.prodname_ghe_server %} tiene una utilidad de línea de comando incorporada para supervisar el estado de la agrupación. Desde el shell administrativo, la puesta en funcionamiento de un comando `ghe-cluster-status` ejecuta una serie de revisiones de estado en cada nodo, incluida la verificación de la conectividad y el estado del servicio. La salida muestra todos los resultados de la prueba incluido el texto `ok` o `error`. Por ejemplo, para mostrar solamente las pruebas fallidas, ejecuta: - -```shell -admin@ghe-data-node-0:~$ ghe-cluster-status | grep error -> mysql-replication ghe-data-node-0: error Stopped -> mysql cluster: error -``` -{% note %} - -**Nota:** Si no hay pruebas fallidas, este comando no produce salidas. Esto indica que la agrupación está en buen estado. - -{% endnote %} - -### Supervisar el estado de la agrupación con Natgios - -Puedes configurar [Nagios](https://www.nagios.org/) para supervisar {% data variables.product.prodname_ghe_server %}. Además de supervisar la conectividad básica para cada uno de los nodos de la agrupación, puedes comprobar el estado de la agrupación al configurar Nagios para que use el comando `ghe-cluster-status -n`. Esto devuelve salidas en un formato que Nagios comprende. - -#### Prerrequisitos -* Host Linux que ejecuta Nagios. -* Acceso de red para la agrupación {% data variables.product.prodname_ghe_server %}. - -#### Configurar el host de Nagios -1. Genera una clave SSH con una contraseña en blanco. Nagios usa esto para autenticar la agrupación de {% data variables.product.prodname_ghe_server %}. - ```shell - nagiosuser@nagios:~$ ssh-keygen -t rsa -b 4096 - > Generating public/private rsa key pair. - > Enter file in which to save the key (/home/nagiosuser/.ssh/id_rsa): - > Enter passphrase (empty for no passphrase): leave blank by pressing enter - > Enter same passphrase again: press enter again - > Your identification has been saved in /home/nagiosuser/.ssh/id_rsa. - > Tu clave pública se ha guardado en /home/nagiosuser/.ssh/id_rsa.pub. - ``` - {% danger %} - - **Advertencia de seguridad** Una clave SSH sin una contraseña puede plantear un riesgo de seguridad en caso de que un host tenga autorización de acceso completo. Limita la autorización de esa clave a un comando único de solo lectura. - - {% enddanger %} -2. Copia la clave privada a la carpeta de inicio de (`id_rsa`) to the `nagios` y establece la propiedad correspondiente. - ```shell - nagiosuser@nagios:~$ sudo cp .ssh/id_rsa /var/lib/nagios/.ssh/ - nagiosuser@nagios:~$ sudo chown nagios:nagios /var/lib/nagios/.ssh/id_rsa - ``` - -3. Para autorizar una clave pública a fin de que ejecute el comando *only* the `ghe-cluster-status -n`, usa un prefijo `command=` en el archivo `/data/user/common/authorized_keys`. Desde el shell administrativo en cualquier nodo, modifica este archivo para agregar la clave pública generada en el paso 1. Por ejemplo: `command="/usr/local/bin/ghe-cluster-status -n" ssh-rsa AAAA....` - -4. Valida y copia la configuración e cualquier nodo en la agrupación al ejecutar `ghe-cluster-config-apply` en el nodo donde modificase el archivo `/data/user/common/authorized_keys`. - - ```shell - admin@ghe-data-node-0:~$ ghe-cluster-config-apply - > Validating configuration - > ... - > Configuración de agrupación finalizada - ``` - -5. Para probar que el plugin de Nagios puede ejecutar el comando exitosamente, ejecútalo interactivamente desde el host de Nagios. - ```shell - nagiosuser@nagios:~$ /usr/lib/nagios/plugins/check_by_ssh -l admin -p 122 -H hostname -C "ghe-cluster-status -n" -t 30 - > OK - No errors detected - ``` - -6. Crea una definición de comando en tu configuración Nagios. - - ###### Definición de ejemplo - - ``` - definir comando { - command_name check_ssh_ghe_cluster - command_line $USER1$/check_by_ssh -H $HOSTADDRESS$ -C "ghe-cluster-status -n" -l admin -p 122 -t 30 - } - ``` -7. Agrega este comando a una definición de servicio para un nodo en la agrupación de {% data variables.product.prodname_ghe_server %}. - - - ###### Definición de ejemplo - - ``` - define host{ - use generic-host - host_name ghe-data-node-0 - alias ghe-data-node-0 - address 10.11.17.180 - } - - define service{ - use generic-service - host_name ghe-data-node-0 - service_description GitHub Cluster Status - check_command check_ssh_ghe_cluster - } - ``` - -En cuanto agregues la definición a Nagios, se ejecutará la comprobación del servicio de acuerdo con tu configuración. Deberías poder ver el servicio configurado recientemente en la interfaz web de Nagios. - -![Ejemplo de Nagios](/assets/images/enterprise/cluster/nagios-example.png) diff --git a/translations/es-XL/content/admin/clustering/overview.md b/translations/es-XL/content/admin/clustering/overview.md deleted file mode 100644 index 31e4e0e39d4b..000000000000 --- a/translations/es-XL/content/admin/clustering/overview.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Información general -intro: Aprende sobre agrupaciones y diferencias con alta disponibilidad. -mapTopic: true -redirect_from: - - /enterprise/admin/clustering/overview -versions: - enterprise-server: '*' ---- - diff --git a/translations/es-XL/content/admin/clustering/replacing-a-cluster-node.md b/translations/es-XL/content/admin/clustering/replacing-a-cluster-node.md deleted file mode 100644 index ff613158a442..000000000000 --- a/translations/es-XL/content/admin/clustering/replacing-a-cluster-node.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: Reemplazar un nodo de agrupación -intro: 'Para reemplazar un nodo {% data variables.product.prodname_ghe_server %}, debes marcar los nodos fuera de línea afectados en el archivo de configuración de la agrupación (`cluster.conf`) y agregar los nodos de reemplazo. Esto puede ser necesario en caso de que un nodo falle, o para agregar un nodo con más recursos a fin de aumentar el rendimiento.' -redirect_from: - - /enterprise/admin/clustering/replacing-a-cluster-node -versions: - enterprise-server: '*' ---- - -{% warning %} - -**Advertencia** El nodo de reemplazo debe usar un nodo de nombre de host que no haya sido usado anteriormente en la agrupación para evitar conflictos. - -{% endwarning %} - -### Reemplazar un nodo funcional -{% data reusables.enterprise_clustering.replacing-a-cluster-node-provision %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-admin-configure-ip %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-modify-cluster-conf %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-initialize-new-node %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-config-node %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-need-three-nodes %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-mark-offline %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-validate-config %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-replacement-name %} - -### Reemplazar un nodo en una emergencia -{% data reusables.enterprise_clustering.replacing-a-cluster-node-provision %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-admin-configure-ip %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-mark-offline %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-validate-config %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-modify-cluster-conf %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-replacement-name %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-initialize-new-node %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-config-node %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-need-three-nodes %} diff --git a/translations/es-XL/content/admin/clustering/setting-up-the-cluster-instances.md b/translations/es-XL/content/admin/clustering/setting-up-the-cluster-instances.md deleted file mode 100644 index 5af385f75656..000000000000 --- a/translations/es-XL/content/admin/clustering/setting-up-the-cluster-instances.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Configurar las instancias de agrupación -intro: 'La agrupación de {% data variables.product.prodname_ghe_server %} requiere que se establezcan y configuren múltiples instancias para que ejecuten los servicios de {% data variables.product.prodname_ghe_server %}.' -mapTopic: true -redirect_from: - - /enterprise/admin/clustering/setting-up-the-cluster-instances -versions: - enterprise-server: '*' ---- - diff --git a/translations/es-XL/content/admin/clustering/upgrading-a-cluster.md b/translations/es-XL/content/admin/clustering/upgrading-a-cluster.md deleted file mode 100644 index 9715d67e70f9..000000000000 --- a/translations/es-XL/content/admin/clustering/upgrading-a-cluster.md +++ /dev/null @@ -1,76 +0,0 @@ ---- -title: Actualizar una agrupación -intro: 'Usa el shell administrativo (SSH) para actualizar una agrupación de {% data variables.product.prodname_ghe_server %} a la última versión.' -redirect_from: - - /enterprise/admin/clustering/upgrading-a-cluster -versions: - enterprise-server: '*' ---- - -### Actualizar con un hotpatch -{% data reusables.enterprise_installation.hotpatching-explanation %}El script de instalación de hotpatch instala el hotpatch en cada nodo de la agrupación y reinicia los servicios en su secuencia adecuada para evitar el tiempo de inactividad. - -1. Realiza una copia de seguridad de tus datos con [{% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils#readme). -2. Desde el shell administrativo de cualquier nodo, usa el comando ` ghe-cluster-hotpatch` para instalar el último hotpatch. Puedes proporcionar una URL para un hotpatch, o descargar manualmente el hotpatch y especificar un nombre de archivo local. - ```shell - $ ghe-cluster-hotpatch https://HOTPATCH-URL/FILENAME.hpkg - ``` - -### Actualizar con un paquete de actualización -Usa un paquete de actualización para actualizar una agrupación de {% data variables.product.prodname_ghe_server %} a la última característica de lanzamiento. Por ejemplo, puedes actualizar desde `2.11` hasta `2.13`. - -#### Preparar para una actualización - -1. Revisa la [Configuración de red de la agrupación](/enterprise/admin/guides/clustering/cluster-network-configuration) para la versión a la que deseas avanzar y realiza las actualizaciones conforme sea necesario. -2. Realiza una copia de seguridad de tus datos con [{% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils#readme). -3. Planifica una ventana de mantenimiento para los usuarios finales de tu agrupación de {% data variables.product.prodname_ghe_server %}, dado que no estará disponible para usar normalmente durante la actualización. El modo de mantenimiento bloquea el acceso de los usuarios e impide que se realicen cambios en los datos mientras la actualización de la agrupación está en curso. -4. En [{% data variables.product.prodname_ghe_server %} Descargar página](https://enterprise.github.com/download), copia la URL para el archivo de actualización *.pkg* en el portapapeles. -5. Desde el shell administrativo de cualquier nodo, usa el comando `ghe-cluster-each` combinado con `curl` para descargar el paquete de lanzamiento para cada nodo en un solo paso. Usa la URL que copiaste en el paso anterior como argumento. - ```shell - $ ghe-cluster-each -- "cd /home/admin && curl -L -O https://PACKAGE-URL.pkg" - > ghe-app-node-1: % Total % Received % Xferd Average Speed Time Time Time Current - > ghe-app-node-1: Dload Upload Total Spent Left Speed - > 100 496M 100 496M 0 0 24.2M 0 0:00:20 0:00:20 --:--:-- 27.4M - > ghe-data-node-2: % Total % Received % Xferd Average Speed Time Time Time Current - > ghe-data-node-2: Dload Upload Total Spent Left Speed - > 100 496M 100 496M 0 0 21.3M 0 0:00:23 0:00:23 --:--:-- 25.8M - > ghe-data-node-1: % Total % Received % Xferd Average Speed Time Time Time Current - > ghe-data-node-1: Dload Upload Total Spent Left Speed - > 100 496M 100 496M 0 0 19.7M 0 0:00:25 0:00:25 --:--:-- 25.6M - > ghe-app-node-2: % Total % Received % Xferd Average Speed Time Time Time Current - > ghe-app-node-2: Dload Upload Total Spent Left Speed - > 100 496M 100 496M 0 0 19.8M 0 0:00:25 0:00:25 --:--:-- 17.6M - > ghe-data-node-3: % Total % Received % Xferd Average Speed Time Time Time Current - > ghe-data-node-3: Dload Upload Total Spent Left Speed - > 100 496M 100 496M 0 0 19.7M 0 0:00:25 0:00:25 --:--:-- 25.5M - ``` -6. Identifica el nodo MySQL principal, que se definió como `mysql-master = ` en `cluster.conf`. Este será el último nodo que se actualizará. - -#### Actualizar los nodos de la agrupación - -1. Habilita el modo de mantenimiento de acuerdo con tu ventana planificada conectando el shell administrativo de cualquier nodo de agrupación y ejecutando `ghe-cluster-maintenance -s`. -2. **Con la excepción del nodo MySQL primario**, conecta el shell administrativo de cada uno de los nodos {% data variables.product.prodname_ghe_server %}. Ejecuta el comando `ghe-upgrade`, suministrando el nombre del archivo del paquete que descargaste en el Paso 4 de [Preparar una actualización](#preparing-to-upgrade): - ```shell - $ ghe-upgrade PACKAGE-FILENAME.pkg - > *** verifying upgrade package signature... - > 497MB 0:00:04 [ 117MB/s] [==========================================>] 100% - > gpg: Signature made Fri 19 Feb 2016 02:33:50 PM UTC using RSA key ID 0D65D57A - > gpg: checking the trustdb - > gpg: 3 marginal(s) needed, 1 complete(s) needed, PGP trust model - > gpg: depth: 0 valid: 1 signed: 0 trust: 0-, 0q, 0n, 0m, 0f, 1u - > gpg: Good signature from "GitHub Enterprise (Upgrade Package Key) > " - ``` -3. El proceso de actualización reiniciará el nodo MySQL principal una vez que esté completo. Verifica que puedes `hacer ping` en cada nodo luego del reinicio. -4. Conecta con el shell administrativo del nodo MySQL principal. Ejecuta el comando `ghe-upgrade`, suministrando el nombre del archivo del paquete que descargaste en el Paso 4 de [Preparar una actualización](#preparing-to-upgrade): - ```shell - $ ghe-upgrade PACKAGE-FILENAME.pkg - > *** verifying upgrade package signature... - > 497MB 0:00:04 [ 117MB/s] [==========================================>] 100% - > gpg: Signature made Fri 19 Feb 2016 02:33:50 PM UTC using RSA key ID 0D65D57A - > gpg: checking the trustdb - > gpg: 3 marginal(s) needed, 1 complete(s) needed, PGP trust model - > gpg: depth: 0 valid: 1 signed: 0 trust: 0-, 0q, 0n, 0m, 0f, 1u - > gpg: Good signature from "GitHub Enterprise (Upgrade Package Key) > " - ``` -5. El proceso de actualización reiniciará el nodo MySQL principal una vez que esté completo. Verifica que puedes `hacer ping` en cada nodo luego del reinicio. -6. Cierra el modo de mantenimiento desde el shell administativo de cualquier nodo al ejecutar `ghe-cluster-maintenance -u`. diff --git a/translations/es-XL/content/admin/configuration/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md b/translations/es-XL/content/admin/configuration/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md deleted file mode 100644 index fd8a2594908b..000000000000 --- a/translations/es-XL/content/admin/configuration/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: Habilitar alertas de seguridad para tus dependencias vulnerables en el servidor de GitHub Enterprise -intro: 'Puedes conectar {% data variables.product.product_location_enterprise %} a {% data variables.product.prodname_ghe_cloud %} y habilitar alertas de seguridad para las dependencias vulnerables de los repositorios de tu instancia.' -redirect_from: - - /enterprise/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server - - /enterprise/admin/configuration/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server -permissions: 'Los administradores de sitio para {% data variables.product.prodname_ghe_server %} que también sean dueños de la cuenta organizacional o empresarial conectada de {% data variables.product.prodname_ghe_cloud %} pueden habilitar las alertas de seguridad para las dependencias vulnerables en {% data variables.product.prodname_ghe_server %}.' -versions: - enterprise-server: '*' ---- - -### Acerca de las alertas para las dependencias vulnerables en {% data variables.product.prodname_ghe_server %} - -{% data reusables.repositories.tracks-vulnerabilities %} Para obtener más información, consulta la sección "[Acerca de las alertas para las dependencias vulnerables](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)". - -Puedes conectar {% data variables.product.product_location_enterprise %} a {% data variables.product.prodname_dotcom_the_website %}, luego sincronizar los datos de vulnerabilidad para tu instancia y generar alertas de seguridad en los repositorios con dependencias vulnerables. - -Luego de conectar {% data variables.product.product_location_enterprise %} a {% data variables.product.prodname_dotcom_the_website %} y de habilitar las alertas de seguridad para las dependencias vulnerables, los datos de vulnerabilidad se sincronizan desde {% data variables.product.prodname_dotcom_the_website %} hasta tu instancia cada una hora. También puedes elegir sincronizar manualmente los datos de vulnerabilidad en cualquier momento. No se han cargado códigos o información sobre el código desde {% data variables.product.product_location_enterprise %} hasta {% data variables.product.prodname_dotcom_the_website %}. - -Cuando {% data variables.product.product_location_enterprise %} recibe información sobre una vulnerabilidad, identificará repositorios en su instancia que usa la versión afectada de la dependencia y envía alertas de seguridad a los propietarios y a las personas con accesos administrativos en estos repositorios. Pueden personalizar cómo recibir las alertas de seguridad. Para obtener más información, consulta la sección "[Acerca de las alertas para las dependencias vulnerables](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies/#configuring-notifications-for-security-alerts)". - -### Habilitar alertas de seguridad para las dependencias vulnerables en {% data variables.product.prodname_ghe_server %} - -Antes de habilitar las alertas de seguridad para dependencias vulnerables en {% data variables.product.product_location_enterprise %}, debes conectar {% data variables.product.product_location_enterprise %} en {% data variables.product.prodname_dotcom_the_website %}. Para obtener más información, consulta "[Conectar {% data variables.product.prodname_ghe_server %} a {% data variables.product.prodname_ghe_cloud %}](/enterprise/{{ currentVersion }}/admin/guides/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)." - -{% if currentVersion ver_gt "enterprise-server@2.20" %} Te recomendamos configurar las alertas de seguridad sin notificaciones durante los primeros días para evitar una sobrecarga de correos electrónicos. Después de algunos cuantos días, puedes habilitar las notificaciones para recibir alertas de seguridad como de costumbre.{% endif %} - -{% data reusables.enterprise_site_admin_settings.sign-in %} -2. En el shell administrativo, habilita las alertas de seguridad para las dependencias vulnerables en {% data variables.product.product_location_enterprise %}: - ``` shell -$ ghe-dep-graph-enable -``` -3. Regresar a {% data variables.product.prodname_ghe_server %}. -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %}{% if currentVersion ver_gt "enterprise-server@2.20" %} -5. Debajo de "Los repositorios pueden escanearse par encontrar vulnerabilidades", utiliza el menú desplegable y selecciona **Habilitado sin notificaciones**. Opcionalmente, para habilitar las alertas con notificaciones, selecciona **Habilitado con notificaciones**.{% else %} -5. En "Los repositorios se pueden escanear para encontrar vulnerabilidades", usa el menú desplegable y selecciona **Enabled** (Habilitado). -{% endif %} - ![Menú desplegable para habilitar el escaneo de repositorios para buscar vulnerabilidades](/assets/images/enterprise/site-admin-settings/enable-vulnerability-scanning-in-repositories.png) - -### Ver las dependencias vulnerables en {% data variables.product.prodname_ghe_server %} - -Puedes ver todas las vulnerabilidades en {% data variables.product.product_location_enterprise %} y sincronizar en forma manual los datos de vulnerabilidad desde {% data variables.product.prodname_dotcom_the_website %} para actualizar la lista. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -2. En la barra lateral izquierda, haz clic en **Vulnerabilities** (Vulnerabilidades). ![Pestaña de vulnerabilidades de la barra lateral del administrador del sitio](/assets/images/enterprise/business-accounts/vulnerabilities-tab.png) -3. Para sincronizar los datos de vulnerabilidades, haz clic en **Sync Vulnerabilities now** (Sincronizar vulnerabilidades ahora). ![Botón de Sincronizar vulnerabilidades ahora](/assets/images/enterprise/site-admin-settings/sync-vulnerabilities-button.png) diff --git a/translations/es-XL/content/admin/developer-workflow/about-pre-receive-hooks.md b/translations/es-XL/content/admin/developer-workflow/about-pre-receive-hooks.md deleted file mode 100644 index 733d8f5e912a..000000000000 --- a/translations/es-XL/content/admin/developer-workflow/about-pre-receive-hooks.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: Acerca de ganchos de pre-recepción -intro: 'Los *ganchos de pre-recepción* son scripts que se ejecutan en el aparato {% data variables.product.prodname_ghe_server %} que puedes usar para implementar controles de calidad.' -redirect_from: - - /enterprise/admin/developer-workflow/about-pre-receive-hooks -versions: - enterprise-server: '*' ---- - -Cuando se produce una subida, cada script se ejecuta en un entorno aislado y puede realizar verificaciones en el contenido que se subió. Los scripts provocarán la aceptación de la subida si el estado de salida es 0, o rechazado si el estado de salida no es cero. - -### Escenarios de uso -Usa los ganchos de pre-recepción para satisfacer las reglas comerciales, implementar el cumplimiento regulatorio y prevenir determinados errores comunes. - -Ejemplos de cómo usar los ganchos de pre-recepción: - -- Requerir mensajes de confirmación para seguir un patrón o formato específico, como incluir un número de ticket válido o finalizar luego de una determinada duración. -- Buscar una rama o repositorio al rechazar todas las subidas. -- Impedir que se agreguen datos sensibles al repositorio al bloquear palabras clave, patrones o tipos de archivo. -- Impedir que un autor PR se fusione con sus propios cambios. - -### Impactar en el rendimiento y los flujos de trabajo flujo de trabajo -El impacto que causa en los programadores y sus flujos de trabajo puede ser significativo y debe considerarse cuidadosamente. Los ganchos de pre-recepción que se basan en necesidades comerciales y se implementan cuidadosamente brindarán la mayor cantidad de beneficios a la organización en conjunto. - -Los ganchos de pre-recepción pueden tener efectos no deseados sobre el rendimiento de {% data variables.product.product_location_enterprise %} y deberían implementarse y revisarse cuidadosamente. diff --git a/translations/es-XL/content/admin/developer-workflow/about-protected-branches-and-required-status-checks.md b/translations/es-XL/content/admin/developer-workflow/about-protected-branches-and-required-status-checks.md deleted file mode 100644 index 3e740767b58e..000000000000 --- a/translations/es-XL/content/admin/developer-workflow/about-protected-branches-and-required-status-checks.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Acerca de ramas protegidas y verificación de estado requerida -intro: 'Las ramas protegidas garantizan que los colaboradores en un repositorio no puedan realizar cambios irrevocables a las ramas. Las verificaciones de estado requeridas garantizan que todas las pruebas de integración continua (CI) requeridas sean aprobadas antes de que los colaboradores puedan realizar cambios en una rama protegida. Las ramas dentro de los repositorios que pertenecen a organizaciones se pueden configurar para que solo ciertos usuarios{% if currentVersion ver_gt "enterprise-server@2.18" %},{% else %} {% endif %} equipos{% if currentVersion ver_gt "enterprise-server@2.18" %} o aplicaciones{% endif %} puedan subir elementos a la rama.' -redirect_from: - - /enterprise/admin/developer-workflow/about-protected-branches-and-required-status-checks -versions: - enterprise-server: '*' ---- - -Las *ramas protegidas* bloquean varias características de Git en una rama que un administrador de repositorio decida proteger. Una rama protegida: - -* No puede tener un empuje forzado -* No puede ser eliminada -* No puede tener cambios fusionados hasta que [ se aprueben las comprobaciones de estado requeridas](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/configuring-protected-branches-and-required-status-checks#enabling-required-status-checks) - -Cualquier usuario con permisos de administración para un repositorio siempre puede subir elementos a una rama protegida. Si habilitas *restricciones de rama*, solo los usuarios{% if currentVersion ver_gt "enterprise-server@2.18" %},{% else %} los{% endif %} equipos{% if currentVersion ver_gt "enterprise-server@2.18" %} o las aplicaciones{% endif %} a los que se les otorgó permiso pueden subir elementos a una rama protegida. Para obtener más información, consulte [Configurar ramas protegidas y verificaciones de estado requerida](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/configuring-protected-branches-and-required-status-checks)". - -![Permisos de rama restringidas](/assets/images/help/repository/restrict-branch-users.png). - -{% tip %} - -**Nota:** Si la opción "Include administrators" (Incluir administradores) está seleccionada, has [habilitado las verificaciones de estado requeridas](/articles/enabling-required-status-checks) en la rama, y si las verificaciones de estado fallan, cualquier intento de subir cambios a la rama protegida también fallará, incluso para las personas{% if currentVersion ver_gt "enterprise-server@2.18" %} y las aplicaciones{% endif %} con permisos de administración. - -{% endtip %} diff --git a/translations/es-XL/content/admin/developer-workflow/blocking-force-pushes-on-your-appliance.md b/translations/es-XL/content/admin/developer-workflow/blocking-force-pushes-on-your-appliance.md deleted file mode 100644 index d0ef6e5c2f0e..000000000000 --- a/translations/es-XL/content/admin/developer-workflow/blocking-force-pushes-on-your-appliance.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: Bloquear empujes forzados en tu aparato -redirect_from: - - /enterprise/admin/articles/blocking-force-pushes-on-your-appliance/ - - /enterprise/admin/developer-workflow/blocking-force-pushes-on-your-appliance -intro: 'Cualquier administrador del sitio puede bloquear todos los empujes forzados (`git push --force`) en un aparato {% data variables.product.prodname_ghe_server %}' -versions: - enterprise-server: '*' ---- - -Cada repositorio hereda una configuración de empuje forzado por defecto desde la configuración de la cuenta del usuario o la organización a la que pertenece. Del mismo modo, cada organización y cuenta del usuario hereda una configuración de empuje forzado por defecto desde la configuración de empuje forzado para todo el aparato. Si cambias la configuración del empuje forzado para el aparato, cambiará para todos los repositorios que son propiedad de cualquier usuario u organización. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -4. Debajo de "Force pushes" (Empujes forzados), usa el menú desplegable y haz clic en **Allow** (Permitir), **Block** (Bloquear) o **Block to the default branch** (Bloquear en la rama predeterminada). ![Forzar empujes desplegables](/assets/images/enterprise/site-admin-settings/force-pushes-dropdown.png) -5. Opcionalmente, selecciona **Enforce on all repositories** (Implementar en todos los repositorios) que sobrescribirán las configuraciones a nivel de la organización y del repositorio para los empujes forzados. - -### Leer más - -- [Bloquear fuerzas de empuje en los repositorios que son propiedad de una cuenta de usuario u organización](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization)" -- [Bloquear fuerzas de empuje en un repositorio](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository)" diff --git a/translations/es-XL/content/admin/developer-workflow/blocking-force-pushes-to-a-repository.md b/translations/es-XL/content/admin/developer-workflow/blocking-force-pushes-to-a-repository.md deleted file mode 100644 index 12bf18baf67f..000000000000 --- a/translations/es-XL/content/admin/developer-workflow/blocking-force-pushes-to-a-repository.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Bloquear empujes forzados en un repositorio -redirect_from: - - /enterprise/admin/articles/blocking-force-pushes-to-a-repository/ - - /enterprise/admin/articles/block-force-pushes/ - - /enterprise/admin/developer-workflow/blocking-force-pushes-to-a-repository -intro: 'Puedes bloquear los empujes forzados (`git push --force`) en todas las ramas, o solo en la rama predeterminada, de un repositorio.' -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_site_admin_settings.override-policy %} - -{% data reusables.enterprise_site_admin_settings.sign-in %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -4. Selecciona **Block** (Bloquear) o **Block to the default branch** (Bloquear en la rama predeterminada) debajo de **Push and Pull** (Subir y extraer). ![Bloquear empujes forzados](/assets/images/enterprise/site-admin-settings/repo/repo-block-force-pushes.png) - -El cambio entra en vigencia inmediatamente. Si cambias de opinión en otro momento, puedes volver a permitir los empujes forzados fácilmente. - -## Leer más - -- ["Bloquear empujes forzados en los repositorios que le pertenecen a una cuenta de usuario u organización](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization)" -- ["Bloquear empujes forzados en tu aparato](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-on-your-appliance)" diff --git a/translations/es-XL/content/admin/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization.md b/translations/es-XL/content/admin/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization.md deleted file mode 100644 index 73df1c975770..000000000000 --- a/translations/es-XL/content/admin/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: Bloquear empujes forzados a los repositorios que posee una cuenta de usuario u organización -redirect_from: - - /enterprise/admin/articles/blocking-force-pushes-for-a-user-account/ - - /enterprise/admin/articles/blocking-force-pushes-for-an-organization/ - - /enterprise/admin/articles/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization/ - - /enterprise/admin/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization -intro: Puedes bloquear los empujes forzados (`git push --force`) en todas las ramas o solo en las ramas por defecto de los repositorios que posee una cuenta de usuario u organización. -versions: - enterprise-server: '*' ---- - -Los repositorios heredan los parámetros de los empujes forzados de la cuenta de usuario u organización a la que pertenecen. Las cuentas de usuarios y organizaciones a su vez heredan los parámetros de los empujes forzado para todo el aparato. - -Puedes sustituir los parámetros predeterminados heredados al configurar los parámetros para una cuenta de usuario u organización. - -{% data reusables.enterprise_site_admin_settings.sign-in %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.search-user-or-org %} -{% data reusables.enterprise_site_admin_settings.click-user-or-org %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -5. En "Parámetros predeterminados del repositorio" en la sección "Empujes forzados", selecciona - - **Block** (Bloquear) para bloquear los empujes forzados en todas las ramas. - - **Block to the default branch** (Bloquear en la rama por defecto) para bloquear solo los empujes forzados en la rama por defecto. ![Bloquear empujes forzados](/assets/images/enterprise/site-admin-settings/user/user-block-force-pushes.png) -6. Opcionalmente, selecciona **Enforce on all repositories** (Implementar en todos los repositorios) para sustituir los parámetros específicos del repositorio. Ten en cuenta que esto **no** sustituirá una política en todo el aparato. ![Block force pushes](/assets/images/enterprise/site-admin-settings/user/user-block-all-force-pushes.png)El cambio entra en vigencia inmediatamente. Si cambias de opinión en otro momento, puedes volver a permitir los empujes forzados. - -### Leer más - -- [Bloquear fuerzas de empuje en un repositorio](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository)" -- ["Bloquear empujes forzados en tu aparato](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-on-your-appliance)" diff --git a/translations/es-XL/content/admin/developer-workflow/blocking-force-pushes.md b/translations/es-XL/content/admin/developer-workflow/blocking-force-pushes.md deleted file mode 100644 index 464ac9bef8d6..000000000000 --- a/translations/es-XL/content/admin/developer-workflow/blocking-force-pushes.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Bloquear los empujes forzados -intro: 'Puedes bloquear los empujes forzados en todos los repositorios en el aparato {% data variables.product.prodname_ghe_server %}, en todos los repositorios que son propiedad de una organización o en un repositorio particular.' -mapTopic: true -redirect_from: - - /enterprise/admin/developer-workflow/blocking-force-pushes -versions: - enterprise-server: '*' ---- - diff --git a/translations/es-XL/content/admin/developer-workflow/configuring-protected-branches-and-required-status-checks.md b/translations/es-XL/content/admin/developer-workflow/configuring-protected-branches-and-required-status-checks.md deleted file mode 100644 index afb4d8318c49..000000000000 --- a/translations/es-XL/content/admin/developer-workflow/configuring-protected-branches-and-required-status-checks.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: Configurar ramas protegidas y verificaciones de estado requeridas -intro: 'Puedes habilitar ramas protegidas para restringir la manipulación de ramas, así como implementar verificaciones de estado requeridas antes de que una rama se fusione con una solicitud de extracción o antes de que las confirmaciones en una rama local se puedan subir a la rama remota protegida.' -redirect_from: - - /enterprise/admin/developer-workflow/configuring-protected-branches-and-required-status-checks -versions: - enterprise-server: '*' ---- - -Cualquier usuario con permisos de administración puede habilitar restricciones de ramas. - -### Habilitar una rama protegida para un repositorio - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -{% data reusables.repositories.repository-branches %} -{% data reusables.repositories.add-branch-protection-rules %} -5. Da clic en **Create** (Crear). - -### Tipos de verificaciones de estado requeridas - -| Tipo de verificación de estado requerida | Parámetro | Requisitos de fusión | Consideraciones | -| ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **Estricta** | La casilla **Require branches to be up-to-date before merging** (Las ramas deben estar actualizadas antes de la fusión) está marcada. | La rama **debe** estar actualizada con la rama de base antes de la fusión. | Este es el comportamiento predeterminado para las verificaciones de estado requeridas. Se pueden requerir más construcciones, ya que deberás actualizar la rama de encabezado después de que otros colaboradores fusionen las solicitudes de extracción con la rama de base protegida. | -| **Flexible** | La casilla **Require branches to be up-to-date before merging** (Las ramas deben estar actualizadas antes de la fusión) **no** está marcada. | La rama **no debe** estar actualizada con la rama de base antes de la fusión. | Tendrás menos construcciones requeridas, ya que no necesitarás actualizar la rama de encabezado después de que otros colaboradores fusionen las solicitudes de extracción. Las verificaciones de estado pueden fallar después de que fusiones tu rama si hay cambios incompatibles con la rama de base. | -| **Inhabilitada** | La casilla **Require status checks to pass before merging** (Se deben superar las verificaciones de estado antes de la fusión) **no** está marcada. | La rama no tiene restricciones de fusión. | Si las verificaciones de estado requeridas no están habilitadas, los colaboradores pueden fusionar la rama en cualquier momento, independientemente de si está actualizada con la rama de base. Esto aumenta la posibilidad de cambios incompatibles. | - -### Habilitar verificaciones de estado requeridas - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -{% data reusables.repositories.repository-branches %} -{% data reusables.repositories.add-branch-protection-rules %} -5. Selecciona **Requerir verificaciones de estado requeridas antes de la fusión**. ![Opción Verificaciones de estado requeridas](/assets/images/help/repository/required-status-checks.png) -6. De la lista de verificaciones de estado disponibles, selecciona las que quieras que se requieran. ![Lista de verificaciones de estado disponibles](/assets/images/help/repository/required-statuses-list.png) -{% data reusables.repositories.include-administrators %} -8. También puedes quitar la marca de selección de **Requerir que las ramas estén actualizadas antes de la fusión**. Al seleccionar esta opción, te aseguras de que la rama se pruebe con el código más reciente en la rama base. ![Casilla de verificación de estado estricta o poco estricta](/assets/images/help/repository/protecting-branch-loose-status-new.png) -9. Opcionalmente, selecciona {% if currentVersion ver_gt "enterprise-server@2.18" %}**Restringir quién puede subir a las ramas correspondientes**{% else %}**Restringir quién puede subir a esta rama**{% endif %}. ![Branch restriction checkbox]{% if currentVersion ver_gt "enterprise-server@2.18" %}(/assets/images/help/repository/restrict-branch.png){% else %}(/assets/images/help/repository/restrict-branch-push.png){% endif %} -10. Busca y selecciona las personas {% if currentVersion ver_gt "enterprise-server@2.18" %},{% else %} o{% endif %} equipos{% if currentVersion ver_gt "enterprise-server@2.18" %}, o aplicaciones{% endif %} que tendrán permiso de subir a la rama protegida. ![Búsqueda de restricciones de rama](/assets/images/help/repository/restrict-branch-search.png) -11. Da clic en **Create** (Crear). - -{% data reusables.repositories.required-status-merge-tip %} diff --git a/translations/es-XL/content/admin/developer-workflow/continuous-integration-using-jenkins.md b/translations/es-XL/content/admin/developer-workflow/continuous-integration-using-jenkins.md deleted file mode 100644 index 87f66fd1a017..000000000000 --- a/translations/es-XL/content/admin/developer-workflow/continuous-integration-using-jenkins.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: Integración continua mediante Jenkins -intro: 'Puedes activar automáticamente la creación de trabajos en un servidor Jenkins cuando las extracciones se realizan a un repositorio en {% data variables.product.product_location_enterprise %}.' -redirect_from: - - /enterprise/admin/developer-workflow/continuous-integration-using-jenkins -versions: - enterprise-server: '*' ---- - -### Requisitos - -- Sigue nuestra documentación técnica "[Guía práctica para CI con Jenkins y GitHub](https://resources.github.com/whitepapers/practical-guide-to-CI-with-Jenkins-and-GitHub/)" para conocer las instrucciones detalladas sobre cómo puedes activar automáticamente la creación de trabajos en un servidor Jenkins cuando las extracciones de realizan en un repositorio en {% data variables.product.product_location_enterprise %}. diff --git a/translations/es-XL/content/admin/developer-workflow/creating-a-pre-receive-hook-environment.md b/translations/es-XL/content/admin/developer-workflow/creating-a-pre-receive-hook-environment.md deleted file mode 100644 index c215758ea8fd..000000000000 --- a/translations/es-XL/content/admin/developer-workflow/creating-a-pre-receive-hook-environment.md +++ /dev/null @@ -1,92 +0,0 @@ ---- -title: Crear un entorno de gancho de pre-recepción -intro: 'Para ejecutar los ganchos de pre-recepción, usa el entorno de pre-recepción predeterminado o crea un entorno personalizado.' -redirect_from: - - /enterprise/admin/developer-workflow/creating-a-pre-receive-hook-environment -versions: - enterprise-server: '*' ---- - -Un entorno de pre-recepción para el {% data variables.product.prodname_ghe_server %} es un entorno Linux [`chroot`](https://en.wikipedia.org/wiki/Chroot). Dado que los ganchos de pre-recepción se ejecutan en todos los eventos de extracción, deberían ser rápidos y livianos. Normalmente, el entorno necesario para tales verificaciones será mínimo. - -El {% data variables.product.prodname_ghe_server %} brinda un entorno predeterminado que incluye estos paquetes: `awk`, `bash`, `coreutils`, `curl`, `find`, `gnupg`, `grep`, `jq`, `sed`. - -Si tu entorno no cumple con uno de los requisitos específicos, como respaldo para un idioma en particular, puedes crear y cargar tu propio entorno `chroot` en Linux de 64 bits. - -### Crear un entorno de gancho de pre-recepción mediante Docker - -Puedes usar una herramienta de administración de contenedores de Linux para crear un entorno de gancho de pre-recepción. Este ejemplo usa [Alpine Linux](http://www.alpinelinux.org/) y [Docker](https://www.docker.com/). - -{% data reusables.linux.ensure-docker %} -2. Crea el archivo `Dockerfile.alpine-3.3` que contiene esta información: - - ``` - FROM gliderlabs/alpine:3.3 - RUN apk add --no-cache git bash - ``` -3. Desde el directorio de trabajo que contiene `Dockerfile.dev`, crea una imagen: - - ```shell - $ docker build -f Dockerfile.alpine-3.3 -t pre-receive.alpine-3.3 . - > Sending build context to Docker daemon 12.29 kB - > Step 1 : FROM gliderlabs/alpine:3.3 - > ---> 8944964f99f4 - > Step 2 : RUN apk add --no-cache git bash - > ---> Using cache - > ---> 0250ab3be9c5 - > Successfully built 0250ab3be9c5 - ``` -4. Crea un contenedor: - - ```shell - $ docker create --name pre-receive.alpine-3.3 pre-receive.alpine-3.3 /bin/true - ``` -5. Exporta el contenedor Docker a un archivo `tar` comprimido como `gzip`: - - ```shell - $ docker export pre-receive.alpine-3.3 | gzip > alpine-3.3.tar.gz - ``` - - Este archivo `alpine-3.3.tar.gz` está listo para subirse al aparato del {% data variables.product.prodname_ghe_server %}. - -### Crear un entorno de gancho de pre-recepción mediante chroot - -1. Crea un entorno `chroot` en Linux. -2. Crea un archivo `tar` comprimido como `gzip` del directorio `chroot`. - ```shell - $ cd /path/to/chroot - $ tar -czf /path/to/pre-receive-environment.tar.gz . - ``` - - {% note %} - - **Notas:** - - No incluyas las rutas iniciales del directorio en los archivos dentro del tar, tales como `/path/to/chroot`. - - La ruta `/bin/sh` debe existir y ser ejecutable como punto de entrada al ambiente chroot. - - A diferencia de los chroots tradicionales, el ambiente de chroot para ganchos de pre-recepción no requiere el directorio `dev`. - - {% endnote %} - -Para obtener más información acerca de la creación de un entorno chroot, consulta "[Chroot](https://wiki.debian.org/chroot)" desde *Debian Wiki*, "[BasicChroot](https://help.ubuntu.com/community/BasicChroot)" desde *Ubuntu Community Help Wiki* o "[Instalar Alpine Linux en un chroot](http://wiki.alpinelinux.org/wiki/Installing_Alpine_Linux_in_a_chroot)" desde *Alpine Linux Wiki*. - -### Cargar un entorno de pre-recepción en el {% data variables.product.prodname_ghe_server %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.hooks-tab %} -5. Haz clic en **Manage environments** (Administrar entornos). ![Administrar entornos](/assets/images/enterprise/site-admin-settings/manage-pre-receive-environments.png) -6. Haz clic en **Add environment** (Agregar entorno). ![Agregar entorno](/assets/images/enterprise/site-admin-settings/add-pre-receive-environment.png) -7. Escribe el nombre que desees en el campo **Environment name** (Nombre del entorno). ![Nombre del entorno](/assets/images/enterprise/site-admin-settings/pre-receive-environment-name.png) -8. Escribe la URL del archivo `*.tar.gz` que contiene tu entorno. ![Cargar un entorno desde una URL](/assets/images/enterprise/site-admin-settings/upload-environment-from-url.png) -9. Haz clic en **Add environment** (Agregar entorno). ![Agregar el botón de entorno](/assets/images/enterprise/site-admin-settings/add-environment-button.png) - -### Cargar un entorno de pre-recepción mediante el shell administrativo -1. Carga un archivo `*.tar.gz` legible que contenga tu entorno a un host web y copia la URL o transfiere el archivo al aparato del {% data variables.product.prodname_ghe_server %} mediante `scp`. Al usar `scp`, es posible que necesites ajustar los permisos del archivo `*.tar.gz` para que todos puedan leerlo. -1. Conecta con el shell administrativo. -2. Usa el comando `ghe-hook-env-create` y escribe el nombre que desees para el entorno como primer argumento y la ruta local completa o la dirección URL de un archivo `*.tar.gz` que contenga tu entorno como segundo argumento. - - ```shell - admin@ghe-host:~$ ghe-hook-env-create AlpineTestEnv /home/admin/alpine-3.3.tar.gz - > Pre-receive hook environment 'AlpineTestEnv' (2) has been created. - ``` diff --git a/translations/es-XL/content/admin/developer-workflow/creating-a-pre-receive-hook-script.md b/translations/es-XL/content/admin/developer-workflow/creating-a-pre-receive-hook-script.md deleted file mode 100644 index 3ca8ca2a77f0..000000000000 --- a/translations/es-XL/content/admin/developer-workflow/creating-a-pre-receive-hook-script.md +++ /dev/null @@ -1,199 +0,0 @@ ---- -title: Crear un script de ganchos de pre-recepción -intro: Usa los scripts de los ganchos de pre-recepción para crear requisitos para aceptar o rechazar una subida en función de los contenidos. -redirect_from: - - /enterprise/admin/developer-workflow/creating-a-pre-receive-hook-script -versions: - enterprise-server: '*' ---- - -Puedes ver los ejemplos de los ganchos de pre-recepción para {% data variables.product.prodname_ghe_server %} en el repositorio [`github/platform-samples`](https://github.com/github/platform-samples/tree/master/pre-receive-hooks). - -### Escribir un script de ganchos de pre-recepción -Un script de gancho de pre-recepción se ejecuta en un entorno de gancho de pre-recepcion en el aparato {% data variables.product.prodname_ghe_server %}. Cuando crees un script de gancho de pre-recepción, considera la entrada, salida, el estado de salida y las variables de entorno. - -#### Entrada (stdin) -Después de que se produce la subida y antes de que las ref se actualicen en el repositorio remoto, el proceso `git-receive-pack` invoca el script del gancho de pre-recepción con la entrada estándar de una línea por ref que se actualizará: - -` SP SP LF` - -Esta cadena representa estos argumentos: - -| Argumento | Descripción | -|:------------------- |:-------------------------------------------------------------------------------------------------------------- | -| `` | Nombre del objeto antiguo almacenado en la `ref`.
    Cuando *creas* una nueva`ref`, esto equivale a 40 ceros. | -| `` | El nombre del objeto nuevo se almacenará en la `ref`.
    Cuando *eliminas* una `ref`, equivale a 40 ceros. | -| `` | El nombre completo de la `ref`. | - -Para obtener más información sobre `git-receive-pack`, consulta "[git-receive-pack](https://git-scm.com/docs/git-receive-pack)" en la documentación de Git. Para obtener más información sobre `refs`, consulta "[Referencias de Git](https://git-scm.com/book/en/v2/Git-Internals-Git-References)" en *Pro Git*. - -#### Salida (stdout) - -La salida del script (`stdout`) se vuelve a pasar al cliente, de manera que los enunciados `eco` estén visibles para el usuario en la línea de comando o en la interfaz del usuario. - -#### Estado de salida - -El `estado de salida` de un script de pre-recepción determina si la subida se aceptará. - -| Valor del estado de salida | Acción | -|:--------------------------:|:-------------------------:| -| 0 | La subida será aceptada. | -| no cero | La subida será rechazada. | - -#### Variables del entorno -Fuera de los valores que se brindan a `stdin`, existen variables adicionales que están disponibles para un script de gancho de pre-recepción en {% data variables.product.prodname_ghe_server %}. - -| Variable | Descripción | -|:------------------------------------- |:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| $GITHUB_USER_LOGIN | El id de usuario que creó el `ref`. | -| $GIT_DIR | La ruta del repositorio remoto en el aparato. | -| $GITHUB_USER_IP | La dirección IP del usuario que realiza la subida. | -| $GITHUB_REPO_NAME | El nombre en el formato `owner`/`repo` del repositorio que se actualiza. | -| $GITHUB_PULL_REQUEST_AUTHOR_LOGIN | El ID de usuario para el autor de una solicitud de extracción en tu instancia. | -| $GITHUB_REPO_PUBLIC | Un valor booleano que cuando `true` representa un repositorio público, y cuando `false` representa un repositorio privado. | -| $GITHUB_PUBLIC_KEY_FINGERPRINT | La huella digital de clave pública del usuario. | -| $GITHUB_PULL_REQUEST_HEAD | Una cadena en el formato: `user:branch` para el HEAD del PR.
    Ejemplo: `octocat:fix-bug` | -| $GITHUB_PULL_REQUEST_BASE | Una cadena en el formato: `user:branch` para la BASE del PR.
    Ejemplo: `octocat:master` | -| $GITHUB_VIA | Método usado para crear la ref.
    **Valores posibles:**
    - `auto-merge deployment api`
    - `blob edit`
    - `branch merge api`
    - `branches page delete button`
    - `git refs create api`
    - `git refs delete api`
    - `git refs update api`
    - `merge api`
    - `pull request branch delete button`
    - `pull request branch undo button`
    - `pull request merge api`
    - `pull request merge button`
    - `pull request revert button`
    - `releases delete button`
    - `stafftools branch restore`
    - `slumlord (#{sha})` | -| $GIT_PUSH_OPTION_COUNT | El número de opciones de extracción que envió el cliente. Para obtener más información sobre las opciones de subida, consulta "[git-push](https://git-scm.com/docs/git-push#git-push---push-optionltoptiongt)" en la documentación de Git. | -| $GIT_PUSH_OPTION_N | Donde N es un número entero que comienza con 0, esta variable contiene la cadena de opción de subida que envió el cliente. La primera opción que se envió se almacenó en GIT_PUSH_OPTION_0, la segunda opción que se envió se almacenó en GIT_PUSH_OPTION_1, y así sucesivamente. Para obtener más información sobre las opciones de subida, consulta "[git-push](https://git-scm.com/docs/git-push#git-push---push-optionltoptiongt)" en la documentación de Git. | - -### Establecer permisos y subidas a un ganchos de pre-recepción para {% data variables.product.prodname_ghe_server %} - -Un script de gancho de pre-recepción se encuentra en un repositorio en el aparato {% data variables.product.prodname_ghe_server %}. Un administrador del sitio debe tener en cuenta los permisos del repositorio y garantizar que solo los usuarios correspondientes tengan acceso. - -Recomendamos los ganchos de consolidación a un solo repositorio. Si el repositorio de gancho consolidado es público, `README.md` puede usarse para explicar los cumplimientos de la política. Además, las contribuciones pueden aceptarse mediante solicitudes de extracción. Sin embargo, los ganchos de pre-recepción solo pueden agregarse desde la rama por defecto. Para un flujo de trabajo de prueba, se deben usar las bifurcaciones del repositorio con la configuración. - -1. Para usuarios de Mac, asegúrate de que los scripts tengan permisos de ejecución: - - ```shell - $ sudo chmod +x SCRIPT_FILE.sh - ``` - Para usuarios de Windows, asegúrate de que los scripts tengan permisos de ejecución: - - ```shell - git update-index --chmod=+x SCRIPT_FILE.sh - ``` - -2. Confirmar y subir a tus repositorio de ganchos pre-recibidos en la instancia {% data variables.product.prodname_ghe_server %}. - - ```shell - $ git commit -m "YOUR COMMIT MESSAGE" - $ git push - ``` - -3. [Crear la instancia de ganchos de pre-recepción](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance/#creating-pre-receive-hooks) on the {% data variables.product.prodname_ghe_server %}. - -### Probar scripts de pre-recepción localmente -Puedes probar un script de gancho de pre-recepción localmente antes de crear o actualizar en tu aparato {% data variables.product.prodname_ghe_server %}. Un método es crear un entorno de Docker local para que actúe como un repositorio remoto que pueda ejecutar el gancho de pre-recepción. - -{% data reusables.linux.ensure-docker %} - -2. Crear un archivo denominado `Dockerfile.dev` que contenga: - - ``` - FROM gliderlabs/alpine:3.3 - RUN \ - apk add --no-cache git openssh bash && \ - ssh-keygen -A && \ - sed -i "s/#AuthorizedKeysFile/AuthorizedKeysFile/g" /etc/ssh/sshd_config && \ - adduser git -D -G root -h /home/git -s /bin/bash && \ - passwd -d git && \ - su git -c "mkdir /home/git/.ssh && \ - ssh-keygen -t rsa -b 4096 -f /home/git/.ssh/id_rsa -P '' && \ - mv /home/git/.ssh/id_rsa.pub /home/git/.ssh/authorized_keys && \ - mkdir /home/git/test.git && \ - git --bare init /home/git/test.git" - - VOLUME ["/home/git/.ssh", "/home/git/test.git/hooks"] - WORKDIR /home/git - - CMD ["/usr/sbin/sshd", "-D"] - ``` - -3. Crear un script de pre-recepción de prueba denominado `always_reject.sh`. Este script del ejemplo rechazará todas las subidas, lo cual es útil para bloquear un repositorio: - - ``` - #!/usr/bin/env bash - - echo "error: rejecting all pushes" - exit 1 - ``` - -4. Asegúrate de que los scripts `always_reject.sh` tengan permisos de ejecución: - - ```shell - $ chmod +x always_reject.sh - ``` - -5. Desde el directorio que contiene `Dockerfile.dev`, crea una imagen: - - ```shell - $ docker build -f Dockerfile.dev -t pre-receive.dev . - > Sending build context to Docker daemon 3.584 kB - > Step 1 : FROM gliderlabs/alpine:3.3 - > ---> 8944964f99f4 - > Step 2 : RUN apk add --no-cache git openssh bash && ssh-keygen -A && sed -i "s/#AuthorizedKeysFile/AuthorizedKeysFile/g" /etc/ssh/sshd_config && adduser git -D -G root -h /home/git -s /bin/bash && passwd -d git && su git -c "mkdir /home/git/.ssh && ssh-keygen -t rsa -b 4096 -f /home/git/.ssh/id_rsa -P ' && mv /home/git/.ssh/id_rsa.pub /home/git/.ssh/authorized_keys && mkdir /home/git/test.git && git --bare init /home/git/test.git" - > ---> Running in e9d79ab3b92c - > fetch http://alpine.gliderlabs.com/alpine/v3.3/main/x86_64/APKINDEX.tar.gz - > fetch http://alpine.gliderlabs.com/alpine/v3.3/community/x86_64/APKINDEX.tar.gz - ....truncated output.... - > OK: 34 MiB in 26 packages - > ssh-keygen: generating new host keys: RSA DSA ECDSA ED25519 - > Password for git changed by root - > Generating public/private rsa key pair. - > Your identification has been saved in /home/git/.ssh/id_rsa. - > Your public key has been saved in /home/git/.ssh/id_rsa.pub. - ....truncated output.... - > Initialized empty Git repository in /home/git/test.git/ - > Successfully built dd8610c24f82 - ``` - -6. Ejecutar un contenedor de datos que contiene una clave SSH generada: - - ```shell - $ docker run --name data pre-receive.dev /bin/true - ``` - -7. Copiar el ganchos de pre-recepción de prueba `always_reject.sh` en el contenedor de datos: - - ```shell - $ docker cp always_reject.sh data:/home/git/test.git/hooks/pre-receive - ``` - -8. Poner en marcha un contenedor de la aplicación que corre `sshd` y ejecuta el gancho. Toma nota del id del contenedor que se devolvió: - - ```shell - $ docker run -d -p 52311:22 --volumes-from data pre-receive.dev - > 7f888bc700b8d23405dbcaf039e6c71d486793cad7d8ae4dd184f4a47000bc58 - ``` - -9. Copilar la clave SSH generada desde el contenedor de datos hasta la máquina local: - - ```shell - $ docker cp data:/home/git/.ssh/id_rsa . - ``` - -10. Modificar el remoto de un repositorio de prueba y subirlo al repositorio `test.git` dentro del contenedor Docker. Este ejemplo usa `git@github.com:octocat/Hello-World.git` pero puedes usar cualquier repositorio que desees. Este ejemplo asume que tu máquina local (127.0.01) es el puerto vinculante 52311, pero puedes usar una dirección IP diferente si el docker está ejecutándose en una máquina remota. - - ```shell - $ git clone git@github.com:octocat/Hello-World.git - $ cd Hello-World - $ git remote add test git@127.0.0.1:test.git - $ GIT_SSH_COMMAND="ssh -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no -p 52311 -i ../id_rsa" git push -u test master - > Warning: Permanently added '[192.168.99.100]:52311' (ECDSA) to the list of known hosts. - > Counting objects: 7, done. - > Delta compression using up to 4 threads. - > Compressing objects: 100% (3/3), done. - > Writing objects: 100% (7/7), 700 bytes | 0 bytes/s, done. - > Total 7 (delta 0), reused 7 (delta 0) - > remote: error: rejecting all pushes - > To git@192.168.99.100:test.git - > ! [remote rejected] master -> master (pre-receive hook declined) - > error: failed to push some refs to 'git@192.168.99.100:test.git' - ``` - - Observa que la subida fue rechazada después de ejecutar el ganchos de pre-recepción y de hace eco la salida del script. - -### Leer más - - "[Personalizar Git - Un ejemplo de la política activa de Git](https://git-scm.com/book/en/v2/Customizing-Git-An-Example-Git-Enforced-Policy)" desde el *sitio web de Pro Git* diff --git a/translations/es-XL/content/admin/developer-workflow/customizing-your-instance-with-integrations.md b/translations/es-XL/content/admin/developer-workflow/customizing-your-instance-with-integrations.md deleted file mode 100644 index 0fe5aa891db6..000000000000 --- a/translations/es-XL/content/admin/developer-workflow/customizing-your-instance-with-integrations.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Personalizar su instancia con integraciones -intro: 'Puedes integrar las aplicaciones de terceros con {% data variables.product.product_location_enterprise %}.' -mapTopic: true -redirect_from: - - /enterprise/admin/developer-workflow/customizing-your-instance-with-integrations -versions: - enterprise-server: '*' ---- - diff --git a/translations/es-XL/content/admin/developer-workflow/establishing-pull-request-merge-conditions.md b/translations/es-XL/content/admin/developer-workflow/establishing-pull-request-merge-conditions.md deleted file mode 100644 index b8fe0a4255ff..000000000000 --- a/translations/es-XL/content/admin/developer-workflow/establishing-pull-request-merge-conditions.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Establecer condiciones de fusión de solicitud de extracción -intro: 'Puedes requerir que las solicitudes de extracción superen un conjunto de verificaciones antes de que se las pueda fusionar. Por ejemplo, puedes bloquear las solicitudes de extracción que no aprueban tus verificaciones de estado.' -mapTopic: true -redirect_from: - - /enterprise/admin/developer-workflow/establishing-pull-request-merge-conditions -versions: - enterprise-server: '*' ---- - diff --git a/translations/es-XL/content/admin/developer-workflow/index.md b/translations/es-XL/content/admin/developer-workflow/index.md deleted file mode 100644 index 1ec19d1e9c54..000000000000 --- a/translations/es-XL/content/admin/developer-workflow/index.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: Implementar políticas y personalizar el flujo de trabajo del programador -redirect_from: - - /enterprise/admin/guides/installation/integrations/ - - /enterprise/admin/categories/integration/ - - /enterprise/admin/developer-workflow -intro: 'En esta guía, se describen las herramientas que se encuentran disponibles en {% data variables.product.prodname_enterprise %} para la implementación del flujo de trabajo de un programador y la aplicación de políticas organizativas para reducir el riesgo y aumentar la calidad.' -versions: - enterprise-server: '*' ---- - - -### Índice - -{% topic_link_in_list /blocking-force-pushes %} - {% link_in_list /blocking-force-pushes-on-your-appliance %} - {% link_in_list /blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization %} - {% link_in_list /blocking-force-pushes-to-a-repository %} -{% topic_link_in_list /using-webhooks-for-continuous-integration %} - {% link_in_list /continuous-integration-using-jenkins %} - {% link_in_list /troubleshooting-service-hooks %} -{% topic_link_in_list /using-pre-receive-hooks-to-enforce-policy %} - {% link_in_list /about-pre-receive-hooks %} - {% link_in_list /creating-a-pre-receive-hook-environment %} - {% link_in_list /creating-a-pre-receive-hook-script %} - {% link_in_list /managing-pre-receive-hooks-on-the-github-enterprise-server-appliance %} -{% topic_link_in_list /establishing-pull-request-merge-conditions %} - {% link_in_list /about-protected-branches-and-required-status-checks %} - {% link_in_list /configuring-protected-branches-and-required-status-checks %} -{% topic_link_in_list /customizing-your-instance-with-integrations %} - {% link_in_list /managing-projects-using-jira %} diff --git a/translations/es-XL/content/admin/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance.md b/translations/es-XL/content/admin/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance.md deleted file mode 100644 index 8ed854719ba6..000000000000 --- a/translations/es-XL/content/admin/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance.md +++ /dev/null @@ -1,59 +0,0 @@ ---- -title: Administrar ganchos de pre-recepción en el aparato del Servidor de GitHub Enterprise -intro: 'Configura cómo las personas usarán sus ganchos de pre-recepción dentro de su aparato del {% data variables.product.prodname_ghe_server %}.' -redirect_from: - - /enterprise/admin/guides/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-appliance/ - - /enterprise/admin/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance -versions: - enterprise-server: '*' ---- - -### Crear ganchos de pre-recepción - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.hooks-tab %} -4. Haz clic en **Add pre-receive hook** (Agregar gancho de pre-recepción). ![Agregar un gancho de pre-recepción](/assets/images/enterprise/site-admin-settings/add-pre-receive-hook.png) -5. En el campo **Hook name** (Nombre de gancho), escribe el nombre del gancho que deseas crear. ![Nombrar los ganchos de pre-recepción](/assets/images/enterprise/site-admin-settings/hook-name.png) -6. En el menú desplegable **Environment** (Entorno), selecciona el entorno en el que deseas ejecutar el gancho. ![Entornos para ganchos](/assets/images/enterprise/site-admin-settings/environment.png) -7. Debajo de **Script**, desde el menú desplegable **Select hook repository** (Seleccionar repositorio de gancho), selecciona el repositorio que contiene tu script de gancho de pre-recepción. Desde el menú desplegable **Select file** (Seleccionar archivo), selecciona el nombre de archivo o el script del gancho de pre-recepción. ![Script para ganchos](/assets/images/enterprise/site-admin-settings/hook-script.png) -8. Selecciona **Use the exit-status to accept or reject pushes** (Usar el estado de salida para aceptar o rechazar subidas) para imponer tu script. Al quitar la marca de selección de esta opción podrás probar el script mientras se ignora el valor del estado de salida. En este modo, el resultado del script estará visible para el usuario en la línea de comando, pero no en la interfaz web. ![Usar el estado de salida](/assets/images/enterprise/site-admin-settings/use-exit-status.png) -9. Selecciona **Enable this pre-receive hook on all repositories by default ** (Habilitar este gancho de pre-recepción en todos los repositorios por defecto) si quieres que el gancho de pre-recepción se ejecute en todos los repositorios. ![Habilitar gachos para todos los repositorios](/assets/images/enterprise/site-admin-settings/enable-hook-all-repos.png) -10. Selecciona **Administrators can enable and disable this hook** (Los administradores pueden habilitar e inhabilitar este gancho) para permitir que los miembros de la organización con permisos de administración o propietario seleccionen si desean habilitar o inhabilitar este gancho de pre-recepción. ![Los administradores habilitan o inhabilitan los ganchos](/assets/images/enterprise/site-admin-settings/admins-enable-hook.png) - -### Editar ganchos de pre-recepción - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.hooks-tab %} -1. Junto al gancho de pre-recepción que deseas editar, haz clic en {% octicon "pencil" aria-label="The edit icon" %}. ![Editar pre-recepción](/assets/images/enterprise/site-admin-settings/edit-pre-receive-hook.png) - -### Eliminar ganchos de pre-recepción - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.hooks-tab %} -2. Junto al gancho de pre-recepción que deseas eliminar, haz clic en {% octicon "x" aria-label="X symbol" %}. ![Editar pre-recepción](/assets/images/enterprise/site-admin-settings/delete-pre-receive-hook.png) - -### Configura ganchos de pre-recepción para una organización - -Un administrador de la organización solo puede configurar permisos de gancho para una organización si el administrador del sitio seleccionó la opción **Administrators can enable o disable this hook** (Los administradores pueden habilitar o inhabilitar este gancho) al crear el gancho de pre-recepción. Para configurar ganchos de pre-recepción para un repositorio, debes ser administrador o propietario de una organización. - -{% data reusables.profile.enterprise_access_profile %} -{% data reusables.profile.access_org %} -{% data reusables.organizations.org_settings %} -4. En la barra lateral izquierda, haz clic en **Hooks** (Ganchos). ![Barra lateral de ganchos](/assets/images/enterprise/orgs-and-teams/hooks-sidebar.png) -5. Junto al gancho de pre-recepción que deseas configurar, haz clic en el menú desplegable **Hook permissions** (Permisos del gancho). Selecciona si deseas habilitar o inhabilitar el gancho de pre-recepción o permite que lo configuren los administradores del repositorio. ![Permisos para ganchos](/assets/images/enterprise/orgs-and-teams/hook-permissions.png) - -### Configura ganchos de pre-recepción para un repositorio - -Un propietario de repositorio solo puede configurar un gancho si el administrador del sitio seleccionó la opción **Administrators can enable or disable this hook** (Los administradores pueden habilitar o inhabilitar este gancho) al crear el gancho de pre-recepción. En una organización, el propietario de la organización también debe haber seleccionado el permiso de gancho **Configurable**. Para configurar ganchos de pre-recepción para un repositorio, debes ser propietario del repositorio. - -{% data reusables.profile.enterprise_access_profile %} -2. Haz clic en **Repositories** (Repositorios) y selecciona el repositorio para el que deseas configurar los ganchos de pre-recepción. ![Repositorios](/assets/images/enterprise/repos/repositories.png) -{% data reusables.repositories.sidebar-settings %} -4. En la barra lateral izquierda, haz clic en **Hooks & Services** (Ganchos y Servicios). ![Ganchos y servicios](/assets/images/enterprise/repos/hooks-services.png) -5. Junto al gancho de pre-recepción que deseas configurar, haz clic en el menú desplegable **Hook permissions** (Permisos del gancho). Selecciona si deseas habilitar o inhabilitar el gancho de pre-recepción. ![Permisos para ganchos de repositorios](/assets/images/enterprise/repos/repo-hook-permissions.png) diff --git a/translations/es-XL/content/admin/developer-workflow/managing-projects-using-jira.md b/translations/es-XL/content/admin/developer-workflow/managing-projects-using-jira.md deleted file mode 100644 index 0ebe88b6b728..000000000000 --- a/translations/es-XL/content/admin/developer-workflow/managing-projects-using-jira.md +++ /dev/null @@ -1,55 +0,0 @@ ---- -title: Administrar proyectos mediante JIRA -intro: 'Puedes integrar JIRA con {% data variables.product.prodname_enterprise %} para la administración de proyectos.' -redirect_from: - - /enterprise/admin/guides/installation/project-management-using-jira/ - - /enterprise/admin/articles/project-management-using-jira/ - - /enterprise/admin/developer-workflow/managing-projects-using-jira -versions: - enterprise-server: '*' ---- - -### Conectar JIRA a una organización {% data variables.product.prodname_enterprise %} - -1. Inicia sesión en tu cuenta de {% data variables.product.prodname_enterprise %} en http[s]://[hostname]/login. -1. En el ángulo superior derecho de cualquier página, haz clic en el icono de ajustes (engranaje) de la cuenta. -1. En la barra lateral izquierda, haz clic en el nombre de tu organización. -1. En la barra lateral izquierda, haz clic en **Applications** (Aplicaciones). -1. En el ángulo superior derecho del cuadro **Organization applications** (Aplicaciones de la organización), haz clic en **Register new application** (Registrar aplicación nueva). -1. Completa los parámetros de la aplicación: - - En el campo **Application name** (Nombre de la aplicación), escribe "JIRA". - - En el campo **Homepage URL** (URL de inicio de sesión), escribe la URL completa de tu instancia JIRA. - - En el campo **Authorization callback URL** (URL de devolución de llamada de autorización), escribe la URL completa de tu instancia JIRA. -1. Haz clic en **Register application** (Registrar aplicación). -1. En la parte inferior de la página, observa el **Client ID** (ID de cliente) y **Client Secret** (Secreto de cliente). Necesitarás estos datos para configurar tu instancia JIRA. - -### Conectar JIRA a tu cuenta personal de {% data variables.product.prodname_enterprise %} - -1. Inicia sesión en tu cuenta de {% data variables.product.prodname_enterprise %} en http[s]://[hostname]/login. -1. En el ángulo superior derecho de cualquier página, haz clic en el icono de ajustes (engranaje) de la cuenta. -1. En la barra lateral izquierda, haz clic en **Applications** (Aplicaciones). -1. En el ángulo superior derecho del cuadro **Developer applications** (Aplicaciones del programador), haz clic en **Register new application** (Registrar aplicación nueva). -1. Completa los parámetros de la aplicación: - - En el campo **Application name** (Nombre de la aplicación), escribe "JIRA". - - En el campo **Homepage URL** (URL de inicio de sesión), escribe la URL completa de tu instancia JIRA. - - En el campo **Authorization callback URL** (URL de devolución de llamada de autorización), escribe la URL completa de tu instancia JIRA. -1. Haz clic en **Register application** (Registrar aplicación). -1. En la parte inferior de la página, observa el **Client ID** (ID de cliente) y **Client Secret** (Secreto de cliente). Necesitarás estos datos para configurar tu instancia JIRA. - -### Configuración de instancia de JIRA - -1. En tu instancia de JIRA, inicia sesión en una cuenta con acceso administrativo. -1. En la parte superior de la página, haz clic en el icono de ajustes (engranaje). -1. En el desplegable de los parámetros, elige **Add-ons** (Adicionales). -1. En la barra lateral izquierda, debajo de **Source control** (Control de origen), haz clic en **DVCS accounts** (Cuentas de DVCS). -1. Haz clic en **Link Bitbucket or GitHub account** (Enlazar cuenta de Bitbucket o GitHub). -1. En el modal **Add New Account** (Agregar nueva cuenta), completa tus parámetros de {% data variables.product.prodname_enterprise %}: - - En el menú desplegable **Host**, elige **GitHub Enterprise**. - - En el campo **Team or User Account** (Cuenta de equipo o usuario), escribe el nombre de tu organización {% data variables.product.prodname_enterprise %} o cuenta personal. - - En el campo **OAuth Key** (Clave OAuth), escribe el ID de cliente de tu aplicación de programador de {% data variables.product.prodname_enterprise %}. - - En el campo **OAuth Secret** (OAuth secreto), escribe el secreto de cliente para tu aplicación de programador de {% data variables.product.prodname_enterprise %}. - - Si no quieres vincular los repositorios nuevos que pertenecen a tu organización o cuenta personal de {% data variables.product.prodname_enterprise %}, quita la marca de selección de **Auto Link New Repositories** (Vincular automáticamente repositorios nuevos). - - Si no quieres habilitar las confirmaciones inteligentes, quita la marca de selección **Enable Smart Commits** (Habilitar confirmaciones inteligentes). - - Haz clic en **Add** (Agregar). -1. Revisa los permisos que concedes a tu cuenta de {% data variables.product.prodname_enterprise %} y haz clic en **Authorize application** (Autorizar aplicación). -1. Si es necesario, escribe tu contraseña para continuar. diff --git a/translations/es-XL/content/admin/developer-workflow/troubleshooting-service-hooks.md b/translations/es-XL/content/admin/developer-workflow/troubleshooting-service-hooks.md deleted file mode 100644 index 79a7002b59c8..000000000000 --- a/translations/es-XL/content/admin/developer-workflow/troubleshooting-service-hooks.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: Solución de problemas con ganchos de servicio -intro: 'Si las cargar no se están entregando, comprueba estos problemas comunes.' -redirect_from: - - /enterprise/admin/articles/troubleshooting-service-hooks/ - - /enterprise/admin/developer-workflow/troubleshooting-service-hooks -versions: - enterprise-server: '*' ---- - -### Obtener información sobre las entregas - -Puedes buscar información para la última respuesta de todas las entregas de ganchos de servicio en cualquier repositorio. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -2. Explorar en el repositorio que estás investigando. -3. Haz clic en el enlace **Hooks** (Ganchos) en la barra lateral de navegación. ![Barra lateral de ganchos](/assets/images/enterprise/settings/Enterprise-Hooks-Sidebar.png) -4. Haz clic en el enlace **Latest Delivery** (Última entrega) bajo el gancho de servicio que tiene problemas. ![Detalles de ganchos](/assets/images/enterprise/settings/Enterprise-Hooks-Details.png) -5. En **Remote Calls** (Llamadas remotas), verás los encabezados que se usaron al publicar en el servidor remoto junto con la respuesta que el servidor remoto volvió a enviar a tu instalación. - -### Ver la carga - -{% data reusables.enterprise_site_admin_settings.access-settings %} -2. Explorar en el repositorio que estás investigando. -3. Haz clic en el enlace **Hooks** (Ganchos) en la barra lateral de navegación. ![Barra lateral de ganchos](/assets/images/enterprise/settings/Enterprise-Hooks-Sidebar.png) -4. Haz clic en el enlace **Latest Delivery** (Última entrega) bajo el gancho de servicio que tiene problemas. -5. Haz clic en **Delivery** (Entrega). ![Ver la carga](/assets/images/enterprise/settings/Enterprise-Hooks-Payload.png) - -### Ver entregas anteriores - -Las entregas se almacenan durante 15 días. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -2. Explorar en el repositorio que estás investigando. -3. Haz clic en el enlace **Hooks** (Ganchos) en la barra lateral de navegación. ![Barra lateral de ganchos](/assets/images/enterprise/settings/Enterprise-Hooks-Sidebar.png) -4. Haz clic en el enlace **Latest Delivery** (Última entrega) bajo el gancho de servicio que tiene problemas. -5. Para ver otras entregas para ese gancho específico, haz clic en **More for this Hook ID** (Más para este ID de gancho): ![Ver más entregas](/assets/images/enterprise/settings/Enterprise-Hooks-More-Deliveries.png) diff --git a/translations/es-XL/content/admin/developer-workflow/using-pre-receive-hooks-to-enforce-policy.md b/translations/es-XL/content/admin/developer-workflow/using-pre-receive-hooks-to-enforce-policy.md deleted file mode 100644 index 3024f39f515e..000000000000 --- a/translations/es-XL/content/admin/developer-workflow/using-pre-receive-hooks-to-enforce-policy.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Usar ganchos de pre-recepción para implementar políticas -intro: Usar ganchos de pre-recepción para implementar estándares de flujo de trabajo dentro de tu organización. Los ganchos de pre-recepción requieren un código para aprobar un conjunto de verificaciones de calidad predefinido antes de que la extracción sea aceptada en el repositorio. -mapTopic: true -redirect_from: - - /enterprise/admin/developer-workflow/using-pre-receive-hooks-to-enforce-policy -versions: - enterprise-server: '*' ---- - diff --git a/translations/es-XL/content/admin/developer-workflow/using-webhooks-for-continuous-integration.md b/translations/es-XL/content/admin/developer-workflow/using-webhooks-for-continuous-integration.md deleted file mode 100644 index 98e225dd4f6d..000000000000 --- a/translations/es-XL/content/admin/developer-workflow/using-webhooks-for-continuous-integration.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Usar webhooks para la integración continua -intro: 'Si ya tienes un ecosistema de desarrollo e implementación en curso, puedes integrarlo con el {% data variables.product.prodname_ghe_server %} mediante webhooks.' -mapTopic: true -redirect_from: - - /enterprise/admin/developer-workflow/continuous-integration-using-travis-ci - - /enterprise/admin/developer-workflow/using-webhooks-for-continuous-integration -versions: - enterprise-server: '*' ---- - diff --git a/translations/es-XL/content/admin/enterprise-management/monitoring-using-analytics.md b/translations/es-XL/content/admin/enterprise-management/monitoring-using-analytics.md deleted file mode 100644 index 7259bd94b491..000000000000 --- a/translations/es-XL/content/admin/enterprise-management/monitoring-using-analytics.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: Monitoring using analytics -intro: 'You can enable web analytics tools to track and analyze traffic for your {% data variables.product.prodname_ghe_server %} instance.' -redirect_from: - - /enterprise/admin/enterprise-management/monitoring-using-analytics -versions: - enterprise-server: '>2.21' ---- - -### Configuring Google Analytics - -To configure Google Analytics, you must have a [Google Analytics ID](https://analytics.google.com/) and authenticate to your {% data variables.product.prodname_ghe_server %} instance with SSH. Para obtener más información, consulta "[Acceder al shell administrativo (SSH)](/enterprise/admin/configuration/accessing-the-administrative-shell-ssh)." - -```shell -$ ghe-config website-analytics.enabled true -$ ghe-config website-analytics.google-analytics-id GOOGLE-ANALYTICS-ID -$ ghe-config-apply -``` diff --git a/translations/es-XL/content/admin/installation/about-enterprise-accounts.md b/translations/es-XL/content/admin/installation/about-enterprise-accounts.md deleted file mode 100644 index e46afc0da93d..000000000000 --- a/translations/es-XL/content/admin/installation/about-enterprise-accounts.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: Acerca de las cuentas de empresa -intro: 'Con {% data variables.product.prodname_ghe_server %}, puedes crear una cuenta empresarial para darle a los administradores una visibilidad centralizada y la administración de su uso de licencia y su facturación.' -redirect_from: - - /enterprise/admin/installation/about-enterprise-accounts -versions: - enterprise-server: '*' ---- - -### Acerca de las cuentas empresariales en {% data variables.product.prodname_ghe_server %} - -Una cuenta empresarial te permite administrar varias organizaciones de {% data variables.product.prodname_dotcom %} e instancias de {% data variables.product.prodname_ghe_server %}. Tu cuenta de empresa debe tener un controlador, como una organización o cuenta personal en {% data variables.product.prodname_dotcom %}. Los administradores de empresas pueden administrar los parámetros y las referencias, como: - -- El acceso de los miembros y la administración (miembros de la organización, colaboradores externos). -- Facturación y uso (instancias de {% data variables.product.prodname_ghe_server %}, licencias de usuario, paquetes de {% data variables.large_files.product_name_short %}) -- Seguridad (inicio de sesión único, autenticación de dos factores). -- Solicitudes y paquetes de soporte compartidos con {% data variables.contact.enterprise_support %} - -{% data reusables.enterprise-accounts.enterprise-accounts-billing %} - -Para obtener más información acerca de las diferencias entre {% data variables.product.prodname_ghe_cloud %} y {% data variables.product.prodname_ghe_server %}, consulta la sección "[ productos de {% data variables.product.prodname_dotcom %}](/articles/githubs-products)". Para mejorar tu cuenta a {% data variables.product.prodname_enterprise %} o para comenzar con una cuenta empresarial, contacta a {% data variables.contact.contact_enterprise_sales %}. - -### Administrar las licencias de {% data variables.product.prodname_ghe_server %} enlazadas con tu cuenta empresarial - -{% data reusables.enterprise-accounts.admin-managing-licenses %} diff --git a/translations/es-XL/content/admin/installation/about-geo-replication.md b/translations/es-XL/content/admin/installation/about-geo-replication.md deleted file mode 100644 index 97262cab8db4..000000000000 --- a/translations/es-XL/content/admin/installation/about-geo-replication.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Acerca de la Replicación geográfica -intro: 'La Replicación geográfica en {% data variables.product.prodname_ghe_server %} utiliza múltiples réplicas activas para responder las solicitudes de los centros de datos distribuidos geográficamente.' -redirect_from: - - /enterprise/admin/installation/about-geo-replication -versions: - enterprise-server: '*' ---- - -Contar con múltiples réplicas puede permitir una menor distancia a la réplica más cercana. Por ejemplo, una organización con oficinas en San Francisco, Nueva York y Londres podrían ejecutar el aparato principal en un centro de datos cercano a Nueva York y dos réplicas en centros de datos cercanos a San Francisco y Londres. Al usar DNS con información de geolocalización, se puede dirigir a los usuarios al servidor disponible más cercano para que accedan a los datos más rápido. Designar como principal el aparato cercano a Nueva York ayuda a reducir la latencia entre los hosts, a diferencia de si se designa como principal el aparato cercano a San Francisco, que tiene mayor latencia con Londres. - -Los proxies de la réplica activa solicitan que no se pueda procesar esta misma para la instancia principal. Las réplicas funcionan como un punto de presencia al terminar todas las conexiones SSL. El tráfico entre los servidores se envía a través de una conexión VPN encriptada, similar a una configuración de dos nodos de alta disponibilidad sin replicación geográfica. - -Las solicitudes de Git y las solicitudes del servidor de archivo, como LFS y las cargas de archivos, se pueden atender directamente desde la réplica sin cargar ningún dato desde el principal. Las solicitudes web siempre se enrutan hacia el principal, pero si la réplica está más cerca del usuario, las solicitudes son más rápidas porque la terminación SSL está más cerca. - -Se solicita un DNS geográfico, como [Amazon's Route 53 service](http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-geo), para que la replicación geográfica funcione sin problemas. El nombre del host para la instancia se debe resolver con la réplica más cercana a la ubicación del usuario. - -### Limitaciones - -Escribir solicitudes para la réplica exige que se envíen los datos al principal y a todas las réplicas. Esto significa que el rendimiento de todas las escrituras está limitado por la réplica más lenta {% if currentVersion ver_gt "enterprise-server@2.17" %}, aunque las nuevas réplicas geográficas pueden poblar la mayoría de sus datos de las réplicas geográficas ubicadas en el mismo lugar, en lugar del primario{% endif %}. La replicación geográfica no le agregará capacidad a una instancia de {% data variables.product.prodname_ghe_server %} ni resolverá problemas de rendimiento relacionados con recursos de CPU o de memoria insuficientes. Si el aparato principal está fuera de línea, las réplicas activas no podrán atender ninguna solicitud de lectura o escritura. - -### Monitorear la configuración de una replicación geográfica - -{% data reusables.enterprise_installation.monitoring-replicas %} - -### Leer más -- "[Crear réplicas de replicación geográfica](/enterprise/{{ currentVersion }}/admin/guides/installation/creating-a-high-availability-replica/#creating-geo-replication-replicas)" diff --git a/translations/es-XL/content/admin/installation/about-high-availability-configuration.md b/translations/es-XL/content/admin/installation/about-high-availability-configuration.md deleted file mode 100644 index 5f4480f0b7f3..000000000000 --- a/translations/es-XL/content/admin/installation/about-high-availability-configuration.md +++ /dev/null @@ -1,181 +0,0 @@ ---- -title: Acerca de la configuración de alta disponibilidad -intro: 'En una configuración de alta disponibilidad, un aparato secundario {% data variables.product.prodname_ghe_server %} totalmente redundante se mantiene en sincronización con el aparato principal mediante la replicación de todos los almacenes de datos importantes.' -redirect_from: - - /enterprise/admin/installation/about-high-availability-configuration -versions: - enterprise-server: '*' ---- - -Cuando configuras la alta disponibilidad, hay una configuración automática unidireccional, una replicación asincrónica de todos los almacenes de datos (repositorios de Git, MySQL, Redis y Elasticsearch) desde el aparato principal hacia la réplica. - -{% data variables.product.prodname_ghe_server %} admite una configuración activa/pasiva, en la que el aparato réplica se ejecuta como en un modo de espera con los servicios de base de datos ejecutándose en modo de replicación, pero con los servicios de aplicación detenidos. - -### Escenarios de fallas específicas - -Utiliza la configuración de alta disponibilidad para la protección contra lo siguiente: - -{% data reusables.enterprise_installation.ha-and-clustering-failure-scenarios %} - -Una configuración de alta disponibilidad no es una buena solución para lo siguiente: - - - **Escalar**. Mientras que puede distribuir el tráfico geográficamente utilizando la replicación geográfica, el rendimiento de las escrituras queda limitado a la velocidad y la disponibilidad del aparato principal. Para obtener más informació, consulta "[Acerca de la replicación geográfica](/enterprise/{{ currentVersion }}/admin/guides/installation/about-geo-replication/)." - - **Generar copias de seguridad de tu aparato principal**. Una réplica de alta disponibilidad no reemplaza las copias de seguridad externas en tu plan de recuperación ante desastres. Algunas formas de corrupción o pérdida de datos se pueden replicar de inmediato desde el aparato principal hacia la réplica. Para asegurar una reversión segura a un estado antiguo estable, debes realizar copias de seguridad de rutina con instantáneas históricas. - - **Actualizaciones del tiempo de inactividad en cero**. Para evitar la pérdida de datos y las situaciones de cerebro dividido en escenarios de promoción controlados, coloca el aparato principal en el modo de mantenimiento y espera a que se completen todas las escrituras entes de promover la réplica. - -### Estrategias de conmutación por error del tráfico de red - -Durante la conmutación por error, debes configurar por separado y administrar el tráfico de red de redireccionamiento desde el aparato principal hacia la réplica. - -#### Conmutación por error de DNS - -Con la conmutación por error de DNS, utiliza valores TTL cortos en los registros DNS que se dirijan al aparato principal {% data variables.product.prodname_ghe_server %}. Recomendamos un TTL de entre 60 segundos y cinco minutos. - -Durante la conmutación por error, debes colocar el aparato principal en modo de mantenimiento y redirigir sus registros DNS hacia la dirección IP del aparato réplica. El tiempo necesario para redirigir el tráfico desde el aparato principal hacia la réplica dependerá de la configuración TTL y del tiempo necesario para actualizar los registros DNS. - -Si estás utilizando la replicación geográfica, debes configurar Geo DNS en tráfico directo hacia la réplica más cercana. Para obtener más informació, consulta "[Acerca de la replicación geográfica](/enterprise/{{ currentVersion }}/admin/guides/installation/about-geo-replication/)." - -#### Balanceador de carga - -{% data reusables.enterprise_clustering.load_balancer_intro %} {% data reusables.enterprise_clustering.load_balancer_dns %} - -Durante la conmutación por error, debes colocar el aparato principal en el modo de mantenimiento. Puedes configurar el balanceador de carga para que detecte automáticamente cuando la réplica se haya promovido a principal, o puede que se requiera un cambio de configuración manual. Debes promover manualmente la réplica a principal antes de que responda al tráfico de usuarios. Para obtener más información, consulta "[Utilizar {% data variables.product.prodname_ghe_server %} con un balanceador de carga](/enterprise/{{ currentVersion }}/admin/guides/installation/using-github-enterprise-server-with-a-load-balancer/)." - -{% data reusables.enterprise_installation.monitoring-replicas %} - -### Utilidades para la administración de la replicación - -Para administrar la replicación en {% data variables.product.prodname_ghe_server %}, haz uso de estas utilidades de la línea de comando conectándote al aparato réplica con SSH. - -#### ghe-repl-setup - -El comando `ghe-repl-setup` coloca un aparato {% data variables.product.prodname_ghe_server %} en modo de espera de réplica. - - - Un túnel cifrado {% if currentVersion ver_gt "enterprise-server@2.17" %}WireGuard VPN{% else %}OpenVPN{% endif %} está configurado para la comunicación entre los dos aparatos. - - Se configuran los servicios de bases de datos para la replicación y se inician. - - Se inhabilitan los servicios de aplicaciones. Los intentos de acceder al aparato réplica por HTTP, Git u otros protocolos compatibles generarán una página de mantenimiento o un mensaje de error de "aparato en modo réplica". - -```shell -admin@169-254-1-2:~$ ghe-repl-setup 169.254.1.1 -Verificar la conectividad ssh con 169.254.1.1 ... -Comprobación de conexión exitosa. -Configurando la replicación de base de datos en oposición al principal... -Exitoso: El modo réplica está configurado para 169.254.1.1. -Para inhabilitar el modo réplica y deshacer estos cambios, ejecuta `ghe-repl-teardown'. -Ejecuta `ghe-repl-start' para comenzar la replicación en oposición al principal recientemente configurado. -``` - -#### ghe-repl-start - -El comando `ghe-repl-start` inicia la replicación activa de todos los almacenes de datos. - -```shell -admin@169-254-1-2:~$ ghe-repl-start{% if currentVersion ver_lt "enterprise-server@2.18" %} -Starting OpenVPN tunnel ... {% endif %} -Iniciando la replicación de MySQL... -Iniciando la replicación de Redis... -Iniciando la replicación de ElasticSearch... -Iniciando la replicación de Páginas... -Iniciando la replicación de Git... -Exitoso: La replicación se está ejecutando para todos los servicios. -Utiliza `ghe-repl-status' para monitorear el estado y el progreso de la replicación. -``` - -#### ghe-repl-status - -El comando `ghe-repl-status` muestra un estado de `OK`, `ADVERTENCIA` o `CRÍTICO` para cada corriente de replicación de almacén de datos. Cuando cualquiera de los canales de replicación está en estado `ADVERTENCIA`, el comando se cerrará con el código `1`. Del mismo modo, cuando cualquiera de los canales esté en un estado `CRÍTICO`, el comando se cerrará con el código `2`. - -```shell -admin@169-254-1-2:~$ ghe-repl-status -OK: replicación de mysql en sinc -OK: la replicación de redis está en sinc -OK: la agrupación de elasticsearch está en sinc -OK: los datos de git están en sinc (10 repos, 2 wikis, 5 gists) -OK: los datos de páginas están en sinc -``` - -Las opciones `-v` y `-vv` dan detalles sobre cada uno de los estados de replicación de almacén de datos: - -```shell -$ ghe-repl-status -v -OK: replicación de mysql en sinc - | IO en ejecución: Sí, SQL en ejecución: Sí, Demora: 0 - -OK: la replicación de redis está en sinc - | master_host:169.254.1.1 - | master_port:6379 - | master_link_status:up - | master_last_io_seconds_ago:3 - | master_sync_in_progress:0 - -OK: la agrupación de elasticsearch está en sinc - | { - | "cluster_name" : "github-enterprise", - | "status" : "green", - | "timed_out" : falso, - | "number_of_nodes" : 2, - | "number_of_data_nodes" : 2, - | "active_primary_shards" : 12, - | "active_shards" : 24, - | "relocating_shards" : 0, - | "initializing_shards" : 0, - | "unassigned_shards" : 0 - | } - -OK: los datos de git están en sinc (366 repos, 31 wikis, 851 gists) - | TOTAL OK FALLA PENDIENTE CON DEMORA - | repositorios 366 366 0 0 0.0 - | wikis 31 31 0 0 0.0 - | gists 851 851 0 0 0.0 - | total 1248 1248 0 0 0.0 - -OK: los datos de páginas están en sinc - | Las páginas están en sinc -``` - -#### ghe-repl-stop - -El comando `ghe-repl-stop` inhabilita temporalmente la replicación de todos los almacenes de datos y detiene los servicios de replicación. Para reanudar la replicación, utiliza el comando [ghe-repl-start](#ghe-repl-start). - -```shell -admin@168-254-1-2:~$ ghe-repl-stop -Deteniendo la replicación de Páginas... -Deteniendo la replicación de Git... -Deteniendo la replicación de MySQL... -Deteniendo la replicación de Redis... -Deteniendo la replicación de Elasticsearch ...{% if currentVersion ver_lt "enterprise-server@2.18" %} -Deteniendo el túnel OpenVPN ...{% endif %} -Exitoso: se detuvo la replicación para todos los servicios. -``` - -#### ghe-repl-promote - -El comando `ghe-repl-promote` inhabilita la replicación y convierte el aparato réplica en principal. El aparato se configura con los mismos ajustes que el principal original y se habilitan todos los servicios. - -{% data reusables.enterprise_installation.promoting-a-replica %} - -```shell -admin@168-254-1-2:~$ ghe-repl-promote -Habilitando el modo de mantenimiento en el aparato principal para evitar escrituras... -Deteniendo la replicación... - | Deteniendo la replicación de Páginas... - | Deteniendo la replicación de Git... - | Deteniendo la replicación de MySQL... - | Deteniendo la replicación de Redis... - | Deteniendo la replicación de Elasticsearch ...{% if currentVersion ver_lt "enterprise-server@2.18" %} - | Deteniendo el túnel OpenVPN ...{% endif %} - | Exitoso: se detuvo la replicación para todos los servicios. -Cambiando del modo réplica... - | Exitoso: se eliminó la configuración de la replicación. - | Ejecuta `ghe-repl-setup' para volver a habilitar el modo réplica. -Aplicando la configuración e iniciando los servicios... -Exitoso: la réplica se promovió a principal y ahora está aceptando solicitudes. -``` - -#### ghe-repl-teardown - -El comando `ghe-repl-teardown` inhabilita el modo de replicación por completo, eliminando la configuración de la réplica. - -### Leer más - -- "[Crear una réplica de alta disponibilidad](/enterprise/{{ currentVersion }}/admin/guides/installation/creating-a-high-availability-replica)" diff --git a/translations/es-XL/content/admin/installation/about-the-github-enterprise-server-api.md b/translations/es-XL/content/admin/installation/about-the-github-enterprise-server-api.md deleted file mode 100644 index 001b6aee29a7..000000000000 --- a/translations/es-XL/content/admin/installation/about-the-github-enterprise-server-api.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: Acerca de la API de servidor de GitHub Enterprise -intro: '{% data variables.product.prodname_ghe_server %} admite la misma poderosa API disponible en {% data variables.product.prodname_dotcom_the_website %} y su propio conjunto de puntos de conexión de API.' -redirect_from: - - /enterprise/admin/articles/about-the-enterprise-api/ - - /enterprise/admin/articles/using-the-api/ - - /enterprise/admin/categories/api/ - - /enterprise/admin/installation/about-the-github-enterprise-server-api -versions: - enterprise-server: '*' ---- - -Toda la documentación para la {% data variables.product.prodname_enterprise_api %} se encuentra disponible en . Con la API, puedes automatizar muchas tareas administrativas. Algunos ejemplos incluyen los siguientes: - -- Realizar cambios en {% data variables.enterprise.management_console %}. Para obtener más información, consulta la secicón "[{% data variables.enterprise.management_console %}](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#management-console)". -- Recopila estadísticas acerca de tu instancia. Para obtener más información, consulta la sección "[Estadísticas de administrador](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#admin-stats)." -- Configura la sincronización de LDAP. Para obtener más información, consulta la sección "[LDAP](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#ldap)."{% if currentVersion ver_gt "enterprise-server@2.18" %} -- Administra tu cuenta Enterprise. Para obtener más información, consulta "[Cuentas Enterprise](/v4/guides/managing-enterprise-accounts)"{% endif %} diff --git a/translations/es-XL/content/admin/installation/accessing-the-administrative-shell-ssh.md b/translations/es-XL/content/admin/installation/accessing-the-administrative-shell-ssh.md deleted file mode 100644 index 9abd1b112e6d..000000000000 --- a/translations/es-XL/content/admin/installation/accessing-the-administrative-shell-ssh.md +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: Acceder al shell administrativo (SSH) -redirect_from: - - /enterprise/admin/articles/ssh-access/ - - /enterprise/admin/articles/adding-an-ssh-key-for-shell-access/ - - /enterprise/admin/guides/installation/administrative-shell-ssh-access/ - - /enterprise/admin/articles/troubleshooting-ssh-permission-denied-publickey/ - - /enterprise/admin/2.13/articles/troubleshooting-ssh-permission-denied-publickey/ - - /enterprise/admin/2.14/articles/troubleshooting-ssh-permission-denied-publickey/ - - /enterprise/admin/2.15/articles/troubleshooting-ssh-permission-denied-publickey/ - - /enterprise/admin/installation/accessing-the-administrative-shell-ssh -intro: 'El acceso al SSH te permite ejecutar las utilidades de la línea de comando del {% data variables.product.prodname_ghe_server %} y es útil para la solución de problemas, para ejecutar copias de seguridad y para configurar la replicación.' -versions: - enterprise-server: '*' ---- - -### Acerca del acceso al shell administrativo - -Si tienes acceso SSH al shell administrativo, puedes ejecutar las utilidades de la línea de comando del {% data variables.product.prodname_ghe_server %}. El acceso SSH también es útil para la solución de problemas, para ejecutar copias de seguridad y para configurar la replicación. El acceso SSH administrativo se administra por separado desde el acceso SSH de Git y es accesible solo desde el puerto 122. - -### Habilitar el acceso al shell administrativo por medio de SSH - -Para habilitar el acceso SSH administrativo, debes agregar tu llave pública SSH a tu lista de llaves autorizadas de la instancia. - -{% tip %} - -**Consejo:** Los cambios en las claves SSH entran en vigor de inmediato. - -{% endtip %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -3. En "SSH access" (Acceso SSH), pega tu clave en el cuadro de texto, luego haz clic en **Add key** (Agregar clave). ![Cuadro te texto y botón para agregar una clave SSH](/assets/images/enterprise/settings/add-authorized-ssh-key-admin-shell.png) -{% data reusables.enterprise_management_console.save-settings %} - -### Conectarse con el shell administrativo por SSH - -Después de que hayas agregado tu clave SSH a la lista, conéctate a la instancia por SSH como el usuario `admin` en el puerto 122. - -```shell -$ ssh -p 122 admin@github.example.com -Último inicio de sesión: dom 9 de nov 07:53:29 2014 desde 169.254.1.1 -admin@github-example-com:~$ █ -``` - -#### Solucionar problemas de conexión al SSH - -Si te encuentras con el error `Permiso denegado (publickey)` cuando intentas conectarte a {% data variables.product.product_location_enterprise %} por medio de SSH, confirma que te estés conectando por el puerto 122. Puede que debas especificar de manera explícita qué clave SSH privada utilizar. - -Para especificar una clave SSH utilizando la línea de comando, ejecuta `ssh` con el argumento `-i`. - -```shell -ssh -i /path/to/ghe_private_key -p 122 admin@hostname -``` - -También puedes especificar una clave SSH privada utilizando el archivo de configuración de SSH (`~/.ssh/config`). - -```shell -Host hostname - IdentityFile /path/to/ghe_private_key - Usuario Admin - Puerto 122 -``` - -### Acceder al shell administrativo utilizando la consola local - -En una situación de emergencia, por ejemplo, si el SSH no está disponible, puedes acceder al shell administrativo de manera local. Inicia sesión como usuario `admin` y utiliza la contraseña establecida durante la configuración inicial de {% data variables.product.prodname_ghe_server %}. - -### Limitaciones de acceso al shell administrativo - -El acceso al shell administrativo se permite solo para la solución de problemas y para realizar procedimientos de operaciones documentadas. Si modificas archivos del sistema y de la aplicación, ejecutas programas o instalas paquetes de software incompatibles se puede invalidar tu contrato de asistencia. Contáctate con {% data variables.contact.contact_ent_support %} si tienes alguna pregunta acerca de las actividades que permite tu contrato de asistencia. diff --git a/translations/es-XL/content/admin/installation/accessing-the-management-console.md b/translations/es-XL/content/admin/installation/accessing-the-management-console.md deleted file mode 100644 index 53d25a331da4..000000000000 --- a/translations/es-XL/content/admin/installation/accessing-the-management-console.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: Acceder a la Consola de administración -intro: 'Utiliza la {% data variables.enterprise.management_console %} para configurar y establecer {% data variables.product.product_location %}, programa las ventanas de mantenimiento, soluciona problemas y administra tu licencia.' -redirect_from: - - /enterprise/admin/articles/about-the-management-console/ - - /enterprise/admin/articles/management-console-for-emergency-recovery/ - - /enterprise/admin/articles/web-based-management-console/ - - /enterprise/admin/categories/management-console/ - - /enterprise/admin/articles/accessing-the-management-console/ - - /enterprise/admin/guides/installation/web-based-management-console/ - - /enterprise/admin/installation/accessing-the-management-console -versions: - enterprise-server: '*' ---- - -### Acerca de {% data variables.enterprise.management_console %} - -Utiliza {% data variables.enterprise.management_console %} para las actividades administrativas básicas: -- **Configuración inicial**: Atraviesa el proceso de configuración inicial durante el primer lanzamiento {% data variables.product.product_location_enterprise %} visitando la dirección IP de {% data variables.product.product_location_enterprise %} en tu navegador. -- **Establecer configuraciones básicas para tu instancia**: Configura DNS, nombre del host, SSL, autenticación de usuario, correo electrónico, servicios de monitoreo y redireccionamiento de registro en la página de Configuraciones. -- **Programar ventanas de mantenimiento**: Trabaja sin conexión en tu {% data variables.product.product_location_enterprise %} mientras realizas mantenimiento con {% data variables.enterprise.management_console %} o el shell administrativo. -- **Solucionar problemas**: Genera un paquete de soporte o visualiza la información de diagnóstico de alto nivel. -- **Administración de licencias**: Visualiza o actualiza tu licencia {% data variables.product.prodname_enterprise %}. - -También puedes acceder a {% data variables.enterprise.management_console %} utilizando la dirección IP de {% data variables.product.product_location_enterprise %}, incluso cuando la instancia se encuentre en modo de mantenimiento o si ocurre una falla crítica en la aplicación o si están mal configurados el nombre del host o la SSL. - -Para acceder a {% data variables.enterprise.management_console %}, debes utilizar la contraseña de administrador establecida durante la configuración inicial de {% data variables.product.product_location_enterprise %}. También debes poder conectarte con el host de la máquina virtual en el puerto 8443. Si tienes problemas para acceder a {% data variables.enterprise.management_console %}, controla las configuraciones del firewall intermedio y del grupo de seguridad. - -### Acceder a la {% data variables.enterprise.management_console %} como administrador del sitio - -La primera vez que accedas a {% data variables.enterprise.management_console %} como administrador del sitio, debes cargar tu archivo de licencia de {% data variables.product.prodname_enterprise %} para autenticarte en la aplicación. Para obtener más información, consulta "[Administrar tu licencia de {% data variables.product.prodname_enterprise %}](/enterprise/{{ currentVersion }}/admin/guides/installation/managing-your-github-enterprise-server-license)." - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.type-management-console-password %} - -### Acceder a {% data variables.enterprise.management_console %} como usuario sin autenticación - -1. Visita esta URL en tu navegador, reemplazando el `nombre del host` por tu nombre del host o tu dirección IP actuales {% data variables.product.prodname_ghe_server %}: - ```shell - http(s)://HOSTNAME/setup - ``` -{% data reusables.enterprise_management_console.type-management-console-password %} - -### Desbloquear {% data variables.enterprise.management_console %} después de los intentos de inicio de sesión fallidos - -Los bloqueos de la {% data variables.enterprise.management_console %} después de diez intentos de inicio de sesión fallidos se hacen en el transcurso de diez minutos. Debes esperar para que la pantalla de inicio de sesión se desbloquee automáticamente antes de intentar iniciar sesión nuevamente. La pantalla de inicio de sesión se desbloquea automáticamente siempre que el período de diez minutos previo contenga menos de diez intentos de inicio de sesión fallidos. El contador se reinicia después de que ocurra un inicio de sesión exitoso. - -Para desbloquear de inmediato la {% data variables.enterprise.management_console %}, utilice el comando `ghe-reactivate-admin-login` a través del shell administrativo. Para obtener más información, consulta "[Utilidades de la línea de comando](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities#ghe-reactivate-admin-login)" y "[Acceder al shell administrativo (SSH)](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-administrative-shell-ssh/)." diff --git a/translations/es-XL/content/admin/installation/accessing-the-monitor-dashboard.md b/translations/es-XL/content/admin/installation/accessing-the-monitor-dashboard.md deleted file mode 100644 index 99b34f2aed93..000000000000 --- a/translations/es-XL/content/admin/installation/accessing-the-monitor-dashboard.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: Acceder al tablero del monitor -intro: '{% data variables.product.prodname_ghe_server %} incluye un tablero de monitoreo en la web que muestra los datos históricos sobre tu aparato {% data variables.product.prodname_ghe_server %}, como la CPU y el uso del almacenamiento, los tiempos de respuesta de la aplicación y de la autenticación y la salud general del sistema.' -redirect_from: - - /enterprise/admin/installation/accessing-the-monitor-dashboard -versions: - enterprise-server: '*' ---- - -### Acceder al tablero del monitor - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -2. En la parte superior de la página, haga clic en **Monitor**. ![Enlace al Tablero del monitor](/assets/images/enterprise/management-console/monitor-dash-link.png) - -### Solucionar problemas de la asignación de los recursos comunes en su aparato - -{% note %} - -**Nota**: Porque el sondeo regular de {% data variables.product.product_location_enterprise %} con integración continua (CI) o la construcción de servidores puede causar efectivamente un rechazo del ataque al servicio que genera problemas, te recomendamos que utilice webhooks para subir las actualizaciones. Para obtener más información, consulte "[Acerca de webhooks](/enterprise/{{ currentVersion }}/user/articles/about-webhooks/)". - -{% endnote %} - -Utiliza el tablero del monitor para mantenerse informado sobre la salud del recurso de su aparato y tomar decisiones sobre cómo corregir los problemas de alto uso. - -| Problema | Posible(s) causa(s) | Recomendaciones | -| ------------------------------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Alto uso de la CPU | Conexión a la VM desde otros servicios o programas que se ejecutan en el mismo host | De ser posible, vuelve a configurar los otros servicios o programas para utilizar menos recursos de la CPU. Para aumentar los recursos totales de la CPU para la VM, consulte "[Aumentar los recursos de CPU o de memoria](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)." | -| Alto uso de la memoria | Conexión a la VM desde otros servicios o programas que se ejecutan en el mismo host | De ser posible, vuelve a configurar otros servicios o programas para utilizar menos memoria. Para aumentar la memoria total disponible en la VM, consulta "[Aumentar los recursos de CPU o de memoria](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)." | -| Baja disponibilidad de espacio en el disco | Binarios grandes o archivos de registro que consumen espacio del disco | De ser posible, aloje los binarios grandes en un servidor separado y comprima o archive los archivos de registro. De ser necesario, aumenta el espacio del disco en la VM siguiendo los pasos de tu plataforma en "[Aumentar la capacidad de almacenamiento](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-storage-capacity/)." | -| Tiempos de respuesta más altos que lo común | Los suelen causar alguna de las propuestas anteriores | Identifica y corrige las propuestas subyacentes. Si los tiempos de respuesta siguen altos, contáctate con {% data variables.contact.contact_ent_support %}. | -| Índices de error elevados | Propuestas de software | Contáctate con {% data variables.contact.contact_ent_support %} e incluye tu paquete de soporte. Para obtener más información, consulta "[Proporcionar datos para {% data variables.product.prodname_enterprise %} Asistencia](/enterprise/{{ currentVersion}}/admin/guides/enterprise-support/providing-data-to-github-support#creating-and-sharing-support-bundles)." | diff --git a/translations/es-XL/content/admin/installation/activity-dashboard.md b/translations/es-XL/content/admin/installation/activity-dashboard.md deleted file mode 100644 index f9715b432732..000000000000 --- a/translations/es-XL/content/admin/installation/activity-dashboard.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: Tablero de actividades -intro: 'El Tablero de actividades te ofrece un resumen de todas las actividades de {% data variables.product.product_location_enterprise %}.' -redirect_from: - - /enterprise/admin/articles/activity-dashboard/ - - /enterprise/admin/installation/activity-dashboard -versions: - enterprise-server: '*' ---- - -El Tablero de actividades te proporciona gráficos semanales, mensuales y anuales de la cantidad de: -- Solicitudes de extracción nuevas -- Solicitudes de extracción fusionadas -- Problemas nuevos -- Problemas resueltos -- Comentarios de problemas nuevos -- Repositorios nuevos -- Cuentas de usuario nuevas -- Organizaciones nuevas -- Equipos nuevos - -![Tablero de actividades](/assets/images/enterprise/activity/activity-dashboard-yearly.png) - -Para más análisis basados en los datos de {% data variables.product.prodname_enterprise %}, puede comprar {% data variables.product.prodname_insights %}. Para obtener más información, consulta "[Acerca de {% data variables.product.prodname_insights %}](/insights/installing-and-configuring-github-insights/about-github-insights)." - -### Acceder al Tablero de actividades - -1. En la parte superior de cualquier página, haz clic en **Explore** (Explorar). ![Explorar la etiqueta](/assets/images/enterprise/settings/ent-new-explore.png) -2. En el margen izquierdo superior, haz clic en **Activity** (Actividad). ![Botón de actividades](/assets/images/enterprise/activity/activity-button.png) diff --git a/translations/es-XL/content/admin/installation/audit-logging.md b/translations/es-XL/content/admin/installation/audit-logging.md deleted file mode 100644 index 87ff86bd10b7..000000000000 --- a/translations/es-XL/content/admin/installation/audit-logging.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: Registro de auditoría -intro: '{% data variables.product.prodname_enterprise %} mantiene registros usuarios, organizaciones, repositorios y eventos del sistema auditados. Los registros son útiles para la depuración y el cumplimiento interno y externo.' -redirect_from: - - /enterprise/admin/articles/audit-logging/ - - /enterprise/admin/installation/audit-logging -versions: - enterprise-server: '*' ---- - -Para acceder a una lista completa, consulta "[Acciones auditadas](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions)". Para obtener más información para encontrar una acción particular, consulta "[Buscar el registro de auditoría](/enterprise/{{ currentVersion }}/admin/guides/installation/searching-the-audit-log)". - -### Subir registros - -Se registra cada operación de inserción de Git. Para obtener más información, consulta "[Ver registros de inserciones](/enterprise/{{ currentVersion }}/admin/guides/installation/viewing-push-logs)." - -### Eventos del sistema - -Todos los eventos del sistema auditados, incluidas las inserciones y las extracciones, se registran en `/var/log/github/audit.log`. Los registros se rotan automáticamente cada 24 horas y se mantienen durante siete días. - -El paquete de soporte incluye registros del sistema. Para obtener más información, consulta "[Proporcionar datos a {% data variables.product.prodname_dotcom %} Asistencia](/enterprise/{{ currentVersion }}/admin/guides/enterprise-support/providing-data-to-github-support)." - -### Paquete de soporte - -Toda la información de auditoría se registra en el archivo `audit.log` del directorio de `github-logs` de cualquier paquete de soporte. Si está habilitado el redireccionamiento de registro, puedes transmitirle estos datos a un consumidor de flujo syslog externo como [Splunk](http://www.splunk.com/) o [Logstash](http://logstash.net/). Todas las entradas de este registro utilizan la palabra clave `github_audit` y se pueden filtrar con ella. Para obtener más información, consulta "[Redireccionamiento de registro](/enterprise/{{ currentVersion }}/admin/guides/installation/log-forwarding)." - -Por ejemplo, esta entrada muestra que se creó un repositorio nuevo. - -``` -Oct 26 01:42:08 github-ent github_audit: {:created_at=>1351215728326, :actor_ip=>"10.0.0.51", :data=>{}, :user=>"some-user", :repo=>"some-user/some-repository", :actor=>"some-user", :actor_id=>2, :user_id=>2, :action=>"repo.create", :repo_id=>1, :from=>"repositories#create"} -``` - -Este ejemplo muestra que las confirmaciones se subieron a un repositorio. - -``` -Oct 26 02:19:31 github-ent github_audit: { "pid":22860, "ppid":22859, "program":"receive-pack", "git_dir":"/data/repositories/some-user/some-repository.git", "hostname":"github-ent", "pusher":"some-user", "real_ip":"10.0.0.51", "user_agent":"git/1.7.10.4", "repo_id":1, "repo_name":"some-user/some-repository", "transaction_id":"b031b7dc7043c87323a75f7a92092ef1456e5fbaef995c68", "frontend_ppid":1, "repo_public":true, "user_name":"some-user", "user_login":"some-user", "frontend_pid":18238, "frontend":"github-ent", "user_email":"some-user@github.example.com", "user_id":2, "pgroup":"github-ent_22860", "status":"post_receive_hook", "features":" report-status side-band-64k", "received_objects":3, "receive_pack_size":243, "non_fast_forward":false, "current_ref":"refs/heads/master" } -``` diff --git a/translations/es-XL/content/admin/installation/audited-actions.md b/translations/es-XL/content/admin/installation/audited-actions.md deleted file mode 100644 index f671eccda104..000000000000 --- a/translations/es-XL/content/admin/installation/audited-actions.md +++ /dev/null @@ -1,133 +0,0 @@ ---- -title: Acciones auditadas -intro: Puedes buscar el registro de auditoría para una gran variedad de acciones. -redirect_from: - - /enterprise/admin/articles/audited-actions/ - - /enterprise/admin/installation/audited-actions -versions: - enterprise-server: '*' ---- - -#### Autenticación - -| Nombre | Descripción | -| ------------------------------------:| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `oauth_access.create` | Un [Token de acceso de OAuth](/v3/oauth/) fue [generado](/articles/creating-an-access-token-for-command-line-use) para la cuenta de un usuario. | -| `oauth_access.destroy` | Un [Token de acceso de OAuth](/v3/oauth/) se eliminó de la cuenta de un usuario. | -| `oauth_application.destroy` | Una [Aplicación de OAuth](/guides/basics-of-authentication/#registering-your-app) se eliminó de la cuenta de un usuario o de una organización. | -| `oauth_application.reset_secret` | Se restableció una [clave secreta de una aplicación de OAuth](/guides/basics-of-authentication/#registering-your-app). | -| `oauth_application.transfer` | Una [aplicación de OAuth](/guides/basics-of-authentication/#registering-your-app) se transfirió de una cuenta de usuario o de organización a otra. | -| `public_key.create` | Una clave SSH se [agregó](/articles/adding-a-new-ssh-key-to-your-github-account) a una cuenta de usuario o una [llave de implementación](/guides/managing-deploy-keys/#deploy-keys) se agregó a un repositorio. | -| `public_key.delete` | Una clave SSH se eliminó de una cuenta de usuario o una [llave de implementación](/guides/managing-deploy-keys/#deploy-keys) se eliminó de un repositorio. | -| `public_key.update` | La clave SSH de una cuenta de usuario o la llave de implementación de un [repositorio](/guides/managing-deploy-keys/#deploy-keys) se actualizó. | -| `two_factor_authentication.enabled` | [Se habilitó la autenticación de dos factores](/articles/about-two-factor-authentication) para una cuenta de usuario. | -| `two_factor_authentication.disabled` | [Se inhabilitó la autenticación de dos factores](/articles/about-two-factor-authentication) para una cuenta de usuario. | - -#### Ganchos - -| Nombre | Descripción | -| ---------------------:| --------------------------------------------------- | -| `hook.create` | Se agregó un enlace nuevo a un repositorio. | -| `hook.config_changed` | Se cambió la configuración de un enlace. | -| `hook.destroy` | Se eliminó un enlace. | -| `hook.events_changed` | Se cambiaron los eventos configurados de un enlace. | - -#### Ajustes de configuración de la instancia - -| Nombre | Descripción | -| -------------------------------------------------------:| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `business.update_member_repository_creation_permission` | Un administrador del sitio restringe la creación de repositorios en las organizaciones de la instancia. Para obtener más información, consulta "[Restringir la creación de repositorios en tu instancia](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)." | -| `business.clear_members_can_create_repos` | Un administrador del sitio elimina una restricción de creación de repositorios en las organizaciones de la instancia. Para obtener más información, consulta "[Restringir la creación de repositorios en tu instancia](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)." | -| `enterprise.config.lock_anonymous_git_access` | Un administrador del sitio bloquea el acceso de lectura anónimo de Git para evitar que los administradores del repositorio cambien las configuraciones existentes de acceso de lectura anónimo de Git para los repositorios de la instancia. Para obtener más información, consulta "[Evitar que los usuarios cambien el acceso de lectura anónimo de Git](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)." | -| `enterprise.config.unlock_anonymous_git_access` | Un administrador del sitio desbloquea el acceso de lectura anónimo de Git para permitir que los administradores del repositorio cambien las configuraciones existentes de acceso de lectura anónimo de Git para los repositorios de la instancia. Para obtener más información, consulta "[Evitar que los usuarios cambien el acceso de lectura anónimo de Git](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)." | - -#### Propuestas y solicitudes de extracción - -| Nombre | Descripción | -| ------------------------------------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `issue.update` | Cambió el texto del cuerpo de un problema (comentario inicial). | -| `issue_comment.update` | Cambió un comentario sobre un problema (diferente al inicial). | -| `pull_request_review_comment.delete` | Se eliminó un comentario de una solicitud de extracción. | -| `issue.destroy` | Se eliminó un problema del repositorio. Para obtener más información, consulta "[Eliminar un problema](/enterprise/{{ currentVersion }}/user/articles/deleting-an-issue)." | - -#### Organizaciones - -| Nombre | Descripción | -| ------------------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `org.async_delete` | Un usuario inició una tarea en segundo plano para eliminar una organización. | -| `org.delete` | Se eliminó una organización con una tarea de segundo plano iniciada por un usuario. | -| `org.transform` | Una cuenta de usuario se convirtió en una organización. Para obtener más información, consulta [Convertir un usuario en una organización](/enterprise/{{ currentVersion}}/user/articles/converting-a-user-into-an-organization/). | - -#### Ramas protegidas - -| Nombre | Descripción | -| ------------------------------------------------------------------:| ------------------------------------------------------------------------------------------------------ | -| `protected_branch.create` | La protección de rama está habilitada para una rama. | -| `protected_branch.destroy` | La protección de rama está inhabilitada para una rama. | -| `protected_branch.update_admin_enforced` | La protección de rama es obligatoria para los administradores de repositorios. | -| `protected_branch.update_require_code_owner_review` | El cumplimiento de la revisión obligatoria del propietario del código está actualizado para una rama. | -| `protected_branch.dismiss_stale_reviews` | El cumplimiento de las solicitudes de extracción en espera descartadas está actualizado para una rama. | -| `protected_branch.update_signature_requirement_enforcement_level` | El cumplimiento de la firma de confirmación obligatoria está actualizado para una rama. | -| `protected_branch.update_pull_request_reviews_enforcement_level` | El cumplimiento de la revisión obligatoria de solicitud de extracción está actualizado para una rama. | -| `protected_branch.update_required_status_checks_enforcement_level` | El cumplimiento de las verificaciones de estado obligatorias está actualizado para una rama. | -| `protected_branch.rejected_ref_update` | Se rechaza el intento de actualización de una rama. | -| `protected_branch.policy_override` | Un administrador de repositorios anula el requisito de protección de una rama. | - -#### Repositorios - -| Nombre | Descripción | -| ------------------------------------------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `repo.access` | Un repositorio privado se volvió público, o un repositorio público se volvió privado. | -| `repo.archive` | Se archivó un repositorio. Para obtener más información, consulta [Archivar y dejar de archivar repositorios](/enterprise/{{ currentVersion }}/admin/guides/user-management/archiving-and-unarchiving-repositories/). | -| `repo.add_member` | Se agregó un colaborador a un repositorio. | -| `repo.config` | Un administrador de sitio bloqueó los empujes forzados. Para obtener más información, consulta [Bloquear los empujes forzados para un repositorio](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository/) para un repositorio. | -| `repo.create` | Se creó un repositorio. | -| `repo.destroy` | Se eliminó un repositorio. | -| `repo.remove_member` | Se eliminó un colaborador de un repositorio. | -| `repo.rename` | Se renombró un repositorio. | -| `repo.transfer` | Un usuario aceptó una solicitud para recibir un repositorio transferido. | -| `repo.transfer_start` | Un usuario envió una solicitud para transferir un repositorio a otro usuario u organización. | -| `repo.unarchive` | Un repositorio dejó de estar archivado. Para obtener más información, consulta [Archivar y dejar de archivar repositorios](/enterprise/{{ currentVersion }}/admin/guides/user-management/archiving-and-unarchiving-repositories/). | -| `repo.config.disable_anonymous_git_access` | El acceso de lectura anónimo de Git está inhabilitado para un repositorio público. Para obtener más información, consulta "[Habilitar acceso de lectura anónimo de Git para un repositorio](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)." | -| `repo.config.enable_anonymous_git_access` | El acceso de lectura anónimo de Git está habilitado para un repositorio público. Para obtener más información, consulta "[Habilitar acceso de lectura anónimo de Git para un repositorio](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)." | -| `repo.config.lock_anonymous_git_access` | La configuración del acceso de lectura anónimo de Git para un repositorio está bloqueada, lo cual evita que los administradores de repositorios cambien (habiliten o deshabiliten) esta configuración. Para obtener más información, consulta "[Evitar que los usuarios cambien el acceso de lectura anónimo de Git](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)." | -| `repo.config.unlock_anonymous_git_access` | La configuración del acceso de lectura anónimo de Git para un repositorio está desbloqueada, lo cual permite que los administradores del repositorio cambien (habiliten o inhabiliten) esta configuración. Para obtener más información, consulta "[Evitar que los usuarios cambien el acceso de lectura anónimo de Git](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)." | - -#### Herramientas del admin del sitio - -| Nombre | Descripción | -| --------------------:| ------------------------------------------------------------------------------------------------------------------------------- | -| `staff.disable_repo` | Un administrador del sitio inhabilitó el acceso a un repositorio y a todas sus bifurcaciones. | -| `staff.enable_repo` | Un administrador del sitio volvió a habilitar el acceso a un repositorio y a todas sus bifurcaciones. | -| `staff.fake_login` | Un administrador del sitio inició sesión en {% data variables.product.prodname_enterprise %} como otro usuario. | -| `staff.repo_unlock` | Un administrador del sitio desbloqueó (obtuvo acceso total de manera temporaria) uno de los repositorios privados del usuario. | -| `staff.unlock` | Un administrador del sitio desbloqueó (obtuvo acceso total de manera temporaria) todos los repositorios privados de un usuario. | - -#### Equipos - -| Nombre | Descripción | -| --------------:| ------------------------------------------------------------ | -| `team.create` | Se agregó una cuenta de usuario o repositorio a un equipo. | -| `team.delete` | Se eliminó una cuenta de usuario o repositorio de un equipo. | -| `team.destroy` | Se eliminó un equipo. | - -#### Usuarios - -| Nombre | Descripción | -| ---------------------------:| ------------------------------------------------------------------------------------------------------------------------- | -| `user.add_email` | Se agregó una dirección de correo electrónico a una cuenta de usuario. | -| `user.async_delete` | Se inició una tarea sincrónica para destruir una cuenta de usuario, lo que finalmente disparó `user.delete`. | -| `user.change_password` | Un usuario cambió su contraseña. | -| `user.create` | Se creó una cuenta de usuario nueva. | -| `user.delete` | Se destruyó una cuenta de usuario mediante una tarea asincrónica. | -| `user.demote` | Se disminuyó el nivel de un administrador del sitio a cuenta de usuario común. | -| `user.destroy` | Un usuario eliminó su cuenta, lo que disparó `user.async_delete`. | -| `user.failed_login` | Un usuario intentó registrarse con un nombre de usuario, contraseña o código de autenticación de dos factores incorrecto. | -| `user.forgot_password` | Un usuario solicitó un restablecimiento de contraseña a través de la página de inicio de sesión. | -| `user.login` | Un usuario inició sesión. | -| `user.promote` | Se ascendió una cuenta de usuario común a administrador del sitio. | -| `user.remove_email` | Se eliminó una dirección de correo electrónico de una cuenta de usuario. | -| `user.rename` | Se cambió un nombre de usuario. | -| `user.suspend` | Un administrador del sitio suspendió una cuenta de usuario. | -| `user.two_factor_requested` | Se solicitó un código de autenticación de dos factores a un usuario. | -| `user.unsuspend` | Un administrador del sitió dejó de suspender una cuenta de usuario. | diff --git a/translations/es-XL/content/admin/installation/command-line-utilities.md b/translations/es-XL/content/admin/installation/command-line-utilities.md deleted file mode 100644 index 33e9f05edf0d..000000000000 --- a/translations/es-XL/content/admin/installation/command-line-utilities.md +++ /dev/null @@ -1,787 +0,0 @@ ---- -title: Utilidades de la línea de comando -intro: '{% data variables.product.prodname_ghe_server %} incluye una gama de utilidades para ayudar a resolver problemas particulares o realizar tareas específicas.' -redirect_from: - - /enterprise/admin/articles/viewing-all-services/ - - /enterprise/admin/articles/command-line-utilities/ - - /enterprise/admin/installation/command-line-utilities -miniTocMaxHeadingLevel: 4 -versions: - enterprise-server: '*' ---- - -Puedes ejecutar estos comandos desde cualquier lugar en la VM después de iniciar sesión como usuario administrador de SSH. Para obtener más información, consulta "[Acceder al shell administrativo (SSH)](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-administrative-shell-ssh/)." - -### General - -#### ghe-announce - -Esta utilidad establece un mensaje emergente en la parte superior de cada página {% data variables.product.prodname_enterprise %}. Puedes usarlo para difundir un mensaje entre tus usuarios. - -```shell -# Establece un mensaje que es visible para todos -$ ghe-announce -s MESSAGE -> Mensaje de anuncio establecido. -# Elimina un mensaje establecido previamente -$ ghe-announce -u -> Eliminó el mensaje de anuncio -``` - -#### ghe-check-disk-usage - -Esta utilidad busca en el disco los archivos grandes o los archivos que se han eliminado, pero siguen teniendo identificadores de archivo abiertos. Esto se debería ejecutar cuando intentes liberar espacio en la partición raíz. - -```shell -ghe-check-disk-usage -``` - -#### ghe-cleanup-caches - -Esta utilidad borra una variedad de cachés que podrían ocupar espacio extra del disco en el volumen raíz. Si notas que el uso del espacio de disco del volumen raíz aumenta de manera considerable, sería buena idea ejecutar esta utilidad para ver si ayuda a reducir el uso general. - -```shell -ghe-cleanup-caches -``` -#### ghe-cleanup-settings - -Esta utilidad borra todas las configuraciones {% data variables.enterprise.management_console %} existentes. - -{% tip %} - -**Consejo**: {% data reusables.enterprise_enterprise_support.support_will_ask_you_to_run_command %} - -{% endtip %} - -```shell -ghe-cleanup-settings -``` - -#### ghe-config - -Con esta utilidad, puedes recuperar y modificar los ajustes de configuración de {% data variables.product.product_location_enterprise %}. - -```shell -$ ghe-config core.github-hostname -# Obtiene el valor de configuración de `core.github-hostname` -$ ghe-config core.github-hostname 'example.com' -# Establece el valor de configuración de `core.github-hostname` en `example.com` -$ ghe-config -l -# Detalla todos los valores de configuración -``` -Te permite encontrar el uuid de tu nodo en `cluster.conf`. - -``` shell - $ ghe-config _hostname_.uuid -``` - -#### ghe-config-apply - -Esta utilidad aplica configuraciones {% data variables.enterprise.management_console %}, vuelve a cargar servicios del sistema, prepara un dispositivo de almacenamiento y ejecuta cualquier migración de base de datos pendiente. Es equivalente a dar clic en **Guardar configuración** en la IU web de {% data variables.enterprise.management_console %} o a enviar una solicitud de POST a [la terminal `/setup/api/configure`](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#management-console). - -Probablemente, nunca la debas ejecutar en forma manual, pero está disponible si quieres automatizar el proceso de guardar tus configuraciones a través de SSH. - -```shell -ghe-config-apply -``` - -#### ghe-console - -Esta utilidad abre la consola GitHub Rails en tu aparato {% data variables.product.prodname_enterprise %}. {% data reusables.command_line.use_with_support_only %} - -```shell -ghe-console -``` - -#### ghe-dbconsole - -Esta utilidad abre una sesión de base de datos de MySQL en tu aparato {% data variables.product.prodname_enterprise %}. {% data reusables.command_line.use_with_support_only %} - -```shell -ghe-dbconsole -``` - -#### ghe-es-index-status -Esta utilidad genera un resumen de los índices de Elasticsearch en formato CSV. - -Imprime un resumen de los índices con un encabezado para `STDOUT`: -```shell -$ ghe-es-index-status -do -> advertencia: parser/current está cargando parser/ruby23, que reconoce -> advertencia: 2.3.3-compliant syntax, pero estás ejecutando 2.3.4. -> advertencia: consulta https://github.com/whitequark/parser#compatibility-with-ruby-mri. -> Name,Primary,Searchable,Writable,UpToDate,RepairProgress,Version -> code-search-1,true,true,true,true,100.0,72e27df7c631b45e026b42bfef059328fa040e17 -> commits-5,true,true,true,true,100.0,7ed28813100c47813ef654c0ee2bb9abf21ab744 -> gists-4,true,true,true,true,100.0,cf8e7d04fcf2564c902e2873c424a279cc41079d -> issues-4,false,false,false,true,100.0,d0bb08f71eebf6e7b070572aa399b185dbdc8a76 -> issues-5,true,true,true,true,100.0,d0bb08f71eebf6e7b070572aa399b185dbdc8a76 -> projects-2,true,true,true,true,100.0,c5cac1c4b3c66d42e609d088d174dbc3dd44469a -> pull-requests-6,true,true,true,true,100.0,6a466ad6b896a3499509990979bf9a18d7d41de3 -> repos-6,true,true,true,true,100.0,6c8b5fbba0fc1e409558db411d05e092c1387082 -> users-5,true,true,true,true,100.0,38984875552bb826c9ec42999f409cb2e95556eb -> wikis-4,true,true,true,true,100.0,2613dec44bd14e14577803ac1f9e4b7e07a7c234 -``` - -Imprime un resumen de los índices y canaliza los resultados en `columnas` para mejor legibilidad: - -```shell -$ ghe-es-index-status -do | column -ts, -> advertencia: parser/current está cargando parser/ruby23, que reconoce -> advertencia: 2.3.3-compliant syntax, pero estás ejecutando 2.3.4. -> advertencia: consulta https://github.com/whitequark/parser#compatibility-with-ruby-mri. -> Nombre Principal Se puede buscar Editable Actualizado Avance reparación Versión -> code-search-1 true true true true 100.0 72e27df7c631b45e026b42bfef059328fa040e17 -> commits-5 true true true true 100.0 7ed28813100c47813ef654c0ee2bb9abf21ab744 -> gists-4 true true true true 100.0 cf8e7d04fcf2564c902e2873c424a279cc41079d -> issues-4 falso falso falso true 100.0 d0bb08f71eebf6e7b070572aa399b185dbdc8a76 -> issues-5 true true true true 100.0 d0bb08f71eebf6e7b070572aa399b185dbdc8a76 -> projects-2 true true true true 100.0 c5cac1c4b3c66d42e609d088d174dbc3dd44469a -> pull-requests-6 true true true true 100.0 6a466ad6b896a3499509990979bf9a18d7d41de3 -> repos-6 true true true true 100.0 6c8b5fbba0fc1e409558db411d05e092c1387082 -> users-5 true true true true 100.0 38984875552bb826c9ec42999f409cb2e95556eb -> wikis-4 true true true true 100.0 2613dec44bd14e14577803ac1f9e4b7e07a7c234 -``` - -#### ghe-legacy-github-services-report - -Esta utilidad enumera los repositorios de tu aparato que usan Servicios {% data variables.product.prodname_dotcom %}, un método de integración que se interrumpirá el 1 de octubre de 2018. Los usuarios de tu aparato pueden tener configurados servicios {% data variables.product.prodname_dotcom %} para crear notificaciones de subidas a determinados repositorios. Para obtener más información, consulta la sección"[Anunciar la obsoletización de servicios de {% data variables.product.prodname_dotcom %} ](https://developer.github.com/changes/2018-04-25-github-services-deprecation/)" en {% data variables.product.prodname_blog %} o la sección "[Reemplazar servicios de {% data variables.product.prodname_dotcom %}](/v3/guides/replacing-github-services/)". Para obtener más informaión acerca de este comando o para encontrar opciones adicionales, utiliza la marca `h`. - -```shell -ghe-legacy-github-services-report - -``` - -#### ghe-logs-tail - -Esta utilidad te permite hacer un registro final de todos los archivos de registro relevantes desde tu instalación. Puedes aprobar opciones para limitar los registros a conjuntos específicos. Utiliza la marca -h para más opciones. - -```shell -ghe-logs-tail -``` - -#### ghe-maintenance - -Esta utilidad te permite controlar el estado del modo de mantenimiento de la instalación. Está diseñada para que la use principalmente la {% data variables.enterprise.management_console %} en segundo plano, pero también se puede usar directamente. - -```shell -ghe-maintenance -h -``` - -{% if currentVersion ver_gt "enterprise-server@2.17" %} -#### ghe-motd - -Esta utilidad vuelve a mostrar el mensaje del día (MOTD) en el que los administradores ven cuando se accede a la isntancia a través del shell administrativo. El resultado contiene un resumen del estado de la instancia. - -```shell -ghe-motd -``` -{% endif %} - -#### ghe-nwo - -Esta utilidad genera un nombre y propietario de repositorio en función del Id. del repositorio. - -```shell -ghe-nwo REPOSITORY_ID -``` - -#### ghe-org-admin-promote - -Usa este comando para otorgarles privilegios de propietario de la organización a los usuarios con privilegios de administrador del sitio sobre el aparato o para otorgarle privilegios de propietario de la organización a cualquier usuario único de una organización única. Debes especificar un usuario o una organización. El comando `ghe-org-admin-promote` siempre pedirá confirmación antes de ejecutarse, a menos que uses la marca `-y` para omitir la confirmación. - -Puedes usar las siguientes opciones con la utilidad: - -- La marca `-u` especifica un nombre de usuario. Usa esta marca para otorgarle privilegios de propietario de la organización a un usuario específico. Omite la marca `-u` para promover todos los administradores del sitio a la organización específica. -- La marca `-o` especifica una organización. Usa esta marca para otorgar privilegios de propietario en una organización específica. Omite la marca `-o` para otorgarle permisos de propietario en todas las organizaciones al administrador del sitio especificado. -- La marca `-a` otorga privilegios de propietario en todas las organizaciones a todos los administradores del sitio. -- La marca `-y` omite la confirmación manual. - -Esta utilidad no puede promover una cuenta de usuario que no sea administrador del sitio a propietario de todas las organizaciones. Puedes promover una cuenta de usuario común a administrador del sitio con [ghe-user-promote](#ghe-user-promote). - -Otorga privilegios de propietario de la organización en una organización específica a un usuario único - -```shell -ghe-org-admin-promote -u USERNAME -o ORGANIZATION -``` - -Otorga privilegios de propietario de la organización en todas las organizaciones a un administrador del sitio específico - -```shell -ghe-org-admin-promote -u USERNAME -``` - -Otorga privilegios de propietario de la organización en una organización específica a todos los administradores del sitio - -```shell -ghe-org-admin-promote -o ORGANIZATION -``` - -Otorga privilegios de propietario de la organización en todas las organizaciones a todos los administradores del sitio - -```shell -ghe-org-admin-promote -a -``` - -#### ghe-reactivate-admin-login - -Usa este comando para desbloquear de inmediato la {% data variables.enterprise.management_console %} después de 10 intentos fallidos de inicio de sesión en el transcurso de 10 minutos. - -```shell -$ ghe-reactivate-admin-login -``` - -#### ghe-resque-info - -Esta utilidad muestra información sobre los trabajos en segundo plano, tanto activos como en cola. Proporciona las mismas cantidades de recuento de trabajos que la barra de estado del administrador que aparece en la parte superior de cada página. - -Esta utilidad puede ayudar a identificar si el servidor Resque está teniendo problemas para procesar los trabajos de segundo plano. Cualquiera de los siguientes escenarios puede ser indicativo de un problema con Reque: - -* Aumenta la cantidad de trabajos de segundo plano, pero los trabajos activos siguen siendo los mismos. -* Las fuentes de eventos no se actualizan. -* Los webhooks no se están activando. -* La interfaz web no se actualiza después de una subida de Git. - -Si sospechas que Resque está fallando, contáctate con {% data variables.contact.contact_ent_support %} para obtener ayuda. - -Con este comando, también puedes detener o reanudar los trabajos en cola. - -```shell -$ ghe-resque-info -# detalla las colas y la cantidad de trabajos actualmente en cola -$ ghe-resque-info -p QUEUE -# detiene la cola especificada -$ ghe-resque-info -r QUEUE -# reanuda la cola especificada -``` - -#### ghe-saml-mapping-csv - -Esta utilidad puede ayudar a mapear los registros de SAML. - -Para crear un archivo CSV que contenga todo el mapeo de SAML para tus usuarios de {% data variables.product.product_name %}: -```shell -$ ghe-saml-mapping-csv -d -``` - -Para realizar una simulación de actualización de mapeo de SAML con nuevos valores: -```shell -$ ghe-saml-mapping-csv -u -n -f /path/to/file -``` - -Para actualizar el mapeo de SAML con nuevos valores: -```shell -$ ghe-saml-mapping-csv -u -f /path/to/file -``` - -#### ghe-service-list - -Esta utilidad enumera todos los servicios que se han iniciado o detenido (en ejecución o en espera) en tu aparato. - -```shell -$ ghe-service-list -start/running - - github-resqued, process 12711 - - github-unicorn, process 12726 - - github-gitauth, process 12743 - - git-daemon, process 12755 - - babeld, process 12771 - - github-svn-proxy, process 12802 - - gist-unicorn, process 12832 - - gist-resqued, process 12881 - - render-unicorn, process 12939 - - hookshot-unicorn, process 13076 - - nodeload2, process 13192 - - slumlord-unicorn, process 13304 - - ghe-storage, process 2012 - - enterprise-manage-unicorn, process 2024 - - enterprise-manage-resque, process 2053 - -stop/waiting - - ghe-replica-mode -``` - -{% tip %} - -Los nombres de servicio que se generen con este comando se pueden utilizar con comandos [`systemctl`](https://www.freedesktop.org/software/systemd/man/systemctl.html) para detener, iniciar o restablecer estos servicios manualmente si así se requiere. Por ejemplo: - -```shell -$ sudo systemctl restart github-resqued -``` - -Detener los servicios generará un tiempo de inactividad en tu instalación, así que recomendamos que te contactes con {% data variables.contact.contact_ent_support %} antes de detener o reiniciar cualquier servicio. - -{% endtip %} - -#### ghe-set-password - -Con `ghe-set-password`, puedes establecer una contraseña nueva para autenticarla en la [{% data variables.enterprise.management_console %}](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-management-console). - -```shell -ghe-set-password -``` - -#### ghe-ssh-check-host-keys - -Esta utilidad compara las claves del host de SSH existentes con la lista de claves del host de SHH filtradas conocidas. - -```shell -$ ghe-ssh-check-host-keys -``` - -Si se encuentra una clave del host filtrada, se cierra la utilidad en un estado `1` y con un mensaje: -```shell -> Una o más de tus claves del host de SHH aparecen en la lista negra. -> Restablece tus claves del host usando ghe-ssh-roll-host-keys. -``` - -Si no se encontró una clave del host filtrada, se cierra la utilidad en un estado `0` y con un mensaje: -```shell -> Las claves del host de SSH no se encontraron en la lista negra de claves del host de SSH. -> No se requieren/recomiendan más pasos en este momento. -``` - -#### ghe-ssh-roll-host-keys - -Esta utilidad rota las claves del host de SSH y las reemplaza con claves que se generan nuevas. - -```shell -$ sudo ghe-ssh-roll-host-keys -¿Quieres proceder con la rotación de claves del host de SSH? Esto eliminará las -las claves existentes en /etc/ssh/ssh_host_* y generará nuevas. [y/N] - -# Presiona 'Y' para confirmar la eliminación o utiliza el modificador -y para omitir esta pregunta - -> Las claves del host de SSH se han rotado con éxito. -``` - -#### ghe-ssh-weak-fingerprints - -Esta utilidad genera un informe de claves de SSH débiles conocidas que están almacenadas en el aparato {% data variables.product.prodname_enterprise %}. Opcionalmente, puedes revocar las claves de usuario como acción masiva. La utilidad informará las claves de sistema débiles que puedes revocar en forma manual en la [{% data variables.enterprise.management_console %}](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-management-console). - -```shell -# Imprime un informe de usuario y claves SSH del sistema débiles -$ ghe-ssh-weak-fingerprints - -# Revoca todas las claves de usuario débiles -$ ghe-ssh-weak-fingerprints --revoke -``` - -#### ghe-ssl-acme - -Esta utilidad te permite instalar un certificado de Let's Encrypt en tu aparato {% data variables.product.prodname_enterprise %}. Para obtener más información, consulta "[Configurar TLS](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-tls)." - -Puede utilizar la etiqueta `-x` para eliminar la configuración ACME. - -```shell -ghe-ssl-acme -e -``` - -#### ghe-ssl-ca-certificate-install - -Esta utilidad te termine instalar un certificado CA de raíz personalizado en tu servidor {% data variables.product.prodname_enterprise %}. El certificado debe tener un formato PEM. Además, si tu proveedor de certificación incluye varios certificados CA en un único archivo, debes separarlos en archivos individuales que luego pasarás a `ghe-ssl-ca-certificate-install` de a uno por vez. - -Ejecuta esta utilidad para agregar una cadena de certificación para la verificación de firma de confirmación S/MIME. Para obtener más información, consulta "[Acerca de la verificación de firma de confirmación](/enterprise/{{ currentVersion }}/user/articles/about-commit-signature-verification/)". - -Ejecuta esta utilidad cuando {% data variables.product.product_location_enterprise %} no pueda conectarse con otro servidor porque el segundo está usando un certificado SSL autofirmado o un certificado SSL para el cual no proporciona el paquete de soporte CA necesario. Una manera de confirmar esto es ejecutar `openssl s_client -connect host:port -verify 0 -CApath /etc/ssl/certs` desde {% data variables.product.product_location_enterprise %}. Si el certificado SSL del servidor remoto se puede verificar, tu `SSL-Session` debe tener un código de retorno de 0, como se muestra a continuación. - -``` -SSL-Session: - Protocol : TLSv1 - Cipher : AES128-SHA - Session-ID: C794EBCC3CBC10F747C9AFC029C03C1048FC99CFC34D13D7444E0F267C58DF4C - Session-ID-ctx: - Master-Key: 02A7C47CFD6EEC87D3C710E9DD87390E04EF82DDD7514AE03127D5DC1945FC0CAEFB5395791AEA598667EFA61B9EA8C5 - Key-Arg : None - Start Time: 1394581597 - Timeout : 300 (sec) - Verify return code: 0 (ok) -``` - -Si, de lo contrario, el certificado SSL del servidor remoto *no* se puede verificar, tu `SSL-Session` debería tener un código de retorno distinto de cero: - -``` -SSL-Session: - Protocol : TLSv1 - Cipher : AES128-SHA - Session-ID: 82CB288051A6DB66094C50A69CF1292AEE7E54C6B01B659B98AB336F8C33863E - Session-ID-ctx: - Master-Key: 01B025B2F764043A27919A8D1355AAECD8844FF0831B1D664042334790574A6F4025BAB085D4ED71D71AAB3091B849E5 - Key-Arg : None - Start Time: 1394581782 - Timeout : 300 (sec) - Verify return code: 27 (certificate not trusted) -``` - -Puedes usar estas opciones adicionales con la utilidad: -- La marca `-r` te permite desinstalar un certificado CA. -- La marca `-h` muestra más información de uso. - -```shell -ghe-ssl-ca-certificate-install -c /path/to/certificate -``` - -#### ghe-ssl-generate-csr - -Esta utilidad te permite generar una clave privada y una solicitud de firma de certificado (CSR), que puedes compartir con una autoridad de certificación comercial o privada para obtener un certificado válido para utilizar con tu instancia. Para obtener más información, consulta "[Configurar TLS](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-tls)." - -Para obtener más información acerca de este comando o para conocer otras opciones, utiliza la marca `-h`. - -```shell -ghe-ssl-generate-csr -``` - -#### ghe-storage-extend - -Algunas plataformas exigen este script para ampliar el volumen de usuarios. Para obtener más información, consulta "[Aumentar la capacidad de almacenamiento](/enterprise/admin/guides/installation/increasing-storage-capacity/)". - -```shell -$ ghe-storage-extend -``` - -#### ghe-version - -Esta utilidad imprime la versión, la plataforma y la compilación de {% data variables.product.product_location_enterprise %}. - -```shell -$ ghe-version -``` - -#### ghe-webhook-logs - -Esta utilidad genera registros de entregas de webhooks para que los administradores los revisen e identifiquen cualquier problema. - -```shell -ghe-webhook-logs -``` - -Para mostrar todas las entregas fallidas del gancho en el día anterior: -```shell -ghe-webhook-logs -f -a YYYYMMDD -``` - -Para mostrar todos los resultados, carga útil y excepciones del gancho para la entrega: -```shell -ghe-webhook-logs -g delivery-guid -v -``` - -Para mostrar las entregas globales de webhook: -```shell -ghe-webhook-logs --global -``` - -### Agrupación - -#### ghe-cluster-support-bundle - -Esta utilidad crea un tarball de paquetes de soporte que contiene registros importantes de cada nodo, tanto en la configuración de Replicación geográfica como de Agrupación. - -Por defecto, el comando crea el tarball en */tmp*, pero también puedes tener `cat` el tarball en `STDOUT` para una fácil transmisión por SSH. Esto es útil en caso de que la UI web no responda o que no funcione descargar un paquete de soporte desde */setup/support*. Debes usar este comando si quieres generar un paquete *ampliado* que contenga registros antiguos. También puedes usar este comando para cargar el paquete de soporte de agrupación directamente para {% data variables.product.prodname_enterprise %} recibir asistencia. - -Para crear un paquete estándar: -```shell -$ ssh -p 122 admin@hostname -- 'ghe-cluster-support-bundle -o' > cluster-support-bundle.tgz -``` - -Para crear un paquete extendido: -```shell -$ ssh -p 122 admin@hostname -- 'ghe-cluster-support-bundle -x -o' > cluster-support-bundle.tgz -``` - -Para enviar un paquete a {% data variables.contact.github_support %}: -```shell -$ ssh -p 122 admin@hostname -- 'ghe-cluster-support-bundle -u' -``` - -Para mandar un paquete a {% data variables.contact.github_support %} y asociarlo con un ticket: -```shell -$ ssh -p 122 admin@hostname -- 'ghe-cluster-support-bundle -t ticket-id' -``` - -#### ghe-dpages - -Esta utilidad le permite gestionar el servidor {% data variables.product.prodname_pages %} distribuido. - -```shell -ghe-dpages -``` - -Para mostrar un resumen de la ubicación y salud del repositorio: -```shell -estado ghe-dpages -``` - -Para evacuar un servicio de almacenamiento {% data variables.product.prodname_pages %} antes de evacuar un nodo de agrupación: -``` shell -ghe-dpages evacuate pages-server- -``` - -#### ghe-spokes - -Esta utilidad te permite administrar las tres copias de cada repositorio en los servidores de git distribuidos. - -```shell -ghe-spokes -``` - -Para mostrar un resumen de la ubicación y salud del repositorio: - -```shell -estado ghe-spokes -``` - -Para mostrar los servidores en donde el repositorio se encuentra almacenado: - -```shell -ruta ghe-spokes -``` - -Para evacuar los servicios de almacenamiento en un nodo de la agrupación: - -``` shell -ghe-spokes server evacuate git-server- -``` - -#### ghe-storage - -Esta utilidad te permite evacuar todos los servicios de almacenamiento antes de evacuar un nodo de agrupación. - -``` shell -ghe-storage evacuate storage-server- -``` - -### Git - -#### ghe-btop - -Una interfaz del tipo `top` para las operaciones actuales de Git. - -```shell -ghe-btop [ | --help | --usage ] -``` - -#### ghe-repo - -Esta utilidad te permite cambiar a un directorio del repositorio y abrir un shell interactivo como el de usuario de `git`. Puedes realizar inspecciones o mantenimientos manuales de un repositorio a través de comandos como `git-*` o `git-nw-*`. - -```shell -ghe-repo username/reponame -``` - -#### ghe-repo-gc - -Esta utilidad reempaqueta de forma manual una red de repositorios para optimizar el almacenamiento de paquetes. Si tienes un repositorio grande, ejecutar este comando puede ayudar a reducir su tamaño general. {% data variables.product.prodname_enterprise %} ejecuta de forma automática este comando durante toda tu interacción con una red de repositorios. - -Puedes agregar el argumento opcional `--prune` para eliminar los objetos de Git inaccesibles que no están referenciados desde una rama, una etiqueta o cualquier otra referencia. Esto es útil, en especial, para eliminar de inmediato [información sensible previamente suprimida](/enterprise/user/articles/remove-sensitive-data/). - -```shell -ghe-repo-gc username/reponame -``` - -### Importar y exportar - -#### ghe-migrator - -`ghe-migrator` es una herramienta de alta fidelidad que te ayuda a realizar migraciones desde una instancia de GitHub a otra. Puedes consolidar tus instancias o mover tu organización, usuarios, equipos y repositorios desde GitHub.com a {% data variables.product.prodname_enterprise %}. - -Para obtener más información, consulta nuestra guía sobre [migrar datos de usuarios, organizaciones y repositorios](/enterprise/admin/guides/migrations/). - -#### git-import-detect - -Con una URL, detecta qué tipo de sistema de administración de control de fuente hay en el otro extremo. Durante una importación manual, probablemente ya lo sepas, pero puede ser muy útil en scripts automáticos. -```shell -git-import-detect -``` - -#### git-import-hg-raw - -Esta utilidad importa un repositorio de Mercurial a este repositorio de Git. Para obtener más información, consulta "[Importar datos de sistemas de control de versiones de terceros](/enterprise/admin/guides/migrations/importing-data-from-third-party-version-control-systems/)." -```shell -git-import-hg-raw -``` - -#### git-import-svn-raw - -Esta utilidad importa los datos del archivo y el historial de Subversion en una rama de Git. Es una copia exacta del árbol, que ignora cualquier distinción de tronco o rama. Para obtener más información, consulta "[importar datos de sistemas de control de versiones de terceros](/enterprise/admin/guides/migrations/importing-data-from-third-party-version-control-systems/)." -```shell -git-import-svn-raw -``` - -#### git-import-tfs-raw - -Esta utilidad importa desde el Control de Versiones de Team Foundation. Para obtener más información, consulta "[Importar datos de sistemas de control de versiones de terceros](/enterprise/admin/guides/migrations/importing-data-from-third-party-version-control-systems/)." -```shell -git-import-tfs-raw -``` - -#### git-import-rewrite - -Esta utilidad reescribe el repositorio importado. Esto te permite renombrar a los autores y, en el caso de TFS y Subversion, produce ramas de Git basadas en carpetas. Para obtener más información, consulta "[Importar datos de sistemas de control de versiones de terceros](/enterprise/admin/guides/migrations/importing-data-from-third-party-version-control-systems/)." -```shell -git-import-rewrite -``` - -### Asistencia - -#### ghe-diagnostics - -Esta utilidad realiza múltiples verificaciones y reúne información acerca de tu instalación que puedes enviar para recibir asistencia para diagnosticar los problemas que tienes. - -Actualmente, el resultado de esta utilidad es similar a descargar la información de diagnóstico en la {% data variables.enterprise.management_console %}, pero con el tiempo se pueden agregar otras mejoras que no están disponibles en la UI web. Para obtener más información, consulta "[Crear y compartir archivos de diagnóstico](/enterprise/admin/guides/enterprise-support/providing-data-to-github-support#creating-and-sharing-diagnostic-files)". - -```shell -ghe-diagnostics -``` - -#### ghe-support-bundle - -{% data reusables.enterprise_enterprise_support.use_ghe_cluster_support_bundle %} -Esta utilidad crea un tarball de paquetes de soporte que contiene registros importantes de tu instancia. - -Por defecto, el comando crea el tarball en */tmp*, pero también puedes tener `cat` el tarball en `STDOUT` para una fácil transmisión por SSH. Esto es útil en caso de que la UI web no responda o que no funcione descargar un paquete de soporte desde */setup/support*. Debes usar este comando si quieres generar un paquete *ampliado* que contenga registros antiguos. También puedes usar este comando para cargar el paquete de soporte directamente en la asistencia de {% data variables.product.prodname_enterprise %}. - -Para crear un paquete estándar: -```shell -$ ssh -p 122 admin@hostname -- 'ghe-support-bundle -o' > support-bundle.tgz -``` - -Para crear un paquete extendido: -```shell -$ ssh -p 122 admin@hostname -- 'ghe-support-bundle -x -o' > support-bundle.tgz -``` - -Para enviar un paquete a {% data variables.contact.github_support %}: -```shell -$ ssh -p 122 admin@hostname -- 'ghe-support-bundle -u' -``` - -Para mandar un paquete a {% data variables.contact.github_support %} y asociarlo con un ticket: - -```shell -$ ssh -p 122 admin@hostname -- 'ghe-support-bundle -t ticket-id' -``` - -#### ghe-support-upload - -Esta utilidad envía información desde tu aparato a la asistencia de {% data variables.product.prodname_enterprise %}. Puedes especificar un archivo local u ofrecer una transmisión de hasta 100MB de datos a través de `STDIN`. Opcionalmente, los datos cargados se pueden asociar a un ticket de asistencia. - -Para enviar un archivo a {% data variables.contact.github_support %} y asociarlo con un ticket: -```shell -ghe-support-upload -f path/to/your/file -t ticket-id -``` - -Para subir datos a través de `STDIN` y asociarlos con un ticket: -```shell -ghe-repl-status -vv | ghe-support-upload -t ticket-id -d "Verbose Replication Status" -``` - -En este ejemplo, `ghe-repl-status -vv` envía información de estado detallada desde un aparato réplica. Debes reemplazar `ghe-repl-status -vv` con los datos específicos que quieras transmitir a `STDIN` y `Verbose Replication Status` (Estado de replicación detallado) con una breve descripción de los datos. {% data reusables.enterprise_enterprise_support.support_will_ask_you_to_run_command %} - -### Actualizar {% data variables.product.prodname_ghe_server %} - -#### ghe-upgrade - -Esta utilidad instala o verifica un paquete actualizado. También puedes usar esta utilidad para revertir un lanzamiento de patch si falla o se interrumpe una actualización. Para obtener más información, consulta "[Actualizar {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-github-enterprise-server/)". - -Para verificar un paquete de mejora: -```shell -ghe-upgrade --verify UPGRADE-PACKAGE-FILENAME -``` - -Para instalar un paquete de mejora: -```shell -ghe-upgrade UPGRADE-PACKAGE-FILENAME -``` - -{% data reusables.enterprise_installation.command-line-utilities-ghe-upgrade-rollback %} - -#### ghe-upgrade-scheduler - -Esta utilidad administra la instalación programada de paquetes de actualización. Puedes mostrar, crear nuevas o eliminar las actualizaciones programadas. Debes crear cronogramas usando expresiones cron. Para obtener más información, consulta [Entrada de Cron en Wikipedia](https://en.wikipedia.org/wiki/Cron#Overview). - -Para programar una nueva instalación para un paquete: -```shell -$ ghe-upgrade-scheduler -c "0 2 15 12 *" UPGRADE-PACKAGE-FILENAME -``` - -Para mostrar las instalaciones programadas para un paquete: -```shell -$ ghe-upgrade-scheduler -s UPGRADE PACKAGE FILENAME -> 0 2 15 12 * /usr/local/bin/ghe-upgrade -y -s UPGRADE-PACKAGE-FILENAME > /data/user/common/UPGRADE-PACKAGE-FILENAME.log 2>&1 -``` - -Para eliminar las instalaciones programadas para un paquete: -```shell -$ ghe-upgrade-scheduler -r UPGRADE PACKAGE FILENAME -``` - -#### ghe-update-check - -Esta utilidad buscará si hay disponible un nuevo lanzamiento de patch de {% data variables.product.prodname_enterprise %}. Si lo hay, y si hay espacio disponible en tu instancia, descargará el paquete. Por defecto, se guarda en */var/lib/ghe-updates*. Luego, un administrador puede [realizar la actualización](/enterprise/admin/guides/installation/updating-the-virtual-machine-and-physical-resources/). - -En */var/lib/ghe-updates/ghe-update-check.status* puedes acceder a un archivo que contiene el estado de la descarga. - -Para buscar el último lanzamiento de {% data variables.product.prodname_enterprise %}, usa el modificador `-i`. - -```shell -$ ssh -p 122 admin@hostname -- 'ghe-update-check' -``` - -### Gestión de usuarios - -#### ghe-license-usage - -Esta utilidad exporta una lista de los usuarios de la instalación en formato JSON. Si tu instancia se conecta a {% data variables.product.prodname_ghe_cloud %}, {% data variables.product.prodname_ghe_server %} utiliza esta información para reportar la información de licencia a {% data variables.product.prodname_ghe_cloud %}. Para obtener más información, consulta la sección "[Conectar {% data variables.product.prodname_ghe_server %} a{% data variables.product.prodname_ghe_cloud %}](/enterprise/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)". - -Predeterminadamente, la lista de usuarios en el JSON resultante se encuentra cifrada. Usa la marca `-h` para obtener más opciones. - -```shell -ghe-license-usage -``` - -#### ghe-org-membership-update - -Esta utilidad aplicará la visibilidad de la membresía a la organización predeterminada mostrando todos los miembros de tu instancia. Para obtener más información, consulta "[Configurar la visibilidad de la membresía a la organización](/enterprise/{{ currentVersion }}/admin/guides/user-management/configuring-visibility-for-organization-membership)". Las opciones de configuración son `público` o `privado`. - -```shell -ghe-org-membership-update --visibility=SETTING -``` - -#### ghe-user-csv - -Esta utilidad exporta una lista de todos los usuarios en la instalación a un formato CSV. El archivo CSV incluye las direcciones de correo electrónico, el tipo de usuario que son (p. ej., administrador, usuario), cuántos repositorios tienen, cuántas claves SSH tienen, la cantidad de membresías a la organización, la última dirección IP que inició sesión, etc. Usa la marca `-h` para obtener más opciones. - -```shell -ghe-user-csv -o > users.csv -``` - -#### ghe-user-demote - -Esta utilidad baja de categoría al usuario especificado del estado de administrador al de usuario normal. Recomendamos usar la UI web para realizar esta acción, pero proporcionamos esta utilidad en caso de que la utilidad `ghe-user-promote` se ejecute con error, y debas volver a bajar de categoría a un usuario desde la CLI (interfaz de línea de comandos). - -```shell -ghe-user-demote some-user-name -``` - -#### ghe-user-promote - -Esta utilidad promueve la cuenta de usuario especificada a administrador del sitio. - -```shell -ghe-user-promote some-user-name -``` - -#### ghe-user-suspend - -Esta utilidad suspende el usuario especificado, evitando que inicie sesión, suba o extraiga datos de tu repositorio. - -```shell -ghe-user-suspend some-user-name -``` - -#### ghe-user-unsuspend - -Esta utilidad anula la suspensión del usuario especificado, otorgándole acceso para iniciar sesión, subir o extraer datos de tu repositorio. - -```shell -ghe-user-unsuspend some-user-name -``` diff --git a/translations/es-XL/content/admin/installation/configuring-a-hostname.md b/translations/es-XL/content/admin/installation/configuring-a-hostname.md deleted file mode 100644 index bf9fc713698d..000000000000 --- a/translations/es-XL/content/admin/installation/configuring-a-hostname.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: Configurar un nombre del host -intro: Recomendamos establecer un nombre del host para tu aparato en lugar de utilizar una dirección IP codificada de forma rígida. -redirect_from: - - /enterprise/admin/guides/installation/configuring-hostnames/ - - /enterprise/admin/installation/configuring-a-hostname -versions: - enterprise-server: '*' ---- - -Si configuras un nombre del host en lugar de una dirección IP codificada de forma rígida, podrás cambiar el hardware físico que ejecuta {% data variables.product.product_location_enterprise %} sin afectar a los usuarios o al software del cliente. - -La configuración del nombre de host en la {% data variables.enterprise.management_console %} debe ajustarse a un nombre de dominio adecuado y que cumpla con todos los requisitos (FQDN) el cual se pueda resolver en la internet o dentro de tu red interna. Por ejemplo, tu configuración de nombre del host podría ser `github.companyname.com.` También recomendamos habilitar el aislamiento de subdominio para el nombre del host elegido a fin de mitigar varias vulnerabilidades del estilo cross-site scripting. Para obtener más información, consulta [Sección 2.1 del HTTP RFC](https://tools.ietf.org/html/rfc1123#section-2). - -{% data reusables.enterprise_installation.changing-hostname-not-supported %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.hostname-menu-item %} -4. Escribe el nombre del host que quieres establecer para {% data variables.product.product_location_enterprise %}. ![Campo para establecer un nombre del host](/assets/images/enterprise/management-console/hostname-field.png) -5. Para probar las configuraciones de DNS y SSL para el nombre del host nuevo, haz clic en **Configuraciones del dominio de prueba**. ![Botón Test domain settings (Probar configuraciones del dominio)](/assets/images/enterprise/management-console/test-domain-settings.png) -{% data reusables.enterprise_management_console.test-domain-settings-failure %} -{% data reusables.enterprise_management_console.save-settings %} - -Después de configurar un nombre del host, recomendamos que habilites el aislamiento de subdominio para {% data variables.product.product_location_enterprise %}. Para obtener más información, consulta "[Habilitar el aislamiento de subdominio](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-subdomain-isolation/)." diff --git a/translations/es-XL/content/admin/installation/configuring-an-outbound-web-proxy-server.md b/translations/es-XL/content/admin/installation/configuring-an-outbound-web-proxy-server.md deleted file mode 100644 index 9a685bbdb0f2..000000000000 --- a/translations/es-XL/content/admin/installation/configuring-an-outbound-web-proxy-server.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Configurar un servidor proxy web fuera de banda -intro: 'Un servidor proxy proporciona otro nivel de seguridad para {% data variables.product.product_location_enterprise %}.' -redirect_from: - - /enterprise/admin/guides/installation/configuring-a-proxy-server/ - - /enterprise/admin/installation/configuring-an-outbound-web-proxy-server -versions: - enterprise-server: '*' ---- - -Cuando se habilita un servidor proxy para {% data variables.product.product_location_enterprise %}, primero {% data variables.product.prodname_ghe_server %} envía mensajes fuera de banda a través del servidor proxy, a menos que el host de destino se agregue como una exclusión de servidor proxy HTTP. Los tipos de mensajes fuera de banda incluyen webhooks salientes, carga de paquetes y extracción de avatares heredados. La URL del servidor proxy es el protocolo, dominio o dirección IP más el número de puerto, por ejemplo `http://127.0.0.1:8123`. - -{% note %} - -**Nota:** Para conectarte a {% data variables.product.product_location_enterprise %} para {% data variables.product.prodname_dotcom_the_website %}, tu configuración proxy debe permitir la conectividad a `github.com` y a `api.github.com`. Para obtener más información, consulta "[Conectarse a {% data variables.product.prodname_ghe_server %} para {% data variables.product.prodname_dotcom_the_website %}](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/connecting-github-enterprise-server-to-github-com)." - -{% endnote %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -4. En **Servidor proxy HTTP**, escribe la URL de tu servidor proxy. ![Campo para escribir la URL del servidor proxy HTTP](/assets/images/enterprise/management-console/http-proxy-field.png) -5. De manera opcional, en **Exclusión de servidor proxy HTTP**, escribe cualquier host que no exija acceso proxy, separando los hosts con comas. ![Campo para escribir cualquier Exclusión de Proxy HTTP](/assets/images/enterprise/management-console/http-proxy-exclusion-field.png) -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/es-XL/content/admin/installation/configuring-applications.md b/translations/es-XL/content/admin/installation/configuring-applications.md deleted file mode 100644 index 0190d76daefc..000000000000 --- a/translations/es-XL/content/admin/installation/configuring-applications.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: Configurar aplicaciones -intro: 'Puedes establecer configuraciones de solicitud interna para {% data variables.product.product_location_enterprise %}.' -redirect_from: - - /enterprise/admin/installation/configuring-applications -versions: - enterprise-server: '*' ---- - -### Ajustar el almacenamiento en caché de las imágenes - -Puedes elegir la cantidad de tiempo que {% data variables.product.product_location_enterprise %} almacena en caché los avatares. Cuando aumentas el tiempo de almacenamiento en caché, aumentas la cantidad de tiempo que tardará en cargar el avatar de un usuario. Configurar el tiempo de almacenamiento en caché con un valor demasiado bajo puede sobrecargar {% data variables.product.product_location_enterprise %} los procesos de trabajo. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -3. En la barra lateral izquierda, haz clic en **Applications** (Aplicaciones). ![Pestaña de solicitudes de la barra lateral de configuraciones](/assets/images/enterprise/management-console/sidebar-applications.png) -4. Debajo de "Avatar image cache time (seconds)" (Tiempo de almacenamiento en caché del avatar [en segundos]), escribe la cantidad de segundos que quieres que {% data variables.product.product_location_enterprise %} almacene en caché las imágenes de avatar.![Campo de formulario de almacenamiento en caché de imagen de avatar](/assets/images/enterprise/management-console/add-image-caching-value-field.png) -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/es-XL/content/admin/installation/configuring-backups-on-your-appliance.md b/translations/es-XL/content/admin/installation/configuring-backups-on-your-appliance.md deleted file mode 100644 index 3a130bf5d657..000000000000 --- a/translations/es-XL/content/admin/installation/configuring-backups-on-your-appliance.md +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: Configurar copias de seguridad en tu aparato -redirect_from: - - /enterprise/admin/categories/backups-and-restores/ - - /enterprise/admin/articles/backup-and-recovery/ - - /enterprise/admin/articles/backing-up-github-enterprise/ - - /enterprise/admin/articles/restoring-github-enterprise/ - - /enterprise/admin/articles/backing-up-repository-data/ - - /enterprise/admin/articles/restoring-enterprise-data/ - - /enterprise/admin/articles/restoring-repository-data/ - - /enterprise/admin/articles/backing-up-enterprise-data/ - - /enterprise/admin/guides/installation/backups-and-disaster-recovery/ - - /enterprise/admin/installation/configuring-backups-on-your-appliance -intro: 'Como parte de un plan de recuperación ante desastres, puedes proteger los datos de producción en {% data variables.product.product_location_enterprise %} configurando copias de seguridad automáticas.' -versions: - enterprise-server: '*' ---- - -### Acerca de {% data variables.product.prodname_enterprise_backup_utilities %} - -{% data variables.product.prodname_enterprise_backup_utilities %} es un sistema de copias de seguridad que instalas en un host separado, el cual realiza instantáneas de copias de seguridad de {% data variables.product.product_location_enterprise %} en intervalos regulares a través de una conexión de red SSH segura. Puedes utilizar una instantánea para restablecer una instancia existente del {% data variables.product.prodname_ghe_server %} a su estado previo desde el host de copias de seguridad. - -Solo se transferirán por la red y ocuparán espacio de almacenamiento físico adicional los datos que se hayan agregado después de esa última instantánea. Para minimizar el impacto en el rendimiento, las copias de seguridad se realizan en línea con la prioridad CPU/IO más baja. No necesitas programar una ventana de mantenimiento para realizar una copia de seguridad. - -Para obtener información más detallada sobre las funciones, los requisitos y el uso avanzado, consulta [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#readme). - -### Prerrequisitos - -Para utilizar {% data variables.product.prodname_enterprise_backup_utilities %}, debes tener un sistema de host Linux o Unix separado de {% data variables.product.product_location_enterprise %}. - -También puedes incorporar {% data variables.product.prodname_enterprise_backup_utilities %} en un entorno existente para almacenar los datos críticos de manera permanente y a largo plazo. - -Recomendamos que exista una distancia geográfica entre el host de copias de seguridad y {% data variables.product.product_location_enterprise %}. Esto asegura que las copias de seguridad estén disponibles para su recuperación en el caso de que ocurra un desastre significativo o una interrupción de red en el sitio principal. - -Los requisitos de almacenamiento físico variarán en función del uso del disco del repositorio de Git y de los patrones de crecimiento esperados: - -| Hardware | Recomendación | -| ------------------ | ---------------------------------------------------------------- | -| **vCPU** | 2 | -| **Memoria** | 2 GB | -| **Almacenamiento** | Cinco veces el almacenamiento asignado de la instancia principal | - -Es posible que se requieran más recursos según su uso, como la actividad del usuario y las integraciones seleccionadas. - -### Instalar {% data variables.product.prodname_enterprise_backup_utilities %} - -{% note %} - -**Nota:** Para asegurar que un aparato recuperado esté disponible de inmediato, realiza copias de seguridad apuntando a la instancia principal, incluso en una configuración de replicación geográfica. - -{% endnote %} - -1. Desgarga el último lanzamiento de [{% data variables.product.prodname_enterprise_backup_utilities %} ](https://github.com/github/backup-utils/releases) y extrae el archivo con el comando `tar`. - ```shell - $ tar -xzvf /path/to/github-backup-utils-vMAJOR.MINOR.PATCH.tar.gz - ``` -2. Copia el archivo incluido `backup.config-example` en `backup.config` y ábrelo en un editor. -3. Configura el valor `GHE_HOSTNAME` al {% data variables.product.prodname_ghe_server %} primario del nombre del host de tu instancia o dirección IP. -4. Configura el valor `GHE_DATA_DIR` en la ubicación del sistema de archivos donde deseas almacenar las instantáneas de copia de seguridad. -5. Abre la página de configuración de tu instancia primaria en `https://HOSTNAME/setup/settings` y agrega la clave SSH del host de copia de seguridad a la lista de claves SSH autorizadas. Para obtener más información, consulta [Acceder al shell administrativo (SSH)](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-administrative-shell-ssh/). -5. Verifica la conectividad SSH con {% data variables.product.product_location_enterprise %} con el comando `ghe-host-check`. - ```shell - $ bin/ghe-host-check - ``` - 6. Para crear una copia de respaldo completa inicial, ejecuta el comando `ghe-backup`. - ```shell - $ bin/ghe-backup - ``` - -Para obtener más información sobre uso avanzado, consulta el archivo README en [{% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils#readme). - -### Programar una copia de seguridad - -Puedes programar copias de seguridad regulares en el host de copia de seguridad utilizando el comando `cron(8)` o un servicio de programación de comando similar. La frecuencia de copias de seguridad configurada dictará el peor caso de Punto Objetivo de Recuperación (RPO) de tu plan de recuperación. Por ejemplo, si has programado que la copia de seguridad se ejecute todos los días a la medianoche, podrías perder hasta 24 horas de datos en un escenario de desastre. Recomendamos comenzar con un cronograma de copias de seguridad por hora, que garantice un peor caso máximo de una hora de pérdida de datos, si los datos del sitio principal se destruyen. - -Si los intentos de copias de seguridad se superponen, el comando `ghe-backup` se detendrá con un mensaje de error que indicará la existencia de una copia de seguridad simultánea. Si esto ocurre, recomendamos que disminuyas la frecuencia de tus copias de seguridad programadas. Para obtener más información, consulta la sección "Programar copias de seguridad" del archivo README en [{% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils#scheduling-backups). - -### Recuperar una copia de seguridad - -En el caso de una interrupción de red prolongada o de un evento catastrófico en el sitio principal, puedes restablecer {% data variables.product.product_location_enterprise %} proporcionando otro aparato para {% data variables.product.prodname_enterprise %} y haciendo un restablecimiento desde el host de copias de seguridad. Debes agregar la clave SSH del host de copias de seguridad en el aparato objetivo {% data variables.product.prodname_enterprise %} como una clave SSH autorizada antes de restablecer un aparato. - -Para restablecer {% data variables.product.product_location_enterprise %} desde la última instantánea exitosa, usa el comando `ghe-restore`. Debes ver un resultado similar a este: - -```shell -$ ghe-restore -c 169.154.1.1 -> Comprobando claves filtradas en la instantánea de respaldo que se está restableciendo ... -> * No se encontraron claves filtradas -> Conectarse a 169.154.1.1:122 OK (v2.9.0) - -> ADVERTENCIA: Todos los datos del aparato GitHub Enterprise 169.154.1.1 (v2.9.0) -> se sobrescribirán con los datos de la instantánea 20170329T150710. -> Antes de continuar, verifica que sea el host de restauración correcto. -> Escribe 'yes' (sí) para continuar: yes - -> Comenzando la restauración de 169.154.1.1:122 desde la instantánea 20170329T150710 -# ...resultado truncado -> Restauración completa de 169.154.1.1:122 desde la instantánea 20170329T150710 -> Visita https://169.154.1.1/setup/settings para revisar la configuración del aparato. -``` - -{% note %} - -**Nota:** Los ajustes de red están excluidos de la instantánea de copias de seguridad. Debes configurar manualmente la red en el aparato objetivo para el {% data variables.product.prodname_ghe_server %} como obligatoria para tu entorno. - -{% endnote %} - -Puedes utilizar estas otras opciones con el comando `ghe-restore`: -- La marca `-c` sobrescribe los ajustes, el certificado y los datos de licencia en el host objetivo, incluso si ya está configurado. Omite esta marca si estás configurando una instancia de preparación con fines de prueba y si quieres conservar la configuración existente en el objetivo. Para obtener más información, consulta la sección "Utilizar una copia de seguridad y restablecer los comandos" de [{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#using-the-backup-and-restore-commands). -- La marca `-s` te permite seleccionar otra instantánea de copias de seguridad. - diff --git a/translations/es-XL/content/admin/installation/configuring-built-in-firewall-rules.md b/translations/es-XL/content/admin/installation/configuring-built-in-firewall-rules.md deleted file mode 100644 index c548ad12357b..000000000000 --- a/translations/es-XL/content/admin/installation/configuring-built-in-firewall-rules.md +++ /dev/null @@ -1,115 +0,0 @@ ---- -title: Configurar las reglas de firewall incorporado -intro: 'Puedes ver las reglas de firewall predeterminadas y personalizar reglas para {% data variables.product.product_location_enterprise %}.' -redirect_from: - - /enterprise/admin/guides/installation/configuring-firewall-settings/ - - /enterprise/admin/installation/configuring-built-in-firewall-rules -versions: - enterprise-server: '*' ---- - -### Acerca del firewell de {% data variables.product.product_location_enterprise %} - -{% data variables.product.prodname_ghe_server %} utiliza Ubuntu's Uncomplicated Firewall (UFW) en el aparato virtual. Para obtener más información, consulta "[UFW](https://help.ubuntu.com/community/UFW)" en la documentación de Ubuntu. Con cada lanzamiento, {% data variables.product.prodname_ghe_server %} actualiza automáticamente la lista blanca de los servicios permitidos del firewell. - -Después de que instales {% data variables.product.prodname_ghe_server %}, se abren automáticamente todos los puertos de red obligatorios para aceptar las conexiones. Cada puerto no obligatorio se configura automáticamente en `deny` (rechazar), y la directiva predeterminada resultante se configura en `allow` (permitir). Se habilita el rastreo con estado para todas las conexiones nuevas. Estas suelen ser paquetes de red con el conjunto de bits `SYN`. Para obtener más información, consulta "[Puertos de red](/enterprise/admin/guides/installation/network-ports)." - -El firewall de UFW también abre varios puertos más que son obligatorios para que {% data variables.product.prodname_ghe_server %} funcione correctamente. Para obtener más información sobre el conjunto de reglas de UFW, consulta [el README de UFW](https://bazaar.launchpad.net/~jdstrand/ufw/0.30-oneiric/view/head:/README#L213). - -### Ver las reglas de firewell predeterminadas - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. Para ver las reglas de firewall predeterminadas, utiliza el comando `sudo ufw status`. Debes ver un resultado similar a este: - ```shell - $ sudo ufw status - > Status: active - > To Action From - > -- ------ ---- - > ghe-1194 ALLOW Anywhere - > ghe-122 ALLOW Anywhere - > ghe-161 ALLOW Anywhere - > ghe-22 ALLOW Anywhere - > ghe-25 ALLOW Anywhere - > ghe-443 ALLOW Anywhere - > ghe-80 ALLOW Anywhere - > ghe-8080 ALLOW Anywhere - > ghe-8443 ALLOW Anywhere - > ghe-9418 ALLOW Anywhere - > ghe-1194 (v6) ALLOW Anywhere (v6) - > ghe-122 (v6) ALLOW Anywhere (v6) - > ghe-161 (v6) ALLOW Anywhere (v6) - > ghe-22 (v6) ALLOW Anywhere (v6) - > ghe-25 (v6) ALLOW Anywhere (v6) - > ghe-443 (v6) ALLOW Anywhere (v6) - > ghe-80 (v6) ALLOW Anywhere (v6) - > ghe-8080 (v6) ALLOW Anywhere (v6) - > ghe-8443 (v6) ALLOW Anywhere (v6) - > ghe-9418 (v6) ALLOW Anywhere (v6) - ``` - -### Agregar reglas de firewell personalizadas - -{% warning %} - -**Advertencia:** Antes de agregar reglas de firewall personalizadas, haz una copia de seguridad de tus reglas actuales en caso de que necesites restablecer un estado de funcionamiento conocido. Si estás bloqueado de tu servidor, comunícate con {% data variables.contact.contact_ent_support %} para reconfigurar las reglas originales del firewall. Restaurar las reglas originales del firewall implica tiempo de inactividad para tu servidor. - -{% endwarning %} - -1. Configura una regla de firewall personalizada. -2. Verifica el estado de cada nueva regla con el comando `estado numerado`. - ```shell - $ sudo ufw status numbered - ``` -3. Para hacer una copia de seguridad de tus reglas de firewall personalizadas, utiliza el comando `cp` para pasar las reglas a un archivo nuevo. - ```shell - $ sudo cp -r /lib/ufw ~/ufw.backup - ``` - -Después de actualizar {% data variables.product.product_location_enterprise %}, debes volver a aplicar tus reglas de firewall personalizadas. Recomendamos que crees un script para volver a aplicar las reglas de firewall personalizadas. - -### Restaurar las reglas de firewell predeterminadas - -Si algo sale mal después de que cambies las reglas de firewell, puedes restablecer las reglas desde la copia de seguridad original. - -{% warning %} - -**Advertencia:** Si no hiciste una copia de seguridad de las reglas originales antes de hacer los cambios en el firewall, contáctate con {% data variables.contact.contact_ent_support %} para recibir más asistencia. - -{% endwarning %} - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. Para restablecer las reglas de la copia de seguridad anterior, vuélvelas a copiar en el firewell con el comando `cp`. - ```shell - $ sudo cp -f ~/ufw.backup/*rules /lib/ufw - ``` -3. Vuelve a iniciar el firewell con el comando `systemctl`. - ```shell - $ sudo systemctl restart ufw - ``` -4. Confirma que las reglas recuperaron su forma predeterminada con el comando `ufw status` (estado de ufw). - ```shell - $ sudo ufw status - > Status: active - > To Action From - > -- ------ ---- - > ghe-1194 ALLOW Anywhere - > ghe-122 ALLOW Anywhere - > ghe-161 ALLOW Anywhere - > ghe-22 ALLOW Anywhere - > ghe-25 ALLOW Anywhere - > ghe-443 ALLOW Anywhere - > ghe-80 ALLOW Anywhere - > ghe-8080 ALLOW Anywhere - > ghe-8443 ALLOW Anywhere - > ghe-9418 ALLOW Anywhere - > ghe-1194 (v6) ALLOW Anywhere (v6) - > ghe-122 (v6) ALLOW Anywhere (v6) - > ghe-161 (v6) ALLOW Anywhere (v6) - > ghe-22 (v6) ALLOW Anywhere (v6) - > ghe-25 (v6) ALLOW Anywhere (v6) - > ghe-443 (v6) ALLOW Anywhere (v6) - > ghe-80 (v6) ALLOW Anywhere (v6) - > ghe-8080 (v6) ALLOW Anywhere (v6) - > ghe-8443 (v6) ALLOW Anywhere (v6) - > ghe-9418 (v6) ALLOW Anywhere (v6) - ``` diff --git a/translations/es-XL/content/admin/installation/configuring-collectd.md b/translations/es-XL/content/admin/installation/configuring-collectd.md deleted file mode 100644 index 0a52dd1fc5b7..000000000000 --- a/translations/es-XL/content/admin/installation/configuring-collectd.md +++ /dev/null @@ -1,57 +0,0 @@ ---- -title: Configurar collectd -intro: '{% data variables.product.prodname_enterprise %} puede reunir datos con `collectd` y enviarlos a un servidor `collectd` externo. Entre otras métricas, reunimos un conjunto estándar de datos, como la utilización de la CPU, el consumo de memoria y de disco, el tráfico y los errores de la interfaz de red y la carga general de la VM.' -redirect_from: - - /enterprise/admin/articles/configuring-collectd/ - - /enterprise/admin/installation/configuring-collectd -versions: - enterprise-server: '*' ---- - -### Configura un servidor `collectd` externo - -Si aún no has configurado un servidor `collectd` externo, tendrás que hacerlo antes de habilitar el redireccionamiento `collectd` en {% data variables.product.product_location_enterprise %}. Tu servidor `collectd` se debe ejecutar con una versión 5.x o posterior de `collectd`. - -1. Inicia sesión en tu servidor `collectd`. -2. Crea o edita el archivo de configuración `collectd` para cargar el plugin de red y completar las directivas del servidor y del puerto con los valores adecuados. En la mayoría de las distribuciones, este se ubica en `/etc/collectd/collectd.conf` - -Un ejemplo *collectd.conf* para ejecutar un servidor `collectd`: - - Red LoadPlugin - ... - ... - - Escucha "0.0.0.0" "25826" - - -### Habilita el redireccionamiento collectd en {% data variables.product.prodname_enterprise %} - -Por defecto, el redireccionamiento `collectd` está inhabilitado en {% data variables.product.prodname_enterprise %}. Sigue los pasos que aparecen a continuación para habilitar y configurar el redireccionamiento `collectd`: - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -1. A continuación aparecen los ajustes de redireccionamiento, selecciona **Enable collectd forwarding** (Habilitar el redireccionamiento collectd). -1. En el campo **Server addres** (Dirección del servidor), escribe la dirección del servidor `collectd` al cual quisieras redirreccionar las estadísticas del aparato {% data variables.product.prodname_enterprise %}. -1. En el campo **Port** (Puerto), escribe el puerto utilizado para canectarse al servidor `collectd`. (Predeterminados en 25826) -1. En el menú desplegable **Cryptographic setup** (Configuración criptográfica), selecciona el nivel de seguridad de las comunicaciones con el servidor `collectd`. (Ninguno, paquetes firmados o paquetes encriptados). -{% data reusables.enterprise_management_console.save-settings %} - -### Exportar los datos collectd con `ghe-export-graphs` - -La herramienta de la línea de comando `ghe-export-graphs` exportará los datos que `collectd` almacene en las bases de datos RRD. Este comando convierte los datos a XML y los exporta a un tarball único (.tgz). - -Su uso principal es proporcionarle al equipo de {% data variables.contact.contact_ent_support %} los datos sobre el desempeño de una VM, sin la necesidad de descargar un paquete de soporte completo. No se debe incluir en tus exportaciones de copias de seguridad regulares y no existe una contraparte de importación. Si te contactas con {% data variables.contact.contact_ent_support %}, puede que te solicitemos estos datos para ayudarte a solucionar los problemas. - -#### Uso - -```shell -ssh -p 122 admin@[hostname] -- 'ghe-export-graphs' && scp -P 122 admin@[hostname]:~/graphs.tar.gz . -``` - -### Solución de problemas - -#### El servidor collectd central no recibe datos - -{% data variables.product.prodname_enterprise %} se envía con `collectd` versión 5.x `collectd` 5.x no es compatible hacia atrás con la serie del lanzamiento 4.x. Tu servidor `collectd` central debe tener al menos la versión 5.x para aceptar los datos que se envían desde {% data variables.product.product_location_enterprise %}. - -Para obtener ayuda con más preguntas o problemas, contacta a {% data variables.contact.contact_ent_support %}. diff --git a/translations/es-XL/content/admin/installation/configuring-dns-nameservers.md b/translations/es-XL/content/admin/installation/configuring-dns-nameservers.md deleted file mode 100644 index 74c25473e526..000000000000 --- a/translations/es-XL/content/admin/installation/configuring-dns-nameservers.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: Configurar servidores de nombres DNS -intro: '{% data variables.product.prodname_ghe_server %} utiliza el protocolo de configuración dinámica de host (DHCP) para los ajustes DNS cuando las concesiones de DHCP ofrecen servidores de nombres. Si una concesión del protocolo de configuración dinámica de host (DHCP) no proporciona los servidores de nombres o si debes utilizar ajustes DNS particulares, puedes especificar los servidores de nombres de manera manual.' -redirect_from: - - /enterprise/admin/guides/installation/about-dns-nameservers/ - - /enterprise/admin/installation/configuring-dns-nameservers -versions: - enterprise-server: '*' ---- - -Los servidores de nombres que especifiques deben resolver el nombre del host de {% data variables.product.product_location_enterprise %}. - -{% data reusables.enterprise_installation.changing-hostname-not-supported %} - -### Configurar servidores de nombres utilizando la consola de la máquina virtual - -{% data reusables.enterprise_installation.open-vm-console-start %} -2. Configurar servidores de nombres para tu instancia. -{% data reusables.enterprise_installation.vm-console-done %} - -### Configurar servidores de nombres utilizando el shell administrativo - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. Para editar tus servidores de nombres, ingresa lo siguiente: - ```shell - $ sudo vim /etc/resolvconf/resolv.conf.d/head - ``` -3. Agrega cualquier entrada de `nameserver` (servidor de nombres) y luego guarda el archivo. -4. Después de verificar tus cambios, guarda el archivo. -5. Para agregar tus entradas nuevas de servidores de nombres en {% data variables.product.product_location_enterprise %}, ingresa lo siguiente: - ```shell - $ sudo service resolvconf restart - ``` diff --git a/translations/es-XL/content/admin/installation/configuring-git-large-file-storage-on-github-enterprise-server.md b/translations/es-XL/content/admin/installation/configuring-git-large-file-storage-on-github-enterprise-server.md deleted file mode 100644 index 8d107ee9e162..000000000000 --- a/translations/es-XL/content/admin/installation/configuring-git-large-file-storage-on-github-enterprise-server.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Configurar Large File Storage de Git en el servidor de GitHub Enterprise -intro: '{% data reusables.enterprise_site_admin_settings.configuring-large-file-storage-short-description %}' -redirect_from: - - /enterprise/admin/guides/installation/configuring-git-large-file-storage-on-github-enterprise/ - - /enterprise/admin/installation/configuring-git-large-file-storage-on-github-enterprise-server -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/es-XL/content/admin/installation/configuring-git-large-file-storage-to-use-a-third-party-server.md b/translations/es-XL/content/admin/installation/configuring-git-large-file-storage-to-use-a-third-party-server.md deleted file mode 100644 index c043d8a517f1..000000000000 --- a/translations/es-XL/content/admin/installation/configuring-git-large-file-storage-to-use-a-third-party-server.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: Configurar Almacenamiento de archivos de gran tamaño Git para usar un servidor de terceros -intro: 'Puedes utilizar {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) en un servidor de terceros inhabilitando {% data variables.large_files.product_name_short %} en el aparato del {% data variables.product.prodname_ghe_server %} y configurando el cliente {% data variables.large_files.product_name_short %} con la URL del servidor en el que quieras almacenar los activos grandes.' -redirect_from: - - /enterprise/admin/installation/configuring-git-large-file-storage-to-use-a-third-party-server -versions: - enterprise-server: '*' ---- - -{% data reusables.large_files.storage_assets_location %} -{% data reusables.large_files.rejected_pushes %} - -1. Inhabilita {% data variables.large_files.product_name_short %} en el aparato del {% data variables.product.prodname_ghe_server %}. Para obtener más información, consulta "[Configurar {% data variables.large_files.product_name_long %}](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-git-large-file-storage#configuring-git-large-file-storage-for-your-appliance)." - -2. Crea un archivo de configuración {% data variables.large_files.product_name_short %} que apunte al servidor de terceros. - ```shell - # Show default configuration - $ git lfs env - > git-lfs/1.1.0 (GitHub; darwin amd64; go 1.5.1; git 94d356c) - > git version 2.7.4 (Apple Git-66) -   - > Endpoint=https://GITHUB-ENTERPRISE-HOST/path/to/repo/info/lfs (auth=basic) -   - # Create .lfsconfig that points to third party server. - $ git config -f .lfsconfig remote.origin.lfsurl https://THIRD-PARTY-LFS-SERVER/path/to/repo - $ git lfs env - > git-lfs/1.1.0 (GitHub; darwin amd64; go 1.5.1; git 94d356c) - > git version 2.7.4 (Apple Git-66) -   - > Endpoint=https://THIRD-PARTY-LFS-SERVER/path/to/repo/info/lfs (auth=none) -   - # Show the contents of .lfsconfig - $ cat .lfsconfig - [remote "origin"] - lfsurl = https://THIRD-PARTY-LFS-SERVER/path/to/repo - ``` - -3. Para mantener la misma configuración {% data variables.large_files.product_name_short %} para cada usuario, confirma un archivo `.lfsconfig` personalizado para el repositorio. - ```shell - $ git add .lfsconfig - $ git commit -m "Adding LFS config file" - ``` -3. Migra cualquier activo {% data variables.large_files.product_name_short %} existente. Para obtener más información, consulta "[Migrar a un servidor diferente {% data variables.large_files.product_name_long %} ](/enterprise/{{ currentVersion }}/admin/guides/installation/migrating-to-a-different-git-large-file-storage-server)." - -### Leer más - -- "[Acerca de {% data variables.large_files.product_name_long %}](/articles/about-git-large-file-storage/)" -- "[Configurar {% data variables.large_files.product_name_long %}](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-git-large-file-storage)" -- "[Migrar a un servidor {% data variables.large_files.product_name_long %} diferente](/enterprise/{{ currentVersion }}/admin/guides/installation/migrating-to-a-different-git-large-file-storage-server)" -- [Sitio del proyecto {% data variables.large_files.product_name_long %}](https://git-lfs.github.com/) diff --git a/translations/es-XL/content/admin/installation/configuring-git-large-file-storage.md b/translations/es-XL/content/admin/installation/configuring-git-large-file-storage.md deleted file mode 100644 index c89446207ced..000000000000 --- a/translations/es-XL/content/admin/installation/configuring-git-large-file-storage.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: Configurar el almacenamiento de archivos Git de gran tamaño -intro: 'Una vez que {[{% data variables.large_files.product_name_short %} está instalado], (/articles/installing-git-large-file-storage/), deberás asociarlo con un archivo de gran tamaño en tu repositorio.' -redirect_from: - - /enterprise/admin/articles/configuring-git-large-file-storage-for-a-repository/ - - /enterprise/admin/articles/configuring-git-large-file-storage-for-every-repository-owned-by-a-user-account-or-organization/ - - /enterprise/admin/articles/configuring-git-large-file-storage-for-your-appliance/ - - /enterprise/admin/installation/configuring-git-large-file-storage -versions: - enterprise-server: '*' ---- - -### Acerca de {% data variables.large_files.product_name_long %} - -{% data reusables.enterprise_site_admin_settings.configuring-large-file-storage-short-description %} Puedes usar {% data variables.large_files.product_name_long %} con un repositorio único, con todos tus repositorios personales o de la organización, o con todos los repositorios de {% data variables.product.product_location_enterprise %}. Antes de poder habilitar {% data variables.large_files.product_name_short %} para repositorios u organizaciones específicas, debes habilitar {% data variables.large_files.product_name_short %} para tu aparato. - -{% data reusables.large_files.storage_assets_location %} -{% data reusables.large_files.rejected_pushes %} - -Para obtener más información, consulta "[Acerca de {% data variables.large_files.product_name_long %}](/articles/about-git-large-file-storage)", "[Control de versiones de archivos grandes](/enterprise/user/articles/versioning-large-files/)," y el sitio del proyecto [{% data variables.large_files.product_name_long %} ](https://git-lfs.github.com/). - -### Configurar {% data variables.large_files.product_name_long %} para tu aparato - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -4. Dentro del "acceso de {% data variables.large_files.product_name_short %}", usa el menú desplegable y haz clic en **Enabled (Habilitado)** o **Disabled (Inhabilitado)**. ![Acceso a LFS de Git](/assets/images/enterprise/site-admin-settings/git-lfs-admin-center.png) - -### Configurar {% data variables.large_files.product_name_long %} para un repositorio individual - -{% data reusables.enterprise_site_admin_settings.override-policy %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -{% data reusables.enterprise_site_admin_settings.git-lfs-toggle %} - -### Configurar {% data variables.large_files.product_name_long %} para cada repositorio que pertenezca a una cuenta de usuario u organización - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.search-user-or-org %} -{% data reusables.enterprise_site_admin_settings.click-user-or-org %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -{% data reusables.enterprise_site_admin_settings.git-lfs-toggle %} diff --git a/translations/es-XL/content/admin/installation/configuring-github-enterprise-server-for-high-availability.md b/translations/es-XL/content/admin/installation/configuring-github-enterprise-server-for-high-availability.md deleted file mode 100644 index d4bfa66257be..000000000000 --- a/translations/es-XL/content/admin/installation/configuring-github-enterprise-server-for-high-availability.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: Configurar un servidor GitHub Enterprise para alta disponibilidad -redirect_from: - - /enterprise/admin/guides/installation/high-availability-cluster-configuration/ - - /enterprise/admin/guides/installation/high-availability-configuration/ - - /enterprise/admin/guides/installation/configuring-github-enterprise-for-high-availability/ - - /enterprise/admin/installation/configuring-github-enterprise-server-for-high-availability -intro: '{% data variables.product.prodname_ghe_server %} admite un modo de alta disponibilidad de funcionamiento diseñado para minimizar la interrupción del servicio en caso que ocurra una falla de hardware o una interrupción de red importante que afecte al aparato principal.' -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/es-XL/content/admin/installation/configuring-github-pages-on-your-appliance.md b/translations/es-XL/content/admin/installation/configuring-github-pages-on-your-appliance.md deleted file mode 100644 index 72f1bc2724b8..000000000000 --- a/translations/es-XL/content/admin/installation/configuring-github-pages-on-your-appliance.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: Configurar las Páginas de GitHub en su aparato -intro: 'Puedes habilitar o inhabilitar {% data variables.product.prodname_pages %} en tu instancia. También puedes elegir hacer que los sitios {% data variables.product.prodname_pages %} sean de acceso público.' -redirect_from: - - /enterprise/admin/guides/installation/disabling-github-enterprise-pages/ - - /enterprise/admin/guides/installation/configuring-github-enterprise-pages/ - - /enterprise/admin/installation/configuring-github-pages-on-your-appliance -versions: - enterprise-server: '*' ---- - -### Making {% data variables.product.prodname_pages %} publicly accessible - -El modo privado está habilitado en tu aparato, el público no puede acceder a los sitios {% data variables.product.prodname_pages %} alojados en {% data variables.product.product_location_enterprise %}. - -{% warning %} - -**Advertencia:** Si habilitas los sitios públicos {% data variables.product.prodname_pages %}, todos los sitios {% data variables.product.prodname_pages %} de cada repositorio de tu instancia serán de acceso público. - -{% endwarning %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.pages-tab %} -4. Selecciona **Public Pages** (Páginas públicas). ![Casilla de verificación para habilitar páginas públicas](/assets/images/enterprise/management-console/public-pages-checkbox.png) -{% data reusables.enterprise_management_console.save-settings %} - -### Inhabilitar {% data variables.product.prodname_pages %} en {% data variables.product.product_location_enterprise %} - -Si el aislamiento de subdominio está inhabilitado para {% data variables.product.product_location_enterprise %}, también debes inhabilitar {% data variables.product.prodname_pages %} para protegerte a ti mismo contra posibles vulnerabilidades de seguridad. Para obtener más información, consulta "[Habilitar el aislamiento de subdominio](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-subdomain-isolation)." - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.pages-tab %} -4. Anula la selección de **Enable Pages** (Habilitar páginas). ![Casilla de verificación para inhabilitar {% data variables.product.prodname_pages %}](/assets/images/enterprise/management-console/pages-select-button.png) -{% data reusables.enterprise_management_console.save-settings %} - -### Leer más - -- "[Habilitar el modo privado](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-private-mode)" diff --git a/translations/es-XL/content/admin/installation/configuring-rate-limits.md b/translations/es-XL/content/admin/installation/configuring-rate-limits.md deleted file mode 100644 index 7245932e9db1..000000000000 --- a/translations/es-XL/content/admin/installation/configuring-rate-limits.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: Configurar límites de tasa -intro: 'Puedes configurar límites de tasa para {% data variables.product.prodname_ghe_server %} usando la {% data variables.enterprise.management_console %}.' -redirect_from: - - /enterprise/admin/installation/configuring-rate-limits -versions: - enterprise-server: '*' ---- - -### Habilitar límites de tasa para {% data variables.product.prodname_enterprise_api %} - -Habilitar límites de tasa en {% data variables.product.prodname_enterprise_api %} puede evitar el uso excesivo de recursos por parte de usuarios individuales o sin autenticación. Para obtener más información, consulta la sección "[Limites de tasa](/enterprise/{{ currentVersion }}/v3/#rate-limiting)." - -{% note %} - -**Nota:** La {% data variables.enterprise.management_console %} detalla el período de tiempo (por minuto o por hora) de cada límite de tasa. - -{% endnote %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -2. En "Limitación de tasa", selecciona **Enable API Rate Limiting** (Habilitar la limitación de tasa de API). ![Casilla para habilitar la limitación de tasa de API](/assets/images/enterprise/management-console/api-rate-limits-checkbox.png) -3. Escribe los límites para las solicitudes autenticadas y no autenticadas para cada API o acepta los límites predeterminados que aparecen completados. -{% data reusables.enterprise_management_console.save-settings %} - -### Habilitar límites de tasa de abuso - -Establecer límites de tasa de abuso protege el nivel general de servicio en {% data variables.product.product_location_enterprise %}. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -2. En "Limitación de tasa", selecciona **Enable Abuse Rate Limiting** (Habilitar limitación de tasa de abuso). ![Casilla para habilitar la limitación de tasa de abuso](/assets/images/enterprise/management-console/abuse-rate-limits-checkbox.png) -3. Escribe límites para las solicitudes totales, límite de CPU y límite de CPU para búsquedas, o acepta los límites predeterminados que aparecen completados. -{% data reusables.enterprise_management_console.save-settings %} - -### Habilitar límites de tasa de Git - -Puedes aplicar límites de tasa de Git por red de repositorios o por Id. de usuario. Los límites de tasa de Git se expresan en operaciones simultáneas por minuto y se adaptan en función de la carga de CPU actual. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -2. En "Limitación de tasa", selecciona **Enable Git Rate Limiting** (Habilitar limitación de tasa de Git). ![Casilla para habilitar la limitación de tasa de Git](/assets/images/enterprise/management-console/git-rate-limits-checkbox.png) -3. Escribe los límites para cada red de repositorios o ID de usuario. ![Campos para la red de repositorios y límites de ID de usuario](/assets/images/enterprise/management-console/example-git-rate-limits.png) -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/es-XL/content/admin/installation/configuring-the-default-visibility-of-new-repositories-on-your-appliance.md b/translations/es-XL/content/admin/installation/configuring-the-default-visibility-of-new-repositories-on-your-appliance.md deleted file mode 100644 index 7f2906e213c4..000000000000 --- a/translations/es-XL/content/admin/installation/configuring-the-default-visibility-of-new-repositories-on-your-appliance.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: Configurar la visibilidad predeterminada de los nuevos repositorios en tu aparato -intro: 'Puedes establecer la visibilidad predeterminada para todos los repositorios nuevos creados a través de la interfaz web en tu aparato {% data variables.product.prodname_ghe_server %} para que sean privados o públicos.' -redirect_from: - - /enterprise/admin/installation/configuring-the-default-visibility-of-new-repositories-on-your-appliance -versions: - enterprise-server: '*' ---- - -Cada que alguien crea un repositorio nuevo en {% data variables.product.product_location_enterprise %}, esta persona debe escoger un tipo de visibilidad para el mismo. Cuando configuras un tipo de visibilidad predeterminado para la instancia, puedes escoger cuál tipo de visibilidad se seleccionará predeterminadamente. Para obtener más información sobre los tipos de visibilidad para los repositorios, visita "[Acerca de la visibilidad de los repositorios](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)." - -Si un administrador de sitio revoca a los miembros el privilegio de crear ciertos tipos de repositorios, estos no podrán crear dicho tipo de repositorio aún si la configuración de visibilidad esté predeterminada para ello. Para obtener más información, consulta "[Restringir la creación de repositorios en tu instancia](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)." - -{% tip %} - -**Consejo:** Puedes limitar la capacidad para cambiar la visibilidad de un repositorio solo para los administradores del sitio. Para obtener más información, consulta "[Evitar que los usuarios cambien la visibilidad de un repositorio](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-a-repository-s-visibility)." - -{% endnote %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -1. Debajo de "Default repository visibility" (visibilidad predeterminada del repositorio), utiliza el menú desplegable y selecciona un tipo de visibilidad predeterminado. ![Menú desplegable para elegir la visibilidad de repositorios predeterminada para tu instancia](/assets/images/enterprise/site-admin-settings/default-repository-visibility-settings.png) - -{% data reusables.enterprise_installation.image-urls-viewable-warning %} diff --git a/translations/es-XL/content/admin/installation/configuring-the-github-enterprise-server-appliance.md b/translations/es-XL/content/admin/installation/configuring-the-github-enterprise-server-appliance.md deleted file mode 100644 index 5472aa419abe..000000000000 --- a/translations/es-XL/content/admin/installation/configuring-the-github-enterprise-server-appliance.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: Configurar el aparato del servidor de GitHub Enterprise -intro: 'Una vez que {% data variables.product.prodname_ghe_server %} esté en funcionamiento, puedes configurar el aparato para que se adapte a las necesidades de tu organización.' -redirect_from: - - /enterprise/admin/guides/installation/basic-configuration/ - - /enterprise/admin/guides/installation/administrative-tools/ - - /enterprise/admin/articles/restricting-ssh-access-to-specific-hosts/ - - /enterprise/admin/guides/installation/configuring-the-github-enterprise-appliance/ - - /enterprise/admin/installation/configuring-the-github-enterprise-server-appliance -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/es-XL/content/admin/installation/configuring-the-ip-address-using-the-virtual-machine-console.md b/translations/es-XL/content/admin/installation/configuring-the-ip-address-using-the-virtual-machine-console.md deleted file mode 100644 index 913339b4b473..000000000000 --- a/translations/es-XL/content/admin/installation/configuring-the-ip-address-using-the-virtual-machine-console.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: Configurar la dirección IP usando la consola de la máquina virtual -intro: 'Por defecto, {% data variables.product.prodname_ghe_server %} recupera las configuraciones de red a través del protocolo de configuración dinámica de host (DHCP). Si es compatible con tu plataforma, o si el DHCP no está disponible, también puedes establecer las configuraciones de red usando la consola de la máquina virtual.' -redirect_from: - - /enterprise/admin/installation/configuring-the-ip-address-using-the-virtual-machine-console -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_installation.open-vm-console-start %} -3. Para configurar, elige el protocolo `IPv4` o `IPv6`. ![Opciones para elegir el protocolo IPv4 o el IPv6](/assets/images/enterprise/network-configuration/IPv4-or-IPv6-protocol.png) -4. Configura las opciones para el protocolo que elegiste. ![Menú con opciones de protocolo IP](/assets/images/enterprise/network-configuration/network-settings-selection.png) -{% data reusables.enterprise_installation.vm-console-done %} diff --git a/translations/es-XL/content/admin/installation/configuring-time-synchronization.md b/translations/es-XL/content/admin/installation/configuring-time-synchronization.md deleted file mode 100644 index 3de172f42926..000000000000 --- a/translations/es-XL/content/admin/installation/configuring-time-synchronization.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: Configurar la sincronización de hora -intro: '{% data variables.product.prodname_ghe_server %} sincroniza automáticamente el reloj conectándose con los servidores NTP. Puedes establecer los servidores NTP que se utilicen para sincronizar el reloj o puedes usar los servidores NTP predeterminados.' -redirect_from: - - /enterprise/admin/articles/adjusting-the-clock/ - - /enterprise/admin/articles/configuring-time-zone-and-ntp-settings/ - - /enterprise/admin/articles/setting-ntp-servers/ - - /enterprise/admin/categories/time/ - - /enterprise/admin/installation/configuring-time-synchronization -versions: - enterprise-server: '*' ---- - -### Cambiar los servidores NTP predeterminados - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -2. En la barra lateral izquierda, haz clic en **Time** (Hora). ![El botón de la hora en la barra lateral {% data variables.enterprise.management_console %}](/assets/images/enterprise/management-console/sidebar-time.png) -3. En "Servidor NTP principal", escribe el nombre del host del servidor NTP principal. En "Servidor NTP secundario", escribe el nombre del host del servidor NTP secundario. ![Los campos para los servidores NTP principal y secundario en la {% data variables.enterprise.management_console %}](/assets/images/enterprise/management-console/ntp-servers.png) -4. Al final de la página, haz clic en **Save settings** (Guardar configuraciones). ![El botón de guardar en la {% data variables.enterprise.management_console %}](/assets/images/enterprise/management-console/save-settings.png) -5. Espera a que la configuración se ejecute por completo. - -### Corregir un desface de tiempo prolongado - -El protocolo NTP corrige permanentemente las pequeñas discrepancias de sincronización de hora. Puedes usar el shell administrativo para sincronizar la hora de inmediato. - -{% note %} - -**Notas:** - - No puedes modificar la zona horaria universal coordinada (UTC). - - Debes evitar que tu hipervisor trate de configurar el reloj de la máquina virtual. Para obtener más información, consulta la documentación proporcionada por el proveedor de virtualización. - -{% endnote %} - -- Utiliza el comando `chronyc` para sincronizar el servidor con el servidor NTP configurado. Por ejemplo: - -```shell -$ sudo chronyc -a makestep -``` diff --git a/translations/es-XL/content/admin/installation/configuring-tls.md b/translations/es-XL/content/admin/installation/configuring-tls.md deleted file mode 100644 index 526c7bf2485f..000000000000 --- a/translations/es-XL/content/admin/installation/configuring-tls.md +++ /dev/null @@ -1,69 +0,0 @@ ---- -title: Configurar TLS -intro: 'Puedes configurar la Seguridad de la capa de transporte (TLS) en {% data variables.product.product_location_enterprise %} para poder usar un certificado firmado por una entidad de certificación confiable.' -redirect_from: - - /enterprise/admin/articles/ssl-configuration/ - - /enterprise/admin/guides/installation/about-tls/ - - /enterprise/admin/installation/configuring-tls -versions: - enterprise-server: '*' ---- - -### Acerca de la Seguridad de la capa de transporte - -El TLS, que reemplazó al SSL, se habilita y configura con un certificado autofirmado cuando se inicia el {% data variables.product.prodname_ghe_server %} por primera vez. Como los certificados autofirmados no son confiables para los navegadores web y los clientes de Git, estos clientes informarán advertencias de certificados hasta que inhabilites TLS o cargues un certificado firmado por una entidad confiable, como Let's Encrypt. - -El aparato {% data variables.product.prodname_ghe_server %} enviará encabezados de Seguridad de transporte estricta de HTTP mientras SSL esté habilitado. Inhabilitar TLS hará que los usuarios pierdan acceso al aparato, porque sus navegadores no permitirán que un protocolo se degrade a HTTP. Para obtener más información, consulta "[Seguridad de transporte estricta de HTTP (HSTS)](https://en.wikipedia.org/wiki/HTTP_Strict_Transport_Security)" en Wikipedia. - -{% data reusables.enterprise_installation.terminating-tls %} - -Para permitir que los usuarios utilicen FIDO U2F para la autenticación de dos factores, debes habilitar TLS para tu instancia. Para obtener más información, consulta "[Configurar autenticación de dos factores](/articles/configuring-two-factor-authentication)". - -### Prerrequisitos - -Para utilizar TLS en la producción, debes tener un certificado en un formato de PEM no cifrado firmado por una entidad de certificación confiable. - -Tu certificado también deberá tener configurados Nombres alternativos de sujeto para los subdominios detallados en "[Habilitar aislamiento de subdominio](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-subdomain-isolation#about-subdomain-isolation)" y deberá incluir toda la cadena de certificación si lo firmó una entidad de certificación intermedia. Para obtener más información, consulta "[Nombre alternativo de sujeto](http://en.wikipedia.org/wiki/SubjectAltName)" en Wikipedia. - -Puedes generar una solicitud de firma de certificados (CSR) para tu instancia usando el comando `ghe-ssl-generate-csr`. Para obtener más información, consulta "[utilidades de línea de comandos](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities/#ghe-ssl-generate-csr)" - -### Cargar un certificado TLS personalizado - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -{% data reusables.enterprise_management_console.select-tls-only %} -4. En "TLS Protocol support" (Asistencia de protocolo TLS), selecciona los protocolos que quieres permitir. ![Botones de radio con opciones para elegir protocolos TLS](/assets/images/enterprise/management-console/tls-protocol-support.png) -5. En "Certificate" (Certificado), haz clic en **Choose File** (Elegir archivo) para elegir el certificado TLS o la cadena de certificación (en formato de PEM) que quieras instalar. Este archivo suele tener una extensión *.pem*, *.crt* o *.cer*. ![Botón para encontrar archivo de certificado TLS](/assets/images/enterprise/management-console/install-tls-certificate.png) -6. En "Unencrypted key" (Clave no cifrada), haz clic en **Choose File** (Elegir archivo) para elegir la clave TLS (en formato de PEM) que quieras instalar. Ese archivo suele tener una extensión *.key*. ![Botón para encontrar archivo de clave TLS](/assets/images/enterprise/management-console/install-tls-key.png) - - {% warning %} - - **Advertencia**: Tu clave TLS no debe tener contraseña. Para obtener más información, consulta "[Eliminar la contraseña de tu archivo clave](/enterprise/{{ currentVersion }}/admin/guides/installation/troubleshooting-ssl-errors#removing-the-passphrase-from-your-key-file)". - - {% endwarning %} -{% data reusables.enterprise_management_console.save-settings %} - -### Acerca de la asistencia de Let's Encrypt - -Let's Encrypt es una entidad de certificación pública que emite certificados TLS gratuitos y automáticos que son confiables para los navegadores que usan el protocolo ACME. De hecho, puedes obtener y renovar los certificados de Let's Encrypt para tu aparato sin la necesidad de realizar ningún mantenimiento manual. - -{% data reusables.enterprise_installation.lets-encrypt-prerequisites %} - -Cuando habilites la automatización de la gestión de certificado TLS con Let's Encrypt, {% data variables.product.product_location_enterprise %} se contactará con los servidores de Let's Encrypt para obtener un certificado. Para renovar un certificado, los servidores de Let's Encrypt deben validar el control del nombre de dominio configurado con las solicitudes HTTP entrantes. - -También puedes usar la utilidad de la línea de comando `ghe-ssl-acme` en {% data variables.product.product_location_enterprise %} para generar un certificado de Let's Encrypt de manera automática. Para obtener más información, consulta "[Utilidades de la línea de comando](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities#ghe-ssl-acme)." - -### Configurar TLS usando Let's Encrypt - -{% data reusables.enterprise_installation.lets-encrypt-prerequisites %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -{% data reusables.enterprise_management_console.select-tls-only %} -5. Selecciona **Enable automation of TLS certificate management using Let's Encrypt** (Habilitar la automatización de la gestión de certificado TLS con Let's Encrypt). ![Casilla de verificación para habilitar Let's Encrypt](/assets/images/enterprise/management-console/lets-encrypt-checkbox.png) -{% data reusables.enterprise_management_console.save-settings %} -{% data reusables.enterprise_management_console.privacy %} -7. Haz clic en **Request TLS certificate** (Solicitar certificado TLS). ![Botón para solicitar certificado TLS](/assets/images/enterprise/management-console/request-tls-button.png) -8. Haz clic en **Save configuration** (Guardar configuración). diff --git a/translations/es-XL/content/admin/installation/configuring-your-github-enterprise-server-network-settings.md b/translations/es-XL/content/admin/installation/configuring-your-github-enterprise-server-network-settings.md deleted file mode 100644 index 83c6a96ef7c8..000000000000 --- a/translations/es-XL/content/admin/installation/configuring-your-github-enterprise-server-network-settings.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: Configurar los ajustes de red de tu servidor de GitHub Enterprise -redirect_from: - - /enterprise/admin/guides/installation/dns-hostname-subdomain-isolation-and-ssl/ - - /enterprise/admin/articles/about-dns-ssl-and-subdomain-settings/ - - /enterprise/admin/articles/configuring-dns-ssl-and-subdomain-settings/ - - /enterprise/admin/guides/installation/configuring-your-github-enterprise-network-settings/ - - /enterprise/admin/installation/configuring-your-github-enterprise-server-network-settings -intro: 'Configura {% data variables.product.prodname_ghe_server %} con los servidores de nombres y el nombre del host DNS necesarios para tu red. También puedes configurar un servidor proxy o reglas de firewall. Debes permitir el acceso a determinados puertos con fines administrativos y relacionados con el usuario.' -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/es-XL/content/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud.md b/translations/es-XL/content/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud.md deleted file mode 100644 index 2ed7a25b444e..000000000000 --- a/translations/es-XL/content/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud.md +++ /dev/null @@ -1,62 +0,0 @@ ---- -title: Conectar el servidor de GitHub Enterprise a GitHub Enterprise Cloud -intro: 'Después de que habilites {% data variables.product.prodname_github_connect %}, puedes compartir características y flujos de trabajo específicos entre {% data variables.product.product_location_enterprise %} y {% data variables.product.prodname_ghe_cloud %}.' -redirect_from: - - /enterprise/admin/guides/developer-workflow/connecting-github-enterprise-to-github-com/ - - /enterprise/admin/guides/developer-workflow/connecting-github-enterprise-server-to-github-com - - /enterprise/admin/developer-workflow/connecting-github-enterprise-server-to-githubcom/ - - /enterprise/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud -permissions: 'Los administradores de sitio para {% data variables.product.prodname_ghe_server %} que también sean dueños de una cuenta de organización o empresa de {% data variables.product.prodname_ghe_cloud %} podrán habilitar {% data variables.product.prodname_github_connect %}.' -versions: - enterprise-server: '*' ---- - -### Acerca de {% data variables.product.prodname_github_connect %} - -Para habilitar {% data variables.product.prodname_github_connect %}, debes configurar la conexión en ambos {% data variables.product.product_location_enterprise %} y en tu cuenta de empresa u organización de {% data variables.product.prodname_ghe_cloud %}. - -Para configurar una conexión, tu configuración proxy debe permitir la conectividad a `github.com` y `api.github.com`. Para obtener más información, consulta "[Configuring an outbound web proxy server](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-an-outbound-web-proxy-server)." - -Después de habilitar {% data variables.product.prodname_github_connect %}, podrás habilitar características, como búsqueda unificada y contribuciones unificadas. Para obtener más información acerca de todas las características disponibles, consulta "[Administrar conexiones entre {% data variables.product.prodname_ghe_server %} y {% data variables.product.prodname_ghe_cloud %}](/enterprise/{{ currentVersion }}/admin/installation/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud)." - -Cuando conectas {% data variables.product.product_location_enterprise %} a {% data variables.product.prodname_ghe_cloud %}, un registro en {% data variables.product.prodname_dotcom_the_website %} almacena información sobre la conexión: -- La parte pública de la clave de tu licencia {% data variables.product.prodname_ghe_server %} -- Un hash de tu licencia {% data variables.product.prodname_ghe_server %} -- El nombre personalizado de tu licencia {% data variables.product.prodname_ghe_server %} -- El nombre del host de {% data variables.product.product_location_enterprise %} -- La versión de {% data variables.product.product_location_enterprise %} -- La cuenta de empresa u organización en {% data variables.product.prodname_dotcom_the_website %} está conectada a {% data variables.product.product_location_enterprise %} -- El token de autenticación que usa {% data variables.product.product_location_enterprise %} para hacerle solicitudes a {% data variables.product.prodname_dotcom_the_website %} - -Habilitar {% data variables.product.prodname_github_connect %} también crea un {% data variables.product.prodname_github_app %} cuyo dueño es la cuenta empresarial u organizacional de {% data variables.product.prodname_ghe_cloud %}. {% data variables.product.prodname_ghe_server %} usa las credenciales de {% data variables.product.prodname_github_app %} para hacerle solicitudes a {% data variables.product.prodname_dotcom_the_website %}. - -{% data variables.product.prodname_ghe_server %} almacena credenciales desde la {% data variables.product.prodname_github_app %}. Estas credenciales se replicarán en cualquier entorno de alta disponibilidad o de agrupación y se almacenarán en cualquier copia de seguridad, incluidas las instantáneas creadas por {% data variables.product.prodname_enterprise_backup_utilities %}. -- Un token de autenticación, que es válido durante una hora -- Una clave privada, que se utiliza para generar un nuevo token de autenticación - -Habilitar {% data variables.product.prodname_github_connect %} no permitirá {% data variables.product.prodname_dotcom_the_website %} que los usuarios hagan cambios en {% data variables.product.prodname_ghe_server %}. - -{% if currentVersion ver_gt "enterprise-server@2.18" %} -Para obtener más información acerca de cómo administrar las cuentas empresariales utilizando la API de GraphQL, consulta la sección "[Cuentas empresariales](/v4/guides/managing-enterprise-accounts)". -{% endif %} -### Habilitar {% data variables.product.prodname_github_connect %} - -1. Iniciar sesión en {% data variables.product.product_location_enterprise %} y {% data variables.product.prodname_dotcom_the_website %}. -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %} -5. En "{% data variables.product.prodname_dotcom_the_website %} aún no está habilitado", haz clic en **Enable {% data variables.product.prodname_github_connect %}** (Habilitar). Al hacer clic en **Enable {% data variables.product.prodname_github_connect %}** (Habilitar), aceptas el Anexo {% data variables.product.prodname_github_connect %} al Acuerdo de licencia {% data variables.product.prodname_enterprise %}. ![Habilitar el botón Conectar de GitHub](/assets/images/enterprise/business-accounts/enable-github-connect-button.png) -6. Al lado de la cuenta de usuario u organización a la que quieres conectarte, haz clic en **Connect** (Conectar). ![Conecta el botón junto a una cuenta de empresa o negocio](/assets/images/enterprise/business-accounts/choose-enterprise-or-org-connect.png) - -### Desconectar una {% data variables.product.prodname_ghe_cloud %} organización o cuenta de empresa de {% data variables.product.product_location_enterprise %} - -Cuando te desconectas de {% data variables.product.prodname_ghe_cloud %}, se elimina la {% data variables.product.prodname_github_connect %} {% data variables.product.prodname_github_app %} de tu cuenta de empresa u organización, y las credenciales almacenadas en {% data variables.product.product_location_enterprise %} se eliminan. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %} -5. Al lado de la cuenta de empresa u organización de la que te quieres desconectar, haz clic en **Disable {% data variables.product.prodname_github_connect %}** (Inhabilitar {% data variables.product.prodname_github_connect %}). ![Inhabilitar el botón Conectar de GitHub para una cuenta de empresa o nombre de organización](/assets/images/enterprise/business-accounts/disable-github-connect-button.png) -6. Lee la información acerca de la desconexión y haz clic en **Disable {% data variables.product.prodname_github_connect %}** (Inhabilitar {% data variables.product.prodname_github_connect %}). ![Modal con información de advertencia acerca de la desconexión y el botón de confirmación](/assets/images/enterprise/business-accounts/confirm-disable-github-connect.png) - diff --git a/translations/es-XL/content/admin/installation/creating-a-high-availability-replica.md b/translations/es-XL/content/admin/installation/creating-a-high-availability-replica.md deleted file mode 100644 index 791ae263c08d..000000000000 --- a/translations/es-XL/content/admin/installation/creating-a-high-availability-replica.md +++ /dev/null @@ -1,101 +0,0 @@ ---- -title: Crear una réplica de alta disponibilidad -intro: 'En una configuración activa/pasiva, el aparato réplica es una copia redundante del aparato principal. Si el aparato principal falla, el modo de alta disponibilidad permite que la réplica actúe como aparato principal, lo que posibilita que la interrupción del servicio sea mínima.' -redirect_from: - - /enterprise/admin/installation/creating-a-high-availability-replica -versions: - enterprise-server: '*' ---- - -### Crear una réplica de alta disponibilidad - -1. Configurar un aparato para el {% data variables.product.prodname_ghe_server %} nuevo en la plataforma que desees. El aparato réplica debe espejar la CPU, la RAM y los ajustes de almacenamiento del aparato principal. Recomendamos que instales el aparato réplica en un entorno separado. El hardward subyacente, el software y los componentes de red deben estar aislados de los del aparato principal. Si estás usando un proveedor de nube, utiliza una región o zona separada. Para obtener más información, consulta ["Configurar una instancia {% data variables.product.prodname_ghe_server %}"](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-github-enterprise-server-instance). -2. Desde un navegador, dirígete a la nueva dirección IP del aparato réplica y carga tu licencia de {% data variables.product.prodname_enterprise %}. -3. Establece una contraseña de administrador que coincida con la contraseña del aparato principal y continúa. -4. Haz clic en **Configure as Replica** (Configurar como réplica). ![Opciones de instalación con enlace para configurar tu nueva instancia como una réplica](/assets/images/enterprise/management-console/configure-as-replica.png) -5. En "Add new SSH key" (Agregar nueva clave SSH), escribe tu clave SSH. ![Agrega la clave SSH](/assets/images/enterprise/management-console/add-ssh-key.png) -6. Haz clic en **Add key** (Agregar clave), luego haz clic en **Continue** (Continuar). -6. Conectarse a la dirección IP del aparato réplica usando SSH. - ```shell - $ ssh -p 122 admin@REPLICA IP - ``` -7. Para generar un par de claves para la replicación, usa el comando `ghe-repl-setup` con la dirección IP del aparato principal y copia la clave pública que este devuelve. - ```shell - $ ghe-repl-setup PRIMARY IP - ``` -{% data reusables.enterprise_installation.add-ssh-key-to-primary %} -9. Para verificar la conexión con la primaria y habilitar el modo de réplica para una nueva réplica, ejecuta nuevamente `ghe-repl-setup`. - ```shell - $ ghe-repl-setup PRIMARY IP - ``` -{% data reusables.enterprise_installation.replication-command %} -11. Para verificar el estado de cada canal de replicación del almacén de datos, utiliza el comando `ghe-repl-status`. - ```shell - $ ghe-repl-status - ``` - -### Crear réplicas de replicación geográfica - -Esta configuración de ejemplo utiliza una réplica primaria y dos réplicas, que se encuentran en tres regiones geográficas diferentes. Aunque los tres nodos pueden estar en redes diferentes, se necesitan todos los nodos para que sean accesibles desde todos los demás nodos. Como mínimo, los puertos administrativos requeridos deben estar abiertos para todos los demás nodos. Para obtener más información acerca de los requisitos de puerto, consulta "[Puertos de red](/enterprise/{{ currentVersion }}/admin/guides/installation/network-ports/#administrative-ports)." - -1. Crea la primera réplica de la misma manera en que lo harías para una configuración de dos nodos estándar ejecutando `ghe-repl-setup` en la primera réplica. - ```shell - (replica1)$ ghe-repl-setup PRIMARY IP - (replica1)$ ghe-repl-start - ``` -2. Crea una segunda réplica y utiliza el comando `ghe-repl-setup --add`. La marca `--add` evita que sobrescriba la configuración de la replicación existente y agrega la nueva réplica a la configuración. - ```shell - (replica2)$ ghe-repl-setup --add PRIMARY IP - (replica2)$ ghe-repl-start - ``` -3. Por defecto, las réplicas se configuran en el mismo centro de datos{% if currentVersion ver_gt "enterprise-server@2.17" %}, e intentarán iniciar desde un nodo existente en el mismo centro de datos{% endif %}. Configura las réplicas para diferentes centros de datos estableciendo un valor diferente para la opción de centro de datos. Los valores específicos pueden ser los que tú quieras, siempre que sean diferentes entre sí. Ejecuta el comando `ghe-repl-node` en cada nodo y especifica el centro de datos. - - En la primaria: - ```shell - (primary)$ ghe-repl-node --datacenter [PRIMARY DC NAME] - ``` - En la primera réplica: - ```shell - (replica1)$ ghe-repl-node --datacenter [FIRST REPLICA DC NAME] - ``` - En la segunda réplica: - ```shell - (replica2)$ ghe-repl-node --datacenter [SECOND REPLICA DC NAME] - ``` - {% tip %} - - **Consejo:** puedes establecer las opciones `--datacenter` y `--active` al mismo tiempo. - - {% endtip %} -4. Un nodo de réplica activo almacenará copias de los datos del aparato y responderá las solicitudes de usuario final. Un nodo inactivo almacenará copias de los datos del aparato, pero no podrá atender las solicitudes de usuario final. Habilita el modo activo usando la marca `--active` o el modo inactivo usando la marca `--inactive`. - - En la primera réplica: - ```shell - (replica1)$ ghe-repl-node --active - ``` - En la segunda réplica: - ```shell - (replica2)$ ghe-repl-node --active - ``` -5. Para aplicar la configuración, usa el comando `ghe-config-apply` en el principal. - ```shell - (primary)$ ghe-config-apply - ``` - -### Configurar el DNS para replicación geográfica - -Configurar Geo DNS usando las direcciones IP de los nodos primarios y réplica. También puedes crear un DNS CNAME para el nodo principal (p. ej., `primary.github.example.com`) para acceder al nodo principal a través de SSH o hacerle una copia de seguridad a través de `backup-utils`. - -Para probarlo, puedes agregar entradas al archivo de `hosts` de la estación de trabajo local (por ejemplo, `/etc/hosts`). Estas entradas de ejemplo resolverán las solicitudes de `HOSTNAME` para `replica2`. Puedes apuntar a hosts específicos comentando en diferentes líneas. - -``` -# HOSTNAME -# HOSTNAME - HOSTNAME -``` - -### Leer más - -- "[Acerca de la configuración de alta disponibilidad](/enterprise/{{ currentVersion }}/admin/guides/installation/about-high-availability-configuration)" -- "[Utilidades para la gestión de replicaciones](/enterprise/{{ currentVersion }}/admin/guides/installation/about-high-availability-configuration/#utilities-for-replication-management)" -- "[Acerca de la replicación geográfica](/enterprise/{{ currentVersion }}/admin/guides/installation/about-geo-replication/)" diff --git a/translations/es-XL/content/admin/installation/disabling-git-ssh-access-on-github-enterprise-server.md b/translations/es-XL/content/admin/installation/disabling-git-ssh-access-on-github-enterprise-server.md deleted file mode 100644 index f5da2883cc6e..000000000000 --- a/translations/es-XL/content/admin/installation/disabling-git-ssh-access-on-github-enterprise-server.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: Inhabilitar el acceso SSH de Git en el servidor de GitHub Enterprise -redirect_from: - - /enterprise/admin/hidden/disabling-ssh-access-for-a-user-account/ - - /enterprise/admin/articles/disabling-ssh-access-for-a-user-account/ - - /enterprise/admin/hidden/disabling-ssh-access-for-your-appliance/ - - /enterprise/admin/articles/disabling-ssh-access-for-your-appliance/ - - /enterprise/admin/hidden/disabling-ssh-access-for-an-organization/ - - /enterprise/admin/articles/disabling-ssh-access-for-an-organization/ - - /enterprise/admin/hidden/disabling-ssh-access-to-a-repository/ - - /enterprise/admin/articles/disabling-ssh-access-to-a-repository/ - - /enterprise/admin/guides/installation/disabling-git-ssh-access-on-github-enterprise/ - - /enterprise/admin/installation/disabling-git-ssh-access-on-github-enterprise-server -intro: 'Puedes evitar que las personas usen Git por SSH para determinados repositorios o para todos ellos en {% data variables.product.product_location_enterprise %}.' -versions: - enterprise-server: '*' ---- - -### Inhabilitar el acceso SSH de Git para un repositorio específico - -{% data reusables.enterprise_site_admin_settings.override-policy %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -1. En "Acceso SSH de Git", usa el menú desplegable y haz clic en **Disabled** (Inhabilitado). ![Menú desplegable del acceso SSH de Git con la opción de inhabilitación seleccionada](/assets/images/enterprise/site-admin-settings/git-ssh-access-repository-setting.png) - -### Inhabilitar el acceso SSH de Git para todos los repositorios que le pertenecen a un usuario o a una organización - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.search-user-or-org %} -{% data reusables.enterprise_site_admin_settings.click-user-or-org %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -7. En "Acceso SSH de Git", usa el menú desplegable y haz clic en **Disabled** (Inhabilitado). Luego selecciona **Enforce on all repositories** (Aplicar en todos los repositorios). ![Menú desplegable del acceso SSH de Git con la opción de inhabilitación seleccionada](/assets/images/enterprise/site-admin-settings/git-ssh-access-organization-setting.png) - -### Inhabilitar el acceso SSH de Git para todos los repositorios de un aparato - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -7. En "Acceso SSH de Git", usa el menú desplegable y haz clic en **Disabled** (Inhabilitado). Luego selecciona **Enforce on all repositories** (Aplicar en todos los repositorios). ![Menú desplegable del acceso SSH de Git con la opción de inhabilitación seleccionada](/assets/images/enterprise/site-admin-settings/git-ssh-access-appliance-setting.png) diff --git a/translations/es-XL/content/admin/installation/disabling-the-merge-conflict-editor-for-pull-requests-between-repositories.md b/translations/es-XL/content/admin/installation/disabling-the-merge-conflict-editor-for-pull-requests-between-repositories.md deleted file mode 100644 index bfd6b5936a17..000000000000 --- a/translations/es-XL/content/admin/installation/disabling-the-merge-conflict-editor-for-pull-requests-between-repositories.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: Inhabilitar el editor de conflicto de fusión para las solicitudes de extracción entre repositorios -intro: 'Puedes solicitar que las personas resuelvan los conflictos de fusión en forma local inhabilitando el editor de conflicto de fusión en {% data variables.product.prodname_ghe_server %} para las solicitudes de extracción en las que la rama base y la rama de encabezado estén en repositorios diferentes.' -redirect_from: - - /enterprise/admin/installation/disabling-the-merge-conflict-editor-for-pull-requests-between-repositories -versions: - enterprise-server: '*' ---- - -Solicitarles a los usuarios que resuelvan los conflictos de fusión en forma local desde sus computadoras puede evitar que las personas escriban inadvertidamente un repositorio ascendente desde una bifurcación. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -1. En "Editor de conflicto para las solicitudes de extracción entre repositorios", usa el menú desplegable y haz clic en **Disabled** (Inhabilitado). ![Menú desplegable con opción para inhabilitar el editor de conflicto de fusión](/assets/images/enterprise/settings/conflict-editor-settings.png) diff --git a/translations/es-XL/content/admin/installation/enabling-and-scheduling-maintenance-mode.md b/translations/es-XL/content/admin/installation/enabling-and-scheduling-maintenance-mode.md deleted file mode 100644 index bd426b6de51a..000000000000 --- a/translations/es-XL/content/admin/installation/enabling-and-scheduling-maintenance-mode.md +++ /dev/null @@ -1,61 +0,0 @@ ---- -title: Habilitar y programar el modo de mantenimiento -intro: 'Algunos procedimientos de mantenimiento estándar, como la actualización {% data variables.product.product_location_enterprise %} o la restauración de copias de seguridad, exigen que la instancia esté sin conexión para el uso normal.' -redirect_from: - - /enterprise/admin/maintenance-mode/ - - /enterprise/admin/categories/maintenance-mode/ - - /enterprise/admin/articles/maintenance-mode/ - - /enterprise/admin/articles/enabling-maintenance-mode/ - - /enterprise/admin/articles/disabling-maintenance-mode/ - - /enterprise/admin/guides/installation/maintenance-mode/ - - /enterprise/admin/installation/enabling-and-scheduling-maintenance-mode -versions: - enterprise-server: '*' ---- - -### Acerca del modo de mantenimiento - -Algunos tipos de operaciones exigen que desconectes tu {% data variables.product.product_location_enterprise %} y la pongas en modo de mantenimiento: -- Actualizar a una versión nueva de tu {% data variables.product.prodname_ghe_server %} -- Aumentar los recursos de CPU, memoria o almacenamiento asignados a la máquina virtual -- Migrar datos desde una máquina virtual a otra -- Restaurar datos desde una instantánea de {% data variables.product.prodname_enterprise_backup_utilities %} -- Solucionar ciertos tipos de problemas críticos de solicitud - -Recomendamos que programe una ventana de mantenimiento para, al menos, los siguientes 30 minutos para darle a los usuarios tiempo para prepararse. Cuando está programada una ventana de mantenimiento, todos los usuarios verán un mensaje emergente al acceder al sitio. - -![Mensaje emergente para el usuario final acerca del mantenimiento programado](/assets/images/enterprise/maintenance/maintenance-scheduled.png) - -Cuando la instancia está en modo de mantenimiento, se rechazan todos los accesos HTTP y Git. Las operaciones de extracción, clonación y subida de Git también se rechazan con un mensaje de error que indica que temporalmente el sitio no se encuentra disponible. Al visitar el sitio desde un navegador aparece una página de mantenimiento. - -![La pantalla de presentación del modo de mantenimiento](/assets/images/enterprise/maintenance/maintenance-mode-maintenance-page.png) - -### Habilitar el modo de mantenimiento de inmediato o programar una ventana de mantenimiento para más tarde - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -2. En la parte superior de la {% data variables.enterprise.management_console %}, haz clic en **Maintenance** (Mantenimiento). ![Pestaña de mantenimiento](/assets/images/enterprise/management-console/maintenance-tab.png) -3. En "Enable and schedule" (Habilitar y programar), decide si habilitas el modo de mantenimiento de inmediato o programas una ventana de mantenimiento para otro momento. - - Para habilitar el modo de mantenimiento de inmediato, usa el menú desplegable y haz clic en **now** (ahora). ![Menú desplegable con la opción para habilitar el modo de mantenimiento ahora seleccionado](/assets/images/enterprise/maintenance/enable-maintenance-mode-now.png) - - Para programar una ventana de mantenimiento para otro momento, usa el menú desplegable y haz clic en un horario de inicio. ![Menú desplegable con la opción para programar una ventana de mantenimiento](/assets/images/enterprise/maintenance/schedule-maintenance-mode-two-hours.png) -4. Selecciona **Enable maintenance mode** (Habilitar el modo de mantenimiento). ![Casilla de verificación para habilitar o programar el modo de mantenimiento](/assets/images/enterprise/maintenance/enable-maintenance-mode-checkbox.png) -{% data reusables.enterprise_management_console.save-settings %} - -### Programar el modo de mantenimiento con {% data variables.product.prodname_enterprise_api %} - -Puedes programar el mantenimiento para horarios o días diferentes con {% data variables.product.prodname_enterprise_api %}. Para obtener más información, consulta la sección "[Consola de Administración](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#enable-or-disable-maintenance-mode)". - -### Habilitar o inhabilitar el modo de mantenimientos para todos los nodos de una agrupación - -Con la herramienta `ghe-cluster-maintenance`, puedes configurar o anular la configuración del modo de mantenimiento para cada nodo de una agrupación. - -```shell -$ ghe-cluster-maintenance -h -# Muestra opciones -$ ghe-cluster-maintenance -q -# Consulta el modo actual -$ ghe-cluster-maintenance -s -# Configura el modo de mantenimiento -$ ghe-cluster-maintenance -u -# Anula la configuración del modo de mantenimiento -``` diff --git a/translations/es-XL/content/admin/installation/enabling-automatic-update-checks.md b/translations/es-XL/content/admin/installation/enabling-automatic-update-checks.md deleted file mode 100644 index 163758996e68..000000000000 --- a/translations/es-XL/content/admin/installation/enabling-automatic-update-checks.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: Habilitar comprobaciones de actualización automáticas -intro: 'Puedes habilitar comprobaciones de actualización automáticas para que {% data variables.product.product_location_enterprise %} busque y descargue el último lanzamiento del {% data variables.product.prodname_ghe_server %}.' -redirect_from: - - /enterprise/admin/installation/enabling-automatic-update-checks -versions: - enterprise-server: '*' ---- - -Cuando un paquete de actualizaciones se descarga automáticamente para {% data variables.product.product_location_enterprise %}, recibirás un mensaje informándote que puedes actualizar el {% data variables.product.prodname_ghe_server %}. Descarga de paquetes para el directorio `/var/lib/ghe-updates` en {% data variables.product.product_location_enterprise %}. Para obtener más información, consulta "[Actualizar {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-github-enterprise-server)." - -Si está disponible un hotpatch para una actualización, el `.hpkg` se descargará automáticamente. En la consola de administración puedes elegir instalar el hotpatch de inmediato o programar la instalación para otro momento. Para obtener más información, consulta "[Actualizar con un hotpatch](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-github-enterprise-server#upgrading-with-a-hotpatch)." - -{% tip %} - -**Consejo:** Para habilitar comprobaciones de actualización automáticas, {% data variables.product.product_location_enterprise %} se debe poder conectar a `https://github-enterprise.s3.amazonaws.com`. - -{% endtip %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.updates-tab %} -4. Haz clic en **Yes, automatically check for updates** (Sí, buscar actualizaciones automáticamente). ![Botón para habilitar actualizaciones automáticas](/assets/images/enterprise/management-console/enable_updates_button.png) -{% data reusables.enterprise_management_console.save-settings %} - -Para saber si tu instancia está actualizada, busca el mensaje emergente en la pestaña de actualizaciones. - -![Mensaje emergente que indica tu lanzamiento del servidor de GitHub Enterprise](/assets/images/enterprise/management-console/up-to-date-banner.png) - -En **Logs** (Registros), puedes ver el estado de la búsqueda de actualizaciones más reciente. - -![Registros para actualización](/assets/images/enterprise/management-console/update-log.png) diff --git a/translations/es-XL/content/admin/installation/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud.md b/translations/es-XL/content/admin/installation/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud.md deleted file mode 100644 index 0d4398166179..000000000000 --- a/translations/es-XL/content/admin/installation/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: Habilitar la sincronización automática de licencias de usuario entre el servidor de GitHub Enterprise y GitHub Enterprise Cloud -intro: 'Puedes conectar {% data variables.product.product_location_enterprise %} a {% data variables.product.prodname_ghe_cloud %} y permitir que {% data variables.product.prodname_ghe_server %} cargue información de licencias de usuario en tu cuenta de empresa en {% data variables.product.prodname_dotcom_the_website %}.' -permissions: 'Los administradores de sitio para {% data variables.product.prodname_ghe_server %} que también sean dueños de la cuenta organizacional o empresarial conectada de {% data variables.product.prodname_ghe_cloud %} pueden habilitar la sincronización automática de la licencia del usuario.' -redirect_from: - - /enterprise/admin/installation/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud -versions: - enterprise-server: '*' ---- - -### Acerca de la sincronización de licencias - -Después de que habilitas la sincronización de licencias, podrás ver el uso de licencias para toda tu cuenta empresarial, a través de {% data variables.product.prodname_ghe_server %} y de {% data variables.product.prodname_ghe_cloud %}. {% data variables.product.prodname_github_connect %} sincroniza la licencia entre {% data variables.product.prodname_ghe_server %} y {% data variables.product.prodname_ghe_cloud %} semanalmente. Para obtener más información, consulta la sección "[Administrar tu licencia de {% data variables.product.prodname_enterprise %}](/enterprise/{{currentVersion}}/admin/installation/managing-your-github-enterprise-license)". - -También puedes cargar en forma manual información de licencias de usuario {% data variables.product.prodname_ghe_server %} en {% data variables.product.prodname_ghe_cloud %}. Para obtener más información, consulta "[Conectar {% data variables.product.prodname_ghe_server %} a {% data variables.product.prodname_ghe_cloud %}](/enterprise/{{ currentVersion }}/admin/guides/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)." - -### Habilitar la sincronización de licencias - -Antes de habilitar la sincronización de licencias en {% data variables.product.product_location_enterprise %}, debes conectar {% data variables.product.product_location_enterprise %} a {% data variables.product.prodname_dotcom_the_website %}. Para obtener más información, consulta "[Conectar {% data variables.product.prodname_ghe_server %} a {% data variables.product.prodname_ghe_cloud %}](/enterprise/{{ currentVersion }}/admin/guides/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)." - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %} -5. En "El servidor puede sincronizar el recuento y uso de licencias de usuario", usa el menú desplegable y selecciona **Enabled** (Habilitado). ![Menú desplegable para habilitar la sincronización automática de licencias de usuario](/assets/images/enterprise/site-admin-settings/enable-user-license-drop-down.png) diff --git a/translations/es-XL/content/admin/installation/enabling-private-mode.md b/translations/es-XL/content/admin/installation/enabling-private-mode.md deleted file mode 100644 index f9d67c71e94f..000000000000 --- a/translations/es-XL/content/admin/installation/enabling-private-mode.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: Habilitar el modo privado -intro: 'En el modo privado, {% data variables.product.prodname_ghe_server %} exige que todos los usuarios inicien sesión para acceder a la instalación.' -redirect_from: - - /enterprise/admin/articles/private-mode/ - - /enterprise/admin/guides/installation/security/ - - /enterprise/admin/guides/installation/securing-your-instance/ - - /enterprise/admin/installation/enabling-private-mode -versions: - enterprise-server: '*' ---- - -Debes habilitar el modo privado si {% data variables.product.product_location_enterprise %} es de acceso público por internet. En el modo privado, los usuarios no pueden clonar repositorios en forma anónima por `git://`. Si también está habilitada la autenticación incorporada, un administrador debe invitar a los nuevos usuarios para que creen una cuenta en la instancia. Para obtener más información, consulta "[Usar la autenticación incorporada](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-built-in-authentication)." - -{% data reusables.enterprise_installation.image-urls-viewable-warning %} - -Con el modo privado habilitado, puedes permitir que operaciones de Git sin autenticación (y cualquiera con acceso de red a {% data variables.product.product_location_enterprise %}) lean un código de repositorio público de tu instancia con acceso de lectura anónimo de Git habilitado. Para obtener más información, consulta "[Permitir que los administradores habiliten el acceso de lectura anónimo de Git para los repositorios públicos](/enterprise/{{ currentVersion }}/admin/guides/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories)." - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -4. Selecciona **Private mode** (Modo privado). ![Casilla de verificación para habilitar el modo privado](/assets/images/enterprise/management-console/private-mode-checkbox.png) -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/es-XL/content/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md b/translations/es-XL/content/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md deleted file mode 100644 index 28d387b32b4f..000000000000 --- a/translations/es-XL/content/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: Habilitar alertas de seguridad para tus dependencias vulnerables en el servidor de GitHub Enterprise -intro: 'Puedes conectar {% data variables.product.product_location_enterprise %} a {% data variables.product.prodname_ghe_cloud %} y habilitar alertas de seguridad para las dependencias vulnerables de los repositorios de tu instancia.' -permissions: 'Los administradores de sitio para {% data variables.product.prodname_ghe_server %} que también sean dueños de la cuenta organizacional o empresarial conectada de {% data variables.product.prodname_ghe_cloud %} pueden habilitar las alertas de seguridad para las dependencias vulnerables en {% data variables.product.prodname_ghe_server %}.' -redirect_from: - - /enterprise/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server -versions: - enterprise-server: '*' ---- - -### Acerca de las alertas para las dependencias vulnerables en {% data variables.product.prodname_ghe_server %} - -{% data reusables.repositories.tracks-vulnerabilities %} Para obtener más información, consulta la sección "[Acerca de las alertas para las dependencias vulnerables](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)". - -Puedes conectar {% data variables.product.product_location_enterprise %} a {% data variables.product.prodname_dotcom_the_website %}, luego sincronizar los datos de vulnerabilidad para tu instancia y generar alertas de seguridad en los repositorios con dependencias vulnerables. - -Luego de conectar {% data variables.product.product_location_enterprise %} a {% data variables.product.prodname_dotcom_the_website %} y de habilitar las alertas de seguridad para las dependencias vulnerables, los datos de vulnerabilidad se sincronizan desde {% data variables.product.prodname_dotcom_the_website %} hasta tu instancia cada una hora. También puedes elegir sincronizar manualmente los datos de vulnerabilidad en cualquier momento. No se han cargado códigos o información sobre el código desde {% data variables.product.product_location_enterprise %} hasta {% data variables.product.prodname_dotcom_the_website %}. - -Cuando {% data variables.product.product_location_enterprise %} recibe información sobre una vulnerabilidad, identificará repositorios en su instancia que usa la versión afectada de la dependencia y envía alertas de seguridad a los propietarios y a las personas con accesos administrativos en estos repositorios. Pueden personalizar cómo recibir las alertas de seguridad. Para obtener más información, consulta la sección "[Acerca de las alertas para las dependencias vulnerables](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies/#configuring-notifications-for-security-alerts)". - -### Habilitar alertas de seguridad para las dependencias vulnerables en {% data variables.product.prodname_ghe_server %} - -Antes de habilitar las alertas de seguridad para dependencias vulnerables en {% data variables.product.product_location_enterprise %}, debes conectar {% data variables.product.product_location_enterprise %} en {% data variables.product.prodname_dotcom_the_website %}. Para obtener más información, consulta "[Conectar {% data variables.product.prodname_ghe_server %} a {% data variables.product.prodname_ghe_cloud %}](/enterprise/{{ currentVersion }}/admin/guides/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)." - -{% if currentVersion ver_gt "enterprise-server@2.20" %} Te recomendamos configurar las alertas de seguridad sin notificaciones durante los primeros días para evitar una sobrecarga de correos electrónicos. Después de algunos cuantos días, puedes habilitar las notificaciones para recibir alertas de seguridad como de costumbre.{% endif %} - -{% data reusables.enterprise_site_admin_settings.sign-in %} -2. En el shell administrativo, habilita las alertas de seguridad para las dependencias vulnerables en {% data variables.product.product_location_enterprise %}: - ``` shell -$ ghe-dep-graph-enable -``` -3. Regresar a {% data variables.product.prodname_ghe_server %}. -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %}{% if currentVersion ver_gt "enterprise-server@2.20" %} -5. Debajo de "Los repositorios pueden escanearse par encontrar vulnerabilidades", utiliza el menú desplegable y selecciona **Habilitado sin notificaciones**. Opcionalmente, para habilitar las alertas con notificaciones, selecciona **Habilitado con notificaciones**.{% else %} -5. En "Los repositorios se pueden escanear para encontrar vulnerabilidades", usa el menú desplegable y selecciona **Enabled** (Habilitado). -{% endif %} - ![Menú desplegable para habilitar el escaneo de repositorios para buscar vulnerabilidades](/assets/images/enterprise/site-admin-settings/enable-vulnerability-scanning-in-repositories.png) - -### Ver las dependencias vulnerables en {% data variables.product.prodname_ghe_server %} - -Puedes ver todas las vulnerabilidades en {% data variables.product.product_location_enterprise %} y sincronizar en forma manual los datos de vulnerabilidad desde {% data variables.product.prodname_dotcom_the_website %} para actualizar la lista. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -2. En la barra lateral izquierda, haz clic en **Vulnerabilities** (Vulnerabilidades). ![Pestaña de vulnerabilidades de la barra lateral del administrador del sitio](/assets/images/enterprise/business-accounts/vulnerabilities-tab.png) -3. Para sincronizar los datos de vulnerabilidades, haz clic en **Sync Vulnerabilities now** (Sincronizar vulnerabilidades ahora). ![Botón de Sincronizar vulnerabilidades ahora](/assets/images/enterprise/site-admin-settings/sync-vulnerabilities-button.png) diff --git a/translations/es-XL/content/admin/installation/enabling-subdomain-isolation.md b/translations/es-XL/content/admin/installation/enabling-subdomain-isolation.md deleted file mode 100644 index 1f1e8115f80b..000000000000 --- a/translations/es-XL/content/admin/installation/enabling-subdomain-isolation.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: Habilitar el aislamiento de subdominio -intro: 'Puedes configurar el aislamiento de subdominio para separar en forma segura el contenido suministrado por el usuario de las demás partes de tu aparato {% data variables.product.prodname_ghe_server %}.' -redirect_from: - - /enterprise/admin/guides/installation/about-subdomain-isolation/ - - /enterprise/admin/installation/enabling-subdomain-isolation -versions: - enterprise-server: '*' ---- - -### Acerca del aislamiento de subdominio - -El aislamiento de subdominio mitiga las vulnerabilidades del estilo cross-site scripting y otras vulnerabilidades relacionadas. Para obtener más información, consulta "[Cross-site scripting](http://en.wikipedia.org/wiki/Cross-site_scripting)" en Wikipedia. Es altamente recomendable que habilites el aislamiento de subdominio en {% data variables.product.product_location_enterprise %}. - -Cuando el aislamiento de subdominio está habilitado, {% data variables.product.prodname_ghe_server %} reemplaza varias rutas con subdominios. - -| Ruta sin aislamiento de subdominio | Ruta con aislamiento de subdominio | -| ---------------------------------- | ---------------------------------- | -| `http(s)://HOSTNAME/assets/` | `http(s)://assets.HOSTNAME/` | -| `http(s)://HOSTNAME/avatars/` | `http(s)://avatars.HOSTNAME/` | -| `http(s)://HOSTNAME/codeload/` | `http(s)://codeload.HOSTNAME/` | -| `http(s)://HOSTNAME/gist/` | `http(s)://gist.HOSTNAME/` | -| `http(s)://HOSTNAME/media/` | `http(s)://media.HOSTNAME/` | -| `http(s)://HOSTNAME/pages/` | `http(s)://pages.HOSTNAME/` | -| `http(s)://HOSTNAME/raw/` | `http(s)://raw.HOSTNAME/` | -| `http(s)://HOSTNAME/render/` | `http(s)://render.HOSTNAME/` | -| `http(s)://HOSTNAME/reply/` | `http(s)://reply.HOSTNAME/` | -| `http(s)://HOSTNAME/uploads/` | `http(s)://uploads.HOSTNAME/` | - -### Prerrequisitos - -{% data reusables.enterprise_installation.disable-github-pages-warning %} - -Antes de que habilites el aislamiento de subdominio, debes configurar tus ajustes de red para el nuevo dominio. - -- Especifica un nombre de dominio válido como tu nombre del host, en lugar de una dirección IP. Para obtener más información, consulta "[Configurar un nombre del host](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-a-hostname)." - -{% data reusables.enterprise_installation.changing-hostname-not-supported %} - -- Configura un registro de Sistema de nombres de dominio (DNS) de carácter comodín o registros DNS individuales para los subdominios detallados más arriba. Recomendamos crear un registro A para `*.HOSTNAME` que apunte a la dirección IP de tu servidor así no tienes que crear múltiples registros para cada subdominio. -- Obtén un certificado de Seguridad de la capa de transporte (TLS) de carácter comodín para `*.HOSTNAME` con un Nombre alternativo del firmante (SAN) para el `HOSTNAME` y para el `*.HOSTNAME` de dominio de carácter comodín. Por ejemplo, si tu nombre del host es `*.github.octoinc.com` obtén un certificado con el valor del nombre común configurado en `*.github.octoinc.com` y un valor SAN configurado en `github.octoinc.com` y `*.github.octoinc.com`. -- Habilita TLS en tu aparato. Para obtener más información, consulta "[Configurar TLS](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-tls/)." - -### Habilitar el aislamiento de subdominio - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.hostname-menu-item %} -4. Selecciona **Subdomain isolation (recommended)** (Aislamiento de subdominio [recomendado]). ![Casilla de verificación para habilitar el aislamiento de subdominio](/assets/images/enterprise/management-console/subdomain-isolation.png) -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/es-XL/content/admin/installation/enabling-unified-contributions-between-github-enterprise-server-and-githubcom.md b/translations/es-XL/content/admin/installation/enabling-unified-contributions-between-github-enterprise-server-and-githubcom.md deleted file mode 100644 index fa5baf43bbe2..000000000000 --- a/translations/es-XL/content/admin/installation/enabling-unified-contributions-between-github-enterprise-server-and-githubcom.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: Habilitar aportes unificados entre el Servidor de GitHub Enterprise y GitHub.com -intro: 'Después de habilitar {% data variables.product.prodname_github_connect %}, puedes permitir {% data variables.product.prodname_ghe_cloud %} que los miembros destaquen su trabajo en {% data variables.product.prodname_ghe_server %} al enviar los recuentos de contribuciones a sus {% data variables.product.prodname_dotcom_the_website %} perfiles.' -redirect_from: - - /enterprise/admin/guides/developer-workflow/enabling-unified-contributions-between-github-enterprise-and-github-com/ - - /enterprise/admin/guides/developer-workflow/enabling-unified-contributions-between-github-enterprise-server-and-github-com/ - - /enterprise/admin/developer-workflow/enabling-unified-contributions-between-github-enterprise-server-and-githubcom/ - - /enterprise/admin/installation/enabling-unified-contributions-between-github-enterprise-server-and-githubcom -permissions: 'Los administradores de sitio para {% data variables.product.prodname_ghe_server %} que también sean dueños de la cuenta organizacional o empresarial conectada de {% data variables.product.prodname_ghe_cloud %} pueden habilitar las contribuciones unificadas entre {% data variables.product.prodname_ghe_server %} y {% data variables.product.prodname_dotcom_the_website %}.' -versions: - enterprise-server: '*' ---- - -Como un administrador del sitio, puedes habilitar a los usuarios finales para que envíen sus recuentos de contribuciones de manera anónima por sus trabajos desde {% data variables.product.prodname_ghe_server %} a sus gráficos de contribuciones {% data variables.product.prodname_dotcom_the_website %}. - -Después de habilitar {% data variables.product.prodname_github_connect %} y habilitar {% data variables.product.prodname_unified_contributions %} en ambos entornos, los usuarios finales a tu instancia pueden conectarse a sus {% data variables.product.prodname_dotcom_the_website %} cuentas y enviar recuentos de contribuciones desde {% data variables.product.prodname_ghe_server %} a {% data variables.product.prodname_dotcom_the_website %}. {% data reusables.github-connect.sync-frequency %} Para obtener más información, consulta "[Enviar tus contribuciones {% data variables.product.prodname_ghe_server %} a tu perfil {% data variables.product.prodname_dotcom_the_website %}](/articles/sending-your-github-enterprise-server-contributions-to-your-github-com-profile/)." - -Si el administrador del sitio inhabilita la funcionalidad o la opción de los programadores de la conexión, los recuentos de contribuciones {% data variables.product.prodname_ghe_server %} se borrarán en {% data variables.product.prodname_dotcom_the_website %}. Si el programador vuelve a conectar sus perfiles luego de inhabilitarlos, se restablecerán los recuentos de contribución para los últimos 90 días. - -{% data variables.product.prodname_ghe_server %} **únicamente** envía el recuento de contribución y la fuente ({% data variables.product.prodname_ghe_server %}) de los usuarios conectados. No envía ningún tipo de información sobre la contribución o cómo se realizó. - -Antes de habilitar {% data variables.product.prodname_unified_contributions %} en {% data variables.product.product_location_enterprise %}, debes conectar {% data variables.product.product_location_enterprise %} a {% data variables.product.prodname_dotcom_the_website %}. Para obtener más información, consulta "[Conectarse a {% data variables.product.prodname_ghe_server %} para {% data variables.product.prodname_dotcom_the_website %}](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/connecting-github-enterprise-server-to-github-com)." - -{% data reusables.github-connect.access-dotcom-and-enterprise %} -{% data reusables.enterprise_site_admin_settings.access-settings %}{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %} -4. En "Los usuarios pueden compartir recuentos de contribuciones en {% data variables.product.prodname_dotcom_the_website %}", haz clic en **Request access (Solicita acceso)**. ![Solicitud para acceder a la opción de contribuciones unificadas](/assets/images/enterprise/site-admin-settings/dotcom-ghe-connection-request-access.png) -5. [Inicia sesión](https://enterprise.github.com/login) en el sitio {% data variables.product.prodname_ghe_server %} para recibir más instrucciones. - -Cuando solicitas acceso, te redireccionaremos al sitio {% data variables.product.prodname_ghe_server %} para comprobar tus términos de servicio actuales. Si {% data variables.product.product_location_enterprise %} utiliza los términos de servicio estándar, la solicitud automáticamente te redireccionará a las instrucciones para habilitar {% data variables.product.prodname_unified_contributions %}. Si estás utilizando los términos de servicio personalizados, registraremos tu solicitud y te contactaremos para configurar el acceso. diff --git a/translations/es-XL/content/admin/installation/enabling-unified-search-between-github-enterprise-server-and-githubcom.md b/translations/es-XL/content/admin/installation/enabling-unified-search-between-github-enterprise-server-and-githubcom.md deleted file mode 100644 index 9e524c5dde6d..000000000000 --- a/translations/es-XL/content/admin/installation/enabling-unified-search-between-github-enterprise-server-and-githubcom.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: Habilitar la búsqueda unificada entre el Servidor de GitHub Enterprise y GitHub.com -intro: 'Después de habilitar {% data variables.product.prodname_github_connect %}, puedes permitir la búsqueda de {% data variables.product.prodname_dotcom_the_website %} desde {% data variables.product.product_location_enterprise %}.' -redirect_from: - - /enterprise/admin/guides/developer-workflow/enabling-unified-search-between-github-enterprise-and-github-com/ - - /enterprise/admin/guides/developer-workflow/enabling-unified-search-between-github-enterprise-server-and-github-com/ - - /enterprise/admin/developer-workflow/enabling-unified-search-between-github-enterprise-server-and-githubcom/ - - /enterprise/admin/installation/enabling-unified-search-between-github-enterprise-server-and-githubcom -permissions: 'Los administradores de sitio para {% data variables.product.prodname_ghe_server %} que también sean dueños de la cuenta organizacional o empresarial conectada de {% data variables.product.prodname_ghe_cloud %} pueden habilitar la búsqueda unificada entre {% data variables.product.prodname_ghe_server %} y {% data variables.product.prodname_dotcom_the_website %}.' -versions: - enterprise-server: '*' ---- - -Cuando habilitas la búsqueda unificada, los usuarios pueden ver los resultados de la búsqueda desde contenido público y privado en {% data variables.product.prodname_dotcom_the_website %} cuando buscan desde {% data variables.product.product_location_enterprise %}. - -Los usuarios no podrán buscar {% data variables.product.product_location_enterprise %} desde {% data variables.product.prodname_dotcom_the_website %}, incluso si tienen acceso a ambos entornos. Los usuarios solo pueden buscar repositorios privados para los que hayas habilitado {% data variables.product.prodname_unified_search %} y a los que tengan acceso en las organizaciones conectadas {% data variables.product.prodname_ghe_cloud %}. Para obtener más información, consulta "[Acerca de la búsqueda en {% data variables.product.prodname_dotcom %}](/articles/about-searching-on-github/#searching-across-github-enterprise-and-githubcom-simultaneously)" y "[Habilitar la búsqueda de repositorio privado {% data variables.product.prodname_dotcom_the_website %} en tu cuenta {% data variables.product.prodname_ghe_server %}](/articles/enabling-private-github-com-repository-search-in-your-github-enterprise-server-account)." - -Buscar a través de las API REST y GraphQL no incluye {% data variables.product.prodname_dotcom_the_website %} los resultados de búsqueda. No están admitidas la búsqueda avanzada y buscar wikis en {% data variables.product.prodname_dotcom_the_website %}. - -{% data reusables.github-connect.access-dotcom-and-enterprise %} -{% data reusables.enterprise_site_admin_settings.access-settings %}{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %} -5. En "Los usuarios pueden buscar {% data variables.product.prodname_dotcom_the_website %}", utiliza el menú desplegable y haz clic en **Enabled (Habilitado)**. ![Habilitar la opción de búsqueda en el menú desplegable de búsqueda de GitHub.com](/assets/images/enterprise/site-admin-settings/github-dotcom-enable-search.png) -6. De manera opcional, en "Users can search private repositories on (Los usuarios pueden buscar repositorios privados en) {% data variables.product.prodname_dotcom_the_website %}", utiliza el menú desplegable y haz clic en **Enabled (Habilitado)**. ![Habilitar la opción de búsqueda de repositorios privados en el menú desplegable de búsqueda de GitHub.com](/assets/images/enterprise/site-admin-settings/enable-private-search.png) - -### Leer más - -- "[Conectar {% data variables.product.prodname_ghe_server %} a {% data variables.product.prodname_dotcom_the_website %}](/enterprise/admin/guides/developer-workflow/connecting-github-enterprise-server-to-github-com)" diff --git a/translations/es-XL/content/admin/installation/getting-started-with-github-enterprise-server.md b/translations/es-XL/content/admin/installation/getting-started-with-github-enterprise-server.md deleted file mode 100644 index 3424281ccc3b..000000000000 --- a/translations/es-XL/content/admin/installation/getting-started-with-github-enterprise-server.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Guía de inicio para GitHub Enterprise Server -shortTitle: Empezar -intro: 'Aprende sobre {% data variables.product.prodname_ghe_server %} y sobre cómo gestionar tu licencia.' -mapTopic: verdadero -redirect_from: - - /enterprise/admin/installation/getting-started-with-github-enterprise-server -versions: - enterprise-server: '*' ---- - diff --git a/translations/es-XL/content/admin/installation/increasing-cpu-or-memory-resources.md b/translations/es-XL/content/admin/installation/increasing-cpu-or-memory-resources.md deleted file mode 100644 index 062bf008f9f1..000000000000 --- a/translations/es-XL/content/admin/installation/increasing-cpu-or-memory-resources.md +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: Aumentar el CPU o los recursos de memoria -intro: 'Para agregar CPU o recursos de memoria a una instancia {% data variables.product.prodname_ghe_server %} existente, cierra la instancia y utiliza las herramientas de la plataforma virtual subyacente para asignar los recursos a tu máquina virtual. Los nuevos recursos asignados se reconocen automáticamente al iniciar y no se necesita configuración adicional.' -redirect_from: - - /enterprise/admin/installation/increasing-cpu-or-memory-resources -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_installation.warning-on-upgrading-physical-resources %} - -### Agregar CPU o recursos de memoria para AWS - -{% note %} - -**Nota:** Para agregar CPU o recursos de memoria para AWS, debes estar familiarizado con el uso de la consola de administración de AWS o la interfaz de la línea de comando `aws ec2` para administrar instancias EC2. Para obtener antecedentes y detalles sobre el uso de herramientas de AWS de tu elección para realizar el ajuste de tamaño, consulta la documentación de AWS en [ajustar el tamaño de una instancia respaldada por Amazon EBS](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-resize.html). - -{% endnote %} - -#### Consideraciones relativas al ajuste de tamaño - -Antes de aumentar la CPU o los recursos de memoria para {% data variables.product.product_location_enterprise %}: -{% if currentVersion != "free-pro-team@latest" %} -- **Escala tu memoria con CPU** - {% data reusables.enterprise_installation.increasing-cpus-max %}{% endif %} -- **Verifica que una IP elástica esté asignada a la instancia** - - Si no se asigna una IP elástica, deberás ajustar los registros DNS A para tu servidor {% data variables.product.prodname_ghe_server %} después de volver a iniciar para considerar el cambio de la dirección de IP pública. Una vez que tu instancia se reinicia, la IP elástica (EIP) se mantiene automáticamente si la instancia se inicia en una VPC. Si la instancia se inicia en una EC2-Classic, la IP elástica debe asociarse nuevamente de forma manual. - -#### Tipos de instancias AWS admitidos - -Debes determinar el tipo de instancia que te gustaría actualizar en base a especificaciones de CPU/memoria. -{% data reusables.enterprise_installation.aws-supported-instance-types %} - -#### Tipos de instancias AWS recomendadas - -{% data reusables.enterprise_installation.aws-recommended-instance-types %} - -{% data reusables.enterprise_installation.warning-on-scaling %} - -#### Volver a ajustar el tamaño para AWS - -{% note %} - -**Nota:** Para instancias iniciadas en EC2-Classic, escribe la dirección de IP elástica asociada con la instancia y las ID de las instancias. Una vez que reiniciaste la instancia, vuelve a asociar la dirección de IP elástica. - -{% endnote %} - -Si no es posible agregar un CPU o recursos de memoria a una instancia AWS/EC2 existente. En su lugar, debes: - -1. Frenar la instancia. -2. Cambiar el tipo de instancia. -3. Iniciar la instancia. -{% data reusables.enterprise_installation.configuration-recognized %} - -### Agregar CPU o recursos de memoria para OpenStack KVM - -No es posible agregar CPU o recursos de memoria para una instancia OpenStack KVM existente. En su lugar, debes: - -1. Tomar una instantánea para la instancia actual. -2. Frenar la instancia. -3. Seleccionar un nuevo formato de la instancia que tenga el CPU o los recursos de memoria deseados. - -### Agregar CPU o recursos de memoria para VMWare - -Si las operaciones en {% data variables.product.product_location_enterprise %} son lentas, es posible que necesites agregar CPU o recursos de memoria. - -{% data reusables.enterprise_installation.increasing-cpus-max %} - -1. Utiliza vSphere Client para conectar al servidor de VMware ESXi. -2. Cierra {% data variables.product.product_location_enterprise %}. -3. Selecciona la máquina virtual y haz clic en **Edit Settings (Editar parámetros)**. -4. En "Hardware", ajusta el CPU o los recursos de memoria asignados a la máquina virtual según se necesite: ![Recursos de configuración de WMware](/assets/images/enterprise/vmware/vsphere-hardware-tab.png) -5. Para iniciar la máquina virtual, haz clic en **OK**. -{% data reusables.enterprise_installation.configuration-recognized %} diff --git a/translations/es-XL/content/admin/installation/increasing-storage-capacity.md b/translations/es-XL/content/admin/installation/increasing-storage-capacity.md deleted file mode 100644 index 578fe9b939c6..000000000000 --- a/translations/es-XL/content/admin/installation/increasing-storage-capacity.md +++ /dev/null @@ -1,57 +0,0 @@ ---- -title: Aumentar la capacidad de almacenamiento -intro: 'Puedes aumentar o cambiar la cantidad de almacenamiento disponible para los repositorios de Git, las bases de datos, los índices de búsqueda y otros datos de aplicaciones persistentes.' -redirect_from: - - /enterprise/admin/installation/increasing-storage-capacity -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_installation.warning-on-upgrading-physical-resources %} - -A medida que se suman usuarios {% data variables.product.product_location_enterprise %}, es posible que necesites ajustar el tamaño de tu volumen de almacenamiento. Consulta la documentación de tu plataforma de virtualización para obtener más información sobre ajuste de tamaño de almacenamiento. - -### Requisitos y recomendaciones - -{% note %} - -**Nota:** Antes de ajustar el tamaño del volumen de almacenamiento del usuario, pon tu instancia en modo mantenimiento. Para obtener más información, consulta "[Habilitar y programar el modo mantenimiento](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)." - -{% endnote %} - -{% data reusables.enterprise_installation.hardware-rec-table %} - -### Aumentar el tamaño de partición de datos - -1. Ajusta el disco de volumen existente del usuario utilizando las herramientas de tu plataforma de virtualización. -{% data reusables.enterprise_installation.ssh-into-instance %} -3. Pon el aparato en modo mantenimiento. Para obtener más información, consulta "[Habilitar y programar el modo mantenimiento](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)." -4. Reinicia el aparato para detectar la nueva asignación de almacenamiento. -5. Ejecuta el comando `ghe-storage-extend` para expandir el sistema de archivos `/data`: - ```shell - $ ghe-storage-extend - ``` - -### Aumentar el tamaño de partición raíz utilizando un nuevo aparato - -1. Configura una nueva instancia {% data variables.product.prodname_ghe_server %} con un disco raíz más grande utilizando la misma versión que tu aparato actual. Para obtener más información, consulta "[Configurar una instancia {% data variables.product.prodname_ghe_server %} ](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-github-enterprise-server-instance)." -2. Cierra el aparato actual. -3. Desconecta el disco de datos de tu aparato actual utilizando las herramientas de tu plataforma de virtualización. -4. Conecta el disco de datos al nuevo aparato con un disco raíz más grande. - -### Aumentar el tamaño de partición raíz utilizando un aparato existente - -1. Conecta un nuevo disco a tu aparato {% data variables.product.prodname_ghe_server %}. -2. Ejecuta el comando `parted` para formatear el disco: - ```shell - $ sudo parted /dev/xvdg mklabel msdos - $ sudo parted /dev/xvdg mkpart primary ext4 0% 50% - $ sudo parted /dev/xvdg mkpart primary ext4 50% 100% - ``` -3. Ejecuta el comando `ghe-upgrade` para instalar un paquete específico de plataforma completo al disco recientemente particionado. Un paquete de actualización de hotpatch universal, como `github-enterprise-2.11.9.hpkg` no funcionará como se espera. - ```shell - $ ghe-upgrade PACKAGE-NAME.pkg -s -t /dev/xvdg1 - ``` -4. Cierra el aparato. -5. En el hipervisor, quita el disco raíz anterior y agrega el nuevo disco raíz en la misma ubicación del disco raíz anterior. -6. Inicia el aparato. diff --git a/translations/es-XL/content/admin/installation/initiating-a-failover-to-your-replica-appliance.md b/translations/es-XL/content/admin/installation/initiating-a-failover-to-your-replica-appliance.md deleted file mode 100644 index 77082e484723..000000000000 --- a/translations/es-XL/content/admin/installation/initiating-a-failover-to-your-replica-appliance.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Iniciar una tolerancia de fallos a tu aparato de réplica -intro: 'Puedes tener tolerancia de fallos en un aparato de réplica {% data variables.product.prodname_ghe_server %} por medio de la línea de comando para mantenimiento y pruebas, o si falla el aparato principal.' -redirect_from: - - /enterprise/admin/installation/initiating-a-failover-to-your-replica-appliance -versions: - enterprise-server: '*' ---- - -El tiempo requerido para la tolerancia de fallos depende de cuánto le tome para impulsar la réplica y redireccionar el tráfico de forma manual. El tiempo promedio varía entre 2 y 10 minutos. - -{% data reusables.enterprise_installation.promoting-a-replica %} - -1. Para permitir que la replicación finalice antes de cambiar aparatos, pon el aparato principal en modo mantenimiento: - - Para usar el administrador de consola, consulta "[Habilitar y programar el modo mantenimiento](/enterprise/admin/guides/installation/enabling-and-scheduling-maintenance-mode/)" - - También puedes usar el comando `ghe-maintenance -s`. - ```shell - $ ghe-maintenance -s - ``` -2. Cuando el número de operaciones Git activas llega a cero, espera 30 segundos. -3. Para verificar que todos los canales de replicación informan `OK`, utiliza el comando `ghe-repl-status -vv`. - ```shell - $ ghe-repl-status -vv - ``` -4. Para frenar la replicación e impulsar el aparato de réplica a un estado primario, utiliza el comando `ghe-repl-promote`. Esto también pondrá de forma automática al nodo primario en nodo mantenimiento si es accesible. - ```shell - $ ghe-repl-promote - ``` -5. Actualiza el registro de DNS para que apunte a la dirección IP de la réplica. El tráfico es direccionado a la réplica después de que transcurra el período TTL. Si estás utilizando un balanceador de carga, asegúrate de que esté configurado para enviar el tráfico a la réplica. -6. Notifica a los usuarios que pueden retomar las operaciones normales. -7. Si se desea, configura una replicación desde el aparato principal nuevo al aparato existente y el principal anterior. Para obtener más información, consulta "[Acerca de la configuración de alta disponibilidad](/enterprise/{{ currentVersion }}/admin/guides/installation/about-high-availability-configuration/#utilities-for-replication-management)." - -### Leer más - -- "[Utilidades para la gestión de replicaciones](/enterprise/{{ currentVersion }}/admin/guides/installation/about-high-availability-configuration/#utilities-for-replication-management)" diff --git a/translations/es-XL/content/admin/installation/log-forwarding.md b/translations/es-XL/content/admin/installation/log-forwarding.md deleted file mode 100644 index aeafc294c1fa..000000000000 --- a/translations/es-XL/content/admin/installation/log-forwarding.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Redireccionamiento de registro -intro: '{% data variables.product.prodname_enterprise %} utiliza `syslog-ng` para redireccionar los registros de la aplicación y del sistema al servidor que especifiques en los parámetros {% data variables.enterprise.management_console %}.' -redirect_from: - - /enterprise/admin/articles/log-forwarding/ - - /enterprise/admin/installation/log-forwarding -versions: - enterprise-server: '*' ---- - -Es compatible cualquier sistema de recopilación de registro que admita los flujos de registro syslog-style (p. ej., [Logstash](http://logstash.net/) y [Splunk](http://docs.splunk.com/Documentation/Splunk/latest/Data/Monitornetworkports)). - -### Habilitar redireccionamiento de registro - -1. En la página de parámetros {% data variables.enterprise.management_console %}, en la barra lateral izquierda, haz clic en **(Monitoring) Revisar**. -1. Selecciona **Enable log forwarding (Habilitar redireccionamiento de registro)**. -1. En el campo **Server address (Dirección del servidor)**, escribe la dirección del servidor al que desees redireccionar los registros. Puedes especificar varias direcciones en una lista de separación por coma. -1. En el menú desplegable de Protocolo, selecciona el protocolo a utilizar para que se comunique con el servidor de registro. El protocolo se aplicará a todos los destinos de registro especificados. -1. Selecciona **Enable TLS (Habilitar TLS)**. -1. Haz clic en **Choose File (Elegir el archivo)** y elige un certificado CA para encriptar la comunicación entre puntos de conexión syslog. Se validará la cadena de certificado completa, y debe terminar en un certificado raíz. Para obtener más información, consulta [Opciones TLS en la documentación de syslog-ng](https://support.oneidentity.com/technical-documents/syslog-ng-open-source-edition/3.16/administration-guide/56#TOPIC-956599). - -### Solución de problemas - -Si encuentras problemas con el redireccionamiento de registro, contacta a {% data variables.contact.contact_ent_support %} y adjunta el archivo de salida de `http(s)://[hostname]/setup/diagnostics` to your email. diff --git a/translations/es-XL/content/admin/installation/managing-billing-for-github-enterprise.md b/translations/es-XL/content/admin/installation/managing-billing-for-github-enterprise.md deleted file mode 100644 index d3cd00a1adcf..000000000000 --- a/translations/es-XL/content/admin/installation/managing-billing-for-github-enterprise.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: Administrar la facturación para GitHub Enterprise -intro: 'Puedes ver el uso de licencias, facturas, historial de pagos, y otra información de facturación para tu cuenta empresarial y para las instancias de {% data variables.product.prodname_ghe_server %}.' -product: '{% data reusables.gated-features.enterprise-accounts %}' -redirect_from: - - /enterprise/admin/installation/managing-billing-for-github-enterprise -versions: - enterprise-server: '*' ---- - -### Acerca de la facturación para las cuentas de empresa - -Las cuentas empresariales actualmente están disponibles para los clientes de {% data variables.product.prodname_enterprise %} que pagan por factura. La facturación para todas las organizaciones e instancias de {% data variables.product.prodname_ghe_server %} conectadas con tu cuenta empresarial se conjunta en un solo cargo por factura para todos tus servicios pagados de {% data variables.product.prodname_dotcom_the_website %} (incluyendo las licencias pagadas en organizaciones, paquetes de datos de {% data variables.large_files.product_name_long %}, y suscripciones a las apps de {% data variables.product.prodname_marketplace %}). - -Los propietarios de la empresa y los gerente de facturación pueden acceder y administrar todas las configuraciones de facturación para las cuentas de empresa. Para obtener más información acerca de las cuentas empresariales, consulta la sección "[Roles de una cuenta empresarial](/github/setting-up-and-managing-your-enterprise-account/roles-for-an-enterprise-account)". Para obtener más información acerca de administrar a los gerente de facturación, consulta [Invitar a personas para que administren tu cuenta de empresa](/github/setting-up-and-managing-your-enterprise-account/inviting-people-to-manage-your-enterprise-account)". - -### Visualizar tu factura actual - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.billing-tab %} -4. Dabajo de "Acciones Rápidas", da clic en **Ver factura**. ![Enlace para ver factura](/assets/images/help/business-accounts/view-invoice-link.png) - -### Pagar tu factura actual - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.billing-tab %} -4. Dabajo de "Acciones Rápidas", da clic en **Pagar factura**. ![Enlace para pagar factura](/assets/images/help/business-accounts/pay-invoice-link.png) -5. Debajo de "Pagar factura", teclea tu información de tarjeta de crédito en la forma segura, posteriormente, da clic en **Pagar factura**. ![Confirmar y pagar la factura](/assets/images/help/business-accounts/pay-invoice.png) - -### Descargar tu factura actual - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.billing-tab %} -4. Dabajo de "Acciones Rápidas", da clic en **Descargar factura actual**. ![Enlace de descarga de factura actual](/assets/images/help/business-accounts/download-current-invoice.png) - -### Ver tu historial de pagos - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.billing-tab %} -4. Debajo de "Facturación", da clic en **Facturas pasadas** para ver un resumen de tu actividad de facturación pasada. ![Pestaña de ver historial de pago](/assets/images/help/business-accounts/view-payment-history.png) diff --git a/translations/es-XL/content/admin/installation/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud.md b/translations/es-XL/content/admin/installation/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud.md deleted file mode 100644 index 0d6ef9dfb1c6..000000000000 --- a/translations/es-XL/content/admin/installation/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: Administrar conexiones entre el servidor de GitHub Enterprise y GitHub Enterprise Cloud -intro: 'Con {% data variables.product.prodname_github_connect %}, puedes compartir determinadas características y datos entre {% data variables.product.product_location_enterprise %} y la cuenta de tu organización u emprendimiento {% data variables.product.prodname_ghe_cloud %} en {% data variables.product.prodname_dotcom_the_website %}.' -mapTopic: true -redirect_from: - - /enterprise/admin/developer-workflow/connecting-github-enterprise-to-github-com - - /enterprise/admin/guides/developer-workflow/connecting-github-enterprise-and-github-com/ - - /enterprise/admin/guides/developer-workflow/connecting-github-enterprise-server-and-github-com/ - - /enterprise/admin/developer-workflow/connecting-github-enterprise-server-and-githubcom/ - - /enterprise/admin/installation/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud -versions: - enterprise-server: '*' ---- - diff --git a/translations/es-XL/content/admin/installation/managing-your-github-enterprise-license.md b/translations/es-XL/content/admin/installation/managing-your-github-enterprise-license.md deleted file mode 100644 index f86c7cef2235..000000000000 --- a/translations/es-XL/content/admin/installation/managing-your-github-enterprise-license.md +++ /dev/null @@ -1,70 +0,0 @@ ---- -title: Administrar tu licencia de GitHub Enterprise -intro: 'Puedes ver, gestionar y actualizar tu licencia de {% data variables.product.prodname_enterprise %}.' -redirect_from: - - /enterprise/admin/categories/licenses/ - - /enterprise/admin/articles/license-files/ - - /enterprise/admin/installation/about-license-files/ - - /enterprise/admin/articles/downloading-your-license/ - - /enterprise/admin/installation/downloading-your-license/ - - /enterprise/admin/articles/upgrading-your-license/ - - /enterprise/admin/installation/updating-your-license/ - - /enterprise/admin/installation/managing-your-github-enterprise-server-license - - /enterprise/admin/installation/managing-your-github-enterprise-license -versions: - enterprise-server: '*' ---- - -### Acerca de las licencias {% data variables.product.prodname_enterprise %} - -Cuando compras o renuevas {% data variables.product.prodname_enterprise %}, recibes un archivo de licencia para validar tu aplicación. Un archivo de licencia tiene una fecha de caducidad y controla la cantidad de licencias de usuario que puedes agregar a {% data variables.product.prodname_enterprise %}. Después de que hayas descargado e instalado {% data variables.product.prodname_enterprise %}, subir el archivo de licencia desbloquea la aplicación para que la puedas usar. - -Puedes asignar las licencias de usuario incluidas en tu licencia de {% data variables.product.prodname_enterprise %} a los usuarios en {% data variables.product.product_location_enterprise %} y en una cuenta empresarial de {% data variables.product.prodname_ghe_cloud %}. Cuando agregas un usuario a algún entorno, se consumirá una licencia. Si un usuario tiene cuentas en ambos ambientes, para consumir únicamente una licencia, su dirección de correo primaria de {% data variables.product.prodname_enterprise %} debe ser la misma que su dirección de correo verificada de {% data variables.product.prodname_ghe_cloud %}. Puedes sincronizar la cantidad de licencias y el uso entre los ambientes. - -Si tu licencia vence {% data variables.product.prodname_ghe_server %}, no podrás acceder a {% data variables.product.product_location_enterprise %} por medio de un navegador web o Git. Si es necesario, podrás usar herramientas de línea de comando para hacer un respaldo de seguridad de todos tus datos. Para obtener más información, consulta "[Configurar copias de seguridad en tu aparato](/enterprise/admin/guides/installation/configuring-backups-on-your-appliance)" Si tienes cualquier duda sobre el renovamiento de tu licencia, contacta a {% data variables.contact.contact_enterprise_sales %}. - -### Subir una nueva licencia a {% data variables.product.prodname_ghe_server %} - -Después de que compras una nueva licencia o actualizas una licencia existente de {% data variables.contact.contact_enterprise_sales %}, debes descargar tu nuevo archivo de licencia. Posteriormente, carga el archivo a {% data variables.product.prodname_ghe_server %} para desbloquear tu nueva licencia de usuario. - -Si quisieras renovar o agregar licencias de usuario a {% data variables.product.prodname_enterprise %}, contacta a {% data variables.contact.contact_enterprise_sales %}. El archivo de tu licencia nueva estará disponible para la descarga de forma inmediata después de que hayas completado tu orden. - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.enterprise-licensing-tab %} -4. Debajo de "instancias de Enterprise Server", da clic en {% octicon "download" aria-label="The download icon" %} para descargar tu archivo de licencia. ![Descargar la licencia de GitHub Enterprise Server](/assets/images/help/business-accounts/download-ghes-license.png) -5. Inicia sesión en tu instancia de {% data variables.product.prodname_ghe_server %} como administrador de sitio. -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.license-tab %} -12. Dentro de "Quick links (Vínculos rápidos)", haz clic en **Update license (Actualizar licencia)**. ![Actualizar enlace de la licencia](/assets/images/enterprise/business-accounts/update-license-link.png) -13. Para seleccionar tu licencia, da clic en **Archivo de licencia**, o arrastra tu archivo de licencia a **Archivo de licencia**. ![Sube el archivo de licencia](/assets/images/enterprise/management-console/upload-license.png) -14. Da clic en **Cargar**. ![Comienza la actualización](/assets/images/enterprise/management-console/begin-upload.png) - -### Ver el uso de la licencia - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.enterprise-licensing-tab %} -4. Revisa tus licencias actuales de {% data variables.product.prodname_enterprise %}, así como las licencias de usuario disponibles y consumidas. - -### Sincronizar de forma automática el uso de la licencia de usuario con {% data variables.product.prodname_ghe_cloud %} - -Puedes utilizar {% data variables.product.prodname_github_connect %} para sincronizar de forma automática el conteo y el uso de la licencia de usuario entre {% data variables.product.prodname_ghe_server %} y {% data variables.product.prodname_ghe_cloud %}. Para obtener más información, consulta "[Habilitar la sincronización de licencia de usuario entre {% data variables.product.prodname_ghe_server %} y {% data variables.product.prodname_ghe_cloud %}](/enterprise/{{currentVersion}}/admin/installation/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud)." - -### Sincronizar el uso de licencias de usuario manualmente entre {% data variables.product.prodname_ghe_server %} y {% data variables.product.prodname_ghe_cloud %} - -Puedes descargar un archivo JSON desde {% data variables.product.prodname_ghe_server %} y subir el archivo a {% data variables.product.prodname_ghe_cloud %} para sincronizar de forma manual el uso de la licencia de usuario entre dos implementaciones. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.license-tab %} -5. Dentro de "Quick links (Vínculos rápidos)", para descargar un archivo que contiene tu uso de licencia actual en {% data variables.product.prodname_ghe_server %}, haz clic en **Export license usage (Exportar uso de licencia)**. ![Exporta el vínculo de uso de la licencia](/assets/images/enterprise/business-accounts/export-license-usage-link.png) -6. Ve a {% data variables.product.prodname_ghe_cloud %}. -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.enterprise-licensing-tab %} -10. Debajo de "Instancias de Enterprise Server", da clic en **Agregar uso del servidor**. ![Sube el vínculo de uso de los servidores de GitHub Enterprise](/assets/images/help/business-accounts/upload-ghe-server-usage-link.png) -11. Sube el archivo JSON que descargaste de {% data variables.product.prodname_ghe_server %}. ![Arrastra y suelta o selecciona un archivo para cargar](/assets/images/help/business-accounts/upload-ghe-server-usage-file.png) diff --git a/translations/es-XL/content/admin/installation/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later.md b/translations/es-XL/content/admin/installation/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later.md deleted file mode 100644 index 05b1f61d94e8..000000000000 --- a/translations/es-XL/content/admin/installation/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later.md +++ /dev/null @@ -1,128 +0,0 @@ ---- -title: Migrar índices de ElasticSearch al servidor de GitHub Enterprise 2.14 o superior -intro: 'Para prepararte para una actualización a {% data variables.product.prodname_ghe_server %} 2.14, deberás migrar tus índices a Elasticsearch 5.6 con nuestro script de migración.' -redirect_from: - - /enterprise/admin/guides/installation/migrating-elasticsearch-indices-to-github-enterprise-2-14-or-later/ - - /enterprise/admin/guides/installation/migrating-elasticsearch-indices-to-github-enterprise-server-2-14-or-later - - /enterprise/admin/installation/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later -versions: - enterprise-server: '*' ---- - -El {% data variables.product.prodname_ghe_server %} 2.14 incluye una actualización a Elasticsearch 5.6. Antes de actualizar a {% data variables.product.prodname_ghe_server %} 2.14 o superior desde 2.12 o 2.13, te recomendamos que descargues, instales y ejecutes las herramientas de migración de Elasticsearch, así tus índices más grandes se migran en línea mientras tu aplicación todavía tiene acceso en línea. - -### Índices buscar - -El script de migración busca un índice `buscar` primero mientras el aparato está en línea. Migrar los índices `buscar` puede tomar desde unos minutos hasta unos días, según su tamaño. Para ejemplificar índices grandes, estos índices demoraron un par de días para migrar a nuestro entorno de prueba. - -``` -admin@ip-172-31-2-141:~$ curl -s http://localhost:9200/_cat/indices?v | sort -n -k 6 -green open blog-1 1 0 0 0 144b 144b -green open projects-1 1 0 0 0 144b 144b -green open registry-packages-1 1 0 0 0 144b 144b -green open showcases-1 1 0 0 0 144b 144b -health status index pri rep docs.count docs.deleted store.size pri.store.size -green open pull-requests-1 1 0 1 0 9.3kb 9.3kb -green open wikis-1 1 0 2 0 5kb 5kb -green open hookshot-logs-2018-05-29 5 0 25 0 124.2kb 124.2kb -green open repos-1 1 0 1638 1 1.4mb 1.4mb -green open gists-1 1 0 3531 64 291.9kb 291.9kb -green open audit_log-1-2018-06-1 1 0 11108 0 3mb 3mb -green open users-1 1 0 19866 56 2.7mb 2.7mb -green open hookshot-logs-2018-05-31 5 0 20000 0 33.4mb 33.4mb -green open hookshot-logs-2018-06-04 5 0 20000 0 32.6mb 32.6mb -green open issues-1 1 0 26405 6 82.8mb 82.8mb -green open hookshot-logs-2018-05-30 5 0 119744 0 196.8mb 196.8mb -green open audit_log-1-2018-05-1 1 0 191664 0 50mb 50mb -green open code-search-1 1 0 6932626 44 42.9gb 42.9gb -green open commits-1 1 0 63753587 1485 45.4gb 45.4gb -``` - -Los índices `buscar` comienzan con: - -- blog- -- code-search- -- commits- -- gists- -- issues- -- labels- -- marketplace-listings- -- non-marketplace-listings- -- projects- -- pull-requests- -- registry-packages- -- repos- -- showcases- -- topics- -- usuarios- - -### Índices Webhooks - -Después de que el script de migración reconstruye los índices `buscar` necesarios en línea, el script verificará si algún índice `webhook` debe ser reconstruido. Si ejecutas tu aparato con el {% data variables.product.prodname_ghe_server %} 2.12 o 2.13 durante 14 días o más, entonces probablemente no necesitarás que tu índice `webhook` se reconstruya ya que los índices `webhook` tienen una política de retención predeterminada de siete días. Si estás actualizando tu aparato desde el {% data variables.product.prodname_enterprise %} 2.11 o inferior, entonces es posible que debas reconstruir los índices `webhook`. - -Si algún índice `webhook` debe ser reconstruido, entonces se te pedirá habilitar el modo mantenimiento antes de que el script pueda reconstruir los índices `webhook`. A pesar de que migrar los índices `webhook` requiere algo de tiempo de inactividad, no se necesitan grandes ventanas de mantenimiento o tiempo de inactividad. - -Los índices `webhook` comienzan con `hookshot-logs-`. - -### Índices disponibles - -Puedes ver los índices disponibles en tu aparato utilizando cURL. - -``` -admin@ip-172-31-2-141:~$ curl -s http://localhost:9200/_cat/indices?v | sort -n -k 6 -green open blog-1 1 0 0 0 144b 144b -green open projects-1 1 0 0 0 144b 144b -green open registry-packages-1 1 0 0 0 144b 144b -green open showcases-1 1 0 0 0 144b 144b -health status index pri rep docs.count docs.deleted store.size pri.store.size -green open pull-requests-1 1 0 1 0 9.3kb 9.3kb -green open wikis-1 1 0 2 0 5kb 5kb -green open hookshot-logs-2018-05-29 5 0 25 0 124.2kb 124.2kb -green open repos-1 1 0 1638 1 1.4mb 1.4mb -green open gists-1 1 0 3531 64 291.9kb 291.9kb -green open audit_log-1-2018-06-1 1 0 11108 0 3mb 3mb -green open users-1 1 0 19866 56 2.7mb 2.7mb -green open hookshot-logs-2018-05-31 5 0 20000 0 33.4mb 33.4mb -green open hookshot-logs-2018-06-04 5 0 20000 0 32.6mb 32.6mb -green open issues-1 1 0 26405 6 82.8mb 82.8mb -green open hookshot-logs-2018-05-30 5 0 119744 0 196.8mb 196.8mb -green open audit_log-1-2018-05-1 1 0 191664 0 50mb 50mb -green open code-search-1 1 0 6932626 44 42.9gb 42.9gb -green open commits-1 1 0 63753587 1485 45.4gb 45.4gb -``` - -### Preparar un aparato del {% data variables.product.prodname_ghe_server %} 2.12 o 2.13 - -Si actualizas a {% data variables.product.prodname_ghe_server %} 2.14 o superior sin ejecutar las herramientas de migración, los índices Elasticsearch existentes pueden ser inválidos y no funcionarán correctamente. Para ejecutar el script de migración de Elasticsearch, tu aparato del {% data variables.product.prodname_ghe_server %} debe estar ejecutando {% data variables.product.prodname_enterprise %} 2.12 o 2.13. - -{% warning %} - -**Advertencia:** -- Utilizar {% data variables.product.prodname_enterprise_backup_utilities %} destruirá los índices Elasticsearch antiguos no compatibles con 5.X después de la restauración. En este caso, es posible que sea necesaria una nueva indexación manual. -- Si {% data variables.product.prodname_ghe_server %} está configurado para alta disponibilidad, el script de migración **debe** ejecutarse mientras todavía se está ejecutando la replicación. Deben permitirse los cambios para replicar completamente al otro aparato antes de iniciar la actualización. Si la replicación no se está ejecutando mientras se ejecuta el script de migración, tus índices Elasticsearch pueden volverse inválidos. - -{% endwarning %} - -1. Autentícate en el aparato principal con alta disponibilidad habilitado utilizando SSH. -2. Descarga e instala el script de migración en el aparato: - ```shell - $ wget https://github-enterprise.s3.amazonaws.com/util/es-5x-transition-tools.tar.gz - $ sudo tar -C / -xvf es-5x-transition-tools.tar.gz - ``` - Si administras una Agrupación del {% data variables.product.prodname_ghe_server %}, autentica a uno de los nodos de servidores de Elasticsearch utilizando SSH e instala las herramientas de migración allí. Búscalos utilizando: - ```shell - $ ghe-cluster-each -r elasticsearch -p - ghe-test-data-0 - ghe-test-data-1 - ghe-test-data-2 - ``` -2. Ejecuta el script de migración: - ```shell - $ /usr/local/share/enterprise/ghe-es-5x-migration -r - ``` - {% note %} - - **Nota:** Si tiene índices `webhook` para migrar, después de ejecutar las migraciones en línea, se te pedirá que habilites el modo mantenimiento. - - {% endnote %} -3. Si estás ejecutando una Agrupación {% data variables.product.prodname_ghe_server %}, sigue la documentación oficial de actualización para VM únicos o entornos de alta disponibilidad o la guía de actualización de agrupación. Para obtener más información, consulta "[Actualizar {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-github-enterprise-server/)" o "[Actualizar una agrupación](/enterprise/{{ currentVersion }}/admin/guides/clustering/upgrading-a-cluster/)". diff --git a/translations/es-XL/content/admin/installation/migrating-from-github-enterprise-1110x-to-2123.md b/translations/es-XL/content/admin/installation/migrating-from-github-enterprise-1110x-to-2123.md deleted file mode 100644 index 1869017e1d07..000000000000 --- a/translations/es-XL/content/admin/installation/migrating-from-github-enterprise-1110x-to-2123.md +++ /dev/null @@ -1,90 +0,0 @@ ---- -title: Migrar desde GitHub Enterprise 11.10.x a 2.1.23 -redirect_from: - - /enterprise/admin-guide/migrating/ - - /enterprise/admin/articles/migrating-github-enterprise/ - - /enterprise/admin/guides/installation/migrating-from-github-enterprise-v11-10-34x/ - - /enterprise/admin/articles/upgrading-to-a-newer-release/ - - /enterprise/admin/guides/installation/migrating-to-a-different-platform-or-from-github-enterprise-11-10-34x/ - - /enterprise/admin/guides/installation/migrating-from-github-enterprise-11-10-x-to-2-1-23 - - /enterprise/admin/installation/migrating-from-github-enterprise-1110x-to-2123 -intro: 'Para migrar desde {% data variables.product.prodname_enterprise %} 11.10.x a 2.1.23, deberás configurar una nueva instancia de aparato y migrar los datos de la instancia anterior.' -versions: - enterprise-server: '*' ---- - -Se admiten migraciones desde {% data variables.product.prodname_enterprise %} 11.10.348 y superior. No se admiten migraciones desde {% data variables.product.prodname_enterprise %} 11.10.348 o inferior. Primero debes actualizar a 11.10.348 en varias actualizaciones. Para obtener más información, consulta el procedimiento de actualización 11.10.348, "[Actualizar al lanzamiento más reciente](/enterprise/11.10.340/admin/articles/upgrading-to-the-latest-release/)." - -Para actualizar a la versión más reciente {% data variables.product.prodname_enterprise %}, primero debes migrar a {% data variables.product.prodname_ghe_server %} 2.1, entonces puedes aplicar el proceso normal de actualización. Para obtener más información, consulta "[Actualizar {% data variables.product.prodname_enterprise %}](/enterprise/admin/guides/installation/upgrading-github-enterprise-server/)". - -### Prepárate para la migración - -1. Revisa la guía de Abastecimiento e instalación y controla que se cumplan todos los requisitos previos necesarios para abastecer y configurar {% data variables.product.prodname_enterprise %} 2.1.23 en tu entorno. Para obtener más información, consulta "[Abastecimiento e instalación](/enterprise/2.1/admin/guides/installation/provisioning-and-installation/)." -2. Verifica que la instancia actual esté ejecutando una versión actualizada compatible. -3. Configura la versión más reciente de {% data variables.product.prodname_enterprise_backup_utilities %}. Para obtener más información, consulta [{% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils). - - Si ya has configurado copias de seguridad programadas utilizando {% data variables.product.prodname_enterprise_backup_utilities %}, asegúrate de que hayas actualizado a la versión más reciente. - - Si no estás ejecutando actualmente copias de seguridad programadas, configura {% data variables.product.prodname_enterprise_backup_utilities %}. -4. Toma una instantánea de copia de respaldo completa inicial de la instancia actual utilizando el comando `ghe-backup`. Si ya configuraste copias de seguridad programadas para tu instancia actual, no debes tomar una instantánea de tu instancia. - - {% tip %} - - **Sugerencia:** puedes dejar la instancia en línea y en uso activo durante la instantánea. Tomarás otras instantánea durante la parte de mantenimiento de la migración. Ya que las copias de seguridad son incrementales, esta instantánea inicial reduce la cantidad de datos transferidos en la instantánea final, que pueden acortar la ventana de mantenimiento. - - {% endtip %} - -5. Determina el método para cambiar el tráfico de red de usuario a la nueva instancia. Después de la migración, todo el tráfico de red de HTTP y Git se dirige a la nueva instancia. - - **DNS** - Recomendamos este método para todos los entornos, ya que es simple y funciona bien incluso cuando se migra desde una base de datos a otra. Antes de comenzar la migración, reduce los TTL de los registros DNS existentes a cinco minutos o menos y permite el cambio a propagar. Una vez que la migración se completa, actualiza los registros DNS para que apunten a la dirección IP de la nueva instancia. - - **Asignación de dirección IP** - Este método está únicamente disponible en VMware para la migración VMware y no se recomienda excepto que el método DNS no esté disponible. Antes de comenzar la migración, deberás cerrar la instancia anterior y asignar tu dirección IP a la nueva instancia. -6. Programa una ventana de mantenimiento. La ventana de mantenimiento debe incluir tiempo suficiente para transferir datos desde el servidor de seguridad a la nueva instancia y variará en base al tamaño de la instantánea de respaldo y el ancho de banda de la red disponible. Durante este tiempo tu instancia actual no estará disponible y estará en modo mantenimiento mientras migras a la nueva instancia. - -### Realiza la migración - -1. Aprovisiona una nueva instancia {% data variables.product.prodname_enterprise %} 2.1. Para obtener más información, consulta la "[Guía de aprovisionamiento e instalación](/enterprise/2.1/admin/guides/installation/provisioning-and-installation/)" para tu plataforma destino. -2. Desde un navegador, dirígete a la nueva dirección IP del aparato réplica y carga tu licencia {% data variables.product.prodname_enterprise %}. -3. Configura una contraseña de administrador. -5. Haz clic en **Migrate (Migrar)**. ![Elegir el tipo de instalación](/assets/images/enterprise/migration/migration-choose-install-type.png) -6. Pega tu clave SSH de acceso al servidor de respaldo en "Add new SSH key (Agregar nueva clave SSH)". ![Autorizar la copia de seguridad](/assets/images/enterprise/migration/migration-authorize-backup-host.png) -7. Haz clic en **Add key (Agregar clave)** y luego cliquea **Continue (Continuar)**. -8. Copia el comando `ghe-restore` que ejecutarás en el servidor de respaldo para migrar datos a la nueva instancia. ![Iniciar la migración](/assets/images/enterprise/migration/migration-restore-start.png) -9. Habilita el modo mantenimiento en la instancia anterior y espera a que se completen todos los procesos activos. Para obtener más información, consulta "[Habilitar y programar el modo mantenimiento](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)." - - {% note %} - - **Nota:** la instancia no estará disponible para el uso normal desde este punto en adelante. - - {% endnote %} - -10. En el servidor de respaldo, ejecuta el comando `ghe-backup` para tomar una instantánea de respaldo final. Esto asegura que se capturen todos los datos de la instancia anterior. -11. En el servidor de respaldo, ejecuta el comando `ghe-restore` que copiaste en la pantalla de estado de restauración de la nueva instancia para restaurar la instantánea más reciente. - ```shell - $ ghe-restore 169.254.1.1 - The authenticity of host '169.254.1.1:122' can't be established. - La clave de huella digital RSA es fe:96:9e:ac:d0:22:7c:cf:22:68:f2:c3:c9:81:53:d1. - ¿Estás seguro que deseas continuar conectado (sí/no)? yes - Connect 169.254.1.1:122 OK (v2.0.0) - Starting restore of 169.254.1.1:122 from snapshot 20141014T141425 - Restoring Git repositories ... - Restaurando las páginas GitHub ... - Restaurando los adjuntos de activo ... - Restaurando las entregas de enlace ... - Restaurando la base de datos MySQL ... - Restaurando la base de datos Redis ... - Restaurando las claves autorizadas de SSH ... - Restaurando los índice de ElasticSearch... - Restaurando las claves del servidor SSH ... - Completed restore of 169.254.1.1:122 from snapshot 20141014T141425 - Visit https://169.254.1.1/setup/settings to review appliance configuration. - ``` - -12. Regresa a la pantalla de estado de restauración de la nueva instancia para ver que la restauración está completa. ![Restaurar la pantalla completa](/assets/images/enterprise/migration/restore-complete-screen.png) -13. Haz clic en **Continue to settings (Continuar a configuraciones)** para revisar y ajustar la información de configuración y los parámetros que se importaron de la instancia anterior. ![Revisar los parámetros importados](/assets/images/enterprise/migration/migration-status-complete.png) -14. Haz clic en **Guardar parámetros**. - - {% note %} - - **Nota:** puedes usar la nueva instancia después de haber aplicado los parámetros de configuración y restaurar el servidor. - - {% endnote %} - -15. Cambia el tráfico de red de usuario desde la instancia anterior a la nueva instancia utilizando la asignación de DNS o la dirección IP. -16. Actualiza a la versión más reciente del lanzamiento del patch de {{ currentVersion }}. Para obtener más información, consulta "[Actualizar {% data variables.product.prodname_ghe_server %}](/enterprise/admin/guides/installation/upgrading-github-enterprise-server/)." diff --git a/translations/es-XL/content/admin/installation/migrating-to-a-different-git-large-file-storage-server.md b/translations/es-XL/content/admin/installation/migrating-to-a-different-git-large-file-storage-server.md deleted file mode 100644 index adedd8bdbd1f..000000000000 --- a/translations/es-XL/content/admin/installation/migrating-to-a-different-git-large-file-storage-server.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Migrar a un servidor de Git Large File Storage diferente -intro: 'Puedes migrar a un nuevo servidor {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) al utilizar el cliente {% data variables.large_files.product_name_short %} para extraer activos desde el servidor existente y subirlos a la nueva ubicación.' -redirect_from: - - /enterprise/admin/guides/installation/migrating-to-different-large-file-storage-server/ - - /enterprise/admin/installation/migrating-to-a-different-git-large-file-storage-server -versions: - enterprise-server: '*' ---- - -Antes de migrar a un servidor {% data variables.large_files.product_name_long %} diferente, debes configurar {% data variables.large_files.product_name_short %} para usar un servidor de un tercero. Para obtener más información, consulta "[Configurar {% data variables.large_files.product_name_long %} para usar un servidor de un tercero](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-git-large-file-storage-to-use-a-third-party-server)." - -1. Configura un repositorio con un segundo remoto. - ```shell - $ git remote add NEW-REMOTE https://NEW-REMOTE-HOSTNAME/path/to/repo -   - $ git lfs env - > git-lfs/1.1.0 (GitHub; darwin amd64; go 1.5.1; git 94d356c) - > git version 2.7.4 (Apple Git-66) -   - > Endpoint=https://GITHUB-ENTERPRISE-HOST/path/to/repo/info/lfs (auth=basic) - > Endpoint (NEW-REMOTE)=https://NEW-REMOTE-HOSTNAME/path/to/repo/info/lfs (auth=none) - ``` - -2. Extrae todos los objetos del remoto anterior. - ```shell - $ git lfs fetch origin --all - > Scanning for all objects ever referenced... - > ✔ 16 objects found - > Fetching objects... - > Git LFS: (16 de 16 archivos) 48.71 MB / 48.85 MB - ``` - -3. Extrae todos los objetos a un nuevo remoto. - ```shell - $ git lfs push NEW-REMOTE --all - > Scanning for all objects ever referenced... - > ✔ 16 objects found - > Pushing objects... - > Git LFS: (16 de 16 archivos) 48.00 MB / 48.85 MB, 879.10 KB pasados por alto - ``` diff --git a/translations/es-XL/content/admin/installation/migrating-to-internal-repositories.md b/translations/es-XL/content/admin/installation/migrating-to-internal-repositories.md deleted file mode 100644 index 895797417fdd..000000000000 --- a/translations/es-XL/content/admin/installation/migrating-to-internal-repositories.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: Migrar hacia repositorios internos -intro: 'Puedes migrar hacia repositorios internos para unificar la experiencia de innersource para los desarolladores que utilicen tanto {% data variables.product.prodname_ghe_server %} como {% data variables.product.prodname_ghe_cloud %}.' -permissions: Los administradores de sitio pueden migrar hacia repositorios internos. -redirect_from: - - /enterprise/admin/installation/migrating-to-internal-repositories -versions: - enterprise-server: '>=2.20' ---- - -### Acerca de los repositorios internos - -Los repositorios internos están disponibles desde {% data variables.product.prodname_ghe_server %} 2.20+. {% data reusables.repositories.about-internal-repos %} para obtener más información, consulta "[Acerca de la visibilidad en los repositorios](/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)." - -En lanzamientos futuros de {% data variables.product.prodname_ghe_server %}, ajustaremos la manera en la que funciona la visibilidad de los repositorios para que los conceptos público, interno y privado tengan un significado uniforme para los desarrolladores de {% data variables.product.prodname_ghe_server %} y {% data variables.product.prodname_ghe_cloud %}. - -Para prepararse para estos cambios, si has habilitado el modo privado, puedes ejecutar una migración en tu instancia para convertir los repositorios públicos en internos. Esta migración es opcional actualmente. Esto sirve para permitirte probar los cambios en una instancia no productiva. La migración será obligatoria en el futuro. - -Cuando ejecutas la migración, todos los repositorios públicos propiedad de las organizaciones en tu instancia se convertirán en repositorios internos. En caso de que cualquiera de estos repositorios tenga ramificaciones, estas se convertirán en privadas. Los repositorios privados permanecerán como privados. - -Todos los repositorios públicos propiedad de cuentas de usuario en tu instancia se convertirán en repositorios privados. Si cualquiera de estos repositorios tienen ramificaciones, éstas también se convertirán en privadas. A cada dueño de una ramificación se le otorgarán permisos de lectura para el directorio padre de la misma. - -Se inhabilitará el acceso de lectura anónimo para Git en cada repositorio público que se convierta en interno o privado. - -Si tu visibilidad predeterminada actual para los repositorios es pública, ahora se convertirá en interna. Si la predeterminada es privada, entonces no cambiará. Puedes cambiar esta configuración predeterminada en cualquier momento. Para encontrar más información, visita "[Configurar la visibilidad predeterminada de repositorios nuevos en tu aplicativo](/enterprise/admin/installation/configuring-the-default-visibility-of-new-repositories-on-your-appliance)." - -La política de creación de repositorios para la instancia cambiará para inhabilitar los repositorios públicos y permitir los privados e internos. Puedes actualizar la política en cualquier momento. Para obtener más información, consulta "[Restringir la creación de repositorios en tu instancia](/enterprise/admin/user-management/restricting-repository-creation-in-your-instance)." - -El script de migración no tendrá efecto si no tienes el modo privado habilitado. - -### Ejecutar la migración - -1. Conecta con el shell administrativo. Para obtener más información, consulta "[Acceder al shell administrativo (SSH)](/enterprise/admin/installation/accessing-the-administrative-shell-ssh)." -2. Navega hacia el directorio `/data/github/current`. - ``` - cd /data/github/current - ``` -3. Ejecuta el comando de migración. - ``` - sudo bin/safe-ruby lib/github/transitions/20191210220630_convert_public_ghes_repos_to_internal.rb -v -w | tee -a /tmp/convert_public_ghes_repos_to_internal.log - ``` - -Se mostrará el registro de salida en la terminal y quedará en `/tmp/convert_public_ghes_repos_to_internal.log`. - -### Leer más - -- "[Habilitar el modo privado](/enterprise/admin/installation/enabling-private-mode)" diff --git a/translations/es-XL/content/admin/installation/monitoring-activity-on-your-github-enterprise-server-instance.md b/translations/es-XL/content/admin/installation/monitoring-activity-on-your-github-enterprise-server-instance.md deleted file mode 100644 index 9b8690af9c2b..000000000000 --- a/translations/es-XL/content/admin/installation/monitoring-activity-on-your-github-enterprise-server-instance.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Supervisar la actividad en tu instancia del servidor de GitHub Enterprise -mapTopic: true -redirect_from: - - /enterprise/admin/installation/monitoring-activity-on-your-github-enterprise-server-instance -versions: - enterprise-server: '*' ---- - diff --git a/translations/es-XL/content/admin/installation/monitoring-using-snmp.md b/translations/es-XL/content/admin/installation/monitoring-using-snmp.md deleted file mode 100644 index 8419e4404463..000000000000 --- a/translations/es-XL/content/admin/installation/monitoring-using-snmp.md +++ /dev/null @@ -1,107 +0,0 @@ ---- -title: Supervisar por medio de SNMP -intro: '{% data variables.product.prodname_enterprise %} proporciona datos sobre el uso del disco, la utilización del CPU, el uso de la memoria y más sobre SNMP.' -redirect_from: - - /enterprise/admin/articles/monitoring-using-snmp/ - - /enterprise/admin/installation/monitoring-using-snmp -versions: - enterprise-server: '*' ---- - -SNMP es una norma común para controlar dispositivos en una red. Recomendamos firmemente habilitar SNMP para que puedas controlar la salud de {% data variables.product.product_location_enterprise %} y saber cuándo agregar más memoria, almacenamiento, o rendimiento del procesador a la máquina del servidor. - -{% data variables.product.prodname_enterprise %} tiene una instalación SNMP estándar, para poder aprovechar los [diversos plugins](http://www.monitoring-plugins.org/doc/man/check_snmp.html) disponibles para Nagios o para cualquier otro sistema de control. - -### Configurar SNMP v2c - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.access-monitoring %} -{% data reusables.enterprise_management_console.enable-snmp %} -4. En el campo **Community string (Cadena de la comunidad)**, ingresa una nueva cadena de comunidad. Si se deja en blanco, queda predeterminado como `públicp`. ![Campo para añadir la cadena de comunidad](/assets/images/enterprise/management-console/community-string.png) -{% data reusables.enterprise_management_console.save-settings %} -5. Prueba tu configuración SNMP al ejecutar el siguiente comando en una estación de trabajo por separado con soporte de SNMP en tu red: - ```shell - # community-string is your community string - # hostname is the IP or domain of your Enterprise instance - $ snmpget -v 2c -c community-string -O e hostname hrSystemDate.0 - ``` - -Debería devolver la hora del sistema en el host {% data variables.product.product_location_enterprise %}. - -### Seguridad basada en el usuario - -Si habilitas el SNMP v3, puedes aprovechar la seguridad en base al usuario aumentada a través de User Security Model (USM). Para cada usuario único, puedes especificar un nivel de seguridad: -- `noAuthNoPriv`: este nivel de seguridad no brinda autenticación ni privacidad. -- `authNoPriv`: este nivel de seguridad brinda autenticación pero no privacidad. Para consultar al aparato deberás usar un nombre de usuario y una contraseña (que debe tener como mínimo ocho caracteres). La información se envía sin encriptación, similar a SNMPv2. El protocolo de autenticación puede ser MD5 o SHA o SHA como predeterminado. -- `authPriv`: este nivel de seguridad brinda autenticación con privacidad. Se requiere autenticación, incluida una contraseña de autenticación de ocho caracteres como mínimo, y las respuestas están encriptadas. No se requiere una contraseña de privacidad, pero si se proporciona debe tener como mínimo ocho caracteres. Si no se proporciona una contraseña de privacidad, se usa la contraseña de autenticación. El protocolo de privacidad puede ser DES o AES y queda AES como predeterminado. - -### Configurando usuarios para SNMP v3 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.access-monitoring %} -{% data reusables.enterprise_management_console.enable-snmp %} -4. Selecciona **SNMP v3**. ![Botón para habilitar SNMP v3](/assets/images/enterprise/management-console/enable-snmpv3.png) -5. En "Username (Nombre de usuario)", escribe el nombre de usuario único de tu usuario SNMP v3.![Campo para escribir el nombre de usuario SNMP v3](/assets/images/enterprise/management-console/snmpv3-username.png) -6. En el menú desplegable **Security Level (Nivel de seguridad)**, haz clic en el nivel de seguridad para tu usuario SNMP v3. ![Menú desplegable para el nivel de seguridad del usuario SNMP v3](/assets/images/enterprise/management-console/snmpv3-securitylevel.png) -7. Para usuarios SNMP v3 con el nivel de seguridad `authnopriv`: ![Configuración para el nivel de seguridad authnopriv](/assets/images/enterprise/management-console/snmpv3-authnopriv.png) - - {% data reusables.enterprise_management_console.authentication-password %} - - {% data reusables.enterprise_management_console.authentication-protocol %} -8. Para usuarios SNMP v3 con el nivel de seguridad `authpriv`: ![Configuración para el nivel de seguridad authpriv](/assets/images/enterprise/management-console/snmpv3-authpriv.png) - - {% data reusables.enterprise_management_console.authentication-password %} - - {% data reusables.enterprise_management_console.authentication-protocol %} - - De forma opcional, en "Privacy password" (Contraseña de privacidad), escribe la contraseña de privacidad. - - Hacia la derecha de "Privacy password" (Contraseña de privacidad), en el menú desplegable **Protocol (Protocolo)**, haz clic en el método de protocolo de privacidad que deseas usar. -9. Haz clic en **Add secret (Agregar secreto)**. ![Botón para añadir usuario SNMP v3](/assets/images/enterprise/management-console/snmpv3-adduser.png) -{% data reusables.enterprise_management_console.save-settings %} - -##### Consultar datos de SNMP - -Tanto la información del nivel de software como de hardware sobre tu aparato está disponible con SNMP v3. Debido a la falta de encriptación y privacidad para los niveles de seguridad `noAuthNoPriv` y `authNoPriv`, excluimos la tabla `hrSWRun` (1.1.3.6.1.2.1.25.41) de los informes SNMP resultantes. Incluimos esta tabla si estás usando el nivel de seguridad `authPriv`. - -Con SNMP v2c, solo está disponible la información del nivel de hardware de tu aparato. Estas aplicaciones y servicios dentro de {% data variables.product.prodname_enterprise %} no tienen configurado OID para informar métricas. Hay varios MIB disponibles, que puedes ver ejecutando `snmpwalk` en una estación de trabajo separada con soporte SNMP en tu red: - -```shell -# community-string es tu cadena de comunidad -# hostname es la IP o dominio de tu instancia de empresa -$ snmpwalk -v 2c -c community-string -O e hostname -``` - -De los MIB disponibles para SNMP, el más útil es `HOST-RESOURCES-MIB` (.1.3.6.1.2.1.25). Consulta la tabla de abajo para ver algunos objetos importantes en este MIB: - -| Nombre | OID | Descripción | -| -------------------------- | ------------------------- | ----------------------------------------------------------------------------------------------- | -| hrSystemDate.2 | .1.3.6.1.2.1.25.1.2 | La noción de servidores de los datos locales y de la hora del día. | -| hrSystemUptime.0 | .1.3.6.1.2.1.25.1.1.0 | Cuánto tiempo ha pasado desde que el servidor se inició por última vez. | -| hrMemorySize.0 | .1.3.6.1.2.1.25.2.2.0 | La cantidad de RAM en el servidor. | -| hrSystemProcesses.0 | .1.3.6.1.2.1.25.1.6.0 | La cantidad de contextos de proceso actualmente cargados o ejecutándose en el servidor. | -| hrStorageUsed.1 | .1.3.6.1.2.1.25.2.3.1.6.1 | La cantidad de espacio de almacenamiento consumido en el servidor, en hrStorageAllocationUnits. | -| hrStorageAllocationUnits.1 | .1.3.6.1.2.1.25.2.3.1.4.1 | El tamaño, en bytes, de una hrStorageAllocationUnit | - -Por ejemplo, para consultar `hrMemorySize` con SNMP v3, ejecuta el siguiente comando en una estación de trabajo separada con apoyo de SNMP en tu red: -```shell -# username es el nombre de usuario único de tu usuario SNMP v3 -# auth password es la contraseña de autenticación -# privacy password es la contraseña de privacidad -# hostname es la IP o el dominio de tu instancia de empresa -$ snmpget -v 3 -u username -l authPriv \ - -A "auth password" -a SHA \ - -X "privacy password" -x AES \ - -O e hostname HOST-RESOURCES-MIB::hrMemorySize.0 -``` - -Con SNMP v2c, para consultar `hrMemorySize`, ejecuta el siguiente comando en una estación de trabajo separada con apoyo de SNMP en tu red: -```shell -# community-string es tu cadena de comunidad -# hostname es la IP o el dominio de tu instancia de empresa -snmpget -v 2c -c community-string hostname HOST-RESOURCES-MIB::hrMemorySize.0 -``` - -{% tip %} - -**Nota:** para evitar que se filtre información sobre los servicios que se están ejecutando en tu aparato, excluimos la tabla `hrSWRun` (1.1.3.6.1.2.1.25.41) de los informes SNMP resultantes excepto que estés usando el nivel de seguridad `authPriv` con SNMP v3. Si estás utilizando el nivel de seguridad `authPriv`, incluimos la tabla `hrSWRun`. - -{% endtip %} - -Para obtener más información sobre los mapeos OID para los atributos de sistema comunes en SNMP, consulta "[OID SNMP de Linux para CPU, memoria y estadísticas de disco](http://www.linux-admins.net/2012/02/linux-snmp-oids-for-cpumemory-and-disk.html)". diff --git a/translations/es-XL/content/admin/installation/monitoring-your-github-enterprise-server-appliance.md b/translations/es-XL/content/admin/installation/monitoring-your-github-enterprise-server-appliance.md deleted file mode 100644 index ad4bb5fa955e..000000000000 --- a/translations/es-XL/content/admin/installation/monitoring-your-github-enterprise-server-appliance.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: Revisar tu aparato del servidor de GitHub Enterprise -intro: 'Debido a que el uso {% data variables.product.product_location_enterprise %} aumenta con el tiempo, se incrementará la utilización de recursos del sistema, como el CPU, la memoria, y el almacenamiento. Puedes configurar una revisión y alertas para que estar al tanto de problemas potenciales antes de que se vuelvan lo suficientemente críticos para impactar de forma negativa en el desempeño de la aplicación o su disponibilidad.' -redirect_from: - - /enterprise/admin/guides/installation/system-resource-monitoring-and-alerting/ - - /enterprise/admin/guides/installation/monitoring-your-github-enterprise-appliance/ - - /enterprise/admin/installation/monitoring-your-github-enterprise-server-appliance -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/es-XL/content/admin/installation/network-ports.md b/translations/es-XL/content/admin/installation/network-ports.md deleted file mode 100644 index 3590a977ebb4..000000000000 --- a/translations/es-XL/content/admin/installation/network-ports.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: Puertos de red -redirect_from: - - /enterprise/admin/articles/configuring-firewalls/ - - /enterprise/admin/articles/firewall/ - - /enterprise/admin/guides/installation/network-configuration/ - - /enterprise/admin/guides/installation/network-ports-to-open/ - - /enterprise/admin/installation/network-ports -intro: 'Abre los puertos de red de forma selectiva en base a los servicios de red que necesitas exponer a los administradores, usuarios finales y apoyo de correo electrónico.' -versions: - enterprise-server: '*' ---- - -### Puertos administrativos - -Se requieren algunos puertos administrativos para configurar {% data variables.product.product_location_enterprise %} y ejecutar determinadas funciones. No se requieren puertos administrativos para el uso de la aplicación básica por parte de los usuarios finales. - -| Puerto | Servicio | Descripción | -| -------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| 8443 | HTTPS | {% data variables.enterprise.management_console %} segura basada en la web. Requerida para la instalación y la configuración básicas. | -| 8080 | HTTP | {% data variables.enterprise.management_console %} basada en la web de texto simple. No se requiere excepto que el SSL esté inhabilitado de forma manual. | -| 122 | SSH | Acceso shell para {% data variables.product.product_location_enterprise %}. Se requiere para abrir las conexiones entrantes de todos los otros nodos en la configuración de alta disponibilidad. El puerto SSH predeterminado (22) está destinado al tráfico de red de la aplicación SSH y Git. | -| 1194/UDP | VPN | Túnel de red de replicación segura en la configuración de alta disponibilidad. Se requiere que esté abierto para todos los otros nodos en la configuración. | -| 123/UDP | NTP | Se requiere para operar el protocolo de tiempo. | -| 161/UDP | SNMP | Se requiere para operar el protocolo de revisión de red. | - -### Puertos de la aplicación para usuarios finales - -Los puertos de la aplicación permiten que los usuarios finales accedan a Git y a la aplicación web. - -| Puerto | Servicio | Descripción | -| ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------- | -| 443 | HTTPS | Acceso a la aplicación web y a Git por HTTPS. | -| 80 | HTTP | Acceso a la aplicación web. Todas las solicitudes se redireccionan al puerto HTTPS cuando se habilita SSL. | -| 22 | SSH | Acceso a Git por SSH. Admite las operaciones clonar, extraer y subir a los repositorios privados y públicos. | -| 9418 | Git | El puerto de protocolo Git admite las operaciones clonar y extraer a los repositorios públicos con comunicación de red desencriptada. | - -{% data reusables.enterprise_installation.terminating-tls %} - -### Puertos de correo electrónico - -Los puertos de correo electrónico deben ser accesibles directamente o por medio de la retransmisión del correo electrónico entrante para los usuarios finales. - -| Puerto | Servicio | Descripción | -| ------ | -------- | ---------------------------------------------- | -| 25 | SMTP | Soporte para SMTP con encriptación (STARTTLS). | diff --git a/translations/es-XL/content/admin/installation/recommended-alert-thresholds.md b/translations/es-XL/content/admin/installation/recommended-alert-thresholds.md deleted file mode 100644 index f53b90cef2c4..000000000000 --- a/translations/es-XL/content/admin/installation/recommended-alert-thresholds.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: Límites de alerta recomendados -intro: 'Puedes configurar una alerta para notificar los problemas de tus recursos de sistema antes de que afecten el desempeño de tu aparato {% data variables.product.prodname_ghe_server %}.' -redirect_from: - - /enterprise/admin/guides/installation/about-recommended-alert-thresholds/ - - /enterprise/admin/installation/recommended-alert-thresholds -versions: - enterprise-server: '*' ---- - -### Controlar el almacenamiento - -Recomendamos que controles los dispositivos de almacenamiento de usuario y raíz y configures una alerta con valores que permitan un gran tiempo de respuesta cuando el espacio de disco disponible sea bajo. - -| Gravedad | Límite | -| --------------- | ---------------------------------------------------- | -| **Advertencia** | El disco excede el 70 % del total disponible | -| **Crítico** | El uso del disco excede el 85 % del total disponible | - -Puedes ajustar estos valores en base a la cantidad total de almacenamiento asignado, los patrones de crecimiento histórico y el tiempo esperado de respuesta. Recomendamos asignar en exceso recursos de almacenamiento para permitir el crecimiento y evitar el tiempo de inactividad requerido para asignar almacenamiento adicional. - -### Controlar el uso del CPU y de la carga promedio - -A pesar de que es normal que el uso de CPU fluctúe en base a las operaciones Git que utilizan muchos recursos, recomendamos configurar una alerta para la utilización del CPU anormalmente alta, ya que spikes prolongados puede significar que tu instancia tiene un aprovisionamiento insuficiente. Recomendamos controlar la carga promedio del sistema de quince minutos para los valores que se acerquen o excedan la cantidad de núcleos de CPU asignados en la máquina virtual. - -| Gravedad | Límite | -| --------------- | --------------------------------------------------------------- | -| **Advertencia** | La carga promedio de quince minutos excede 1x de núcleos de CPU | -| **Crítico** | La carga promedio de quince minutos excede 2x de núcleos de CPU | - -También recomendamos que controles el tiempo de "robo" de virtualización para asegurar que otras máquinas virtuales ejecutándose en el mismo sistema de servidor no estén usando todos los recursos de la instancia. - -### Controla el uso de la memoria - -La cantidad de memoria física asignada a {% data variables.product.product_location_enterprise %} puede tener un gran impacto sobre el desempeño general y la capacidad de respuesta de la aplicación. El sistema está designado para realizar un uso intenso del caché del disco kernel para acelerar las operaciones Git. Recomendamos que el conjunto en funcionamiento de RSS normal se acomode dentro del 50 % del total de RAM disponible para un uso máximo. - -| Gravedad | Límite | -| --------------- | ---------------------------------------------------------------------- | -| **Advertencia** | El uso sostenido de RSS excede el 50 % del total de memoria disponible | -| **Crítico** | El uso sostenido de RSS excede el 70 % del total de memoria disponible | - -Si se acaba la memoria, el killer de OOM kernel intentará liberar recursos de memoria al sacrificar de manera forzosa procesos de aplicación con mucho uso de RAM, lo que puede dar como resultado una interrupción del servicio. Recomendamos asignar más memoria a la máquina virtual de la requerida en el curso normal de las operaciones. diff --git a/translations/es-XL/content/admin/installation/recovering-a-high-availability-configuration.md b/translations/es-XL/content/admin/installation/recovering-a-high-availability-configuration.md deleted file mode 100644 index dedc4e511f11..000000000000 --- a/translations/es-XL/content/admin/installation/recovering-a-high-availability-configuration.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Recuperar una configuración de disponibilidad alta -intro: 'Después de la conmutación por error de un aparato {% data variables.product.prodname_ghe_server %}, debes recuperar redundancia tan pronto como sea posible en lugar de depender de un aparato único.' -redirect_from: - - /enterprise/admin/installation/recovering-a-high-availability-configuration -versions: - enterprise-server: '*' ---- - -Puedes utilizar el aparato principal antiguo como el nuevo aparato de réplica si la conmutación por error fue planeada o no estaba relacionada con la salud del aparato. Si la conmutación por error estaba relacionado con un problema con el aparato primario, es posible que prefieras crear un nuevo aparato de réplica. Para obtener más información, consulta "[Crear una réplica de alta disponibilidad](/enterprise/{{ currentVersion }}/admin/guides/installation/creating-a-high-availability-replica/)." - -### Configurar un aparato principal antiguo como una nueva réplica - -1. Conéctate a la dirección IP del aparato principal antiguo utilizando SSH. - ```shell - $ ssh -p 122 admin@FORMER PRIMARY IP - ``` -2. En el aparato principal antiguo, ejecuta el comando `ghe-repl-setup` con la dirección IP de la réplica antigua. - ```shell - $ ghe-repl-setup FORMER REPLICA IP - ``` -{% data reusables.enterprise_installation.add-ssh-key-to-primary %} -4. Para verificar la conexión con el aparato principal nuevo y habilitar el modo réplica para la nueva réplica, ejecuta nuevamente `ghe-repl-setup`. - ```shell - $ ghe-repl-setup FORMER REPLICA IP - ``` -{% data reusables.enterprise_installation.replication-command %} diff --git a/translations/es-XL/content/admin/installation/removing-a-high-availability-replica.md b/translations/es-XL/content/admin/installation/removing-a-high-availability-replica.md deleted file mode 100644 index c26a9881c8dc..000000000000 --- a/translations/es-XL/content/admin/installation/removing-a-high-availability-replica.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: Quitar una réplica de disponibilidad alta -intro: 'Puedes detener una replicación a una réplica {% data variables.product.prodname_ghe_server %} de forma temporal, o quitar la replicación de forma permanente.' -redirect_from: - - /enterprise/admin/installation/removing-a-high-availability-replica -versions: - enterprise-server: '*' ---- - -### Detener una replicación de forma temporal - -1. Si es necesario, puedes detener una replicación geográfica del tráfico de usuario activo al quitar las entradas Geo DNS para la réplica. -2. En la réplica donde deseas detener la replicación de forma temporal, ejecuta ghe-repl-stop. - ```shell - $ ghe-repl-stop - ``` -3. Para comenzar la replicación nuevamente, ejecuta `ghe-repl-start`. - ```shell - $ ghe-repl-start - ``` - -### Quitar la replicación de forma permanente - -1. Si es necesario, puedes detener una replicación geográfica del tráfico de usuario activo al quitar las entradas Geo DNS para la réplica. -2. En la réplica donde deseas quitar la replicación, ejecuta `ghe-repl-stop`. - ```shell - $ ghe-repl-stop - ``` -3. En la réplica, para acabar con el estado de replicación, ejecuta `ghe-repl-teardown`. - ```shell - $ ghe-repl-teardown - ``` diff --git a/translations/es-XL/content/admin/installation/searching-the-audit-log.md b/translations/es-XL/content/admin/installation/searching-the-audit-log.md deleted file mode 100644 index 2009f592493b..000000000000 --- a/translations/es-XL/content/admin/installation/searching-the-audit-log.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: Buscar el registro de auditoría -intro: 'Los administradores del sitio pueden buscar una amplia lista de [acciones auditadas](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions) en {% data variables.product.product_location_enterprise %}.' -redirect_from: - - /enterprise/admin/articles/searching-the-audit-log/ - - /enterprise/admin/installation/searching-the-audit-log -versions: - enterprise-server: '*' ---- - -### Buscar sintaxis de consultas - -Redacta una consulta de búsqueda de uno o más pares de clave-valor separados por operadores lógicos y/o. - -| Clave | Valor | -| --------------:| -------------------------------------------------------------------------------------------------------- | -| `actor_id` | ID de la cuenta de usuario que inició la acción | -| `actor` | Nombre de la cuenta de usuario que inició la acción | -| `oauth_app_id` | ID de la aplicación OAuth asociada con la acción | -| `action` | Nombre de la [acción auditada](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions) | -| `user_id` | ID del usuario afectado por la acción | -| `usuario` | Nombre del usuario afectado por la acción | -| `repo_id` | ID del repositorio afectado por la acción (si corresponde) | -| `repo` | Nombre del repositorio afectado por la acción (si corresponde) | -| `actor_ip` | Dirección IP desde donde se inició la acción | -| `created_at` | Momento en el cual ocurrió la acción | -| `from` | Vista desde donde se inició la acción | -| `note` | Información variada de evento específico (en texto simple o en formato JSON) | -| `org` | Nombre de la organización afectada por la acción (si corresponde) | -| `org_id` | ID de la organización afectada por la acción (si corresponde) | - -Por ejemplo, para ver todas las acciones que afectaron el repositorio `octocat/Spoon-Knife` desde el inicio de 2017: - - `repo:"octocat/Spoon-Knife" AND created_at:[2017-01-01 TO *]` - -Para ver una lista completa de acciones, consulta "[Acciones auditadas](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions)." - -### Buscar el registro de auditoría - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.audit-log-tab %} -4. Escribe una consulta de búsqueda. ![Consulta de búsqueda](/assets/images/enterprise/site-admin-settings/search-query.png) diff --git a/translations/es-XL/content/admin/installation/setting-git-push-limits.md b/translations/es-XL/content/admin/installation/setting-git-push-limits.md deleted file mode 100644 index b0aa7a7f59d1..000000000000 --- a/translations/es-XL/content/admin/installation/setting-git-push-limits.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: Configurar límites Git push -intro: Puedes imponer el tamaño máximo de objetos de Git en un repositorio. -redirect_from: - - /enterprise/admin/guides/installation/git-server-settings/ - - /enterprise/admin/articles/setting-git-push-limits/ - - /enterprise/admin/installation/setting-git-push-limits -versions: - enterprise-server: '*' ---- - -Puedes configurar un límite de tamaño para los archivos en los repositorios de tu instancia para mantener un tamaño fácil de administrar en los mismos y prevenir los problemas de rendimiento. - -Cuando impones límites de carga a los repositorios, la configuración predeterminada no permite a los usuarios añadir o actualizar archivos mayores a 100 MB. - -{% if currentVersion ver_lt "enterprise-server@2.20" %} -{% tip %} - -**Nota:** únicamente los archivos mayores a {% data variables.large_files.warning_size %} se revisarán frente al límite de subida de Git. Si debes establecer un límite de subida menor, contacta a {% data variables.contact.contact_ent_support %} para obtener ayuda. - -{% endtip %} -{% endif %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -4. Dentro de "Repository upload limit (Límite de subida del repositorio)", utiliza el menú desplegable y haz clic en un tamaño máximo de objeto. ![Menú desplegable con opciones de tamaño máximo de objeto](/assets/images/enterprise/site-admin-settings/repo-upload-limit-dropdown.png) -5. Opcionalmente, para imponer un límite máximo de carga en todos los repositorios de {% data variables.product.product_location_enterprise %}, selecciona **Imponer en todos los repositorios** ![Opción para imponer tamaño máximo de objetos en todos los repositorios](/assets/images/enterprise/site-admin-settings/all-repo-upload-limit-option.png) diff --git a/translations/es-XL/content/admin/installation/setting-up-external-monitoring.md b/translations/es-XL/content/admin/installation/setting-up-external-monitoring.md deleted file mode 100644 index 028d129305fa..000000000000 --- a/translations/es-XL/content/admin/installation/setting-up-external-monitoring.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: Configurar la revisión externa -intro: 'Puedes revisar los recursos de sistema básicos en tu aparato {% data variables.product.prodname_ghe_server %} utilizando el SNMP o los protocolos de recopilación de estadísticas collectd.' -redirect_from: - - /enterprise/admin/installation/setting-up-external-monitoring -versions: - enterprise-server: '*' ---- - -### Acerca de SNMP - -El Protocolo de Administración de Red Simple (SNMP) es un método muy compatible para revisar los dispositivos y los servidores de red. El SNMP está inhabilitado por defecto pero puede ser configurado a través del tablero de revisión {% data variables.product.prodname_enterprise %}. El puerto UDP 161 debe abrirse y ser accesible desde tu estación de administración de red. Para obtener más información, consulta "[Revisión utilizando el SNMP](/enterprise/{{ currentVersion }}/admin/guides/installation/monitoring-using-snmp/)." - -### Acerca de collectd - -collectd es una recopilación de estadísticas de código abierto y daemon de información con apoyo integrado para escribir en archivos RRD. Las estadísticas sobre utilización de CPU, memoria y uso de disco, errores y tráfico de interfaz de red y carga de sistema pueden redireccionarse a un servidor externo collectd donde se pueden configurar los gráficos, los análisis y las alertas utilizando un amplia gama de herramientas y plugins disponibles. Para configurar el redireccionamiento de `collectd`, consulta "[Configurar collectd](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-collectd/)". - -Además, las herramientas de supervisión dentro de las plataformas de virtualización subyacentes pueden también usarse para supervisar y alertar sobre los recursos de sistema. Para obtener más información, consulta la documentación [Amazon CloudWatch](http://aws.amazon.com/cloudwatch/) y [Supervisión de VMware vSphere ](http://pubs.vmware.com/vsphere-50/topic/com.vmware.ICbase/PDF/vsphere-esxi-vcenter-server-50-monitoring-performance-guide.pdf). diff --git a/translations/es-XL/content/admin/installation/site-admin-dashboard.md b/translations/es-XL/content/admin/installation/site-admin-dashboard.md deleted file mode 100644 index 8b9d307786b4..000000000000 --- a/translations/es-XL/content/admin/installation/site-admin-dashboard.md +++ /dev/null @@ -1,178 +0,0 @@ ---- -title: Tablero de administración del sitio -intro: 'El tablero de administración del sitio brinda una cantidad de herramientas para ayudarte a administrar {% data variables.product.product_location_enterprise %}.' -redirect_from: - - /enterprise/admin/articles/site-admin-dashboard/ - - /enterprise/admin/installation/site-admin-dashboard -versions: - enterprise-server: '*' ---- - -Para acceder al tablero, en la esquina superior derecha de cualquier página, haz clic en {% octicon "rocket" aria-label="The rocket ship" %}. ![Ícono de cohete para acceder a las configuraciones de administrador del sitio](/assets/images/enterprise/site-admin-settings/access-new-settings.png) - -### Información de la licencia & buscar - -Consulta esta sección del tablero de administración del sitio para controlar tu licencia {% data variables.product.prodname_enterprise %} actual, para buscar usuarios y repositorios y para consultar el [registro de auditoría](#audit-log). - -### {% data variables.enterprise.management_console %} - -Aquí puedes iniciar la {% data variables.enterprise.management_console %} para administrar las configuraciones del aparato virtual como el dominio, la autenticación y SSL. - -### Explorar - - Los datos para la [página de tendencia](https://github.com/blog/1585-explore-what-is-trending-on-github) de GitHub se calculan en lapsos de tiempo diarios, semanales y mensuales para ambos repositorios y programadores. Puedes ver cuándo estos datos fueron almacenados en caché por última vez y poner en cola las tareas nuevas de cálculo de tendencia desde la sección **Explore (Explorar)**. - -### Registro de auditoría - -{% data variables.product.prodname_enterprise %} mantiene un registro continuo de las acciones auditadas que puedes consultar. - -Por defecto, el registro de auditoría te muestra una lista de todas las acciones auditadas en orden cronológico reverso. Puedes filtrar esta lista al ingresar pares de valores clave en el casillero de texto de **Query (Consulta)** y después hacer clic en **Search (Buscar)**, como se explicó en "[Buscar el registro de auditoría](/enterprise/{{ currentVersion }}/admin/guides/installation/searching-the-audit-log)." - -Para obtener más información sobre el registro de auditoría en general, consulta "[Registros de auditoría](/enterprise/{{ currentVersion }}/admin/guides/installation/audit-logging)." Para obtener una lista completa de acciones auditadas, consulta "[Acciones auditadas](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions)." - -### Informes - -Si necesitas obtener información sobre los usuarios, organizaciones y repositorios en {% data variables.product.product_location_enterprise %}, comúnmente extraerías datos JSON a través de la [API de GitHub](http://developer.github.com/v3/). Lamentablemente, es posible que la API no proporcione todos los datos que deseas y se requiera algo de conocimiento técnico para usarla. Este tablero de administración del sitio ofrece una sección de **Reports (Informes)** como una alternativa, haciendo que sea fácil descargar informes CSV con la mayoría de la información que probablemente necesites para los usuarios, las organizaciones y los repositorios. - -Específicamente, puedes descargar informes CSV que enumeren a - -- todos los usuarios -- todos los usuarios que han estado activos dentro del último mes -- todos los usuarios que han estado inactivos durante un mes o más -- todos los usuarios que han sido suspendidos -- todas las organizaciones -- todos los repositorios - -También puedes acceder a estos informes mediante programación a través de una autenticación estándar de HTTP con una cuenta de administrador del sitio. Debes utilizar un token de acceso personal con alcance de `site_admin`. Para obtener más información, consulta la sección "[Crear un token de acceso personal](/github/authenticating-to-github/creating-a-personal-access-token)". - -Por ejemplo, así es como descargarías el informe "todos los usuarios" utilizando cURL: - -```shell -curl -L -u username:token http(s)://hostname/stafftools/reports/all_users.csv -``` - -Para acceder a otros informes mediante programación, reemplaza `all_users` con `active_users`, `dormant_users`, `suspended_users`, `all_organizations`, o `all_repositories`. - -{% note %} - -**Nota:** La solicitud `curl` inicial devolverá una respuesta 202 HTTP si no hay informes en caché disponibles; se generará un informe en segundo plano. Puedes enviar una segunda solicitud para descargar el informe. Puedes utilizar una contraseña o un token de OAuth con el alcance `site_admin` en lugar de la contraseña. - -{% endnote %} - -#### Informes del usuario - -| Clave | Descripción | -| --------------------------:| --------------------------------------------------------------------------------- | -| `created_at` | Cuándo fue creada la cuenta de usuario (como una marca de tiempo ISO 8601) | -| `id` | ID de la cuenta para el usuario o la organización | -| `login (inicio de sesión)` | Nombre de inicio de sesión de la cuenta | -| `correo electrónico` | Dirección principal de correo electrónico de la cuenta | -| `rol` | Si la cuenta es de un usuario administrador o de un usuario común | -| `suspended?` | Si la cuenta ha sido suspendida | -| `last_logged_ip` | La dirección IP más reciente que se registró en la cuenta | -| `repos` | Cantidad de repositorios que posee la cuenta | -| `ssh_keys` | Cantidad de claves SSH registradas en la cuenta | -| `org_memberships` | Cantidad de organizaciones a las que pertenece la cuenta | -| `dormant?` | Si la cuenta está inactiva | -| `last_active` | Cuándo la cuenta estuvo activa por última vez (como una marca de tiempo ISO 8601) | -| `raw_login` | Información de inicio de sesión sin procesar (en formato JSON) | -| `2fa_enabled?` | Si el usuario ha habilitado autenticación de dos factores | - -#### Informes de la organización - -| Clave | Descripción | -| ------------------------:| ------------------------------------------------------------ | -| `id` | ID de la organización | -| `created_at (creado en)` | Cuándo se creó la organización | -| `login` | Nombre de inicio de sesión de la organización | -| `correo electrónico` | Dirección principal de correo electrónico de la organización | -| `owners` | Cantidad de propietarios de la organización | -| `members` | Cantidad de miembros de la organización | -| `teams` | Cantidad de equipos de la organización | -| `repos` | Cantidad de repositorios de la organización | -| `2fa_required?` | Si la organización requiere autenticación de dos factores | - -#### Informes del repositorio - -| Clave | Descripción | -| ------------------------:| ------------------------------------------------------------------ | -| `created_at (creado en)` | Cuándo fue creado el repositorio | -| `owner_id` | ID del propietario del repositorio | -| `owner_type` | Si el repositorio es propiedad de un usuario o de una organización | -| `owner_name` | Nombre del propietario del repositorio | -| `id` | ID del repositorio | -| `name` | Nombre del repositorio | -| `visibilidad` | Si el repositorio es público o privado | -| `readable_size` | El tamaño del repositorio en un formato legible | -| `raw_size` | Tamaño del repositorio como un número | -| `collaborators` | Cantidad de colaboradores del repositorio | -| `fork?` | Si el repositorio es una bifurcación | -| `deleted?` | Si el repositorio ha sido borrado | - -### Indexar - - Las funciones de [búsqueda de código](https://github.com/blog/1381-a-whole-new-code-search) de GitHub son propulsadas por [ElasticSearch](http://www.elasticsearch.org/). Esta sección del tablero de administración del sitio muestra el estado actual de tu agrupación de ElasticSearch y brinda diversas herramientas para controlar el comportamiento de búsqueda e indexación. Estas herramientas están separadas en las siguientes tres categorías. - -#### Búsqueda de código - -Esto te permite habilitar o deshabilitar tanto las operaciones de búsqueda como de indexación en el código fuente. - -#### Reparación del índice de búsqueda de código - -Esto controla cómo se repara el índice de búsqueda de código. Puedes - -- habilitar o inhabilitar tareas de reparación de índices -- comenzar una nueva tarea de reparación de índice -- restablecer todos los estados de reparación de índices - -{% data variables.product.prodname_enterprise %} utiliza tareas de reparación para compaginar el estado del índice de búsqueda con los datos almacenados en una base de datos (propuestas, solicitudes de extracción, repositorios y usuarios) y los datos almacenados en los repositorios de Git (código fuente). Esto sucede cuando - -- se crea un nuevo índice de búsqueda; -- faltan datos que se deben reponer; o -- los datos de búsqueda antiguos deben ser actualizados. - -En otras palabras, las tareas de reparación se inician según se necesiten y se ejecutan en segundo plano, no están programados por los administradores del sitio de ningún modo. - -Además, las tareas de reparación utilizan una "compensación de reparación" para la paralelización. Esto es una compensación dentro de la tabla de base de datos para el registro que se está compaginando. Múltiples tareas en segundo plano pueden sincronizar el trabajo en base a esta compensación. - -Una barra de progreso muestra el estado actual de la tarea de reparación a través de todos sus trabajadores en segundo plano. Es la diferencia de porcentaje de la compensación de reparación con el ID de registro más alto en la base de datos. No te preocupes sobre el valor que se muestra en la barra de progreso después de que una tarea de reparación se haya completado: ya que muestra la diferencia entre la compensación de reparación y el ID del registro más alto en la base de datos, disminuirá a medida que se agreguen más repositorios a {% data variables.product.product_location_enterprise %} incluso aquellos repositorios que están de hecho indexados. - -Puedes comenzar una nueva tarea de reparación de índice de búsqueda de código en cualquier momento. Utilizará una CPU única ya que compagina el índice de búsqueda con la base de datos y los datos del repositorio de Git. Para minimizar los efectos que esto tendrá en el desempeño de I/O y reducir las posibilidades de que las operaciones queden inactivas, trata de ejecutar una tarea de reparación durante las horas valle en primer lugar. Controla las cargas promedio de tu sistema y el uso de tu CPU con una herramienta como `top`; si no notas cambios significativos, debería ser seguro ejecutar una tarea de reparación de índice también durante las horas pico. - -#### Reparación de índice de propuestas - - Esto controla de qué manera se repara el [índice de propuestas](https://github.com/blog/831-issues-2-0-the-next-generation). Puedes - -- habilitar o inhabilitar tareas de reparación de índices -- comenzar una nueva tarea de reparación de índice -- restablecer todos los estados de reparación de índices - -### Repositorios - -Es una lista de los repositorios en {% data variables.product.product_location_enterprise %}. Puedes hacer clic en un nombre de repositorio y acceder a las funciones para administrar el repositorio. - -- [Bloquear empujes forzados en un repositorio](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository/) -- [Configurar {% data variables.large_files.product_name_long %}](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-git-large-file-storage/#configuring-git-large-file-storage-for-an-individual-repository) -- [Archivar y desarchivar repositorios](/enterprise/{{ currentVersion }}/admin/guides/user-management/archiving-and-unarchiving-repositories/) - -### Todos los usuarios - -Aquí puedes ver todos los usuarios en {% data variables.product.product_location_enterprise %}—, e [iniciar una auditoría clave de SSH](/enterprise/{{ currentVersion }}/admin/guides/user-management/auditing-ssh-keys). - -### Administrador del sitio - -Aquí puedes ver todos los administradores en {% data variables.product.product_location_enterprise %}, e [iniciar una auditoría clave en SSH](/enterprise/{{ currentVersion }}/admin/guides/user-management/auditing-ssh-keys). - -### Usuarios inactivos - -Aquí puedes ver y [suspender](/enterprise/{{ currentVersion }}/admin/guides/user-management/suspending-and-unsuspending-users) todos los usuarios inactivos en {% data variables.product.product_location_enterprise %}. Una cuenta de usuario se considera inactiva ("dormant") cuando: - -- Ha existido durante más tiempo del umbral de inactividad que está establecido para {% data variables.product.product_location_enterprise %}. -- No ha generado ninguna actividad dentro de ese período. -- No es un administrador del sitio. - -{% data reusables.enterprise_site_admin_settings.dormancy-threshold %} Para obtener más información, consulta "[Administrar usuarios inactivos](/enterprise/{{ currentVersion }}/admin/guides/user-management/managing-dormant-users/#configuring-the-dormancy-threshold)." - -### Usuarios suspendidos - -Aquí puedes ver todos los usuarios que han sido suspendidos en {% data variables.product.product_location_enterprise %}, e [iniciar una auditoría clave de SSH](/enterprise/{{ currentVersion }}/admin/guides/user-management/auditing-ssh-keys). diff --git a/translations/es-XL/content/admin/installation/system-overview.md b/translations/es-XL/content/admin/installation/system-overview.md deleted file mode 100644 index c97c564520e9..000000000000 --- a/translations/es-XL/content/admin/installation/system-overview.md +++ /dev/null @@ -1,140 +0,0 @@ ---- -title: Descripción del sistema -intro: 'El {% data variables.product.prodname_ghe_server %} es la copia privada de tu organización de {% data variables.product.prodname_dotcom %} contenida dentro de un aparato virtual, alojada localmente o en la nube, que configuras y controlas.' -redirect_from: - - /enterprise/admin/installation/system-overview -versions: - enterprise-server: '*' ---- - -### Arquitectura de almacenamiento - -El {% data variables.product.prodname_ghe_server %} requiere dos volúmenes de almacenamiento, uno instalado en la ruta del *sistema de archivos raíz* (`/`) y otro en la ruta del *sistema de archivos del usuario* (`/data/user`). Esta arquitectura simplifica los procedimientos de actualización, reversión y recuperación al separar el entorno del software que se ejecuta de los datos de aplicación persistentes. - -El sistema de archivos raíz está incluido en la imagen de máquina distribuida. Contiene el sistema operativo base y el entorno de aplicación del {% data variables.product.prodname_ghe_server %}. El sistema de archivos raíz debería tratarse como efímero. Cualquier dato en el sistema de archivos raíz será reemplazado cuando se actualice con futuros lanzamientos del {% data variables.product.prodname_ghe_server %}. - -El sistema de archivos raíz contiene: - - Los certificados de autoridad de certificación personalizados (CA) (en */usr/local/share/ca-certificates*) - - Las configuraciones de red personalizadas - - Las configuraciones de firewall personalizadas - - El estado de replicación - -El sistema de archivos del usuario contiene la configuración y los datos del usuario, tales como: - - Repositorios Git - - Bases de datos - - Índices de búsqueda - - Contenido publicado en los sitios {% data variables.product.prodname_pages %} - - Archivos grandes de {% data variables.large_files.product_name_long %} - - Entornos de enlaces de pre-recepción - -### Opciones de implementación - -Puedes implementar el {% data variables.product.prodname_ghe_server %} como un aparato virtual único, o en una configuración de alta disponibilidad. Para obtener más información, consulta "[Configurar el {% data variables.product.prodname_ghe_server %} para alta disponibilidad](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-github-enterprise-server-for-high-availability/)." - -Algunas organizaciones con decenas de miles de programadores podrían también beneficiarse de una Agrupación del {% data variables.product.prodname_ghe_server %}. Para obtener más información, consulta "[Acerca de las agrupaciones](/enterprise/{{ currentVersion }}/admin/guides/clustering/about-clustering)." - -### Retención de datos y redundancia de centro de datos - -{% danger %} - -Antes de usar {% data variables.product.prodname_ghe_server %} en un entorno de producción, recomendamos firmemente que configures copias de seguridad y un plan de recuperación ante desastres. Para obtener más información, consulta "[Configurar copias de seguridad en tu aparato](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-backups-on-your-appliance)". - -{% enddanger %} - -El {% data variables.product.prodname_ghe_server %} incluye soporte para copias de seguridad en línea e incrementales con [{% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils). Puedes tomar instantáneas incrementales sobre un enlace de red seguro (el puerto administrativo SSH) sobre grandes distancias para el almacenamiento externo o geográficamente disperso. Puedes restaurar instantáneas a través de la red en un nuevo aparato virtual recientemente aprovisionado al momento de la recuperación en el caso de un desastre en el centro de datos principal. - -Además se admiten las copias de seguridad de red, las instantáneas de disco AWS (EBS) y VMware de los volúmenes de almacenamiento del usuario mientras que el aparato está fuera de línea o en modo mantenimiento. Las instantáneas de volumen regulares pueden usarse como una alternativa de bajo costo y baja complejidad para las copias de seguridad de red con {% data variables.product.prodname_enterprise_backup_utilities %} si tus requisitos de nivel de servicio permiten un mantenimiento fuera de línea regular. - -Para obtener más información, consulta "[Configurar copias de seguridad en tu aparato](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-backups-on-your-appliance)". - -### Seguridad - -El {% data variables.product.prodname_ghe_server %} es un aparato virtual que se ejecuta en tu infraestructura y está gobernado por tus controles de seguridad de información existentes, como cortafuegos, IAM, monitoreo y VPN. Usar el {% data variables.product.prodname_ghe_server %} puede ayudarte a evitar problemas de cumplimiento regulatorio que surgen de las soluciones basadas en la nube. - -El {% data variables.product.prodname_ghe_server %} también incluye características de seguridad adicionales. - -- [Sistema operativo, software y parches](#operating-system-software-and-patches) -- [Seguridad de la red](#network-security) -- [Seguridad de la aplicación](#application-security) -- [Servicios externos y acceso de soporte](#external-services-and-support-access) -- [Comunicación encriptada](#encrypted-communication) -- [Usuarios y permisos de acceso](#users-and-access-permissions) -- [Autenticación](#authentication) -- [Auditoría y registro de acceso](#audit-and-access-logging) - -#### Sistema operativo, software y parches - -El {% data variables.product.prodname_ghe_server %} ejecuta un sistema operativo Linux personalizado con las aplicaciones y los servicios necesarios únicamente. El {% data variables.product.prodname_dotcom %} gestiona el parche del sistema operativo central del aparato como parte de su ciclo estándar de lanzamiento de productos. Los parches abordan problemas de funcionalidad, de estabilidad y de seguridad no críticos para las aplicaciones de {% data variables.product.prodname_dotcom %}. {% data variables.product.prodname_dotcom %} también proporciona parches de seguridad críticos según se necesita fuera del ciclo de lanzamiento regular. - -#### Seguridad de la red - -El cortafuegos interno del {% data variables.product.prodname_ghe_server %} restringe el acceso de la red a los servicios del aparato. Están disponibles en la red únicamente los servicios necesarios para que el aparato funcione. Para obtener más información, consulta "[Puertos de red](/enterprise/{{ currentVersion }}/admin/guides/installation/network-ports)." - -#### Seguridad de la aplicación - -El equipo de seguridad de la aplicación de {% data variables.product.prodname_dotcom %} se centra en la evaluación de vulnerabilidad, la prueba de penetración y la revisión del código para los productos de {% data variables.product.prodname_dotcom %} , incluido el {% data variables.product.prodname_ghe_server %}. {% data variables.product.prodname_dotcom %} también contrata firmas de seguridad externas para proporcionar evaluaciones de seguridad puntuales de los productos de {% data variables.product.prodname_dotcom %}. - -#### Servicios externos y acceso de soporte - -El {% data variables.product.prodname_ghe_server %} puede funcionar sin ningún acceso de salida de tu red a servicios externos. De forma opcional, puedes habilitar la integración con servicios externos para la entrega de correo electrónico, el monitoreo externo y el reenvío de registros. Para más información, consulta "[Configurar correo electrónico para notificaciones](/enterprise/{{ currentVersion }}/admin/user-management/configuring-email-for-notifications)," "[Configurar el monitoreo externo](/enterprise/{{ currentVersion }}/admin/installation/setting-up-external-monitoring)" y "[Reenvío de registros](/enterprise/{{ currentVersion }}/admin/installation/log-forwarding)." - -Puedes recopilar y enviar manualmente datos de resolución de problemas a {% data variables.contact.github_support %}. Para obtener más información, consulta "[Proporcionar datos a {% data variables.contact.github_support %}](/enterprise/{{ currentVersion }}/admin/enterprise-support/providing-data-to-github-support)." - -#### Comunicación encriptada - -{% data variables.product.prodname_dotcom %} diseña {% data variables.product.prodname_ghe_server %} para ejecutar detrás de tu cortafuegos corporativo. Para asegurar la comunicación a través del cable, te alentamos a habilitar la seguridad de la capa de transporte (TLS). El {% data variables.product.prodname_ghe_server %} admite certificados TLS comerciales de 2048 bits y superiores para el tráfico HTTPS. Para obtener más información, consulta "[Configurar TLS](/enterprise/{{ currentVersion }}/admin/installation/configuring-tls)." - -Por defecto, el aparato también ofrece acceso a Secure Shell (SSH) para el acceso al repositorio utilizando Git y con fines administrativos. Para obtener más información, consulta "[Acerca de SSH](/enterprise/user/articles/about-ssh)" y "[Acceder al shell administrativo (SSH)](/enterprise/{{ currentVersion }}/admin/installation/accessing-the-administrative-shell-ssh)." - -#### Usuarios y permisos de acceso - -El {% data variables.product.prodname_ghe_server %} proporciona tres tipos de cuentas. - -- La cuenta de usuario de Linux del `administrador` ha controlado el acceso al sistema operativo subyacente, incluido el sistema de archivos directo y el acceso a la base de datos. Un pequeño conjunto de administradores de confianza debería tener acceso a esta cuenta, a la que pueden acceder por medio de SSH. Para obtener más información, consulta "[Acceder al shell administrativo (SSH)](/enterprise/{{ currentVersion }}/admin/installation/accessing-the-administrative-shell-ssh)." -- Las cuentas de usuario en la aplicación web del aparato tienen acceso completo a sus propios datos y a cualquier dato que otros usuarios u organizaciones concedan de manera explícita. -- Los administradores del sitio en la aplicación web del aparato son cuentas de usuario que pueden administrar los ajustes de aplicaciones web y de aparatos de alto nivel, la configuración de cuenta de usuario y de organización y los datos del repositorio. - -Para más información sobre los permisos de usuario del {% data variables.product.prodname_ghe_server %}, consulta "[Permisos de acceso en GitHub](/enterprise/user/articles/access-permissions-on-github)." - -#### Autenticación - -El {% data variables.product.prodname_ghe_server %} proporciona cuatro métodos de autenticación. - -- La autenticación de claves públicas SSH proporciona acceso del repositorio usando Git y el shell administrativo. Para obtener más información, consulta "[Acerca de SSH](/enterprise/user/articles/about-ssh)" y "[Acceder al shell administrativo (SSH)](/enterprise/{{ currentVersion }}/admin/installation/accessing-the-administrative-shell-ssh)." -- El nombre de usuario y la autenticación de contraseña con cookies HTTP proporciona acceso a la aplicación web y la gestión de sesiones, con autenticación opcional de dos factores (2FA). Para obtener más información, consulta "[Usar la autenticación incorporada](/enterprise/{{ currentVersion }}/admin/user-management/using-built-in-authentication)." -- La autenticación externa LDAP, SAML o CAS mediante un servicio LDAP, SAML Identity Provider (IdP) u otro servicio compatible proporciona acceso a la aplicación web. Para más información, consulta "[Autenticar usuarios para tu instancia de servidor de GitHub Enterprise](/enterprise/{{ currentVersion }}/admin/user-management/authenticating-users-for-your-github-enterprise-server-instance)." -- OAuth y los token de acceso personal proporcionan acceso a los datos del repositorio de Git y a API para clientes externos y servicios. Para obtener más información, consulta la sección "[Crear un token de acceso personal](/github/authenticating-to-github/creating-a-personal-access-token)". - -#### Auditoría y registro de acceso - -El {% data variables.product.prodname_ghe_server %} almacena tanto registros tradicionales de sistema operativo como de aplicación. La aplicación también escribe registros de auditoría y de seguridad detallados, que el {% data variables.product.prodname_ghe_server %} almacena de forma permanente. Puedes reenviar ambos tipos de registros en tiempo real a múltiples destinos a través del protocolo `syslog-ng`. Para obtener más información, consulta "[Redireccionamiento de registro](/enterprise/{{ currentVersion }}/admin/installation/log-forwarding)." - -Los registros de acceso y de auditoría incluyen información como la siguiente. - -##### Registros de acceso - -- Registros completos de servidor web tanto para el navegador como para el acceso a la API -- Registros completos para acceder a los datos del repositorio por medio de protocolos Git, HTTPS y SSH -- Registros de acceso administrativo por medio de HTTPS y SSH - -##### Registros de auditoría - -- Inicios de sesión del usuario, restablecimientos de contraseña, solicitudes 2FA, cambios en la configuración del correo electrónico y cambios en aplicaciones autorizadas y API -- Acciones de administrador del sitio, como desbloquear cuentas de usuario y repositorios -- Eventos push de repositorio, permisos de acceso, transferencias y renombres -- Cambios de membresía de la organización, incluida la creación y la destrucción de equipo - -### Dependencias de código abierto para {% data variables.product.prodname_ghe_server %} - -Puedes consultar una lista completa de dependencias en la versión de tu aparato de {% data variables.product.prodname_ghe_server %}, y la licencia de cada proyecto, en `http(s)://HOSTNAME/site/credits`. - -Están disponibles en tu aparato los tarballes con una lista completa de dependencias y metadatos asociados: -- Para conocer las dependencias comunes a todas las plataformas, ingresa en `/usr/local/share/enterprise/dependencies--base.tar.gz`. -- Para conocer las dependencias específicas de una plataforma, ingresa en `/usr/local/share/enterprise/dependencies--.tar.gz`. - -También están disponibles los tarballes, con una lista completa de las dependencias y los metadatos, en `https://enterprise.github.com/releases//download.html`. - -### Leer más - -- "[Configurar una prueba de {% data variables.product.prodname_ghe_server %}](/articles/setting-up-a-trial-of-github-enterprise-server)" -- "[Configurar una instancia del {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-github-enterprise-server-instance)" diff --git a/translations/es-XL/content/admin/installation/troubleshooting-ssl-errors.md b/translations/es-XL/content/admin/installation/troubleshooting-ssl-errors.md deleted file mode 100644 index 367571815f81..000000000000 --- a/translations/es-XL/content/admin/installation/troubleshooting-ssl-errors.md +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: Errores de solución de problemas de SSL -intro: 'Si te encuentras con problemas de SSL en tu aparato, puedes tomar medidas para resolverlos.' -redirect_from: - - /enterprise/admin/articles/troubleshooting-ssl-errors/ - - /enterprise/admin/categories/dns-ssl-and-subdomain-configuration/ - - /enterprise/admin/installation/troubleshooting-ssl-errors -versions: - enterprise-server: '*' ---- - -### Eliminar la contraseña de un archivo clave - -Si tienes una máquina linux con OpenSSL instalado, puedes eliminar tu contraseña. - -1. Renombrar tu archivo clave original. - ```shell - $ mv yourdomain.key yourdomain.key.orig - ``` -2. Generar una nueva clave sin una contraseña. - ```shell - $ openssl rsa -in yourdomain.key.orig -out yourdomain.key - ``` - -Se te pedirá la contraseña de la clave cuando ejecutes este comando. - -Para más información sobre OpenSSL, consulta la documentación de OpenSSL [](https://www.openssl.org/docs/). - -### Convertir tu certificado SSL o tu clave a un formato PEM - -Si tienes instalado OpenSSL, puedes convertir tu clave en formato PEM usando el comando `openssl`. Por ejemplo, puedes convertir una clave de formato DER a formato PEM. - -```shell -$ openssl rsa -in yourdomain.der -inform DER -out yourdomain.key -outform PEM -``` - -De lo contrario, puedes utilizar la herramienta SSL Converter para convertir tu certificado a formato PEM. Para obtener más información, consulta la [Documentación de la herramienta SSL Converter](https://www.sslshopper.com/ssl-converter.html). - -### Instalación sin respuesta después de cargar una clave - -Si {% data variables.product.product_location_enterprise %} no tiene respuesta después de cargar una clave SSL, contacta [al {% data variables.product.prodname_enterprise %} Soporte](https://enterprise.github.com/support) con detalles específicos, incluida una copia de tu certificado SSL. - -### Errores de validez de certificado - -Los clientes como navegadores web y líneas de comando Git mostrarán un mensaje de error si no pueden verificar la validez de un certificado SSL. Esto sucede con frecuencia con los certificados autofirmados y los certificados de "raíz encadenada" emitidos por un certificado raíz intermedio que no es reconocido por el cliente. - -Si estás usando un certificado firmado por una autoridad de certificación (CA), el archivo del certificado que cargaste a {% data variables.product.prodname_ghe_server %} debe incluir una cadena de certificado con ese certificado raíz de CA. Para crear dicho archivo, concatena tu cadena de certificado entera (o "paquete de certificado") al final de tu certificado, garantizando que el certificado principal con tu nombre del host aparezca primero. En la mayoría de los sistemas puedes hacer esto con un comando similar a: - -```shell -$ cat yourdomain.com.crt bundle-certificates.crt > yourdomain.combined.crt -``` - -Deberías poder descargar un paquete de certificado (por ejemplo, `bundle-certificates.crt`) desde tu proveedor de SSL o de la autoridad de certificación. - -### Instalar certificados raíz de autoridad de certificación (CA) autofirmados o que no son de confianza - -Si tu aparato {% data variables.product.prodname_ghe_server %} interactúa con otras máquinas en tu red que utilizan un certificado autofirmado o que no es de confianza, deberás importar el certificado raíz de la CA firmante en el almacenamiento de certificado de todo el sistema para poder acceder a estos sistemas por HTTPS. - -1. Obtén el certificado raíz de la CA de tu autoridad de certificación local y asegúrate que esté en formato PEM. -2. Copia el archivo a tu aparato {% data variables.product.prodname_ghe_server %} por SSH como el usuario "administrador" en el puerto 122. - ```shell - $ scp -P 122 rootCA.crt admin@HOSTNAME:/home/admin - ``` -3. Conecta a la shell administrativa {% data variables.product.prodname_ghe_server %} por SSH como el usuario "administrador" en el puerto 122. - ```shell - $ ssh -p 122 admin@HOSTNAME - ``` -4. Importa el certificado al almacenamiento de certificado de todo el sistema. - ```shell - $ ghe-ssl-ca-certificate-install -c rootCA.crt - ``` diff --git a/translations/es-XL/content/admin/installation/updating-the-virtual-machine-and-physical-resources.md b/translations/es-XL/content/admin/installation/updating-the-virtual-machine-and-physical-resources.md deleted file mode 100644 index 6b0c8275d946..000000000000 --- a/translations/es-XL/content/admin/installation/updating-the-virtual-machine-and-physical-resources.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: Actualizar la máquina virtual y los recursos físicos -intro: 'La actualización del software virtual y del hardware virtual requiere algo de tiempo de inactividad para tu instancia, por ello asegúrate de planear tu actualización de antemano.' -redirect_from: - - '/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-the-vm/' - - '/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-physical-resources/' - - /enterprise/admin/installation/updating-the-virtual-machine-and-physical-resources -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/es-XL/content/admin/installation/upgrade-requirements.md b/translations/es-XL/content/admin/installation/upgrade-requirements.md deleted file mode 100644 index 6c75f06c77e2..000000000000 --- a/translations/es-XL/content/admin/installation/upgrade-requirements.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Requisitos de actualización -intro: 'Antes de actualizar el {% data variables.product.prodname_ghe_server %}, revisa estas recomendaciones y requisitos para planificar tu estrategia de actualización.' -redirect_from: - - /enterprise/admin/guides/installation/finding-the-current-github-enterprise-release/ - - /enterprise/admin/installation/upgrade-requirements -versions: - enterprise-server: '*' ---- - -{% note %} - -**Notas:** -- Para actualizar desde {% data variables.product.prodname_enterprise %} 11.10.348 a {% data variables.product.current-340-version %}, debes primero migrar a {% data variables.product.prodname_enterprise %} 2.1.23. Para obtener más información, consulta "[Migrar desde {% data variables.product.prodname_enterprise %} 11.10.x a 2.1.23](/enterprise/{{ currentVersion }}/admin/guides/installation/migrating-from-github-enterprise-11-10-x-to-2-1-23)." -- Los paquetes de actualización están disponibles en [enterprise.github.com](https://enterprise.github.com/releases) para las versiones admitidas. Verifica la disponibilidad de los paquetes de actualización, deberás completar la actualización. Si un paquete no está disponible, contacta a {% data variables.contact.contact_ent_support %} para obtener ayuda. -- Si estás usando una Agrupación del {% data variables.product.prodname_ghe_server %}, consulta "[Actualizar una agrupación](/enterprise/{{ currentVersion }}/admin/guides/clustering/upgrading-a-cluster/)" en la Guía de Agrupación del {% data variables.product.prodname_ghe_server %} para obtener instrucciones específicas únicas para agrupaciones. -- Estas notas de lanzamiento para el {% data variables.product.prodname_ghe_server %} brindan una lista detallada de las nuevas características de cada versión del {% data variables.product.prodname_ghe_server %}. Para obtener más información, consulta las [páginas de lanzamiento](https://enterprise.github.com/releases). - -{% endnote %} - -### Recomendaciones - -- Incluye tantas nuevas actualizaciones como sea posible en tu proceso de actualización. Por ejemplo, en lugar de actualizar desde {% data variables.product.prodname_enterprise %} {{ enterpriseVersions.supported[2] }} a {{ enterpriseVersions.supported[1] }} a {{ enterpriseVersions.latest }}, podrías actualizar desde {% data variables.product.prodname_enterprise %} {{ enterpriseVersions.supported[2] }} a {{ enterpriseVersions.latest }}. -- Si estás varias versiones desactualizado, actualiza {% data variables.product.product_location_enterprise %} tanto como sea posible con cada paso de tu proceso de actualización. Utilizar la versión más reciente posible en cada actualización te permite aprovechar las mejoras de desempeño y las correcciones de errores. Por ejemplo, podrías actualizar desde {% data variables.product.prodname_enterprise %} 2.7 a 2.8 a 2.10, pero actualizar desde {% data variables.product.prodname_enterprise %} 2.7 a 2.9 a 2.10 utiliza una versión posterior en el segundo paso. -- Utiliza el lanzamiento de patch más reciente cuando actualices. {% data reusables.enterprise_installation.enterprise-download-upgrade-pkg %} -- Utiliza una instancia de preparación para probar los pasos de actualización. Para obtener más información, consulta "[Configurar una instancia de preparación](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-staging-instance/)." -- Cuando ejecutes múltiples actualizaciones, espera por lo menos 24 horas entre las actualizaciones de características para permitir que las tareas de actualización de migraciones de datos y de datos en copias de seguridad se completen en su totalidad. - -### Requisitos - -- Debes actualizar desde una característica de lanzamiento que sea **como máximo** dos lanzamientos anteriores. Por ejemplo, para actualizar a {% data variables.product.prodname_enterprise %} {{ enterpriseVersions.latest }}, debes estar en {% data variables.product.prodname_enterprise %} {{ enterpriseVersions.supported[1] }} o {{ enterpriseVersions.supported[2] }}. -- {% data reusables.enterprise_installation.hotpatching-explanation %} -- Es posible que un hotpatch requiera tiempo de inactividad si los servicios afectados (como kernel, MySQL, o Elasticsearch) requieren un reinicio de VM o un reinicio del servicio. Se te notificará cuando se necesite reiniciar. Puedes completar el reinicio más tarde. -- Es necesario que haya un almacenamiento raíz adicional disponible cuando se actualiza a través de un hotpatch, ya que instala múltiples versiones de determinados servicios hasta que se completa la actualización. El control de prevuelo te notificará si no tienes suficiente almacenamiento de disco raíz. -- Cuando se actualiza a través de un hotpatch, tu instancia no puede estar muy cargada, ya que puede impactar el proceso del hotpatch. Los controles de pre-vuelo considerarán la carga promedio y, posteriormente, la mejora fallará si dicha carga promedio es demasiado alta. - Mejorar a {% data variables.product.prodname_ghe_server %} 2.17 migrará sus registros de auditoría de Elasicsearch a MySQL. Esta migración también incrementa la cantidad de tiempo y el espacio en disco que lleva restaurar una instantánea. Antes de migrar, controla el número de bytes en tus índices de registro de auditoría de ElasticSearch con este comando: -``` shell -curl -s http://localhost:9201/audit_log/_stats/store | jq ._all.primaries.store.size_in_bytes -``` -Utiliza el número para estimar la cantidad de espacio de disco que los registros de auditoría de MySQL necesitarán. El script también controla tu espacio libre en disco mientras la importación está en progreso. Controlar este número es especialmente útil si tu espacio libre en disco está cerca de la cantidad de espacio en disco necesaria para la migración. - -Después de revisar estas recomendaciones y requisitos, puedes actualizar el {% data variables.product.prodname_ghe_server %}. Para obtener más información, consulta "[Actualizar {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-github-enterprise-server/)." diff --git a/translations/es-XL/content/admin/installation/upgrading-github-enterprise-server.md b/translations/es-XL/content/admin/installation/upgrading-github-enterprise-server.md deleted file mode 100644 index ff649ea0f2be..000000000000 --- a/translations/es-XL/content/admin/installation/upgrading-github-enterprise-server.md +++ /dev/null @@ -1,219 +0,0 @@ ---- -title: Actualizar el servidor de GitHub Enterprise -intro: 'Actualizar el {% data variables.product.prodname_ghe_server %} para obtener las funciones y las actualizaciones de seguridad más recientes.' -redirect_from: - - /enterprise/admin/articles/upgrading-to-the-latest-release/ - - /enterprise/admin/articles/migrations-and-upgrades/ - - /enterprise/admin/guides/installation/upgrading-the-github-enterprise-virtual-machine/ - - /enterprise/admin/guides/installation/upgrade-packages-for-older-releases/ - - /enterprise/admin/articles/upgrading-older-installations/ - - /enterprise/admin/hidden/upgrading-older-installations/ - - /enterprise/admin/hidden/upgrading-github-enterprise-using-a-hotpatch-early-access-program/ - - /enterprise/admin/hidden/upgrading-github-enterprise-using-a-hotpatch/ - - /enterprise/admin/guides/installation/upgrading-github-enterprise/ - - /enterprise/admin/installation/upgrading-github-enterprise-server -versions: - enterprise-server: '*' ---- - -### Preparar para una actualización - -1. Determina una estrategia de actualización y elige una versión a la que actualizar. Para obtener más información, consulta "[Requisitos de actualización](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)." -3. Crea una copia de seguridad nueva de tu instancia principal con las {% data variables.product.prodname_enterprise_backup_utilities %}. Para obtener más información, consulta el archivo README.md en [{% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils#readme). -4. Si estás actualizando con un paquete de actualización, programa una ventana de mantenimiento para los usuarios finales del {% data variables.product.prodname_ghe_server %}. Si estás usando un hotpatch, no se necesita el modo mantenimiento. - - {% note %} - - **Nota:** la ventana de mantenimiento depende del tipo de actualización que realices. Las actualizaciones que utilizan un hotpatch por lo general no necesitan una ventana de mantenimiento. A veces se necesita reiniciar; puedes hacerlo más tarde. Siguiendo el esquema de control de versiones de MAJOR.FEATURE.PATCH, los lanzamientos de patch que utilizan un paquete de actualización normalmente necesitan menos de cinco minutos de tiempo de inactividad. Los lanzamientos de funciones que incluyen migraciones de datos toman más tiempo dependiendo del desempeño del almacenamiento y de la cantidad de datos que se migran. Para obtener más información, consulta [Habilitar y programar el modo mantenimiento](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)." - - {% endnote %} - -### Tomar una instantánea - -Una instantánea es un punto de verificación de una máquina virtual (VM) en un momento en el tiempo. Recomendamos firmemente tomar una instantánea antes de actualizar tu máquina virtual para que si falla una actualización, puedas revertir tu VM nuevamente a la instantánea. Si no estás actualizando a un nuevo lanzamiento de característica, debes tomar una instantánea de VM. Si estás actualizando a un nuevo lanzamiento de patch, puedes adjuntar el disco de datos existente. - -Hay dos tipos de instantáneas: - -- **Las instantáneas de VM** guardan el estado completo de tu VM, incluidos los datos del usuario y los datos de configuración. Este método de instantáneas requiere una gran cantidad de espacio de disco e insume mucho tiempo. -- **Las instantáneas de disco de datos** únicamente guardan tus datos de usuario. - - {% note %} - - **Notas:** - - Algunas plataformas no permiten que tomes una instantánea solo de tu disco de datos. Para estas plataformas, necesitarás tomar una instantánea de tu VM completa. - - Si tu hipervisor no admite instantáneas de VM completas, debes tomar una instantánea de tu disco raíz y de tu disco de datos en rápida sucesión. - - {% endnote %} - -| Plataforma | Método de instantánea | URL de documentación de instantánea | -| --------------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| Amazon AWS | Disco | | -| Azure | VM | | -| Hyper-V | VM | | -| Google Compute Engine | Disco | | -| VMware | VM | [https://pubs.vmware.com/vsphere-50/topic/com.vmware.wssdk.pg.doc_50/PG_Ch11_VM_Manage.13.3.html](https://pubs.vmware.com/vsphere-50/topic/com.vmware.wssdk.pg.doc_50/PG_Ch11_VM_Manage.13.3.html) | -| XenServer | VM | | - -### Actualizar con un hotpatch - -{% data reusables.enterprise_installation.hotpatching-explanation %} Utilizando la {% data variables.enterprise.management_console %}, puedes instalar un hotpatch de forma inmediata o programar la instalación para más tarde. Puedes utilizar el shell administrativo para instalar un hotpatch con la herramienta `ghe-upgrade`. Para obtener más información, consulta "[Requisitos de actualización](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)." - -{% note %} - -**Note**: instalar un hotpatch utilizando la {% data variables.enterprise.management_console %} no está disponible en los entornos de agrupación. Para instalar un parche en un entorno de agrupación, consulta "[Actualizar una agrupación](/enterprise/{{ currentVersion }}/admin/clustering/upgrading-a-cluster#upgrading-with-a-hotpatch)." - -{% endnote %} - -#### Actualizar un aparato único con un hotpatch - -##### Instalar un hotpatch utilizando la {% data variables.enterprise.management_console %} - -1. Habilitar actualizaciones automáticas. Para obtener más información, consulta "[Habilitar actualizaciones automáticas](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-subdomain-isolation/)." -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.updates-tab %} -4. Cuando se ha descargado un nuevo hotpatch, utiliza el menú desplegable del paquete de instalación: - - Para instalar de forma inmediata, selecciona **Now (Ahora)**: - - Para instalarlo más tarde, selecciona una fecha posterior. ![Menú desplegable de fecha de instalación de hotpatch](/assets/images/enterprise/management-console/hotpatch-installation-date-dropdown.png) -5. Haz clic en **Install** (Instalar). ![Botón de instalación de hotpatch](/assets/images/enterprise/management-console/hotpatch-installation-install-button.png) - -##### Instalar un hotpatch utilizando un shell administrativo - -{% data reusables.enterprise_installation.download-note %} - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. {% data reusables.enterprise_installation.enterprise-download-upgrade-pkg %} Copia el URL para obtener el paquete de actualización (*.hpkg* file). -{% data reusables.enterprise_installation.download-package %} -4. Ejecuta el comando `ghe-upgrade` utilizando el nombre del archivo del paquete: - ```shell - admin@HOSTNAME:~$ ghe-upgrade GITHUB-UPGRADE.hpkg - *** verifying upgrade package signature... - ``` -5. Si se requiere un reinicio para las actualizaciones de kernel, MySQL, Elasticsearch u otros programas, el script de actualización de hotpatch te avisa. - -#### Actualizar un aparato que tiene instancias de réplica utilizando un hotpatch - -{% note %} - -**Nota**: si estás instalando un hotpatch, no necesitas entrar en modo de mantenimiento o detener la replicación. - -{% endnote %} - -Los aparatos configurados para alta disponibilidad y de replicación geográfica utilizan instancias de réplica además de las instancias principales. Para actualizar estos aparatos, necesitarás actualizar tanto la instancia principal y todas las instancias de réplica, una a la vez. - -##### Actualizar la instancia principal - -1. Actualiza la instancia principal siguiendo las instrucciones en "[Instalar un hotpatch utilizando el shell administrativo](#installing-a-hotpatch-using-the-administrative-shell)." - -##### Actualizar una instancia de réplica - -{% note %} - -**Nota:** si estás ejecutando múltiples instancias de réplica como parte de la replicación geográfica, repite este procedimiento para cada instancia de réplica, una a la vez. - -{% endnote %} - -1. Actualiza la instancia de réplica siguiendo las instrucciones en "[Instalar un hotpatch utilizando el shell administrativo](#installing-a-hotpatch-using-the-administrative-shell)." Si estás usando múltiples réplicas para la replicación geográfica, debes repetir este procedimiento para actualizar cada réplica, una a la vez. -{% data reusables.enterprise_installation.replica-ssh %} -{% data reusables.enterprise_installation.replica-verify %} - -### Actualizar con un paquete de actualización - -Al mismo tiempo que puedes utilizar un hotpatch para actualizar al lanzamiento de patch más reciente dentro de una serie de características, debes utilizar un paquete de actualización para actualizar a un lanzamiento de característica más nuevo. Por ejemplo para actualizar de `2.11.10` a `2.12.4` debes utilizar un paquete de actualización ya que están en series de características diferentes. Para obtener más información, consulta "[Requisitos de actualización](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)." - -#### Actualizar un aparato único con un paquete de actualización - -{% data reusables.enterprise_installation.download-note %} - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. {% data reusables.enterprise_installation.enterprise-download-upgrade-pkg %} Selecciona la plataforma adecuada y copia el URL para obtener el paquete de actualización (*.pkg* file). -{% data reusables.enterprise_installation.download-package %} -4. Habilita el modo mantenimiento y espera que se completen todos los procesos activos en la instancia del {% data variables.product.prodname_ghe_server %}. Para obtener más información, consulta "[Habilitar y programar el modo mantenimiento](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)." - - {% note %} - - **Nota**: cuando se actualiza el aparato primario en una configuración de alta disponibilidad, el aparato debería estar ya en modo mantenimiento si estás siguiendo las instrucciones en "[Actualizar la instancia primaria](#upgrading-the-primary-instance)." - - {% endnote %} - -5. Ejecuta el comando `ghe-upgrade` utilizando el nombre del archivo del paquete: - ```shell - admin@HOSTNAME:~$ ghe-upgrade GITHUB-UPGRADE.pkg - *** verifying upgrade package signature... - ``` -6. Confirma que te gustaría continuar con la actualización y reinicia después de que se verifique la firma del paquete. El nuevo sistema de archivos raíz escribe en la segunda partición y la instancia de forma automática se reinicia en modo mantenimiento: - ```shell - *** aplicando actualización... - This package will upgrade your installation to version version-number - Current root partition: /dev/xvda1 [version-number] - Target root partition: /dev/xvda2 - Proceed with installation? [s/N] - ``` -7. Para las actualizaciones de aparato único, deshabilita el modo mantenimiento para que los usuarios puedan utilizar {% data variables.product.product_location_enterprise %}. - - {% note %} - - **Nota**: cuando se actualizan aparatos en configuración de alta disponibilidad, deberías mantener el modo mantenimiento hasta que hayas actualizado todas las réplicas y la replicación esté en curso. Para obtener más información, consulta "[Actualizar una instancia de réplica](#upgrading-a-replica-instance)." - - {% endnote %} - -#### Actualizar un aparato que tiene instancias de réplica utilizando un paquete de actualización - -Los aparatos configurados para alta disponibilidad y de replicación geográfica utilizan instancias de réplica además de las instancias principales. Para actualizar estos aparatos, necesitarás actualizar tanto la instancia principal y todas las instancias de réplica, una a la vez. - -##### Actualizar la instancia principal - -{% warning %} - -**Advertencia:** Cuando se detiene una replicación, si falla la primaria, se perderá cualquier trabajo que se realice antes de que la réplica esté actualizada y comience nuevamente la replicación. - -{% endwarning %} - -1. En la instancia primaria, habilita el modo mantenimiento y espera a que se completen todos los procesos activos. Para obtener más información, consulta "[Habilitar el modo mantenimiento](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode/)." -{% data reusables.enterprise_installation.replica-ssh %} -3. En la instancia de réplica, o en todas las instancias de réplica si estás ejecutando múltiples instancias de réplica como parte de una replicación geográfica, ejecuta `ghe-repl-stop` para detener la replicación. -4. Actualiza la instancia primaria siguiendo las instrucciones en "[Actualizar un aparato único con un paquete de actualización](#upgrading-a-single-appliance-with-an-upgrade-package)." - -##### Actualizar una instancia de réplica - -{% note %} - -**Nota:** si estás ejecutando múltiples instancias de réplica como parte de la replicación geográfica, repite este procedimiento para cada instancia de réplica, una a la vez. - -{% endnote %} - -1. Actualiza la instancia de réplica siguiendo las instrucciones en "[Actualizar un aparato único con un paquete de actualización](#upgrading-a-single-appliance-with-an-upgrade-package)." Si estás usando múltiples réplicas para la replicación geográfica, debes repetir este procedimiento para actualizar cada réplica, una a la vez. -{% data reusables.enterprise_installation.replica-ssh %} -{% data reusables.enterprise_installation.replica-verify %} - -{% data reusables.enterprise_installation.start-replication %} - -{% data reusables.enterprise_installation.replication-status %} Si el comando devuelve `La replicación no se está ejecutando`, la replicación puede estar comenzando. Espera alrededor de un minuto antes de volver a ejecutar `ghe-repl-status`. - - {% note %} - - **Nota:** mientras la resincronización está en progreso, `ghe-repl-status` puede devolver mensajes esperados que indiquen que la replicación está de forma subyacente. - Por ejemplo: `CRITICO: la replicación de git está de forma subyacente de la primaria por más de 1007 repositorios o gists` - - {% endnote %} - - Si `ghe-repl-status` no devuelve `OK`, sigue los pasos de abajo para iniciar la replicación de forma manual. - - 1. En la instancia de réplica, ejecuta nuevamente `ghe-repl-setup `. - {% data reusables.enterprise_installation.start-replication %} - {% data reusables.enterprise_installation.replication-status %} -6. Cuando hayas completado la actualización de la última réplica, y se haya completado la resincronización, deshabilita el modo mantenimiento para que los usuarios puedan utilizar {% data variables.product.product_location_enterprise %}. - -### Restaurar desde una actualización fallida - -Si una actualización falla o se interrumpe, deberías revertir tu instancia a su estado anterior. El proceso para completar esto depende del tipo de actualización. - -#### Revertir un lanzamiento de patch - -Para volver a lanzar una versión de parche, usa el comando `ghe-upgrade` con el comando `--allow-patch-rollback` switch. {% data reusables.enterprise_installation.command-line-utilities-ghe-upgrade-rollback %} - -Para obtener más información, consulta "[Herramientas de línea de comando](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities/#ghe-upgrade)." - -#### Revertir un lanzamiento de característica - -Para revertir un lanzamiento de característica, restaura desde una instantánea de VM para garantizar que las particiones raíz y de datos estén en un estado consistente. Para obtener más información, consulta "[Tomar una instantánea](#taking-a-snapshot)." diff --git a/translations/es-XL/content/admin/installation/using-github-enterprise-server-with-a-load-balancer.md b/translations/es-XL/content/admin/installation/using-github-enterprise-server-with-a-load-balancer.md deleted file mode 100644 index 3a95b0c5aa47..000000000000 --- a/translations/es-XL/content/admin/installation/using-github-enterprise-server-with-a-load-balancer.md +++ /dev/null @@ -1,54 +0,0 @@ ---- -title: Utilizar el servidor de GitHub Enterprise con un balanceador de carga -intro: 'Utiliza un balanceador de carga frente a un aparato único del {% data variables.product.prodname_ghe_server %} o un par de aparatos en una configuración de alta disponibilidad.' -redirect_from: - - /enterprise/admin/guides/installation/using-github-enterprise-with-a-load-balancer/ - - /enterprise/admin/installation/using-github-enterprise-server-with-a-load-balancer -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_clustering.load_balancer_intro %} - -{% data reusables.enterprise_clustering.load_balancer_dns %} - -### Manejar información de conexión de clientes - -Debido a que las conexiones de cliente al {% data variables.product.prodname_ghe_server %} provienen del balanceador de carga, se puede perder la dirección IP del cliente. - -{% data reusables.enterprise_clustering.proxy_preference %} - -{% data reusables.enterprise_clustering.proxy_xff_firewall_warning %} - -#### Habilitar soporte para protocolo de PROXY en {% data variables.product.product_location_enterprise %} - -Recomendamos firmemente habilitar el soporte para protocolo de PROXY para tu aparato y el balanceador de carga. Utiliza las instrucciones provistas por tu proveedor para habilitar el protocolo PROXY en tu balanceador de carga. Para obtener más información, consulta [la documentación de protocolo PROXY](http://www.haproxy.org/download/1.6/doc/proxy-protocol.txt). - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -3. Dentro de **External load balancers (Balanceadores de carga externos)**, selecciona **Enable support for PROXY protocol (Habilitar soporte para el protocolo de PROXY)**. ![Casilla de verificación para habilitar el soporte para el protocolo PROXY](/assets/images/enterprise/management-console/enable-proxy.png) -{% data reusables.enterprise_management_console.save-settings %} - -{% data reusables.enterprise_clustering.proxy_protocol_ports %} - -#### Habilitar soporte para X-Forwarded-For en {% data variables.product.product_location_enterprise %} - -{% data reusables.enterprise_clustering.x-forwarded-for %} - -{% data reusables.enterprise_installation.terminating-tls %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -3. Dentro de **External load balancers (Balanceadores de carga externos)**, selecciona **Allow HTTP X-Forwarded-For header (Permitir encabezados HTTP X-Forwarded-For)**. ![Casilla de verificación para permitir el encabezado de HTTP X-Forwarded-For](/assets/images/enterprise/management-console/allow-xff.png) -{% data reusables.enterprise_management_console.save-settings %} - -{% data reusables.enterprise_clustering.without_proxy_protocol_ports %} - -### Configurar la revisión de estado - -Las comprobaciones de estado permiten que un balanceador de carga deje de enviar tráfico a un nodo que no responde si una comprobación preconfigurada falla en ese nodo. Si el aparato está fuera de línea debido a un mantenimiento o una falla inesperada, el balanceador de carga puede mostrar una página de estado. En una configuración de alta disponibilidad (HA), un balanceador de carga puede usarse como parte de una estrategia de conmutación por error. Sin embargo, no está admitida la conmutación por error automática de los pares de HA. Debes impulsar de forma manual el aparato réplica antes de que comience con las consultas activas. Para obtener más información, consulta "[Configurar {% data variables.product.prodname_ghe_server %} para alta disponibilidad](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-github-enterprise-server-for-high-availability/)." - -{% data reusables.enterprise_clustering.health_checks %} -{% data reusables.enterprise_site_admin_settings.maintenance-mode-status %} diff --git a/translations/es-XL/content/admin/installation/validating-your-domain-settings.md b/translations/es-XL/content/admin/installation/validating-your-domain-settings.md deleted file mode 100644 index 8d80ab9ace03..000000000000 --- a/translations/es-XL/content/admin/installation/validating-your-domain-settings.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: Validar tus parámetros de dominio -intro: 'Asegúrate de que tus parámetros de dominio estén configurados adecuadamente antes de arrancar {% data variables.product.product_location_enterprise %} por primera vez.' -redirect_from: - - /enterprise/admin/installation/validating-your-domain-settings -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.hostname-menu-item %} -4. Para probar los parámetros DNS y SSL de tu aparato, haz clic en **Test domain settings (Pruebar parámetros de dominio)**. ![Probar botón de configuración de dominio](/assets/images/enterprise/management-console/test-domain-settings.png) -{% data reusables.enterprise_management_console.test-domain-settings-failure %} -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/es-XL/content/admin/installation/viewing-push-logs.md b/translations/es-XL/content/admin/installation/viewing-push-logs.md deleted file mode 100644 index 43ae444b4ee3..000000000000 --- a/translations/es-XL/content/admin/installation/viewing-push-logs.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: Ver registros de subidas -intro: 'Los administradores del sitio pueden ver una lista de operaciones de subida de Git para un repositorio en {% data variables.product.product_location_enterprise %}.' -redirect_from: - - /enterprise/admin/articles/viewing-push-logs/ - - /enterprise/admin/installation/viewing-push-logs -versions: - enterprise-server: '*' ---- - -Las entradas de registro de subida muestran: - -- Quién inició la subida -- Si fue un empuje forzado o no -- La rama a la que alguien subió -- El protocolo utilizado para subir -- La dirección IP inicial -- El cliente Git utilizado para subir -- Los hashes SHA de antes y después de la operación - -### Ver registros de subida de un repositorio - -1. Navegar a un repositorio. -{% data reusables.enterprise_site_admin_settings.access-settings %} -3. En la esquina superior derecha de la página, haz clic en {% octicon "shield" aria-label="The shield" %} **Security (Seguridad)**. ![Pestaña de seguridad](/assets/images/enterprise/site-admin-settings/repo/repo-security-top-tab.png) -4. En la barra lateral izquierda, haz clic en **Push Log (Registro de subida)**. ![Pestaña de registro de subida](/assets/images/enterprise/site-admin-settings/push-log-tab.png) - -### Ver registros de subida de un repositorio en la línea de comando - -1. SSH en tu aparato. Para obtener más información, consulta "[Acceder al shell administrativo (SSH)](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-administrative-shell-ssh/)." -2. En el repositorio Git adecuado, abre el archivo de registro de auditoría: - ```shell - ghe-repo owner/repository -c "less audit_log" - ``` diff --git a/translations/es-XL/content/admin/migrations/about-migrations.md b/translations/es-XL/content/admin/migrations/about-migrations.md deleted file mode 100644 index e0599480f6a6..000000000000 --- a/translations/es-XL/content/admin/migrations/about-migrations.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: Acerca de las migraciones -intro: 'Una migración es un proceso de transferencia de datos desde una ubicación *origen* (ya sea una organización {% data variables.product.prodname_dotcom_the_website %} o una instancia {% data variables.product.prodname_ghe_server %}) a una instancia *objetivo* {% data variables.product.prodname_ghe_server %}. Las migraciones se pueden utilizar para la transferencia de datos al cambiar de plataforma o actualizar el hardware en la instancia.' -redirect_from: - - /enterprise/admin/migrations/about-migrations -versions: - enterprise-server: '*' ---- - -### Tipos de migraciones - -Existen tres tipos de migraciones que se pueden realizar: - -- Una migración de una instancia {% data variables.product.prodname_ghe_server %} a otra instancia {% data variables.product.prodname_ghe_server %}. Puedes migrar la cantidad de repositorios que desees de cualquier usuario u organización en la instancia. Antes de hacer una migración, debes tener acceso de administrador del sitio en ambas instancias. -- Una migración de una organización {% data variables.product.prodname_dotcom_the_website %} a una instancia {% data variables.product.prodname_ghe_server %}. Puedes migrar la cantidad de repositorios de la organización que desees. Antes de efectuar una migración, debes tener [ acceso administrativo ](/enterprise/user/articles/permission-levels-for-an-organization/) a la organización {% data variables.product.prodname_dotcom_the_website %}, así como acceso de administrador del sitio a la instancia de destino. -- *Las ejecuciones de prueba *son migraciones que importan datos a una [instancia de preparación](/enterprise/admin/guides/installation/setting-up-a-staging-instance/). Estas pueden ser útiles para ver qué *sucedería* si se aplicara una migración {% data variables.product.product_location_enterprise %}. **Se recomienda encarecidamente que se lleve a cabo una ejecución de prueba en una instancia de preparación antes de importar datos a la instancia de producción.** - -### Datos migrados - -En una migración, todo gira en torno a un repositorio. La mayoría de los datos asociados con un repositorio se pueden migrar. Por ejemplo, un repositorio dentro de una organización migrará el repositorio *y* la organización, así como los usuarios, equipos, propuestas y solicitudes de extracción asociados con el repositorio. - -Los elementos de la tabla a continuación se pueden migrar con un repositorio. Los elementos que no se muestren en la lista de datos migrados no se pueden migrar. - -{% data reusables.enterprise_migrations.fork-persistence %} - -| Datos asociados con un repositorio migrado | Notas | -| --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Usuarios | Las **@menciones** de los usuarios se reescriben para coincidir con el objetivo. | -| Organizaciones | El nombre y los datos de una organización se migran. | -| Repositorios | Los enlaces a árboles Git, blobs, confirmaciones de cambios y líneas se reescriben para coincidir con el objetivo. El migrador sigue un máximo de tres redirecciones de repositorio. | -| Wikis | Todos los datos de la wiki se migran. | -| Equipos | Las **@menciones** de los equipos se reescriben para coincidir con el objetivo. | -| Hitos | Los registros horarios se conservan. | -| Tableros de proyecto | Los tableros de proyectos asociados con el repositorio y con la organización que posee el repositorio se migran. | -| Problemas | Las referencias de propuestas y los registros horarios se conservan. | -| Comentarios de propuestas | Las referencias cruzadas a los comentarios se reescriben para la instancia de destino. | -| Solicitudes de extracción | Las referencias cruzadas a las solicitudes de extracción se reescriben para coincidir con el objetivo. Los registros horarios se conservan. | -| Revisiones de solicitudes de extracción | Las revisiones de solicitudes de extracción y los datos asociados se migran. | -| Comentarios sobre revisiones de solicitudes de extracción | Las referencias cruzadas a los comentarios se reescriben para la instancia de destino. Los registros horarios se conservan. | -| Comentarios sobre confirmación de cambios | Las referencias cruzadas a los comentarios se reescriben para la instancia de destino. Los registros horarios se conservan. | -| Lanzamientos | Todos los datos de las versiones se migran. | -| Medidas adoptadas en las solicitudes de extracción o propuestas | Todas las modificaciones a las solicitudes de extracción o propuestas, como la asignación de usuarios, el cambio de nombre de título y la modificación de etiquetas se conservan, junto con los registros horarios de cada acción. | -| Archivos adjuntos | [Los archivos adjuntos a las propuestas y las solicitudes de extracción](/articles/file-attachments-on-issues-and-pull-requests) se migran. Puedes elegir inhabilitar esta opción como parte de la migración. | -| Webhooks | Solo se migran los webhooks activos. | -| Llaves de implementación de repositorios | Las llaves de implementación de repositorios se migran. | -| Ramas protegidas | La configuración de las ramas protegidas y los datos asociados se migran. | diff --git a/translations/es-XL/content/admin/migrations/applying-the-imported-data-on-github-enterprise-server.md b/translations/es-XL/content/admin/migrations/applying-the-imported-data-on-github-enterprise-server.md deleted file mode 100644 index dac5c01c6e28..000000000000 --- a/translations/es-XL/content/admin/migrations/applying-the-imported-data-on-github-enterprise-server.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Aplicar los datos importados en GitHub Enterprise Server -intro: 'Una vez finalizada la revisión de los datos de migración, puedes aplicar los cambios de forma permanente a tu instancia de destino.' -redirect_from: - - /enterprise/admin/guides/migrations/applying-the-imported-data-on-github-enterprise/ - - /enterprise/admin/migrations/applying-the-imported-data-on-github-enterprise-server -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_installation.ssh-into-target-instance %} - -2. Con el comando `ghe-migrator import`, inicia el proceso de importación. Necesitarás: - * Tu GUID de migración. - * Tu token de acceso personal para autenticación. El token de acceso personal que utilices es solo para autenticación como administrador de sitio, y no requiere ningún alcance específico. Para obtener más información, consulta la sección "[Crear un token de acceso personal](/github/authenticating-to-github/creating-a-personal-access-token)". - - ```shell - $ ghe-migrator import /home/admin/MIGRATION_GUID.tar.gz -g MIGRATION_GUID -u username -p TOKEN - - > Comenzando con GitHub::Migrador - > Importación 100 % completa / - ``` - - * {% data reusables.enterprise_migrations.specify-staging-path %} diff --git a/translations/es-XL/content/admin/migrations/completing-the-import-on-github-enterprise-server.md b/translations/es-XL/content/admin/migrations/completing-the-import-on-github-enterprise-server.md deleted file mode 100644 index 938fc3066586..000000000000 --- a/translations/es-XL/content/admin/migrations/completing-the-import-on-github-enterprise-server.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Completar la importación en GitHub Enterprise Server -intro: 'Una vez que se haya aplicado la migración a tu instancia de destino y hayas revisado la migración, desbloquearás los repositorios y los eliminarás del origen. Antes de eliminar los datos de origen, se recomienda esperar alrededor de dos semanas para asegurarse de que todo funciona de acuerdo con lo esperado.' -redirect_from: - - /enterprise/admin/guides/migrations/completing-the-import-on-github-enterprise/ - - /enterprise/admin/migrations/completing-the-import-on-github-enterprise-server -versions: - enterprise-server: '*' ---- - -### Desbloquear repositorios en la instancia de destino - -{% data reusables.enterprise_installation.ssh-into-instance %} -{% data reusables.enterprise_migrations.unlocking-on-instances %} - -### Desbloquear repositorios en el origen - -#### Desbloquear repositorios de una organización {% data variables.product.prodname_dotcom_the_website %} - -Para desbloquear los repositorios en una organización{% data variables.product.prodname_dotcom_the_website %}, debes enviar una solicitud de `DELETE` al punto final de desbloqueo de migración. Necesitarás: - * Tu token de acceso para autenticación - * El `id` único de la migración - * El nombre del repositorio a desbloquear -```shell -curl -H "Authorization: token GITHUB_ACCESS_TOKEN" -X DELETE \ - -H "Accept: application/vnd.github.wyandotte-preview+json" \ - https://api.github.com/orgs/orgname/migrations/id/repos/repo_name/lock -``` - -#### Eliminar repositorios de una organización {% data variables.product.prodname_dotcom_the_website %} - -Después de desbloquear los repositorios de la organización de {% data variables.product.prodname_dotcom_the_website %}, debes borrar todos los repositorios que migraste anteriormente utilizando [la terminal de borrado de repositorios](/enterprise/{{ currentVersion }}/v3/repos/#delete-a-repository). Necesitarás tu token de acceso para la autenticación: -```shell -curl -H "Authorization: token GITHUB_ACCESS_TOKEN" -X DELETE \ - https://api.github.com/repos/orgname/repo_name -``` - -#### Desbloquear repositorios desde una instancia de {% data variables.product.prodname_ghe_server %} - -{% data reusables.enterprise_installation.ssh-into-instance %} -{% data reusables.enterprise_migrations.unlocking-on-instances %} diff --git a/translations/es-XL/content/admin/migrations/exporting-migration-data-from-github-enterprise-server.md b/translations/es-XL/content/admin/migrations/exporting-migration-data-from-github-enterprise-server.md deleted file mode 100644 index 8a3feeab1743..000000000000 --- a/translations/es-XL/content/admin/migrations/exporting-migration-data-from-github-enterprise-server.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Exportar datos de migración desde GitHub Enterprise Server -intro: 'Para exportar datos de migración desde una instancia {% data variables.product.prodname_ghe_server %}, deberás preparar la instancia, bloquear los repositorios y generar un archivo de migración. Debes exportar datos de una instancia {% data variables.product.prodname_ghe_server %} si tienes planeado cambiar de plataforma o vas a pasar de una instancia de prueba a una instancia de producción.' -redirect_from: - - /enterprise/admin/guides/migrations/exporting-migration-data-from-github-enterprise/ - - /enterprise/admin/migrations/exporting-migration-data-from-github-enterprise-server -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/es-XL/content/admin/migrations/exporting-migration-data-from-githubcom.md b/translations/es-XL/content/admin/migrations/exporting-migration-data-from-githubcom.md deleted file mode 100644 index 44aea40ce698..000000000000 --- a/translations/es-XL/content/admin/migrations/exporting-migration-data-from-githubcom.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Exportar datos de migración desde GitHub.com -intro: 'Para exportar datos de migración de una organización {% data variables.product.prodname_dotcom_the_website %}, debes utilizar la API para seleccionar repositorios que vas a migrar. A continuación, se generará un archivo de migración que puedes importar en una instancia {% data variables.product.prodname_ghe_server %}.' -redirect_from: - - /enterprise/admin/guides/migrations/exporting-migration-data-from-github-com - - /enterprise/admin/migrations/exporting-migration-data-from-githubcom -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/es-XL/content/admin/migrations/exporting-the-github-enterprise-server-source-repositories.md b/translations/es-XL/content/admin/migrations/exporting-the-github-enterprise-server-source-repositories.md deleted file mode 100644 index 49d23a0d55a8..000000000000 --- a/translations/es-XL/content/admin/migrations/exporting-the-github-enterprise-server-source-repositories.md +++ /dev/null @@ -1,84 +0,0 @@ ---- -title: Exportar los repositorios de origen de GitHub Enterprise Server -intro: 'Después de bloquear los repositorios de origen, puedes exportarlos uno por uno, o en bloque, utilizando una lista de URL de repositorio en un archivo de texto. A continuación, generarás un archivo de migración único para el proceso de importación.' -redirect_from: - - /enterprise/admin/guides/migrations/exporting-the-github-enterprise-source-repositories/ - - /enterprise/admin/migrations/exporting-the-github-enterprise-server-source-repositories -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_migrations.locking-repositories %} - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. Para preparar un repositorio para la exportación, usa el comando `ghe-migrator add` con la URL del repositorio: - * Si estás bloqueando el repositorio, agrega el comando `--lock`. Si estás efectuando una ejecución de prueba, el comando `--lock` no es necesario. - ```shell - $ ghe-migrator add https://hostname/username/reponame --lock - ``` - * Puedes excluir archivos adjuntos agregando ` --exclude_attachments ` al comando. {% data reusables.enterprise_migrations.exclude-file-attachments %} - * Para preparar varios repositorios al mismo tiempo para exportación, crea un archivo de texto que incluya las URL del repositorio en una línea separada, y ejecuta el comando `ghe-migrator add` con el indicador `-i` y la ruta a tu archivo de texto. - ```shell - $ ghe-migrator add -i PATH/TO/YOUR/REPOSITORY_URLS.txt - ``` - -3. Cuando se te indique, ingresa tu nombre de usuario {% data variables.product.prodname_ghe_server %}: - ```shell - Ingresa el nombre de usuario autorizado para la migración: admin - ``` -4. Cuando se te pida un token de acceso personal, ingresa el token de acceso que creaste en"[Preparación de {% data variables.product.prodname_ghe_server %} la instancia de origen](/enterprise/admin/guides/migrations/preparing-the-github-enterprise-server-source-instance/)": - ```shell - Ingresa el token de acceso personal: ************** - ``` -5. Cuando `ghe-migrator add` haya terminado, imprimirá el "GUID de migración" único que generó para identificar esta exportación, así como una lista de los recursos que se agregaron a la exportación. Utilizarás el GUID de migración que generaste en los pasos posteriores `ghe-migrator add` y`ghe-migrator export` para indicar a `ghe-migrator` que continúe operando en la misma exportación. - ```shell - > 101 models added to export - > Migration GUID: example-migration-guid - > Number of records in this migration: - > users | 5 - > organizations | 1 - > repositories | 1 - > teams | 3 - > protected_branches | 1 - > pull_request_reviews | 1 - > milestones | 1 - > issues | 3 - > pull_requests | 5 - > pull_request_review_comments | 4 - > commit_comments | 2 - > issue_comments | 10 - > issue_events | 63 - > releases | 3 - > attachments | 4 - > projects | 2 - ``` - Cada vez que agregues un repositorio nuevo con un GUID de migración existente, se actualizará la exportación existente. Si ejecutas `ghe-migrator add` nuevamente sin un GUID de migración, comenzará una nueva exportación y generará un nuevo GUID de migración. **No vuelvas a utilizar el GUID de migración generado durante una exportación cuando comiences a preparar tu migración para importar**. - -3. Si bloqueaste el repositorio de origen, puedes usar el comando `ghe-migrator target_url` para configurar un mensaje de bloqueo personalizado en la página del repositorio que vincula con la nueva ubicación del repositorio. Pasa la URL del repositorio de origen, la URL del repositorio de destino y el GUID de migración del Paso 5: - - ```shell - $ ghe-migrator target_url https://hostname/username/reponame https://target_hostname/target_username/target_reponame -g MIGRATION_GUID - ``` - -6. Usa el comando `ghe-migrator add` con el indicador `-g` para agregar más repositorios a la misma exportación. Pasarás la nueva URL del repositorio y el GUID de migración del Paso 5: - ```shell - $ ghe-migrator add https://hostname/username/other_reponame -g MIGRATION_GUID --lock - ``` -7. Cuando hayas terminado de agregar repositorios, genera el archivo de migración con el comando `ghe-migrator export` con el indicador `-g` y el GUID de migración del Paso 5: - ```shell - $ ghe-migrator export -g MIGRATION_GUID - > Archivo guardado en: /data/github/current/tmp/MIGRATION_GUID.tar.gz - ``` - * {% data reusables.enterprise_migrations.specify-staging-path %} - -8. Cierra la conexión a {% data variables.product.product_location_enterprise %}: - ```shell - $ exit - > logout - > Connection to hostname closed. - ``` -9. Copia el archivo de migración a tu computadora con el comando [`scp`](https://linuxacademy.com/blog/linux/ssh-and-scp-howto-tips-tricks#scp). Se te asignará al archivo de almacenamiento un nombre con el GUID de migración: - ```shell - $ scp -P 122 admin@hostname:/data/github/current/tmp/MIGRATION_GUID.tar.gz ~/Desktop - ``` -{% data reusables.enterprise_migrations.ready-to-import-migrations %} diff --git a/translations/es-XL/content/admin/migrations/exporting-the-githubcom-organizations-repositories.md b/translations/es-XL/content/admin/migrations/exporting-the-githubcom-organizations-repositories.md deleted file mode 100644 index 847672abf807..000000000000 --- a/translations/es-XL/content/admin/migrations/exporting-the-githubcom-organizations-repositories.md +++ /dev/null @@ -1,70 +0,0 @@ ---- -title: Exportar los repositorios de la organización de GitHub.com -intro: 'Con la API de Migraciones, puedes exportar los repositorios de una organización. Una vez que hayas exportado tus repositorios, descarga el archivo de migración que se utiliza para el proceso de importación.' -redirect_from: - - /enterprise/admin/guides/migrations/exporting-the-github-com-organization-s-repositories - - /enterprise/admin/migrations/exporting-the-githubcom-organizations-repositories -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_migrations.fork-persistence %} - -Para exportar datos del repositorio desde {% data variables.product.prodname_dotcom_the_website %}, usa la API de Migraciones. - -La API de Migraciones se encuentra actualmente en un período de previsualización, lo que significa que los puntos finales y los parámetros pueden cambiar en el futuro. Para acceder a la API de Migraciones, debes proporcionar un [tipo de medio](/v3/media) personalizado en el encabezado `Accept` (Aceptar): `application/vnd.github.wyandotte-preview+json`. Los ejemplos a continuación incluyen el tipo de medio personalizado. - -### Generar un archivo de migración - -{% data reusables.enterprise_migrations.locking-repositories %} - -1. Notifica a los miembros de tu organización que harás una migración. La exportación puede durar varios minutos, en función de la cantidad de repositorios que se exporten. La migración completa, incluida la importación, puede durar varias horas. Por lo tanto, te recomendamos que hagas una prueba para determinar cuánto tiempo tomará el proceso completo. Para obtener más información, consulta "[Acerca de las migraciones](/enterprise/admin/migrations/about-migrations#types-of-migrations)". - -2. Inicia una migración mediante `POST` al punto final de migración. Necesitarás: - * Tu token de acceso para autenticación. - * Una [lista de los repositorios](/v3/repos/#list-organization-repositories) que deseas migrar: - ```shell - curl -H "Autorización: token GITHUB_ACCESS_TOKEN" -X POST \ - -H "Aceptar: application/vnd.github.wyandotte-preview+json" \ - -d'{"lock_repositories":true,"repositories":["orgname/reponame", "orgname/reponame"]}' \ - https://api.github.com/orgs/orgname/migrations - ``` - * Si deseas bloquear los repositorios antes de migrarlos, asegúrate de que `lock_repositories`esté establecido en `true` (true). Esto es altamente recomendable. - * Puedes excluir archivos adjuntos pasando `exclude_attachments: true` al punto final. {% data reusables.enterprise_migrations.exclude-file-attachments %} El tamaño final del archivo debe ser inferior a 20 GB. - - Esta solicitud devuelve un `id` único que representa tu migración. Lo necesitarás para solicitudes posteriores a la API de Migraciones. - -3. Envía una solicitud de `GET` al punto final del estado de la migración para extraer el estado de una migración. Necesitarás: - * Tu token de acceso para autenticación. - * El `id` único de la migración: - ```shell - curl -H "Autorización: token GITHUB_ACCESS_TOKEN" \ - -H "Aceptar: application/vnd.github.wyandotte-preview+json" \ - https://api.github.com/orgs/orgname/migrations/id - ``` - - Una migración puede estar en uno de los siguientes estados: - * `pending` (pendiente), lo que significa que la migración aún no se ha iniciado. - * `exporting` (exportando), lo que significa que la migración está en curso. - * `exported` (exportada), lo que significa que la migración finalizó correctamente. - * `failed` (fallida), lo que significa que la migración falló. - -4. Una vez que se haya exportado tu migración, descarga el archivo de migración enviando una solicitud de `GET` al punto final de descarga de migración. Necesitarás: - * Tu token de acceso para autenticación. - * El `id` único de la migración: - ```shell - curl -H "Aceptar: application/vnd.github.wyandotte-preview+json" \ - -u GITHUB_USERNAME:GITHUB_ACCESS_TOKEN \ - -L -o migration_archive.tar.gz \ - https://api.github.com/orgs/orgname/migrations/id/archive - ``` - -5. El archivo de migración se elimina automáticamente después de siete días. Si prefieres eliminarlo antes, puedes enviar una solicitud `DELETE` al punto final de eliminación del archivo de migración. Necesitarás: - * Tu token de acceso para autenticación. - * El `id` único de la migración: - ```shell - curl -H "Autorización: token GITHUB_ACCESS_TOKEN" -X DELETE \ - -H "Aceptar: application/vnd.github.wyandotte-preview+json" \ - https://api.github.com/orgs/orgname/migrations/id/archive - ``` -{% data reusables.enterprise_migrations.ready-to-import-migrations %} diff --git a/translations/es-XL/content/admin/migrations/generating-a-list-of-migration-conflicts.md b/translations/es-XL/content/admin/migrations/generating-a-list-of-migration-conflicts.md deleted file mode 100644 index 6f7eb2280c47..000000000000 --- a/translations/es-XL/content/admin/migrations/generating-a-list-of-migration-conflicts.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: Generar una lista de conflictos de migración -intro: 'Si `ghe-migrator` informa que hay conflictos en la preparación de los datos para importación, debes generar una lista de esos conflictos antes de prepararte para resolverlos con asignaciones personalizadas.' -redirect_from: - - /enterprise/admin/migrations/generating-a-list-of-migration-conflicts -versions: - enterprise-server: '*' ---- - -1. Con el comando `ghe-migrator conflicts` con el GUID de migración, genera un archivo *conflicts.csv*: - ```shell - $ ghe-migrator conflicts -g MIGRATION_GUID > conflicts.csv - ``` - - Si no se informa de ningún conflicto, puedes importar de forma segura los datos siguiendo los pasos en "[Aplicar los datos importados en {% data variables.product.prodname_ghe_server %}](/enterprise/admin/guides/migrations/applying-the-imported-data-on-github-enterprise-server/)". -2. Si hay conflictos, con el comando [`scp`](https://linuxacademy.com/blog/linux/ssh-and-scp-howto-tips-tricks#scp), copia *conflicts.csv* a tu computadora local: - ```shell - $ scp -P 122 admin@hostname:conflicts.csv ~/Desktop - ``` -3. Continúa con "[Resolver conflictos de migración o crear asignaciones personalizadas](/enterprise/admin/guides/migrations/resolving-migration-conflicts-or-setting-up-custom-mappings/)". diff --git a/translations/es-XL/content/admin/migrations/importing-data-from-third-party-version-control-systems.md b/translations/es-XL/content/admin/migrations/importing-data-from-third-party-version-control-systems.md deleted file mode 100644 index 67b04c47a162..000000000000 --- a/translations/es-XL/content/admin/migrations/importing-data-from-third-party-version-control-systems.md +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: Importar datos desde sistemas de control de versiones de terceros -intro: 'Usando el conjunto de herramientas git-import, puedes importar desde Subversion, Mercurial y Team Foundation Version Control a los repositorios Git en {% data variables.product.prodname_ghe_server %}.' -redirect_from: - - /enterprise/admin/migrations/importing-data-from-third-party-version-control-systems -versions: - enterprise-server: '*' ---- - -### Importar proyectos de Mercurial - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. Haz un clon sin procesar del proyecto mediante el comando a continuación, especificando la URL del proyecto de origen y una ruta a un repositorio temporal: - ```shell - $ git-import-hg-raw HG-CLONE-URL /PATH/REPO-NAME.git - # Crea un nuevo repositorio con uno o más ref de Git en "refs/import/" en la ruta especificada. - ``` -{% data reusables.enterprise_migrations.review-the-import-csv %} -4. Reescribe los autores y las ramas utilizando el archivo CSV: - ```shell - $ git-import-rewrite --flavor hg --authors /PATH/AUTHORS-MAP-FILE.csv /PATH/REPO-NAME.git - ``` -5. Si aún no lo has hecho, [ crea un nuevo repositorio vacío en {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/user/articles/creating-a-new-repository). -{% data reusables.command_line.switching_directories_procedural %} -7. Sube el repositorio importado a {% data variables.product.prodname_ghe_server %}: - ```shell - $ git push --mirror PUSH-URL-ON-GITHUB-ENTERPRISE - ``` - -### Importar proyectos de Subversion - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. Haz un clon sin procesar del proyecto mediante el comando a continuación, especificando la URL del proyecto de origen y una ruta a un repositorio temporal: - ```shell - $ git-import-svn-raw SVN-CLONE-URL /PATH/REPO-NAME.git - # Crea un nuevo repositorio con uno o más ref de Git en "refs/import/" en la ruta especificada. - ``` -{% data reusables.enterprise_migrations.review-the-import-csv %} -4. Reescribe los autores y las ramas utilizando el archivo CSV: - ```shell - $ git-import-rewrite --flavor svn --authors /PATH/AUTHORS-MAP-FILE.csv /PATH/REPO-NAME.git - ``` -5. Si aún no lo has hecho, [ crea un nuevo repositorio vacío en {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/user/articles/creating-a-new-repository). -{% data reusables.command_line.switching_directories_procedural %} -7. Sube el repositorio importado a {% data variables.product.prodname_ghe_server %}: - ```shell - $ git push --mirror PUSH-URL-ON-GITHUB-ENTERPRISE - ``` - -### Importar proyectos de Team Foundation Version Control - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. Haz un clon sin procesar del proyecto mediante el comando a continuación, especificando la URL del proyecto de origen y una ruta a un repositorio temporal: - ```shell - $ git-import-tfs-raw TEAM-FOUNDATION-CLONE-URL /PATH/REPO-NAME.git - # Crea un nuevo repositorio con uno o más ref de Git en "refs/import/" en la ruta especificada. - ``` -{% data reusables.enterprise_migrations.review-the-import-csv %} -4. Reescribe los autores y las ramas utilizando el archivo CSV: - ```shell - $ git-import-rewrite --flavor tfs --authors /PATH/AUTHORS-MAP-FILE.csv /PATH/REPO-NAME.git - ``` -5. Si aún no lo has hecho, [ crea un nuevo repositorio vacío en {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/user/articles/creating-a-new-repository). -{% data reusables.command_line.switching_directories_procedural %} -7. Sube el repositorio importado a {% data variables.product.prodname_ghe_server %}: - ```shell - $ git push --mirror PUSH-URL-ON-GITHUB-ENTERPRISE - ``` - -### Leer más - -- "[Command-line-utilities](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities/#import-and-export)" diff --git a/translations/es-XL/content/admin/migrations/importing-migration-data-to-github-enterprise-server.md b/translations/es-XL/content/admin/migrations/importing-migration-data-to-github-enterprise-server.md deleted file mode 100644 index 10d77f688e82..000000000000 --- a/translations/es-XL/content/admin/migrations/importing-migration-data-to-github-enterprise-server.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Importar datos de migración a GitHub Enterprise Server -intro: 'Después de generar un archivo de migración, puedes importar los datos a tu instancia de destino del {% data variables.product.prodname_ghe_server %}. Podrás revisar los cambios para detectar posibles conflictos antes de aplicar de manera permanente los cambios a tu instancia de destino.' -redirect_from: - - /enterprise/admin/guides/migrations/importing-migration-data-to-github-enterprise/ - - /enterprise/admin/migrations/importing-migration-data-to-github-enterprise-server -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/es-XL/content/admin/migrations/index.md b/translations/es-XL/content/admin/migrations/index.md deleted file mode 100644 index e26e5b82a5f6..000000000000 --- a/translations/es-XL/content/admin/migrations/index.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: 'Migrar datos de usuario, organización y repositorio' -shortTitle: Migrar datos -intro: 'Puedes exportar datos de usuario, organización y repositorio desde {% data variables.product.prodname_ghe_server %} o {% data variables.product.prodname_dotcom_the_website %}, y posteriormente importar los datos en {% data variables.product.product_location_enterprise %}.' -redirect_from: - - /enterprise/admin/articles/moving-a-repository-from-github-com-to-github-enterprise/ - - /enterprise/admin/categories/migrations-and-upgrades/ - - /enterprise/admin/migrations -versions: - enterprise-server: '*' ---- - - -### Índice - -{% topic_link_in_list /overview %} - {% link_in_list /about-migrations %} -{% topic_link_in_list /exporting-migration-data-from-github-enterprise-server %} - {% link_in_list /preparing-the-github-enterprise-server-source-instance %} - {% link_in_list /exporting-the-github-enterprise-server-source-repositories %} -{% topic_link_in_list /exporting-migration-data-from-githubcom %} - {% link_in_list /preparing-the-githubcom-source-organization %} - {% link_in_list /exporting-the-githubcom-organizations-repositories %} -{% topic_link_in_list /importing-migration-data-to-github-enterprise-server %} - {% link_in_list /preparing-the-migrated-data-for-import-to-github-enterprise-server %} - {% link_in_list /generating-a-list-of-migration-conflicts %} - {% link_in_list /reviewing-migration-conflicts %} - {% link_in_list /resolving-migration-conflicts-or-setting-up-custom-mappings %} - {% link_in_list /applying-the-imported-data-on-github-enterprise-server %} - {% link_in_list /reviewing-migration-data %} - {% link_in_list /completing-the-import-on-github-enterprise-server %} - {% link_in_list /importing-data-from-third-party-version-control-systems %} diff --git a/translations/es-XL/content/admin/migrations/overview.md b/translations/es-XL/content/admin/migrations/overview.md deleted file mode 100644 index ad6bd6f25d49..000000000000 --- a/translations/es-XL/content/admin/migrations/overview.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Información general -intro: 'Aprende como migrar datos a {% data variables.product.product_location_enterprise %}.' -mapTopic: verdadero -redirect_from: - - /enterprise/admin/migrations/overview -versions: - enterprise-server: '*' ---- - diff --git a/translations/es-XL/content/admin/migrations/preparing-the-github-enterprise-server-source-instance.md b/translations/es-XL/content/admin/migrations/preparing-the-github-enterprise-server-source-instance.md deleted file mode 100644 index 973e8f3e2d83..000000000000 --- a/translations/es-XL/content/admin/migrations/preparing-the-github-enterprise-server-source-instance.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: Preparar la instancia de origen de GitHub Enterprise Server -intro: 'Antes de migrar datos desde {% data variables.product.prodname_ghe_server %}, asegúrate de tener la autenticación y el acceso administrativo adecuados a la instancia.' -redirect_from: - - /enterprise/admin/guides/migrations/preparing-the-github-enterprise-source-instance/ - - /enterprise/admin/migrations/preparing-the-github-enterprise-server-source-instance -versions: - enterprise-server: '*' ---- - -1. Verifica que eres un administrador del sitio en el origen {% data variables.product.prodname_ghe_server %}. La mejor manera de hacerlo es verificar que puedes usar [SSH en la instancia](/enterprise/admin/guides/installation/accessing-the-administrative-shell-ssh/). - -2. {% data reusables.enterprise_migrations.token-generation %} en la instancia de origen {% data variables.product.prodname_ghe_server %}. - -{% data reusables.enterprise_migrations.make-a-list %} diff --git a/translations/es-XL/content/admin/migrations/preparing-the-githubcom-source-organization.md b/translations/es-XL/content/admin/migrations/preparing-the-githubcom-source-organization.md deleted file mode 100644 index 8780e019e475..000000000000 --- a/translations/es-XL/content/admin/migrations/preparing-the-githubcom-source-organization.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: Preparar la organización de origen de GitHub.com -intro: 'Antes de migrar los repositorios de una organización {% data variables.product.prodname_dotcom_the_website %}, asegúrate de tener la autenticación y el acceso administrativo adecuados.' -redirect_from: - - /enterprise/admin/guides/migrations/preparing-the-github-com-source-organization - - /enterprise/admin/migrations/preparing-the-githubcom-source-organization -versions: - enterprise-server: '*' ---- - -1. Asegúrate de tener [permisos de propietario](/articles/permission-levels-for-an-organization/) en los repositorios de la organización de origen. - -2. {% data reusables.enterprise_migrations.token-generation %} en {% data variables.product.prodname_dotcom_the_website %}. - -{% data reusables.enterprise_migrations.make-a-list %} diff --git a/translations/es-XL/content/admin/migrations/preparing-the-migrated-data-for-import-to-github-enterprise-server.md b/translations/es-XL/content/admin/migrations/preparing-the-migrated-data-for-import-to-github-enterprise-server.md deleted file mode 100644 index a02c0ae507c3..000000000000 --- a/translations/es-XL/content/admin/migrations/preparing-the-migrated-data-for-import-to-github-enterprise-server.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: Preparar los datos migrados para su importación a GitHub Enterprise Server -intro: 'Antes de aplicar los datos migrados a tu instancia de destino, deberás copiar el archivo de migración a tu instancia de destino y prepararlo para la importación.' -redirect_from: - - /enterprise/admin/guides/migrations/preparing-the-migrated-data-for-import-to-github-enterprise/ - - /enterprise/admin/migrations/preparing-the-migrated-data-for-import-to-github-enterprise-server -versions: - enterprise-server: '*' ---- - -1. Con el comando [`scp`](https://linuxacademy.com/blog/linux/ssh-and-scp-howto-tips-tricks#scp), copia el archivo de migración generado desde tu instancia u organización de origen a tu {% data variables.product.prodname_ghe_server %} destino: - - ```shell - $ scp -P 122 /path/to/archive/MIGRATION_GUID.tar.gz admin@hostname:/home/admin/ - ``` - -{% data reusables.enterprise_installation.ssh-into-target-instance %} - -3. Usa el comando `ghe-migrator prepare` para preparar el archivo para importar en la instancia de destino y generar un nuevo GUID de Migración para que uses en los pasos subsiguientes: - - ```shell - ghe-migrator prepare /home/admin/MIGRATION_GUID.tar.gz - ``` - - * Para comenzar un nuevo intento de importación, ejecuta `ghe-migrator prepare` nuevamente y obtén un nuevo GUID de migración. - * {% data reusables.enterprise_migrations.specify-staging-path %} diff --git a/translations/es-XL/content/admin/migrations/resolving-migration-conflicts-or-setting-up-custom-mappings.md b/translations/es-XL/content/admin/migrations/resolving-migration-conflicts-or-setting-up-custom-mappings.md deleted file mode 100644 index eb61af146568..000000000000 --- a/translations/es-XL/content/admin/migrations/resolving-migration-conflicts-or-setting-up-custom-mappings.md +++ /dev/null @@ -1,70 +0,0 @@ ---- -title: Resolver conflictos de migración o crear asignaciones personalizadas -intro: 'Antes de importar datos de migración, puedes efectuar correcciones para resolver conflictos, renombrar registros entrantes o asignar registros entrantes a registros existentes.' -redirect_from: - - /enterprise/admin/migrations/resolving-migration-conflicts-or-setting-up-custom-mappings -versions: - enterprise-server: '*' ---- - -Los pasos a continuación se pueden utilizar para resolver conflictos o agregar asignaciones personalizadas a tu migración. - -### Resolver conflictos - -Si crees que `ghe-migrator` realizará un cambio incorrecto, puedes hacer correcciones cambiando los datos en *conflicts.csv*. Puedes hacer cambios en cualquiera de las filas en *conflicts.csv*. - -Por ejemplo, supongamos que observas que el usuario `octocat` del origen se está asignando a `octocat` en el destino: - -| `model_name` | `source_url` | `target_url` | `recommended_action` | -| ------------ | ------------------------------------ | ----------------------------------- | -------------------- | -| `user` | `https://example-gh.source/octocatc` | `https://example-gh.target/octocat` | `map` | - -Puedes optar por asignar el usuario a un usuario diferente en el destino. Supongamos que sabes que `octocat` en realidad debe ser `monalisa` en el destino. Puedes cambiar la columna `target_url` en *conflicts.csv* a `monalisa`: - -| `model_name` | `source_url` | `target_url` | `recommended_action` | -| ------------ | ----------------------------------- | ------------------------------------ | -------------------- | -| `usuario` | `https://example-gh.source/octocat` | `https://example-gh.target/monalisa` | `map` | - -Como otro ejemplo, si deseas cambiar el nombre del repositorio `octo-org/widgets` a `octo-org/amazing-widgets` en la instancia de destino, cambia la `target_url` a `octo-org/amazing-widgets` y la `recommended_action` a `rename`: - -| `model_name` | `source_url` | `target_url` | `recommended_action` | -| ------------ | -------------------------------------------- | ---------------------------------------------------- | -------------------- | -| `repository` | `https://example-gh.source/octo-org/widgets` | `https://example-gh.target/octo-org/amazing-widgets` | `rename (renombrar)` | - -### Agregar asignaciones personalizadas - -Una situación común durante una migración es que los usuarios migrados tengan diferentes nombres de usuario en el destino que los que tienen en el origen. - -Dada una lista de nombres de usuario en el origen y una lista de nombres de usuario en el destino, puedes crear un archivo CSV con asignaciones personalizadas y luego aplicarlo para garantizar que el nombre de usuario y el contenido de cada usuario se atribuyan correctamente al final de la migración. - -Puedes generar rápidamente un CSV de usuarios que se migran en el formato CSV necesario para aplicar asignaciones personalizadas mediante el comando [`ghe-migrator audit`](/enterprise/admin/guides/migrations/reviewing-migration-data): - -```shell -$ ghe-migrator audit -m user -g MIGRATION_GUID > users.csv -``` - -Ahora, puedes editar ese CSV e ingresar la nueva URL para cada usuario que quieras asignar o renombrar, y luego actualizar la cuarta columna para `asignar` o `renombrar` según corresponda. - -Por ejemplo, para cambiar el nombre del usuario `octocat` a `monalisa` en el `https://example-gh.target` de destino, debes crear una fila con el siguiente contenido: - -| `model_name` | `source_url` | `url_destino` | `state` | -| ------------ | ----------------------------------- | ------------------------------------ | -------- | -| `usuario` | `https://example-gh.source/octocat` | `https://example-gh.target/monalisa` | `rename` | - -Se puede usar el mismo proceso para crear asignaciones para cada registro que admita asignaciones personalizadas. Para obtener más información, consulta [nuestra tabla sobre las posibles asignaciones de registro](/enterprise/admin/guides/migrations/reviewing-migration-conflicts#possible-mappings-for-each-record-type). - -### Aplicar datos de migración modificados - -1. Después de hacer cambios, usa el comando [`scp`](https://linuxacademy.com/blog/linux/ssh-and-scp-howto-tips-tricks#scp) para aplicar el *conflicts.csv* modificado (o cualquier otro csv de asignación en el formato correcto) a la instancia de destino: - - ```shell - $ scp -P 122 ~/Desktop/conflicts.csv admin@hostname:/home/admin/ - ``` - -2. Vuelve a asignar los datos de migración con el comando `ghe-migrator map`, pasando la ruta al archivo csv modificado y al GUID de migración: - - ```shell - $ ghe-migrator map -i conflicts.csv -g MIGRATION_GUID - ``` - -3. Si el comando `ghe-migrator map -i conflicts.csv -g MIGRATION_GUID` informa que aún existen conflictos, ejecuta nuevamente el proceso de resolución de conflictos de migración. diff --git a/translations/es-XL/content/admin/migrations/reviewing-migration-conflicts.md b/translations/es-XL/content/admin/migrations/reviewing-migration-conflicts.md deleted file mode 100644 index 8a7953bb81bc..000000000000 --- a/translations/es-XL/content/admin/migrations/reviewing-migration-conflicts.md +++ /dev/null @@ -1,43 +0,0 @@ ---- -title: Revisar conflictos de migración -intro: 'Después de generar una lista de conflictos de migración, debes revisarlos para asegurarte de que estás de acuerdo con las acciones predeterminadas que ''ghe-migrator` tomará cuando los resuelva.' -redirect_from: - - /enterprise/admin/migrations/reviewing-migration-conflicts -versions: - enterprise-server: '*' ---- - -1. Con un editor de texto o [ un software de hoja de cálculo compatible con CSV](https://en.wikipedia.org/wiki/Comma-separated_values#Application_support), abre *conflicts.csv*. -2. Con la guía de los ejemplos y las tablas de referencia a continuación, revisa el archivo *conflicts.csv* para asegurarte de que se tomarán las medidas adecuadas al importar. - -El archivo *conflicts.csv* contiene un *mapa de migración* de conflictos y acciones recomendadas. Un mapa de migración enumera tanto los datos que se migran desde el origen como la forma en que los datos se aplicarán al destino. - -| `model_name` | `source_url` | `target_url` | `recommended_action` | -| -------------- | ------------------------------------------------------ | ------------------------------------------------------ | -------------------- | -| `usuario` | `https://example-gh.source/octocatc` | `https://example-gh.target/octocat` | `map` | -| `organización` | `https://example-gh.source/octo-org` | `https://example-gh.target/octo-org` | `map` | -| `repositorio` | `https://example-gh.source/octo-org/widgets` | `https://example-gh.target/octo-org/widgets` | `rename (renombrar)` | -| `equipo` | `https://example-gh.source/orgs/octo-org/teams/admins` | `https://example-gh.target/orgs/octo-org/teams/admins` | `fusionar` | - -Cada fila de *conflicts.csv* proporciona la siguiente información: - -| Nombre | Descripción | -| -------------------- | -------------------------------------------------------------------- | -| `nombre_modelo` | El tipo de datos que se están cambiando. | -| `url_origen` | La URL fuente de los datos. | -| `url_destino` | La URL de destino esperada de los datos. | -| `recommended_action` | La acción preferida que tomará `ghe-migrator` al importar los datos. | - -### Asignaciones posibles para cada tipo de registro - -Hay varias acciones de asignación diferentes que `ghe-migrator` puede realizar al transferir datos: - -| `Acción` | Descripción | Modelos aplicables | -| --------------------- | -------------------------------------------------------------------------------------------- | -------------------------------------- | -| `importar` | (predeterminado) Los datos del origen se importan al destino. | Todos los tipos de registro | -| `map` | Los datos del origen se reemplazan por los datos existentes en el destino. | Usuarios, organizaciones, repositorios | -| `rename (renombrar)` | Los datos del origen se renombran y luego se copian en el destino. | Usuarios, organizaciones, repositorios | -| `asignar_o_renombrar` | Si el destino existe, asignar a ese destino. De lo contrario, renombrar el modelo importado. | Usuarios | -| `fusionar` | Los datos del origen se combinan con los datos existentes en el destino. | Equipos | - -**Recomendamos firmemente que revises el archivo *conflicts.csv* y uses [`ghe-migrator audit`](/enterprise/admin/guides/migrations/reviewing-migration-data) para asegurarte que se estén realizando las acciones correctas.** Si todo luce bien, puedes continuar a "[Aplicar los datos importados en {% data variables.product.prodname_ghe_server %}](/enterprise/admin/guides/migrations/applying-the-imported-data-on-github-enterprise-server)". diff --git a/translations/es-XL/content/admin/migrations/reviewing-migration-data.md b/translations/es-XL/content/admin/migrations/reviewing-migration-data.md deleted file mode 100644 index 921eb0780981..000000000000 --- a/translations/es-XL/content/admin/migrations/reviewing-migration-data.md +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: Revisar datos de migración -intro: 'Después de cada paso de una migración, puedes revisar el estado de los datos de migración. Podrás asegurarte de que los registros se asignen o renombren correctamente, obtener las nuevas url para los registros después del paso de importación, así como una lista de los registros que no se pudieron migrar.' -redirect_from: - - '/enterprise/{{ currentVersion }}/admin/guides/migrations/reviewing-the-imported-data/' - - /enterprise/admin/migrations/reviewing-migration-data -versions: - enterprise-server: '*' ---- - -De forma predeterminada, `ghe-migrator audit` devuelve todos los registros. También te permite filtrar los registros por: - - * Los tipos de registros. - * El estado de los registros. - -Los tipos de registro coinciden con los encontrados en los [datos migrados](/enterprise/admin/guides/migrations/about-migrations/#migrated-data). - -### Filtros de tipo de registro - -| Tipo de registro | Nombre del filtro | -| --------------------------------------------------------------- | --------------------------------------------------- | -| Usuarios | `usuario` | -| Organizaciones | `organización` | -| Repositorios | `repositorio` | -| Equipos | `equipo` | -| Hitos | `hito` | -| Tableros de proyecto | `project` | -| Problemas | `propuesta` | -| Comentarios de propuestas | `comentario_propuesta` | -| Solicitudes de extracción | `solicitud_extracción` | -| Revisiones de solicitudes de extracción | `revisión_solicitud de extracción` | -| Comentarios sobre confirmación de cambios | `comentario_confirmación de cambios` | -| Comentarios sobre revisiones de solicitudes de extracción | `comentarios _revisiones_solicitudes de extracción` | -| Lanzamientos | `lanzamiento` | -| Medidas adoptadas en las solicitudes de extracción o propuestas | `evento_propuesta` | -| Ramas protegidas | `rama_protegida` | - -### Filtros de estado de registro - -| Estado de registro | Descripción | -| --------------------- | ---------------------------------- | -| `exportar` | El registro se exportará. | -| `importar` | El registro se importará. | -| `asignar` | El registro se asignará. | -| `renombrar` | El registro se renombrará. | -| `fusionar` | El registro se fusionará. | -| `exportado` | El registro se exportó con éxito. | -| `importado` | El registro se importó con éxito. | -| `asignado` | El registro se asignó con éxito. | -| `renombrado` | El registro se renombró con éxito. | -| `fusionado` | El registro se fusionó con éxito. | -| `exportación_fallida` | El registro no se pudo exportar. | -| `importación_fallida` | El registro no se pudo importar. | -| `asignación_fallida` | El registro no se pudo asignar. | -| `renombrar_fallido` | El registro no se pudo renombrar. | -| `fusión_fallida` | El registro no se pudo fusionar. | - -### Filtrar registros auditados - -Con el comando de auditoría `ghe-migrator audit` puedes filtrar en función del tipo de registro mediante el indicador `-m`. Del mismo modo, puedes filtrar en el estado de importación mediante el indicador `-s`. El comando se ve de la siguiente manera: - -```shell -$ ghe-migrator audit -m RECORD_TYPE -s STATE -g MIGRATION_GUID -``` - -Por ejemplo, para ver cada organización y equipo importados con éxito, debes ingresar: -```shell -$ ghe-migrator audit -m organization,team -s mapped,renamed -g MIGRATION_GUID -> model_name,source_url,target_url,state -> organization,https://gh.source/octo-org/,https://ghe.target/octo-org/,renamed -``` - -**Te recomendamos encarecidamente que hagas una auditoría de todas las importaciones que fallaron.** Para ello, ingresa en: -```shell -$ ghe-migrator audit -s failed_import,failed_map,failed_rename,failed_merge -g MIGRATION_GUID -> model_name,source_url,target_url,state -> user,https://gh.source/octocat,https://gh.target/octocat,failed -> repository,https://gh.source/octo-org/octo-project,https://ghe.target/octo-org/octo-project,failed -``` - -Si tienes alguna duda sobre las importaciones fallidas, comunícate con {% data variables.contact.contact_ent_support %}. diff --git a/translations/es-XL/content/admin/user-management/about-global-webhooks.md b/translations/es-XL/content/admin/user-management/about-global-webhooks.md deleted file mode 100644 index 415371300586..000000000000 --- a/translations/es-XL/content/admin/user-management/about-global-webhooks.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: Acerca de los webhooks locales -intro: Los webhooks locales te notifican acerca de los eventos en el nivel de instancia. -redirect_from: - - /enterprise/admin/user-management/about-global-webhooks -versions: - enterprise-server: '*' ---- - -Puedes utilizar los webhooks globales para controlar, responder o aplicar reglas automáticamente para la administración de usuarios y de organizaciones en tu instancia. Por ejemplo, puedes configurar tus webhooks para ejecutar lo siguiente: -- Se crea o se elimina una cuenta de usuario. -- Se crea o se elimina una organización. -- Se agrega o se elimina un colaborador desde un repositorio. -- Se bifurca un repositorio. - -![Listado de webhooks globales](/assets/images/enterprise/site-admin-settings/list-of-global-webhooks.png) - -Para obtener más información acerca de la configuración de los webhooks, consultar "[Managing global webhooks](/enterprise/{{ currentVersion }}/admin/guides/user-management/managing-global-webhooks)." - -{% data reusables.enterprise_user_management.manage-global-webhooks-api %} diff --git a/translations/es-XL/content/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories.md b/translations/es-XL/content/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories.md deleted file mode 100644 index 403d7d3462b5..000000000000 --- a/translations/es-XL/content/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: Permitir a los administradores activar el acceso de lectura Git anónimo a los repositorios públicos -intro: 'Para simplificar el funcionamiento de las herramientas personalizadas en tu instancia y saltear los requisitos de autenticación, puedes permitir a los administradores de repositorio activar el acceso de lectura Git anónimo a los repositorios públicos en {% data variables.product.product_location_enterprise %}.' -redirect_from: - - /enterprise/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_user_management.disclaimer-for-git-read-access %} - -Si el modo privado está activado, puedes permitir a los administradores de repositorio activar el acceso de lectura Git anónimo a los repositorios públicos en {% data variables.product.product_location_enterprise %}. Para obtener más información acerca del modo privado, consulta "[Activar modo privado](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-private-mode/)." - -Permitir el acceso de lectura Git anónimo te da la posibilidad de saltear la autenticación para las herramientas personalizadas en tu instancia. Cuando tú o un administrador de repositorio activan esta configuración de acceso a un repositorio, las operaciones Git no autenticadas (y cualquiera con acceso de red a {% data variables.product.prodname_ghe_server %}) tendrán acceso de lectura al repositorio sin autenticación. - -También puedes evitar que los administradores de repositorios cambien la configuración de acceso Git anónimo para todos los repositorios o un repositorio específico en {% data variables.product.product_location_enterprise %}. Para obtener más información, consulta "[Evitar que los usuarios cambien el acceso de lectura anónimo de Git](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)." - -{% data reusables.enterprise_site_admin_settings.list-of-repos-with-anonymous-git-read-access-enabled %} - -{% data reusables.enterprise_user_management.exceptions-for-enabling-anonymous-git-read-access %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -4. En "Acceso de lectura Git anónimo", usa el menú desplegable y haz clic en **Activado**. ![Menú desplegable de acceso de lectura Git anónimo que muestra las opciones de menú "Habilitado" e "Inhabilitado"](/assets/images/enterprise/site-admin-settings/enable-anonymous-git-read-access.png) -3. Opcionalmente, para impedir que los administradores de repositorio modifiquen los parámetros de acceso de lectura Git anónimo en todos los repositorios en tu instancia, selecciona **Impedir que los administradores de repositorio modifiquen el acceso de lectura Git anónimo**. ![Selecciona la casilla de verificación para evitar que los administradores del repositorio cambien la configuración de acceso de lectura Git anónimo para todos los repositorios en tu instancia](/assets/images/enterprise/site-admin-settings/globally-lock-repos-from-changing-anonymous-git-read-access.png) - -### Activar el acceso de lectura Git anónimo para un repositorio específico - -{% data reusables.enterprise_user_management.exceptions-for-enabling-anonymous-git-read-access %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -6. En "Zona de peligro", al lado de "Activar el acceso de lectura Git anónimo", haz clic en **Activar**. ![Botón "Activado" en "Activar el acceso de lectura Git anónimo" en la zona de peligro de los parámetros de administración del sitio de un repositorio ](/assets/images/enterprise/site-admin-settings/site-admin-enable-anonymous-git-read-access.png) -7. Revisa los cambios. Para confirmar, haz clic en **Sí, habilitar el acceso de lectura Git anónimo.** ![Confirma la configuración de acceso de lectura Git anónimo en la ventana emergente](/assets/images/enterprise/site-admin-settings/confirm-anonymous-git-read-access-for-specific-repo-as-site-admin.png) -8. Opcionalmente, para impedir que los administradores de repositorio modifiquen estos parámetros para este repositorio, selecciona **Impedir que los administradores de repositorio modifiquen el acceso de lectura Git anónimo**. ![Selecciona la casilla de verificación para evitar que los administradores del repositorio cambien el acceso de lectura Git anónimo para este repositorio](/assets/images/enterprise/site-admin-settings/lock_anonymous_git_access_for_specific_repo.png) diff --git a/translations/es-XL/content/admin/user-management/allowing-built-in-authentication-for-users-outside-your-identity-provider.md b/translations/es-XL/content/admin/user-management/allowing-built-in-authentication-for-users-outside-your-identity-provider.md deleted file mode 100644 index 4bf1b3470bde..000000000000 --- a/translations/es-XL/content/admin/user-management/allowing-built-in-authentication-for-users-outside-your-identity-provider.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: Permitir autenticación integrada para usuarios fuera de tu proveedor de identidad -intro: 'Puedes configurar una autenticación integrada para autenticar usuarios que no tienen acceso a tu proveedor de identidad que usa LDAP, SAML o CAS.' -redirect_from: - - /enterprise/admin/user-management/allowing-built-in-authentication-for-users-outside-your-identity-provider -versions: - enterprise-server: '*' ---- - -### Acerca de la autenticación integrada para usuarios fuera de tu proveedor de identidad - -Puedes utilizar la autenticación integrada para usuarios externos cuando no puedes agregar cuentas específicas a tu proveedor de identidad (IdP), como cuentas para contratistas o usuarios de equipos. También puedes usar la autenticación integrada para acceder a una cuenta de reserva si el proveedor de identidad no está disponible. - -Una vez que se configura la autenticación integrada y un usuario autentica exitosamente con SAML o CAS, ya no tendrá la opción de autenticar con un nombre de usuario y una contraseña. Si un usuario autentica exitosamente con LDAP, las credenciales ya no se consideran internas. - -La autenticación integrada para un IdP se desactiva por defecto. - -{% warning %} - -**Advertencia:** Si desactivas la autenticación integrada, debes suspender individualmente a todo usuario que ya no debe tener acceso a la instancia. Para obtener más información, consulta [Suspender y anular suspensión de usuarios](/enterprise/{{ currentVersion }}/admin/guides/user-management/suspending-and-unsuspending-users)." - -{% endwarning %} - -### Configurar autenticación integrada para usuarios fuera de tu proveedor de identidad - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.authentication %} -4. Selecciona tu proveedor de identidad. ![Seleccionar la opción proveedor de identidad](/assets/images/enterprise/management-console/identity-provider-select.gif) -5. Selecciona **Permitir la creación de cuentas con autenticación integrada**. ![Seleccionar la opción autenticación integrada](/assets/images/enterprise/management-console/built-in-auth-identity-provider-select.png) -6. Lee la advertencia, luego haz clic en **Aceptar**. - -{% data reusables.enterprise_user_management.two_factor_auth_header %} -{% data reusables.enterprise_user_management.2fa_is_available %} - -### Invitar a usuarios fuera de tu proveedor de identidad a autenticar tu instancia - -Cuando un usuario acepta la invitación, puede utilizar su nombre de usuario y contraseña para iniciar sesión en lugar de iniciar sesión a través del IdP. - -{% data reusables.enterprise_site_admin_settings.sign-in %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.invite-user-sidebar-tab %} -{% data reusables.enterprise_site_admin_settings.invite-user-reset-link %} - -### Leer más - -- "[Usar LDAP](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap)" -- "[Usar SAML](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-saml)" -- "[Usar CAS](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-cas)" diff --git a/translations/es-XL/content/admin/user-management/archiving-and-unarchiving-repositories.md b/translations/es-XL/content/admin/user-management/archiving-and-unarchiving-repositories.md deleted file mode 100644 index 33ddb7e2a583..000000000000 --- a/translations/es-XL/content/admin/user-management/archiving-and-unarchiving-repositories.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: Archivar y desarchivar repositorios -intro: Como administrador del sitio puedes archivar o desarchivar un repositorio en el tablero de administrador del sitio. -redirect_from: - - /enterprise/admin/articles/archiving-and-unarchiving-repositories/ - - /enterprise/admin/user-management/archiving-and-unarchiving-repositories -versions: - enterprise-server: '*' ---- - -### Archivar un repositorio -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -5. En la Zona de peligro, haz clic en **Archivar**. ![Botón Archivar](/assets/images/enterprise/site-admin-settings/repo-archive.png) -6. Haz clic en **Archivar repositorio** ![Botón Archivar repositorio](/assets/images/enterprise/site-admin-settings/repo-archive-confirm.png) - -### Desarchivar un repositorio -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -5. En la Zona de peligro, haz clic en **Desarchivar**. ![Botón Archivar](/assets/images/enterprise/site-admin-settings/repo-unarchive.png) -6. Haz clic en **Desarchivar repositorio**. ![Botón Archivar repositorio](/assets/images/enterprise/site-admin-settings/repo-unarchive-confirm.png) - -### Leer más -- "[Acerca de archivar repositorios](/enterprise/{{ currentVersion }}/user/articles/about-archiving-repositories)" diff --git a/translations/es-XL/content/admin/user-management/authenticating-users-for-your-github-enterprise-server-instance.md b/translations/es-XL/content/admin/user-management/authenticating-users-for-your-github-enterprise-server-instance.md deleted file mode 100644 index acf87e4bc983..000000000000 --- a/translations/es-XL/content/admin/user-management/authenticating-users-for-your-github-enterprise-server-instance.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: Autenticar usuarios para tu instancia de servidor de GitHub Enterprise -intro: 'Puedes usar la autenticación integrada de {% data variables.product.prodname_ghe_server %} o elegir entre CAS, LDAP o SAML para integrar tus cuentas existentes y administrar centralmente el acceso de usuarios para {% data variables.product.product_location_enterprise %}.' -redirect_from: - - /enterprise/admin/categories/authentication/ - - /enterprise/admin/guides/installation/user-authentication/ - - /enterprise/admin/articles/inviting-users/ - - /enterprise/admin/guides/migrations/authenticating-users-for-your-github-enterprise-instance/ - - /enterprise/admin/user-management/authenticating-users-for-your-github-enterprise-server-instance -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/es-XL/content/admin/user-management/basic-account-settings.md b/translations/es-XL/content/admin/user-management/basic-account-settings.md deleted file mode 100644 index f9af3adabcdf..000000000000 --- a/translations/es-XL/content/admin/user-management/basic-account-settings.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Parámetros básicos de cuenta -intro: 'Una vez que los usuarios pueden autenticar para {% data variables.product.product_location_enterprise %}, querrán configurar algunos parámetros de perfil personalizados básicos como un avatar y notificaciones por correo electrónico.' -redirect_from: - - /enterprise/admin/guides/user-management/enabling-avatars-and-identicons/ - - /enterprise/admin/user-management/basic-account-settings -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/es-XL/content/admin/user-management/changing-authentication-methods.md b/translations/es-XL/content/admin/user-management/changing-authentication-methods.md deleted file mode 100644 index a49f5e3d971b..000000000000 --- a/translations/es-XL/content/admin/user-management/changing-authentication-methods.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: Modificar los métodos de autenticación -intro: 'Puedes modificar la manera en que {% data variables.product.prodname_ghe_server %} se autentica con tus cuentas existentes en cualquier momento.' -redirect_from: - - /enterprise/admin/user-management/changing-authentication-methods -versions: - enterprise-server: '*' ---- - -Cuando modificas el método de autenticación, las cuentas de usuario en {% data variables.product.product_location_enterprise %} se conservan y los usuarios seguirán iniciando sesión en la misma cuenta siempre que su nombre de usuario no cambie. - -Si el nuevo método de autenticación modifica los nombres de usuario, se crearán nuevas cuentas. Como administrador, puedes renombrar usuarios a través de los ajustes de administrador del sitio o utilizando [la API de Administración de Usuarios](/enterprise/{{currentVersion}}/v3/enterprise-admin/users/#rename-an-existing-user). - -Otras cuestiones que deberías tener en cuenta son las siguientes: - -* **Contraseñas:** Si comienzas a usar la autenticación integrada para tu instancia, los usuarios deben [configurar una contraseña](/enterprise/user/articles/how-can-i-reset-my-password/) una vez completado el cambio. - -* **Administradores del sitio:** Los privilegios administrativos son [controlados por tu proveedor de identidad cuando usas SAML](/enterprise/admin/guides/user-management/using-saml/#saml-attributes) y pueden ser [controlados por los miembros del grupo cuando usas LDAP](/enterprise/admin/guides/user-management/using-ldap/#configuring-ldap-with-your-github-enterprise-server-instance). - -* **Miembros del equipo:** Solo LDAP te permite [controlar los miembros del equipo](/enterprise/admin/guides/user-management/using-ldap/#configuring-ldap-with-your-github-enterprise-server-instance) desde tu servidor de directorios. - -* **Suspensión de usuario:** cuando usas LDAP para autenticar, se puede controlar el acceso al {% data variables.product.prodname_ghe_server %} mediante _grupos restringidos_. Después de cambiar a LDAP, si se configuran grupos restringidos, los usuarios existentes que no estén en uno de esos grupos serán suspendidos. La suspensión ocurrirá cuando inicien sesión o durante la siguiente sincronización LDAP. - -* **Miembros del grupo:** Cuando usas LDAP para autenticar, [se suspende y se anula la suspensión](/enterprise/admin/guides/user-management/suspending-and-unsuspending-users) de los usuarios automáticamente, en función de los miembros del grupo con restricciones y los estados de cuenta con Active Directory. - -* **Autenticación Git:** SAML y CAS solo admiten la autenticación Git a través de HTTP o HTTPS usando un [token de acceso personal](/articles/creating-an-access-token-for-command-line-use). No se admite la autenticación de contraseña a través de HTTP o HTTPS. LDAP admite la autenticación Git basada en contraseña por defecto, pero te recomendamos [desactivar ese método](/enterprise/admin/guides/user-management/using-ldap/#disabling-password-authentication-for-git-operations) y forzar la autenticación mediante un token de acceso personal o clave SSH. - -* **Autenticación de API:** SAML y CAS solo admiten la autenticación de API usando un [token de acceso personal](/articles/creating-an-access-token-for-command-line-use). No se admite la autenticación básica. - -* **Autenticación de dos factores:** {% data reusables.enterprise_user_management.external_auth_disables_2fa %} - -* **Autenticación integrada para usuarios fuera de tu proveedor de identidad:** Puedes invitar usuarios a autenticar {% data variables.product.product_location_enterprise %} sin agregarlos a tu proveedor de identidad. Para obtener más información, consulta "[Permitir autenticación integrada para usuarios fuera de tu proveedor de identidad](/enterprise/{{ currentVersion }}/admin/guides/user-management/allowing-built-in-authentication-for-users-outside-your-identity-provider)". diff --git a/translations/es-XL/content/admin/user-management/disabling-unauthenticated-sign-ups.md b/translations/es-XL/content/admin/user-management/disabling-unauthenticated-sign-ups.md deleted file mode 100644 index 4b5361a67726..000000000000 --- a/translations/es-XL/content/admin/user-management/disabling-unauthenticated-sign-ups.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: Desactivar los registros no autenticados -redirect_from: - - /enterprise/admin/articles/disabling-sign-ups/ - - /enterprise/admin/user-management/disabling-unauthenticated-sign-ups -intro: 'Si usas la autenticación integrada, puedes impedir que las personas no autenticadas puedan crear una cuenta.' -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -3. Quita la marca de selección en **Activar registro**. ![Habilitar casilla de registro](/assets/images/enterprise/management-console/enable-sign-up.png) -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/es-XL/content/admin/user-management/organizations-and-teams.md b/translations/es-XL/content/admin/user-management/organizations-and-teams.md deleted file mode 100644 index aca44acc45ac..000000000000 --- a/translations/es-XL/content/admin/user-management/organizations-and-teams.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: Organizaciones y equipos -redirect_from: - - /enterprise/admin/articles/adding-users-and-teams/ - - /enterprise/admin/categories/admin-bootcamp/ - - /enterprise/admin/user-management/organizations-and-teams -intro: 'Las organizaciones son ideales para crear grupos diferentes de usuarios dentro de tu empresa, como divisiones o grupos trabajando en proyectos similares. Los repositorios públicos que pertenecen a una organización son accesibles para los usuarios de otras organizaciones, mientras que los repositorios privados son inaccesibles para cualquiera, salvo para los miembros de la organización.' -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/es-XL/content/admin/user-management/preventing-users-from-changing-a-repositorys-visibility.md b/translations/es-XL/content/admin/user-management/preventing-users-from-changing-a-repositorys-visibility.md deleted file mode 100644 index 68e0a5c21dba..000000000000 --- a/translations/es-XL/content/admin/user-management/preventing-users-from-changing-a-repositorys-visibility.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: Impedir que los usuarios modifiquen la visibilidad de un repositorio -intro: 'Puedes hacer que los miembros no puedan modificar la visibilidad de los repositorios que son propiedad de la organización en tu aparato {% data variables.product.prodname_ghe_server %}.' -redirect_from: - - /enterprise/admin/guides/user-management/preventing-users-from-changing-a-repository-s-visibility - - /enterprise/admin/user-management/preventing-users-from-changing-a-repositorys-visibility -versions: - enterprise-server: '*' ---- - -Cuando impides que los miembros modifiquen la visibilidad del repositorio, solo los administradores del sitio tienen la capacidad de convertir los repositorios públicos en privado o los repositorios privados en públicos. - -Si un administrador del sitio ha restringido la creación del repositorio solo a los propietarios de la organización, entonces los miembros no podrán modificar la visibilidad del repositorio. Si un administrador del sitio ha restringido la creación del repositorio del miembro solo a los repositorios privados, entonces los miembros solo podrán modificar los repositorios de público a privado. Para obtener más información, consulta "[Restringir la creación de repositorios en tu instancia](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)." - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.policies-tab %} -{% data reusables.enterprise-accounts.repositories-tab %} -5. En "Modificar visibilidad del repositorio", revisa la información sobre cómo modificar los parámetros. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} - -{% data reusables.enterprise-accounts.repository-visibility-policy %} diff --git a/translations/es-XL/content/admin/user-management/preventing-users-from-changing-anonymous-git-read-access.md b/translations/es-XL/content/admin/user-management/preventing-users-from-changing-anonymous-git-read-access.md deleted file mode 100644 index 56982a8f84e7..000000000000 --- a/translations/es-XL/content/admin/user-management/preventing-users-from-changing-anonymous-git-read-access.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Impedir que los usuarios modifiquen el acceso de lectura Git anónimo -intro: 'Puedes hacer que los administradores de repositorio no modifiquen el acceso de lectura Git anónimo a un repositorio {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} o a todos los repositorios{% endif %}.' -redirect_from: - - /enterprise/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access-to-a-repository/ - - /enterprise/admin/user-management/preventing-users-from-changing-anonymous-git-read-access -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_user_management.disclaimer-for-git-read-access %} - -Para hacer que los administradores de repositorio no puedan modificar los parámetros de acceso de lectura Git anónimo para un repositorio específico, puedes bloquear los parámetros de acceso del repositorio. Una vez que bloqueas los parámetros de acceso de lectura Git de un repositorio, solo un administrador del sitio puede modificar los parámetros. - -El administrador de un repositorio puede modificar el acceso de lectura Git anónimo para un repositorio público si no es una bifurcación. Para obtener más información, consulta "[Permitir que los administradores habiliten el acceso de lectura anónimo de Git para los repositorios públicos](/enterprise/{{ currentVersion }}/admin/guides/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories)." - -{% data reusables.enterprise_site_admin_settings.list-of-repos-with-anonymous-git-read-access-enabled %} - -### Impedir que los usuarios modifiquen el acceso de lectura Git anónimo para un repositorio - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -6. En "Zona de peligro", selecciona **Impedir que los administradores de repositorio activen el acceso de lectura Git anónimo**. ![Seleccionar la casilla de verificación para que el repositorio no pueda modificar los parámetros de acceso de lectura Git anónimo](/assets/images/enterprise/site-admin-settings/lock-repo-from-changing-anonymous-git-read-access.png) - -### Impedir que los usuarios modifiquen el acceso de lectura Git anónimo para todos los repositorios - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -3. En "Acceso de lectura Git anónimo", confirma que los parámetros estén activados, luego selecciona **Impedir que los administradores de repositorio modifiquen el acceso de lectura Git anónimo**. ![Seleccionar la casilla de verificación para que el repositorio no pueda modificar globalmente los parámetros de acceso de lectura Git anónimo](/assets/images/enterprise/site-admin-settings/globally-lock-repos-from-changing-anonymous-git-read-access.png) - diff --git a/translations/es-XL/content/admin/user-management/preventing-users-from-deleting-organization-repositories.md b/translations/es-XL/content/admin/user-management/preventing-users-from-deleting-organization-repositories.md deleted file mode 100644 index 6091ea759b88..000000000000 --- a/translations/es-XL/content/admin/user-management/preventing-users-from-deleting-organization-repositories.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: Impedir que los usuarios eliminen los repositorios de una organización -intro: 'Puedes hacer que los miembros no puedan eliminar ni transferir repositorios en organizaciones en tu aparato {% data variables.product.prodname_ghe_server %}.' -redirect_from: - - /enterprise/admin/user-management/preventing-users-from-deleting-organization-repositories -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.policies-tab %} -{% data reusables.enterprise-accounts.repositories-tab %} -5. En "Transferencia y eliminación de repositorios", revisa la información sobre cómo modificar los parámetros. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} - -{% data reusables.enterprise-accounts.repository-deletion-policy %} diff --git a/translations/es-XL/content/admin/user-management/repositories.md b/translations/es-XL/content/admin/user-management/repositories.md deleted file mode 100644 index 98669718b260..000000000000 --- a/translations/es-XL/content/admin/user-management/repositories.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Repositorios -intro: 'Puedes administrar los parámetros disponibles para los administradores de repositorios en tu aparato {% data variables.product.prodname_ghe_server %}.' -mapTopic: true -redirect_from: - - /enterprise/admin/user-management/repositories -versions: - enterprise-server: '*' ---- - diff --git a/translations/es-XL/content/admin/user-management/restricting-repository-creation-in-your-instance.md b/translations/es-XL/content/admin/user-management/restricting-repository-creation-in-your-instance.md deleted file mode 100644 index 764971d5a680..000000000000 --- a/translations/es-XL/content/admin/user-management/restricting-repository-creation-in-your-instance.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: Restringir la creación de repositorios en tu instancia -intro: 'Puedes elegir qué miembros de tu organización en tu aplicativo de {% data variables.product.prodname_ghe_server %} pueden crear repositorios y de qué tipo.' -redirect_from: - - /enterprise/admin/user-management/restricting-repository-creation-in-your-instance -versions: - enterprise-server: '*' ---- - -{% data reusables.organizations.repo-creation-constants %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.policies-tab %} -{% data reusables.enterprise-accounts.repositories-tab %} -5. En "Creación de repositorio", revisa la información sobre cómo modificar los parámetros. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} -{% if currentVersion ver_gt "enterprise-server@2.19" %} -{% data reusables.enterprise-accounts.repo-creation-policy %} -{% data reusables.enterprise-accounts.repo-creation-types %} -{% else %} -6. En "Creación de repositorios", usa el menú desplegable y elige una política. ![Menú desplegable con políticas para creación de repositorio](/assets/images/enterprise/site-admin-settings/repository-creation-drop-down.png) -{% endif %} diff --git a/translations/es-XL/content/admin/user-management/user-security.md b/translations/es-XL/content/admin/user-management/user-security.md deleted file mode 100644 index 359e61ffbdfe..000000000000 --- a/translations/es-XL/content/admin/user-management/user-security.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Seguridad del usuario -intro: 'Asegúrate de que tus usuarios {% data variables.product.prodname_ghe_server %} estén seguros. Puedes auditar sus parámetros de seguridad o implementar las mejores prácticas a través de tu instancia.' -mapTopic: true -redirect_from: - - /enterprise/admin/user-management/user-security -versions: - enterprise-server: '*' ---- - diff --git a/translations/es-XL/content/admin/user-management/using-built-in-authentication.md b/translations/es-XL/content/admin/user-management/using-built-in-authentication.md deleted file mode 100644 index 569ee1dc46cc..000000000000 --- a/translations/es-XL/content/admin/user-management/using-built-in-authentication.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: Usar la autenticación integrada -intro: 'Cuando usas el método de autenticación predeterminado, todos los detalles de autenticación se almacenan dentro de {% data variables.product.product_location_enterprise %}. La autenticación integrada es el método predeterminado, si ya no tienes un proveedor de autenticación establecido, como LDAP, SAML o CAS.' -redirect_from: - - /enterprise/admin/user-management/using-built-in-authentication -versions: - enterprise-server: '*' ---- - -Puedes crear mensajes personalizados que los usuarios verán en las páginas de inicio de sesión y de cierre de sesión. Para obtener más información, consulta "[Personalizar mensajes de usuario en tu instancia](/enterprise/admin/user-management/customizing-user-messages-on-your-instance)." - -### Configurar la autenticación integrada - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.authentication %} -4. Selecciona **Autenticación integrada**. ![Seleccionar la opción autenticación integrada](/assets/images/enterprise/management-console/built-in-auth-select.png) - -{% data reusables.enterprise_user_management.two_factor_auth_header %} -{% data reusables.enterprise_user_management.2fa_is_available %} - -### Crear tu cuenta y agregar usuarios - -Una vez que se ha creado tu instancia, necesitarás crear tu propia cuenta de administrador y usarla para aprovisionar usuarios. - -1. En la página "Crear cuenta de administrador " en `http(s)://[hostname]/join`, elige tu nombre de usuario, contraseña y dirección de correo electrónico, luego haz clic en **Crear una cuenta**. ![Crear cuenta de administrador](/assets/images/enterprise/site-admin-settings/create-first-admin-acct.png) -{% data reusables.enterprise_site_admin_settings.sign-in %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.invite-user-sidebar-tab %} -{% data reusables.enterprise_site_admin_settings.invite-user-reset-link %} diff --git a/translations/es-XL/content/admin/user-management/using-cas.md b/translations/es-XL/content/admin/user-management/using-cas.md deleted file mode 100644 index e1da41cf36c8..000000000000 --- a/translations/es-XL/content/admin/user-management/using-cas.md +++ /dev/null @@ -1,43 +0,0 @@ ---- -title: Usar CAS -redirect_from: - - /enterprise/admin/articles/configuring-cas-authentication/ - - /enterprise/admin/articles/about-cas-authentication/ - - /enterprise/admin/user-management/using-cas -intro: 'CAS es un protocolo de inicio de sesión único (SSO) para varias aplicaciones web. Una cuenta de usuario CAS no usa un {% if currentVersion ver_gt "enterprise-server@2.16" %}asiento{% else %}de licencia de usuario{% endif %} hasta que el usuario inicia sesión.' -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_user_management.built-in-authentication %} - -### Consideraciones sobre el nombre de usuario con CAS - -{% data reusables.enterprise_management_console.username_normalization %} - -{% data reusables.enterprise_management_console.username_normalization_sample %} - -{% data reusables.enterprise_user_management.two_factor_auth_header %} -{% data reusables.enterprise_user_management.external_auth_disables_2fa %} - -### Atributos de CAS - -Están disponibles los siguientes atributos. - -| Nombre del atributo | Tipo | Descripción | -| ------------------- | --------- | ----------------------------------------------------------------------------- | -| `nombre de usuario` | Requerido | El nombre de usuario {% data variables.product.prodname_ghe_server %}. | - -### Configurar CAS -{% warning %} - -**Advertencia:** Antes de configurar CAS en {% data variables.product.product_location_enterprise %}, ten en cuenta que los usuarios no podrán usar sus nombres de usuario ni contraseñas CAS para autenticar las solicitudes de API o las operaciones Git a través de HTTP/HTTPS. En cambio, será necesario que [creen un token de acceso](/enterprise/{{ currentVersion }}/user/articles/creating-an-access-token-for-command-line-use). - -{% endwarning %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.authentication %} -3. Selecciona **CAS**. ![Seleccionar CAS](/assets/images/enterprise/management-console/cas-select.png) -4. {% data reusables.enterprise_user_management.built-in-authentication-option %} ![Seleccionar la casilla de verificación autenticación integrada](/assets/images/enterprise/management-console/cas-built-in-authentication.png) -5. En el campo **URL del servidor**, escribe la URL completa de tu servidor CAS. Si tu servidor CAS usa un certificado que no puede ser validado por {% data variables.product.prodname_ghe_server %}, puedes usar el comando `ghe-ssl-ca-certificate-install` para instalarlo como un certificado de confianza. diff --git a/translations/es-XL/content/admin/user-management/using-ldap.md b/translations/es-XL/content/admin/user-management/using-ldap.md deleted file mode 100644 index df36b244f79f..000000000000 --- a/translations/es-XL/content/admin/user-management/using-ldap.md +++ /dev/null @@ -1,190 +0,0 @@ ---- -title: Usar LDAP -redirect_from: - - /enterprise/admin/articles/configuring-ldap-authentication/ - - /enterprise/admin/articles/about-ldap-authentication/ - - /enterprise/admin/articles/viewing-ldap-users/ - - /enterprise/admin/hidden/enabling-ldap-sync/ - - /enterprise/admin/hidden/ldap-sync/ - - /enterprise/admin/user-management/using-ldap -intro: 'LDAP te permite autenticar el {% data variables.product.prodname_ghe_server %} en tus cuentas existentes y administrar de manera centralizada el acceso a los repositorios. LDAP es un protocolo de aplicación popular para acceder a servicios de información de directorios y mantenerlos, y uno de los protocolos más comunes que se usan para integrar software de terceros con directorios de usuarios de empresas grandes.' -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_user_management.built-in-authentication %} - -### Servicios LDAP admitidos - -El {% data variables.product.prodname_ghe_server %} se integra con los siguientes servicios LDAP: - -* Active Directory -* FreeIPA -* Oracle Directory Server Enterprise Edition -* OpenLDAP -* Open Directory -* 389-ds - -### Consideraciones sobre el nombre de usuario con LDAP - -{% data reusables.enterprise_management_console.username_normalization %} - -{% data reusables.enterprise_management_console.username_normalization_sample %} - -{% data reusables.enterprise_user_management.two_factor_auth_header %} -{% data reusables.enterprise_user_management.2fa_is_available %} - -### Configurar LDAP con {% data variables.product.product_location_enterprise %} - -Una vez configurado LDAP, los usuarios podrán iniciar sesión en tu instancia con sus credenciales LDAP. Cuando los usuarios inician sesión por primera vez, sus nombres de perfil, direcciones de correo electrónico y claves SSH se establecen con los atributos de LDAP desde tu directorio. - -Cuando configuras el acceso de LDAP para los usuarios a través de {% data variables.enterprise.management_console %}, tus licencias de usuario no se utilizarán sino hasta que los usuarios ingresen en tu instancia por primera vez. Sin embargo, si creas una cuenta manualmente utilizando la configuración de administrador para el sitio, esta licencia de usuario se tomará en cuenta. - -{% warning %} - -**Advertencia:** Antes de configurar LDAP en {% data variables.product.product_location_enterprise %}, asegúrate de que tu servicio LDAP admita resultados paginados. - -{% endwarning %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.authentication %} -3. En "Authentication" (Autenticación), selecciona **LDAP**. ![Seleccionar LDAP](/assets/images/enterprise/management-console/ldap-select.png) -4. {% data reusables.enterprise_user_management.built-in-authentication-option %} ![Seleccionar la casilla de verificación autenticación integrada LDAP](/assets/images/enterprise/management-console/ldap-built-in-authentication.png) -5. Agrega tus parámetros de configuración. - -### Atributos de LDAP -Usa estos atributos para terminar de configurar LDAP para {% data variables.product.product_location_enterprise %}. - -| Nombre del atributo | Tipo | Descripción | -| --------------------------------------------------------------------------------------------------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `Host` | Requerido | El host LDAP, p. ej. `ldap.example.com` o `10.0.0.30`. Si el nombre del host solo está disponible desde tu red interna, es posible que primero debas configurar el DNS de {% data variables.product.product_location_enterprise %} para que pueda resolver el nombre del host usando tus servidores de nombres internos. | -| `Port (Puerto)` | Requerido | El puerto que están escuchando los servicios LDAP. Los ejemplos incluyen: 389 y 636 (para LDAPS). | -| `Encryption (Cifrado)` | Requerido | El método de cifrado usado para garantizar las comunicaciones con el servidor LDAP. Los ejemplos incluyen el normal (sin cifrado), el SSL/LDAPS (cifrado desde el principio) y el StartTLS (se actualiza a comunicación cifrada una vez que se conecta). | -| `Domain search user (Usuario de búsqueda de dominio)` | Opcional | El usuario LDAP que realiza las búsquedas de usuario para autenticar otros usuarios cuando inician sesión. Esto suele ser una cuenta de servicio creada específicamente para integraciones de terceros. Usa un nombre certificado completo, como `cn=Administrator,cn=Users,dc=Example,dc=com`. Con Active Directory, también puedes usar la sintaxis `[DOMAIN]\[USERNAME]` (p. ej.,`WINDOWS\Administrator`) para el usuario de búsqueda de dominio. | -| `Domain search password (Contraseña de búsqueda de dominio)` | Opcional | La contraseña para el usuario de búsqueda de dominio. | -| `Administrators group (Grupo de administradores)` | Opcional | Los usuarios de este grupo son promovidos a administradores del sitio cuando inician sesión en tu aparato. Si no configuras un Grupo de administradores LDAP, la primera cuenta de usuario LDAP que inicie sesión en tu aparato será promovida automáticamente a administrador del sitio. | -| `Domain base (Base de dominio)` | Requerido | El `Nombre Distintivo` (DN) completamente calificado de un subárbol LDAP que quieras buscar para usuarios y grupos. Puedes agregar tantos como quieras; sin embargo, cada grupo debe estar definido en la misma base de dominio que los usuarios que le pertenecen. Si especificas grupos de usuarios con restricciones, solo los usuarios que pertenecen a esos grupo estarán al alcance. Te recomendamos que especifiques el primer nivel de tu árbol de directorios LDAP como tu base de dominio y que uses grupos de usuarios con restricciones para controlar el acceso. | -| `Restricted user groups (Grupos de usuarios con restricciones)` | Opcional | Si se especifica, solo los usuarios de estos grupos tendrán permiso para iniciar sesión. Solo necesitas especificar los nombres comunes (CN) de los grupos y puedes agregar tantos grupos como quieras. Si no se especifica ningún grupo, *todos* los usuarios dentro del alcance de la base de dominio especificada podrán iniciar sesión en tu instancia del {% data variables.product.prodname_ghe_server %}. | -| `User ID (Identificación de usuario)` | Requerido | El atributo de LDAP que identifica al usuario LDAP que intenta una autenticación. Una vez que se establece una asignación, los usuarios pueden modificar sus nombres de usuario del {% data variables.product.prodname_ghe_server %}. El campo debería ser `sAMAccountName` para la mayoría de las instalaciones de Active Directory, pero puede ser `uid` para otras soluciones LDAP, como OpenLDAP. El valor predeterminado es `uid`. | -| `Nombre de perfil` | Opcional | El nombre que aparecerá en la página de perfil del {% data variables.product.prodname_ghe_server %} del usuario. A menos que la sincronización LDAP esté activada, los usuarios pueden modificar sus nombres de perfil. | -| `Emails (Correos electrónicos)` | Opcional | Las direcciones de correo electrónico para la cuenta del {% data variables.product.prodname_ghe_server %} de un usuario. | -| `SSH keys (Claves SSH)` | Opcional | Las claves SSH públicas vinculadas a la cuenta del {% data variables.product.prodname_ghe_server %} de un usuario. Las claves deben ser en formato OpenSSH. | -| `Claves GPG` | Opcional | Las claves GPG vinculadas a la cuenta del {% data variables.product.prodname_ghe_server %} de un usuario. | -| `Disable LDAP authentication for Git operations (Desactivar la autenticación LDAP para las operaciones de Git)` | Opcional | Si está seleccionado, [desactiva](#disabling-password-authentication-for-git-operations) la posibilidad del usuario de usar contraseñas LDAP para autenticar las operaciones de Git. | -| `Enable LDAP certificate verification (Activar la verificación de certificado LDAP)` | Opcional | Si está seleccionado, [activa](#enabling-ldap-certificate-verification) la verificación de certificado LDAP. | -| `Synchronization (Sincronización)` | Opcional | Si está seleccionado, [activa](#enabling-ldap-sync) la sincronización LDAP. | - -#### Desactivar la autenticación de contraseña para las operaciones de Git - -Selecciona **Disable username and password authentication for Git operations** (Desactivar la autenticación de nombre de usuario y contraseña para las operaciones de Git) en los parámetros de tu LDAP para implementar el uso de los tokens de acceso personal o las claves SSH para el acceso a Git, que pueden ayudarte a prevenir que tu servidor se sobrecargue de solicitudes de autenticación LDAP. Recomendamos esta configuración, ya que un servidor LDAP de respuesta lenta, en especial combinado con una gran cantidad de solicitudes debido al sondeo, suele ser una causa de problemas e interrupciones. - -![Desactivar la casilla de verificación autenticación de contraseña LDAP](/assets/images/enterprise/management-console/ldap-disable-password-auth-for-git.png) - -Cuando se selecciona esta opción, si un usuario intenta usar una contraseña para las operaciones de Git a través de la línea de comando, recibirá un mensaje de error que dice: `La autenticación de contraseña no está permitida para las operaciones de Git. Debes usar un token de acceso personal.` - -#### Activar la verificación de certificado LDAP - -Selecciona **Enable LDAP certificate verification** (Activar verificación de certificado LDAP) en tus parámetros LDAP para validar el certificado del servidor LDAP que usas con TLS. - -![Casilla de verificación de certificado LDAP](/assets/images/enterprise/management-console/ldap-enable-certificate-verification.png) - -Cuando se selecciona esta opción, el certificado se valida para garantizar que: -- Si el certificado contiene al menos un nombre alternativo del firmante (SAN), uno de los SAN coincida con el nombre del host de LDAP. De lo contrario, que el nombre común (CN) coincida con el nombre del host de LDAP. -- El certificado no haya vencido. -- El certificado esté firmado por una entidad de certificación (CA) de confianza. - -#### Activar la sincronización LDAP - -La sincronización LDAP te permite sincronizar usuarios y miembros del equipo del {% data variables.product.prodname_ghe_server %} con tus grupos LDAP establecidos. Esto te permite establecer un control de acceso basado en roles para los usuarios desde tu servidor LDAP, en lugar de hacerlo de forma manual dentro del {% data variables.product.prodname_ghe_server %}. Para obtener más información, consulta "[Crear equipos](/enterprise/{{ currentVersion }}/admin/guides/user-management/creating-teams#creating-teams-with-ldap-sync-enabled)". - -Para activar la sincronización LDAP, en tus parámetros LDAP, selecciona **Synchronize Emails** (Sincronizar correos electrónicos), **Synchronize SSH Keys** (Sincronizar claves SSH) o **Synchronize GPG Keys** (Sincronizar claves GPG). - -![Casilla de verificación de Sincronización](/assets/images/enterprise/management-console/ldap-synchronize.png) - -Una vez que actives la sincronización LDAP, se ejecutará un trabajo de sincronización en el intervalo de tiempo especificado para realizar las siguientes operaciones en cada cuenta de usuario: - -- Si has permitido la autenticación integrada para usuarios externos a tu proveedor de identidad, y el usuario está usando la autenticación integrada, pasa al siguiente usuario. -- Si no existe una asignación LDAP para el usuario, intenta asignar el usuario a una entrada LDAP en el directorio. Si el usuario no se puede asignar a una entrada LDAP, suspéndelo y pasa al siguiente usuario. -- Si hay una asignación LDAP y falta la entrada LDAP correspondiente en el directorio, suspende el usuario y pasa al siguiente usuario. -- Si la entrada LDAP correspondiente se marcó como desactivada, y el usuario aún no se suspendió, suspéndelo y pasa al siguiente usuario. -- Si la entrada LDAP correspondiente no se marcó como desactivada, el usuario está suspendido y _Reactivate suspended users_ (Reactivar usuarios suspendidos) está activado en el centro de administración, anula la suspensión del usuario. -- Si la entrada LDAP correspondiente incluye un atributo `name`, actualiza el nombre de perfil del usuario. -- Si la entrada LDAP correspondiente está en el grupo de administradores, promueve al usuario a administrador del sitio. -- Si la entrada LDAP correspondiente no está en el grupo de administradores, degrada al usuario a una cuenta normal. -- Si un campo de usuario LDAP está definido para correos electrónicos, sincroniza los parámetros del correo electrónico del usuario con la entrada LDAP. Establece la primera entrada `mail` LDAP como el correo electrónico principal. -- Si un campo de usuario LDAP está definido para claves públicas SSH, sincroniza las claves SSH públicas del usuario con la entrada LDAP. -- Si un campo de usuario LDAP está definido para claves GPG, sincroniza las claves GPG del usuario con la entrada LDAP. - -{% note %} - -**Nota**: Las entradas LDAP solo pueden estar marcadas como desactivadas si usas Active Directory y el atributo `userAccountControl` está presente y marcado con `ACCOUNTDISABLE`. - -{% endnote %} - -También se ejecutará un trabajo de sincronización en el intervalo de tiempo especificado para realizar las siguientes operaciones en cada equipo que haya sido asignado a un grupo LDAP: - -- Si se eliminó el grupo LDAP correspondiente de un equipo, elimina todos los miembros del equipo. -- Si las entradas de miembros LDAP se eliminaron del grupo LDAP, elimina los usuarios correspondientes del equipo. Si como resultado el usuario pierde acceso a algún repositorio, elimina toda bifurcación privada que el usuario tenga de esos repositorios. -- Si las entradas de miembros LDAP se agregaron al grupo LDAP, agrega los usuarios correspondientes al equipo. Si como resultado el usuario recupera el acceso a algún repositorio, restablece toda bifurcación privada de los repositorios que haya sido eliminada debido a que el usuario perdió acceso en los últimos 90 días. - -{% data reusables.enterprise_user_management.ldap-sync-nested-teams %} - -{% warning %} - -**Advertencia de seguridad:** - -Cuando la sincronización LDAP está activada, los administradores del sitio y los propietarios de la organización pueden buscar en el directorio LDAP los grupos a los cuales asignar el equipo. - -Esto posibilita divulgar información organizativa confidencial a contratistas u otros usuarios sin privilegios, incluidos los siguientes: - -- La existencia de grupos LDAP específicos visibles para el *Usuario de búsqueda de dominio*. -- Los miembros del grupo LDAP que tienen cuentas de usuario del {% data variables.product.prodname_ghe_server %}, que se divulga cuando se crea un equipo sincronizado con ese grupo LDAP. - -Si no se desea divulgar dicha información, su empresa u organización debe restringir los permisos del *Usuario de búsqueda de dominio* en la consola de administración. Si no es posible aplicar dicha restricción, comuníquese con el {% data variables.contact.contact_ent_support %}. - -{% endwarning %} - -#### Clases de objetos del grupo LDAP admitidas - -El {% data variables.product.prodname_ghe_server %} admite estas clases de objetos del grupo LDAP. Los grupos se pueden anidar. - -- `grupo` -- `groupOfNames` -- `groupOfUniqueNames` -- `posixGroup` - -### Ver y crear usuarios LDAP - -Puedes ver la lista completa de usuarios LDAP que tienen acceso a tu instancia y aprovisionar nuevos usuarios. - -{% data reusables.enterprise_site_admin_settings.sign-in %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -3. En la barra lateral izquierda, haz clic en **LDAP users** (Usuarios LDAP). ![Pestaña LDAP users (Usuarios LDAP)](/assets/images/enterprise/site-admin-settings/ldap-users-tab.png) -4. Para buscar un usuario, escribe un nombre de usuario completo o parcial y haz clic en **Search** (Buscar). Se mostrarán los usuarios existentes en los resultados de búsqueda. Si un usuario no existe, haz clic en **Create** (Crear) para aprovisionar la nueva cuenta de usuario. ![Búsqueda LDAP](/assets/images/enterprise/site-admin-settings/ldap-users-search.png) - -### Actualizar cuentas LDAP - -A menos que [la sincronización LDAP esté activada](#enabling-ldap-sync), las modificaciones de las cuentas LDAP no se sincronizan automáticamente con el {% data variables.product.prodname_ghe_server %}. - -* Para usar un nuevo grupo de administración LDAP, los usuarios deben ser promovidos y degradados de forma manual en el {% data variables.product.prodname_ghe_server %} para reflejar las modificaciones en LDAP. -* Para agregar o eliminar cuentas LDAP de los grupos de administración LDAP, [promueve o degrada las cuentas en el {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/guides/user-management/promoting-or-demoting-a-site-administrator). -* Para eliminar las cuentas LDAP, [suspende las cuentas del {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/guides/user-management/suspending-and-unsuspending-users). - -#### Sincronizar cuentas LDAP de forma manual - -{% data reusables.enterprise_site_admin_settings.sign-in %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.search-user %} -{% data reusables.enterprise_site_admin_settings.click-user %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -5. En "LDAP", haz clic en **Sync now** (Sincronizar ahora) para actualizar de forma manual la cuenta con los datos de tu servidor LDAP. ![Botón LDAP sync now (Sincronizar LDAP ahora)](/assets/images/enterprise/site-admin-settings/ldap-sync-now-button.png) - -También puedes [utilizar la API para activar una sincronización manual](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#ldap). - -### Revocar acceso a {% data variables.product.product_location_enterprise %} - -Si [la sincronización LDAP está activada](#enabling-ldap-sync), al eliminar las credenciales LDAP de un usuario, se suspenderá su cuenta hasta la siguiente ejecución de sincronización. - -Si la sincronización LDAP **no** está activada, debes suspender de forma manual la cuenta del {% data variables.product.prodname_ghe_server %} después de eliminar las credenciales LDAP. Para obtener más información, consulta "[Suspender y anular suspensión de usuarios](/enterprise/{{ currentVersion }}/admin/guides/user-management/suspending-and-unsuspending-users)". diff --git a/translations/es-XL/content/admin/user-management/using-saml.md b/translations/es-XL/content/admin/user-management/using-saml.md deleted file mode 100644 index a40fcfe0d880..000000000000 --- a/translations/es-XL/content/admin/user-management/using-saml.md +++ /dev/null @@ -1,137 +0,0 @@ ---- -title: Usar SAML -redirect_from: - - /enterprise/admin/articles/configuring-saml-authentication/ - - /enterprise/admin/articles/about-saml-authentication/ - - /enterprise/admin/user-management/using-saml -intro: 'SAML es un estándar basado en XML para autenticación y autorización. {% data variables.product.prodname_ghe_server %} puede actuar como un proveedor de servicios (SP) con tu proveedor de identidad (IdP) SAML interno.' -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_user_management.built-in-authentication %} - -### Servicios SAML admitidos - -{% data reusables.saml.saml-supported-idps %} - -{% data reusables.saml.saml-single-logout-not-supported %} - -### Consideraciones sobre el nombre de usuario con SAML - -Cada nombre de usuario {% data variables.product.prodname_ghe_server %} lo determina una de las siguientes aserciones en la respuesta SAML, ordenadas por prioridad: - -- El atributo de nombre de usuario personalizado, si está definido y si hay uno. -- Una aserción `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name`, si hay una. -- Una aserción `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress` assertion, si hay una. -- El elemento `NameID`. - -Se requiere el elemento `NameID`, incluso si hay otros atributos. - -Se crea una asignación entre el `NameID` y el nombre de usuario {% data variables.product.prodname_ghe_server %}, para que el `NameID` sea persistente, único y no esté sujeto a cambios durante el ciclo de vida del usuario. - -{% data reusables.enterprise_management_console.username_normalization %} - -{% data reusables.enterprise_management_console.username_normalization_sample %} - -{% data reusables.enterprise_user_management.two_factor_auth_header %} -{% data reusables.enterprise_user_management.external_auth_disables_2fa %} - -### Metadatos SAML - -Los metadatos del proveedor de servicios de tu instancia {% data variables.product.prodname_ghe_server %} están disponible en `http(s)://[hostname]/saml/metadata`. - -Para configurar tu proveedor de identidad de forma manual, la URL del Servicio de consumidor de aserciones (ACS) es `http(s)://[hostname]/saml/consume`. Esta usa el enlace `urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST`. - -### Atributos de SAML - -Estos atributos están disponibles. Puedes modificar el nombre del atributo en [Consola de administración](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-management-console/), a excepción del atributo `administrator`. - -| Nombre de atributo predeterminado | Tipo | Descripción | -| --------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `ID del nombre` | Requerido | Un identificador de usuario persistente. Se puede usar cualquier formato de identificador de nombre persistente. El elemento `NameID` se usará para un nombre de usuario {% data variables.product.prodname_ghe_server %}, a menos que se proporcione una de las aserciones alternativas. | -| `administrador` | Opcional | Cuando el valor es "true", el usuario será promovido automáticamente como un administrador. Cualquier otro valor o un valor no existente degradará al usuario a una cuenta de usuario normal. | -| `nombre de usuario` | Opcional | El nombre de usuario {% data variables.product.prodname_ghe_server %}. | -| `nombre_completo` | Opcional | El nombre del usuario que se muestra en su página de perfil. Los usuarios pueden cambiar sus nombres después del aprovisionamiento. | -| `correos electrónicos` | Opcional | Las direcciones de correo electrónico para el usuario. Se puede especificar más de una. | -| `claves_públicas` | Opcional | Las claves SSH públicas para el usuario. Se puede especificar más de una. | -| `claves_gpg` | Opcional | Las claves GPG para el usuario. Se puede especificar más de una. | - -### Configurar parámetros SAML - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.authentication %} -3. Selecciona **SAML**. ![Autenticación SAML](/assets/images/enterprise/management-console/auth-select-saml.png) -4. {% data reusables.enterprise_user_management.built-in-authentication-option %} ![Seleccionar la casilla de verificación Autenticación integrada SAML](/assets/images/enterprise/management-console/saml-built-in-authentication.png) -5. Opcionalmente, para activar el SSO de respuesta no solicitada, selecciona **IdP initiated SSO**. Por defecto, {% data variables.product.prodname_ghe_server %} responderá a una solicitud iniciada por un proveedor de identidad (IdP) no solicitada con una `AuthnRequest` de vuelta al IdP. ![SSO del IdP SAML](/assets/images/enterprise/management-console/saml-idp-sso.png) - - {% tip %} - - **Nota**: Te recomendamos mantener este valor **sin seleccionar**. Debes activar esta función **solo** en el caso inusual que tu implementación SAML no admita el SSO iniciado del proveedor de servicios y que {% data variables.contact.enterprise_support %} lo aconseje. - - {% endtip %} - -5. Selecciona **Disable administrator demotion/promotion (Desactivar la degradación/promoción del administrador)** si **no** quieres que tu proveedor de SAML determine los derechos del administrador para los usuarios en {% data variables.product.product_location_enterprise %}. ![Configuración de administración para desactivar SAML](/assets/images/enterprise/management-console/disable-admin-demotion-promotion.png) -6. En el campo **URL de inicio de sesión único**, escribe la HTTP o el extremo HTTPS en tu IdP para las solicitudes de inicio de sesión único. Este valor lo provee la configuración de tu IdP. Si el host solo está disponible desde tu red interna, es posible que sea necesario [configurar {% data variables.product.product_location_enterprise %} para usar los servidores de nombres internos](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-dns-nameservers/). ![Autenticación SAML](/assets/images/enterprise/management-console/saml-single-sign-url.png) -7. También puedes escribir tu nombre de emisor de SAML en el campo **Emisor**. Esto verifica la autenticidad de los mensajes enviados a {% data variables.product.product_location_enterprise %}. ![Emisor SAML](/assets/images/enterprise/management-console/saml-issuer.png) -8. En los menúes desplegables **Método de firma** y **Método de resumen**, elige el algoritmo de hash que usa tu emisor SAML para verificar la integridad de las respuestas desde {% data variables.product.product_location_enterprise %}. Especifica el formato con el menú desplegable **Formato de identificador de nombre**. ![Método SAML](/assets/images/enterprise/management-console/saml-method.png) -9. Dentro de **Verification certificate (Certificado de comprobación)**, haz clic en **Choose File (Elegir archivo)** y elige un certificado para validar las respuestas SAML desde el IdP. ![Autenticación SAML](/assets/images/enterprise/management-console/saml-verification-cert.png) -10. Modifica los nombres de atributo de SAML para hacerlos coincidir con tu IdP, si es necesario, o acepta los nombres predeterminados. ![Nombres de atributo de SAML](/assets/images/enterprise/management-console/saml-attributes.png) - -### Revocar acceso a {% data variables.product.product_location_enterprise %} - -Si eliminas un usuario desde tu proveedor de identidad, también debes suspenderlos de forma manual. De lo contrario, seguirán estando disponibles para autenticarse usando los tokens de acceso o las claves SSH. Para obtener más información, consulta "[Suspender y anular suspensión de usuarios](/enterprise/admin/guides/user-management/suspending-and-unsuspending-users)". - -### Requisitos para los mensajes de respuesta - -El mensaje de respuesta debe cumplir con los siguientes requisitos: - -- Se debe proporcionar el elemento `` en el documento de respuesta raíz y empatar la URL ACS únicamente cuando dicho documento se firme. Si la aserción está firmada, será ignorada. -- Siempre deberá proporcionarse el elemento `` como parte del elemento ``. Éste debe empatar con la Id de entidad de {% data variables.product.prodname_ghe_server %}. Ésta es la URL para la instancia de {% data variables.product.prodname_ghe_server %}, tal como `https://ghe.corp.example.com`. -- Cada aserción en la respuesta **debe** estar protegida por una firma digital. Esto se puede lograr firmando cada elemento `` individual o firmando el elemento ``. -- Un elemento `` se debe proporcionar como parte del elemento ``. Se puede usar cualquier formato de identificador de nombre persistente. -- El atributo `Recipient` debe estar presente y establecido en la URL ACS. Por ejemplo: - -```xml - - - - ... - - - - - - - monalisa - - - - -``` - -### Mensajes de error - -Si el `Recipient` no coincide con la URL ACS, se presentará el siguiente mensaje de error en el registro de autenticación: - -``` -El destinatario en la respuesta SAML no era válido. -``` - -Si el `Recipient` no es parte del mensaje de respuesta, se presentará el siguiente mensaje de error en el registro de autenticación: - -``` -El destinatario en la respuesta SAML no debe estar en blanco. -``` - -Si la respuesta SAML no está firmada o la firma no coincide con los contenidos, se presentará el siguiente mensaje de error en el registro de autenticación: - -``` -La respuesta SAML no está firmada o ha sido modificada. -``` -Si falta `Audience` o no coincide con el Id. de entidad del {% data variables.product.prodname_ghe_server %}, se presentará el siguiente mensaje de error en el registro de autenticación: - -``` -La audiencia es no válida. El atributo de audiencia no coincide con your_instance_url -``` diff --git a/translations/es-XL/content/desktop/contributing-and-collaborating-using-github-desktop/accessing-a-pull-request-locally.md b/translations/es-XL/content/desktop/contributing-and-collaborating-using-github-desktop/accessing-a-pull-request-locally.md deleted file mode 100644 index c7f885307e69..000000000000 --- a/translations/es-XL/content/desktop/contributing-and-collaborating-using-github-desktop/accessing-a-pull-request-locally.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: Cómo acceder a una solicitud de extracción localmente -intro: 'Puedes ver los cambios propuestos en las solicitudes de extracción abiertas en {% data variables.product.prodname_desktop %}.' -redirect_from: - - /desktop/contributing-to-projects/accessing-a-pull-request-locally -versions: - free-pro-team: '*' ---- - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.click-pull-requests %} - ![Pestaña Pull Requests en el menú desplegable de la rama actual](/assets/images/help/desktop/branch-drop-down-pull-request-tab.png) -{% data reusables.desktop.choose-pr-from-list %} - ![Lista de las solicitudes de extracción abiertas en el repositorio](/assets/images/help/desktop/click-pull-request.png) -4. Opcionalmente, para actualizar la lista de solicitudes de extracción, haz clic en {% octicon "sync" aria-label="The sync icon" %}. ![Botón Sync (Sincronizar) para actualizar](/assets/images/help/desktop/pull-request-list-sync.png) diff --git a/translations/es-XL/content/desktop/contributing-to-projects/accessing-a-pull-request-locally.md b/translations/es-XL/content/desktop/contributing-to-projects/accessing-a-pull-request-locally.md deleted file mode 100644 index da07b057b952..000000000000 --- a/translations/es-XL/content/desktop/contributing-to-projects/accessing-a-pull-request-locally.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: Cómo acceder a una solicitud de extracción localmente -intro: 'Puedes ver los cambios propuestos en las solicitudes de extracción abiertas en {% data variables.product.prodname_desktop %}.' -versions: - free-pro-team: '*' ---- - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.click-pull-requests %} - ![Pestaña Pull Requests en el menú desplegable de la rama actual](/assets/images/help/desktop/branch-drop-down-pull-request-tab.png) -{% data reusables.desktop.choose-pr-from-list %} - ![Lista de las solicitudes de extracción abiertas en el repositorio](/assets/images/help/desktop/click-pull-request.png) -4. Opcionalmente, para actualizar la lista de solicitudes de extracción, haz clic en {% octicon "sync" aria-label="The sync icon" %}. ![Botón Sync (Sincronizar) para actualizar](/assets/images/help/desktop/pull-request-list-sync.png) diff --git a/translations/es-XL/content/desktop/contributing-to-projects/adding-a-repository-from-your-local-computer-to-github-desktop.md b/translations/es-XL/content/desktop/contributing-to-projects/adding-a-repository-from-your-local-computer-to-github-desktop.md deleted file mode 100644 index d9e0ff76149c..000000000000 --- a/translations/es-XL/content/desktop/contributing-to-projects/adding-a-repository-from-your-local-computer-to-github-desktop.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: Agregar un repositorio desde tu equipo local a GitHub Desktop -intro: 'Puedes agregar cualquier repositorio Git a {% data variables.product.prodname_desktop %}, incluso si no es un repositorio {% data variables.product.prodname_dotcom %}.' -versions: - free-pro-team: '*' ---- - -{% tip %} - -**Sugerencia:** Puedes agregar un repositorio Git desde tu equipo local hasta GitHub Destktop arrastrando la carpeta a la ventana {% data variables.product.prodname_desktop %}. Si arrastras múltiples carpetas Git a {% data variables.product.prodname_desktop %} al mismo tiempo, cada carpeta se agregará como un repositorio Git individual. - -{% endtip %} - -{% mac %} - -1. En el menú **File** (Archivo), haz clic en **Add Local Repository** (Agregar repositorio local). ![Agrega la opción de menú Local Repository (Repositorio local)](/assets/images/help/desktop/add-local-repository-mac.png) -2. Haz clic en **Choose...** (Elegir...) y, a través de la ventana Finder (Buscador) desplázate hasta el repositorio local que deseas agregar. ![El campo Local Path en la app Mac](/assets/images/help/desktop/add-repo-choose-button-mac.png) -4. Haz clic en **Add Repository** (Agregar repositorio). ![El botón Add repository (Agregar repositorio) en la app Mac](/assets/images/help/desktop/add-repository-button-mac.png) - -{% endmac %} - -{% windows %} - -1. En el menú **File** (Archivo) haz clic en **Add Local Repository** (Agregar repositorio local). ![Agrega la opción de menú Local Repository (Repositorio local)](/assets/images/help/desktop/add-local-repository-windows.png) -2. Haz clic en **Choose...** (Elegir) y, a través de Windows Explorer, desplázate hasta el repositorio local que deseas agregar. ![El campo Local Path (Ruta local) en la app Windows](/assets/images/help/desktop/add-repo-choose-button-win.png) -4. Haz clic en **Add repository** (Agregar repositorio). ![El botón Add repository (Agregar repositorio) en la app Windows](/assets/images/help/desktop/add-repository-button-windows.png) - -{% endwindows %} diff --git a/translations/es-XL/content/desktop/contributing-to-projects/adding-an-existing-project-to-github-using-github-desktop.md b/translations/es-XL/content/desktop/contributing-to-projects/adding-an-existing-project-to-github-using-github-desktop.md deleted file mode 100644 index 01628f517dc8..000000000000 --- a/translations/es-XL/content/desktop/contributing-to-projects/adding-an-existing-project-to-github-using-github-desktop.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: Agregar un proyecto existente a GitHub usando el GitHub Desktop -intro: 'Puedes agregar un repositorio Git existente a {% data variables.product.prodname_dotcom %} usando {% data variables.product.prodname_desktop %}.' -versions: - free-pro-team: '*' ---- - -{% mac %} - -{% data reusables.git.remove-git-remote %} -2. [Agrega el repositorio al GitHub Desktop Desktop](/desktop/guides/contributing-to-projects/adding-a-repository-from-your-local-computer-to-github-desktop/). -{% data reusables.desktop.publish-repository %} -4. Escribe el nombre deseado del repositorio en el campo **Name** (Name) o usa el nombre de repositorio local actual predeterminado. ![El campo Name (Nombre)](/assets/images/help/desktop/publish-repository-name-mac.png) -5. Para publicar un repositorio público, quita la marca de selección de **Keep this code private**. ![Marca la casilla de verificación privada de este código](/assets/images/help/desktop/publish-repository-private-checkbox-mac.png) -6. Escoge la organización en el **Organization** (Organización) desplegable donde deseas publicar el repositorio, o selecciona **None** (Ninguno) para publicar el repositorio en tu cuenta personal. ![Desplegable de la organización](/assets/images/help/desktop/publish-repository-org-dropdown-mac.png) -7. Haz clic en el botón **Publish Repository** (Publicar repositorio). ![El botón Publish repository (Publicar repositorio) en el cuadro de diálogo Publish Repository (Publicar repositorio)](/assets/images/help/desktop/publish-repository-dialog-button-mac.png) - -{% endmac %} - -{% windows %} - -{% data reusables.git.remove-git-remote %} -2. [Agrega el repositorio al GitHub Desktop Desktop](/desktop/guides/contributing-to-projects/adding-a-repository-from-your-local-computer-to-github-desktop/). -{% data reusables.desktop.publish-repository %} -4. Escribe el nombre deseado del repositorio en el campo **Name** (Name) o usa el nombre de repositorio local actual predeterminado. ![El campo Name (Nombre)](/assets/images/help/desktop/publish-repository-name-win.png) -5. Para publicar un repositorio público, quita la marca de selección de **Keep this code private**. ![Marca la casilla de verificación privada de este código](/assets/images/help/desktop/publish-repository-private-checkbox-win.png) -6. Escoge la organización en el **Organization** (Organización) desplegable donde deseas publicar el repositorio, o selecciona **None** (Ninguno) para publicar el repositorio en tu cuenta personal. ![Desplegable de la organización](/assets/images/help/desktop/publish-repository-org-dropdown-win.png) -7. Haz clic en el botón **Publish Repository** (Publicar repositorio). ![El botón Publish repository (Publicar repositorio) en el cuadro de diálogo Publish repository (Publicar repositorio)](/assets/images/help/desktop/publish-repository-dialog-button-win.png) - -{% endwindows %} diff --git a/translations/es-XL/content/desktop/contributing-to-projects/adding-and-cloning-repositories.md b/translations/es-XL/content/desktop/contributing-to-projects/adding-and-cloning-repositories.md deleted file mode 100644 index 16528bf69935..000000000000 --- a/translations/es-XL/content/desktop/contributing-to-projects/adding-and-cloning-repositories.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: Agregar y clonar repositorios -intro: 'Añadir repositorios existentes desde su equipo local a {% data variables.product.prodname_desktop %}o clonar repositorios desde {% data variables.product.product_name %}.' -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/es-XL/content/desktop/contributing-to-projects/changing-a-remotes-url-from-github-desktop.md b/translations/es-XL/content/desktop/contributing-to-projects/changing-a-remotes-url-from-github-desktop.md deleted file mode 100644 index b8bcb4d87a7d..000000000000 --- a/translations/es-XL/content/desktop/contributing-to-projects/changing-a-remotes-url-from-github-desktop.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Cambiar una URL remota desde el GitHub Desktop -intro: 'Puedes cambiar la URL remota para un repositorio en el que estés trabajando {% data variables.product.prodname_desktop %}. Es posible que puedas hacerlo si se ha cambiado el nombre, o si el nombre de usuario o la organización que posee el repositorio ha cambiado.' -redirect_from: - - /desktop/contributing-to-projects/changing-a-remote-s-url-from-github-desktop -versions: - free-pro-team: '*' ---- - -{% mac %} - -1. En el menú **Repository** (Repositorio) haz clic en **Repository Settings...** (Configuración del repositorio...). ![Opciones del menú Repository Settings (Configuración del repositorio)](/assets/images/help/desktop/repository-settings-mac.png) -2. En el campo **Primary remote repository** (Repositorio remoto principal) escribe la URL que desees. ![Campo Primary remote repository (Repositorio remoto principal)](/assets/images/help/desktop/repository-settings-remote-mac.png) -3. Haz clic en **Save** (Guardar). ![El botón Save (Guardar)](/assets/images/help/desktop/repository-settings-save-mac.png) - -{% endmac %} - -{% windows %} - -1. En el menú **Repository** (Repositorio), haz clic en **Repository settings...** (Configuración del repositorio...). ![Opciones del menú Repository Settings (Configuración del repositorio)](/assets/images/help/desktop/repository-settings-win.png) -2. En el campo **Primary remote repository** (Repositorio remoto principal) escribe la URL que desees. ![Campo Primary remote repository (Repositorio remoto principal)](/assets/images/help/desktop/repository-settings-remote-win.png) -3. Haz clic en **Save** (Guardar). ![El botón Save (Guardar)](/assets/images/help/desktop/repository-settings-save-win.png) - -{% endwindows %} diff --git a/translations/es-XL/content/desktop/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop.md b/translations/es-XL/content/desktop/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop.md deleted file mode 100644 index 7892e7ab0f03..000000000000 --- a/translations/es-XL/content/desktop/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: Cómo clonar un repositorio desde GitHub hasta GitHub Desktop -intro: 'Puedes usar {% data variables.product.prodname_dotcom %} para clonar repositorios remotos a {% data variables.product.prodname_desktop %}.' -versions: - free-pro-team: '*' ---- - -{% tip %} - -**Sugerencia:** También puede usar {% data variables.product.prodname_desktop %} para clonar repositorios que existen en {% data variables.product.prodname_dotcom %}. Para obtener más información, consulta "[Cómo clonar un repositorio desde {% data variables.product.prodname_desktop %}](/desktop/guides/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop/)." - -{% endtip %} - -{% mac %} - -1. Inicia sesión en {% data variables.product.product_location %} y {% data variables.product.prodname_desktop %} antes de comenzar la clonación. -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.open-with-github-desktop %} -5. Haz clic en **Choose...** (Elegir...) y, a través de la ventana Finder (Buscador) desplázate hasta la ruta donde deseas clonar el repositorio. ![El botón Choose (Elegir) en la pestaña URL](/assets/images/help/desktop/clone-choose-button-url-mac.png) - - {% note %} - - **Nota:** Si el repositorio está configurado para usar LFS, se te pedirá que inicies {% data variables.large_files.product_name_short %}. - - {% endnote %} - -5. Haz clic en **Clone**. ![El botón para clonar en la pestaña URL](/assets/images/help/desktop/clone-button-url-mac.png) - -{% endmac %} - -{% windows %} - -1. Inicia sesión en {% data variables.product.product_location %} y {% data variables.product.prodname_desktop %} antes de comenzar la clonación. -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.open-with-github-desktop %} -5. Haz clic en **Choose...** (Elegir...) y, a través de Windows Explorer, desplázate hasta la ruta donde deseas clonar el repositorio. ![El botón Choose (Elegir)](/assets/images/help/desktop/clone-choose-button-url-win.png) - - {% note %} - - **Nota:** Si el repositorio está configurado para usar LFS, se te pedirá que inicies {% data variables.large_files.product_name_short %}. - - {% endnote %} - -5. Haz clic en **Clone**. ![El botón Clone (Clonar)](/assets/images/help/desktop/clone-button-url-win.png) - -{% endwindows %} diff --git a/translations/es-XL/content/desktop/contributing-to-projects/cloning-and-forking-repositories-from-github-desktop.md b/translations/es-XL/content/desktop/contributing-to-projects/cloning-and-forking-repositories-from-github-desktop.md deleted file mode 100644 index fc3967eb9818..000000000000 --- a/translations/es-XL/content/desktop/contributing-to-projects/cloning-and-forking-repositories-from-github-desktop.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: Cómo clonar y bifurcar repositorios desde GitHub Desktop -intro: 'Puedes utilizar {% data variables.product.prodname_desktop %} para clonar y ramificar los repositorios que están en {% data variables.product.prodname_dotcom %}.' -redirect_from: - - /desktop/contributing-to-projects/cloning-a-repository-from-github-desktop -versions: - free-pro-team: '*' ---- - -### Clonar repositorios -Los repositorios en {% data variables.product.prodname_dotcom %} son remotos. Puedes clonar repositorios públicos de otros dueños. Puedes clonar tu propio repositorio para crear una copia local en tu computadora y sincronizarla entre las dos ubicaciones. - -También puedes clonar un repositorio directamente desde {% data variables.product.prodname_dotcom %} o {% data variables.product.prodname_enterprise %}. Para obtener más información, visita "[Cómo clonar un repositorio desde {% data variables.product.prodname_dotcom %} hacia {% data variables.product.prodname_desktop %}](/desktop/guides/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop/)". - -{% mac %} - -{% data reusables.desktop.choose-clone-repository %} - ![Clonar opción de menú en la aplicación Mac](/assets/images/help/desktop/clone-file-menu-mac.png) -{% data reusables.desktop.cloning-location-tab %} - ![Pestañas de ubicación en el menú Clone a repository (Clonar un repositorio)](/assets/images/help/desktop/choose-repository-location-mac.png) -{% data reusables.desktop.cloning-repository-list %} - ![Clonar una lista de repositorio](/assets/images/help/desktop/clone-a-repository-list-mac.png) -4. Haz clic en **Choose...** (Elegir...) y, a través de la ventana Finder (Buscador) desplázate hasta la ruta donde deseas clonar el repositorio. ![El botón Choose (Elegir)](/assets/images/help/desktop/clone-choose-button-mac.png) -5. Haz clic en **Clone**. ![El botón Clone (Clonar)](/assets/images/help/desktop/clone-button-mac.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.choose-clone-repository %} - ![Opción Clone menu (Clonar menú) en la app de Windows](/assets/images/help/desktop/clone-file-menu-windows.png) -{% data reusables.desktop.cloning-location-tab %} - ![Pestañas de ubicación en el menú Clone a repository (Clonar un repositorio)](/assets/images/help/desktop/choose-repository-location-win.png) -{% data reusables.desktop.cloning-repository-list %} - ![Clonar una lista de repositorio](/assets/images/help/desktop/clone-a-repository-list-win.png) -4. Haz clic en **Choose...** (Elegir...) y, a través de Windows Explorer, desplázate hasta la ruta donde deseas clonar el repositorio. ![El botón Choose (Elegir)](/assets/images/help/desktop/clone-choose-button-win.png) -5. Haz clic en **Clone**. ![El botón Clone (Clonar)](/assets/images/help/desktop/clone-button-win.png) - -{% endwindows %} - -### Ramificar repositorios -Puedes utilizar {% data variables.product.prodname_desktop %} para crear una ramificación del repositorio y contribuir con un proyecto en donde no tengas privilegios de escritura. Los cambios en tu ramificación no afectarán al repositorio original. Puedes confirmar los cambios en tu ramificación y generar una solicitud de extracción del repositorio original con los cambios que propones. Para obtener más información, visita "[Acerca de las ramificaciones](/github/collaborating-with-issues-and-pull-requests/about-forks)." - -1. Si clonaste un repositorio en donde no tienes privilegios de escritura, intenta confirmar los cambios, {% data variables.product.prodname_desktop %} enviará una alerta de que "No cuentas con privilegios de escritura para el **REPOSITORIO**". Da clic en **crear una ramificación**. ![Crear un enlace para la ramificación](/assets/images/help/desktop/create-a-fork.png) -3. Da clic en **Ramificar este repositorio**. ![Botón para ramificar este repositorio](/assets/images/help/desktop/fork-this-repo-button.png) -4. Para ver tu ramificación en {% data variables.product.prodname_dotcom %}, da clic en tu foto de perfil en la esquina superior derecha de {% data variables.product.prodname_dotcom %} y posteriormente en **Tus repositorios**. ![Enlace a tus repositorios](/assets/images/help/profile/your-repositories.png) diff --git a/translations/es-XL/content/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project.md b/translations/es-XL/content/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project.md deleted file mode 100644 index eb10a002f54b..000000000000 --- a/translations/es-XL/content/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project.md +++ /dev/null @@ -1,97 +0,0 @@ ---- -title: Confirmar y revisar cambios en su proyecto -intro: '{% data variables.product.prodname_desktop %} registra todos los cambios a medida que los editas. Puedes decidir cómo agrupar los cambios para crear confirmaciones significativas.' -versions: - free-pro-team: '*' ---- - -### Acerca de las confirmaciones - -De manera similar al guardado de un archivo, una confirmación es un cambio en uno o más archivos en su rama. Git asigna a cada confirmación un ID exclusivo, denominado SHA o hash, que realiza el seguimiento de: - -- Los cambios específicos -- Cuando se realizaron los cambios -- Quién creó los cambios - -Cuando realizas una confirmación, debes incluir un mensaje de confirmación que describa brevemente los cambios. También puedes agregar un coautor en cualquiera de las confirmaciones en las que colabores. - -### 1. Elegir una rama y realizar cambios - -1. [Crear una rama nueva](/desktop/guides/contributing-to-projects/managing-branches) o seleccionar una rama existente haciendo clic en {% octicon "git-branch" aria-label="The branch icon" %}**Current Branch** (Rama actual) en la barra de herramientas y seleccionando la rama de la lista. ![Despliega el menú para cambiar tu rama actual](/assets/images/help/desktop/click-branch-in-drop-down.png) -{% data reusables.desktop.make-changes %} - -### 2. Seleccionar cambios para incluirlos en una confirmación - -A medida que realizas cambios en los archivos en tu editor de texto y que los guardas localmente, también verás los cambios en {% data variables.product.prodname_desktop %}. - -* El icono rojo {% octicon "diff-removed" aria-label="The diff removed icon color-red" %} hace referencia a los archivos eliminados. -* El icono amarillo {% octicon "diff-modified" aria-label="The diff modified icon color-yellow" %} hace referencia a los archivos modificados. -* El icono verde {% octicon "diff-added" aria-label="The diff added icon color-green" %} hace referencia a los archivos agregados. -* Para acceder a los cambios acumulados, haz clic en **Stashed Changes** (Cambios acumulados). ![Opción de cambios acumulados](/assets/images/help/desktop/stashed-changes.png) -* {% data reusables.desktop.commit-all-desc %}![Selecciona la casilla de verificación para confirmar todos los archivos cambiados](/assets/images/help/desktop/commit-all.png) -* {% data reusables.desktop.commit-some-desc %}![Selecciona las casillas de verificación junto a los archivos que deseas confirmar](/assets/images/help/desktop/commit-some.png) - -#### Crear una confirmación parcial - -Si un archivo contiene múltiples cambios, pero solo quieres que *algunos* de esos cambios se incluyan en una confirmación, puedes crear una confirmación parcial. El resto de los cambios permanecerán intactos, por lo que puedes realizar confirmaciones y modificaciones adicionales. Esto permite realizar confirmaciones separadas, significativas, como mantener cambios de interrupción de línea en una confirmación separada desde cambios en el código o la prosa. - -Cuando revises la diferencia del archivo, las líneas que se incluirán en la confirmación están resaltadas en azul. Para excluir el cambio, haz clic en la línea cambiada para que desaparezca el azul. - -![Líneas no seleccionadas en un archivo](/assets/images/help/desktop/partial-commit.png) - -#### Descartar cambios - -Puedes descartar todos los cambios no confirmados en un archivo, o rango de archivos, o descartar todos los cambios en todos los archivos desde la última confirmación. - -{% mac %} - -{% data reusables.desktop.select-discard-files %} -{% data reusables.desktop.click-discard-files %} - ![Opción Discard Changes (Descartar cambios) en el menú contextual](/assets/images/help/desktop/discard-changes-mac.png) -{% data reusables.desktop.confirm-discard-files %} - ![Botón Discard Changes (Descartar cambios) en el cuadro de diálogo de confirmación](/assets/images/help/desktop/discard-changes-confirm-mac.png) - -{% tip %} - -**Sugerencia:** Los cambios que descartaste se cargarán en un archivo fechado en la Papelera y puedes recuperarlos hasta que se vacíe la Papelera. - -{% endtip %} - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.select-discard-files %}{% data reusables.desktop.click-discard-files %} - ![Opción Discard Changes (Descartar cambios) en el menú contextual](/assets/images/help/desktop/discard-changes-win.png) -{% data reusables.desktop.confirm-discard-files %} - ![Botón Discard Changes (Descartar cambios) en el cuadro de diálogo de confirmación](/assets/images/help/desktop/discard-changes-confirm-win.png) - -{% tip %} - -**Sugerencia:** Los cambios que descartaste se guardarán en un archivo en la Papelera de reciclaje y puedes recuperarlos hasta que se vacíe. - -{% endtip %} - -{% endwindows %} - -### 3. Escribir un mensaje de confirmación y subir los cambios - -Una vez que estés satisfecho con los cambios que elegiste incluir en tu confirmación, escribe tu mensaje de confirmación y sube los cambios. Si has colaborado en una confirmación, también puedes contribuir en una confirmación de más de un autor. - -{% note %} - -**Nota**: {% data reusables.desktop.tags-push-with-commits %} Para obtener más información, consulta la sección "[Administrar las etiquetas](/desktop/contributing-to-projects/managing-tags)". - -{% endnote %} - -{% data reusables.desktop.commit-message %} - ![Campo para mensaje de confirmación](/assets/images/help/desktop/commit-message.png) -2. De manera opcional, para atribuir una confirmación a otro autor, haz clic en el icono de coautores y escribe el nombre de usuario que deseas incluir. ![Agregar un coautor al mensaje de confirmación](/assets/images/help/desktop/add-co-author-commit.png) -{% data reusables.desktop.commit-button %} - ![Botón Commit (Confirmar)](/assets/images/help/desktop/commit-button.png) -4. Si la rama a la que intentas comprometerte está protegida, Desktop te avisará. - - Para mover tus cambios, haz clic en **switch btanches (cambiar ramas)**. - - Para confirmar tus cambios en la rama protegida, haz clic en **Commit to _BRANCH_****(Enviar a _RAMA)_**. - - Para más información sobre ramas protegidas, ve "[Acerca de ramas protegidas](/github/administering-a-repository/about-protected-branches)". ![Advertencia de rama protegida](/assets/images/help/desktop/protected-branch-warning.png) -{% data reusables.desktop.push-origin %} diff --git a/translations/es-XL/content/desktop/contributing-to-projects/creating-a-branch-for-your-work.md b/translations/es-XL/content/desktop/contributing-to-projects/creating-a-branch-for-your-work.md deleted file mode 100644 index cadf47aa9db5..000000000000 --- a/translations/es-XL/content/desktop/contributing-to-projects/creating-a-branch-for-your-work.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: Crear una rama para tu trabajo -intro: 'Si tienes permisos de colaborador en un repositorio, puedes crear una rama fuera de la rama predeterminada del repositorio de manera que puedas experimentar con cambios de manera segura.' -versions: - free-pro-team: '*' ---- - -### Cómo crear una rama - -{% tip %} - -**Sugerencia:** La primera rama nueva que crees se basará en la rama predeterminada, que habitualmente es `principal`. Si tienes más de una rama, tendrás la oportunidad de basar la nueva rama en la rama revisada actualmente o la rama por defecto. - -{% endtip %} - -{% mac %} - -{% data reusables.desktop.click-base-branch-in-drop-down %} - ![Menú desplegable para cambiar tu rama actual](/assets/images/help/desktop/click-branch-in-drop-down-mac.png) -{% data reusables.desktop.create-new-branch %} - ![Opción New Branch (Rama nueva) en el menú Branch (Rama)](/assets/images/help/desktop/new-branch-button-mac.png) -{% data reusables.desktop.name-branch %} - ![Campo para crear un nombre para la rama nueva](/assets/images/help/desktop/create-branch-name-mac.png) -{% data reusables.desktop.select-base-branch %} - ![Opciones de rama base](/assets/images/help/desktop/create-branch-choose-branch-mac.png) -{% data reusables.desktop.confirm-new-branch-button %} - ![Botón Create Branch (Crear rama)](/assets/images/help/desktop/create-branch-button-mac.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.click-base-branch-in-drop-down %} - ![Menú desplegable para cambiar tu rama actual](/assets/images/help/desktop/click-branch-in-drop-down-win.png) -{% data reusables.desktop.create-new-branch %} - ![Opción New Branch (Rama nueva) en el menú Branch (Rama)](/assets/images/help/desktop/new-branch-button-win.png) -{% data reusables.desktop.name-branch %} - ![Campo para crear un nombre para la rama nueva](/assets/images/help/desktop/create-branch-name-win.png) -{% data reusables.desktop.select-base-branch %} - ![Opciones de rama base](/assets/images/help/desktop/create-branch-choose-branch-win.png) -{% data reusables.desktop.confirm-new-branch-button %} - ![Botón Create Branch (Crear rama)](/assets/images/help/desktop/create-branch-button-win.png) - -{% endwindows %} - -### Leer más - -- [Clonar un repositorio de {% data variables.product.prodname_desktop %}](/desktop/guides/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop) diff --git a/translations/es-XL/content/desktop/contributing-to-projects/creating-an-issue-or-pull-request.md b/translations/es-XL/content/desktop/contributing-to-projects/creating-an-issue-or-pull-request.md deleted file mode 100644 index dd02c16cf02c..000000000000 --- a/translations/es-XL/content/desktop/contributing-to-projects/creating-an-issue-or-pull-request.md +++ /dev/null @@ -1,56 +0,0 @@ ---- -title: Crear un nuevo informe de problemas o solicitud de extracción -intro: Puedes crear una propuesta o solicitud de extracción para proponer y colaborar en los cambios en un repositorio. -redirect_from: - - /desktop/contributing-to-projects/creating-a-pull-request -versions: - free-pro-team: '*' ---- - -### Abrir un informe de problemas nuevo -Cuando encuentras un error o deseas sugerir una mejora mientras trabajas de forma local con {% data variables.product.prodname_desktop %}, puedes abrir una nueva propuesta en el repositorio en el que estás si las propuestas están habilitadas. Para obtener más información acerca de cómo trabajar con propuestas, consulta "[Acerca de las propuestas](/github/managing-your-work-on-github/about-issues)." - -{% mac %} - -1. En la esquina superior izquierda de la pantalla, selecciona el menú **Repositorio**. ![Menú de GitHub Desktop en la barra de menú de Mac](/assets/images/help/desktop/select-repository-menu-mac.png) -2. Da clic en **Crear informe de problemas en {% data variables.product.prodname_dotcom %}**. ![Valor del repositorio en el menú de la rama](/assets/images/help/desktop/create-issue-mac.png) -3. En {% data variables.product.prodname_dotcom %}, da clic en **Empezar** para abrir una plantilla de informe de problemas o da clic en **Abrir un informe de problemas en blanco**. ![Opciones para crear nuevo informe de problemas](/assets/images/help/desktop/create-new-issue.png) - -{% endmac %} - -{% windows %} - -1. En la esquina superior izquierda de la ventana, selecciona el menú **Repositorio**. ![El menú de GitHub Desktop en la barra de menú Mac](/assets/images/help/desktop/select-repository-menu-windows.png) -2. Da clic en **Crear informe de problemas en {% data variables.product.prodname_dotcom %}**. ![El valor del repositorio en el menú de la rama](/assets/images/help/desktop/create-issue-windows.png) -3. En {% data variables.product.prodname_dotcom %}, da clic en **Empezar** para abrir una plantilla de informe de problemas o da clic en **Abrir un informe de problemas en blanco**. ![Opciones para crear nuevo informe de problemas](/assets/images/help/desktop/create-new-issue.png) - -{% endwindows %} - -{% note %} - -**Nota**: Si no están habilitadas las plantillas de informe de problemas en tu repositorio actual, {% data variables.product.prodname_desktop %}te direccionará a un informe de problemas en blanco en {% data variables.product.prodname_dotcom %}. - -{% endnote %} - -### Crear una nueva solicitud de extracción -Después de [crear una rama](/desktop/guides/contributing-to-projects/managing-branches) y de [confirmar algunos cambios](/desktop/guides/contributing-to-projects/committing-and-reviewing-changes-to-your-project), puedes abrir una solicitud de extracción para obtener comentarios sobre los cambios propuestos. - -{% mac %} - -1. En la esquina superior izquierda de la pantalla, selecciona el menú **Branch** (Rama). ![El menú de GitHub Desktop en la barra de menú Mac](/assets/images/help/desktop/mac-select-branch-menu.png) -2. Haz clic en **Create Pull Request** (Crear solicitud de extracción). ![El valor Create pull request (Crear solicitud de extracción) en el menú Branch (Rama)](/assets/images/help/desktop/create-pull-request-mac.png) -3. En {% data variables.product.prodname_dotcom %}, verifica la rama _base_ predeterminada y la rama _compare_ en los menús desplegables, y cámbiala si es necesario. ![Menús desplegables para elegir la base y comparar ramas](/assets/images/help/pull_requests/choose-base-and-compare-branches.png) -{% data reusables.repositories.pr-title-description %} -{% data reusables.repositories.create-pull-request %} - -{% endmac %} - -{% windows %} - -1. En la esquina superior izquierda de la ventana, selecciona el menú **Branch** (Rama). ![El menú de GitHub Desiktpo en la barra de menú de las ventanas](/assets/images/help/desktop/windows-select-branch-menu.png) -2. Haz clic en **Create Pull Request** (Crear solicitud de extracción). ![El valor Create pull request (Crear solicitud de extracción) en el menú Branch (Rama)](/assets/images/help/desktop/create-pull-request-win.png) -3. En {% data variables.product.prodname_dotcom %}, verifica la rama _base_ predeterminada y la rama _compare_ en los menús desplegables, y cámbiala si es necesario. ![Menús desplegables para elegir la base y comparar ramas](/assets/images/help/pull_requests/choose-base-and-compare-branches.png) -{% data reusables.repositories.pr-title-description %} -{% data reusables.repositories.create-pull-request %} - -{% endwindows %} diff --git a/translations/es-XL/content/desktop/contributing-to-projects/index.md b/translations/es-XL/content/desktop/contributing-to-projects/index.md deleted file mode 100644 index 44698742465f..000000000000 --- a/translations/es-XL/content/desktop/contributing-to-projects/index.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: Contribuir a los proyectos con GitHub Desktop -shortTitle: Contribuir a proyectos -intro: 'Usa GitHub Desktop para administrar tus proyectos, crear confirmaciones significativas y realizar un seguimiento del historial del proyecto en una app en lugar de en la línea de comando.' -versions: - free-pro-team: '*' ---- - - -### Índice - -{% topic_link_in_list /adding-and-cloning-repositories %} - {% link_in_list /adding-a-repository-from-your-local-computer-to-github-desktop %} - {% link_in_list /adding-an-existing-project-to-github-using-github-desktop %} - {% link_in_list /cloning-and-forking-repositories-from-github-desktop %} - {% link_in_list /cloning-a-repository-from-github-to-github-desktop %} -{% topic_link_in_list /making-changes-in-a-branch %} - {% link_in_list /managing-branches %} - {% link_in_list /committing-and-reviewing-changes-to-your-project %} - {% link_in_list /pushing-changes-to-github %} - {% link_in_list /reverting-a-commit %} - {% link_in_list /managing-tags %} - {% link_in_list /viewing-the-branch-history %} -{% topic_link_in_list /working-with-your-remote-repository-on-github-or-github-enterprise %} - {% link_in_list /syncing-your-branch %} - {% link_in_list /creating-an-issue-or-pull-request %} - {% link_in_list /accessing-a-pull-request-locally %} - {% link_in_list /changing-a-remotes-url-from-github-desktop %} diff --git a/translations/es-XL/content/desktop/contributing-to-projects/making-changes-in-a-branch.md b/translations/es-XL/content/desktop/contributing-to-projects/making-changes-in-a-branch.md deleted file mode 100644 index 21984631e0d4..000000000000 --- a/translations/es-XL/content/desktop/contributing-to-projects/making-changes-in-a-branch.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: Realizar cambios en una rama -intro: 'Usa tu editor de texto favorito, como [Atom](https://atom.io/), para realizar cambios en el proyecto y, a continuación, utiliza {% data variables.product.prodname_desktop %} para visualizar confirmaciones útiles.' -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/es-XL/content/desktop/contributing-to-projects/managing-branches.md b/translations/es-XL/content/desktop/contributing-to-projects/managing-branches.md deleted file mode 100644 index 27b018c93eef..000000000000 --- a/translations/es-XL/content/desktop/contributing-to-projects/managing-branches.md +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: Administrar ramas -intro: Puedes crear una rama nueva desde la rama predeterminada de un repositorio para que puedas experimentar con los cambios de forma segura. -redirect_from: - - /desktop/contributing-to-projects/creating-a-branch-for-your-work - - /desktop/contributing-to-projects/switching-between-branches -versions: - free-pro-team: '*' ---- - -### Acerca de administrar ramas -Puedes utilizar las ramas para experimentar de forma segura con los cambios de tu proyecto. Las ramas aislan tu trabajo de desarrollo de otras ramas en el repositorio. Por ejemplo, puedes utilizar una rama para desarrollar una nueva característica o para corregir un error. - -Siempre puedes crear una rama a partir de otra rama existente. Habitualmente, puedes crear una rama desde la rama `master` en tu repositorio. Podrás entonces trabajar en esta rama nueva aislado de los cambios que otras personas hacen al repositorio. - -Una vez que estés satisfecho con tu trbaajo, puedes [abrir una solicitud de extracción](/desktop/contributing-to-projects/creating-an-issue-or-pull-request) para fusionar los cambios de la rama actual en otra rama. Para obtener más información, consulta "[Acerca de las solicitudes de extracción](/articles/about-pull-requests)." - -Siempre podrás crear una rama en {% data variables.product.prodname_desktop %} si tienes acceso de lectura en un repositorio, pero solo podrás cargar la rama a {% data variables.product.prodname_dotcom %} si tienes acceso de escritura en el repositorio en cuestión. - -{% data reusables.desktop.protected-branches %} - -### Cómo crear una rama - -{% tip %} - -**Sugerencia:** La primera rama nueva que crees se basará en la rama predeterminada, que habitualmente es `principal`. Si tienes más de una rama, puedes elegir basar la nueva rama en aquella que has revisado actualmente o en la rama predeterminada. - -{% endtip %} - -{% mac %} - -{% data reusables.desktop.click-base-branch-in-drop-down %} - ![Menú desplegable para cambiar tu rama actual](/assets/images/help/desktop/click-branch-in-drop-down-mac.png) -{% data reusables.desktop.create-new-branch %} - ![Opción New Branch (Rama nueva) en el menú Branch (Rama)](/assets/images/help/desktop/new-branch-button-mac.png) -{% data reusables.desktop.name-branch %} - ![Campo para crear un nombre para la rama nueva](/assets/images/help/desktop/create-branch-name-mac.png) -{% data reusables.desktop.select-base-branch %} - ![Opciones de rama base](/assets/images/help/desktop/create-branch-choose-branch-mac.png) -{% data reusables.desktop.confirm-new-branch-button %} - ![Botón Create Branch (Crear rama)](/assets/images/help/desktop/create-branch-button-mac.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.click-base-branch-in-drop-down %} - ![Menú desplegable para cambiar tu rama actual](/assets/images/help/desktop/click-branch-in-drop-down-win.png) -{% data reusables.desktop.create-new-branch %} - ![Opción New Branch (Rama nueva) en el menú Branch (Rama)](/assets/images/help/desktop/new-branch-button-win.png) -{% data reusables.desktop.name-branch %} - ![Campo para crear un nombre para la rama nueva](/assets/images/help/desktop/create-branch-name-win.png) -{% data reusables.desktop.select-base-branch %} - ![Opciones de rama base](/assets/images/help/desktop/create-branch-choose-branch-win.png) -{% data reusables.desktop.confirm-new-branch-button %} - ![Botón Create Branch (Crear rama)](/assets/images/help/desktop/create-branch-button-win.png) - -{% endwindows %} - -### Alternar entre ramas -Puedes ver y realizar confirmaciones en cualquiera de las ramas de tu repositorio. Si tienes cambios guardados, no confirmados, deberás decidir qué hacer con tus cambios antes de alternar las ramas. Puedes confirmar tus cambios en la rama actual, acumula tus cambios en la rama actual, o lleva los cambios a tu nueva rama. Si quieres confirmar tus cambios en la rama actual, sigue los pasos en [Confirmar y revisar cambios en tu proyecto](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project) antes de alternar entre ramas. - -{% tip %} - -**Consejo**: Puedes configurar un comportamiento predeterminado para alternar entre ramas en la configuración **Avanzada**. Para obtener más información, consulta la sección "[Configurar los ajustes básicos](/desktop/getting-started-with-github-desktop/configuring-basic-settings)". - -{% endtip %} - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.switching-between-branches %} - ![Lista de ramas en el repositorio](/assets/images/help/desktop/click-branch-in-drop-down-mac.png) -3. Si tienes cambios guardados, sin confirmar, elige **Leave my changes** (Dejar mis cambios) o **Bring my changes** (Traer mis cambios) y luego haz clic en **Switch Branch** (Cambiar rama). ![Alternar ramas con opciones de cambios](/assets/images/help/desktop/stash-changes-options.png) - -### Recuperar cambios acumulados -Para acceder a los cambios que has acumulado en otra rama, vuelve a cambiar a la rama en la que acumulaste los cambios. - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.switching-between-branches %} - ![Lista de ramas en el repositorio](/assets/images/help/desktop/click-branch-in-drop-down-mac.png) -3. En la barra lateral a la izquierda, haz clic en **Stashed Changes** (Cambios acumulados). ![Opción de cambios acumulados](/assets/images/help/desktop/stashed-changes.png) -4. Para eliminar tus cambios acumulados, haz clic en **Discard **, o bien, para usar tus cambios acumulados, haz clic en **Restore**. ![Descartar o restaurar cambios acumulados](/assets/images/help/desktop/discard-restore-stash-buttons.png) - -### Cómo eliminar una rama - -No puedes borrar una rama que esté actualmente asociada con una solicitud de extracción abierta. No puedes revertir el haber borrado una rama. - -{% mac %} - -{% data reusables.desktop.select-branch-to-delete %} - ![Menú desplegable para seleccionar qué rama borrar](/assets/images/help/desktop/select-branch-to-delete.png) -{% data reusables.desktop.delete-branch-mac %} - ![Opción de "borrar..." en el menú de la rama](/assets/images/help/desktop/delete-branch-mac.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.select-branch-to-delete %} - ![Menú desplegable para seleccionar qué rama borrar](/assets/images/help/desktop/select-branch-to-delete.png) -{% data reusables.desktop.delete-branch-win %} - ![Opción de "borrar..." en el menú de la rama](/assets/images/help/desktop/delete-branch-win.png) - -{% endwindows %} - -### Leer más - -- [Clonar un repositorio de {% data variables.product.prodname_desktop %}](/desktop/guides/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop) -- "[Rama](/articles/github-glossary/#branch)" en el glosario {% data variables.product.prodname_dotcom %} -- "[Acerca de las ramas](/articles/about-branches)" -- "[Ramas en resumen](https://git-scm.com/book/en/v2/Git-Branching-Branches-in-a-Nutshell)" en la documentación de Git diff --git a/translations/es-XL/content/desktop/contributing-to-projects/managing-tags.md b/translations/es-XL/content/desktop/contributing-to-projects/managing-tags.md deleted file mode 100644 index db2cc9df3a4a..000000000000 --- a/translations/es-XL/content/desktop/contributing-to-projects/managing-tags.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: Administrar etiquetas -intro: 'Puedes utilizar {% data variables.product.prodname_desktop %} para crear, cargar y visualizar etiquetas.' -versions: - free-pro-team: '*' ---- - -### Acerca de las etiquetas en {% data variables.product.prodname_desktop %} - -{% data variables.product.prodname_desktop %} te permite crear etiquetas anotadas. Puedes utilizar una etiqueta para marcar un punto individual en el historial de tu repositorio, incluyendo un número de versión para un lanzamiento. Para obtener más información acerca de las etiquetas de lanzamiento, consulta la sección "[Acerca de los lanzamientos](https://help.github.com/en/github/administering-a-repository/about-releases)". - -{% data reusables.desktop.tags-push-with-commits %} - -### Crear una etiqueta - -{% data reusables.desktop.history-tab %} -{% data reusables.desktop.create-tag %} -{% data reusables.desktop.name-tag %} -{% data reusables.desktop.confirm-tag %} - -### Visualizar etiquetas - -{% data reusables.desktop.history-tab %} -2. Da clic en la confirmación. - {% note %} - - **Nota**: {% data variables.product.prodname_desktop %} muestra una flecha {% octicon "arrow-up" aria-label="The up arrow icon" %} si la etiqueta no se ha subido al repositorio remoto. - - {% endnote %} - - ![Visualizar una etiqueta en el historial](/assets/images/help/desktop/viewing-tags-in-history.png) - -3. Todas las etiquetas asociadas con la confirmación se pueden ver en los metadatos de dicha confirmación. ![Visualizar una etiqueta en la confirmación](/assets/images/help/desktop/viewing-tags-in-commit.png) diff --git a/translations/es-XL/content/desktop/contributing-to-projects/pushing-changes-to-github.md b/translations/es-XL/content/desktop/contributing-to-projects/pushing-changes-to-github.md deleted file mode 100644 index 9b17d98d611e..000000000000 --- a/translations/es-XL/content/desktop/contributing-to-projects/pushing-changes-to-github.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Cargar cambios en GitHub -shortTitle: Cargar cambios -intro: 'De manera que confirmes cambios localmente en tu proyecto, puedes cargarlos a {% data variables.product.prodname_dotcom %} para que otros puedan acceder a ellos desde el repositorio remoto.' -permissions: Las personas con permisos de escritura pueden cargar cambios a un repositorio. -versions: - free-pro-team: '*' ---- - -### Acerca de cargar cambios a {% data variables.product.prodname_dotcom %} - -Cuando cargas cambios, envías los cambios confirmados en tu repositorio local al repositorio remoto en {% data variables.product.prodname_dotcom %}. Si cambias tu proyecto localmente y quieres que otros tengan acceso a los cambios, deberás cargar los cambios a {% data variables.product.prodname_dotcom %}. - -Antes de cargar los cambios, debes actualizar tu rama local para que incluya cualquier confirmación que se haya agregado al repositorio remoto. Si alguien hizo confirmaciones en la rama remota, las cuales no están en tu rama local, {% data variables.product.prodname_desktop %} te solicitará conseguir las confirmaciones nuevas antes de cargar tus cambios para evitar conflictos de fusión. Para obtener más información, consulta la sección "[Sincronizar tu rama](/desktop/contributing-to-projects/syncing-your-branch)". - -{% data reusables.desktop.protected-branches %} - -### Cargar cambios a {% data variables.product.prodname_dotcom %} - -{% note %} - -**Nota:** {% data variables.product.prodname_desktop %} rechazará una carga si excede ciertos límites. - -- Una carga contiene un archivo grande de más de 100MB de tamaño. -- Una carga es mayor a 2GB en su tamaño total. - -{% endnote %} - -{% data reusables.desktop.push-origin %} -2. Si {% data variables.product.prodname_desktop %} te pide traer las confirmaciones nuevas de la rama remota, da clic en **Recuperar**. ![El botón de recuperar](/assets/images/help/desktop/fetch-newer-commits.png) -3. Opcionalmente, da clic en **Crear Solicitud de Extracción** para abrir una solicitud de extracción y colaborar en tus cambios. Para obtener más información, consulta la sección "[Crear un informe de problemas o solicitud de extracción](/desktop/contributing-to-projects/creating-an-issue-or-pull-request)" ![El botón de crear solicitud de extracción](/assets/images/help/desktop/create-pull-request.png) - -### Leer más -- "[Cargar](/github/getting-started-with-github/github-glossary/#push)" en el glosario de {% data variables.product.prodname_dotcom %} -- "[Confirmar y revisar los cambios hechos a tu proyecto](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project)" diff --git a/translations/es-XL/content/desktop/contributing-to-projects/reverting-a-commit.md b/translations/es-XL/content/desktop/contributing-to-projects/reverting-a-commit.md deleted file mode 100644 index 8c980305d2d1..000000000000 --- a/translations/es-XL/content/desktop/contributing-to-projects/reverting-a-commit.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: Revertir una confirmación -intro: Puedes revertir una confirmación específica para eliminar los cambios de tu rama. -versions: - free-pro-team: '*' ---- - -Cuando reviertes la confirmación anterior, la reversión también es una confirmación. La confirmación original también permanece en el historial del repositorio. - -{% tip %} - -**Sugerencia:** Cuando reviertes múltiples confirmaciones, es mejor revertirlas desde la más nueva hasta la más antigua. Si reviertes confirmaciones en un orden diferente, es posible que se produzcan conflictos de fusión. - -{% endtip %} - -{% mac %} - -{% data reusables.desktop.history-tab %} -{% data reusables.desktop.revert-commit %} - ![La opción Revert (Revertir) sobre la vista diferente](/assets/images/help/desktop/commit-revert-mac.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.history-tab %} -{% data reusables.desktop.revert-commit %} - ![La opción Revert (Revertir) sobre la vista diferente](/assets/images/help/desktop/commit-revert-win.png) - -{% endwindows %} diff --git a/translations/es-XL/content/desktop/contributing-to-projects/switching-between-branches.md b/translations/es-XL/content/desktop/contributing-to-projects/switching-between-branches.md deleted file mode 100644 index 09ac8be37dba..000000000000 --- a/translations/es-XL/content/desktop/contributing-to-projects/switching-between-branches.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: Alternar entre ramas -intro: Puedes ver y realizar confirmaciones en cualquiera de las ramas de tu repositorio. -versions: - free-pro-team: '*' ---- - -### Alternar entre ramas -Si tienes cambios guardados, no confirmados, deberás decidir qué hacer con tus cambios antes de alternar las ramas. Puedes confirmar tus cambios en la rama actual, acumula tus cambios en la rama actual, o lleva los cambios a tu nueva rama. Si quieres confirmar tus cambios en la rama actual, sigue los pasos en [Confirmar y revisar cambios en tu proyecto](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project) antes de alternar entre ramas. - -{% tip %} - -**Consejo**: Puedes configurar un comportamiento predeterminado para alternar entre ramas en la configuración **Avanzada**. Para obtener más información, consulte “[Configurar las opciones básicas](/desktop/getting-started-with-github-desktop/configuring-basic-settings)". - -{% endtip %} - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.switching-between-branches %} - ![Lista de ramas en el repositorio](/assets/images/help/desktop/click-branch-in-drop-down-mac.png) -3. Si tienes cambios guardados, sin confirmar, elige **Leave my changes** (Dejar mis cambios) o **Bring my changes** (Traer mis cambios) y luego haz clic en **Switch Branch** (Cambiar rama). ![Alternar ramas con opciones de cambios](/assets/images/help/desktop/stash-changes-options.png) - -### Recuperar cambios acumulados -Para acceder a los cambios que has acumulado en otra rama, vuelve a cambiar a la rama en la que acumulaste los cambios. - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.switching-between-branches %} - ![Lista de ramas en el repositorio](/assets/images/help/desktop/click-branch-in-drop-down-mac.png) -3. En la barra lateral a la izquierda, haz clic en **Stashed Changes** (Cambios acumulados). ![Opción de cambios acumulados](/assets/images/help/desktop/stashed-changes.png) -4. Para eliminar tus cambios acumulados, haz clic en **Discard **, o bien, para usar tus cambios acumulados, haz clic en **Restore**. ![Descartar o restaurar cambios acumulados](/assets/images/help/desktop/discard-restore-stash-buttons.png) diff --git a/translations/es-XL/content/desktop/contributing-to-projects/syncing-your-branch.md b/translations/es-XL/content/desktop/contributing-to-projects/syncing-your-branch.md deleted file mode 100644 index 48263b45eb15..000000000000 --- a/translations/es-XL/content/desktop/contributing-to-projects/syncing-your-branch.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: Sincronizar tu rama -intro: 'Tus confirmaciones suben a tu proyecto en {% data variables.product.prodname_dotcom %}, puedes conservar una copia local del proyecto en sincronía con el repositorio remoto.' -versions: - free-pro-team: '*' ---- - -Debes sincronizar tu rama local con el repositorio remoto para obtener las confirmaciones adicionales que se agregaron a la rama ascendente desde que [creaste tu rama](/desktop/guides/contributing-to-projects/managing-branches) originalmente. - -### Actualizar tu rama local - -1. En {% data variables.product.prodname_desktop %}, alterna a la rama local que deseas actualizar haciendo clic en {% octicon "git-branch" aria-label="The branch icon" %}**Current Branch** (Rama actual) y seleccionando la rama de la lista. -2. Haz clic en **Fetch origin** (Extraer origen) para actualizar tu rama. ![El botón Fetch origin (Buscar origen)](/assets/images/help/desktop/fetch-button.png) -3. Si hay confirmaciones en la rama remota, puedes extraerlas haciendo clic en **Pull origin** (Extraer origen) o **Pull origin with rebase** (Extraer origen con rebase). ![El botón Pull origin (Extraer origen)](/assets/images/help/desktop/pull-button.png) -{% data reusables.desktop.resolve-merge-conflicts %} - -### Fusionar otra rama en tu rama de proyecto - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.choose-a-branch-to-merge %} -{% data reusables.desktop.confirm-merging-branch %} - - {% note %} - - **Nota:** Si hay conflictos de fusión, {% data variables.product.prodname_desktop %} te advertiremos sobre **Merge BRANCH (Fusionar RAMA) en el botón BRANCH** (RAMA). No podrás fusionar las ramas hasta que hayas resuelto todos los conflictos. - - {% endnote %} - - ![El botón Merge (Fusionar)](/assets/images/help/desktop/merge-branch-button.png) -{% data reusables.desktop.push-origin %} - -### Rebasa tu rama de proyecto en otra rama -Algunos flujos de trabajo requieren o se benefician a partir de un rebase en contraposición a una fusión. Al rebasar podemos reordenar, editar o combinar confirmaciones. Para obtener más información, consulta [Accerca del rebase de Git](/articles/about-git-rebase)." - -1. Usa el desplegable ** Branch** y haz clic en **Rebase Current Branch**. ![Rebase Current Branch (Rebasar rama actual) en el desplegable de rama](/assets/images/help/desktop/rebase-current-branch.png) -2. Haz clic en la rama que deseas rebasar en la rama actual, luego haz clic en **Start rebase**. ![Botón Start rebase (Iniciar rebase)](/assets/images/help/desktop/start-rebase-button.png) -3. Si estás seguro de que deseas rebasar, haz clic en **Begin rebase** (Comenzar rebase). ![Botón Begin rebase (Comenzar rebase)](/assets/images/help/desktop/begin-rebase-button.png) -{% data reusables.desktop.resolve-merge-conflicts %} -4. Para extraer tus cambios locales, haz clic en **Force push origin** (Origen de empuje forzado). ![Origen de empuje forzado](/assets/images/help/desktop/force-push-origin.png) diff --git a/translations/es-XL/content/desktop/contributing-to-projects/viewing-the-branch-history.md b/translations/es-XL/content/desktop/contributing-to-projects/viewing-the-branch-history.md deleted file mode 100644 index 0195ba32f75a..000000000000 --- a/translations/es-XL/content/desktop/contributing-to-projects/viewing-the-branch-history.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: Visualizar el historial de ramas -intro: 'Puedes ver los detalles de cualquier confirmación en {% data variables.product.prodname_desktop %}, incluyendo una diferencia de los cambios introducidos por la confirmación.' -versions: - free-pro-team: '*' ---- - -Cada confirmación muestra: - - - El mensaje de confirmación - - La hora en que se creó la confirmación - - El nombre de usuario y la foto de perfil (si está disponible) de la persona que confirma el cambio - - El hash SHA-1 de la confirmación (el ID exclusivo) - -{% data reusables.desktop.history-tab %} -2. En la pestaña **History** (Historial), haz clic en la confirmación que deseas revisar. ![Una confirmación en la pestaña History (Historial)](/assets/images/help/desktop/branch-history-commit.png) -3. Si existen múltiples archivos en la confirmación, haz clic en un archivo individual para ver los cambios que se realizan a ese archivo en esa confirmación. ![Un archivo en la confirmación](/assets/images/help/desktop/branch-history-file.png) - -### Leer más - -- [Sincronizar tu rama](/desktop/guides/contributing-to-projects/syncing-your-branch/)" diff --git a/translations/es-XL/content/desktop/contributing-to-projects/working-with-your-remote-repository-on-github-or-github-enterprise.md b/translations/es-XL/content/desktop/contributing-to-projects/working-with-your-remote-repository-on-github-or-github-enterprise.md deleted file mode 100644 index aa2f80e9f704..000000000000 --- a/translations/es-XL/content/desktop/contributing-to-projects/working-with-your-remote-repository-on-github-or-github-enterprise.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: Trabajar con tu repositorio remoto en GitHub o GitHub Enterprise -intro: 'A medida que realizas cambios a tu proyecto localmente, puedes mantenerlos actualizados con tu repositorio remoto. En Git, *remoto* hace referencia al servidor donde se almacena tu código. En tu caso, ese servidor es un repositorio en {% data variables.product.prodname_dotcom %} o {% data variables.product.prodname_enterprise %}.' -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/es-XL/content/desktop/getting-started-with-github-desktop/about-the-github-desktop-windows-installer-package.md b/translations/es-XL/content/desktop/getting-started-with-github-desktop/about-the-github-desktop-windows-installer-package.md deleted file mode 100644 index 3491a748cea9..000000000000 --- a/translations/es-XL/content/desktop/getting-started-with-github-desktop/about-the-github-desktop-windows-installer-package.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Acerca del paquete de GitHub Desktop Windows Installer -intro: 'Como administrador de red puedes usar el archivo del paquete de Windows Installer (`.msi`) con Group Policiy u otro sistema de instalación remota para implementar {% data variables.product.prodname_desktop %} en las computadoras con Microsoft Windows en una red administrada de Active Directory.' -versions: - free-pro-team: '*' ---- - -El paquete de Windows Installer extrae el instalador (`.exe`) independiente y configura Windows para que instale {% data variables.product.prodname_desktop %} cuando el próximo usuario inicie sesión en su estación de trabajo. Los usuarios deben tener permisos para instalar {% data variables.product.prodname_desktop %} en su directorio de usuario. - -Si un usuario ejecuta el paquete de Windows Installer {% data variables.product.prodname_desktop %} directamente, deberá cerrar sesión y volver a su estación de trabajo para completar la instalación. diff --git a/translations/es-XL/content/desktop/getting-started-with-github-desktop/authenticating-to-github.md b/translations/es-XL/content/desktop/getting-started-with-github-desktop/authenticating-to-github.md deleted file mode 100644 index c4a59a41bab0..000000000000 --- a/translations/es-XL/content/desktop/getting-started-with-github-desktop/authenticating-to-github.md +++ /dev/null @@ -1,65 +0,0 @@ ---- -title: Autenticar a GitHub -intro: 'Conecta tu cuenta de {% data variables.product.product_name %} a {% data variables.product.prodname_desktop %}.' -redirect_from: - - /desktop/getting-started-with-github-desktop/authenticating-to-github-using-the-browser -versions: - free-pro-team: '*' ---- - -Antes de realizar la autenticación, {% data reusables.desktop.get-an-account %} - -{% mac %} - -### Autenticarse en {% data variables.product.prodname_dotcom %} utilizando el buscador - -{% data reusables.desktop.mac-select-desktop-menu %} -{% data reusables.desktop.mac-select-accounts %} -4. A la derecha de "{% data variables.product.prodname_dotcom %}", da clic en **Iniciar sesión**. ![El botón Sign In (Iniciar sesión) para GitHub Enterprise](/assets/images/help/desktop/mac-sign-in-github.png) -5. En el panel de inicio de sesión, haz clic en **Sign in using your browser** (Iniciar sesión usando el navegador). ![Inicio de sesión mediante el enlace de su navegador](/assets/images/help/desktop/mac-sign-in-browser.png) -{% data reusables.desktop.authenticate-in-browser %} -{% data reusables.desktop.retrieve-2fa-in-browser %} -{% data reusables.desktop.enter-2fa-in-browser %} -9. Luego de que {% data variables.product.prodname_dotcom %} autentica tu cuenta, vuelve a {% data variables.product.prodname_desktop %}. - -### Autenticarse en {% data variables.product.prodname_dotcom %} utilizando tu nombre de usuario y contraseña - -{% data reusables.user_settings.password-authentication-deprecation-desktop %} - -{% data reusables.desktop.mac-select-desktop-menu %} -{% data reusables.desktop.mac-select-accounts %} -{% data reusables.desktop.choose-product-authenticate %} -5. Para agregar una cuenta a GitHub Enterprise, escribe tus credenciales debajo de "Enterprise server address" (Dirección de servidor empresarial) y luego haz clic en **Continue** (Continuar). ![El botón Sign In (Iniciar sesión) para GitHub Enterprise](/assets/images/help/desktop/mac-sign-in-button-enterprise.png) -6. Para agregar una cuenta GitHub, escribe tus credenciales de GitHub.com y haz clic en **Sign in** (Iniciar sesión). ![El botón Sign In (Iniciar sesión) para GitHub Enterprise](/assets/images/help/desktop/mac-sign-in-button.png) -{% data reusables.desktop.retrieve-2fa %} -{% data reusables.desktop.return-to-desktop %} Si se solicita, escribe tu código 2FA y luego haz clic en **Sign in** (Iniciar sesión). ![La indicación del código 2FA](/assets/images/help/desktop/mac-2fa-code-prompt.png) - -{% endmac %} - -{% windows %} - -### Autenticarse en {% data variables.product.prodname_dotcom %} utilizando el buscador - -{% data reusables.desktop.windows-choose-options %} -{% data reusables.desktop.windows-select-accounts %} -4. A la derecha de "GitHub.com", da clic en **Iniciar sesión**. ![El botón Sign In (Iniciar sesión) para GitHub Enterprise](/assets/images/help/desktop/windows-sign-in-github.png) -5. En el panel de inicio de sesión, haz clic en **Sign in using your browser** (Iniciar sesión usando el navegador). ![Inicio de sesión mediante el enlace de su navegador](/assets/images/help/desktop/windows-sign-in-browser.png) -{% data reusables.desktop.authenticate-in-browser %} -{% data reusables.desktop.retrieve-2fa-in-browser %} -{% data reusables.desktop.enter-2fa-in-browser %} -9. Luego de que {% data variables.product.prodname_dotcom %} autentica tu cuenta, vuelve a {% data variables.product.prodname_desktop %}. - -### Autenticarse en {% data variables.product.prodname_dotcom %} utilizando tu nombre de usuario y contraseña - - -{% data reusables.user_settings.password-authentication-deprecation-desktop %} - -{% data reusables.desktop.windows-choose-options %} -{% data reusables.desktop.windows-select-accounts %} -{% data reusables.desktop.choose-product-authenticate %} -5. Para agregar una cuenta a GitHub Enterprise, escribe tus credenciales debajo de "Enterprise server address" (Dirección de servidor empresarial) y luego haz clic en **Continue** (Continuar). ![El botón Sign In (Iniciar sesión) para GitHub Enterprise](/assets/images/help/desktop/windows-sign-in-button-enterprise.png) -6. Para agregar una cuenta GitHub, escribe tus credenciales de GitHub.com y haz clic en **Sign in** (Iniciar sesión). ![El botón Sign In (Iniciar sesión) para GitHub Enterprise](/assets/images/help/desktop/windows-sign-in-button.png) -{% data reusables.desktop.retrieve-2fa %} -{% data reusables.desktop.return-to-desktop %} Si se solicita, escribe tu código 2FA y luego haz clic en **Sign in** (Iniciar sesión). ![La indicación del código 2FA](/assets/images/help/desktop/windows-2fa-code-prompt.png) - -{% endwindows %} diff --git a/translations/es-XL/content/desktop/getting-started-with-github-desktop/configuring-a-default-editor.md b/translations/es-XL/content/desktop/getting-started-with-github-desktop/configuring-a-default-editor.md deleted file mode 100644 index b42e8b1adbfc..000000000000 --- a/translations/es-XL/content/desktop/getting-started-with-github-desktop/configuring-a-default-editor.md +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: Configurar un editor predeterminado -intro: Puedes configurar GitHub Desktop para abrir archivos en tu proyecto con tu editor de texto o ambiente de desarrollo integrado (IDE) preferidos. -versions: - free-pro-team: '*' ---- - -### Editores compatibles - -{% data variables.product.prodname_desktop %} es compatible con los siguientes editores. - -{% mac %} - -- [Atom](https://atom.io/) -- [MacVim](https://macvim-dev.github.io/macvim/) -- [Visual Studio Code](https://code.visualstudio.com/) -- [Visual Studio Codium](https://vscodium.com/) -- [Sublime Text](https://www.sublimetext.com/) -- [BBEdit](http://www.barebones.com/products/bbedit/) -- [JetBrains WebStorm](https://www.jetbrains.com/webstorm/) -- [JetBrains PhpStorm](https://www.jetbrains.com/phpstorm/) -- [JetBrains Rider](https://www.jetbrains.com/rider/) -- [JetBrains PyCharm](https://www.jetbrains.com/pycharm/) -- [JetBrains RubyMine](https://www.jetbrains.com/rubymine/) -- [JetBrains IntelliJ IDEA](https://www.jetbrains.com/idea/) -- [JetBrains GoLand](https://www.jetbrains.com/go/) -- [TextMate](https://macromates.com/) -- [Brackets](http://brackets.io/) - - Para utilizar Brackets con {% data variables.product.prodname_desktop %}, debes instalar el atajo de la línea de comandos. Para instalar el atajo, abre Brackets, da clic en **Archivo** en la barra de menú y luego da clic en **Instalar Atajo para la Línea de Comandos**. -- [Typora](https://typora.io/) -- [CodeRunner](https://coderunnerapp.com/) -- [SlickEdit](https://www.slickedit.com/) -- [Xcode](https://developer.apple.com/xcode/) -- [Android Studio](https://developer.android.com/studio) - -{% endmac %} - -{% windows %} - -- [Átomo](https://atom.io/) -- [Visual Studio Code](https://code.visualstudio.com/) -- [Visual Studio Codium](https://vscodium.com/) -- [Sublime Text](https://www.sublimetext.com/) -- [ColdFusion Builder](https://www.adobe.com/products/coldfusion-builder.html) -- [Typora](https://typora.io/) -- [SlickEdit](https://www.slickedit.com/) -- [JetBrains WebStorm](https://www.jetbrains.com/webstorm/) -- [JetBrains PhpStorm](https://www.jetbrains.com/phpstorm/) -- [JetBrains Rider](https://www.jetbrains.com/rider/) -- [Notepad++](https://notepad-plus-plus.org/) - -{% endwindows %} - -### Configurar un editor predeterminado - -{% mac %} - -{% data reusables.desktop.mac-select-desktop-menu %} -3. En la ventana de preferencias, selecciona **Integrations** (integraciones). ![El panel de Integraciones en la ventana de Preferencias](/assets/images/help/desktop/mac-select-integrations-pane.png) -4. Utiliza el menú desplegable de "Editor Externo" y elige el editor que quieras configurar como predeterminado. ![El menú External editor (Editor externo) en la barra del menú Preferences (Preferencias)](/assets/images/help/desktop/mac-editor-menu.png) -5. Haz clic en **Save** (Guardar). - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.windows-choose-options %} -3. En la ventana de Opciones, seleccione **Integrations** (integraciones). ![El panel de Integraciones en la ventana de Opciones](/assets/images/help/desktop/windows-select-integrations-pane.png) -4. Utiliza el menú desplegable de "Editor Externo" y elige el editor que quieras configurar como predeterminado. ![El menú External editor (Editor externo) en la barra del menú Options (Opciones)](/assets/images/help/desktop/windows-editor-menu.png) -5. Haz clic en **Save** (Guardar). - -{% endwindows %} diff --git a/translations/es-XL/content/desktop/getting-started-with-github-desktop/configuring-and-customizing-github-desktop.md b/translations/es-XL/content/desktop/getting-started-with-github-desktop/configuring-and-customizing-github-desktop.md deleted file mode 100644 index ebe6cd522118..000000000000 --- a/translations/es-XL/content/desktop/getting-started-with-github-desktop/configuring-and-customizing-github-desktop.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: Configurar y personalizar GitHub Desktop -intro: 'Cómo configurar Git, conectar tu editor predeterminado y personalizar las opciones para alinear GitHub Desktop con tu flujo de trabajo.' -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/es-XL/content/desktop/getting-started-with-github-desktop/configuring-basic-settings.md b/translations/es-XL/content/desktop/getting-started-with-github-desktop/configuring-basic-settings.md deleted file mode 100644 index 3158470123cc..000000000000 --- a/translations/es-XL/content/desktop/getting-started-with-github-desktop/configuring-basic-settings.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: Configurar parámetros básicos -intro: 'Puedes acceder a la configuración para proteger tu privacidad, conectar cuentas a GitHub Desktop, y configurar Git.' -versions: - free-pro-team: '*' ---- - -{% mac %} - -{% data reusables.desktop.mac-select-desktop-menu %} -3. Para ver o cambiar tu configuración, alterna entre estos paneles:![La navegación por el menú Preferences (Preferencias)](/assets/images/help/desktop/mac-select-accounts-pane.png) -{% data reusables.desktop.preferences-options-tabs %} - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.windows-choose-options %} -2. Para ver o cambiar tu configuración, alterna entre estos paneles: ![La navegación por el menú Options (Opciones)](/assets/images/help/desktop/windows-select-accounts-pane.png) -{% data reusables.desktop.preferences-options-tabs %} - -{% endwindows %} - -### Leer más - -- "[Configurar un tema para {% data variables.product.prodname_desktop %}](/desktop/guides/getting-started-with-github-desktop/setting-a-theme-for-github-desktop)" diff --git a/translations/es-XL/content/desktop/getting-started-with-github-desktop/configuring-git-for-github-desktop.md b/translations/es-XL/content/desktop/getting-started-with-github-desktop/configuring-git-for-github-desktop.md deleted file mode 100644 index 993ff003cfda..000000000000 --- a/translations/es-XL/content/desktop/getting-started-with-github-desktop/configuring-git-for-github-desktop.md +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: Configurar Git para GitHub Desktop -shortTitle: Configuring Git -intro: 'Si todavía no tienes Git instalado, debes configurarlo antes de usar GitHub Desktop.' -versions: - free-pro-team: '*' ---- - -{% data variables.product.prodname_desktop %} uses the email address you set in your local Git configuration to connect commits with your account on {% data variables.product.product_name %}. - -{% data reusables.desktop.update-email-address %} - -{% tip %} - -**Tip**: Cualquiera podrá ver la dirección de correo electrónico en tu configuración de Git si haces confirmaciones públicas. Para obtener más información, consulta "[Establecer tu dirección de correo electrónico de confirmación](/articles/setting-your-commit-email-address)." - -{% endtip %} - -{% mac %} - -{% data reusables.desktop.sign-in-choose-product %} -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.emails %} -{% data reusables.desktop.copy-email-git-config %} -{% data reusables.desktop.return-to-desktop %} -{% data reusables.desktop.mac-select-desktop-menu %} -7. In the Preferences window, click **Git**. ![El panel de Git en el menú Preferences (Preferencias)](/assets/images/help/desktop/mac-select-git-pane.png) -{% data reusables.desktop.name-field-git-config %} - ![El campo con el nombre de la configuración de Git](/assets/images/help/desktop/mac-name-git-config.png) -{% data reusables.desktop.paste-email-git-config %} - ![La dirección de correo electrónico copiada en el campo de configuración de Git](/assets/images/help/desktop/mac-email-git-config.png) -{% data reusables.desktop.click-save-git-config %} - ![Save button in Git configuration field](/assets/images/help/desktop/mac-save-git-config.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.sign-in-choose-product %} -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.emails %} -{% data reusables.desktop.copy-email-git-config %} -{% data reusables.desktop.return-to-desktop %} -{% data reusables.desktop.windows-choose-options %} -8. In the Options window, click **Git**. ![El panel de Git en el menú Options (Opciones)](/assets/images/help/desktop/windows-select-git-pane.png) -{% data reusables.desktop.name-field-git-config %} - ![El campo con el nombre de la configuración de Git](/assets/images/help/desktop/windows-name-git-config.png) -{% data reusables.desktop.paste-email-git-config %} - ![La dirección de correo electrónico copiada en el campo de configuración de Git](/assets/images/help/desktop/windows-email-git-config.png) -{% data reusables.desktop.click-save-git-config %} - ![Save button in Git configuration field](/assets/images/help/desktop/windows-save-git-config.png) - -{% endwindows %} - -### Leer más - -- [Agregar una dirección de correo electrónico a tu cuenta de GitHub](/articles/adding-an-email-address-to-your-github-account/)" -- "[Establecer tu dirección de correo electrónico de confirmación](/articles/setting-your-commit-email-address)." diff --git a/translations/es-XL/content/desktop/getting-started-with-github-desktop/creating-your-first-repository-using-github-desktop.md b/translations/es-XL/content/desktop/getting-started-with-github-desktop/creating-your-first-repository-using-github-desktop.md deleted file mode 100644 index bde2d7a424dc..000000000000 --- a/translations/es-XL/content/desktop/getting-started-with-github-desktop/creating-your-first-repository-using-github-desktop.md +++ /dev/null @@ -1,98 +0,0 @@ ---- -title: Crear el primer repositorio mediante GitHub Desktop -intro: 'Puedes usar {% data variables.product.prodname_desktop %} para comenzar a trabajar rápidamente con un repositorio Git sin necesidad de usar la línea de comando.' -versions: - free-pro-team: '*' ---- - -### Introducción - -Esta guía te orientará a través del proceso de uso de {% data variables.product.prodname_desktop %} para trabajar en un repositorio Git. {% data variables.product.prodname_desktop %} se extiende y simplifica tu flujo de trabajo {% data variables.product.prodname_dotcom_the_website %}, usando una interfaz visual en lugar de comandos de texto en la línea de comandos. Al final de esta guía, habrás usado {% data variables.product.prodname_desktop %} para crear un repositorio, realizar cambios al repositorio, y publicar los cambios en {% data variables.product.prodname_dotcom_the_website %} o {% data variables.product.prodname_ghe_server %}. - -Después de descargar {% data variables.product.prodname_desktop %} e iniciar sesión en {% data variables.product.prodname_dotcom %} o {% data variables.product.prodname_enterprise %} puedes crear y clonar un repositorio de tutorial. El tutorial introducirá los aspectos básicos del trabajo con Git y {% data variables.product.prodname_dotcom %}, que incluye la instalación de un editor, la creación de una rama, la generación de una confirmación, la extracción de {% data variables.product.prodname_dotcom_the_website %}, y la creación de una solicitud de extracción. El tutorial está disponible mientras no tengas ningún repositorio en {% data variables.product.prodname_desktop %}. - -### Paso 1. Instalar e iniciar sesión en {% data variables.product.prodname_desktop %} - -1. Descarga {% data variables.product.prodname_desktop %} de {% data variables.product.desktop_link %}. {% data variables.product.prodname_desktop %} soporta las versiones recientes de Windows y macOS. Para conocer las instrucciones de instalación específicas para tu sistema operativo, consulta [Instalar {% data variables.product.prodname_desktop %}](/desktop/getting-started-with-github-desktop/installing-github-desktop)." - -2. Abre {% data variables.product.prodname_desktop %} y sigue el flujo de bienvenida inicial para iniciar sesión en tu cuenta de {% data variables.product.product_name %}. Verás un paso "Configure Git" (Configurar Git), donde puedes configurar tu nombre y dirección de correo electrónico. Para asegurarte de que tus confirmaciones se atribuyan correctamente a tu cuenta de {% data variables.product.product_name %}, usa la dirección de correo electrónico asociada a tu cuenta de {% data variables.product.product_name %}. Para obtener más información, consulta "[Establecer tu dirección de correo electrónico de confirmación](/articles/setting-your-commit-email-address)." - -### Paso 2. Crear un repositorio nuevo - -Verás una vista "Let's get started!" (¡Comencemos"), donde puedes elegir si deseas crear y clonar un repositorio de tutorial, crear un repositorio nuevo o agregar un repositorio existente. - -#### Crear y clonar un repositorio de tutorial - -1. Haz clic en **Create a tutorial repository and clone it** (Crear un repositorio de tutorial y clonarlo). ![Crear y clonar un botón de repositorio de tutorial](/assets/images/help/desktop/getting-started-guide/create-and-clone-a-tutorial-repository.png) -2. Sigue las instrucciones en el tutorial. - -#### Crear un repositorio nuevo - -1. Haz clic en **Crear un nuevo repositorio en tu disco duro...** ![Crear un repositorio nuevo](/assets/images/help/desktop/getting-started-guide/creating-a-repository.png) -2. Para crear un repositorio nuevo, completa los campos: ![Crear un repositorio de opciones](/assets/images/help/desktop/getting-started-guide/create-a-new-repository-options.png) - - "Name" (Nombre) define el nombre de tu repositorio a nivel local y en {% data variables.product.product_name %}. - - "Description" (Descripción) es un campo opcional que puedes usar para brindar más información sobre el objetivo de tu repositorio. - - "Local path" (Ruta local) establece la ubicación de tu repositorio en tu computadora. De manera predeterminada, {% data variables.product.prodname_desktop %} crea una carpeta _GitHub_ en tu carpeta _Documents_ (Documentos) para almacenar tus repositorios, pero puedes elegir cualquier ubicación en tu computadora. Tu nuevo repositorio será una carpeta dentro de la ubicación elegida. Por ejemplo, si colocas el nombre `Tutorial` a tu repositorio, se creará la carpeta _Tutorial_ dentro de la carpeta que seleccionaste en tu ruta local. {% data variables.product.prodname_desktop %} recuerda tu ubicación elegida la próxima vez que crees o clones un repositorio nuevo. - - **Si inicializas este repositorio con un README** (Léeme), se crea una confirmación inicial con un archivo _README.md_. README ayuda a las personas a comprender el objetivo de tu proyecto, por lo que recomendamos seleccionarlo y completarlo con información útil. Cuando alguien visita tu repositorio en {% data variables.product.product_name %}, el archivo README es lo primero que verán a medida que aprenden sobre tu proyecto. Para obtener más información, consulta "[Acerca de los archivos README](/articles/about-readmes/)". - - El menú desplegable **Git ignore** (Ignorar Git) te permite agregar un archivo personalizado para ignorar los archivos específicos en tu repositorio local que no deseas almacenar en el control de la versión. Si existe un idioma o encuadre específico que estarás usando, puedes seleccionar una opción desde la lista disponible. Si recién estás comenzando, puedes omitir esta selección. Para obtener más información, consulta "[Ignorar archivos](/articles/ignoring-files)". - - El menú desplegable **License** (Licencia) te permite agregar una licencia de código abierto para un archivo _LICENSE_ (Licencia) en tu repositorio. No tienes que preocuparte por aprender cómo agregar una licencia inmediatamente. Para obtener más información sobre las licencias de código abierto disponibles y cómo agregarlas a tu repositorio, consulta "[Licenciar un repositorio](/articles/licensing-a-repository)". -3. Haz clic en **Crear repositorio**. - -### Paso 3. Explorar {% data variables.product.prodname_desktop %} - -Ahora que has creado un repositorio, verás un menú de archivo en la parte superior de la pantalla. Allí es donde puedes acceder a la configuración y las acciones que puedes realizar en {% data variables.product.prodname_desktop %}. La mayoría de las acciones tienen atajos del teclado para ayudarte a trabajar con más eficacia. Para encontrar un listado completo de atajos de teclado, consulta la sección "[Atajos de teclado](/desktop/getting-started-with-github-desktop/keyboard-shortcuts)". - -1. Debajo del menú se encuentra una barra que muestra el estado actual del repositorio en {% data variables.product.prodname_desktop %}: - - **Current repository** (Repositorio actual) muestra el nombre del repositorio en el que estás trabajando. Puedes hacer clic en **Current repository** (Repositorio actual) para alternar a un repositorio diferente en {% data variables.product.prodname_desktop %}. - - **Current branch** (Rama actual) muestra el nombre de la rama en la que estás trabajando. Puedes hacer clic en **Current branch** (Rama actual) para ver todas las ramas en tu repositorio, alternar a una rama diferente o crear una rama nueva. Una vez que creaste solicitud de extracción en tu repositorio, también puedes verlas haciendo clic en **Current branch** (Rama actual). - - **Publish repository** (Publicar repositorio) aparece porque todavía no has publicado tu repositorio en {% data variables.product.product_name %}. que harás a continuación en el próximo paso. - - ![Explorar el escritorio de GitHub](/assets/images/help/desktop/getting-started-guide/explore-github-desktop.png) - -2. En la barra lateral a la izquierda, encontrarás la vista **Changes** (Cambios) y la vista**History** (Historial). - - - La vista **Changes** (Cambios) muestra los cambios que realizaste a los archivos en tu rama actual pero aún no confirmaste en tu repositorio local. En la parte inferior, advertirás un cuadro con los cuadros de texto "Summary" (Resumen) y "Description" (Descripción) y un botón **Commit to master** (Confirmar en principal). Aquí es donde confirmarás los campos nuevos. El botón **Commit** (Confirmar) te permite saber en qué rama estás confirmando los cambios. ![Área de confirmación de cambios](/assets/images/help/desktop/getting-started-guide/commit-area.png) - - - La vista **History** (Historial) muestra las confirmaciones previas en la rama actual de tu repositorio. Deberías ver una "Initial commit" (Confirmación inicial) que fue creada por {% data variables.product.prodname_desktop %} cuando creaste tu repositorio. A la derecha de la confirmación, según las opciones que seleccionaste al crear tu repositorio, es posible que veas los archivos _.gitattributes_, _.gitignore_, _LICENSE_, o _README_. Puedes hacer clic en cada archivo para ver una diferencia para ese archivo, que son los cambios realizados en el archivo en esa confirmación. La diferencia solo muestra las partes del archivo que han cambiado, no slo los contenidos completos del archivo. ![Vista de historial](/assets/images/help/desktop/getting-started-guide/history-view.png) - -### Paso 4. Subir tu repositorio a {% data variables.product.product_name %} - -Actualmente, tu repositorio solo existe en tu computadora, y eres el único que puede acceder al repositorio. Al publicar tu repositorio en {% data variables.product.product_name %} se mantiene actualizado con múltiples computadoras y miembros del equipo en el mismo proyecto. Para publicar el repositorio, lo "subirás" a {% data variables.product.product_name %}, lo que permite que también esté disponible en {% data variables.product.prodname_dotcom_the_website %}. - -1. Haz clic en **Publish repository** (Publicar repositorio). ![Publicar repositorio](/assets/images/help/desktop/getting-started-guide/publish-repository.png) - - Verás algunos campos familiares. "Name" (Nombre) y "Description" (Descripción) coinciden con los campos completados cuando creaste el repositorio. - - Verás la opción **Keep this code private** (Mantener la privacidad de este código). Selecciona esta opción si no deseas compartir tu código públicamente con otros usuarios en {% data variables.product.product_name %}. - - El desplegable **Organization** (Organización), si está presente, te permite publicar tu repositorio a una organización específica a la que perteneces en {% data variables.product.product_name %}. No hay problemas si todavía no eres miembro de una organización. ![Publicar pasos del repositorio](/assets/images/help/desktop/getting-started-guide/publish-repository-steps.png) -2. Haz clic en **Publish repository** (Publicar repositorio). -3. Puedes acceder al repositorio en {% data variables.product.prodname_dotcom_the_website %} desde el interior de {% data variables.product.prodname_desktop %}. En el menú del archivo, haz clic en **Repository** (Repositorio), luego haz clic en **View on GitHub** (Ver en GitHub). Esto te llevará directamente hasta el repositorio en tu navegador predeterminado. - -Ahora que el repositorio está publicado, volvamos a {% data variables.product.prodname_desktop %} y realicemos más cambios a tu repositorio local. En primer lugar, repasaremos la configuración de un editor de texto predeterminado. - -### Paso 5. Configurar un editor de texto - -Para reducir la cantidad de tiempo dedicada a la configuración de tu entorno de desarrollo, lanzaremos un número de editores de texto y entornos de desarrollo integrados (IDE, por sus siglas en inglés) directamente desde {% data variables.product.prodname_desktop %}. Desde un repositorio en {% data variables.product.prodname_desktop %}, puedes abrir perfectamente la carpeta del proyecto en tu editor de texto favorito. - -1. Haz clic en **File** (Archivo), luego haz clic en **Options** (Opciones) y luego haz clic en **Advanced** (Avanzado). -2. Usa el menú desplegable **External editor** (Editor externo) y selecciona un editor de la lista. Deberías ver los editores que has instalado en la lista. Si no ves ningún editor, instala un editor compatible como [Atom](https://atom.io). Para ver la lista de editores compatibles, consulta [ la integración "Open External Editor" ](https://github.com/desktop/desktop/blob/development/docs/technical/editor-integration.md#windows) (Abrir editor externo) en el repositorio {% data variables.product.prodname_desktop %}. ![Editor externo](/assets/images/help/desktop/mac-editor-menu.png) -3. Si instalaste un editor nuevo, reinicia {% data variables.product.prodname_desktop %} para que el editor esté disponible en el menú desplegable **External editor** (Editor externo). - -### Paso 6. Realizar, confirmar y subir cambios - -Ahora que has configurado un editor predeterminado, estás listo para hacer cambios en tu proyecto y para comenzar a crear tu primera confirmación en tu repositorio. - -1. Para iniciar tu editor externo desde el interior {% data variables.product.prodname_desktop %}, haz clic en **Repository** (Repositorio) y luego haz clic en **Open in EDITOR** (Abrir en EDITOR). ![Abrir en editor](/assets/images/help/desktop/getting-started-guide/open-in-editor.png) - -2. Comienza por realizar algunos cambios en el archivo _README.md_ que creaste previamente. Agrega la información que describe el proyecto, como qué hace y por qué resulta útil. Recuerda que esta es la primera interacción que tendrán las personas con tu proyecto. Ahora estás listo para hacer tu primera confirmación. -3. Cambia desde el editor de texto hasta {% data variables.product.prodname_desktop %} y desplázate hasta la pestaña **Changes** (Cambios). En la lista de archivos, deberías ver tu _README.md_. La marca de verificación junto al archivo _README.md_ indica que los cambios que realizaste en el archivo formarán parte de la confirmación que realizaste. En el futuro, es posible que realices cambios a múltiples archivos pero solo quieras confirmar los cambios que realizaste en alguno de los archivos. {% data variables.product.prodname_desktop %} te permite seleccionar los cambios específicos que deseas confirmar. ![Ver cambios](/assets/images/help/desktop/getting-started-guide/viewing-changes.png) - -4. En la parte inferior de la lista **Changes** (Cambios), escribe un mensaje de confirmación. A la derecha de tu imagen de perfil, escribe una descripción breve de la confirmación. Dado que estamos cambiando el archivo _README.md_, "Agregar información sobre el objetivo del proyecto" sería un buen resumen de la confirmación. Debajo del resumen, verás un campo de texto "Description" (Descripción), donde puedes escribir una descripción más extensa de los cambios en la confirmación, que resulta útil al volver a mirar el historial de un proyecto y comprender por qué se hicieron los cambios. Dado que estás realizando una actualización básica de un archivo _README.md_, puedes omitir la descripción. ![Mensaje de confirmación](/assets/images/help/desktop/getting-started-guide/commit-message.png) -5. Haz clic en **Committ to master** (Confirmar en principal). El botón de confirmación muestra tu rama actual, que en este caso es `master` (principal), por lo que debes asegurarte de confirmar la rama que deseas. ![Confirmar al principal](/assets/images/help/desktop/getting-started-guide/click-commit-to-master.png) -6. Para subir los cambios al repositorio remoto en {% data variables.product.product_name %}, haz clic en **Push origin** (Subir origen). ![Subir origen](/assets/images/help/desktop/getting-started-guide/push-to-origin.png) - - ¿Recuerdas el botón **Publish** (Publicar) que usaste para publicar tu repositorio en {% data variables.product.product_name %}? Ahora debería decir `Push origin` (Subir origen), con un código `1`, junto al nombre, indicando que existe una confirmación que no ha sido subida a {% data variables.product.product_name %}. - - El "origen" en **Push origin** (Subir origen) significa que estamos subiendo los cambios al remoto llamado `origin` (origen), que en este caso es tu repositorio del proyecto en {% data variables.product.prodname_dotcom_the_website %}. Hasta que hayas subido alguna de las nuevas confirmaciones {% data variables.product.product_name %}, habrá diferencias entre el repositorio de tu proyecto en tu computadora y el repositorio del proyecto en {% data variables.product.prodname_dotcom_the_website %}. Esto te permite trabajar localmente y solo subir tu trabajo a {% data variables.product.prodname_dotcom_the_website %} cuando estés listo. -7. En el área abierta junto a la pestaña **Changes** (Cambios), verás sugerencias sobre lo que puedes hacer a continuación. Para abrir el repositorio en {% data variables.product.product_name %} en tu navegador, haz clic en **View on GitHub** (Ver en GitHub). ![Ver en GitHub](/assets/images/help/desktop/getting-started-guide/view-on-github.png) -8. En tu navegador, haz clic en **2 commits** (2 confirmaciones). Verás una lista de las confirmaciones en este repositorio en {% data variables.product.product_name %}. La primera confirmación deberá ser la confirmación que acabas de realizar en {% data variables.product.prodname_desktop %}. ![Hacer clic en dos confirmaciones](/assets/images/help/desktop/getting-started-guide/click-two-commits.png) - -### Conclusión - -¡Felicitaciones! Has creado un repositorio, publicado el repositorio en {% data variables.product.product_name %}, realizado una confirmación y subido tus cambios. Esta es solo una muestra de todas las cosas que puedes hacer con {% data variables.product.product_name %} y {% data variables.product.prodname_desktop %}. Esperamos que este ejercicio te estimule para explorar un poco más. diff --git a/translations/es-XL/content/desktop/getting-started-with-github-desktop/index.md b/translations/es-XL/content/desktop/getting-started-with-github-desktop/index.md deleted file mode 100644 index 41c259bd0e46..000000000000 --- a/translations/es-XL/content/desktop/getting-started-with-github-desktop/index.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: Comenzar con GitHub Desktop -shortTitle: Empezar -intro: 'Configura GitHub Desktop para administrar tu proyecto de trabajo. Autentícate en GitHub.com o en el Servidor de GitHub Enterprise, mantén la app actualizada y revisa tu configuración preferida.' -redirect_from: - - /desktop/getting-started-with-github-desktop/setting-up-github-desktop/ -versions: - free-pro-team: '*' ---- - - -### Índice - -{% topic_link_in_list /overview %} - {% link_in_list /creating-your-first-repository-using-github-desktop %} - {% link_in_list /keyboard-shortcuts %} - {% link_in_list /launching-github-desktop-from-the-command-line %} -{% topic_link_in_list /installing-and-authenticating-to-github-desktop %} - {% link_in_list /installing-github-desktop %} - {% link_in_list /authenticating-to-github %} - {% link_in_list /about-the-github-desktop-windows-installer-package %} - {% link_in_list /updating-github-desktop %} - {% link_in_list /uninstalling-github-desktop %} -{% topic_link_in_list /configuring-and-customizing-github-desktop %} - {% link_in_list /configuring-basic-settings %} - {% link_in_list /configuring-git-for-github-desktop %} - {% link_in_list /configuring-a-default-editor %} - {% link_in_list /setting-a-theme-for-github-desktop %} diff --git a/translations/es-XL/content/desktop/getting-started-with-github-desktop/installing-and-authenticating-to-github-desktop.md b/translations/es-XL/content/desktop/getting-started-with-github-desktop/installing-and-authenticating-to-github-desktop.md deleted file mode 100644 index a9a2db7570d4..000000000000 --- a/translations/es-XL/content/desktop/getting-started-with-github-desktop/installing-and-authenticating-to-github-desktop.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: Cómo instalar y autenticarse en GitHub Desktop -intro: Instalar GitHub Desktop y conectar tus cuentas de GitHub y GitHub Enterprise. -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/es-XL/content/desktop/getting-started-with-github-desktop/installing-github-desktop.md b/translations/es-XL/content/desktop/getting-started-with-github-desktop/installing-github-desktop.md deleted file mode 100644 index 14545ddefccb..000000000000 --- a/translations/es-XL/content/desktop/getting-started-with-github-desktop/installing-github-desktop.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: Instalar GitHub Desktop -intro: Puedes instalar GitHub Desktop en sistemas operativos Microsoft Windows o macOS. -versions: - free-pro-team: '*' ---- - -Antes de configurar {% data variables.product.prodname_desktop %}, {% data reusables.desktop.get-an-account %} - -### Descargar e instalar {% data variables.product.prodname_desktop %} - -{% mac %} - -Puedes instalar {% data variables.product.prodname_desktop %} en {% data variables.desktop.mac-osx-versions %}. - -{% data reusables.desktop.download-desktop-page %} -2. Escoge **Download for Mac** (Descargar para Mac). -3. En la carpeta **Download** (Descargas) de tu computadora, haz doble clic en el archivo comprimido **{% data variables.product.prodname_desktop %}**. -4. Una vez que se descomprima el archivo, haz doble clic en **{% data variables.product.prodname_desktop %}**. - -{% endmac %} - -{% windows %} - -Puedes instalar {% data variables.product.prodname_desktop %} en {% data variables.desktop.windows-versions %}. - -{% warning %} - -**Advertencia**: Debes tener un sistema operativo de 64 bits para ejecutar {% data variables.product.prodname_desktop %}. - -{% endwarning %} - -{% data reusables.desktop.download-desktop-page %} -2. Escoge **Download for Windows** (Descargar para Windows). - - {% note %} - - **Nota** Si eres administrador de red, puedes usar el [{% data variables.product.prodname_desktop %} paquete instalador de Windows](/desktop/guides/getting-started-with-github-desktop/about-the-github-desktop-windows-installer-package/) para implementar {% data variables.product.prodname_desktop %}. - - {% endnote %} - -3. En la carpeta **Download** (Descargas) de tu computadora, haz doble clic en **{% data variables.product.prodname_desktop %}**. -4. En la ventana emergente, haz clic en **Install** (Instalar). -5. Una vez que el programa hay sido instalado, haz clic en **Run** (Ejecutar). - -{% endwindows %} - -### Configurar {% data variables.product.prodname_desktop %} - -Una vez que hayas abierto {% data variables.product.prodname_desktop %}, puedes elegir si deseas configurar {% data variables.product.prodname_desktop %} inmediatamente, o puedes omitir el proceso de configuración. diff --git a/translations/es-XL/content/desktop/getting-started-with-github-desktop/keyboard-shortcuts-in-github-desktop.md b/translations/es-XL/content/desktop/getting-started-with-github-desktop/keyboard-shortcuts-in-github-desktop.md deleted file mode 100644 index dbc132d8271a..000000000000 --- a/translations/es-XL/content/desktop/getting-started-with-github-desktop/keyboard-shortcuts-in-github-desktop.md +++ /dev/null @@ -1,115 +0,0 @@ ---- -title: Atajos de teclado en GitHub Desktop -intro: 'Puedes usar los atajos de teclado en {% data variables.product.prodname_desktop %}.' -versions: - free-pro-team: '*' ---- - -{% mac %} - -Atajos de teclado de GitHyb Desktop en macOS - -### Atajos en todo el sitio - -| Atajo del teclado | Descripción | -| ------------------------------------ | ------------------------------------------------------------------------ | -| ⌘, | Ir a Preferences (Preferencias) | -| ⌘H | Ocultar la aplicación {% data variables.product.prodname_desktop %} | -| ⌥⌘H | Ocultar todas las otras aplicaciones | -| ⌘Q | Dejar {% data variables.product.prodname_desktop %} | -| ⌃⌘F | Alternar vista de pantalla completa | -| ⌘0 | Restablecer zoom al tamaño de texto predeterminado | -| ⌘= | Acercar para textos y gráficos más grandes | -| ⌘- | Alejar para textos y gráficos más pequeños | -| ⌥⌘I | Alternar herramientas del desarrollador | - -### Repositorios - -| Atajo del teclado | Descripción | -| ------------------------------------ | ------------------------------------------------------------------------------------ | -| ⌘N | Agregar un repositorio nuevo | -| ⌘O | Agregar un repositorio local | -| ⇧⌘O | Clonar un repositorio desde {% data variables.product.prodname_dotcom %} | -| ⌘T | Mostrar una lista de tus repositorios | -| ⌘P | Subir las últimas confirmaciones a {% data variables.product.prodname_dotcom %} | -| ⇧⌘P | Bajar los últimos cambios de {% data variables.product.prodname_dotcom %} | -| ⌘⌫ | Eliminar un repositorio existente | -| ⇧⌘G | Ver el repositorio en {% data variables.product.prodname_dotcom %} | -| ⌃` | Abrir el repositorio en tu herramienta de terminal preferida | -| ⇧⌘F | Mostrar el repositorio en Finder | -| ⇧⌘A | Abrir el repositorio en tu herramienta de editor preferida | -| ⌘I | Crear un informe de problemas en {% data variables.product.prodname_dotcom %} | - -### Ramas - -| Atajo del teclado | Descripción | -| ------------------------------------ | ---------------------------------------------------------------------------------------------- | -| ⌘1 | Mostrar todos los cambios antes de confirmar | -| ⌘2 | Mostrar tu historial de confirmaciones | -| ⌘B | Mostrar todas tus ramas | -| ⌘G | Ir al campo de resumen de confirmaciones | -| espacio | Select or deselect all highlighted files | -| ⇧⌘N | Crear una rama nueva | -| ⇧⌘R | Renombrar la rama actual | -| ⇧⌘D | Eliminar la rama actual | -| ⇧⌘U | Actualizar desde la rama predeterminada | -| ⇧⌘B | Comparar con una rama existente | -| ⇧⌘M | Fusionar en una rama actual | -| ⌃H | Mostrar u ocultar cambios acumulados | -| ⇧⌘C | Comparar ramas en {% data variables.product.prodname_dotcom %} | -| ⌘R | Mostrar la solicitud de extracción actual en {% data variables.product.prodname_dotcom %} | - -{% endmac %} - -{% windows %} - -Atajos de teclado de GitHub Desktop en Windows - -### Atajos en todo el sitio - -| Atajo del teclado | Descripción | -| ------------------------------------------- | -------------------------------------------------- | -| Ctrl, | Ir a Options (Opciones) | -| F11 | Alternar vista de pantalla completa | -| Ctrl0 | Restablecer zoom al tamaño de texto predeterminado | -| Ctrl= | Acercar para textos y gráficos más grandes | -| Ctrl- | Alejar para textos y gráficos más pequeños | -| CtrlShiftI | Alternar herramientas del desarrollador | - -### Repositorios - -| Atajo del teclado | Descripción | -| ------------------------------------------- | ------------------------------------------------------------------------------------ | -| CtrlN | Agregar un repositorio nuevo | -| CtrlO | Agregar un repositorio local | -| CtrlShiftO | Clonar un repositorio desde {% data variables.product.prodname_dotcom %} | -| CtrlT | Mostrar una lista de tus repositorios | -| CtrlP | Subir las últimas confirmaciones a {% data variables.product.prodname_dotcom %} | -| CtrlShiftP | Bajar los últimos cambios de {% data variables.product.prodname_dotcom %} | -| CtrlDelete | Eliminar un repositorio existente | -| CtrlShiftG | Ver el repositorio en {% data variables.product.prodname_dotcom %} | -| Ctrl` | Abrir el repositorio en tu herramienta de línea de comando preferida | -| CtrlShiftF | Mostrar el repositorio en Explorador | -| CtrlShiftA | Abrir el repositorio en tu herramienta de editor preferida | -| CtrlI | Crear un informe de problemas en {% data variables.product.prodname_dotcom %} | - -### Ramas - -| Atajo del teclado | Descripción | -| ------------------------------------------- | ---------------------------------------------------------------------------------------------- | -| Ctrl1 | Mostrar todos los cambios antes de confirmar | -| Ctrl2 | Mostrar tu historial de confirmaciones | -| CtrlB | Mostrar todas tus ramas | -| CtrlG | Ir al campo de resumen de confirmaciones | -| espacio | Select or deselect all highlighted files | -| CtrlShiftN | Crear una rama nueva | -| CtrlShiftR | Renombrar la rama actual | -| CtrlShiftD | Eliminar la rama actual | -| CtrlShiftU | Actualizar desde la rama predeterminada | -| CtrlShiftB | Comparar con una rama existente | -| CtrlShiftM | Fusionar en una rama actual | -| CtrlH | Mostrar u ocultar cambios acumulados | -| CtrlShiftC | Comparar ramas en {% data variables.product.prodname_dotcom %} | -| CtrlR | Mostrar la solicitud de extracción actual en {% data variables.product.prodname_dotcom %} | - -{% endwindows %} diff --git a/translations/es-XL/content/desktop/getting-started-with-github-desktop/keyboard-shortcuts.md b/translations/es-XL/content/desktop/getting-started-with-github-desktop/keyboard-shortcuts.md deleted file mode 100644 index 9ae5b74ce986..000000000000 --- a/translations/es-XL/content/desktop/getting-started-with-github-desktop/keyboard-shortcuts.md +++ /dev/null @@ -1,117 +0,0 @@ ---- -title: Atajos del teclado -redirect_from: - - /desktop/getting-started-with-github-desktop/keyboard-shortcuts-in-github-desktop/ -intro: 'Puedes usar los atajos de teclado en {% data variables.product.prodname_desktop %}.' -versions: - free-pro-team: '*' ---- - -{% mac %} - -Atajos de teclado de GitHyb Desktop en macOS - -### Atajos en todo el sitio - -| Atajo del teclado | Descripción | -| ------------------------------------ | ------------------------------------------------------------------------ | -| ⌘, | Ir a Preferences (Preferencias) | -| ⌘H | Ocultar la aplicación {% data variables.product.prodname_desktop %} | -| ⌥⌘H | Ocultar todas las otras aplicaciones | -| ⌘Q | Dejar {% data variables.product.prodname_desktop %} | -| ⌃⌘F | Alternar vista de pantalla completa | -| ⌘0 | Restablecer zoom al tamaño de texto predeterminado | -| ⌘= | Acercar para textos y gráficos más grandes | -| ⌘- | Alejar para textos y gráficos más pequeños | -| ⌥⌘I | Alternar herramientas del desarrollador | - -### Repositorios - -| Atajo del teclado | Descripción | -| ------------------------------------ | ------------------------------------------------------------------------------------ | -| ⌘N | Agregar un repositorio nuevo | -| ⌘O | Agregar un repositorio local | -| ⇧⌘O | Clonar un repositorio desde {% data variables.product.prodname_dotcom %} | -| ⌘T | Mostrar una lista de tus repositorios | -| ⌘P | Subir las últimas confirmaciones a {% data variables.product.prodname_dotcom %} | -| ⇧⌘P | Bajar los últimos cambios de {% data variables.product.prodname_dotcom %} | -| ⌘⌫ | Eliminar un repositorio existente | -| ⇧⌘G | Ver el repositorio en {% data variables.product.prodname_dotcom %} | -| ⌃` | Abrir el repositorio en tu herramienta de terminal preferida | -| ⇧⌘F | Mostrar el repositorio en Finder | -| ⇧⌘A | Abrir el repositorio en tu herramienta de editor preferida | -| ⌘I | Crear un informe de problemas en {% data variables.product.prodname_dotcom %} | - -### Ramas - -| Atajo del teclado | Descripción | -| ------------------------------------ | ---------------------------------------------------------------------------------------------- | -| ⌘1 | Mostrar todos los cambios antes de confirmar | -| ⌘2 | Mostrar tu historial de confirmaciones | -| ⌘B | Mostrar todas tus ramas | -| ⌘G | Ir al campo de resumen de confirmaciones | -| espacio | Selecciona o deselecciona todos los archivos resaltados | -| ⇧⌘N | Crear una rama nueva | -| ⇧⌘R | Renombrar la rama actual | -| ⇧⌘D | Eliminar la rama actual | -| ⇧⌘U | Actualizar desde la rama predeterminada | -| ⇧⌘B | Comparar con una rama existente | -| ⇧⌘M | Fusionar en una rama actual | -| ⌃H | Mostrar u ocultar cambios acumulados | -| ⇧⌘C | Comparar ramas en {% data variables.product.prodname_dotcom %} | -| ⌘R | Mostrar la solicitud de extracción actual en {% data variables.product.prodname_dotcom %} | - -{% endmac %} - -{% windows %} - -Atajos de teclado de GitHub Desktop en Windows - -### Atajos en todo el sitio - -| Atajo del teclado | Descripción | -| ------------------------------------------- | -------------------------------------------------- | -| Ctrl, | Ir a Options (Opciones) | -| F11 | Alternar vista de pantalla completa | -| Ctrl0 | Restablecer zoom al tamaño de texto predeterminado | -| Ctrl= | Acercar para textos y gráficos más grandes | -| Ctrl- | Alejar para textos y gráficos más pequeños | -| CtrlShiftI | Alternar herramientas del desarrollador | - -### Repositorios - -| Atajo del teclado | Descripción | -| ------------------------------------------- | ------------------------------------------------------------------------------------ | -| CtrlN | Agregar un repositorio nuevo | -| CtrlO | Agregar un repositorio local | -| CtrlShiftO | Clonar un repositorio desde {% data variables.product.prodname_dotcom %} | -| CtrlT | Mostrar una lista de tus repositorios | -| CtrlP | Subir las últimas confirmaciones a {% data variables.product.prodname_dotcom %} | -| CtrlShiftP | Bajar los últimos cambios de {% data variables.product.prodname_dotcom %} | -| CtrlDelete | Eliminar un repositorio existente | -| CtrlShiftG | Ver el repositorio en {% data variables.product.prodname_dotcom %} | -| Ctrl` | Abrir el repositorio en tu herramienta de línea de comando preferida | -| CtrlShiftF | Mostrar el repositorio en Explorador | -| CtrlShiftA | Abrir el repositorio en tu herramienta de editor preferida | -| CtrlI | Crear un informe de problemas en {% data variables.product.prodname_dotcom %} | - -### Ramas - -| Atajo de teclado | Descripción | -| ------------------------------------------- | ---------------------------------------------------------------------------------------------- | -| Ctrl1 | Mostrar todos los cambios antes de confirmar | -| Ctrl2 | Mostrar tu historial de confirmaciones | -| CtrlB | Mostrar todas tus ramas | -| CtrlG | Ir al campo de resumen de confirmaciones | -| espacio | Selecciona o deselecciona todos los archivos resaltados | -| CtrlShiftN | Crear una rama nueva | -| CtrlShiftR | Renombrar la rama actual | -| CtrlShiftD | Eliminar la rama actual | -| CtrlShiftU | Actualizar desde la rama predeterminada | -| CtrlShiftB | Comparar con una rama existente | -| CtrlShiftM | Fusionar en una rama actual | -| CtrlH | Mostrar u ocultar cambios acumulados | -| CtrlShiftC | Comparar ramas en {% data variables.product.prodname_dotcom %} | -| CtrlR | Mostrar la solicitud de extracción actual en {% data variables.product.prodname_dotcom %} | - -{% endwindows %} diff --git a/translations/es-XL/content/desktop/getting-started-with-github-desktop/launching-github-desktop-from-the-command-line.md b/translations/es-XL/content/desktop/getting-started-with-github-desktop/launching-github-desktop-from-the-command-line.md deleted file mode 100644 index f6d5048ca379..000000000000 --- a/translations/es-XL/content/desktop/getting-started-with-github-desktop/launching-github-desktop-from-the-command-line.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: Lanzar GitHub Desktop desde la línea de comando -shortTitle: Lanzar desde la línea de comandos -intro: Puedes lanzar GitHub Desktop desde la línea de comando. -versions: - free-pro-team: '*' ---- - -{% mac %} - -1. En la barra de menú, selecciona el menú de **{% data variables.product.prodname_desktop %}** y luego da clic en **Instalar la Herramienta de Línea de Comandos**. ![Opción para Instalar la Herramienta de Línea de Comandos en el menú desplegable de {% data variables.product.prodname_desktop %}](/assets/images/help/desktop/mac-install-command-line-tool.png) -2. Abre Terminal. -3. {% data reusables.desktop.launch-desktop-from-command-line %} - - ```shell - $ github /path/to/repo - ``` - - También puedes cambiar tu ruta de repositorio y luego teclear `github .` para abrir ese repositorio. - - ```shell - $ cd /path/to/repo - [repo]$ github . - ``` - -{% endmac %} - -{% windows %} - -1. Abre un símbolo del sistema. -2. {% data reusables.desktop.launch-desktop-from-command-line %} - - ```shell - C:\Users\octocat> github path\to\repo - ``` - - También puedes cambiar tu ruta de repositorio y después teclear `github .` para abrirlo. - - ```shell - C:\Users\octocat> cd repo\myrepo - C:\Users\octocat\repo\myrepo> github . - ``` - -{% endwindows %} diff --git a/translations/es-XL/content/desktop/getting-started-with-github-desktop/overview.md b/translations/es-XL/content/desktop/getting-started-with-github-desktop/overview.md deleted file mode 100644 index 3544e3887890..000000000000 --- a/translations/es-XL/content/desktop/getting-started-with-github-desktop/overview.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: Información general -intro: Conozca GitHub Desktop y cree rápidamente su primer repositorio. -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/es-XL/content/desktop/getting-started-with-github-desktop/setting-a-theme-for-github-desktop.md b/translations/es-XL/content/desktop/getting-started-with-github-desktop/setting-a-theme-for-github-desktop.md deleted file mode 100644 index a78d40a69ce1..000000000000 --- a/translations/es-XL/content/desktop/getting-started-with-github-desktop/setting-a-theme-for-github-desktop.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: Establecer un tema para GitHub Desktop -intro: Puedes establecer un tema para personalizar el aspecto de GitHub Desktop. -versions: - free-pro-team: '*' ---- - -{% mac %} - -{% data reusables.desktop.mac-select-desktop-menu %} -{% data reusables.desktop.choose-a-theme %} - ![Las opciones de temas para la pestaña de Apariencia para Mac](/assets/images/help/desktop/mac-appearance-tab-themes.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.windows-choose-options %} -{% data reusables.desktop.choose-a-theme %} - ![Las opciones de temas para la pestaña de Apariencia para Windows](/assets/images/help/desktop/windows-appearance-tab-themes.png) - -{% endwindows %} diff --git a/translations/es-XL/content/desktop/getting-started-with-github-desktop/uninstalling-github-desktop.md b/translations/es-XL/content/desktop/getting-started-with-github-desktop/uninstalling-github-desktop.md deleted file mode 100644 index 6cc8654b7ecf..000000000000 --- a/translations/es-XL/content/desktop/getting-started-with-github-desktop/uninstalling-github-desktop.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Desinstalar GitHub Desktop -intro: You can uninstall GitHub Desktop from your computer at any time. -versions: - free-pro-team: '*' ---- - -{% mac %} - -1. In a Finder window, navigate to the Applications folder. ![Applications folder in the Finder window](/assets/images/help/desktop/applications-folder.png) -2. While pressing the **Control** button on your keyboard, click **{% data variables.product.prodname_desktop %}**. -3. Elige **Move to Trash** (Mover a Papelera). ![The Move to Trash option](/assets/images/help/desktop/mac-move-to-trash.png) -4. In the menu bar, use the **Finder** drop-down menu, then click **Empty Trash**. ![The Empty Trash option in the menu bar](/assets/images/help/desktop/mac-empty-trash-menu.png) -5. Lee la advertencia en el cuadro emergente y haz clic en **Empty Trash** (Vaciar Papelera). ![The Empty Trash button](/assets/images/help/desktop/mac-empty-trash-button.png) - -{% endmac %} - -{% windows %} - -1. Open Control Panel. For more information, see [Where is Control Panel?](https://support.microsoft.com/en-us/help/13764/windows-where-is-control-panel) in Windows Help. -2. Under "Programs", click **Uninstall a program**. ![The Uninstall a Program option in Control Panel](/assets/images/help/desktop/windows-uninstall-a-program.png) -3. Right-click the entry named **{% data variables.product.prodname_desktop %}**, then click **Uninstall**. ![The Uninstall option](/assets/images/help/desktop/windows-click-uninstall.png) - -{% endwindows %} diff --git a/translations/es-XL/content/desktop/getting-started-with-github-desktop/updating-github-desktop.md b/translations/es-XL/content/desktop/getting-started-with-github-desktop/updating-github-desktop.md deleted file mode 100644 index 5571c808070a..000000000000 --- a/translations/es-XL/content/desktop/getting-started-with-github-desktop/updating-github-desktop.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: Actualizar GitHub Desktop -intro: GitHub Desktop automáticamente descarga las actualizaciones y las instala al reiniciar. También puedes verificar las actualizaciones manualmente. -versions: - free-pro-team: '*' ---- - -{% mac %} - -1. En el menú **GitHub Desktop**, haz clic en **Acerca de GitHub Desktop**. ![Acerca de la opción de menú de GitHub Desktop](/assets/images/help/desktop/desktop-menu-about-desktop-mac.png) -2. Haz clic en **Check for Updates** (Comprobar actualizaciones). ![Botón Check for Updates (Comprobar actualizaciones)](/assets/images/help/desktop/check-for-updates.png) -3. Si hay una actualización disponible, cierre y vuelva a abrir {% data variables.product.prodname_desktop %} para instalar la actualización. - -{% endmac %} - -{% windows %} - -1. En el menú **Help** (Ayuda), haz clic en **Acerca de GitHub Desktop**. ![Acerca de la opción de menú de GitHub Desktop](/assets/images/help/desktop/help-about-desktop-win.png) -2. Haz clic en **Check for Updates** (Comprobar actualizaciones). ![Botón Check for Updates (Comprobar actualizaciones)](/assets/images/help/desktop/check-for-updates.png) -3. Si hay una actualización disponible, cierre y vuelva a abrir {% data variables.product.prodname_desktop %} para instalar la actualización. - -{% endwindows %} diff --git a/translations/es-XL/content/github/administering-a-repository/about-github-dependabot.md b/translations/es-XL/content/github/administering-a-repository/about-github-dependabot.md deleted file mode 100644 index 6df9add82417..000000000000 --- a/translations/es-XL/content/github/administering-a-repository/about-github-dependabot.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: Acerca de GitHub Dependabot -intro: 'Puede utilizar el {% data variables.product.prodname_dependabot %} para mantener los paquetes que utilizas actualizados a su versión más reciente.' -versions: - free-pro-team: '*' ---- - -{% data reusables.dependabot.beta-note %} - -### Acerca de {% data variables.product.prodname_dependabot %} - -{% data variables.product.prodname_dependabot %} es una app de {% data variables.product.prodname_dotcom %} que hace el esfuerzo de mantener tus dependencias. Puedes utilizarlo para garantizar que tu repositorio se mantenga automáticamente con los últimos lanzamientos de los paquetes y aplicaciones de los que depende. - -Puedes habilitar {% data variables.product.prodname_dependabot_version_updates %} si seleccionas el archivo de configuración en tu repositorio. El archivo de configuración especifica la ubicación del manifiesto, u otros archivos de definición de paquetes, almacenado en tu repositorio. La app utiliza esta información para revisar si hay paquetes y aplicaciones desactualizados. La app del {% data variables.product.prodname_dependabot_short %} determina si hay una versión nueva de una dependencia al buscar el versionamiento semántico ([semver](https://semver.org/)) de ésta para decidir si debería actualizarla a esa versión. Cuando la app identifica una dependencia desactualizada, levanta una solicitud de extracción para actualizar el manifiesto a la última versión de la dependencia. Verificas que tu prueba pase, revisas el registro de cambios y notas de lanzamiento que se incluyan en el resumen de la solicitud de extracción y, posteriormente, lo fusionas. Para obtener más información, consulta la sección "[Habilitar e inhabilitar las actualizaciones de versión](/github/administering-a-repository/enabling-and-disabling-version-updates)". - -Si habilitas las actualizaciones de seguridad, el {% data variables.product.prodname_dependabot %} también levantará las solicitudes de extracción para actualizar las dependencias vulnerables. Para obtener más información, consulta la sección "[Configurar {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)". - -{% data reusables.dependabot.dependabot-tos %} - -### Frecuencia de las solicitudes de extracción del {% data variables.product.prodname_dependabot %} - -Tú eres quien especifica qué tan a menudo se revisa cada ecosistema para encontrar nuevas versiones en el archivo de configuración: diario, semanalmente, o mensualmente. - -{% data reusables.dependabot.initial-updates %} - -Si habilitaste las actualizaciones de seguridad, algunas veces verás solicitudes de extracción adicionales para actualizaciones de seguridad. Estas se activan mediante una alerta al Dependabot para una dependencia en tu rama predeterminada. El {% data variables.product.prodname_dependabot %} levanta automáticamente una solicitud de extracción para actualizar la dependencia vulnerable. - -### Repositorios y ecosistemas compatibles - -Puedes configurar las actualizaciones de versión para los repositorios que contengan un manifiesto de dependencias o un archivo fijado para alguno de los administradores de paquetes compatibles. - -{% data reusables.dependabot.supported-package-managers %} - -Si tu repositorio ya utiliza una integración para la administración de dependencias, necesitarás inhabilitarlo antes de habilitar el {% data variables.product.prodname_dependabot %}. Para obtener más información, consulta la sección "[Acerca de las integraciones](/github/customizing-your-github-workflow/about-integrations)". diff --git a/translations/es-XL/content/github/administering-a-repository/setting-the-default-branch.md b/translations/es-XL/content/github/administering-a-repository/setting-the-default-branch.md deleted file mode 100644 index d9ef11f1623a..000000000000 --- a/translations/es-XL/content/github/administering-a-repository/setting-the-default-branch.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Configurar la rama por defecto -intro: 'Si tienes más de una rama en tu repositorio, puedes elegir otra rama para que sea la predeterminada.' -redirect_from: - - /articles/setting-the-default-branch -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -### Acerca de la rama predeterminada - -{% data reusables.branches.new-repo-default-branch %}{% data reusables.branches.default-branch-automatically-base-branch %} Si tienes más de una rama en tu repositorio, cualquiera con permisos administrativos en los repositorios pueden seleccionar alguna de estas ramas como la rama predeterminada de los mismos. - -### Configurar la rama por defecto - -{% note %} - -**Nota:** Para configurar la rama predeterminada debes tener más de una de ellas en tu repositorio. - -{% endnote %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -{% data reusables.repositories.repository-branches %} -4. En el menú desplegable de la rama predeterminada, elige la rama predeterminada nueva. ![Selector desplegable de la rama por defecto](/assets/images/help/repository/repository-options-defaultbranch.png) -5. Da clic en **Actualizar**. - -Puedes únicamente cambiar entre ramas que ya existan en {% data variables.product.product_location %}. Para crear una nueva rama a través de UI, consulta "[Crear y eliminar ramas dentro de tu repositorio](/articles/creating-and-deleting-branches-within-your-repository)". - -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} - -También puedes configurar el nombre de la rama predeterminada para cualquier repositorio creado recientemente que pertenezca a tu cuenta de usuario, organización o cuenta empresarial. Para obtener más información, consulta las secciones "[Administrar la rama predeterminada para tus repositorios](/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories)", "[Administrar el nombre de la rama predeterminada para los repositorios en tu organización](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization)", o "[Requerir unapolítica en sobre el nombre de la rama predeterminada](/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account#enforcing-a-policy-on-the-default-branch-name)". - -{% endif %} - -{% warning %} - -**Advertencia**: El configurar una rama predeterminada diferente afecta el contenido de `trunk` en tu rama en el [puente de Git-Subversion](https://github.com/blog/1178-collaborating-on-github-with-subversion) y en el `HEAD` que verías cuando haces `git ls-remote` en la [URL ascendente del repositorio](https://git-scm.com/docs/git-ls-remote.html). - -{% endwarning %} diff --git a/translations/es-XL/content/github/articles/README.md b/translations/es-XL/content/github/articles/README.md deleted file mode 100644 index 1eaef8c78676..000000000000 --- a/translations/es-XL/content/github/articles/README.md +++ /dev/null @@ -1,5 +0,0 @@ -# Hidden GitHub.com articles - -GitHub.com/Enterprise User articles that have `hidden: true` frontmatter live in this directory. - -See [`content/README`](../README.md#hidden-pages) for more about hidden pages. diff --git a/translations/es-XL/content/github/articles/about-the-github-and-visual-studio-bundle.md b/translations/es-XL/content/github/articles/about-the-github-and-visual-studio-bundle.md deleted file mode 100644 index 3884088dd382..000000000000 --- a/translations/es-XL/content/github/articles/about-the-github-and-visual-studio-bundle.md +++ /dev/null @@ -1,54 +0,0 @@ ---- -title: Acerca de GitHub y el paquete Visual Studio -hidden: true -redirect_from: - - /articles/about-the-github-and-visual-studio-bundle -versions: - free-pro-team: '*' ---- - -{% tip %} - -**Sugerencias**: -- Solo los propietarios de la organización pueden invitar a usuarios a unirse a una organización. Para obtener más información, consulta "[Niveles de permiso para una organización](/articles/permission-levels-for-an-organization)". - -{% endtip %} - - -### En este artículo -- [Acerca de {% data variables.product.prodname_enterprise %} y las licencias del paquete Visual Studio](#about-github-enterprise-and-visual-studio-bundle-licenses) -- [Asignar una licencia de usuario de {% data variables.product.prodname_enterprise %}](#assigning-a-github-enterprise-user-license) -- [Sobreasignación de las licencias de usuario](#overallocation-of-user-licenses) - - -### Acerca de {% data variables.product.prodname_enterprise %} y las licencias del paquete Visual Studio - -Los clientes que han comprado el paquete {% data variables.product.prodname_dotcom %}-Visual Studio cumplen con el requisito para obtener una licencia de usuario de {% data variables.product.prodname_enterprise %}. Estas licencias se aprovisionan en una cuenta de empresa de {% data variables.product.prodname_dotcom %}, que se vincula con el Contrato Microsoft Enterprise y pueden ser asignadas a los miembros de la organización. - -Cuando los propietarios de las organizaciones en tu empresa invitan a un usuario nuevo a unirse a una organización, pueden elegir si le asignan al usuario nuevo una licencia de tu {% data variables.product.prodname_enterprise %} o de tu {% data variables.product.prodname_enterprise %} con las suscripciones de Visual Studio. - -### Asignar una licencia de usuario de {% data variables.product.prodname_enterprise %} - -{% data reusables.profile.access_profile %} -{% data reusables.profile.access_org %} -{% data reusables.organizations.people %} -{% data reusables.organizations.invite_member_from_people_tab %} -{% data reusables.organizations.invite_to_org %} -{% data reusables.organizations.choose-to-restore-privileges %} -{% data reusables.organizations.choose-user-role %} -{% data reusables.organizations.choose-user-license %} -{% data reusables.organizations.add-user-to-teams %} -{% data reusables.organizations.send-invitation %} -{% data reusables.organizations.user_must_accept_invite_email %} {% data reusables.organizations.cancel_org_invite %} - -### Sobreasignación de las licencias de usuario - -Puedes ver la cantidad total de licencias que has usado para tu {% data variables.product.prodname_enterprise %} y {% data variables.product.prodname_enterprise %} con las suscripciones de Visual Studio en los parámetros de facturación de tu cuenta de empresa. - -Si los propietarios de la organización y de la empresa asignan más licencias de suscripción de {% data variables.product.prodname_enterprise %} (Visual Studio) a los usuarios que las licencias incluidas en tu suscripción, entonces tu próxima factura de nivelación incluirá los cargos para la cantidad de usuarios sobre la cantidad permitida por tu suscripción. - -Para obtener más información, consulta "[Ver la suscripción y el uso de tu cuenta de empresa](/articles/viewing-the-subscription-and-usage-for-your-enterprise-account)". - -### Leer más -- "[Agregar miembros de la organización a un equipo](/articles/adding-organization-members-to-a-team)" -- Si tu organización [requiere que los miembros usen la autenticación de dos factores](/articles/requiring-two-factor-authentication-in-your-organization), los usuarios que invites deben [habilitar la autenticación de dos factores](/articles/securing-your-account-with-two-factor-authentication-2fa) para poder aceptar la invitación. diff --git a/translations/es-XL/content/github/articles/managing-your-disabled-github-pages-site.md b/translations/es-XL/content/github/articles/managing-your-disabled-github-pages-site.md deleted file mode 100644 index e14c893ccef1..000000000000 --- a/translations/es-XL/content/github/articles/managing-your-disabled-github-pages-site.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: Administrar tu sitio de Páginas de GitHub deshabilitadas -intro: 'Los repositorios privados en {% data variables.product.prodname_free_user %} no admiten {% data variables.product.prodname_pages %}, sin embargo, una cantidad limitada de sitios {% data variables.product.prodname_pages %} conectados a repositorios privados gratuitos fueron dejados activos por error. Estos sitios ya no se actualizan y se dejarán de publicar por parte de {% data variables.product.prodname_dotcom %} el 10 de mayo de 2019.' -hidden: true -redirect_from: - - /articles/managing-your-disabled-github-pages-site -versions: - free-pro-team: '*' ---- - -{% note %} - -{% data variables.product.prodname_pages %} está únicamente disponible en repositorios públicos con {% data variables.product.prodname_free_user %}, y en repositorios públicos y privados con {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, y {% data variables.product.prodname_ghe_server %}. {% data reusables.gated-features.more-info %} - -{% endnote %} - -Si tienes un sitio publicado {% data variables.product.prodname_pages %} en un repositorio privado gratuito, tienes unas cuantas opciones para continuar publicando y actualizando tu sitio, o para despublicar tu sitio de forma manual. Si no tomas ninguna medida, {% data variables.product.prodname_dotcom %} dejará de publicar tu sitio el 10 de mayo de 2019. - -- **Para continuar publicando y actualizando tu sitio {% data variables.product.prodname_pages %} **, puedes convertir el repositorio en público o actualizar tu cuenta a {% data variables.product.prodname_pro %}. Para obtener más información sobre cómo convertir tu repositorio privado en público, consulta "[Configurar la visibilidad del repositorio](/articles/setting-repository-visibility#making-a-private-repository-public)." Para obtener más información sobre actualizar tu cuenta, consulta "[Actualizar tu suscripción de GitHub](/articles/upgrading-your-github-subscription)." - -- **Para detener la publicación de tu sitio {% data variables.product.prodname_pages %} **, puedes [despublicar de forma manual](#manually-unpublishing-your-github-pages-site), o no hacer nada y {% data variables.product.prodname_dotcom %} dejará de publicar tu sitio el 10 de mayo de 2019. Si tu sitio {% data variables.product.prodname_pages %} tiene un dominio personalizado configurado, deberías actualizar o eliminar tus registros de DNS con tu proveedor de DNS tan pronto como sea posible para evitar el riesgo de adquisición del dominio. La configuración de tu dominio personalizado con tu proveedor DNS mientras tu sitio {% data variables.product.prodname_pages %} está inhabilitado, podría hacer que alguien más aloje un sitio en uno de tus subdominios. Para obtener más información, consulta "[Usar un dominio personalizado con {% data variables.product.prodname_pages %}](/articles/using-a-custom-domain-with-github-pages)". - -### Despublicar de forma manual tu sitio {% data variables.product.prodname_pages %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -3. En la barra lateral izquierda, haz clic en **Unpublish (Despublicar) {% data variables.product.prodname_pages %}**. ![Configuraciones del repositorio para despublicar el sitio {% data variables.product.prodname_pages %}](/assets/images/help/pages/unpublish-pages-button-sidebar.png) -4. Haz clic en **Unpublish this site (Despublicar este sitio)**. ![Botón para despublicar el sitio {% data variables.product.prodname_pages %}](/assets/images/help/pages/unpublish-pages-button.png) - -### Leer más - -- "[Despublicar un sitio de páginas de usuario](articles/unpublishing-a-user-pages-site)" -- "[Despublicar un sitio de páginas de proyecto](/articles/unpublishing-a-project-pages-site)" -- "[Transferir un repositorio](/articles/transferring-a-repository)" -- [Acerca de Archivar repositorios](/articles/about-archiving-repositories)" -- "[Borrar un repositorio](/articles/deleting-a-repository)" diff --git a/translations/es-XL/content/github/articles/searching-and-navigating-code.md b/translations/es-XL/content/github/articles/searching-and-navigating-code.md deleted file mode 100644 index d71f3d9995b5..000000000000 --- a/translations/es-XL/content/github/articles/searching-and-navigating-code.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: Código de búsqueda y navegación -intro: 'El código de búsqueda y navegación es una parte crítica del flujo de trabajo de desarrollo, y GitHub está mejorando estas áreas. Si eres partes de una organización que optó por el Código privado beta de búsqueda y navegación, tendrás acceso a nuevas herramientas de búsqueda y navegación. Para preguntas adicionales acerca de esta Beta privada, envía un correo electrónico a search-beta@github.com.' -hidden: true -redirect_from: - - /articles/searching-and-navigating-code -versions: - free-pro-team: '*' ---- - - -### En esta guía - -- [Búsqueda de código literal](#literal-code-search) -- [Relevancia](#relevancy) -- [Saltar a navegación](#jump-to-navigation) - -### Búsqueda de código literal - -Antes de esta Beta privada, muchos símbolos fueron desprovistos de índices de búsqueda, lo que significa que las expresiones idiomáticas comunes como `>>` no eran indexadas. Por ejemplo, cuando se busca `>>` en un repositorio, se muestran 0 resultados. Con la Beta privada, puedes encerrar el símbolo entre comillas dobles y ver los resultados correctos. Esta capacidad se extiende más allá de los símbolos y te permite buscar frases entrecomilladas enteras como `"return [] unless"`. Esta función se aplica a la búsqueda de código para todos los lenguajes. - -### Relevancia - -Para un subgrupo de lenguajes (Go, JavaScript, Python, Ruby, y TypeScript), la búsqueda de código ajusta la relevancia de las declaraciones. Se mostrará como resultado una declaración de un método, una función, una clase, u otra entidad antes de las solicitudes o los comentarios que incluyen el mismo término. - -### Saltar a navegación - -Para un subgrupo de lenguajes (Go, JavaScript, Python, Ruby, and TypeScript), GitHub ahora admite navegación e información adicional cuando haces clic sobre un símbolo. Esta navegación incluye saltar a la navegación de definición para los recursos dentro de un repositorio, lo que permite una navegación más rápida y una información aumentada. - -### Comentarios - -Todos los usuarios que actualmente optaron por el Código beta privado de búsqueda y navegación pueden aportar comentarios al hacer [esta encuesta](https://www.research.net/r/CodeSearch-Navigation). Para realizar comentarios y preguntas adicionales, envía un correo electrónico a search-beta@github.com. - -### Leer más -- [Acerca de la búsqueda en GitHub](/articles/about-searching-on-github/) -- [Encontrar funciones y métodos cambiados en una solicitud de extracción](/articles/finding-changed-methods-and-functions-in-a-pull-request/) diff --git a/translations/es-XL/content/github/articles/using-gist-playground.md b/translations/es-XL/content/github/articles/using-gist-playground.md deleted file mode 100644 index f98f0493ac0a..000000000000 --- a/translations/es-XL/content/github/articles/using-gist-playground.md +++ /dev/null @@ -1,45 +0,0 @@ ---- -title: Utilizar Gist Playground -intro: '' -hidden: true -redirect_from: - - /articles/articles/using-gist-playground -versions: - free-pro-team: '*' ---- - -{% note %} - -**Nota:** Gist Playground está disponible como programa beta privado limitado y está sujeto al acuerdo de acceso previo. - -{% endnote %} - -### En este artículo -- [Acerca de Gist Playground](#about-gist-playground) -- [Crear gists nuevos](#creating-new-gists) -- [Guardar tus cambios](#saving-your-changes) -- [Colaborar con otros](#collaborating-with-others) -- [Informar errores y comentarios](#reporting-bugs-and-feedback) - -### Acerca de Gist Playground -Gist Playground es una reiteración experimental de [Gist](https://gist.github.com/). Tus cambios se guardarán automáticamente mientras trabajas junto con tus amigos y pares. - -### Crear gists nuevos -Visitar Gist Playground creará automáticamente un borrador nuevo o mostrará tu borrador más reciente. Haz clic en **Create gist** (Crear gist) en el encabezado una vez que estés listo para crear y compartir tu gist. - -Todos los gists que se hacen en Gist Playground son *secretos*. Actualmente, no existe manera de volver público un gist desde dentro de Gist Playground. Si quieres volver público un gist, puedes utilizar el [Gist](https://gist.github.com/) existente para hacerlo. - -### Guardar tus cambios -Tus cambios se guardan automáticamente mientras escribes. También puedes cerrar la pestaña en cualquier momento y regresar sin perder ninguna parte del trabajo. - -Una vez que estés en un punto de control, puedes actualizar el gist con esos cambios haciendo clic en **Update gist** (Actualizar gist) en el encabezado. - -### Colaborar con otros -Puedes colaborar con cualquier otra persona que sea parte de la beta privada de Gist Playground. En "Invite to collaborate" (Invitar a colaborar), haz clic en la URL de colaboración para copiarla, envíale la URL a un amigo, y luego podrán hacer cambios juntos. - -Una vez que estés en un punto de control, el propietario del gist puede conservar los cambios haciendo clic en **Update gist** (Actualizar gist). - -Si quieres colaborar con alguien que no sea parte de la beta privada de Gist Playground, envíanos un correo electrónico a [gist-playground@github.com](mailto:gist-playground@github.com) y veremos si podemos agregarlo. - -### Informar errores y comentarios -¡Nos encantaría saber qué piensas acerca de Gist Playground y cómo se podría mejorar! Envíanos un correo electrónico a [gist-playground@github.com](mailto:gist-playground@github.com) con cualquier idea, comentario o error. diff --git a/translations/es-XL/content/github/committing-changes-to-your-project/why-are-my-commits-in-the-wrong-order.md b/translations/es-XL/content/github/committing-changes-to-your-project/why-are-my-commits-in-the-wrong-order.md deleted file mode 100644 index d21a80aa19c3..000000000000 --- a/translations/es-XL/content/github/committing-changes-to-your-project/why-are-my-commits-in-the-wrong-order.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: ¿Por qué mis confirmaciones están en el orden incorrecto? -intro: 'Si rescribes tu historial de confirmaciones mediante `git rebase` o un empuje forzado, puedes notar que tu secuencia de confirmación no funciona al abrir una solicitud de extracción.' -redirect_from: - - /articles/why-are-my-commits-in-the-wrong-order -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -GitHub destaca las Solicitudes de extracción como un espacio para el debate. Todos sus aspectos (comentarios, referencias y confirmaciones) se representan en orden cronológico. Rescribir tu historial de confirmaciones de Git [mientras se realizan las rebases](/articles/about-git-rebase) altera el continuo espacio-tiempo, lo que significa que las confirmaciones pueden no estar representadas en la forma que esperas en la interfaz GitHub. - -Si quieres ver siempre tus confirmaciones en orden, te recomendamos que no uses `git rebase`. Sin embargo, ¡ten por seguro que nada está roto cuando veas cosas que no estén en orden cronológico! diff --git a/translations/es-XL/content/github/developing-online-with-codespaces/connecting-to-your-codespace-from-visual-studio-code.md b/translations/es-XL/content/github/developing-online-with-codespaces/connecting-to-your-codespace-from-visual-studio-code.md deleted file mode 100644 index 117fcbeab14c..000000000000 --- a/translations/es-XL/content/github/developing-online-with-codespaces/connecting-to-your-codespace-from-visual-studio-code.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: Conectarte a tu codespace desde Visual Studio Code -intro: 'Puedes desarrollar tu codespace directamente en {% data variables.product.prodname_vscode %} si conectas la extensión de {% data variables.product.prodname_vs_codespaces %} con tu cuenta en {% data variables.product.product_name %}.' -product: '{% data reusables.gated-features.codespaces %}' -versions: - free-pro-team: '*' ---- - -{% data reusables.codespaces.release-stage %} - -### Conectar la extensión de {% data variables.product.prodname_vs_codespaces %} a tu cuenta de {% data variables.product.prodname_dotcom %} - -Antes de que puedas desarrollar en un codespace directamente en {% data variables.product.prodname_vscode %}, debes configurar la extensión {% data variables.product.prodname_vs_codespaces %} para conectar tu cuenta de {% data variables.product.product_name %}. - -1. Utiliza {% data variables.product.prodname_vs %} Marketplace para instalar la extensión de [{% data variables.product.prodname_vs_codespaces %}](https://marketplace.visualstudio.com/items?itemName=ms-vsonline.vsonline). Para obtener más información, consulta la sección[Extensión de Marketplace](https://code.visualstudio.com/docs/editor/extension-gallery) en la documentación de {% data variables.product.prodname_vscode %}. -2. En {% data variables.product.prodname_vscode %}, en la barra lateral izquierda, da clic en el icono de Extensiones. ![El icono de extensiones en {% data variables.product.prodname_vscode %}](/assets/images/help/codespaces/click-extensions-icon-vscode.png) -3. Debajo de {% data variables.product.prodname_vs_codespaces %}, da clic en el icono de Administrar, después, da clic en **Configuración de Extensión**. ![La opción de configuración de extensión](/assets/images/help/codespaces/select-extension-settings.png) -4. Utiliza el menú desplegable "Vsonline: Proveedor de Cuenta" y selecciona {% data variables.product.prodname_dotcom %}. ![Configurar un Proveedor de Cuenta con {% data variables.product.prodname_dotcom %}](/assets/images/help/codespaces/select-account-provider-vscode.png) -{% data reusables.codespaces.click-remote-explorer-icon-vscode %} -6. Si {% data variables.product.prodname_codespaces %} nose ha seleccionado en el encabezado, da clic en **{% data variables.product.prodname_codespaces %}**. ![El encabezado {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/codespaces-header-vscode.png) -7. Da clic en **Registrarse para ver {% data variables.product.prodname_codespaces %}...**. ![Registrarse para ver {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/sign-in-to-view-codespaces-vscode.png) -8. Para autorizar a {% data variables.product.prodname_vscode %} para acceder a tu cuenta en {% data variables.product.product_name %}, da clic en **Permitir**. -9. Regístrate en {% data variables.product.product_name %} para aprobar la extensión. - -### Abrir un codespace en {% data variables.product.prodname_vscode %} - -Después de que hayas conectado tu cuenta de {% data variables.product.product_name %} a la extensión de {% data variables.product.prodname_vs_codespaces %}, podrás desarrollar un codespace que hayas creado en {% data variables.product.product_name %} directamente en {% data variables.product.prodname_vscode %}. - -{% data reusables.codespaces.click-remote-explorer-icon-vscode %} -2. Debajo de Codespaces, da clic en el codespace en el que quieras desarrollar. -3. Da clic en en el icono de conexión al codespace. ![Icono de conectarse al codespace en {% data variables.product.prodname_vscode %}](/assets/images/help/codespaces/click-connect-to-codespace-icon-vscode.png) diff --git a/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-for-compiled-languages.md b/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-for-compiled-languages.md deleted file mode 100644 index e8256be466a5..000000000000 --- a/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-for-compiled-languages.md +++ /dev/null @@ -1,137 +0,0 @@ ---- -title: Configuring code scanning for compiled languages -shortTitle: Configuring for compiled languages -intro: 'You can configure how {% data variables.product.prodname_dotcom %} scans code written in compiled languages for vulnerabilities and errors.' -product: '{% data reusables.gated-features.code-scanning %}' -permissions: 'Las personas con permisos de escritura en un repositorio pueden configurar {% data variables.product.prodname_code_scanning %} para el mismo.' -versions: - free-pro-team: '*' ---- - -{% data reusables.code-scanning.beta %} - -{% note %} - -**Note**: This article refers to {% data variables.product.prodname_code_scanning %} powered by {% data variables.product.prodname_codeql %}, not to {% data variables.product.prodname_code_scanning %} resulting from the upload of third-party static analysis tools. - -{% endnote %} - -### About {% data variables.product.prodname_code_scanning %} and compiled languages - -To enable {% data variables.product.prodname_code_scanning %} for your repository, you add to the repository a {% data variables.product.prodname_actions %} workflow which includes {% data variables.product.prodname_codeql %} analysis. Para obtener más información, consulta la sección "[Habilitar {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning)". - -{% data reusables.code-scanning.edit-workflow %} -For more information about configuring {% data variables.product.prodname_code_scanning %} and editing workflow files, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)" and "[Configuring a workflow](/actions/configuring-and-managing-workflows/configuring-a-workflow)." - -### About autobuild for {% data variables.product.prodname_codeql %} - -{% data reusables.code-scanning.autobuild-compiled-languages %} - -{% note %} - -**Note**: If you use self-hosted runners for {% data variables.product.prodname_actions %}, you may need to install additional software to use the `autobuild` process. Additionally, if your repository requires a specific version of a build tool, you may need to install it manually. Para obtener más información, consulta "[Software instalado en los ejecutores alojados por GitHub](/actions/reference/software-installed-on-github-hosted-runners)". - -{% endnote %} - -#### C/C++ - -| Supported system type | System name | -| --------------------- | ----------------------------------------------------------- | -| Sistema operativo | Windows and Linux | -| Build system | Autoconf, CMake, qmake, Meson, Waf, SCons, and Linux Kbuild | - -The behavior of the `autobuild` step varies according to the operating system that the extraction runs on. On Windows, the step has no default actions. On Linux, this step reviews the files present in the repository to determine the build system used: - -1. Look for a build system in the root directory. -2. If none are found, search subdirectories for a unique directory with a build system for C/C++. -3. Run an appropriate command to configure the system. - -#### C - -| Supported system type | System name | -| --------------------- | ------------------------------------------ | -| Sistema operativo | Windows and Linux | -| Build system | .NET and MSbuild, as well as build scripts | - -The `autobuild` process attempts to autodetect a suitable build method for C# using the following approach: - -1. Invoke `dotnet build` on the solution (`.sln`) or project (`.csproj`) file closest to the root. -2. Invoke `MSbuild` (Linux) or `MSBuild.exe` (Windows) on the solution or project file closest to the root. If `autobuild` detects multiple solution or project files at the same (shortest) depth from the top level directory, it will attempt to build all of them. -3. Invoke a script that looks like a build script—_build_ and _build.sh_ (in that order, for Linux) or _build.bat_, _build.cmd_, _and build.exe_ (in that order, for Windows). - - -#### Java - -| Supported system type | System name | -| --------------------- | ----------------------------------------- | -| Sistema operativo | Windows, macOS and Linux (no restriction) | -| Build system | Gradle, Maven and Ant | - -The `autobuild` process tries to determine the build system for Java codebases by applying this strategy: - -1. Search for a build file in the root directory. Check for Gradle then Maven then Ant build files. -2. Run the first build file found. If both Gradle and Maven files are present, the Gradle file is used. -3. Otherwise, search for build files in direct subdirectories of the root directory. If only one subdirectory contains build files, run the first file identified in that subdirectory (using the same preference as for 1). If more than one subdirectory contains build files, report an error. - -### Agregar pasos de compilación para un lenguaje compilado - -{% data reusables.code-scanning.autobuild-add-build-steps %} For information about editing the workflow, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#editing-a-code-scanning-workflow)." - -After removing the `autobuild` step, uncomment the `run` step and add build commands that are suitable for your repository. The workflow `run` step runs command-line programs using the operating system's shell. Puedes modificar estos comandos y agregar más de ellos para personalizar el proceso de compilación. - -``` yaml -- run: | - make bootstrap - make release -``` - -Para obtener más información acerca de la palabra clave `run`, consulta la sección "[Sintaxis de flujo de trabajo para { site.data.variables.product.prodname_actions }}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)". - -You can also use a build matrix to update the workflow to build more than one compiled language, if this is the appropriate approach for your system and doesn't cause conflicts. For more information, see "[Configuring a build matrix](/actions/configuring-and-managing-workflows/configuring-a-workflow#configuring-a-build-matrix)." - - -For example, the workflow below runs one job for C/C++ analysis, and another job for Java analysis. - -```yaml - -name: "Code Scanning - Action" - -on: - pull_request: - branches: [master] - push: - branches: [master] - -jobs: - CodeQL-Build: - - strategy: - fail-fast: false - matrix: - language: [ 'cpp', 'java'] - - # CodeQL runs on ubuntu-latest, windows-latest, and macos-latest - runs-on: ubuntu-latest - - steps: - - name: Checkout repository - uses: actions/checkout@v2 - - # Initializes the CodeQL tools for scanning. - - name: Initialize CodeQL - uses: github/codeql-action/init@v1 - with: - languages: ${{ matrix.language }} - - # Autobuild attempts to build any compiled languages (C/C++, C#, or Java). - # If this step fails, then you should remove it and run the build manually. - - name: Autobuild - uses: github/codeql-action/autobuild@v1 - - - name: Perform CodeQL Analysis - uses: github/codeql-action/analyze@v1 -``` - -For more tips and tricks about why `autobuild` won't build your code, see "[Troubleshooting {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning)". - -If you added manual build steps for compiled languages or used a build matrix and {% data variables.product.prodname_code_scanning %} is still not working on your repository, contact {% data variables.contact.contact_support %}. diff --git a/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages.md b/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages.md deleted file mode 100644 index 6a0c27d22a20..000000000000 --- a/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages.md +++ /dev/null @@ -1,135 +0,0 @@ ---- -title: Configuring the CodeQL action for compiled languages -shortTitle: Configurar para los lenguajes compilados -intro: 'You can configure how {% data variables.product.prodname_dotcom %} uses the {% data variables.product.prodname_codeql_workflow %} to scan code written in compiled languages for vulnerabilities and errors.' -product: '{% data reusables.gated-features.code-scanning %}' -permissions: 'Las personas con permisos de escritura en un repositorio pueden configurar {% data variables.product.prodname_code_scanning %} para el mismo.' -redirect_from: - - /github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-for-compiled-languages -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.code-scanning.beta %} -{% data reusables.code-scanning.enterprise-enable-code-scanning-actions %} - -### About the {% data variables.product.prodname_codeql_workflow %} and compiled languages - -You enable {% data variables.product.prodname_dotcom %} to run {% data variables.product.prodname_code_scanning %} for your repository by adding a {% data variables.product.prodname_actions %} workflow to the repository. **Note**: This article refers to {% data variables.product.prodname_code_scanning %} powered by {% data variables.product.prodname_codeql %}, not to {% data variables.product.prodname_code_scanning %} resulting from the upload of third-party static analysis tools. El flujo de trabajo predeterminado de {% data variables.product.prodname_code_scanning %} utiliza el evento `on.push` para activar el escaneo de código cada vez que alguien carga información a cualquier rama que contenga el archivo de flujo de trabajo. - -{% data reusables.code-scanning.edit-workflow %} -For general information about configuring {% data variables.product.prodname_code_scanning %} and editing workflow files, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)" and "[Configuring a workflow](/actions/configuring-and-managing-workflows/configuring-a-workflow)." - -### Acerca de autobuild para {% data variables.product.prodname_codeql %} - -{% data reusables.code-scanning.autobuild-compiled-languages %} - -{% note %} - -**Nota**: Si utilizas los ejecutores auto-hospedados para {% data variables.product.prodname_actions %}, tal vez necesites instalar software adicional para utilizar el proceso de `autobuild`. Adicionalmente, si tu repositorio requiere de una versión específica de una herramienta de compilación, tal vez necesites instalarla manualmente. Para obtener más información, consulta "[Software instalado en los ejecutores alojados por GitHub](/actions/reference/software-installed-on-github-hosted-runners)". - -{% endnote %} - -#### C/C++ - -| Tipo de sistema compatible | Nombre del sistema | -| -------------------------- | --------------------------------------------------------- | -| Sistema operativo | Windows y Linux | -| Sistema de compilación | Autoconf, CMake, qmake, Meson, Waf, SCons, y Linux Kbuild | - -El comportamiento del paso de `autobuild` varía de acuerdo con el sistema operativo en el que se ejecute la extracción. Wn Windows, el paso no tiene acciones predeterminadas. En Linux, este paso revisa los archivos presentes en el repositorio para determinar el sistema de compilación que se utilizó: - -1. Busca un sistema de compilación en el directorio raíz. -2. Si no se encuentra ninguno, busca un directorio único en los subdirectorios, el cual cuente con un sistema de compilación para C/C++. -3. Ejecuta un comando adecuado para configurar el sistema. - -#### C - -| Tipo de sistema compatible | Nombre del sistema | -| -------------------------- | --------------------------------------------------- | -| Sistema operativo | Windows y Linux | -| Sistema de compilación | .NET y MSbuild, así como los scripts de compilación | - -El proceso de `autobuild` intenta autodetectar un método de compilación adecuado para C# utilizando el siguiente acercamiento: - -1. Invoca a `dotnet build` en el archivo (`.sln`) de la solución o en el archivo (`.csproj`) del proyecto que esté más cercano a la raíz. -2. Invoca a `MSbuild` (Linux) o a `MSBuild.exe` (Windows) en el archivo de la solución o del proyecto más cercano a la raíz. Si `autobuild` detecta soluciones o archivos de proyecto múltiples en la misma profundidad (la más corta) desde el directorio de nivel superior, entonces intentará compilarlos todos. -3. Invoca un script que se parece a un script de compilación—_build_ y _build.sh_ (en ese orden, para Linux) o _build.bat_, _build.cmd_, _y build.exe_ (en ese orden, para Windows). - -#### Java - -| Tipo de sistema compatible | Nombre del sistema | -| -------------------------- | ---------------------------------------- | -| Sistema operativo | Windows, macOS y Linux (sin restricción) | -| Sistema de compilación | Gradle, Maven y Ant | - -El proceso de `autobuild` intenta determinar el sistema de compilación para las bases de código de Java aplicando esta estrategia: - -1. Busca un archivo de compilación en el directorio raíz. Busca a Gradle en Maven y luego Ant compila los archivos. -2. Ejecuta el primer archivo de compilación que encuentre. Si tanto los archivos de Gradle como los de Maven están presentes, se utiliza el archivo de Gradle. -3. De lo contrario, usca los archivos de compilación en los subidrectorios directos del directorio raíz. Si solo un subdirectorio contiene archivos de compilación, ejecuta el primer archivo identificado en este subdirectorio (utilizando la misma preferencia que para 1). Si más de un subdirectorio contiene archivos de compilación, reporta un error. - -### Agregar pasos de compilación para un lenguaje compilado - -{% data reusables.code-scanning.autobuild-add-build-steps %} Para obtener información acerca de cómo editar el flujo de trabajo, consulta la sección "[Configurar el {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#editing-a-code-scanning-workflow)". - -Después de eliminar el paso de `autobuild`, quita el comentario del paso de `run` y agrega los comandos de compilación que son adecuados para tu repositorio. El paso de `run` en el flujo de trabajo ejecuta programas de línea de comandos que utiizan el shell del sistema operativo. Puedes modificar estos comandos y agregar más de ellos para personalizar el proceso de compilación. - -``` yaml -- run: | - make bootstrap - make release -``` - -Para obtener más información acerca de la palabra clave `run`, consulta la sección "[Sintaxis de flujo de trabajo para { site.data.variables.product.prodname_actions }}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)". - -También puedes utilizar una matriz de compilación para actualizar el flujo de trabajo para que compile más de un lenguaje compilado, en caso de que éste es el acercamiento adecuado para tu sistema y no causa conflictos. Para obtener más información, consulta la sección "[Configurar una matriz de compilación](/actions/configuring-and-managing-workflows/configuring-a-workflow#configuring-a-build-matrix)". - - -Por eejmplo, el siguiente flujo de trabajo ejecuta un job para análisis de C/C++ y otro para análisis de Java. - -```yaml - -name: "CodeQL" - -on: - push: - branches: [main, ] - pull_request: - branches: [main] - -jobs: - CodeQL-Build: - - strategy: - fail-fast: false - matrix: - language: ['cpp', 'java'] - -{% if currentVersion ver_gt "enterprise-server@2.21" %} runs-on: self-hosted -{% else %} # CodeQL runs on ubuntu-latest, windows-latest, and macos-latest - runs-on: ubuntu-latest{% endif %} - - steps: - - name: Checkout repository - uses: actions/checkout@v2 - - # Initializes the CodeQL tools for scanning. - - name: Initialize CodeQL - uses: github/codeql-action/init@v1 - with: - languages: ${{ matrix.language }} - - # Autobuild attempts to build any compiled languages (C/C++, C#, or Java). - # If this step fails, then you should remove it and run the build manually. - - name: Autobuild - uses: github/codeql-action/autobuild@v1 - - - name: Perform CodeQL Analysis - uses: github/codeql-action/analyze@v1 -``` - -Para encontrar más tips del porqué `autobuild` no compilará tu código, consulta la sección "[Solucionar problemas del {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning)". - -Si agregaste pasos de compilación manuales para los lenguajes compilados o si utilizaste una matriz de compilación y el {% data variables.product.prodname_code_scanning %} sigue sin funcionar en tu repositorio, contacta a {% data variables.contact.contact_support %}. diff --git a/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning.md b/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning.md deleted file mode 100644 index 705b0db7329a..000000000000 --- a/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: Habilitar el escaneo de código -intro: 'Puedes habilitar {% data variables.product.prodname_code_scanning %} para el repositorio de tu proyecto.' -product: '{% data reusables.gated-features.code-scanning %}' -permissions: 'Las personas con permisos de escritura en un repositorio pueden habilitar {% data variables.product.prodname_code_scanning %} para éste.' -redirect_from: - - /github/managing-security-vulnerabilities/configuring-automated-code-scanning -versions: - free-pro-team: '*' ---- - -{% data reusables.code-scanning.beta %} - -### Habilitar {% data variables.product.prodname_code_scanning %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-security %} -3. A la derecha de "Escaneo de código", da clic en **Configurar escaneo de código**. ![botón de "configurar escaneo de código" a la derecha de "escaneo de código" en el Resumen de Seguridad.](/assets/images/help/security/overview-set-up-code-scanning.png) -4. Debajo de "Empezar con el escaneo de código", da clic en **Configurar este flujo de trabajo**. ![Botón de "configurar este flujo de trabajo" debajo del título "empezar con el escaneo de código"](/assets/images/help/repository/code-scanning-set-up-this-workflow.png) -5. Opcionalmente, para personalizar como {% data variables.product.prodname_code_scanning %} escanea tu código, edita el flujo de trabajo. Para obtener más información, consulta "[Configurar {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)". -6. Utiliza el menú desplegable de**Comenzar confirmación**, y teclea un mensaje de confirmación. ![Iniciar confirmación](/assets/images/help/repository/start-commit-commit-new-file.png) -7. Escoge si te gustaría confirmar directamente en la rama predeterminada, o crear una nueva rama y comenzar una solicitud de extracción. ![Escoger dónde confirmar](/assets/images/help/repository/start-commit-choose-where-to-commit.png) -8. Da clic en **Confirmar archivo nuevo** o en **Proponer archivo nuevo**. - -Después de que confirmes el archivo de flujo de trabajo o crees una solicitud de extracción, {% data variables.product.prodname_code_scanning %} analizará tu código de acuerdo con la frecuencia que hayas especificado en tu archivo de flujo de trabajo. Si creaste una solicitud de extracción, {% data variables.product.prodname_code_scanning %} solo analizará el código en la rama de tema de esta solicitud hasta que la fusiones en la rama predeterminada del repositorio. - -### Pasos siguientes - -Después de que habilites {% data variables.product.prodname_code_scanning %}, podrás monitorear los análisis, ver resultados, y personalizar aún más la forma en la que escaneas tu código. - -- Puedes ver el estado de ejecución de {% data variables.product.prodname_code_scanning %} y recibir notificaciones para las ejecuciones que se completen. Para obtener más información, consulta la sección "[Administrar una ejecución de flujo de trabajo](/actions/configuring-and-managing-workflows/managing-a-workflow-run)" y "[Configurar notificaciones](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)". -- Después de que se complete un escaneo, puedes ver las alertas del escaneo completado. Para obtener más información, consulta la sección "[Administrar alertas desde {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)". -- Puedes personalizar cómo {% data variables.product.prodname_code_scanning %} escanea el código en tu repositorio. Para obtener más información, consulta la sección "[Configurar el escaneo de código](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)". diff --git a/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning.md b/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning.md deleted file mode 100644 index 24cdf7f418d3..000000000000 --- a/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning.md +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: Administrar alertas del escaneo de código -shortTitle: Administrar alertas -intro: 'Puedes ver, arreglar y cerrar alertas para los errores o vulnerabilidades potenciales en el código de tu proyecto.' -product: '{% data reusables.gated-features.code-scanning %}' -permissions: 'Las personas con permisos de escritura en un repositorio pueden administrar las alertas de {% data variables.product.prodname_code_scanning %} para el repositario.' -redirect_from: - - /github/managing-security-vulnerabilities/managing-alerts-from-automated-code-scanning -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.code-scanning.beta %} -{% data reusables.code-scanning.enterprise-enable-code-scanning %} - -### Acerca de las alertas de {% data variables.product.prodname_code_scanning %} - -After you enable {% data variables.product.prodname_code_scanning %}, {% data variables.product.prodname_dotcom %} displays {% data variables.product.prodname_code_scanning %} alerts in your repository. El flujo de trabajo predeterminado de {% data variables.product.prodname_code_scanning %} utiliza el evento `on.push` para activar el escaneo de código cada vez que alguien carga información a cualquier rama que contenga el archivo de flujo de trabajo. - -Each alert highlights a problem with the code and the name of the tool that identified it. Puedes ver la línea de código que activó la alerta, así como las propiedades de la misma, tales como la severidad y la naturaleza de dicho problema. Las alertas también te dicen si el problema se introdujo por primera vez. For alerts identified by {% data variables.product.prodname_codeql %} analysis, you will also see information on how to fix the problem. - -![Ejemplo de alerta de {% data variables.product.prodname_code_scanning %}](/assets/images/help/repository/code-scanning-alert.png) - -Si no quieres tomar la acción que se recomienda en la alerta, puedes cerrarla manualmente. Por ejemplo, puedes cerrar una alerta para el código que se utilice para pruebas, o si crees que ésta es un falso positivo. También puede que quieras cerrar una alerta si el esfuerzo para arreglar el error en el código es mayor que el beneficio potencial de mejorarlo. - -Por defecto, {% data variables.product.prodname_dotcom %} muestra alertas para la rama predeterminada y para cualquier rama protegida. Puedes clasificar y filtrar la lista de alertas para ver únicamente aquellas que te interesen. - -Puedes ver las alertas que se introdujeron en una solicitud de extracción y tomar acción inmediata. Cuando {% data variables.product.prodname_code_scanning %} encuentra errores o vulnerabilidades en una solicitud de extracción, {% data variables.product.prodname_dotcom %} muestra anotaciones en la línea de tiempo así como las vistas diferenciales de dicha solicitud. - -If you enable {% data variables.product.prodname_code_scanning %} using {% data variables.product.prodname_codeql %}, this can also detect data-flow problems in your code. Data-flow analysis finds potential security issues in code, such as: using data insecurely, passing dangerous arguments to functions, and leaking sensitive information. - -Cuando {% data variables.product.prodname_code_scanning %} reporta alertas de flujo de datos, {% data variables.product.prodname_dotcom %} te muestra como se mueven los datos a través del código. {% data variables.product.prodname_code_scanning_capc %} allows you to identify the areas of your code that leak sensitive information, and that could be the entry point for attacks by malicious users. - -{% data reusables.code-scanning.you-can-upload-third-party-analysis %}{% data reusables.code-scanning.get-started-uploading-third-party-data %} - -If you scan your code using a third-party tool or scan your code with custom {% data variables.product.prodname_codeql %} queries, {% data variables.product.prodname_dotcom %} will only use the supported SARIF 2.1.0 properties to display alerts. Los resultados de herramientas de terceros o las consultas personalizadas podrían no incluir todas las propiedades que ves cuando escaneas tu código utilizando las consultas predeterminadas de {% data variables.product.prodname_codeql %} en {% data variables.product.company_short %}. Para obtener más información, consulta la sección "[Soporte de SARIF para {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning)". - -### Visualizar una alerta - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-security %} -{% data reusables.repositories.sidebar-code-scanning-alerts %} -{% data reusables.code-scanning.click-alert-in-list %} -5. Opcionalmente, si la alerta resalta un problema con el flujo de datos, da clic en **Mostrar ruta** para revisar la ruta de los datos. ![Ejemplo de alerta de flujo de datos](/assets/images/help/repository/code-scanning-show-paths.png) - -### Cerrar una alerta - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-security %} -{% data reusables.repositories.sidebar-code-scanning-alerts %} -{% data reusables.code-scanning.click-alert-in-list %} -5. Utiliza el menú desplegable de "Cerrar" y da clic en una razón para cerrar la alerta. ![Escoger una razón para cerrar la alerta a través del menú desplegable de "Cerrar"](/assets/images/help/repository/code-scanning-alert-close-drop-down.png) - -### Leer más - -- "[{% data variables.product.prodname_code_scanning_capc %}](http://developer.github.com/v3/code-scanning)" -- "[{% data variables.product.prodname_code_scanning_capc %} API](/v3/code-scanning)" diff --git a/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-results-from-code-scanning.md b/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-results-from-code-scanning.md deleted file mode 100644 index 66a325374715..000000000000 --- a/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-results-from-code-scanning.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Administrar resultados del escaneo de código -shortTitle: Administrar los resultados -intro: 'Puedes ver, clasificar, entender y resolver errores y vulnerabilidades que encuentre {% data variables.product.prodname_code_scanning %}.' -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning.md b/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning.md deleted file mode 100644 index 36819579483d..000000000000 --- a/translations/es-XL/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning.md +++ /dev/null @@ -1,130 +0,0 @@ ---- -title: Troubleshooting code scanning -shortTitle: Troubleshooting -intro: 'You can see tips to resolve common issues with {% data variables.product.prodname_code_scanning %}.' -product: '{% data reusables.gated-features.code-scanning %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.code-scanning.beta %} -{% data reusables.code-scanning.enterprise-enable-code-scanning %} - -### Automatic build for a compiled language fails - -If an automatic build of code for a compiled language within your project fails, try the following troubleshooting steps. - -- Remove the `autobuild` step from your {% data variables.product.prodname_code_scanning %} workflow and add specific build steps. For information about editing the workflow, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#editing-a-code-scanning-workflow)." For more information about replacing the `autobuild` step, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." -- If the repository for your project contains code in a specific language that does not build, disable automatic language detection in your {% data variables.product.prodname_code_scanning %} workflow and specify only the languages you want to build. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#overriding-automatic-language-detection)." - -### No code found during the build - -If your workflow fails with an error `No source code was seen during the build` or `The process '/opt/hostedtoolcache/CodeQL/0.0.0-20200630/x64/codeql/codeql' failed with exit code 32`, this indicates that {% data variables.product.prodname_codeql %} was unable to trace your code. Several reasons can explain such a failure: - -1. Automatic language detection identified a supported language, but there is no analyzable code of that language in the repository. A typical example is when our language detection service finds a file associated with a particular programming language like a `.h`, or `.gyp` file, but no corresponding executable code is present in the repository. To solve the problem, you can manually define the languages you want to analyze by updating the `init` step to specify the supported languages that are present in your repository. For example, the following configuration will analyze only Go, and JavaScript. - - ```yaml - - name: Initialize CodeQL - uses: github/codeql-action/init@v1 - with: - languages: go, javascript # Other options are csharp, python, cpp, java - ``` -2. Your {% data variables.product.prodname_code_scanning %} workflow is analyzing a compiled language (C, C++, C#, or Java), but the code was not compiled. By default, the {% data variables.product.prodname_codeql %} analysis workflow contains an `autobuild` step, however, this step represents a best effort process, and may not succeed in building your code, depending on your specific build environment. Compilation may also fail if you have removed the `autobuild` step and did not include build steps manually. For more information about specifying build steps, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." -3. Your workflow is analyzing a compiled language (C, C++, C#, or Java), but portions of your build are cached to improve performance (most likely to occur with build systems like Gradle or Bazel). Since {% data variables.product.prodname_codeql %} observes the activity of the compiler to understand the data flows in a repository, {% data variables.product.prodname_codeql %} requires a complete build to take place in order to perform analysis. -4. Your workflow is analyzing a compiled language (C, C++, C#, or Java), but compilation does not occur between the `init` and `analyze` steps in the workflow. {% data variables.product.prodname_codeql %} requires that your build happens in between these two steps in order to observe the activity of the compiler and perform analysis. -5. Your compiled code (in C, C++, C#, or Java) was compiled successfully, but {% data variables.product.prodname_codeql %} was unable to detect the compiler invocations. The most common causes are certain configuration options like running your build process in a container, if you're building using a distributed build system external to {% data variables.product.prodname_actions %} using a daemon process, or if {% data variables.product.prodname_codeql %} isn't aware of the specific compiler you are using. - 1. For C# projects using either `dotnet build` or `msbuild` which target .NET Core 2, you should specify `/p:UseSharedCompilation=false` in your workflow's `run` step, when you build your code. The `UseSharedCompilation` flag isn't necessary for .NET Core 3.0 and later. - - For example, the following configuration will pass the flag during the first build step. - - ```yaml - - run: | - dotnet build /p:UseSharedCompilation=false - ``` - 2. If you encounter another problem with your specific compiler or configuration, contact {% data variables.contact.contact_support %}. - -For more information about specifying build steps, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." - -### Portions of my repository were not analyzed using `autobuild` - -The {% data variables.product.prodname_codeql %} `autobuild` feature uses heuristics to build the code in a repository, however, sometimes this approach results in incomplete analysis of a repository. For example, when multiple `build.sh` commands exist in a single repository, the analysis may not complete since the `autobuild` step will only execute one of the commands. The solution is to replace the `autobuild` step with build steps which build all of the source code which you wish to analyze. Alternatively, if more than one compiled language is present in your repository and you want {% data variables.product.prodname_code_scanning %} to analyze all these compiled languages, you can use a build matrix in your workflow. {% if currentVersion ver_gt "enterprise-server@2.21" %}To use a build matrix, you should make sure that {% data variables.product.prodname_actions %} is enabled on {% data variables.product.product_location_enterprise %}. {% endif %}For more information, see "[Managing complex workflows](/actions/learn-github-actions/managing-complex-workflows/#using-a-build-matrix)" and -"[Configuring the {% data variables.product.prodname_codeql %} action for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages#adding-build-steps-for-a-compiled-language)." - -### Error: "Server error" - -If the run of a workflow for {% data variables.product.prodname_code_scanning %} fails due to a server error, try running the workflow again. If the problem persists, contact {% data variables.contact.contact_support %}. - -### Error: "Out of disk" or "Out of memory" - -On very large projects, {% data variables.product.prodname_codeql %} may run out of disk or memory on the runner. -{% if currentVersion == "free-pro-team@latest" %}If you encounter this issue on a hosted {% data variables.product.prodname_actions %} runner, contact {% data variables.contact.contact_support %} so that we can investigate the problem. -{% else %}If you encounter this issue, try increasing the memory on the runner.{% endif %} - -### The build takes too long - -If your build with {% data variables.product.prodname_codeql %} analysis takes too long to run, there are several approaches you can try to reduce the build time. - -#### Increase the memory or cores - -If you use self-hosted runners to run {% data variables.product.prodname_codeql %} analysis, you can increase the memory or the number of cores on those runners. - -#### Use matrix builds to parallelize the analysis - -By default, {% data variables.product.prodname_codeql %} performs analysis of each language sequentially, which can impact performance, especially for repositories with more than one language. You can speed analysis up by using a build matrix that splits the analysis by language. {% if currentVersion ver_gt "enterprise-server@2.21" %}To use a build matrix, you should make sure that {% data variables.product.prodname_actions %} is enabled on {% data variables.product.product_location_enterprise %}. {% endif %}For more information, see "[Managing complex workflows](/actions/learn-github-actions/managing-complex-workflows/#using-a-build-matrix)." - -For example, the workflow below will be run with one job for JavaScript analysis, and another job for Go analysis. - -```yaml - -name: "Code Scanning - Action" - -on: - pull_request: - branches: [main] - push: - branches: [main] - -jobs: - CodeQL-Build: - - strategy: - fail-fast: false - matrix: - language: [ 'go', 'javascript'] - - # CodeQL runs on ubuntu-latest, windows-latest, and macos-latest - runs-on: ubuntu-latest - - steps: - - name: Checkout repository - uses: actions/checkout@v2 - - # Initializes the CodeQL tools for scanning. - - name: Initialize CodeQL - uses: github/codeql-action/init@v1 - with: - languages: ${{ matrix.language }} - - # Autobuild attempts to build any compiled languages (C/C++, C#, or Java). - # If this step fails, then you should remove it and run the build manually (see below). - - name: Autobuild - uses: github/codeql-action/autobuild@v1 - - - name: Perform CodeQL Analysis - uses: github/codeql-action/analyze@v1 -``` - -#### Reduce the amount of code being analyzed in a single workflow - -Analysis time is typically proportional to the amount of code being analyzed. You can reduce the analysis time by reducing the amount of code being analyzed at once, for example, by excluding test code, or breaking analysis into multiple workflows that analyze only a subset of your code at a time. - -For compiled languages like Java, C, C++, and C#, {% data variables.product.prodname_codeql %} analyzes all of the code which was built during the workflow run. To limit the amount of code being analyzed, build only the code which you wish to analyze by specifying your own build steps in a `run` block. You can combine specifying your own build steps with using the `paths` or `paths-ignore` filters on the `pull_request` and `push` events to ensure that your workflow only runs when specific code is changed. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)." - -For interpreted languages like Go, JavaScript, Python, and TypeScript, that {% data variables.product.prodname_codeql %} analyzes without a specific build, you can specify additional configuration options to limit the amount of code to analyze. For more information, see "[Specifying directories to scan](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#specifying-directories-to-scan)." - -If you split your analysis into multiple workflows as described above, we still recommend that you have at least one workflow which runs on a `schedule` which analyzes all of the code in your repository. Because {% data variables.product.prodname_codeql %} analyzes data flows between components, some complex security behaviors may only be detected on a complete build. - -#### Run only during a `schedule` event - -If your analysis is still too slow to be run during `push` or `pull_request` events, then you may want to only trigger analysis on the `schedule` event. For more information, see "[Events](/actions/learn-github-actions/introduction-to-github-actions#events)." diff --git a/translations/es-XL/content/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies.md b/translations/es-XL/content/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies.md deleted file mode 100644 index cb61de043f58..000000000000 --- a/translations/es-XL/content/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies.md +++ /dev/null @@ -1,59 +0,0 @@ ---- -title: Acerca de las alertas de seguridad para las dependencias vulnerables -intro: '{% data variables.product.product_name %} envía alertas de seguridad cuando detectamos vulnerabilidades que afecten a tu repositorio.' -redirect_from: - - /articles/about-security-alerts-for-vulnerable-dependencies -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -### Acerca de las vulnerabilidades de seguridad - -{% data reusables.repositories.a-vulnerability-is %} Dependiendo del nivel de gravedad y la manera en la que tu proyecto utiliza la dependencia, las vulnerabilidades pueden causar diversos problemas para el mismo y para la gente que lo utiliza. Puedes hacer un seguimiento y resolver las vulnerabilidades para ciertos tipos de dependencias en tu repositorio de {% data variables.product.product_name %}. - -Te enviaremos una alerta de seguridad si {% data variables.product.prodname_dotcom %} detecta una vulnerabilidad desde el {% data variables.product.prodname_advisory_database %} o desde [WhiteSource](https://www.whitesourcesoftware.com/GitHubSecurityAlerts) en una de las dependencias de la gráfica de dependencias de tu repositorio. Para obtener más información acerca de {% data variables.product.prodname_advisory_database %}, consulta la sección "Buscar vulnerabilidades de seguridad en el {% data variables.product.prodname_advisory_database %}". - -{% if currentVersion == "free-pro-team@latest" %} -### Alertas y actualizaciones de seguridad automatizadas para dependencias vulnerables -{% else %} -### Alertas de seguridad para las dependencias vulnerables -{% endif %} - -Cuando se añade una nueva vulnerabilidad a la Base de Datos de Asesoría de GitHub, identificamos los {% if currentVersion == "free-pro-team@latest" %}repositorios{% endif %}públicos{% if currentVersion == "free-pro-team@latest" %} (y los repositorios privados que se han unido a la detección de vulnerabilidades){% endif %}que utilizan la versión afectada de la dependencia{% if currentVersion == "free-pro-team@latest" %}, enviamos una alerta de seguridad a los mantenedores del repositorio además de generar una actualización de seguridad automatizada {% else %} y enviar una alerta de seguridad a los mantenedores del mismo{% endif %}. - -Cada alerta de seguridad incluye un nivel de gravedad{% if currentVersion == "free-pro-team@latest" %}, un enlace al archivo afectado en tu proyecto, y un enlace a una solicitud de extracción que contiene una actualización de seguridad automatizada que resuelve la vulnerabilidad{% else %}{% endif %}. Cuando esté disponible, la alerta incluirá más detalles acerca de la vulnerabilidad. - -Puedes ver todas las alertas que afectan a un proyecto{% if currentVersion == "free-pro-team@latest" %} en particular en la pestaña Alertas del repositorio o{% endif %} en el gráfico de dependencias del repositorio.{% if currentVersion == "free-pro-team@latest" %} Para obtener información, consulta "[ Ver y actualizar las dependencias vulnerables en tu repositorio](/articles/viewing-and-updating-vulnerable-dependencies-in-your-repository)".{% endif %} - -Enviamos alertas de seguridad para las personas con permisos de administrador en los repositorios por defecto afectados. {% data variables.product.product_name %} nunca divulga públicamente las vulnerabilidades identificadas para ningún repositorio.{% if currentVersion == "free-pro-team@latest" %} También puedes activar alertas de seguridad para personas y equipos adicionales que trabajan en los repositorios que son propiedad de una organización. Para obtener más información, consulta "[Administrar las alertas por dependencias vulnerables en los repositorios de tu organización](/articles/managing-alerts-for-vulnerable-dependencies-in-your-organization-s-repositories)".{% endif %} - -{% data reusables.repositories.enable-security-alerts %} -{% if currentVersion == "free-pro-team@latest" %} -Las actualizaciones de seguridad automatizadas actualizan las dependencias vulnerables a la versión mínima que resuelve la vulnerabilidad. Estas se habilitan automáticamente en los repositorios que utilicen la gráfica de dependencias y las alertas de seguridad, pero puedes decidir inhabilitar las solicitudes de extracción automáticas y generar las actualizaciones de seguridad manualmente. Para obtener más información, consulta la sección "[Configurar las actualizaciones de seguridad automatizadas](/github/managing-security-vulnerabilities/configuring-automated-security-updates)". - -{% data variables.product.prodname_dotcom %} detecta y alerta sobre las dependencias vulnerables en los repositorios _públicos_ por defecto. Para recibir alertas de seguridad por dependencias vunerables en un repositorio _privado_, un propietario de o una persona con acceso de administrador al repositorio debe activar el gráfico de dependencias y las alertas de seguridad en el repositorio. Para obtener más información, consulta "[Incluir o excluir uso de datos para tu repositorio privado](/articles/opting-into-or-out-of-data-use-for-your-private-repository)". -{% endif %} - -Para obtener una lista de los idiomas admitidos que {% data variables.product.product_name %} pueden detectar vulnerabilidades y dependencias, consulta "[Detallar los paquetes de los que depende un repositorio](/articles/listing-the-packages-that-a-repository-depends-on)". - -{% warning %} - -**Nota**: Las características de seguridad de {% data variables.product.product_name %}, como las alertas de seguridad, no afirman atrapar todas las vulnerabilidades. Aunque siempre estamos intentando actualizar nuestra base de datos de vulnerabilidades y alertarte con nuestra información más actualizada, no nos será posible atrapar todo o alertarte sobre vulnerabilidades conocidas dentro de un plazo garantizado. Estas características no son sustitutos de la revisión humana de cada dependencia por posibles vulnerabilidades o cualquier otra cuestión. Te recomendamos consultar con un servicio de seguridad o realizar una revisión de vulnerabilidad exhaustiva cuando sea necesario. - -{% endwarning %} - -### Configurar notificaciones para alertas de notificaciones - -Predeterminadamente, recibirás alertas de seguridad por correo electrónico{% if currentVersion == "free-pro-team@latest" %}, agrupadas por la vulnerabilidad específica{% endif %}. También puedes elegir recibir las alertas de seguridad en un correo electrónico semanal que las resuma en hasta 10 de tus repositorios, en tus notificaciones web, o en la interfaz de usuario de {% data variables.product.product_name %}. Para obtener más información, consulta la sección {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}"[Configurar las notificaciones](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#security-alert-options){% else %}"[Elegir el método de entrega para tus notificaciones](/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications){% endif %}". - -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" % %}{% data reusables.repositories.security-alerts-x-github-severity %} Para obtener más información, consulta la sección {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}"[Configurar las notificaciones](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#filtering-email-notifications){% else %}"[Acerca de las notificaciones por correo electrónico](/github/receiving-notifications-about-activity-on-github/about-email-notifications){% endif %}".{% endif %} - -### Leer más - -{% if currentVersion == "free-pro-team@latest" %}- "[Configurar las actualizaciones de seguridad automatizadas](/github/managing-security-vulnerabilities/configuring-automated-security-updates)" -- "[Ver y actualizar las dependencias vulnerables en tu repositorio](/articles/viewing-and-updating-vulnerable-dependencies-in-your-repository)" -- " -Entender cómo {% data variables.product.product_name %} utiliza y protege tus datos"{% endif %} - - - [Definición de MITRE de "vulnerabilidad"](https://cve.mitre.org/about/terminology.html#vulnerability) diff --git a/translations/es-XL/content/github/managing-security-vulnerabilities/configuring-automated-security-updates.md b/translations/es-XL/content/github/managing-security-vulnerabilities/configuring-automated-security-updates.md deleted file mode 100644 index b189a9c0ab01..000000000000 --- a/translations/es-XL/content/github/managing-security-vulnerabilities/configuring-automated-security-updates.md +++ /dev/null @@ -1,92 +0,0 @@ ---- -title: Configurando actualizaciones de seguridad automatizadas -intro: Puedes usar solicitudes de extracción automatizadas o manuales para actualizar fácilmente dependencias vulnerables. -redirect_from: - - /articles/configuring-automated-security-fixes - - /github/managing-security-vulnerabilities/configuring-automated-security-fixes -versions: - free-pro-team: '*' ---- - -### Sobre las actualizaciones de seguridad automatizadas - -Puedes habilitar actualizaciones de seguridad automatizadas para cualquier repositorio que utilice alertas de seguridad y el gráfico de dependencias. Puedes desactivar las actualizaciones de seguridad automatizadas para un repositorio individual o para todos los repositorios que sean propiedad de tu cuenta de usuario u organización. - -Cuando recibas una alerta de seguridad sobre una dependencia vulnerable en tu repositorio, puedes resolver la vulnerabilidad usando una actualización de seguridad automatizada en una solicitud de extracción que corresponde a dicha alerta. Las actualizaciones de seguridad automatizadas se encuentran disponibles en los repositorios que utilicen la gráfica de dependencias. Por defecto, {% data variables.product.prodname_dotcom %} automáticamente crea una solicitud de extracción en tu repositorio para actualizar la dependencia vulnerable a la mínima versión segura posible que se necesita para evitar la vulnerabilidad. Si lo prefieres, puedes inhabilitar las solicitudes de extracción automáticas y crear manualmente solicitudes de extracción para actualizar dependencias solo cuando lo desees. - -Las solicitudes de seguridad automatizadas tienen todo lo que necesitas para revisar y fusionar de manera rápida y segura una corrección propuesta en tu proyecto, incluida la información sobre la vulnerabilidad como notas de lanzamiento, entradas de registro de cambios y detalles de confirmaciones. - -Las actualizaciones de seguridad automatizadas se abren por medio de Dependabot a nombre de {% data variables.product.prodname_dotcom %}. El Dependabot {% data variables.product.prodname_github_app %} se instala automáticamente en cada repositorio donde se habiliten las actualizaciones de seguridad automatizadas. - -Las personas con acceso a las alertas de seguridad de tu repositorio verán un enlace a las alertas de seguridad pertinentes, si bien otras personas con acceso a la solicitud de extracción no podrán ver qué vulnerabilidad resuelve la solicitud de extracción. - -Cuando fusionas una solicitud de extracción que contiene una actualización de seguridad automatizada, la alerta de seguridad correspondiente se marca como resuelta en tu repositorio. - -{% note %} - -**Nota:**Las actualizaciones de seguridad automatizadas únicamente resuelven vulnerabilidades de seguridad. Las actualizaciones de seguridad automatizadas no se crean para resolver vulnerabilidades en registros o paquetes privados hospedados en repositorios privados. - -{% endnote %} - -### Repositorios compatibles - -{% data variables.product.prodname_dotcom %} habilita automáticamente las actualizaciones de seguridad automatizadas para todo repositorio que cumpla con los siguientes requisitos. - -{% note %} - -**Nota**: Para los repositorios creados antes de noviembre de 2019, {% data variables.product.prodname_dotcom %} ha habilitado automáticamente las actualizaciones de seguirdad automatizadas si el repositorio cumple con los siguientes criterios y ha recibido por lo menos una subida de información desde el 23 de mayo de 2019. - -{% endnote %} - -| Requisito | Más información | -| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Que el repositorio no sea una bifrucación | "[Acerca de las bifurcaciones](/github/collaborating-with-issues-and-pull-requests/about-forks)" | -| Que el repositorio no esté archivado | "[Archivar repositorios](/github/creating-cloning-and-archiving-repositories/archiving-repositories)" | -| Que el repositorio sea público, o que sea privado y hayas habilitado un análisis de solo lectura por {% data variables.product.prodname_dotcom %}, gráfica de dependencias y alertas de vulnerabilidades en la configuración del mismo | "[Optar por utilizar datos para tu repositorio privado](/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-data-use-for-your-private-repository#opting-into-data-use-for-your-private-repository)" | -| Que el repositorio contenga un archivo de manifiesto de dependencias de un ecosistema de paquete que sea compatible con {% data variables.product.prodname_dotcom %} | "[Ecosistemas de paquete compatibles](/github/visualizing-repository-data-with-graphs/listing-the-packages-that-a-repository-depends-on#supported-package-ecosystems)" | -| Que las actualizaciones de seguridad automatizadas no se inhabiliten en el repositorio | "[Administrar las actualizaciones de seguridad automatizadas para tu repositorio](#managing-automated-security-updates-for-your-repository)" | -| Que el repositorio no esté utilizando ya una integración para administración de dependencias | "[Acerca de las integraciones](/github/customizing-your-github-workflow/about-integrations)" | - -Si tu repositorio no tiene habilitadas las actualizaciones de seguridad automatizadas y no sabes por qué, puedes [contactar a soporte](https://support.github.com/contact). - -### Acerca de las puntuaciones de compatibilidad - -Las actualizaciones de seguridad automatizadas también incluyen puntajes de compatibilidad para que puedas saber si actualizar una vulnerabilidad podría causar cambios importantes en tu proyecto. Revisamos las pruebas de IC aprobadas previamente en repositorios públicos donde hemos generado alguna actualización de seguridad automática para aprender si esta causa que las pruebas fallen. Una puntuación de compatibilidad de la actualización es el porcentaje de ejecuciones de CI que se aprobaron al actualizar entre las versiones relevantes de la dependencia. - -### Administrar las actualizaciones de seguridad automatizadas para tu repositorio - -Puedes habilitar o inhabilitar las actualizaciones de seguridad automatizadas par aun repositorio individual. - -Estas actualizaciones requieren una configuración específica del repositorio. Para obtener más información, consulta la sección "[Repositorios compatibles](#supported-repositories)". - -{% data reusables.repositories.you-can-enable-or-disable-security-features %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-security %} -4. Arriba del listado de alertas, utiliza el menú desplegable y selecciona o deselecciona **Actualizaciones de seguridad automatizadas**. ![Menú desplegable con la opción de habilitar las actualizaciones de seguridad automatizadas](/assets/images/help/repository/enable-automated-security-updates-drop-down.png) - -### Administrar las actualizaciones de seguridad automatizadas para tu cuenta de usuario - -Puedes inhabilitar las actualizaciones de seguridad automatizadas para todos los repositorios que pertenezcan a tu cuenta de usuario. Si lo haces, aún puedes habilitar dichas actualizaciones para repositorios individuales que pertenezcan a tu cuenta de usuario. - -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.security %} -{% data reusables.repositories.opt-out-automated-security-updates %} - -### Administrar las actualizaciones de seguridad automatizadas para tu organización - -Los propietarios de las organizaciones pueden inhabilitar las actualizaciones de seguridad automatizadas para todos los repositorios que les pertenezcan. Si lo hacen, cualquiera con permisos de administrador en un repositorio individual que pertenezca a la organización aún podrá habilitar estas actualizaciones en el mismo. - -{% data reusables.repositories.you-can-enable-or-disable-security-features %} - -{% data reusables.profile.access_profile %} -{% data reusables.profile.access_org %} -{% data reusables.organizations.org_settings %} -{% data reusables.organizations.security %} -{% data reusables.repositories.opt-out-automated-security-updates %} - -### Leer más - -- "[Acerca de las alertas de seguridad para las dependencias vulnerables](/articles/about-security-alerts-for-vulnerable-dependencies)" -- "[Optar por utilizar datos para tu repositorio privado](/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-data-use-for-your-private-repository#opting-into-data-use-for-your-private-repository)" -- "[Ecosistemas de paquete compatibles](/github/visualizing-repository-data-with-graphs/listing-the-packages-that-a-repository-depends-on#supported-package-ecosystems)" diff --git a/translations/es-XL/content/github/managing-security-vulnerabilities/managing-alerts-for-vulnerable-dependencies-in-your-organization.md b/translations/es-XL/content/github/managing-security-vulnerabilities/managing-alerts-for-vulnerable-dependencies-in-your-organization.md deleted file mode 100644 index 61476fd6fcc1..000000000000 --- a/translations/es-XL/content/github/managing-security-vulnerabilities/managing-alerts-for-vulnerable-dependencies-in-your-organization.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: Administrar las alertas por dependencias vulnerables en tu organización -intro: 'Los propietarios de organización y los administradores de repositorio reciben las {% data variables.product.prodname_dependabot_alerts %} cuando detectamos una dependencia vulnerable en el repositorio de una organización. Puedes especificar miembros o equipos adicionales de la organización con acceso de escritura para que también reciban alertas de las dependencias vulnerables.' -redirect_from: - - /articles/managing-alerts-for-vulnerable-dependencies-in-your-organization-s-repositories/ - - /articles/managing-alerts-for-vulnerable-dependencies-in-your-organizations-repositories/ - - /articles/managing-alerts-for-vulnerable-dependencies-in-your-organization -versions: - free-pro-team: '*' ---- - -{% if currentVersion == "free-pro-team@latest" %} -{% data reusables.repositories.you-can-manage-access-to-security-alerts %} -{% endif %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -3. En la barra lateral izquierda, da clic en **Alertas del Dependabot**. ![Pestaña de alertas del dependabot en la barra lateral de configuración](/assets/images/help/settings/settings-sidebar-dependabot-alerts.png) -4. Teclea el nombre de la persona o equipo sobre los cuales quieres recibir {% data variables.product.prodname_dependabot_alerts %} cuando {% data variables.product.product_name %} detecte una dependencia vulnerable y, posteriormente, da clic en el nombre de usuario o de equipo para seleccionarlo. -5. Después de que hayas seleccionado a todas las personas o equipos sobre las cuales quieres recibir {% data variables.product.prodname_dependabot_alerts %}, da clic en **Guardar cambios**. - -### Leer más - -- "[Acerca de las alertas para las dependencias vulnerables](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)" -- "[Ver y actualizar las dependencias vulnerables en tu repositorio](/articles/viewing-and-updating-vulnerable-dependencies-in-your-repository)" -- "[Administrar la seguridad y la configuración de análisis para tu organización](/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization)" diff --git a/translations/es-XL/content/github/searching-for-information-on-github/searching-code-for-exact-matches.md b/translations/es-XL/content/github/searching-for-information-on-github/searching-code-for-exact-matches.md deleted file mode 100644 index 58440150e0a4..000000000000 --- a/translations/es-XL/content/github/searching-for-information-on-github/searching-code-for-exact-matches.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: Buscar coincidencias exactas en el código -intro: 'Puedes buscar coincidencias exactas de código en los repositorios de {% data variables.product.prodname_dotcom %}.' -redirect_from: - - /github/searching-for-information-on-github/searching-files-in-a-repository-for-exact-matches -permissions: Las personas con permisos de lectura en un repositorio pueden buscar coincidencias exactas de archivos en el mismo. -versions: - free-pro-team: '*' ---- - -{% note %} - -{% data reusables.search.exact-match-beta %} Para solicitar acceso al beta,, [únete a la lista de espera](https://github.com/features/code-search-exact-match/signup). - -{% endnote %} - -### Acerca de la búsqueda de coincidencias exactas en el código - -{% data reusables.search.exact-match %} - -Predeterminadamente, las búsquedas de coincidencias exactas distinguen entre mayúsculas, minúsuclas, y símbolos, y no pueden incluir coincidencias parciales o gramática estandarizada. Por ejemplo, si buscas `let ReactDOM*` se regresará el valor `let ReactDOM*`. - -### Buscar coincidencias exactas en el código - -{% note %} - -Buscar coincidencias exactas en los archivos dentro de un repositorio solo funcionará con aquellos repositorios indizados para el lanzamiento beta. - -{% endnote %} - -{% data reusables.repositories.navigate-to-repo %} -2. En el campo de búsqueda, teclea la cadena de caracteres que quieras encontrar. ![Búsqueda de cadena de caracteres para coincidencia exacta](/assets/images/help/search/exact-match-search-string.png) -3. Opcionalmente, da clic en el menú desplegable de **Opciones** para acotar tu búsqueda. ![Menú desplegable de opciones para búsqueda de coincidencia exacta](/assets/images/help/search/exact-match-options.png) -4. Presiona Enter o Return en tu teclado. -5. En la lista de resultados, da clic en el archivo. - -### Leer más - -- "[Buscar código](/github/searching-for-information-on-github/searching-code)" -- "[Navegar en el código de {% data variables.product.product_name %}](/github/managing-files-in-a-repository/navigating-code-on-github)" diff --git a/translations/es-XL/content/github/site-policy/github-enterprise-cloud-addendum.md b/translations/es-XL/content/github/site-policy/github-enterprise-cloud-addendum.md deleted file mode 100644 index b39109f8e8d8..000000000000 --- a/translations/es-XL/content/github/site-policy/github-enterprise-cloud-addendum.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: Anexo de GitHub Enterprise Cloud -redirect_from: - - /github-business-cloud-addendum/ - - /articles/github-enterprise-cloud-addendum -versions: - free-pro-team: '*' ---- - -Estos son los términos adicionales para GitHub Enterprise Cloud ("términos de la Enterprise Cloud"). Cualquier término con mayúscula inicial no definido en estos términos de Enterprise Cloud se definirá en los [Términos de servicio](/articles/github-terms-of-service/) o los [Términos de servicio corporativos](/articles/github-corporate-terms-of-service/). Al aceptar estos términos de Enterprise Cloud, también aceptas los términos de servicio, según el tipo de cuenta que tengas. - -Enterprise Cloud incluye una cuenta de Organización, SAML de inicio de sesión único, provisión de acceso y soporte 24/5 con un tiempo de respuesta de 8 horas. Esta lista de funciones y servicios no es exhaustiva y puede ser actualizada de vez en cuando. Para obtener más información, véase "[Productos de GitHub](https://github.com/pricing)". - -### Definiciones: -- Usuario activo: Se refiere a un usuario que intenta ingresar a nuestro servicio en el momento de una interrupción. -- Cliente: Persona o entidad que ha comprado Enterprise Cloud a GitHub. -- Usuario elegible: Se refiere a un individuo que es designado como miembro de la organización Enterprise Cloud del Cliente al tener su cuenta individual de GitHub asociada con la cuenta Enterprise Cloud del Cliente. -- Servicios esenciales: Se refiere a los servicios esenciales para la funcionalidad de control de la versión principal de GitHub, incluyendolas características y los servicios, como crear, bifurcar y clonar repositorios; crear, confirmar y fusionar ramas; crear, revisar y fusionar solicitudes de extracción; y las interfaces del cliente web, API y Git para los flujos de trabajo de Git principales. Los siguientes ejemplos muestran funciones periféricas y servicios que no están incluidos: Webhooks, Gists, páginas y notificaciones por correo electrónico. -- Interrupción: Se refiere a la interrupción de un servicio esencial que afecta a más del 50⁰% de los usuarios activos. -- Crédito de servicio: Se refiere a un crédito en dólares, calculado como se establece a continuación, que podemos acreditar a una cuenta elegible. - -### Tiempo de actividad SLA de Enterprise Cloud - -Beneficios del programa: -- Garantizamos que el Servicio tendrá un porcentaje de tiempo de actividad del 99,95⁰% por trimestre. Eso significa que los Servicios esenciales de GitHub no se detendrán por una Interrupción que afecte a más del 50⁰% de los Usuarios activos, durante más del 0,05⁰% del trimestre. -- Si no cumplimos con nuestra garantía de tiempo de actividad trimestral del 99.95⁰%, GitHub puede emitir créditos de servicio para los clientes. - -¿Cómo calculamos el tiempo de actividad? -- Nuestro cálculo de tiempo de actividad se basa en el porcentaje de solicitudes exitosas a las que servimos a través de nuestras interfaces de cliente web, API y Git. - -¿Qué se excluye de nuestra garantía de tiempo de actividad? Interrupciones resultantes de: -- Actos del cliente, omisiones o uso indebido de los servicios, incluyendo violaciones de los Términos de Servicio. -- Fallos en la conectividad a Internet -- Factores fuera de nuestro control razonable, incluyendo problemas relacionados con el acceso a Internet, eventos de fuerza mayor y servicios o tecnología de terceros -- Tu equipo, servicios u otra tecnología - -¿Qué son los créditos de servicio para tiempo de inactividad, cómo puedo averiguar si los tengo y cómo puedo canjearlos? -- Si el porcentaje de tiempo de actividad trimestral de GitHub cae por debajo de nuestra garantía de tiempo de actividad del 99.95%, entonces el cliente tiene derecho a recibir 25 veces la cantidad que fue pagada por el tiempo de interrupción que excede la garantía de tiempo de actividad trimestral ("crédito del servicio por tiempo de actividad"), que se aplicará en la próxima factura del cliente. Los créditos del servicio por tiempo de actividad se calculan al final de cada trimestre y solo pueden otorgarse bajo solicitud. -- Para conocer acerca del porcentaje de tiempo de actividad de GitHub, puedes solicitar un informe de tiempo de actividad al final de cada trimestre. -- Para recibir créditos de servicio por tiempo de actividad, el propietario de la cuenta o el Gerente de Facturación debe enviar una solicitud por escrito, en nombre del cliente, dentro de los 30 días posteriores al final de cada trimestre. Los créditos de servicio por tiempo de inactividad no se pueden guardar. Después de que se te conceda un crédito de servicio por tiempo de actividad, se aplicará automáticamente a la próxima factura del cliente. Las solicitudes escritas se deben enviar a {% data variables.contact.contact_support %}. - -**Descargo y limitación de responsabilidad:** La [página de estado](https://www.githubstatus.com/) de GitHub no está conectada con este SLA de tiempo de actividad y no es una representación precisa del tiempo de actividad de GitHub a fin de calcular los créditos del servicio de tiempo de actividad. Los Créditos de servicio se limitan a treinta (30) días de servicio pago por trimestre. Los Créditos de servicio son la única compensación del Cliente por cualquier falla de GitHub en el cumplimiento de todas las obligaciones de tiempo de actividad, tal como se indica en este Anexo. diff --git a/translations/es-XL/content/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-data-use-for-your-private-repository.md b/translations/es-XL/content/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-data-use-for-your-private-repository.md deleted file mode 100644 index 6fcc49ef7c9b..000000000000 --- a/translations/es-XL/content/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-data-use-for-your-private-repository.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: Incluir o excluir el uso de datos para tu repositorio privado -intro: 'Para ayudar a {% data variables.product.product_name %} a conectarse a tus herramientas, personas, proyectos e información relevantes, puedes incluir el uso de datos para tu repositorio privado. Si no has incluido el uso de datos para tu repositorio privado y ya no deseas que {% data variables.product.product_name %} use tus datos, puedes excluirlo.' -redirect_from: - - /articles/opting-into-or-out-of-data-use-for-your-private-repository -versions: - free-pro-team: '*' ---- - -### Acerca del uso de datos para tu repositorio privado - -Cuando incluyes el uso de datos para tu repositorio privado, podrás acceder al gráfico de dependencia, donde puedes rastrear las dependencias de tu repositorio y recibir alertas de seguridad cuando {% data variables.product.product_name %} detecta dependencias vulnerables. Para obtener más información, consulta "[Acerca de las alertas de seguridad para las dependencias vulnerables](/articles/about-security-alerts-for-vulnerable-dependencies)". - -{% data reusables.repositories.you-can-enable-or-disable-security-features %} - -### Incluir el uso de datos para tu repositorio privado - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -3. Dentro de "Data services" (Servicios de datos), seleccione **Allow {% data variables.product.prodname_dotcom %} to perform read-only analysis of this repository (Permitir que {% data variables.product.prodname_dotcom %} realice un análisis de solo lectura de este repositorio)**. ![Casilla de verificación para permitir que {% data variables.product.prodname_dotcom %} realice un análisis de solo lectura de este repositorio](/assets/images/help/repository/private-repo-data-use-opt-in.png) -4. De manera opcional, selecciona la casilla de verificación al lado de cualquier servicio adicional que deseas habilitar para el uso de datos. ![Lista de servicios adicionales con sus propias casillas de verificación](/assets/images/help/repository/private-repo-data-use-additional-services.png) - -### Excluir el uso de datos para tu repositorio privado - -{% tip %} - -**Sugerencia:** para excluir el uso de datos para servicios específicos, quita la selección en la casilla de verificación al lado del servicio. - -{% endtip %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -3. Dentro de "Data services" (Servicios de datos), quita la selección en **Allow {% data variables.product.prodname_dotcom %} to perform read-only analysis of this repository (Permitir que {% data variables.product.prodname_dotcom %} realice un análisis de solo lectura de este repositorio)**. ![Casilla de verificación para deshabilitar que {% data variables.product.prodname_dotcom %} realice un análisis de solo lectura de este repositorio](/assets/images/help/repository/private-repo-data-use-opt-out.png) - -### Leer más - -- "[Acerca del uso de tus datos de {% data variables.product.prodname_dotcom %}](/articles/about-github-s-use-of-your-data)" -- "[Ver y actualizar las dependencias vulnerables en tu repositorio](/articles/viewing-and-updating-vulnerable-dependencies-in-your-repository) -- "[Administrar alertas para dependencias vulnerables en los repositorios de tu organización](/articles/managing-alerts-for-vulnerable-dependencies-in-your-organization-s-repositories)" diff --git a/translations/es-XL/content/github/using-git/changing-author-info.md b/translations/es-XL/content/github/using-git/changing-author-info.md deleted file mode 100644 index 3f891d64a8af..000000000000 --- a/translations/es-XL/content/github/using-git/changing-author-info.md +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Cambiar información del autor -redirect_from: - - /change-author-info/ - - /changing-author-info/ - - /articles/changing-author-info -intro: 'Para cambiar el nombre y la dirección de correo electrónico registrados en las confirmaciones existentes, debes volver a escribir la historia completa de tu repositorio de Git.' -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -{% warning %} - -**Advertencia**; Esta acción es destructiva para el historial de tu repositorio. Si estás colaborando con otros en un repositorio, será considerado como una mala práctica para volver a escribir el historial publicado. Solo deberías hacerlo en caso de emergencia. - -{% endwarning %} - -### Cambiar el historial de Git de tu repositorio mediante un script - -Hemos creado un script que cambiará las confirmaciones que tenía previamente la dirección de correo electrónico antigua en sus campos de autor o persona que confirma el cambio para usar el nombre y la dirección de correo electrónico correctos. - -{% tip %} - -**Nota**: Al ejecutar este script se vuelve a escribir el historial para todos los colaboradores del repositorio. Luego de completar estos pasos, cualquier persona con bifurcaciones o clones debe extraer del historial escrito y la rebase cualquier cambio local que se encuentre en el historial escrito. - -{% endtip %} - -Antes de ejecutar este script, necesitarás: - -* La dirección de correo electrónico antigua que aparece en los campos autor/persona que confirma el cambio que deseas cambiar -* El nombre y la dirección de correo electrónico correctos a los que deseas atribuir esas confirmaciones - -{% data reusables.command_line.open_the_multi_os_terminal %} -2. Crear un clone nuevo, básico de tu repositorio: - ```shell - git clone --bare https://{% data variables.command_line.codeblock %}/user/repo.git - cd repo.git - ``` -3. Copiar y pegar el script, reemplazando las siguientes variables en función de la información que recopilaste: - * `OLD_EMAIL` - * `CORRECT_NAME` - * `CORRECT_EMAIL` - - ```shell - #!/bin/sh - - git filter-branch --env-filter ' - - OLD_EMAIL="your-old-email@example.com" - CORRECT_NAME="Your Correct Name" - CORRECT_EMAIL="your-correct-email@example.com" - - if [ "$GIT_COMMITTER_EMAIL" = "$OLD_EMAIL" ] - then - export GIT_COMMITTER_NAME="$CORRECT_NAME" - export GIT_COMMITTER_EMAIL="$CORRECT_EMAIL" - fi - if [ "$GIT_AUTHOR_EMAIL" = "$OLD_EMAIL" ] - then - export GIT_AUTHOR_NAME="$CORRECT_NAME" - export GIT_AUTHOR_EMAIL="$CORRECT_EMAIL" - fi - ' --tag-name-filter cat -- --branches --tags - ``` - -4. Presionar **Enter** (Intro) para ejecutar el script. -5. Revisar el nuevo historial de Git para detectar errores. -6. Subir tu historial corregido a {% data variables.product.product_name %}: - ```shell - git push --force --tags origin 'refs/heads/*' - ``` -7. Limpiar el clon temporal: - ```shell - cd .. - rm -rf repo.git - ``` diff --git a/translations/es-XL/content/github/using-git/updating-credentials-from-the-osx-keychain.md b/translations/es-XL/content/github/using-git/updating-credentials-from-the-osx-keychain.md deleted file mode 100644 index 08793fa7aca5..000000000000 --- a/translations/es-XL/content/github/using-git/updating-credentials-from-the-osx-keychain.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: Actualizar credenciales desde la Keychain OSX -intro: 'Necesitarás actualizar tus credenciales guardadas en el asistente `git-credential-osxkeychain` si cambias tu nombre de usuario, contraseña o token de acceso personal en {% data variables.product.product_name %}.' -redirect_from: - - /articles/updating-credentials-from-the-osx-keychain -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -{% data reusables.user_settings.password-authentication-deprecation %} - -### Actualizar tus credenciales a través de Keychain Access (Acceso keychain) - -1. En Finder (Buscador), busca la aplicación **Keychain Access** (Acceso keychain). ![Barra Spotlight Search (Búsqueda de Spotlight)](/assets/images/help/setup/keychain-access.png) -2. En Keychain Access (Acceso keychain), busca **{% data variables.command_line.backticks %}**. -3. Encuentra la entrada "internet password" (contraseña de internet) para `{% data variables.command_line.backticks %}`. ![Entrada de contraseña de GitHub en Keychain](/assets/images/help/setup/keychain-entry.png) -4. Edita o borra la entrada según corresponda. - -### Eliminar tus credenciales a través de la línea de comando - -A través de la línea de comando, puedes utilizar el ayudante de credenciales directamente para borrar la entrada keychain. - -Para hacerlo, escribe el siguiente comando: - -```shell -$ git credential-osxkeychain erase -host={% data variables.command_line.codeblock %} -protocol=https -> [Press Return] -``` - -Si resulta exitoso, no se imprimirá nada. Para ver si funciona, prueba y clona un repositorio desde {% data variables.product.product_location %}. Si te solicita una contraseña, la entrada keychain se eliminó. - -### Leer más - -- [Almacenar tus credenciales de {% data variables.product.prodname_dotcom %} en el caché dentro de Git](/github/using-git/caching-your-github-credentials-in-git/)" diff --git a/translations/es-XL/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository.md b/translations/es-XL/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository.md deleted file mode 100644 index ad92efeba1b2..000000000000 --- a/translations/es-XL/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository.md +++ /dev/null @@ -1,65 +0,0 @@ ---- -title: Exploring the dependencies and dependents of a repository -intro: 'Using the dependency graph, you can see the packages your project depends on and the repositories that depend on it. In addition, you can see any vulnerabilities detected in its dependencies.' -redirect_from: - - /articles/listing-the-packages-that-a-repository-depends-on - - /github/visualizing-repository-data-with-graphs/listing-the-packages-that-a-repository-depends-on - - /articles/listing-the-projects-that-depend-on-a-repository - - /github/visualizing-repository-data-with-graphs/listing-the-projects-that-depend-on-a-repository -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -### Viewing the dependency graph - -{% data reusables.repositories.enable-security-alerts %} - -The dependency graph has tabs that show the dependencies and dependents of your repository. For information about how these views are populated and which ecosystems are supported, see "[About the dependency graph](about-the-dependency-graph)." - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.accessing-repository-graphs %} -{% data reusables.repositories.click-dependency-graph %} -4. Optionally, under "Dependency graph", click **Dependents**. ![Pestaña Dependents (Dependencias) de la página del gráfico de dependencias](/assets/images/help/graphs/dependency-graph-dependents-tab.png) - -#### Dependencies view - -Dependencies are grouped by ecosystem. You can expand a dependency to view its dependencies. For dependencies hosted on {% data variables.product.product_name %}, you can also click a dependency to view the repository. If vulnerabilities have been detected in the repository, these are shown at the top of the view for users with access to {% if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %}. - -![Gráfico de dependencias](/assets/images/help/graphs/dependencies_graph.png) - -#### Dependents view - -For public repositories, the dependents view shows how the repository is used by other repositories. To show only the repositories that contain a library in a package manager, click **NUMBER Packages** immediately above the list of dependent repositories. The dependent counts are approximate and may not always match the dependents listed. - -![Gráfico de dependencias](/assets/images/help/graphs/dependents_graph.png) - -{% if currentVersion == "free-pro-team@latest" %} -### Enabling and disabling the dependency graph for a private repository - -Repository administrators can enable or disable the dependency graph for private repositories. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -{% data reusables.repositories.navigate-to-security-and-analysis %} -4. Read the message about granting {% data variables.product.product_name %} read-only access to the repository data to enable the dependency graph, then next to "Dependency Graph", click **Enable**. !["Enable" button for the dependency graph](/assets/images/help/repository/dependency-graph-enable-button.png) - -You can disable the dependency graph at any time by clicking **Disable** next to "Dependency Graph" on the Security & analysis tab. -{% endif %} - -### Solución de problemas del gráfico de dependencias - -If your dependency graph is empty, there may be a problem with the file containing your dependencies. Check the file to ensure that it's correctly formatted for the file type. - -{% if currentVersion == "free-pro-team@latest" %} -If the file is correctly formatted, then check its size. The dependency graph ignores individual manifest and lock files that are over 0.5 Mb, unless you are a {% data variables.product.prodname_enterprise %} user. It processes up to 20 manifest or lock files per repository by default, so you can split dependencies into smaller files in subdirectories of the repository.{% endif %} - -If a manifest or lock file is not processed, its dependencies are omitted from the dependency graph and they can't be checked for vulnerable dependencies. - -### Leer más - -- "[About the dependency graph](about-the-dependency-graph)"{% if currentVersion == "free-pro-team@latest" %} -- "[Ver la información de tu organización](/github/setting-up-and-managing-organizations-and-teams/viewing-insights-for-your-organization)" -- "[Ver y actualizar las dependencias vulnerables en tu repositorio](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository)" -- "[Entender cómo {% data variables.product.product_name %} utiliza y protege tus datos](/github/understanding-how-github-uses-and-protects-your-data)" -{% endif %} diff --git a/translations/es-XL/content/github/visualizing-repository-data-with-graphs/listing-the-packages-that-a-repository-depends-on.md b/translations/es-XL/content/github/visualizing-repository-data-with-graphs/listing-the-packages-that-a-repository-depends-on.md deleted file mode 100644 index 1809d5783f0e..000000000000 --- a/translations/es-XL/content/github/visualizing-repository-data-with-graphs/listing-the-packages-that-a-repository-depends-on.md +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: Detallar los paquetes de los que depende un repositorio -intro: 'En el gráfico de dependencias, puedes ver tus dependencias del proyecto y cualquier vulnerabilidad detectada.' -redirect_from: - - /articles/listing-the-packages-that-a-repository-depends-on -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -### Acerca del gráfico de dependencias - -La gráfica de dependencias se encuentra disponible para cualquier repositorio {% if currentVersion == "free-pro-team@latest" %}público{% endif %} que defina dependencias en un ecosistema de paquetes compatible utilizando un formato de archivos compatible.{% if currentVersion == "free-pro-team@latest" %}Los administradores de repositorio también pueden configurar la gráfica de dependencias para los repositorios privados.{% endif %} - -{% data reusables.repositories.enable-security-alerts %} - -Puedes ver y actualizar las dependencias vulnerables en tu gráfico de dependencias del repositorio. El gráfico de dependencias detalla las dependencias vulnerables ante otras dependencias. Para obtener más información, consulta "[Acerca de las alertas de seguridad de las dependencias vulnerables](/articles/about-security-alerts-for-vulnerable-dependencies)". - -{% if currentVersion == "free-pro-team@latest" %} -Puedes ver las dependencias utilizadas en los repositorios de la organización en un tablero único. Para obtener más información, consulta "[Ver información de tu organización](/articles/viewing-insights-for-your-organization#viewing-organization-dependency-insights)".{% endif %} - -### Ecosistemas de paquetes compatibles - -| Administración de paquetes | Idiomas | Formatos recomendados | Formatos compatibles | -| -------------------------- | -------------------------------- | ------------------------------------------------------ | ------------------------------------------------------------------------- | -| Maven | Java, Scala | `pom.xml` | `pom.xml` | -| npm | JavaScript | `package-lock.json` | `package-lock.json`, `package.json` | -| Yarn | JavaScript | `yarn.lock` | `package.json`, `yarn.lock` | -| `dotnet` CLI | .NET languages (C#, C++, F#, VB) | `.csproj`, `.vbproj`, `.nuspec`, `.vcxproj`, `.fsproj` | `.csproj`, `.vbproj`, `.nuspec`, `.vcxproj`, `.fsproj`, `packages.config` | -| Python PIP | Python | `requirements.txt`, `pipfile.lock` | `requirements.txt`, `pipfile.lock`, `setup.py`* | -| RubyGems | Ruby | `Gemfile.lock` | `Gemfile.lock`,`Gemfile`, `*.gemspec` | -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}| Composer | PHP | `composer.lock` | `composer.json`, `composer.lock` |{% endif %} - -{% note %} - -**Nota:** Si detallas tus dependencias de Python dentro de un archivo `setup.py`, quizás no podamos analizar, detallar y alertar sobre todas las dependencias de tu proyecto. - -{% endnote %} - -### Detallar dependencias para un repositorio con el gráfico de dependencias habilitado - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.accessing-repository-graphs %} -{% data reusables.repositories.click-dependency-graph %} - -{% if currentVersion == "free-pro-team@latest" %} -### Habilitar el gráfico de dependencias para un repositorio privado - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.accessing-repository-graphs %} -{% data reusables.repositories.click-dependency-graph %} -4. Lee el mensaje acerca de conceder {% data variables.product.product_name %} acceso a los datos del repositorio para habilitar el gráfico de dependencias, luego haz clic en **Allow access** (Permitir acceso). ![Botón para permitir el acceso a los datos del repositorio para habilitar el gráfico de dependencias](/assets/images/help/repository/dependency-graph-allow-access-button.png) - -Para obtener más información, consulta "[Entender cómo {% data variables.product.product_name %} utiliza y protege tus datos](/categories/understanding-how-github-uses-and-protects-your-data)". - -### Inhabilitar el gráfico de dependencias de un repositorio privado - -{% data reusables.repositories.you-can-enable-or-disable-security-features %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -3. En "Data services" (Servicios de datos), anula la selección de **Dependency graph** (Gráfico de dependencias). ![Casilla para inhabilitar el gráfico de dependencias](/assets/images/help/repository/private-repo-data-use-dependency-graph-disabled.png) - -Para excluir el uso de datos de tu repositorio, consulta "[Incluir o excluir el uso de datos de tu repositorio privado](/articles/opting-into-or-out-of-data-use-for-your-private-repository)". -{% endif %} - -### Solución de problemas del gráfico de dependencias - -{% data reusables.repositories.troubleshooting-dependency-graph %} - -### Leer más - -- "[Detallar los proyectos que dependen de un repositorio](/articles/listing-the-projects-that-depend-on-a-repository)"{% if currentVersion == "free-pro-team@latest" %} -- "[Entender cómo {% data variables.product.product_name %} utiliza y protege tus datos](/categories/understanding-how-github-uses-and-protects-your-data)" -- "[Ver y actualizar las dependencias vulnerables en tu repositorio](/articles/viewing-and-updating-vulnerable-dependencies-in-your-repository)"{% endif %} diff --git a/translations/es-XL/content/github/visualizing-repository-data-with-graphs/listing-the-projects-that-depend-on-a-repository.md b/translations/es-XL/content/github/visualizing-repository-data-with-graphs/listing-the-projects-that-depend-on-a-repository.md deleted file mode 100644 index 12dd9bf312bb..000000000000 --- a/translations/es-XL/content/github/visualizing-repository-data-with-graphs/listing-the-projects-that-depend-on-a-repository.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: Detallar los proyectos que dependen de un repositorio -intro: Puedes ver los paquetes y proyectos que dependen de un repositorio en el gráfico de dependencias. -redirect_from: - - /articles/listing-the-projects-that-depend-on-a-repository -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -### Acerca del gráfico de dependencias -El gráfico de dependencias contiene datos sobre los paquetes y las aplicaciones. Los paquetes son repositorios que contienen una biblioteca en un administrador de paquetes, mientras que las aplicaciones son repositorios que dependen del repositorio seleccionado. La lista de aplicaciones en el gráfico de dependencias está clasificada por el proyecto más reciente que depende del repositorio. - -El gráfico de dependencias contiene datos para los siguientes lenguajes: - -- RubyGems -- NPM -- PyPI -- Maven (pom.xml únicamente) -- Nuget - -{% data reusables.repositories.enable-security-alerts %} - -{% note %} - -**Nota:** Los conteos de dependencias son aproximados y puede que no coincidan con las dependencias detalladas. - -{% endnote %} - -![Gráfico de dependencias](/assets/images/help/graphs/dependents_graph.png) - -### Acceder al gráfico de dependencias - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.accessing-repository-graphs %} -{% data reusables.repositories.click-dependency-graph %} -4. En "Dependency graph" (Gráfico de dependencias), haz clic en **Dependents** (Dependencias). ![Pestaña Dependents (Dependencias) de la página del gráfico de dependencias](/assets/images/help/graphs/dependency-graph-dependents-tab.png) - -### Leer más - -- "[Detallar los paquetes de los que depende un repositorio](/articles/listing-the-packages-that-a-repository-depends-on)"{% if currentVersion == "free-pro-team@latest" %} -- "[Ver la información de tu organización](/articles/viewing-insights-for-your-organization)"{% endif %} diff --git a/translations/es-XL/content/rest/reference/endpoints-available-for-github-apps.md b/translations/es-XL/content/rest/reference/endpoints-available-for-github-apps.md deleted file mode 100644 index 899888a325ab..000000000000 --- a/translations/es-XL/content/rest/reference/endpoints-available-for-github-apps.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: Terminales disponibles para las Apps de GitHub -intro: Tu app puede hacer solicitudes a las siguientes terminales de REST. -redirect_from: - - /v3/apps/available-endpoints -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -Debes utilizar un token de acceso a la isntalación para acceder a las terminales utilizando tu {% data variables.product.prodname_github_app %}. Para obtener más información, consulta la sección "[Autenticarse con {% data variables.product.prodname_github_apps %}](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)". - -{% include rest_enabled_for_github_apps_in_current_version %} diff --git a/translations/es-XL/data/reusables/actions/actions-app-read-permissions-sh-org.md b/translations/es-XL/data/reusables/actions/actions-app-read-permissions-sh-org.md deleted file mode 100644 index 9b24e525b432..000000000000 --- a/translations/es-XL/data/reusables/actions/actions-app-read-permissions-sh-org.md +++ /dev/null @@ -1 +0,0 @@ -Las {% data variables.product.prodname_github_app %}s deben tener el permiso de organización `self-hosted runners:read` para utilizar esta terminal. \ No newline at end of file diff --git a/translations/es-XL/data/reusables/actions/actions-app-secrets-org-permissions.md b/translations/es-XL/data/reusables/actions/actions-app-secrets-org-permissions.md deleted file mode 100644 index 9d495e920289..000000000000 --- a/translations/es-XL/data/reusables/actions/actions-app-secrets-org-permissions.md +++ /dev/null @@ -1 +0,0 @@ -Las {% data variables.product.prodname_github_app %}s deben tener el permiso de organización `secrets` para utilizar esta terminal. \ No newline at end of file diff --git a/translations/es-XL/data/reusables/actions/actions-app-secrets-permissions.md b/translations/es-XL/data/reusables/actions/actions-app-secrets-permissions.md deleted file mode 100644 index a33b72f75a36..000000000000 --- a/translations/es-XL/data/reusables/actions/actions-app-secrets-permissions.md +++ /dev/null @@ -1 +0,0 @@ -Las {% data variables.product.prodname_github_app %}s deben tener el permiso de repositorio `secrets` para utilizar esta terminal. \ No newline at end of file diff --git a/translations/es-XL/data/reusables/actions/actions-app-write-permissions-sh-org.md b/translations/es-XL/data/reusables/actions/actions-app-write-permissions-sh-org.md deleted file mode 100644 index 3b6c8617b1f6..000000000000 --- a/translations/es-XL/data/reusables/actions/actions-app-write-permissions-sh-org.md +++ /dev/null @@ -1 +0,0 @@ -Las {% data variables.product.prodname_github_app %}s deben tener el permiso de organización `self-hosted runners:write` para utilizar esta terminal. \ No newline at end of file diff --git a/translations/es-XL/data/reusables/actions/actions-downloads.md b/translations/es-XL/data/reusables/actions/actions-downloads.md deleted file mode 100644 index cb1e2af1dc74..000000000000 --- a/translations/es-XL/data/reusables/actions/actions-downloads.md +++ /dev/null @@ -1 +0,0 @@ -Llama a esta terminal utilizando el marcador `-v`, el cual habilita la salida verbosa y te permite ver la URL de descarga en el encabezado. Para descargar el archivo en el directorio de trabajo actual, especifica el nombre de archivo utilizando el marcador `-o`. \ No newline at end of file diff --git a/translations/es-XL/data/reusables/actions/actions-secret-encyption-examples.md b/translations/es-XL/data/reusables/actions/actions-secret-encyption-examples.md deleted file mode 100644 index 8b4277236b62..000000000000 --- a/translations/es-XL/data/reusables/actions/actions-secret-encyption-examples.md +++ /dev/null @@ -1,75 +0,0 @@ -#### Ejemplo para cifrar un secreto utilizando Node.js - -Cifra tu secreto utilizando la biblioteca [tweetsodium](https://github.com/github/tweetsodium). - -```js -const sodium = require('tweetsodium'); - -const key = "base64-encoded-public-key"; -const value = "plain-text-secret"; - -// Convert the message and key to Uint8Array's (Buffer implements that interface) -const messageBytes = Buffer.from(value); -const keyBytes = Buffer.from(key, 'base64'); - -// Encrypt using LibSodium. -const encryptedBytes = sodium.seal(messageBytes, keyBytes); - -// Base64 the encrypted secret -const encrypted = Buffer.from(encryptedBytes).toString('base64'); - -console.log(encrypted); -``` - -#### Ejemplo para cifrar un secreto utilizando Python - -Cifra tu secreto utilizando [pynacl](https://pynacl.readthedocs.io/en/stable/public/#nacl-public-sealedbox) con Python 3. - -```py -from base64 import b64encode -from nacl import encoding, public - -def encrypt(public_key: str, secret_value: str) -> str: - """Encrypt a Unicode string using the public key.""" - const sodium = require('tweetsodium'); - -const key = "base64-encoded-public-key"; -const value = "plain-text-secret"; - -// Convert the message and key to Uint8Array's (Buffer implements that interface) -const messageBytes = Buffer.from(value); -const keyBytes = Buffer.from(key, 'base64'); - -// Encrypt using LibSodium. -``` - -#### Ejemplo para cifrar un secreto utilizando C\# - -Cifra tu secreto utilizando el [Sodium.Core](https://www.nuget.org/packages/Sodium.Core/) Paquete. - -```csharp -var secretValue = System. Text.Encoding.UTF8.GetBytes("mySecret"); -var publicKey = Convert. FromBase64String("2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvvcCU="); - -var sealedPublicKeyBox = Sodium. SealedPublicKeyBox.Create(secretValue, publicKey); - -Console. WriteLine(Convert.ToBase64String(sealedPublicKeyBox)); -``` - -#### Ejemplo para cifrar un secreto utilizando Ruby - -Cifra tu secreto utilizando la gema [rbnacl](https://github.com/RubyCrypto/rbnacl). - -```ruby -require "rbnacl" -require "base64" - -key = Base64.decode64("+ZYvJDZMHUfBkJdyq5Zm9SKqeuBQ4sj+6sfjlH4CgG0=") -public_key = RbNaCl::PublicKey.new(key) - -box = RbNaCl::Boxes::Sealed.from_public_key(public_key) -encrypted_secret = box.encrypt("my_secret") - -# Print the base64 encoded secret -puts Base64.strict_encode64(encrypted_secret) -``` diff --git a/translations/es-XL/data/reusables/actions/gh-app-actions-read-permissions.md b/translations/es-XL/data/reusables/actions/gh-app-actions-read-permissions.md deleted file mode 100644 index ad952d7c5486..000000000000 --- a/translations/es-XL/data/reusables/actions/gh-app-actions-read-permissions.md +++ /dev/null @@ -1 +0,0 @@ -Las {% data variables.product.prodname_github_app %}s deben contar con el permiso de `actions:read` para utilizar esta terminal. \ No newline at end of file diff --git a/translations/es-XL/data/reusables/actions/gh-app-actions-write-permissions.md b/translations/es-XL/data/reusables/actions/gh-app-actions-write-permissions.md deleted file mode 100644 index cff4a5485fea..000000000000 --- a/translations/es-XL/data/reusables/actions/gh-app-actions-write-permissions.md +++ /dev/null @@ -1 +0,0 @@ -Las {% data variables.product.prodname_github_app %}s deben contar con el permiso de `actions:write` para utilizar esta terminal. \ No newline at end of file diff --git a/translations/es-XL/data/reusables/actions/workflow-route-param-by-name.md b/translations/es-XL/data/reusables/actions/workflow-route-param-by-name.md deleted file mode 100644 index c1ea0180a278..000000000000 --- a/translations/es-XL/data/reusables/actions/workflow-route-param-by-name.md +++ /dev/null @@ -1 +0,0 @@ -También puedes reemplazar `:workflow_id` con `:workflow_file_name`. Por ejemplo, puedes utilizar `main.yml`. \ No newline at end of file diff --git a/translations/es-XL/data/reusables/actions/workflow-usage.md b/translations/es-XL/data/reusables/actions/workflow-usage.md deleted file mode 100644 index 479df6c14a14..000000000000 --- a/translations/es-XL/data/reusables/actions/workflow-usage.md +++ /dev/null @@ -1 +0,0 @@ -Los minutos que se pueden facturar solo aplican para los flujos de trabajo en los repositorios privados que utilicen ejecutores hospedados en {% data variables.product.prodname_dotcom %}. El uso se lista para cada sistema operativo del ejecutor hospedado en {% data variables.product.prodname_dotcom %} en milisegundos. Cualquier re-ejecución de jobs también se incluye en este uso. El uso no incluye el multiplicador para los ejecutores de macOS y de Windows, y no se redondea al siguiente minuto entero. Para obtener más información, consulta la sección "[Administrar la facturación para {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)". \ No newline at end of file diff --git a/translations/es-XL/data/reusables/actions/workflow_runs_parameters_table.md b/translations/es-XL/data/reusables/actions/workflow_runs_parameters_table.md deleted file mode 100644 index 7789a2fbece5..000000000000 --- a/translations/es-XL/data/reusables/actions/workflow_runs_parameters_table.md +++ /dev/null @@ -1,8 +0,0 @@ -#### Parámetros - -| Nombre | Tipo | Descripción | -| --------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `actor (actor)` | `secuencia` | Devuelve las ejecuciones de flujo de trabajo de alguien. Utiliza el inicio de sesión del usuario que creó la `push` asociada con la suite de verificaciones o la ejecución de flujo de trabajo. | -| `rama` | `secuencia` | Devuelve las ejecuciones de flujo de trabajo asociadas con una rama. Utiliza el mismo nombre de la rama de la `push`. | -| `event` | `secuencia` | Devuelve la ejecución de flujo de trabajo que activó el evento que especificaste. Por ejemplo, `push`, `pull_request` o `issue`. Para obtener más información, consulta la sección "[Eventos que activan flujos de trabajo](/actions/automating-your-workflow-with-github-actions/events-that-trigger-workflows)". | -| `estado` | `secuencia` | Devuelve las ejecuciones de flujo de trabajo asociadas con el `status` o la `conclusion` de la ejecución de verificación que especifiques. Por ejemplo, una conclusión puede verse como `success` o un estado puede verse como `completed`. Para obtener más información, consulta las opciones de `status` y de `conclusion` en "[Crear una ejecución de verificación](/v3/checks/runs/#create-a-check-run)". | diff --git a/translations/es-XL/data/reusables/apps/access_token_parameters_table_and_example.md b/translations/es-XL/data/reusables/apps/access_token_parameters_table_and_example.md deleted file mode 100644 index b07b6bf054ac..000000000000 --- a/translations/es-XL/data/reusables/apps/access_token_parameters_table_and_example.md +++ /dev/null @@ -1,13 +0,0 @@ -#### Parámetros - -| Nombre | Tipo | Descripción | -| -------------- | ----------- | --------------------------------------------------------------------------------- | -| `access_token` | `secuencia` | El token de acceso de OAuth que se utiliza para autenticarse en la API de GitHub. | - -#### Ejemplo - -```json -{ - "access_token": "e72e16c7e42f292c6912e7710c838347ae178b4a" -} -``` diff --git a/translations/es-XL/data/reusables/apps/app_req_account_deletion.md b/translations/es-XL/data/reusables/apps/app_req_account_deletion.md deleted file mode 100644 index 207434de479d..000000000000 --- a/translations/es-XL/data/reusables/apps/app_req_account_deletion.md +++ /dev/null @@ -1 +0,0 @@ -Las apps deben proporcionar a los clientes una forma de borrarla de sus cuentas sin tener que mandar un correo electrónico o llamar al personal de soporte. diff --git a/translations/es-XL/data/reusables/apps/authenticated_user_access.md b/translations/es-XL/data/reusables/apps/authenticated_user_access.md deleted file mode 100644 index 360cca3deee4..000000000000 --- a/translations/es-XL/data/reusables/apps/authenticated_user_access.md +++ /dev/null @@ -1 +0,0 @@ -El usuario autenticado tiene permiso explícito para acceder a los repositorios que le pertenezcan, a aquellos en donde es colaborador, y a aquellos a los que puede acceder mediante una membrecía organizacional. diff --git a/translations/es-XL/data/reusables/apps/authorizations_oauth_tokens_SAML.md b/translations/es-XL/data/reusables/apps/authorizations_oauth_tokens_SAML.md deleted file mode 100644 index b877c041fd19..000000000000 --- a/translations/es-XL/data/reusables/apps/authorizations_oauth_tokens_SAML.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -{% warning %} - -**Advertencia:** Las apps deben utilizar el [flujo de aplicaciones web](/apps/building-oauth-apps/authorizing-oauth-apps/#web-application-flow) para obtener tokens de OAuth que funcionen con las organizaciones SAML de GitHub. Los tokens de OAuth que se crean utilizando la API de autorizaciones no podrán acceder a las organizaciones SAML de GitHub. Para obtener más información, consulta la [publicación del blog](https://developer.github.com/changes/2019-11-05-deprecated-passwords-and-authorizations-api). - -{% endwarning %} -{% endif %} diff --git a/translations/es-XL/data/reusables/apps/deprecating_applications_api_endpoints.md b/translations/es-XL/data/reusables/apps/deprecating_applications_api_endpoints.md deleted file mode 100644 index ba78417bdaf6..000000000000 --- a/translations/es-XL/data/reusables/apps/deprecating_applications_api_endpoints.md +++ /dev/null @@ -1,9 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -{% warning %} - -**Aviso de Obsoletización:** {% data variables.product.prodname_dotcom %} reemplazará y descontinuará las terminales de OAuth que contengan `access_token` en el parámetro de la ruta. Estamos introduciendo terminales nuevas que te permitirán administrar de forma segura los tokens para las Apps de OAuth utilizando un `access_token` como parámetro de entrada.{% if currentVersion == "free-pro-team@latest" %} La API de Aplicación de OAuth se eliminará el 5 de mayo de 2021.{% endif %} Para obtener más información,{% if currentVersion == "free-pro-team@latest" %} incluyendo los periodos de indisposición programados,{% endif %} consulta la [publicación del blog](https://developer.github.com/changes/2020-02-14-deprecating-oauth-app-endpoint/). - -{% if currentVersion != "free-pro-team@latest" %} Las terminales de OAuth que utilizan un `access_token` en el parámetro de ruta se encuentran disponibles actualmente y no se han obsoletizado en el {% data variables.product.prodname_ghe_server %} aún. {% data variables.product.prodname_dotcom %} anunciará la obsoletización y proporcionará notificaciones oportunas antes de que elimine la compatibilidad para esta característica.{% endif %} - -{% endwarning %} -{% endif %} diff --git a/translations/es-XL/data/reusables/apps/deprecating_github_services_ghe_compact.md b/translations/es-XL/data/reusables/apps/deprecating_github_services_ghe_compact.md deleted file mode 100644 index fa25aa6fc0fd..000000000000 --- a/translations/es-XL/data/reusables/apps/deprecating_github_services_ghe_compact.md +++ /dev/null @@ -1 +0,0 @@ -El lanzamiento 2.17 de GitHub Enterprise y las versiones superiores ya no admiten que los administradores instalen GitHub Services. Por favor, consulta la [Guía para Reemplazar GitHub Services](/v3/guides/replacing-github-services) para encontrr más detalles. \ No newline at end of file diff --git a/translations/es-XL/data/reusables/apps/deprecating_oauth_authorizations.md b/translations/es-XL/data/reusables/apps/deprecating_oauth_authorizations.md deleted file mode 100644 index 084e16d5d10c..000000000000 --- a/translations/es-XL/data/reusables/apps/deprecating_oauth_authorizations.md +++ /dev/null @@ -1,9 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -{% warning %} - -**Aviso de Obsoletización:** {% data variables.product.prodname_dotcom %} descontinuará la API de Autorizaciones de OAuth, la cual utilizan las integraciones para crear tokens de acceso personal y de OAuth, y ahora debes crear estos tokens utilizando nuestro [flujo de aplicaciones web](/apps/building-oauth-apps/authorizing-oauth-apps/#web-application-flow).{% if currentVersion == "free-pro-team@latest" %} La API de Autorizaciones de OAuth se eliminará el 13 de Noviembre de 2020.{% endif %} Para obtener más información,{% if currentVersion == "free-pro-team@latest" %} incluyendo los periodos de inactividad programados,{% endif %} consulta la [publicación del blog](https://developer.github.com/changes/2020-02-14-deprecating-oauth-auth-endpoint/). - -{% if currentVersion != "free-pro-team@latest" %} La API de autorizaciones de OAuth sigue disponible actualmente y no se ha obsoletizado en {% data variables.product.prodname_ghe_server %}. {% data variables.product.prodname_dotcom %} anunciará la obsoletización y proporcionará notificaciones oportunas antes de que elimine la compatibilidad para esta característica.{% endif %} - -{% endwarning %} -{% endif %} diff --git a/translations/es-XL/data/reusables/apps/iat_required.md b/translations/es-XL/data/reusables/apps/iat_required.md deleted file mode 100644 index 328b72e6b8f6..000000000000 --- a/translations/es-XL/data/reusables/apps/iat_required.md +++ /dev/null @@ -1 +0,0 @@ -Debes utilizar un [token de acceso a la instalación](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation) para acceder a esta terminal. diff --git a/translations/es-XL/data/reusables/apps/iat_required_multiple_endpoints.md b/translations/es-XL/data/reusables/apps/iat_required_multiple_endpoints.md deleted file mode 100644 index 8b1d56ab7a04..000000000000 --- a/translations/es-XL/data/reusables/apps/iat_required_multiple_endpoints.md +++ /dev/null @@ -1 +0,0 @@ -Debes utilizar un [token de acceso a la instalación](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation) para acceder a estas terminales. diff --git a/translations/es-XL/data/reusables/apps/jwt_or_client_secret_required.md b/translations/es-XL/data/reusables/apps/jwt_or_client_secret_required.md deleted file mode 100644 index 70d9d7a5b20d..000000000000 --- a/translations/es-XL/data/reusables/apps/jwt_or_client_secret_required.md +++ /dev/null @@ -1 +0,0 @@ -Las GitHub Apps deben utilizar un [JWT](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) para acceder a esta terminal. Las Apps de OAuth deben utilizar la [autenticación básica](/v3/auth/#basic-authentication) con su ID y secreto de cliente para acceder a esta terminal. diff --git a/translations/es-XL/data/reusables/apps/jwt_required.md b/translations/es-XL/data/reusables/apps/jwt_required.md deleted file mode 100644 index acce71472355..000000000000 --- a/translations/es-XL/data/reusables/apps/jwt_required.md +++ /dev/null @@ -1 +0,0 @@ -Debes utilizar un [JWT](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) para acceder a esta terminal. diff --git a/translations/es-XL/data/reusables/apps/null-headbranch.md b/translations/es-XL/data/reusables/apps/null-headbranch.md deleted file mode 100644 index e6cd6bf704b4..000000000000 --- a/translations/es-XL/data/reusables/apps/null-headbranch.md +++ /dev/null @@ -1 +0,0 @@ -la API de Verificaciones únicamente busca las cargas en el repositorio donde se creó el conjunto o la ejecución de verificaciones. No se detectan aquellas cargas en ramas de repositorios bifurcados y estas devuelven un arreglo vacío de `pull_requests` y un valor `null` para la `head_branch`. diff --git a/translations/es-XL/data/reusables/apps/pat_or_ba_required.md b/translations/es-XL/data/reusables/apps/pat_or_ba_required.md deleted file mode 100644 index 0f94036e3554..000000000000 --- a/translations/es-XL/data/reusables/apps/pat_or_ba_required.md +++ /dev/null @@ -1 +0,0 @@ -Debes utilizar un token de acceso personal (el cual puedes crear a través de la [línea de comandos](/articles/creating-a-personal-access-token-for-the-command-line/) o de la [API de Autorizaciones OAuth](/v3/oauth_authorizations/#create-a-new-authorization)) o una [Autenticación Básica](/v3/auth/#basic-authentication) para acceder a esta terminal. diff --git a/translations/es-XL/data/reusables/apps/u2s_required.md b/translations/es-XL/data/reusables/apps/u2s_required.md deleted file mode 100644 index fdfadad366ad..000000000000 --- a/translations/es-XL/data/reusables/apps/u2s_required.md +++ /dev/null @@ -1 +0,0 @@ -Debes utilizar un [Token de acceso OAuth de usuario a servidor](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/#identifying-users-on-your-site), que se haya creado para un usuario que haya autorizado tu GitHub App, para acceder a esta terminal. diff --git a/translations/es-XL/data/reusables/apps/undetected-pushes-to-a-forked-repository-for-check-runs.md b/translations/es-XL/data/reusables/apps/undetected-pushes-to-a-forked-repository-for-check-runs.md deleted file mode 100644 index 0abcd2421e1c..000000000000 --- a/translations/es-XL/data/reusables/apps/undetected-pushes-to-a-forked-repository-for-check-runs.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Nota:** la API de Verificaciones únicamente busca las cargas en el repositorio donde se creó el conjunto o ejecución de verificaciones. No se detectan aquellas cargas en ramas de repositorios bifurcados y estas devuelven un arreglo vacío de `pull_requests`. - -{% endnote %} diff --git a/translations/es-XL/data/reusables/blog/affected_users.md b/translations/es-XL/data/reusables/blog/affected_users.md deleted file mode 100644 index ff7a3b8e578d..000000000000 --- a/translations/es-XL/data/reusables/blog/affected_users.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Nota**: Esta actualización solo afecta a los usuarios de GitHub.com y a las versiones venideras de GitHub Enterprise. - -{% endnote %} diff --git a/translations/es-XL/data/reusables/branches/apps-permissions.md b/translations/es-XL/data/reusables/branches/apps-permissions.md deleted file mode 100644 index e1c0027e8ee4..000000000000 --- a/translations/es-XL/data/reusables/branches/apps-permissions.md +++ /dev/null @@ -1 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}Solo las {% data variables.product.prodname_github_app %}s instaladas con acceso de `write` al permiso de `contents` podrán agregarse como actores autorizados en una rama protegida.{% endif %} diff --git a/translations/es-XL/data/reusables/branches/limits.md b/translations/es-XL/data/reusables/branches/limits.md deleted file mode 100644 index 8e59ae8d57e8..000000000000 --- a/translations/es-XL/data/reusables/branches/limits.md +++ /dev/null @@ -1 +0,0 @@ -**Nota**: La lista de usuarios{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, apps,{% endif %} y equipos en total se limita a 100 elementos. diff --git a/translations/es-XL/data/reusables/branches/rename-existing-branch.md b/translations/es-XL/data/reusables/branches/rename-existing-branch.md deleted file mode 100644 index aeb5fa9ea934..000000000000 --- a/translations/es-XL/data/reusables/branches/rename-existing-branch.md +++ /dev/null @@ -1,3 +0,0 @@ -Si bien puedes renombrar la rama predeterminada existente de tu repositorio, {% data variables.product.company_short %} planea proporcionar herramientas para simplificar el proceso de renombrar la rama predeterminada. Para obtener más información sobre estos planes, consulta [`github/renaming`](https://github.com/github/renaming). - -Si ya renombraste a la rama predeterminada, {% data variables.product.prodname_dotcom %} redireccionará automáticamente los links en {% if currentVersion ver_gt "enterprise-server@2.22" %}{% data variables.product.product_location_enterprise %}{% else %}{% data variables.product.prodname_dotcom_the_website %}{% endif %} que contenga una rama de `master` borrada en el enlace equivalente de la rama predeterminada del repositorio. diff --git a/translations/es-XL/data/reusables/checks/conclusion_values.md b/translations/es-XL/data/reusables/checks/conclusion_values.md deleted file mode 100644 index 865bac189c21..000000000000 --- a/translations/es-XL/data/reusables/checks/conclusion_values.md +++ /dev/null @@ -1 +0,0 @@ -**Requerido si proporcionas un `completed_at` o un `status` de `completed`**. La conclusión final de la verificación. Puede ser una de entre `success`, `failure`, `neutral`, `cancelled`, {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}`skipped`, {% endif %}`timed_out`, o `action_required`. \ No newline at end of file diff --git a/translations/es-XL/data/reusables/checks/requested_actions.md b/translations/es-XL/data/reusables/checks/requested_actions.md deleted file mode 100644 index 9f7c6d9e3dfd..000000000000 --- a/translations/es-XL/data/reusables/checks/requested_actions.md +++ /dev/null @@ -1 +0,0 @@ -Para conocer más sobre las ejecuciones de verificación y las acciones solicitadas, consulta la sección "[Ejecuciones de verificación y acciones solicitadas](/v3/checks/runs/#check-runs-and-requested-actions)". diff --git a/translations/es-XL/data/reusables/cli/beta.md b/translations/es-XL/data/reusables/cli/beta.md deleted file mode 100644 index 87415506595a..000000000000 --- a/translations/es-XL/data/reusables/cli/beta.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_cli %} está actualmente en fase beta y está sujeto a cambios. diff --git a/translations/es-XL/data/reusables/collaborators/collaborator-definition.md b/translations/es-XL/data/reusables/collaborators/collaborator-definition.md deleted file mode 100644 index d6627b5249e2..000000000000 --- a/translations/es-XL/data/reusables/collaborators/collaborator-definition.md +++ /dev/null @@ -1 +0,0 @@ -la lista de colaboradores incluye a aquellos externos, miembros de la organización que son colaboradores directos, miembros de la organización con acceso a través de membrecías de equipo, miembros de la organización con acceso a través de permisos predeterminados de la organización, y propietarios de la organización. diff --git a/translations/es-XL/data/reusables/command_line/parameters_filters.md b/translations/es-XL/data/reusables/command_line/parameters_filters.md deleted file mode 100644 index c6698dc6654a..000000000000 --- a/translations/es-XL/data/reusables/command_line/parameters_filters.md +++ /dev/null @@ -1 +0,0 @@ -Puedes utilizar parámetros para definir la lista de resultados. Para obtener más información acerca de cómo utilizar los parámetros, consulta la sección de [Parámetros](/v3/#parameters). \ No newline at end of file diff --git a/translations/es-XL/data/reusables/commits/verification-object-definition.md b/translations/es-XL/data/reusables/commits/verification-object-definition.md deleted file mode 100644 index c6e134090293..000000000000 --- a/translations/es-XL/data/reusables/commits/verification-object-definition.md +++ /dev/null @@ -1,28 +0,0 @@ -##### Objeto de verificación de firma - -La respuesta incluirá un objeto de `verification` que describe el resultado de verificar la firma de la confirmación. Los siguientes campos se incluyen en el objeto `verification`: - -| Nombre | Tipo | Descripción | -| ------------ | ----------- | ------------------------------------------------------------------------------------------------------------- | -| `verificado` | `boolean` | Indica si GitHub considera que la firma en esta confirmación debe verificarse. | -| `razón` | `secuencia` | La razón para el valor `verified`. Los valores posibles y sus significados se enumeran en la siguiente tabla. | -| `frima` | `secuencia` | La firma que se extrajo de la confirmación. | -| `payload` | `secuencia` | El valor que se firmó. | - -Estos son los valores posibles para `reason` en el objeto `verification`: - -| Valor | Descripción | -| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `expired_key` | La clave que hizo la firma caducó. | -| `not_signing_key` | El marcador "firmante" no está entre los marcadores de uso en la llave GPG que hizo la firma. | -| `gpgverify_error` | Ocurrió un error al comunicarse con el servicio de verificación de la firma. | -| `gpgverify_unavailable` | El servicio de verificación de la firma no está disponible actualmente. | -| `unsigned` | El objeto no incluye una firma. | -| `unknown_signature_type` | Se encontró una firma en el comentario, la cual no es de tipo PGP. | -| `no_user` | No se asoció a un usuario con la dirección de correo electrónico del `committer` en la confirmación. | -| `unverified_email` | La dirección de correo electrónico del `committer` en la confirmación se asoció con un usuario, pero la dirección de correo electrónico no está verificada en su cuenta. | -| `bad_email` | La dirección de correo electrónico del `committer` en la confirmación no se incluye en las identidades de la llave PGP que creó la firma. | -| `unknown_key` | La llave que hizo la firma no se ha registrado con ninguna cuenta de usuario. | -| `malformed_signature` | Hubo un error al analizar la firma. | -| `no válida` | La firma no se pudo verificar criptográficamente utilizando la llave cuya key-id se encontró en la firma. | -| `valid` | Ninguno de los errores anteriores aplica, así que la firma se considera verificada. | diff --git a/translations/es-XL/data/reusables/desktop/commit-history-list.md b/translations/es-XL/data/reusables/desktop/commit-history-list.md deleted file mode 100644 index 13735797872e..000000000000 --- a/translations/es-XL/data/reusables/desktop/commit-history-list.md +++ /dev/null @@ -1 +0,0 @@ -1. En la lista del historial de confirmaciones, haz clic en la confirmación que deseas revertir. diff --git a/translations/es-XL/data/reusables/desktop/enter-2fa-in-browser.md b/translations/es-XL/data/reusables/desktop/enter-2fa-in-browser.md deleted file mode 100644 index 6c5274a6f2ca..000000000000 --- a/translations/es-XL/data/reusables/desktop/enter-2fa-in-browser.md +++ /dev/null @@ -1 +0,0 @@ -1. Vuelve a {% data variables.product.prodname_dotcom %}. Si se solicita, escribe tu código 2FA y luego haz clic en **Verify (Verificar)**. ![El campo de código de autenticación 2FA](/assets/images/help/desktop/2fa-code-field.png) diff --git a/translations/es-XL/data/reusables/desktop/retrieve-2fa-in-browser.md b/translations/es-XL/data/reusables/desktop/retrieve-2fa-in-browser.md deleted file mode 100644 index 7b1d081f1746..000000000000 --- a/translations/es-XL/data/reusables/desktop/retrieve-2fa-in-browser.md +++ /dev/null @@ -1,3 +0,0 @@ -1. Si has configurado la autenticación de dos factores para {% data variables.product.prodname_dotcom %}, realiza una de las siguientes acciones: - - Si configuras 2FA por medio de SMS, recupera tu código 2FA de un mensaje SMS. - - Si configuras 2FA con una aplicación TOTP, genera un código 2FA. diff --git a/translations/es-XL/data/reusables/desktop/windows-select-file-menu.md b/translations/es-XL/data/reusables/desktop/windows-select-file-menu.md deleted file mode 100644 index e27b8a898a38..000000000000 --- a/translations/es-XL/data/reusables/desktop/windows-select-file-menu.md +++ /dev/null @@ -1 +0,0 @@ -1. En la esquina superior izquierda de la ventana, selecciona el menú **File (Archivo)**. ![El menú de {% data variables.product.prodname_desktop %} en la barra de menú de la ventana](/assets/images/help/desktop/windows-select-file-menu.png) diff --git a/translations/es-XL/data/reusables/dotcom_billing/cost-management-tab.md b/translations/es-XL/data/reusables/dotcom_billing/cost-management-tab.md deleted file mode 100644 index a1ab891af101..000000000000 --- a/translations/es-XL/data/reusables/dotcom_billing/cost-management-tab.md +++ /dev/null @@ -1 +0,0 @@ -1. Debajo de "Facturación", da clic en **Administración de costos**. ![Pestaña de administración de costos](/assets/images/help/settings/cost-management-tab.png) diff --git a/translations/es-XL/data/reusables/dotcom_billing/publishing-nodejs-packages.md b/translations/es-XL/data/reusables/dotcom_billing/publishing-nodejs-packages.md deleted file mode 100644 index 442b83263612..000000000000 --- a/translations/es-XL/data/reusables/dotcom_billing/publishing-nodejs-packages.md +++ /dev/null @@ -1,203 +0,0 @@ ---- -title: Publicar paquetes Node.js -intro: Puedes publicar paquetes Node.js en un registro como parte de tu flujo de trabajo de integración continua (CI). -product: '{% data reusables.gated-features.actions %}' -productVersions: - dotcom: '*' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages ---- - -### Introducción - -Esta guía te muestra cómo crear un flujo de trabajo que publique paquetes Node.js en el {% data variables.product.prodname_registry %} y registros npm después de que se aprueben las pruebas de integración continua (CI). Con un solo flujo de trabajo, puedes publicar paquetes en un solo registro o varios registros. - -### Prerrequisitos - -Recomendamos que tengas un conocimiento básico de las opciones de configuración de flujo de trabajo y de cómo crear un archivo de flujo de trabajo. Para obtener más información, consulta "[Configurar un flujo de trabajo](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)." - -Para obtener más información acerca de la creación de un flujo de trabajo de CI para tu proyecto Node.js, consulta "[Usar Node.js con las {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/using-nodejs-with-github-actions)." - -También puede ser útil tener un entendimiento básico de lo siguiente: - -- "[Conceptos básicos para {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)" -- "[Configurar npm para usar con {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)" -- "[Usar variables de entorno](/actions/automating-your-workflow-with-github-actions/using-environment-variables)" -- "[Crear y usar secretos cifrados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)" -- "[Autenticar con el GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)" - -### Acerca de la configuración del paquete - - Los campos `Nombre` y `Versión` en el archivo *package.json* crean un identificador único que los registros usan para vincular tu paquete a un registro. Puedes agregar un resumen para la página de descripción del paquete al incluir un campo `Descripción` en el archivo *package.json*. Para obtener más información, consulta "[Crear un archivo package.json](https://docs.npmjs.com/creating-a-package-json-file) y [Crear módulos Node.js](https://docs.npmjs.com/creating-node-js-modules)"en la documentación de npm. - -Cuando existe un archivo *.npmrc* local y tiene un valor especificado de `registro`, el comando `npm publish` usa el registro configurado en el archivo *.npmrc*. {% data reusables.github-actions.setup-node-intro %} - -Puedes especificar la versión de Node.js instalada en el ejecutor utilizando la acción `setup-node`. - -Si agregas pasos en tu flujo de trabajo para configurar los campos `publishConfig` en tu archivo *package.json*, no es necesario que especifiques la URL del registro utilizando la acción `setup-node`, pero estarás limitado a publicar el paquete en un solo registro. Para obtener más información, consulta "[publishConfig](https://docs.npmjs.com/files/package.json#publishconfig)" en la documentación de npm. - -### Publicar paquetes en el registro npm - -Cada vez que creas un lanzamiento nuevo, puedes desencadenar un flujo de trabajo para publicar tu paquete. El flujo de trabajo en el ejemplo a continuación se ejecuta cuando el evento `lanzamiento` desencadena con tipo `creado`. El flujo de trabajo publica el paquete en el registro npm si se pasan las pruebas de CI. - -Para realizar operaciones autenticadas frente al registro npm en tu flujo de trabajo, necesitarás almacenar tu token de autenticación npm como un secreto en los parámetros de tu repositorio. Por ejemplo, crea un secreto llamado `NPM_TOKEN`. Para obtener más información, consulta "[Crear y usar secretos cifrados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". - -Por defecto, npm usa el campo `Nombre` del archivo *package.json* para determinar el registro npm. Al publicar en un espacio de nombres global, solo necesitas incluir el nombre del paquete. Por ejemplo, publicarías un paquete llamado `npm-hello-world-test` en `https://www.npmjs.com/package/npm-hello-world-test`. - -Si estás publicando un paquete que incluye un prefijo de alcance, incluye el ámbito en el nombre de tu archivo *package.json*. Por ejemplo, si el prefijo del ámbito npm es octocat y el nombre del paquete es hello-world, el `nombre` en tu archivo *package.json* debe ser `@octocat/hello-world`. Si su paquete npm usa un prefijo de ámbito y el paquete es público, debes usar la opción `npm publish --access public`. Esta es una opción que npm requiere para evitar que alguien publique un paquete privado involuntariamente. - -Este ejemplo almacena el secreto `NPM_TOKEN` en la variable de entorno `NODE_AUTH_TOKEN`. Cuando la acción `setup-node` crea un archivo *.npmrc*, hace referencia al token de la variable de entorno `NODE_AUTH_TOKEN`. - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # Configura el archivo .npmrc para publicar en npm - - uses: actions/setup-node@v1 - with: - node-version: '12.x' - registry-url: 'https://registry.npmjs.org' - - run: npm install - - run: npm publish - env: - NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} -``` -{% endraw %} - -En el ejemplo anterior, la acción `setup-node` crea un archivo *.npmrc* en el ejecutor con el siguiente contenido: - -``` -//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN} -registry=https://registry.npmjs.org/ -always-auth=true -``` - -### Sube paquetes al {% data variables.product.prodname_registry %} - -Cada vez que creas un lanzamiento nuevo, puedes desencadenar un flujo de trabajo para publicar tu paquete. El flujo de trabajo en el ejemplo a continuación se ejecuta cada vez que se produce el evento `lanzamiento` con tipo `creado`. El flujo de trabajo publica el paquete en el {% data variables.product.prodname_registry %} si se pasan las pruebas de CI. - -Por defecto, {% data variables.product.prodname_registry %} publica un paquete en el repositorio {% data variables.product.prodname_dotcom %} que especifiques en el campo `Nombre` del archivo *package.json*. Por ejemplo, publicarías un paquete denominado `@my-org/test` al repositorio de {% data variables.product.prodname_dotcom %} `My-org/test`. Para obtener más información, consulta [`npm-Scope`](https://docs.npmjs.com/misc/scope) en la documentación de npm. - -Para realizar operaciones autenticadas contra el registro {% data variables.product.prodname_registry %} en tu flujo de trabajo, puedes utilizar el `GITHUB_TOKEN`. El `GITHUB_TOKEN` existe en tu repositorio por defecto y tiene permisos de lectura y escritura para paquetes en el repositorio donde se ejecuta el flujo de trabajo. Para obtener más información, consulta "[Crear y usar secretos cifrados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". - -Este ejemplo almacena el secreto `GITHUB_TOKEN` en la variable de entorno `NODE_AUTH_TOKEN`. Cuando la acción `setup-node` crea un archivo *.npmrc*, hace referencia al token de la variable de entorno `NODE_AUTH_TOKEN`. - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # Configura el archivo .npmrc file para publicar GitHub Packages - - uses: actions/setup-node@v1 - with: - node-version: '12.x' - registry-url: 'https://npm.pkg.github.com' - scope: '@octocat' # Predeterminado al usuario u organización que posee el archivo de flujo de trabajo - - run: npm install - - run: npm publish - env: - NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} - -La acción `setup-node` crea un archivo *.npmrc* en el ejecutor. Cuando utilizas la entrada `scope` a la acción `setup-node`, el archivo *.npmrc* incluye el prefijo de alcance. Por defecto, la acción `setup-node` establece el ámbito en el archivo *.npmrc* en la cuenta que contiene ese archivo de flujo de trabajo. - -``` -//npm.pkg.github.com/:_authToken=${NODE_AUTH_TOKEN} -@octocat:registry=https://npm.pkg.github.com -always-auth=true -``` - -### Publicar paquetes mediante yarn - -Si usas el gestor de paquetes Yarn, puedes instalar y publicar paquetes mediante Yarn. - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # Configura el archivo .npmrc para publicar en npm - - uses: actions/setup-node@v1 - with: - node-version: '12.x' - registry-url: 'https://registry.npmjs.org' - scope: '@octocat' # Predeterminado al usuario u organización que posee el archivo de flujo de trabajo - - run: yarn - - run: yarn publish - env: - NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} -``` -{% endraw %} - -### Publicar paquetes en npm y {% data variables.product.prodname_registry %} - -{% note %} - -**Nota:** Si necesitas publicar en los registros que tienen diferentes prefijos de ámbito, deberás modificar el archivo *package.json* en el ejecutor para cambiar el prefijo de ámbito. Por ejemplo, si publicas un paquete en el ámbito `@mona` para npm y `@octocat` para {% data variables.product.prodname_registry %}, puedes reemplazar el ámbito `@mona` por `@octocat` en el archivo *package.json* del ejecutor después de publicar en npm y antes de publicar en {% data variables.product.prodname_registry %}. - -{% endnote %} - -Puedes publicar tus paquetes tanto en el registro npm como en {% data variables.product.prodname_registry %} mediante la acción `setup-node` para cada registro. - -Si publicas un paquete en ambos registros, tendrás que asegurarte de que tu prefijo de ámbito en npm coincida con tu nombre de usuario u organización de {% data variables.product.prodname_dotcom %}. Para publicar paquetes en un registro público con un prefijo de ámbito, puedes utilizar el comando `npm publish --access public`. Para obtener más información, consulta [`npm-scope`](https://docs.npmjs.com/misc/scope) y "[Crear y publicar paquetes públicos con ámbitos](https://docs.npmjs.com/creating-and-publishing-scoped-public-packages)" en la documentación de npm. - -Asegúrate de que tu archivo *package.json* incluya el ámbito de tu repositorio de {% data variables.product.prodname_dotcom %} y el registro de npm. Por ejemplo, si planeas publicar un paquete en el repositorio `octocat/npm-hello-world-test` en {% data variables.product.prodname_dotcom %} y https://www.npmjs. om/package/@octocat/npm-hello-world-test, el nombre en tu archivo *package.json* debería ser `"name": "@octocat/npm-hello-world-test"`. - -Para realizar operaciones autenticadas contra el registro {% data variables.product.prodname_registry %} en tu flujo de trabajo, puedes utilizar el `GITHUB_TOKEN`. El `GITHUB_TOKEN` existe en tu repositorio por defecto y tiene permisos de lectura y escritura para paquetes en el repositorio donde se ejecuta el flujo de trabajo. Para obtener más información, consulta "[Crear y usar secretos cifrados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". - -Cuando utilizas la entrada `scope` a la acción `setup-node`, la acción crea un archivo *.npmrc* que incluye el prefijo de alcance. Por defecto, la acción `setup-node` establece el ámbito en el archivo *.npmrc* al usuario u organización que posee el archivo de flujo de trabajo. - -Este flujo de trabajo llama a la acción `setup-node` dos veces. Cada vez que se ejecuta la acción `setup-node`, sobrescribe el archivo *.npmrc*. El archivo *.npmrc* hace referencia al token que te permite realizar operaciones autenticadas frente al registro del paquete desde la variable de entorno `NODE_AUTH_TOKEN`. El flujo de trabajo establece la variable de entorno `NODE_AUTH_TOKEN` cada vez que se ejecuta el comando `npm publish`, primero con un token para publicar en npm (`NPM_TOKEN`) y luego con un token para publicar en el {% data variables.product.prodname_registry %} (`GITHUB_TOKEN`). - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # Configura el archivo .npmrc para publicar en npm - - uses: actions/setup-node@v1 - with: - node-version: '10.x' - registry-url: 'https://registry.npmjs.org' - - run: npm install - # Publica en npm - - run: npm publish --access public - env: - NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} - # Configura el archivo .npmrc para publicar en GitHub Packages - - uses: actions/setup-node@v1 - with: - registry-url: 'https://npm.pkg.github.com' - scope: '@octocat' # Defaults to the user or organization that owns the workflow file - # Publica en GitHub Packages - - run: npm publish - env: - NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} diff --git a/translations/es-XL/data/reusables/enterprise-accounts/business-settings.md b/translations/es-XL/data/reusables/enterprise-accounts/business-settings.md deleted file mode 100644 index aefa647074ac..000000000000 --- a/translations/es-XL/data/reusables/enterprise-accounts/business-settings.md +++ /dev/null @@ -1 +0,0 @@ -1. Dentro del nombre de tu cuenta de empresa, haz clic en {% octicon "gear" aria-label="The Settings gear" %} **Settings (Parámetros)**. ![Pestaña de parámetros en la página de perfil de la cuenta de empresa](/assets/images/help/business-accounts/business-account-settings-tab.png) diff --git a/translations/es-XL/data/reusables/enterprise-accounts/github-dotcom-connection-tab.md b/translations/es-XL/data/reusables/enterprise-accounts/github-dotcom-connection-tab.md deleted file mode 100644 index f2a5dbc2693c..000000000000 --- a/translations/es-XL/data/reusables/enterprise-accounts/github-dotcom-connection-tab.md +++ /dev/null @@ -1 +0,0 @@ -1. En la barra lateral izquierda, haz clic en **conexión a {% data variables.product.prodname_dotcom_the_website %}**. ![Pestaña de conexión a GitHub.com en la barra lateral de parámetros de la cuenta de empresa](/assets/images/enterprise/business-accounts/settings-github-dotcom-connection-tab.png) diff --git a/translations/es-XL/data/reusables/enterprise-accounts/member-privileges-tab.md b/translations/es-XL/data/reusables/enterprise-accounts/member-privileges-tab.md deleted file mode 100644 index 446156d6fe1d..000000000000 --- a/translations/es-XL/data/reusables/enterprise-accounts/member-privileges-tab.md +++ /dev/null @@ -1 +0,0 @@ -1. En la barra lateral de parámetros de la empresa, haz clic en **Member privileges** (Privilegios del miembro). ![Pestaña Member privileges (Privilegios del miembros) en la barra lateral de parámetros de la cuenta de empresa](/assets/images/help/business-accounts/settings-member-privileges-tab.png) diff --git a/translations/es-XL/data/reusables/enterprise/ldap_sync_warning.md b/translations/es-XL/data/reusables/enterprise/ldap_sync_warning.md deleted file mode 100644 index 75b816a2d1e9..000000000000 --- a/translations/es-XL/data/reusables/enterprise/ldap_sync_warning.md +++ /dev/null @@ -1,9 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" %} - -{% warning %} - -Si tu instancia de {% data variables.product.prodname_ghe_server %} tiene [habilitadas la sincronización de LDAP y la opción para sincronizar correos electrónicos](/enterprise/admin/authentication/using-ldap#enabling-ldap-sync), esta API estará inhabilitada y devolverá una respuesta `403`. Los usuarios administrados en LDAP no podrán agregar o borrar una dirección de correo electrónico a través de la API si tienen estas opciones habilitadas. - -{% endwarning %} - -{% endif %} diff --git a/translations/es-XL/data/reusables/enterprise_enterprise_support/sign-in-to-enterprise-portal.md b/translations/es-XL/data/reusables/enterprise_enterprise_support/sign-in-to-enterprise-portal.md deleted file mode 100644 index 3bb54a126e83..000000000000 --- a/translations/es-XL/data/reusables/enterprise_enterprise_support/sign-in-to-enterprise-portal.md +++ /dev/null @@ -1 +0,0 @@ -1. Para iniciar sesión en el {% data variables.contact.enterprise_portal %}, en el ángulo superior derecho de la página, haz clic en **Sign in** (Iniciar sesión). ![Inicia sesión en {% data variables.contact.enterprise_portal %}](/assets/images/enterprise/support/sign-in-support-portal.png) diff --git a/translations/es-XL/data/reusables/enterprise_installation/increasing-cpus-max.md b/translations/es-XL/data/reusables/enterprise_installation/increasing-cpus-max.md deleted file mode 100644 index 7184a3e7e1c5..000000000000 --- a/translations/es-XL/data/reusables/enterprise_installation/increasing-cpus-max.md +++ /dev/null @@ -1,3 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" %} - {% data reusables.enterprise_installation.increasing-cpus-req %}Cuando utilizas más de 16 CPU, no necesitas agregar 6.5 GB de memoria para cada uno, pero debes monitorear tu instancia para garantizar que tenga memoria suficiente. -{% endif %} diff --git a/translations/es-XL/data/reusables/enterprise_installation/resizing-root-disk.md b/translations/es-XL/data/reusables/enterprise_installation/resizing-root-disk.md deleted file mode 100644 index 44e3347fd881..000000000000 --- a/translations/es-XL/data/reusables/enterprise_installation/resizing-root-disk.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Nota:** el disco raíz se puede cambiar de tamaño si construyes un aplicativo nuevo o si utilizas un aplicativo existente. Para obtener más información, consulta la sección [Incrementar la capacidad de almacenamiento](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-storage-capacity)" - -{% endnote %} diff --git a/translations/es-XL/data/reusables/enterprise_installation/root-and-data-disk-requirement.md b/translations/es-XL/data/reusables/enterprise_installation/root-and-data-disk-requirement.md deleted file mode 100644 index 0de4c2f9cde6..000000000000 --- a/translations/es-XL/data/reusables/enterprise_installation/root-and-data-disk-requirement.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_ghe_server %} requiere un disco de datos persistente separado del disco raíz. Para obtener más información, consulta "[Resumen del sistema](/enterprise/admin/guides/installation/system-overview)". diff --git a/translations/es-XL/data/reusables/enterprise_installation/storage-disk-requirements.md b/translations/es-XL/data/reusables/enterprise_installation/storage-disk-requirements.md deleted file mode 100644 index b267536e9aa5..000000000000 --- a/translations/es-XL/data/reusables/enterprise_installation/storage-disk-requirements.md +++ /dev/null @@ -1 +0,0 @@ -Para tu dispositivo de almacenamiento, recomendamos usar un SSD de alto rendimiento, ya sea que lo conectes en forma directa o desde una red del área de almacenamiento (SAN). diff --git a/translations/es-XL/data/reusables/enterprise_installation/warning-on-polling.md b/translations/es-XL/data/reusables/enterprise_installation/warning-on-polling.md deleted file mode 100644 index 07c7ae34df1d..000000000000 --- a/translations/es-XL/data/reusables/enterprise_installation/warning-on-polling.md +++ /dev/null @@ -1,5 +0,0 @@ -{% warning %} - -**Advertencia:** Te recomendamos utilizar webhooks para extraer cambios de repositorio para integración contínua (IC) o sistemas similares. Realizar verificaciones automáticas frecuentes, o *sondeos*, reducirá significativamente la escalabilidad de tu instancia. Para obtener más información, consulte "[Acerca de webhooks](/enterprise/{{ currentVersion }}/user/articles/about-webhooks/)" - -{% endwarning %} diff --git a/translations/es-XL/data/reusables/gated-features/actions-api-gated.md b/translations/es-XL/data/reusables/gated-features/actions-api-gated.md deleted file mode 100644 index 68c7b3a74aff..000000000000 --- a/translations/es-XL/data/reusables/gated-features/actions-api-gated.md +++ /dev/null @@ -1,5 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} - -{% data variables.product.prodname_actions %} se encuentra disponible con {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_free_team %} para organizaciones, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, y {% data variables.product.prodname_ghe_one %}. {% data variables.product.prodname_actions %} no está disponible para repositorios privados que pertenezcan a cuentas que utilicen planes tradicionales por repositorio. {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %} - -{% endif %} diff --git a/translations/es-XL/data/reusables/gated-features/credential-authorizations-org.md b/translations/es-XL/data/reusables/gated-features/credential-authorizations-org.md deleted file mode 100644 index 547e9843b1e3..000000000000 --- a/translations/es-XL/data/reusables/gated-features/credential-authorizations-org.md +++ /dev/null @@ -1,5 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} - -El listado y borrado de autorizaciones de credencial se encuentra disponible para las organizaciones con {% data variables.product.prodname_ghe_cloud %}. {% data reusables.gated-features.more-info %} - -{% endif %} diff --git a/translations/es-XL/data/reusables/gated-features/draft-pull-requests.md b/translations/es-XL/data/reusables/gated-features/draft-pull-requests.md deleted file mode 100644 index b7e31c517ea7..000000000000 --- a/translations/es-XL/data/reusables/gated-features/draft-pull-requests.md +++ /dev/null @@ -1,2 +0,0 @@ - -Los borradores de solicitudes de extracción se encuentran disponibles en repositorios públicos con {% data variables.product.prodname_free_user %} y {% data variables.product.prodname_free_team %} para organizaciones, {% data variables.product.prodname_pro %}, y planes de facturación por repositorio tradicionales, y en repositorios públicos y privados con {% data variables.product.prodname_team %}{% if currentVersion != "free-pro-team@latest" %}, {% data variables.product.prodname_ghe_server %} 2.17+,{% endif %} y {% data variables.product.prodname_ghe_cloud %}. {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %} diff --git a/translations/es-XL/data/reusables/gated-features/policies.md b/translations/es-XL/data/reusables/gated-features/policies.md deleted file mode 100644 index 414ecedadd76..000000000000 --- a/translations/es-XL/data/reusables/gated-features/policies.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Nota:** {% data variables.product.prodname_policies %} se encuentra acutalmente en alfa. Esta documentación es confidencial y se hace disponible mediante un NDA (Acuerdo de no divulgación, por sus siglas en inglés). No distribuir. - -{% endnote %} \ No newline at end of file diff --git a/translations/es-XL/data/reusables/gated-features/sponsors-beta.md b/translations/es-XL/data/reusables/gated-features/sponsors-beta.md deleted file mode 100644 index 4a154c2bc051..000000000000 --- a/translations/es-XL/data/reusables/gated-features/sponsors-beta.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Nota:**{% data variables.product.prodname_sponsors %} para organizaciones se encuentra actualmente en beta y está sujeto a cambios. - -{% endnote %} diff --git a/translations/es-XL/data/reusables/gated-features/team-sync-gated.md b/translations/es-XL/data/reusables/gated-features/team-sync-gated.md deleted file mode 100644 index 2d89daf79a81..000000000000 --- a/translations/es-XL/data/reusables/gated-features/team-sync-gated.md +++ /dev/null @@ -1,5 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} - -La sincronización de equipos se encuentra disponible para organizaciones que utilicen {% data variables.product.prodname_ghe_cloud %}. {% data reusables.gated-features.more-info %} - -{% endif %} diff --git a/translations/es-XL/data/reusables/github-actions/explains-hello-world-example.md b/translations/es-XL/data/reusables/github-actions/explains-hello-world-example.md deleted file mode 100644 index f2c79d2d13dc..000000000000 --- a/translations/es-XL/data/reusables/github-actions/explains-hello-world-example.md +++ /dev/null @@ -1 +0,0 @@ -El `OWNER` del repositorio es la organización `octocat` y el nombre del `REPOSITORY` es `hello-world`. diff --git a/translations/es-XL/data/reusables/github-actions/github-actions-minutes-change.md b/translations/es-XL/data/reusables/github-actions/github-actions-minutes-change.md deleted file mode 100644 index a02ff3ef1354..000000000000 --- a/translations/es-XL/data/reusables/github-actions/github-actions-minutes-change.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Nota:** Después del 14 de mayo de 2020, {% data variables.product.prodname_team %} incluirá 3,000 minutos mensuales de {% data variables.product.prodname_actions %}. - -{% endnote %} diff --git a/translations/es-XL/data/reusables/github-actions/github-actions-usage-limits.md b/translations/es-XL/data/reusables/github-actions/github-actions-usage-limits.md deleted file mode 100644 index 0845eceb5e1e..000000000000 --- a/translations/es-XL/data/reusables/github-actions/github-actions-usage-limits.md +++ /dev/null @@ -1,15 +0,0 @@ -Existen algunos límites para el uso de {% data variables.product.prodname_actions %}, los cuales dependerán de si utilizas ejecutores auto-hospedados, u hospedados en {% data variables.product.prodname_dotcom %}. Estos límites están sujetos a cambios. - -- **Tiempo de ejecución de jobs** - Cada job en un flujo de trabajo puede ejecutarse hasta por 6 horas en tiempo de ejecución. Si un job llega a este límite, éste se terminará y fallará en completarse. Este límite no aplica para los ejecutores auto-hospedados. -- **Tiempo de ejecución del flujo de trabajo** - Cada flujo de trabajo se limita a 72 horas. Si un flujo de trabajo llega a este límite, se cancelará. Este límite también aplica para los ejecutores auto-hospedados. -- **Tiempo de cola de espera para el job** - Cada job para ejecutores auto-hospedados puede ponerse en cola de espera por un máximo de 24 horas. Si un ejecutor auto-hospedado no comienza a ejecutar el job dentro de este límite de tiempo, dicho job se terminará y no se podrá completar. Este límite no aplica a los ejecutores hospedados en {% data variables.product.prodname_dotcom %}. -- **Solicitudes de la API** - Puedes ejecutar hasta 1000 solicitudes de API en una hora en todas las acciones dentro de un repositorio. Si esto se excede, los llamados adicionales a la API fallarán, lo cual puede ocasionar que los jobs fallen también. Este límite también aplica para los ejecutores auto-hospedados. -- **Jobs simultáneos** - La cantidad de jobs que puedes ejecutar simultáneamente en tu cuenta depende de tu plan de GitHub, como se indica en la siguiente tabla. Si eso se excede, cualquier job adicional se pondrá en cola de espera. No hay límites de ejecución simultánea para ejecutores auto-hospedados. - - | Plan de GitHub | Jobs simultáneos totales | Jobs simultáneos de macOS máximos | - | -------------- | ------------------------ | --------------------------------- | - | Gratis | 20 | 5 | - | Pro | 40 | 5 | - | Equipo | 60 | 5 | - | Empresa | 180 | 50 | -- **Matiz de jobs** - {% data reusables.github-actions.matrix-limits %} diff --git a/translations/es-XL/data/reusables/github-actions/matrix-limits.md b/translations/es-XL/data/reusables/github-actions/matrix-limits.md deleted file mode 100644 index 1ca2197eea84..000000000000 --- a/translations/es-XL/data/reusables/github-actions/matrix-limits.md +++ /dev/null @@ -1 +0,0 @@ -Una matriz de jobs puede generar un máximo de 256 jobs por ejecución de flujo de trabajo. Este límite también aplica para los ejecutores auto-hospedados. \ No newline at end of file diff --git a/translations/es-XL/data/reusables/github-actions/self-hosted-runner-add-new-runner.md b/translations/es-XL/data/reusables/github-actions/self-hosted-runner-add-new-runner.md deleted file mode 100644 index 9c25cde499ea..000000000000 --- a/translations/es-XL/data/reusables/github-actions/self-hosted-runner-add-new-runner.md +++ /dev/null @@ -1,20 +0,0 @@ -1. Debajo de "Eejcutores auto-hospedados", da clic en **Agregar ejecutor**. - -1. Selecciona el sistema operativo y arquitectura de tu máquina de ejecutor auto-hospedado. ![Selecciona el sistema operativo del ejecutor autoalojado](/assets/images/help/settings/actions-runner-architecture-os.png) - - -1. Verás instrucciones que te mostrarán cómo descargar la aplicación del ejecutor e instalarla en tu máquina de ejecutor autoalojado. - - Abre un shell en tu máquina de ejecutor autoalojado y ejecuta cada comando del shell en el orden que se muestra. - - {% note %} - - **Nota:** En Windows, si deseas instalar la aplicación del ejecutor autoalojado como un servicio, debes abrir un shell con privilegios de administrador. También recomendamos que uses `C:\actions-runner` como el directorio para la aplicación del ejecutor autoalojado de modo que las cuentas del sistema de Windows puedan acceder al directorio del ejecutor. - - {% endnote %} - - Las instrucciones te guían para completar estas tareas: - - Descargar y extraer la aplicación de ejecutor autoalojado. - - Ejecutar el script `config` para configurar la aplicación del ejecutor auto-hospedado y registrarlo con {% data variables.product.prodname_actions %}. El script `config` requiere la URL destino y un token de tiempo limitado generado automáticamente para autenticar la solicitud. - - En Windows, el script `config` también te pregunta si deseas instalar la aplicación del ejecutor autoalojado como un servicio. Para Linux y macOS, puedes instalar un servicio después de que termines de agregar el ejecutor. Para obtener más información, consulta "[Configurar la aplicación del ejecutor autoalojado como un servicio](/actions/automating-your-workflow-with-github-actions/configuring-the-self-hosted-runner-application-as-a-service)." - - Ejecutar la aplicación del ejecutor autoalojado para conectar la máquina a las {% data variables.product.prodname_actions %}. diff --git a/translations/es-XL/data/reusables/github-component-kit/intro-for-component-kit.md b/translations/es-XL/data/reusables/github-component-kit/intro-for-component-kit.md deleted file mode 100644 index 8fe721a9ae55..000000000000 --- a/translations/es-XL/data/reusables/github-component-kit/intro-for-component-kit.md +++ /dev/null @@ -1 +0,0 @@ -El {% data variables.product.prodname_component_kit %} utiliza {% data variables.product.prodname_github_app %}s y {% data variables.product.prodname_actions %} para impulsar los elementos interactivos dentro de la IU de {% data variables.product.prodname_dotcom %}. Por ejemplo, puedes guiar a los usuarios de un repositorio con los siguientes pasos o solicitarles aceptar los acuerdos de licencia. diff --git a/translations/es-XL/data/reusables/github-component-kit/opening-explanation-for-component-kit.md b/translations/es-XL/data/reusables/github-component-kit/opening-explanation-for-component-kit.md deleted file mode 100644 index c50be8ae0f8a..000000000000 --- a/translations/es-XL/data/reusables/github-component-kit/opening-explanation-for-component-kit.md +++ /dev/null @@ -1,3 +0,0 @@ -El {% data variables.product.prodname_component_kit %} te habilita para configurar un componente interactivo para que aparezca en un informe de problemas o en una solicitud de extracción. Los componentes interactivos habilitan a las personas para activar y administrar las tareas que aparecen en la {% data variables.product.prodname_dotcom %} cuando una {% data variables.product.prodname_github_app %} o una acción realizan las tareas solicitadas y comparten actualizaciones. - -Utilizando la terminal "[Crear un comentario estructurado](/hidden/github-component-kit/composable-comments#create-composable-comment)", una {% data variables.product.prodname_github_app %} o una acción pueden crear un comentario estructurado en un informe de problemas o en una solicitud de extracción. El comentario estructurado puede incluir un componente interactivo, tal como un botón personalizado. Cuando alguien interactúa con el comentario la {% data variables.product.prodname_github_app %} recibirá el evento de webhook `interactive_component`. diff --git a/translations/es-XL/data/reusables/github-insights/no-configuration-file.md b/translations/es-XL/data/reusables/github-insights/no-configuration-file.md deleted file mode 100644 index 64eb702cfe92..000000000000 --- a/translations/es-XL/data/reusables/github-insights/no-configuration-file.md +++ /dev/null @@ -1 +0,0 @@ -Si no tienes un archivo de configuración, sigue las instrucciones para instalar {% data variables.product.prodname_insights %} por primera vez. Para obtener más información, consulta la sección "[Instalar {% data variables.product.prodname_insights %}](/insights/installing-and-configuring-github-insights/installing-github-insights#installing-github-insights)". diff --git a/translations/es-XL/data/reusables/identity-and-permissions/about-connected-teams.md b/translations/es-XL/data/reusables/identity-and-permissions/about-connected-teams.md deleted file mode 100644 index 75009b717939..000000000000 --- a/translations/es-XL/data/reusables/identity-and-permissions/about-connected-teams.md +++ /dev/null @@ -1,7 +0,0 @@ -Una vez que los equipos {% data variables.product.prodname_dotcom %} están conectados a un grupo IdP, tu adiministrador IdP debe realizar cambios en la membrecía de equipo a través del proveedor de identidad. Si se conecta a un equipo con un grupo de IdP, no puedes administrar la membrecía de equipo en {% data variables.product.product_name %} o utilizando la API. - -Para administrar el acceso a un repositorio para cualquier equipo de {% data variables.product.prodname_dotcom %}, incluyendo los equipos conectados a un grupo de IdP, debes hacer cambios en {% data variables.product.product_name %}. Para obtener más información, consulta "[Acerca de equipos](/articles/about-teams)" y "[Administrar el acceso de equipo a un repositorio de la organización](/articles/managing-team-access-to-an-organization-repository)." - -Puedes seleccionar los repositorios a los cuales quieres que los miembros del equipo tengan acceso predeterminadamente. Los grupos conectados por IdP tendrán acceso a estos repositorios automáticamente. Para obtener más información, consulta la sección "[Administrar el acceso de un equipo a un repositorio organizacional](/articles/managing-team-access-to-an-organization-repository)". - -Todos los cambios a la membrecía de equipo que se hagan con tu IdP aparecerán en la bitácora de auditoría en {% data variables.product.product_name %} como cambios que realiza el bot de sincronización de equipos. Tu IdP enviará datos de la membresía de equipo a {% data variables.product.prodname_dotcom %} una vez por hora. \ No newline at end of file diff --git a/translations/es-XL/data/reusables/marketplace/marketplace_RFP_deadline.md b/translations/es-XL/data/reusables/marketplace/marketplace_RFP_deadline.md deleted file mode 100644 index 1188c5036139..000000000000 --- a/translations/es-XL/data/reusables/marketplace/marketplace_RFP_deadline.md +++ /dev/null @@ -1 +0,0 @@ -Abril de 10 \ No newline at end of file diff --git a/translations/es-XL/data/reusables/marketplace/unverified-req.md b/translations/es-XL/data/reusables/marketplace/unverified-req.md deleted file mode 100644 index 14479bd44c25..000000000000 --- a/translations/es-XL/data/reusables/marketplace/unverified-req.md +++ /dev/null @@ -1 +0,0 @@ -Las apps sin verificar no necesitan cumplir con los "[Requisitos para listar una app en GitHub Marketplace](/marketplace/getting-started/requirements-for-listing-an-app-on-github-marketplace/)" ni pasar por el "[proceso de revisión de seguridad](/marketplace/getting-started/security-review-process/)". \ No newline at end of file diff --git a/translations/es-XL/data/reusables/nested-teams/include-child-team-members.md b/translations/es-XL/data/reusables/nested-teams/include-child-team-members.md deleted file mode 100644 index 3210a722e190..000000000000 --- a/translations/es-XL/data/reusables/nested-teams/include-child-team-members.md +++ /dev/null @@ -1,5 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.20" %} -Si pasas el tipo de medios `hellcat-preview`, los miembros del equipo incluirán a los miembros de los equipos hijo. -{% else %} -Los miembros del equipo incluirán a los miembros de los equipos hijos. -{% endif %} diff --git a/translations/es-XL/data/reusables/organizations/org-settings-repository-roles.md b/translations/es-XL/data/reusables/organizations/org-settings-repository-roles.md deleted file mode 100644 index 2e5b0698ed44..000000000000 --- a/translations/es-XL/data/reusables/organizations/org-settings-repository-roles.md +++ /dev/null @@ -1 +0,0 @@ -4. En la barra lateral izquierda, da clic en **Roles del repositorio**. ![La pestaña de roles del repositorio en la configuración de la organización](/assets/images/help/organizations/org-settings-repository-roles.png) diff --git a/translations/es-XL/data/reusables/orgs/deprecating_creation_type.md b/translations/es-XL/data/reusables/orgs/deprecating_creation_type.md deleted file mode 100644 index 20a0ad422c2b..000000000000 --- a/translations/es-XL/data/reusables/orgs/deprecating_creation_type.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -{% warning %} - -**Aviso de Obsoletización de Parámetros:** {% data variables.product.prodname_dotcom %} reemplazará y descontinuará a `members_allowed_repository_creation_type` para favorecer permisos más granulares. Los nuevos parámetros de entrada son `members_can_create_public_repositories`, `members_can_create_private_repositories` para todas las organizaciones y `members_can_create_internal_repositories` para aquellas organizaciones asociadas con una cuenta empresarial que utilice {% data variables.product.prodname_ghe_cloud %} o {% data variables.product.prodname_ghe_server %} 2.20+. Para obtener más información, consulta la [publicación del blog](https://developer.github.com/changes/2019-12-03-internal-visibility-changes). - -{% endwarning %} -{% endif %} diff --git a/translations/es-XL/data/reusables/orgs/internal_repos.md b/translations/es-XL/data/reusables/orgs/internal_repos.md deleted file mode 100644 index f0f171c52239..000000000000 --- a/translations/es-XL/data/reusables/orgs/internal_repos.md +++ /dev/null @@ -1 +0,0 @@ -Si tu organización se asocia con una cuenta empresarial que utiliza {% data variables.product.prodname_ghe_cloud %} o {% data variables.product.prodname_ghe_server %} 2.20+, la `visibility` también puede ser `internal`. \ No newline at end of file diff --git a/translations/es-XL/data/reusables/package_registry/about-spending-limits.md b/translations/es-XL/data/reusables/package_registry/about-spending-limits.md deleted file mode 100644 index f9a0e7ec9999..000000000000 --- a/translations/es-XL/data/reusables/package_registry/about-spending-limits.md +++ /dev/null @@ -1 +0,0 @@ -Predeterminadamente, tu cuenta tendrá un límite de gastos de $0 para tu uso combinado de {% data variables.product.prodname_registry %} y {% data variables.product.prodname_actions %}. Para permitir los excedentes, puedes incrementar el límite de gastos o permitir los gastos ilimitados. diff --git a/translations/es-XL/data/reusables/package_registry/accessing-packages.md b/translations/es-XL/data/reusables/package_registry/accessing-packages.md deleted file mode 100644 index c79a6c173726..000000000000 --- a/translations/es-XL/data/reusables/package_registry/accessing-packages.md +++ /dev/null @@ -1,4 +0,0 @@ -Puedes acceder a tus paquetes desde esta URL si reemplazas `OWNER` con tu nombre de usuario u organización de {% data variables.product.prodname_dotcom %}, y `REPOSITORY` con tu nombre de repositorio: - ``` - https://github.com/OWNER/REPOSITORY/packages - ``` diff --git a/translations/es-XL/data/reusables/package_registry/authenticate-to-container-registry.md b/translations/es-XL/data/reusables/package_registry/authenticate-to-container-registry.md deleted file mode 100644 index 56a2c6418463..000000000000 --- a/translations/es-XL/data/reusables/package_registry/authenticate-to-container-registry.md +++ /dev/null @@ -1,18 +0,0 @@ -1. Create a new personal access token (PAT) with the appropriate scopes for the tasks you want to accomplish. If your organization requires SSO, you must enable SSO for your new token. - - Select the `read:packages` scope to download container images and read their metadata. - - Select the `write:packages` scope to download and upload container images and read and write their metadata. - - Select the `delete:packages` scope to delete container images. - - Para obtener más información, consulta la sección "[Crear un token de acceso personal para la línea de comandos](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)". - -2. Save your PAT. We recommend saving your PAT as an environment variable. - ```shell - $ export CR_PAT=YOUR_TOKEN - ``` -3. Using the CLI for your container type, sign in to the {% data variables.product.prodname_github_container_registry %} service at `ghcr.io`. - {% raw %} - ```shell - $ echo $CR_PAT | docker login ghcr.io -u USERNAME --password-stdin - > Login Succeeded - ``` - {% endraw %} diff --git a/translations/es-XL/data/reusables/permissions/admin-access-org.md b/translations/es-XL/data/reusables/permissions/admin-access-org.md deleted file mode 100644 index 251a0e482fa8..000000000000 --- a/translations/es-XL/data/reusables/permissions/admin-access-org.md +++ /dev/null @@ -1 +0,0 @@ -Debes autenticarte utilizando un token de acceso con el alcance `admin:org` para utilizar esta terminal. \ No newline at end of file diff --git a/translations/es-XL/data/reusables/permissions/admin-access.md b/translations/es-XL/data/reusables/permissions/admin-access.md deleted file mode 100644 index c614c79ff70f..000000000000 --- a/translations/es-XL/data/reusables/permissions/admin-access.md +++ /dev/null @@ -1 +0,0 @@ -Debes autenticarte utilizando un token de acceso con el alcance `repo` para utilizar esta terminal. \ No newline at end of file diff --git a/translations/es-XL/data/reusables/permissions/code-scanning-app-read-permissions.md b/translations/es-XL/data/reusables/permissions/code-scanning-app-read-permissions.md deleted file mode 100644 index 6002b33357ab..000000000000 --- a/translations/es-XL/data/reusables/permissions/code-scanning-app-read-permissions.md +++ /dev/null @@ -1 +0,0 @@ -Las {% data variables.product.prodname_github_app %}s deben tener el permiso de lectura de `security_events` para utilizar esta terminal. \ No newline at end of file diff --git a/translations/es-XL/data/reusables/permissions/read-access.md b/translations/es-XL/data/reusables/permissions/read-access.md deleted file mode 100644 index 843d7dbfd6db..000000000000 --- a/translations/es-XL/data/reusables/permissions/read-access.md +++ /dev/null @@ -1 +0,0 @@ -Cualquiera con acceso de lectura en el repositorio puede utilizar esta terminal. Si el repositorio es privado, debes utilizar un token de acceso con el alcance `repo`. \ No newline at end of file diff --git a/translations/es-XL/data/reusables/permissions/security-events-scope.md b/translations/es-XL/data/reusables/permissions/security-events-scope.md deleted file mode 100644 index a5c102d0fcaa..000000000000 --- a/translations/es-XL/data/reusables/permissions/security-events-scope.md +++ /dev/null @@ -1 +0,0 @@ -Debes utilizar un token de acceso con el alcance `security_events` para utilizar esta terminal. \ No newline at end of file diff --git a/translations/es-XL/data/reusables/permissions/write-access.md b/translations/es-XL/data/reusables/permissions/write-access.md deleted file mode 100644 index c614c79ff70f..000000000000 --- a/translations/es-XL/data/reusables/permissions/write-access.md +++ /dev/null @@ -1 +0,0 @@ -Debes autenticarte utilizando un token de acceso con el alcance `repo` para utilizar esta terminal. \ No newline at end of file diff --git a/translations/es-XL/data/reusables/pre-release-program/ant-man-preview-deployments.md b/translations/es-XL/data/reusables/pre-release-program/ant-man-preview-deployments.md deleted file mode 100644 index b26052d8377d..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/ant-man-preview-deployments.md +++ /dev/null @@ -1,11 +0,0 @@ -{% note %} - -**Nota:** Los parámetros de `transient_environment` y `production_environment` están actualmente disponibles para que los desarrolladores los previsualicen. Durante el periodo de vista previa, la API podría cambiar sin previo aviso. Por favor, consulta la [publicación del blog](https://developer.github.com/changes/2016-04-06-deployment-and-deployment-status-enhancements) para obtener todos los detalles. - -Para acceder a la API durante el periodo de vista previa, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: - -``` -application/vnd.github.ant-man-preview+json -``` - -{% endnote %} diff --git a/translations/es-XL/data/reusables/pre-release-program/ant-man-preview-statuses.md b/translations/es-XL/data/reusables/pre-release-program/ant-man-preview-statuses.md deleted file mode 100644 index 1b4aadc83625..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/ant-man-preview-statuses.md +++ /dev/null @@ -1,11 +0,0 @@ -{% note %} - -**Nota:** El estado `inactive` y los parámetros de `log_url`, `environment_url`, y `auto_inactive` se encuentran actualmente disponibles para que los desarrolladores los previsualicen. Por favor, consulta la [publicación del blog](https://developer.github.com/changes/2016-04-06-deployment-and-deployment-status-enhancements) para obtener todos los detalles. - -Para acceder a la API durante el periodo de vista previa, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: - -``` -application/vnd.github.ant-man-preview+json -``` - -{% endnote %} diff --git a/translations/es-XL/data/reusables/pre-release-program/antiope-preview.md b/translations/es-XL/data/reusables/pre-release-program/antiope-preview.md deleted file mode 100644 index 72e76776f2f9..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/antiope-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Nota:** La API de verificaciones se encuentra actualmente disponible para que los desarrolladores la previsualicen. Durante el periodo de vista previa, la API podría cambiar sin previo aviso. Por favor, consulta la [publicación del blog](https://developer.github.com/changes/2018-05-07-new-checks-api-public-beta/) para obtener todos los detalles. Para acceder a la API durante el periodo de vista previa, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: - -``` -application/vnd.github.antiope-preview+json -``` - -{% endnote %} diff --git a/translations/es-XL/data/reusables/pre-release-program/baptiste-keys-preview.md b/translations/es-XL/data/reusables/pre-release-program/baptiste-keys-preview.md deleted file mode 100644 index ec8d5409744d..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/baptiste-keys-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Nota:** Las claves de `is_template` y de `template_repository` actualmente se encuentran disponibles para que los desarrolladores las previsualicen. Consulta la sección [Crear un repositorio utilzando una plantilla](/v3/repos/#create-a-repository-using-a-template) para aprender cómo crear los repositorios de plantilla. Para acceder a estas claves de respuesta nuevas durante el periodo de vista previa, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: -``` -application/vnd.github.baptiste-preview+json -``` - -{% endnote %} diff --git a/translations/es-XL/data/reusables/pre-release-program/baptiste-preview.md b/translations/es-XL/data/reusables/pre-release-program/baptiste-preview.md deleted file mode 100644 index 5823f1342aed..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/baptiste-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Nota:** El crear y utilizar plantillas de repositorio se encuentra disponible para que los desarrolladores lo previsualicen. Para acceder a esta terminal nueva durante el periodo de vista previa, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: -``` -application/vnd.github.baptiste-preview+json -``` - -{% endnote %} diff --git a/translations/es-XL/data/reusables/pre-release-program/batman-preview.md b/translations/es-XL/data/reusables/pre-release-program/batman-preview.md deleted file mode 100644 index b2d42772b69d..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/batman-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -{% note %} - -**Nota:** El uso de la API de {% data variables.product.prodname_component_kit %} se encuentra disponible actualmente para que lo previsualicen los desarrolladores. Para acceder a estas terminales durante el periodo de vista previa, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: - -``` -application/vnd.github.batman-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/es-XL/data/reusables/pre-release-program/checks-public-beta.md b/translations/es-XL/data/reusables/pre-release-program/checks-public-beta.md deleted file mode 100644 index 4e3727abbfe8..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/checks-public-beta.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Nota:** La API de verificaciones se encuentra actualmente en un beta público y solo está disponible para utilizarse con las GitHub Apps. - -{% endnote %} diff --git a/translations/es-XL/data/reusables/pre-release-program/cloak-preview.md b/translations/es-XL/data/reusables/pre-release-program/cloak-preview.md deleted file mode 100644 index fe22fe89ab3e..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/cloak-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Nota:** La API de Búsqueda de Confirmaciones se encuentra disponible actualmente para que los desarrolladores la previsualicen. Durante el periodo de vista previa, las API podrían cambiar sin previo aviso. Por favor, consulta la [publicación del blog](https://developer.github.com/changes/2017-01-05-commit-search-api/) para obtener todos los detalles. - -Para acceder a la API debes proprocionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: -``` -application/vnd.github.cloak-preview -``` -{% endnote %} diff --git a/translations/es-XL/data/reusables/pre-release-program/code-scanning-beta.md b/translations/es-XL/data/reusables/pre-release-program/code-scanning-beta.md deleted file mode 100644 index f4e770e4dcb5..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/code-scanning-beta.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Nota:** El {% data variables.product.prodname_code_scanning_capc %} para repositorios de código abierto y privados se encuentra actualmente en beta y está sujeto a cambios. Para registrarte, consulta la sección [Beta de Seguridad Avanzada](https://github.com/features/security/advanced-security/signup). - -{% endnote %} -{% endif %} diff --git a/translations/es-XL/data/reusables/pre-release-program/comfort-fade-preview.md b/translations/es-XL/data/reusables/pre-release-program/comfort-fade-preview.md deleted file mode 100644 index ebe04cf4231e..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/comfort-fade-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Nota:** Los comentarios de línea múltiple en el diff de una solicitud de extracción se encuentran actualmente disponibles para que los desarrolladores los previsualicen. Para acceder a los nuevos campos de respuesta durante el periodo de previsualización, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: - -``` -application/vnd.github.comfort-fade-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/es-XL/data/reusables/pre-release-program/doctor-strange-preview.md b/translations/es-XL/data/reusables/pre-release-program/doctor-strange-preview.md deleted file mode 100644 index 811d2ef897cc..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/doctor-strange-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion == "enterprise-server@2.20" %} -{% note %} - -**Nota:** Las terminales nuevas que utilicen tokens de OAuth como parámetros de entrada en vez de como parámetros de ruta se encuentran disponibles para que los desarrolladores las previsualicen en la [API de Aplicaciones de OAuth](/v3/apps/oauth_applications/). Para acceder a estas terminales durante el periodo de vista previa, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: - -``` -application/vnd.github.doctor-strange-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/es-XL/data/reusables/pre-release-program/dorian-preview.md b/translations/es-XL/data/reusables/pre-release-program/dorian-preview.md deleted file mode 100644 index 1d809706b574..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/dorian-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Nota:** El habilitar e inhabilitar las alertas de dependencia para un repositorio que utilice la API de REST se encuentra actualmente disponible para que los desarrolladores lo previsualicen. Para acceder estas terminales nuevas durante el periodo de previsualización, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado `Accept`: -``` -application/vnd.github.dorian-preview+json -``` - -{% endnote %} diff --git a/translations/es-XL/data/reusables/pre-release-program/drax-preview.md b/translations/es-XL/data/reusables/pre-release-program/drax-preview.md deleted file mode 100644 index 9fcc664418b6..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/drax-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.13" %} -{% note %} - -**Nota:** La [API de Licencias](https://developer.github.com/changes/2015-03-09-licenses-api/) está actualmente disponible para que los desarrolladores la previsualicen. Para acceder a la API durante el periodo de vista previa, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: - -``` -application/vnd.github.drax-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/es-XL/data/reusables/pre-release-program/echo-preview.md b/translations/es-XL/data/reusables/pre-release-program/echo-preview.md deleted file mode 100644 index de2455a6dec5..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/echo-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -{% note %} - -**Nota:** La API debates de equipo se encuentra disponible actualmente para que los desarrolladores la previsualicen. Consulta la [publicación del blog](https://developer.github.com/changes/2018-02-07-team-discussions-api) para encontrar todos los detalles. Para acceder a la API durante el periodo de vista previa, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: - -``` -application/vnd.github.echo-preview+json -``` -{% endnote %} -{% endif %} diff --git a/translations/es-XL/data/reusables/pre-release-program/flash-preview.md b/translations/es-XL/data/reusables/pre-release-program/flash-preview.md deleted file mode 100644 index b7022c80130c..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/flash-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% note %} - -**Nota:** Las características nuevas en la API de despliegues en {% data variables.product.product_name %} se encuentran actualmente disponibles durante el beta público. Por favor, consulta la [publicación del blog](https://developer.github.com/changes/2018-10-16-deployments-environments-states-and-auto-inactive-updates/) para obtener todos los detalles. - -Para acceder al nuevo parámetro de `environment`, los dos valores nuevos para el parámetro `state` (`in_progress` y `queued`), y para utilizar `auto_inactive` en despliegues productivos durante el periodo del beta público, debes proporcionar los siguientes [tipos de medios](/v3/media) personalizados en el encabezado `Accept`: - -``` -application/vnd.github.flash-preview+json -``` - -{% endnote %} diff --git a/translations/es-XL/data/reusables/pre-release-program/gambit-preview.md b/translations/es-XL/data/reusables/pre-release-program/gambit-preview.md deleted file mode 100644 index cd6f4b1c2ffb..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/gambit-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.21" %} -{% note %} - -**Nota:** El desinstalar las {% data variables.product.prodname_github_app %}s y el revocar el token de instalación de una app se encuentra disponible para que los desarrolladores lo previsualicen. Para acceder a la terminal nueva durante el periodo de vista previa, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado `Accept`: -``` -application/vnd.github.gambit-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/es-XL/data/reusables/pre-release-program/giant-sentry-fist-pre-release.md b/translations/es-XL/data/reusables/pre-release-program/giant-sentry-fist-pre-release.md deleted file mode 100644 index 8db126e6d32e..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/giant-sentry-fist-pre-release.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "2.8" %} -{% note %} - -**Nota:** {% data variables.giant-sentry-fist.product_name_long %} en {% data variables.product.product_name %} se encuentra actualmente disponible para que los desarrolladores lo previsualicen. Para acceder a la API, debes proprocionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: - -``` -application/vnd.github.giant-sentry-fist-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/es-XL/data/reusables/pre-release-program/github-actions-public-beta.md b/translations/es-XL/data/reusables/pre-release-program/github-actions-public-beta.md deleted file mode 100644 index 7f966f4ca1d1..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/github-actions-public-beta.md +++ /dev/null @@ -1,11 +0,0 @@ -{% warning %} - -**Lanzamiento nuevo:** {% data variables.product.prodname_actions %} ahora se encuentra disponible en un beta público limitado nuevo. Esta versión ofrece una configuración de flujo de trabajo nueva y capacidades incorporadas para integración y despliegue contínuos. Realmente te recomendamos que evites utilizarlo para flujos de trabajo y contenido de alto valor durante este periodo de beta público. Para solicitar unirte a al beta público limitado, consulta la [página de Github Actions](https://github.com/features/actions). Para obtener más información, consulta la sección "[Acerca de GitHub Actions](/articles/about-github-actions)". - -GitHub Support solo proporcionará compatibilidad con la sintaxis de YAML y ya no lo hará para aquella de HCL. - -Si participaste en la beta pública limitada y creaste flujos de trabajo con la sintaxis HCL de {% data variables.product.prodname_actions %}, deberás actualizar a la nueva beta pública limitada que utiliza la sintaxis YAML. Cuando tu repositorio sea apto para actualizarse, verás una invitación en tu repositorio. Debes aceptar la invitación antes de poder usar la nueva beta pública limitada. - -Una vez que hagas la mejora, cualquier flujo de trabajo que hayas creado con la sintaxis de HCL tendrá que actualizarse a la nueva sintaxis de YAML. Para convertir tus flujos de trabajo automáticamente, consulta la sección "[Mirgrar las {% data variables.product.prodname_actions %} de la sintaxis de HCL a la sintaxis de YAML](/articles/migrating-github-actions-from-hcl-syntax-to-yaml-syntax)". - -{% endwarning %} diff --git a/translations/es-XL/data/reusables/pre-release-program/github-components-public-beta.md b/translations/es-XL/data/reusables/pre-release-program/github-components-public-beta.md deleted file mode 100644 index a71b2d42e0a6..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/github-components-public-beta.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -{% note %} - -**Nota:** La API de {% data variables.product.prodname_component_kit %} se encuentra acutalmente en beta privado y está sujeto a cambios. - -{% endnote %} -{% endif %} diff --git a/translations/es-XL/data/reusables/pre-release-program/groot-preview.md b/translations/es-XL/data/reusables/pre-release-program/groot-preview.md deleted file mode 100644 index 5590375b3159..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/groot-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Nota:** El actualizar ramas o solicitudes de extracción para una confirmación en la API de confirmaciones se encuentra actualmente disponible para que los desarrolladores lo previsualicen. Consulta la [publicación del blog](https://developer.github.com/changes/2019-04-11-pulls-branches-for-commit/) para encontrar más detalles. Para acceder a las terminales nuevas durante el periodo de previsualización, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado `Accept`: -``` -application/vnd.github.groot-preview+json -``` - -{% endnote %} diff --git a/translations/es-XL/data/reusables/pre-release-program/hagar-preview.md b/translations/es-XL/data/reusables/pre-release-program/hagar-preview.md deleted file mode 100644 index 66c482050fda..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/hagar-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -{% note %} - -**Nota:** Ahora puedes recuperar la información de la tarjeta de visita virtual de alguien en diferentes contextos utilizando la API de tarjeta de visita virtual. Esta característica se encuentra disponible actualmente para que los desarrolladores la previsualicen. Consulta la [publicación del blog](https://developer.github.com/changes/2018-03-21-hovercard-api-preview) para encontrar todos los detalles. Para acceder a la API durante el periodo de vista previa, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: -``` -application/vnd.github.hagar-preview+json -``` -{% endnote %} -{% endif %} diff --git a/translations/es-XL/data/reusables/pre-release-program/hellcat-preview.md b/translations/es-XL/data/reusables/pre-release-program/hellcat-preview.md deleted file mode 100644 index c2caa43fc445..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/hellcat-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.20" %} -{% note %} - -**Nota:** La API de Equipos Anidados actualmente está disponible para que los desarrolladores la previsualicen. Consulta la [publicación del blog](https://developer.github.com/changes/2017-08-30-preview-nested-teams) para encontrar todos los detalles. Para acceder a la API, debes proprocionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: -``` -application/vnd.github.hellcat-preview+json -``` -{% endnote %} - -{% endif %} diff --git a/translations/es-XL/data/reusables/pre-release-program/inertia-preview.md b/translations/es-XL/data/reusables/pre-release-program/inertia-preview.md deleted file mode 100644 index 1a691401bc15..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/inertia-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Nota:** La API de Poryectos actualmente está disponible para que los desarrolladores la previsualicen. Durante el periodo de vista previa, la API podría cambiar sin previo aviso. Por favor, consulta la [publicación del blog](https://developer.github.com/changes/2016-10-27-changes-to-projects-api) para obtener todos los detalles. Para acceder a la API durante el periodo de vista previa, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: - -``` -application/vnd.github.inertia-preview+json -``` - -{% endnote %} diff --git a/translations/es-XL/data/reusables/pre-release-program/london-preview.md b/translations/es-XL/data/reusables/pre-release-program/london-preview.md deleted file mode 100644 index f25183b67fb5..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/london-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Nota:** El Habilitar e inhabilitar correcciones de seguridad automatizadas se encuentra actualmente disponible para que los desarrolladores lo previsualicen. Para acceder a esta terminal nueva durante el periodo de vista previa, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: -``` -application/vnd.github.london-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/es-XL/data/reusables/pre-release-program/luke-cage-preview.md b/translations/es-XL/data/reusables/pre-release-program/luke-cage-preview.md deleted file mode 100644 index ee0680ce68d7..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/luke-cage-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Nota:** La API de Ramas Protegidas ahora tiene una configuración para requerir una cantidad específica de revisiónes aprobatorias de solicitudes de extracción antes de la fusión. Esta característica se encuentra disponible actualmente para que los desarrolladores la previsualicen. Consulta la [publicación del blog](https://developer.github.com/changes/2018-03-16-protected-branches-required-approving-reviews) para encontrar todos los detalles. Para acceder a la API durante el periodo de vista previa, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: - -``` -application/vnd.github.luke-cage-preview+json -``` - -{% endnote %} diff --git a/translations/es-XL/data/reusables/pre-release-program/lydian-preview.md b/translations/es-XL/data/reusables/pre-release-program/lydian-preview.md deleted file mode 100644 index f75033e821a0..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/lydian-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Nota:** El actualizar la rama de solicitud de extracción con los últimos cambios ascendentes se encuentra actualmente disponible para que los desarrolladores lo previsualicen. Para acceder a esta terminal nueva durante el periodo de vista previa, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: -``` -application/vnd.github.lydian-preview+json -``` - -{% endnote %} diff --git a/translations/es-XL/data/reusables/pre-release-program/mercy-pre-release-replace.md b/translations/es-XL/data/reusables/pre-release-program/mercy-pre-release-replace.md deleted file mode 100644 index 4609a733279a..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/mercy-pre-release-replace.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Nota:** Los temas de repositorio en {% data variables.product.product_name %} están disponibles actualmente para que los desarrolladores los previsualicen. Para utilizar esta terminal, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: - -``` -application/vnd.github.mercy-preview+json -``` - -{% endnote %} diff --git a/translations/es-XL/data/reusables/pre-release-program/mercy-pre-release.md b/translations/es-XL/data/reusables/pre-release-program/mercy-pre-release.md deleted file mode 100644 index 13e3c0684be0..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/mercy-pre-release.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Nota:** {% data variables.mercy.product_name_long %} en {% data variables.product.product_name %} se encuentra disponible para que los desarrolladores lo previsualicen. Para ver la propiedad de `topics` en las llamadas que devuelven resultados del repositorio, debes proprocionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: - -``` -application/vnd.github.mercy-preview+json -``` - -{% endnote %} diff --git a/translations/es-XL/data/reusables/pre-release-program/mister-fantastic-pre-release.md b/translations/es-XL/data/reusables/pre-release-program/mister-fantastic-pre-release.md deleted file mode 100644 index bab296d8f86a..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/mister-fantastic-pre-release.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -{% note %} - -**Nota:** {% data variables.mister-fantastic.product_name_long %} contiene dos campos adicionales en las respuestas, los cuales pueden previsualizar los desarrolladores: `html_url` y `source`. Para ver estos dos campos nuevos, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado `Accept`: - -``` -application/vnd.github.mister-fantastic-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/es-XL/data/reusables/pre-release-program/mockingbird-preview.md b/translations/es-XL/data/reusables/pre-release-program/mockingbird-preview.md deleted file mode 100644 index 9751095698a0..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/mockingbird-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Nota:** La API para obtener la líne de tiempo de un informe de problemas actualmente está disponible para que los desarrolladores la previsualicen. Durante el periodo de vista previa, las API podrían cambiar sin previo aviso. Por favor, consulta la [publicación del blog](https://developer.github.com/changes/2016-05-23-timeline-preview-api/) para obtener todos los detalles. Para acceder a la API debes proprocionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: - -``` -application/vnd.github.mockingbird-preview -``` - -{% endnote %} diff --git a/translations/es-XL/data/reusables/pre-release-program/multi-line-comments-public-beta.md b/translations/es-XL/data/reusables/pre-release-program/multi-line-comments-public-beta.md deleted file mode 100644 index 71cba5688fdb..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/multi-line-comments-public-beta.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Nota:** Los comentarios de línea múltiple en las solicitudes de extracción se encuentran actualmente en un beta público y están sujetos a cambios. - -{% endnote %} -{% endif %} diff --git a/translations/es-XL/data/reusables/pre-release-program/nebula-preview.md b/translations/es-XL/data/reusables/pre-release-program/nebula-preview.md deleted file mode 100644 index 14712e8a5274..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/nebula-preview.md +++ /dev/null @@ -1,14 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} - -{% note %} - -**Nota:** Puedes configurar la visibilidad de un repositorio utilizando el parámetro nuevo de `visibility` en la [API de Repositorios](/v3/repos/), y obtener así la visibilidad de un repositorio con una llave de respuesta nueva. Para obtener más información, consulta la [publicación del blog](https://developer.github.com/changes/2019-12-03-internal-visibility-changes/). - -Para acceder a la visibilidad del repositorio durante el periodo de previsualización, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: - -``` -application/vnd.github.nebula-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/es-XL/data/reusables/pre-release-program/nightshade-preview.md b/translations/es-XL/data/reusables/pre-release-program/nightshade-preview.md deleted file mode 100644 index a6e23b33a872..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/nightshade-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.20" %} -{% note %} - -**Nota:** La [API de Transferencia de Repositorios](https://developer.github.com/changes/2017-11-09-repository-transfer-api-preview) está actualmente disponible para que los desarrolladores la pre-vean. Para acceder a la API, debes proprocionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: - -``` -application/vnd.github.nightshade-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/es-XL/data/reusables/pre-release-program/org-self-hosted-runner-beta.md b/translations/es-XL/data/reusables/pre-release-program/org-self-hosted-runner-beta.md deleted file mode 100644 index 7b9e1f6eecf0..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/org-self-hosted-runner-beta.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% warning %} - -**Advertencia:** La API de los ejecutores auto-hospedados para las organizaciones se encuentra actualmente en un beta público y está sujeta a cambios. - -{% endwarning %} -{% endif %} diff --git a/translations/es-XL/data/reusables/pre-release-program/performed-by-integration-deployment.md b/translations/es-XL/data/reusables/pre-release-program/performed-by-integration-deployment.md deleted file mode 100644 index 23bac400da77..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/performed-by-integration-deployment.md +++ /dev/null @@ -1,13 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Nota:** Si se crea un despliegue a través de una {% data variables.product.prodname_github_app %}, la respuesta incluirá el objeto `performed_via_github_app` con información acerca de dicha {% data variables.product.prodname_github_app %}. Para obtener más información, consulta la [publicación del blog relacionada](https://developer.github.com/changes/2016-09-14-Integrations-Early-Access). - -Para recibir el objeto `performed_via_github_app` en la respuesta, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: - -``` -application/vnd.github.machine-man-preview -``` - -{% endnote %} -{% endif %} diff --git a/translations/es-XL/data/reusables/pre-release-program/performed-by-integration-issue-comment.md b/translations/es-XL/data/reusables/pre-release-program/performed-by-integration-issue-comment.md deleted file mode 100644 index 8fa431013241..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/performed-by-integration-issue-comment.md +++ /dev/null @@ -1,13 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Nota:** Si se crea un comentario de un informe de problemas a través de una {% data variables.product.prodname_github_app %}, la respuesta incluirá el objeto `performed_via_github_app` con información acerca de dicha {% data variables.product.prodname_github_app %}. Para obtener más información, consulta la [publicación del blog relacionada](https://developer.github.com/changes/2016-09-14-Integrations-Early-Access). - -Para recibir el objeto `performed_via_github_app` en la respuesta, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: - -``` -application/vnd.github.machine-man-preview -``` - -{% endnote %} -{% endif %} diff --git a/translations/es-XL/data/reusables/pre-release-program/performed-by-integration-issue-event.md b/translations/es-XL/data/reusables/pre-release-program/performed-by-integration-issue-event.md deleted file mode 100644 index bf49fc3b53e7..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/performed-by-integration-issue-event.md +++ /dev/null @@ -1,13 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Nota:** Si se crea un evento de un informe de problemas a través de una {% data variables.product.prodname_github_app %}, la respuesta incluirá el objeto `performed_via_github_app` con información acerca de dicha {% data variables.product.prodname_github_app %}. Para obtener más información, consulta la [publicación del blog relacionada](https://developer.github.com/changes/2016-09-14-Integrations-Early-Access). - -Para recibir el objeto `performed_via_github_app` en la respuesta, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: - -``` -application/vnd.github.machine-man-preview -``` - -{% endnote %} -{% endif %} diff --git a/translations/es-XL/data/reusables/pre-release-program/performed-by-integration-issue.md b/translations/es-XL/data/reusables/pre-release-program/performed-by-integration-issue.md deleted file mode 100644 index 9c5a5464fe4b..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/performed-by-integration-issue.md +++ /dev/null @@ -1,13 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Nota:** Si se abre un informe de problemas a través de una {% data variables.product.prodname_github_app %}, la respuesta incluirá el objeto `performed_via_github_app` con información acerca de dicha {% data variables.product.prodname_github_app %}. Para obtener más información, consulta la [publicación del blog relacionada](https://developer.github.com/changes/2016-09-14-Integrations-Early-Access). - -Para recibir el objeto `performed_via_github_app` en la respuesta, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: - -``` -application/vnd.github.machine-man-preview -``` - -{% endnote %} -{% endif %} diff --git a/translations/es-XL/data/reusables/pre-release-program/scarlet-witch-key-preview.md b/translations/es-XL/data/reusables/pre-release-program/scarlet-witch-key-preview.md deleted file mode 100644 index 3a69758da91d..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/scarlet-witch-key-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Nota:** Los desarroladores pueden previsualizar un `code_of_conduct` nuevo en las respuestas. Para obtener más información, consulta la [API de códigos de conducta](/v3/codes_of_conduct/). - -Para acceder a esta clave de respuesta nueva durante el periodo de previsualización, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado `Accept`: -``` -application/vnd.github.scarlet-witch-preview+json -``` -{% endnote %} diff --git a/translations/es-XL/data/reusables/pre-release-program/scarlet-witch-preview.md b/translations/es-XL/data/reusables/pre-release-program/scarlet-witch-preview.md deleted file mode 100644 index 7bb1e1d0f0da..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/scarlet-witch-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Nota:** La API de Códigos de Conducta se encuentra disponible actualmente para que los desarrolladores la previsualicen. - -Para acceder a la API durante el periodo de vista previa, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: -``` -application/vnd.github.scarlet-witch-preview+json -``` -{% endnote %} diff --git a/translations/es-XL/data/reusables/pre-release-program/shadow-cat-preview.md b/translations/es-XL/data/reusables/pre-release-program/shadow-cat-preview.md deleted file mode 100644 index e3dcf48b1a45..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/shadow-cat-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.21" %} -{% note %} - -**Nota:** La API de Borrador de Solicitud de Extracción actualmente está disponible para que los desarrolladores la previsualicen. Puedes utilizar esta API para crear un borrador de solicitud de extracción o ver si una solicitud de extracción se encuentra en estado de borrador. Consulta la vista previa de la [publicación del blog](https://developer.github.com/changes/2019-02-14-draft-pull-requests) para encontrar más detalles. Para acceder al nuevo parámetro `draft` durante el periodo de previsualización, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado `Accept`: -``` -application/vnd.github.shadow-cat-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/es-XL/data/reusables/pre-release-program/sombra-preview.md b/translations/es-XL/data/reusables/pre-release-program/sombra-preview.md deleted file mode 100644 index f02320179a69..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/sombra-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Nota:** La API de interacciones se encuentra actualmente en previsualización pública. Consulta la vista previa de la [publicación del blog](https://developer.github.com/changes/2018-12-18-interactions-preview) para encontrar más detalles. Para acceder a la API durante el periodo de vista previa, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: -``` -application/vnd.github.sombra-preview -``` - -{% endnote %} -{% endif %} diff --git a/translations/es-XL/data/reusables/pre-release-program/squirrel-girl-preview.md b/translations/es-XL/data/reusables/pre-release-program/squirrel-girl-preview.md deleted file mode 100644 index 17c35fad3bde..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/squirrel-girl-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Nota:** Las API para administrar las reacciones se encuentran disponibles actualmente para que los desarrolladores las previsualicen. Consulta la [publicación del blog](https://developer.github.com/changes/2016-05-12-reactions-api-preview) para encontrar todos los detalles. Para acceder a la API durante el periodo de vista previa, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: - - ``` - application/vnd.github.squirrel-girl-preview+json - ``` - {% endnote %} diff --git a/translations/es-XL/data/reusables/pre-release-program/squirrel-girl-response-preview.md b/translations/es-XL/data/reusables/pre-release-program/squirrel-girl-response-preview.md deleted file mode 100644 index 6b463aa4c93a..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/squirrel-girl-response-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Nota:** La [API de reacciones](/v3/reactions/) está disponible para que los desarrolladores la previsualicen. La `url` puede utilizarse para construir la ubicación de la API para [listar y crear](/v3/reactions) reacciones. Consulta la [publicación del blog](https://developer.github.com/changes/2016-05-12-reactions-api-preview) para encontrar todos los detalles. Para recibir el objeto `reactions` en la respuesta para esta terminal, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: - -``` -application/vnd.github.squirrel-girl-preview -``` - -{% endnote %} diff --git a/translations/es-XL/data/reusables/pre-release-program/superpro-preview.md b/translations/es-XL/data/reusables/pre-release-program/superpro-preview.md deleted file mode 100644 index 6716cdad5aeb..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/superpro-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Nota:** La [API de Webhooks Globales](/rest/reference/enterprise-admin#global-webhooks) está actualmente disponible para que los desarrolladores la pre-vean. Para acceder a la API durante el periodo de vista previa, debes proporcionar un [tipo de medios](/rest/overview/media-types) personalizado en el encabezado de `Accept`: - -``` -application/vnd.github.superpro-preview+json -``` - -{% endnote %} diff --git a/translations/es-XL/data/reusables/pre-release-program/surtur-preview.md b/translations/es-XL/data/reusables/pre-release-program/surtur-preview.md deleted file mode 100644 index 12f06c7f0415..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/surtur-preview.md +++ /dev/null @@ -1,21 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -{% note %} - -**Nota:** Los permisos de creación de repositorios nuevos se encuentran disponibles para su previsualización. Ahora puedes utilizar `members_can_create_public_repositories`, `members_can_create_private_repositories`, and `members_can_create_internal_repositories`. Solo puedes permitir que los miembros creen repositorios internos si tu organización está asociada con una cuenta empresarial que utilice {% data variables.product.prodname_ghe_cloud %} o {% data variables.product.prodname_ghe_server %} 2.20+. Estos parámetros proporcionan permisos más granulares para configurar el tipo de repositorios que pueden crear los miembros de la organización. - -Para acceder a estos parámetros nuevos durante el periodo de previsualización, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado `Accept`: -``` -application/vnd.github.surtur-preview+json -``` -{% endnote %} -{% else %} -{% note %} - -**Nota:** Los permisos de creación de repositorios nuevos se encuentran disponibles para su previsualización. Ahora puedes configurar el parámetro `members_allowed_repository_creation_type` para configurar si los miembros de la organización pueden crear repositorios y qué tipo de repositorios pueden crear. - -Para acceder a este parámetro nuevo durante el periodo de previsualización, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado `Accept`: -``` -application/vnd.github.surtur-preview+json -``` -{% endnote %} -{% endif %} diff --git a/translations/es-XL/data/reusables/pre-release-program/switcheroo-preview.md b/translations/es-XL/data/reusables/pre-release-program/switcheroo-preview.md deleted file mode 100644 index 0e56d9cae2f4..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/switcheroo-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Nota:** El Habilitar e inhabilitar las Páginas en la API de Páginas se encuentra actualmente disponible para que los desarrolladores lo previsualicen. Consulta la vista previa de la [publicación del blog](https://developer.github.com/changes/2019-03-14-enabling-disabling-pages/) para encontrar más detalles. Para acceder a las terminales nuevas durante el periodo de previsualización, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado `Accept`: -``` -application/vnd.github.switcheroo-preview+json -``` - -{% endnote %} diff --git a/translations/es-XL/data/reusables/pre-release-program/symmetra-preview.md b/translations/es-XL/data/reusables/pre-release-program/symmetra-preview.md deleted file mode 100644 index 01797798d39f..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/symmetra-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% if currentVersion != ‘dotcom’ and currentVersion ver_lt "enterprise-server@2.20" %} -{% note %} - -**Nota:** Puedes agregar o editar las descripciones en las etiquetas. Consulta la [publicación del blog](https://developer.github.com/changes/2018-02-22-label-description-search-preview) para encontrar todos los detalles. Para acceder a esta característica durante el periodo de previsualización, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: -``` -application/vnd.github.symmetra-preview+json -``` -{% endnote %} -{% endif %} diff --git a/translations/es-XL/data/reusables/pre-release-program/thor-pre-release.md b/translations/es-XL/data/reusables/pre-release-program/thor-pre-release.md deleted file mode 100644 index 2ea7edf83e15..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/thor-pre-release.md +++ /dev/null @@ -1,13 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.13" %} -{% note %} - -**Nota:** Las solicitudes de revisión basadas en equipos dentro de la API de Solicitudes de Revisión en {% data variables.product.product_name %} se encuentran actualmente disponibles para que los desarrolladores las previsualicen. Consulta la [publicación del blog](https://developer.github.com/changes/2017-07-26-team-review-request-thor-preview) para encontrar todos los detalles. - -Para acceder a la API durante el periodo de vista previa, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: - -``` -application/vnd.github.thor-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/es-XL/data/reusables/pre-release-program/usage-api-beta.md b/translations/es-XL/data/reusables/pre-release-program/usage-api-beta.md deleted file mode 100644 index eea8863ac80f..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/usage-api-beta.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% warning %} - -**Advertencia:** Esta terminal de uso de {% data variables.product.prodname_actions %} se encuentra actualmente en beta público y está sujeta a cambios. Para obtener más información, consulta la sección "[Uso del flujo de trabajo de la API de Github Actions](https://developer.github.com/changes/2020-05-15-actions-api-workflow-usage)". - -{% endwarning %} -{% endif %} diff --git a/translations/es-XL/data/reusables/pre-release-program/wyandotte-preview.md b/translations/es-XL/data/reusables/pre-release-program/wyandotte-preview.md deleted file mode 100644 index c44a9d46016c..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/wyandotte-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Nota:** Para acceder a la API de migraciones, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado `Accept`: -``` -application/vnd.github.wyandotte-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/es-XL/data/reusables/pre-release-program/x-ray-preview.md b/translations/es-XL/data/reusables/pre-release-program/x-ray-preview.md deleted file mode 100644 index b97bfdc7b3f5..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/x-ray-preview.md +++ /dev/null @@ -1,13 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" %} -{% note %} - -**Nota:** Cuando una instancia de GitHub Enterprise se encuentra en modo privado, los administradores de sitio y de repositorio pueden habilitar el acceso anónimo de Git para un repositorio público. Esta característica se encuentra disponible actualmente para que los desarrolladores la previsualicen. Consulta la [publicación del blog](https://blog.github.com/2018-07-12-introducing-enterprise-2-14/) para encontrar todos los detalles. - -Para acceder a la API durante el periodo de vista previa, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: - -``` -application/vnd.github.x-ray-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/es-XL/data/reusables/pre-release-program/zzzax-preview.md b/translations/es-XL/data/reusables/pre-release-program/zzzax-preview.md deleted file mode 100644 index 99d704d0ba73..000000000000 --- a/translations/es-XL/data/reusables/pre-release-program/zzzax-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.12" %} -{% note %} - -**Nota:** La API de Ramas Protegidas ahora puede administrar una configuración para requerir las confirmaciones firmadas. Esta característica se encuentra disponible actualmente para que los desarrolladores la previsualicen. Consulta la [publicación del blog](https://developer.github.com/changes/2018-02-22-protected-branches-required-signatures) para encontrar todos los detalles. Para acceder a la API durante el periodo de vista previa, debes proporcionar un [tipo de medios](/v3/media) personalizado en el encabezado de `Accept`: - -``` -application/vnd.github.zzzax-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/es-XL/data/reusables/pulls/diff_location.md b/translations/es-XL/data/reusables/pulls/diff_location.md deleted file mode 100644 index 031c4d7ea9e3..000000000000 --- a/translations/es-XL/data/reusables/pulls/diff_location.md +++ /dev/null @@ -1,7 +0,0 @@ -{% note %} - -**Nota:** Para comentar en una línea específica de un archivo, necesitas determinar primero la _posición_ de dicha línea en el diff. La API de REST de GitHub ofrece el [tipo de medios](/v3/media/#commits-commit-comparison-and-pull-requests) `application/vnd.github.v3.diff`. Para ver el diff de una solicitud de extracción, agrega este tipo de medios al encabezado `Accept` de una llamada a la terminal [solicitud de extracción sencilla](/v3/pulls/#get-a-pull-request). - -El valor `position` será la cantidad de líneas hacia abajo desde el primer pedazo de "@@" en el encabezado dentro del archivo al que quieras agregar un comentario. La línea que está justo debajo de aquella con "@@" es la posición 1, la siguiente es la posición 2, y así subsecuentemente. La posición en el diff sigue incrementando a través de las líneas de espacios en blanco y de trozos adicionales hasta que comience un archivo nuevo. - -{% endnote %} diff --git a/translations/es-XL/data/reusables/pulls/multiline_comments_summary_for_responses.md b/translations/es-XL/data/reusables/pulls/multiline_comments_summary_for_responses.md deleted file mode 100644 index d8809b212b11..000000000000 --- a/translations/es-XL/data/reusables/pulls/multiline_comments_summary_for_responses.md +++ /dev/null @@ -1,21 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} - -##### Resumen de comentarios de línea múltiple - -{% note %} - -**Nota:** Los parámetros y campos de respuesta nuevos se encuentran disponibles para que los desarrolladores los previsualicen. Durante el periodo de vista previa, estos campos de respuesta podrían cambiar sin previo aviso. Por favor, consulta la [publicación del blog](https://developer.github.com/changes/2019-10-03-multi-line-comments) para obtener todos los detalles. - -{% endnote %} - -Utiliza el encabezado de vista previa `comfort-fade` y el parámetro `line` para mostrar los campos compatibles de comentarios de línea múltiple en la respuesta. - -Si utilizas el encabezado de vista previa `comfort-fade`, tu respuesta mostrará: -- Para los comentarios de línea múltiple, los valores de `start_line`, `original_start_line`, `start_side`, `line`, `original_line`, y `side`. -- Para los comentarios de línea sencilla, los valores de `line`, `original_line`, and `side` and a `null` value for `start_line`, `original_start_line`, y `start_side`. - -Si no utilizas el encabezado de vista previa `comfort-fade`, los comentarios de línea múltiple y de línea sencilla aparecerán de la misma manera en la respuesta con un solo atributo de `position`. Tu respuesta mostrará: -- Para los comentarios de línea múltiple, la última línea del rango de comentarios para el atributo `position`. -- Para los comentarios de línea sencilla, es la forma posicionada del diff para referenciar los comentarios del atributo `position`. Para obtener más información, consulta `position` en la tabla de [parámetros de entrada](/v3/pulls/comments/#parameters-2). - -{% endif %} diff --git a/translations/es-XL/data/reusables/pulls/pull_request_access.md b/translations/es-XL/data/reusables/pulls/pull_request_access.md deleted file mode 100644 index baea42915cf1..000000000000 --- a/translations/es-XL/data/reusables/pulls/pull_request_access.md +++ /dev/null @@ -1,5 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} - -Para abrir o actualizar una solicitud de extracción en un repositorio público, debes tener acceso de escritura en la rama origen o la rama principal. Para los repositorios que pertenecen a una organización, debes ser un miembro de la organización dueña de estos para abrir o actualizar una solicitud de extracción. - -{% endif %} diff --git a/translations/es-XL/data/reusables/pulls/pull_request_mergeability.md b/translations/es-XL/data/reusables/pulls/pull_request_mergeability.md deleted file mode 100644 index 4377d52025b8..000000000000 --- a/translations/es-XL/data/reusables/pulls/pull_request_mergeability.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Nota:** Necesitas [solicitar una solicitud de extracción](/v3/pulls/#get-a-pull-request) explícitamente para activar una confirmación de prueba de fusión, la cual verifica la capacidad de fusión de las solicitudes de extracción. Para obtener más información, consulta la sección "[Verificar la capacidad de fusión para las solicitudes de extracción](/v3/git/#checking-mergeability-of-pull-requests)". - -{% endnote %} diff --git a/translations/es-XL/data/reusables/pulls/pullrequests_as_issues.md b/translations/es-XL/data/reusables/pulls/pullrequests_as_issues.md deleted file mode 100644 index 295ed786f8d9..000000000000 --- a/translations/es-XL/data/reusables/pulls/pullrequests_as_issues.md +++ /dev/null @@ -1,7 +0,0 @@ -{% note %} - -**Nota**: la API de REST de GitHub considera cada solicitud de extracción como un informe de problemas, pero no todos los informes de problemas serán una solicitud de extracción. Es por esto que la terminal para los "informes de problemas" podría devolver tanto informes de problemas como solicitudes de extracción en su respuesta. Puedes identificar a las solicitudes de extracción por la clave `pull_request`. - -Toma en cuenta que la `id` de una solicitud de extracción que se devuelve de las terminales de "informes de problemas" será una _issue id_. Para encontrar la id de la solicitud de extracción, utiliza la terminal "[List pull requests](/v3/pulls/#list-pull-requests)". - -{% endnote %} diff --git a/translations/es-XL/data/reusables/reminders/install-slack.md b/translations/es-XL/data/reusables/reminders/install-slack.md deleted file mode 100644 index 689fee47eb8d..000000000000 --- a/translations/es-XL/data/reusables/reminders/install-slack.md +++ /dev/null @@ -1 +0,0 @@ -Si te gustaría instalar Slack en todos tus repositorios, selecciona **Todos los repositorios**. Si quisieras instalar únicamente Slack en los repositorios seleccionados, escoge **Únicamente repositorios seleccionados**. Posteriormente, lee la lista de permisos a los cuales estés dejando acceder a Slack y da clic en **Instalar**. ![Botón de instalar Slack](/assets/images/help/settings/scheduled-reminders-install-slack.png) diff --git a/translations/es-XL/data/reusables/reminders/scheduled-reminders-beta.md b/translations/es-XL/data/reusables/reminders/scheduled-reminders-beta.md deleted file mode 100644 index ba5ad5168118..000000000000 --- a/translations/es-XL/data/reusables/reminders/scheduled-reminders-beta.md +++ /dev/null @@ -1 +0,0 @@ -Los recordatorios programados para solicitudes de extracción se encuentran actualmente en beta y están sujetos a cambios. Para solicitar acceso a la siguiente fase del beta para recordatorios programados, únete a la lista de espera en [Recordatorios Programados de GitHub](https://github.com/features/reminders/signup). diff --git a/translations/es-XL/data/reusables/repositories/actions-new-workflow.md b/translations/es-XL/data/reusables/repositories/actions-new-workflow.md deleted file mode 100644 index e08f44a83bb1..000000000000 --- a/translations/es-XL/data/reusables/repositories/actions-new-workflow.md +++ /dev/null @@ -1,2 +0,0 @@ -1. En la esquina superior izquierda, da clic en **Nuevo flujo de trabajo**. ![Crear un nuevo flujo de trabajo](/assets/images/help/repository/actions-new-workflow.png) - \ No newline at end of file diff --git a/translations/es-XL/data/reusables/repositories/actions-set-up-workflow-template.md b/translations/es-XL/data/reusables/repositories/actions-set-up-workflow-template.md deleted file mode 100644 index 71cd79ac0ca9..000000000000 --- a/translations/es-XL/data/reusables/repositories/actions-set-up-workflow-template.md +++ /dev/null @@ -1 +0,0 @@ -1. Debajo del nombre de la plantilla que deseas utilizar, da clic en **Configurar este flujo de trabajo**. ![Recomendaciones de plantillas de Node.js](/assets/images/help/repository/actions-recommended-workflow-template.png) diff --git a/translations/es-XL/data/reusables/repositories/opt-out-automated-security-updates.md b/translations/es-XL/data/reusables/repositories/opt-out-automated-security-updates.md deleted file mode 100644 index 021444a55c68..000000000000 --- a/translations/es-XL/data/reusables/repositories/opt-out-automated-security-updates.md +++ /dev/null @@ -1,2 +0,0 @@ -1. Debajo de "Actualizaciones de seguridad automatizadas", selecciona o deselecciona **Salirse de las actualizaciones de seguridad automatizadas**. ![Casilla para salirse de las actualizaciones de seguridad automatizadas](/assets/images/help/repository/opt-out-automated-security-updates.png) -2. Haz clic en **Save** (Guardar). diff --git a/translations/es-XL/data/reusables/repositories/opt-out-dependabot-security-updates.md b/translations/es-XL/data/reusables/repositories/opt-out-dependabot-security-updates.md deleted file mode 100644 index 3a68c3c20731..000000000000 --- a/translations/es-XL/data/reusables/repositories/opt-out-dependabot-security-updates.md +++ /dev/null @@ -1 +0,0 @@ -1. To the right of "{% data variables.product.prodname_dependabot_short %} security updates", click **Disable all** or **Enable all**. !["Disable all" or "Enable all" button for {% data variables.product.prodname_dependabot_short %} security updates](/assets/images/help/repository/opt-out-dependabot-security-updates.png) diff --git a/translations/es-XL/data/reusables/repositories/settings-security-and-analysis-tab-beta.md b/translations/es-XL/data/reusables/repositories/settings-security-and-analysis-tab-beta.md deleted file mode 100644 index 8c0ad66562c6..000000000000 --- a/translations/es-XL/data/reusables/repositories/settings-security-and-analysis-tab-beta.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Nota**: La nueva experiencia para administrar la configuración de seguridad y análisis se encuentra en beta y está sujeta a cambios. - -{% endnote %} diff --git a/translations/es-XL/data/reusables/repositories/sidebar-integrations-and-services.md b/translations/es-XL/data/reusables/repositories/sidebar-integrations-and-services.md deleted file mode 100644 index 9da1ec93a8ec..000000000000 --- a/translations/es-XL/data/reusables/repositories/sidebar-integrations-and-services.md +++ /dev/null @@ -1 +0,0 @@ -1. Da clic en **Integración & Servicios**. ![Selección de integración y servicios](/assets/images/help/settings/integrations_and_services_menu.png) diff --git a/translations/es-XL/data/reusables/repositories/troubleshooting-dependency-graph.md b/translations/es-XL/data/reusables/repositories/troubleshooting-dependency-graph.md deleted file mode 100644 index 53752a46c5a8..000000000000 --- a/translations/es-XL/data/reusables/repositories/troubleshooting-dependency-graph.md +++ /dev/null @@ -1 +0,0 @@ -Si tu proyecto tiene dependencias pero éstas no se detectan en tu gráfica, puede que haya un problema con el archivo que contiene las dependencias. Verifica el archivo de tu proyecto para garantizar que se formateó correctamente para el tipo de archivo. diff --git a/translations/es-XL/data/reusables/repositories/you-can-enable-or-disable-security-features.md b/translations/es-XL/data/reusables/repositories/you-can-enable-or-disable-security-features.md deleted file mode 100644 index a595c9b6b79d..000000000000 --- a/translations/es-XL/data/reusables/repositories/you-can-enable-or-disable-security-features.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Nota**: El beta de escaneo de código y de secretos incluye una nueva experiencia para administrar la configuración de análisis y seguridad. Si estás participando en el beta, omite los siguientes pasos y consulta la sección "[Administrar la configuración de análisis y seguridad para tu repositorio](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository)". - -{% endnote %} diff --git a/translations/es-XL/data/reusables/repositories/you-can-manage-access-to-security-alerts.md b/translations/es-XL/data/reusables/repositories/you-can-manage-access-to-security-alerts.md deleted file mode 100644 index 089feb480f1b..000000000000 --- a/translations/es-XL/data/reusables/repositories/you-can-manage-access-to-security-alerts.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Nota**: El beta de escaneo de código y de secretos incluye una nueva experiencia para administrar a las personas y equipos con acceso a las alertas de seguridad. Si estás participando en el beta, omite los siguientes pasos y consulta la sección "[Administrar la configuración de análisis y seguridad para tu repositorio](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository#granting-access-to-github-dependabot-alerts)". - -{% endnote %} diff --git a/translations/es-XL/data/reusables/saml/scim-unavailable-for-enterprise-accounts.md b/translations/es-XL/data/reusables/saml/scim-unavailable-for-enterprise-accounts.md deleted file mode 100644 index 6184f4e4bfa7..000000000000 --- a/translations/es-XL/data/reusables/saml/scim-unavailable-for-enterprise-accounts.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Nota**: la compatibilidad con SCIM no está disponible para cuentas empresariales en {% data variables.product.prodname_dotcom %} por el momento. - -{% endnote %} diff --git a/translations/es-XL/data/reusables/scim/complete_user_example.md b/translations/es-XL/data/reusables/scim/complete_user_example.md deleted file mode 100644 index e444e167ecc8..000000000000 --- a/translations/es-XL/data/reusables/scim/complete_user_example.md +++ /dev/null @@ -1,7 +0,0 @@ -<%= json \ "schemas":["urn:ietf:params:scim:schemas:core:2.0:User"], "userName":"mona.octocat@okta.example.com", "name":{ "familyName":"Octocat", "givenName":"Mona" }, "emails":[ - { - "value":"mona.octocat@okta.example.com", - "type":"work", - "primary": true - } - ] %> diff --git a/translations/es-XL/data/reusables/scim/user_required_values.md b/translations/es-XL/data/reusables/scim/user_required_values.md deleted file mode 100644 index 8ce2892d0662..000000000000 --- a/translations/es-XL/data/reusables/scim/user_required_values.md +++ /dev/null @@ -1 +0,0 @@ -De acuerdo a como se muestra en el siguiente ejemplo, debes proporcionar por lo menos estos valores requeridos para el usuario: `userName`, `name`, y `emails`. diff --git a/translations/es-XL/data/reusables/search/exact-match-beta.md b/translations/es-XL/data/reusables/search/exact-match-beta.md deleted file mode 100644 index c8c8b881edcf..000000000000 --- a/translations/es-XL/data/reusables/search/exact-match-beta.md +++ /dev/null @@ -1 +0,0 @@ -Las coincidencias exactas en la búsqueda de código es una característica que se encuentra actualmente en fase beta y se proporciona a una cantidad limitada de usuarios y repositorios en {% data variables.product.prodname_dotcom %}, y está sujeta a cambios. diff --git a/translations/es-XL/data/reusables/search/exact-match.md b/translations/es-XL/data/reusables/search/exact-match.md deleted file mode 100644 index 451290509d7d..000000000000 --- a/translations/es-XL/data/reusables/search/exact-match.md +++ /dev/null @@ -1 +0,0 @@ -Puedes buscar coincidencias exactas en el código, las cuales incluyen cualquier combinación de letras, números y símbolos. diff --git a/translations/es-XL/data/reusables/shortdesc/2fa.md b/translations/es-XL/data/reusables/shortdesc/2fa.md deleted file mode 100644 index 4ce2303870cc..000000000000 --- a/translations/es-XL/data/reusables/shortdesc/2fa.md +++ /dev/null @@ -1 +0,0 @@ -Si tienes una configuración de autenticación de dos factores, la autenticación básica para esta terminal requerirá que utilices una contraseña de única vez (OTP) y tu nombre de usuario y contraseña en vez de los tokens. Para obtener más información, consulta la sección "[Trabajar con autenticaciones de dos factores](/v3/auth/#working-with-two-factor-authentication)". \ No newline at end of file diff --git a/translations/es-XL/data/reusables/shortdesc/content_reference_body.md b/translations/es-XL/data/reusables/shortdesc/content_reference_body.md deleted file mode 100644 index 4b89190d30bf..000000000000 --- a/translations/es-XL/data/reusables/shortdesc/content_reference_body.md +++ /dev/null @@ -1 +0,0 @@ -You have used an email that already exists for the user_email_uniq field.\n \## DETAILS:\n\nThe (email)=(Octocat@github.com) already exists.\n\n The error was found in core/models.py in get_or_create_user at line 62.\n\n\ self.save() \ No newline at end of file diff --git a/translations/es-XL/data/reusables/shortdesc/content_reference_title.md b/translations/es-XL/data/reusables/shortdesc/content_reference_title.md deleted file mode 100644 index 531d7aabf6de..000000000000 --- a/translations/es-XL/data/reusables/shortdesc/content_reference_title.md +++ /dev/null @@ -1 +0,0 @@ -[A-1234] Error found in core/models.py file \ No newline at end of file diff --git a/translations/es-XL/data/reusables/sponsors/email-submit-bank-info.md b/translations/es-XL/data/reusables/sponsors/email-submit-bank-info.md deleted file mode 100644 index 287ad3747d8e..000000000000 --- a/translations/es-XL/data/reusables/sponsors/email-submit-bank-info.md +++ /dev/null @@ -1 +0,0 @@ -Luego de unirte a {% data variables.product.prodname_sponsors %}, deberás recibir un correo electrónico con instrucciones para enviar tu información bancaria y fiscal. diff --git a/translations/es-XL/data/reusables/sponsors/matching-period.md b/translations/es-XL/data/reusables/sponsors/matching-period.md deleted file mode 100644 index 3443c937b188..000000000000 --- a/translations/es-XL/data/reusables/sponsors/matching-period.md +++ /dev/null @@ -1 +0,0 @@ -Los patrocinios pueden ser elegibles para consideración dentro de las limitaciones aquí expuestas durante el primer año en el que una persona participe en {% data variables.product.prodname_sponsors %}. La elegibilidad para ser considerado en el programa comienza después de que {% data variables.product.company_short %} admita una cuenta en {% data variables.product.prodname_sponsors %}, quien publicará el perfil de patrocinio para dicha cuenta. El periodo de consideraciones no puede extenderse por razón alguna. Si sales de {% data variables.product.prodname_sponsors %} y te vuelves a unir después, el tiempo que pase entre tus periodos de participación podría descontarse de tu periodo de consideración, o bien, este periodo podría caducar. diff --git a/translations/es-XL/data/reusables/sponsors/org-sponsorship-dashboard.md b/translations/es-XL/data/reusables/sponsors/org-sponsorship-dashboard.md deleted file mode 100644 index d6ab980b4fd5..000000000000 --- a/translations/es-XL/data/reusables/sponsors/org-sponsorship-dashboard.md +++ /dev/null @@ -1 +0,0 @@ -1. A la derecha de tu organización, da clic en **Tablero de patrocinio**. ![Botón de tablero de patrocinio](/assets/images/help/sponsors/org-sponsorship-dashboard.png) diff --git a/translations/es-XL/data/reusables/support/advanced-security-support-terms-differ.md b/translations/es-XL/data/reusables/support/advanced-security-support-terms-differ.md deleted file mode 100644 index d111b7816910..000000000000 --- a/translations/es-XL/data/reusables/support/advanced-security-support-terms-differ.md +++ /dev/null @@ -1 +0,0 @@ -Las condiciones de este artículo no aplican al soporte para {% data variables.product.prodname_advanced_security %}. Para obtener más información, consulta la sección "[Acerca del soporte para {% data variables.product.prodname_advanced_security %}](/enterprise/admin/enterprise-support/about-support-for-advanced-security)". diff --git a/translations/es-XL/data/reusables/support/ghec-premium-priority-high-description.md b/translations/es-XL/data/reusables/support/ghec-premium-priority-high-description.md deleted file mode 100644 index 1cc5e9238843..000000000000 --- a/translations/es-XL/data/reusables/support/ghec-premium-priority-high-description.md +++ /dev/null @@ -1 +0,0 @@ -Los problemas de cuenta o de seguridad con tu organización o empresa en {% data variables.product.prodname_ghe_cloud %} están causando un impacto limitado en tu negocio. \ No newline at end of file diff --git a/translations/es-XL/data/reusables/support/ghec-premium-priority-high-examples.md b/translations/es-XL/data/reusables/support/ghec-premium-priority-high-examples.md deleted file mode 100644 index d986303dc88d..000000000000 --- a/translations/es-XL/data/reusables/support/ghec-premium-priority-high-examples.md +++ /dev/null @@ -1 +0,0 @@ -
    • Un propietario de organización o empresa borró una organización sin querer
    • Un miembro de una organización o empresa subió datos sensibles en una confirmación, informe de problemas, solicitud de extracción o adjunto en el informe de problemas
    \ No newline at end of file diff --git a/translations/es-XL/data/reusables/support/ghec-premium-priority-low-description.md b/translations/es-XL/data/reusables/support/ghec-premium-priority-low-description.md deleted file mode 100644 index 928dd26aca78..000000000000 --- a/translations/es-XL/data/reusables/support/ghec-premium-priority-low-description.md +++ /dev/null @@ -1 +0,0 @@ -Tienes una pregunta o sugerencia sobre tu organización o empresa en {% data variables.product.prodname_ghe_cloud %} que no es urgente, o no bloquea la productividad de tu equipo en alguna otra forma. \ No newline at end of file diff --git a/translations/es-XL/data/reusables/support/ghec-premium-priority-low-examples.md b/translations/es-XL/data/reusables/support/ghec-premium-priority-low-examples.md deleted file mode 100644 index 5cdf41af987d..000000000000 --- a/translations/es-XL/data/reusables/support/ghec-premium-priority-low-examples.md +++ /dev/null @@ -1 +0,0 @@ -
    • Uso excesivo de recursos para tu organización o empresa
    • Solicitudes de verificaciones de estado
    • Ayuda con el uso de Gists, notificaciones, wikis, {% data variables.product.prodname_pages %}, {% data variables.product.prodname_desktop %}, Atom, u otros servicios periféricos o características en tu organización o empresa
    • Solicitudes de características
    • Retroalimentación de producto
    \ No newline at end of file diff --git a/translations/es-XL/data/reusables/support/ghec-premium-priority-normal-description.md b/translations/es-XL/data/reusables/support/ghec-premium-priority-normal-description.md deleted file mode 100644 index 56cbe609e954..000000000000 --- a/translations/es-XL/data/reusables/support/ghec-premium-priority-normal-description.md +++ /dev/null @@ -1 +0,0 @@ -Los miembros de tu organización o empresa en {% data variables.product.prodname_ghe_cloud %} están experimentando problemas moderados o limitados con {% data variables.product.prodname_dotcom_the_website %}, o tienes preocupaciones o dudas generales sobre tu organización o empresa. \ No newline at end of file diff --git a/translations/es-XL/data/reusables/support/ghec-premium-priority-normal-examples.md b/translations/es-XL/data/reusables/support/ghec-premium-priority-normal-examples.md deleted file mode 100644 index 6c3fea62622d..000000000000 --- a/translations/es-XL/data/reusables/support/ghec-premium-priority-normal-examples.md +++ /dev/null @@ -1 +0,0 @@ -
    • Preguntas sobre el uso de las API o de las características para tu organización o empresa
    • Problemas con herramientas para migración de datos de una organización que proporciona {% data variables.product.company_short %}
    • Características relacionadas con que tu organización o empresa no funcione como se espera
    • Preguntas generales de seguridad de tu organización o empresa
    \ No newline at end of file diff --git a/translations/es-XL/data/reusables/support/ghec-premium-priority-urgent-description.md b/translations/es-XL/data/reusables/support/ghec-premium-priority-urgent-description.md deleted file mode 100644 index b2363b300225..000000000000 --- a/translations/es-XL/data/reusables/support/ghec-premium-priority-urgent-description.md +++ /dev/null @@ -1 +0,0 @@ -Los flujos de trabajo de producción para tu organización o empresa en {% data variables.product.prodname_ghe_cloud %} fallan debido a los errores o suspensiones de servicios críticos, y las fallas impactan directamente a la operación de tu negocio. \ No newline at end of file diff --git a/translations/es-XL/data/reusables/support/ghec-premium-priority-urgent-examples.md b/translations/es-XL/data/reusables/support/ghec-premium-priority-urgent-examples.md deleted file mode 100644 index 58edd771951b..000000000000 --- a/translations/es-XL/data/reusables/support/ghec-premium-priority-urgent-examples.md +++ /dev/null @@ -1 +0,0 @@ -
    • Los errores o suspenciones en {% data variables.product.prodname_dotcom_the_website %} afectan la funcionalidad principal de Git o de las aplicaciones web para todos los miembros de tu organización o empresa
    \ No newline at end of file diff --git a/translations/es-XL/data/reusables/support/github-one-premium-plus-response-times-differ.md b/translations/es-XL/data/reusables/support/github-one-premium-plus-response-times-differ.md deleted file mode 100644 index 09bf5f7eef34..000000000000 --- a/translations/es-XL/data/reusables/support/github-one-premium-plus-response-times-differ.md +++ /dev/null @@ -1 +0,0 @@ -Para clientes que compran {% data variables.product.prodname_ghe_one %}, el soporte para {% data variables.product.prodname_actions %}, {% data variables.product.prodname_insights %}, {% data variables.product.prodname_learning %}, y {% data variables.product.prodname_registry %} se encuentra disponible las 24 horas del día, 5 días por semana, excluyendo fines de semana y días festivos de los EE.UU. El tiempo de respuesta estándar es de 1 día hábil. diff --git a/translations/es-XL/data/reusables/support/github-one-premium-plus-sla-differs.md b/translations/es-XL/data/reusables/support/github-one-premium-plus-sla-differs.md deleted file mode 100644 index 8fc033c427d5..000000000000 --- a/translations/es-XL/data/reusables/support/github-one-premium-plus-sla-differs.md +++ /dev/null @@ -1 +0,0 @@ -Para clientes que compran {% data variables.product.prodname_ghe_one %}, el acuerdo de nivel de servicio para el tiempo de respuesta inicial de {% data variables.contact.premium_support %} no aplica en tickets para {% data variables.product.prodname_actions %}, {% data variables.product.prodname_insights %}, {% data variables.product.prodname_learning %}, o {% data variables.product.prodname_registry %}. \ No newline at end of file diff --git a/translations/es-XL/data/reusables/support/github-one-premium-plus-support-terms-differ.md b/translations/es-XL/data/reusables/support/github-one-premium-plus-support-terms-differ.md deleted file mode 100644 index 37fb8a98a32f..000000000000 --- a/translations/es-XL/data/reusables/support/github-one-premium-plus-support-terms-differ.md +++ /dev/null @@ -1 +0,0 @@ -Para clientes que compran {% data variables.product.prodname_ghe_one %}, los términos de soporta para el {% data variables.product.premium_plus_support_plan %} difieren para {% data variables.product.prodname_actions %}, {% data variables.product.prodname_insights %}, {% data variables.product.prodname_learning %}, y {% data variables.product.prodname_registry %}. \ No newline at end of file diff --git a/translations/es-XL/data/reusables/teams/team-sync.md b/translations/es-XL/data/reusables/teams/team-sync.md deleted file mode 100644 index f1bf7d7bba30..000000000000 --- a/translations/es-XL/data/reusables/teams/team-sync.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - - **Nota:** Cuando configuras la sincornizacion de equipos para un equipo con el proveedor de identidad (IdP) de tu organización, verás un error si intentas utilizar la API para hacer cambios en la membrecía de dicho equipo. Si tienes acceso para administrar las membrecías de usuario en tu IdP, puedes administrar la membrecía del equipo de GitHub a través de tu proveedor de identidad, lo cual agrega y elimina automáticamente a los miembros en una organización. Para obtener más información, consulta la sección "[Sincronizar equipos entre tu proveedor de identidad y GitHub](/articles/synchronizing-teams-between-your-identity-provider-and-github/)". - -{% endnote %} -{% endif %} diff --git a/translations/es-XL/data/reusables/user-settings/throttling-notice.md b/translations/es-XL/data/reusables/user-settings/throttling-notice.md deleted file mode 100644 index 91c17b8fe997..000000000000 --- a/translations/es-XL/data/reusables/user-settings/throttling-notice.md +++ /dev/null @@ -1 +0,0 @@ -Esta terminal activa las [notificaciones](/articles/about-notifications/). Si creas contenido muy rápidamente utilizando esta terminal, podría considerarse como abuso del límite de tasa. Consulta la sección "[Abuso de límites de tasa](/v3/#abuse-rate-limits)"{% if currentVersion == "free-pro-team@latest" %} y "[Lidiar con los abusos de límite de tasa](/v3/guides/best-practices-for-integrators/#dealing-with-abuse-rate-limits)"{% endif %} para obtener más detalles. diff --git a/translations/es-XL/data/reusables/webhooks/interactive_component_short_desc.md b/translations/es-XL/data/reusables/webhooks/interactive_component_short_desc.md deleted file mode 100644 index 3cd90810286f..000000000000 --- a/translations/es-XL/data/reusables/webhooks/interactive_component_short_desc.md +++ /dev/null @@ -1 +0,0 @@ -Se activa cuando un usuario da clic en un elemento interactivo que se creó utilizando el {% data variables.product.prodname_component_kit %}. Las {% data variables.product.prodname_github_app %}s se suscriben automáticamente al evento `interactive_component` para que no haya necesidad de suscribirse manualmente a él. A diferencia de otros eventos de webhook, el evento `interactive_component` solo se envía a la {% data variables.product.prodname_github_app %} con la cual interactuó el usuario a través de un componente interactivo, tal como el comentario estructurado. Las {% data variables.product.prodname_oauth_app %}s no pueden suscribirse al evento `interactive_component` y las otras {% data variables.product.prodname_github_app %}s que se instalaron no recibirán el evento de webhook aún si se suscriben al `interactive_component`. \ No newline at end of file diff --git a/translations/es-XL/data/reusables/webhooks/issue_comment_event_api_properties.md b/translations/es-XL/data/reusables/webhooks/issue_comment_event_api_properties.md deleted file mode 100644 index 3f5f46d78dd1..000000000000 --- a/translations/es-XL/data/reusables/webhooks/issue_comment_event_api_properties.md +++ /dev/null @@ -1,3 +0,0 @@ -| Clave | Tipo | Descripción | -| -------- | ----------- | --------------------------------------------------------------- | -| `Acción` | `secuencia` | La acción que se realizó en el comentario. Puede ser `created`. | \ No newline at end of file diff --git a/translations/es-XL/data/reusables/webhooks/package_short_desc.md b/translations/es-XL/data/reusables/webhooks/package_short_desc.md deleted file mode 100644 index 965e6d3e795d..000000000000 --- a/translations/es-XL/data/reusables/webhooks/package_short_desc.md +++ /dev/null @@ -1 +0,0 @@ -La actividad relacionada con GitHub Packages. {% data reusables.webhooks.action_type_desc %} Para obtener más información, consulta "[GitHub Packages](/packages)". \ No newline at end of file diff --git a/translations/es-XL/data/reusables/webhooks/pull_request_forked_repos_link.md b/translations/es-XL/data/reusables/webhooks/pull_request_forked_repos_link.md deleted file mode 100644 index f7381169f5a0..000000000000 --- a/translations/es-XL/data/reusables/webhooks/pull_request_forked_repos_link.md +++ /dev/null @@ -1 +0,0 @@ -Consulta [más adelante](#pull-request-events-for-forked-repositories) para aprender cómo funciona este evento con los repositorios bifurcados. \ No newline at end of file diff --git a/translations/es-XL/data/variables/ant-man.yml b/translations/es-XL/data/variables/ant-man.yml deleted file mode 100644 index 1aac85f54bf8..000000000000 --- a/translations/es-XL/data/variables/ant-man.yml +++ /dev/null @@ -1,3 +0,0 @@ ---- -deployments-ant-man-parameter-note: >- - {% if currentVersion == "free-pro-team@latest" %}**Nota:** Este parámetro requiere que utilices el tipo de medios personalizado de [`application/vnd.github.ant-man-preview+json`](/v3/previews/#enhanced-deployments).{% endif %} diff --git a/translations/es-XL/data/variables/cloud-9.yml b/translations/es-XL/data/variables/cloud-9.yml deleted file mode 100644 index 2e8442b9abbd..000000000000 --- a/translations/es-XL/data/variables/cloud-9.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: La API de SCIM diff --git a/translations/es-XL/data/variables/giant-sentry-fist.yml b/translations/es-XL/data/variables/giant-sentry-fist.yml deleted file mode 100644 index 89c0794ef826..000000000000 --- a/translations/es-XL/data/variables/giant-sentry-fist.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: La API de Bloqueo de Usuarios diff --git a/translations/es-XL/data/variables/korra.yml b/translations/es-XL/data/variables/korra.yml deleted file mode 100644 index 9118568c7b26..000000000000 --- a/translations/es-XL/data/variables/korra.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: La API de Membreciá de Organización diff --git a/translations/es-XL/data/variables/mercy.yml b/translations/es-XL/data/variables/mercy.yml deleted file mode 100644 index 7b9e2f9c267a..000000000000 --- a/translations/es-XL/data/variables/mercy.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: La propiedad de `topics` para los repositorios diff --git a/translations/es-XL/data/variables/mister-fantastic.yml b/translations/es-XL/data/variables/mister-fantastic.yml deleted file mode 100644 index c917b2394021..000000000000 --- a/translations/es-XL/data/variables/mister-fantastic.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: La API de GitHub Pages diff --git a/translations/es-XL/data/variables/performed-via-integration.yml b/translations/es-XL/data/variables/performed-via-integration.yml deleted file mode 100644 index a7b47125d79f..000000000000 --- a/translations/es-XL/data/variables/performed-via-integration.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: Un objeto adicional de `performed_via_github_app` en la carga útil del informe de problemas diff --git a/translations/es-XL/data/variables/valkyrie.yml b/translations/es-XL/data/variables/valkyrie.yml deleted file mode 100644 index 508e3cfb08f8..000000000000 --- a/translations/es-XL/data/variables/valkyrie.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: La API de GitHub Marketplace diff --git a/translations/ja-JP/content/actions/building-and-testing-code-with-continuous-integration/about-continuous-integration.md b/translations/ja-JP/content/actions/building-and-testing-code-with-continuous-integration/about-continuous-integration.md deleted file mode 100644 index d4a5d8d3eeb7..000000000000 --- a/translations/ja-JP/content/actions/building-and-testing-code-with-continuous-integration/about-continuous-integration.md +++ /dev/null @@ -1,62 +0,0 @@ ---- -title: 継続的インテグレーションについて -intro: '{% data variables.product.prodname_actions %} で {% data variables.product.prodname_dotcom %} リポジトリにカスタム継続的インテグレーション（CI）ワークフローと継続的デプロイメント（CD）ワークフローを直接作成できます。' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/about-continuous-integration - - /github/automating-your-workflow-with-github-actions/about-continuous-integration - - /actions/automating-your-workflow-with-github-actions/about-continuous-integration -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -### 継続的インテグレーションについて - -継続的インテグレーション (CI) とは、ソフトウェアの開発においてコードを頻繁に共有リポジトリにコミットする手法のことです。 コードをコミットする頻度が高いほどエラーの検出が早くなり、開発者がエラーの原因を見つけようとしてデバッグする必要性も減ります。 コードの更新が頻繁であれば、ソフトウェア開発チームの他のメンバーによる変更をマージするのも、それだけ容易になります。 開発者がコードの記述にばかり時間をとられ、エラーのデバッグやマージコンフリクトの解決にかける時間が少ないときに威力を発揮します。 - -コードをリポジトリにコミットするとき、コミットによってエラーが発生しないように、コードのビルドとテストを継続的に行うことができます。 テストには、コードの文法チェッカー (スタイルフォーマットをチェックする)、セキュリティチェック、コード網羅率、機能テスト、その他のカスタムチェックを含めることができます。 - -コードをビルドしてテストするには、サーバーが必要です。 ローカルでアップデートのビルドとテストを行ってからコードをリポジトリにプッシュする方法もありますし、リポジトリ での新しいコードのコミットをチェックするCIサーバーを使用する方法もあります。 - -### {% data variables.product.prodname_actions %} を使用する継続的インテグレーションについて - -{% data variables.product.prodname_actions %} を利用した CI では、リポジトリ内のコードをビルドしてテストを実行できるワークフローが利用できます。 ワークフローは、{% data variables.product.prodname_dotcom %} でホストされている仮想マシン、または自分がホストしているマシンで実行できます。 詳しい情報については、「[{% data variables.product.prodname_dotcom %} ホストランナーの仮想環境](/actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)」および「[セルフホストランナーについて](/actions/automating-your-workflow-with-github-actions/about-self-hosted-runners)」を参照してください。 - -CI ワークフローは、{% data variables.product.product_name %} イベントが発生したとき（たとえば、新しいコードがリポジトリにプッシュされたとき）、設定されたスケジュールで、またはリポジトリディスパッチ Webhook を使用して外部イベントが発生したときに実行するように設定できます。 - -{% data variables.product.product_name %} は CI テストを実行して、プルリクエストで各テストの結果を提供するため、ブランチの変更によってエラーが発生したかどうかを確認できます。 ワークフローのテストがすべて成功すると、プッシュした変更をチームメンバーがレビューできるように、またはマージできるようになります。 テストが失敗した場合は、いずれかの変更がその原因になっている可能性があります。 - -リポジトリに CI を設定すると、{% data variables.product.product_name %} がリポジトリ内のコードを分析し、リポジトリ内の言語とフレームワークに基づいて CI ワークフローを推奨します。 たとえば、[Node.js](https://nodejs.org/en/) を使用する場合、{% data variables.product.product_name %} は、Node.js パッケージをインストールしてテストを実行するテンプレートファイルを提案します。 {% data variables.product.product_name %} によって提案された CI ワークフローテンプレートを使用しても、提案されたテンプレートをカスタマイズしてもかまいませんし、独自のカスタムワークフローファイルを作成して CI テストを実行することもできます。 - -![提案された継続的インテグレーションテンプレートのスクリーンショット](/assets/images/help/repository/ci-with-actions-template-picker.png) - -プロジェクトの CI ワークフローの設定だけでなく、{% data variables.product.prodname_actions %} を使用してソフトウェア開発のライフサイクル全体でワークフローを作成することもできます。 たとえば、アクションを使用してプロジェクトをデプロイ、パッケージ、またはリリースすることが可能です。 詳しい情報については、「[{% data variables.product.prodname_actions %} について](/articles/about-github-actions)」を参照してください。 - -一般的な用語の定義については「[{% data variables.product.prodname_actions %} の中核的概念](/github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)」を参照してください。 - -### サポートされている言語 - -{% data variables.product.product_name %} では、各種言語およびフレームワークに応じて CI ワークフローテンプレートが提供されます。 - -詳細は「[ワークフローの設定](/articles/configuring-a-workflow)」を参照してください。 - -### ワークフロー実行の通知 - -{% data reusables.repositories.workflow-notifications %} - -### ワークフロー実行のためのステータスバッジ - -{% data reusables.repositories.actions-workflow-status-badge-into %} - -詳細は「[ワークフローの設定](/articles/configuring-a-workflow)」を参照してください。 - -### 参考リンク - -- 「[{% data variables.product.prodname_actions %} を使用して継続的インテグレーションを設定する](/articles/setting-up-continuous-integration-using-github-actions)」 -{% if currentVersion == "free-pro-team@latest" %} -- 「[{% data variables.product.prodname_actions %} の支払いを管理する](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)」 -{% endif %} diff --git a/translations/ja-JP/content/actions/building-and-testing-code-with-continuous-integration/index.md b/translations/ja-JP/content/actions/building-and-testing-code-with-continuous-integration/index.md deleted file mode 100644 index 8eb8f2d98a10..000000000000 --- a/translations/ja-JP/content/actions/building-and-testing-code-with-continuous-integration/index.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: 継続的インテグレーションでのコードのビルドとテスト -shortTitle: 継続的インテグレーション -intro: '{% data variables.product.prodname_actions %}を使って、カスタムの継続的インテグレーション（CI）及び継続的デプロイメント（CD）ワークフローをリポジトリ内に作成できます。' -redirect_from: - - /articles/setting-up-continuous-integration-on-github - - /github/automating-your-workflow-with-github-actions/setting-up-continuous-integration-on-github - - /github/automating-your-workflow-with-github-actions/creating-continuous-integration-workflows - - /actions/automating-your-workflow-with-github-actions/creating-continuous-integration-workflows -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -{% link_in_list /about-continuous-integration %} -{% link_in_list /setting-up-continuous-integration-using-github-actions %} diff --git a/translations/ja-JP/content/actions/building-and-testing-code-with-continuous-integration/setting-up-continuous-integration-using-github-actions.md b/translations/ja-JP/content/actions/building-and-testing-code-with-continuous-integration/setting-up-continuous-integration-using-github-actions.md deleted file mode 100644 index 47e6a628fe4d..000000000000 --- a/translations/ja-JP/content/actions/building-and-testing-code-with-continuous-integration/setting-up-continuous-integration-using-github-actions.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: GitHub Actionsを使用して継続的インテグレーションを設定する -intro: 使用したい言語とツールに一致するワークフローテンプレートを使用して、プロジェクトに継続的インテグレーションを設定することができます。 -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/setting-up-continuous-integration-using-github-actions - - /github/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions - - /actions/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -リポジトリへの書き込み権限があるユーザなら誰でも {% data variables.product.prodname_actions %} を使用して継続的インテグレーション (CI) を設定することができます。 - -CIを設定すると、必要に応じてワークフローをカスタマイズすることができます。 - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -3. 使用したい言語とツールに一致するテンプレートを探し、[**Set up this workflow**] をクリックします。 ![[Setup workflow] ボタン](/assets/images/help/repository/setup-workflow-button.png) -5. [**Start commit**] をクリックします。 ![[Start commit]ボタン](/assets/images/help/repository/start-commit.png) -{% data reusables.files.write_commit_message %} -{% data reusables.files.choose_commit_branch %} -{% data reusables.files.propose_new_file %} - -リポジトリへのプッシュを実行すると、{% data variables.product.prodname_dotcom %}で実行された継続的インテグレーションワークフローのステータスと詳細ログを追跡し、カスタマイズした通知を受け取ることができます。 詳しい情報については、「[通知を設定する](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)」及び「[ワークフローの実行の管理](/articles/managing-a-workflow-run)」を参照してください。 - -{% data reusables.repositories.actions-workflow-status-badge-into %} - -詳細は「[ワークフローの設定](/articles/configuring-a-workflow)」を参照してください。 - -### 参考リンク - -- [継続的インテグレーションについて](/articles/about-continuous-integration) -- "[ワークフロー実行の管理](/articles/managing-a-workflow-run)" -{% if currentVersion == "free-pro-team@latest" %} -- 「[{% data variables.product.prodname_actions %} の支払いを管理する](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)」 -{% endif %} diff --git a/translations/ja-JP/content/actions/configuring-and-managing-workflows/about-service-containers.md b/translations/ja-JP/content/actions/configuring-and-managing-workflows/about-service-containers.md deleted file mode 100644 index 9ecafd9b47c6..000000000000 --- a/translations/ja-JP/content/actions/configuring-and-managing-workflows/about-service-containers.md +++ /dev/null @@ -1,116 +0,0 @@ ---- -title: サービスコンテナについて -intro: サービスコンテナを使って、データベース、Webサービス、メモリキャッシュ、あるいはその他のツールをワークフローに接続できます。 -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/about-service-containers -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -### サービスコンテナについて - -サービスコンテナは、ワークフロー中でアプリケーションをテストもしくは運用するのに必要になるかもしれないサービスをホストするための、シンプルでポータブルな方法を提供するDockerコンテナです。 たとえば、ワークフローでデータベースやメモリキャッシュへのアクセスを必要とする結合テストを実行する必要があるかもしれません。 - -サービスコンテナは、ワークフロー中のそれぞれのジョブに対して設定できます。 {% data variables.product.prodname_dotcom %}は新しいDockerコンテナをワークフロー中で設定された各サービスに対して作成し、ジョブが完了したときにそのサービスコンテナを破棄します。 ジョブ中のステップは、同じジョブの一部であるすべてのサービスコンテナと通信できます。 - -{% data reusables.github-actions.docker-container-os-support %} - -### サービスコンテナとの通信 - -ワークフロー中のジョブは、直接ランナーマシン上で実行するようにも、Dockerコンテナ中で実行するようにも設定できます。 ジョブと、ジョブのサービスコンテナとの通信は、ジョブがランナーマシン上で直接実行されているか、コンテナ内で実行されているかによって異なります。 - -#### コンテナ内でのジョブの実行 - -コンテナ内でジョブを実行する場合、{% data variables.product.prodname_dotcom %}はDockerのユーザー定義ブリッジネットワークを使ってサービスコンテナをジョブに接続します。 詳しい情報についてはDockerのドキュメンテーションの「[ブリッジネットワークの利用](https://docs.docker.com/network/bridge/)」を参照してください。 - -コンテナ内でジョブとサービスを実行すれば、ネットワークアクセスはシンプルになります。 サービスコンテナへは、ワークフロー中で設定したラベルを使ってアクセスできます。 サービスコンテナのホスト名は、自動的にラベル名にマップされます。 たとえば`redis`というラベルでサービスコンテナを作成したなら、そのサービスコンテナのホスト名は`redis`になります。 - -サービスコンテナでポートを設定する必要はありません。 デフォルトで、すべてのコンテナは同じDockerネットワークの一部となってお互いにすべてのポートを公開し合い、Dockerネットワークの外部へはポートは公開されません。 - -#### ランナーマシン上でのジョブの実行 - -ジョブをランナーマシン上で直接実行する場合、サービスコンテナには`localhost:`もしくは`127.0.0.1:`を使ってアクセスできます。 {% data variables.product.prodname_dotcom %}は、サービスコンテナからDockerホストへの通信を可能にするよう、コンテナネットワークを設定します。 - -ジョブがランナーマシン上で直接実行されている場合、Dockerコンテナ内で実行されているサービスは、ランナー上で実行しているジョブに対してデフォルトではポートを公開しません。 サービスコンテナ上のポートは、Dockerホストに対してマップする必要があります。 詳しい情報については「[Dockerホストとサービスコンテナのポートのマッピング](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)」を参照してください。 - -### サービスコンテナの作成 - -`services`キーワードを使って、ワークフロー内のジョブの一部であるサービスコンテナを作成できます。 詳しい情報については[`jobs..services`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idservices)を参照してください。 - -以下の例は、`container-job`というジョブの中に`redis`というサービスを作成します。 この例でのDockerホストは`node:10.18-jessie`コンテナです。 - -{% raw %} -```yaml -name: Redis container example -on: push - -jobs: - # コンテナジョブのラベル - container-job: - # コンテナはLinuxベースのオペレｰ手イングシステム内で実行する - runs-on: ubuntu-latest - # `container-job`が実行されるDocker Hubイメージ - container: node:10.18-jessie - - # `container-job`と実行されるサービスコンテナ - services: - # サービスコンテナへのアクセスに使われるラベル - redis: - # Docker Hubのイメージ - image: redis -``` -{% endraw %} - -### Dockerホストとサービスコンテナのポートのマッピング - -ジョブがDockerコンテナ内で実行されるなら、ポートをホストあるいはサービスコンテナにマップする必要はありません。 ジョブがランナーマシン上で直接実行されるなら、必要なサービスコンテナのポートはホストランナーマシンのポートにマップしなければなりません。 - -サービスコンテナのポートは、`ports`キーワードを使ってDockerホストにマップできます。 詳しい情報については[`jobs..services`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idservices)を参照してください。 - -| `ports`の値 | 説明 | -| ------------- | ------------------------------------------------- | -| `8080:80` | コンテナのTCPのポート80をDockerホストのポート8080にマップします。 | -| `8080:80/udp` | コンテナのUDPポート80をDockerホストのポート8080にマップします。 | -| `8080/udp` | コンテナでランダムに選択したUDPポートをDockerホストのUDPポート8080にマップします。 | - -`ports`キーワードを使ってポートをマップする場合、{% data variables.product.prodname_dotcom %}は`--publish`コマンドを使ってコンテナのポートをDockerホストに公開します。 詳しい情報についてはDockerのドキュメンテーションの「[Dockerコンテナのネットワーキング](https://docs.docker.com/config/containers/container-networking/)」を参照してください。 - -Dockerホストのポートを指定して、コンテナのポートを指定しなかった場合、コンテナのポートは空いているポートにランダムに割り当てられます。 {% data variables.product.prodname_dotcom %}は割り当てられたコンテナのポートをサービスコンテナのコンテキストに設定します。 たとえば`redis`サービスコンテナに対し、Dockerホストのポート5432を設定したなら、対応するコンテナのポートには`job.services.redis.ports[5432]`コンテキストを使ってアクセスできます。 詳しい情報については、「[{% data variables.product.prodname_actions %} のコンテキストと式構文](/actions/reference/context-and-expression-syntax-for-github-actions#job-context)」を参照してください。 - -#### Redisのポートのマッピングの例 - -以下の例は、サービスコンテナ`redis`のポート6379を、Dockerホストのポート6379にマップします。 - -{% raw %} -```yaml -name: Redis Service Example -on: push - -jobs: - # コンテナジョブのラベル - runner-job: - # サービスコンテナもしくはコンテナジョブの利用の際はLinux環境を使わなければならない - runs-on: ubuntu-latest - - # `runner-job`と実行するサービスコンテナ - services: - # サービスコンテナへのアクセスに使われるラベル - redis: - # Docker Hubイメージ - image: redis - # - ports: - # ホストとサービスコンテナのTCPポート6379をオープンする - - 6379:6379 -``` -{% endraw %} - -### 参考リンク - -- [Redisサービスコンテナの作成](/actions/automating-your-workflow-with-github-actions/creating-redis-service-containers) -- [PostgreSQLサービスコンテナの作成](/actions/automating-your-workflow-with-github-actions/creating-postgresql-service-containers) diff --git a/translations/ja-JP/content/actions/configuring-and-managing-workflows/authenticating-with-the-github_token.md b/translations/ja-JP/content/actions/configuring-and-managing-workflows/authenticating-with-the-github_token.md deleted file mode 100644 index 008a360a5e5b..000000000000 --- a/translations/ja-JP/content/actions/configuring-and-managing-workflows/authenticating-with-the-github_token.md +++ /dev/null @@ -1,99 +0,0 @@ ---- -title: '`GITHUB_TOKEN`での認証' -intro: '{% data variables.product.prodname_dotcom %}は、{% data variables.product.prodname_actions %}の代理で認証を受けるために利用できるトークンを提供します。' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /github/automating-your-workflow-with-github-actions/authenticating-with-the-github_token - - /actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -リポジトリに対して`write`アクセスがあるユーザなら、誰でもシークレットの作成、読み取りおよび使用ができます。 - -### `GITHUB_TOKEN`シークレットについて - -{% data variables.product.prodname_dotcom %}は、ワークフローで利用する`GITHUB_TOKEN`シークレットを自動的に生成します。 この`GITHUB_TOKEN`は、ワークフローの実行内での認証に利用できます。 - -{% data variables.product.prodname_actions %}を有効化すると、{% data variables.product.prodname_dotcom %}はリポジトリに{% data variables.product.prodname_github_app %}をインストールします。 `GITHUB_TOKEN`シークレットは、{% data variables.product.prodname_github_app %}インストールアクセストークンです。 このインストールアクセストークンは、リポジトリにインストールされた{% data variables.product.prodname_github_app %}の代わりに認証を受けるために利用できます このトークンの権限は、ワークフローを含むリポジトリに限定されます。 詳しい情報については「[`GITHUB_TOKEN`の権限](#permissions-for-the-github_token)」を参照してください。 - -各ジョブの開始前に、{% data variables.product.prodname_dotcom %} はジョブのインストールアクセストークンをフェッチします。 トークンはジョブが終了すると期限切れになります。 - -このトークンは、`github.token`コンテキストにもあります。 詳しい情報については、「[{% data variables.product.prodname_actions %} のコンテキストと式構文](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)」を参照してください。 - -### ワークフロー内での`GITHUB_TOKEN`の利用 - -`GITHUB_TOKEN`シークレットを利用するためには、ワークフローファイル内で参照しなければなりません。 トークンの利用には、そのトークンを要求するアクションへ入力としてそのトークンを渡すことや、認証を受けた{% data variables.product.prodname_dotcom %} APIコールの発行が含まれます。 - -{% data reusables.github-actions.actions-do-not-trigger-workflows %} - -#### `GITHUB_TOKEN`を入力として渡す例 - -以下のワークフローの例では[labeler action](https://github.com/actions/labeler)を使用しています。これには、`repo-token`入力パラメータの値として`GITHUB_TOKEN`を渡すことが必要です。 - - {% raw %} - ```yaml - name: Pull request labeler - on: - - pull_request - jobs: - triage: - runs-on: ubuntu-latest - steps: - - uses: actions/labeler@v2 - with: - repo-token: ${{ secrets.GITHUB_TOKEN }} - ``` - {% endraw %} - -#### REST APIの呼び出しの例 - -`GITHUB_TOKEN`を使って、認証されたAPIコールを発行できます。 以下のワークフローの例では、{% data variables.product.prodname_dotcom %} REST APIを使ってIssueを作成しています。 - - {% raw %} - ```yaml - name: Create issue on commit - on: - - push - jobs: - create_commit: - runs-on: ubuntu-latest - steps: - - name: Create issue using REST API - run: | - curl --request POST \ - --url https://api.github.com/repos/${{ github.repository }}/issues \ - --header 'authorization: Bearer ${{ secrets.GITHUB_TOKEN }}' \ - --header 'content-type: application/json' \ - --data '{ - "title": "Automated issue for commit: ${{ github.sha }}", - "body": "This issue was automatically created by the GitHub Action workflow **${{ github.workflow }}**. \n\n The commit hash was: _${{ github.sha }}_." - }' - ``` - {% endraw %} - -### `GITHUB_TOKEN`の権限 - -{% data variables.product.prodname_github_apps %} が各権限でアクセできる API エンドポイントについては、「[{% data variables.product.prodname_github_app %} の権限](/v3/apps/permissions/)」を参照してください。 - -| 権限 | アクセスタイプ | フォークしたリポジトリからのアクセス | -| ----------- | --------- | ------------------ | -| actions | 読み取り/書き込み | 読み取り | -| チェック | 読み取り/書き込み | 読み取り | -| コンテンツ | 読み取り/書き込み | 読み取り | -| デプロイメント | 読み取り/書き込み | 読み取り | -| issues | 読み取り/書き込み | 読み取り | -| メタデータ | 読み取り | 読み取り | -| パッケージ | 読み取り/書き込み | 読み取り | -| プルリクエスト | 読み取り/書き込み | 読み取り | -| リポジトリプロジェクト | 読み取り/書き込み | 読み取り | -| ステータス | 読み取り/書き込み | 読み取り | - -`GITHUB_TOKEN`で利用できない権限を要求するトークンが必要な場合は、個人アクセストークンを生成して、それをリポジトリのシークレットに設定できます。 - -1. リポジトリに対して適切な権限を持つトークンを利用もしくは生成してください。 詳しい情報については、「[個人アクセストークンを作成する](/github/authenticating-to-github/creating-a-personal-access-token)」を参照してください。 -1. ワークフローのリポジトリにそのトークンをシークレットとして追加し、 {%raw%}`${{ secrets.SECRET_NAME }}`{% endraw %}構文でそれを参照してください。 詳しい情報については、「[暗号化されたシークレットの作成と利用](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 diff --git a/translations/ja-JP/content/actions/configuring-and-managing-workflows/caching-and-storing-workflow-data.md b/translations/ja-JP/content/actions/configuring-and-managing-workflows/caching-and-storing-workflow-data.md deleted file mode 100644 index 3b1cb3372e0b..000000000000 --- a/translations/ja-JP/content/actions/configuring-and-managing-workflows/caching-and-storing-workflow-data.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: ワークフローデータのキャッシングと保存 -intro: 依存関係をキャッシュし、成果物を保存して、ワークフローの実行を効率化してください。 -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/ja-JP/content/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows.md b/translations/ja-JP/content/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows.md deleted file mode 100644 index c221188c5bab..000000000000 --- a/translations/ja-JP/content/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows.md +++ /dev/null @@ -1,190 +0,0 @@ ---- -title: 依存関係をキャッシュしてワークフローのスピードを上げる -intro: ワークフローを高速化して効率を上げるために、依存関係や広く再利用されるファイルに対するキャッシュを作成して利用できます。 -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /github/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows - - /actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows -versions: - free-pro-team: '*' ---- - -### ワークフローの依存関係のキャッシングについて - -ワークフローの実行は、しばしば他の実行と同じ出力あるいはダウンロードされた依存関係を再利用します。 たとえばMaven、Gradle、npm、Yarnといったパッケージ及び依存関係管理ツールは、ダウンロードされた依存関係のローカルキャッシュを保持します。 - -{% data variables.product.prodname_dotcom %}ホストランナー上のジョブは、クリーンな仮想環境で開始され、依存関係を毎回ダウンロードしなければならず、ネットワークの利用率を増大させ、実行時間が長くなり、コストが高まってしまいます。 これらのファイルの再生成にかかる時間を短縮しやすくするために、{% data variables.product.prodname_dotcom %}はワークフロー内で頻繁に使われる依存関係をキャッシュできます。 - -ジョブのために依存関係をキャッシュするには、{% data variables.product.prodname_dotcom %}の`cache`アクションを使わなければなりません。 このアクションは、ユニークなキーで指定されるキャッシュを取得します。 詳しい情報については「[`actions/cache`](https://github.com/actions/cache)」を参照してください。 - -{% warning %} - -**警告**: パブリックリポジトリのキャッシュには、センシティブな情報を保存しないことをおすすめします。 たとえばキャッシュパス内のファイルに保存されたアクセストークンあるいはログインクレデンシャルなどがセンシティブな情報です。 また、`docker login`のようなコマンドラインインターフェース（CLI）プログラムは、アクセスクレデンシャルを設定ファイルに保存することがあります。 読み取りアクセスを持つ人は誰でも、リポジトリにプルリクエストを作成し、キャッシュの内容にアクセスできます。 リポジトリのフォークも、ベースブランチ上にプルリクエストを作成し、ベースブランチ上のキャッシュにアクセスできます。 - -{% endwarning %} - -### 成果物の比較と依存関係のキャッシング - -成果物とキャッシングは、{% data variables.product.prodname_dotcom %}にファイルを保存できるようにするので似ていますが、それぞれの機能のユースケースは異なっており、入れ替えて使うことはできません。 - -- キャッシングは、ジョブやワークフローの実行間で頻繁に変化しないファイルを再利用したいときに使ってください。 -- ジョブによって生成されたファイルをワークフローの終了後に見るために保存したい場合に成果物を使ってください。 詳しい情報については「[成果物を利用してワークフローのデータを永続化する](/github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)」を参照してください。 - -### キャッシュへのアクセスについての制限 - -`cache` アクションの `v2` を使用すると、`GITHUB_REF` を含むイベントによってトリガーされるワークフローのキャッシュにアクセスできます。 `cache` アクションの `v1` を使用している場合、`pull_request` の `closed` イベントを除いて、`push` イベントと `pull_request` イベントによってトリガーされるワークフローでのみキャッシュにアクセスできます。 詳しい情報については、「[ワークフローをトリガーするイベント](/actions/reference/events-that-trigger-workflows)」を参照してください。 - -ワークフローは、現在のブランチ、baseブランチ（フォークされたリポジトリのbaseブランチを含む）、デフォルトブランチ（通常は`master`）で作成されたキャッシュにアクセスし、リストアできます。 たとえばデフォルトブランチの`master`で作成されたキャッシュは、どのプルリクエストからもアクセスできます。 また、`feature-b`ブランチが`feature-a`をbaseブランチとして持つなら、`feature-b`で起動されたワークフローはデフォルトブランチ（`master`）、`feature-a`、`feature-b`で作成されたキャッシュにアクセスできます。 - -アクセス制限は、異なるワークフローとブランチ間の論理的な境界を作成することによって、キャッシュの分離とセキュリティを提供します。 たとえば`feature-a`というブランチ（baseブランチは`master`）用に作成されたキャッシュは、`feature-b`というブランチ（baseブランチは`master`）へのプルリクエストからはアクセスできません。 - -### `cache`アクションの利用 - -`cache`アクションは、提供された`key`に基づいてキャッシュをリストアしようとします。 このアクションは、キャッシュを見つけるとそのキャッシュファイルを設定された`path`にリストアします。 - -正確なマッチがなければ、ジョブが成功したならこのアクションは新しいキャッシュエントリを作成します。 新しいキャッシュは提供された`key`を使い、`path`ディレクトリ内にファイルを保存します。 - -既存のキャッシュに`key`がマッチしなかった場合に使われる、`restore-keys`のリストを提供することもできます。 `restore-keys`のリストは、 `restore-keys`が部分的にしかキャッシュキーとマッチしないために、他のブランチからのキャッシュをリストアする場合に役立ちます。 `restore-keys`のマッチに関する詳しい情報については「[キャッシュキーのマッチ](#matching-a-cache-key)」を参照してください。 - -詳しい情報については「[`actions/cache`](https://github.com/actions/cache)」を参照してください。 - -#### `cache` アクションの入力パラメータ - -- `key`: **必須** このキーはキャッシュの保存時に作成され、キャッシュの検索に使われます。 変数、コンテキスト値、静的な文字列、関数の任意の組み合わせが使えます。 キーの長さは最大で512文字であり、キーが最大長よりも長いとアクションは失敗します。 -- `path`: **必須** ランナーがキャッシュあるいはリストアをするファイルパス。 このパスは、絶対パスでも、ワーキングディレクトリからの相対パスでもかまいません。 - - `cache` アクションの `v2` では、単一のパスまたは複数のパスをリストとして指定できます。 パスはディレクトリまたは単一ファイルのいずれかで、glob パターンがサポートされています。 - - `cache` アクションの `v1` では、単一のパスのみがサポートされ、かつそれがディレクトリである必要があります。 単一のファイルをキャッシュすることはできません。 -- `restore-keys`: **オプション** `key`に対するキャッシュヒットがなかった場合にキャッシュを見つけるために使われる代理キーの順序付きリスト。 - -#### `cache`アクションの出力パラメータ - -- `cache-hit`: キーの完全一致が見つかったことを示すブール値。 - -#### `cache` アクションの使用例 - -以下の例では、`package-lock.json`ファイル内のパッケージが変更された場合、あるいはランナーのオペレーティングシステムが変更された場合に新しいキャッシュが作成されます。 キャッシュキーはコンテキストと式を使い、ランナーのオペレーティングシステムと`package-lock.json`ファイルのSHA-256ハッシュを含むキーを生成します。 - -{% raw %} -```yaml -name: Caching with npm - -on: push - -jobs: - build: - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - - name: Cache node modules - uses: actions/cache@v2 - env: - cache-name: cache-node-modules - with: - # npm キャッシュファイルは Linux/macOS の「~/.npm」に保存される - path: ~/.npm - key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('**/package-lock.json') }} - restore-keys: | - ${{ runner.os }}-build-${{ env.cache-name }}- - ${{ runner.os }}-build- - ${{ runner.os }}- - - - name: Install Dependencies - run: npm install - - - name: Build - run: npm build - - - name: Test - run: npm test - -``` -{% endraw %} - -`key`が既存のキャッシュにマッチした場合はキャッシュヒットと呼ばれ、このアクションはキャッシュされたファイルを`path`ディレクトリにリストアします。 - -`key`が既存のキャッシュにマッチしなかった場合はキャッシュミスと呼ばれ、ジョブが成功して完了したなら新しいキャッシュが作成されます。 キャッシュミスが生じた場合、このアクションは`restore-keys`と呼ばれる代理キーを検索します。 - -1. `restore-keys`が渡された場合、`cache`アクションは`restore-keys`のリストにマッチするキャッシュを順番に検索します。 - - 完全なマッチがあった場合、アクションはそのファイルを`path`ディレクトリ中のキャッシュにリストアします。 - - 完全なマッチがなかった場合、アクションはリストアキーに対する部分一致を検索します。 アクションが部分一致を見つけた場合、最も最近のキャッシュが`path`ディレクトリにリストアされます。 -1. `cache` アクションが完了し、ジョブ内の次のワークフローステップが実行されます。 -1. ジョブが成功して完了したなら、アクションは`path`ディレクトリの内容で新しいキャッシュを作成します。 - -複数のディレクトリにファイルをキャッシュするには、各ディレクトリごとに[`cache`](https://github.com/actions/cache) アクションを使うステップが必要です。 キャッシュをいったん作成すると、既存のキャッシュの内容を変更することはできませんが、新しいキーで新しいキャッシュを作成することはできます。 - -#### コンテキストを使ったキャッシュキーの作成 - -キャッシュキーには、コンテキスト、関数、リテラル、{% data variables.product.prodname_actions %}がサポートする演算子を含めることができます。 詳しい情報については、「[{% data variables.product.prodname_actions %} のコンテキストと式構文](/actions/reference/context-and-expression-syntax-for-github-actions)」を参照してください。 - -式を使って`key`を作成すれば、依存関係が変化したときに自動的に新しいキャッシュを作成できます。 たとえばnpmの`package-lock.json`ファイルのハッシュを計算する式を使って`key`を作成できます。 - -{% raw %} -``` -npm-${{ hashFiles('package-lock.json') }} -``` -{% endraw %} - -{% data variables.product.prodname_dotcom %}は`hash "package-lock.json"`という式を評価して、最終的な`key`を導出します。 - -``` -npm-d5ea0750 -``` - -### キャッシュキーのマッチング - -`cache` アクションは最初に、ワークフロー実行を含むブランチで `key` および `restore-keys` のキャッシュヒットを検索します。 現在のブランチにヒットがない場合、`cache` アクションは、親ブランチと上流のブランチで `key` および `restore-keys` を検索します。 - -`key`でキャッシュミスがあった場合に使うリストアキーのリストを提供できます。 特定の度合いが強いものから弱いものへ並べて複数のリストアキーを作成できます。 `cache`アクションは順番に`restore-keys`を検索していきます。 キーが直接マッチしなかった場合、アクションはリストアキーでプレフィックスされたキーを検索します。 リストアキーに対して複数の部分一致があった場合、アクションは最も最近に作成されたキャッシュを返します。 - -#### 複数のリストアキーの利用例 - -{% raw %} -``` -restore-keys: | - npm-foobar-${{ hashFiles('package-lock.json') }} - npm-foobar- - npm- -``` -{% endraw %} - -ランナーは式を評価します。この式は以下のような`restore-keys`になります。 - -{% raw %} -``` -restore-keys: | - npm-foobar-d5ea0750 - npm-foobar- - npm- -``` -{% endraw %} - -リストアキーの`npm-foobar-`は、`npm-foobar-`という文字列で始まる任意のキーにマッチします。 たとえば`npm-foobar-fd3052de`や`npm-foobar-a9b253ff`というキーはいずれもこのリストアキーにマッチします。 最も最近の期日に作成されたキャッシュが使われます。 この例でのキーは、以下の順序で検索されます。 - -1. **`npm-foobar-d5ea0750`**は特定のハッシュにマッチします。 -1. **`npm-foobar-`**は`npm-foobar-`をプレフィックスとするキャッシュキーにマッチします。 -1. **`npm-`**は`npm-`をプレフィックスとする任意のキーにマッチします。 - -##### 検索の優先度の例 - -```yaml -key: - npm-feature-d5ea0750 -restore-keys: | - npm-feature- - npm- -``` - -たとえばあるプルリクエストに`feature`ブランチ（カレントスコープ）が含まれており、デフォルトブランチ（`master`）をターゲットにしている場合、アクションは`key`と`restore-keys`を以下の順序で検索します。 - -1. `feature`ブランチのスコープ内で`npm-feature-d5ea0750`というキー -1. `feature`ブランチのスコープ内で`npm-feature-`というキー -2. `feature`ブランチのスコープ内で`npm-`というキー -1. `master`ブランチのスコープ内で`npm-feature-d5ea0750`というキー -3. `master`ブランチのスコープ内で`npm-d5ea0750`というキー -4. `master`ブランチのスコープ内で`npm`というキー - -### 利用制限と退去のポリシー - -{% data variables.product.prodname_dotcom %}は、7日間以上アクセスされていないキャッシュエントリを削除します。 保存できるキャッシュ数には上限がありませんが、1つのリポジトリ内のすべてのキャッシュの合計サイズは5GBに制限されます。 この制限を超えた場合、{% data variables.product.prodname_dotcom %}はキャッシュを保存しますが、合計サイズが5GB以下になるまでキャッシュを退去させはじめます。 diff --git a/translations/ja-JP/content/actions/configuring-and-managing-workflows/configuring-a-workflow.md b/translations/ja-JP/content/actions/configuring-and-managing-workflows/configuring-a-workflow.md deleted file mode 100644 index 26c618f55475..000000000000 --- a/translations/ja-JP/content/actions/configuring-and-managing-workflows/configuring-a-workflow.md +++ /dev/null @@ -1,482 +0,0 @@ ---- -title: ワークフローの構成 -intro: カスタム ワークフローを作成して、プロジェクトのソフトウェア開発ライフサイクル プロセスを自動化できます。 -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /記事/作成-githubアクション/ - - /記事/ワークフローを作成する -github アクション/ - - /記事/ワークフローの構成 - - /github/自動化-ワークフローをgithubアクションで/ワークフローを設定する - - /アクション/自動化-ワークフローをgithubアクションで/ワークフローを設定する - - /アクション/作成ワークフロー/ワークフロー構成オプション -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -リポジトリへの書き込み権限または管理者権限を持つユーザーは、ワークフローを作成、編集、または表示できます。 - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -### ワークフローについて - -ワークフローは、リポジトリ内で設定して、プロジェクトをビルド、テスト、パッケージ化、リリース、またはデプロイするために設定できるカスタムの自動化プロセス {% data variables.product.prodname_dotcom %}。 ワークフローを使用すると、さまざまなツールとサービスでソフトウェア開発ライフサイクルを自動化できます。 詳細については、「 {% data variables.product.prodname_actions %}について -」を参照してください。

    - -リポジトリ内に複数のワークフローを作成できます。 ワークフローは、リポジトリのルートにあるディレクトリの `github/ワークフロー` ディレクトリに格納する必要があります。 - -ワークフローには少なくとも 1 つのジョブが必要であり、ジョブには個々のタスクを実行する一連のステップが含まれています。 ステップは、コマンドを実行したり、アクションを使用したりできます。 独自のアクションを作成したり、 {% data variables.product.prodname_dotcom %} コミュニティで共有するアクションを使用して、必要に応じてカスタマイズすることができます。 - -{% data variables.product.prodname_dotcom %} イベントが発生したとき、スケジュールに従って、または外部イベントから開始するようにワークフローを構成できます。 - -YAML 構文を使用してワークフローを設定し、リポジトリ内のワークフロー ファイルとして保存する必要があります。 YAML ワークフロー ファイルを正常に作成し、ワークフローをトリガーすると、ワークフローの各ステップのビルド ログ、テスト結果、アーティファクト、およびステータスが表示されます。 詳細については、「ワークフローの実行[管理」を参照](/articles/managing-a-workflow-run)。 - -![アナンスされたワークフロー実行イメージ](/assets/images/help/repository/annotated-workflow.png) - -ワークフローステータスの更新に関する通知を受信することもできます。 通知オプションの詳細については、「通知のの構成」を参照してください。

    - -使用制限は、個々のワークフローに適用されます。 詳細については、「ワークフローの使用制限[](/articles/workflow-syntax-for-github-actions#usage-limits)」を参照してください。 - - - -### ワークフロー ファイルの作成 - -大まかに言えば、ワークフロー ファイルを追加する手順は次のとおりです。 具体的な構成例については、以降のセクションを参照してください。 - -1. リポジトリのルートで、ワークフロー ファイルを格納するディレクトリ `.github/workflow` というディレクトリを作成します。 - -1. github/ワークフロー ``で、ワークフローの `.yml` または `.yaml` ファイルを追加します。 たとえば、 `.github/ワークフロー/継続的インテグレーションワークフロー.yml`。 - -1. 「 {% data variables.product.prodname_actions %}のワークフロー構文」参照ドキュメントを使用して、アクションのトリガ、アクションの追加、ワークフローのカスタマイズを行うイベントを選択します。

    - - 1 ワークフロー ファイルの変更を、ワークフローを実行するブランチにコミットします。 - - - -#### ワークフロー ファイルの例 - -{% raw %} - - -```yaml -name: [すべてのユーザーを迎える] -# このワークフローはリポジトリへのプッシュでトリガーされます。 -on: [push] - -ジョブ: - ビルド: - # ジョブ名はグリーティング - 名: グリーティング - # このジョブは Linux - で実行されます: ubuntu-最新 - ステップ: - # このステップはGitHubの hello-world-javascript アクションを使用しています: https://github.com/actions/hello-world-javascript-action - - 名前 こんにちは世界 - 使用:アクション/ハローワールドjavascript-action@v1.1と - : - 誰が挨拶:'モナ・ザ・オクトキャット' - id:こんにちは - #このステップは、前のステップのアクションからの出力(時間)を出力します。 - - 名前:挨拶の実行時間 - エコー:エコー'時間は${{ steps.hello.outputs.time }}でした. -``` - - -{% endraw %} - -{% data reusables.github-actions.invalid-workflow-files %} - - - -### イベントを含むワークフローのトリガー - -ワークフローを一度開始するように設定できます。 - -- {% data variables.product.prodname_dotcom %} に関するイベントは、誰かがコミットをリポジトリにプッシュしたときや、問題やプル要求が作成された場合などに発生します。 -- スケジュールされたイベントが開始されます。 -- 外部イベントが発生します。 - -{% data variables.product.prodname_dotcom %}でイベントが発生した後にワークフローをトリガーするには、ワークフロー名の後に `` とイベント値を追加します。 たとえば、このワークフローは、変更がリポジトリ内のブランチにプッシュされたときにトリガーされます。 - - - -```yaml -name: 説明ワークフロー名 -: プッシュ -``` - - -ワークフローをスケジュールするには、ワークフロー ファイルで POSIX cron 構文を使用します。 スケジュールされたワークフローを実行できる最短の間隔は、5 分ごとに 1 回です。 たとえば、このワークフローは 1 時間ごとにトリガーされます。 - - - -```yaml -オン: - スケジュール: - - cron: '0 * * * * *' -``` - - - - -#### ワークフローの手動実行 - -ワークフローを手動で実行するには、最初にワークフローを構成して、 `workflow_dispatch` イベントを使用する必要があります。 カスタム定義の入力プロパティ、デフォルトの入力値、および必要な入力をワークフローで直接構成できます。 ワークフローが実行されると、 `github.event.inputs` コンテキスト内の入力値にアクセスできます。 詳細については、「ワークフローをトリガーするイベント[」および「 {% data variables.product.prodname_dotcom %} アクション](/actions/reference/events-that-trigger-workflows/#workflow_dispatch)のコンテキストと式の構文をする」を参照してください。

    - -この例では、 `名` 定義し、入力 ` github.event.inputs.name` を使用してそれらを出力し、github.event.inputs.home コンテキスト `します。 ` `名が指定されていない場合は、既定値の 「Mona the Octocat」 が表示されます。

    - -

    {% raw %}

    - -
    名前: 手動でトリガーされたワークフロー
-:
-  workflow_dispatch:
-    入力:
-      の説明:
-        
-        説明: 必須: true
-        デフォルト: 'モナ・ザ・オクトキャット' ホーム
-      : 'モナ・ザ・オクトキャット'
-        ホーム: '場所'
-        必要: 偽
-
-ジョブ:
-  say_hello:
-    実行: ubuntu最新
-    ステップ:
-    - 実行 |
-        エコー "こんにちは ${{ github.event.inputs.name }}!
-        エコー "- ${{ github.event.inputs.home }}で!
-`
    - -{% endraw %} - -`workflow_dispatch` イベントは、 {% data variables.product.prodname_dotcom %} または REST API を使用して[アクション]タブからトリガーできます。 REST API の使用の詳細については、「ワークフローディスパッチ イベントの作成」を参照してください。 REST API を使用する場合は、 `入力` を構成し、要求本文パラメーターとして ref `します。 入力を省略すると、ワークフロー ファイルで定義されている既定値が使用されます。

    - -

    {% data variables.product.prodname_dotcom %}で workflow_dispatch` イベントをトリガするには、ワークフローが既定のブランチに含まれる必要があります。 ワークフローの実行を手動でトリガーするには、次の手順に従います。

    - -{% data reusables.repositories.navigate-to-repo %} - - - -{% data reusables.repositories.actions-tab %} - -1. 左側のサイドバーで、実行するワークフローをクリックします。 ![アクション選択ワークフロー](/assets/images/actions-select-workflow.png) - -1. ワークフロー実行の一覧の上にある [ワークフローの実行 ****を実行する] を選択します。 ![アクション ワークフローのディスパッチ](/assets/images/actions-workflow-dispatch.png) - -1. ワークフローを実行する分岐を選択し、ワークフローで使用される入力パラメータを入力します。 [ ワークフロー**実行 ] をクリックします。 ![アクションはワークフローを手動で実行します](/assets/images/actions-manually-run-workflow.png)

    - - - -#### 外部イベントからのワークフローのトリガー - -外部イベントが発生した後にワークフローをトリガーするには、「リポジトリー・ディスパッチ・イベントの作成」REST API エンドポイントを呼び出して、 `repository_dispatch` webhook イベントを呼び出すことができます。 詳細については、「リポジトリディスパッチ イベントを作成」を参照してください。

    - -詳細と例については、「ワークフローをトリガーするイベントを」を参照してください。

    - - - -### 特定のブランチ、タグ、およびパスのフィルタリング - -ワークフローは、特定のブランチでのみ実行するように設定できます。 - -たとえば、このワークフローは、 `テスト` ディレクトリにファイルを含むプッシュが `マスター` ブランチで行われた場合、または `v1` タグにプッシュされたときに実行されます。 - - - -```yaml -on: - プッシュ: - ブランチ: - - マスター - タグ: - - イベントで考慮する # ファイルパスを - v1。 省略可能。既定値は、すべてになります。 - パス: - - 'テスト/*' -``` - - -ブランチ、タグ、およびパス フィルターの構文の詳細については、「[`を参照してください。."" と "を`](/articles/workflow-syntax-for-github-actions#onpushpull_requestbranchestags)します。.パス. - - - -### ランナーの選択 - -ワークフローは、 {% data variables.product.prodname_dotcom %}ホストランナーまたは自己ホスト型ランナーで実行できます。 ジョブは、マシン上または Docker コンテナーで直接実行できます。 - -ワークフローの各ジョブに対して、実行    `を使用して、ランナーを指定できます。 ラン 実行`の詳細については、「 {% data variables.product.prodname_actions %}のワークフロー構文の」を参照してください。

    - -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - - - -#### {% data variables.product.prodname_dotcom %}ホストランナーの使用 - -Linux、Windows、macOS など、さまざまな種類とバージョンの仮想ホストマシンから選択できます。 ワークフロー内の各ジョブは仮想環境の新しいインスタンスで実行され、ジョブ内のステップはファイルシステムを使用して情報を共有できます。 詳細については、「ホストされている {% data variables.product.prodname_actions %}のランナーの仮想環境を[する」](/articles/virtual-environments-for-github-actions)参照してください。 - -たとえば、ubuntu-latest     `使用して、Ubuntu {% data variables.product.prodname_dotcom %}ホストランナーの最新バージョンを指定できます。

    - -
    ランオン:Ubuntu-最新
-`
    - - - -#### 自己ホスト型ランナーの使用 - -ラベルを使用して、特定のタイプのセルフホストランナーにジョブをルーティングできます。 すべてのセルフホストランナーは、 `のセルフホスト型` ラベルを取得し、各セルフホストランナーにはオペレーティングシステムとシステムアーキテクチャのラベルがあります。 詳細については、「ワークフローでの自己ホスト型ランナーの使用」を参照してください。

    - -たとえば、Linux オペレーティングシステムと ARM32 アーキテクチャを持つ自己ホスト型ランナーを追加した場合、 `の自己ホスト型`、 `Linux`、ARM32     ラベルを `して、そのランナーを選択できます。

    - -
    ランオン: [自己ホスト型、Linux、ARM32]
-`
    - - - -### ビルド マトリックスの構成 - -複数のオペレーティング システム、プラットフォーム、および言語バージョン間で同時にテストを行うために、ビルド マトリックスを構成できます。 - -ビルド マトリックスを使用すると、さまざまなソフトウェア構成とオペレーティング システム構成でコードをテストできます。 たとえば、ワークフローでは、サポートされている複数のバージョンの言語、オペレーティング システム、またはツールに対してジョブを実行できます。 構成ごとに、ジョブのコピーが実行され、状況が報告されます。 - -ワークフロー ファイルでビルド マトリックスを指定し、 `の戦略の下にある構成オプションをリストする配列を指定`。 たとえば、このビルドマトリックスは、Linux オペレーティングシステムの Node.js と Ubuntu のバージョンが異なるジョブを実行します。 - -{% data reusables.repositories.actions-matrix-builds-os %} - -{% raw %} - - -```yaml -ランオン: ${{ matrix.os }} -戦略: - マトリクス: - os: [ubuntu-16.04, ubuntu-18.04] - ノード: [6, 8, 10] -``` - - -{% endraw %} - -詳細については、「 {% data variables.product.prodname_actions %}のワークフロー構文」を参照してください。

    - - - -### チェックアウト アクションの使用 - -ワークフローで使用できる標準アクションがいくつかあります。 チェックアウト アクションは、次の場合に他のアクションの前にワークフローに含める必要がある標準アクションです。 - -- リポジトリを構築してテストするときや、継続的インテグレーションを使用する場合など、ワークフローにはリポジトリのコードのコピーが必要です。 -- ワークフロー内に、同じリポジトリで定義されたアクションが少なくとも 1 つあります。 詳細については、「ワークフローでのアクションの参照をする」を参照してください。 - - 標準のチェックアウトアクションを追加仕様なしで使用するには、次の手順を実行します。 - - -```yaml -- 用途: アクション/checkout@v2 -``` - - -この例では、 `v2` を使用すると、安定したバージョンのチェックアウト アクションを使用できます。 詳細については、「チェックアウト アクションの [」を参照](https://github.com/actions/checkout)。 - - - -### ワークフローのアクションのタイプの選択 - -プロジェクトのニーズに合わせてワークフローで使用できるアクションには、次の種類があります。 - -- Docker コンテナーアクション -- アクション -- 複合実行ステップアクション - -詳細については、「アクションについて」を参照してください。

    - -ワークフローで使用するアクションの種類を選択する場合は、パブリックリポジトリまたは Docker ハブで既存のアクションを探索し、プロジェクトに合わせてこれらのアクションをカスタマイズすることをお勧めします。 - -[github.com/actions](https://github.com/actions) 組織内の {% data variables.product.prodname_dotcom %} によって作成されたアクションを参照して使用できます。 Docker ハブにアクセスするには、Docker サイトの「[Docker ハブ](https://www.docker.com/products/docker-hub)」を参照してください。 - - - -### ワークフロー内のアクションの参照 - -ワークフロー ファイル内のアクションを正しい構文で参照するには、アクションが定義されている場所を考慮する必要があります。 - -ワークフローでは、次の中で定義されたアクションを使用できます。 - -- パブリック リポジトリ -- ワークフロー ファイルがアクションを参照するリポジトリと同じ -- Docker ハブで公開された Docker コンテナー イメージ - -プライベート リポジトリで定義されたアクションを使用するには、ワークフロー ファイルとアクションの両方が同じリポジトリ内にある必要があります。 他のプライベートリポジトリが同じ組織にある場合でも、ワークフローで他のプライベートリポジトリで定義されたアクションを使用することはできません。 - -アクションが更新されてもワークフローの安定性を維持するには、ワークフロー ファイルで Git ref または Docker タグ番号を指定することで、使用しているアクションのバージョンを参照できます。 例については、「 {% data variables.product.prodname_actions %}のワークフロー構文」を参照してください。

    - -{% if currentVersion == "free-pro-team@latest" %} - - - -{% data reusables.dependabot.version-updates-for-actions %} - - - -{% endif %} - -詳細な構成オプションについては、「 {% data variables.product.prodname_actions %}のワークフロー構文」を参照してください。

    - - - -#### パブリック リポジトリからのアクションの参照 - -アクションがパブリックリポジトリで定義されている場合は、構文 `{owner}/{repo}@{ref}` または `{owner}/{repo}/{path}@{ref}`を使用してアクションを参照する必要があります。 - - - -```yaml -ジョブ: - my_first_job: - 名: - 名: - - 用途: アクション/セットアップnode@v1 - : - ノードバージョン: 10.x -``` - - -完全なワークフローの例については、テンプレート リポジトリの [設定ノード](https://github.com/actions/setup-node) 参照してください。 - - - -#### ワークフロー ファイルでアクションを使用する同じリポジトリ内のアクションの参照 - -ワークフロー ファイルがアクションを使用するのと同じリポジトリでアクションが定義されている場合は、ワークフロー ファイル内の`{owner}/{repo}@{ref}` または `./path/to/dir` 構文を使用してアクションを参照できます。 - -リポジトリ ファイル構造の例: - - - -``` -|-- ハローワールド (リポジトリ) -| github -| └─ ワークフロー -| └─ 私の最初のワークフロー.yml -| └─ -アクション | |__ ハローワールドアクション -| └── アクション.yml -``` - - -ワークフロー ファイルの例: - - - -```yaml -ジョブ: - ビルド: - 実行: ubuntu 最新 - ステップ: - # このステップは、リポジトリのコピーをチェックアウトします。 - - 用途: アクション/checkout@v2 - # このステップは、アクションを含むディレクトリを参照します。 - - 用途: ./.github/アクション/ハローワールドアクション -``` - - - - -#### Docker ハブでのコンテナーの参照 - -アクションが Docker Hub の公開された Docker コンテナー イメージで定義されている場合は、ワークフロー ファイル内の `docker://{image}:{tag}` 構文を使用してアクションを参照する必要があります。 コードとデータを保護するために、ワークフローで使用する前に Docker Hub から Docker コンテナー イメージの整合性を確認することを強くお勧めします。 - - - -```yaml -ジョブ: - my_first_job: - ステップ: - - 名前: 使用 - 私の最初のステップ: docker://alpine:3.8 -``` - - -Docker アクションの例については、「docker-image.yml ワークフロー [」および「docker コンテナー アクションの作成](https://github.com/actions/starter-workflows/blob/master/ci/docker-image.yml)」参照してください。

    - -詳細については、「 {% data variables.product.prodname_actions %}のワークフロー構文」を参照してください。

    - - - -### リポジトリへのワークフローステータスバッジの追加 - -{% data reusables.repositories.actions-workflow-status-badge-into %} - -ワークフローで `名` キーワードを使用する場合は、ワークフローを名前で参照する必要があります。 ワークフローの名前に空白が含まれている場合は、URL エンコード文字列 `%20`にスペースを置き換える必要があります。 `名` キーワードの詳細については、「 {% data variables.product.prodname_actions %}のワークフロー構文」を参照してください。

    - - - -``` -https://github.com///ワークフロー//badge.svg -``` - - -または、ワークフローに `名が含まれていない場合`は、リポジトリのルート ディレクトリに対する相対ファイル パスを使用してワークフロー ファイルを参照する必要があります。 - -{% note %} - -**注意:** ワークフローに `名が含まれていない場合、ファイル パスを使用してワークフロー ファイルを参照`機能しません。 - -{% endnote %} - - - -``` -https://github.com///ワークフロー//badge.svg -``` - - - - -#### ワークフロー名を使用した例 - -この Markdown の例では、"すべてのユーザーを出す" という名前のワークフローのステータス バッジを追加します。 リポジトリの `OWNER` は、組織     `アクションであり、 リポジトリ` 名はハローワールド`。

    - -
    ![ワークフロー名の例](https://github.com/actions/hello-world/workflows/Greet%20E非常に一つ/バッジ.svg)
-`
    - - - -#### ワークフロー ファイル パスの使用例 - -この Markdown の例では、ファイル パスを持つワークフローのステータス バッジを追加します `.github/workflow/main.yml`。 リポジトリの `OWNER` は、組織 `アクションであり、 リポジトリ` 名はハローワールド`。

    - -
    ![ワークフロー ファイルのパスの例](https://github.com/actions/hello-world/workflows/.github/workflows/main.yml/badge.svg)
-`
    - - - -#### `ブランチ` パラメータを使用した例 - -この Markdown の例では、機能 1の名前 `分岐のステータス バッジを追加します。

    - -
    ![分岐パラメータの例](https://github.com/actions/hello-world/workflows/Greet%20E非常に一人/バッジ.svg?ブランチ=フィーチャー-1)
-`
    - - - -#### `イベント` パラメータの使用例 - -この Markdown の例では、 `pull_request` イベントによってトリガーされたワークフロー実行の状態を示すバッジを追加します。 - - - -``` -![イベント パラメーターの例](https://github.com/actions/hello-world/workflows/Greet%20E非常に一人/バッジ.svg?イベント=pull_request) -``` - - -{% if currentVersion == "free-pro-team@latest" %} - - -### 参考リンク - -- "[ {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)の請求を管理する " - - {% endif %} diff --git a/translations/ja-JP/content/actions/configuring-and-managing-workflows/configuring-and-managing-workflow-files-and-runs.md b/translations/ja-JP/content/actions/configuring-and-managing-workflows/configuring-and-managing-workflow-files-and-runs.md deleted file mode 100644 index 587a8a718b67..000000000000 --- a/translations/ja-JP/content/actions/configuring-and-managing-workflows/configuring-and-managing-workflow-files-and-runs.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: ワークフローのファイル及び実行の設定と管理 -intro: プロジェクトの開発の部分を自動化するために、ワークフローを作成して設定してください。 -mapTopic: true -redirect_from: - - /articles/configuring-workflows - - /github/automating-your-workflow-with-github-actions/configuring-workflows - - /actions/automating-your-workflow-with-github-actions/configuring-workflows -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/ja-JP/content/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets.md b/translations/ja-JP/content/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets.md deleted file mode 100644 index 3315addd472e..000000000000 --- a/translations/ja-JP/content/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets.md +++ /dev/null @@ -1,220 +0,0 @@ ---- -title: 暗号化されたシークレットの作成と保存 -intro: 暗号化されたシークレットを使用すると、機密情報をリポジトリまたは Organization に保存できます。 -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets - - /actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -### 暗号化されたシークレットについて - -シークレットは、リポジトリまたは Organization で作成する暗号化された環境変数です。 作成したシークレットは、{% data variables.product.prodname_actions %} ワークフローで使用できます。 {% data variables.product.prodname_dotcom %}は、[ libsodium sealed box](https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes)を使って、シークレットが{% data variables.product.prodname_dotcom %}に到達する前に暗号化され、ワークフローで使われるまで暗号化されたままになっていることを保証する手助けをします。 - -{% data reusables.github-actions.secrets-org-level-overview %} - -#### シークレットに名前を付ける - -シークレットの名前には次のルールが適用されます。 - -* シークレット名には、英数字（`[a-z]`、`[A-Z]`、`[0-9]`）または下線（`_`）のみを含めることができます。 スペースは使用できません。 -* シークレット名の最初を `GITHUB_` プレフィックスにすることはできません。 -* シークレット名の最初を数字にすることはできません。 -* シークレット名は、作成されたレベルで一意である必要があります。 たとえば、Organization レベルで作成されたシークレット名はそのレベルで一意である必要があり、リポジトリレベルで作成されたシークレット名はそのリポジトリ内で一意である必要があります。 Organization レベルのシークレット名がリポジトリレベルのシークレット名と同じ場合、リポジトリレベルのシークレット名が優先されます。 - -{% data variables.product.prodname_dotcom %} がログのシークレットを確実に削除するよう、シークレットの値として構造化データを使用しないでください。 たとえば、JSONやエンコードされたGit blobを含むシークレットは作成しないでください。 - -#### シークレットにアクセスする - -シークレットをアクションが使用できるようにするには、ワークフローファイルでシークレットを入力または環境変数に設定する必要があります。 アクションに必要な入力および環境変数については、アクションのREADMEファイルを確認します。 詳しい情報については、「[{% data variables.product.prodname_actions %}のワークフロー構文](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepsenv)」を参照してください。 - -ファイルを編集するアクセス権を持っていれば、ワークフローファイル中の暗号化されたシークレットを使い、読み取ることができます。 詳細は「[{% data variables.product.prodname_dotcom %} 上のアクセス権限](/github/getting-started-with-github/access-permissions-on-github)」を参照してください。 - -{% warning %} - -**警告：** {% data variables.product.prodname_dotcom %}は、ログに出力されたシークレットを自動的に削除しますが、シークレットをログに出力することは意識的に避けなくてはなりません。 - -{% endwarning %} - -REST API を使用してシークレットを管理することもできます。 詳しい情報については、「[シークレット](/v3/actions/secrets/)」を参照してください。 - -#### 認証情報のアクセス許可を制限する - -クレデンシャルを生成する際には、可能な限り最小限の権限だけを許可することをおすすめします。 たとえば、個人のクレデンシャルを使う代わりに、[デプロイキー](/v3/guides/managing-deploy-keys/#deploy-keys)あるいはサービスアカウントを使ってください。 必要なのが読み取りだけであれば、読み取りのみの権限を許可すること、そしてアクセスをできるかぎり限定することを考慮してください。 個人アクセストークン（PAT）を生成する際には、必要最小限のスコープを選択してください。 - -### リポジトリの暗号化されたシークレットの作成 - -{% data reusables.github-actions.permissions-statement-secrets-repository %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -{% data reusables.github-actions.sidebar-secret %} -1. [**Add a new secret**] をクリックします。 -1. [名前] 入力ボックスにシークレットの名前 **入力します。 -1 シークレットの値を入力します。 -1 [**Add secret**] をクリックします。 - -リポジトリが親組織のシークレットにアクセスできる場合、そのシークレットもこのページに表示されます。 - -### 組織の暗号化されたシークレットの作成 - -組織でシークレットを作成する場合、ポリシーを使用して、そのシークレットにアクセスできるリポジトリを制限できます。 たとえば、すべてのリポジトリにアクセスを許可したり、プライベート リポジトリまたは指定したリポジトリ のリストのみにアクセスを制限したりできます。 - -{% data reusables.github-actions.permissions-statement-secrets-organization %} - -{% data reusables.organizations.navigate-to-org %} -{% data reusables.organizations.org_settings %} -{% data reusables.github-actions.sidebar-secret %} -1. [新しいシークレット ****] をクリックします。 -1. [名前] 入力ボックスにシークレットの名前 **入力します。 -1 シークレットの **値** を入力します。 -1 [ **リポジトリアクセス** ドロップダウン リストから、アクセス ポリシーを選択します。 -1 [**Add secret**] をクリックします。 - -### 組織レベルのシークレットへのアクセスの確認 - -組織内のシークレットに適用されているアクセス ポリシーを確認できます。 - -{% data reusables.organizations.navigate-to-org %} -{% data reusables.organizations.org_settings %} -{% data reusables.github-actions.sidebar-secret %} -1. シークレットのリストには、構成済みのアクセス許可とポリシーが含まれます。 例: ![シークレットリスト](/assets/images/help/settings/actions-org-secrets-list.png) -1. 各シークレットに構成されているアクセス許可の詳細については、[更新**] をクリックしてください。

    - -### 暗号化されたシークレットのワークフロー内での利用 - -`GITHUB_TOKEN`を除き、フォークしたリポジトリからワークフローがトリガーされた場合、シークレットは runner に渡されません。 - -アクションに入力あるいは環境変数としてシークレットを提供するには、リポジトリ内に作成したシークレットにアクセスする`secrets`コンテキストを使うことができます。 詳しい情報については「[{% data variables.product.prodname_actions %}のコンテキストと式構文](/actions/reference/context-and-expression-syntax-for-github-actions)」及び「[{% data variables.product.prodname_actions %}のワークフロー構文](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)」を参照してください。 - -{% raw %} -```yaml -steps: - - name: Hello world action - with: # Set the secret as an input - super_secret: ${{ secrets.SuperSecret }} - env: # Or as an environment variable - super_secret: ${{ secrets.SuperSecret }} -``` -{% endraw %} - -可能であれば、コマンドラインからプロセス間でシークレットを渡すのは避けてください。 コマンドラインプロセスは他のユーザから見えるかもしれず（`ps`コマンドを使って）、あるいは[セキュリティ監査イベント](https://docs.microsoft.com/en-us/windows-server/identity/ad-ds/manage/component-updates/command-line-process-auditing)でキャプチャされるかもしれません。 シークレットの保護のために、環境変数、`STDIN`、あるいはターゲットのプロセスがサポートしている他の仕組みの利用を考慮してください。 - -コマンドラインからシークレットを渡さなければならない場合は、それらを適切なルールでクオート内に収めてください。 シークレットは、意図せずシェルに影響するかもしれない特殊なキャラクターをしばしば含みます。 それらの特殊なキャラクターをエスケープするには、環境変数をクオートで囲ってください。 例: - -#### Bashの利用例 - -{% raw %} -```yaml -steps: - - shell: bash - env: - SUPER_SECRET: ${{ secrets.SuperSecret }} - run: | - example-command "$SUPER_SECRET" -``` -{% endraw %} - -#### PowerShellの利用例 - -{% raw %} -```yaml -steps: - - shell: pwsh - env: - SUPER_SECRET: ${{ secrets.SuperSecret }} - run: | - example-command "$env:SUPER_SECRET" -``` -{% endraw %} - -#### Cmd.exeの利用例 - -{% raw %} -```yaml -steps: - - shell: cmd - env: - SUPER_SECRET: ${{ secrets.SuperSecret }} - run: | - example-command "%SUPER_SECRET%" -``` -{% endraw %} - -### シークレットの制限 - -ワークフローは、最大で100のシークレットを持てます。 シークレット環境変数の名前は、リポジトリ内でユニークでなければなりません。 - -シークレットの容量は最大64 KBです。 64 KBより大きなシークレットを使うには、暗号化されたシークレットをリポジトリ内に保存して、復号化パスフレーズを{% data variables.product.prodname_dotcom %}に保存します。 たとえば、{% data variables.product.prodname_dotcom %}のリポジトリにファイルをチェックインする前に、`gpg`を使って認証情報をローカルで暗号化します。 詳しい情報については、「[gpg manpage](https://www.gnupg.org/gph/de/manual/r1023.html)」を参照してください。 - -{% warning %} - -**警告**: アクションを実行する際、シークレットは出力されないので注意してください。 この回避策を用いる場合、{% data variables.product.prodname_dotcom %}はログに出力されたシークレットを削除しません。 - -{% endwarning %} - -1. ターミナルから以下のコマンドを実行して、`gpg`およびAES256暗号アルゴリズムを使用して`my_secret.json`ファイルを暗号化します。 - - ``` shell - $ gpg --symmetric --cipher-algo AES256 my_secret.json - ``` - -1. パスフレーズを入力するよう求められます。 このパスフレーズを覚えておいてください。{% data variables.product.prodname_dotcom %}で、このパスフレーズを値として用いる新しいシークレットを作成するために必要になります。 - -1. パスフレーズを含む新しいシークレットを作成します。 たとえば、`LARGE_SECRET_PASSPHRASE`という名前で新しいシークレットを作成し、シークレットの値を上記のステップで選択したパスフレーズに設定します。 - -1. 暗号化したファイルをリポジトリ内にコピーしてコミットします。 この例では、暗号化したファイルは`my_secret.json.gpg`です。 - -1. パスワードを復号化するシェルスクリプトを作成します。 このファイルを`decrypt_secret.sh`として保存します。 - - ``` shell - #!/bin/sh - - # mkdir $HOME/secrets - # --batch - ファイルを復号化して、インタラクティブなコマンド - # --yes を防ぎ、質問に対して "はい" を - -- yes --はい --パスフレーズを解読する ="$LARGE_SECRET_PASSPHRASE" \ - -- $HOME/secrets/my_secret.json my_secret.json.gpg - ``` - -1. リポジトリにチェックインする前に、シェルスクリプトが実行可能であることを確かめてください。 - - ``` shell - $ chmod +x decrypt_secret.sh - $ git add decrypt_secret.sh - $ git commit -m "Add new decryption script" - $ git push - ``` - -1. ワークフローから、`step`を使用してシェルスクリプトを呼び出し、シークレットを復号化します。 ワークフローを実行している環境にリポジトリのコピーを作成するには、[`actions/checkout`](https://github.com/actions/checkout)アクションを使用する必要があります。 リポジトリのルートを基準として、`run`コマンドを使用することで、シェルスクリプトを参照します。 - -{% raw %} - ```yaml - 名前: 大きな - - 秘密を持つワークフロー: プッシュ - - ジョブ - : プッシュジョブ: - 名:のジョブ - 実行: ubuntu 最新 - ステップ: - - 使用: アクション/checkout@v2 - - 名前: 大規模な秘密 - を復号化 - 実行: ./.github/scripts/decrypt_secret.sh env: - LARGE_SECRET_PASSPHRASE: ${{ secrets.LARGE_SECRET_PASSPHRASE }} - # このコマンドは、あなたの秘密が印刷されていることを示す例 - # あなたの印刷シークレットを削除します。 GitHub does - # not hide secrets that use this workaround. - - name: Test printing your secret (Remove this step in production) - run: cat $HOME/secrets/my_secret.json - ``` -{% endraw %} diff --git a/translations/ja-JP/content/actions/configuring-and-managing-workflows/creating-postgresql-service-containers.md b/translations/ja-JP/content/actions/configuring-and-managing-workflows/creating-postgresql-service-containers.md deleted file mode 100644 index ef7959a7cfd4..000000000000 --- a/translations/ja-JP/content/actions/configuring-and-managing-workflows/creating-postgresql-service-containers.md +++ /dev/null @@ -1,335 +0,0 @@ ---- -title: PostgreSQLサービスコンテナの作成 -intro: ワークフローで利用するPostgreSQLサービスコンテナを作成できます。 このガイドでは、コンテナで実行されるジョブか、ランナーマシン上で直接実行されるジョブのためのPostgreSQLサービスの作成例を紹介します。 -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/creating-postgresql-service-containers -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -### はじめに - -このガイドでは、Docker Hubの`postgres`イメージを使ってサービスコンテナを設定するワークフローの例を紹介します。 このワークフローは、PostgreSQLのクライアントを作成してクライアントにデータを展開するスクリプトを実行します。 PostgreSQLクライアントを作成して展開するワークフローをテストするために、このスクリプトはクライアントのデータをコンソールに出力します。 - -{% data reusables.github-actions.docker-container-os-support %} - -### 必要な環境 - -{% data reusables.github-actions.service-container-prereqs %} - -YAML、{% data variables.product.prodname_actions %}の構文、PosgreSQLの基本な理解があれば役立つかも知れません。 詳しい情報については、以下を参照してください。 - -- [ワークフローの設定](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow) -- PostgreSQLのドキュメンテーション中の[PostgreSQLチュートリアル](https://www.postgresqltutorial.com/) -- [{% data variables.product.prodname_actions %}の中核的概念](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions) -- [環境変数の利用](/actions/automating-your-workflow-with-github-actions/using-environment-variables) - -### コンテナ内でのジョブの実行 - -{% data reusables.github-actions.container-jobs-intro %} - -{% data reusables.github-actions.copy-workflow-file %} - -{% raw %} -```yaml -name: PostgreSQL service example -on: push - -jobs: - # コンテナジョブのラベル - container-job: - # コンテナはLinuxベースのオペレーティングシステム内で実行しなければならない - runs-on: ubuntu-latest - # `container-job`が実行されるDocker Hubのイメージ - container: node:10.18-jessie - - # `container-job`と実行されるサービスコンテナ - services: - # サービスコンテナへのアクセスに使われるラベル - postgres: - # Docker Hubのイメージ - image: postgres - # postgresのパスワードを提供 - env: - POSTGRES_PASSWORD: postgres - # postgresが起動するまで待つヘルスチェックの設定 - options: >- - --health-cmd pg_isready - --health-interval 10s - --health-timeout 5s - --health-retries 5 - - steps: - # CIテストの実行前にリポジトリからコードのコピーをダウンロード - - name: Check out repository code - uses: actions/checkout@v2 - - # `package.json`ファイル内のすべての依存関係のクリーンインストールを実行 - # 詳しい情報についてはhttps://docs.npmjs.com/cli/ci.htmlを参照 - - name: Install dependencies - run: npm ci - - - name: Connect to PostgreSQL - # PostgreSQLクライアントを作成し、クライアントにデータを展開し、 - # データを取り出すスクリプトを実行 - run: node client.js - # `client.js`スクリプトが新しいPostgreSQLクライアントの作成に使う環境変数 - env: - # PostgreSQLサービスコンテナとの通信に使われるホスト名 - POSTGRES_HOST: postgres - # デフォルトのPostgreSQLポート - POSTGRES_PORT: 5432 -``` -{% endraw %} - -#### ランナージョブの設定 - -{% data reusables.github-actions.service-container-host %} - -{% data reusables.github-actions.postgres-label-description %} - -```yaml -jobs: - # コンテナジョブのラベル - container-job: - # コンテナはLinuxベースのオペレーティングシステム内で実行しなければならない - runs-on: ubuntu-latest - # `container-job`が実行されるDocker Hubのイメージ - container: node:10.18-jessie - - # `container-job`と実行されるサービスコンテナ - services: - # サービスコンテナへのアクセスに使われるラベル - postgres: - # Docker Hubのイメージ - image: postgres - # postgresのパスワードを提供 - env: - POSTGRES_PASSWORD: postgres - # postgresが起動するまで待つヘルスチェックの設定 - options: >- - --health-cmd pg_isready - --health-interval 10s - --health-timeout 5s - --health-retries 5 -``` - -#### ステップの設定 - -{% data reusables.github-actions.service-template-steps %} - -```yaml -steps: - # CIテストの実行前にリポジトリのコードのコピーをダウンロード - - name: Check out repository code - uses: actions/checkout@v2 - - # `package.json`ファイル中のすべての依存関係のクリーンインストールを実行 - # 詳しい情報については https://docs.npmjs.com/cli/ci.html を参照 - - name: Install dependencies - run: npm ci - - - name: Connect to PostgreSQL - # PostgreSQLクライアントを作成し、クライアントにデータを展開し、 - # データを取り出すスクリプトを実行 - run: node client.js - # `client.js`スクリプトが新しいPostgreSQLクライアントを作成する際に - # 利用する環境変数 - env: - # PostgreSQLサービスコンテナとの通信に使われるホスト名 - POSTGRES_HOST: postgres - # デフォルトのPostgreSQLポート - POSTGRES_PORT: 5432 -``` - -{% data reusables.github-actions.postgres-environment-variables %} - -PostgreSQLサービスのホスト名は、ワークフロー中で設定されたラベルで、ここでは`postgres`です。 同じユーザー定義ブリッジネットワーク上のDockerコンテナは、デフォルトですべてのポートをオープンするので、サービスコンテナにはデフォルトのPostgreSQLのポートである5432でアクセスできます。 - -### ランナーマシン上で直接のジョブの実行 - -ランナーマシン上で直接ジョブを実行する場合、サービスコンテナ上のポートをDockerホスト上のポートにマップしなければなりません。 Dockerホストからサービスコンテナへは、`localhost`とDockerホストのポート番号を使ってアクセスできます。 - -{% data reusables.github-actions.copy-workflow-file %} - -{% raw %} -```yaml -name: PostgreSQL Service Example -on: push - -jobs: - # ランナージョブのラベル - runner-job: - # サービスコンテナもしくはコンテナジョブを使う場合にはLinux環境を使わなければならない - runs-on: ubuntu-latest - - # `runner-job`と実行されるサービスコンテナ - services: - # サービスコンテナへのアクセスに使われるラベル - postgres: - # Docker Hubのイメージ - image: postgres - # postgresのパスワードを提供 - env: - POSTGRES_PASSWORD: postgres - # posgresが起動するまで待つヘルスチェックの設定 - options: >- - --health-cmd pg_isready - --health-interval 10s - --health-timeout 5s - --health-retries 5 - ports: - # サービスコンテナ上のTCPポート5432をホストにマップ - - 5432:5432 - - steps: - # CIテストの実行前にリポジトリからコードのコピーをダウンロード - - name: Check out repository code - uses: actions/checkout@v2 - - # `package.json`ファイル内のすべての依存関係のクリーンインストールを実行 - # 詳しい情報についてはhttps://docs.npmjs.com/cli/ci.htmlを参照 - - name: Install dependencies - run: npm ci - - - name: Connect to PostgreSQL - # PostgreSQLクライアントを作成し、クライアントにデータを展開し、 - # データを取り出すスクリプトを実行 - run: node client.js - # `client.js`スクリプトが新しいPostgreSQLクライアントの - # 作成に使う環境変数 - env: - # PostgreSQLサービスコンテナとの通信に使われるホスト名 - POSTGRES_HOST: localhost - # デフォルトのPostgreSQLポート - POSTGRES_PORT: 5432 -``` -{% endraw %} - -#### ランナージョブの設定 - -{% data reusables.github-actions.service-container-host-runner %} - -{% data reusables.github-actions.postgres-label-description %} - -このワークフローはPostgreSQLサービスコンテナ上のポート5432をDockerホストにマップします。 `ports`キーワードに関する詳しい情報については「[サービスコンテナについて](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)」を参照してください。 - -```yaml -jobs: - # ランナージョブのラベル - runner-job: - # サービスコンテナもしくはコンテナジョブを使う場合にはLinux環境を使わなければならない - runs-on: ubuntu-latest - - # `runner-job`と実行されるサービスコンテナ - services: - # サービスコンテナへのアクセスに使われるラベル - postgres: - # Docker Hubのイメージ - image: postgres - # postgresにパスワードを提供 - env: - POSTGRES_PASSWORD: postgres - # postgresが起動するまで待つヘルスチェックの設定 - options: >- - --health-cmd pg_isready - --health-interval 10s - --health-timeout 5s - --health-retries 5 - ports: - # サービスコンテナ上のTCPポート5432をホストにマップ - - 5432:5432 -``` - -#### ステップの設定 - -{% data reusables.github-actions.service-template-steps %} - -```yaml -steps: - # CIテストの実行前にリポジトリのコードのコピーをダウンロード - - name: Check out repository code - uses: actions/checkout@v2 - - # `package.json`ファイル中のすべての依存関係のクリーンインストールを実行 - # 詳しい情報については https://docs.npmjs.com/cli/ci.html を参照 - - name: Install dependencies - run: npm ci - - - name: Connect to PostgreSQL - # PostgreSQLクライアントを作成し、クライアントにデータを展開し、 - # データを取り出すスクリプトを実行 - run: node client.js - # `client.js`スクリプトが新しいPostgreSQLクライアントを作成する際に - # 利用する環境変数 - env: - # PostgreSQLサービスコンテナとの通信に使われるホスト名 - POSTGRES_HOST: localhost - # デフォルトのPostgreSQLポート - POSTGRES_PORT: 5432 -``` - -{% data reusables.github-actions.postgres-environment-variables %} - -{% data reusables.github-actions.service-container-localhost %} - -### PostgreSQLサービスコンテナのテスト - -ワークフローを以下のスクリプトでテストできます。このスクリプトはPostgreSQLクライアントを作成し、いくつかのプレースホルダーデータで新しいテーブルを追加します。 そしてこのスクリプトは、PostgreSQLクライアント内に保存された値をターミナルに出力します。 スクリプトには好きな言語を使えますが、この例ではNode.jsとnpmモジュールの`pg`を使っています。 詳しい情報については[npm pgモジュール](https://www.npmjs.com/package/pg)を参照してください。 - -*client.js*を修正して、ワークフローで必要なPostgreSQLの操作を含めることができます。 この例では、スクリプトはPostgreSQLクライアントのインスタンスを作成し、テーブルを作成し、プレースホルダーデータを追加し、そしてそのデータを取り出します。 - -{% data reusables.github-actions.service-container-add-script %} - -```javascript -const { Client } = require('pg'); - -const pgclient = new Client({ - host: process.env.POSTGRES_HOST, - port: process.env.POSTGRES_PORT, - user: 'postgres', - password: 'postgres', - database: 'postgres' -}); - -pgclient.connect(); - -const table = 'CREATE TABLE student(id SERIAL PRIMARY KEY, firstName VARCHAR(40) NOT NULL, lastName VARCHAR(40) NOT NULL, age INT, address VARCHAR(80), email VARCHAR(40))' -const text = 'INSERT INTO student(firstname, lastname, age, address, email) VALUES($1, $2, $3, $4, $5) RETURNING *' -const values = ['Mona the', 'Octocat', 9, '88 Colin P Kelly Jr St, San Francisco, CA 94107, United States', 'octocat@github.com'] - -pgclient.query(table, (err, res) => { - if (err) throw err -}); - -pgclient.query(text, values, (err, res) => { - if (err) throw err -}); - -pgclient.query('SELECT * FROM student', (err, res) => { - if (err) throw err - console.log(err, res.rows) // Print the data in student table - pgclient.end() -}); -``` - -このスクリプトは新しいPostgreSQLの`Client`を作成します。これは、パラメーターとして`host`と`port`を受け付けます。 スクリプトは環境変数の`POSTGRES_HOST`と`POSTGRES_PORT`を使って、クライアントのIPアドレスとポートを設定します。 `host`と`port`が定義されていない場合、デフォルトのホストは`localhost`で、デフォルトのポートは5432になります。 - -スクリプトはテーブルを作成し、そのテーブルにプレースホルダーデータを展開します。 PostgreSQLデータベースがデータを含んでいることをテストするために、スクリプトはテーブルの内容をコンソールログに出力します。 - -このワークフローを実行すると、"Connect to PostgreSQL"ステップで以下のように出力され、PostgreSQLのクライアントが作成され、データが追加されたことが確認できます。 - -``` -null [ { id: 1, - firstname: 'Mona the', - lastname: 'Octocat', - age: 9, - address: - '88 Colin P Kelly Jr St, San Francisco, CA 94107, United States', - email: 'octocat@github.com' } ] -``` diff --git a/translations/ja-JP/content/actions/configuring-and-managing-workflows/creating-redis-service-containers.md b/translations/ja-JP/content/actions/configuring-and-managing-workflows/creating-redis-service-containers.md deleted file mode 100644 index 82fdec7c75ac..000000000000 --- a/translations/ja-JP/content/actions/configuring-and-managing-workflows/creating-redis-service-containers.md +++ /dev/null @@ -1,325 +0,0 @@ ---- -title: Redisサービスコンテナの作成 -intro: サービスコンテナを使って、ワークフロー中でRedisのクライアントを作成できます。 このガイドでは、コンテナで実行されるジョブか、ランナーマシン上で直接実行されるジョブのためのRedisサービスの作成例を紹介します。 -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/creating-redis-service-containers -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -### はじめに - -このガイドでは、Docker Hubの`redis`イメージを使ってサービスコンテナを設定するワークフローの例を紹介します。 このワークフローは、Redisのクライアントを作成してクライアントにデータを展開するスクリプトを実行します。 Redisクライアントを作成して展開するワークフローをテストするために、このスクリプトはクライアントのデータをコンソールに出力します。 - -{% data reusables.github-actions.docker-container-os-support %} - -### 必要な環境 - -{% data reusables.github-actions.service-container-prereqs %} - -YAML、{% data variables.product.prodname_actions %}の構文、Redisの基本な理解があれば役立つかも知れません。 詳しい情報については、以下を参照してください。 - -- [ワークフローの設定](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow) -- Redisのドキュメンテーション中の[Getting Started with Redis](https://redislabs.com/get-started-with-redis/) -- [{% data variables.product.prodname_actions %}の中核的概念](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions) -- [環境変数の利用](/actions/automating-your-workflow-with-github-actions/using-environment-variables) - -### コンテナ内でのジョブの実行 - -{% data reusables.github-actions.container-jobs-intro %} - -{% data reusables.github-actions.copy-workflow-file %} - -{% raw %} -```yaml -name: Redis container example -on: push - -jobs: - # コンテナジョブのラベル - container-job: - # コンテナはLinuxベースのオペレーティングシステム内で実行しなければならない - runs-on: ubuntu-latest - # `container-job`が実行されるDocker Hubのイメージ - container: node:10.18-jessie - - # `container-job`と実行されるサービスコンテナ - services: - # サービスコンテナへのアクセスに使われるラベル - redis: - # Docker Hubのイメージ - image: redis - # redisが起動するまで待つヘルスチェックの設定 - options: >- - --health-cmd "redis-cli ping" - --health-interval 10s - --health-timeout 5s - --health-retries 5 - - steps: - # CIテストの実行前にリポジトリからコードのコピーをダウンロード - - name: Check out repository code - uses: actions/checkout@v2 - - # `package.json`ファイル内のすべての依存関係のクリーンインストールの実行 - # 詳しい情報についてはhttps://docs.npmjs.com/cli/ci.htmlを参照 - - name: Install dependencies - run: npm ci - - - name: Connect to Redis - # Redisクライアントを作成し、クライアントにデータを展開し、 - # データを取り出すスクリプトを実行 - run: node client.js - # `client.js`スクリプトが新しいRedisクライアントを作成するのに使う環境変数 - env: - # Redisサービスコンテナとの通信に使われるホスト名 - REDIS_HOST: redis - # デフォルトのRedisポート - REDIS_PORT: 6379 -``` -{% endraw %} - -#### コンテナジョブの設定 - -{% data reusables.github-actions.service-container-host %} - -{% data reusables.github-actions.redis-label-description %} - -```yaml -jobs: - # コンテナジョブのラベル - container-job: - # コンテナはLinuxベースのオペレーティングシステム内で実行しなければならない - runs-on: ubuntu-latest - # `container-job`が実行されるDocker Hubのイメージ - container: node:10.18-jessie - - # `container-job`と実行されるサービスコンテナ - services: - # サービスコンテナへのアクセスに使われるラベル - redis: - # Docker Hubのイメージ - image: redis - # redisが起動するまで待つヘルスチェックの設定 - options: >- - --health-cmd "redis-cli ping" - --health-interval 10s - --health-timeout 5s - --health-retries 5 -``` - -#### ステップの設定 - -{% data reusables.github-actions.service-template-steps %} - -```yaml -steps: - # CIテストの実行前にリポジトリのコードのコピーをダウンロード - - name: Check out repository code - uses: actions/checkout@v2 - - # `package.json`ファイル中のすべての依存関係のクリーンインストールの実行 - # 詳しい情報については https://docs.npmjs.com/cli/ci.html を参照 - - name: Install dependencies - run: npm ci - - - name: Connect to Redis - # Redisクライアントを作成し、クライアントにデータを展開し、 - # データを取り出すスクリプトを実行 - run: node client.js - # `client.js`スクリプトが新しいRedisクライアントを作成する際に利用する環境変数 - env: - # Redisサービスコンテナとの通信に使われるホスト名 - REDIS_HOST: redis - # デフォルトのRedisポート - REDIS_PORT: 6379 -``` - -{% data reusables.github-actions.redis-environment-variables %} - -Redisサービスのホスト名は、ワークフロー中で設定されたラベルで、ここでは`redis`です。 同じユーザー定義ブリッジネットワーク上のDockerコンテナは、デフォルトですべてのポートをオープンするので、サービスコンテナにはデフォルトのRedisのポートである6379でアクセスできます。 - -### ランナーマシン上で直接のジョブの実行 - -ランナーマシン上で直接ジョブを実行する場合、サービスコンテナ上のポートをDockerホスト上のポートにマップしなければなりません。 Dockerホストからサービスコンテナへは、`localhost`とDockerホストのポート番号を使ってアクセスできます。 - -{% data reusables.github-actions.copy-workflow-file %} - -{% raw %} -```yaml -name: Redis runner example -on: push - -jobs: - # ランナージョブのラベル - runner-job: - # サービスコンテナもしくはコンテナジョブを使う際にはLinux環境を使わなければならない - runs-on: ubuntu-latest - - # `runner-job`と実行されるサービスコンテナ - services: - # サービスコンテナへのアクセスに使われるラベル - redis: - # Docker Hubのイメージ - image: redis - # redisが起動するまで待つヘルスチェックの設定 - options: >- - --health-cmd "redis-cli ping" - --health-interval 10s - --health-timeout 5s - --health-retries 5 - ports: - # サービスコンテナのポート6379をホストにマップ - - 6379:6379 - - steps: - # CIテストの実行前にリポジトリのコードのコピーをダウンロード - - name: Check out repository code - uses: actions/checkout@v2 - - # `package.json`ファイル内のすべての依存関係のクリーンインストールの実行 - # 詳しい情報についてはhttps://docs.npmjs.com/cli/ci.htmlを参照 - - name: Install dependencies - run: npm ci - - - name: Connect to Redis - # Redisクライアントを作成し、クライアントにデータを展開し、 - # データを取り出すスクリプトを実行 - run: node client.js - # `client.js`スクリプトが新しいRedisクライアントを作成するのに - # 使う環境変数 - env: - # Redisサービスコンテナとの通信に使われるホスト名 - REDIS_HOST: localhost - # デフォルトのRedisポート - REDIS_PORT: 6379 -``` -{% endraw %} - -#### ランナージョブの設定 - -{% data reusables.github-actions.service-container-host-runner %} - -{% data reusables.github-actions.redis-label-description %} - -このワークフローはRedisサービスコンテナ上のポート6379をDockerホストにマップします。 `ports`キーワードに関する詳しい情報については「[サービスコンテナについて](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)」を参照してください。 - -```yaml -jobs: - # ランナージョブのラベル - runner-job: - # サービスコンテナもしくはコンテナジョブを使う際にはLinux環境を使わなければならない - runs-on: ubuntu-latest - - # `runner-job`と実行するサービスコンテナ - services: - # サービスコンテナへのアクセスに使うラベル - redis: - # Docker Hubのイメージ - image: redis - # redisが起動するまで待つヘルスチェックの設定 - options: >- - --health-cmd "redis-cli ping" - --health-interval 10s - --health-timeout 5s - --health-retries 5 - ports: - # サービスコンテナ上のポート6379をホストにマップ - - 6379:6379 -``` - -#### ステップの設定 - -{% data reusables.github-actions.service-template-steps %} - -```yaml -steps: - # CIテストの実行前にリポジトリのコードのコピーをダウンロード - - name: Check out repository code - uses: actions/checkout@v2 - - # `package.json`ファイル中のすべての依存関係のクリーンインストールの実行 - # 詳しい情報については https://docs.npmjs.com/cli/ci.html を参照 - - name: Install dependencies - run: npm ci - - - name: Connect to Redis - # Redisクライアントを作成し、クライアントにデータを展開し、 - # データを取り出すスクリプトを実行 - run: node client.js - # `client.js`スクリプトが新しいRedisクライアントを作成する際に - # 利用する環境変数 - env: - # Redisサービスコンテナとの通信に使われるホスト名 - REDIS_HOST: localhost - # デフォルトのRedisポート - REDIS_PORT: 6379 -``` - -{% data reusables.github-actions.redis-environment-variables %} - -{% data reusables.github-actions.service-container-localhost %} - -### Redisサービスコンテナのテスト - -ワークフローを以下のスクリプトでテストできます。このスクリプトはRedisクライアントを作成し、いくつかのプレースホルダーデータをクライアントに展開します。 そしてこのスクリプトは、Redisクライアント内に保存された値をターミナルに出力します。 スクリプトには好きな言語を使えますが、この例ではNode.jsとnpmモジュールの`redis`を使っています。 詳しい情報については[npm redisモジュール](https://www.npmjs.com/package/redis)を参照してください。 - -*client.js*を修正して、ワークフローで必要なRedisの操作を含めることができます。 この例では、スクリプトはRedisクライアントのインスタンスを作成し、プレースホルダーデータを追加し、そしてそのデータを取り出します。 - -{% data reusables.github-actions.service-container-add-script %} - -```javascript -const redis = require("redis"); - -// 新しいRedisクライアントの作成 -// REDIS_HOSTが設定されていなければ、デフォルトのホストはlocalhost -// REDIS_PORTが設定されていなければ、デフォルトのポートは6379 -const redisClient = redis.createClient({ - host: process.env.REDIS_HOST, - port: process.env.REDIS_PORT -}); - -redisClient.on("error", function(err) { - console.log("Error " + err); -}); - -// キー"octocat"に"Mona the octocat"という値を設定 -redisClient.set("octocat", "Mona the Octocat", redis.print); -// キーを"octocat"、フィールドを"species"、"value"を"Cat and Octopus"に設定 -redisClient.hset("species", "octocat", "Cat and Octopus", redis.print); -// キーを"octocat"、フィールドを"species"、"value"を"Dinosaur and Octopus"に設定 -redisClient.hset("species", "dinotocat", "Dinosaur and Octopus", redis.print); -// キーを"octocat"、フィールドを"species"、 "value"を"Cat and Robot"に設定 -redisClient.hset(["species", "robotocat", "Cat and Robot"], redis.print); -// キー"species"のすべてのフィールドを取得 - -redisClient.hkeys("species", function (err, replies) { - console.log(replies.length + " replies:"); - replies.forEach(function (reply, i) { - console.log(" " + i + ": " + reply); - }); - redisClient.quit(); -}); -``` - -このスクリプトは新しいRedisクライアントを`createClient`メソッドを使って作成します。これは、パラメーターとして`host`と`port`を受け付けます。 スクリプトは環境変数の`REDIS_HOST`と`REDIS_PORT`を使って、クライアントのIPアドレスとポートを設定します。 `host`と`port`が定義されていない場合、デフォルトのホストは`localhost`で、デフォルトのポートは6379になります。 - -このスクリプトは、`set`及び`hset`メソッドを使ってデータベースにいくつかのキー、フィールド、値を展開します。 Redisデータベースがデータを含んでいることを確認するために、スクリプトはデータベースの内容をコンソールログに出力します。 - -このワークフローを実行すると、"Connect to Redis"ステップで以下のように出力され、Redisのクライアントが作成され、データが追加されたことが確認できます。 - -``` -Reply: OK -Reply: 1 -Reply: 1 -Reply: 1 -3 replies: - 0: octocat - 1: dinotocat - 2: robotocat -``` diff --git a/translations/ja-JP/content/actions/configuring-and-managing-workflows/index.md b/translations/ja-JP/content/actions/configuring-and-managing-workflows/index.md deleted file mode 100644 index 05ea35a7832c..000000000000 --- a/translations/ja-JP/content/actions/configuring-and-managing-workflows/index.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: ワークフローの設定と管理 -shortTitle: ワークフロー -intro: カスタムのワークフローを作成し、実行を管理することによって、プロジェクトのソフトウェア開発ライフサイクスのプロセスをコントロールできます。 -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -{% topic_link_in_list /configuring-and-managing-workflow-files-and-runs %} - {% link_in_list /configuring-a-workflow %} - {% link_in_list /managing-a-workflow-run %} - {% link_in_list /sharing-workflow-templates-within-your-organization %} -{% topic_link_in_list /using-variables-and-secrets-in-a-workflow %} - {% link_in_list /creating-and-storing-encrypted-secrets %} - {% link_in_list /using-environment-variables %} - {% link_in_list /authenticating-with-the-github_token %} -{% topic_link_in_list /caching-and-storing-workflow-data %} - {% link_in_list /persisting-workflow-data-using-artifacts %} - {% link_in_list /caching-dependencies-to-speed-up-workflows %} -{% topic_link_in_list /using-databases-and-service-containers %} - {% link_in_list /about-service-containers %} - {% link_in_list /creating-redis-service-containers %} - {% link_in_list /creating-postgresql-service-containers %} diff --git a/translations/ja-JP/content/actions/configuring-and-managing-workflows/managing-a-workflow-run.md b/translations/ja-JP/content/actions/configuring-and-managing-workflows/managing-a-workflow-run.md deleted file mode 100644 index c18f09604a8b..000000000000 --- a/translations/ja-JP/content/actions/configuring-and-managing-workflows/managing-a-workflow-run.md +++ /dev/null @@ -1,251 +0,0 @@ ---- -title: ワークフローの実行の管理 -intro: ワークフローの各ステップのステータスと結果の表示、保留中のワークフローのキャンセル、請求可能なジョブ実行時間の表示、失敗したワークフローのデバッグと再実行、ログの検索とダウンロード、アーティファクトのダウンロードを行うことができます。 -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/viewing-your-repository-s-workflows - - /articles/viewing-your-repositorys-workflows - - /articles/managing-a-workflow-run - - /github/automating-your-workflow-with-github-actions/managing-a-workflow-run - - /actions/automating-your-workflow-with-github-actions/managing-a-workflow-run -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -### ワークフロー管理について - -ワークフローの実行ページから、ワークフローの実行が進行中か完了しているかを確認できます。 実行が進行中の場合はキャンセルできます。 パブリックなリポジトリの分も含むワークフローの実行情報を見るには、{% data variables.product.prodname_dotcom %}のアカウントにログインしなければなりません。 詳細は「[GitHub 上のアクセス権限](/articles/access-permissions-on-github)」を参照してください。 - -実行が完了している場合には、結果が成功か失敗か、キャンセルされたか、またはニュートラルかを確認できます。 実行が失敗した場合には、ビルドログを表示して検索し、失敗の原因を診断してワークフローを再実行することもできます。 また、課金対象のジョブ実行時間を表示したり、ログをダウンロードして成果物をビルドすることもできます。 - - ![アナンスされたワークフロー実行イメージ](/assets/images/help/repository/annotated-workflow.png) - -{% data variables.product.prodname_actions %}は、Checks APIを使用してワークフローのステータス、結果、ログを出力します。 {% data variables.product.prodname_dotcom %} は、ワークフローの実行に対してそれぞれ新しいチェックスイートを作成します。 チェックスイートには、ワークフロー内の各ジョブに対するチェック実行が含まれ、各ジョブにはステップが含まれています。 {% data variables.product.prodname_actions %}は、ワークフローのステップとして実行されます。 チェック API の詳細については、「[チェック](/v3/checks/)」を参照してください。 - -{% data reusables.github-actions.invalid-workflow-files %} - -### ワークフロー履歴を表示する - -ワークフローの実行の各ジョブと、ジョブの各ステップを表示することができます。 詳しい情報については、「[{% data variables.product.prodname_actions %}の中核的概念](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions#job)」を参照してください。 {% data reusables.repositories.permissions-statement-read %} - -ワークフローファイルで設定されたステップに加えて、各ジョブにはジョブの実行の開始と完了のための追加タスクも含まれます。 これらのステップは、"Set up job"及び"Complete job"としてワークフローの実行にログインします。 - -{% data variables.product.prodname_dotcom %}ホストランナー上のジョブの実行では、"Set up job"はランナーの仮想環境の詳細を記録し、ランナーマシン上にあったプリインストールされたツールのリストへのリンクを含みます。 - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -6. あるいは実行が失敗した場合にワークフローを再実行するには、ワークフローの右上隅で [**Re-run checks**] ドロップダウンメニューから [**Re-run all checks**] を選択します。 ![[Re-run checks] ドロップダウンメニュー](/assets/images/help/repository/rerun-checks-drop-down.png) - -### ワークフローの実行をキャンセルする - -ワークフローの実行をキャンセルすると、 {% data variables.product.prodname_dotcom %} はそのワークフローの一部であるすべてのジョブとステップをキャンセルします。 {% data reusables.repositories.permissions-statement-write %} - -ワークフローの実行をキャンセルする場合、ワークフローの実行に関連するリソースを使用する他のソフトウェアを実行している可能性があります。 ワークフローの実行に関連するリソースを解放するために、ワークフローの実行をキャンセルするために {% data variables.product.prodname_dotcom %} が実行する手順を理解するのに役立ちます。 詳細については、「ワークフローの実行をキャンセルする[手順」](#steps-github-takes-to-cancel-a-workflow-run){% data variables.product.prodname_dotcom %} 参照してください。 - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -1. ワークフローの右上隅で、[**Cancel check suite**] をクリックします。 ![[Cancel check suite] ボタン](/assets/images/help/repository/cancel-check-suite.png) -1. [スイート **キャンセル] をクリック**。 - -#### ワークフローの実行をキャンセル {% data variables.product.prodname_dotcom %} 手順 - -1. ワークフローの実行をキャンセルするには、現在実行中のすべてのジョブに対して条件     `を再評価します。 条件が true`に評価 `場合、ジョブはキャンセルされません。 例えば、条件 : always()` が true と評価され、ジョブの実行が継続されます。 条件がない場合、前のステップが正常に終了した場合にのみ実行される条件 `の条件と同等です`。 -2. キャンセルする必要があるジョブについては、サーバーは、キャンセルする必要があるジョブを持つすべてのランナー マシンにキャンセル メッセージを送信します。 -3. 実行を継続するジョブの場合、サーバーは、未完了のステップの条件 場合、 `を再評価します。 条件が true`に `評価された場合、ステップは引き続き実行されます。 -
  • キャンセルが必要なステップの場合、ランナーマシンは、ステップのエントリープロセスに SIGINT/Ctrl-C` を送信します(javascriptアクションの`ノード` 、コンテナアクションのドッカー を `、ステップで実行` `を使用する場合は のbash/cmd/pwd` を送信します)。 プロセスが 7500 ミリ秒以内に終了しない場合、ランナーは `SIGTERM/Ctrl-Break` をプロセスに送信し、プロセスが終了するまで 2500 ミリ秒待ちます。 プロセスがまだ実行中の場合、ランナーはプロセスツリーを強制終了します。 -5. 5 分間のキャンセル タイムアウト期間が経過すると、サーバーは、実行を完了しないか、キャンセルプロセスを完了できなかったすべてのジョブとステップを強制的に終了します。 - -### ワークフロー実行の削除 - -完了したワークフロー実行、または 2 週間を超えるワークフロー実行を削除できます。 {% data reusables.repositories.permissions-statement-write %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -1. ワークフロー実行を削除するには、[ {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} ] ドロップダウン メニューを使用して、[ワークフローの削除 ****を実行する] を選択します。 - - ![ワークフロー実行の削除](/assets/images/help/settings/workflow-delete-run.png) -1. 確認プロンプトを確認し、[はい、このワークフロー実行を完全に削除 **をクリックします。

    - - ![ワークフロー実行確認の削除](/assets/images/help/settings/workflow-delete-run-confirmation.png)
    • - -{% if currentVersion == "free-pro-team@latest" %} - -### 課金対象のジョブの実行時間 (分) の表示 - -ジョブの実行時間 (ジョブの発生した支払対象の分を含む) を表示できます。 - -課金対象のジョブ実行時間 (分) は、ホストされているランナー {% data variables.product.prodname_dotcom %}使用するプライベート リポジトリで実行されるジョブに対してのみ表示されます。 パブリック リポジトリで {% data variables.product.prodname_actions %} を使用する場合や、セルフ ホストランナーで実行されるジョブに対して課金対象の時間がありません。 - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -1. ジョブの概要の下の [実行と課金対象の時間の詳細 **] をクリック**。 ![実行および支払請求可能な時間の詳細リンク](/assets/images/help/repository/view-run-billable-time.png) - - {% note %} - - **注:** 表示される請求可能な時間には、丸めや分数の乗数は含まれません。 丸めと分の乗数を含む {% data variables.product.prodname_actions %} の総使用量を表示するには、「 {% data variables.product.prodname_actions %} の使用状況を表示する」 -参照してください。

    - - {% endnote %} - - {% endif %} - - - -### ログを表示してエラーを診断する - -ワークフローの実行を失敗した場合には、どのステップが失敗の原因になったかを確認し、失敗したステップのビルドログを確かめてトラブルシューティングすることができます。 各ステップの実行にかかった時間もわかります。 ログファイルの特定の行のパーマリンクをコピーして、チームで共有することもできます。 {% data reusables.repositories.permissions-statement-read %} - -{% data variables.product.product_name %}は、完全なビルドログと成果物が90日間保存されます。 - -{% data reusables.repositories.navigate-to-repo %} - - - -{% data reusables.repositories.actions-tab %} - - - -{% data reusables.repositories.navigate-to-workflow %} - - - -{% data reusables.repositories.view-run %} - - - -{% data reusables.repositories.navigate-to-job %} - -6. ログを展開して、失敗したステップを確認するには、ステップをクリックします。 ![失敗したステップの名前](/assets/images/help/repository/failed-check-step.png) - -7. あるいはログの中の特定の行へのリンクを取得するには、そのステップの行番号をクリックします。 Webブラウザのアドレスバーからリンクをコピーできます。 ![リンクをコピーするボタン](/assets/images/help/repository/copy-link-button.png) - - - -### ログを検索する - -特定のステップのビルドログを検索できます。 ログを検索する際、展開されているステップのみが結果に含まれます。 {% data reusables.repositories.permissions-statement-read %} - -{% data reusables.repositories.navigate-to-repo %} - - - -{% data reusables.repositories.actions-tab %} - - - -{% data reusables.repositories.navigate-to-workflow %} - - - -{% data reusables.repositories.view-run %} - - - -{% data reusables.repositories.navigate-to-job %} - -6. 検索に含めたい各ステップを展開するには、そのステップをクリックします。![ステップの名前](/assets/images/help/repository/failed-check-step.png) - -7. ログ出力の右上隅にある [**Search logs**] 検索ボックスに、検索語句を入力します。 ![ログを検索するための検索ボックス](/assets/images/help/repository/search-log-box.png) - - - -### ログのダウンロード - -ワークフローの実行からは、ログファイルをダウンロードできます。 また、ワークフローの成果物もダウンロードできます。 詳しい情報については「[成果物を利用してワークフローのデータを永続化する](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)」を参照してください。 {% data reusables.repositories.permissions-statement-read %} - -{% data reusables.repositories.navigate-to-repo %} - - - -{% data reusables.repositories.actions-tab %} - - - -{% data reusables.repositories.navigate-to-workflow %} - - - -{% data reusables.repositories.view-run %} - -5. ログをダウンロードするには、[**Download logs**] ドロップダウンメニューから、ダウンロードしたいログを選択します。 ![[Download logs] ドロップダウンメニュー](/assets/images/help/repository/download-logs-drop-down.png) - - - -### ログの削除 - -ワークフローの実行からログファイルを削除できます。 {% data reusables.repositories.permissions-statement-write %} - -{% data reusables.repositories.navigate-to-repo %} - - - -{% data reusables.repositories.actions-tab %} - - - -{% data reusables.repositories.navigate-to-workflow %} - - - -{% data reusables.repositories.view-run %} - -5. ログファイルを削除するには、**Delete all logs（すべてのログを削除）**ボタンをクリックして、確認の要求を見てください 。 ![Delete all logs](/assets/images/help/repository/delete-all-logs.png) ログを削除すると、**Delete all logs（すべてのログを削除）**ボタンはなくなり、ワークフローの実行中にログファイルが残っていないことを示します。 - - - -### デバッグロギングの有効化 - -ワークフロージョブあるいはステップが期待どおりに動作しない理由を診断する上で、十分な詳細がワークフローのログになかった場合、追加のデバッグロギングを有効化できます。 - -これらの追加ログは、ワークフローを含むリポジトリにシークレットを設定することで有効になるため、同じ権限要件が適用されます。 - -- {% data reusables.github-actions.permissions-statement-secrets-organization %} -- {% data reusables.github-actions.permissions-statement-secrets-repository %} -- {% data reusables.github-actions.permissions-statement-secrets-api %} - -シークレットの設定に関する詳しい情報については、「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 - - - -#### ランナーの診断ロギングの有効化 - -ランナーの診断ログは、ランナーによるジョブの実行の様子に関する情報を含む追加のログファイルを提供します。 ログアーカイブには、2つのログファイルが追加されます。 - -* ランナープロセスログにはジョブの実行のためのランナーの調整とセットアップに関する情報が含まれます。 -* ワーカープロセスログには、ジョブの実行が記録されます。 - -1. ランナー診断ロギングを有効化するには、ワークフローを含むリポジトリ内で以下のシークレットを設定してください： `ACTIONS_RUNNER_DEBUG`を`true`にしてください。 - -1. ランナーの診断ログをダウンロードするには、ワークフローの実行のログアーカイブをダウンロードしてください。 ランナーの診断ログは`runner-diagnostic-logs`フォルダに含まれています。 ログのダウンロードに関する詳しい情報については「[ログのダウンロード](#downloading-logs)」を参照してください。 - - - -#### ステップのデバッグロギングの有効化 - -ステップのデバッグロギングは、ジョブの実行の間と実行後のジョブのログの詳細度を高めます。 - -1. ステップのデバッグロギングを有効化するには、ワークフローを含むリポジトリで以下のシークレットを設定しなければなりません： `ACTIONS_STEP_DEBUG`を`true`にしてください。 - -1. このシークレットを設定すると、ステップログにより多くのデバッグイベントが示されるようになります。 詳しい情報については「[障害の診断のためのログの閲覧](#viewing-logs-to-diagnose-failures)」を参照してください。 - - - - -### 参考リンク - -- "[{% data variables.product.prodname_actions %}について](/articles/about-github-actions)" -- "[ワークフローの設定](/articles/configuring-a-workflow)" -- [{% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions)のワークフロー構文 -- [ワークフローをトリガーするイベント](/articles/events-that-trigger-workflows) -- "[{% data variables.product.prodname_dotcom %}ホストランナーの仮想環境](/actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)" diff --git a/translations/ja-JP/content/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts.md b/translations/ja-JP/content/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts.md deleted file mode 100644 index e25aca8f6d08..000000000000 --- a/translations/ja-JP/content/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts.md +++ /dev/null @@ -1,281 +0,0 @@ ---- -title: アーティファクトを使用してワークフローデータを永続化する -intro: アーティファクトを使うと、ワークフローが完了したときに、そのワークフローのジョブとストアデータの間でデータを共有することができます。 -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/persisting-workflow-data-using-artifacts - - /github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts - - /actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -### ワークフローの成果物について - -成果物を使えば、ジョブの完了後にデータを永続化でき、そのデータを同じワークフロー中の他のジョブと共有できます。 アーティファクトとは、ワークフロー実行中に生成されるファイル、またはファイルのコレクションです。 たとえば、成果物を使ってワークフローの実行が終了した後、ビルドとテストの出力を保存しておけます。 プッシュとプルリクエストについては、{% data variables.product.product_name %}は90日間成果物を保存します。 プルリクエストの場合の保持期間は、そのプルリクエストに対して新しいコミットがプッシュされるたびにリセットされます。 - -以下は、アップロードできる一般的な成果物の一部です。 - -- ログファイルとコアダンプ -- テスト結果、エラー、スクリーンショット -- バイナリあるいは圧縮されたファイル -- ストレステストのパフォーマンス出力およびコード網羅率の結果 - -{% if currentVersion == "free-pro-team@latest" %} - -成果物の保存には、{% data variables.product.product_name %}上のストレージ領域が使われます。 {% data reusables.github-actions.actions-billing %} 詳細は「[{% data variables.product.prodname_actions %} の支払いの管理](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)」を参照してください。 - -{% else %} - -アーティファクトは、 {% data variables.product.product_location %}で {% data variables.product.prodname_actions %} 用に構成された外部 BLOB ストレージのストレージ領域を消費します。 - -{% endif %} - -成果物はワークフローの実行中にアップロードされ、成果物の名前とサイズはUIで見ることができます。 {% data variables.product.product_name %}のUIを使って成果物がダウンロードされる場合、成果物の一部として個別にアップロードされたすべてのファイルはzipして1つのファイルにまとめられます。 これはすなわち、支払いはこのzipファイルのサイズではなく、アップロードされた成果物のサイズを元に計算されるということです。 - -{% data variables.product.product_name %}には、ビルドアーティファクトのアップロードとダウンロードに使用できるアクションが2つあります。 詳細については、[actions/upload-artifact](https://github.com/actions/upload-artifact)アクションと[download-artifact](https://github.com/actions/download-artifact)アクションを参照してください。 - -ジョブ間でデータを共有するには: - -* **ファイルをアップロード**: アップロードされたファイルに名前を付けて、ジョブが終了する前にデータをアップロードしてください。 -* **ファイルをダウンロード**: 成果物は、同じワークフローの実行中にアップロードされたものだけがダウンロードできます。 ファイルをダウンロードする際には、名前で参照できます。 - -ジョブのステップは、ランナーマシン上で同じ環境を共有しますが、それぞれが個別のプロセス内で実行されます。 ジョブのステップ間のデータを受け渡すには、入力と出力を使用できます。 入力と出力の詳細については、「[{% data variables.product.prodname_actions %}構文のメタデータ](/articles/metadata-syntax-for-github-actions)」を参照してください。 - -### ワークフローのジョブ間でデータを受け渡す - -`upload-artifact`アクションと`download-artifact`アクションを使うと、ワークフローのジョブ間でデータを共有できます。 以下のワークフローの例では、同じワークフローのジョブ間でデータを受け渡す方法を説明しています。 詳細については、[actions/upload-artifact](https://github.com/actions/upload-artifact)アクションと[download-artifact](https://github.com/actions/download-artifact)アクションを参照してください。 - -前のジョブのアーティファクトに依存するジョブは、前のジョブが正常に完了するまで待つ必要があります。 このワークフローは、`needs`キーワードを使用して`job_1`、`job_2`、`job_3`を順次実行することができます。 たとえば、`job_2`には`needs: job_1`構文を使用する`job_1`が必要です。 - -ジョブ1は、以下のステップを実行します。 -- 数式の計算を実行し、その結果を`math-homework.txt`というテキストファイルに保存します。 -- `upload-artifact`アクションを使って、`math-homework.txt`ファイルを`homework`という名前でアップロードします。 このアクションで、ファイルが`homework`という名前のディレクトリに配置されます。 - -ジョブ2は、前のジョブの結果を利用して、次の処理を実行します。 -- 前のジョブでアップロードされた`homework`成果物をダウンロードします。 デフォルトでは、`download-artifact`アクションは、ステップが実行されているワークスペースディレクトリに成果物をダウンロードします。 入力パラメータの`path`を使って、別のダウンロードディレクトリを指定することもできます。 -- `homework/math-homework.txt`ファイル中の値を読み取り、数式の計算を実行し、結果を`math-homework.txt`に保存します。 -- `math-homework.txt`ファイルをアップロードします。 このアップロードは、前のアップロードを上書きします。どちらも同じ名前を使っているからです。 - -ジョブ3は、前のジョブでアップロードされた結果を表示して、次の処理を実行します。 -- `homework`成果物をダウンロードします。 -- 数式の結果をログに出力します。 - -このワークフロー例で実行される完全な数式は、`(3 + 7) x 9 = 90`です。 - -```yaml -名前: - -ジョブ間でデータを共有: [push] - -ジョブ: - job_1: - 名: 3 と 7 - 実行を追加: ubuntu 最新 - ステップ: - - シェル: バッシュ - 実行: | - expr 3 + 7 > math-homework.txt - - 名前: ジョブ1の数学の結果をアップロード - 使用: アクション/アップロードartifact@v2 - 使用: - 名: 宿題 - パス: math-homework.txt - - job_2: - 名: job_1 - の - ニーズ: job_1 実行: windows-最新 - ステップ: - - 名前: ジョブ1 - の数学結果をダウンロード使用: アクション/ダウンロードartifact@v2 - - - - : - 値='cat math-homework.txt' - は、数学-homework.txt - $value 9 > - 名前:ジョブ2 - の数学の結果をアップロード使用:アクション/アップロードartifact@v2 - : - 名:宿題 - パス:数学-宿題.txt - - job_3: - 名 結果 - 表示:のニーズを表示する:job_2 - 実行:macOS最新 - ステップ: - - 名前:ジョブ2の数学の結果をダウンロード - 使用:アクション/ダウンロードartifact@v2 - : - 名:宿題 - - 名前:シェル - 最終結果を印刷する:バッシュ - 実行: | - 値='cat数学宿題.txt' - エコー 結果は $value -``` - -![ジョブ間でデータを受け渡して数学を実行するワークフロー](/assets/images/help/repository/passing-data-between-jobs-in-a-workflow.png) - -### ワークフロー実行間でデータを共有する - -ワークフローが終了した後、**Actions**タブでワークフローの実行を見つけて、{% data variables.product.product_name %}上にアップロードされた成果物の圧縮ファイルをダウンロードできます。 {% data variables.product.prodname_dotcom %}のREST APIを使って成果物をダウンロードすることもできます。 詳細については、「アーティファクト - -」を参照してください。

    - -{% data variables.product.product_name %}には、ビルドの成果物のアップロードとダウンロードに使用できるアクションが2つあります。 詳細については、[actions/upload-artifact](https://github.com/actions/upload-artifact)アクションと[download-artifact](https://github.com/actions/download-artifact)アクションを参照してください。 - - - -### ビルドおよびテストの成果物をアップロードする - -継続的インテグレーション（CI）ワークフローを作成して、コードのビルドやテストを行えます。 {% data variables.product.prodname_actions %} を使用して CI を実行する方法の詳細については、「継続的な統合について」を参照してください。

    - -コードのビルドおよびテストを出力すると多くの場合、エラーのデバッグに使用できるファイルと、デプロイできる本番コードが生成されます。 リポジトリにプッシュされるコードをビルドしてテストし、成功または失敗のステータスをレポートするワークフローを構成することができます。 デプロイメントに使用するビルドおよびテスト出力をアップロードし、失敗したテストまたはクラッシュをデバッグしてテストスイートの範囲を確認できます。 - -成果物をアップロードするには、`upload-artifact`アクションが使用できます。 成果物をアップロードする場合は、単一のファイルまたはディレクトリー、または複数のファイルまたはディレクトリーを指定できます。 また、特定のファイルやディレクトリを除外したり、ワイルドカードパターンを使用したりすることもできます。 アーティファクトの名前を指定することをお勧めしますが、名前を指定しない場合は、 `アーティファクト` が既定の名前として使用されます。 構文の詳細については、 {% data variables.product.product_location %}{% endif %}のアクション/アーティファクトのアップロード アクション{% else %} `アクション/` アーティファクトのアップロードアクションを {% if currentVersion == "free-pro-team@latest" %}するを参照してください。

    - - - -#### サンプル - -たとえば、リポジトリあるいはWebアプリケーションにはCSSやJavaScriptに変換しなければならないSASSやTypeScriptが含まれているかもしれません。 ビルド構成が`dist`ディレクトリにコンパイル後のファイルを出力すると仮定すると、テストがすべて正常に完了した場合、`dist`ディレクトリにあるファイルがWebアプリケーションにデプロイされます。 - - - -``` -|-- hello-world (repository) -| └── dist -| └── tests -| └── src -| └── sass/app.scss -| └── app.ts -| └── output -| └── test -| -``` - - -この例では、`src`ディレクトリにコードを`builds`して、`tests`ディレクトリでテストを実行するNode.jsプロジェクトのワークフローを作成しています。 実行中の`npm test`が、`code-coverage.html`という名前で、`output/test/`ディレクトリに保存されるコード網羅率レポートを生成すると想定できます。 - -ワークフローは、 `dist` ディレクトリにプロダクション アーティファクトをアップロードしますが、マークダウン ファイルは除きます。 また、 `の code-coverage.html` レポートを別のアーティファクトとしてアップロードします。 - - - -```yaml -名前: ノード CI - -: [push] - -ジョブ: - build_and_test: - 実行: ubuntu-最新 - ステップ: - - 名前: チェックアウト リポジトリ - 使用: アクション/checkout@v2 - - 名前: npm インストール、ビルド、テスト - 実行: | - npm のインストール - npm 実行ビルド --if-present - npm テスト - - 名前: アーカイブ制作アーティファクト - 使用: アクション/アップロードartifact@v2 - : - 名: dist-マークダウンなし - パス: | - dist - !dist/**/*.md - - 名前: アーカイブ コード カバレッジ結果 - 使用: アクション/アップロードartifact@v2 - と共に: - 名: コード カバレッジ レポート - パス: output/test/code-coverage.html -``` - - -![ワークフローアップロード成果物ワークフロー実行の画像](/assets/images/help/repository/upload-build-test-artifact.png) - - - -### 成果物のダウンロードあるいは削除 - -ワークフローの実行中に、同じワークフロー実行で以前にアップロードされたアーティファクトをダウンロードできます。 ワークフローの実行が完了したら、ワークフローの実行履歴を使用して、GitHub でアーティファクトをダウンロードまたは削除できます。 - - - -#### ワークフロー実行中の成果物のダウンロード - -[アクション/ダウンロードアーティファクト](https://github.com/actions/download-artifact) アクションを使用して、ワークフロー実行中に以前にアップロードされたアーティファクトをダウンロードできます。 - -{% note %} - -**注意:** 同じワークフロー実行中にアップロードされたワークフロー内のアーティファクトのみをダウンロードできます。 - -{% endnote %} - -個々の成果物をダウンロードする成果物の名前を指定します。 名前を指定せずにアーティファクトをアップロードした場合、デフォルト名はアーティファクト    `されます。

    - -
    - 名前: 使用
-  単一のアーティファクトをダウンロード: アクション/ダウンロードartifact@v2
-  と共に:
-    名: my-artifact
-`
    - -また、名前を指定しないことで、ワークフロー実行のすべての成果物をダウンロードすることもできます。 これは、多数のアーティファクトを扱っている場合に便利です。 - - - -```yaml -- 名前: 使用 - すべてのワークフロー実行アーティファクトをダウンロード: アクション/ダウンロードartifact@v2 -``` - - -ワークフロー実行のすべての成果物をダウンロードすると、各成果物のディレクトリーがその名前を使用して作成されます。 - -For more information on syntax, see the [actions/download-artifact](https://github.com/actions/download-artifact) action. - - - -#### ワークフローの実行完了後の成果物のダウンロードと削除 - -成果物は90日後に自動的に期限切れになりますが、{% data variables.product.product_name %}で期限切れになる前に成果物を削除すれば、使用された{% data variables.product.prodname_actions %}のストレージをいつでも回収できます。 - -{% warning %} - -**警告:** いったん削除された成果物をリストアすることはできません。 - -{% endwarning %} - -{% data reusables.repositories.navigate-to-repo %} - - - -{% data reusables.repositories.actions-tab %} - - - -{% data reusables.repositories.navigate-to-workflow %} - - - -{% data reusables.repositories.view-run %} - -1. 成果物をダウンロードするには、[**Artifacts**] ドロップダウンメニューを使用して、ダウンロードしたい成果物を選択します。 ![成果物のダウンロードのドロップダウンメニュー](/assets/images/help/repository/artifact-drop-down.png) -1. 成果物を削除するには、**Artifacts**ドロップダウンメニューを使って{% octicon "trashcan" aria-label="The trashcan icon" %}をクリックしてください。 ![成果物の削除のドロップダウンメニュー](/assets/images/help/repository/actions-delete-artifact.png) - -{% if currentVersion == "free-pro-team@latest" %} - - - -### 参考リンク - -- /github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions - -{% endif %} diff --git a/translations/ja-JP/content/actions/configuring-and-managing-workflows/sharing-workflow-templates-within-your-organization.md b/translations/ja-JP/content/actions/configuring-and-managing-workflows/sharing-workflow-templates-within-your-organization.md deleted file mode 100644 index ffed7fdd2525..000000000000 --- a/translations/ja-JP/content/actions/configuring-and-managing-workflows/sharing-workflow-templates-within-your-organization.md +++ /dev/null @@ -1,79 +0,0 @@ ---- -title: 組織内でのワークフロー テンプレートの共有 -intro: 組織専用のワークフロー テンプレートの標準化されたセットを作成できます。 組織のメンバーは、組織のリポジトリで新しいワークフローを作成するときに、テンプレートを使用できます。 -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -ワークフローテンプレートは、組織の `.github` リポジトリへの書き込みアクセス権を持つユーザーによって作成できます。 その後、ワークフローを作成する権限を持つ組織メンバーがテンプレートを使用できます。 - -ワークフロー テンプレートを使用すると、組織のパブリック リポジトリに新しいワークフローを作成できます。テンプレートを使用してプライベートリポジトリにワークフローを作成するには、組織がエンタープライズプランまたはGitHub Oneプランの一部である必要があります。 - -### ワークフロー テンプレートの作成 - -この手順では、ワークフロー テンプレートとメタデータ ファイルを作成する方法を示します。 メタデータ ファイルには、ユーザーが新しいワークフローを作成するときにテンプレートがどのように表示されるかについて説明します。 - -1. 存在しない場合は、組織内で .github `という名前の新しいパブリック リポジトリを作成します。 -
  • ワークフロー テンプレートという名前のディレクトリ 作成`。 -1. `ワークフローテンプレート` ディレクトリ内に新しいワークフローファイルを作成します。 - - リポジトリのデフォルトブランチを参照する必要がある場合は、 `$default-branch` プレースホルダを使用できます。 テンプレートを使用してワークフローを作成すると、プレースホルダはリポジトリのデフォルトブランチの名前に自動的に置き換えられます。 - - たとえば、octo-organization-ci.yml `名前のこのファイルは、基本的なワークフローを示しています。 -
       name: Octo Organization CI
-
-   :
-     プッシュ:
-       ブランチ: [ $default-ブランチ ]
-     pull_request:
-       ブランチ: [ $default-ブランチ]
-
-   ジョブ:
-     ビルド:
-       実行: ubuntu-最新
-
-       ステップ:
-       - 使用: アクション/checkout@v2
-
-       - 名前: 1 行スクリプトを実行
-         実行します: Octo Organization から hello をエコーします
-`
    -1. `ワークフローテンプレート` ディレクトリ内にメタデータファイルを作成します。 メタデータ ファイルは、ワークフロー ファイルと同じ名前である必要がありますが、 `.yml` 拡張子の代わりに、 `.properties.json`を付ける必要があります。 たとえば、octo-organization-ci.properties.json `名前のこのファイルには` 、octo-organization-ci.yml`名前のワークフローファイルのメタデータが含まれています。 -
       { "名前"
-       " " " " " " " " " "説明"
-       " "説明" " " "" "アイコン"
-       " "example-icon"
-       "" "  "" "
-       " " [
-           "go"  ]
-       "filePatterns" [
-           "package.json$" 」
-   
-       
-           、
-           "^Dockerfile"
-`
    - * `名` - 必須 **。** ワークフロー テンプレートの名前。 これは、使用可能なテンプレートの一覧に表示されます。 - * `説明` - 必須 **。** ワークフロー テンプレートの説明。 これは、使用可能なテンプレートの一覧に表示されます。 - * `アイコン名前` - 必須 **。** テンプレート リスト内のワークフローのエントリのアイコンを定義します。 `iconName` は、同じ名前の SVG アイコンである必要があり、 `ワークフローテンプレート` ディレクトリに格納する必要があります。 たとえば、example-icon.svg `名前の SVG ファイルは、 例アイコン`として参照されます。 - * `カテゴリ` - オプション **。** ワークフローの言語カテゴリを定義します。 ユーザーが使用可能なテンプレートを表示すると、同じ言語に一致するテンプレートの機能が顕著になります。 使用可能な言語カテゴリについては、「https://github.com/github/linguist/blob/master/lib/linguist/languages.yml」を参照してください。 - * `ファイルパターン` - オプション **。** 定義された正規表現に一致するファイルがユーザーのリポジトリのルート ディレクトリにある場合に、テンプレートを使用できるようにします。 - -別のワークフロー テンプレートを追加するには、同じ `ワークフロー テンプレート` ディレクトリにファイルを追加します。 例: - -![ワークフロー テンプレート ファイル](/assets/images/help/images/workflow-template-files.png) - -### ワークフロー テンプレートの使用 - -この手順では、組織のメンバーがワークフロー テンプレートを検索して使用して新しいワークフローを作成する方法を示します。 組織のワークフロー テンプレートは、組織のメンバーであるすべてのユーザーが使用できます。 - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -1. リポジトリに既存のワークフローが既に存在する場合: 左上隅にある [新しいワークフロー**] をクリックします。 ![新規ワークフローの選択](/assets/images/help/repository/actions-new-workflow.png)

    • -1 -組織のワークフロー テンプレートは、組織名で作成されたワークフロー"というタイトルの独自 _セクションにあります。 使いたいテンプレート名の下で、**Set up this workflow（このワークフローをセットアップする）**をクリックしてください。 ![このワークフローを設定します](/assets/images/help/settings/actions-create-starter-workflow.png)

    diff --git a/translations/ja-JP/content/actions/configuring-and-managing-workflows/using-databases-and-service-containers.md b/translations/ja-JP/content/actions/configuring-and-managing-workflows/using-databases-and-service-containers.md deleted file mode 100644 index 3464ca30fa61..000000000000 --- a/translations/ja-JP/content/actions/configuring-and-managing-workflows/using-databases-and-service-containers.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: データベースとサービスコンテナの利用 -intro: ワークフローのツールを管理するために、データベースとサービスコンテナを接続してください。 -mapTopic: true -redirect_from: - - /actions/automating-your-workflow-with-github-actions/using-databases-and-services -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/ja-JP/content/actions/configuring-and-managing-workflows/using-environment-variables.md b/translations/ja-JP/content/actions/configuring-and-managing-workflows/using-environment-variables.md deleted file mode 100644 index 06f3cdd75a70..000000000000 --- a/translations/ja-JP/content/actions/configuring-and-managing-workflows/using-environment-variables.md +++ /dev/null @@ -1,68 +0,0 @@ ---- -title: 環境変数の利用 -intro: '{% data variables.product.prodname_dotcom %}はそれぞれの{% data variables.product.prodname_actions %}ワークフローの実行に対してデフォルトの環境変数を設定します。 ワークフローファイル中でカスタムの環境変数を設定することもできます。' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /github/automating-your-workflow-with-github-actions/using-environment-variables - - /actions/automating-your-workflow-with-github-actions/using-environment-variables -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -### 環境変数について - -{% data variables.product.prodname_dotcom %}は、ワークフローの実行におけるどのステップでも使用できる、デフォルトの環境変数を設定します。 環境変数では、大文字小文字は区別されます。 アクションあるいはステップ内のコマンド実行は、環境変数を作成、読み取り、変更することができます。 - -カスタムの環境変数を設定するには、ワークフローファイル中でその変数を指定しなければなりません。 ステップ、ジョブ、あるいはワークフロー全体に対する環境変数は、[`jobs..steps.env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsenv)、[`jobs..env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idenv)、 [`env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#env)というキーワードを使って定義できます。 詳しい情報については、「[{% data variables.product.prodname_dotcom %}のワークフロー構文](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepsenv)」を参照してください。 - -```yaml -steps: - - name: Hello world - run: echo Hello world $FIRST_NAME $middle_name $Last_Name! - env: - FIRST_NAME: Mona - middle_name: The - Last_Name: Octocat -``` - -ワークフローコマンドの`set-env`を使って、ワークフロー中の以降のステップで使える環境変数を設定することもできます。 `set-env`コマンドは、アクションから直接使うことも、`run`キーワードを使うワークフローファイル中のシェルコマンドとして使うこともできます。 詳しい情報については「[{% data variables.product.prodname_actions %}のワークフローコマンド](/actions/reference/workflow-commands-for-github-actions/#setting-an-environment-variable)」を参照してください。 - -### デフォルトの環境変数 - -アクションでは、ファイルシステムにアクセスするとき、ハードコードされたファイルパスを使うのではなく環境変数を使用することを強くお勧めします。 {% data variables.product.prodname_dotcom %}は、すべてのランナー環境でアクションが使用する環境変数を設定します。 - -| 環境変数 | 説明 | -| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `CI` | 常に`true`に設定されます。 | -| `HOME` | ユーザーデータの格納に使用される{% data variables.product.prodname_dotcom %}ホームディレクトリのパス。 たとえば、`/github/home`です。 | -| `GITHUB_WORKFLOW` | ワークフローの名前。 | -| `GITHUB_RUN_ID` | {% data reusables.github-actions.run_id_description %} | -| `GITHUB_RUN_NUMBER` | {% data reusables.github-actions.run_number_description %} | -| `GITHUB_ACTION` | アクションの一意の識別子 (`id`)。 | -| `GITHUB_ACTIONS` | {% data variables.product.prodname_actions %}がワークフローを実行しているときは常に`true`に設定されます。 この変数は、テストがローカルで実行されているときと、{% data variables.product.prodname_actions %}によって実行されているときを区別するために利用できます。 | -| `GITHUB_ACTOR` | ワークフローを開始するユーザーまたはアプリの名前。 `octocat`などです。 | -| `GITHUB_REPOSITORY` | 所有者およびリポジトリの名前。 `octocat/Hello-World`などです。 | -| `GITHUB_EVENT_NAME` | ワークフローをトリガーしたwebhookイベントの名前。 | -| `GITHUB_EVENT_PATH` | 完了したwebhookイベントペイロードのファイルのパス。 `/github/workflow/event.json`などです。 | -| `GITHUB_WORKSPACE` | {% data variables.product.prodname_dotcom %}ワークスペースディレクトリのパス。 ワークフローが[actions/checkout](https://github.com/actions/checkout)アクションを使用している場合、ワークスペースディレクトリには、リポジトリのコピーがあるサブディレクトリが含まれています。 `actions/checkout`アクションを使用していない場合、ディレクトリは空となります。 たとえば、`/home/runner/work/my-repo-name/my-repo-name`となります。 | -| `GITHUB_SHA` | ワークフローをトリガーしたコミットSHA。 たとえば、`ffac537e6cbbf934b08745a378932722df287a53`です。 | -| `GITHUB_REF` | ワークフローをトリガーしたブランチまたはタグref。 たとえば、`refs/heads/feature-branch-1`です。 イベントタイプのブランチもタグも利用できない場合、変数は存在しません。 | -| `GITHUB_HEAD_REF` | フォークしたリポジトリのみに設定。 headリポジトリのブランチです。 | -| `GITHUB_BASE_REF` | フォークしたリポジトリのみに設定。 ベースリポジトリのブランチです。 | -| `GITHUB_SERVER_URL` | {% data variables.product.product_name %} サーバーの URL を返します。 For example: `https://github.com`. | -| `GITHUB_API_URL` | API URL を返します。 For example: `https://api.github.com`. | -| `GITHUB_GRAPHQL_URL` | グラフ QL API の URL を返します。 For example: `https://api.github.com/graphql`. | - -### 環境変数の命名規則 - -{% note %} - -**注意:** {% data variables.product.prodname_dotcom %} は、 {% data variables.product.prodname_dotcom %}で使用する環境変数のプレフィックス `GITHUB_` 予約します。 `GITHUB_`接頭辞を使用して環境変数またはシークレットを設定すると、エラーになります。 - -{% endnote %} - -ファイルシステム上の場所にそのポイントを設定した新しい環境変数がある場合は、`_PATH`接尾辞を指定する必要があります。 デフォルトの変数`HOME`と`GITHUB_WORKSPACE`は、「home」および「workspace」という言葉で最初から場所がわかっているため、この規則の例外です。 diff --git a/translations/ja-JP/content/actions/configuring-and-managing-workflows/using-variables-and-secrets-in-a-workflow.md b/translations/ja-JP/content/actions/configuring-and-managing-workflows/using-variables-and-secrets-in-a-workflow.md deleted file mode 100644 index 7fbac7b63b53..000000000000 --- a/translations/ja-JP/content/actions/configuring-and-managing-workflows/using-variables-and-secrets-in-a-workflow.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: ワークフロー中での変数とシークレットの利用 -intro: リポジトリを保護するために、ワークフロー中で暗号化されたシークレット、変数、トークンを利用してください。 -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/ja-JP/content/actions/getting-started-with-github-actions/about-github-actions.md b/translations/ja-JP/content/actions/getting-started-with-github-actions/about-github-actions.md deleted file mode 100644 index 0c843327e41d..000000000000 --- a/translations/ja-JP/content/actions/getting-started-with-github-actions/about-github-actions.md +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: GitHub Actionsについて -intro: '{% data variables.product.prodname_actions %} では、カスタムソフトウェア開発のライフサイクル (SDLC) にわたるワークフローを {% data variables.product.prodname_dotcom %} リポジトリに直接作成することができます。' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/migrating-github-actions-from-hcl-syntax-to-yaml-syntax/ - - /articles/about-github-actions - - /github/automating-your-workflow-with-github-actions/about-github-actions - - /actions/automating-your-workflow-with-github-actions/about-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -### {% data variables.product.prodname_actions %}について - -{% data reusables.repositories.about-github-actions %}ワークフローとは、{% data variables.product.prodname_dotcom %}で任意のコードプロジェクトをビルド、テスト、パッケージ、リリース、またはデプロイするためにリポジトリで設定できる、カスタムの自動プロセスです。 - -{% data reusables.repositories.actions-ci-cd %} {% data variables.product.prodname_actions %}は、{% data variables.product.prodname_dotcom %}に組み込まれている継続的インテグレーションサービスを駆動します。 詳細については、「[継続的インテグレーションについて](/articles/about-continuous-integration)」を参照してください。 - -ワークフローは、Linux、macOS、Windows、コンテナで、'ランナー'と呼ばれる{% data variables.product.prodname_dotcom %}がホストするマシン上で実行できます。 あるいは、自分が所有もしくは管理するマシン上でワークフローを実行するために、独自にランナーをホストすることもできます。 詳しい情報については「[セルフホストランナーについて](/actions/automating-your-workflow-with-github-actions/about-self-hosted-runners)」を参照してください。 - -ワークフローの作成には、リポジトリで定義されているアクション、{% data variables.product.prodname_dotcom %}のパブリックリポジトリにあるオープンソースのアクション、または公開されているDockerコンテナイメージを使用できます。 フォークされたリポジトリのワークフローは、デフォルトでは動作しません。 - -ワークフローで使用するアクションを{% data variables.product.prodname_dotcom %}で見つけ、{% data variables.product.prodname_dotcom %}コミュニティと共有するアクションをビルドできます。 カスタムアクションの作成については、「[アクションを作成する](/actions/creating-actions)」を参照してください。 - -特定のイベントで実行するように設定したワークフローファイルを作成できます。 詳細については、「[ワークフローの設定](/articles/configuring-a-workflow)」と「{% data variables.product.prodname_actions %}[のワークフロー構文](/articles/workflow-syntax-for-github-actions)」を参照してください。 - -一般的な用語の定義については「[{% data variables.product.prodname_actions %}の中核的な概念](/github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)」を参照してください。 - -### {% data variables.product.prodname_dotcom %}コミュニティでアクションを見つける - -{% data variables.product.prodname_marketplace %}は、{% data variables.product.prodname_dotcom %}コミュニティによって構築されたアクションを見つけ、共有し、利用するための中央となる場所です。 詳しい情報については「[ワークフロー中での{% data variables.product.prodname_marketplace %}からのアクションの利用](/actions/automating-your-workflow-with-github-actions/using-actions-from-github-marketplace-in-your-workflow)」を参照してください。 - -{% data variables.product.prodname_dotcom %}上のパブリックリポジトリで共有されているオープンソースのアクションでプロジェクトをカスタマイズし、[actions](https://github.com/actions) Organization内で{% data variables.product.prodname_dotcom %}によって構築されたアクションを使うこともできます。 - -### リポジトリあるいはOrganizationでの{% data variables.product.prodname_actions %}の無効化もしくは制限 - -{% data reusables.github-actions.disabling-github-actions %} - -詳しい情報については「[リポジトリでの{% data variables.product.prodname_actions %}の無効化もしくは制限](/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository)」あるいは「[Organizationでの{% data variables.product.prodname_actions %}の無効化もしくは制限](/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization)」を参照してください。 - -### ワークフロー実行の通知 - -{% data reusables.repositories.workflow-notifications %} - -### 使用制限 - -{% data reusables.github-actions.github-actions-usage-limits %} - -{% if currentVersion == "free-pro-team@latest" %} - -### 利用のポリシー - -使用制限に加えて、{% data variables.product.prodname_actions %}を[GitHubの利用規約](/articles/github-terms-of-service/)内で使っていることを確認しなければなりません。 {% data variables.product.prodname_actions %}の固有の規約に関する詳しい情報については、[GitHubの追加製品規約](/github/site-policy/github-additional-product-terms#a-actions-usage)を参照してください。 - -### {% data variables.product.prodname_actions %}の支払いについて - -{% data reusables.github-actions.actions-billing %} 詳細は「[{% data variables.product.prodname_actions %} の支払いについて](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions)」を参照してください。 - -### サポートへの連絡 - -{% data reusables.github-actions.contacting-support %} - -{% endif %} - -### 参考リンク - -- "[ワークフロー実行の管理](/articles/managing-a-workflow-run)" -- [ワークフローをトリガーするイベント](/articles/events-that-trigger-workflows) -- "[{% data variables.product.prodname_dotcom %}ホストランナーの仮想環境](/actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)" -{% data reusables.github-actions.actions-billing %} 詳細は「[{% data variables.product.prodname_actions %} の支払いについて](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions)」を参照してください。 diff --git a/translations/ja-JP/content/actions/getting-started-with-github-actions/core-concepts-for-github-actions.md b/translations/ja-JP/content/actions/getting-started-with-github-actions/core-concepts-for-github-actions.md deleted file mode 100644 index 4a259a60fe46..000000000000 --- a/translations/ja-JP/content/actions/getting-started-with-github-actions/core-concepts-for-github-actions.md +++ /dev/null @@ -1,76 +0,0 @@ ---- -title: GitHub Actionsの中核的概念 -shortTitle: 中核的概念 -intro: '以下のリストに、弊社のサイト及び{% data variables.product.prodname_actions %}のドキュメンテーションで使う一般的な{% data variables.product.prodname_actions %}の用語を示します。' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions - - /actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -### アクション - -ステップとして組み合わせてジョブを作成するための、個々のタスクです。 アクションは、ワークフローの最小のポータブルな構成要素です。 {% data variables.product.prodname_dotcom %}コミュニティから共有されるアクションを使って独自にアクションを作成することも、パブリックなアクションをカスタマイズすることもできます。 ワークフローでアクションを使うには、それをステップとして含めなければなりません。 - -### 成果物 - -アーティファクトとは、コードをビルドしてテストするときに作成されるファイルのことです。 たとえば、アーティファクトには、バイナリまたパッケージファイル、テスト結果、スクリーンショット、ログファイルなどがあります。 アーティファクトは、それを作成したワークフローの実行に関連づけられ、他のジョブから使ったり、デプロイしたりできます。 - -### 継続的インテグレーション（CI） - -頻繁に小さなコード変更を共有リポジトリにコミットするソフトウェア開発のプラクティス。 {% data variables.product.prodname_actions %}を使えば、コードを自動的にビルドしてテストするカスタムのCIワークフローを作成できます。 リポジトリからコード変更のステータスと、ワークフロー内の各アクションの詳細なログを見ることができます。 CIは、コード変更に対する即座のフィードバックを提供し、素早くバグを検出して解決できるようにすることによって、開発者の時間を節約します。 - -### 継続的デプロイメント（CD） - -継続的デプロイメントは、継続的インテグレージョンの上に構築されます。 新しいコードがコミットされ、CIテストをパスしたなら、そのコードは自動的に実働環境にデプロイされます。 {% data variables.product.prodname_actions %}を使えば、コードを任意のクラウド、自己ホストのサービスやプラットフォームに、リポジトリから自動的にデプロイをするカスタムのCDワークフローを作成できます。 CDは、デプロイメントのプロセスを自動化し、テスト済みの安定したコード変更を顧客により早くデプロイすることによって、開発者の時間を節約します。 - -### イベント - -ワークフローの実行をトリガする特定のアクティビティ。 たとえば、誰かがコミットをリポジトリにプッシュした場合、あるいはIssueもしくはプルリクエストが作成された場合、{% data variables.product.prodname_dotcom %}からアクティビティを発生させることができます。 また、リポジトリのディスパッチwebhookを使って外部イベントが生じたときにワークフローが実行されるよう設定することもできます。 - -### {% data variables.product.prodname_dotcom %}ホストランナー -{% data variables.product.prodname_dotcom %}は、Linux、Windows、macOSのランナーをホストします。 ジョブは、一般的に使用されるプリインストールのソフトウェアを含む仮想マシンの新たなインスタンスで実行されます。 {% data variables.product.prodname_dotcom %}は、{% data variables.product.prodname_dotcom %}ホストランナーのすべてのアップグレードやメンテナンスを行います。 {% data variables.product.prodname_dotcom %}ホストランナーのハードウェア構成はカスタマイズできません。 詳しい情報については「[{% data variables.product.prodname_dotcom %}ホストランナーの仮想環境](/github/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)」を参照してください。 - -### ジョブ - -同じランナー上で実行されるステップの集合。 ジョブの実行に関する依存関係のルールを、ワークフローファイル内で定義できます。 ジョブは、同時に並列に実行することも、先行するジョブのステータスに応じてシーケンシャルに実行することもできます。 たとえば、ワークフローにコードのビルドとテストという2つのシーケンシャルなジョブを持たせ、テストジョブをビルドジョブのステータスに依存させることができます。 ビルドジョブが失敗した場合は、テストジョブは実行されません。 {% data variables.product.prodname_dotcom %}ホストランナーでは、ワークフロー内の各ジョブは仮想環境の新しいインスタンス内で実行されます。 - -### ランナー - -{% data variables.product.prodname_actions %}ランナーアプリケーションがインストールされたマシンです。 {% data variables.product.prodname_dotcom %}がホストするランナーを使うことも、自分でランナーをホストすることもできます。 ランナーは実行できるジョブを待ち受けます。 ランナーは、ジョブを選択するとそのジョブのアクションを実行し、進行状況、ログ、最終結果の報告を{% data variables.product.prodname_dotcom %}に返します。 ランナーは一度に1つのジョブを実行します。 詳しい情報については「[{% data variables.product.prodname_dotcom %}ホストランナー](#github-hosted-runner)」及び「[セルフホストランナー](#self-hosted-runner)」を参照してください。 - -{% note %} - -**ノート：** {% data reusables.github-actions.runner-app-open-source %} - -{% endnote %} - -### セルフホストランナー - -セルフホストランナーアプリケーションがインストールされた、あなたが管理してメンテナンスするマシンです。 {% data reusables.github-actions.self-hosted-runner-description %} 詳しい情報については「[自分のランナーのホスト](/github/automating-your-workflow-with-github-actions/hosting-your-own-runners)」を参照してください。 - -### ステップ - -ステップは、コマンドやアクションを実行できる個別のタスクです。 ジョブには1つ以上のステップが設定されます。 ジョブ中の各ステップは同じランナー上で実行されるので、ファイルシステムを使用して、そのジョブにおける複数のアクションで情報を共有することが可能です。 - -### 仮想環境 - -{% data variables.product.prodname_dotcom %}ホストランナーの仮想環境には、その仮想マシンのハードウェア構成、オペレーティングシステム、インストール済みのソフトウェアが含まれます。 詳しい情報については「[{% data variables.product.prodname_dotcom %}ホストランナーの仮想環境](/github/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)」を参照してください。 - -### ワークフロー - -{% data variables.product.prodname_dotcom %}で任意のプロジェクトをビルド、テスト、パッケージ、リリース、またはデプロイするためにリポジトリでセットアップできる、設定可能な自動プロセスです。 ワークフローは1つ以上のジョブから構成され、スケジュールしたり、イベントに応じて動作させたりできます。 - -### ワークフローファイル - -最低1つのジョブと合わせてワークフローの設定を定義するYAMLファイル。 このファイルは、{% data variables.product.prodname_dotcom %}リポジトリの`.github/workflows`ディレクトリ直下にあります。 - -### ワークフローラン - -事前設定されたイベントが生じたときに実行されるワークフローのインスタンス。 それぞれのワークフローランについて、ジョブ、アクション、ログ、ステータスを見ることができます。 diff --git a/translations/ja-JP/content/actions/getting-started-with-github-actions/index.md b/translations/ja-JP/content/actions/getting-started-with-github-actions/index.md deleted file mode 100644 index 7d2142b574a5..000000000000 --- a/translations/ja-JP/content/actions/getting-started-with-github-actions/index.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: GitHub Actionsを使ってみる -shortTitle: はじめましょう -intro: '{% data variables.product.prodname_actions %} は、ワークフローの各ステップに組み込まれる強力な実行環境を特徴としています。 {% data variables.product.prodname_actions %} を理解、作成、共有して、あらゆるジョブを実行できます。' -redirect_from: - - /articles/getting-started-with-github-actions - - /github/automating-your-workflow-with-github-actions/getting-started-with-github-actions - - /actions/automating-your-workflow-with-github-actions/getting-started-with-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -{% topic_link_in_list /overview %} - {% link_in_list /about-github-actions %} - {% link_in_list /core-concepts-for-github-actions %} - {% link_in_list /security-hardening-for-github-actions %} -{% topic_link_in_list /using-community-workflows-and-actions %} - {% link_in_list /starting-with-preconfigured-workflow-templates %} - {% link_in_list /using-actions-from-github-marketplace %} diff --git a/translations/ja-JP/content/actions/getting-started-with-github-actions/overview.md b/translations/ja-JP/content/actions/getting-started-with-github-actions/overview.md deleted file mode 100644 index 105c07ce67a3..000000000000 --- a/translations/ja-JP/content/actions/getting-started-with-github-actions/overview.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: 概要 -intro: '{% data variables.product.prodname_actions %}の概念と用語を学んでください。' -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/ja-JP/content/actions/getting-started-with-github-actions/security-hardening-for-github-actions.md b/translations/ja-JP/content/actions/getting-started-with-github-actions/security-hardening-for-github-actions.md deleted file mode 100644 index 6dc4e8f10e8b..000000000000 --- a/translations/ja-JP/content/actions/getting-started-with-github-actions/security-hardening-for-github-actions.md +++ /dev/null @@ -1,93 +0,0 @@ ---- -title: GitHub Actions のセキュリティ強化 -shortTitle: セキュリティ強化 -intro: '{% data variables.product.prodname_actions %} 機能を使用するための適切なセキュリティプラクティス。' -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -このガイドでは、特定の {% data variables.product.prodname_actions %} 機能のセキュリティ強化を設定する方法について説明します。 {% data variables.product.prodname_actions %} の概念について理解を深めるには、「[GitHub Actions の中核的概念](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)」を参照してください。 - -### シークレットを使用する - -機密性の高い値は、平文としてワークフローファイルに保存するのではなく、シークレットとして保存してください。 [シークレット](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)は Organization またはリポジトリレベルで設定でき、機密情報を {% data variables.product.product_name %} に保存できます。 - -シークレットは [Libsodium sealed boxes](https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes) を使用するため、{% data variables.product.product_name %} に到達する前に暗号化されます。 これは、[UI を使用](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets#creating-encrypted-secrets-for-a-repository)して、または [REST API](/rest/reference/actions#secrets) を介してシークレットが送信されたときに発生します。 このクライアント側の暗号化により、{% data variables.product.product_name %} のインフラストラクチャ内での偶発的なログ（例外ログやリクエストログなど）に関連するリスクを最小限に抑えることができます。 シークレットがアップロードされると、{% data variables.product.product_name %} はそれを復号化して、ワークフローランタイムに挿入できるようになります。 - -偶発的な開示を防ぐために、{% data variables.product.product_name %} は、実行ログに表示されるシークレットを編集しようとするメカニズムを使用しています。 この編集は、設定されたシークレットの完全一致、および Base64 などの値の一般的なエンコーディングを検索します。 ただし、シークレットの値を変換する方法は複数あるため、この編集は保証されません。 そのため、シークレットを確実に編集し、シークレットに関連する他のリスクを制限するために実行する必要がある、特定の予防的ステップと推奨事項は次のとおりです。 - -- **構造化データをシークレットとして使用しない** - - 非構造化データは、ログ内のシークレットの編集失敗の原因となる可能性があります。これは、編集が特定のシークレット値の完全一致を見つけることに大きく依存しているためです。 たとえば、JSON、XML、または YAML（または同様）の Blob を使用してシークレット値をカプセル化しないでください。シークレットが適切に編集される可能性が大幅に低下するためです。 代わりに、機密値ごとに個別のシークレットを作成します。 -- **ワークフロー内で使用されるすべてのシークレットを登録する** - - シークレットを使用してワークフロー内で別の機密値を生成する場合は、生成された値を正式に[シークレットとして登録](https://github.com/actions/toolkit/tree/master/packages/core#setting-a-secret)して、ログに表示されたときに編集されるようにする必要があります。 たとえば、秘密鍵を使用して署名済み JWT を生成し、Web API にアクセスする場合は、その JWT をシークレットとして登録してください。そうしない場合、ログ出力に入力されても編集されません。 - - シークレットの登録は、あらゆる種類の変換/エンコーディングにも適用されます。 シークレットが何らかの方法で変換された場合（Base64 や URL エンコードなど）、新しい値もシークレットとして登録してください。 -- **シークレットの処理方法を監査する** - - シークレットの使用方法を監査し、シークレットが想定どおりに処理されていることを確認します。 これを行うには、ワークフローを実行しているリポジトリのソースコードを確認し、ワークフローで使用されているアクションを確認します。 たとえば、意図しないホストに送信されていないか、またはログ出力に明示的に出力されていないかを確認します。 - - 有効/無効な入力をテストした後、ワークフローの実行ログを表示し、シークレットが正しく編集されているか、表示されていないかを確認します。 呼び出しているコマンドまたはツールがどのようにしてエラーを `STDOUT` および `STDERR` に送信するかは必ずしも明らかではなく、シークレットはその後エラーログに記録される可能性があります。 そのため、有効な入力と無効な入力をテストした後、ワークフローログを手動で確認することをお勧めします。 -- **スコープが最小限の資格情報を使用する** - - ワークフロー内で使用されている認証情報に必要な最小限の権限があることを確認し、リポジトリへの書き込みアクセスを持つすべてのユーザが、リポジトリで設定されたすべてのシークレットへの読み取りアクセスを持っていることに注意してください。 -- **登録されたシークレットの監査とローテーション** - - 登録されたシークレットを定期的に確認して、現在も必要であることを確認します。 不要になったものは削除してください。 - - シークレットを定期的にローテーションして、不正使用されたシークレットが有効である期間を短縮します。 - -### サードパーティアクションを使用する - -ワークフロー内の個々のジョブは、他のジョブと相互作用（および侵害）する場合があります。 たとえば、後のジョブで使用される環境変数をクエリするジョブ、後のジョブが処理する共有ディレクトリにファイルを書き込むジョブ、または Docker ソケットとやり取りして他の実行中のコンテナを検査してコマンドを実行することにより、さらに多くのディレクトリを作成するジョブなどです。 - -これは、ワークフロー内の 1 つのアクションへの侵害が非常に重要になる可能性があるということです。その侵害されたアクションがリポジトリに設定されたすべてのシークレットにアクセスし、`GITHUB_TOKEN` を使用してリポジトリに書き込むことができるためです。 したがって、{% data variables.product.prodname_dotcom %} のサードパーティリポジトリからアクションを調達することには大きなリスクがあります。 次のような適切な方法に従うことで、このリスクを軽減することができます。 - -* **アクションを完全なコミット SHA にピン止めする** - - 現在、アクションを不変のリリースとして使用する唯一の方法は、アクションを完全なコミット SHA にピン止めすることです。 特定の SHA にピン止めすると、有効な Git オブジェクトペイロードに対して SHA-1 衝突を生成する必要があるため、悪意のある人がアクションのリポジトリにバックドアを追加するリスクを軽減できます。 - - {% warning %} - - **警告:** コミット SHA の短いバージョンは安全ではないため、アクションの Git リファレンスの指定には使用しないでください。 リポジトリネットワークの仕組みにより、どのユーザもリポジトリをフォークし、短い SHA と衝突するよう細工されたコミットをプッシュできます。 これにより、その SHA の後続のクローンがあいまいなコミットになるため失敗します。 その結果、短縮された SHA を使用するワークフローはすぐに失敗します。 - - {% endwarning %} -* **アクションのソースコードを監査する** - - アクションが想定どおりにリポジトリとシークレットのコンテンツを処理していることを確認します。 たとえば、シークレットが意図しないホストに送信されていないか、または誤ってログに記録されていないかを確認します。 - -* **作成者を信頼できる場合に限り、アクションをタグにピン止めする** - - コミット SHA に対するピン止めが最も安全なオプションですが、タグを指定する方が便利で広く使用されています。 タグを指定する場合は、アクションの作成者が信頼できることを確認してください。 {% data variables.product.prodname_marketplace %} の「Verified creator」バッジは便利な判断材料で、 {% data variables.product.prodname_dotcom %} で身元が確認されたチームによって作成されたアクションであることを示しています。 作者が信頼できる場合でも、このアプローチにはリスクがあることに注意してください。悪意のある人がアクションを保存しているリポジトリにアクセスすると、タグが移動または削除される可能性があります。 - -### リポジトリ間のアクセスを検討する - -{% data variables.product.product_name %} は、意図的に一度に単一のリポジトリに対してスコープされます。 ワークフロー環境で使用される `GITHUB_TOKEN` は、書き込みアクセスユーザと同じレベルのアクセスを許可します。書き込みアクセスを持つユーザは、ワークフローファイルを作成または変更することによってこのトークンにアクセスできるためです。 ユーザはリポジトリごとに特定の権限を持っているため、1 つのリポジトリの `GITHUB_TOKEN` に別のリポジトリへのアクセスを許可すると、慎重に実装しない場合 {% data variables.product.prodname_dotcom %} 権限モデルに影響します。 同様に、{% data variables.product.prodname_dotcom %} 認証トークンをワークフロー環境に追加する場合は注意が必要です。これは、コラボレータに誤って広範なアクセスを付与することにより、{% data variables.product.prodname_dotcom %} アクセス許可モデルにも影響を与える可能性があるためです。 - -[{% data variables.product.prodname_dotcom %} ロードマップ](https://github.com/github/roadmap/issues/74)では、{% data variables.product.product_name %} 内のリポジトリ間アクセスを可能にするフローをサポートする計画がありますが、この機能はまだサポートされていません。 現在、権限のあるリポジトリ間のやり取りを実行する唯一の方法は、ワークフロー環境内に {% data variables.product.prodname_dotcom %} 認証トークンまたは SSH キーをシークレットとして配置することです。 多くの認証トークンタイプでは特定のリソースへの詳細なアクセスが許可されていないことから、意図したものよりはるかに広範なアクセスを許可できるため、間違ったトークンタイプを使用すると重大なリスクが生じます。 - -次のリストでは、ワークフロー内のリポジトリデータにアクセスするための推奨アプローチを優先度の高い順に説明しています。 - -1. **ワークフロー環境の `GITHUB_TOKEN`** - - このトークンは、ワークフローを呼び出した単一のリポジトリに意図的にスコープが設定されており、リポジトリの書き込みアクセスユーザと同じレベルのアクセス権を持っています。 トークンは各ジョブが開始する前に作成され、ジョブが終了すると期限切れになります。 詳しい情報については「[GITHUB_TOKENでの認証](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)」を参照してください。 - - 可能な場合は、常に `GITHUB_TOKEN` を使用する必要があります。 -2. **リポジトリのデプロイキー** - - デプロイキーは、単一のリポジトリへの読み取りまたは書き込みアクセスを許可する唯一の認証情報タイプの 1 つであり、ワークフロー内の別のリポジトリとのやり取りに使用できます。 詳しい情報については、「[デプロイキーを管理する](/developers/overview/managing-deploy-keys#deploy-keys)」を参照してください。 - - デプロイキーは Git を使用してリポジトリに複製およびプッシュできるだけであり、REST または GraphQL API とのやり取りには使用できないため、要件に適さない場合があることに注意してください。 -3. **{% data variables.product.prodname_github_app %} トークン** - - {% data variables.product.prodname_github_apps %} は、選択したリポジトリにインストールでき、リポジトリ内のリソースに対する詳細な権限を持つこともできます。 Organization の内部で {% data variables.product.prodname_github_app %} を作成し、ワークフロー内でアクセスする必要があるリポジトリにインストールして、それらのリポジトリにアクセスするためのワークフロー内のインストールとして認証できます。 -4. **個人アクセストークン** - - 自分のアカウントから個人アクセストークンを使用しないでください。 これらのトークンは、アクセスできる Organization 内のすべてのリポジトリ、およびユーザアカウントのすべての個人リポジトリへのアクセスを許可します。 これにより、ワークフローが含まれているリポジトリのすべての書き込みアクセスユーザに間接的に広範なアクセス権が付与されます。 さらに、後で Organization を離れると、このトークンを使用するワークフローはすぐに中断され、この問題のデバッグが困難になる場合があります。 - - 個人アクセストークンを使用する場合は、ワークフローに必要な特定のリポジトリへのアクセスのみが許可される新しいアカウント用に生成されたものを使用してください。 このアプローチはスケーラブルではないため、デプロイキーなどの代替案を優先して避ける必要があります。 -5. **ユーザアカウントの SSH キー** - - ワークフローでは、ユーザアカウントの SSH キーを使用しないでください。 これらは、個人アクセストークンと同様に、すべての個人リポジトリと、Organization のメンバーシップを通じてアクセスできるすべてのリポジトリに読み取り/書き込み権限を付与します。 これにより、ワークフローが含まれているリポジトリのすべての書き込みアクセスユーザに間接的に広範なアクセス権が付与されます。 リポジトリのクローンまたはプッシュのみを実行する必要があり、パブリック API とやり取りする必要がないため、SSH キーを使用する場合は、代わりに個別のデプロイキーを使用する必要があります。 - -### セルフホストランナーを強化する - -**{% data variables.product.prodname_dotcom %} でホストされた**ランナーは、一過性でクリーンな隔離された仮想マシン内でコードを実行します。つまり、この環境を永続的に危険にさらしたり、ブートストラッププロセス中にこの環境に置かれた以上の情報にアクセスしたりする方法はありません。 - -**{% data variables.product.product_name %} のセルフホスト**ランナーは、一過性でクリーンな仮想マシンでの実行に関する保証がなく、ワークフロー内の信頼されていないコードによって永続的に侵害される可能性があります。 - -そのため、[{% data variables.product.product_name %} のパブリックリポジトリにセルフホストランナーを使用することはほとんどありません](/actions/hosting-your-own-runners/about-self-hosted-runners#self-hosted-runner-security-with-public-repositories)。これは、ユーザがリポジトリに対してプルリクエストを開き、環境を危険にさらす可能性があるためです。 同様に、プライベートリポジトリでセルフホストランナーを使用する場合は注意してください。リポジトリをフォークして PR を開くことができるユーザ（一般にリポジトリへの読み取りアクセス権を持つユーザ）は、シークレットへのアクセスと、リポジトリへの書き込みアクセス許可を付与する、より特権的な `GITHUB_TOKEN` を取得して、セルフホストのランナー環境を危険にさらすことができるためです。 - -次のように、セルフホストランナーマシンの環境も考慮する必要があります。 -- セルフホストランナーとして設定されたマシンにはどのような機密情報が存在するか。 たとえば、SSH 秘密鍵、API アクセストークンなどです。 -- マシンが機密性の高いサービスにネットワークアクセス可能か。 たとえば、Azure または AWS メタデータサービスなどです。 この環境での機密情報量は最小限に抑える必要があります。ワークフローを呼び出すことができるすべてのユーザがこの環境にアクセスできることを常に意識しておいてください。 diff --git a/translations/ja-JP/content/actions/getting-started-with-github-actions/starting-with-preconfigured-workflow-templates.md b/translations/ja-JP/content/actions/getting-started-with-github-actions/starting-with-preconfigured-workflow-templates.md deleted file mode 100644 index 5f3eb9e5742f..000000000000 --- a/translations/ja-JP/content/actions/getting-started-with-github-actions/starting-with-preconfigured-workflow-templates.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: 事前設定されたワークフローテンプレートで始める -intro: '{% data variables.product.prodname_dotcom %}は、ワークフローを自動化したり、特定の言語やフレームワークのためのCIワークフローを作成するための、事前設定されたワークフローテンプレートを提供しています。' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/starting-with-preconfigured-workflow-templates -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -### ワークフローテンプレートについて - -{% data variables.product.product_name %}はコードを分析し、リポジトリに最も適したCIテンプレートを提示します。 たとえばリポジトリにNode.jsのコードが含まれているなら、Node.jsプロジェクトのためのサジェッションが提示されます。 ワークフローテンプレートは、カスタムワークフローの構築の出発点として利用することも、そのまま利用することもできます。 - -[actions/starter-workflows](https://github.com/actions/starter-workflows/tree/master/ci)リポジトリで、CIテンプレートの完全なリストをブラウズできます。 また、ワークフローを自動化するテンプレートを見つけることもできます。 また、ワークフローを自動化するテンプレートを見つけることもできます。 - -### 最初のワークフローテンプレートの追加 - -まだリポジトリにワークフローを追加していないなら、ワークフローのテンプレートを見て選択できます。 - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.actions-set-up-workflow-template %} - -### 追加のワークフローテンプレートの追加 - -すでにワークフローを使っており、新しいテンプレートワークフローを追加したいなら、そのワークフローテンプレートにアクセスできます。 - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.actions-new-workflow %} -{% data reusables.repositories.actions-set-up-workflow-template %} diff --git a/translations/ja-JP/content/actions/getting-started-with-github-actions/using-actions-from-github-marketplace.md b/translations/ja-JP/content/actions/getting-started-with-github-actions/using-actions-from-github-marketplace.md deleted file mode 100644 index f859b6b7648b..000000000000 --- a/translations/ja-JP/content/actions/getting-started-with-github-actions/using-actions-from-github-marketplace.md +++ /dev/null @@ -1,51 +0,0 @@ ---- -title: GitHub Marketplaceからのアクションの利用 -intro: 'ワークフローで使うために、{% data variables.product.prodname_marketplace %}内のアクションをブラウズし、検索できます。' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/using-github-marketplace-actions - - /actions/automating-your-workflow-with-github-actions/using-actions-from-github-marketplace-in-your-workflow -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -### {% data variables.product.prodname_marketplace %}内のアクションについて - -{% data variables.product.prodname_marketplace %}は、{% data variables.product.prodname_dotcom %}コミュニティによって構築されたアクションを見つけるための中央となる場所です。 バッジが付いているアクションは、{% data variables.product.prodname_dotcom %}がアクションの作者をパートナー組織として検証したことを示します。 - -{% data reusables.actions.enterprise-marketplace-actions %} - -新しいアクションは、{% data variables.product.prodname_dotcom %}上のワークフローエディタから、そして[{% data variables.product.prodname_marketplace %}ページ](https://github.com/marketplace/actions/)から発見できます。 - -ワークフローエディタから直接アクションを見れば、{% data variables.product.prodname_marketplace %}内のすべてのアクションに素早くアクセスできます。 {% data variables.product.prodname_marketplace %}アクションページは、カテゴリによるアクションのフィルタリングをもっと柔軟に行えます。 - -### ワークフローエディタでのアクションのブラウズ - -リポジトリのワークフローエディタで、直接アクションを検索し、ブラウズできます。 サイドバーから特定のアクションを検索し、注目のアクションを見て、注目のカテゴリをブラウズできます。 また、アクションが{% data variables.product.prodname_dotcom %}コミュニティから受けたStarの数も見ることができます。 - -1. リポジトリで、編集したいワークフローファイルにアクセスします。 -1. ファイルビューの右上隅の {% octicon "pencil" aria-label="The edit icon" %}をクリックしてワークフローエディタを開きます。 ![ワークフローファイルの編集ボタン](/assets/images/help/repository/actions-edit-workflow-file.png) -1. エディタの右側で{% data variables.product.prodname_marketplace %}サイドバーを使ってアクションをブラウズしてください。 ![マーケットプレイスのワークフローサイドバー](/assets/images/help/repository/actions-marketplace-sidebar.png) - -### {% data variables.product.prodname_marketplace %}内のアクションのブラウズ - -同じアクションは[{% data variables.product.prodname_marketplace %}アクションページ](https://github.com/marketplace/actions/)でも見つけられます。 {% data variables.product.prodname_marketplace %}ページでは、カテゴリや検証状況によって柔軟にアクションをフィルタリングできます。 - -### ワークフローエディタからのワークフローへのアクションの追加 - -アクションのリストのページには、アクションのバージョンと、そのアクションを利用するために必要なワークフローの構文が含まれています。 - -1. ワークフローで使いたいアクションにアクセスしてください。 -1. "Installation（インストール）"の下で、{% octicon "clippy" aria-label="The edit icon" %}をクリックしてワークフローの構文をコピーしてください。 ![アクションのリストの表示](/assets/images/help/repository/actions-sidebar-detailed-view.png) -1. この構文をワークフロー中に新しいステップとして貼り付けてください。 詳細については、「[{% data variables.product.prodname_actions %}のワークフロー構文](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idsteps)」を参照してください。 -1. そのアクションに変数を提供する必要があるなら、変数をワークフロー中で設定してください。 アクションが要求する変数に関する詳しい情報については、{% data variables.product.prodname_marketplace %}のアクションの完全なリストを参照してください。 - -{% if currentVersion == "free-pro-team@latest" %} - -{% data reusables.dependabot.version-updates-for-actions %} - -{% endif %} diff --git a/translations/ja-JP/content/actions/getting-started-with-github-actions/using-community-workflows-and-actions.md b/translations/ja-JP/content/actions/getting-started-with-github-actions/using-community-workflows-and-actions.md deleted file mode 100644 index 01c93b4fba23..000000000000 --- a/translations/ja-JP/content/actions/getting-started-with-github-actions/using-community-workflows-and-actions.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: コミュニティのワークフローとアクションの利用 -intro: '{% data variables.product.prodname_dotcom %}を含む他の人々やOrganizationによってビルドされたアクションやワークフローを利用しましょう。' -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/ja-JP/content/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners.md b/translations/ja-JP/content/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners.md deleted file mode 100644 index c58541a6b0ee..000000000000 --- a/translations/ja-JP/content/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: セルフホストランナーへのアクセスの管理 -intro: Organizationのセルフホストランナーへどのリポジトリがジョブを送れるかを制御できます。 -versions: - free-pro-team: '*' ---- - -Organizationレベルで追加されたセルフホストランナーは、そのOrganization内のすべてのリポジトリのジョブを処理できます。 セルフホストランナーへのアクセスを制限する必要があるなら、プライベートリポジトリのジョブだけを処理するようにポリシーを設定したり、許可されたリポジトリのリストを定義したりすることができます。 - -### Organizationのランナーへアクセスできるリポジトリの制御 - -{% data reusables.organizations.navigate-to-org %} -{% data reusables.organizations.org_settings %} -{% data reusables.organizations.settings-sidebar-actions %} -1. "Self-hosted runners（セルフホストランナー）"の隣の**Manage repository permissions（リポジトリの権限の管理）**をクリックしてください。 ![リポジトリの権限の管理](/assets/images/help/settings/actions-runner-manage-permissions.png) - -1. ドロップダウンメニューから、以下のいずれかを選択してください。 - - * **All repositories（すべてのリポジトリ）** - Organization内のすべてのパブリック及びプライベートのリポジトリがOrganizationのセルフホストランナーにジョブを送信できます。 - * **Private repositories（プライベートリポジトリ）** - Organization内のプライベートリポジトリだけがOrganizationのセルフホストランナーにジョブを送信できます。 - * **Selected repositories（選択されたリポジトリ）** - リポジトリの選択メニューを使い、ジョブをOrganizationのセルフホストランナーに送信できるOrganization内のリポジトリを選択してください。 diff --git a/translations/ja-JP/content/actions/language-and-framework-guides/building-and-testing-java-with-ant.md b/translations/ja-JP/content/actions/language-and-framework-guides/building-and-testing-java-with-ant.md deleted file mode 100644 index bb7f76a5849e..000000000000 --- a/translations/ja-JP/content/actions/language-and-framework-guides/building-and-testing-java-with-ant.md +++ /dev/null @@ -1,107 +0,0 @@ ---- -title: AntでのJavaのビルドとテスト -intro: GitHub Actions中で継続的インテグレーション（CI）ワークフローを作成し、AntでJavaのプロジェクトのビルドとテストを行うことができます。 -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -### はじめに - -このガイドは、Antビルドシステムを使ってJavaのプロジェクトのための継続的インテグレーション（CI）を実行するワークフローを作成する方法を紹介します。 作成するワークフローによって、プルリクエストに対するコミットがデフォルトブランチに対してビルドあるいはテストの失敗を引き起こしたことを見ることができるようになります。このアプローチは、コードが常に健全であることを保証するための役に立ちます。 CIワークフローを拡張して、ワークフローの実行による成果物をアップロードするようにもできます。 - -{% data variables.product.prodname_dotcom %}ホストランナーは、Java Development Kits（JDKs）及びAntを含むプリインストールされたソフトウェアを伴うツールキャッシュを持ちます。 ソフトウェア及びプリインストールされたバージョンのJDK及びAntのリストについては、「[{% data variables.product.prodname_dotcom %}ホストランナー上にインストールされているソフトウェア](/actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners)」を参照してください。 - -### 必要な環境 - -YAMLと{% data variables.product.prodname_actions %}の構文に馴染んでいる必要があります。 詳しい情報については、以下を参照してください。 -- [{% data variables.product.prodname_actions %}のワークフロー構文](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions) -- [ワークフローの設定](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow) - -Java及びAntフレームワークの基本的な理解をしておくことをおすすめします。 詳しい情報については[Apache Ant Manual](https://ant.apache.org/manual/)を参照してください。 - -{% data reusables.actions.enterprise-setup-prereq %} - -### Antワークフローテンプレートで始める - -{% data variables.product.prodname_dotcom %}は、ほとんどのAntベースのJavaプロジェクトで使えるAntワークフローテンプレートを提供しています。 詳しい情報については[Antワークフローテンプレート](https://github.com/actions/starter-workflows/blob/master/ci/ant.yml)を参照してください。 - -素早く始めるには、新しいワークフローを作成する際に事前設定されたAntテンプレートを選択できます。 詳しい情報については「[事前設定されたワークフローテンプレートで始める](/actions/automating-your-workflow-with-github-actions/starting-with-preconfigured-workflow-templates)」を参照してください。 - -リポジトリの`.github/workflows`に新しいファイルを作成して、手作業でこのワークフローを追加することもできます。 - -{% raw %} -```yaml -name: Java CI - -on: [push] - -jobs: - build: - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - name: Set up JDK 1.8 - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Build with Ant - run: ant -noinput -buildfile build.xml -``` -{% endraw %} - -このワークフローは以下のステップを実行します。 - -1. `checkout`ステップは、ランナーにリポジトリのコピーをダウンロードします。 -2. `setup-java`ステップは、Java 1.8 JDKを設定します。 -3. "Build with Ant"ステップは、`build.xml`中のデフォルトターゲットを非インタラクティブモードで実行します。 - -デフォルトのワークフローテンプレートは、ビルドとテストのワークフローを構築する際の素晴らしい出発点であり、プロジェクトの要求に合わせてこのテンプレートをカスタマイズできます。 - -{% data reusables.github-actions.example-github-runner %} - -{% data reusables.github-actions.java-jvm-architecture %} - -### コードのビルドとテスト - -ローカルで使うのと同じコマンドを、コードのビルドとテストに使えます。 - -このスターターワークフローは、_build.xml_ファイルで指定されたデフォルトのターゲットを実行します。 デフォルトのターゲットは、一般的にクラスをビルドし、テストを実行し、たとえばJARファイルのような配布可能なフォーマットにクラスをパッケージするように設定されるでしょう。 - -プロジェクトのビルドに異なるコマンドを使ったり、異なるターゲットを実行したいのであれば、それらを指定できます。 たとえば、_build-ci.xml_ファイル中で設定された`jar`ターゲットを実行したいこともあるでしょう。 - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Run the Ant jar target - run: ant -noinput -buildfile build-ci.xml jar -``` -{% endraw %} - -### 成果物としてのワークフローのデータのパッケージ化 - -ビルドが成功し、テストがパスした後には、結果のJavaのパッケージをビルドの成果物としてアップロードすることになるかもしれません。 そうすれば、ビルドされたパッケージをワークフローの実行の一部として保存することになり、それらをダウンロードできるようになります。 成果物によって、プルリクエストをマージする前にローカルの環境でテスト及びデバッグしやすくなります。 詳しい情報については「[成果物を利用してワークフローのデータを永続化する](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)」を参照してください。 - -Antは通常、JAR、EAR、WARのような出力ファイルを`build/jar`ディレクトリに作成します。 このディレクトリの内容は`upload-artifact`アクションを使ってアップロードできます。 - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - - run: ant -noinput -buildfile build.xml - - uses: actions/upload-artifact@v2 - with: - name: Package - path: build/jar -``` -{% endraw %} diff --git a/translations/ja-JP/content/actions/language-and-framework-guides/building-and-testing-java-with-gradle.md b/translations/ja-JP/content/actions/language-and-framework-guides/building-and-testing-java-with-gradle.md deleted file mode 100644 index f81abde7741c..000000000000 --- a/translations/ja-JP/content/actions/language-and-framework-guides/building-and-testing-java-with-gradle.md +++ /dev/null @@ -1,132 +0,0 @@ ---- -title: GradleでのJavaのビルドとテスト -intro: GitHub Actions中で継続的インテグレーション（CI）ワークフローを作成し、GradleでJavaのプロジェクトのビルドとテストを行うことができます。 -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -### はじめに - -このガイドは、Gradleビルドシステムを使ってJavaのプロジェクトのための継続的インテグレーション（CI）を実行するワークフローを作成する方法を紹介します。 作成するワークフローによって、プルリクエストに対するコミットがデフォルトブランチに対してビルドあるいはテストの失敗を引き起こしたことを見ることができるようになります。このアプローチは、コードが常に健全であることを保証するための役に立ちます。 CIワークフローを拡張して、ファイルをキャッシュし、ワークフローの実行による成果物をアップロードするようにもできます。 - -{% data variables.product.prodname_dotcom %}ホストランナーは、Java Development Kits（JDKs）及びGradleを含むプリインストールされたソフトウェアを伴うツールキャッシュを持ちます。 ソフトウェア及びプリインストールされたバージョンのJDK及びGradleのリストについては、「[{% data variables.product.prodname_dotcom %}ホストランナー上にインストールされているソフトウェア](/actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners)」を参照してください。 - -### 必要な環境 - -YAMLと{% data variables.product.prodname_actions %}の構文に馴染んでいる必要があります。 詳しい情報については、以下を参照してください。 -- [{% data variables.product.prodname_actions %}のワークフロー構文](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions) -- [ワークフローの設定](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow) - -Java及びGradleフレームワークの基本的な理解をしておくことをおすすめします。 詳しい情報については、Gradleのドキュメンテーションの[Getting Started](https://docs.gradle.org/current/userguide/getting_started.html)を参照してください。 - -{% data reusables.actions.enterprise-setup-prereq %} - -### Gradleワークフローテンプレートで始める - -{% data variables.product.prodname_dotcom %}は、ほとんどのGradleベースのJavaプロジェクトで使えるGradleワークフローテンプレートを提供しています。 詳しい情報については[Gradleワークフローテンプレート](https://github.com/actions/starter-workflows/blob/master/ci/gradle.yml)を参照してください。 - -素早く始めるには、新しいワークフローを作成する際に事前設定されたGradleテンプレートを選択できます。 詳しい情報については「[事前設定されたワークフローテンプレートで始める](/actions/automating-your-workflow-with-github-actions/starting-with-preconfigured-workflow-templates)」を参照してください。 - -リポジトリの`.github/workflows`に新しいファイルを作成して、手作業でこのワークフローを追加することもできます。 - -{% raw %} -```yaml -name: Java CI - -on: [push] - -jobs: - build: - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - name: Set up JDK 1.8 - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Build with Gradle - run: ./gradlew build -``` -{% endraw %} - -このワークフローは以下のステップを実行します。 - -1. `checkout`ステップは、ランナーにリポジトリのコピーをダウンロードします。 -2. `setup-java`ステップは、Java 1.8 JDKを設定します。 -3. "Build with Gradle"ステップは、ラッパースクリプトの`gradlew`を実行し、コードがビルドされ、テストをパスし、パッケージが作成できることを保証します。 - -デフォルトのワークフローテンプレートは、ビルドとテストのワークフローを構築する際の素晴らしい出発点であり、プロジェクトの要求に合わせてこのテンプレートをカスタマイズできます。 - -{% data reusables.github-actions.example-github-runner %} - -{% data reusables.github-actions.java-jvm-architecture %} - -### コードのビルドとテスト - -ローカルで使うのと同じコマンドを、コードのビルドとテストに使えます。 - -スターターワークフローは、デフォルトで`build`タスクを実行します。 デフォルトのGradleの設定では、このコマンドは依存関係をダウンロードし、クラスをビルドし、テストを実行し、たとえばJARファイルのような配布可能なフォーマットにクラスをパッケージします。 - -プロジェクトのビルドに異なるコマンドを使ったり、異なるタスクを使いたいのであれば、それらを指定できます。 たとえば、_ci.gradle_ファイル中で設定された`package`タスクを実行したいこともあるでしょう。 - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Run the Gradle package task - run: ./gradlew -b ci.gradle package -``` -{% endraw %} - -### 依存関係のキャッシング - -ワークフローの実行速度を上げるために、依存関係をキャッシュすることもできます。 実行に成功した後、ローカルのGradleパッケージキャッシュがGitHub Actionsのインフラストラクチャ上に保存されます。 その後のワークフローの実行では、キャッシュがリストアされ、依存関係をリモートのパッケージリポジトリからダウンロードする必要がなくなります。 詳しい情報については「[ワークフローを高速化するための依存関係のキャッシング](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)」及び[`cache`アクション](https://github.com/marketplace/actions/cache)を参照してください。 - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - name: Set up JDK 1.8 - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Cache Gradle packages - uses: actions/cache@v2 - with: - path: ~/.gradle/caches - key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle') }} - restore-keys: ${{ runner.os }}-gradle - - name: Build with Gradle - run: ./gradlew build -``` -{% endraw %} - -このワークフローは、ランナーのホームディレクトリ内の`.gradle/caches`ディレクトリにあるローカルのGradleパッケージキャッシュの内容を保存します。 キャッシュのキーは、Gradleのビルドファイルの内容をハッシュしたものになるので、それらに変更があればキャッシュは無効になります。 - -### 成果物としてのワークフローのデータのパッケージ化 - -ビルドが成功し、テストがパスした後には、結果のJavaのパッケージをビルドの成果物としてアップロードすることになるかもしれません。 そうすれば、ビルドされたパッケージをワークフローの実行の一部として保存することになり、それらをダウンロードできるようになります。 成果物によって、プルリクエストをマージする前にローカルの環境でテスト及びデバッグしやすくなります。 詳しい情報については「[成果物を利用してワークフローのデータを永続化する](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)」を参照してください。 - -Gradleは通常、JAR、EAR、WARのような出力ファイルを`build/libs`ディレクトリに作成します。 このディレクトリの内容は`upload-artifact`アクションを使ってアップロードできます。 - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - - run: ./gradlew build - - uses: actions/upload-artifact@v2 - with: - name: Package - path: build/libs -``` -{% endraw %} diff --git a/translations/ja-JP/content/actions/language-and-framework-guides/building-and-testing-java-with-maven.md b/translations/ja-JP/content/actions/language-and-framework-guides/building-and-testing-java-with-maven.md deleted file mode 100644 index 8140df3a1b35..000000000000 --- a/translations/ja-JP/content/actions/language-and-framework-guides/building-and-testing-java-with-maven.md +++ /dev/null @@ -1,133 +0,0 @@ ---- -title: MavenでのJavaのビルドとテスト -intro: GitHub Actions中で継続的インテグレーション（CI）ワークフローを作成し、MavenでJavaのプロジェクトのビルドとテストを行うことができます。 -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -### はじめに - -このガイドは、ソフトウェアプロジェクト管理ツールのMavenを使ってJavaのプロジェクトのための継続的インテグレーション（CI）を実行するワークフローを作成する方法を紹介します。 作成するワークフローによって、プルリクエストに対するコミットがデフォルトブランチに対してビルドあるいはテストの失敗を引き起こしたことを見ることができるようになります。このアプローチは、コードが常に健全であることを保証するための役に立ちます。 CIワークフローを拡張して、ファイルをキャッシュし、ワークフローの実行による成果物をアップロードするようにもできます。 - -{% data variables.product.prodname_dotcom %}ホストランナーは、Java Development Kits（JDKs）及びMavenを含むプリインストールされたソフトウェアを伴うツールキャッシュを持ちます。 ソフトウェア及びプリインストールされたバージョンのJDK及びMavenのリストについては、「[{% data variables.product.prodname_dotcom %}ホストランナー上にインストールされているソフトウェア](/actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners)」を参照してください。 - -### 必要な環境 - -YAMLと{% data variables.product.prodname_actions %}の構文に馴染んでいる必要があります。 詳しい情報については、以下を参照してください。 -- [{% data variables.product.prodname_actions %}のワークフロー構文](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions) -- [ワークフローの設定](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow) - -Java及びMavenフレームワークの基本的な理解をしておくことをおすすめします。 詳しい情報については、Mavenのドキュメンテーションの[Maven Getting Started Guide](http://maven.apache.org/guides/getting-started/index.html)を参照してください。 - -{% data reusables.actions.enterprise-setup-prereq %} - -### Mavenワークフローテンプレートで始める - -{% data variables.product.prodname_dotcom %}は、ほとんどのMavenベースのJavaプロジェクトで使えるMavenワークフローテンプレートを提供しています。 詳しい情報については[Mavenワークフローテンプレート](https://github.com/actions/starter-workflows/blob/master/ci/maven.yml)を参照してください。 - -素早く始めるには、新しいワークフローを作成する際に事前設定されたMavenテンプレートを選択できます。 詳しい情報については「[事前設定されたワークフローテンプレートで始める](/actions/automating-your-workflow-with-github-actions/starting-with-preconfigured-workflow-templates)」を参照してください。 - -リポジトリの`.github/workflows`に新しいファイルを作成して、手作業でこのワークフローを追加することもできます。 - -{% raw %} -```yaml -name: Java CI - -on: [push] - -jobs: - build: - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - name: Set up JDK 1.8 - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Build with Maven - run: mvn -B package --file pom.xml -``` -{% endraw %} - -このワークフローは以下のステップを実行します。 - -1. `checkout`ステップは、ランナーにリポジトリのコピーをダウンロードします。 -2. `setup-java`ステップは、Java 1.8 JDKを設定します。 -3. "Build with Maven"ステップは、Mavenの`package`ターゲットを非インタラクティブモードで実行し、コードがビルドされ、テストをパスし、パッケージが作成できることを保証します。 - -デフォルトのワークフローテンプレートは、ビルドとテストのワークフローを構築する際の素晴らしい出発点であり、プロジェクトの要求に合わせてこのテンプレートをカスタマイズできます。 - -{% data reusables.github-actions.example-github-runner %} - -{% data reusables.github-actions.java-jvm-architecture %} - -### コードのビルドとテスト - -ローカルで使うのと同じコマンドを、コードのビルドとテストに使えます。 - -スターターワークフローは、デフォルトで`package`タスクを実行します。 デフォルトのMavenの設定では、このコマンドは依存関係をダウンロードし、クラスをビルドし、テストを実行し、たとえばJARファイルのような配布可能なフォーマットにクラスをパッケージします。 - -プロジェクトのビルドに異なるコマンドを使ったり、異なるターゲットを使いたいのであれば、それらを指定できます。 たとえば、_pom-ci.xml_ファイル中で設定された`verify`ターゲットを実行したいこともあるでしょう。 - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Run the Maven verify phase - run: mvn -B verify --file pom-ci.xml -``` -{% endraw %} - -### 依存関係のキャッシング - -ワークフローの実行速度を上げるために、依存関係をキャッシュすることもできます。 実行に成功した後、ローカルのMavenリポジトリがGitHub Actionsのインフラストラクチャ上に保存されます。 その後のワークフローの実行では、キャッシュがリストアされ、依存関係をリモートのMavenリポジトリからダウンロードする必要がなくなります。 詳しい情報については「[ワークフローを高速化するための依存関係のキャッシング](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)」及び[`cache`アクション](https://github.com/marketplace/actions/cache)を参照してください。 - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - name: Set up JDK 1.8 - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Cache Maven packages - uses: actions/cache@v2 - with: - path: ~/.m2 - key: ${{ runner.os }}-m2-${{ hashFiles('**/pom.xml') }} - restore-keys: ${{ runner.os }}-m2 - - name: Build with Maven - run: mvn -B package --file pom.xml -``` -{% endraw %} - -このワークフローは、ランナーのホームディレクトリ内の`.m2`ディレクトリにあるローカルのMavenリポジトリの内容を保存します。 キャッシュのキーは_pom.xml_の内容をハッシュしたものになるので、_pom.xml_が変更されればキャッシュは無効になります。 - -### 成果物としてのワークフローのデータのパッケージ化 - -ビルドが成功し、テストがパスした後には、結果のJavaのパッケージをビルドの成果物としてアップロードすることになるかもしれません。 そうすれば、ビルドされたパッケージをワークフローの実行の一部として保存することになり、それらをダウンロードできるようになります。 成果物によって、プルリクエストをマージする前にローカルの環境でテスト及びデバッグしやすくなります。 詳しい情報については「[成果物を利用してワークフローのデータを永続化する](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)」を参照してください。 - -Mavenは通常、JAR、EAR、WARのような出力ファイルを`target`ディレクトリに作成します。 それらを成果物としてアップロードするために、アップロードする成果物を含む新しいディレクトリにそれらをコピーできます。 たとえば、`staging`というディレクトリを作成できます。 として、そのディレクトリの内容を`upload-artifact`アクションを使ってアップロードできます。 - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - - run: mvn -B package --file pom.xml - - run: mkdir staging && cp target/*.jar staging - - uses: actions/upload-artifact@v2 - with: - name: Package - path: staging -``` -{% endraw %} diff --git a/translations/ja-JP/content/actions/language-and-framework-guides/github-actions-for-docker.md b/translations/ja-JP/content/actions/language-and-framework-guides/github-actions-for-docker.md deleted file mode 100644 index a79b54bcc317..000000000000 --- a/translations/ja-JP/content/actions/language-and-framework-guides/github-actions-for-docker.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: DockerのためのGitHub Actions -intro: Dockerプロジェクトをビルドして公開するワークフローを作成してください。 -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/ja-JP/content/actions/language-and-framework-guides/github-actions-for-java.md b/translations/ja-JP/content/actions/language-and-framework-guides/github-actions-for-java.md deleted file mode 100644 index b87e2c3a19e1..000000000000 --- a/translations/ja-JP/content/actions/language-and-framework-guides/github-actions-for-java.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: JavaのためのGitHub Actions -intro: Javaで書かれたプロジェクトのビルドとテストを行うワークフローを作成してください。 -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/ja-JP/content/actions/language-and-framework-guides/github-actions-for-javascript-and-typescript.md b/translations/ja-JP/content/actions/language-and-framework-guides/github-actions-for-javascript-and-typescript.md deleted file mode 100644 index 4f83fa986c0c..000000000000 --- a/translations/ja-JP/content/actions/language-and-framework-guides/github-actions-for-javascript-and-typescript.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: JavaScript及びTypeScriptのためのGitHub Actions -intro: JavaScript及びTypeScriptライブラリで書かれたプロジェクトのビルドとテストを行うワークフローを作成してください。 -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/ja-JP/content/actions/language-and-framework-guides/github-actions-for-python.md b/translations/ja-JP/content/actions/language-and-framework-guides/github-actions-for-python.md deleted file mode 100644 index 693deb6b2f7d..000000000000 --- a/translations/ja-JP/content/actions/language-and-framework-guides/github-actions-for-python.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: PythonのためのGitHub Actions -intro: Pythonで書かれたプロジェクトのビルドとテストを行うワークフローを作成してください。 -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/ja-JP/content/actions/language-and-framework-guides/index.md b/translations/ja-JP/content/actions/language-and-framework-guides/index.md deleted file mode 100644 index c34b38a9da44..000000000000 --- a/translations/ja-JP/content/actions/language-and-framework-guides/index.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: 言語とフレームワークのガイド -intro: 様々なプログラミング言語で書かれたプロジェクトのビルドとテストを行う継続的インテグレーション（CI）ワークフローを作成できます。 -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -{% topic_link_in_list /github-actions-for-javascript-and-typescript %} - {% link_in_list /using-nodejs-with-github-actions %} - {% link_in_list /publishing-nodejs-packages %} -{% topic_link_in_list /github-actions-for-python %} - {% link_in_list /using-python-with-github-actions %} -{% topic_link_in_list /github-actions-for-java %} - {% link_in_list /building-and-testing-java-with-maven %} - {% link_in_list /building-and-testing-java-with-gradle %} - {% link_in_list /building-and-testing-java-with-ant %} - {% link_in_list /publishing-java-packages-with-maven %} - {% link_in_list /publishing-java-packages-with-gradle %} -{% topic_link_in_list /github-actions-for-docker %} - {% link_in_list /publishing-docker-images %} diff --git a/translations/ja-JP/content/actions/language-and-framework-guides/publishing-docker-images.md b/translations/ja-JP/content/actions/language-and-framework-guides/publishing-docker-images.md deleted file mode 100644 index b3b4b9ea68f1..000000000000 --- a/translations/ja-JP/content/actions/language-and-framework-guides/publishing-docker-images.md +++ /dev/null @@ -1,157 +0,0 @@ ---- -title: Dockerイメージの公開 -intro: '継続的インテグレーション（CI）の一部として、Docker Hubや{% data variables.product.prodname_registry %}といったレジストリに対しDockerイメージを公開できます。' -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -### はじめに - -このガイドでは、Dockerのビルドを実行し、DockerのイメージをDocker Hubあるいは{% data variables.product.prodname_registry %}に公開するワークフローの作成方法を紹介します。 1つのワークフローで、1つのレジストリあるいは複数のレジストリにイメージを公開できます。 - -{% note %} - -**ノート:** 他のサードパーティのDockerレジストリにプッシュしたい場合は、「[{% data variables.product.prodname_registry %}へのイメージの公開](#publishing-images-to-github-packages)」セクションにある例がよいテンプレートになるでしょう。 - -{% endnote %} - -### 必要な環境 - -ワークフローの設定オプションと、ワークフローファイルの作成方法についての基本的な知識を持っておくことをおすすめします。 詳細は「[ワークフローの設定](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)」を参照してください。 - -以下についての基本的な理解があると役に立つでしょう。 - -- [{% data variables.product.prodname_actions %}の中核的概念](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions) -- [暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets) -- [GITHUB_TOKENでの認証](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token) -- [{% data variables.product.prodname_registry %}で利用するためのDockerの設定](/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages) - -### イメージの設定について - -このガイドは、{% data variables.product.prodname_dotcom %}レジストリ内に保存されたDockerのイメージについての完全な定義を持っていることを前提としています。 たとえば、リポジトリにはイメージを作成するためのDockerビルドを行うのに必要な_Dockerfile_やその他のファイルが含まれていなければなりません。 - -このガイドではDockerの`build-push-action`アクションを使って、Dockerイメージをビルドし、それを1つ以上のDockerレジストリにプッシュします。 詳しい情報については[`build-push-action`](https://github.com/marketplace/actions/build-and-push-docker-images)を参照してください。 - -{% data reusables.actions.enterprise-marketplace-actions %} - -### Docker Hubへのイメージの公開 - -{% data reusables.github-actions.release-trigger-workflow %} - -以下のワークフローの例では、Dockerの`build-push-action`アクションを使ってDockerイメージをビルドし、ビルドが成功すれば構築されたイメージをDocker Hubにプッシュします。 - -Docker Hubにプッシュするためには、Docker Hubのアカウントを持っており、Docker Hubのレジストリを作成していなければなりません。 詳しい情報についてはDockerのドキュメンテーション中の「[Share images on Docker Hub](https://docs.docker.com/get-started/part3/)」を参照してください。 - -Docker Hubに必要な`build-push-action`のオプションは以下のとおりです。 - -* `username`及び`password`: Docker Hubのユーザ名とパスワードです。 Docker Hubのユーザ名とパスワードは、{% data variables.product.prodname_dotcom %}リポジトリに暗号化されたシークレットとして保存し、ワークフローファイルで公開しないことをおすすめします。 詳しい情報については、「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 -* `repository`: `DOCKER-HUB-NAMESPACE/DOCKER-HUB-REPOSITORY`フォーマットでのDocker Hubのリポジトリ。 - -{% raw %} -```yaml -name: Publish Docker image -on: - release: - types: [published] -jobs: - push_to_registry: - name: Push Docker image to Docker Hub - runs-on: ubuntu-latest - steps: - - name: Check out the repo - uses: actions/checkout@v2 - - name: Push to Docker Hub - uses: docker/build-push-action@v1 - with: - username: ${{ secrets.DOCKER_USERNAME }} - password: ${{ secrets.DOCKER_PASSWORD }} - repository: my-docker-hub-namespace/my-docker-hub-repository - tag_with_ref: true -``` -{% endraw %} - -{% data reusables.github-actions.docker-tag-with-ref %} - -### {% data variables.product.prodname_registry %}へのイメージの公開 - -{% data reusables.github-actions.release-trigger-workflow %} - -以下のワークフローの例では、Dockerの`build-push-action`アクションを使ってDockerイメージをビルドし、ビルドが成功すれば構築されたイメージを{% data variables.product.prodname_registry %}にプッシュします。 - -{% data variables.product.prodname_registry %}に必要な`build-push-action`のオプションは以下のとおりです。 - -* `username`: {% raw %}`${{ github.actor }}`{% endraw %}コンテキストを使って、ワークフローの実行を始めたユーザのユーザ名を自動的に使うことができます。 詳しい情報については、「[GitHub Actionsのコンテキストと式構文](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)」を参照してください。 -* `password`: パスワードには、自動的に生成された`GITHUB_TOKEN`シークレットを利用できます。 詳しい情報については「[GITHUB_TOKENでの認証](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)」を参照してください。 -* `registry`: `docker.pkg.github.com`に設定しなければなりません。 -* `repository`: `OWNER/REPOSITORY/IMAGE_NAME`というフォーマットで設定しなければなりません。 たとえば、`http://github.com/octo-org/octo-repo`にある{% data variables.product.prodname_dotcom %}上に保存される`octo-image`という名前のイメージでは、`repository`オプションは`octo-org/octo-repo/octo-image`に設定しなければなりません。 - -{% raw %} -```yaml -name: Publish Docker image -on: - release: - types: [published] -jobs: - push_to_registry: - name: Push Docker image to GitHub Packages - runs-on: ubuntu-latest - steps: - - name: Check out the repo - uses: actions/checkout@v2 - - name: Push to GitHub Packages - uses: docker/build-push-action@v1 - with: - username: ${{ github.actor }} - password: ${{ secrets.GITHUB_TOKEN }} - registry: docker.pkg.github.com - repository: my-org/my-repo/my-image - tag_with_ref: true - -``` -{% endraw %} - -{% data reusables.github-actions.docker-tag-with-ref %} - -### Docker Hubと{% data variables.product.prodname_registry %}へのイメージの公開 - -1つのワークフローで、それぞれのレジストリに対して`build-push-action`アクションを使い、複数のレジストリにDockerイメージを公開できます。 - -以下のワークフローの例では、以前のセクション（「[Docker Hubへのイメージの公開](#publishing-images-to-docker-hub)」及び「[{% data variables.product.prodname_registry %}へのイメージの公開](#publishing-images-to-github-packages)」）での`build-push-action`ステップを使い、両方のレジストリにプッシュを行う1つのワークフローを作成します。 - -{% raw %} -```yaml -name: Publish Docker image -on: - release: - types: [published] -jobs: - push_to_registries: - name: Push Docker image to multiple registries - runs-on: ubuntu-latest - steps: - - name: Check out the repo - uses: actions/checkout@v2 - - name: Push to Docker Hub - uses: docker/build-push-action@v1 - with: - username: ${{ secrets.DOCKER_USERNAME }} - password: ${{ secrets.DOCKER_PASSWORD }} - repository: my-docker-hub-namespace/my-docker-hub-repository - tag_with_ref: true - - name: Push to GitHub Packages - uses: docker/build-push-action@v1 - with: - username: ${{ github.actor }} - password: ${{ secrets.GITHUB_TOKEN }} - registry: docker.pkg.github.com - repository: my-org/my-repo/my-image - tag_with_ref: true -``` -{% endraw %} - -上のワークフローの例は、{% data variables.product.prodname_dotcom %}リポジトリをチェックアウトし、`build-push-action`アクションを2回使ってDockerイメージをビルドしてDocker Hubと{% data variables.product.prodname_registry %}にプッシュします。 どちらのステップでも、このワークフローは`build-push-action`のオプションの[`tag_with_ref`](https://github.com/marketplace/actions/build-and-push-docker-images#tag_with_ref)を、構築されたDockerイメージをワークフローイベントのGit参照で自動的にタグ付けするように設定します。 このワークフローは{% data variables.product.prodname_dotcom %}リリースの公開で起動されるので、どちらのレジストリの参照も、そのリリースのGitタグになります。 diff --git a/translations/ja-JP/content/actions/language-and-framework-guides/publishing-java-packages-with-gradle.md b/translations/ja-JP/content/actions/language-and-framework-guides/publishing-java-packages-with-gradle.md deleted file mode 100644 index d0a16211ec62..000000000000 --- a/translations/ja-JP/content/actions/language-and-framework-guides/publishing-java-packages-with-gradle.md +++ /dev/null @@ -1,218 +0,0 @@ ---- -title: GradleでのJavaパッケージの公開 -intro: 継続的インテグレーション（CI）ワークフローの一部として、Javaのパッケージをレジストリに公開するためにGradleを利用できます。 -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -### はじめに - -{% data reusables.github-actions.publishing-java-packages-intro %} - -### 必要な環境 - -ワークフローファイルと設定オプションに関する基本的な理解をしておくことをおすすめします。 詳細は「[ワークフローの設定](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)」を参照してください。 - -GradleでのJavaプロジェクトのためのCIワークフローの作成に関する詳しい情報については「[GradleでのJavaのビルドとテスト](/actions/language-and-framework-guides/building-and-testing-java-with-gradle)」を参照してください。 - -また、以下の基本的な理解があれば役立ちます。 - -- [{% data variables.product.prodname_actions %}の中核的概念](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions) -- [{% data variables.product.prodname_registry %} で利用するために npm を設定する](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages) -- [環境変数の利用](/actions/automating-your-workflow-with-github-actions/using-environment-variables) -- [暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets) -- [GITHUB_TOKENでの認証](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token) - -### パッケージの設定について - -_build.gradle_ファイルの`MavenPublication`セクションにある`groupId`及び`artifactId`フィールドは、レジストリがパッケージをレジストリにリンクするために使用する、パッケージのためのユニークな識別子を生成します。 これは、Mavenの_pom.xml_ファイルにおける`groupId`と`artifactId`に似ています。 詳しい情報については、Gradleのドキュメンテーションの「[Maven Publish Plugin](https://docs.gradle.org/current/userguide/publishing_maven.html)」を参照してください。 - -_build.gradle_ファイルには、Gradleがパッケージを公開する配布管理リポジトリの設定も含まれています。 各リポジトリは、名前、デプロイメントのURL、認証のためのクレデンシャルを持っていなければなりません。 - -### Maven Central Repositoryへのパッケージの公開 - -新しいリリースを作成するたびに、パッケージを公開するワークフローを起動できます。 以下の例でのワークフローは、`created`という種類で`release`イベントが発生したときに実行されます。 このワークフローは、CIテストをパスすればMaven Central Repositoryにパッケージを公開します。 `release`イベントに関する詳しい情報については「[ワークフローを起動するイベント](/actions/reference/events-that-trigger-workflows#release)」を参照してください。 - -_build.gradle_ファイルのpublishingブロックには、パッケージリポジトリを指す新しいMavenリポジトリを定義できます。 たとえば、OSSRHホスティングプロジェクトを通じてMaven Central Repositoryにデプロイしていたなら、_build.gradle_ は`”OSSRH"`という名前でリポジトリを指定できます。 - -{% raw %} -```groovy -publishing { - ... - - repositories { - maven { - name = "OSSRH" - url = "https://oss.sonatype.org/service/local/staging/deploy/maven2/" - credentials { - username = System.getenv("MAVEN_USERNAME") - password = System.getenv("MAVEN_PASSWORD") - } - } - } -} -``` -{% endraw %} - -この設定で、`gradle publish`コマンドの実行によってパッケージをMaven Central Repositoryに公開するワークフローを作成できます。 リポジトリの認証のために、ユーザ名とパスワードを含む環境変数を提供する必要もあります。 - -デプロイのステップでは、ユーザ名とパスワードのための環境変数か、Mavenリポジトリの認証に使うトークンを環境変数に設定する必要があります。 詳しい情報については、「[暗号化されたシークレットの作成と利用](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 - - -{% raw %} -```yaml -name: Publish package to the Maven Central Repository -on: - release: - types: [created] -jobs: - publish: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - - name: Set up Java - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Publish package - run: gradle publish - env: - MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }} - MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }} -``` -{% endraw %} - -{% data reusables.github-actions.gradle-workflow-steps %} -1. `gradle publish`コマンドを実行して、`OSSRH` Mavenリポジトリに公開してください。 環境変数の`MAVEN_USERNAME`は`OSSRH_USERNAME`シークレットの内容で、環境変数の`MAVEN_PASSWORD`は`OSSRH_TOKEN`シークレットの内容で設定されます。 - - ワークフロー中でのシークレットの利用に関する詳しい情報については「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 - -### {% data variables.product.prodname_registry %}へのパッケージの公開 - -新しいリリースを作成するたびに、パッケージを公開するワークフローを起動できます。 以下の例でのワークフローは、`created`という種類で`release`イベントが発生したときに実行されます。 このワークフローは、CIテストをパスすれば{% data variables.product.prodname_registry %}にパッケージを公開します。 `release`イベントに関する詳しい情報については「[ワークフローを起動するイベント](/actions/reference/events-that-trigger-workflows#release)」を参照してください。 - -_build.gradle_のpublishingブロックには、{% data variables.product.prodname_registry %}を指す新しいMavenリポジトリを定義できます。 そのリポジトリの設定では、CIワークフローの実行で設定された環境変数を活用することもできます。 環境変数の`GITHUB_ACTOR`はユーザ名として利用でき、環境変数の`GITHUB_TOKEN`には`GITHUB_TOKEN`シークレットを設定できます。 - -`GITHUB_TOKEN`は、デフォルトでリポジトリ中に存在し、ワークフローが実行されるリポジトリ中のパッケージには読み書きの権限があります。 詳しい情報については「[GITHUB_TOKENでの認証](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)」を参照してください。 - -たとえば、Organizationの名前が"octocat"でリポジトリの名前が"hello-world"なら、_build.gradle_中の{% data variables.product.prodname_registry %}の設定は以下の例のようになるでしょう。 - -{% raw %} -```groovy -publishing { - ... - - repositories { - maven { - name = "GitHubPackages" - url = "https://maven.pkg.github.com/octocat/hello-world" - credentials { - username = System.getenv("GITHUB_ACTOR") - password = System.getenv("GITHUB_TOKEN") - } - } - } -} -``` -{% endraw %} - -この設定で、`gradle publish`コマンドの実行によってパッケージをMaven Central Repositoryに公開するワークフローを作成できます。 - -{% raw %} -```yaml -name: Publish package to GitHub Packages -on: - release: - types: [created] -jobs: - publish: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Publish package - run: gradle publish - env: - GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} - -{% data reusables.github-actions.gradle-workflow-steps %} -1. {% data variables.product.prodname_registry %}に公開するために` gradle publish `コマンドを実行してください。 環境変数`GITHUB_TOKEN`には、`GITHUB_TOKEN`シークレットの内容が設定されます。 - - ワークフロー中でのシークレットの利用に関する詳しい情報については「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 - -### Maven Central Repositoryと{% data variables.product.prodname_registry %}へのパッケージの公開 - -_ build.gradle _ファイルでそれぞれについて設定すれば、Maven Central Repositoryと{% data variables.product.prodname_registry %}の両方にパッケージを公開できます。 - -_build.gradle_ファイルに、{% data variables.product.prodname_dotcom %}リポジトリとMaven Central Repositoryプロバイダの双方に対するリポジトリを確実に含めてください。 - -たとえば、OSSRHホスティングプロジェクトを通じてMaven Central Repositoryにデプロイしていたなら、`name`を`OSSRH `に設定して配布管理リポジトリでそのことを指定できます。 {% data variables.product.prodname_registry %}にデプロイするなら、`name`を`GitHubPackages`に設定して配布管理リポジトリでそのことを指定できます。 - -Organizationの名前が"octocat"でリポジトリの名前が"hello-world"なら、_build.gradle_中の{% data variables.product.prodname_registry %}の設定は以下の例のようになるでしょう。 - -{% raw %} -```groovy -publishing { - ... - - repositories { - maven { - name = "OSSRH" - url = "https://oss.sonatype.org/service/local/staging/deploy/maven2/" - credentials { - username = System.getenv("MAVEN_USERNAME") - password = System.getenv("MAVEN_PASSWORD") - } - } - maven { - name = "GitHubPackages" - url = "https://maven.pkg.github.com/octocat/hello-world" - credentials { - username = System.getenv("GITHUB_ACTOR") - password = System.getenv("GITHUB_TOKEN") - } - } - } -} -``` -{% endraw %} - -この設定で、`gradle publish`コマンドの実行によってパッケージをMaven Central Repositoryと{% data variables.product.prodname_registry %}の両方に公開するワークフローを作成できます。 - -{% raw %} -```yaml -name: Publish package to the Maven Central Repository and GitHub Packages -on: - release: - types: [created] -jobs: - publish: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - - name: Set up Java - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Publish to the Maven Central Repository - run: gradle publish - env: - MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }} - MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }} - GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} - -{% data reusables.github-actions.gradle-workflow-steps %} -1. `OSSRH` Mavenリポジトリと{% data variables.product.prodname_registry %}に公開するために` gradle publish`コマンドを実行してください。 環境変数の`MAVEN_USERNAME`は`OSSRH_USERNAME`シークレットの内容で、環境変数の`MAVEN_PASSWORD`は`OSSRH_TOKEN`シークレットの内容で設定されます。 環境変数`GITHUB_TOKEN`には、`GITHUB_TOKEN`シークレットの内容が設定されます。 - - ワークフロー中でのシークレットの利用に関する詳しい情報については「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 diff --git a/translations/ja-JP/content/actions/language-and-framework-guides/publishing-java-packages-with-maven.md b/translations/ja-JP/content/actions/language-and-framework-guides/publishing-java-packages-with-maven.md deleted file mode 100644 index 345c379c6fa9..000000000000 --- a/translations/ja-JP/content/actions/language-and-framework-guides/publishing-java-packages-with-maven.md +++ /dev/null @@ -1,209 +0,0 @@ ---- -title: MavenでのJavaのパッケージの公開 -intro: 継続的インテグレーション（CI）ワークフローの一部として、Javaのパッケージをレジストリに公開するためにMavenを利用できます。 -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -### はじめに - -{% data reusables.github-actions.publishing-java-packages-intro %} - -### 必要な環境 - -ワークフローファイルと設定オプションに関する基本的な理解をしておくことをおすすめします。 詳細は「[ワークフローの設定](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)」を参照してください。 - -MavenでのJavaプロジェクトのためのCIワークフローの作成に関する詳しい情報については「[MavenでのJavaのビルドとテスト](/actions/language-and-framework-guides/building-and-testing-java-with-maven)」を参照してください。 - -また、以下の基本的な理解があれば役立ちます。 - -- [{% data variables.product.prodname_actions %}の中核的概念](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions) -- [{% data variables.product.prodname_registry %} で利用するために npm を設定する](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages) -- [環境変数の利用](/actions/automating-your-workflow-with-github-actions/using-environment-variables) -- [暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets) -- [GITHUB_TOKENでの認証](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token) - -### パッケージの設定について - -_pom.xml_ファイル中の`groupId`及び`artifactId`フィールドは、レジストリがパッケージをレジストリにリンクするために利用するパッケージのユニークな識別子を作成します。 詳しい情報については、Apache Mavenのドキュメンテーションの[Guide to uploading artifacts to the Central Repository](http://maven.apache.org/repository/guide-central-repository-upload.html)を参照してください。 - -_pom.xml_ファイルには、Mavenがパッケージをデプロイする配布管理リポジトリの設定も含まれています。 各リポジトリは、名前とデプロイメントURLを持たなければなりません。 これらのリポジトリに対する認証は、Mavenを実行するユーザーのホームディレクトリ内の_.m2/settings.xml_ファイルに設定できます。 - -`setup-java`アクションを使って、デプロイメントリポジトリを認証と合わせて設定できます。 詳しい情報については[`setup-java`](https://github.com/actions/setup-java)を参照してください。 - -### Maven Central Repositoryへのパッケージの公開 - -新しいリリースを作成するたびに、パッケージを公開するワークフローを起動できます。 以下の例でのワークフローは、`created`という種類で`release`イベントが発生したときに実行されます。 このワークフローは、CIテストをパスすればMaven Central Repositoryにパッケージを公開します。 `release`イベントに関する詳しい情報については「[ワークフローを起動するイベント](/actions/reference/events-that-trigger-workflows#release)」を参照してください。 - -このワークフロー内では、`setup-java`アクションを利用できます。 このアクションは、指定されたバージョンのJDKを`PATH`にインストールしますが、パッケージの公開のためのMavenの_settings.xml_も設定します。 デフォルトでは、設定ファイルは{% data variables.product.prodname_registry %}に対して設定されますが、Maven Central Repositoryなどの他のパッケージレジストリにデプロイするようにも設定できます。 _pom.xml_に設定済みの配布管理リポジトリが酢デイあるなら、`setup-java`アクションの呼び出しの際にその`id`を指定できます。 - -たとえば、OSSRHホスティングプロジェクトを通じてMaven Central Repositoryにデプロイしていたなら、_pom.xml_ は`ossrh`の`id`で配布管理リポジトリを指定できます。 - -{% raw %} -```xml - - ... - - - ossrh - Central Repository OSSRH - https://oss.sonatype.org/service/local/staging/deploy/maven2/ - - - -``` -{% endraw %} - -この設定で、リポジトリ管理の`id`を`setup-java`アクションに指定してやることで、パッケージをMaven Central Repositoryに公開するワークフローを作成できます。 リポジトリの認証のために、ユーザ名とパスワードを含む環境変数を提供する必要もあります。 - -デプロイのステップでは、リポジトリに認証してもらうユーザ名と、認証のためのパスワードあるいはトークンで設定したシークレットを環境変数に設定する必要があります。 詳しい情報については、「[暗号化されたシークレットの作成と利用](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 - - -{% raw %} -```yaml -name: Publish package to the Maven Central Repository -on: - release: - types: [created] -jobs: - publish: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - - name: Set up Maven Central Repository - uses: actions/setup-java@v1 - with: - java-version: 1.8 - server-id: ossrh - server-username: MAVEN_USERNAME - server-password: MAVEN_PASSWORD - - name: Publish package - run: mvn -B deploy - env: - MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }} - MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }} -``` -{% endraw %} - -このワークフローは以下のステップを実行します。 - -1. プロジェクトのリポジトリのコピーをチェックアウトします。 -1. Java JDKをセットアップし、環境変数の`MAVEN_USERNAME`と`MAVEN_PASSWORD`を使って`ossrh`リポジトリに対する認証を追加するためにMavenの_settings.xml_ファイルも設定します。 -1. {% data reusables.github-actions.publish-to-maven-workflow-step %} - - ワークフロー中でのシークレットの利用に関する詳しい情報については「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 - -### {% data variables.product.prodname_registry %}へのパッケージの公開 - -新しいリリースを作成するたびに、パッケージを公開するワークフローを起動できます。 以下の例でのワークフローは、`created`という種類で`release`イベントが発生したときに実行されます。 このワークフローは、CIテストをパスすれば{% data variables.product.prodname_registry %}にパッケージを公開します。 `release`イベントに関する詳しい情報については「[ワークフローを起動するイベント](/actions/reference/events-that-trigger-workflows#release)」を参照してください。 - -このワークフロー内では、`setup-java`アクションを利用できます。 このアクションは、指定されたバージョンのJDKを`PATH`にインストールし、{% data variables.product.prodname_registry %}にパッケージを公開するためにMavenの_settings.xml_もセットアップします。 生成された_settings.xml_は、環境変数の`GITHUB_ACTOR`をユーザ名、`GITHUB_TOKEN`をパスワードとして使い、`github`の`id`でサーバーの認証を定義します。 - -`GITHUB_TOKEN`は、デフォルトでリポジトリ中に存在し、ワークフローが実行されるリポジトリ中のパッケージには読み書きの権限があります。 詳しい情報については「[GITHUB_TOKENでの認証](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)」を参照してください。 - -Mavenベースのプロジェクトでは、{% data variables.product.prodname_registry %}のエンドポイントを指す`github`の`id`で_pom.xml_ファイル中に配布リポジトリを作成することによって、これらの設定を利用できます。 - -たとえば、Organizationの名前が"octocat"でリポジトリの名前が"hello-world"なら、_pom.xml_中の{% data variables.product.prodname_registry %}の設定は以下の例のようになるでしょう。 - -{% raw %} -```xml - - ... - - - github - GitHub Packages - https://maven.pkg.github.com/octocat/hello-world - - - -``` -{% endraw %} - -この設定で、自動的に生成された_settings.xml_を利用して{% data variables.product.prodname_registry %}にパッケージを公開するワークフローを作成できます。 - -{% raw %} -```yaml -name: Publish package to GitHub Packages -on: - release: - types: [created] -jobs: - publish: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Publish package - run: mvn -B deploy - env: - GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} - -このワークフローは以下のステップを実行します。 - -1. プロジェクトのリポジトリのコピーをチェックアウトします。 -1. Java JDKをセットアップし、自動的にMavenの_settings.xml_ファイルを設定して環境変数の`GITHUB_TOKEN`を使うように`github` Mavenリポジトリの認証を追加します。 -1. {% data reusables.github-actions.publish-to-packages-workflow-step %} - - ワークフロー中でのシークレットの利用に関する詳しい情報については「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 - -### Maven Central Repositoryと{% data variables.product.prodname_registry %}へのパッケージの公開 - -`setup-java`アクションをそれぞれのレジストリに対して利用すれば、Maven Central Repositoryと{% data variables.product.prodname_registry %}の両方にパッケージを公開できます。 - -_pom.xml_ファイルに、{% data variables.product.prodname_dotcom %}リポジトリとMaven Central Repositoryプロバイダの双方に対する配布管理リポジトリを確実に含めてください。 たとえば、OSSRHホスティングプロジェクトを通じてCentral Repositoryへデプロイするなら、それを`id`を`ossrh`に設定して配布管理リポジトリ内で指定し、`id`を`github`に設定して配布管理リポジトリ内で{% data variables.product.prodname_registry %}を指定することになるかもしれません。 - -{% raw %} -```yaml -name: Publish package to the Maven Central Repository and GitHub Packages -on: - release: - types: [created] -jobs: - publish: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - - name: Set up Java for publishing to Maven Central Repository - uses: actions/setup-java@v1 - with: - java-version: 1.8 - server-id: ossrh - server-username: MAVEN_USERNAME - server-password: MAVEN_PASSWORD - - name: Publish to the Maven Central Repository - run: mvn -B deploy - env: - MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }} - MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }} - - name: Set up Java for publishing to GitHub Packages - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Publish to GitHub Packages - run: mvn -B deploy - env: - GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} - -このワークフローは、`setup-java`アクションを2回呼びます。 実行される度に、`setup-java`アクションはMavenの_settings.xml_をパッケージの公開のために上書きします。 リポジトリの認証については、_settings.xml_ファイルは配布管理リポジトリの`id`、及びユーザ名とパスワードを参照します。 - -このワークフローは以下のステップを実行します。 - -1. プロジェクトのリポジトリのコピーをチェックアウトします。 -1. 1回目の`setup-java`の呼び出しを行います。 これはMavenの_settings.xml_ファイルを`ossrh`に対して設定し、認証のオプションを次のステップで定義される環境変数に設定します。 -1. {% data reusables.github-actions.publish-to-maven-workflow-step %} -1. 2回目の`setup-java`の呼び出しを行います。 Mavenの_settings.xml_ファイルを{% data variables.product.prodname_registry %}に対して自動的に設定します。 -1. {% data reusables.github-actions.publish-to-packages-workflow-step %} - - ワークフロー中でのシークレットの利用に関する詳しい情報については「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 diff --git a/translations/ja-JP/content/actions/language-and-framework-guides/publishing-nodejs-packages.md b/translations/ja-JP/content/actions/language-and-framework-guides/publishing-nodejs-packages.md deleted file mode 100644 index 9ce7ac4c693e..000000000000 --- a/translations/ja-JP/content/actions/language-and-framework-guides/publishing-nodejs-packages.md +++ /dev/null @@ -1,210 +0,0 @@ ---- -title: Node.jsパッケージの公開 -intro: 継続的インテグレーション（CI）ワークフローの一部として、Node.jsのパッケージをレジストリに公開できます。 -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -### はじめに - -本ガイドでは、継続的インテグレーション（CI）テストにパスした後、Node.jsのパッケージを{% data variables.product.prodname_registry %}及びnpmレジストリに公開するワークフローの作成方法を紹介します。 1つのワークフローで、パッケージを1つのレジストリや複数のレジストリに公開できます。 - -### 必要な環境 - -ワークフローの設定オプションと、ワークフローファイルの作成方法についての基本的な知識を持っておくことをおすすめします。 詳細は「[ワークフローの設定](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)」を参照してください。 - -Node.jsプロジェクトのためのCIワークフローの作成に関する詳しい情報については「[{% data variables.product.prodname_actions %}でのNode.jsの利用](/actions/automating-your-workflow-with-github-actions/using-nodejs-with-github-actions)」を参照してください。 - -また、以下の基本的な理解があれば役立ちます。 - -- [{% data variables.product.prodname_actions %}の中核的概念](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions) -- [{% data variables.product.prodname_registry %} で利用するために npm を設定する](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages) -- [環境変数の利用](/actions/automating-your-workflow-with-github-actions/using-environment-variables) -- [暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets) -- [GITHUB_TOKENでの認証](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token) - -### パッケージの設定について - - *package.json*ファイル中の`name`及び`version`フィールドは、レジストリがパッケージをレジストリにリンクするために利用するユニークな識別子を作成します。 *package.json*ファイル中に`description`を含めることによって、パッケージのリストページのためのまとめを追加できます。 詳しい情報については、npmのドキュメンテーション中の「[package.jsonファイルの作成](https://docs.npmjs.com/creating-a-package-json-file)」及び「[Node.jsモジュールの作成](https://docs.npmjs.com/creating-node-js-modules)」を参照してください。 - -ローカルの*.npmrc*ファイルがあり、`registry`の値が指定されている場合、`npm publish`コマンドは*.npmrc*ファイルで設定されたレジストリを使います。 {% data reusables.github-actions.setup-node-intro %} - -`setup-node`アクションを使えば、ランナーにインストールされたNode.jsのバージョンを指定できます。 - -*package.json*ファイルに`publishConfig`フィールドを設定するステップをワークフローに追加したなら、`setup-node`アクションを使ってregistry-urlを指定する必要はありませんが、パッケージを公開するレジストリは1つだけに限られます。 詳しい情報についてはnpmドキュメンテーションの「[Configの公開](https://docs.npmjs.com/files/package.json#publishconfig)」を参照してください。 - -### npmレジストリへのパッケージの公開 - -新しいリリースを作成するたびに、パッケージを公開するワークフローを起動できます。 以下の例でのワークフローは、`created`という種類で`release`イベントが発生したときに実行されます。 このワークフローは、CIテストをパスすればnpmレジストリにパッケージを公開します。 - -ワークフロー中でnpmレジストリに対して認証を受けた操作を行うためには、npmの認証トークンをリポジトリの設定中にシークレットとして保存しなければなりません。 たとえば`NPM_TOKEN`というシークレットを生成してください。 詳しい情報については、「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 - -デフォルトでは、npmは*package.json*ファイルの`name`フィールドを使ってnpmレジストリを決めます。 グローバルな名前空間に公開する場合は、パッケージ名だけを含める必要があります。 たとえば`https://www.npmjs.com/package/npm-hello-world-test`に`npm-hello-world-test`という名前のパッケージを公開できます。 - -スコープのプレフィックスを含むパッケージを公開するなら、そのスコープを*package.json*ファイルの名前に含めてください。 たとえばnpmのスコーププレフィックスがoctocatであり、パッケージ名がhello-worldなら、*package.json*ファイル中の`name`は`@octocat/hello-world`とすべきです。 npmパッケージがスコーププレフィックスを使っており、パブリックであるなら、`npm publish --access public`オプションを使う必要があります。 これは、意図せずプライベートパッケージを公開してしまうことを防ぐためにnpmが必要とするオプションです。 - -以下の例は、`NPM_TOKEN`シークレットを環境変数の`NODE_AUTH_TOKEN`に保存します。 `setup-node`アクションが*.npmrc*ファイルを作成する際には、環境変数の`NODE_AUTH_TOKEN`からトークンを参照します。 - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # npmへの公開のための.npmrcファイルのセットアップ - - uses: actions/setup-node@v1 - with: - node-version: '12.x' - registry-url: 'https://registry.npmjs.org' - - run: npm install - - run: npm publish - env: - NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} -``` -{% endraw %} - -上の例では、`setup-node`アクションは以下の内容でランナー上に*.npmrc*ファイルを作成します。 - -``` -//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN} -registry=https://registry.npmjs.org/ -always-auth=true -``` - -### {% data variables.product.prodname_registry %}へのパッケージの公開 - -新しいリリースを作成するたびに、パッケージを公開するワークフローを起動できます。 以下の例でのワークフローは、`created`という種類で`release`イベントが発生したときに実行されます。 このワークフローは、CIテストをパスすれば{% data variables.product.prodname_registry %}にパッケージを公開します。 - -デフォルトでは、{% data variables.product.prodname_registry %}は*package.json*ファイルの`name`フィールドで指定された{% data variables.product.prodname_dotcom %}のリポジトリにパッケージを公開します。 たとえば`@my-org/test`という名前のパッケージを{% data variables.product.prodname_dotcom %}リポジトリの`my-org/test`に公開します。 詳しい情報については、npmドキュメンテーション中の[`npm-scope`](https://docs.npmjs.com/misc/scope)を参照してください。 - -ワークフロー中で{% data variables.product.prodname_registry %}レジストリに対して認証を受けた操作をするには、`GITHUB_TOKEN`が使えます。 `GITHUB_TOKEN`は、デフォルトでリポジトリ中に存在し、ワークフローが実行されるリポジトリ中のパッケージには読み書きの権限があります。 詳しい情報については、「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 - -以下の例は、`GITHUB_TOKEN`シークレットを環境変数の`NODE_AUTH_TOKEN`に保存します。 `setup-node`アクションが*.npmrc*ファイルを作成する際には、環境変数の`NODE_AUTH_TOKEN`からトークンを参照します。 - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # GitHub パッケージに公開する .npmrc ファイルを設定する - - uses: actions/setup-node@v1 - with: - node-version: '12.x' - registry-url: 'https://npm.pkg.github.com' - # デフォルトはワークフローファイルを所有するユーザまたは Organization - scope: '@octocat' - - run: npm install - - run: npm publish - env: - NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} - -`setup-node`アクションは、ランナー上で*.npmrc*ファイルを作成します。 `setup-node`アクションで`scope`インプットを使うと、*.npmrc*ファイルにはスコーププレフィックスが含まれます。 デフォルトでは、`setup-node`アクションは*.npmrc*ファイルのスコープを、ワークフローファイルを含むアカウントに設定します。 - -``` -//npm.pkg.github.com/:_authToken=${NODE_AUTH_TOKEN} -@octocat:registry=https://npm.pkg.github.com -always-auth=true -``` - -### yarnを利用したパッケージの公開 - -パッケージマネージャーのYarnを使う場合、Yarnを使ってパッケージのインストールと公開が行えます。 - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # npm に公開する .npmrc ファイルを設定する - - uses: actions/setup-node@v1 - with: - node-version: '12.x' - registry-url: 'https://registry.npmjs.org' - # デフォルトはワークフローファイルを所有するユーザまたは Organization - scope: '@octocat' - - run: yarn - - run: yarn publish - env: - NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} -``` -{% endraw %} - -### npmと{% data variables.product.prodname_registry %}へのパッケージの公開 - -{% note %} - -**ノート：** 異なるスコーププレフィックスを持つレジストリへ公開する必要がある倍は、ランナー上の*package.json*ファイルを修正してスコーププレフィックスを変更しなければなりません。 たとえばnpmに対しては`@mona`スコープで、{% data variables.product.prodname_registry %}に対しては`@octocat`スコープでパッケージを公開する場合は、npmへの公開後、{% data variables.product.prodname_registry %}への公開前にランナー上の*package.json*ファイルの`@mona`スコープを`@octocat`で置き換えることができます。 - -{% endnote %} - -`setup-node`アクションをそれぞれのレジストリに対して利用すれば、npmレジストリと{% data variables.product.prodname_registry %}の両方にパッケージを公開できます。 - -両方のレジストリにパッケージを公開するなら、npm上のスコーププレフィックスが{% data variables.product.prodname_dotcom %}のユーザ名もしくはOrganization名と一致することを確認する必要があります。 パッケージをスコーププレフィックス付きでパブリックなレジストリに公開するには、`npm publish --access public`コマンドが使えます。 詳しい情報については、npmドキュメンテーション中の[`npm-scope`](https://docs.npmjs.com/misc/scope)及び「[スコープ付きのパブリックパッケージの作成と公開](https://docs.npmjs.com/creating-and-publishing-scoped-public-packages)」を参照してください。 - -*package.json*ファイルに{% data variables.product.prodname_dotcom %}レジストリとnpmレジストリのスコープが含まれていることを確かめてください。 たとえば、`octocat/npm-hello-world-test`リポジトリ内のパッケージを{% data variables.product.prodname_dotcom %}及びhttps://www.npmjs.com/package/@octocat/npm-hello-world-testに公開する計画をしているなら、*package.json*ファイル内の名前は`"name": "@octocat/npm-hello-world-test"`となるでしょう。 - -ワークフロー中で{% data variables.product.prodname_registry %}レジストリに対して認証を受けた操作をするには、`GITHUB_TOKEN`が使えます。 `GITHUB_TOKEN`は、デフォルトでリポジトリ中に存在し、ワークフローが実行されるリポジトリ中のパッケージには読み書きの権限があります。 詳しい情報については、「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 - -`setup-node`アクションで`scope`インプットを使うと、このアクションはスコーププレフィックスを含む*.npmrc*ファイルを作成します。 デフォルトでは、`setup-node`アクションは*.npmrc*ファイル中のスコープを、ワークフローファイルを所有するユーザもしくはOrganizationに設定します。 - -このワークフローは、`setup-node`アクションを2回呼びます。 `setup-node`アクションは、実行されるたびに*.npmrc*ファイルを上書きします。 *.npmrc*ファイルは、パッケージレジストリに対する認証を受けた操作を行えるようにしてくれるトークンを、環境変数の`NODE_AUTH_TOKEN`から参照します。 このワークフローは、環境変数の`NODE_AUTH_TOKEN`を`npm publish`コマンドが実行されるたびに設定します。初回はnpmへの公開のためのトークン（`NPM_TOKEN`）が、続いて{% data variables.product.prodname_registry %}への公開のためのトークン（`GITHUB_TOKEN`）が使われます。 - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # npmに公開する.npmrcファイルを設定する - - uses: actions/setup-node@v1 - with: - node-version: '10.x' - registry-url: 'https://registry.npmjs.org' - - run: npm install - # npmに公開する - - run: npm publish --access public - env: - NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} - # GitHub パッケージに公開する .npmrc ファイルを設定する - - uses: actions/setup-node@v1 - with: - registry-url: 'https://npm.pkg.github.com' - # デフォルトはワークフローファイルを所有するユーザまたは Organization - scope: '@octocat' - # GitHub パッケージに公開する - - run: npm publish - env: - NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} diff --git a/translations/ja-JP/content/actions/language-and-framework-guides/using-nodejs-with-github-actions.md b/translations/ja-JP/content/actions/language-and-framework-guides/using-nodejs-with-github-actions.md deleted file mode 100644 index 8596860f91a1..000000000000 --- a/translations/ja-JP/content/actions/language-and-framework-guides/using-nodejs-with-github-actions.md +++ /dev/null @@ -1,277 +0,0 @@ ---- -title: GitHub ActionsでのNode.jsの利用 -intro: Node.jsプロジェクトのビルドとテストのための継続的インテグレーション（CI）ワークフローを作成できます。 -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/using-nodejs-with-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -### はじめに - -このガイドでは、Node.jsのコードのビルドとテストを行う継続的インテグレーション（CI）ワークフローの作成方法を紹介します。 CIテストにパスしたなら、コードをデプロイしたりパッケージを公開したりすることになるでしょう。 - -### 必要な環境 - -Node.js、YAML、ワークフローの設定オプションと、ワークフローファイルの作成方法についての基本的な知識を持っておくことをおすすめします。 詳細については、「[ワークフローの設定](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)」と「[ Getting started with Node.js](https://nodejs.org/en/docs/guides/getting-started-guide/)」を参照してください。 - -また、以下の基本的な理解があれば役立ちます。 - -- [{% data variables.product.prodname_actions %}の中核的概念](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions) -- [環境変数の利用](/actions/automating-your-workflow-with-github-actions/using-environment-variables) - -{% data reusables.actions.enterprise-setup-prereq %} - -### Node.jsワークフローテンプレートでの開始 - -{% data variables.product.prodname_dotcom %}は、ほとんどのNode.jsプロジェクトで使えるNode.jsのワークフローテンプレートを提供しています。 このガイドには、カスタマイズして利用できるnpm及びYarnの例が含まれます。 詳しい情報については[Node.jsのワークフローテンプレート](https://github.com/actions/starter-workflows/blob/master/ci/node.js.yml)を参照してください。 - -手早く始めるために、テンプレートをリポジトリの`.github/workflows`ディレクトリに追加してください。 - -{% raw %} -```yaml -name: Node.js CI - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - - strategy: - matrix: - node-version: [8.x, 10.x, 12.x] - - steps: - - uses: actions/checkout@v2 - - name: Use Node.js ${{ matrix.node-version }} - uses: actions/setup-node@v1 - with: - node-version: ${{ matrix.node-version }} - - run: npm install - - run: npm run build --if-present - - run: npm test - env: - CI: true -``` -{% endraw %} - -{% data reusables.github-actions.example-github-runner %} - -### Node.jsのバージョンの指定 - -最も簡単にNode.jsのバージョンを指定する方法は、{% data variables.product.prodname_dotcom %}が提供する`setup-node`アクションを使うことです。 詳しい情報については[`setup-node`](https://github.com/actions/setup-node/)を参照してください。 - -`setup-node`アクションはNode.jsのバージョンを入力として取り、ランナー上でそのバージョンを設定します。 `setup-node`は各ランナー上のツールキャッシュから指定されたNode.jsのバージョンを見つけ、必要なバイナリを`PATH`に追加します。設定されたバイナリは、ジョブでそれ以降永続化されます。 `setup-node`アクションの利用は、{% data variables.product.prodname_actions %}でNode.jsを使うための推奨される方法です。これは、そうすることで様々なランナーや様々なバージョンのNode.jsで一貫した振る舞いが保証されるためです。 セルフホストランナーを使っている場合は、Node.jsをインストールして`PATH`に追加しなければなりません。 - -以下のテンプレートには、Node.jsのバージョン8.x、10.x、12.ｘでコードをビルドしてテストするマトリクス戦略が含まれています。 この'x'はワイルドカードキャラクターで、そのバージョンで利用できる最新のマイナー及びパッチリリースにマッチします。 `node-version`配列で指定されたNode.jsの各バージョンに対して、同じステップを実行するジョブが作成されます。 - -それぞれのジョブは、配列`node-version` のマトリクスで定義された値に、`matrix`コンテキストを使ってアクセスできます。 `setup-node`アクションは、このコンテキストを`node-version`のインプットとして使います。 `setup-node`アクションは、コードのビルドとテストに先立って、様々なNode.jsのバージョンで各ジョブを設定します。 マトリクス戦略とコンテキストに関する詳しい情報については、「[{% data variables.product.prodname_actions %}のワークフロー構文](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix)」及び「[{% data variables.product.prodname_actions %}のコンテキストと式構文](/actions/reference/context-and-expression-syntax-for-github-actions)」を参照してください。 - -{% raw %} -```yaml -strategy: - matrix: - node-version: [8.x, 10.x, 12.x] - -steps: -- uses: actions/checkout@v2 -- name: Use Node.js ${{ matrix.node-version }} - uses: actions/setup-node@v1 - with: - node-version: ${{ matrix.node-version }} -``` -{% endraw %} - -あるいは、厳密にNode.jsバージョンを指定してビルドとテストを行うこともできます。 - -```yaml -strategy: - matrix: - node-version: [8.16.2, 10.17.0] -``` - -または、Node.jsの1つのバージョンを使ってビルドとテストを行うこともできます。 - -{% raw %} -```yaml -name: Node.js CI - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - name: Use Node.js - uses: actions/setup-node@v1 - with: - node-version: '12.x' - - run: npm install - - run: npm run build --if-present - - run: npm test - env: - CI: true -``` -{% endraw %} - -Node.jsのバージョンを指定しなかった場合、{% data variables.product.prodname_dotcom %}は環境のデフォルトのNode.jsのバージョンを使います。 詳しい情報については「[{% data variables.product.prodname_dotcom %}ホストランナーにインストールされているソフトウェア](/actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners)」を参照してください。 - -### 依存関係のインストール - -{% data variables.product.prodname_dotcom %}ホストランナーには、依存関係マネージャーのnpmとYarnがインストールされています。 コードのビルドとテストに先立って、npmやYarnを使ってワークフロー中で依存関係をインストールできます。 Windows及びLinuxの{% data variables.product.prodname_dotcom %}ホストランナーには、Grunt、Gulp、Bowerもインストールされています。 - -ワークフローの速度を上げるために、依存関係をキャッシュすることもできます。 詳しい情報については「[ワークフローを高速化するための依存関係のキャッシング](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)」を参照してください。 - -#### npmの利用例 - -以下の例では、*package.json*ファイルで定義された依存関係がインストールされます。 詳しい情報については[`npm install`](https://docs.npmjs.com/cli/install)を参照してください。 - -```yaml -steps: -- uses: actions/checkout@v2 -- name: Use Node.js - uses: actions/setup-node@v1 - with: - node-version: '12.x' -- name: Install dependencies - run: npm install -``` - -`npm ci`を使うと、 *package-lock.json*あるいは*npm-shrinkwrap.json*ファイル中のバージョンがインストールされ、ロックファイルの更新を回避できます。 概して`npm ci`は、`npm install`を実行するよりも高速です。 詳しい情報については[`npm ci`](https://docs.npmjs.com/cli/ci.html)及び「[Introducing `npm ci` for faster, more reliable builds](https://blog.npmjs.org/post/171556855892/introducing-npm-ci-for-faster-more-reliable)」を参照してください。 - -{% raw %} -```yaml -steps: -- uses: actions/checkout@v2 -- name: Use Node.js - uses: actions/setup-node@v1 - with: - node-version: '12.x' -- name: Install dependencies - run: npm ci -``` -{% endraw %} - -#### Yarnの利用例 - -以下の例では、*package.json*ファイルで定義された依存関係がインストールされます。 詳しい情報については[`yarn install`](https://yarnpkg.com/en/docs/cli/install)を参照してください。 - -```yaml -steps: -- uses: actions/checkout@v2 -- name: Use Node.js - uses: actions/setup-node@v1 - with: - node-version: '12.x' -- name: Install dependencies - run: yarn -``` - -あるいは`--frozen-lockfile`を渡して*yarn.lock*ファイル中のバージョンをインストールし、*yarn.lock*ファイルの更新を回避できます。 - -```yaml -steps: -- uses: actions/checkout@v2 -- name: Use Node.js - uses: actions/setup-node@v1 - with: - node-version: '12.x' -- name: Install dependencies - run: yarn --frozen-lockfile -``` - -#### プライベートレジストリの利用と.npmrcファイルの作成の例 - -{% data reusables.github-actions.setup-node-intro %} - -プライベートリポジトリで認証を受けるには、npm認証トークンをリポジトリ設定中にシークレットとして保存しなければなりません。 たとえば`NPM_TOKEN`というシークレットを生成してください。 詳しい情報については、「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 - -以下の例では、`NPM_TOKEN`というシークレットにはnpmの認証トークンが保存されます。 `setup-node`アクションは、環境変数の`NODE_AUTH_TOKEN`からnpmの認証トークンを読み取るよう*.npmrc*ファイルを設定します。 `setup-node`アクションを使って*.npmrc*ファイルを作成する場合、環境変数の`NPM_AUTH_TOKEN`にnpmの認証トークンを含むシークレットを設定しなければなりません。 - -依存関係をインストールする前に、`setup-node`アクションを使って*.npmrc*ファイルを作成してください。 このアクションには2つの入力パラメーターがあります。 `node-version`パラメーターはNode.jsのバージョンを設定し、`registry-url`パラメーターはデフォルトのレジストリを設定します。 パッケージレジストリがスコープを使うなら、`scope`パラメーターを使わなければなりません。 詳しい情報については[`npm-scope`](https://docs.npmjs.com/misc/scope)を参照してください。 - -{% raw %} -```yaml -steps: -- uses: actions/checkout@v2 -- name: Use Node.js - uses: actions/setup-node@v1 - with: - always-auth: true - node-version: '12.x' - registry-url: https://registry.npmjs.org - scope: '@octocat' -- name: Install dependencies - run: npm ci - env: - NODE_AUTH_TOKEN: ${{secrets.NPM_TOKEN}} -``` -{% endraw %} - -上の例では、以下の内容で*.npmrc*ファイルを作成しています。 - -``` -//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN} -@octocat:registry=https://registry.npmjs.org/ -always-auth=true -``` - -#### 依存関係のキャッシングの例 - -`cache`アクションを使って、ユニークキーを使って依存関係をキャッシュし、将来のワークフローの実行で依存関係をリストアできます。 詳しい情報については「[ワークフローを高速化するための依存関係のキャッシング](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)」及び[`cache`アクション](https://github.com/marketplace/actions/cache)を参照してください。 - -{% raw %} -```yaml -steps: -- uses: actions/checkout@v2 -- name: Use Node.js - uses: actions/setup-node@v1 - with: - node-version: '12.x' -- name: Cache Node.js modules - uses: actions/cache@v2 - with: - # npm キャッシュファイルは Linux/macOS の「~/.npm」に保存される - path: ~/.npm - key: ${{ runner.OS }}-node-${{ hashFiles('**/package-lock.json') }} - restore-keys: | - ${{ runner.OS }}-node- - ${{ runner.OS }}- -- name: Install dependencies - run: npm ci -``` -{% endraw %} - -### コードのビルドとテスト - -ローカルで使うのと同じコマンドを、コードのビルドとテストに使えます。 たとえば*package.json*ファイルで定義されたビルドのステップを実行するのに`npm run build`を実行し、テストスイートを実行するのに`npm test`を実行しているなら、それらのコマンドをワークフローファイルに追加します。 - -```yaml -steps: -- uses: actions/checkout@v2 -- name: Use Node.js - uses: actions/setup-node@v1 - with: - node-version: '12.x' -- run: npm install -- run: npm run build --if-present -- run: npm test -``` - -### 成果物としてのワークフローのデータのパッケージ化 - -ビルドとテストのステップの成果物を保存し、ジョブの完了後に見ることができます。 たとえば、ログファイル、コアダンプ、テスト結果、スクリーンショットを保存する必要があるかもしれません。 詳しい情報については「[成果物を利用してワークフローのデータを永続化する](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)」を参照してください。 - -### パッケージレジストリへの公開 - -CIテストにパスした後、Node.jsパッケージをパッケージレジストリに公開するようにワークフローを設定できます。 npm及び{% data variables.product.prodname_registry %}への公開に関する詳しい情報については「[Node.jsパッケージの公開](/actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages)」を参照してください。 diff --git a/translations/ja-JP/content/actions/language-and-framework-guides/using-python-with-github-actions.md b/translations/ja-JP/content/actions/language-and-framework-guides/using-python-with-github-actions.md deleted file mode 100644 index d144df570033..000000000000 --- a/translations/ja-JP/content/actions/language-and-framework-guides/using-python-with-github-actions.md +++ /dev/null @@ -1,462 +0,0 @@ ---- -title: GitHub ActionsでのPythonの利用 -intro: Pythonプロジェクトのビルドとテストのための継続的インテグレーション（CI）ワークフローを作成できます。 -redirect_from: - - /actions/automating-your-workflow-with-github-actions/using-python-with-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -### はじめに - -このガイドは、Pythonパッケージのビルド、テスト、公開の方法を紹介します。 - -{% data variables.product.prodname_dotcom %}ホストランナーは、Python及びPyPyを含むプリインストールされたソフトウェアを伴うツールキャッシュを持ちます。 自分では何もインストールする必要がありません！ 最新のソフトウェアとプリインストールされたバージョンのPython及びPyPyの完全なリストについては、[{% data variables.product.prodname_dotcom %}ホストランナー上にインストールされているソフトウェア](/actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners)を参照してください。 - -### 必要な環境 - -YAMLと{% data variables.product.prodname_actions %}の構文に馴染んでいる必要があります。 詳細については、「[{% data variables.product.prodname_actions %}のワークフロー構文](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)」を参照してください。 - -Python、PyPy、pipの基本的な理解をしておくことをおすすめします。 詳しい情報については、以下を参照してください。 -- [Getting started with Python](https://www.python.org/about/gettingstarted/) -- [PyPy](https://pypy.org/) -- [Pip package manager](https://pypi.org/project/pip/) - -{% data reusables.actions.enterprise-setup-prereq %} - -### Pythonワークフローテンプレートでの開始 - -{% data variables.product.prodname_dotcom %}は、ほとんどのPythonプロジェクトで使えるPythonのワークフローテンプレートを提供しています。 このガイドには、テンプレートのカスタマイズに利用できる例が含まれます。 詳しい情報については[Pythonのワークフローテンプレート](https://github.com/actions/starter-workflows/blob/master/ci/python-package.yml)を参照してください。 - -手早く始めるために、テンプレートをリポジトリの`.github/workflows`ディレクトリに追加してください。 - -{% raw %} -```yaml -name: Python package - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - strategy: - matrix: - python-version: [2.7, 3.5, 3.6, 3.7, 3.8] - - steps: - - uses: actions/checkout@v2 - - name: Set up Python ${{ matrix.python-version }} - uses: actions/setup-python@v2 - with: - python-version: ${{ matrix.python-version }} - - name: Install dependencies - run: | - python -m pip install --upgrade pip - pip install flake8 pytest - if [ -f requirements.txt ]; then pip install -r requirements.txt; fi - - name: Lint with flake8 - run: | - # Python 構文エラーまたは未定義の名前がある場合はビルドを停止する - flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics - # exit-zeroはすべてのエラーを警告として扱う。 GitHubのエディタの幅は127文字 - flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics - - name: Test with pytest - run: | - pytest -``` -{% endraw %} - -### Pythonのバージョンの指定 - -{% data variables.product.prodname_dotcom %}ホストランナー上でPythonもしくはPyPyのプリインストールされたバージョンを使うには、`setup-python`アクションを使ってください。 このアクションは各ランナーのツールキャッシュから指定されたバージョンのPythonもしくはPyPyを見つけ、必要なバイナリを`PATH`に追加します。設定されたバイナリは、ジョブでそれ以降永続化されます。 特定のバージョンの Python がツールキャッシュにプリインストールされていない場合、`setup-python` アクションは [`python-versions`](https://github.com/actions/python-versions) リポジトリから適切なバージョンをダウンロードして設定します。 - -`setup-action`の利用は、{% data variables.product.prodname_actions %}でPythonを使うための推奨される方法です。 これは、そうすることで様々なランナーや様々なバージョンのPythonで一貫した振る舞いが保証されるためです。 セルフホストランナーを使っている場合は、Pythonをインストールして`PATH`に追加しなければなりません。 詳しい情報については、[`setup-python`アクション](https://github.com/marketplace/actions/setup-python)を参照してください。 - -以下の表は、各{% data variables.product.prodname_dotcom %}ホストランナー内でのツールキャッシュの場所です。 - -| | Ubuntu | Mac | Windows | -| ------------------ | ------------------------------- | ---------------------------------------- | ------------------------------------------ | -| **ツールキャッシュディレクトリ** | `/opt/hostedtoolcache/*` | `/Users/runner/hostedtoolcache/*` | `C:\hostedtoolcache\windows\*` | -| **Pythonツールキャッシュ** | `/opt/hostedtoolcache/Python/*` | `/Users/runner/hostedtoolcache/Python/*` | `C:\hostedtoolcache\windows\Python\*` | -| **PyPyツールキャッシュ** | `/opt/hostedtoolcache/PyPy/*` | `/Users/runner/hostedtoolcache/PyPy/*` | `C:\hostedtoolcache\windows\PyPy\*` | - -セルフホストランナーを使用している場合は、`setup-python` アクションを使用して依存関係を管理するようにランナーを設定できます。 詳しい情報については、`setup-python` の README にある「[セルフホストランナーで setup-python を使用する](https://github.com/actions/setup-python#using-setup-python-with-a-self-hosted-runner)」を参照してください。 - -{% data variables.product.prodname_dotcom %}は、セマンティックバージョン構文をサポートしています。 詳しい情報については「[セマンティックバージョンの利用](https://docs.npmjs.com/about-semantic-versioning#using-semantic-versioning-to-specify-update-types-your-package-can-accept)」及び「[セマンティックバージョンの仕様](https://semver.org/)」を参照してください。 - -#### Pythonの複数バージョンの利用 - -{% raw %} -```yaml -name: Python package - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - strategy: - # python-version内のPyPyのバージョンが利用できる。 - # For example, pypy2 and pypy3 - matrix: - python-version: [2.7, 3.5, 3.6, 3.7, 3.8] - - steps: - - uses: actions/checkout@v2 - - name: Set up Python ${{ matrix.python-version }} - uses: actions/setup-python@v2 - with: - python-version: ${{ matrix.python-version }} - # 現在の Python バージョンを印刷して、マトリックスをテストできます - - name: Display Python version - run: python -c "import sys; print(sys.version)" -``` -{% endraw %} - -#### 　特定のバージョンのPythonの利用 - -Pythonの特定バージョンを設定することができます。 たとえば3.8が利用できます。 あるいは、セマンティックバージョン構文を使い、最新のマイナーリリースを使うことができます。 以下の例では、Python 3の最新のマイナーリリースを使います。 - -{% raw %} -```yaml -name: Python package - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - name: Set up Python 3.x - uses: actions/setup-python@v2 - with: - # セマンティックバージョン範囲の構文または Python バージョンの正確なバージョン - python-version: '3.x' - # オプション - x64 または x86 アーキテクチャ、デフォルトは x64 - architecture: 'x64' - # 現在の Python バージョンを印刷して、マトリックスをテストできます - - name: Display Python version - run: python -c "import sys; print(sys.version)" -``` -{% endraw %} - -#### バージョンの除外 - -使用できないPythonのバージョンを指定すると、`setup-python`は`##[error]Version 3.4 with arch x64 not found`といったエラーで失敗します。 このエラーメッセージには、利用できるバージョンが含まれます。 - -実行したくないPythonの環境があるなら、ワークフロー中で`exclude`キーワードを使うこともできます。 詳しい情報については、「[{% data variables.product.prodname_actions %} のワークフロー構文](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategy)」を参照してください。 - -{% raw %} -```yaml -name: Python package - -on: [push] - -jobs: - build: - - runs-on: ${{ matrix.os }} - strategy: - matrix: - os: [ubuntu-latest, macos-latest, windows-latest] - python-version: [2.7, 3.6, 3.7, 3.8, pypy2, pypy3] - exclude: - - os: macos-latest - python-version: 3.6 - - os: windows-latest - python-version: 3.6 -``` -{% endraw %} - -#### デフォルトバージョンのPythonの利用 - -依存関係を明示的にしやすくなるので、ワークフロー中で使うPythonのバージョンの設定には`setup-python`を使うことをおすすめします。 `setup-python`を使わない場合、いずれかのシェルで`python`を呼ぶと`PATH`に設定されたデフォルトバージョンのPythonが使われます。 デフォルトバージョンのPythonは、{% data variables.product.prodname_dotcom %}ホストランナーによって様々なので、予想外の変更が生じたり、期待しているよりも古いバージョンが使われたりするかもしれません。 - -| {% data variables.product.prodname_dotcom %}ホストランナー | 説明 | -| -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Ubuntu | Ubuntuランナーでは`/usr/bin/python`及び`/usr/bin/python3`の下に複数バージョンのシステムPythonがあります。 {% data variables.product.prodname_dotcom %}がツールキャッシュにインストールしエチルバージョンに加えて、UbuntuにパッケージングされているバージョンのPythonがあります。 | -| Windows | ツールキャッシュにあるPythonのバージョンを除けば、WindowsにはシステムPythonに相当するバージョンは含まれていません。 他のランナーとの一貫した動作を保ち、`setup-python`アクションなしですぐにPythonが使えるようにするため、{% data variables.product.prodname_dotcom %}はツールキャッシュからいくつかのバージョンを`PATH`に追加します。 | -| macOS | macOSランナーには、ツールキャッシュ内のバージョンに加えて、複数バージョンのシステムPythonがインストールされています。 システムのPythonバージョンは`/usr/local/Cellar/python/*`mディレクトリにあります。 | - -### 依存関係のインストール - -{% data variables.product.prodname_dotcom %}ホストランナーには、パッケージマネージャーのpipがインストールされています。 コードのビルドとテストに先立って、pipを使ってパッケージレジストリのPyPIから依存関係をインストールできます。 たとえば以下のYAMLは`pip`パッケージインストーラーと`setuptools`及び`wheel`パッケージのインストールやアップグレードを行います。 - -ワークフローの速度を上げるために、依存関係をキャッシュすることもできます。 詳しい情報については「[ワークフローを高速化するための依存関係のキャッシング](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)」を参照してください。 - -{% raw %} -```yaml -steps: -- uses: actions/checkout@v2 -- name: Set up Python - uses: actions/setup-python@v2 - with: - python-version: '3.x' -- name: Install dependencies - run: python -m pip install --upgrade pip setuptools wheel -``` -{% endraw %} - -#### Requirementsファイル - -`pip`をアップデートした後、次の典型的なステップは*requirements.txt*からの依存関係のインストールです。 - -{% raw %} -```yaml -steps: -- uses: actions/checkout@v2 -- name: Set up Python - uses: actions/setup-python@v2 - with: - python-version: '3.x' -- name: Install dependencies - run: | - python -m pip install --upgrade pip - pip install -r requirements.txt -``` -{% endraw %} - -#### 依存関係のキャッシング - -`cache`アクションを使って、ユニークキーを使ってpipの依存関係をキャッシュし、将来のワークフローの実行で依存関係をリストアできます。 詳しい情報については「[ワークフローを高速化するための依存関係のキャッシング](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)」を参照してください。

    - -ランナーのオペレーティングシステムによって、pipは依存関係を様々な場所にキャッシュします。 キャッシュする必要があるパスは、使用するオペレーティングシステムによって以下のUbuntuの例とは異なるかもしれません。 詳しい情報については[Pythonのキャッシングの例](https://github.com/actions/cache/blob/master/examples.md#python---pip)を参照してください。 - -{% raw %} - - -```yaml -steps: -- uses: actions/checkout@v2 -- name: Setup Python - uses: actions/setup-python@v2 - with: - python-version: '3.x' -- name: Cache pip - uses: actions/cache@v2 - with: - # このパスは Ubuntu に固有です - path: ~/.cache/pip - # 対応する要件ファイルにキャッシュヒットがあるかどうかを確認する - key: ${{ runner.os }}-pip-${{ hashFiles('requirements.txt') }} - restore-keys: | - ${{ runner.os }}-pip- - ${{ runner.os }}- -- name: Install dependencies - run: pip install -r requirements.txt -``` - - -{% endraw %} - -{% note %} - -**ノート：** 依存関係の数によっては、依存関係キャッシュを使う方が高速になることがあります。 多くの大きな依存関係を持つプロジェクトでは、ダウンロードに必要な時間を節約できるので、パフォーマンスの向上が見られるでしょう。 依存関係が少ないプロジェクトでは、大きなパフォーマンスの向上は見られないかもしれず、pipがキャッシュされた依存関係をインストールする方法のために、パフォーマンスがやや低下さえするかもしれません。 パフォーマンスはプロジェクトによって異なります。 - -{% endnote %} - - - -### コードのテスト - -ローカルで使うのと同じコマンドを、コードのビルドとテストに使えます。 - - - -#### pytest及びpytest-covでのテスト - -以下の例では、`pytest`及び`pytest-cov`をインストールあるいはアップグレードします。 そしてテストが実行され、JUnit形式で出力が行われ、一方でコードカバレッジの結果がCoberturaに出力されます。 詳しい情報については[JUnit](https://junit.org/junit5/)及び[Cobertura](https://cobertura.github.io/cobertura/)を参照してください。 - -{% raw %} - - -```yaml -steps: -- uses: actions/checkout@v2 -- name: Set up Python - uses: actions/setup-python@v2 - with: - python-version: '3.x' -- name: Install dependencies - run: | - python -m pip install --upgrade pip - pip install -r requirements.txt -- name: Test with pytest - run: | - pip install pytest - pip install pytest-cov - pytest tests.py --doctest-modules --junitxml=junit/test-results.xml --cov=com --cov-report=xml --cov-report=html -``` - - -{% endraw %} - - - -#### Flake8を使ったコードのlint - -以下の例は、`flake8`をインストールもしくはアップグレードし、それを使ってすべてのファイルをlintします。 詳しい情報については[Flake8](http://flake8.pycqa.org/en/latest/)を参照してください。 - -{% raw %} - - -```yaml -steps: -- uses: actions/checkout@v2 -- name: Set up Python - uses: actions/setup-python@v2 - with: - python-version: '3.x' -- name: Install dependencies - run: | - python -m pip install --upgrade pip - pip install -r requirements.txt -- name: Lint with flake8 - run: | - pip install flake8 - flake8 . -``` - - -{% endraw %} - - - -#### toxでのテストの実行 - -{% data variables.product.prodname_actions %}では、toxでテストを実行し、その処理を複数のジョブに分散できます。 toxを起動する際には、特定のバージョンを指定するのではなく、`-e py`オプションを使って`PATH`中のPythonのバージョンを選択しなければなりません。 詳しい情報については [tox](https://tox.readthedocs.io/en/latest/)を参照してください。 - -{% raw %} - - -```yaml -name: Python package - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - strategy: - matrix: - python: [2.7, 3.7, 3.8] - - steps: - - uses: actions/checkout@v2 - - name: Setup Python - uses: actions/setup-python@v2 - with: - python-version: ${{ matrix.python }} - - name: Install Tox and any other packages - run: pip install tox - - name: Run Tox - # 「PATH」で Python のバージョンを使用して tox を実行する - run: tox -e py -``` - - -{% endraw %} - - - -### 成果物としてのワークフローのデータのパッケージ化 - -ワークフローの完了後に、成果物をアップロードして見ることができます。 たとえば、ログファイル、コアダンプ、テスト結果、スクリーンショットを保存する必要があるかもしれません。 詳しい情報については「[成果物を利用してワークフローのデータを永続化する](/github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)」を参照してください。 - -以下の例は、`upload-artifact`アクションを使って`pytest`の実行によるテスト結果をアーカイブする方法を示しています。 詳しい情報については[`upload-artifact`アクション](https://github.com/actions/upload-artifact)を参照してください。 - -{% raw %} - - -```yaml -name: Python package - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - strategy: - matrix: - python-version: [2.7, 3.5, 3.6, 3.7, 3.8] - - steps: - - uses: actions/checkout@v2 - - name: Setup Python # Set Python version - uses: actions/setup-python@v2 - with: - python-version: ${{ matrix.python-version }} - # pip と pytest をインストールする - - name: Install dependencies - run: | - python -m pip install --upgrade pip - pip install pytest - - name: Test with pytest - run: pytest tests.py --doctest-modules --junitxml=junit/test-results-${{ matrix.python-version }}.xml - - name: Upload pytest test results - uses: actions/upload-artifact@v2 - with: - name: pytest-results-${{ matrix.python-version }} - path: junit/test-results-${{ matrix.python-version }}.xml - # テスト失敗時にテスト結果を公開するには、always() を使用して常にこのステップを実行する - if: ${{ always() }} -``` - - -{% endraw %} - - - -### パッケージレジストリへの公開 - -CIテストにパスしたなら、Pythonパッケージを任意のパッケージレジストリに公開するようにワークフローを設定できます。 - -パッケージを公開するのに必要なアクセストークンやクレデンシャルは、リポジトリシークレットを使って保存できます。 以下の例では、`twine`と`dist`を使ってパッケージを作成してPyPIに公開しています。 詳しい情報については、「[暗号化されたシークレットの作成と利用](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 - -{% raw %} - - -```yaml -name: Upload Python Package - -on: - release: - types: [created] - -jobs: - deploy: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - - name: Set up Python - uses: actions/setup-python@v2 - with: - python-version: '3.x' - - name: Install dependencies - run: | - python -m pip install --upgrade pip - pip install setuptools wheel twine - - name: Build and publish - env: - TWINE_USERNAME: ${{ secrets.PYPI_USERNAME }} - TWINE_PASSWORD: ${{ secrets.PYPI_PASSWORD }} - run: | - python setup.py sdist bdist_wheel - twine upload dist/* -``` - - -{% endraw %} - -テンプレートワークフローに関する詳しい情報については[`python-publish`](https://github.com/actions/starter-workflows/blob/master/ci/python-publish.yml)を参照してください。 diff --git a/translations/ja-JP/content/actions/migrating-to-github-actions/index.md b/translations/ja-JP/content/actions/migrating-to-github-actions/index.md deleted file mode 100644 index f32fca314731..000000000000 --- a/translations/ja-JP/content/actions/migrating-to-github-actions/index.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: GitHub Actionsへの移行 -intro: '他の継続的インテグレーション（CI）プロバイダから{% data variables.product.prodname_actions %}への移行' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -{% link_in_list /migrating-from-circleci-to-github-actions %} -{% link_in_list /migrating-from-azure-pipelines-to-github-actions %} -{% link_in_list /migrating-from-azure-pipelines-to-github-actions %} diff --git a/translations/ja-JP/content/actions/migrating-to-github-actions/migrating-from-azure-pipelines-to-github-actions.md b/translations/ja-JP/content/actions/migrating-to-github-actions/migrating-from-azure-pipelines-to-github-actions.md deleted file mode 100644 index a9977e916281..000000000000 --- a/translations/ja-JP/content/actions/migrating-to-github-actions/migrating-from-azure-pipelines-to-github-actions.md +++ /dev/null @@ -1,329 +0,0 @@ ---- -title: Azure PipelinesからGitHub Actionsへの移行 -intro: '{% data variables.product.prodname_actions %}とAzure Pipelinesは、いくつかの点で設定が似ており、そのため{% data variables.product.prodname_actions %}への移行は比較的単純です。' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -### はじめに - -Azure Pipelinesと{% data variables.product.prodname_actions %}は、どちらも自動的にコードのビルド、テスト、公開、リリース、デプロイを行うワークフローを作成できます。 Azure Pipelinesと{% data variables.product.prodname_actions %}は、ワークフローの設定において似ているところがあります。 - -- ワークフローの設定ファイルはYAMLで書かれ、コードのリポジトリに保存されます。 -- ワークフローには1つ以上のジョブが含まれます。 -- ジョブには1つ以上のステップもしくは個別のコマンドが含まれます。 -- ステップもしくはタスクは、再利用とコミュニティとの共有が可能です。 - -詳しい情報については、「[{% data variables.product.prodname_actions %}の中核的概念](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)」を参照してください。 - -### 主要な差異 - -Azure Pipelinesから移行する際には、以下の差異を考慮してください。 - -- Azure Pipelineはレガシーの_クラシックエディタ_をサポートしています。これはCIの設定を、YAMLファイルでパイプラインの定義を作成する代わりに、GUIのエディタで定義できるようにするものです。 {% data variables.product.prodname_actions %}はワークフローの定義にYAMLファイルを使い、グラフィカルなエディタはサポートしていません。 -- Azure Pipelinesでは、ジョブの定義中の一部の構造を省略できます。 たとえば、ジョブが1つだけしかないなら、ジョブを定義する必要はなく、ステップだけを定義すれば済みます。 {% data variables.product.prodname_actions %}は明示的な設定が必要であり、YAMLの構造は省略できません。 -- Azure PipelinesはYAMLファイル中で定義される_ステージ_をサポートしています。ステージは、デプロイメントのワークフローの作成に利用できます。 {% data variables.product.prodname_actions %}では、ステージは個別のYAMLワークフローファイルに分割しなければなりません。 -- オンプレミスのAzure Pipelinesビルドエージェントは、機能で選択できます。 {% data variables.product.prodname_actions %}のセルフホストランナーは、ラベルで選択できます。 - -### ジョブとステップの移行 - -Azure Pipelinesのジョブとステップは、{% data variables.product.prodname_actions %}のジョブとステップによく似ています。 どちらのシステムでも、ジョブは以下の特徴を持ちます。 - -* ジョブは、順番に実行される一連のステップを持ちます。 -* ジョブは、個別の仮想マシンまたは個別のコンテナで実行されます。 -* ジョブは、デフォルトでは並列に実行されますが、順次実行するように設定することもできます。 - -### スクリプトのステップの移行 - -スクリプトやシェルのコマンドを、ワークフロー中のステップとして実行できます。 Azure Pipelinesでは、スクリプトのステップは`script`キー、あるいは`bash`、`powershell`、`pwsh`といったキーで指定できます。 スクリプトはまた、[Bashタスク](https://docs.microsoft.com/en-us/azure/devops/pipelines/tasks/utility/bash?view=azure-devops)あるいは[PowerShellタスク](https://docs.microsoft.com/en-us/azure/devops/pipelines/tasks/utility/powershell?view=azure-devops)への入力としても指定できます。 - -{% data variables.product.prodname_actions %}では、すべてのスクリプトは`run`キーを使って指定されます。 特定のシェルを選択するには、スクリプトを提供する際に`shell`キーを指定します。 詳細については、「[{% data variables.product.prodname_actions %}のワークフロー構文](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)」を参照してください。 - -以下が、それぞれのシステムの構文の例です。 - - - - - - - - - - -
    -Azure Pipelines - -{% data variables.product.prodname_actions %} -
    -{% raw %} -```yaml -jobs: -- job: scripts - pool: - vmImage: 'windows-latest' - steps: - - script: echo "This step runs in the default shell" - - bash: echo "This step runs in bash" - - pwsh: Write-Host "This step runs in PowerShell Core" - - task: PowerShell@2 - inputs: - script: Write-Host "This step runs in PowerShell" -``` -{% endraw %} - -{% raw %} -```yaml -jobs: - scripts: - runs-on: windows-latest - steps: - - run: echo "This step runs in the default shell" - - run: echo "This step runs in bash" - shell: bash - - run: Write-Host "This step runs in PowerShell Core" - shell: pwsh - - run: Write-Host "This step runs in PowerShell" - shell: powershell -``` -{% endraw %} -
    - -### スクリプトのエラー処理の差異 - -Azure Pipelinesでは、`stderr`への出力があればスクリプトがエラーとなるように設定できます。 {% data variables.product.prodname_actions %}はこの設定をサポートしていません。 - -{% data variables.product.prodname_actions %}は、可能な場合にはシェルを"fail fast"に設定します。これは、スクリプト中のコマンドの1つがエラーコードで終了した場合に即座にスクリプトを停止させるものです。 これに対し、Azure Pipelinesではエラーの際に即座に終了させるためには、明示的に設定しなければなりません。 詳細については、「[{% data variables.product.prodname_actions %}のワークフロー構文](/actions/reference/workflow-syntax-for-github-actions#exit-codes-and-error-action-preference)」を参照してください。 - -### Windows上でのデフォルトシェルの差異 - -Azure Pipelinesでは、Windowsプラットフォーム上のスクリプトのためのデフォルトシェルはコマンドシェル(_cmd.exe_)です。 {% data variables.product.prodname_actions %}では、Windowsプラットフォーム上のスクリプトのためのデフォルトシェルはPowerShellです。 PowerShellは、組み込みコマンド、変数の展開、フロー制御で多少の差異があります。 - -シンプルなコマンドを実行するなら、コマンドシェルのスクリプトを変更なしにPowerShellで実行できるかもしれません。 しかしほとんどの場合は、PowerShellの構文でスクリプトをアップデートするか、{% data variables.product.prodname_actions %}に対してスクリプトをPowerShellではなくコマンドシェルで実行するように指定することになります。 それには、`shell`を`cmd`と指定します。 - -以下が、それぞれのシステムの構文の例です。 - - - - - - - - - - -
    -Azure Pipelines - -{% data variables.product.prodname_actions %} -
    -{% raw %} -```yaml -jobs: -- job: run_command - pool: - vmImage: 'windows-latest' - steps: - - script: echo "This step runs in CMD on Windows by default" -``` -{% endraw %} - -{% raw %} -```yaml -jobs: - run_command: - runs-on: windows-latest - steps: - - run: echo "This step runs in PowerShell on Windows by default" - - run: echo "This step runs in CMD on Windows explicitly" - shell: cmd -``` -{% endraw %} -
    - -詳細については、「[{% data variables.product.prodname_actions %}のワークフロー構文](/actions/reference/workflow-syntax-for-github-actions#using-a-specific-shell)」を参照してください。 - -### 条件と式の構文の移行 - -Azure Pipelinesと{% data variables.product.prodname_actions %}は、どちらもステップを条件付きで実行できます。 Azure Pipelinesでは、条件式は`condition`キーを使って指定します。 {% data variables.product.prodname_actions %}では、条件式は`if`キーを使って指定します。 - -Azure Pipelinesは、ステップを条件付きで実行するために、式の中で関数を使います。 それに対し、{% data variables.product.prodname_actions %}はinfix表記を使います。 たとえば、Azure Pipelinesにおける`eq`関数は、{% data variables.product.prodname_actions %}では`==`演算子に置き換えなければなりません。 - -以下が、それぞれのシステムの構文の例です。 - - - - - - - - - - -
    -Azure Pipelines - -{% data variables.product.prodname_actions %} -
    -{% raw %} -```yaml -jobs: -- job: conditional - pool: - vmImage: 'ubuntu-latest' - steps: - - script: echo "This step runs with str equals 'ABC' and num equals 123" - condition: and(eq(variables.str, 'ABC'), eq(variables.num, 123)) -``` -{% endraw %} - -{% raw %} -```yaml -jobs: - conditional: - runs-on: ubuntu-latest - steps: - - run: echo "This step runs with str equals 'ABC' and num equals 123" - if: ${{ env.str == 'ABC' && env.num == 123 }} -``` -{% endraw %} -
    - -詳しい情報については、「[{% data variables.product.prodname_actions %} のコンテキストと式構文](/actions/reference/context-and-expression-syntax-for-github-actions)」を参照してください。 - -### ジョブ間の依存関係 - -Azure Pipelinesと{% data variables.product.prodname_actions %}は、どちらもジョブの依存関係を設定できます。 どちらのシステムでも、デフォルトではジョブは並行に実行されますが、ジョブの依存関係を明示的に指定できます。 Azure Pipelinesでは、これは`dependsOn`キーで行います。 {% data variables.product.prodname_actions %}では、`needs`キーを使って行います。 - -以下は、それぞれのシステムにおける構文の例です。 このワークフローは、`initial`という名前の最初のジョブを開始し、そのジョブが終わると`fanout1`と`fanout2`という名前の2つのジョブが実行されます。 最後に、それらのジョブが完了すると、`fanin`というジョブが実行されます。 - - - - - - - - - - -
    -Azure Pipelines - -{% data variables.product.prodname_actions %} -
    -{% raw %} -```yaml -jobs: -- job: initial - pool: - vmImage: 'ubuntu-latest' - steps: - - script: echo "This job will be run first." -- job: fanout1 - pool: - vmImage: 'ubuntu-latest' - dependsOn: initial - steps: - - script: echo "This job will run after the initial job, in parallel with fanout2." -- job: fanout2 - pool: - vmImage: 'ubuntu-latest' - dependsOn: initial - steps: - - script: echo "This job will run after the initial job, in parallel with fanout1." -- job: fanin: - pool: - vmImage: 'ubuntu-latest' - dependsOn: [fanout1, fanout2] - steps: - - script: echo "This job will run after fanout1 and fanout2 have finished." -``` -{% endraw %} - -{% raw %} -```yaml -jobs: -- job: initial - pool: - vmImage: 'ubuntu-latest' - steps: - - script: echo "This job will be run first." - - job: fanout1 - pool: - vmImage: 'ubuntu-latest' - dependsOn: initial - steps: - - script: echo "This job will run after the initial job, in parallel with fanout2." - - job: fanout2 - pool: - vmImage: 'ubuntu-latest' - dependsOn: initial - steps: - - script: echo "This job will run after the initial job, in parallel with fanout1." - - job: fanin: - pool: - vmImage: 'ubuntu-latest' - dependsOn: [fanout1, fanout2] - steps: - - script: echo "This job will run after fanout1 and fanout2 have finished." -``` -{% endraw %} -
    - -詳細については、「[{% data variables.product.prodname_actions %}のワークフロー構文](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)」を参照してください。 - -### タスクのアクションへの移行 - -Azure Pipelinesは_タスク_を使います。これは、複数のワークフローで再利用できるアプリケーションのコンポーネントです。 {% data variables.product.prodname_actions %}は_アクション_を使います。これは、タスクの実行とワークフローのカスタマイズに利用できます。 どちらのシステムでも、実行するタスクやアクションの名前を、必要な入力のキー/値のペアとともに指定できます。 - -以下が、それぞれのシステムの構文の例です。 - - - - - - - - - - -
    -Azure Pipelines - -{% data variables.product.prodname_actions %} -
    -{% raw %} -```yaml -jobs: -- job: run_python - pool: - vmImage: 'ubuntu-latest' - steps: - - task: UsePythonVersion@0 - inputs: - versionSpec: '3.7' - architecture: 'x64' - - script: python script.py -``` -{% endraw %} - -{% raw %} -```yaml -jobs: - run_python: - runs-on: ubuntu-latest - steps: - - uses: actions/setup-python@v2 - with: - python-version: '3.7' - architecture: 'x64' - - run: python script.py -``` -{% endraw %} -
    - -ワークフロー中で利用できるアクションは、[{% data variables.product.prodname_marketplace %}](https://github.com/marketplace?type=actions)で見つけることも、独自のactionsを作成することもできます。 詳細については、「[アクションを作成する](/actions/creating-actions)」を参照してください。 - diff --git a/translations/ja-JP/content/actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions.md b/translations/ja-JP/content/actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions.md deleted file mode 100644 index dc3e73e3cd38..000000000000 --- a/translations/ja-JP/content/actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions.md +++ /dev/null @@ -1,445 +0,0 @@ ---- -title: CircleCIからGitHub Actionsへの移行 -intro: GitHub ActionsとCircleCIには設定に相似点があるので、GitHub Actionsへの移行は比較的単純明快です。 -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -### はじめに - -CircleCIと{% data variables.product.prodname_actions %}は、どちらも自動的にコードのビルド、テスト、公開、リリース、デプロイを行うワークフローを作成できます。 CircleCIと{% data variables.product.prodname_actions %}は、ワークフローの設定において似ているところがあります。 - -- ワークフローの設定ファイルはYAMLで書かれ、リポジトリに保存されます。 -- ワークフローには1つ以上のジョブが含まれます。 -- ジョブには1つ以上のステップもしくは個別のコマンドが含まれます。 -- ステップもしくはタスクは、再利用とコミュニティとの共有が可能です。 - -詳しい情報については、「[{% data variables.product.prodname_actions %}の中核的概念](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)」を参照してください。 - -### 主要な差異 - -CircleCIから移行する際には、以下の差異を考慮してください。 - -- CircleCIの自動テストの並列性は、ユーザが指定したルールもしくは過去のタイミングの情報に基づいて、自動的にテストをグループ化します。 この機能は{% data variables.product.prodname_actions %}には組み込まれていません。 -- コンテナはユーザのマッピングが異なるので、Dockerコンテナ内で実行されるアクションは、権限の問題に敏感です。 これらの問題の多くは、*Dockerfile*中で`USER`命令を使わなければ回避できます。 Dockerのファイルシステムに関する詳しい情報については「[{% data variables.product.product_name %}ホストランナーの仮想環境](/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem)」を参照してください。 - -### ワークフローとジョブの移行 - -CircleCIは*config.yml*ファイル中で`workflows`を定義するので、複数のワークフローを設定できます。 {% data variables.product.product_name %}はワークフローごとに1つのワークフローファイルを必要とするので、結果として`workflows`を宣言する必要がありません。 それぞれのワークフローごとに、*config.yml*で内で設定された新しいワークフローファイルを作成しなければなりません。 - -CircleCIと{% data variables.product.prodname_actions %}は、どちらも似た構文を使って設定ファイル中で`jobs`を設定します。 CircleCIワークフロー中で`requires`を使ってジョブ間の依存関係を設定しているなら、相当する{% data variables.product.prodname_actions %}の`needs`構文を利用できます。 詳細については、「[{% data variables.product.prodname_actions %}のワークフロー構文](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)」を参照してください。 - -### orbsからアクションへの移行 - -CircleCIと{% data variables.product.prodname_actions %}は、どちらもワークフロー中のタスクを再利用し、共有するための仕組みを提供しています。 CircleCIはorbsという概念を利用します。これはYAMLで書かれ、ワークフロー中で再利用できるタスクを提供します。 {% data variables.product.prodname_actions %}はアクションと呼ばれる協力で柔軟な再利用できるコンポーネントを持っており、これはJavaScriptファイルもしくはDockerイメージで構築できます。 {% data variables.product.product_name %}の API やパブリックに利用可能なサードパーティAPIとのインテグレーションなど、好きな方法でリポジトリを操作するカスタムコードを書いて、アクションを作成することができます。 たとえば、アクションでnpmモジュールを公開する、緊急の問題が発生したときにSMSアラートを送信する、本番対応のコードをデプロイすることなどが可能です。 詳細については、「[アクションを作成する](/actions/creating-actions)」を参照してください。 - -CircleCIは、YAMLのアンカーとエイリアスでワークフローの部分を再利用できます。 {% data variables.product.prodname_actions %}はビルドマトリックスを使って、再利用性についての一般的な要求のほとんどをサポートします。 ビルドマトリックスに関する詳細な情報については「[ワークフローの設定](/actions/configuring-and-managing-workflows/configuring-a-workflow#configuring-a-build-matrix)」を参照してください。 - -### Dockerイメージの利用 - - -CircleCIと{% data variables.product.prodname_actions %}は、どちらもDockerイメージ内でのステップの実行をサポートします。 - -CircleCIは、共通の依存関係を持つ一連のビルド済みのイメージを提供します。 これらのイメージでは`USER`が`circleci`に設定されており、それが{% data variables.product.prodname_actions %}との権限の衝突を引き起こすことになります。 - -{% data variables.product.prodname_actions %}への移行に際しては、CircleCIの構築済みイメージから離脱することをおすすめします。 多くの場合、必要な追加の依存関係のインストールにアクションを使うことができます。 - -Dockerのファイルシステムに関する詳しい情報については「[{% data variables.product.product_name %}ホストランナーの仮想環境](/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem)」を参照してください。 - -{% data variables.product.prodname_dotcom %}ホストの仮想環境で利用できるツールとパッケージに関する詳しい情報については「[GitHubホストランナーにインストールされているソフトウェア](/actions/reference/software-installed-on-github-hosted-runners)」を参照してください。 - -### 変数とシークレットの利用 - -CircleCIと{% data variables.product.prodname_actions %}は、設定ファイル内での環境変数の設定と、CircleCIもしくは{% data variables.product.product_name %}のUIを使ったシークレットの作成をサポートしています。 - -詳しい情報については「[環境変数の利用](/actions/configuring-and-managing-workflows/using-environment-variables)」及び「[暗号化されたシークレットの作成と利用](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)」を参照してください。 - -### キャッシング - -CircleCIと{% data variables.product.prodname_actions %}は、設定ファイル中で手動でファイルをキャッシュする方法を提供しています。 - -以下は、それぞれのシステムにおける構文の例です。 - - - - - - - - - - -
    -CircleCI - -GitHub Actions -
    -{% raw %} -```yaml -- restore_cache: - keys: - - v1-npm-deps-{{ checksum "package-lock.json" }} - - v1-npm-deps- -``` -{% endraw %} - -{% raw %} -```yaml -- name: Cache node modules - uses: actions/cache@v2 - with: - path: ~/.npm - key: v1-npm-deps-${{ hashFiles('**/package-lock.json') }} - restore-keys: v1-npm-deps- -``` -{% endraw %} -
    - -詳しい情報については「[ワークフローを高速化するための依存関係のキャッシング](/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows)」を参照してください。 - -{% data variables.product.prodname_actions %}は、CircleCIのDocker Layer Caching（DLC）に相当する機能を持っていません。 - -### ジョブ間でのデータの永続化 - -CircleCIと{% data variables.product.prodname_actions %}は、どちらもジョブ間でデータを永続化するための仕組みを提供しています。 - -以下は、CircleCIと{% data variables.product.prodname_actions %}の設定構文の例です。 - - - - - - - - - - -
    -CircleCI - -GitHub Actions -
    -{% raw %} -```yaml -- persist_to_workspace: - root: workspace - paths: - - math-homework.txt - -... - -- attach_workspace: - at: /tmp/workspace -``` -{% endraw %} - -{% raw %} -```yaml -- name: Upload math result for job 1 - uses: actions/upload-artifact@v2 - with: - name: homework - path: math-homework.txt - -... - -- name: Download math result for job 1 - uses: actions/download-artifact@v2 - with: - name: homework -``` -{% endraw %} -
    - -詳しい情報については「[成果物を利用してワークフローのデータを永続化する](/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts)」を参照してください。 - -### データベースとサービスコンテナの利用 - -どちらのシステムでも、データベース、キャッシング、あるいはその他の依存関係のための追加コンテナを含めることができます。 - -CircleCIでは、*config.yaml*で最初に挙げられているイメージが、コマンドの実行に使われる主要なイメージです。 {% data variables.product.prodname_actions %}は明示的なセクションを使います。主要なコンテナには`container`を使い、追加のコンテナは`services`にリストしてください。 - -以下は、CircleCIと{% data variables.product.prodname_actions %}の設定構文の例です。 - - - - - - - - - - -
    -CircleCI - -GitHub Actions -
    -{% raw %} -```yaml ---- -version: 2.1 - -jobs: - - ruby-26: - docker: - - image: circleci/ruby:2.6.3-node-browsers-legacy - environment: - PGHOST: localhost - PGUSER: administrate - RAILS_ENV: test - - image: postgres:10.1-alpine - environment: - POSTGRES_USER: administrate - POSTGRES_DB: ruby26 - POSTGRES_PASSWORD: "" - - working_directory: ~/administrate - - steps: - - checkout - - # Bundle install dependencies - - run: bundle install --path vendor/bundle - - # Wait for DB - - run: dockerize -wait tcp://localhost:5432 -timeout 1m - - # Setup the environment - - run: cp .sample.env .env - - # Setup the database - - run: bundle exec rake db:setup - - # Run the tests - - run: bundle exec rake - - -workflows: - version: 2 - build: - jobs: - - ruby-26 -... - -- attach_workspace: - at: /tmp/workspace -``` -{% endraw %} - -{% raw %} -```yaml -name: Containers - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - container: circleci/ruby:2.6.3-node-browsers-legacy - - env: - PGHOST: postgres - PGUSER: administrate - RAILS_ENV: test - - services: - postgres: - image: postgres:10.1-alpine - env: - POSTGRES_USER: administrate - POSTGRES_DB: ruby25 - POSTGRES_PASSWORD: "" - ports: - - 5432:5432 - # Add a health check - options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 5 - - steps: - # This Docker file changes sets USER to circleci instead of using the default user, so we need to update file permissions for this image to work on GH Actions. - # https://docs.github.com/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem 参照 - - name: Setup file system permissions - run: sudo chmod -R 777 $GITHUB_WORKSPACE /github /__w/_temp - - uses: actions/checkout@v2 - - name: Install dependencies - run: bundle install --path vendor/bundle - - name: Setup environment configuration - run: cp .sample.env .env - - name: Setup database - run: bundle exec rake db:setup - - name: Run tests - run: bundle exec rake -``` -{% endraw %} -
    - -詳しい情報については「[サービスコンテナについて](/actions/configuring-and-managing-workflows/about-service-containers)」を参照してください。 - -### 完全な例 - -以下は実際の例です。 左は[ thoughtbot/administrator](https://github.com/thoughtbot/administrate)リポジトリのための実際の*config.yml*を示しています。 右は、同等の{% data variables.product.prodname_actions %}を示しています。 - - - - - - - - - - -
    -CircleCI - -GitHub Actions -
    -{% raw %} -```yaml ---- -version: 2.1 - -commands: - shared_steps: - steps: - - checkout - - # Restore Cached Dependencies - - restore_cache: - name: Restore bundle cache - key: administrate-{{ checksum "Gemfile.lock" }} - - # Bundle install dependencies - - run: bundle install --path vendor/bundle - - # Cache Dependencies - - save_cache: - name: Store bundle cache - key: administrate-{{ checksum "Gemfile.lock" }} - paths: - - vendor/bundle - - # Wait for DB - - run: dockerize -wait tcp://localhost:5432 -timeout 1m - - # Setup the environment - - run: cp .sample.env .env - - # Setup the database - - run: bundle exec rake db:setup - - # Run the tests - - run: bundle exec rake - -default_job: &default_job - working_directory: ~/administrate - steps: - - shared_steps - # Run the tests against multiple versions of Rails - - run: bundle exec appraisal install - - run: bundle exec appraisal rake - -jobs: - ruby-25: - <<: *default_job - docker: - - image: circleci/ruby:2.5.0-node-browsers - environment: - PGHOST: localhost - PGUSER: administrate - RAILS_ENV: test - - image: postgres:10.1-alpine - environment: - POSTGRES_USER: administrate - POSTGRES_DB: ruby25 - POSTGRES_PASSWORD: "" - - ruby-26: - <<: *default_job - docker: - - image: circleci/ruby:2.6.3-node-browsers-legacy - environment: - PGHOST: localhost - PGUSER: administrate - RAILS_ENV: test - - image: postgres:10.1-alpine - environment: - POSTGRES_USER: administrate - POSTGRES_DB: ruby26 - POSTGRES_PASSWORD: "" - - -workflows: - version: 2 - multiple-rubies: - jobs: - - ruby-26 - - ruby-25 -``` -{% endraw %} - -{% raw %} -```yaml -name: Containers - -on: [push] - -jobs: - build: - - strategy: - matrix: - ruby: [2.5, 2.6.3] - - runs-on: ubuntu-latest - - env: - PGHOST: localhost - PGUSER: administrate - RAILS_ENV: test - - services: - postgres: - image: postgres:10.1-alpine - env: - POSTGRES_USER: administrate - POSTGRES_DB: ruby25 - POSTGRES_PASSWORD: "" - ports: - - 5432:5432 - # ヘルスチェックを追加する - options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 5 - - steps: - - uses: actions/checkout@v2 - - name: Setup Ruby - uses: eregon/use-ruby-action@master - with: - ruby-version: ${{ matrix.ruby }} - - name: Cache dependencies - uses: actions/cache@v2 - with: - path: vendor/bundle - key: administrate-${{ matrix.image }}-${{ hashFiles('Gemfile.lock') }} - - name: Install postgres headers - run: sudo apt-get install libpq-dev - - name: Install dependencies - run: bundle install --path vendor/bundle - - name: Setup environment configuration - run: cp .sample.env .env - - name: Setup database - run: bundle exec rake db:setup - - name: Run tests - run: bundle exec rake - - name: Install appraisal - run: bundle exec appraisal install - - name: Run appraisal - run: bundle exec appraisal rake -``` -{% endraw %} -
    diff --git a/translations/ja-JP/content/actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions.md b/translations/ja-JP/content/actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions.md deleted file mode 100644 index 77d77aef2d31..000000000000 --- a/translations/ja-JP/content/actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions.md +++ /dev/null @@ -1,291 +0,0 @@ ---- -title: JenkinsからGitHub Actionsへの移行 -intro: '{% data variables.product.prodname_actions %}とJenkinsには複数の相似点があり、そのため{% data variables.product.prodname_actions %}への移行は比較的単純です。' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -### はじめに - -Jenkinsと{% data variables.product.prodname_actions %}は、どちらも自動的にコードのビルド、テスト、公開、リリース、デプロイを行うワークフローを作成できます。 Jenkinsと{% data variables.product.prodname_actions %}は、ワークフローの設定において似ているところがあります。 - -- Jenkinsは_宣言的パイプライン_を使ってワークフローを作成します。これは{% data variables.product.prodname_actions %}のワークフローファイルに似ています。 -- Jenkinsは_ステージ_を使ってステップの集合を実行しますが、{% data variables.product.prodname_actions %}は1つ以上のステップもしくは個別のコマンドをグループ化するのにジョブを使います。 -- Jenkinsと{% data variables.product.prodname_actions %}はコンテナベースのビルドをサポートします。 詳しい情報については「[Docker コンテナアクションを作成する](/articles/creating-a-docker-container-action)」を参照してください。 -- ステップもしくはタスクは、再利用とコミュニティとの共有が可能です。 - -詳しい情報については、「[{% data variables.product.prodname_actions %}の中核的概念](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)」を参照してください。 - -### 主要な差異 - -- Jenkinsには、パイプラインの作成用の構文として、宣言的パイプラインとスクリプトパイプラインの2種類があります。 {% data variables.product.prodname_actions %}は、ワークフローと設定ファイルの作成にYAMLを使います。 詳しい情報については、「[GitHub Actionsのワークフロー構文](/actions/reference/workflow-syntax-for-github-actions)」を参照してください。 -- Jenkinsのデプロイメントは通常セルフホストであり、ユーザが自身のデータセンター内のサーバーをメンテナンスします。 {% data variables.product.prodname_actions %}は、ジョブの実行に利用できる独自のランナーをホストするハイブリッドクラウドのアプローチを提供しながら、セルフホストランナーもサポートします。 詳しい情報については「[セルフホストランナーについて](/actions/hosting-your-own-runners/about-self-hosted-runners)」を参照してください。 - -### 機能の比較 - -#### ビルドの分配 - -Jenkinsでは、ビルドを単一のビルドエージェントに送信することも、複数のエージェントに対して分配することもできます。 それらのエージェントを、オペレーティングシステムの種類などの様々な属性に従って分類することもできます。 - -同様に、{% data variables.product.prodname_actions %}はジョブを{% data variables.product.prodname_dotcom %}ホストあるいはセルフホストのランナーに送信でき、ラベルを使って様々な属性に従ってランナーを分類できます。 以下の表は、分散ビルドの概念がJenkinsと{% data variables.product.prodname_actions %}でどのように実装されているかを比較しています。 - -| Jenkins | {% data variables.product.prodname_actions %} | -| ---------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [`エージェント`](https://wiki.jenkins.io/display/JENKINS/Distributed+builds) | [`ランナー`](/actions/getting-started-with-github-actions/core-concepts-for-github-actions#runner)
    [`セルフホストランナー`](/actions/hosting-your-own-runners/about-self-hosted-runners) | - -#### セクションを利用したパイプラインの整理 - -Jenkinsは、宣言的パイプラインを複数のセクションに分割します。 同様に、{% data variables.product.prodname_actions %}はワークフローを個別のセクションとして編成します。 以下の表は、Jenkinsのセクションを{% data variables.product.prodname_actions %}のワークフローと比較しています。 - -| Jenkinsのディレクティブ | {% data variables.product.prodname_actions %} | -| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| [`agent`](https://jenkins.io/doc/book/pipeline/syntax/#agent) | [`jobs..runs-on`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idruns-on)
    [`jobs..container`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idcontainer) | -| [`post`](https://jenkins.io/doc/book/pipeline/syntax/#post) | | -| [`stages`](https://jenkins.io/doc/book/pipeline/syntax/#stages) | [`jobs`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobs) | -| [`steps`](https://jenkins.io/doc/book/pipeline/syntax/#steps) | [`jobs..steps`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idsteps) | - - -### ディレクティブの利用 - -Jenkinsは、_宣言的パイプライン_を管理するためにディレクティブを使います。 それらのディレクティブは、ワークフローの特徴と、その実行方法を定義します。 以下の表は、それらのディレクティブが{% data variables.product.prodname_actions %}の概念とどのように対応するかを示しています。 - -| Jenkinsのディレクティブ | {% data variables.product.prodname_actions %} | -| ------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [`environment`](https://jenkins.io/doc/book/pipeline/syntax/#environment) | [`jobs..env`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#env)
    [`jobs..steps.env`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsenv) | -| [`options`](https://jenkins.io/doc/book/pipeline/syntax/#parameters) | [`jobs..strategy`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategy)
    [`jobs..strategy.fail-fast`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategyfail-fast)
    [`jobs..timeout-minutes`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idtimeout-minutes) | -| [`parameters`](https://jenkins.io/doc/book/pipeline/syntax/#parameters) | [`inputs`](/actions/creating-actions/metadata-syntax-for-github-actions#inputs)
    [`outputs`](/actions/creating-actions/metadata-syntax-for-github-actions#outputs) | -| [`triggers`](https://jenkins.io/doc/book/pipeline/syntax/#triggers) | [`on`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#on)
    [`on..types`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onevent_nametypes)
    [on..](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onpushpull_requestbranchestags)
    [on..paths](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onpushpull_requestpaths) | -| [`triggers { upstreamprojects() }`](https://jenkins.io/doc/book/pipeline/syntax/#triggers) | [`jobs..needs`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idneeds) | -| [Jenkinsのcron構文](https://jenkins.io/doc/book/pipeline/syntax/#cron-syntax) | [`on.schedule`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onschedule) | -| [`ステージ`](https://jenkins.io/doc/book/pipeline/syntax/#stage) | [`jobs.`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_id)
    [`jobs..name`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idname) | -| [`tools`](https://jenkins.io/doc/book/pipeline/syntax/#tools) | [GitHubホストランナーにインストールされるソフトウェア](/actions/reference/software-installed-on-github-hosted-runners) | -| [`input`](https://jenkins.io/doc/book/pipeline/syntax/#input) | [`inputs`](/actions/automating-your-workflow-with-github-actions/metadata-syntax-for-github-actions#inputs) | -| [`when`](https://jenkins.io/doc/book/pipeline/syntax/#when) | [`jobs..if`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idif) | - - -### シーケンシャルなステージの利用 - -#### 並列なジョブの処理 - -Jenkinsは`ステージ`と`ステップ`を並行して実行できますが、{% data variables.product.prodname_actions %}が並行に処理できるのは現時点ではジョブだけです。 - -| Jenkinsの並列処理 | {% data variables.product.prodname_actions %} | -| ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [`parallel`](https://jenkins.io/doc/book/pipeline/syntax/#parallel) | [`jobs..strategy.max-parallel`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymax-parallel) | - -#### ビルドマトリックス - -{% data variables.product.prodname_actions %}とJenkinsはどちらも、ビルドマトリックスを使って様々なシステムの組み合わせを定義できます。 - -| Jenkins | {% data variables.product.prodname_actions %} | -| ------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [`axis`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-axes) | [`strategy/matrix`](/actions/configuring-and-managing-workflows/configuring-a-workflow#configuring-a-build-matrix)
    [`context`](/actions/reference/context-and-expression-syntax-for-github-actions) | -| [`stages`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-stages) | [`steps-context`](/actions/reference/context-and-expression-syntax-for-github-actions#steps-context) | -| [`excludes`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-stages) | | - -#### ステップを使ったタスクの実行 - -Jenkinsは`ステップ`をまとめて`ステージ`にグループ化します。 それらの各ステップは、スクリプト、関数、コマンドなどです。 同様に、{% data variables.product.prodname_actions %}は`ジョブ`を使って特定の`ステップ`のグループを実行します。 - -| Jenkinsのステップ | {% data variables.product.prodname_actions %} | -| --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | -| [`script`](https://jenkins.io/doc/book/pipeline/syntax/#script) | [`jobs..steps`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idsteps) | - -### 一般的なタスクの例 - -#### `cron`で実行するようパイプラインをスケジュール - - - - - - - - - - -
    -Jenkinsのパイプライン - -{% data variables.product.prodname_actions %}のワークフロー -
    - - ```yaml - pipeline { - agent any - triggers { - cron('H/15 * * * 1-5') - } - } - ``` - - - - ```yaml - on: - schedule: - - cron: '*/15 * * * 1-5' - ``` - -
    - -#### パイプライン中での環境変数の設定 - - - - - - - - - - -
    -Jenkinsのパイプライン - -{% data variables.product.prodname_actions %}のワークフロー -
    - - ```yaml - pipeline { - agent any - environment { - MAVEN_PATH = '/usr/local/maven' - } - } - ``` - - - - ```yaml - jobs: - maven-build: - env: - MAVEN_PATH: '/usr/local/maven' - - ``` - -
    - -#### 上流のプロジェクトからのビルド - - - - - - - - - - -
    -Jenkinsのパイプライン - -{% data variables.product.prodname_actions %}のワークフロー -
    - - ```yaml - pipeline { - triggers { - upstream( - upstreamProjects: 'job1,job2', - threshold: hudson.model.Result.SUCCESS) - } - } - } - - ``` - - - - ```yaml - jobs: - job1: - job2: - needs: job1 - job3: - needs: [job1, job2] - - ``` - -
    - -#### 複数のオペレーティングシステムでのビルド - - - - - - - - - - -
    -Jenkinsのパイプライン - -{% data variables.product.prodname_actions %}のワークフロー -
    - - ```yaml -pipeline { - agent none - stages { - stage('Run Tests') { - parallel { - stage('Test On MacOS') { - agent { label "macos" } - tools { nodejs "node-12" } - steps { - dir("scripts/myapp") { - sh(script: "npm install -g bats") - sh(script: "bats tests") - } - } - } - stage('Test On Linux') { - agent { label "linux" } - tools { nodejs "node-12" } - steps { - dir("script/myapp") { - sh(script: "npm install -g bats") - sh(script: "bats tests") - } - } - } - } - } - } -} - ``` - - - -{% raw %} - ```yaml - name: demo-workflow - on: - push: - jobs: - test: - runs-on: ${{ matrix.os }} - strategy: - fail-fast: false - matrix: - os: [macos-latest, ubuntu-latest] - steps: - - uses: actions/checkout@v1 - - uses: actions/setup-node@v1 - with: - node-version: 12 - - run: npm install -g bats - - run: bats tests - working-directory: scripts/myapp - ``` -{% endraw %} - -
    diff --git a/translations/ja-JP/content/actions/publishing-packages-with-github-actions/about-packaging-with-github-actions.md b/translations/ja-JP/content/actions/publishing-packages-with-github-actions/about-packaging-with-github-actions.md deleted file mode 100644 index e40f50d7d103..000000000000 --- a/translations/ja-JP/content/actions/publishing-packages-with-github-actions/about-packaging-with-github-actions.md +++ /dev/null @@ -1,45 +0,0 @@ ---- -title: GitHub Actionsでのパッケージング -intro: 'パッケージを生成し、{% data variables.product.prodname_registry %}あるいはその他のパッケージホスティングプロバイダにアップロードするワークフローを{% data variables.product.prodname_actions %}でセットアップできます。' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/about-packaging-with-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -### パッケージングのステップについて - -パッケージングのステップは、継続的インテグレーションあるいは継続的デリバリのワークフローの一般的な部分です。 アプリケーションをビルドしてテストした後、実行もしくはデプロイ可能な成果物がパッケージの形で生成されます。 たとえば、Javaのプロジェクトのための継続的インテグレーションのワークフローは、`mvn package`を実行してJARファイルを生成するかもしれません。 あるいは、Node.jsアプリケーションのためのCIワークフローは、Dockerコンテナを作成するかもしれません。 - -ビルドしているアプリケーションの種類によって、このパッケージは手動でのテストのためにローカルにダウンロードしたり、ユーザーがダウンロードできるようにしたり、ステージングあるいはプロダクションの環境にデプロイしたりできます。 - -### 継続的インテグレーションワークフロー内でのパッケージング - -継続的インテグレーションワークフローの終わりにパッケージを作成すれば、プルリクエストに対するコードレビューの間に役立つことがあります。 コードをビルドしてテストした後、パッケージングのステップで実行可能な、あるいはデプロイ可能な成果物を生成できます。 そしてワークフローはワークフローの一部として、この成果物をアップロードできます。 - -そうすれば、プルリクエストをレビューする際には、ワークフローの実行を見て生成された成果物をダウンロードできるでしょう。 - -![成果物のダウンロードのドロップダウンメニュー](/assets/images/help/repository/artifact-drop-down.png) - -こうすれば、プルリクエスト中のコードを自分のマシン上で実行できるので、プルリクエストのデバッグやテストに役立ちます。 - -### パッケージを公開するためのワークフロー - -継続的インテグレーションのワークフロー中で、テストのためにパッケージ化された成果物をアップロードすることに加えて、プロジェクトをビルドして、パッケージをパッケージレジストリに公開するワークフローを作成できます。 - -* **{% data variables.product.prodname_registry %}へのパッケージの公開** {% data variables.product.prodname_registry %}は、多くの種類のパッケージについてパッケージホストティングサービスとして振る舞うことができます。 パッケージを{% data variables.product.prodname_dotcom %}のすべてと共有することも、パッケージをプライベートにしてコラボレータやOrganizationと共有することもできます。 詳しい情報については「[{% data variables.product.prodname_registry %}について](/github/managing-packages-with-github-packages/about-github-packages)」を参照してください。 - - masterブランチにプッシュがある度に、パッケージを{% data variables.product.prodname_registry %}に公開したいかもしれません。 そうすれば、プロジェクトの開発者は常にmasterからの最新のビルドを{% data variables.product.prodname_registry %}からインストールして実行及びテストできるようになります。 - -* **パッケージレジストリへのパッケージの公開** 多くのプロジェクトで、新しいバージョンのプロジェクトがリリースされたときにパッケージレジストリへの公開が行われます。 たとえば、JARファイルを生成するプロジェクトは、新しいリリースをMaven Centralリポジトリにアップロードするかもしれません。 あるいは、.NETのプロジェクトはnugetのパッケージを生成し、NuGet Galleryへアップロードするかもしれません。 - - これは、リリースが作成される度にパッケージをパッケージレジストリに公開するワークフローを作成すれば、自動化できます。 詳しい情報については「[リリースの作成](/github/administering-a-repository/creating-releases)」を参照してください。 - -### 参考リンク - -- [Node.jsパッケージの公開](/actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages) diff --git a/translations/ja-JP/content/actions/publishing-packages-with-github-actions/index.md b/translations/ja-JP/content/actions/publishing-packages-with-github-actions/index.md deleted file mode 100644 index 4dfc37afebf1..000000000000 --- a/translations/ja-JP/content/actions/publishing-packages-with-github-actions/index.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: GitHub Actionsでのパッケージの公開 -shortTitle: パッケージの公開 -intro: 'パッケージを作成し、{% data variables.product.prodname_registry %}あるいは他のパッケージホスティングプロバイダに公開してください。' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -{% link_in_list /about-packaging-with-github-actions %} diff --git a/translations/ja-JP/content/actions/reference/software-installed-on-github-hosted-runners.md b/translations/ja-JP/content/actions/reference/software-installed-on-github-hosted-runners.md deleted file mode 100644 index 1a68f70c8931..000000000000 --- a/translations/ja-JP/content/actions/reference/software-installed-on-github-hosted-runners.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: GitHubホストランナーにインストールされるソフトウェア -intro: 'この記事は、{% data variables.product.prodname_dotcom %}がホストする仮想環境で利用できるパッケージとツールのリファレンスにリンクします。' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/software-in-virtual-environments-for-github-actions - - /github/automating-your-workflow-with-github-actions/software-in-virtual-environments-for-github-actions - - /github/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners - - /actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -{% data variables.product.prodname_dotcom %}ホストランナーに含まれるツールは、毎週更新されます。 各ランナーオペレーティングシステム用に含まれるツールの最新のリストについては、以下のリンクを参照してください。 - -* [Ubuntu 20.04 LTS](https://github.com/actions/virtual-environments/blob/master/images/linux/Ubuntu2004-README.md) -* [Ubuntu 18.04 LTS](https://github.com/actions/virtual-environments/blob/master/images/linux/Ubuntu1804-README.md) -* [Ubuntu 16.04 LTS](https://github.com/actions/virtual-environments/blob/master/images/linux/Ubuntu1604-README.md) -* [Windows Server 2019](https://github.com/actions/virtual-environments/blob/master/images/win/Windows2019-Readme.md) -* [Windows Server 2016](https://github.com/actions/virtual-environments/blob/master/images/win/Windows2016-Readme.md) -* [MacOS 10.15](https://github.com/actions/virtual-environments/blob/master/images/macos/macos-10.15-Readme.md) - -{% data reusables.github-actions.ubuntu-runner-preview %} - -{% data variables.product.prodname_dotcom %}ホストランナーには、オペレーティングシステムのデフォルトの組み込みツールに加え、上のリファレンスのリスト内のパッケージにが含まれています。 たとえば、Ubuntu及びmacOSのランナーには、`grep`、`find`、`which`やその他のデフォルトのツールが含まれています。 - -リクエストしたいツールがある場合、[actions/virtual-environments](https://github.com/actions/virtual-environments) で Issue を開いてください。 diff --git a/translations/ja-JP/content/actions/reference/virtual-environments-for-github-hosted-runners.md b/translations/ja-JP/content/actions/reference/virtual-environments-for-github-hosted-runners.md deleted file mode 100644 index c328115318a8..000000000000 --- a/translations/ja-JP/content/actions/reference/virtual-environments-for-github-hosted-runners.md +++ /dev/null @@ -1,131 +0,0 @@ ---- -title: GitHubホストランナーの仮想環境 -intro: '{% data variables.product.prodname_dotcom %}は、ワークフローを実行するためのホストされた仮想マシンを提供します。 仮想マシンには、{% data variables.product.prodname_actions %}で使用できるツール、パッケージ、および設定の環境が含まれています。' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/virtual-environments-for-github-actions - - /github/automating-your-workflow-with-github-actions/virtual-environments-for-github-actions - - /github/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners - - /actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data variables.product.prodname_actions %} の支払いを管理する -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -### {% data variables.product.prodname_dotcom %}ホストランナーについて - -{% data variables.product.prodname_dotcom %}ホストランナーは{% data variables.product.prodname_actions %}ランナーアプリケーションがインストールされた、{% data variables.product.prodname_dotcom %}がホストする仮想マシンです。 {% data variables.product.prodname_dotcom %}は、Linux、Windows、macOSのランナーを提供します。 - -{% data variables.product.prodname_dotcom %}ホストランナーを使用すると、マシンのメンテナンスとアップグレードが自動的に行われます。 ワークフローは、仮想マシンで直接実行することも、Dockerコンテナで実行することもできます。 - -ワークフローのジョブごとにランナーの種類を指定できます。 ワークフローの各ジョブは、仮想マシンの新しいインスタンスで実行されます。 ジョブ実行のステップはすべて、仮想マシンの同じインスタンスで実行されるため、そのジョブのアクションはファイルシステムを使用して情報を共有できます。 - -{% data reusables.github-actions.runner-app-open-source %} - -#### {% data variables.product.prodname_dotcom %}ホストランナーのクラウドホスト - -{% data variables.product.prodname_dotcom %}は、Microsoft AzureのStandard_DS2_v2仮想マシン上で{% data variables.product.prodname_actions %}ランナーアプリケーションがインストールされたLinux及びWindowsランナーをホストします。 {% data variables.product.prodname_dotcom %}ホストランナーアプリケーションは、Azure Pipelines Agentのフォークです。 インバウンドのICMPパケットはすべてのAzure仮想マシンでブロックされるので、pingやtracerouteコマンドは動作しないでしょう。 Standard_DS2_v2マシンのリソースに関する詳しい情報については、Microsoft Azureドキュメンテーションの「[Dv2 and DSv2シリーズ](https://docs.microsoft.com/ja-jp/azure/virtual-machines/dv2-dsv2-series#dsv2-series)」を参照してください。 - -{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 - -#### {% data variables.product.prodname_dotcom %}ホストランナーの管理権限 - -LinuxおよびmacOSの仮想環境は、パスワード不要の`sudo`により動作します。 現在のユーザが持っているよりも高い権限が求められるコマンドやインストールツールを実行する必要がある場合は、パスワードを入力する必要なく、`sudo`を使うことができます。 詳しい情報については、「[Sudo Manual](https://www.sudo.ws/man/1.8.27/sudo.man.html)」を参照してください。 - -Windowsの仮想マシンは、ユーザアカウント制御（UAC）が無効化されて管理者として動作するように設定されています。 詳しい情報については、Windowsのドキュメンテーションの「[ユーザー アカウント制御のしくみ](https://docs.microsoft.com/en-us/windows/security/identity-protection/user-account-control/how-user-account-control-works)」を参照してください。 - -### サポートされているランナーとハードウェアリソース - -各仮想マシンで、同一のハードウェアリソースを使用できます。 - -- 2コアCPU -- 7 GBのRAMメモリー -- 14 GBのSSDディスク容量 - -{% data reusables.github-actions.supported-github-runners %} - -{% data reusables.github-actions.ubuntu-runner-preview %} - -各ランナーでサポートされているソフトウェア、ツール、パッケージのリストについては「[{% data variables.product.prodname_dotcom %}ホストランナーにインストールされているソフトウェア](/actions/reference/software-installed-on-github-hosted-runners)」を参照してください。 - -ワークフローの実行のログを見て、ジョブで利用された正確なランナーの環境や、ランナー上にプリインストールされたツールへのリンクを見ることができます。 詳しい情報については「[ワークフロー実行の管理](/actions/configuring-and-managing-workflows/managing-a-workflow-run#viewing-your-workflow-history)」を参照してください。 - - -#### {% data variables.product.prodname_dotcom %}ホストランナーのIPアドレス - -{% note %} - -**ノート:** {% data variables.product.prodname_dotcom %}のOrganizationもしくはEnterpriseアカウントでIPアドレスの許可リストを使っているなら、{% data variables.product.prodname_dotcom %}ホストランナーは利用できず、代わりにセルフホストランナーを使わなければなりません。 詳しい情報については「[セルフホストランナーについて](/actions/hosting-your-own-runners/about-self-hosted-runners)」を参照してください。 - -{% endnote %} - -WindowsとUbuntuのランナーはAzureでホストされ、IPアドレスの範囲がAzureデータセンターと同じになります。 現在、すべてのWindows及びUbuntuの{% data variables.product.prodname_dotcom %}ホストランナーは、以下のAzureリージョン内にあります。 - -- 米国東部(`eastus`) -- 米国東部2 (`eastus2`) -- 米国西部2 (`westus2`) -- 米国中部 (`centralus`) -- 米国中南部(`southcentralus`) - -Microsoftは、AzureのIPアドレスの範囲をJSONファイルで毎週更新しています。このファイルは、[Azure IP Ranges and Service Tags - Public Cloud (AzureのIPアドレス範囲とサービスタグ - パブリッククラウド)](https://www.microsoft.com/en-us/download/details.aspx?id=56519)のウェブサイトからダウンロードできます。 内部リソースに対する不正アクセスを防ぐために許可リストが必要な場合には、このIPアドレスの範囲を利用できます。 - -JSONファイルには、`values`という配列があります。 この配列のうち、たとえば`"AzureCloud.eastus2"`というようなAzureのリージョンの`name`と`id`があるオブジェクトで、サポート対象のIPアドレスが見つかります。 - -サポート対象のIPアドレスの範囲は、`"addressPrefixes"`オブジェクトにあります。 次に示すのは、JSONファイルを縮めたサンプルです。 - -```json -{ - "changeNumber": 84, - "cloud": "Public", - "values": [ - { - "name": "AzureCloud.eastus2", - "id": "AzureCloud.eastus2", - "properties": { - "changeNumber": 33, - "region": "eastus2", - "platform": "Azure", - "systemService": "", - "addressPrefixes": [ - "13.68.0.0/17", - "13.77.64.0/18", - "13.104.147.0/25", - ... - ] - } - } - ] -} -``` - -### {% data variables.product.prodname_dotcom %}ホストランナーのファイルシステム - -{% data variables.product.prodname_dotcom %}は、仮想マシン上の特定のディレクトリでアクションとシェルコマンドを実行します。 仮想マシン上のファイルパスは静的なものではありません。 `home`、`workspace`、`workflow` ディレクトリのファイルパスを構築するには、{% data variables.product.prodname_dotcom %}が提供している環境変数を使用してください。 - -| ディレクトリ | 環境変数 | 説明 | -| --------------------- | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | -| `home` | `HOME` | ユーザ関連のデータが含まれます。 たとえば、このディレクトリにはログイン試行からの認証情報を含めることができます。 | -| `workspace` | `GITHUB_WORKSPACE` | アクションとシェルコマンドはこのディレクトリで実行されます。 このディレクトリの内容は、アクションによって変更することができ、後続のアクションでアクセスできます。 | -| `workflow/event.json` | `GITHUB_EVENT_PATH` | ワークフローをトリガーしたwebhookイベントの`POST`ペイロード。 {% data variables.product.prodname_dotcom %}は、アクションを実行するたびにアクション間でファイルの内容を隔離するためにこれを書き換えます。 | - -各ワークフローに対して{% data variables.product.prodname_dotcom %}が作成する環境変数のリストについては、「[環境変数の利用](/github/automating-your-workflow-with-github-actions/using-environment-variables)」を参照してください。 - -#### Dockerコンテナのファイルシステム - -Dockerコンテナで実行されるアクションには、 `/github`パスの下に静的なディレクトリがあります。 ただし、Dockerコンテナ内のファイルパスを構築するには、デフォルトの環境変数を使用することを強くお勧めします。 - -{% data variables.product.prodname_dotcom %}は、`/github`パス接頭辞を予約し、アクションのために3つのディレクトリを作成します。 - -- `/github/home` -- `/github/workspace` - {% data reusables.repositories.action-root-user-required %} -- `/github/workflow` - -{% if currentVersion == "free-pro-team@latest" %} - -### 参考リンク -- "[ {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)の請求を管理する " - -{% endif %} diff --git a/translations/ja-JP/content/admin/articles/README.md b/translations/ja-JP/content/admin/articles/README.md deleted file mode 100644 index e740775f0163..000000000000 --- a/translations/ja-JP/content/admin/articles/README.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -redirect_from: - - /enterprise/admin/articles/README ---- -# 非表示 Enterprise Admin 記事 - -`hidden: true` フロントマターが記述された、このディレクトリにある Enterprise Admin 記事です。 - -非表示ページに関する詳しい情報については、[`content/README`](../../README.md#hidden-pages) を参照してください。 diff --git a/translations/ja-JP/content/admin/articles/configuring-unified-contributions-between-github-enterprise-and-githubcom.md b/translations/ja-JP/content/admin/articles/configuring-unified-contributions-between-github-enterprise-and-githubcom.md deleted file mode 100644 index 76c2ee35bdc4..000000000000 --- a/translations/ja-JP/content/admin/articles/configuring-unified-contributions-between-github-enterprise-and-githubcom.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: GitHub Enterprise と GitHub.com の間で統一されたコントリビューションを設定する -intro: 'サイト管理者として {% data variables.product.prodname_github_connect %} を有効にしている場合、エンドユーザに {% data variables.product.prodname_dotcom_the_website %} コントリビューショングラフの {% data variables.product.prodname_enterprise %} からの作業に対する匿名のコントリビューションカウントの表示を許可することができます。' -hidden: true -redirect_from: - - /enterprise/admin/articles/configuring-unified-contributions-between-github-enterprise-and-github-com - - /enterprise/admin/articles/configuring-unified-contributions-between-github-enterprise-and-githubcom -versions: - enterprise-server: '*' ---- - - -両方の環境で、{% data variables.product.prodname_github_connect %} および {% data variables.product.prodname_unified_contributions %} を有効にすると、インスタンスのエンドユーザは {% data variables.product.prodname_dotcom_the_website %} アカウントに接続して {% data variables.product.prodname_enterprise %} からのコントリビューションカウントを {% data variables.product.prodname_dotcom_the_website %} に送信することができます。 詳細は「[{% data variables.product.prodname_unified_contributions %} と {% data variables.product.prodname_enterprise %} の間で {% data variables.product.prodname_dotcom_the_website %} を有効にする](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/enabling-unified-contributions-between-github-enterprise-server-and-github-com)」 および「[{% data variables.product.prodname_ghe_server %} コントリビューションを {% data variables.product.prodname_dotcom_the_website %} プロフィールに送信する](/articles/sending-your-github-enterprise-server-contributions-to-your-github-com-profile/)」を参照してください。 - -サイト管理者が機能を無効にするか、開発者が接続を拒否すると、{% data variables.product.prodname_enterprise %}　コントリビューションカウントは {% data variables.product.prodname_dotcom_the_website %} から削除されます。 開発者がプロフィールを無効にした後に再接続すると、過去 90 日間のコントリビューションカウントが復元されます。 - -1. 管理シェルで、{% data variables.product.product_location_enterprise %}の{% data variables.product.prodname_unified_contributions %}設定を有効にします。 - ```shell - $ ghe-config 'app.github.dotcom-contributions-configurable' 'true' - $ ghe-config-apply - ``` -2. {% data variables.product.prodname_enterprise %} に戻ります。 -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.business-settings %} -{% data reusables.enterprise-accounts.github-connect-tab %} -7. [Users can share contribution counts to {% data variables.product.prodname_dotcom_the_website %}] で、ドロップダウンメニューを使用して [**Enabled**] をクリックします。 -8. {% data variables.product.prodname_dotcom_the_website %} にリダイレクトされた後、接続済みのユーザアカウントに {% data variables.product.prodname_enterprise %} コントリビューションアカウントを書き込むには、{% data variables.product.prodname_github_app %} をアップグレードする必要があります。 接続済みの {% data variables.product.prodname_dotcom_the_website %} Organization の Organization 管理者は、`external_contributions` 権限で {% data variables.product.prodname_github_app %} のアップグレードを承認する必要があります。 - diff --git a/translations/ja-JP/content/admin/articles/including-github-enterprise-contributions-in-your-githubcom-profile.md b/translations/ja-JP/content/admin/articles/including-github-enterprise-contributions-in-your-githubcom-profile.md deleted file mode 100644 index 0615a91138b0..000000000000 --- a/translations/ja-JP/content/admin/articles/including-github-enterprise-contributions-in-your-githubcom-profile.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: GitHub.com プロフィールに GitHub Enterprise コントリビューションを含める -redirect_from: - - /enterprise/admin/articles/including-github-enterprise-contributions-in-your-github-com-profile - - /enterprise/admin/articles/including-github-enterprise-contributions-in-your-githubcom-profile -intro: '{% data variables.product.product_location_enterprise %} を {% data variables.product.prodname_dotcom_the_website %} に接続して、エンドユーザがクローズした Early Access Program の一環として {% data variables.product.product_location_enterprise %} から {% data variables.product.prodname_dotcom_the_website %} プロフィールにコントリビューションを送信できるようにすることができます。' -hidden: true -versions: - enterprise-server: '*' ---- - -{% data variables.product.prodname_dotcom_the_website %} プロフィールを {% data variables.product.prodname_enterprise %} コントリビューションに含めることは、{% data variables.product.prodname_enterprise %} 2.14 のクローズした Early Access Program の一環です。 詳しい情報については、「[{% data variables.product.prodname_dotcom_the_website %}プロフィールに {% data variables.product.prodname_enterprise %}コントリビューションを含める](/enterprise/2.14/admin/hidden/including-github-enterprise-contributions-in-your-github-com-profile/)」を参照してください。 diff --git a/translations/ja-JP/content/admin/articles/using-github-task-runner.md b/translations/ja-JP/content/admin/articles/using-github-task-runner.md deleted file mode 100644 index 87cd9594f504..000000000000 --- a/translations/ja-JP/content/admin/articles/using-github-task-runner.md +++ /dev/null @@ -1,109 +0,0 @@ ---- -title: GitHub Task Runner の使用 -intro: 'クローズした Early Access Program の一環として、{% data variables.product.prodname_dotcom %} Task Runner を CI/CD が統合されたシステムとして使用することができます。 {% data variables.product.product_name %} Task Runner を使用すると、リポジトリ内の設定ファイルを基づいて、{% data variables.product.prodname_github_app %} からのコードを自動的にビルド、テスト、およびデプロイすることができます。' -hidden: true -redirect_from: - - /enterprise/admin/articles/using-github-task-runner -versions: - enterprise-server: '*' ---- - - -{% note %} - -**メモ:** {% data variables.product.prodname_dotcom %}Task Runner へのアクセスをリクエストする前に、{% data variables.product.product_location_enterprise %}の `EARLY ACCESS LINK` で、Early Access Program の免責事項と責任制限を読んで同意する必要があります。 この書類は、これらの規約を含んでいます。 - -{% endnote %} - -### このガイドの内容 -- [{% data variables.product.prodname_dotcom %}Task Runner について](#about-github-task-runner) -- [{% data variables.product.prodname_dotcom %}Task Runner バイナリをダウンロードする](#downloading-the-github-task-runner-binary) -- [アプライアンスに {% data variables.product.prodname_dotcom %} Task Runner {% data variables.product.prodname_github_app %}を作成する](#creating-the-github-task-runner-github-app-on-your-appliance) -- [{% data variables.product.prodname_dotcom %}Task Runner アプリケーションをインストールする](#installing-the-github-task-runner-app) -- [プロジェクトのタスクを実行する](#running-tasks-for-a-project) - -### {% data variables.product.prodname_dotcom %}Task Runner について - -{% data variables.product.product_name %} Task Runnerは、ディスパッチャ (Webhook プッシュイベントを処理し、タスクをキューに入れる別のサービス) によってキューに入れられたタスクを実行します。 - -ディスパッチャには {% data variables.product.product_location_enterprise %} が付属していますが、{% data variables.product.product_name %} Task Runner をアプライアンスに手動でインストールする必要があります。 {% data variables.product.product_name %}Task Runner をセットアップするには、Runnerバイナリをダウンロードし、アプライアンスに {% data variables.product.prodname_github_app %}を作成し、ディスパッチャーと連携するようサーバーをセットアップする必要があります。 - -### {% data variables.product.prodname_dotcom %}Task Runner バイナリをダウンロードする - -{% data variables.product.product_location_enterprise %}に {% data variables.product.product_name %}Task Runner アプリケーションバイナリファイルが必要です。 ご希望のプラットフォーム用のバイナリをダウンロードするには、`hostname` を {% data variables.product.product_location_enterprise %} ホスト名または IP アドレスで置き換えて、`https://HOSTNAME/_dispatcher/downloads/` にアクセスします。 - -`chmod` コマンドを使用して、コマンドラインの {% data variables.product.product_name %} Task Runner の使用権限を変更します。 - -{% mac %} - -```shell -$ chmod +x task-runner_darwin_amd64 -``` - -{% endmac %} - -{% windows %} - -```shell -$ move task-runner_windows_amd64 task-runner_windows_amd64.exe -``` - -{% endwindows %} - -{% linux %} - -```shell -$ chmod +x task-runner_linux_amd64 -``` - -{% endlinux %} - -### アプライアンスに {% data variables.product.prodname_dotcom %} Task Runner {% data variables.product.prodname_github_app %}を作成する - -1. 現在のディレクトリに、`.task-runner.yaml` 設定ファイルを作成します。 `--config` フラグを使用して、別のディレクトリにファイルを移動することができます。 - -```shell -task-runner セットアップ -``` - -2. {% data variables.product.product_location_enterprise %} のホスト名を入力します。 -3. 特別な権限で設定された個人アクセストークンを入力します。 詳細は「[コマンドライン用の個人アクセストークンを作成する](/articles/creating-a-personal-access-token-for-the-command-line/)」を参照してください。 アカウントに {% data variables.product.prodname_github_app %} を作成している場合、`user` 権限を使用できます。または、Organization に {% data variables.product.prodname_github_app %} を作成している場合、`admin:org` を使用できます。 -4. {% data variables.product.prodname_github_app %}に名前 (`Octocat Task Runner` など) を入力します。 -5. Organization に {% data variables.product.prodname_github_app %}を作成している場合、Organization の名前を入力します。 -6. Task Runner を起動します。 - -```shell -task-runner 起動 -``` - -### {% data variables.product.prodname_dotcom %}Task Runner アプリケーションをインストールする - -1. ページの右上隅にあるプロフィール画像をクリックしてから、[Settings] をクリックします。 ![ユーザバーの [Settings（設定）] アイコン](/assets/images/help/images/userbar-account-settings.png) -2. 左サイドバーで [**Developer settings**] をクリックします。 ![Developer settings（開発者設定）セクション](/assets/images/help/images/developer_settings.png) -3. 左サイドバーで [**{% data variables.product.prodname_dotcom %}Apps**] をクリックします。 ![GitHub Apps セクション](/assets/images/help/images/github_apps.png) -4. インストールするアプリケーションをクリックします。 -5. 左サイドバーで [**Public page**] をクリックします。 ![[Public page] セクション](/assets/images/help/images/public-page-tab.png) -6. [**Install**] をクリックします。 ![GitHub App 公開ページのインストールボタン](/assets/images/help/images/install-runner-public-page.png) -7. [**[Only select repositories（リポジトリの選択のみを行う）]**] を選択し、{% data variables.product.prodname_dotcom %} Task Runner をインストールするリポジトリ名を入力します。 ![インストール先のリポジトリを選択する](/assets/images/help/images/repositories-install-task-runner.png) -8. [**Install**] をクリックします。 ![GitHub App インストールページのインストールボタン](/assets/images/help/images/install-runner-installation-page.png) -9. アプリケーションをインストールしたリポジトリへ移動します。 -10. 次に類似した `github/tasks.gf` ファイルを作成します: - - ``` -task "my task" { -command = "command-to-run" -runnerType = "Shell" -env = { - FOO="bar", - BAR="baz" -} -} - ``` -12. プルリクエストを開き、リポジトリにファイルを追加します。 -13. 変更をプッシュして、CI タスクが実行されることを確認します。 - -### プロジェクトのタスクを実行する - -プルリクエストを作成したら、{% data variables.product.prodname_github_app %} はイベントをディスパッチャ (タスクがキューに入れられて {% data variables.product.prodname_dotcom %} Task Runner に送信されるところ) にプッシュします。 {% data variables.product.prodname_dotcom %} Task Runner がタスクを受信して実行した後、ディスパッチャにレポートすると、プルリクエストが結果で更新されます。 - -![プルリクエストの CI テスト結果](/assets/images/help/images/task-results.png) diff --git a/translations/ja-JP/content/admin/clustering/about-cluster-nodes.md b/translations/ja-JP/content/admin/clustering/about-cluster-nodes.md deleted file mode 100644 index 85d0f6be9c44..000000000000 --- a/translations/ja-JP/content/admin/clustering/about-cluster-nodes.md +++ /dev/null @@ -1,69 +0,0 @@ ---- -title: クラスタノードについて -intro: '*ノード*は、クラスタ内で動作する {% data variables.product.prodname_ghe_server %} インスタンスです。 ぞれぞれのノードは、クラスターに提供される (最終的にはユーザーに提供される) 一連のサービスを実行します。' -redirect_from: - - /enterprise/admin/clustering/about-cluster-nodes -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_clustering.clustering-requires-https %} - -### 推奨する最小のハードウェア構成 -各ノードには、ルートボリュームに加えてデータボリュームが別途必要です。 以下に最小の推奨構成を示します。 ユーザのアクティビティや他の製品との結合といった利用方法によっては、さらに多くのリソースが必要になることがあります。 - -| サービス | 最小のメモリ | 最小のデータボリュームの空き領域 | -|:----------------------------------------------------------------------------:|:------:|:----------------:| -| `job-server`,
    `memcache-server`,
    `web-server` | 14 GB | 1 GB | -| `consul-server`,
    `mysql-server`,
    `redis-server` | 14 GB | 10 GB | -| `git-server`,
    `metrics-server`,
    `pages-server`,
    `storage-server` | 7 GB | 10 GB | -| `elasticsearch-server` | 14 GB | 10 GB | - -### クラスタリングに必要なサービス -適切な冗長性を持たせるために、各サービスの運用には少なくとも以下のノードを使ってください。 - -{% tip %} - -**ノート：**組織がどの程度のスケーラビリティを必要とするかは、リポジトリ数、ユーザー数、全体的な利用度を含む多くの要素に依存します。 - -{% endtip %} - -| サービス | 必要な最小ノード数 | -|:---------------------------------------------------------------------------:|:---------:| -| `job-server`,
    `memcache-server`,
    `metrics-server`,
    `web-server` | 2 | -| `mysql-server`,
    `redis-server` | 2 | -| `consul-server` | 3 | -| `git-server`,
    `pages-server`,
    `storage-server` | 3 | -| `elasticsearch-server` | 3 | - -### クラスタ設計に関する推奨 - -{% data variables.product.prodname_ghe_server %} を構成するサービス群は、クラスタリングによってそれぞれ個別にスケールアウトできるようになります。 この柔軟性は、様々なスケーラビリティに対する要求を有する組織に適したクラスタの設計と実装に利用できます。 たとえば、組織によっては、大規模あるいは頻繁なフェッチのためにストレージのスループットに対する要求は高いものの、Webサーバーの利用は比較的少ないことがあるでしょう。 別の組織では、少ないストレージリソースで良好なパフォーマンスが出せるものの、`pages-server`あるいは`elasticsearch-server`の動作には多くのノードが必要になるかもしれません。 多くの様々な組み合わせが可能です。 お客様の固有の要求に最も適したクラスタの構成を決めるため、顧客担当と共同で作業してください。 - -- 冗長なノードは、独立したハードウェアに分散させてください。 CPU、メモリ、ストレージデバイスを共用するなら、パフォーマンスの低下が生じ、単一障害点を作ることになります。 ネットワーキングのコンポーネントを共用することも、スループットの低下と障害発生時に接続が失われるリスクの増大を招くことがあります。 -- 高速なストレージを使ってください。 ストレージエリアネットワーク（SAN）は、しばしば絶対的なスループットではなく、最大限の領域の利用、可用性、耐障害性に最適化されます。 {% data variables.product.prodname_ghe_server %} クラスタリングは冗長性と可用性を提供し、利用可能な最速のストレージ上で最高のパフォーマンスを発揮します。 ローカルのSSDストレージをおすすめします。 -- Organization にとって意味のあるノードの層を確立します。 設定例: - - 2つのノードと以下のサービスを持つフロントエンド層： - - `web-server` - - `jobs-server` - - `memcache-server` - - 3つのノードと以下のサービスを持つデータベース層： - - `consul-server` - - `mysql-server` - - `redis-server` - - 3つのノードと以下のサービスを持つ検索層： - - `elasticsearch-server` - - 3つのノードと以下のサービスを持つストレージ層： - - `git-server` - - `pages-server` - - `storage-server` - - `metrics-server` - -#### クラスタの図の例 -{% note %} - -**注意：これは例に過ぎません。**組織にとって最適なクラスタの設計は、組織に特有の要求に依存します。 Talk to your dedicated representative or {% data variables.contact.contact_enterprise_sales %} so we can help you determine the best cluster configuration. - -{% endnote %} - -クラスタの例 diff --git a/translations/ja-JP/content/admin/clustering/about-clustering.md b/translations/ja-JP/content/admin/clustering/about-clustering.md deleted file mode 100644 index 2ea15a472f50..000000000000 --- a/translations/ja-JP/content/admin/clustering/about-clustering.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: クラスタリングについて -intro: '{% data variables.product.prodname_ghe_server %} クラスタリングを利用することで、{% data variables.product.prodname_ghe_server %} を構成するサービス群を複数のノードにまたがってスケールアウトできるようになります。' -redirect_from: - - /enterprise/admin/clustering/clustering-overview/ - - /enterprise/admin/clustering/about-clustering -versions: - enterprise-server: '*' ---- - -### クラスタリングのアーキテクチャ - -{% data variables.product.prodname_ghe_server %}は、一連のサービスから構成されています。 クラスタでは、これらのサービスは複数のノードにまたがって動作し、リクエストはそれらのノード間でロードバランスされます。 変更は、冗長なコピーと共に個別のノードに自動的に保存されます。 ほとんどのサービスは、同じサービスの他のインスタンスと同等のピア群です。 ただし`mysql-server`と`redis-server`サービスは例外です。 これらは1つの_プライマリ_ノードと、1つ以上の_レプリカ_ノード上で動作します。 - -[クラスタリングに必要なサービス](/enterprise/{{ currentVersion }}/admin/guides/clustering/about-cluster-nodes#services-required-for-clustering)についてさらに学んでください。 - -### クラスタリングは組織に適切か？ - -{% data reusables.enterprise_clustering.clustering-scalability %}とはいえ、冗長性のあるスケーラブルなクラスタのセットアップは複雑であり、かつ、注意深い計画が必要です。 この追加の複雑さによって、インストール、システム災害復旧およびアップグレードについて計画することが必要となります。 - -{% data variables.product.prodname_ghe_server %} ではノード間のレイテンシが低いことが必要であり、地理的に離れた場所にまたがる冗長性を意図したものではありません。 - -クラスタリングは冗長性を提供しますが、High Availability構成を置き換えることを意図したものではありません。 詳細は「[High Availability 構成](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-github-enterprise-server-for-high-availability)」を参照してください。 プライマリ／セカンダリフェイルオーバー設定はクラスタリングよりもはるかにシンプルであり、多くの組織の要求に応えます。 詳しくは[クラスタリングと高可用性との違い](/enterprise/{{ currentVersion }}/admin/guides/clustering/differences-between-clustering-and-high-availability-ha/)を参照してください。 - -### クラスタリングを利用するには？ - -クラスタリングは特定のスケーリングの状況のために設計されており、すべての組織を対象としたものではありません。 If clustering is something you'd like to consider, please contact your dedicated representative or {% data variables.contact.contact_enterprise_sales %}. diff --git a/translations/ja-JP/content/admin/clustering/cluster-network-configuration.md b/translations/ja-JP/content/admin/clustering/cluster-network-configuration.md deleted file mode 100644 index 2876141a6d64..000000000000 --- a/translations/ja-JP/content/admin/clustering/cluster-network-configuration.md +++ /dev/null @@ -1,122 +0,0 @@ ---- -title: クラスタのネットワーク設定 -intro: '{% data variables.product.prodname_ghe_server %} クラスタリングが適切に動作するためには、DNS の名前解決、ロードバランシング、ノード間の通信が適切に行われなければなりません。' -redirect_from: - - /enterprise/admin/clustering/network-configuration - - /enterprise/admin/clustering/cluster-network-configuration -versions: - enterprise-server: '*' ---- - -### ネットワークに関する考慮 - -クラスタリングのための最もシンプルなネットワーク設計は、ノード群を単一のLANに置くことです。 冗長性を持つクラスタが複数のサブネットにまたがってしまう場合は、サブネット間に適切な経路があり、レイテンシが1ms以下でなければなりません。 - -#### エンドユーザーのためのアプリケーションポート - -アプリケーションのポートは、エンドユーザーにWebアプリケーションとGitへのアクセスを提供します。 - -| ポート | 説明 | 暗号化 | -|:-------- |:---------------------------------------- |:-------------------------------------------- | -| 22/TCP | Git over SSH | あり | -| 25/TCP | SMTP | STARTTLSが必要 | -| 80/TCP | HTTP | なし
    （SSLが有効化されている場合、このポートはHTTPSにリダイレクトされる） | -| 443/TCP | HTTPS | あり | -| 9418/TCP | シンプルなGitプロトコルのポート
    （プライベートモードでは無効化される） | なし | - -#### 管理ポート - -管理ポートは、エンドユーザが基本的なアプリケーションを利用するためには必要ありません。 - -| ポート | 説明 | 暗号化 | -|:-------- |:------------------------ |:-------------------------------------------- | -| ICMP | ICMP Ping | なし | -| 122/TCP | 管理SSH | あり | -| 161/UDP | SNMP | なし | -| 8080/TCP | Management Console HTTP | なし
    （SSLが有効化されている場合、このポートはHTTPSにリダイレクトされる） | -| 8443/TCP | Management Console HTTPS | あり | - -#### クラスタ通信ポート - -ネットワークレベルのファイアウォールがノード間にある場合は、これらのポートがアクセス可能である必要があります。 ノード間の通信は暗号化されていません。 これらのポートは外部からアクセスできません。 - -| ポート | 説明 | -|:--------- |:------------------- | -| 1336/TCP | 内部 API | -| 3033/TCP | 内部 SVN アクセス | -| 3037/TCP | 内部 SVN アクセス | -| 3306/TCP | MySQL | -| 4486/TCP | Governor アクセス | -| 5115/TCP | ストレージバックエンド | -| 5208/TCP | 内部 SVN アクセス | -| 6379/TCP | Redis | -| 8001/TCP | Grafana | -| 8090/TCP | 内部 GPG アクセス | -| 8149/TCP | GitRPC ファイルサーバーアクセス | -| 8300/TCP | Consul | -| 8301/TCP | Consul | -| 8302/TCP | Consul | -| 9000/TCP | Git デーモン | -| 9102/TCP | Pages ファイルサーバー | -| 9105/TCP | LFS サーバー | -| 9200/TCP | Elasticsearch | -| 9203/TCP | セマンティックコードサービス | -| 9300/TCP | Elasticsearch | -| 11211/TCP | Memcache | -| 161/UDP | SNMP | -| 8125/UDP | Statsd | -| 8301/UDP | Consul | -| 8302/UDP | Consul | -| 25827/UDP | Collectd | - - -### ロードバランサの設定 - - ノード間のトラフィックの分配には、PROXY プロトコルをサポートする TCP ベースの外部ロードバランサをおすすめします。 以下のロードバランサ設定を検討してください: - - - TCP ポート (下記参照) は `web-server` サービスを実行しているノードに転送される必要があります。 これらは、外部クライアント要求を処理する唯一のノードです。 - - スティッキーセッションは有効化してはなりません。 - -{% data reusables.enterprise_installation.terminating-tls %} - -### クライアントの接続情報の処理 - -クラスタへのクライアント接続はロードバランサから行われるため、クライアントの IP アドレスが失われる可能性があります。 クライアント接続情報を正しく取り込むには、追加の検討が必要です。 - -{% data reusables.enterprise_clustering.proxy_preference %} - -{% data reusables.enterprise_clustering.proxy_xff_firewall_warning %} - -#### {% data variables.product.prodname_ghe_server %}での PROXY サポートの有効化 - -インスタンスとロードバランサの双方でPROXYサポートを有効化することを強くおすすめします。 - - - インスタンスにはこのコマンドを使用してください: - ```shell - $ ghe-config 'loadbalancer.proxy-protocol' 'true' && ghe-cluster-config-apply - ``` - - ロードバランサでは、ベンダーから提供された手順書に従ってください。 - - {% data reusables.enterprise_clustering.proxy_protocol_ports %} - -#### {% data variables.product.prodname_ghe_server %}での X-Forwarded-For サポートの有効化 - -{% data reusables.enterprise_clustering.x-forwarded-for %} - -`X-Fowarded-For` ヘッダを有効化するには、次のコマンドを使用します: - -```shell -$ ghe-config 'loadbalancer.http-forward' 'true' && ghe-cluster-config-apply -``` - -{% data reusables.enterprise_clustering.without_proxy_protocol_ports %} - -#### ヘルスチェックの設定 -ロードバランサは健全性チェックによって、事前に設定されたチェックが失敗するようになったノードがあれば、反応しなくなったノードへのトラフィックの送信を止めます。 クラスタのノードに障害が起きた場合、冗長なノードと組み合わさったヘルスチェックが高可用性を提供してくれます。 - -{% data reusables.enterprise_clustering.health_checks %} -{% data reusables.enterprise_site_admin_settings.maintenance-mode-status %} - -### DNSの要求事項 - -{% data reusables.enterprise_clustering.load_balancer_dns %} diff --git a/translations/ja-JP/content/admin/clustering/differences-between-clustering-and-high-availability-ha.md b/translations/ja-JP/content/admin/clustering/differences-between-clustering-and-high-availability-ha.md deleted file mode 100644 index 1231b0ab0826..000000000000 --- a/translations/ja-JP/content/admin/clustering/differences-between-clustering-and-high-availability-ha.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: クラスタリングとHigh Availability（HA）との違い -intro: '{% data variables.product.prodname_ghe_server %} High Availability (HA) は冗長性を提供するプライマリ／セカンダリフェイルオーバー構成ですが、クラスタリングは読み書きの負荷を複数のノードに分散させることによって冗長性とスケーラビリティを提供します。' -redirect_from: - - /enterprise/admin/clustering/differences-between-clustering-and-high-availability-ha -versions: - enterprise-server: '*' ---- - -### フェイルオーバーのシナリオ - -High Availability (HA) とクラスタリングはどちらも、障害の原因となる単一ノードを排除することによって冗長性を提供します。 可用性は次のシナリオで提供できます: - -{% data reusables.enterprise_installation.ha-and-clustering-failure-scenarios %} - -### スケーラビリティ - -{% data reusables.enterprise_clustering.clustering-scalability %}HAでは、アプライアンスのスケールはプライマリノードにのみ依存し、負荷がレプリカサーバーに分配されることはありません。 - -### フェイルオーバーの方法と構成における相違点 - -| 機能 | フェイルオーバーの構成 | フェイルオーバーの方法 | -|:------------------- |:---------------------------------------- |:---------------------------------------------------------- | -| High Availability構成 | プライマリアプライアンスもしくはロードバランサを指す短いTTLのDNSレコード。 | DNSフェイルオーバー及びロードバランサ構成のどちらでも、レプリカアプライアンスを手作業で昇格させなければならない。 | -| クラスタリング | DNSレコードはロードバランサを指さなければならない。 | ロードバランサの背後にあるノードが落ちた場合、トラフィックは動作している他のノードに自動的に送られる。 | - -### バックアップとシステム災害復旧 - -HAもクラスタリングも、定期的なバックアップに代わるものと考えるべきではありません。 詳しくは、"[ アプライアンスでのバックアップの設定](/enterprise/admin/guides/installation/configuring-backups-on-your-appliance)。"を参照してください。 - -### モニタリング - -可用性の機能、特にクラスタリングのように自動フェイルオーバーを持つものは、通常は何かが失敗してもサービスが破綻しないので、障害を覆い隠すことができます。 HAもしくはクラスタリングを利用する場合、障害が起きたことに気づけるよう、各インスタンスの健全性をモニタリングすることが重要です。 モニタリングに関する詳しい情報については、「[アラートの推奨閾値](/enterprise/{{ currentVersion }}/admin/guides/installation/recommended-alert-thresholds/)」および「[クラスタノードのモニタリング](/enterprise/{{ currentVersion}}/admin/guides/clustering/monitoring-cluster-nodes/)」を参照してください。 - -### 参考リンク -- {% data variables.product.prodname_ghe_server %}のクラスタリングに関する詳しい情報については「[クラスタリングについて](/enterprise/{{ currentVersion}}/admin/guides/clustering/about-clustering/)」を参照してください。 -- HA についての詳しい情報は、「[High Availability 向けに {% data variables.product.prodname_ghe_server %} を設定する](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-github-enterprise-server-for-high-availability/)」を参照してください。 diff --git a/translations/ja-JP/content/admin/clustering/evacuating-a-cluster-node.md b/translations/ja-JP/content/admin/clustering/evacuating-a-cluster-node.md deleted file mode 100644 index 9af7afab39d6..000000000000 --- a/translations/ja-JP/content/admin/clustering/evacuating-a-cluster-node.md +++ /dev/null @@ -1,52 +0,0 @@ ---- -title: クラスタノードからの待避 -intro: データサービスをクラスタノードから待避させることができます。 -redirect_from: - - /enterprise/admin/clustering/evacuating-a-cluster-node -versions: - enterprise-server: '*' ---- - -データサービスクラスタにノードが3つしかない場合、ノードからの待避はできません。`ghe-spokes`に、コピーを作成する別の場所がないからです。 ノードが4つ以上ある場合は、`ghe-spokes`によってすべてのリポジトリが待避元のノードから移動されます。 - -データサービス (Git、ページ、ストレージ) があるノードをオフラインにする場合、ノードをオフラインにする前に各ノードからの待避を実行してください。 - -1. `ghe-config`コマンドでクラスタ内のノードの`uuid`を見つけてください。 - - ``` - $ ghe-config cluster._hostname_.uuid - ``` - -2. データのコピー中は、ノードのステータスをモニターする必要があります。 コピーが完了するまで、ノードはオフラインにしないでください。 ノードのステータスをモニターするには、次のいずれかのコマンドを実行します。 - - Git: - ``` - ghe-spokes evac-status - ``` - {% data variables.product.prodname_pages %}: - ``` - echo "select count(*) from pages_replicas where host = 'pages-server-'" | ghe-dbconsole -y - ``` - ストレージ: - ``` - ghe-storage evacuation-status - ``` - -3. コピーが完了したら、ストレージサービスを待避させます。 実行するコマンドは次のいずれかです。 - - Git: - ``` - ghe-spokes server evacuate git-server- - ``` - {% data variables.product.prodname_pages %}: - ``` - ghe-dpages evacuate pages-server- - ``` - ストレージに対して、ノードをオフラインにします。 - ``` - ghe-storage offline storage-server- - ``` - 次に、待避を実行します。 - ``` - ghe-storage evacuate storage-server- - ``` diff --git a/translations/ja-JP/content/admin/clustering/index.md b/translations/ja-JP/content/admin/clustering/index.md deleted file mode 100644 index a470dc03d10d..000000000000 --- a/translations/ja-JP/content/admin/clustering/index.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: GitHub Enterprise Server の設定と管理 -shortTitle: クラスタリング -intro: 'このガイドは、{% data variables.product.prodname_enterprise %} クラスタリングがあなたの組織によって良いソリューションかを決定するための顧客担当との作業と、クラスタのセットアップについて述べます。' -redirect_from: - - /enterprise/admin/clustering -versions: - enterprise-server: '*' ---- - -### 目次 - -{% topic_link_in_list /overview %} - {% link_in_list /about-clustering %} - {% link_in_list /differences-between-clustering-and-high-availability-ha %} -{% topic_link_in_list /setting-up-the-cluster-instances %} - {% link_in_list /about-cluster-nodes %} - {% link_in_list /cluster-network-configuration %} - {% link_in_list /initializing-the-cluster %} -{% topic_link_in_list /managing-a-github-enterprise-server-cluster %} - {% link_in_list /upgrading-a-cluster %} - {% link_in_list /replacing-a-cluster-node %} - {% link_in_list /evacuating-a-cluster-node %} - {% link_in_list /monitoring-cluster-nodes %} diff --git a/translations/ja-JP/content/admin/clustering/initializing-the-cluster.md b/translations/ja-JP/content/admin/clustering/initializing-the-cluster.md deleted file mode 100644 index 097a59e81911..000000000000 --- a/translations/ja-JP/content/admin/clustering/initializing-the-cluster.md +++ /dev/null @@ -1,113 +0,0 @@ ---- -title: クラスタの初期化 -intro: '{% data variables.product.prodname_ghe_server %} クラスタはライセンスを使用して設定し、管理シェル (SSH) を使用して初期化する必要があります。' -redirect_from: - - /enterprise/admin/clustering/initializing-the-cluster -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_clustering.clustering-requires-https %} - -### {% data variables.product.prodname_ghe_server %}のインストール - -1. 各クラスタノードで {% data variables.product.prodname_ghe_server %} をプロビジョニングしてインストールします。 詳細は「[{% data variables.product.prodname_ghe_server %} インスタンスをセットアップする](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-github-enterprise-server-instance)」を参照してください。 -2. 管理シェルもしくは DHCP を使い、各ノードの IP アドレス**のみ**を設定してください。 その他の設定は行わないでください。 - -### 最初のノードの設定 - -1. `cluster.conf`中で`mysql-master`に指定されるノードに接続してください。 詳しい情報については「[クラスタの設定について](/enterprise/{{ currentVersion }}/admin/guides/clustering/initializing-the-cluster/#about-the-cluster-configuration-file)」を参照してください。 -2. Webブラウザで`https://:8443/setup/`にアクセスしてください。 -{% data reusables.enterprise_installation.upload-a-license-file %} -{% data reusables.enterprise_installation.save-settings-in-web-based-mgmt-console %} -{% data reusables.enterprise_installation.instance-will-restart-automatically %} - -### クラスタの初期化 - -クラスタを初期化するためには、クラスタ設定ファイル（`cluster.conf`）が必要です。 詳しい情報については[クラスタの設定について](/enterprise/{{ currentVersion }}/admin/guides/clustering/initializing-the-cluster/#about-the-cluster-configuration-file)を参照してください。 - -1. 設定された最初のノードで、`ghe-cluster-config-init` を実行します。 実行すると、クラスタ設定ファイルに設定されていないノードがある場合にクラスタを初期化します。 -2. `ghe-cluster-config-apply` を実行します。 これにより、 `cluster.conf` ファイルを検証して各ノードファイルに設定を適用し、各ノードで設定されたサービスを起動します。 - -動作中のクラスタのステータスをチェックするには`ghe-cluster-status`コマンドを使ってください。 - -### クラスタ設定ファイルについて - -クラスタ設定ファイル（`cluster.conf`）は、クラスタ中のノードと、その上で動作するサービスを定義します。 詳しい情報については「[クラスタノードについて](/enterprise/{{ currentVersion }}/admin/guides/clustering/about-cluster-nodes)」を参照してください。 - -この例の`cluster.conf`では、5ノードを持つクラスタを定義しています。 - - - 2つのノード（`ghe-app-node-\*`と呼ばれます）では、クライアントからのリクエストに対するレスポンスを受け持つ`web-server`と`job-server`サービスが動作します。 - - 3 つのノード (`ghe-data-node-\*` と呼ばれる) は、{% data variables.product.prodname_ghe_server %} データの保存と取得のサービスを実行します。 - -ノードの名前には、ホスト名として有効な任意の名前を選択できます。 この名前は各ノードのホスト名として設定され、各ノードの`/etc/hosts`に追加され、各ノードがローカルでお互いを解決できるようにします。 - -設定した最初のクラスタノードを、`mysql-server`及び`mysql-master`でMySQLのマスターとして指定してください。 - -``` -[cluster] - mysql-master = ghe-data-node-1 - redis-master = ghe-data-node-1 - primary-datacenter = default -[cluster "ghe-app-node-1"] - hostname = ghe-app-node-1 - ipv4 = 192.168.0.2 - # ipv6 = fd12:3456:789a:1::2 - web-server = true - job-server = true -[cluster "ghe-app-node-2"] - hostname = ghe-app-node-2 - ipv4 = 192.168.0.3 - # ipv6 = fd12:3456:789a:1::3 - web-server = true - job-server = true -[cluster "ghe-data-node-1"] - hostname = ghe-data-node-1 - ipv4 = 192.168.0.4 - # ipv6 = fd12:3456:789a:1::4 - consul-server = true - consul-datacenter = default - git-server = true - pages-server = true - mysql-server = true - elasticsearch-server = true - redis-server = true - memcache-server = true - metrics-server = true - storage-server = true -[cluster "ghe-data-node-2"] - hostname = ghe-data-node-2 - ipv4 = 192.168.0.5 - # ipv6 = fd12:3456:789a:1::5 - consul-server = true - consul-datacenter = default - git-server = true - pages-server = true - mysql-server = true - elasticsearch-server = true - redis-server = true - memcache-server = true - metrics-server = true - storage-server = true -[cluster "ghe-data-node-3"] - hostname = ghe-data-node-3 - ipv4 = 192.168.0.6 - # ipv6 = fd12:3456:789a:1::6 - consul-server = true - consul-datacenter = default - git-server = true - pages-server = true - mysql-server = true - elasticsearch-server = true - redis-server = true - memcache-server = true - metrics-server = true - storage-server = true -``` - -設定された最初のノード上で、`/data/user/common/cluster.conf` ファイルを作成します。 たとえば、次のように `vim` を使用します。 - - ```shell - ghe-data-node-1:~$ sudo vim /data/user/common/cluster.conf - ``` - diff --git a/translations/ja-JP/content/admin/clustering/managing-a-github-enterprise-server-cluster.md b/translations/ja-JP/content/admin/clustering/managing-a-github-enterprise-server-cluster.md deleted file mode 100644 index 301b9e9a1074..000000000000 --- a/translations/ja-JP/content/admin/clustering/managing-a-github-enterprise-server-cluster.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: GitHub Enterprise Server クラスタの管理 -intro: 'アップグレード、キャパシティの追加、障害が起きたノードの置き換えなど、{% data variables.product.prodname_ghe_server %} クラスタのメンテナンス処理を計画します。' -redirect_from: - - /enterprise/admin/guides/clustering/managing-a-github-enterprise-cluster/ - - /enterprise/admin/clustering/managing-a-github-enterprise-server-cluster -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/ja-JP/content/admin/clustering/monitoring-cluster-nodes.md b/translations/ja-JP/content/admin/clustering/monitoring-cluster-nodes.md deleted file mode 100644 index 6c2ea2746ff9..000000000000 --- a/translations/ja-JP/content/admin/clustering/monitoring-cluster-nodes.md +++ /dev/null @@ -1,106 +0,0 @@ ---- -title: クラスタノードのモニタリング -intro: '{% data variables.product.prodname_ghe_server %} クラスタは、2 つ以上のノードに分散された冗長サービスで構成されています。 もしも個々のサービスまたは1つのノード全体に障害があっても、それがクラスタのユーザに即座に見えることはありません。 ただし、パフォーマンスと冗長性が影響を受けるため、{% data variables.product.prodname_ghe_server %} クラスタの健全性を監視することが重要です。' -redirect_from: - - /enterprise/admin/clustering/monitoring-cluster-nodes -versions: - enterprise-server: '*' ---- - -### クラスタのステータスの手動でのチェック - -{% data variables.product.prodname_ghe_server %} には、クラスタの健全性をモニタリングするためのコマンドラインユーティリティが組み込まれています。 管理シェルから`ghe-cluster-status`コマンドを実行すると、接続性やサービスステータスの検証を含む一連のヘルスチェックが各ノード上で実行されます。 結果出力には、すべてのテスト結果にtext `ok`もしくは`error`が含まれます。 たとえば失敗したテストだけを表示するには以下のようにしてください。 - -```shell -admin@ghe-data-node-0:~$ ghe-cluster-status | grep error -> mysql-replication ghe-data-node-0: error Stopped -> mysql cluster: error -``` -{% note %} - -**メモ:** すべてのテストにパスした場合、このコマンドは何も出力しません。 これはクラスタが健全であることを意味します。 - -{% endnote %} - -### Nagiosでのクラスタステータスのモニタリング - -{% data variables.product.prodname_ghe_server %} をモニタリングするよう、[Nagios](https://www.nagios.org/) を設定できます。 各クラスタノードの基本的な接続性のモニタリングに加えて、`ghe-cluster-status -n`コマンドを使うようNagiosを設定してクラスタステータスをチェックできます。 これは、Nagiosが理解できるフォーマットの出力を返します。 - -#### 必要な環境 -* Nagiosを動作させるLinuxのホスト。 -* {% data variables.product.prodname_ghe_server %}クラスターへのネットワークアクセス。 - -#### Nagiosホストの設定 -1. 空のパスフレーズで SSH キーを生成してください。 Nagios はこれを使用して {% data variables.product.prodname_ghe_server %} クラスタへの認証を行います。 - ```shell - nagiosuser@nagios:~$ ssh-keygen -t rsa -b 4096 - > Generating public/private rsa key pair. - > Enter file in which to save the key (/home/nagiosuser/.ssh/id_rsa): - > Enter passphrase (empty for no passphrase): leave blank by pressing enter - > Enter same passphrase again: press enter again - > Your identification has been saved in /home/nagiosuser/.ssh/id_rsa. - > Your public key has been saved in /home/nagiosuser/.ssh/id_rsa.pub. - ``` - {% danger %} - - {% danger %} - **セキュリティの警告:** パスフレーズを持たない SSH キーは、ホストへの完全なアクセスを承認されていた場合、セキュリティリスクになることがあります。 このキーの承認は、単一の読み取りのみのコマンドに限定してください。 - - {% enddanger %} -2. 秘密鍵 (`id_rsa`) を `nagios` ホームフォルダにコピーし、適切な所有権を設定します。 - ```shell - nagiosuser@nagios:~$ sudo cp .ssh/id_rsa /var/lib/nagios/.ssh/ - nagiosuser@nagios:~$ sudo chown nagios:nagios /var/lib/nagios/.ssh/id_rsa - ``` - -3. `ghe-cluster-status -n` コマンド*のみ*を実行するために公開鍵を認証するには、`/data/user/common/authorized_keys` ファイル中で `command=` プレフィックスを使ってください。 任意のノードの管理シェルから、このファイルを変更してステップ1で生成した公開鍵を追加してください。 例: `command="/usr/local/bin/ghe-cluster-status -n" ssh-rsa AAAA....` - -4. `/data/user/common/authorized_keys` ファイルを変更したノード上で `ghe-cluster-config-apply` を実行し、設定を検証してクラスタ内の各ノードにコピーしてください。 - - ```shell - admin@ghe-data-node-0:~$ ghe-cluster-config-apply - > Validating configuration - > ... - > Finished cluster configuration - ``` - -5. Nagios プラグインがこのコマンドの実行をうまく行えることをテストするには、このコマンドを Nagios のホストからインタラクティブに実行してください。 - ```shell - nagiosuser@nagios:~$ /usr/lib/nagios/plugins/check_by_ssh -l admin -p 122 -H hostname -C "ghe-cluster-status -n" -t 30 - > OK - No errors detected - ``` - -6. Nagios の設定中にコマンド定義を作成してください。 - - ###### 定義の例 - - ``` - define command { - command_name check_ssh_ghe_cluster - command_line $USER1$/check_by_ssh -H $HOSTADDRESS$ -C "ghe-cluster-status -n" -l admin -p 122 -t 30 - } - ``` -7. このコマンドを {% data variables.product.prodname_ghe_server %} クラスタ内のノードのサービス定義に追加します。 - - - ###### 定義の例 - - ``` - define host{ - use generic-host - host_name ghe-data-node-0 - alias ghe-data-node-0 - address 10.11.17.180 - } - - define service{ - use generic-service - host_name ghe-data-node-0 - service_description GitHub Cluster Status - check_command check_ssh_ghe_cluster - } - ``` - -Nagios に定義を追加すると、設定に従ってサービスチェックが実行されます。 Nagios の Web インターフェースで新しく設定されたサービスを確認することができます。 - -![Nagios の例](/assets/images/enterprise/cluster/nagios-example.png) diff --git a/translations/ja-JP/content/admin/clustering/overview.md b/translations/ja-JP/content/admin/clustering/overview.md deleted file mode 100644 index ef8b12b71dd8..000000000000 --- a/translations/ja-JP/content/admin/clustering/overview.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: 概要 -intro: クラスタリングについて、そしてHigh Availabilityとの差異にについて学んでください。 -mapTopic: true -redirect_from: - - /enterprise/admin/clustering/overview -versions: - enterprise-server: '*' ---- - diff --git a/translations/ja-JP/content/admin/clustering/replacing-a-cluster-node.md b/translations/ja-JP/content/admin/clustering/replacing-a-cluster-node.md deleted file mode 100644 index 54afe01d57dd..000000000000 --- a/translations/ja-JP/content/admin/clustering/replacing-a-cluster-node.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: クラスタノードの入れ替え -intro: '{% data variables.product.prodname_ghe_server %} ノードを入れ替えるには、クラスタ設定ファイル (`cluster.conf`) 中で対象となるノードをオフラインとしてマークし、入れ替えるノードを追加しなければなりません。 ノードに障害があった場合、あるいはパフォーマンスを高めるためにリソースの多いノードを追加する場合、この作業が必要になることがあります。' -redirect_from: - - /enterprise/admin/clustering/replacing-a-cluster-node -versions: - enterprise-server: '*' ---- - -{% warning %} - -**警告：**衝突を避けるため、入れ替えるノードはそれまでクラスタ中で使われていないホスト名を使わなければなりません。 - -{% endwarning %} - -### 関数ノードの入れ替え -{% data reusables.enterprise_clustering.replacing-a-cluster-node-provision %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-admin-configure-ip %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-modify-cluster-conf %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-initialize-new-node %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-config-node %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-need-three-nodes %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-mark-offline %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-validate-config %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-replacement-name %} - -### 緊急時のノードの入れ替え -{% data reusables.enterprise_clustering.replacing-a-cluster-node-provision %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-admin-configure-ip %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-mark-offline %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-validate-config %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-modify-cluster-conf %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-replacement-name %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-initialize-new-node %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-config-node %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-need-three-nodes %} diff --git a/translations/ja-JP/content/admin/clustering/setting-up-the-cluster-instances.md b/translations/ja-JP/content/admin/clustering/setting-up-the-cluster-instances.md deleted file mode 100644 index 054a4eff638b..000000000000 --- a/translations/ja-JP/content/admin/clustering/setting-up-the-cluster-instances.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: クラスタインスタンスのセットアップ -intro: '{% data variables.product.prodname_ghe_server %} のクラスタリングには、複数のインスタンスのセットアップと {% data variables.product.prodname_ghe_server %} サービスの実行設定が必要です。' -mapTopic: true -redirect_from: - - /enterprise/admin/clustering/setting-up-the-cluster-instances -versions: - enterprise-server: '*' ---- - diff --git a/translations/ja-JP/content/admin/clustering/upgrading-a-cluster.md b/translations/ja-JP/content/admin/clustering/upgrading-a-cluster.md deleted file mode 100644 index 4533d28a56c1..000000000000 --- a/translations/ja-JP/content/admin/clustering/upgrading-a-cluster.md +++ /dev/null @@ -1,76 +0,0 @@ ---- -title: クラスタのアップグレード -intro: '管理シェル (SSH) を使用して {% data variables.product.prodname_ghe_server %}クラスタを最新のリリースにアップグレードします。' -redirect_from: - - /enterprise/admin/clustering/upgrading-a-cluster -versions: - enterprise-server: '*' ---- - -### ホットパッチでのアップグレード -{% data reusables.enterprise_installation.hotpatching-explanation %}ホットパッチのインストールスクリプトは、ホットパッチをクラスタ内の各ノードにインストールし、サービスを適切な順序で再起動し、ダウンタイムを回避します。 - -1. データを[{% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils#readme)でバックアップしてください。 -2. 任意のノードの管理シェルから `ghe-cluster-hotpatch` コマンドを使って最新のホットパッチをインストールしてください。 ホットパッチの URL を指定するか、手動でホットパッチをダウンロードしてローカルのファイル名を指定することができます。 - ```shell - $ ghe-cluster-hotpatch https://HOTPATCH-URL/FILENAME.hpkg - ``` - -### アップグレードパッケージでのアップグレード -アップグレードパッケージを使用して、{% data variables.product.prodname_ghe_server %} クラスタを最新のフィーチャリリースにアップグレードします。 たとえば`2.11`から`2.13`へのアップグレードが行えます。 - -#### アップグレードの準備 - -1. アップグレードしようとしているバージョンの[クラスタネットワーク設定](/enterprise/admin/guides/clustering/cluster-network-configuration)をレビューして、必要に応じて設定を更新してください。 -2. データを[{% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils#readme)でバックアップしてください。 -3. アップグレード中は通常どおりに使用できないため、{% data variables.product.prodname_ghe_server %}クラスタのエンドユーザーに対してメンテナンス期間をスケジュールします。 メンテナンスモードは、クラスタのアップグレードの進行中、ユーザーのアクセスをブロックし、データが変更されないようにします。 -4. [{% data variables.product.prodname_ghe_server %}のダウンロードページ](https://enterprise.github.com/download)で、アップグレード *.pkg* ファイルの URL をクリップボードにコピーします。 -5. 任意のノードの管理シェルから `ghe-cluster-each` コマンドを `curl` と組み合わせて使い、一度のステップでリリースパッケージを各ノードにダウンロードしてください。 先ほどのステップでコピーした URL を引数として使ってください。 - ```shell - $ ghe-cluster-each -- "cd /home/admin && curl -L -O https://PACKAGE-URL.pkg" - > ghe-app-node-1: % Total % Received % Xferd Average Speed Time Time Time Current - > ghe-app-node-1: Dload Upload Total Spent Left Speed - > 100 496M 100 496M 0 0 24.2M 0 0:00:20 0:00:20 --:--:-- 27.4M - > ghe-data-node-2: % Total % Received % Xferd Average Speed Time Time Time Current - > ghe-data-node-2: Dload Upload Total Spent Left Speed - > 100 496M 100 496M 0 0 21.3M 0 0:00:23 0:00:23 --:--:-- 25.8M - > ghe-data-node-1: % Total % Received % Xferd Average Speed Time Time Time Current - > ghe-data-node-1: Dload Upload Total Spent Left Speed - > 100 496M 100 496M 0 0 19.7M 0 0:00:25 0:00:25 --:--:-- 25.6M - > ghe-app-node-2: % Total % Received % Xferd Average Speed Time Time Time Current - > ghe-app-node-2: Dload Upload Total Spent Left Speed - > 100 496M 100 496M 0 0 19.8M 0 0:00:25 0:00:25 --:--:-- 17.6M - > ghe-data-node-3: % Total % Received % Xferd Average Speed Time Time Time Current - > ghe-data-node-3: Dload Upload Total Spent Left Speed - > 100 496M 100 496M 0 0 19.7M 0 0:00:25 0:00:25 --:--:-- 25.5M - ``` -6. `cluster.conf` で `mysql-master = ` として定義されているプライマリ MySQL ノードを特定します。 このノードは最後にアップグレードされます。 - -#### クラスタノードのアップグレード - -1. 任意のクラスタノードの管理シェルに接続し、`ghe-cluster-maintenance -s` を実行して、スケジュールしたウィンドウに従ってメンテナンスモードを有効にします。 -2. **プライマリMySQLノードを除き**、{% data variables.product.prodname_ghe_server %}の各ノードの管理シェルに接続します。 [アップグレードの準備](#preparing-to-upgrade)のステップ 4 でダウンロードしたパッケージのファイル名を用いて、`ghe-upgrade` コマンドを実行してください。 - ```shell - $ ghe-upgrade PACKAGE-FILENAME.pkg - > *** verifying upgrade package signature... - > 497MB 0:00:04 [ 117MB/s] [==========================================>] 100% - > gpg: Signature made Fri 19 Feb 2016 02:33:50 PM UTC using RSA key ID 0D65D57A - > gpg: checking the trustdb - > gpg: 3 marginal(s) needed, 1 complete(s) needed, PGP trust model - > gpg: depth: 0 valid: 1 signed: 0 trust: 0-, 0q, 0n, 0m, 0f, 1u - > gpg: Good signature from "GitHub Enterprise (Upgrade Package Key) > " - ``` -3. アップグレードプロセスが完了すると、ノードが再起動します。 再起動後に各ノードを `ping` できることを確認してください。 -4. プライマリ MySQL ノードの管理シェルに接続してください。 [アップグレードの準備](#preparing-to-upgrade)のステップ 4 でダウンロードしたパッケージのファイル名を用いて、`ghe-upgrade` コマンドを実行してください。 - ```shell - $ ghe-upgrade PACKAGE-FILENAME.pkg - > *** verifying upgrade package signature... - > 497MB 0:00:04 [ 117MB/s] [==========================================>] 100% - > gpg: Signature made Fri 19 Feb 2016 02:33:50 PM UTC using RSA key ID 0D65D57A - > gpg: checking the trustdb - > gpg: 3 marginal(s) needed, 1 complete(s) needed, PGP trust model - > gpg: depth: 0 valid: 1 signed: 0 trust: 0-, 0q, 0n, 0m, 0f, 1u - > gpg: Good signature from "GitHub Enterprise (Upgrade Package Key) > " - ``` -5. アップグレードプロセスが完了すると、プライマリ MySQL ノードが再起動します。 再起動後に各ノードを `ping` できることを確認してください。 -6. 任意のノードの管理シェルから `ghe-cluster-maintenance -u` を実行して管理モードを終了してください。 diff --git a/translations/ja-JP/content/admin/configuration/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md b/translations/ja-JP/content/admin/configuration/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md deleted file mode 100644 index 78aa49eb04c5..000000000000 --- a/translations/ja-JP/content/admin/configuration/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: GitHub Enterprise Serverで脆弱性のある依存関係に対するアラートを有効化する -intro: '{% data variables.product.product_location_enterprise %}を{% data variables.product.prodname_ghe_cloud %}に接続して、インスタンスのリポジトリ内の脆弱性のある依存関係に対するセキュリティアラートを有効化することができます。' -redirect_from: - - /enterprise/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server - - /enterprise/admin/configuration/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server -permissions: '接続された{% data variables.product.prodname_ghe_cloud %}のOrganizationあるいはEnterpriseアカウントの所有者でもある{% data variables.product.prodname_ghe_server %}のサイト管理者は、{% data variables.product.prodname_ghe_server %}上の脆弱性のある依存関係に対するセキュリティアラートを有効化できます。' -versions: - enterprise-server: '*' ---- - -### About alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %} - -{% data reusables.repositories.tracks-vulnerabilities %} For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)." - -{% data variables.product.product_location_enterprise %}を{% data variables.product.prodname_dotcom_the_website %}に接続して、インスタンスに脆弱性データを同期させ、脆弱性のある依存関係を持つリポジトリ内にセキュリティアラートを生成します。 - -{% data variables.product.product_location_enterprise %}を {% data variables.product.prodname_dotcom_the_website %}に接続し、脆弱性のある依存関係に関するセキュリティアラートを有効化すると、{% data variables.product.prodname_dotcom_the_website %}からのあなたのインスタンスへ、脆弱性データが 1 時間に 1 回同期されます。 また、脆弱性データはいつでも手動で同期することができます。 {% data variables.product.product_location_enterprise %} からのコードまたはコードに関する情報は、{% data variables.product.prodname_dotcom_the_website %} にアップロードされません。 - -{% data variables.product.product_location_enterprise %} が脆弱性に関する情報を受信すると、影響を受けるバージョンの依存関係を使用するインスタンス内のリポジトリを識別し、それらのリポジトリ内の管理者アクセス権を持つコードオーナーおよび人にセキュリティアラートを送信します。 セキュリティアラートの受信方法をカスタマイズすることができます。 詳しい情報については、「[脆弱性のある依存関係に対するアラートについて](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies/#configuring-notifications-for-security-alerts)」を参照してください。 - -### {% data variables.product.prodname_ghe_server %}で脆弱性のある依存関係に対するアラートを有効化する - -{% data variables.product.product_location_enterprise %} で脆弱性のある依存関係に対するセキュリティアラートを有効化する前に、{% data variables.product.product_location_enterprise %} を {% data variables.product.prodname_dotcom_the_website %} に接続する必要があります。 詳細は、「[{% data variables.product.prodname_ghe_server %}を{% data variables.product.prodname_ghe_cloud %}に接続する](/enterprise/{{ currentVersion }}/admin/guides/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)」を参照してください。 - -{% if currentVersion ver_gt "enterprise-server@2.20" %} We recommend configuring security alerts without notifications for the first few days to avoid an overload of emails. After a few days, you can enable notifications to receive security alerts as usual.{% endif %} - -{% data reusables.enterprise_site_admin_settings.sign-in %} -2. 管理シェルで、{% data variables.product.product_location_enterprise %} の脆弱性のある依存関係に対するセキュリティアラートを有効化します。 - ``` shell -$ ghe-dep-graph-enable -``` -3. {% data variables.product.prodname_ghe_server %}に戻ります。 -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %}{% if currentVersion ver_gt "enterprise-server@2.20" %} -5. Under "Repositories can be scanned for vulnerabilities", use the drop-down menu and select **Enabled without notifications**. Optionally, to enable alerts with notifications, select **Enabled with notifications**.{% else %} -5. 「Repositories can be scanned for vulnerabilities」で、ドロップダウンメニューを使用して「**Enabled**」を選択します。 -{% endif %} - ![脆弱性に対するリポジトリのスキャンを有効化するドロップダウンメニュー](/assets/images/enterprise/site-admin-settings/enable-vulnerability-scanning-in-repositories.png) - -### {% data variables.product.prodname_ghe_server %}で脆弱性のある依存関係を表示する - -{% data variables.product.product_location_enterprise %}ですべての脆弱性を表示し、{% data variables.product.prodname_dotcom_the_website %}から脆弱性データを手動で同期して、リストを更新することができます。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -2. 左サイドバーで [**Vulnerabilities**] をクリックします。 ![サイト管理サイドバーの [Vulnerabilities] タブ](/assets/images/enterprise/business-accounts/vulnerabilities-tab.png) -3. 脆弱性データを同期するには、[**Sync Vulnerabilities now**] をクリックします。 ![[Sync vulnerabilities now] ボタン](/assets/images/enterprise/site-admin-settings/sync-vulnerabilities-button.png) diff --git a/translations/ja-JP/content/admin/developer-workflow/about-pre-receive-hooks.md b/translations/ja-JP/content/admin/developer-workflow/about-pre-receive-hooks.md deleted file mode 100644 index ecaebc23d975..000000000000 --- a/translations/ja-JP/content/admin/developer-workflow/about-pre-receive-hooks.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: pre-receiveフックについて -intro: '*pre-receive フック*は {% data variables.product.prodname_ghe_server %} アプライアンス上で動作するスクリプトで、品質チェックを実装するために利用できます。' -redirect_from: - - /enterprise/admin/developer-workflow/about-pre-receive-hooks -versions: - enterprise-server: '*' ---- - -プッシュが行われると、各スクリプトは分離された環境で実行され、プッシュの内容についてのチェックを実行できます。 このスクリプトの終了ステータスが0ならプッシュは受け付けられ、0以外なら拒否されることになります。 - -### 利用のシナリオ -pre-receiveフックは、ビジネスルールを満たしたり、規制の遵守を強制したり、一般的なミスを避けたりするために利用してください。 - -pre-receiveフックの利用方法の例： - -- 正当なチケット番号を含めたり、一定以上の長さでなければならなかったりといった特定のパターンやフォーマットに伴うコミットメッセージを要求する。 -- すべてのプッシュを拒否する事でブランチまたはリポジトリをロックする。 -- キーワード、パターン、ファイルタイプをブロックすることによって、センシティブなデータがリポジトリに追加されないようにする。 -- PRの作者が自身の変更をマージしないようにする。 - -### パフォーマンスとワークフローへの影響 -開発者と開発者のワークフローへの影響は大きくなりうるので、注意深く検討することが必要です。 ビジネス上の要求に基づき、思慮深く実装されたpre-receiveフックは、全体として組織に最大のメリットをもたらします。 - -pre-receiveフックは{% data variables.product.product_location_enterprise %}のパフォーマンスに意図しない影響をもたらすことがあり、慎重に実装され、レビューされなければなりません。 diff --git a/translations/ja-JP/content/admin/developer-workflow/about-protected-branches-and-required-status-checks.md b/translations/ja-JP/content/admin/developer-workflow/about-protected-branches-and-required-status-checks.md deleted file mode 100644 index c9efb7007f3c..000000000000 --- a/translations/ja-JP/content/admin/developer-workflow/about-protected-branches-and-required-status-checks.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: 保護されたブランチと必須のステータスチェックについて -intro: '保護されたブランチは、リポジトリのコラボレータが回復不能な変更をブランチに行えないことを確実にします。 必須ステータスチェックにより、コラボレータが保護されたブランチに変更を加える前に、すべての必須 CI テストにパスしていることが保証されます。 Organization に属するリポジトリ内のブランチは、特定のユーザ{% if currentVersion ver_gt "enterprise-server@2.18" %}、{% else %} または{% endif %}チーム{% if currentVersion ver_gt "enterprise-server@2.18" %}、またはアプリ{% endif %}のみがブランチにプッシュできるように設定できます。' -redirect_from: - - /enterprise/admin/developer-workflow/about-protected-branches-and-required-status-checks -versions: - enterprise-server: '*' ---- - -*保護されたブランチ*は、リポジトリの管理者が保護することにしたブランチに対する Git のいくつかの機能をブロックします。 保護されたブランチは、 - -* フォースプッシュできません。 -* 削除できません。 -* [必須のステータスチェック](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/configuring-protected-branches-and-required-status-checks#enabling-required-status-checks)をパスするまでは、変更をマージできません。 - -リポジトリに対する管理者権限を持つユーザなら誰でも、保護されたブランチに常にプッシュできます。 *ブランチ制限*を有効化している場合、権限を与えられたユーザ{% if currentVersion ver_gt "enterprise-server@2.18" %}、{% else %}または{% endif %}チーム{% if currentVersion ver_gt "enterprise-server@2.18" %}、またはアプリ{% endif %}のみが、保護されたブランチにプッシュできます。 詳しい情報については[保護されたブランチと必須のステータスチェックの設定](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/configuring-protected-branches-and-required-status-checks)を参照してください。 - -![制限されたブランチの権限](/assets/images/help/repository/restrict-branch-users.png). - -{% tip %} - -**注釈:** [Include administrators] が選択されていて、ブランチで[ステータスチェック必須](/articles/enabling-required-status-checks)にしており、かつステータスチェックが失敗した場合は、管理者権限を持つ人{% if currentVersion ver_gt "enterprise-server@2.18" %}やアプリ{% endif %}であっても、保護されたブランチに変更をプッシュしようとすれば失敗することになります。 - -{% endtip %} diff --git a/translations/ja-JP/content/admin/developer-workflow/blocking-force-pushes-on-your-appliance.md b/translations/ja-JP/content/admin/developer-workflow/blocking-force-pushes-on-your-appliance.md deleted file mode 100644 index 954fc27c1610..000000000000 --- a/translations/ja-JP/content/admin/developer-workflow/blocking-force-pushes-on-your-appliance.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: アプライアンス上でのフォースプッシュのブロック -redirect_from: - - /enterprise/admin/articles/blocking-force-pushes-on-your-appliance/ - - /enterprise/admin/developer-workflow/blocking-force-pushes-on-your-appliance -intro: 'サイト管理者は誰でも、{% data variables.product.prodname_ghe_server %} アプライアンス上のすべてのフォースプッシュ (`git push --force`) をブロックできます。' -versions: - enterprise-server: '*' ---- - -それぞれのリポジトリは、所属するユーザアカウントもしくはOraganizationの設定から、デフォルトのフォースプッシュの設定を引き継ぎます。 同様に、それぞれのOrganization及びユーザアカウントは、デフォルトのフォースプッシュの設定をアプライアンス全体のフォースプッシュの設定から引き継ぎます。 アプライアンスのフォースプッシュの設定を変更すれば、すべてのユーザあるいはOrganizationが所有するすべてのリポジトリが変更されます。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -4. [Force pushes] の下のドロップダウンメニューから、[**Allow**]、[**Block**]、[**Block to the default branch**] のいずれかをクリックしてください。 ![フォースプッシュのドロップダウン](/assets/images/enterprise/site-admin-settings/force-pushes-dropdown.png) -5. [**Enforce on all repositories（すべてのリポジトリに強制）**] を選択して、フォースプッシュに関する Organization およびリポジトリレベルの設定をオーバーライドすることもできます。 - -### 参考リンク - -- [ユーザーアカウントもしくはOrganizationが所有するリポジトリへのフォースプッシュのブロック](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization) -- [リポジトリへのフォースプッシュのブロック](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository) diff --git a/translations/ja-JP/content/admin/developer-workflow/blocking-force-pushes-to-a-repository.md b/translations/ja-JP/content/admin/developer-workflow/blocking-force-pushes-to-a-repository.md deleted file mode 100644 index 6a4f7cab121b..000000000000 --- a/translations/ja-JP/content/admin/developer-workflow/blocking-force-pushes-to-a-repository.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: リポジトリへのフォースプッシュをブロックする -redirect_from: - - /enterprise/admin/articles/blocking-force-pushes-to-a-repository/ - - /enterprise/admin/articles/block-force-pushes/ - - /enterprise/admin/developer-workflow/blocking-force-pushes-to-a-repository -intro: リポジトリのすべてのブランチ、あるいはデフォルトブランチに対するフォースプッシュ（`git push --force`）をブロックできます。 -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_site_admin_settings.override-policy %} - -{% data reusables.enterprise_site_admin_settings.sign-in %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -4. [**Push and Pull**] の下で [**Block**] または [**Block to the default branch**] を選択してください。 ![フォースプッシュのブロック](/assets/images/enterprise/site-admin-settings/repo/repo-block-force-pushes.png) - -変更はすぐに有効になります。 後で考えが変わった場合には、フォースプッシュを再度許可することも簡単にできます。 - -## 参考リンク - -- [ユーザーアカウントもしくはOrganizationが所有するリポジトリへのフォースプッシュのブロック](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization) -- [アプライアンスでのフォースプッシュのブロック](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-on-your-appliance) diff --git a/translations/ja-JP/content/admin/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization.md b/translations/ja-JP/content/admin/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization.md deleted file mode 100644 index 2ae20f2ab9cf..000000000000 --- a/translations/ja-JP/content/admin/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: ユーザアカウントもしくはOrganizationが所有するリポジトリへのフォースプッシュのブロック -redirect_from: - - /enterprise/admin/articles/blocking-force-pushes-for-a-user-account/ - - /enterprise/admin/articles/blocking-force-pushes-for-an-organization/ - - /enterprise/admin/articles/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization/ - - /enterprise/admin/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization -intro: ユーザアカウントもしくはOrganizationが所有するリポジトリのすべてのブランチ、あるいはデフォルトブランチのみに対してフォースプッシュ（`git push --force`）をブロックできます。 -versions: - enterprise-server: '*' ---- - -リポジトリは、所属するユーザアカウントもしくはOrganizationからフォースプッシュの設定を引き継ぎます。 そしてそれぞれのOrganization及びユーザアカウントは、フォースプッシュの設定をアプライアンス全体のフォースプッシュの設定から引き継ぎます。 - -引き継がれたデフォルトの設定は、ユーザアカウントもしくはOrganizationの設定をすることで上書きできます。 - -{% data reusables.enterprise_site_admin_settings.sign-in %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.search-user-or-org %} -{% data reusables.enterprise_site_admin_settings.click-user-or-org %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -5. [Repository default settings（リポジトリのデフォルト設定）] の下の [Force pushes（フォースプッシュ）] セクションで、以下から選択してください。 - - [**Block（ブロック）**] ですべてのブランチへのフォースプッシュがブロックされます。 - - [**Block to the default branch（デフォルトブランチへのブロック）**] でデフォルトブランチへのフォースプッシュのみがブロックされます。 ![フォースプッシュのブロック](/assets/images/enterprise/site-admin-settings/user/user-block-force-pushes.png) -6. **Enforce on all repositories（すべてのリポジトリに対して強制）**を選択して、リポジトリ固有の設定を上書きすることもできます。 こうしてもアプライアンス全体のポリシーは上書き**されない**ことに注意してください。 ![Block force pushes](/assets/images/enterprise/site-admin-settings/user/user-block-all-force-pushes.png) この変更はすぐに有効になります。 後で考えが変わった場合には、フォースプッシュを再度許可することもできます。 - -### 参考リンク - -- [リポジトリへのフォースプッシュのブロック](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository) -- [アプライアンスでのフォースプッシュのブロック](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-on-your-appliance) diff --git a/translations/ja-JP/content/admin/developer-workflow/blocking-force-pushes.md b/translations/ja-JP/content/admin/developer-workflow/blocking-force-pushes.md deleted file mode 100644 index 89ad90a02f28..000000000000 --- a/translations/ja-JP/content/admin/developer-workflow/blocking-force-pushes.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: フォースプッシュのブロック -intro: 'フォースプッシュのブロックは、{% data variables.product.prodname_ghe_server %} アプライアンス上の全リポジトリ、ある Oraganization が所有するすべてのリポジトリ、特定のリポジトリに対して行えます。' -mapTopic: true -redirect_from: - - /enterprise/admin/developer-workflow/blocking-force-pushes -versions: - enterprise-server: '*' ---- - diff --git a/translations/ja-JP/content/admin/developer-workflow/configuring-protected-branches-and-required-status-checks.md b/translations/ja-JP/content/admin/developer-workflow/configuring-protected-branches-and-required-status-checks.md deleted file mode 100644 index f6789cbcc131..000000000000 --- a/translations/ja-JP/content/admin/developer-workflow/configuring-protected-branches-and-required-status-checks.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: 保護されたブランチと必須のステータスチェックの設定 -intro: ブランチの操作を制限するために保護されたブランチを有効化できます。また、ブランチがプルリクエストでマージされる前、あるいはローカルブランチへのコミットが保護されたリモートブランチへプッシュされる前に、必須のステータスチェックを強制することができます。 -redirect_from: - - /enterprise/admin/developer-workflow/configuring-protected-branches-and-required-status-checks -versions: - enterprise-server: '*' ---- - -リポジトリに対する管理者権限があるユーザなら誰でも、ブランチ制限を有効化できます。 - -### リポジトリで保護されたブランチを有効化する - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -{% data reusables.repositories.repository-branches %} -{% data reusables.repositories.add-branch-protection-rules %} -5. **Create（作成）**をクリックしてください。 - -### 必須ステータスチェックのタイプ - -| 必須ステータスチェックのタイプ | 設定 | マージの要件 | 留意点 | -| --------------- | --------------------------------------------------------------------------- | ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | -| **Strict** | [**Require branches to be up-to-date before merging**] チェックボックスにチェックする | マージ前、ブランチは、base ブランチとの関係で**最新でなければならない**。 | これは、必須ステータスチェックのデフォルト動作です。 他のコラボレーターが、保護された base ブランチにプルリクエストをマージした後に、あなたは head ブランチをアップデートする必要が出てくる可能性があるため、追加のビルドが必要になるかもしれません。 | -| **Loose** | [**Require branches to be up-to-date before merging**] チェックボックスにチェック**しない** | マージ前、ブランチは base ブランチとの関係で**最新でなくてもよい**。 | 他のコラボレーターがプルリクエストをマージした後に head ブランチをアップデートする必要はないことから、必要となるビルドは少なくなります。 base ブランチと競合する変更がある場合、ブランチをマージした後のステータスチェックは失敗する可能性があります。 | -| **無効** | [**Require status checks to pass before merging**] チェックボックスにチェック**しない** | ブランチのマージについての制限はない | 必須ステータスチェックが有効化されていない場合、base ブランチにあわせてアップデートされているかどうかに関わらず、コラボレーターはいつでもブランチをマージできます。 このことで、変更の競合が発生する可能性が高まります。 | - -### 必須ステータスチェックを有効にする - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -{% data reusables.repositories.repository-branches %} -{% data reusables.repositories.add-branch-protection-rules %} -5. [**Require status checks to pass before merging**] を選択します。 ![必須ステータスチェックのオプション](/assets/images/help/repository/required-status-checks.png) -6. 使用可能なステータスチェックのリストから、必須としたいものを選択します。 ![利用可能なステータスチェックの一覧](/assets/images/help/repository/required-statuses-list.png) -{% data reusables.repositories.include-administrators %} -8. オプションとして、[**Require branches to be up to date before merging**] の選択を解除します。 選択すると、ベースブランチ上でブランチが最新のコードでテストされるようにできます。 ![必須ステータスのチェックボックス、ゆるい、または厳格な](/assets/images/help/repository/protecting-branch-loose-status-new.png) -9. 必要に応じて、 {% if currentVersion ver_gt "enterprise-server@2.18" %}**Restrict who can push to matching branches（マッチするブランチにプッシュできるユーザーを制限する）**{% else %}**Restrict who can push to this branch（このブランチにプッシュできるユーザーを制限する）**{% endif %}を選択してください。 ![Branch restriction checkbox]{% if currentVersion ver_gt "enterprise-server@2.18" %}(/assets/images/help/repository/restrict-branch.png){% else %}(/assets/images/help/repository/restrict-branch-push.png){% endif %} -10. 保護されたブランチにプッシュできる権限を持つ人{% if currentVersion ver_gt "enterprise-server@2.18" %}、{% else %}または{% endif %}チーム{% if currentVersion ver_gt "enterprise-server@2.18" %}、またはアプリ{% endif %}を検索し、選択します。 ![ブランチ制限の検索](/assets/images/help/repository/restrict-branch-search.png) -11. **Create（作成）**をクリックしてください。 - -{% data reusables.repositories.required-status-merge-tip %} diff --git a/translations/ja-JP/content/admin/developer-workflow/continuous-integration-using-jenkins.md b/translations/ja-JP/content/admin/developer-workflow/continuous-integration-using-jenkins.md deleted file mode 100644 index a21f861126e8..000000000000 --- a/translations/ja-JP/content/admin/developer-workflow/continuous-integration-using-jenkins.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: Jenkinsを使った継続的インテグレーション -intro: '{% data variables.product.product_location_enterprise %} のリポジトリにプッシュがあったときに、自動的に Jenkins サーバーのビルドジョブを実行させることができます。' -redirect_from: - - /enterprise/admin/developer-workflow/continuous-integration-using-jenkins -versions: - enterprise-server: '*' ---- - -### 要件 - -- {% data variables.product.product_location_enterprise %} のリポジトリにプッシュが行われた際に、Jenkins サーバーのビルドジョブを自動的に起動するためのステップバイステップの手順については、弊社のホワイトペーパー「[Practical guide to CI with Jenkins and GitHub](https://resources.github.com/whitepapers/practical-guide-to-CI-with-Jenkins-and-GitHub/)」をご覧ください。 diff --git a/translations/ja-JP/content/admin/developer-workflow/creating-a-pre-receive-hook-environment.md b/translations/ja-JP/content/admin/developer-workflow/creating-a-pre-receive-hook-environment.md deleted file mode 100644 index 7cce9e2ffd92..000000000000 --- a/translations/ja-JP/content/admin/developer-workflow/creating-a-pre-receive-hook-environment.md +++ /dev/null @@ -1,92 +0,0 @@ ---- -title: pre-receiveフック環境の作成 -intro: pre-receiveフックを実行するには、デフォルトのpre-receive環境を使うか、カスタムの環境を作成します。 -redirect_from: - - /enterprise/admin/developer-workflow/creating-a-pre-receive-hook-environment -versions: - enterprise-server: '*' ---- - -{% data variables.product.prodname_ghe_server %} の pre-receive 環境は、Linux の [`chroot`](https://en.wikipedia.org/wiki/Chroot) 環境です。 pre-receiveフックはプッシュのイベントごとに実行されるので、高速かつ軽量でなければなりません。 こうしたチェックに必要となる環境は、通常最小限のものです。 - -{% data variables.product.prodname_ghe_server %} は、以下のパッケージを含むデフォルトの環境を提供します: `awk`、 `bash`、`coreutils`、`curl`、`find`、`gnupg`、`grep`、`jq`、`sed` - -特定の言語のサポートなど、この環境が満たさない特定の要求があるなら、独自の64-bit Linux `chroot`環境を作成してアップロードできます。 - -### Dockerを利用したpre-receiveフック環境の作成 - -pre-receiveフック環境の構築には、Linuxのコンテナ管理ツールが利用できます。 この例では[Alpine Linux](http://www.alpinelinux.org/)と[Docker](https://www.docker.com/)を使っています。 - -{% data reusables.linux.ensure-docker %} -2. この情報を含む `Dockerfile.alpine-3.3` ファイルを作成してください: - - ``` - FROM gliderlabs/alpine:3.3 - RUN apk add --no-cache git bash - ``` -3. `Dockerfile.alpine-3.3`を含むワーキングディレクトリから、イメージをビルドします: - - ```shell - $ docker build -f Dockerfile.alpine-3.3 -t pre-receive.alpine-3.3 . - > Sending build context to Docker daemon 12.29 kB - > Step 1 : FROM gliderlabs/alpine:3.3 - > ---> 8944964f99f4 - > Step 2 : RUN apk add --no-cache git bash - > ---> Using cache - > ---> 0250ab3be9c5 - > Successfully built 0250ab3be9c5 - ``` -4. コンテナを作成します: - - ```shell - $ docker create --name pre-receive.alpine-3.3 pre-receive.alpine-3.3 /bin/true - ``` -5. この Docker コンテナを `gzip` 圧縮された `tar` ファイルにエクスポートします: - - ```shell - $ docker export pre-receive.alpine-3.3 | gzip > alpine-3.3.tar.gz - ``` - - このファイル `alpine-3.3.tar.gz` を {% data variables.product.prodname_ghe_server %} アプライアンスにアップロードする準備ができました。 - -### chrootを使ったpre-receiveフック環境の作成 - -1. Linux の `chroot` 環境を作成します。 -2. `chroot` ディレクトリの `gzip` 圧縮された `tar` ファイルを作成します. - ```shell - $ cd /path/to/chroot - $ tar -czf /path/to/pre-receive-environment.tar.gz . - ``` - - {% note %} - - **注釈:** - - `/path/to/chroot`のような、ファイルの先行するディレクトリパスをtarアーカイブに含めないでください。 - - chroot環境へのエントリポイントとして、`/bin/sh`が存在し、実行可能でなければなりません。 - - 旧来のchrootと異なり、`dev`ディレクトリはpre-receiveフックのためのchroot環境では必要ありません。 - - {% endnote %} - -chroot 環境の作成に関する詳しい情報については *Debian Wiki* の「[Chroot](https://wiki.debian.org/chroot)」、*Ubuntu Community Help Wiki* の「[BasicChroot](https://help.ubuntu.com/community/BasicChroot)」、または *Alpine Linux Wiki* の「[Installing Alpine Linux in a chroot](http://wiki.alpinelinux.org/wiki/Installing_Alpine_Linux_in_a_chroot)」を参照してください。 - -### {% data variables.product.prodname_ghe_server %}へのpre-receiveフック環境のアップロード - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.hooks-tab %} -5. [**Manage environments**] (環境を管理) をクリックします。 ![環境を管理](/assets/images/enterprise/site-admin-settings/manage-pre-receive-environments.png) -6. [**Add environment**] (環境を追加) をクリックします。 ![環境を追加](/assets/images/enterprise/site-admin-settings/add-pre-receive-environment.png) -7. 希望する名前を [**Environment name**] (環境名) フィールドに入力します。 ![環境名](/assets/images/enterprise/site-admin-settings/pre-receive-environment-name.png) -8. 環境が入っている `*.tar.gz` ファイルの URL を入力します。 ![URL から環境をアップロード](/assets/images/enterprise/site-admin-settings/upload-environment-from-url.png) -9. [**Add environment**] (環境を追加) をクリックします。 ![環境を追加するボタン](/assets/images/enterprise/site-admin-settings/add-environment-button.png) - -### 管理シェル経由でのpre-receiveフック環境のアップロード -1. 環境が入っている読み出し可能な `*.tar.gz` ファイルを Web のホストにアップロードしてその URL をコピーするか、このファイルを `scp` で {% data variables.product.prodname_ghe_server %} アプライアンスに転送してください。 `scp` を使う場合には、`*.tar.gz` ファイルの権限を外界から読めるように調整しなければならないかもしれません。 -1. 管理シェルに接続します。 -2. `ghe-hook-env-create` コマンドを使い、環境に与えたい名前を最初の引数に、環境が入っている `*.tar.gz` ファイルの完全なローカルパスあるいは URL を 2 番目の引数に入力してください。 - - ```shell - admin@ghe-host:~$ ghe-hook-env-create AlpineTestEnv /home/admin/alpine-3.3.tar.gz - > Pre-receive hook environment 'AlpineTestEnv' (2) has been created. - ``` diff --git a/translations/ja-JP/content/admin/developer-workflow/creating-a-pre-receive-hook-script.md b/translations/ja-JP/content/admin/developer-workflow/creating-a-pre-receive-hook-script.md deleted file mode 100644 index 648e5fd0aab4..000000000000 --- a/translations/ja-JP/content/admin/developer-workflow/creating-a-pre-receive-hook-script.md +++ /dev/null @@ -1,199 +0,0 @@ ---- -title: pre-receiveフックスクリプトの作成 -intro: pre-receiveフックスクリプトを使って、プッシュを内容に基づいて受け付けあるいは拒否するための要件を作成します。 -redirect_from: - - /enterprise/admin/developer-workflow/creating-a-pre-receive-hook-script -versions: - enterprise-server: '*' ---- - -{% data variables.product.prodname_ghe_server %} の pre-receive フックの例は、[`github/platform-samples`リポジトリ](https://github.com/github/platform-samples/tree/master/pre-receive-hooks)で見ることができます。 - -### pre-receiveフックスクリプトの作成 -pre-receive フックスクリプトは、{% data variables.product.prodname_ghe_server %} アプライアンス上の pre-receive フック環境内で実行されます。 pre-receiveフックスクリプトを作成する際には、利用可能な入力、出力、終了ステータス、環境変数について考慮してください。 - -#### 入力（stdin） -プッシュが行われ、リモートリポジトリ上でrefがあった場合に、それらが更新される前、 `git-receive-pack`プロセスは更新されるrefごとに1行の標準入力を渡してpre-receiveフックスクリプトを呼び出します。 - -` SP SP LF` - -この文字列は以下の引数を表現しています。 - -| 引数 | 説明 | -|:------------------- |:------------------------------------------------------------ | -| `` | `ref`に保存されている古いオブジェクトネーム。
    新しい`ref`を*作成*した場合、これは40個のゼロになる。 | -| `` | `ref`に保存される新しいオブジェクトネーム。
    `ref`を*削除*した場合、これは40個のゼロになる。 | -| `` | `ref`の完全な名前。 | - -`git-receive-pack`に関する詳しい情報については、Gitのドキュメンテーション中の[git-receive-pack](https://git-scm.com/docs/git-receive-pack)を参照してください。 `refs`に関する詳しい情報については、*Pro Git*の[Git References](https://git-scm.com/book/en/v2/Git-Internals-Git-References)を参照してください。 - -#### 出力（stdout） - -スクリプトの出力（`stdout`）はクライアントに返されるので、`echo`文があればその出力はコマンドライン上あるいはユーザインターフェースからユーザに見えることになります。 - -#### 終了ステータス - -pre-receiveスクリプトの`終了ステータス`は、プッシュが受け付けられるかどうかを決めます。 - -| 終了ステータスの値 | Action | -|:---------:|:--------------:| -| 0 | プッシュは受け付けられます。 | -| 0以外 | プッシュは拒否されます。 | - -#### 環境変数 -`stdin` に渡された値以外に、{% data variables.product.prodname_ghe_server %} 上で動作する pre-receive フックスクリプトから利用できる追加の変数があります。 - -| 変数 | 説明 | -|:------------------------------------- |:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| $GITHUB_USER_LOGIN | `ref` を作成したユーザ ID | -| $GIT_DIR | アプライアンス上のリモートリポジトリのパス。 | -| $GITHUB_USER_IP | プッシュを行ったユーザの IP アドレス。 | -| $GITHUB_REPO_NAME | `owner`/`repo` フォーマットでの更新されるリポジトリの名前。 | -| $GITHUB_PULL_REQUEST_AUTHOR_LOGIN | インスタンス上でオープンされたプルリクエストの作者のユーザ ID。 | -| $GITHUB_REPO_PUBLIC | 論理値で、`true` ならパブリックリポジトリを、`false` ならプライベートリポジトリを示す。 | -| $GITHUB_PUBLIC_KEY_FINGERPRINT | ユーザの公開鍵のフィンガープリント。 | -| $GITHUB_PULL_REQUEST_HEAD | PR の HEAD に対する `user:branch` という形式の文字列。
    例: `octocat:fix-bug` | -| $GITHUB_PULL_REQUEST_BASE | PR の BASE に対する `user:branch` という形式の文字列。
    例: `octocat:master` | -| $GITHUB_VIA | ref の作成に使われた方式。
    **取り得る値: **
    - `auto-merge deployment api`
    - `blob edit`
    - `branch merge api`
    - `branches page delete button`
    - `git refs create api`
    - `git refs delete api`
    - `git refs update api`
    - `merge api`
    - `pull request branch delete button`
    - `pull request branch undo button`
    - `pull request merge api`
    - `pull request merge button`
    - `pull request revert button`
    - `releases delete button`
    - `stafftools branch restore`
    - `slumlord (#{sha})` | -| $GIT_PUSH_OPTION_COUNT | クライアントによって送信されたプッシュオプション数。 プッシュオプションに関する詳しい情報については、Gitのドキュメンテーションの[git-push](https://git-scm.com/docs/git-push#git-push---push-optionltoptiongt)を参照してください。 | -| $GIT_PUSH_OPTION_N | ここで N は 0 から始まる整数で、この変数にはクライアントから送信されたプッシュオプションの文字列が含まれます。 送信された最初のオプションはGIT_PUSH_OPTION_0に保存され、2番目のオプションはGIT_PUSH_OPTION_1に保存され、といったようになります。 プッシュオプションに関する詳しい情報については、Gitのドキュメンテーションの[git-push](https://git-scm.com/docs/git-push#git-push---push-optionltoptiongt)を参照してください。 | - -### 権限の設定と {% data variables.product.prodname_ghe_server %} への pre-receive フックのプッシュ - -pre-receive フックスクリプトは、{% data variables.product.prodname_ghe_server %} アプライアンス上のリポジトリに含まれます。 サイト管理者はリポジトリの権限を考慮し、適切なユーザだけがアクセスできるようにしなければなりません。 - -フックは単一のリポジトリに集約することをおすすめします。 集約されたフックのリポジトリがパブリックになっている場合、`README.md`をポリシーの強制の説明に利用できます。 また、コントリビューションをプルリクエスト経由で受け付けることもできます。 しかし、pre-receiveフックはデフォルトブランチからのみ追加できます。 テストのワークフロー用には、設定を持つリポジトリのフォークを使うべきです。 - -1. Mac ユーザは、スクリプトに実行権限を持たせてください。 - - ```shell - $ sudo chmod +x SCRIPT_FILE.sh - ``` - Windows ユーザは、スクリプトに実行権限を持たせてください。 - - ```shell - git update-index --chmod=+x SCRIPT_FILE.sh - ``` - -2. {% data variables.product.prodname_ghe_server %} インスタンス上の対象となる pre-receive フックのリポジトリにコミットおよびプッシュしてください。 - - ```shell - $ git commit -m "YOUR COMMIT MESSAGE" - $ git push - ``` - -3. {% data variables.product.prodname_ghe_server %} のインスタンス上で [pre-receive フックを作成](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-appliance/#creating-pre-receive-hooks)してください。 - -### ローカルでのpre-receiveスクリプトのテスト -pre-receive フックスクリプトは、{% data variables.product.prodname_ghe_server %} アプライアンス上で作成したり更新したりする前に、ローカルでテストできます。 その方法の 1 つは、pre-receive フックを実行できるリモートリポジトリとして働くローカルの Docker 環境を作成することです。 - -{% data reusables.linux.ensure-docker %} - -2. 以下を含む `Dockerfile.dev` というファイルを作成してください。 - - ``` - FROM gliderlabs/alpine:3.3 - RUN \ - apk add --no-cache git openssh bash && \ - ssh-keygen -A && \ - sed -i "s/#AuthorizedKeysFile/AuthorizedKeysFile/g" /etc/ssh/sshd_config && \ - adduser git -D -G root -h /home/git -s /bin/bash && \ - passwd -d git && \ - su git -c "mkdir /home/git/.ssh && \ - ssh-keygen -t rsa -b 4096 -f /home/git/.ssh/id_rsa -P '' && \ - mv /home/git/.ssh/id_rsa.pub /home/git/.ssh/authorized_keys && \ - mkdir /home/git/test.git && \ - git --bare init /home/git/test.git" - - VOLUME ["/home/git/.ssh", "/home/git/test.git/hooks"] - WORKDIR /home/git - - CMD ["/usr/sbin/sshd", "-D"] - ``` - -3. `always_reject.sh` というテストのpre-receiveスクリプトを作成してください。 このスクリプト例では、全てのプッシュを拒否します。これは、リポジトリをロックする場合に役立ちます。 - - ``` - #!/usr/bin/env bash - - echo "error: rejecting all pushes" - exit 1 - ``` - -4. `always_reject.sh`スクリプトが実行権限を持つことを確認してください。 - - ```shell - $ chmod +x always_reject.sh - ``` - -5. `Dockerfile.dev` を含むディレクトリからイメージをビルドしてください。 - - ```shell - $ docker build -f Dockerfile.dev -t pre-receive.dev . - > Sending build context to Docker daemon 3.584 kB - > Step 1 : FROM gliderlabs/alpine:3.3 - > ---> 8944964f99f4 - > Step 2 : RUN apk add --no-cache git openssh bash && ssh-keygen -A && sed -i "s/#AuthorizedKeysFile/AuthorizedKeysFile/g" /etc/ssh/sshd_config && adduser git -D -G root -h /home/git -s /bin/bash && passwd -d git && su git -c "mkdir /home/git/.ssh && ssh-keygen -t rsa -b 4096 -f /home/git/.ssh/id_rsa -P ' && mv /home/git/.ssh/id_rsa.pub /home/git/.ssh/authorized_keys && mkdir /home/git/test.git && git --bare init /home/git/test.git" - > ---> Running in e9d79ab3b92c - > fetch http://alpine.gliderlabs.com/alpine/v3.3/main/x86_64/APKINDEX.tar.gz - > fetch http://alpine.gliderlabs.com/alpine/v3.3/community/x86_64/APKINDEX.tar.gz - ....truncated output.... - > OK: 34 MiB in 26 packages - > ssh-keygen: generating new host keys: RSA DSA ECDSA ED25519 - > Password for git changed by root - > Generating public/private rsa key pair. - > Your identification has been saved in /home/git/.ssh/id_rsa. - > Your public key has been saved in /home/git/.ssh/id_rsa.pub. - ....出力を省略.... - > Initialized empty Git repository in /home/git/test.git/ - > Successfully built dd8610c24f82 - ``` - -6. 生成された SSH キーを含むデータコンテナを実行してください。 - - ```shell - $ docker run --name data pre-receive.dev /bin/true - ``` - -7. テスト pre-receive フックの `always_reject.sh` をデータコンテナにコピーしてください: - - ```shell - $ docker cp always_reject.sh data:/home/git/test.git/hooks/pre-receive - ``` - -8. `sshd` を実行しフックを動作させるアプリケーションコンテナを実行してください。 返されたコンテナ ID をメモしておいてください: - - ```shell - $ docker run -d -p 52311:22 --volumes-from data pre-receive.dev - > 7f888bc700b8d23405dbcaf039e6c71d486793cad7d8ae4dd184f4a47000bc58 - ``` - -9. 生成された SSH キーをデータコンテナからローカルマシンにコピーしてください: - - ```shell - $ docker cp data:/home/git/.ssh/id_rsa . - ``` - -10. テストリポジトリのリモートを修正して、Docker コンテナ内の `test.git` リポジトリにプッシュしてください。 この例では `git@github.com:octocat/Hello-World.git` を使っていますが、どのリポジトリを使ってもかまいません。 この例ではローカルマシン (127.0.0.1) がポート 52311 をバインドしているものとしていますが、docker がリモートマシンで動作しているなら異なる IP アドレスを使うことができます。 - - ```shell - $ git clone git@github.com:octocat/Hello-World.git - $ cd Hello-World - $ git remote add test git@127.0.0.1:test.git - $ GIT_SSH_COMMAND="ssh -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no -p 52311 -i ../id_rsa" git push -u test master - > Warning: Permanently added '[192.168.99.100]:52311' (ECDSA) to the list of known hosts. - > Counting objects: 7, done. - > Delta compression using up to 4 threads. - > Compressing objects: 100% (3/3), done. - > Writing objects: 100% (7/7), 700 bytes | 0 bytes/s, done. - > Total 7 (delta 0), reused 7 (delta 0) - > remote: error: rejecting all pushes - > To git@192.168.99.100:test.git - > ! [remote rejected] master -> master (pre-receive hook declined) - > error: failed to push some refs to 'git@192.168.99.100:test.git' - ``` - - pre-receive フックの実行後にプッシュが拒否され、スクリプトからの出力がエコーされていることに注意してください。 - -### 参考リンク - - *Pro Git Webサイト*の「[Gitのカスタマイズ - Gitポリシーの実施例](https://git-scm.com/book/en/v2/Customizing-Git-An-Example-Git-Enforced-Policy)」 diff --git a/translations/ja-JP/content/admin/developer-workflow/customizing-your-instance-with-integrations.md b/translations/ja-JP/content/admin/developer-workflow/customizing-your-instance-with-integrations.md deleted file mode 100644 index b116ae04fcd7..000000000000 --- a/translations/ja-JP/content/admin/developer-workflow/customizing-your-instance-with-integrations.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: インテグレーションでインスタンスをカスタマイズする -intro: '{% data variables.product.product_location_enterprise %} とサードパーティのアプリケーションをインテグレーションできます。' -mapTopic: true -redirect_from: - - /enterprise/admin/developer-workflow/customizing-your-instance-with-integrations -versions: - enterprise-server: '*' ---- - diff --git a/translations/ja-JP/content/admin/developer-workflow/establishing-pull-request-merge-conditions.md b/translations/ja-JP/content/admin/developer-workflow/establishing-pull-request-merge-conditions.md deleted file mode 100644 index 2a569cd0896e..000000000000 --- a/translations/ja-JP/content/admin/developer-workflow/establishing-pull-request-merge-conditions.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: プルリクエストのマージ条件の確立 -intro: プルリクエストをマージ可能にするための条件として、一連のチェックに合格することを必須とすることができます。 たとえばステータスチェックをパスしないプルリクエストをブロックできます。 -mapTopic: true -redirect_from: - - /enterprise/admin/developer-workflow/establishing-pull-request-merge-conditions -versions: - enterprise-server: '*' ---- - diff --git a/translations/ja-JP/content/admin/developer-workflow/index.md b/translations/ja-JP/content/admin/developer-workflow/index.md deleted file mode 100644 index c1c102f6edfc..000000000000 --- a/translations/ja-JP/content/admin/developer-workflow/index.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: ポリシー の施行と開発者ワークフローのカスタマイズ -redirect_from: - - /enterprise/admin/guides/installation/integrations/ - - /enterprise/admin/categories/integration/ - - /enterprise/admin/developer-workflow -intro: 'このガイドは、開発者ワークフローを実装し、リスクを引き下げ品質を高めるための組織的なポリシーを強制するために、{% data variables.product.prodname_enterprise %} で利用できるツールについて述べます。' -versions: - enterprise-server: '*' ---- - - -### 目次 - -{% topic_link_in_list /blocking-force-pushes %} - {% link_in_list /blocking-force-pushes-on-your-appliance %} - {% link_in_list /blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization %} - {% link_in_list /blocking-force-pushes-to-a-repository %} -{% topic_link_in_list /using-webhooks-for-continuous-integration %} - {% link_in_list /continuous-integration-using-jenkins %} - {% link_in_list /troubleshooting-service-hooks %} -{% topic_link_in_list /using-pre-receive-hooks-to-enforce-policy %} - {% link_in_list /about-pre-receive-hooks %} - {% link_in_list /creating-a-pre-receive-hook-environment %} - {% link_in_list /creating-a-pre-receive-hook-script %} - {% link_in_list /managing-pre-receive-hooks-on-the-github-enterprise-server-appliance %} -{% topic_link_in_list /establishing-pull-request-merge-conditions %} - {% link_in_list /about-protected-branches-and-required-status-checks %} - {% link_in_list /configuring-protected-branches-and-required-status-checks %} -{% topic_link_in_list /customizing-your-instance-with-integrations %} - {% link_in_list /managing-projects-using-jira %} diff --git a/translations/ja-JP/content/admin/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance.md b/translations/ja-JP/content/admin/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance.md deleted file mode 100644 index c9b55ffb48b7..000000000000 --- a/translations/ja-JP/content/admin/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance.md +++ /dev/null @@ -1,59 +0,0 @@ ---- -title: GitHub Enterprise Server アプライアンスで pre-receive フックを管理する -intro: 'pre-receive フックの {% data variables.product.prodname_ghe_server %} アプライアンス内での利用方法を設定する' -redirect_from: - - /enterprise/admin/guides/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-appliance/ - - /enterprise/admin/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance -versions: - enterprise-server: '*' ---- - -### pre-receiveフックの作成 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.hooks-tab %} -4. **Add pre-receive hook（pre-receiveフックの追加）**をクリックしてください。 ![pre-receive フックを追加する](/assets/images/enterprise/site-admin-settings/add-pre-receive-hook.png) -5. **Hook name（フック名）**フィールドに、作成したいフックの名前を入力してください。 ![pre-receive フックに名前を付ける](/assets/images/enterprise/site-admin-settings/hook-name.png) -6. **Environment（環境）**ドロップダウンメニューから、フックを動作させたい環境を選択してください。 ![フックの環境](/assets/images/enterprise/site-admin-settings/environment.png) -7. [**Script**] の下で、[**Select hook repository**]ドロップダウンメニューから、pre-receive フックスクリプトを含むリポジトリを選択してください。 **Select file（ファイルの選択）**ドロップダウンメニューから、pre-receiveフックスクリプトのファイル名を選択してください。 ![フックスクリプト](/assets/images/enterprise/site-admin-settings/hook-script.png) -8. スクリプトを強制するには**Use the exit-status to accept or reject pushes（プッシュを受け入れるか拒否するかを終了ステータスで決める）**を選択してください。 このオプションの選択を外すと、終了ステータスの値が無視され、スクリプトをテストできるようになります。 このモードでは、スクリプトの出力はコマンドラインでユーザに見えますが、Web インターフェースには表示されません。 ![exit-status の利用](/assets/images/enterprise/site-admin-settings/use-exit-status.png) -9. pre-receiveフックをすべてのリポジトリで実行したい場合は、**Enable this pre-receive hook on all repositories by default（デフォルトで全リポジトリ上でこのpre-receiveフックを有効化する）**を選択してください。 ![すべてのリポジトリでフックを有効化](/assets/images/enterprise/site-admin-settings/enable-hook-all-repos.png) -10. 管理者もしくはオーナー権限を持つOrganizationのメンバーがこのpre-receiveフックを有効化あるいは無効化できるようにしたい場合には、**Administrators can enable and disable this hook（管理者がこのフックを有効化及び無効化できるようにする）**を選択してください。 ![管理者によるフックの有効化もしくは無効化](/assets/images/enterprise/site-admin-settings/admins-enable-hook.png) - -### pre-receiveフックの編集 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.hooks-tab %} -1. 編集したい pre-receive フックの隣の {% octicon "pencil" aria-label="The edit icon" %} をクリックします。 ![pre-receiveの編集](/assets/images/enterprise/site-admin-settings/edit-pre-receive-hook.png) - -### pre-receiveフックの削除 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.hooks-tab %} -2. 削除したい pre-receive フックの隣の {% octicon "x" aria-label="X symbol" %} をクリックします。 ![pre-receiveの編集](/assets/images/enterprise/site-admin-settings/delete-pre-receive-hook.png) - -### Organizationのためのpre-receiveフックの設定 - -Organizationの管理者がOrganizationのフックの権限を設定できるのは、サイト管理者がpre-receiveフックの作成時に**Administrators can enable or disable this hook（管理者がこのフックを有効化及び無効化できるようにする）**オプションを選択している場合のみです。 リポジトリのpre-receiveフックを設定するには、Organizationの管理者もしくはオーナーでなければなりません。 - -{% data reusables.profile.enterprise_access_profile %} -{% data reusables.profile.access_org %} -{% data reusables.organizations.org_settings %} -4. 左のサイトバーで**Hooks（フック）**をクリックしてください。 ![フックサイドバー](/assets/images/enterprise/orgs-and-teams/hooks-sidebar.png) -5. 設定したいpre-receiveフックの隣の**Hook permissions（フックの権限）**ドロップダウンメニューをクリックしてください。 pre-receiveフックの有効化もしくは無効化を選択するか、リポジトリ管理者による設定を許可してください。 ![フックの権限](/assets/images/enterprise/orgs-and-teams/hook-permissions.png) - -### リポジトリのためのpre-receiveフックの設定 - -サイト管理者がpre-receiveフックの作成時に**Administrators can enable or disable this hook（管理者がこのフックを有効化及び無効化できるようにする）**オプションを選択している場合にのみ、リポジトリのオーナーがフックを設定できます。 Organizationで、Organizationのオーナーは**Configurable（設定可能）** フック権限を選択している必要もあります。 リポジトリのpre-receiveフックを設定するには、リポジトリのオーナーでなければなりません。 - -{% data reusables.profile.enterprise_access_profile %} -2. **Repositories（リポジトリ）**をクリックし、pre-receiveフックを設定したいリポジトリを選択してください。 ![リポジトリ](/assets/images/enterprise/repos/repositories.png) -{% data reusables.repositories.sidebar-settings %} -4. 左のサイドバーで、**Hooks & Services（フックとサービス）**をクリックしてください。 ![フックとサービス](/assets/images/enterprise/repos/hooks-services.png) -5. 設定したいpre-receiveフックの隣の**Hook permissions（フックの権限）**ドロップダウンメニューをクリックしてください。 pre-receiveフックを有効化するか無効化するかを選択してください。 ![リポジトリのフックの権限](/assets/images/enterprise/repos/repo-hook-permissions.png) diff --git a/translations/ja-JP/content/admin/developer-workflow/managing-projects-using-jira.md b/translations/ja-JP/content/admin/developer-workflow/managing-projects-using-jira.md deleted file mode 100644 index a62ba4fae67e..000000000000 --- a/translations/ja-JP/content/admin/developer-workflow/managing-projects-using-jira.md +++ /dev/null @@ -1,55 +0,0 @@ ---- -title: JIRA を使用してプロジェクトを管理する -intro: 'プロジェクト管理用に {% data variables.product.prodname_enterprise %}に JIRA を統合することができます。' -redirect_from: - - /enterprise/admin/guides/installation/project-management-using-jira/ - - /enterprise/admin/articles/project-management-using-jira/ - - /enterprise/admin/developer-workflow/managing-projects-using-jira -versions: - enterprise-server: '*' ---- - -### {% data variables.product.prodname_enterprise %}のOrganizationへの JIRA の繋ぎ方 - -1. http[s]://[hostname]/login で {% data variables.product.prodname_enterprise %}のアカウントにサインインする。 -1. ページ右上にあるアカウント設定のアイコン（歯車）をクリックする。 -1. 左のサイドバーで、あなたのOrganizationの名前をクリックする。 -1. 左のサイドバーで、**Applications** をクリックする。 -1. **Organization applications** のボックスの右上隅にある、**Register new application** をクリックする。 -1. アプリケーションの設定を次のように記入する。 - - **Application name** の欄に "JIRA" と入力する。 - - **Homepage URL** の欄には、JIRA インスタンスの全 URL を入力する。 - - **Authorization callback URL** の欄には、JIRAインスタンスの全URLを入力する。 -1. **Register application** をクリックする。 -1. ページの上部の [**Client ID**] と [**Client Secret**] をメモしてください。 これらは JIRA のインスタンスの設定に必要です。 - -### {% data variables.product.prodname_enterprise %}の個人アカウントへの JIRA の繋ぎ方 - -1. http[s]://[hostname]/login で {% data variables.product.prodname_enterprise %}のアカウントにサインインする。 -1. ページ右上にあるアカウント設定のアイコン（歯車）をクリックする。 -1. 左のサイドバーで、**Applications** をクリックする。 -1. **Developer applications** のボックスの右上隅にある、**Register new application** をクリックする。 -1. アプリケーションの設定を次のように記入する。 - - **Application name** の欄に "JIRA" と入力する。 - - **Homepage URL** の欄には、JIRA インスタンスの全 URL を入力する。 - - **Authorization callback URL** の欄には、JIRAインスタンスの全URLを入力する。 -1. **Register application** をクリックする。 -1. ページの上部の [**Client ID**] と [**Client Secret**] をメモしてください。 これらは JIRA のインスタンスの設定に必要です。 - -### JIRA インスタンス を設定 - -1. JIRA インスタンス で、管理人権限でアカウントにログインする。 -1. ページ上部の、設定アイコン（歯車）をクリックする。 -1. 設定のドロップダウンで、**Add-ons** を選択する。 -1. 左のサイドバーにある**Source control** で、**DVCS accounts** をクリックする。 -1. **Link Bitbucket or GitHub account** をクリックする。 -1. [**Add New Account**] (新規アカウントを追加) モーダルで、{% data variables.product.prodname_enterprise %} の設定を記入してください。 - - **Host** のドロップダウンメニューで、**GitHub Enterprise** を選択する。 - - **Team or User Account** の欄には、{% data variables.product.prodname_enterprise %}のOrganization、または個人アカウントの名前を入力する。 - - **OAuth Key** の欄には、{% data variables.product.prodname_enterprise %}のディベロッパーアプリケーションのClient ID を入力する。 - - **OAuth Secret** の欄には、{% data variables.product.prodname_enterprise %}のデベロッパーアプリケーションの Client Secret を入力する。 - - {% data variables.product.prodname_enterprise %}の Organization、または個人アカウントが所有している新規リポジトリをリンクしたくない場合は、**Auto Link New Repositories** の選択を解除する。 - - スマートコミットを有効にしたくない場合は、**Enable Smart Commits** の選択を解除する。 - - **Add** をクリックする。 -1. {% data variables.product.prodname_enterprise %}に対して与えるアクセス権を確認して、**Authorize application** をクリックする。 -1. 必要であれば、パスワードを入力する。 diff --git a/translations/ja-JP/content/admin/developer-workflow/troubleshooting-service-hooks.md b/translations/ja-JP/content/admin/developer-workflow/troubleshooting-service-hooks.md deleted file mode 100644 index 35b818806232..000000000000 --- a/translations/ja-JP/content/admin/developer-workflow/troubleshooting-service-hooks.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: サービスフックのトラブルシューティング -intro: ペイロードが配信されない場合、以下の一般的な問題をチェックしてください。 -redirect_from: - - /enterprise/admin/articles/troubleshooting-service-hooks/ - - /enterprise/admin/developer-workflow/troubleshooting-service-hooks -versions: - enterprise-server: '*' ---- - -### デリバリーについての情報を入手 - -任意のリポジトリのすべてのサービスフックのデリバリに対する最後のレスポンスに関する情報を調べることができます。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -2. 調べるリポジトリを開ける。 -3. ナビゲーションサイドバーで **Hooks** のリンクをクリックする。 ![フックのサイドバー](/assets/images/enterprise/settings/Enterprise-Hooks-Sidebar.png) -4. 問題が発生しているサービスフックで、**Latest Delivery** へのリンクをクリックする。 ![フックの詳細](/assets/images/enterprise/settings/Enterprise-Hooks-Details.png) -5. [**Remote Calls**] (リモート呼び出し) の下に、リモートサーバーへの POST の際に使われたヘッダと、リモートサーバーがあなたの環境に返信したレスポンスを見ることができます。 - -### ペイロードの表示 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -2. 調べるリポジトリを開ける。 -3. ナビゲーションサイドバーで **Hooks** のリンクをクリックする。 ![フックのサイドバー](/assets/images/enterprise/settings/Enterprise-Hooks-Sidebar.png) -4. 問題が発生しているサービスフックで、**Latest Delivery** へのリンクをクリックする。 -5. [**Delivery**] をクリックします。 ![ペイロードの表示](/assets/images/enterprise/settings/Enterprise-Hooks-Payload.png) - -### 過去のデリバリーの表示 - -デリバリーは 15 日間保存されます。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -2. 調べるリポジトリを開ける。 -3. ナビゲーションサイドバーで **Hooks** のリンクをクリックする。 ![フックのサイドバー](/assets/images/enterprise/settings/Enterprise-Hooks-Sidebar.png) -4. 問題が発生しているサービスフックで、**Latest Delivery** へのリンクをクリックする。 -5. その特定のフックに対する他のデリバリーを見るには、[**More for this Hook ID**] をクリックします。 ![デリバリーをさらに表示](/assets/images/enterprise/settings/Enterprise-Hooks-More-Deliveries.png) diff --git a/translations/ja-JP/content/admin/developer-workflow/using-pre-receive-hooks-to-enforce-policy.md b/translations/ja-JP/content/admin/developer-workflow/using-pre-receive-hooks-to-enforce-policy.md deleted file mode 100644 index db8e0d9a6712..000000000000 --- a/translations/ja-JP/content/admin/developer-workflow/using-pre-receive-hooks-to-enforce-policy.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: pre-receiveフックを使ったポリシーの強制 -intro: pre-receiveフックを使ってOrganization内のワークフローの標準を強制します。 pre-receiveフックは、プッシュがリポジトリに受け付けられる前に、事前に定義された一連の品質チェックをコードがパスすることを求めます。 -mapTopic: true -redirect_from: - - /enterprise/admin/developer-workflow/using-pre-receive-hooks-to-enforce-policy -versions: - enterprise-server: '*' ---- - diff --git a/translations/ja-JP/content/admin/developer-workflow/using-webhooks-for-continuous-integration.md b/translations/ja-JP/content/admin/developer-workflow/using-webhooks-for-continuous-integration.md deleted file mode 100644 index 65b96378b7d1..000000000000 --- a/translations/ja-JP/content/admin/developer-workflow/using-webhooks-for-continuous-integration.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: 継続的インテグレーションへのwebhookの利用 -intro: 'すでに開発とデプロイメントのエコシステムがあるなら、webhook を使ってそれを {% data variables.product.prodname_ghe_server %} と統合できます。' -mapTopic: true -redirect_from: - - /enterprise/admin/developer-workflow/continuous-integration-using-travis-ci - - /enterprise/admin/developer-workflow/using-webhooks-for-continuous-integration -versions: - enterprise-server: '*' ---- - diff --git a/translations/ja-JP/content/admin/enterprise-management/monitoring-using-analytics.md b/translations/ja-JP/content/admin/enterprise-management/monitoring-using-analytics.md deleted file mode 100644 index 1adc770e8177..000000000000 --- a/translations/ja-JP/content/admin/enterprise-management/monitoring-using-analytics.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: Monitoring using analytics -intro: 'You can enable web analytics tools to track and analyze traffic for your {% data variables.product.prodname_ghe_server %} instance.' -redirect_from: - - /enterprise/admin/enterprise-management/monitoring-using-analytics -versions: - enterprise-server: '>2.21' ---- - -### Configuring Google Analytics - -To configure Google Analytics, you must have a [Google Analytics ID](https://analytics.google.com/) and authenticate to your {% data variables.product.prodname_ghe_server %} instance with SSH. 詳しい情報については「[管理シェル（SSH）にアクセスする](/enterprise/admin/configuration/accessing-the-administrative-shell-ssh)」を参照してください。 - -```shell -$ ghe-config website-analytics.enabled true -$ ghe-config website-analytics.google-analytics-id GOOGLE-ANALYTICS-ID -$ ghe-config-apply -``` diff --git a/translations/ja-JP/content/admin/installation/about-enterprise-accounts.md b/translations/ja-JP/content/admin/installation/about-enterprise-accounts.md deleted file mode 100644 index 4749c6d70751..000000000000 --- a/translations/ja-JP/content/admin/installation/about-enterprise-accounts.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: Enterprise アカウントについて -intro: 'With {% data variables.product.prodname_ghe_server %}, you can create an enterprise account to give administrators a single point of visibility and management for their billing and license usage.' -redirect_from: - - /enterprise/admin/installation/about-enterprise-accounts -versions: - enterprise-server: '*' ---- - -### About enterprise accounts on {% data variables.product.prodname_ghe_server %} - -Enterprise アカウントでは、複数の {% data variables.product.prodname_dotcom %} Organization と {% data variables.product.prodname_ghe_server %} インスタンスを管理できます。 Enterprise アカウントは、{% data variables.product.prodname_dotcom %} 上の Organization や個人アカウントのようにハンドルを持たなければなりません。 Enterprise 管理者は、以下のような設定やプリファレンスを管理できます: - -- メンバーのアクセスと管理 (Organization のメンバー、外部コラボレーター) -- 支払いと使用状況 ({% data variables.product.prodname_ghe_server %} インスタンス、ユーザライセンス、{% data variables.large_files.product_name_short %} パック) -- セキュリティ (シングルサインオン、2 要素認証) -- {% data variables.contact.enterprise_support %} とのリクエストおよび Support Bundle の共有 - -{% data reusables.enterprise-accounts.enterprise-accounts-billing %} - -For more information about the differences between {% data variables.product.prodname_ghe_cloud %} and {% data variables.product.prodname_ghe_server %}, see "[{% data variables.product.prodname_dotcom %}'s products](/articles/githubs-products)." To upgrade to {% data variables.product.prodname_enterprise %} or to get started with an enterprise account, contact {% data variables.contact.contact_enterprise_sales %}. - -### Enterprise アカウントにリンクされている {% data variables.product.prodname_ghe_server %} ライセンスの管理 - -{% data reusables.enterprise-accounts.admin-managing-licenses %} diff --git a/translations/ja-JP/content/admin/installation/about-geo-replication.md b/translations/ja-JP/content/admin/installation/about-geo-replication.md deleted file mode 100644 index fc0ceb8029f5..000000000000 --- a/translations/ja-JP/content/admin/installation/about-geo-replication.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Geo-replicationについて -intro: '{% data variables.product.prodname_ghe_server %} 上の Geo-replication は、地理的に分散したデータセンターからの要求を満たすために、複数のアクティブなレプリカを使用します。' -redirect_from: - - /enterprise/admin/installation/about-geo-replication -versions: - enterprise-server: '*' ---- - -アクティブなレプリカが複数あれば、最も近いレプリカへの距離を短くできます。 たとえばサンフランシスコ、ニューヨーク、ロンドンにオフィスを持つ組織は、プライマリのアプライアンスをニューヨークの近くのデータセンター内で動作させ、2つのレプリカをサンフランシスコとロンドンの近くのデータセンターで動作させることができます。 地理的な場所を認識するDNSを利用すれば、ユーザーは利用可能な最も近いサーバへ振り分けられ、リポジトリのデータに高速にアクセスできます。 ニューヨークの近くにあるアプライアンスをプライマリにすれば、ロンドンへのレイテンシが大きいサンフランシスコ近くのアプライアンスをプライマリにする場合に比べ、ホスト間のレイテンシの削減に役立ちます。 - -アクティブなレプリカは、自身では処理できないリクエストをプライマリインスタンスに中継します。 レプリカは、すべてのSSL接続をターミネートする接続点として機能します。 ホスト間のトラフィックは、暗号化されたVPN接続を通じて送信されます。これは、Geo-replicationなしの2ノードのHigh Availability構成に似ています。 - -Gitのリクエストや、LFSやファイルアップロードのような特定のファイルサーバのリクエストは、プライマリからデータをロードすることなくレプリカが直接処理できます。 Webリクエストは常にプライマリにルーティングされますが、レプリカがユーザに近ければ、近くでSSLのターミネーションが行われることからリクエストは高速に処理されます。 - -Geo-replicationがスムーズに動作するためには、[Amazon's Route 53 サービス](http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-geo)のようなGeo DNSが必要です。 インスタンスのホスト名は、ユーザの場所に最も近いレプリカに解決されるべきです。 - -### 制限事項 - -レプリカへの書き込みリクエストには、データをプライマリとすべてのレプリカへ送信することが必要です。 これはすなわち、すべての書き込みのパフォーマンスは最も低速なレプリカによって制約されるということです。{% if currentVersion ver_gt "enterprise-server@2.17" %}ただし、Geoレプリカは、大部分のデータをプライマリからではなく、既存の共在するGeoレプリカからシードできます。{% endif %} Geo-replication は、{% data variables.product.prodname_ghe_server %} インスタンスに容量を追加したり、不十分な CPU やメモリリソースに関連するパフォーマンスの問題を解決したりしません。 プライマリのアプライアンスがオフラインである場合、アクティブなレプリカはいかなる読み込みや書き込みのリクエストも処理できません。 - -### Geo-replication設定のモニタリング - -{% data reusables.enterprise_installation.monitoring-replicas %} - -### 参考リンク -- "[Geo-replicationレプリカの作成](/enterprise/{{ currentVersion }}/admin/guides/installation/creating-a-high-availability-replica/#creating-geo-replication-replicas)" diff --git a/translations/ja-JP/content/admin/installation/about-high-availability-configuration.md b/translations/ja-JP/content/admin/installation/about-high-availability-configuration.md deleted file mode 100644 index ca58f8a120fb..000000000000 --- a/translations/ja-JP/content/admin/installation/about-high-availability-configuration.md +++ /dev/null @@ -1,181 +0,0 @@ ---- -title: High Availability設定について -intro: 'High Availability 設定では、完全に冗長なセカンダリの {% data variables.product.prodname_ghe_server %} アプライアンスは、すべての主要なデータストアのレプリケーションによってプライマリアプライアンスとの同期を保ちます。' -redirect_from: - - /enterprise/admin/installation/about-high-availability-configuration -versions: - enterprise-server: '*' ---- - -High Availability設定をする際には、プライマリからレプリカアプライアンスへのすべてのデータストア（Gitリポジトリ、MySQL、Redis、Elasticsearch）の一方方向の非同期レプリケーションが、自動的にセットアップされます。 - -{% data variables.product.prodname_ghe_server %} はアクティブ／パッシブ設定をサポートします。この設定では、レプリカアプライアンスはデータベースサービスをレプリケーションモードで実行しながらスタンバイとして実行しますが、アプリケーションサービスは停止します。 - -### ターゲットとなる障害のシナリオ - -以下に対する保護として、High Availability設定を使ってください。 - -{% data reusables.enterprise_installation.ha-and-clustering-failure-scenarios %} - -High Availability設定は、以下に対するソリューションとしては適切ではありません。 - - - **スケーリング外**。 Geo-replicationを使えば地理的にトラフィックを分散させることができるものの、書き込みのパフォーマンスはプライマリアプライアンスの速度と可用性によって制限されます。 詳細は「[Geo-replication について](/enterprise/{{ currentVersion }}/admin/guides/installation/about-geo-replication/)」を参照してください。 - - **プライマリアプライアンスのバックアップ**。 High Availabilityレプリカは、システム災害復旧計画のオフサイトバックアップを置き換えるものではありません。 データ破壊や損失の中には、プライマリからレプリカへ即座にレプリケーションされてしまうものもあります。 安定した過去の状態への安全なロールバックを保証するには、履歴スナップショットでの定期的なバックアップを行う必要があります。 - - **ダウンタイムゼロのアップグレード**。 コントロールされた昇格のシナリオにおけるデータ損失やスプリットブレインの状況を避けるには、プライマリアプライアンスをメンテナンスモードにして、すべての書き込みが完了するのを待ってからレプリカを昇格させてください。 - -### ネットワークトラフィックのフェイルオーバー戦略 - -フェイルオーバーの間は、ネットワークトラフィックをプライマリからレプリカへリダイレクトするよう、別個に設定管理しなければなりません。 - -#### DNSフェイルオーバー - -DNS フェイルオーバーでは、プライマリの {% data variables.product.prodname_ghe_server %} アプライアンスを指す DNS レコードに短い TTL 値を使用します。 60秒から5分の間のTTLを推奨します。 - -フェイルオーバーの間、プライマリはメンテナンスモードにして、プライマリのDNSレコードはレプリカアプライアンスのIPアドレスへリダイレクトしなければなりません。 トラフィックをプライマリからレプリカへリダイレクトするのに要する時間は、TTLの設定とDNSレコードの更新に必要な時間に依存します。 - -Geo-replication を使用している場合は、トラフィックを最も近いレプリカに転送するように Geo DNS を設定する必要があります。 詳細は「[Geo-replication について](/enterprise/{{ currentVersion }}/admin/guides/installation/about-geo-replication/)」を参照してください。 - -#### ロードバランサ - -{% data reusables.enterprise_clustering.load_balancer_intro %} {% data reusables.enterprise_clustering.load_balancer_dns %} - -フェイルオーバーの間、プライマリアプライアンスはメンテナンスモードにしなければなりません。 ロードバランサは、レプリカがプライマリに昇格したときに自動的に検出するように設定することも、手動での設定変更が必要なようにしておくこともできます。 ユーザからのトラフィックに反応する前に、レプリカはプライマリに手動で昇格させておかなければなりません、 詳細は「[ロードバランサとともに {% data variables.product.prodname_ghe_server %} を使用する](/enterprise/{{ currentVersion }}/admin/guides/installation/using-github-enterprise-server-with-a-load-balancer/)」を参照してください。 - -{% data reusables.enterprise_installation.monitoring-replicas %} - -### レプリケーション管理のユーティリティ - -{% data variables.product.prodname_ghe_server %} でレプリケーションを管理するには、SSH を使用してレプリカアプライアンスに接続して以下のコマンドラインユーティリティを使用します。 - -#### ghe-repl-setup - -`ghe-repl-setup` コマンドは、{% data variables.product.prodname_ghe_server %} アプライアンスをレプリカスタンバイモードにします。 - - - 2 つのアプライアンス間の通信のために、暗号化された{% if currentVersion ver_gt "enterprise-server@2.17" %}WireGuard VPN{% else %}OpenVPN{% endif %}トンネルが設定されます。 - - レプリケーションのためのデータベースサービスが設定され、起動されます。 - - アプリケーションサービスは無効化されます。 HTTP、Git、あるいはその他のサポートされているプロトコルでレプリカアプライアンスへアクセスしようとすると、"appliance in replica mode"メンテナンスページあるいはエラーメッセージが返されます。 - -```shell -admin@169-254-1-2:~$ ghe-repl-setup 169.254.1.1 -Verifying ssh connectivity with 169.254.1.1 ... -Connection check succeeded. -Configuring database replication against primary ... -Success: Replica mode is configured against 169.254.1.1. -レプリカモードを無効化してこれらの変更を取り消すには`ghe-repl-teardown'を実行してください。 -新たに設定されたプライマリに対してレプリケーションを開始するには`ghe-repl-start'を実行してください。 -``` - -#### ghe-repl-start - -`ghe-repl-start`コマンドは、すべてのデータストアのアクティブなレプリケーションを有効化します。 - -```shell -admin@169-254-1-2:~$ ghe-repl-start{% if currentVersion ver_lt "enterprise-server@2.18" %} -Starting OpenVPN tunnel ... {% endif %} -Starting MySQL replication ... -Starting Redis replication ... -Starting Elasticsearch replication ... -Starting Pages replication ... -Starting Git replication ... -Success: replication is running for all services. -レプリケーションの健全性と進行状況をモニタリングするには`ghe-repl-status'を使ってください。 -``` - -#### ghe-repl-status - -`ghe-repl-status`コマンドは、各データストアのレプリケーションストリームについて`OK`、`WARNING`、`CRITICAL`のいずれかのステータスを返します。 レプリケーションチャンネルのいずれかが`WARNING`ステータスにある場合、このコマンドはコード`1`で終了します。 同様に、いずれかのチャンネルが`CRITICAL`ステータスにある場合、このコマンドはコード`2`で終了します。 - -```shell -admin@169-254-1-2:~$ ghe-repl-status -OK: mysql replication in sync -OK: redis replication is in sync -OK: elasticsearch cluster is in sync -OK: git data is in sync (10 repos, 2 wikis, 5 gists) -OK: pages data is in sync -``` - -`-v`及び`-vv`オプションは、各データストアのレプリケーションのステータスについての詳細を返します。 - -```shell -$ ghe-repl-status -v -OK: mysql replication in sync - | IO running: Yes, SQL running: Yes, Delay: 0 - -OK: redis replication is in sync - | master_host:169.254.1.1 - | master_port:6379 - | master_link_status:up - | master_last_io_seconds_ago:3 - | master_sync_in_progress:0 - -OK: elasticsearch cluster is in sync - | { - | "cluster_name" : "github-enterprise", - | "status" : "green", - | "timed_out" : false, - | "number_of_nodes" : 2, - | "number_of_data_nodes" : 2, - | "active_primary_shards" : 12, - | "active_shards" : 24, - | "relocating_shards" : 0, - | "initializing_shards" : 0, - | "unassigned_shards" : 0 - | } - -OK: git data is in sync (366 repos, 31 wikis, 851 gists) - | TOTAL OK FAULT PENDING DELAY - | repositories 366 366 0 0 0.0 - | wikis 31 31 0 0 0.0 - | gists 851 851 0 0 0.0 - | total 1248 1248 0 0 0.0 - -OK: pages data is in sync - | Pages are in sync -``` - -#### ghe-repl-stop - -`ghe-repl-stop`コマンドは、一時的にすべてのデータストアのレプリケーションを無効化し、レプリケーションサービスを停止させます。 レプリケーションを再開するには[ghe-repl-start](#ghe-repl-start)コマンドを使ってください。 - -```shell -admin@168-254-1-2:~$ ghe-repl-stop -Stopping Pages replication ... -Stopping Git replication ... -Stopping MySQL replication ... -Stopping Redis replication ... -Stopping Elasticsearch replication ...{% if currentVersion ver_lt "enterprise-server@2.18" %} -Stopping OpenVPN tunnel ...{% endif %} -Success: replication was stopped for all services. -``` - -#### ghe-repl-promote - -`ghe-repl-promote`コマンドはレプリケーションを無効化し、レプリカアプライアンスをプライマリに変換します。 アプライアンスはオリジナルのプライマリと同じ設定がなされ、すべてのサービスが有効化されます。 - -{% data reusables.enterprise_installation.promoting-a-replica %} - -```shell -admin@168-254-1-2:~$ ghe-repl-promote -Enabling maintenance mode on the primary to prevent writes ... -Stopping replication ... - | Stopping Pages replication ... - | Stopping Git replication ... - | Stopping MySQL replication ... - | Stopping Redis replication ... - | Stopping Elasticsearch replication ...{% if currentVersion ver_lt "enterprise-server@2.18" %} - | Stopping OpenVPN tunnel ...{% endif %} - | Success: replication was stopped for all services. -Switching out of replica mode ... - | Success: Replication configuration has been removed. - | Run `ghe-repl-setup' to re-enable replica mode. -Applying configuration and starting services ... -Success: Replica has been promoted to primary and is now accepting requests. -``` - -#### ghe-repl-teardown - -`ghe-repl-teardown`コマンドはレプリケーションモードを完全に無効化し、レプリカの設定を削除します。 - -### 参考リンク - -- "[High Availabilityレプリカの作成](/enterprise/{{ currentVersion }}/admin/guides/installation/creating-a-high-availability-replica)" diff --git a/translations/ja-JP/content/admin/installation/about-the-github-enterprise-server-api.md b/translations/ja-JP/content/admin/installation/about-the-github-enterprise-server-api.md deleted file mode 100644 index 23ce9b688f19..000000000000 --- a/translations/ja-JP/content/admin/installation/about-the-github-enterprise-server-api.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: GitHub Enterprise Server API について -intro: '{% data variables.product.prodname_ghe_server %} は、それ自身の一連の API エンドポイントだけでなく、{% data variables.product.prodname_dotcom_the_website %} で使用できるのと同じ強力な API もサポートしています。' -redirect_from: - - /enterprise/admin/articles/about-the-enterprise-api/ - - /enterprise/admin/articles/using-the-api/ - - /enterprise/admin/categories/api/ - - /enterprise/admin/installation/about-the-github-enterprise-server-api -versions: - enterprise-server: '*' ---- - -The complete documentation for the {% data variables.product.prodname_enterprise_api %} is available at . API を使って、さまざまなタスクを自動化できます。 例えば、 - -- {% data variables.enterprise.management_console %} に変更を加える。 For more information, see "[{% data variables.enterprise.management_console %}](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#management-console)." -- 自分のインスタンスに関する統計を収集する。 For more information, see "[Admin stats](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#admin-stats)." -- LDAP 同期を設定する。 For more information, see "[LDAP](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#ldap)."{% if currentVersion ver_gt "enterprise-server@2.18" %} -- Enterpriseアカウントの管理。 詳しい情報については「[Enterprise アカウント](/v4/guides/managing-enterprise-accounts)」を参照してください。{% endif %} diff --git a/translations/ja-JP/content/admin/installation/accessing-the-administrative-shell-ssh.md b/translations/ja-JP/content/admin/installation/accessing-the-administrative-shell-ssh.md deleted file mode 100644 index d797ca1c9fde..000000000000 --- a/translations/ja-JP/content/admin/installation/accessing-the-administrative-shell-ssh.md +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: 管理シェル (SSH) にアクセスする -redirect_from: - - /enterprise/admin/articles/ssh-access/ - - /enterprise/admin/articles/adding-an-ssh-key-for-shell-access/ - - /enterprise/admin/guides/installation/administrative-shell-ssh-access/ - - /enterprise/admin/articles/troubleshooting-ssh-permission-denied-publickey/ - - /enterprise/admin/2.13/articles/troubleshooting-ssh-permission-denied-publickey/ - - /enterprise/admin/2.14/articles/troubleshooting-ssh-permission-denied-publickey/ - - /enterprise/admin/2.15/articles/troubleshooting-ssh-permission-denied-publickey/ - - /enterprise/admin/installation/accessing-the-administrative-shell-ssh -intro: 'SSH アクセスにより、{% data variables.product.prodname_ghe_server %} のコマンドラインユーティリティを実行でき、トラブルシューティング、バックアップの実行、およびレプリケーションの設定に役立ちます。' -versions: - enterprise-server: '*' ---- - -### 管理シェルでのアクセスについて - -管理シェルへの SSH アクセスがある場合は、{% data variables.product.prodname_ghe_server %} のコマンドラインユーティリティを実行できます。 SSHでのアクセスは、トラブルシューティングやバックアップの実行、レプリケーションの設定にも役立ちます。 管理のためのSSHアクセスはGitのSSHアクセスとは別に管理され、ポート122を通じてのみアクセスできます。 - -### SSH経由での管理シェルへのアクセスの有効化 - -管理のためのSSHアクセスを有効化するには、SSHの公開鍵をインスタンスの認証済みキーのリストに追加しなければなりません。 - -{% tip %} - -**Tip:**認証済みSSH鍵への変更は、すぐに有効になります。 - -{% endtip %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -3. "SSH access（SSHでのアクセス）"の下のテキストボックスに鍵を貼り付け、**Add key（鍵の追加）**をクリックしてください。 ![SSHキーを追加するためのテキストボックスおよびボタン](/assets/images/enterprise/settings/add-authorized-ssh-key-admin-shell.png) -{% data reusables.enterprise_management_console.save-settings %} - -### SSH経由での管理シェルへの接続 - -SSH鍵をリストに追加したら、`admin`ユーザとしてインスタンスのポート122にSSHで接続してください。 - -```shell -$ ssh -p 122 admin@github.example.com -Last login: Sun Nov 9 07:53:29 2014 from 169.254.1.1 -admin@github-example-com:~$ █ -``` - -#### SSH 接続問題のトラブルシューティング - -SSH 経由で {% data variables.product.product_location_enterprise %} に接続しようとしたときに、`Permission denied (publickey)` というエラーが発生した場合は、ポート 122 経由で接続していることを確認してください。 使用するプライベートな SSH キーを明確に指定することが必要になる場合があります。 - -コマンドラインでプライベートな SSH キーを指定するには、`-i` 引数を付けて `ssh` を実行します。 - -```shell -ssh -i /path/to/ghe_private_key -p 122 admin@hostname -``` - -SSH 設定ファイル (`~/.ssh/config`) を使用することでもプライベートな SSH キーを指定できます。 - -```shell -Host hostname - IdentityFile /path/to/ghe_private_key - User admin - Port 122 -``` - -### ローカルコンソールを使った管理シェルへのアクセス - -たとえばSSHが利用でいないような緊急時には、管理シェルにローカルでアクセスできます。 `admin` ユーザーとしてサインインし、{% data variables.product.prodname_ghe_server %} の初期セットアップ中に設定されたパスワードを使用します。 - -### 管理シェルへのアクセス制限 - -管理シェルへのアクセスは、トラブルシューティングとドキュメント化された運用手順の実行時のみ許されます。 システムやアプリケーションのファイル変更、プログラムの実行、サポートされていないソフトウェアパッケージのインストールは、サポート契約を無効にすることがあります。 サポート契約の下で許されているアクティビティについて質問があれば、{% data variables.contact.contact_ent_support %} に連絡してください。 diff --git a/translations/ja-JP/content/admin/installation/accessing-the-management-console.md b/translations/ja-JP/content/admin/installation/accessing-the-management-console.md deleted file mode 100644 index 88a92e6c9b96..000000000000 --- a/translations/ja-JP/content/admin/installation/accessing-the-management-console.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: Management Consoleへのアクセス -intro: '{% data variables.product.product_location %}のセットアップと設定、メンテナンスウィンドウのスケジューリング、問題のトラブルシューティング、ライセンスの管理には{% data variables.enterprise.management_console %}を使ってください。' -redirect_from: - - /enterprise/admin/articles/about-the-management-console/ - - /enterprise/admin/articles/management-console-for-emergency-recovery/ - - /enterprise/admin/articles/web-based-management-console/ - - /enterprise/admin/categories/management-console/ - - /enterprise/admin/articles/accessing-the-management-console/ - - /enterprise/admin/guides/installation/web-based-management-console/ - - /enterprise/admin/installation/accessing-the-management-console -versions: - enterprise-server: '*' ---- - -### {% data variables.enterprise.management_console %}について - -次の基本的な管理作業には {% data variables.enterprise.management_console %} を使用します。 -- **初期セットアップ**: ブラウザで {% data variables.product.product_location_enterprise %} の IP アドレスにアクセスすることで {% data variables.product.product_location_enterprise %} を最初に起動したときに、初期セットアッププロセスを段階的に実行します。 -- **インスタンスの基本設定**: [Settings] ページで、DNS、ホスト名、SSL、ユーザ認証、メール、モニタリングサービス、ログの転送を設定します。 -- **スケジュールメンテナンスウィンドウ**: {% data variables.enterprise.management_console %} または管理シェルを使用してメンテナンスを実行する際に、{% data variables.product.product_location_enterprise %} をオフラインにします。 -- **トラブルシューティング**: Support Bundle を生成するか、高レベルの診断情報を一覧表示します。 -- **ライセンス管理**: {% data variables.product.prodname_enterprise %} ライセンスを一覧表示または更新します。 - -{% data variables.enterprise.management_console %}には、{% data variables.product.product_location_enterprise %}のIPアドレスからいつでもアクセスできます。インスタンスがメンテナンスモードになっていたり、致命的なアプリケーション障害やホスト名あるいはSSLの設定ミスがあってもアクセス可能です。 - -{% data variables.enterprise.management_console %}にアクセスするには、{% data variables.product.product_location_enterprise %}の初期セットアップ時に設定した管理者パスワードを使わなければなりません。 また、ポート8443で仮想マシンのホストに接続することもできます。 {% data variables.enterprise.management_console %}へのアクセスに問題があれば、中間のファイアウォールやセキュリティグループの設定を確認してください。 - -### サイト管理者としての{% data variables.enterprise.management_console %}へのアクセス - -The first time that you access the {% data variables.enterprise.management_console %} as a site administrator, you must upload your {% data variables.product.prodname_enterprise %} license file to authenticate into the app. For more information, see "[Managing your {% data variables.product.prodname_enterprise %} license](/enterprise/{{ currentVersion }}/admin/guides/installation/managing-your-github-enterprise-license)." - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.type-management-console-password %} - -### 認証されていないユーザとしての{% data variables.enterprise.management_console %}へのアクセス - -1. ブラウザで次の URL にアクセスします。`hostname` は実際の {% data variables.product.prodname_ghe_server %} ホスト名または IP アドレスに置き換えてください: - ```shell - http(s)://HOSTNAME/setup - ``` -{% data reusables.enterprise_management_console.type-management-console-password %} - -### ログイン試行の失敗後の{% data variables.enterprise.management_console %}のアンロック - -10 分以内にログインに 10 回失敗すると、{% data variables.enterprise.management_console %} はロックされます。 ログインを再度試みるには、ログイン画面が自動的にロック解除されるまで待つ必要があります。 直前の 10 分間に失敗したログイン試行が 10 回未満となると同時に、ログイン画面は自動的にロックが解除されます。 ログインが成功すると、カウンタはリセットされます。 - -{% data variables.enterprise.management_console %} をただちにロック解除するには、管理シェルから `ghe-reactivate-admin-login` コマンドを使用します。 詳細は「[コマンドラインユーティリティ](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities#ghe-reactivate-admin-login)」および「[管理シェル (SSH) にアクセスする](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-administrative-shell-ssh/)」を参照してください。 diff --git a/translations/ja-JP/content/admin/installation/accessing-the-monitor-dashboard.md b/translations/ja-JP/content/admin/installation/accessing-the-monitor-dashboard.md deleted file mode 100644 index 26d3d44c743b..000000000000 --- a/translations/ja-JP/content/admin/installation/accessing-the-monitor-dashboard.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: モニターダッシュボードへのアクセス -intro: '{% data variables.product.prodname_ghe_server %} には、CPU やストレージの使用状況、アプリケーションや認証の応答時間、一般的なシステム健全性など、{% data variables.product.prodname_ghe_server %} アプライアンスに関する履歴データを表示する Web ベースのモニタリングダッシュボードが搭載されています。' -redirect_from: - - /enterprise/admin/installation/accessing-the-monitor-dashboard -versions: - enterprise-server: '*' ---- - -### モニターダッシュボードへのアクセス - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -2. ページの上部で**Monitor（モニター）**をクリックしてください。 ![モニターダッシュボードのリンク](/assets/images/enterprise/management-console/monitor-dash-link.png) - -### アプライアンスにおける一般的なリソース割り当ての問題のトラブルシューティング - -{% note %} - -**注意**: 継続的インテグレーション（CI）あるいはビルドサーバで定期的に{% data variables.product.product_location_enterprise %}をポーリングすると、実質的にサービス拒否攻撃となって問題が生ずることがあるので、更新のプッシュにはwebhookの利用をお勧めします。 詳しい情報については"[webhookについて](/enterprise/{{ currentVersion }}/user/articles/about-webhooks/)"を参照してください。 - -{% endnote %} - -モニターダッシュボードを使ってアプライアンスリソースの健全性を把握し、高利用率の問題の解決方法を判断してください。 - -| 問題 | 考えられる原因 | 推奨される対応 | -| --------------- | ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| 高いCPU消費 | 同一ホスト上で動作する他のサービスやプログラムとのVM競合 | 可能であれば、CPU消費を下げるように他のサービスやプログラムを再設定する。 VMの総CPUリソースを増加させる方法については"[CPUあるいはメモリリソースの増加](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)"を参照してください。 | -| 高いメモリ消費 | 同一ホスト上で動作する他のサービスやプログラムとのVM競合 | 可能であれば、メモリ消費を下げるように他のサービスやプログラムを再設定する。 VMで利用できるの総メモリ量を増加させる方法については"[CPUあるいはメモリリソースの増加](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)"を参照してください。 | -| ディスクの空き容量の低下 | 大きなバイナリあるいはログファイルによるディスク領域の消費 | 可能であれば大きなバイナリは個別のサーバー上に置き、ログファイルは圧縮もしくはアーカイブする。 必要であれば、使用しているプラットフォームで"[ストレージ容量の増加](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-storage-capacity/)"のステップを踏み、VM上のディスク領域を増やしてください。 | -| 通常よりも長いレスポンスタイム | 多くの場合上記のいずれかの問題によって生ずる | 原因となっている問題を特定して修復してください。 それでもレスポンスタイムが長い場合は、{% data variables.contact.contact_ent_support %} に連絡してください。 | -| エラーレートの増大 | ソフトウェアの問題 | {% data variables.contact.contact_ent_support %}に連絡し、Support Bundleを含めてください。 詳細は「[{% data variables.product.prodname_enterprise %} Support にデータを提供する](/enterprise/{{ currentVersion}}/admin/guides/enterprise-support/providing-data-to-github-support#creating-and-sharing-support-bundles)」を参照してください。 | diff --git a/translations/ja-JP/content/admin/installation/activity-dashboard.md b/translations/ja-JP/content/admin/installation/activity-dashboard.md deleted file mode 100644 index 3f0f575651a1..000000000000 --- a/translations/ja-JP/content/admin/installation/activity-dashboard.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: アクティビティダッシュボード -intro: 'アクティビティダッシュボード で {% data variables.product.product_location_enterprise %}の全てのアクティビティの概要を見ることができます。' -redirect_from: - - /enterprise/admin/articles/activity-dashboard/ - - /enterprise/admin/installation/activity-dashboard -versions: - enterprise-server: '*' ---- - -アクティビティダッシュボードには、次の数値の週次、月次、年次のグラフが表示されます。 -- 新規プルリクエスト -- マージされたプルリクエスト -- 新規 Issue -- 解決された Issue -- 新規 Issue コメント -- 新規リポジトリ -- 新規ユーザアカウント -- 新規 Organization -- 新規 Team - -![アクティビティダッシュボード](/assets/images/enterprise/activity/activity-dashboard-yearly.png) - -{% data variables.product.prodname_enterprise %}からのデータに基づく分析をさらに進めるには、{% data variables.product.prodname_insights %}を購入できます。 詳しい情報については「[{% data variables.product.prodname_insights %}について](/insights/installing-and-configuring-github-insights/about-github-insights)」を参照してください。 - -### アクティビティダッシュボードへのアクセス - -1. ページの上部で [**Explore**] をクリックします。 ![[Explore] タブ](/assets/images/enterprise/settings/ent-new-explore.png) -2. 右上にある **Activity** をクリックする。 ![Activity ボタン](/assets/images/enterprise/activity/activity-button.png) diff --git a/translations/ja-JP/content/admin/installation/audit-logging.md b/translations/ja-JP/content/admin/installation/audit-logging.md deleted file mode 100644 index 37c1a3ed90f1..000000000000 --- a/translations/ja-JP/content/admin/installation/audit-logging.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: 監査ログ -intro: '{% data variables.product.prodname_enterprise %} は、監査済みのユーザ、Organization、リポジトリ、およびシステムイベントのログを保管します。 ログはデバッグや内部および外部のコンプライアンスに役立ちます。' -redirect_from: - - /enterprise/admin/articles/audit-logging/ - - /enterprise/admin/installation/audit-logging -versions: - enterprise-server: '*' ---- - -完全なリストについては「[監査されたアクション](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions)」を参照してください。特定アクションの検索についての詳細は「[Audit log を検索する](/enterprise/{{ currentVersion }}/admin/guides/installation/searching-the-audit-log)」を参照してください。 - -### プッシュのログ - -Git プッシュ操作はすべてログに記録されます。 詳細は「[プッシュのログを表示する](/enterprise/{{ currentVersion }}/admin/guides/installation/viewing-push-logs)」を参照してください。 - -### システムイベント - -すべてのプッシュとプルを含む監査されたすべてのシステムイベントは、`/var/log/github/audit.log` に記録されます。 ログは 24 時間ごとに自動的に交換され、7 日間保持されます。 - -Support Bundle にはシステムログが含まれています。 詳細は「[{% data variables.product.prodname_dotcom %} Support にデータを提供する](/enterprise/{{ currentVersion }}/admin/guides/enterprise-support/providing-data-to-github-support)」を参照してください。 - -### Support Bundle - -すべての監査情報は、Support Bundle の `github-logs` ディレクトリにある `audit.log` ファイルに記録されます。 ログの転送が有効な場合、[Splunk](http://www.splunk.com/) や [Logstash](http://logstash.net/) などの外部の syslog ストリーミングコンシューマに、このデータをストリーミングすることができます。 このログからのすべてのエントリは、`github_audit` キーワードでフィルタリングできます。 詳細は「[ログの転送](/enterprise/{{ currentVersion }}/admin/guides/installation/log-forwarding)」を参照してください。 - -たとえば、次のエントリは新規リポジトリが作成されたことを示しています。 - -``` -Oct 26 01:42:08 github-ent github_audit: {:created_at=>1351215728326, :actor_ip=>"10.0.0.51", :data=>{}, :user=>"some-user", :repo=>"some-user/some-repository", :actor=>"some-user", :actor_id=>2, :user_id=>2, :action=>"repo.create", :repo_id=>1, :from=>"repositories#create"} -``` - -次の例は、コミットがリポジトリにプッシュされたことを示しています。 - -``` -Oct 26 02:19:31 github-ent github_audit: { "pid":22860, "ppid":22859, "program":"receive-pack", "git_dir":"/data/repositories/some-user/some-repository.git", "hostname":"github-ent", "pusher":"some-user", "real_ip":"10.0.0.51", "user_agent":"git/1.7.10.4", "repo_id":1, "repo_name":"some-user/some-repository", "transaction_id":"b031b7dc7043c87323a75f7a92092ef1456e5fbaef995c68", "frontend_ppid":1, "repo_public":true, "user_name":"some-user", "user_login":"some-user", "frontend_pid":18238, "frontend":"github-ent", "user_email":"some-user@github.example.com", "user_id":2, "pgroup":"github-ent_22860", "status":"post_receive_hook", "features":" report-status side-band-64k", "received_objects":3, "receive_pack_size":243, "non_fast_forward":false, "current_ref":"refs/heads/master" } -``` diff --git a/translations/ja-JP/content/admin/installation/audited-actions.md b/translations/ja-JP/content/admin/installation/audited-actions.md deleted file mode 100644 index 4baed7e5dfbd..000000000000 --- a/translations/ja-JP/content/admin/installation/audited-actions.md +++ /dev/null @@ -1,133 +0,0 @@ ---- -title: 監査されたアクション -intro: 監査ログでいろんなアクションを検索することができます。 -redirect_from: - - /enterprise/admin/articles/audited-actions/ - - /enterprise/admin/installation/audited-actions -versions: - enterprise-server: '*' ---- - -#### 認証 - -| 名前 | 説明 | -| ------------------------------------:| ------------------------------------------------------------------------------------------------------------------------------------------------ | -| `oauth_access.create` | ユーザアカウントに[OAuth アクセストークン](/v3/oauth/) が[作成](/articles/creating-an-access-token-for-command-line-use) されました。 | -| `oauth_access.destroy` | [OAuth アクセストークン](/v3/oauth/) がユーザアカウントから削除されました。 | -| `oauth_application.destroy` | [OAuth application](/guides/basics-of-authentication/#registering-your-app)がユーザまたは Organization のアカウントから削除されました。 | -| `oauth_application.reset_secret` | [OAuth アプリケーション](/guides/basics-of-authentication/#registering-your-app)の秘密鍵がリセットされました。 | -| `oauth_application.transfer` | [OAuth アプリケーション](/guides/basics-of-authentication/#registering-your-app)が別のユーザ、または Organization のアカウントへ移されました。 | -| `public_key.create` | SSHキーがユーザアカウントに[追加](/articles/adding-a-new-ssh-key-to-your-github-account)されたか[デプロイキー](/guides/managing-deploy-keys/#deploy-keys)がリポジトリに追加されました。 | -| `public_key.delete` | SSHキーがユーザアカウントから削除されたか[デプロイキー](/guides/managing-deploy-keys/#deploy-keys)がリポジトリから削除されました。 | -| `public_key.update` | ユーザアカウントのSSHキーもしくは、リポジトリの[デプロイキー](/guides/managing-deploy-keys/#deploy-keys)が更新されました。 | -| `two_factor_authentication.enabled` | ユーザアカウントの[二段階認証](/articles/about-two-factor-authentication)が有効化されました。 | -| `two_factor_authentication.disabled` | ユーザアカウントの[二段階認証](/articles/about-two-factor-authentication)が無効化されました。 | - -#### フック - -| 名前 | 説明 | -| ---------------------:| ------------------------ | -| `hook.create` | リポジトリに新規フックが追加されました。 | -| `hook.config_changed` | フックのコンフィグレーションが変更されました。 | -| `hook.destroy` | フックが削除されました。 | -| `hook.events_changed` | フックの設定されているイベントが変更されました。 | - -#### インスタンス設定 - -| 名前 | 説明 | -| -------------------------------------------------------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `business.update_member_repository_creation_permission` | サイトアドミンは、インスタンス上の Organization でリポジトリの作成を制限しています。 詳しい情報については、「[インスタンスでリポジトリ作成を制限する](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)」を参照してください。 | -| `business.clear_members_can_create_repos` | サイトアドミンは、インスタンス上の Organization でリポジトリ作成の制限を解除しています。 詳しい情報については、「[インスタンスでリポジトリ作成を制限する](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)」を参照してください。 | -| `enterprise.config.lock_anonymous_git_access` | リポジトリ管理者が、インスタンス上のリポジトリに対する既存の匿名 Git 読み取りアクセス設定を変更できないようにするため、サイトアドミンは、匿名 Git 読み取りアクセス設定をロックしています。 詳細は「[ユーザによる匿名 Git 読み取りアクセスの変更を禁止する](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)」を参照してください。 | -| `enterprise.config.unlock_anonymous_git_access` | リポジトリ管理者が、インスタンス上のリポジトリに対する既存の匿名 Git 読み取りアクセス設定を変更できるようにするため、サイトアドミンは、匿名 Git 読み取りアクセス設定のロックを解除しています。 詳細は「[ユーザによる匿名 Git 読み取りアクセスの変更を禁止する](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)」を参照してください。 | - -#### Issue およびプルリクエスト - -| 名前 | 説明 | -| ------------------------------------:| ------------------------------------------------------------------------------------------------------------------- | -| `issue.update` | Issue のテキスト本体（最初のコメント）が変更されました。 | -| `issue_comment.update` | Issue （最初以外）のコメントが変更されました。 | -| `pull_request_review_comment.delete` | プルリクエストに関するコメントが削除されました。 | -| `issue.destroy` | Issue がリポジトリから削除されました。 詳細は「[Issue を削除する](/enterprise/{{ currentVersion }}/user/articles/deleting-an-issue)」を参照してください。 | - -#### Organization - -| 名前 | 説明 | -| ------------------:| ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `org.async_delete` | ユーザが Organization を削除するための背景ジョブを開始しました。 | -| `org.delete` | ユーザが行った背景ジョブによって Organization が削除されました。 | -| `org.transform` | ユーザアカウントが Organization へと変換されました。 詳しくは [ユーザをOrganization に変換する方法](/enterprise/{{ currentVersion}}/user/articles/converting-a-user-into-an-organization/) を参照してください。 | - -#### 保護されたブランチ - -| 名前 | 説明 | -| ------------------------------------------------------------------:| ---------------------------------- | -| `protected_branch.create` | ブランチ保護がブランチで有効になっています。 | -| `protected_branch.destroy` | ブランチ保護がブランチで無効になっています。 | -| `protected_branch.update_admin_enforced` | ブランチ保護がリポジトリ管理者に対して強制されます。 | -| `protected_branch.update_require_code_owner_review` | 必要なコードオーナーレビューの強制がブランチで更新されます。 | -| `protected_branch.dismiss_stale_reviews` | 却下している古いプルリクエストの強制がブランチで更新されます。 | -| `protected_branch.update_signature_requirement_enforcement_level` | 必要なコミット署名の強制がブランチで更新されます。 | -| `protected_branch.update_pull_request_reviews_enforcement_level` | 必要なプルリクエストレビューの強制がブランチで更新されます。 | -| `protected_branch.update_required_status_checks_enforcement_level` | 必要なステータスチェックの強制がブランチで更新されます。 | -| `protected_branch.rejected_ref_update` | ブランチ更新の試行が拒否されます。 | -| `protected_branch.policy_override` | ブランチ保護の要件がリポジトリ管理者によってオーバーライドされます。 | - -#### リポジトリ - -| 名前 | 説明 | -| ------------------------------------------:| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `repo.access` | プライベートリポジトリが公開されたか、パブリックリポジトリが非公開にされました。 | -| `repo.archive` | リポジトリがアーカイブされました。 詳細は「[リポジトリのアーカイブとアーカイブ削除](/enterprise/{{ currentVersion }}/admin/guides/user-management/archiving-and-unarchiving-repositories/)」を参照してください。 | -| `repo.add_member` | リポジトリにコラボレーターが追加されました。 | -| `repo.config` | サイト管理者がフォースプッシュをブロックしました。 詳しくは、 [リポジトリへのフォースプッシュのブロック](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository/)を参照してください。 | -| `repo.create` | リポジトリが作成されました。 | -| `repo.destroy` | リポジトリが削除されました。 | -| `repo.remove_member` | コラボレーターがリポジトリから削除されました。 | -| `repo.rename` | リポジトリの名前が変更されました。 | -| `repo.transfer` | ユーザーが転送されたリポジトリを受け取る要求を受け入れました。 | -| `repo.transfer_start` | ユーザーがリポジトリを別のユーザーまたは Organization に転送する要求を送信しました。 | -| `repo.unarchive` | リポジトリがアーカイブ解除されました。 詳細は「[リポジトリのアーカイブとアーカイブ削除](/enterprise/{{ currentVersion }}/admin/guides/user-management/archiving-and-unarchiving-repositories/)」を参照してください。 | -| `repo.config.disable_anonymous_git_access` | 匿名 Git 読み取りアクセスがパブリックリポジトリに対して無効になります。 詳細は「[リポジトリに対する匿名 Git 読み取りアクセスを有効化する](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)」を参照してください。 | -| `repo.config.enable_anonymous_git_access` | 匿名 Git 読み取りアクセスがパブリックリポジトリに対して有効になっています。 詳細は「[リポジトリに対する匿名 Git 読み取りアクセスを有効化する](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)」を参照してください。 | -| `repo.config.lock_anonymous_git_access` | リポジトリの匿名 Git 読み取りアクセス設定がロックされているため、リポジトリ管理者はこの設定を変更 (有効化または無効化) できません。 詳細は「[ユーザによる匿名 Git 読み取りアクセスの変更を禁止する](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)」を参照してください。 | -| `repo.config.unlock_anonymous_git_access` | リポジトリの匿名 Git 読み取りアクセス設定がロック解除されているため、リポジトリ管理者はこの設定を変更 (有効化または無効化) できます。 詳細は「[ユーザによる匿名 Git 読み取りアクセスの変更を禁止する](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)」を参照してください。 | - -#### サイトアドミンのツール - -| 名前 | 説明 | -| --------------------:| --------------------------------------------------------------------------------- | -| `staff.disable_repo` | サイトアドミンがリポジトリとその全てのフォークへのアクセスを無効にしました。 | -| `staff.enable_repo` | サイトアドミンがリポジトリとその全てのフォークへのアクセスを再度有効化しました。 | -| `staff.fake_login` | サイトアドミンが {% data variables.product.prodname_enterprise %}に別のユーザとしてサインインしました。 | -| `staff.repo_unlock` | サイトアドミンがユーザのプライベートリポジトリを解除（一時的にフルアクセスが可能）しました。 | -| `staff.unlock` | サイトアドミンがユーザの全てのプライベートリポジトリを解除（一時的にフルアクセスが可能）しました。 | - -#### Team - -| 名前 | 説明 | -| --------------:| --------------------------------- | -| `team.create` | ユーザアカウントまたはリポジトリが Team に追加されました。 | -| `team.delete` | ユーザアカウントまたはリポジトリが Team から削除されました。 | -| `team.destroy` | Teamが削除されました。 | - -#### ユーザ - -| 名前 | 説明 | -| ---------------------------:| ------------------------------------------------------------ | -| `user.add_email` | ユーザアカウントにメールアドレスが追加されました。 | -| `user.async_delete` | ユーザアカウントを削除するための非同期的ジョブが開始されました。おって `user.delete` がトリガーされます。 | -| `user.change_password` | ユーザがパスワードを変更しました。 | -| `user.create` | 新規ユーザが作成されました。 | -| `user.delete` | ユーザアカウントが非同期的ジョブによって削除されました。 | -| `user.demote` | サイトアドミンが一般ユーザアカウントに変更されました。 | -| `user.destroy` | ユーザが自分のアカウントを削除し、`user.async_delete` をトリガーしました。 | -| `user.failed_login` | ユーザが間違ったユーザネームやパスワード、または二段階認証コードでサインインしようとしました。 | -| `user.forgot_password` | ユーザがサインインページでパスワードリセットを申請しました。 | -| `user.login` | ユーザがサインインしました。 | -| `user.promote` | 一般ユーザアカウントがサイトアドミンへと変更されました。 | -| `user.remove_email` | ユーザアカウントからメールアドレスが削除されました。 | -| `user.rename` | ユーザ名が変更されました。 | -| `user.suspend` | サイトアドミンがユーザアカウントを停止しました。 | -| `user.two_factor_requested` | ユーザが二段階認証コードを要求されました。 | -| `user.unsuspend` | サイトアドミンがユーザアカウント停止を解除しました。 | diff --git a/translations/ja-JP/content/admin/installation/command-line-utilities.md b/translations/ja-JP/content/admin/installation/command-line-utilities.md deleted file mode 100644 index 22eb199134d3..000000000000 --- a/translations/ja-JP/content/admin/installation/command-line-utilities.md +++ /dev/null @@ -1,786 +0,0 @@ ---- -title: コマンドラインのユーティリティ -intro: '{% data variables.product.prodname_ghe_server %} には、特定の問題を解決したり特定のタスクを実行するのに役立つさまざまなユーティリティが搭載されています。' -redirect_from: - - /enterprise/admin/articles/viewing-all-services/ - - /enterprise/admin/articles/command-line-utilities/ - - /enterprise/admin/installation/command-line-utilities -miniTocMaxHeadingLevel: 4 -versions: - enterprise-server: '*' ---- - -SSH 管理ユーザとしてサインインした後では、VM 上のどこからでもこれらのコマンドを実行できます。 詳しくは、"[管理シェル（SSH）へのアクセス方法](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-administrative-shell-ssh/)を参照してください。" - -### 一般的 - -#### ghe-announce - -このユーティリティは、あらゆる {% data variables.product.prodname_enterprise %} ページの上部にバナーを設定します。 これを使用すればユーザにメッセージを配信することができます。 - -```shell -# 皆に見えるメッセージを設定する -$ ghe-announce -s MESSAGE -> Announcement message set. -# 以前設定したメッセージを削除する -$ ghe-announce -u -> Removed the announcement message -``` - -#### ghe-check-disk-usage - -このユーティリティは、大きなファイルがないか、あるいは削除されているがファイルハンドルがまだ開いているファイルがないか、ディスクをチェックします。 これは、ルートパーティションで空き容量を確保しようとしているときに実行してください。 - -```shell -ghe-check-disk-usage -``` - -#### ghe-cleanup-caches - -このユーティリティは、ルートボリュームでディスク領域を将来余分に取り過ぎる可能性があるさまざまなキャッシュをクリーンアップします。 ルートボリュームのディスク領域の使用量が時間の経過とともに著しく増加していることがわかった場合は、このユーティリティを実行して全体的な使用量を減らすのに役立つかどうかを確認することをおすすめします。 - -```shell -ghe-cleanup-caches -``` -#### ghe-cleanup-settings - -このユーティリティは、既存の {% data variables.enterprise.management_console %} の設定をすべて消去します。 - -{% tip %} - -**参考**: {% data reusables.enterprise_enterprise_support.support_will_ask_you_to_run_command %} - -{% endtip %} - -```shell -ghe-cleanup-settings -``` - -#### ghe-config - -このユーティリティを使用すると、{% data variables.product.product_location_enterprise %} の設定を取得して変更することができます。 - -```shell -$ ghe-config core.github-hostname -# `core.github-hostname` のコンフィグレーション値を獲得する -$ ghe-config core.github-hostname 'example.com' -# `core.github-hostname` のコンフィグレーション値を `example.com`にする -$ ghe-config -l -# コンフィグレーションの全ての値を表示 -``` -`cluster.conf`で有効なUUIDを検索できます。 - -``` shell - $ ghe-config _hostname_.uuid -``` - -#### ghe-config-apply - -このユーティリティは、{% data variables.enterprise.management_console %} の設定の適用や、システムサービスのリロード、アプリケーションサービスのリロード、保留中のデータベースマイグレーションを行います。 It is equivalent to clicking **Save settings** in the {% data variables.enterprise.management_console %}'s web UI or to sending a POST request to [the `/setup/api/configure` endpoint](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#management-console). - -手動で実行することはないと思いますが、設定を保存する過程をSSH 経由で自動化したい場合に利用できます。 - -```shell -ghe-config-apply -``` - -#### ghe-console - -このユーティリティは、{% data variables.product.prodname_enterprise %} アプライアンスで GitHub Rails コンソールを開きます。 {% data reusables.command_line.use_with_support_only %} - -```shell -ghe-console -``` - -#### ghe-dbconsole - -このユーティリティは、{% data variables.product.prodname_enterprise %} アプライアンスで MySQL データベースセッションを開きます。 {% data reusables.command_line.use_with_support_only %} - -```shell -ghe-dbconsole -``` - -#### ghe-es-index-status -このユーティリティは、ElasticSearch のインデックスの概要を CSV フォーマットで表示します。 - -`STDOUT` でヘッダー行が付いてるインデックスの概要を表示します。 -```shell -$ ghe-es-index-status -do -> warning: parser/current is loading parser/ruby23, which recognizes -> warning: 2.3.3-compliant syntax, but you are running 2.3.4. -> warning: please see https://github.com/whitequark/parser#compatibility-with-ruby-mri. -> Name,Primary,Searchable,Writable,UpToDate,RepairProgress,Version -> code-search-1,true,true,true,true,100.0,72e27df7c631b45e026b42bfef059328fa040e17 -> commits-5,true,true,true,true,100.0,7ed28813100c47813ef654c0ee2bb9abf21ab744 -> gists-4,true,true,true,true,100.0,cf8e7d04fcf2564c902e2873c424a279cc41079d -> issues-4,false,false,false,true,100.0,d0bb08f71eebf6e7b070572aa399b185dbdc8a76 -> issues-5,true,true,true,true,100.0,d0bb08f71eebf6e7b070572aa399b185dbdc8a76 -> projects-2,true,true,true,true,100.0,c5cac1c4b3c66d42e609d088d174dbc3dd44469a -> pull-requests-6,true,true,true,true,100.0,6a466ad6b896a3499509990979bf9a18d7d41de3 -> repos-6,true,true,true,true,100.0,6c8b5fbba0fc1e409558db411d05e092c1387082 -> users-5,true,true,true,true,100.0,38984875552bb826c9ec42999f409cb2e95556eb -> wikis-4,true,true,true,true,100.0,2613dec44bd14e14577803ac1f9e4b7e07a7c234 -``` - -インデックスの概要を表示し、読みやすくするために `column` にパイプします。 - -```shell -$ ghe-es-index-status -do | column -ts, -> warning: parser/current is loading parser/ruby23, which recognizes -> warning: 2.3.3-compliant syntax, but you are running 2.3.4. -> warning: please see https://github.com/whitequark/parser#compatibility-with-ruby-mri. -> Name Primary Searchable Writable UpToDate RepairProgress Version -> code-search-1 true true true true 100.0 72e27df7c631b45e026b42bfef059328fa040e17 -> commits-5 true true true true 100.0 7ed28813100c47813ef654c0ee2bb9abf21ab744 -> gists-4 true true true true 100.0 cf8e7d04fcf2564c902e2873c424a279cc41079d -> issues-4 false false false true 100.0 d0bb08f71eebf6e7b070572aa399b185dbdc8a76 -> issues-5 true true true true 100.0 d0bb08f71eebf6e7b070572aa399b185dbdc8a76 -> projects-2 true true true true 100.0 c5cac1c4b3c66d42e609d088d174dbc3dd44469a -> pull-requests-6 true true true true 100.0 6a466ad6b896a3499509990979bf9a18d7d41de3 -> repos-6 true true true true 100.0 6c8b5fbba0fc1e409558db411d05e092c1387082 -> users-5 true true true true 100.0 38984875552bb826c9ec42999f409cb2e95556eb -> wikis-4 true true true true 100.0 2613dec44bd14e14577803ac1f9e4b7e07a7c234 -``` - -#### ghe-legacy-github-services-report - -このユーティリティは、2018 年 10 月 1 日に廃止予定の統合方式である {% data variables.product.prodname_dotcom %} サービスを使用しているアプライアンス上のリポジトリを一覧表示します。 アプライアンス上のユーザーは、特定のリポジトリへのプッシュに対する通知を作成するために、{% data variables.product.prodname_dotcom %} サービスを設定している場合があります。 For more information, see "[Announcing the deprecation of {% data variables.product.prodname_dotcom %} Services](https://developer.github.com/changes/2018-04-25-github-services-deprecation/)" on {% data variables.product.prodname_blog %} or "[Replacing {% data variables.product.prodname_dotcom %} Services](/v3/guides/replacing-github-services/)." For more information about this command or for additional options, use the `-h` flag. - -```shell -ghe-legacy-github-services-report - -``` - -#### ghe-logs-tail - -このユーティリティでは、インストールから関連するすべてのログファイルを末尾に記録できます。 オプションを渡すことでログを特定のセットに制限できます。 追加オプションを確認するには -h フラグを使用してください。 - -```shell -ghe-logs-tail -``` - -#### ghe-maintenance - -このユーティリティにより、インストールのメンテナンスモードの状態を制御できます。 これは主に舞台裏で {% data variables.enterprise.management_console %} によって使用されるように設計されていますが、直接使用することもできます。 - -```shell -ghe-maintenance -h -``` - -{% if currentVersion ver_gt "enterprise-server@2.17" %} -#### ghe-motd - -This utility re-displays the message of the day (MOTD) that administrators see when accessing the instance via the administrative shell. The output contains an overview of the instance's state. - -```shell -ghe-motd -``` -{% endif %} - -#### ghe-nwo - -このユーティリティを使って、リポジトリの ID でリポジトリの名前とオーナーを検索することができます。 - -```shell -ghe-nwo REPOSITORY_ID -``` - -#### ghe-org-admin-promote - -このコマンドを使用して、アプライアンスでサイトの管理者権限を持つユーザーに Organization のオーナー権限を付与したり、単一の Organization 内の任意の単一ユーザーに Organization のオーナー権限を付与したりします。 ユーザーや Organization を指定する必要があります。 確認を省略するために`-y` フラグを使用しない限り、`ghe-org-admin-encourage` コマンドは実行前に常に確認を求めます。 - -ユーティリティでは以下のオプションを使用できます。 - -- `-u`のフラグはユーザ名を指定します。 このフラグを使用して特定ユーザーに Organization のオーナー権限を付与します。 すべてのサイト管理者を指定された Organization に昇格させるには、`-u`フラグを省略します。 -- `-o`のフラグは Organization を指定します。 このフラグを使用して特定の Organization でオーナー権限を付与します。 すべての Organization で指定されたサイト管理者にオーナー権限を付与するには、`-o` フラグを省略します。 -- `-a` のフラグは、全ての Organization で全てのサイトアドミンにコードオーナー権限を与えます。 -- `-y` フラグは手動の確認を省略します。 - -このユーティリティは、非サイト管理者をすべての Organization のオーナーに昇格させることはできません。 [ghe-user-promote](#ghe-user-promote)を使用すれば、通常のユーザーアカウントをサイト管理者に昇格させることができます。 - -1人のユーザに 特定の Organization で Organization のオーナー権限を与える - -```shell -ghe-org-admin-promote -u ユーザ名 -o ORGANIZATION -``` - -全ての Organization で特定のサイトアドミンに Organizationのオーナー権限を与える - -```shell -ghe-org-admin-promote -u ユーザ名 -``` - -特定の Organization で全てのサイトアドミンに Organizationのオーナー権限を与える - -```shell -ghe-org-admin-promote -o ORGANIZATION -``` - -全ての Organization で全てのサイトアドミンに Organization のオーナー権限を与える - -```shell -ghe-org-admin-promote -a -``` - -#### ghe-reactivate-admin-login - -10分以内にログインを10回失敗した場合、このコマンドを使って {% data variables.enterprise.management_console %} を直ちに解除できます。 - -```shell -$ ghe-reactivate-admin-login -``` - -#### ghe-resque-info - -このユーティリティは、アクティブでありかつキュー内にある、バックグラウンドジョブに関する情報を表示します。 あらゆるページの上部には、管理統計バーと同じジョブ数が表示されます。 - -このユーティリティは、Resque サーバーでバックグラウンドジョブの処理に問題があるかどうかを識別するのに役立ちます。 以下のどのシナリオも Resque の問題を示している可能性があります。 - -* 背景のジョブの数が増えていますが、実行中のジョブの数は同じままです。 -* イベントフィードが更新されない。 -* Webhooks are not being triggered. -* Git プッシュ後、ウェブインタフェースが更新されない。 - -Resque の故障を懸念している場合は、{% data variables.contact.contact_ent_support %} に連絡してください。 - -このコマンドでは、キューでのジョブ停止または再開をすることができます。 - -```shell -$ ghe-resque-info -# キューと現在キューに入っているジョブの数を表示する -$ ghe-resque-info -p QUEUE -# 特定のキューを停止する -$ ghe-resque-info -r QUEUE -# 特定のキューを再開する -``` - -#### ghe-saml-mapping-csv - -このユーティリティは、SAMLレコードのマップを支援します。 - -{% data variables.product.product_name %}ユーザのためのすべてのSAMLマッピングを含むCSVファイルを作成するには、次のようにします。 -```shell -$ ghe-saml-mapping-csv -d -``` - -新しい値でのSAMLマッピングの更新のドライランを実行するには、次のようにします。 -```shell -$ ghe-saml-mapping-csv -u -n -f /path/to/file -``` - -新しい値でSAMLマッピングを更新するには、次のようにします。 -```shell -$ ghe-saml-mapping-csv -u -n -f /path/to/file -``` - -#### ghe-service-list - -このユーティリティは、アプライアンス に開始または停止された（実行中または待機中）、全てのサービスの一覧を表示します。 - -```shell -$ ghe-service-list -start/running - - github-resqued, process 12711 - - github-unicorn, process 12726 - - github-gitauth, process 12743 - - git-daemon, process 12755 - - babeld, process 12771 - - github-svn-proxy, process 12802 - - gist-unicorn, process 12832 - - gist-resqued, process 12881 - - render-unicorn, process 12939 - - hookshot-unicorn, process 13076 - - nodeload2, process 13192 - - slumlord-unicorn, process 13304 - - ghe-storage, process 2012 - - enterprise-manage-unicorn, process 2024 - - enterprise-manage-resque, process 2053 - -stop/waiting - - ghe-replica-mode -``` - -{% tip %} - -このコマンドが返すサービス名は、[`systemctl`](https://www.freedesktop.org/software/systemd/man/systemctl.html)コマンドで利用して、それらのサービスを必要に応じて手動で停止、起動、再起動できます。 例: - -```shell -$ sudo systemctl restart github-resqued -``` - -サービスを停止することによって、インスタレーションが稼働停止しますので、サービスを停止または再起動する前に {% data variables.contact.contact_ent_support %} に連絡することをおすすめします。 - -{% endtip %} - -#### ghe-set-password - -`ghe-set-password` では、[{% data variables.enterprise.management_console %}](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-management-console) に認証するための新しいパスワードを設定することができます。 - -```shell -ghe-set-password <新しいパスワード> -``` - -#### ghe-ssh-check-host-keys - -このユーティリティは、既存の SSH のホストキーを漏洩した SSH ホストキーと比べます。 - -```shell -$ ghe-ssh-check-host-keys -``` - -漏洩したホストキーが発見された場合、ユーティリティは `1` というステータスと次のメッセージで終了します。 -```shell -> One or more of your SSH host keys were found in the blacklist. -> Please reset your host keys using ghe-ssh-roll-host-keys. -``` - -漏洩したホストキーが発見されなかった場合、ユーティリティは `0` というステータスと次のメッセージで終了します。 -```shell -> The SSH host keys were not found in the SSH host key blacklist. -> No additional steps are needed/recommended at this time. -``` - -#### ghe-ssh-roll-host-keys - -このユーティリティは、SSH のホストキーを廃棄し、新しく作成したキーに置き換えます。 - -```shell -$ sudo ghe-ssh-roll-host-keys -SSH のホストキーを廃棄しますか？ /etc/ssh/ssh_host_* にある既存キーを削除し、新しいキーを生成します。 [y/N] - -# 'Y' を押して、削除を確認するか、-y スイッチを使ってこのプロンプトを回避する - -> SSH host keys have successfully been rolled. -``` - -#### ghe-ssh-weak-fingerprints - -このユーティリティは、{% data variables.product.prodname_enterprise %} のアプライアンスに保存されている脆弱なSSHキーの報告を作成します。 ユーザのキーを一括アクションとして取り消すことができます。 このユーティリティは、脆弱なシステムキーについて報告します。取り消しは、[{% data variables.enterprise.management_console %}](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-management-console) で手動的に行う必要があります。 - -```shell -# ユーザのシステムの脆弱なキーの報告を表示 -$ ghe-ssh-weak-fingerprints - -# ユーザの全ての脆弱なキーを取り消す -$ ghe-ssh-weak-fingerprints --revoke -``` - -#### ghe-ssl-acme - -このユーティリティでは、 {% data variables.product.prodname_enterprise %} のアプライアンスに Let's Encrypt の証明書をインストールすることができます。 詳しくは、"[TLS の設定方法](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-tls)。" を参照してください。 - -`-x`フラグを使って、ACME設定を削除できます。 - -```shell -ghe-ssl-acme -e -``` - -#### ghe-ssl-ca-certificate-install - -このユーティリティでは、{% data variables.product.prodname_enterprise %} のサーバにカスタムルートのCA証明書をインストールできます。 証明書は PEM 形式でなければなりません。 さらに、証明書の提供者が1つのファイルに複数のCA証明書を含めている場合は、それらを個別のファイルに分けて `ghe-ssl-ca-certificate-install` に各々を渡す必要があります。 - -S/MIME コミット署名の検証のために証明書チェーンを追加するには、このユーティリティを実行します。 詳細は「[コミット署名の検証について](/enterprise/{{ currentVersion }}/user/articles/about-commit-signature-verification/)」を参照してください。 - -他のサーバが自己署名証明書または必要な CA バンドルがついていない SSL 証明書を使っているため {% data variables.product.product_location_enterprise %} がそのサーバに接続できない場合、このユーティリティを使ってください。 これを確認する方法は、{% data variables.product.product_location_enterprise %} から`openssl s_client -connect host:port -verify 0 -CApath /etc/ssl/certs` を実行することです。 リモートサーバの SSL 証明書を確認できたら、`SSL-Session` が次のように0の終了コードを表示します。 - -``` -SSL-Session: - Protocol : TLSv1 - Cipher : AES128-SHA - Session-ID: C794EBCC3CBC10F747C9AFC029C03C1048FC99CFC34D13D7444E0F267C58DF4C - Session-ID-ctx: - Master-Key: 02A7C47CFD6EEC87D3C710E9DD87390E04EF82DDD7514AE03127D5DC1945FC0CAEFB5395791AEA598667EFA61B9EA8C5 - Key-Arg : None - Start Time: 1394581597 - Timeout : 300 (sec) - Verify return code: 0 (ok) -``` - -リモートサーバの SSL 証明書を確認*できない*場合は、`SSL-Session` が0ではない終了コードを表示します。 - -``` -SSL-Session: - Protocol : TLSv1 - Cipher : AES128-SHA - Session-ID: 82CB288051A6DB66094C50A69CF1292AEE7E54C6B01B659B98AB336F8C33863E - Session-ID-ctx: - Master-Key: 01B025B2F764043A27919A8D1355AAECD8844FF0831B1D664042334790574A6F4025BAB085D4ED71D71AAB3091B849E5 - Key-Arg : None - Start Time: 1394581782 - Timeout : 300 (sec) - Verify return code: 27 (certificate not trusted) -``` - -ユーティリティでは以下のオプションを使用できます: -- `-r` フラグにより、CA 証明書をアンインストールできます。 -- `-h` フラグはさらなる使用情報を表示します。 - -```shell -ghe-ssl-ca-certificate-install -c /path/to/certificate -``` - -#### ghe-ssl-generate-csr - -このユーティリティにより、秘密鍵と証明書署名要求 (CSR) を生成できます。これらを商用またはプライベートの認証局と共有することで、インスタンスで使用する有効な証明書を取得できます。 詳しくは、"[TLS の設定方法](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-tls)。" を参照してください。 - -このコマンドの詳細や追加のオプションについては、`-h` フラグを使用してください。 - -```shell -ghe-ssl-generate-csr -``` - -#### ghe-storage-extend - -一部のプラットフォームでは、ユーザボリュームを拡張するためにこのスクリプトが必要です。 詳しい情報については、「[ストレージ容量の増加](/enterprise/admin/guides/installation/increasing-storage-capacity/)」を参照してください。 - -```shell -$ ghe-storage-extend -``` - -#### ghe-version - -このユーティリティは、{% data variables.product.product_location_enterprise %} のバージョンやプラットフォーム、ビルドを表示します。 - -```shell -$ ghe-version -``` - -#### ghe-webhook-logs - -このユーティリティは、管理人がレビューして問題を突き止めるための webhook のデリバリログを表示します。 - -```shell -ghe-webhook-logs -``` - -過去1日の失敗したフックデリバリーを表示するには、以下のようにします。 -```shell -ghe-webhook-logs -f -a YYYYMMDD -``` - -フックのペイロードの全体や結果、デリバリーの例外を表示するには、以下のようにします。 -```shell -ghe-webhook-logs -g delivery-guid -v -``` - -グローバルな webhook のデリバリーを表示するには、以下のようにします。 -```shell -ghe-webhook-logs --global -``` - -### クラスタリング - -#### ghe-cluster-support-bundle - -このユーティリティは、Geo-replication またはクラスタリングのいずれかの構成で、各ノードからの重要なログを含む Support Bundle tarball を作成します。 - -このコマンドは、デフォルトの設定では、*/tmp* に TAR 書庫を作成しますが、簡単に SSH 経由でストリーミングできるように、TAR 書庫を `STDOUT` に `cat`できます。 ウェブ UI が反応していないか、*/setup/support* から Support Bundle をダウンロードできないときに役立ちます。 より古いログを含む*拡張*バンドルを生成するときにこのコマンドを使う必要があります。 さらに、このコマンドを使って {% data variables.product.prodname_enterprise %} のサポートにクラスタリングSupport Bundle を直接アップロードすることができます。 - -標準のバンドルを作成するには、以下のようにします。 -```shell -$ ssh -p 122 admin@hostname -- 'ghe-cluster-support-bundle -o' > cluster-support-bundle.tgz -``` - -拡張バンドルを作成するには、以下のようにします。 -```shell -$ ssh -p 122 admin@hostname -- 'ghe-cluster-support-bundle -x -o' > cluster-support-bundle.tgz -``` - -バンドルを{% data variables.contact.github_support %}に送信するには、以下のようにします。 -```shell -$ ssh -p 122 admin@hostname -- 'ghe-cluster-support-bundle -u' -``` - -バンドルを{% data variables.contact.github_support %}に送信し、そのバンドルをチケットに関連づけるには以下のようにします。 -```shell -$ ssh -p 122 admin@hostname -- 'ghe-cluster-support-bundle -t ticket-id' -``` - -#### ghe-dpages - -このユーティリティを使えば、分散{% data variables.product.prodname_pages %}サーバーを管理できます。 - -```shell -ghe-dpages -``` - -リポジトリの場所と健全性の概要を表示するには、以下のようにします。 -```shell -ghe-dpages status -``` - -クラスタノードの退避に先立って{% data variables.product.prodname_pages %}ストレージサービスを退避するには、以下のようにします。 -``` shell -ghe-dpages evacuate pages-server- -``` - -#### ghe-spokes - -このユーティリティでは、分散型 Git サーバにある各リポジトリの3つのコピーを管理することができます。 - -```shell -ghe-spokes -``` - -リポジトリの場所と健全性の概要を表示するには、以下のようにします。 - -```shell -ghe-spokes status -``` - -リポジトリが保存されているサーバーを表示するには、以下のようにします。 - -```shell -ghe-spokes route -``` - -クラスタノード上のストレージサービスを退避するには、以下のようにします。 - -``` shell -ghe-spokes server evacuate git-server- -``` - -#### ghe-storage - -このユーティリティを使用すると、クラスタノードからの待避の前にストレージサービスをすべて待避させることができます。 - -``` shell -ghe-storage evacuate storage-server- -``` - -### Git - -#### ghe-btop - -現在の Git 作業用の`top`にあたるインタフェース。 - -```shell -ghe-btop [ | --help | --usage ] -``` - -#### ghe-repo - -このユーティリティでは、リポジトリのディレクトリを変更し、`git`ユーザとしてインタラクティブシェルを開けることができます。 `git-*` や `git-nw-*` などのコマンドを使って、手動的な監査やメンテナンスを行うことができます。 - -```shell -ghe-repo ユーザ名/reponame -``` - -#### ghe-repo-gc - -このユーティリティは、パックの容量を最適化するために、手動的にリポジトリのネットワークをリパックします。 大きなリポジトリの場合、このコマンドを実行するとリポジトリの全体的なサイズを減らすことができます。 リポジトリのネットワークとの対話を通じて、{% data variables.product.prodname_enterprise %} がこのコマンドを自動的に実行します。 - -任意の`--prune` の引数を付けて、ブランチやタグ、refに参照されていない、届かないGitオブジェクトを除くことができます。 これは、[以前抹消した機密情報](/enterprise/user/articles/remove-sensitive-data/) を直ちに削除するために役立ちます。 - -```shell -ghe-repo-gc ユーザ名/reponame -``` - -### インポートとエクスポート - -#### ghe-migrator - -`ghe-migrator` は、他のGitHubインスタンスに移行するためのハイファイツールです。 インスタンスを統合、もしくは Organization やユーザ、Team、リポジトリをGitHub.comから {% data variables.product.prodname_enterprise %} に移行することができます。 - -詳細については、[ユーザ、Organization、リポジトリデータの移行](/enterprise/admin/guides/migrations/)ガイドを参照してください。 - -#### git-import-detect - -URL が与えられたら、どのタイプのソース管理システムが相手側にあるのかを検出します。 このことは、手動インポートの間におそらくすでに知られていますが、自動化されたスクリプトでとても役立ちます。 -```shell -git-import-detect -``` - -#### git-import-hg-raw - -このユーティリティは、MercurialのリポジトリをこのGitリポジトリにインポートします。 詳しい情報については「[サードパーティのバージョン管理システムからのデータのインポート](/enterprise/admin/guides/migrations/importing-data-from-third-party-version-control-systems/)」を参照してください。 -```shell -git-import-hg-raw -``` - -#### git-import-svn-raw - -このユーティリティはSubversionの履歴とファイルデータをGitのブランチにインポートします。 これはツリーの単純なコピーであり、トランクやブランチの区別を無視します。 詳しい情報については「[サードパーティのバージョン管理システムからのデータのインポート](/enterprise/admin/guides/migrations/importing-data-from-third-party-version-control-systems/)」を参照してください。 -```shell -git-import-svn-raw -``` - -#### git-import-tfs-raw - -このユーティリティは、Team Foundation Version Controlからインポートします。 詳しい情報については「[サードパーティのバージョン管理システムからのデータのインポート](/enterprise/admin/guides/migrations/importing-data-from-third-party-version-control-systems/)」を参照してください。 -```shell -git-import-tfs-raw -``` - -#### git-import-rewrite - -このユーティリティは、インポートされたリポジトリを書き直します。 これにより、作者名を変更したり、SubversionやTFSではフォルダーを基にGitのブランチを生成したりできます。 詳しい情報については「[サードパーティのバージョン管理システムからのデータのインポート](/enterprise/admin/guides/migrations/importing-data-from-third-party-version-control-systems/)」を参照してください。 -```shell -git-import-rewrite -``` - -### サポート - -#### ghe-diagnostics - -このユーティリティは、さまざまな確認を行うとともに、インストールについての情報を集めます。この情報は、サポートチームが問題の診断に役立てるために、送信することができます。 - -現在のところ、このユーティリティの出力は、{% data variables.enterprise.management_console %} でダウンロードできる診断情報に類似していますが、今後、Web UI では利用できない改善が追加される可能性があります。 詳しい情報については、「[診断ファイルの作成と共有](/enterprise/admin/guides/enterprise-support/providing-data-to-github-support#creating-and-sharing-diagnostic-files)」を参照してください。 - -```shell -ghe-diagnostics -``` - -#### ghe-support-bundle - -{% data reusables.enterprise_enterprise_support.use_ghe_cluster_support_bundle %} -このユーティリティは、インスタンスから重要なログを含むSupport BundleのTAR書庫を作成します。 - -このコマンドは、デフォルトの設定では、*/tmp* に TAR 書庫を作成しますが、簡単に SSH 経由でストリーミングできるように、TAR 書庫を `STDOUT` に `cat`できます。 ウェブ UI が反応していないか、*/setup/support* から Support Bundle をダウンロードできないときに役立ちます。 より古いログを含む*拡張*バンドルを生成するときにこのコマンドを使う必要があります。 さらに、このコマンドを使って {% data variables.product.prodname_enterprise %} のサポートに Support Bundle を直接アップロードすることができます。 - -標準のバンドルを作成するには、以下のようにします。 -```shell -$ ssh -p 122 admin@hostname -- 'ghe-support-bundle -o' > support-bundle.tgz -``` - -拡張バンドルを作成するには、以下のようにします。 -```shell -$ ssh -p 122 admin@hostname -- 'ghe-support-bundle -x -o' > support-bundle.tgz -``` - -バンドルを{% data variables.contact.github_support %}に送信するには、以下のようにします。 -```shell -$ ssh -p 122 admin@hostname -- 'ghe-support-bundle -u' -``` - -バンドルを{% data variables.contact.github_support %}に送信し、そのバンドルをチケットに関連づけるには以下のようにします。 - -```shell -$ ssh -p 122 admin@hostname -- 'ghe-support-bundle -t ticket-id' -``` - -#### ghe-support-upload - -このユーティリティは、アプライアンスから {% data variables.product.prodname_enterprise %} サポートに情報を送信します。 ローカルファイルを指定、または`STDIN`経由で最大100MBまでのデータのストリームを提供することができます。 アップロードされたデータは任意でサポートチケットと関連付けることができます。 - -ファイルを{% data variables.contact.github_support %}に送信し、そのファイルをチケットに関連づけるには以下のようにします。 -```shell -ghe-support-upload -f path/to/your/file -t ticket-id -``` - -`STDIN`経由でデータをアップロードし、そのデータをチケットに関連づけるには以下のようにします。 -```shell -ghe-repl-status -vv | ghe-support-upload -t ticket-id -d "Verbose Replication Status" -``` - -この例では、`ghe-repl-status -vv` がレプリカアプライアンスから詳細なステータス情報を送信します。 `ghe-repl-status -vv`を`STDIN`ストリーミングしたい特定データに入れ替えて、`Verbose Replication Status` をデータの簡潔な説明に入れ替えます。 {% data reusables.enterprise_enterprise_support.support_will_ask_you_to_run_command %} - -### {% data variables.product.prodname_ghe_server %} のアップグレード - -#### ghe-upgrade - -このユーティリティは、アップグレードパッケージをインストール、または確認します。 アップグレードが失敗した場合や中断された場合は、このユーティリティを使用してパッチリリースをロールバックすることもできます。 詳しい情報については、「[{% data variables.product.prodname_ghe_server %} をアップグレードする](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-github-enterprise-server/)」を参照してください。 - -アップグレードパッケージを確認するには以下のようにします。 -```shell -ghe-upgrade --verify UPGRADE-PACKAGE-FILENAME -``` - -アップグレードパッケージをインストールするには以下のようにします。 -```shell -ghe-upgrade UPGRADE-PACKAGE-FILENAME -``` - -{% data reusables.enterprise_installation.command-line-utilities-ghe-upgrade-rollback %} - -#### ghe-upgrade-scheduler - -このユーティリティは、アップグレードパッケージの定期的なインストールを管理します。 定期的なインストールを表示、新規作成、削除することができます。 クーロン表現を使って、スケジュールを作る必要があります。 詳しい情報については、[Wikipedia にあるクーロンのエントリー](https://en.wikipedia.org/wiki/Cron#Overview)を参照してくださ - -パッケージの新しいインストールをスケジュールするには以下のようにします。 -```shell -$ ghe-upgrade-scheduler -c "0 2 15 12 *" UPGRADE-PACKAGE-FILENAME -``` - -パッケージのスケジュールされたインストールを表示するには以下のようにします。 -```shell -$ ghe-upgrade-scheduler -s UPGRADE PACKAGE FILENAME -> 0 2 15 12 * /usr/local/bin/ghe-upgrade -y -s UPGRADE-PACKAGE-FILENAME > /data/user/common/UPGRADE-PACKAGE-FILENAME.log 2>&1 -``` - -パッケージのスケジュールされたインストールを削除するには以下のようにします。 -```shell -$ ghe-upgrade-scheduler -r UPGRADE PACKAGE FILENAME -``` - -#### ghe-update-check - -このユーティリティは、{% data variables.product.prodname_enterprise %} の新規パッチのリリースがあるかどうかを確認します。 リリースが存在する場合、インスタンスに十分な容量があればパッケージをダウンロードします。 デフォルトでは、パッケージは */var/lib/ghe-updates* に保存されます。 その後、管理人が[アップグレードを実行できます](/enterprise/admin/guides/installation/updating-the-virtual-machine-and-physical-resources/)。 - -*/var/lib/ghe-updates/ghe-update-check.status* にダウンロードのステータスを含むファイルがあります。 - -`-i`のスイッチを使って、{% data variables.product.prodname_enterprise %} の最新リリースを確認することができます。 - -```shell -$ ssh -p 122 admin@hostname -- 'ghe-update-check' -``` - -### ユーザ管理 - -#### ghe-license-usage - -This utility exports a list of the installation's users in JSON format. If your instance is connected to {% data variables.product.prodname_ghe_cloud %}, {% data variables.product.prodname_ghe_server %} uses this information for reporting licensing information to {% data variables.product.prodname_ghe_cloud %}. For more information, see "[Connecting {% data variables.product.prodname_ghe_server %} to {% data variables.product.prodname_ghe_cloud %} ](/enterprise/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)." - -By default, the list of users in the resulting JSON file is encrypted. その他のオプションを利用するには、`-h` のフラグを使ってください。 - -```shell -ghe-license-usage -``` - -#### ghe-org-membership-update - -このユーティリティは、インスタンスでメンバー全員に対して、デフォルトの Organization メンバーシップの可視性の設定を必須化します。 詳しい情報については、「[Organization メンバーの可視性の設定](/enterprise/{{ currentVersion }}/admin/guides/user-management/configuring-visibility-for-organization-membership)」を参照してください。設定可能なオプションは、`public` または `private` です。 - -```shell -ghe-org-membership-update --visibility=SETTING -``` - -#### ghe-user-csv - -This utility exports a list of all the users in the installation into CSV format. CSV ファイルにはメールアドレスやユーザの種類 (例えば、アドミンやユーザなど) や所有しているリポジトリの数、所有している SSH キーの数、Organization のメンバーの数、最後にログインしたときの IP アドレスなどが含まれています。 その他のオプションを利用するには、`-h` のフラグを使ってください。 - -```shell -ghe-user-csv -o > users.csv -``` - -#### ghe-user-demote - -このユーティリティは、指定のユーザをアドミンステータスから一般ユーザのステータスに変更します。 このアクションは、ウェブ UI を使って行うことをおすすめします。このユーティリティを提供しているのは、誤って`ghe-user-promote` を実行してしまった場合に、CLI からユーザを降格させるためです。 - -```shell -ghe-user-demote some-user-name -``` - -#### ghe-user-promote - -このユーティリティは、指定したユーザアカウントをサイト管理人に変更します。 - -```shell -ghe-user-promote some-user-name -``` - -#### ghe-user-suspend - -このユーティリティは、指定したユーザのアカウントを停止して、ログインやプッシュ、リポジトリからのプルを行えないようにします。 - -```shell -ghe-user-suspend some-user-name -``` - -#### ghe-user-unsuspend - -このユーティリティは、指定したユーザの停止状態を解除して、ログインやプッシュ、リポジトリからプルを行えるようにします。 - -```shell -ghe-user-unsuspend some-user-name -``` diff --git a/translations/ja-JP/content/admin/installation/configuring-a-hostname.md b/translations/ja-JP/content/admin/installation/configuring-a-hostname.md deleted file mode 100644 index 4a91b10b7a63..000000000000 --- a/translations/ja-JP/content/admin/installation/configuring-a-hostname.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: ホスト名の設定 -intro: アプライアンスには、ハードコードされたIPアドレスを使うのではなくホスト名を設定することをおすすめします。 -redirect_from: - - /enterprise/admin/guides/installation/configuring-hostnames/ - - /enterprise/admin/installation/configuring-a-hostname -versions: - enterprise-server: '*' ---- - -ハードコードされたIPアドレスの代わりにホスト名を設定すれば、ユーザやクライアントソフトウェアに影響を与えることなく{% data variables.product.product_location_enterprise %}を動作させる物理ハードウェアを変更できるようになります。 - -The hostname setting in the {% data variables.enterprise.management_console %} should be set to an appropriate fully qualified domain name (FQDN) which is resolvable on the internet or within your internal network. たとえば、ホスト名の設定は `github.companyname.com` であるかもしれません。 また、選択したホスト名に対して Subdomain Isolation を有効にして、いくつかのクロスサイトスクリプティングスタイルの脆弱性を軽減することもおすすめします。 ホスト名の設定に関する詳しい情報については、[HTTP RFC の Section 2.1](https://tools.ietf.org/html/rfc1123#section-2) を参照してください。 - -{% data reusables.enterprise_installation.changing-hostname-not-supported %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.hostname-menu-item %} -4. {% data variables.product.product_location_enterprise %} に設定するホスト名を入力します。 ![ホスト名を設定するためのフィールド](/assets/images/enterprise/management-console/hostname-field.png) -5. 新しいホスト名のためのDNS及びSSLの設定をテストするには**Test domain settings（ドメイン設定のテスト）**をクリックしてください。 ![[Test domain settings] ボタン](/assets/images/enterprise/management-console/test-domain-settings.png) -{% data reusables.enterprise_management_console.test-domain-settings-failure %} -{% data reusables.enterprise_management_console.save-settings %} - -ホスト名を設定したら、{% data variables.product.product_location_enterprise %}のSubdomain Isolationを有効化することをお勧めします。 詳しい情報については"[Subdomain Isolationの有効化](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-subdomain-isolation/)"を参照してください。 diff --git a/translations/ja-JP/content/admin/installation/configuring-an-outbound-web-proxy-server.md b/translations/ja-JP/content/admin/installation/configuring-an-outbound-web-proxy-server.md deleted file mode 100644 index 3c00183ed5e1..000000000000 --- a/translations/ja-JP/content/admin/installation/configuring-an-outbound-web-proxy-server.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: アウトバウンドのWebプロキシサーバの設定 -intro: 'プロキシサーバは、{% data variables.product.product_location_enterprise %}に追加のセキュリティのレベルをもたらしてくれます。' -redirect_from: - - /enterprise/admin/guides/installation/configuring-a-proxy-server/ - - /enterprise/admin/installation/configuring-an-outbound-web-proxy-server -versions: - enterprise-server: '*' ---- - -{% data variables.product.product_location_enterprise %} に対してプロキシサーバーが有効である場合、送信先ホストが HTTP プロキシ除外として追加されていない限り、{% data variables.product.prodname_ghe_server %} によって送信されたアウトバウンドメッセージがプロキシサーバーを経由してまず最初に送信されます。 アウトバウンドのメッセージの種類には、webhook、Bundleのアップロード、レガシーのアバターのフェッチが含まれます。 プロキシサーバのURLは、たとえば`http://127.0.0.1:8123`といったように、プロトコル、ドメインもしくはIPアドレスにポート番号を加えたものです。 - -{% note %} - -**メモ:** {% data variables.product.product_location_enterprise %}　を　{% data variables.product.prodname_dotcom_the_website %} に接続するには、`github.com` と `api.github.com` への接続がプロキシ設定で許可されている必要があります。 詳細は「[{% data variables.product.prodname_ghe_server %} を {% data variables.product.prodname_dotcom_the_website %} に接続する](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/connecting-github-enterprise-server-to-github-com)」を参照してください。 - -{% endnote %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -4. **HTTP Proxy Server（HTTPプロキシサーバ）**の下に、プロキシサーバのURLを入力してください。 ![HTTP プロキシサーバーのURLを入力するためのフィールド](/assets/images/enterprise/management-console/http-proxy-field.png) -5. オプションで、プロキシのアクセスを要しないホストがあれば**HTTP Proxy Exclusion（HTTPプロキシの除外）**の下にカンマ区切りで入力してください。 ![HTTP プロキシの除外を入力するためのフィールド](/assets/images/enterprise/management-console/http-proxy-exclusion-field.png) -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/ja-JP/content/admin/installation/configuring-applications.md b/translations/ja-JP/content/admin/installation/configuring-applications.md deleted file mode 100644 index 6c8286b95931..000000000000 --- a/translations/ja-JP/content/admin/installation/configuring-applications.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: アプリケーションを設定する -intro: '{% data variables.product.product_location_enterprise %} 向けに内部アプリケーションを設定できます。' -redirect_from: - - /enterprise/admin/installation/configuring-applications -versions: - enterprise-server: '*' ---- - -### 画像キャッシュを調整する - -{% data variables.product.product_location_enterprise %} がアバターをキャッシュする時間を選択できます。 キャッシュ時間を長くすると、ユーザのアバターをロードするのにかかる時間が長くなります。 キャッシュ時間を短すぎる値で設定すると、{% data variables.product.product_location_enterprise %} のワークプロセスが過負荷になる可能性があります。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -3. 左のサイドバーで、**Applications** をクリックする。 ![[Settings] サイドバーでの [Applications] タブ](/assets/images/enterprise/management-console/sidebar-applications.png) -4. [Avatar image cache time (seconds)] で、{% data variables.product.product_location_enterprise %} にアバター画像をキャッシュさせる秒数を入力します。 ![アバター画像キャッシュのフォームフィールド](/assets/images/enterprise/management-console/add-image-caching-value-field.png) -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/ja-JP/content/admin/installation/configuring-backups-on-your-appliance.md b/translations/ja-JP/content/admin/installation/configuring-backups-on-your-appliance.md deleted file mode 100644 index f3529f620529..000000000000 --- a/translations/ja-JP/content/admin/installation/configuring-backups-on-your-appliance.md +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: アプライアンスでのバックアップの設定 -redirect_from: - - /enterprise/admin/categories/backups-and-restores/ - - /enterprise/admin/articles/backup-and-recovery/ - - /enterprise/admin/articles/backing-up-github-enterprise/ - - /enterprise/admin/articles/restoring-github-enterprise/ - - /enterprise/admin/articles/backing-up-repository-data/ - - /enterprise/admin/articles/restoring-enterprise-data/ - - /enterprise/admin/articles/restoring-repository-data/ - - /enterprise/admin/articles/backing-up-enterprise-data/ - - /enterprise/admin/guides/installation/backups-and-disaster-recovery/ - - /enterprise/admin/installation/configuring-backups-on-your-appliance -intro: 'システム災害復旧計画の一部として、自動化バックアップを設定して{% data variables.product.product_location_enterprise %}のプロダクションデータを保護できます。' -versions: - enterprise-server: '*' ---- - -### {% data variables.product.prodname_enterprise_backup_utilities %}について - -{% data variables.product.prodname_enterprise_backup_utilities %}は、個別のホストにインストールするバックアップシステムで、{% data variables.product.product_location_enterprise %}のバックアップスナップショットをセキュアなSSHネットワーク接続経由で定期的に取得します。 スナップショットを使用して、既存の {% data variables.product.prodname_ghe_server %} インスタンスをバックアップホストから以前の状態に復元できます。 - -ネットワーク経由で転送されるのは最後のスナップショット以降に追加されたデータのみで、追加の物理ストレージ領域もその分だけしか占めません。 パフォーマンスへの影響を最小化するために、バックアップは最低のCPU/IO優先度の下でオンライン実行されます。 バックアップを行うために、メンテナンスウィンドウをスケジューリングする必要はありません。 - -機能、要求事項、高度な利用方法に関する詳しい情報については[{% data variables.product.prodname_enterprise_backup_utilities %}README](https://github.com/github/backup-utils#readme)を参照してください。 - -### 必要な環境 - -{% data variables.product.prodname_enterprise_backup_utilities %}を利用するには、{% data variables.product.product_location_enterprise %}とは別のLinuxもしくはUnixホストシステムが必要です。 - -{% data variables.product.prodname_enterprise_backup_utilities %}は、重要なデータのための長期的な恒久ストレージの既存環境に統合することもできます。 - -バックアップホストと{% data variables.product.product_location_enterprise %}は、地理的に離れたところに配置することをおすすめします。 そうすることで、プライマリのサイトにおける大規模な災害やネットワーク障害に際してもリカバリにバックアップが利用できることが保証されます。 - -物理的なストレージの要求は、Gitリポジトリのディスク利用状況と予想される成長パターンによって異なります。 - -| ハードウェア | 推奨構成 | -| --------- | --------------------------- | -| **vCPUs** | 2 | -| **メモリ** | 2 GB | -| **ストレージ** | プライマリインスタンスに割り当てられたストレージの5倍 | - -ユーザのアクティビティや他の製品との結合といった利用方法によっては、さらに多くのリソースが必要になることがあります。 - -### {% data variables.product.prodname_enterprise_backup_utilities %}のインストール - -{% note %} - -**注意:** リカバリされたアプライアンスがすぐに利用できることを保証するために、Geo-replication構成の場合であってもプライマリインスタンスをターゲットとしたバックアップを実行してください。 - -{% endnote %} - -1. 最新の[{% data variables.product.prodname_enterprise_backup_utilities %}リリース](https://github.com/github/backup-utils/releases)をダウンロードし、`tar`コマンドで展開してください。 - ```shell - $ tar -xzvf /path/to/github-backup-utils-vMAJOR.MINOR.PATCH.tar.gz - ``` -2. 含まれている `backup.config-example` ファイルを `backup.config` にコピーして、エディタで開きます。 -3. `GHE_HOSTNAME` の値をプライマリの {% data variables.product.prodname_ghe_server %} インスタンスのホスト名あるいは IP アドレスに設定します。 -4. `GHE_DATA_DIR` の値をバックアップスナップショットを保存したいファイルシステムの場所に設定します。 -5. `https://HOSTNAME/setup/settings` にあるプライマリインスタンスの設定ページを開き、バックアップホストの SSH キーを認証済みの SSH キーのリストに追加します。 詳しい情報については、「[管理シェル (SSH) にアクセスする](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-administrative-shell-ssh/)」を参照してください。 -5. `ghe-host-check` コマンドで、{% data variables.product.product_location_enterprise %} との SSH 接続を確認します。 - ```shell - $ bin/ghe-host-check - ``` - 6. 最初のフルバックアップを作成するには、`ghe-backup` コマンドを実行します。 - ```shell - $ bin/ghe-backup - ``` - -高度な使い方に関する詳しい情報については、[{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#readme)を参照してください。 - -### バックアップのスケジューリング - -バックアップのスケジュールを設定する `cron(8)` コマンドや同様のコマンドスケジューリングサービスを使用すれば、バックアップホストで定期的なバックアップをスケジュール設定できます。 設定されたバックアップ頻度によって、リカバリー計画での最悪の目標復旧ポイント (RPO) が決まります。 たとえば、毎日午前 0 時にバックアップを実行するようにスケジュール設定した場合、災害のシナリオで最大 24 時間分のデータが失われる可能性があります。 プライマリサイトのデータが破壊された場合に、最悪でも最大 1 時間分のデータ損失で収まることが保証されるように、1 時間ごとのバックアップスケジュールから始めることをおすすめします。 - -バックアップの試行が重複すると、`ghe-backup` コマンドはエラーメッセージを表示して中断し、同時バックアップが存在することを示します。 そのような場合は、スケジュール設定したバックアップの頻度を減らすことをおすすめします。 詳しい情報については、[{% data variables.product.prodname_enterprise_backup_utilities %} README](https://github.com/github/backup-utils#scheduling-backups) の「スケジューリングバックアップ」を参照してください。 - -### バックアップのリストア - -万が一、プライマリサイトで長時間の停止または壊滅的なイベントが発生した場合は、別の {% data variables.product.prodname_enterprise %} アプライアンスをプロビジョニングしてバックアップホストから復元を実行することで、{% data variables.product.product_location_enterprise %} を復元できます。 アプライアンスを復元する前に、バックアップホストの SSH キーをターゲットの {% data variables.product.prodname_enterprise %} アプライアンスに認証済み SSH キーとして追加する必要があります。 - -最後に成功したスナップショットから {% data variables.product.product_location_enterprise %} を復元するには、`ghe-restore` コマンドを使用します。 以下と同じような出力が表示されるでしょう: - -```shell -$ ghe-restore -c 169.154.1.1 -> Checking for leaked keys in the backup snapshot that is being restored ... -> * No leaked keys found -> Connect 169.154.1.1:122 OK (v2.9.0) - -> WARNING: All data on GitHub Enterprise appliance 169.154.1.1 (v2.9.0) -> will be overwritten with data from snapshot 20170329T150710. -> Please verify that this is the correct restore host before continuing. -> Type 'yes' to continue: yes - -> Starting restore of 169.154.1.1:122 from snapshot 20170329T150710 -# ...output truncated -> Completed restore of 169.154.1.1:122 from snapshot 20170329T150710 -> Visit https://169.154.1.1/setup/settings to review appliance configuration. -``` - -{% note %} - -**メモ:** ネットワーク設定はバックアップのスナップショットから除外されます。 ご使用の環境に合わせて、ターゲットの {% data variables.product.prodname_ghe_server %} アプライアンスでネットワークを手動で設定する必要があります。 - -{% endnote %} - -以下の追加オプションは、`ghe-restore` コマンドで使用できます。 -- `-c` フラグは、すでに設定されている場合でも、ターゲットホストで設定、証明書、およびライセンスデータを上書きします。 テストのためにステージングインスタンスを設定しており、ターゲット上の依存の設定を残しておきたい場合には、このフラグを省いてください。 詳しい情報については[{% data variables.product.prodname_enterprise_backup_utilities %}README](https://github.com/github/backup-utils#using-the-backup-and-restore-commands)の"バックアップ及びリストアコマンドの利用"セクションを参照してください。 -- `-s` フラグにより、異なるバックアップスナップショットを選択できます。 - diff --git a/translations/ja-JP/content/admin/installation/configuring-built-in-firewall-rules.md b/translations/ja-JP/content/admin/installation/configuring-built-in-firewall-rules.md deleted file mode 100644 index a071fe3d46d5..000000000000 --- a/translations/ja-JP/content/admin/installation/configuring-built-in-firewall-rules.md +++ /dev/null @@ -1,115 +0,0 @@ ---- -title: 組み込みファイアウォールのルール設定 -intro: '{% data variables.product.product_location_enterprise %}のデフォルトのファイアウォールのルールとカスタマイズされたルールを見ることができます。' -redirect_from: - - /enterprise/admin/guides/installation/configuring-firewall-settings/ - - /enterprise/admin/installation/configuring-built-in-firewall-rules -versions: - enterprise-server: '*' ---- - -### {% data variables.product.product_location_enterprise %}のファイアウォールについて - -{% data variables.product.prodname_ghe_server %} は、仮想アプライアンスで Ubuntu の Uncomplicated Firewall (UFW) を使用します。 詳しい情報についてはUbuntuのドキュメンテーションの"[UFW](https://help.ubuntu.com/community/UFW)"を参照してください。 {% data variables.product.prodname_ghe_server %} automatically updates the firewall allowlist of allowed services with each release. - -{% data variables.product.prodname_ghe_server %} をインストールすると、接続を受け入れるために必要なすべてのネットワークポートが自動的に開かれます。 不必要なすべてのポートは自動的に`deny`に設定され、デフォルトの送信ポリシーは`allow`に設定されます。 ステートフルな追跡は、任意の新しいコネクションに対して有効化されます。それらは通常、`SYN`ビットが立てられているネットワークパケットです。 詳しい情報については"[ネットワークポート](/enterprise/admin/guides/installation/network-ports)"を参照してください。 - -UFW ファイアウォールは、{% data variables.product.prodname_ghe_server %} が正しく動作するのに必要となる他のいくつかのポートも開きます。 UFWのルールセットに関する詳しい情報については[the UFW README](https://bazaar.launchpad.net/~jdstrand/ufw/0.30-oneiric/view/head:/README#L213)を参照してください。 - -### デフォルトのファイアウォールルールの表示 - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. デフォルトのファイアウォールルールを表示するには、`sudo ufw status` コマンドを使用します。 以下と同じような出力が表示されるでしょう: - ```shell - $ sudo ufw status - > Status: active - > To Action From - > -- ------ ---- - > ghe-1194 ALLOW Anywhere - > ghe-122 ALLOW Anywhere - > ghe-161 ALLOW Anywhere - > ghe-22 ALLOW Anywhere - > ghe-25 ALLOW Anywhere - > ghe-443 ALLOW Anywhere - > ghe-80 ALLOW Anywhere - > ghe-8080 ALLOW Anywhere - > ghe-8443 ALLOW Anywhere - > ghe-9418 ALLOW Anywhere - > ghe-1194 (v6) ALLOW Anywhere (v6) - > ghe-122 (v6) ALLOW Anywhere (v6) - > ghe-161 (v6) ALLOW Anywhere (v6) - > ghe-22 (v6) ALLOW Anywhere (v6) - > ghe-25 (v6) ALLOW Anywhere (v6) - > ghe-443 (v6) ALLOW Anywhere (v6) - > ghe-80 (v6) ALLOW Anywhere (v6) - > ghe-8080 (v6) ALLOW Anywhere (v6) - > ghe-8443 (v6) ALLOW Anywhere (v6) - > ghe-9418 (v6) ALLOW Anywhere (v6) - ``` - -### カスタムのファイアウォールルールの追加 - -{% warning %} - -**警告:** 既知の作業状態にリセットする必要が生じた場合に備えて、カスタムのファイアウォールルールを追加する前に、現在のルールをバックアップしてください。 サーバーからロックアウトされている場合には、{% data variables.contact.contact_ent_support %}に問い合わせて、元のファイアウォールルールを再設定してください。 元のファイアウォールルールを復元すると、サーバーでダウンタイムが発生します。 - -{% endwarning %} - -1. カスタムのファイアウォールルールを設定する。 -2. `status numbered`コマンドを使って、新しいルールそれぞれのステータスをチェックします。 - ```shell - $ sudo ufw status numbered - ``` -3. カスタムのファイアウォールルールをバックアップするには、`cp` コマンドを使用してルールを新しいファイルに移動します。 - ```shell - $ sudo cp -r /lib/ufw ~/ufw.backup - ``` - -{% data variables.product.product_location_enterprise %}をアップグレードした後は、カスタムのファイアウォールルールを再適用しなければなりません。 ファイアウォールのカスタムルールを再適用するためのスクリプトを作成することをお勧めします。 - -### デフォルトのファイアウォールルールのリストア - -ファイアウォールルールの変更後に何か問題が生じたなら、オリジナルのバックアップからルールをリセットできます。 - -{% warning %} - -**注意:** ファイアウォールに変更を加える前にオリジナルのルールをバックアップしていなかった場合は、{% data variables.contact.contact_ent_support %}に連絡して以降の支援を求めてください。 - -{% endwarning %} - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. 以前のバックアップルールを復元するには、`cp` コマンドでそれらをファイアウォールにコピーして戻します。 - ```shell - $ sudo cp -f ~/ufw.backup/*rules /lib/ufw - ``` -3. `systemctl` コマンドでファイアウォールを再起動します。 - ```shell - $ sudo systemctl restart ufw - ``` -4. `ufw status` コマンドで、ルールがデフォルトに戻っていることを確認します。 - ```shell - $ sudo ufw status - > Status: active - > To Action From - > -- ------ ---- - > ghe-1194 ALLOW Anywhere - > ghe-122 ALLOW Anywhere - > ghe-161 ALLOW Anywhere - > ghe-22 ALLOW Anywhere - > ghe-25 ALLOW Anywhere - > ghe-443 ALLOW Anywhere - > ghe-80 ALLOW Anywhere - > ghe-8080 ALLOW Anywhere - > ghe-8443 ALLOW Anywhere - > ghe-9418 ALLOW Anywhere - > ghe-1194 (v6) ALLOW Anywhere (v6) - > ghe-122 (v6) ALLOW Anywhere (v6) - > ghe-161 (v6) ALLOW Anywhere (v6) - > ghe-22 (v6) ALLOW Anywhere (v6) - > ghe-25 (v6) ALLOW Anywhere (v6) - > ghe-443 (v6) ALLOW Anywhere (v6) - > ghe-80 (v6) ALLOW Anywhere (v6) - > ghe-8080 (v6) ALLOW Anywhere (v6) - > ghe-8443 (v6) ALLOW Anywhere (v6) - > ghe-9418 (v6) ALLOW Anywhere (v6) - ``` diff --git a/translations/ja-JP/content/admin/installation/configuring-collectd.md b/translations/ja-JP/content/admin/installation/configuring-collectd.md deleted file mode 100644 index 34b824cc63fc..000000000000 --- a/translations/ja-JP/content/admin/installation/configuring-collectd.md +++ /dev/null @@ -1,57 +0,0 @@ ---- -title: collectd のコンフィグレーション -intro: '{% data variables.product.prodname_enterprise %}は、`collectd` でデータを収集し、外部の `collectd` に送信することができます。 CPU の使用率やメモリーとディスクの消費、ネットワークインタフェーストラフィックとエラー、仮想マシンの全体的な負荷などのデータを収集しています。' -redirect_from: - - /enterprise/admin/articles/configuring-collectd/ - - /enterprise/admin/installation/configuring-collectd -versions: - enterprise-server: '*' ---- - -### 外部 `collectd` サーバーを設置 - -{% data variables.product.product_location_enterprise %}に`collectd` の転送をまだ有効にしていない場合は、外部の `collectd` サーバを設置する必要があります。 `collectd` サーバは、`collectd` 5.x以上のバージョンを使わなければなりません。 - -1. `collectd` サーバにログインする -2. `collectd` を作成、または編集することで、ネットワークプラグインをロードし、適切な値をサーバとポートのディレクティブに追加する。 たいていのディストリビューションでは、これは `/etc/collectd/collectd.conf` にあります。 - -`collectd` サーバを実行するための見本の*collectd.conf* - - LoadPlugin network - ... - ... - - Listen "0.0.0.0" "25826" - - -### {% data variables.product.prodname_enterprise %}でcollectd転送を有効にする - -デフォルトでは、`collectd` 転送は {% data variables.product.prodname_enterprise %} で無効になっています。 次の手順に従って、`collectd` 転送を有効にして設定します。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -1. ログの転送設定の下にある、**Enable collectd forwarding** を選択する -1. **Server address** の欄には {% data variables.product.prodname_enterprise %}のアプライアンスの統計を転送したい`collectd` サーバのアドレスを入力する。 -1. **Port**の欄には、`collectd` サーバーに接続するためのポートを入力する。 (デフォルトは 25826) -1. **Cryptographic setup** のドロップダウンメニューでは、`collectd` サーバーとのコミュニケーションのセキュリティーレベルを選択する。 (None、signed packets、もしくは encrypted packets.) -{% data reusables.enterprise_management_console.save-settings %} - -### collectd データの `ghe-export-graphs`でのエクスポート - -`ghe-export-graphs` のコマンドラインツールは、`collectd` が RRD データベースに保存するデータをエクスポートします。 このコマンドは、データを XML にして、1つのTAR書庫（.tgz）にエクスポートします。 - -その主な用途は、Support Bundleを一括ダウンロードする必要なく、{% data variables.contact.contact_ent_support %}のチームに仮想マシンのパフォーマンスに関するデータ提供することです。 定期的なバックアップエクスポートに含めてはなりません。また、その逆のインポートもありません。 {% data variables.contact.contact_ent_support %}に連絡したとき、問題解決を容易にするため、このデータが必要となる場合があります。 - -#### 使い方 - -```shell -ssh -p 122 admin@[hostname] -- 'ghe-export-graphs' && scp -P 122 admin@[hostname]:~/graphs.tar.gz . -``` - -### トラブルシューティング - -#### 中心の collectd サーバはデータを受信していない - -{% data variables.product.prodname_enterprise %}は、`collectd` の 5.x バージョンを標準装備しています。`collectd` 5.x は 4.x リリースのシリーズとの後方互換性はありません。 {% data variables.product.product_location_enterprise %}から送られるデータを受信するには、中心の`collectd`サーバは 5.x 以上のバージョンでなければなりません。 - -他に質問や問題がある場合、{% data variables.contact.contact_ent_support %}までお問い合わせください。 diff --git a/translations/ja-JP/content/admin/installation/configuring-dns-nameservers.md b/translations/ja-JP/content/admin/installation/configuring-dns-nameservers.md deleted file mode 100644 index c3cb107f9d42..000000000000 --- a/translations/ja-JP/content/admin/installation/configuring-dns-nameservers.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: DNSネームサーバの設定 -intro: '{% data variables.product.prodname_ghe_server %} は、動的ホスト構成プロトコル (DHCP) のリースがネームサーバーを提供するときに、DNS 設定に対して DHCP を使用します。 ネームサーバがDHCPのリースで提供されない場合、あるいは特定のDNS設定を使う必要がある場合は、手動でネームサーバを指定できます。' -redirect_from: - - /enterprise/admin/guides/installation/about-dns-nameservers/ - - /enterprise/admin/installation/configuring-dns-nameservers -versions: - enterprise-server: '*' ---- - -指定するネームサーバは、{% data variables.product.product_location_enterprise %}のホスト名を解決できなければなりません。 - -{% data reusables.enterprise_installation.changing-hostname-not-supported %} - -### 仮想マシンのコンソールを使ったネームサーバの設定 - -{% data reusables.enterprise_installation.open-vm-console-start %} -2. インスタンスに対してネームサーバーを設定します。 -{% data reusables.enterprise_installation.vm-console-done %} - -### 管理シェルを使ったネームサーバの設定 - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. ネームサーバーを編集するには、次を入力します: - ```shell - $ sudo vim /etc/resolvconf/resolv.conf.d/head - ``` -3. `nameserver` エントリを追加し、続いてファイルを保存します。 -4. 変更を確認したら、ファイルを保存します。 -5. 新しいネームサーバーエントリを {% data variables.product.product_location_enterprise %} に追加するには、次を入力します: - ```shell - $ sudo service resolvconf restart - ``` diff --git a/translations/ja-JP/content/admin/installation/configuring-git-large-file-storage-on-github-enterprise-server.md b/translations/ja-JP/content/admin/installation/configuring-git-large-file-storage-on-github-enterprise-server.md deleted file mode 100644 index a6db9c76e66d..000000000000 --- a/translations/ja-JP/content/admin/installation/configuring-git-large-file-storage-on-github-enterprise-server.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: GitHub Enterprise Server で Git Large File Storage を設定する -intro: '{% data reusables.enterprise_site_admin_settings.configuring-large-file-storage-short-description %}' -redirect_from: - - /enterprise/admin/guides/installation/configuring-git-large-file-storage-on-github-enterprise/ - - /enterprise/admin/installation/configuring-git-large-file-storage-on-github-enterprise-server -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/ja-JP/content/admin/installation/configuring-git-large-file-storage-to-use-a-third-party-server.md b/translations/ja-JP/content/admin/installation/configuring-git-large-file-storage-to-use-a-third-party-server.md deleted file mode 100644 index 7f1f934debd3..000000000000 --- a/translations/ja-JP/content/admin/installation/configuring-git-large-file-storage-to-use-a-third-party-server.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: サードパーティのサーバを使うGit Large File Storageの設定 -intro: '{% data variables.product.prodname_ghe_server %} アプライアンスで {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) を無効にし、大規模なアセットを保存するサーバーの URL で {% data variables.large_files.product_name_short %} クライアントを設定することで、サードパーティのサーバーで {% data variables.large_files.product_name_short %} を使用できます。' -redirect_from: - - /enterprise/admin/installation/configuring-git-large-file-storage-to-use-a-third-party-server -versions: - enterprise-server: '*' ---- - -{% data reusables.large_files.storage_assets_location %} -{% data reusables.large_files.rejected_pushes %} - -1. {% data variables.product.prodname_ghe_server %} アプライアンスで {% data variables.large_files.product_name_short %} を無効にします。 詳しい情報については"[{% data variables.large_files.product_name_long %}の設定](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-git-large-file-storage#configuring-git-large-file-storage-for-your-appliance)"を参照してください。 - -2. サードパーティのサーバーを指し示す {% data variables.large_files.product_name_short %} の設定ファイルを作成します。 - ```shell - # Show default configuration - $ git lfs env - > git-lfs/1.1.0 (GitHub; darwin amd64; go 1.5.1; git 94d356c) - > git version 2.7.4 (Apple Git-66) -   - > Endpoint=https://GITHUB-ENTERPRISE-HOST/path/to/repo/info/lfs (auth=basic) -   - # Create .lfsconfig that points to third party server. - $ git config -f .lfsconfig remote.origin.lfsurl https://THIRD-PARTY-LFS-SERVER/path/to/repo - $ git lfs env - > git-lfs/1.1.0 (GitHub; darwin amd64; go 1.5.1; git 94d356c) - > git version 2.7.4 (Apple Git-66) -   - > Endpoint=https://THIRD-PARTY-LFS-SERVER/path/to/repo/info/lfs (auth=none) -   - # Show the contents of .lfsconfig - $ cat .lfsconfig - [remote "origin"] - lfsurl = https://THIRD-PARTY-LFS-SERVER/path/to/repo - ``` - -3. 各ユーザーに対して同じ {% data variables.large_files.product_name_short %} の設定を維持するには、カスタムの `.lfsconfig` ファイルをリポジトリにコミットします。 - ```shell - $ git add .lfsconfig - $ git commit -m "Adding LFS config file" - ``` -3. 既存の {% data variables.large_files.product_name_short %} アセットを移行します。 詳細は「[異なる {% data variables.large_files.product_name_long %} サーバーへ移行する](/enterprise/{{ currentVersion }}/admin/guides/installation/migrating-to-a-different-git-large-file-storage-server)」を参照してください。 - -### 参考リンク - -- "[{% data variables.large_files.product_name_long %}について](/articles/about-git-large-file-storage/)" -- "[{% data variables.large_files.product_name_long %}の設定](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-git-large-file-storage)" -- "[異なる{% data variables.large_files.product_name_long %}サーバへの移行](/enterprise/{{ currentVersion }}/admin/guides/installation/migrating-to-a-different-git-large-file-storage-server)" -- [{% data variables.large_files.product_name_long %}プロジェクトサイト](https://git-lfs.github.com/) diff --git a/translations/ja-JP/content/admin/installation/configuring-git-large-file-storage.md b/translations/ja-JP/content/admin/installation/configuring-git-large-file-storage.md deleted file mode 100644 index cac02a26953b..000000000000 --- a/translations/ja-JP/content/admin/installation/configuring-git-large-file-storage.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: Git Large File Storage を設定する -intro: '[{% data variables.large_files.product_name_short %} をインストール](/articles/installing-git-large-file-storage/) したら、それをリポジトリ内の大容量ファイルに関連付ける必要かあります。' -redirect_from: - - /enterprise/admin/articles/configuring-git-large-file-storage-for-a-repository/ - - /enterprise/admin/articles/configuring-git-large-file-storage-for-every-repository-owned-by-a-user-account-or-organization/ - - /enterprise/admin/articles/configuring-git-large-file-storage-for-your-appliance/ - - /enterprise/admin/installation/configuring-git-large-file-storage -versions: - enterprise-server: '*' ---- - -### {% data variables.large_files.product_name_long %}について - -{% data reusables.enterprise_site_admin_settings.configuring-large-file-storage-short-description %} {% data variables.large_files.product_name_long %} は、単一のリポジトリ、個人または Organization のすべてのリポジトリ、あるいは {% data variables.product.product_location_enterprise %} 内のあらゆるリポジトリで使用できます。 アプライアンスに対して {% data variables.large_files.product_name_short %} を事前に有効にしなければ、特定のリポジトリまたは Organization に対して {% data variables.large_files.product_name_short %} を有効にすることはできません。 - -{% data reusables.large_files.storage_assets_location %} -{% data reusables.large_files.rejected_pushes %} - -詳しい情報については"[{% data variables.large_files.product_name_long %}について](/articles/about-git-large-file-storage)"、"[大きなファイルのバージョニング](/enterprise/user/articles/versioning-large-files/)" 、[{% data variables.large_files.product_name_long %}プロジェクトサイト](https://git-lfs.github.com/)を参照してください。 - -### アプライアンス用に {% data variables.large_files.product_name_long %} を設定する - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -4. [{% data variables.large_files.product_name_short %} access]で、ドロップダウンメニューを使用して [**Enabled**] または [**Disabled**] をクリックします。 ![Git LFSアクセス](/assets/images/enterprise/site-admin-settings/git-lfs-admin-center.png) - -### 個々のリポジトリ用に {% data variables.large_files.product_name_long %} を設定する - -{% data reusables.enterprise_site_admin_settings.override-policy %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -{% data reusables.enterprise_site_admin_settings.git-lfs-toggle %} - -### ユーザーアカウントまたは Organization が所有するすべてのリポジトリ用に {% data variables.large_files.product_name_long %} を設定する - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.search-user-or-org %} -{% data reusables.enterprise_site_admin_settings.click-user-or-org %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -{% data reusables.enterprise_site_admin_settings.git-lfs-toggle %} diff --git a/translations/ja-JP/content/admin/installation/configuring-github-enterprise-server-for-high-availability.md b/translations/ja-JP/content/admin/installation/configuring-github-enterprise-server-for-high-availability.md deleted file mode 100644 index 8032c0eca5fe..000000000000 --- a/translations/ja-JP/content/admin/installation/configuring-github-enterprise-server-for-high-availability.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: High Availability 用に GitHub Enterprise Server を設定する -redirect_from: - - /enterprise/admin/guides/installation/high-availability-cluster-configuration/ - - /enterprise/admin/guides/installation/high-availability-configuration/ - - /enterprise/admin/guides/installation/configuring-github-enterprise-for-high-availability/ - - /enterprise/admin/installation/configuring-github-enterprise-server-for-high-availability -intro: '{% data variables.product.prodname_ghe_server %} は、プライマリアプライアンスに影響を及ぼすハードウェア障害や重大なネットワーク障害が発生した場合に、サービスの中断を最小限に抑えるように設計された、運用の High Availability モードをサポートしています。' -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/ja-JP/content/admin/installation/configuring-github-pages-on-your-appliance.md b/translations/ja-JP/content/admin/installation/configuring-github-pages-on-your-appliance.md deleted file mode 100644 index 033dbc1195cc..000000000000 --- a/translations/ja-JP/content/admin/installation/configuring-github-pages-on-your-appliance.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: アプライアンス上でのGitHub Pagesの設定 -intro: 'インスタンスで {% data variables.product.prodname_pages %} ページを有効または無効にすることができます。 {% data variables.product.prodname_pages %} サイトを公開するように選択することもできます。' -redirect_from: - - /enterprise/admin/guides/installation/disabling-github-enterprise-pages/ - - /enterprise/admin/guides/installation/configuring-github-enterprise-pages/ - - /enterprise/admin/installation/configuring-github-pages-on-your-appliance -versions: - enterprise-server: '*' ---- - -### {% data variables.product.prodname_pages %}の公開 - -インスタンスでプライベートモードが有効化されている場合、{% data variables.product.product_location_enterprise %}でホストされている{% data variables.product.prodname_pages %}は公開されていません。 - -{% warning %} - -**注意:** 公開{% data variables.product.prodname_pages %}サイトを有効化すると、インスタンス中のすべてのリポジトリのすべての{% data variables.product.prodname_pages %}サイトが公開されます。 - -{% endwarning %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.pages-tab %} -4. **Public Pages（公開ページ）**を選択してください。 ![[Public Pages] を有効化するチェックボックス](/assets/images/enterprise/management-console/public-pages-checkbox.png) -{% data reusables.enterprise_management_console.save-settings %} - -### {% data variables.product.product_location_enterprise %}での{% data variables.product.prodname_pages %}の無効化 - -{% data variables.product.product_location_enterprise %}のSubdomain Isolationが無効化されているなら、{% data variables.product.prodname_pages %}も無効化し、潜在的なセキュリティの脆弱性に対する保護をすべきです。 詳しい情報については"[Subdomain Isolationの有効化](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-subdomain-isolation)"を参照してください。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.pages-tab %} -4. **Enable Pages（ページの有効化）**の選択を解除してください。 ![{% data variables.product.prodname_pages %} を無効化するチェックボックス](/assets/images/enterprise/management-console/pages-select-button.png) -{% data reusables.enterprise_management_console.save-settings %} - -### 参考リンク - -- "[プライベートモードの有効化](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-private-mode)" diff --git a/translations/ja-JP/content/admin/installation/configuring-rate-limits.md b/translations/ja-JP/content/admin/installation/configuring-rate-limits.md deleted file mode 100644 index 8626fc80f2fc..000000000000 --- a/translations/ja-JP/content/admin/installation/configuring-rate-limits.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: レート制限の設定 -intro: '{% data variables.enterprise.management_console %} を使用することで、{% data variables.product.prodname_ghe_server %} のレート制限を設定できます。' -redirect_from: - - /enterprise/admin/installation/configuring-rate-limits -versions: - enterprise-server: '*' ---- - -### {% data variables.product.prodname_enterprise_api %}のレート制限の有効化 - -{% data variables.product.prodname_enterprise_api %}のレート制限を有効化すれば、個人あるいは認証されていないユーザによるリソースの過剰な利用を回避できます。 For more information, see "[Rate Limiting](/enterprise/{{ currentVersion }}/v3/#rate-limiting)." - -{% note %} - -**ノート:** {% data variables.enterprise.management_console %}は、各レート制限の時間間隔（毎分もしくは毎時）をリストします。 - -{% endnote %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -2. "Rate Limiting（レート制限）"の下で**Enable API Rate Limiting（APIレート制限の有効化）**を選択してください。 ![API レート制限を有効にするためのチェックボックス](/assets/images/enterprise/management-console/api-rate-limits-checkbox.png) -3. 各APIについて認証済み及び非認証リクエストの制限を入力するか、事前に入力されているデフォルトの制限を承認してください。 -{% data reusables.enterprise_management_console.save-settings %} - -### 不正利用レート制限の有効化 - -不正利用レート制限を設定すれば、{% data variables.product.product_location_enterprise %}上のサービスの全体のレベルを保護できます。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -2. "Rate Limiting（レート制限）"の下で**Enable Abuse Rate Limiting（不正利用レート制限の有効化）**を選択してください。 ![不正利用レート制限を有効にするためのチェックボックス](/assets/images/enterprise/management-console/abuse-rate-limits-checkbox.png) -3. 総リクエストの制限、CPU制限、検索のためのCPU制限を入力するか、事前に入力されているデフォルトの制限を承認してください。 -{% data reusables.enterprise_management_console.save-settings %} - -### Gitレート制限の有効化 - -リポジトリネットワークごとまたはユーザー ID ごとに Git レート制限を適用できます。 Git レート制限は 1 分あたりの同時操作数で表現され、現在の CPU 負荷に適応します。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -2. "Rate Limiting（レート制限）"の下で**Enable Git Rate Limiting（Gitレート制限の有効化）**を選択してください。 ![Git レート制限を有効にするためのチェックボックス](/assets/images/enterprise/management-console/git-rate-limits-checkbox.png) -3. リポジトリネットワークまたはユーザ ID ごとの制限を入力してください。 ![リポジトリネットワークとユーザ ID 制限のフィールド](/assets/images/enterprise/management-console/example-git-rate-limits.png) -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/ja-JP/content/admin/installation/configuring-the-default-visibility-of-new-repositories-on-your-appliance.md b/translations/ja-JP/content/admin/installation/configuring-the-default-visibility-of-new-repositories-on-your-appliance.md deleted file mode 100644 index 9ae696ac2398..000000000000 --- a/translations/ja-JP/content/admin/installation/configuring-the-default-visibility-of-new-repositories-on-your-appliance.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: アプライアンスにおける新しいリポジトリのデフォルトの可視性の設定 -intro: 'Web インターフェースを使って {% data variables.product.prodname_ghe_server %} アプライアンス上に作成される新しいすべてのリポジトリに対するデフォルトの可視性は、パブリックまたはプライベートに設定できます。' -redirect_from: - - /enterprise/admin/installation/configuring-the-default-visibility-of-new-repositories-on-your-appliance -versions: - enterprise-server: '*' ---- - -{% data variables.product.product_location_enterprise %}上に新しいリポジトリを作るときには、そのリポジトリの可視性を選択しなければなりません。 そのインタンスのデフォルトの可視性の設定をする際には、デフォルトで選択される可視性を選択します。 リポジトリの可視性に関する詳しい情報については、「[リポジトリの可視性について](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)」を参照してください。 - -サイト管理者がメンバーに対して特定の種類のリポジトリの作成を禁止している場合、可視性の設定のデフォルトがその種類になっていても、メンバーはその種類のリポジトリを作成できません。 詳しい情報については、「[インスタンスでリポジトリ作成を制限する](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)」を参照してください。 - -{% tip %} - -**Tip:** リポジトリの可視性を変更できる能力をサイト管理者のみに制限できます。 詳しい情報については"[ユーザによるリポジトリの可視性の変更の禁止](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-a-repository-s-visibility)."を参照してください。 - -{% endnote %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -1. "Default repository visibility（デフォルトのリポジトリの可視性）"の下で、ドロップダウンメニューを使ってデフォルトの可視性を選択してください。![インスタンスにおけるデフォルトのリポジトリの可視化性を選択するためのドロップダウンメニュー](/assets/images/enterprise/site-admin-settings/default-repository-visibility-settings.png) - -{% data reusables.enterprise_installation.image-urls-viewable-warning %} diff --git a/translations/ja-JP/content/admin/installation/configuring-the-github-enterprise-server-appliance.md b/translations/ja-JP/content/admin/installation/configuring-the-github-enterprise-server-appliance.md deleted file mode 100644 index 96dc3a42997b..000000000000 --- a/translations/ja-JP/content/admin/installation/configuring-the-github-enterprise-server-appliance.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: GitHub Enterprise Server アプライアンスを設定する -intro: '{% data variables.product.prodname_ghe_server %} が起動して作動し始めたら、Organization のニーズに合わせてアプライアンスを設定できます。' -redirect_from: - - /enterprise/admin/guides/installation/basic-configuration/ - - /enterprise/admin/guides/installation/administrative-tools/ - - /enterprise/admin/articles/restricting-ssh-access-to-specific-hosts/ - - /enterprise/admin/guides/installation/configuring-the-github-enterprise-appliance/ - - /enterprise/admin/installation/configuring-the-github-enterprise-server-appliance -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/ja-JP/content/admin/installation/configuring-the-ip-address-using-the-virtual-machine-console.md b/translations/ja-JP/content/admin/installation/configuring-the-ip-address-using-the-virtual-machine-console.md deleted file mode 100644 index 7bf073a111ba..000000000000 --- a/translations/ja-JP/content/admin/installation/configuring-the-ip-address-using-the-virtual-machine-console.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: 仮想マシンのコンソールを使ったIPアドレスの設定 -intro: 'デフォルトでは、{% data variables.product.prodname_ghe_server %} は動的ホスト構成プロトコル (DHCP) を通じてネットワーク設定を取得します。 利用するプラットフォームでサポートされている場合、あるいはDHCPが利用できない場合、ネットワーク設定を仮想マシンのコンソールを使って設定することもできます。' -redirect_from: - - /enterprise/admin/installation/configuring-the-ip-address-using-the-virtual-machine-console -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_installation.open-vm-console-start %} -3. `IPv4`あるいは`IPv6`プロトコルの設定を選択してください。 ![IPv4 または IPv6 プロトコルを選択するためのオプション](/assets/images/enterprise/network-configuration/IPv4-or-IPv6-protocol.png) -4. 選択したプロトコルのオプションを設定してください。 ![IP プロトコルオプションのメニュー](/assets/images/enterprise/network-configuration/network-settings-selection.png) -{% data reusables.enterprise_installation.vm-console-done %} diff --git a/translations/ja-JP/content/admin/installation/configuring-time-synchronization.md b/translations/ja-JP/content/admin/installation/configuring-time-synchronization.md deleted file mode 100644 index d8b68c849055..000000000000 --- a/translations/ja-JP/content/admin/installation/configuring-time-synchronization.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: 時間の同期の設定 -intro: '{% data variables.product.prodname_ghe_server %} は、NTP サーバーに接続することによって自動的に時刻を同期させます。 時刻の同期に使われるNTPサーバは設定できます。あるいはデフォルトのNTPサーバを利用することもできます。' -redirect_from: - - /enterprise/admin/articles/adjusting-the-clock/ - - /enterprise/admin/articles/configuring-time-zone-and-ntp-settings/ - - /enterprise/admin/articles/setting-ntp-servers/ - - /enterprise/admin/categories/time/ - - /enterprise/admin/installation/configuring-time-synchronization -versions: - enterprise-server: '*' ---- - -### デフォルトのNTPサーバの変更 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -2. 左のサイドバーで**Time（時間）**をクリックしてください。 ![{% data variables.enterprise.management_console %} サイドバーでの [Time] ボタン](/assets/images/enterprise/management-console/sidebar-time.png) -3. "Primary NTP server（プライマリのNTPサーバ）"の下で、プライマリNTPサーバのホスト名を入力してください。 "Secondary NTP server（セカンダリのNTPサーバ）"の下で、セカンダリのNTPサーバのホスト名を入力してください。 ![{% data variables.enterprise.management_console %} でのプライマリとセカンダリの NTP サーバーのためのフィールド](/assets/images/enterprise/management-console/ntp-servers.png) -4. ページの下部で **Save settings（設定の保存）**をクリックしてください。 ![{% data variables.enterprise.management_console %} での [Save settings] ボタン](/assets/images/enterprise/management-console/save-settings.png) -5. 設定が完了するのを待ってください。 - -### 大きな時間の乱れの修正 - -NTP プロトコルは小さな時間同期の不一致を継続的に修正します。 管理シェルを使用すれば、時間を直ちに同期させることができます。 - -{% note %} - -**注釈:** - - 協定世界時 (UTC) ゾーンは変更できません。 - - ハイパーバイザーが仮想マシンの時刻を設定しようとするのを回避しなければなりません。 詳しい情報については、仮想化プロバイダが提供しているドキュメンテーションを参照してください。 - -{% endnote %} - -- `chronyc` コマンドを使用して、サーバーを設定済みの NTP サーバーと同期させます。 例: - -```shell -$ sudo chronyc -a makestep -``` diff --git a/translations/ja-JP/content/admin/installation/configuring-tls.md b/translations/ja-JP/content/admin/installation/configuring-tls.md deleted file mode 100644 index 25ca4c287597..000000000000 --- a/translations/ja-JP/content/admin/installation/configuring-tls.md +++ /dev/null @@ -1,69 +0,0 @@ ---- -title: TLSの設定 -intro: '信頼できる認証機関によって署名された証明書を使用できるように、{% data variables.product.product_location_enterprise %} で Transport Layer Security (TLS) を設定できます。' -redirect_from: - - /enterprise/admin/articles/ssl-configuration/ - - /enterprise/admin/guides/installation/about-tls/ - - /enterprise/admin/installation/configuring-tls -versions: - enterprise-server: '*' ---- - -### Transport Layer Securityについて - -SSL に代わる TLS は、{% data variables.product.prodname_ghe_server %} の初回起動時に有効になり、自己署名証明書で設定されます。 自己署名証明書は Web ブラウザや Git クライアントから信頼されていないため、TLS を無効にするか、Let's Encrypt などの信頼できる機関によって署名された証明書をアップロードするまで、これらのクライアントは証明書の警告を報告します。 - -SSL が有効な場合、{% data variables.product.prodname_ghe_server %} アプライアンスは HTTP Strict Transport Security ヘッダーを送信します。 TLSを無効化すると、ブラウザはHTTPへのプロトコルダウングレードを許さないので、ユーザはアプライアンスにアクセスできなくなります。 詳しい情報についてはWikipediaの"[HTTP Strict Transport Security](https://ja.wikipedia.org/wiki/HTTP_Strict_Transport_Security)"を参照してください。 - -{% data reusables.enterprise_installation.terminating-tls %} - -ユーザが2要素認証のFIDO U2Fを利用できるようにするには、インスタンスでTLSを有効化しなければなりません。 詳しい情報については「[2 要素認証の設定](/articles/configuring-two-factor-authentication)」を参照してください。 - -### 必要な環境 - -プロダクションでTLSを利用するには、暗号化されていないPEMフォーマットで、信頼済みの証明書認証局によって署名された証明書がなければなりません。 - -また、証明書には"[Subdomain Isolationの有効化](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-subdomain-isolation#about-subdomain-isolation)"のリストにあるサブドメインに設定されたSubject Alternative Namesが必要で、中間証明書認証局によって署名されたものであれば、完全な証明書チェーンを含んでいる必要があります。 詳しい情報についてはWikipediaの"[Subject Alternative Name](http://en.wikipedia.org/wiki/SubjectAltName)"を参照してください。 - -`ghe-ssl-generate-csr` コマンドを使用すれば、インスタンス用の証明書署名要求 (CSR) を生成できます。 詳しい情報については、「[コマンドラインユーティリティ](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities/#ghe-ssl-generate-csr)」を参照してください。 - -### カスタムのTLS証明書のアップロード - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -{% data reusables.enterprise_management_console.select-tls-only %} -4. [TLS Protocol support] で、許可するプロトコルを選択します。 ![TLS プロトコルを選択するオプションを備えたラジオボタン](/assets/images/enterprise/management-console/tls-protocol-support.png) -5. "Certificate（証明書）"の下で**Choose File（ファイルの選択）**をクリックし、インストールしたいTLS証明書もしくは証明書チェーン（PEMフォーマット）を選択してください。 このファイルは通常、*.pem*、*.crt*、*.cer* といった拡張子を持ちます。 ![TLS 証明書ファイルを見つけるためのボタン](/assets/images/enterprise/management-console/install-tls-certificate.png) -6. "Unencrypted key（暗号化されていない鍵）"の下で**Choose File（ファイルの選択）**をクリックし、インストールするTLS鍵（PEMフォーマット）を選択してください。 このファイルは通常*.key*という拡張子を持ちます。 ![TLS鍵ファイルを見つけるためのボタン](/assets/images/enterprise/management-console/install-tls-key.png) - - {% warning %} - - **警告**: このTLS鍵はパスフレーズを持っていてはなりません。 詳しい情報については"[キーファイルからのパスフレーズの除去](/enterprise/{{ currentVersion }}/admin/guides/installation/troubleshooting-ssl-errors#removing-the-passphrase-from-your-key-file)"を参照してください。 - - {% endwarning %} -{% data reusables.enterprise_management_console.save-settings %} - -### Let's Encryptのサポートについて - -Let's Encryptは公開の証明書認証者で、ACMEプロトコルを使ってブラウザが信頼するTLS証明書を、無料で自動的に発行してくれます。 アプライアンスのためのLet's Encryptの証明書は、手動のメンテナンスを必要とせず自動的に取得及び更新できます。 - -{% data reusables.enterprise_installation.lets-encrypt-prerequisites %} - -Let's Encryptを使ったTLS証明書管理の自動化を有効にすると、{% data variables.product.product_location_enterprise %}はLet's Encryptのサーバに接続して証明書を取得します。 証明書を更新するには、Let's EncryptのサーバはインバウンドのHTTPリクエストで設定されたドメイン名の制御を検証しなければなりません。 - -また、{% data variables.product.product_location_enterprise %}上でコマンドラインユーティリティの`ghe-ssl-acme`を使っても、自動的にLet's Encryptの証明書を生成できます。 詳細は「[コマンドラインユーティリティ](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities#ghe-ssl-acme)」を参照してください。 - -### Let's Encryptを使ったTLSの設定 - -{% data reusables.enterprise_installation.lets-encrypt-prerequisites %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -{% data reusables.enterprise_management_console.select-tls-only %} -5. **Enable automation of TLS certificate management using Let's Encrypt（Let's Encryptを使った自動的なTLS証明書管理の有効化）**を選択してください。 ![[Let's Encrypt] を有効化するチェックボックス](/assets/images/enterprise/management-console/lets-encrypt-checkbox.png) -{% data reusables.enterprise_management_console.save-settings %} -{% data reusables.enterprise_management_console.privacy %} -7. **Request TLS certificate（TLS証明書のリクエスト）**をクリックしてください。 ![[Request TLS certificate] ボタン](/assets/images/enterprise/management-console/request-tls-button.png) -8. **Save configuration（設定の保存）**をクリックしてください。 diff --git a/translations/ja-JP/content/admin/installation/configuring-your-github-enterprise-server-network-settings.md b/translations/ja-JP/content/admin/installation/configuring-your-github-enterprise-server-network-settings.md deleted file mode 100644 index 07a1ba71271a..000000000000 --- a/translations/ja-JP/content/admin/installation/configuring-your-github-enterprise-server-network-settings.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: GitHub Enterprise Server ネットワークを設定する -redirect_from: - - /enterprise/admin/guides/installation/dns-hostname-subdomain-isolation-and-ssl/ - - /enterprise/admin/articles/about-dns-ssl-and-subdomain-settings/ - - /enterprise/admin/articles/configuring-dns-ssl-and-subdomain-settings/ - - /enterprise/admin/guides/installation/configuring-your-github-enterprise-network-settings/ - - /enterprise/admin/installation/configuring-your-github-enterprise-server-network-settings -intro: 'ネットワークで必要な DNS ネームサーバーとホスト名を使用して {% data variables.product.prodname_ghe_server %} を設定します。 プロキシサーバあるいはファイアウォールルールを設定することもできます。 管理及びユーザのために特定のポートへのアクセスを許可しなければなりません。' -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/ja-JP/content/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud.md b/translations/ja-JP/content/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud.md deleted file mode 100644 index 04b8c8ce028e..000000000000 --- a/translations/ja-JP/content/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud.md +++ /dev/null @@ -1,62 +0,0 @@ ---- -title: GitHub Enterprise ServerからGitHub Enterprise Cloudに接続する -intro: '{% data variables.product.prodname_github_connect %}を有効化すると、特定の機能やワークフローを{% data variables.product.product_location_enterprise %}と{% data variables.product.prodname_ghe_cloud %}のOrganizationの間で共有できます。' -redirect_from: - - /enterprise/admin/guides/developer-workflow/connecting-github-enterprise-to-github-com/ - - /enterprise/admin/guides/developer-workflow/connecting-github-enterprise-server-to-github-com - - /enterprise/admin/developer-workflow/connecting-github-enterprise-server-to-githubcom/ - - /enterprise/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud -permissions: '{% data variables.product.prodname_ghe_cloud %}のOrganizationあるいはEnterpriseアカウントの所有者でもある{% data variables.product.prodname_ghe_server %}のサイト管理者は、{% data variables.product.prodname_github_connect %}を有効化できます。' -versions: - enterprise-server: '*' ---- - -### {% data variables.product.prodname_github_connect %} について - -{% data variables.product.prodname_github_connect %}を有効化するには、{% data variables.product.product_location_enterprise %}と{% data variables.product.prodname_ghe_cloud %} のOrganizationまたはEnterpriseアカウントの両方で接続を設定しなければなりません。 - -接続を設定するには、プロキシの設定で`github.com` および `api.github.com` への接続が許可されていなければなりません。 詳細は「[アウトバウンド Web プロキシサーバーを設定する](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-an-outbound-web-proxy-server)」を参照してください。 - -{% data variables.product.prodname_github_connect %}を有効化すると、Unified Searchや統合コントリビューションといった機能を使用できるようになります。 使用できるすべての機能についての詳細は、「[ {% data variables.product.prodname_ghe_server %}と{% data variables.product.prodname_ghe_cloud %}の間の接続を管理する](/enterprise/{{ currentVersion }}/admin/installation/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud)」を参照してください。 - -{% data variables.product.product_location_enterprise %}を{% data variables.product.prodname_ghe_cloud %}に接続すると、{% data variables.product.prodname_dotcom_the_website %}上のレコードに、接続に関する情報が保存されます: -- {% data variables.product.prodname_ghe_server %} ライセンスの公開鍵の部分 -- {% data variables.product.prodname_ghe_server %} ライセンスのハッシュ -- {% data variables.product.prodname_ghe_server %} ライセンスの顧客名 -- {% data variables.product.product_location_enterprise %} のホスト名 -- {% data variables.product.product_location_enterprise %} のバージョン -- {% data variables.product.product_location_enterprise %}に接続している{% data variables.product.prodname_dotcom_the_website %}上のOrganizationまたはEnterpriseアカウント -- {% data variables.product.prodname_dotcom_the_website %} へのリクエストの発行に {% data variables.product.product_location_enterprise %} が使用する認証トークン - -{% data variables.product.prodname_github_connect %}を有効化すると、{% data variables.product.prodname_ghe_cloud %}のOrganizationまたはEnterpriseアカウントが所有している{% data variables.product.prodname_github_app %}も作成されます。 {% data variables.product.prodname_ghe_server %} は {% data variables.product.prodname_github_app %} のクレデンシャルを使って {% data variables.product.prodname_dotcom_the_website %} へのリクエストを発行します。 - -{% data variables.product.prodname_ghe_server %} は {% data variables.product.prodname_github_app %} からのクレデンシャルを保存します。 以下のクレデンシャルは、High Availability あるいはクラスタリング環境ではレプリケーションされ、{% data variables.product.prodname_enterprise_backup_utilities %} が作成するスナップショットを含むあらゆるバックアップに保存されます。 -- 1 時間にわたって有効な認証トークン -- 新しい認証トークンを生成するのに使われる秘密鍵 - -{% data variables.product.prodname_github_connect %} を有効化しても、{% data variables.product.prodname_dotcom_the_website %} のユーザは {% data variables.product.prodname_ghe_server %} を変更できるようになりません。 - -{% if currentVersion ver_gt "enterprise-server@2.18" %} -For more information about managing enterprise accounts using the GraphQL API, see "[Enterprise accounts](/v4/guides/managing-enterprise-accounts)." -{% endif %} -### {% data variables.product.prodname_github_connect %} の有効化 - -1. {% data variables.product.product_location_enterprise %}と{% data variables.product.prodname_dotcom_the_website %}にサインインしてください。 -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %} -5. 「{% data variables.product.prodname_dotcom_the_website %} is not enabled yet」の下で、「**Enable{% data variables.product.prodname_github_connect %}**」をクリックします。 「**Enable {% data variables.product.prodname_github_connect %}**,」をクリックすると、 {% data variables.product.prodname_enterprise %} ライセンスアグリーメントの {% data variables.product.prodname_github_connect %} に関する補遺に合意したことになります。 ![「Enable GitHub Connect」ボタン](/assets/images/enterprise/business-accounts/enable-github-connect-button.png) -6. 接続したいEnterpriseアカウントまたはOrganizationの横にある「**Connect**」をクリックします。 ![Enterprise アカウントまたはビジネスアカウントの横にある [Connect] ボタン](/assets/images/enterprise/business-accounts/choose-enterprise-or-org-connect.png) - -### {% data variables.product.product_location_enterprise %}{% data variables.product.prodname_ghe_cloud %}OrganizationまたはEnterpriseアカウントを切断する - -{% data variables.product.prodname_ghe_cloud %}から切断すると、EnterpriseアカウントまたはOrganizationから{% data variables.product.prodname_github_connect %}{% data variables.product.prodname_github_app %}が削除され、{% data variables.product.product_location_enterprise %}に保存されているクレデンシャルが削除されます。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %} -5. 切断しようとするEnterpriseアカウントまたはOrganizationの横にある「**Disable {% data variables.product.prodname_github_connect %}**」をクリックします。 ![EnterpriseアカウントまたはOrganization名の横にある「Disable GitHub Connect」ボタン](/assets/images/enterprise/business-accounts/disable-github-connect-button.png) -6. 切断に関する情報を読み、「 **Disable {% data variables.product.prodname_github_connect %}**」をクリックします。 ![切断に関する警告情報が表示され確定ボタンがあるモーダル](/assets/images/enterprise/business-accounts/confirm-disable-github-connect.png) - diff --git a/translations/ja-JP/content/admin/installation/creating-a-high-availability-replica.md b/translations/ja-JP/content/admin/installation/creating-a-high-availability-replica.md deleted file mode 100644 index c0d9a9fe0e2b..000000000000 --- a/translations/ja-JP/content/admin/installation/creating-a-high-availability-replica.md +++ /dev/null @@ -1,101 +0,0 @@ ---- -title: High Availabilityレプリカの作成 -intro: アクティブ／パッシブ設定では、レプリカアプライアンスはプライマリアプライアンスの冗長コピーです。 プライマリアプライアンスに障害が起こると、High Availabilityモードではレプリカがプライマリアプライアンスとして動作し、サービスの中断を最小限にできます。 -redirect_from: - - /enterprise/admin/installation/creating-a-high-availability-replica -versions: - enterprise-server: '*' ---- - -### High Availabilityレプリカの作成 - -1. 新しい {% data variables.product.prodname_ghe_server %} アプライアンスを希望するプラットフォームにセットアップします。 レプリカアプライアンスのCPU、RAM、ストレージ設定は、プライマリアプライアンスと同じにするべきです。 レプリカアプライアンスは、独立した環境にインストールすることをお勧めします。 下位層のハードウェア、ソフトウェア、ネットワークコンポーネントは、プライマリアプライアンスのそれらとは分離されているべきです。 クラウドプロバイダを利用している場合には、別個のリージョンもしくはゾーンを使ってください。 詳細は「["{% data variables.product.prodname_ghe_server %} インスタンスをセットアップする](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-github-enterprise-server-instance)」を参照してください。 -2. ブラウザで新しいレプリカアプライアンスのIPアドレスにアクセスして、所有する{% data variables.product.prodname_enterprise %}のライセンスをアップロードしてください。 -3. プライマリアプライアンス上のパスワードと一致する管理者パスワードを設定して続行します。 -4. **Configure as Replica（レプリカとして設定）**をクリックしてください。 ![新しいインスタンスをレプリカとして設定するリンクを持つインストールオプション](/assets/images/enterprise/management-console/configure-as-replica.png) -5. "Add new SSH key（新しいSSH鍵の追加）"の下でSSH鍵を入力してください。 ![SSHキーの追加](/assets/images/enterprise/management-console/add-ssh-key.png) -6. **Add key（鍵の追加）**をクリックし、続いて**Continue（続ける）**をクリックしてください。 -6. SSHを使ってレプリカアプライアンスのIPアドレスに接続してください。 - ```shell - $ ssh -p 122 admin@REPLICA IP - ``` -7. レプリケーション用の鍵ペアを生成するには、プライマリアプライアンスの IP アドレスを指定した `ghe-repl-setup` コマンドを使用し、そのコマンドが返す公開鍵をコピーします。 - ```shell - $ ghe-repl-setup PRIMARY IP - ``` -{% data reusables.enterprise_installation.add-ssh-key-to-primary %} -9. プライマリへの接続を確認し、新しいレプリカのレプリカモードを有効にするには、`ghe-repl-setup` をもう一度実行します。 - ```shell - $ ghe-repl-setup PRIMARY IP - ``` -{% data reusables.enterprise_installation.replication-command %} -11. 各データストアのレプリケーションチャネルのステータスを確認するには、`ghe-repl-status` コマンドを使用します。 - ```shell - $ ghe-repl-status - ``` - -### Geo-replicationレプリカの作成 - -レプリカを作成する以下の例の設定では、1 つのプライマリと 2 つのレプリカを使用しており、これらは 3 つの異なる地域にあります。 3 つのノードは別のネットワークに配置できますが、すべてのノードは他のすべてのノードから到達可能である必要があります。 最低限、必要な管理ポートは他のすべてのノードに対して開かれている必要があります。 ポートの要件に関する詳しい情報については、「[ネットワークポート](/enterprise/{{ currentVersion }}/admin/guides/installation/network-ports/#administrative-ports)」を参照してください。 - -1. 最初のレプリカで `ghe-repl-setup` を実行することで、標準の 2 ノード構成の場合と同じ方法で最初のレプリカを作成します。 - ```shell - (replica1)$ ghe-repl-setup PRIMARY IP - (replica1)$ ghe-repl-start - ``` -2. 2 番目のレプリカを作成して、`ghe-repl-setup --add` コマンドを使用します。 `--add` フラグは、既存のレプリケーション設定を上書きするのを防ぎ、新しいレプリカを設定に追加します。 - ```shell - (replica2)$ ghe-repl-setup --add PRIMARY IP - (replica2)$ ghe-repl-start - ``` -3. デフォルトでは、レプリカは同じデータセンターに設定され{% if currentVersion ver_gt "enterprise-server@2.17" %}、同じノードにある既存のノードからシードを試行し{% endif %}ます。 レプリカを別のデータセンターに設定するには、datacenter オプションに異なる値を設定します。 具体的な値は、それらが互いに異なる限り、どのようなものでもかまいません。 各ノードで `ghe-repl-node` コマンドを実行し、データセンターを指定します。 - - プライマリでは以下のコマンドを実行します。 - ```shell - (primary)$ ghe-repl-node --datacenter [PRIMARY DC NAME] - ``` - 1 番目のレプリカでは以下のコマンドを実行します。 - ```shell - (replica1)$ ghe-repl-node --datacenter [FIRST REPLICA DC NAME] - ``` - 2 番目のレプリカでは以下のコマンドを実行します。 - ```shell - (replica2)$ ghe-repl-node --datacenter [SECOND REPLICA DC NAME] - ``` - {% tip %} - - **ヒント:** `--datacenter` と `--active` のオプションは同時に設定できます。 - - {% endtip %} -4. アクティブなレプリカノードは、アプライアンスデータのコピーを保存し、エンドユーザーのリクエストに応じます。 アクティブではないノードは、アプライアンスデータのコピーを保存しますが、エンドユーザーのリクエストに応じることはできません。 `--active` フラグを使用してアクティブモードを有効にするか、`--inactive` フラグを使用して非アクティブモードを有効にします。 - - 1 番目のレプリカでは以下のコマンドを実行します。 - ```shell - (replica1)$ ghe-repl-node --active - ``` - 2 番目のレプリカでは以下のコマンドを実行します。 - ```shell - (replica2)$ ghe-repl-node --active - ``` -5. 設定を適用するには、プライマリで `ghe-config-apply` コマンドを使用します。 - ```shell - (primary)$ ghe-config-apply - ``` - -### Geo-replicationのためのDNSの設定 - -プライマリとレプリカノードの IP アドレスを使って、Geo DNS を設定します。 SSH でプライマリノードにアクセスしたり、`backup-utils` でバックアップするために、プライマリノード (たとえば、`primary.github.example.com`) に対して DNS CNAME を作成することもできます。 - -テストのために、ローカルワークステーションの `hosts` ファイル (たとえば、`/etc/hosts`) にエントリを追加することができます。 以下の例のエントリでは、`HOSTNAME` に対するリクエストが `replica2` に決定されることになります。 別の行をコメントアウトすることで、特定のホストをターゲットにすることができます。 - -``` -# HOSTNAME -# HOSTNAME - HOSTNAME -``` - -### 参考リンク - -- "[High Availability設定について](/enterprise/{{ currentVersion }}/admin/guides/installation/about-high-availability-configuration)" -- "[レプリケーション管理のユーティリティ](/enterprise/{{ currentVersion }}/admin/guides/installation/about-high-availability-configuration/#utilities-for-replication-management)" -- 「[Geo-replication について](/enterprise/{{ currentVersion }}/admin/guides/installation/about-geo-replication/)」 diff --git a/translations/ja-JP/content/admin/installation/disabling-git-ssh-access-on-github-enterprise-server.md b/translations/ja-JP/content/admin/installation/disabling-git-ssh-access-on-github-enterprise-server.md deleted file mode 100644 index d2e8db63e3ca..000000000000 --- a/translations/ja-JP/content/admin/installation/disabling-git-ssh-access-on-github-enterprise-server.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: GitHub Enterprise Server で Git SSH アクセスを無効化する -redirect_from: - - /enterprise/admin/hidden/disabling-ssh-access-for-a-user-account/ - - /enterprise/admin/articles/disabling-ssh-access-for-a-user-account/ - - /enterprise/admin/hidden/disabling-ssh-access-for-your-appliance/ - - /enterprise/admin/articles/disabling-ssh-access-for-your-appliance/ - - /enterprise/admin/hidden/disabling-ssh-access-for-an-organization/ - - /enterprise/admin/articles/disabling-ssh-access-for-an-organization/ - - /enterprise/admin/hidden/disabling-ssh-access-to-a-repository/ - - /enterprise/admin/articles/disabling-ssh-access-to-a-repository/ - - /enterprise/admin/guides/installation/disabling-git-ssh-access-on-github-enterprise/ - - /enterprise/admin/installation/disabling-git-ssh-access-on-github-enterprise-server -intro: '{% data variables.product.product_location_enterprise %} で、特定のまたはすべてのリポジトリに対して、人々が Git over SSH を使えないようにすることができます。' -versions: - enterprise-server: '*' ---- - -### 特定のリポジトリへのGit SSHアクセスの無効化 - -{% data reusables.enterprise_site_admin_settings.override-policy %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -1. [Git SSH access] で、ドロップダウンメニューを使用して [**Disabled**] を選択します。 ![無効化オプションが選択されたGit SSHアクセスドロップダウンメニュー](/assets/images/enterprise/site-admin-settings/git-ssh-access-repository-setting.png) - -### ユーザもしくは組織が所有するすべてのリポジトリへのGit SSHアクセスの無効化 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.search-user-or-org %} -{% data reusables.enterprise_site_admin_settings.click-user-or-org %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -7. [Git SSH access] で、ドロップダウンメニューを使用して [**Disabled**] を選択します。 続いて、**Enforce on all repositories（すべてのリポジトリで強制）**を選択してください。 ![無効化オプションが選択されたGit SSHアクセスドロップダウンメニュー](/assets/images/enterprise/site-admin-settings/git-ssh-access-organization-setting.png) - -### アプライアンス上のすべてのリポジトリへのGit SSHアクセスの無効化 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -7. [Git SSH access] で、ドロップダウンメニューを使用して [**Disabled**] を選択します。 続いて、**Enforce on all repositories（すべてのリポジトリで強制）**を選択してください。 ![無効化オプションが選択されたGit SSHアクセスドロップダウンメニュー](/assets/images/enterprise/site-admin-settings/git-ssh-access-appliance-setting.png) diff --git a/translations/ja-JP/content/admin/installation/disabling-the-merge-conflict-editor-for-pull-requests-between-repositories.md b/translations/ja-JP/content/admin/installation/disabling-the-merge-conflict-editor-for-pull-requests-between-repositories.md deleted file mode 100644 index d78a415e09c5..000000000000 --- a/translations/ja-JP/content/admin/installation/disabling-the-merge-conflict-editor-for-pull-requests-between-repositories.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: リポジトリ間のプルリクエストのためのマージコンフリクトエディタの無効化 -intro: 'ベースブランチとヘッドブランチが別のリポジトリにあるプルリクエストに対して、{% data variables.product.prodname_ghe_server %} でマージコンフリクトエディタを無効にすることで、ローカルでマージコンフリクトを解決するように人々に要求することができます。' -redirect_from: - - /enterprise/admin/installation/disabling-the-merge-conflict-editor-for-pull-requests-between-repositories -versions: - enterprise-server: '*' ---- - -ユーザが自分のコンピュータ上でローカルにマージコンフリクトを解決するように要求すれば、うっかりフォークから上流のリポジトリに書き込んでしまうことを回避できます。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -1. "Conflict editor for pull requests between repositories（リポジトリ間のプルリクエストのコンフリクトエディタ）"の下でドロップダウンメニューを使い、**Disabled（無効化）**を選択してください。 ![マージコンフリクトエディタを無効化するオプションを持つドロップダウンメニュー](/assets/images/enterprise/settings/conflict-editor-settings.png) diff --git a/translations/ja-JP/content/admin/installation/enabling-and-scheduling-maintenance-mode.md b/translations/ja-JP/content/admin/installation/enabling-and-scheduling-maintenance-mode.md deleted file mode 100644 index 6b03ada16517..000000000000 --- a/translations/ja-JP/content/admin/installation/enabling-and-scheduling-maintenance-mode.md +++ /dev/null @@ -1,61 +0,0 @@ ---- -title: メンテナンスモードの有効化とスケジューリング -intro: '標準的なメンテナンス手順のうち、{% data variables.product.product_location_enterprise %} のアップグレードやバックアップの復元などは、通常の使用のためにインスタンスをオフラインにしなければならないものがあります。' -redirect_from: - - /enterprise/admin/maintenance-mode/ - - /enterprise/admin/categories/maintenance-mode/ - - /enterprise/admin/articles/maintenance-mode/ - - /enterprise/admin/articles/enabling-maintenance-mode/ - - /enterprise/admin/articles/disabling-maintenance-mode/ - - /enterprise/admin/guides/installation/maintenance-mode/ - - /enterprise/admin/installation/enabling-and-scheduling-maintenance-mode -versions: - enterprise-server: '*' ---- - -### メンテナンスモードについて - -操作の種類によっては、{% data variables.product.product_location_enterprise %} をオフラインにしてメンテナンスモードにする必要があります。 -- {% data variables.product.prodname_ghe_server %} の新規バージョンにアップグレードする -- 仮想マシンに割り当てられている CPU、メモリ、またはストレージリソースを拡大する -- ある仮想マシンから別の仮想マシンへデータを移行する -- {% data variables.product.prodname_enterprise_backup_utilities %} スナップショットからデータを復元する -- 特定の種類の重要なアプリケーション問題のトラブルシューティング - -メンテナンスウィンドウのスケジュールは、ユーザに準備時間を与えるために少なくとも30分は先にすることをおすすめします。 メンテナンスウィンドウがスケジューリングされると、すべてのユーザにはサイトにアクセスしたときにバナーが表示されます。 - -![スケジューリングされたメンテナンスに関するエンドユーザ向けバナー](/assets/images/enterprise/maintenance/maintenance-scheduled.png) - -インスタンスがメンテナンスモードに入ると、通常のHTTP及びGitアクセスはすべて拒否されます。 Git fetch、clone、pushの操作も、サイトが一時的に利用できなくなっていることを示すエラーメッセージと共に拒否されます。 サイトにブラウザーでアクセスすると、メンテナンスページが表示されます。 - -![メンテナンスモードのスプラッシュスクリーン](/assets/images/enterprise/maintenance/maintenance-mode-maintenance-page.png) - -### メンテナンスモードの即時有効化あるいは後のためのメンテナンスウィンドウのスケジューリング - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -2. {% data variables.enterprise.management_console %}の上部で**Maintenance（メンテナンス）**をクリックしてください ![[Maintenance] タブ](/assets/images/enterprise/management-console/maintenance-tab.png) -3. "Enable and schedule（有効化とスケジュール）"の下で、即時にメンテナンスモードを有効化するか、将来にメンテナンスウィンドウをスケジューリングするかを決めてください。 - - メンテナンスモードを直ちに有効にするには、プルダウンメニューを使用して [**now**] をクリックします。 ![メンテナンスモードを有効にするオプションが選択されたドロップダウンメニュー](/assets/images/enterprise/maintenance/enable-maintenance-mode-now.png) - - 今後のメンテナンス時間枠をスケジュール設定するには、ドロップダウンメニューを使用して開始時間をクリックします。 ![メンテナンス時間枠を 2 時間でスケジュール設定するオプションが選択されたドロップダウンメニュー](/assets/images/enterprise/maintenance/schedule-maintenance-mode-two-hours.png) -4. **Enable maintenance mode（メンテナンスモードの有効化）**を選択してください。 ![メンテナンスモードの有効化とスケジューリングのためのチェックボックス](/assets/images/enterprise/maintenance/enable-maintenance-mode-checkbox.png) -{% data reusables.enterprise_management_console.save-settings %} - -### {% data variables.product.prodname_enterprise_api %}でのメンテナンスモードのスケジューリング - -{% data variables.product.prodname_enterprise_api %}では、様々な時間や日付にメンテナンスをスケジューリングできます。 For more information, see "[Management Console](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#enable-or-disable-maintenance-mode)." - -### クラスタ内の全ノードでのメンテナンスモードの有効化もしくは無効化 - -`ghe-cluster-maintenance`ユーティリティを使えば、クラスタ内のすべてのノードでメンテナンスモードの設定や解除ができます。 - -```shell -$ ghe-cluster-maintenance -h -# オプションの表示 -$ ghe-cluster-maintenance -q -# 現在のモードの問い合わせ -$ ghe-cluster-maintenance -s -# メンテナンスモードの設定 -$ ghe-cluster-maintenance -u -# メンテナンスモードの解除 -``` diff --git a/translations/ja-JP/content/admin/installation/enabling-automatic-update-checks.md b/translations/ja-JP/content/admin/installation/enabling-automatic-update-checks.md deleted file mode 100644 index 061126ce733d..000000000000 --- a/translations/ja-JP/content/admin/installation/enabling-automatic-update-checks.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: 自動アップデートチェックの有効化 -intro: '自動アップデートチェックを有効にすると、{% data variables.product.product_location_enterprise %} が最新の {% data variables.product.prodname_ghe_server %} リリースをチェックしてダウンロードします。' -redirect_from: - - /enterprise/admin/installation/enabling-automatic-update-checks -versions: - enterprise-server: '*' ---- - -{% data variables.product.product_location_enterprise %} のアップグレードパッケージが自動的にダウンロードされると、{% data variables.product.prodname_ghe_server %} をアップグレードできることを知らせるメッセージを受け取ります。 パッケージは{% data variables.product.product_location_enterprise %}の `/var/lib/ghe-updates`ディレクトリへダウンロードされます。 詳細は「[{% data variables.product.prodname_ghe_server %} をアップグレードする](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-github-enterprise-server)」を参照してください。 - -アップグレードにホットパッチが利用できる場合、`.hpkg` は自動的にダウンロードします。 管理コンソールでは、ホットパッチを直ちにインストールするか、後でインストールするようにスケジュール設定するかを選択できます。 詳細は「[ホットパッチ付きでアップグレードする](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-github-enterprise-server#upgrading-with-a-hotpatch)」を参照してください。 - -{% tip %} - -**Tip:** 自動アップデートチェックを有効化するには、{% data variables.product.product_location_enterprise %}は`https://github-enterprise.s3.amazonaws.com`に接続できなければなりません。 - -{% endtip %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.updates-tab %} -4. **Yes, automatically check for updates（はい、アップデートを自動的にチェックする）**をクリックしてください。 ![自動更新を有効化するためのボタン](/assets/images/enterprise/management-console/enable_updates_button.png) -{% data reusables.enterprise_management_console.save-settings %} - -インスタンスが最新の状態になっているかを知るには、Updatesタブのバナーを調べてください。 - -![GitHub Enterprise Server のリリースを示すバナー](/assets/images/enterprise/management-console/up-to-date-banner.png) - -**Logs（ログ）**の下で、最も直近のアップデートチェックのステータスを確認できます。 - -![アップデートのログ](/assets/images/enterprise/management-console/update-log.png) diff --git a/translations/ja-JP/content/admin/installation/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud.md b/translations/ja-JP/content/admin/installation/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud.md deleted file mode 100644 index 1188acb79da3..000000000000 --- a/translations/ja-JP/content/admin/installation/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: GitHub Enterprise ServerとGitHub Enterprise Cloudの間で自動ユーザライセンス同期を有効化する -intro: '{% data variables.product.product_location_enterprise %}を{% data variables.product.prodname_ghe_cloud %}に接続すると、{% data variables.product.prodname_ghe_server %}でユーザライセンス情報を{% data variables.product.prodname_dotcom_the_website %}上のEnterpriseアカウントにアップロードすることができます。' -permissions: '接続されている{% data variables.product.prodname_ghe_cloud %}のOrganizationあるいはEnterpriseアカウントの所有者でもある{% data variables.product.prodname_ghe_server %}のサイト管理者は、ユーザライセンスの自動同期を有効化できます。' -redirect_from: - - /enterprise/admin/installation/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud -versions: - enterprise-server: '*' ---- - -### ライセンスの同期について - -After you enable license synchronization, you'll be able to view license usage for your entire enterprise account, across {% data variables.product.prodname_ghe_server %} and {% data variables.product.prodname_ghe_cloud %}. {% data variables.product.prodname_github_connect %} syncs license between {% data variables.product.prodname_ghe_server %} and {% data variables.product.prodname_ghe_cloud %} weekly. For more information, see "[Managing your {% data variables.product.prodname_enterprise %} license](/enterprise/{{currentVersion}}/admin/installation/managing-your-github-enterprise-license)." - -{% data variables.product.prodname_ghe_server %}ユーザライセンス情報を手動で{% data variables.product.prodname_ghe_cloud %}にアップロードすることもできます。 詳細は、「[{% data variables.product.prodname_ghe_server %}を{% data variables.product.prodname_ghe_cloud %}に接続する](/enterprise/{{ currentVersion }}/admin/guides/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)」を参照してください。 - -### ライセンス同期の有効化 - -{% data variables.product.product_location_enterprise %}でライセンス同期を有効化する前に、{% data variables.product.product_location_enterprise %}を{% data variables.product.prodname_dotcom_the_website %}に接続する必要があります。 詳細は、「[{% data variables.product.prodname_ghe_server %}を{% data variables.product.prodname_ghe_cloud %}に接続する](/enterprise/{{ currentVersion }}/admin/guides/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)」を参照してください。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %} -5. [Server can sync user license count and usage] で、ドロップダウンメニューほ使って [**Enabled**] を選択します。 ![自動ユーザライセンス同期を有効化するドロップダウンメニュー](/assets/images/enterprise/site-admin-settings/enable-user-license-drop-down.png) diff --git a/translations/ja-JP/content/admin/installation/enabling-private-mode.md b/translations/ja-JP/content/admin/installation/enabling-private-mode.md deleted file mode 100644 index abc22bc40312..000000000000 --- a/translations/ja-JP/content/admin/installation/enabling-private-mode.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: プライベートモードの有効化 -intro: 'プライベートモードでは、{% data variables.product.prodname_ghe_server %} はインストールにアクセスするすべてのユーザーにサインインを求めます。' -redirect_from: - - /enterprise/admin/articles/private-mode/ - - /enterprise/admin/guides/installation/security/ - - /enterprise/admin/guides/installation/securing-your-instance/ - - /enterprise/admin/installation/enabling-private-mode -versions: - enterprise-server: '*' ---- - -{% data variables.product.product_location_enterprise %}がインターネット経由でパブリックにアクセス可能になっている場合、プライベートモードを有効化しなければなりません。 プライベートモードでは、ユーザは`git://`経由でリポジトリを匿名クローンすることはできません。 ビルトイン認証も有効化されている場合、新しいユーザがインスタンスにアカウントを作成するには管理者が招待しなければなりません。 詳しい情報については"[ビルトイン認証の利用](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-built-in-authentication)"を参照してください。 - -{% data reusables.enterprise_installation.image-urls-viewable-warning %} - -プライベートモードを有効にすると、認証されていない Git 操作 (および {% data variables.product.product_location_enterprise %} へのネットワークアクセス権を所有する人) に、匿名 Git 読み取りアクセスを有効にしたインスタンスで、パブリックリポジトリのコードの読み取りを許可できます。 詳しい情報については[管理者にパブリックリポジトリの匿名Git読み取りアクセスの有効化を許可する](/enterprise/{{ currentVersion }}/admin/guides/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories)を参照してください。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -4. **Private mode（プライベートモード）**を選択してください。 ![プライベートモードを有効にするためのチェックボックス](/assets/images/enterprise/management-console/private-mode-checkbox.png) -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/ja-JP/content/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md b/translations/ja-JP/content/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md deleted file mode 100644 index 25c978d90888..000000000000 --- a/translations/ja-JP/content/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: GitHub Enterprise Serverで脆弱性のある依存関係に対するアラートを有効化する -intro: '{% data variables.product.product_location_enterprise %}を{% data variables.product.prodname_ghe_cloud %}に接続して、インスタンスのリポジトリ内の脆弱性のある依存関係に対するセキュリティアラートを有効化することができます。' -permissions: '接続された{% data variables.product.prodname_ghe_cloud %}のOrganizationあるいはEnterpriseアカウントの所有者でもある{% data variables.product.prodname_ghe_server %}のサイト管理者は、{% data variables.product.prodname_ghe_server %}上の脆弱性のある依存関係に対するセキュリティアラートを有効化できます。' -redirect_from: - - /enterprise/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server -versions: - enterprise-server: '*' ---- - -### About alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %} - -{% data reusables.repositories.tracks-vulnerabilities %} For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)." - -{% data variables.product.product_location_enterprise %}を{% data variables.product.prodname_dotcom_the_website %}に接続して、インスタンスに脆弱性データを同期させ、脆弱性のある依存関係を持つリポジトリ内にセキュリティアラートを生成します。 - -{% data variables.product.product_location_enterprise %}を {% data variables.product.prodname_dotcom_the_website %}に接続し、脆弱性のある依存関係に関するセキュリティアラートを有効化すると、{% data variables.product.prodname_dotcom_the_website %}からのあなたのインスタンスへ、脆弱性データが 1 時間に 1 回同期されます。 また、脆弱性データはいつでも手動で同期することができます。 {% data variables.product.product_location_enterprise %} からのコードまたはコードに関する情報は、{% data variables.product.prodname_dotcom_the_website %} にアップロードされません。 - -{% data variables.product.product_location_enterprise %} が脆弱性に関する情報を受信すると、影響を受けるバージョンの依存関係を使用するインスタンス内のリポジトリを識別し、それらのリポジトリ内の管理者アクセス権を持つコードオーナーおよび人にセキュリティアラートを送信します。 セキュリティアラートの受信方法をカスタマイズすることができます。 詳しい情報については、「[脆弱性のある依存関係に対するアラートについて](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies/#configuring-notifications-for-security-alerts)」を参照してください。 - -### {% data variables.product.prodname_ghe_server %}で脆弱性のある依存関係に対するアラートを有効化する - -{% data variables.product.product_location_enterprise %} で脆弱性のある依存関係に対するセキュリティアラートを有効化する前に、{% data variables.product.product_location_enterprise %} を {% data variables.product.prodname_dotcom_the_website %} に接続する必要があります。 詳細は、「[{% data variables.product.prodname_ghe_server %}を{% data variables.product.prodname_ghe_cloud %}に接続する](/enterprise/{{ currentVersion }}/admin/guides/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)」を参照してください。 - -{% if currentVersion ver_gt "enterprise-server@2.20" %} We recommend configuring security alerts without notifications for the first few days to avoid an overload of emails. After a few days, you can enable notifications to receive security alerts as usual.{% endif %} - -{% data reusables.enterprise_site_admin_settings.sign-in %} -2. 管理シェルで、{% data variables.product.product_location_enterprise %} の脆弱性のある依存関係に対するセキュリティアラートを有効化します。 - ``` shell -$ ghe-dep-graph-enable -``` -3. {% data variables.product.prodname_ghe_server %}に戻ります。 -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %}{% if currentVersion ver_gt "enterprise-server@2.20" %} -5. Under "Repositories can be scanned for vulnerabilities", use the drop-down menu and select **Enabled without notifications**. Optionally, to enable alerts with notifications, select **Enabled with notifications**.{% else %} -5. 「Repositories can be scanned for vulnerabilities」で、ドロップダウンメニューを使用して「**Enabled**」を選択します。 -{% endif %} - ![脆弱性に対するリポジトリのスキャンを有効化するドロップダウンメニュー](/assets/images/enterprise/site-admin-settings/enable-vulnerability-scanning-in-repositories.png) - -### {% data variables.product.prodname_ghe_server %}で脆弱性のある依存関係を表示する - -{% data variables.product.product_location_enterprise %}ですべての脆弱性を表示し、{% data variables.product.prodname_dotcom_the_website %}から脆弱性データを手動で同期して、リストを更新することができます。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -2. 左サイドバーで [**Vulnerabilities**] をクリックします。 ![サイト管理サイドバーの [Vulnerabilities] タブ](/assets/images/enterprise/business-accounts/vulnerabilities-tab.png) -3. 脆弱性データを同期するには、[**Sync Vulnerabilities now**] をクリックします。 ![[Sync vulnerabilities now] ボタン](/assets/images/enterprise/site-admin-settings/sync-vulnerabilities-button.png) diff --git a/translations/ja-JP/content/admin/installation/enabling-subdomain-isolation.md b/translations/ja-JP/content/admin/installation/enabling-subdomain-isolation.md deleted file mode 100644 index b6149b3c7f31..000000000000 --- a/translations/ja-JP/content/admin/installation/enabling-subdomain-isolation.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: Subdomain Isolationの有効化 -intro: 'Subdomain Isolation をセットアップすれば、ユーザーが提供したコンテンツを {% data variables.product.prodname_ghe_server %} アプライアンスの他の部分から安全に分離できるようになります。' -redirect_from: - - /enterprise/admin/guides/installation/about-subdomain-isolation/ - - /enterprise/admin/installation/enabling-subdomain-isolation -versions: - enterprise-server: '*' ---- - -### Subdomain Isolationについて - -Subdomain Isolationは、クロスサイトスクリプティングや関連するその他の脆弱性を緩和します。 詳しい情報については"Wikipediaの[クロスサイトスクリプティング](http://en.wikipedia.org/wiki/Cross-site_scripting)"を参照してください。 {% data variables.product.product_location_enterprise %}ではSubdomain Isolationを有効化することを強くお勧めします。 - -Subdomain Isolation が有効な場合、{% data variables.product.prodname_ghe_server %} はいくつかのパスをサブドメインで置き換えます。 - -| Subdomain Isolationなしのパス | Subdomain Isolationされたパス | -| ------------------------------ | ------------------------------ | -| `http(s)://HOSTNAME/assets/` | `http(s)://assets.HOSTNAME/` | -| `http(s)://HOSTNAME/avatars/` | `http(s)://avatars.HOSTNAME/` | -| `http(s)://HOSTNAME/codeload/` | `http(s)://codeload.HOSTNAME/` | -| `http(s)://HOSTNAME/gist/` | `http(s)://gist.HOSTNAME/` | -| `http(s)://HOSTNAME/media/` | `http(s)://media.HOSTNAME/` | -| `http(s)://HOSTNAME/pages/` | `http(s)://pages.HOSTNAME/` | -| `http(s)://HOSTNAME/raw/` | `http(s)://raw.HOSTNAME/` | -| `http(s)://HOSTNAME/render/` | `http(s)://render.HOSTNAME/` | -| `http(s)://HOSTNAME/reply/` | `http(s)://reply.HOSTNAME/` | -| `http(s)://HOSTNAME/uploads/` | `http(s)://uploads.HOSTNAME/` | - -### 必要な環境 - -{% data reusables.enterprise_installation.disable-github-pages-warning %} - -Subdomain Isolationを有効化する前に、新しいドメインに合わせてネットワークを設定しなければなりません。 - -- 有効なドメイン名を、IP アドレスではなくホスト名として指定します。 For more information, see "[Configuring a hostname](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-a-hostname)." - -{% data reusables.enterprise_installation.changing-hostname-not-supported %} - -- 上記のサブドメインに対して、ワイルドカードのドメインネームシステム (DNS) レコードまたは個々の DNS レコードをセットアップします。 各サブドメイン用に複数のレコードを作成せずに済むよう、サーバのIPアドレスを指す`*.HOSTNAME`のAレコードを作成することをおすすめします。 -- `HOSTNAME` とワイルドカードのドメイン `*.HOSTNAME` の両方に対するサブジェクト代替名 (SAN) が記載された、`*.HOSTNAME` に対するワイルドカードの Transport Layer Security (TLS) 証明書を取得します。 たとえば、ホスト名が `github.octoinc.com` である場合は、Common Name の値が `*.github.octoinc.com` に設定され、SAN の値が `github.octoinc.com` と `*.github.octoinc.com` の両方に設定された証明書を取得します。 -- アプライアンスで TLS を有効にします。 詳しい情報については"[TLSの設定](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-tls/)"を参照してください - -### Subdomain Isolationの有効化 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.hostname-menu-item %} -4. **Subdomain isolation (recommended)（Subdomain Isolation（推奨））**を選択してください。 ![Subdomain Isolation を有効化するチェックボックス](/assets/images/enterprise/management-console/subdomain-isolation.png) -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/ja-JP/content/admin/installation/enabling-unified-contributions-between-github-enterprise-server-and-githubcom.md b/translations/ja-JP/content/admin/installation/enabling-unified-contributions-between-github-enterprise-server-and-githubcom.md deleted file mode 100644 index ac2d4dd0d1cd..000000000000 --- a/translations/ja-JP/content/admin/installation/enabling-unified-contributions-between-github-enterprise-server-and-githubcom.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: GitHub Enterprise Server と GitHub.com の間で統合コントリビューションを設定する -intro: '{% data variables.product.prodname_github_connect %}を有効化すると、{% data variables.product.prodname_ghe_cloud %}のメンバーがコントリビューション数を{% data variables.product.prodname_dotcom_the_website %}のプロフィールに送信して、{% data variables.product.prodname_ghe_server %}上の作業をハイライトできるようにできます。' -redirect_from: - - /enterprise/admin/guides/developer-workflow/enabling-unified-contributions-between-github-enterprise-and-github-com/ - - /enterprise/admin/guides/developer-workflow/enabling-unified-contributions-between-github-enterprise-server-and-github-com/ - - /enterprise/admin/developer-workflow/enabling-unified-contributions-between-github-enterprise-server-and-githubcom/ - - /enterprise/admin/installation/enabling-unified-contributions-between-github-enterprise-server-and-githubcom -permissions: '接続された{% data variables.product.prodname_ghe_cloud %}のOrganizationあるいはEnterpriseアカウントの所有者でもある{% data variables.product.prodname_ghe_server %}のサイト管理者は、{% data variables.product.prodname_ghe_server %}と{% data variables.product.prodname_dotcom_the_website %}間の統合コントリビューションを有効化できます。' -versions: - enterprise-server: '*' ---- - -サイト管理者は、{% data variables.product.prodname_ghe_server %} からの作業に対する匿名のコントリビューション数の {% data variables.product.prodname_dotcom_the_website %} コントリビューショングラフへの送信をエンドユーザに許可できます。 - -{% data variables.product.prodname_github_connect %} を有効化して双方の環境で {% data variables.product.prodname_unified_contributions %} を有効化した後、インスタンス上のエンドユーザは自分の {% data variables.product.prodname_dotcom_the_website %} アカウントに接続し、{% data variables.product.prodname_ghe_server %} からのコントリビューション数を {% data variables.product.prodname_dotcom_the_website %} に送信できます。 {% data reusables.github-connect.sync-frequency %} 詳細は「[{% data variables.product.prodname_ghe_server %} コントリビューションを {% data variables.product.prodname_dotcom_the_website %} プロフィールに送信する](/articles/sending-your-github-enterprise-server-contributions-to-your-github-com-profile)」を参照してください。 - -サイト管理者が機能を無効にするか、開発者が接続を拒否すると、{% data variables.product.prodname_ghe_server %} コントリビューション数は {% data variables.product.prodname_dotcom_the_website %} から削除されます。 開発者がプロフィールを無効にした後に再接続すると、過去 90 日間のコントリビューションカウントが復元されます。 - -{% data variables.product.prodname_ghe_server %} は、接続されているユーザーのコントリビューション数およびソース ({% data variables.product.prodname_ghe_server %}) **のみ**を送信します。 コントリビューションまたはその作成方法に関する情報は送信されません。 - -{% data variables.product.product_location_enterprise %}で {% data variables.product.prodname_unified_contributions %}を有効化する前に、{% data variables.product.product_location_enterprise %}を {% data variables.product.prodname_dotcom_the_website %}に接続する必要があります。 詳細は「[{% data variables.product.prodname_ghe_server %} を {% data variables.product.prodname_dotcom_the_website %} に接続する](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/connecting-github-enterprise-server-to-github-com)」を参照してください。 - -{% data reusables.github-connect.access-dotcom-and-enterprise %} -{% data reusables.enterprise_site_admin_settings.access-settings %}{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %} -4. \[Users can share contribution counts to {% data variables.product.prodname_dotcom_the_website %}\] (ユーザは {% data variables.product.prodname_dotcom_the_website %} にコントリビューション数を共有できる) の下で、[**Request access**] (アクセスをリクエスト) をクリックします。 ![統合コントリビューションへのアクセスをリクエストするオプション](/assets/images/enterprise/site-admin-settings/dotcom-ghe-connection-request-access.png) -5. {% data variables.product.prodname_ghe_server %} サイトに[サインイン](https://enterprise.github.com/login)して、以降の指示を受けてください。 - -アクセスをリクエストすると、{% data variables.product.prodname_ghe_server %} サイトにリダイレクトされます。そこで現在の利用規約をお読みください。 {% data variables.product.product_location_enterprise %} が標準の利用規約を使用している場合、リクエストによって自動的に {% data variables.product.prodname_unified_contributions %} の有効化の手順にリダイレクトされます。 あなたがカスタム利用規約を利用している場合、弊社はリクエストを記録して、アクセスのセットアップのためにあなたに連絡します。 diff --git a/translations/ja-JP/content/admin/installation/enabling-unified-search-between-github-enterprise-server-and-githubcom.md b/translations/ja-JP/content/admin/installation/enabling-unified-search-between-github-enterprise-server-and-githubcom.md deleted file mode 100644 index bb4512c01bce..000000000000 --- a/translations/ja-JP/content/admin/installation/enabling-unified-search-between-github-enterprise-server-and-githubcom.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: GitHub Enterprise Server と GitHub.com の間の Unified Search を有効化する -intro: '{% data variables.product.prodname_github_connect %} を有効化すると、{% data variables.product.product_location_enterprise %} からの {% data variables.product.prodname_dotcom_the_website %} の検索を許可できます。' -redirect_from: - - /enterprise/admin/guides/developer-workflow/enabling-unified-search-between-github-enterprise-and-github-com/ - - /enterprise/admin/guides/developer-workflow/enabling-unified-search-between-github-enterprise-server-and-github-com/ - - /enterprise/admin/developer-workflow/enabling-unified-search-between-github-enterprise-server-and-githubcom/ - - /enterprise/admin/installation/enabling-unified-search-between-github-enterprise-server-and-githubcom -permissions: '接続された{% data variables.product.prodname_ghe_cloud %}のOrganizationあるいはEnterpriseアカウントの所有者でもある{% data variables.product.prodname_ghe_server %}のサイト管理者は、{% data variables.product.prodname_ghe_server %}と{% data variables.product.prodname_dotcom_the_website %}間のUnified Searchを有効化できます。' -versions: - enterprise-server: '*' ---- - -Unified Searchを有効化すると、ユーザは{% data variables.product.product_location_enterprise %}から検索をした際に、{% data variables.product.prodname_dotcom_the_website %}上のパブリックおよびプライベートコンテンツからの検索結果を見ることができます。 - -両方の環境にアクセスできる場合でも、ユーザは{% data variables.product.prodname_dotcom_the_website %}から{% data variables.product.product_location_enterprise %}を検索することはできません。 ユーザが検索できるのは、あなたが{% data variables.product.prodname_unified_search %}を有効化したプライベートリポジトリと、接続された{% data variables.product.prodname_ghe_cloud %} Organizationでユーザがアクセスできるプライベートリポジトリだけです。 詳細は、「[{% data variables.product.prodname_dotcom %}](/articles/about-searching-on-github/#searching-across-github-enterprise-and-githubcom-simultaneously)での検索について」と「[{% data variables.product.prodname_ghe_server %}アカウントでのプライベートな{% data variables.product.prodname_dotcom_the_website %}リポジトリの検索を有効化する](/articles/enabling-private-github-com-repository-search-in-your-github-enterprise-server-account)」を参照してください。 - -REST及びGraphQL APIでの検索には、{% data variables.product.prodname_dotcom_the_website %}の検索結果は含まれません。 {% data variables.product.prodname_dotcom_the_website %}の高度な検索及びwikiの検索はサポートされていません。 - -{% data reusables.github-connect.access-dotcom-and-enterprise %} -{% data reusables.enterprise_site_admin_settings.access-settings %}{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %} -5. \[Users can search {% data variables.product.prodname_dotcom_the_website %}\] (ユーザは {% data variables.product.prodname_dotcom_the_website %} を検索可能) の下で、ドロップダウンメニューを使って [**Enabled**] をクリックします。 ![Enable search option in the [search GitHub.com] ドロップダウンメニューの [Enable search] オプション](/assets/images/enterprise/site-admin-settings/github-dotcom-enable-search.png) -6. \[Users can search private repositories on {% data variables.product.prodname_dotcom_the_website %}\] (ユーザは {% data variables.product.prodname_dotcom_the_website %} のプライベートリポジトリを検索可能) の下でドロップダウンメニューを使い、[**Enabled**] (有効) をクリックすることもできます。 ![[search GitHub.com] ドロップダウンメニューの [Enable private repositories search] オプション](/assets/images/enterprise/site-admin-settings/enable-private-search.png) - -### 参考リンク - -- 「[{% data variables.product.prodname_ghe_server %} を {% data variables.product.prodname_dotcom_the_website %} に接続する](/enterprise/admin/guides/developer-workflow/connecting-github-enterprise-server-to-github-com)」 diff --git a/translations/ja-JP/content/admin/installation/getting-started-with-github-enterprise-server.md b/translations/ja-JP/content/admin/installation/getting-started-with-github-enterprise-server.md deleted file mode 100644 index 734160c77af5..000000000000 --- a/translations/ja-JP/content/admin/installation/getting-started-with-github-enterprise-server.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: GitHub Enterprise Serverを使い始める -shortTitle: はじめましょう -intro: '{% data variables.product.prodname_ghe_server %}と、ライセンスの管理方法について学びましょう。' -mapTopic: true -redirect_from: - - /enterprise/admin/installation/getting-started-with-github-enterprise-server -versions: - enterprise-server: '*' ---- - diff --git a/translations/ja-JP/content/admin/installation/increasing-cpu-or-memory-resources.md b/translations/ja-JP/content/admin/installation/increasing-cpu-or-memory-resources.md deleted file mode 100644 index 19744bd383ed..000000000000 --- a/translations/ja-JP/content/admin/installation/increasing-cpu-or-memory-resources.md +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: CPUあるいはメモリリソースの増加 -intro: '既存の {% data variables.product.prodname_ghe_server %} インスタンスに CPU またはメモリリソースを追加するには、そのインスタンスをシャットダウンし、下部の仮想プラットフォームのツールを使用して仮想マシンにリソースを割り当てます。 新たに割り当てられたリソースは起動時に自動的に認識され、追加の設定は必要ありません。' -redirect_from: - - /enterprise/admin/installation/increasing-cpu-or-memory-resources -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_installation.warning-on-upgrading-physical-resources %} - -### AWSでのCPUあるいはメモリリソースの追加 - -{% note %} - -**ノート:** AWSでCPUあるいはメモリリソースを追加するには、EC2インスタンスを管理するためにAWSのマネージメントコンソールもしくは`aws ec2`コマンドラインインターフェースのいずれかの利用に慣れていなければなりません。 リサイズを行うための好みのAWSツールの利用の背景と詳細については、[Amazon EBS-Backed インスタンスのサイズ変更](https://docs.aws.amazon.com/ja_jp/AWSEC2/latest/UserGuide/ec2-instance-resize.html)にあるAWSのドキュメンテーションを参照してください。 - -{% endnote %} - -#### リサイズについての考慮 - -{% data variables.product.product_location_enterprise %} の CPU またはメモリリソースを増加させる前に、以下のことを行ってください: -{% if currentVersion != "free-pro-team@latest" %} -- **CPU に応じてメモリーをスケーリング** - {% data reusables.enterprise_installation.increasing-cpus-max %}{% endif %} -- **Elastic IP がインスタンスに割り当てられていることを確認** - - Elastic IP が割り当てられていない場合は、パブリック IP アドレスでの変更を考慮して、再起動後に {% data variables.product.prodname_ghe_server %} ホストの DNS A レコードを調整する必要があります。 インスタンスがVPC内で起動していれば、インスタンスが再起動してもElastic IP（EIP）は自動的に保持されます。 インスタンスがEC2-Classic内で起動されていれば、Elastic IPは手動で際割り当てが必要です。 - -#### サポートされているAWSインスタンスタイプ - -アップグレードするインスタンスタイプは、CPU／メモリの仕様に基づいて決定しなければなりません。 -{% data reusables.enterprise_installation.aws-supported-instance-types %} - -#### 推奨されるAWSインスタンスタイプ - -{% data reusables.enterprise_installation.aws-recommended-instance-types %} - -{% data reusables.enterprise_installation.warning-on-scaling %} - -#### AWSでのリサイズ - -{% note %} - -**ノート:**EC2-Classicで起動されたインスタンスについては、インスタンスに関連づけられたElastic IPアドレスとインスタンスIPの両方を書き留めておいてください。 インスタンスを再起動したなら、Elastic IPのアドレスを再割り当てしてください。 - -{% endnote %} - -既存の AWS/EC2 インスタンスに CPU またはメモリリソースを追加することはできません。 その代わりに、以下を行う必要があります: - -1. インスタンスを停止する。 -2. インスタンスタイプを変更する。 -3. インスタンスを起動します。 -{% data reusables.enterprise_installation.configuration-recognized %} - -### OpenStack KVMでのCPUあるいはメモリリソースの追加 - -既存の OpenStack KVM インスタンスに CPU またはメモリリソースを追加することはできません。 その代わりに、以下を行う必要があります: - -1. 現在のインスタンスのスナップショットを取る。 -2. インスタンスを停止する。 -3. 希望するCPUやメモリリソースを持つ新しいインスタンスフレーバーを選択する。 - -### VMWareでのCPUあるいはメモリリソースの追加 - -{% data variables.product.product_location_enterprise %}での処理が遅いなら、CPUあるいはメモリリソースを追加する必要があるかもしれません。 - -{% data reusables.enterprise_installation.increasing-cpus-max %} - -1. vSphere Clientを使ってVMware ESXiホストに接続してください。 -2. {% data variables.product.product_location_enterprise %}をシャットダウンしてください。 -3. 仮想マシンを選択し、 **Edit Settings（設定の編集）**をクリックしてください。 -4. "Hardware"の下で、必要に応じて仮想マシンに割り当てられたCPUやメモリリソースを調整してください。![VMWareのセットアップリソース](/assets/images/enterprise/vmware/vsphere-hardware-tab.png) -5. 仮想マシンを起動するには、[**OK**] をクリックします。 -{% data reusables.enterprise_installation.configuration-recognized %} diff --git a/translations/ja-JP/content/admin/installation/increasing-storage-capacity.md b/translations/ja-JP/content/admin/installation/increasing-storage-capacity.md deleted file mode 100644 index 570a01bb067c..000000000000 --- a/translations/ja-JP/content/admin/installation/increasing-storage-capacity.md +++ /dev/null @@ -1,57 +0,0 @@ ---- -title: ストレージ容量の増加 -intro: Gitリポジトリ、データベース、検索インデックス、その他の恒久的なアプリケーションデータに利用できるストレージの量は、追加あるいは変更できます。 -redirect_from: - - /enterprise/admin/installation/increasing-storage-capacity -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_installation.warning-on-upgrading-physical-resources %} - -{% data variables.product.product_location_enterprise %}に参加するユーザが増えるにつれて、ストレージボリュームをリサイズする必要があるかもしれません。 ストレージのリサイズに関する情報については、使用している仮想化プラットフォームのドキュメンテーションを参照してください。 - -### 要求及び推奨事項 - -{% note %} - -**ノート:** ユーザストレージボリュームをリサイズする前に、インスタンスをメンテナンスモードにしてください。 詳しい情報については"[メンテナンスモードの有効化とスケジューリング](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)"を参照してください。 - -{% endnote %} - -{% data reusables.enterprise_installation.hardware-rec-table %} - -### データパーティションサイズの増加 - -1. 仮想化プラットフォームのツールを使用して、既存のユーザーボリュームのディスクのサイズを変更します。 -{% data reusables.enterprise_installation.ssh-into-instance %} -3. アプライアンスをメンテナンスモードにしてください。 詳しい情報については"[メンテナンスモードの有効化とスケジューリング](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)"を参照してください。 -4. アプライアンスを再起動して、新しいストレージの割り当てを検出させてください。 -5. `ghe-storage-extend` コマンドを実行して、`/data` のファイルシステムを拡張します。 - ```shell - $ ghe-storage-extend - ``` - -### 新しいアプライアンスを使用したルートパーティションサイズの増加 - -1. 現在のアプライアンスと同じバージョンを使用して、より大きなルートディスクで新たな {% data variables.product.prodname_ghe_server %} をセットアップします。 詳細は「[{% data variables.product.prodname_ghe_server %} インスタンスをセットアップする](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-github-enterprise-server-instance)」を参照してください。 -2. 現在のアプライアンスをシャットダウンします。 -3. 使用している仮想化プラットフォームのツールを使い、現在のアプライアンスからデータディスクをデタッチします。 -4. 大きなルートディスクを持つ新しいアプライアンスにデータディスクをアタッチします。 - -### 既存のアプライアンスを使用したルートパーティションサイズの増加 - -1. {% data variables.product.prodname_ghe_server %} アプライアンスに新しいディスクを取り付けます。 -2. `parted` コマンドを実行して、ディスクをフォーマットします。 - ```shell - $ sudo parted /dev/xvdg mklabel msdos - $ sudo parted /dev/xvdg mkpart primary ext4 0% 50% - $ sudo parted /dev/xvdg mkpart primary ext4 50% 100% - ``` -3. `ghe-upgrade` コマンドを実行して、完全なプラットフォーム固有のパッケージを新たにパーティション分割されたディスクにインストールします。 `github-enterprise-2.11.9.hpkg` などのユニバーサルなホットパッチのアップブレードパッケージは、期待通りに動作しません。 - ```shell - $ ghe-upgrade PACKAGE-NAME.pkg -s -t /dev/xvdg1 - ``` -4. アプライアンスをシャットダウンします。 -5. ハイパーバイザーで、古いルートディスクを取り外し、古いルートディスクと同じ場所に新しいルートディスクを取り付けます。 -6. アプライアンスを起動します。 diff --git a/translations/ja-JP/content/admin/installation/initiating-a-failover-to-your-replica-appliance.md b/translations/ja-JP/content/admin/installation/initiating-a-failover-to-your-replica-appliance.md deleted file mode 100644 index bf286df86b70..000000000000 --- a/translations/ja-JP/content/admin/installation/initiating-a-failover-to-your-replica-appliance.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: レプリカアプライアンスへのフェイルオーバーの開始 -intro: 'メンテナンスやテストのため、またはプライマリアプライアンスが機能しなくなった場合は、コマンドラインを使用して {% data variables.product.prodname_ghe_server %} レプリカアプライアンスにフェイルオーバーできます。' -redirect_from: - - /enterprise/admin/installation/initiating-a-failover-to-your-replica-appliance -versions: - enterprise-server: '*' ---- - -フェイルオーバーに必要な時間は、レプリカを手動で昇格させてトラフィックをリダイレクトするのにかかる時間によって異なります。 平均的な時間は 2 分から 10 分です。 - -{% data reusables.enterprise_installation.promoting-a-replica %} - -1. アプライアンスを切り替える前にレプリケーションを終了できるようにするには、プライマリアプライアンスをメンテナンスモードにします。 - - Management Console を使用するには、「[メンテナンスモードの有効化とスケジュール設定](/enterprise/admin/guides/installation/enabling-and-scheduling-maintenance-mode/)」を参照してください。 - - `ghe-maintenance -s` コマンドも使用できます。 - ```shell - $ ghe-maintenance -s - ``` -2. アクティブな Git 操作の数がゼロになったら、30 秒間待ちます。 -3. すべてのレプリケーションチャネルが `OK` を報告することを確認するには、`ghe-repl-status -vv` コマンドを使用します。 - ```shell - $ ghe-repl-status -vv - ``` -4. レプリケーションを停止してレプリカアプライアンスをプライマリステータスに昇格するには、`ghe-repl-encourage` コマンドを使用します。 到達可能であれば、これによりプライマリノードも自動的にメンテナンスノードになります。 - ```shell - $ ghe-repl-promote - ``` -5. レプリカの IP アドレスを指すように DNS レコードを更新します。 TTL 期間が経過すると、トラフィックはレプリカに転送されます。 ロードバランサを使用している場合は、トラフィックがレプリカに送信されるように設定されていることを確認します。 -6. 通常の操作が再開できることをユーザーに通知します。 -7. 必要に応じて、新しいプライマリから既存のアプライアンスや以前のプライマリへのレプリケーションをセットアップします。 詳細は「[High Availability の設定について](/enterprise/{{ currentVersion }}/admin/guides/installation/about-high-availability-configuration/#utilities-for-replication-management)」を参照してください。 - -### 参考リンク - -- "[レプリケーション管理のユーティリティ](/enterprise/{{ currentVersion }}/admin/guides/installation/about-high-availability-configuration/#utilities-for-replication-management)" diff --git a/translations/ja-JP/content/admin/installation/log-forwarding.md b/translations/ja-JP/content/admin/installation/log-forwarding.md deleted file mode 100644 index 969b140eae96..000000000000 --- a/translations/ja-JP/content/admin/installation/log-forwarding.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: ログの転送 -intro: '{% data variables.product.prodname_enterprise %}は、`syslog-ng` を使って、{% data variables.enterprise.management_console %}の設定で指定したサーバに、システムとアプリケーションのログを転送します。' -redirect_from: - - /enterprise/admin/articles/log-forwarding/ - - /enterprise/admin/installation/log-forwarding -versions: - enterprise-server: '*' ---- - -syslog-style 式のログストリームに対応するログ回収システムは、サポートしています。（例えば、[Logstash](http://logstash.net/) や [Splunk](http://docs.splunk.com/Documentation/Splunk/latest/Data/Monitornetworkports)など） - -### ログの転送を有効化 - -1. {% data variables.enterprise.management_console %}の設定ページの左サイドバーで**Monitoring**をクリックする。 -1. **Enable log forwarding** を選択する。 -1. [**Server address**] フィールドに、ログの転送先となるサーバーのアドレスを入力します。 コンマ区切りリストで複数のアドレスを指定できます。 -1. [Protocol] ドロップダウンメニューで、ログサーバーとの通信に使用するプロトコルを選択します。 そのプロトコルは指定されたすべてのログ送信先に適用されます。 -1. **Enable TLS** を選択する。 -1. **Choose File** をクリックして、syslog のエンドポイントの間の通信を暗号化するためのCA証明書を選択する。 一連の証明書の全体が確認され、ルート証明書で終了しなければなりません。 詳しくは、[syslog-ng のドキュメントのTLSオプション](https://support.oneidentity.com/technical-documents/syslog-ng-open-source-edition/3.16/administration-guide/56#TOPIC-956599)を参照してください。 - -### トラブルシューティング - -ログ転送で問題が発生した場合、 `http(s)://[hostname]/setup/diagnostics` のアウトプットファイルをメールに添付し、{% data variables.contact.contact_ent_support %}に連絡してください。 diff --git a/translations/ja-JP/content/admin/installation/managing-billing-for-github-enterprise.md b/translations/ja-JP/content/admin/installation/managing-billing-for-github-enterprise.md deleted file mode 100644 index 2fda253a8863..000000000000 --- a/translations/ja-JP/content/admin/installation/managing-billing-for-github-enterprise.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: Managing billing for GitHub Enterprise -intro: 'You can view the license usage, invoices, payment history, and other billing information for your enterprise account and {% data variables.product.prodname_ghe_server %} instances.' -product: '{% data reusables.gated-features.enterprise-accounts %}' -redirect_from: - - /enterprise/admin/installation/managing-billing-for-github-enterprise -versions: - enterprise-server: '*' ---- - -### Enterprise アカウントの支払いについて - -現時点では、Enterprise アカウントは請求書で支払いを行っている {% data variables.product.prodname_enterprise %} のお客様が利用できます。 Billing for all of the organizations and {% data variables.product.prodname_ghe_server %} instances connected to your enterprise account is aggregated into a single bill charge for all of your paid {% data variables.product.prodname_dotcom_the_website %} services (including paid licenses in organizations, {% data variables.large_files.product_name_long %} data packs, and subscriptions for {% data variables.product.prodname_marketplace %} apps). - -Enterprise オーナーと支払いマネージャーは、Enterprise アカウントの支払い設定すべてに対するアクセスおよび管理が可能です。 For more information about enterprise accounts, see "[Roles of an enterprise account](/github/setting-up-and-managing-your-enterprise-account/roles-for-an-enterprise-account)." 支払いマネージャーの管理に関する詳細は、「[Enterprise アカウントの管理をするよう招待する](/github/setting-up-and-managing-your-enterprise-account/inviting-people-to-manage-your-enterprise-account)」を参照してください。 - -### Viewing your current invoice - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.billing-tab %} -4. Under "Quick Actions", click **View invoice**. ![View invoice link](/assets/images/help/business-accounts/view-invoice-link.png) - -### Paying your current invoice - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.billing-tab %} -4. Under "Quick Actions", click **Pay invoice**. ![Pay invoice link](/assets/images/help/business-accounts/pay-invoice-link.png) -5. Under "Pay invoice", type your credit card information in the secure form, then click **Pay Invoice**. ![Confirm and pay invoice](/assets/images/help/business-accounts/pay-invoice.png) - -### Downloading your current invoice - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.billing-tab %} -4. Under "Quick Actions", click **Download current invoice**. ![Download current invoice link](/assets/images/help/business-accounts/download-current-invoice.png) - -### Viewing your payment history - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.billing-tab %} -4. Under "Billing", click the **Past Invoices** tab to see a summary of your past billing activity. ![View payment history tab](/assets/images/help/business-accounts/view-payment-history.png) diff --git a/translations/ja-JP/content/admin/installation/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud.md b/translations/ja-JP/content/admin/installation/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud.md deleted file mode 100644 index 08e2f777d30f..000000000000 --- a/translations/ja-JP/content/admin/installation/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: GitHub Enterprise ServerとGitHub Enterprise Cloudの間の接続を管理する -intro: '{% data variables.product.prodname_github_connect %}を使えば、{% data variables.product.prodname_dotcom_the_website %}で、{% data variables.product.product_location_enterprise %}と{% data variables.product.prodname_ghe_cloud %}のOrganizationまたはEnterpriseアカウントの特定の機能やデータを共有できます。' -mapTopic: true -redirect_from: - - /enterprise/admin/developer-workflow/connecting-github-enterprise-to-github-com - - /enterprise/admin/guides/developer-workflow/connecting-github-enterprise-and-github-com/ - - /enterprise/admin/guides/developer-workflow/connecting-github-enterprise-server-and-github-com/ - - /enterprise/admin/developer-workflow/connecting-github-enterprise-server-and-githubcom/ - - /enterprise/admin/installation/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud -versions: - enterprise-server: '*' ---- - diff --git a/translations/ja-JP/content/admin/installation/managing-your-github-enterprise-license.md b/translations/ja-JP/content/admin/installation/managing-your-github-enterprise-license.md deleted file mode 100644 index a1253673b0f0..000000000000 --- a/translations/ja-JP/content/admin/installation/managing-your-github-enterprise-license.md +++ /dev/null @@ -1,70 +0,0 @@ ---- -title: Managing your GitHub Enterprise license -intro: '{% data variables.product.prodname_enterprise %} ライセンスを表示、管理、および更新できます。' -redirect_from: - - /enterprise/admin/categories/licenses/ - - /enterprise/admin/articles/license-files/ - - /enterprise/admin/installation/about-license-files/ - - /enterprise/admin/articles/downloading-your-license/ - - /enterprise/admin/installation/downloading-your-license/ - - /enterprise/admin/articles/upgrading-your-license/ - - /enterprise/admin/installation/updating-your-license/ - - /enterprise/admin/installation/managing-your-github-enterprise-server-license - - /enterprise/admin/installation/managing-your-github-enterprise-license -versions: - enterprise-server: '*' ---- - -### {% data variables.product.prodname_enterprise %}ライセンスについて - -{% data variables.product.prodname_enterprise %}を購入または更新すると、アプリケーションを有効化するためのライセンスファイルが届きます。 A license file has an expiration date and controls the number of user licenses you can add to {% data variables.product.prodname_enterprise %}. {% data variables.product.prodname_enterprise %}をダウンロードしてインストールしたら、ライセンスファイルをアップロードして、使用するアプリケーションのロックを解除します。 - -{% data variables.product.prodname_enterprise %}ライセンスに含まれるユーザライセンスを、{% data variables.product.product_location_enterprise %}と{% data variables.product.prodname_ghe_cloud %}のEnterpriseアカウントのユーザーに割り当てることができます。 ユーザをいずれかの環境に追加すると、ライセンスが消費されます。 If a user has accounts in both environments, to consume only one license, their primary {% data variables.product.prodname_enterprise %} email address must be the same as their verified {% data variables.product.prodname_ghe_cloud %} email address. You can sync license count and usage between the environments. - -{% data variables.product.prodname_ghe_server %}ライセンスの有効期限が切れると、ウェブブラウザまたはGit経由で{% data variables.product.product_location_enterprise %}にアクセスすることはできなくなります。 必要な場合は、コマンドラインユーティリティを使用してすべてのデータをバックアップできます。 詳しくは、"[ アプライアンスでのバックアップの設定](/enterprise/admin/guides/installation/configuring-backups-on-your-appliance)。"を参照してください。 If you have any questions about renewing your license, contact {% data variables.contact.contact_enterprise_sales %}. - -### {% data variables.product.prodname_ghe_server %}に新しいライセンスをアップロードする - -After you purchase a new license or upgrade an existing license from {% data variables.contact.contact_enterprise_sales %}, you must download your new license file, then upload the file to {% data variables.product.prodname_ghe_server %} to unlock your new user licenses. - -If you'd like to renew or add user licenses to {% data variables.product.prodname_enterprise %}, contact {% data variables.contact.contact_enterprise_sales %}. 注文完了したら、新しいライセンスのファイルが直ちにダウンロード可能となります。 - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.enterprise-licensing-tab %} -4. Under "Enterprise Server Instances", click {% octicon "download" aria-label="The download icon" %} to download your license file. ![Download GitHub Enterprise Server license](/assets/images/help/business-accounts/download-ghes-license.png) -5. Log into your {% data variables.product.prodname_ghe_server %} instance as a site administrator. -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.license-tab %} -12. [Quick links] で [**Update license**] をクリックする。 ![ライセンス更新のリンク](/assets/images/enterprise/business-accounts/update-license-link.png) -13. To select your license, click **License file**, or drag your license file onto **License file**. ![ライセンスファイルのアップロード](/assets/images/enterprise/management-console/upload-license.png) -14. Click **Upload**. ![アップグレードを開始](/assets/images/enterprise/management-console/begin-upload.png) - -### ライセンス使用状況を表示する - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.enterprise-licensing-tab %} -4. Review your current {% data variables.product.prodname_enterprise %} license, as well as consumed and available user licenses. - -### ユーザライセンスの使用状況を自動で{% data variables.product.prodname_ghe_cloud %}と同期する - -{% data variables.product.prodname_github_connect %}を使用して、{% data variables.product.prodname_ghe_server %}と{% data variables.product.prodname_ghe_cloud %}の間でユーザライセンスの数と使用状況を自動で同期できます。 詳細は、「[{% data variables.product.prodname_ghe_server %}と{% data variables.product.prodname_ghe_cloud %}の間で自動ユーザライセンス同期を有効化する](/enterprise/{{currentVersion}}/admin/installation/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud)」を参照してください。 - -### Manually syncing user license usage between {% data variables.product.prodname_ghe_server %} and {% data variables.product.prodname_ghe_cloud %} - -{% data variables.product.prodname_ghe_server %}からJSONファイルをダウンロードして{% data variables.product.prodname_ghe_cloud %}にそのファイルをアップロードし、2つのデプロイメント間でユーザライセンスの使用状況を手動で同期できます。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.license-tab %} -5. [Quick links] で、{% data variables.product.prodname_ghe_server %}上の現在のライセンスを含むファイルをダウンロードするには、[**Export license usage**] をクリックします。 ![ライセンス使用状況リンクをエクスポートする](/assets/images/enterprise/business-accounts/export-license-usage-link.png) -6. {% data variables.product.prodname_ghe_cloud %}に移動します。 -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.enterprise-licensing-tab %} -10. Under "Enterprise Server Instances", click **Add server usage**. ![GitHub Enterprise Serversの使用状況リンクをアップロードする](/assets/images/help/business-accounts/upload-ghe-server-usage-link.png) -11. {% data variables.product.prodname_ghe_server %}からダウンロードしたJSONファイルをアップロードします。 ![アップロードするファイルをドラッグアンドドロップまたは選択する](/assets/images/help/business-accounts/upload-ghe-server-usage-file.png) diff --git a/translations/ja-JP/content/admin/installation/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later.md b/translations/ja-JP/content/admin/installation/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later.md deleted file mode 100644 index 687c5e502ded..000000000000 --- a/translations/ja-JP/content/admin/installation/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later.md +++ /dev/null @@ -1,128 +0,0 @@ ---- -title: Elasticsearch インデックスを GitHub Enterprise 2.14 以降に移行する -intro: '{% data variables.product.prodname_ghe_server %} 2.14 へのアップグレードを準備するには、移行スクリプトを使用してインデックスを Elasticsearch 5.6 に移行する必要があります。' -redirect_from: - - /enterprise/admin/guides/installation/migrating-elasticsearch-indices-to-github-enterprise-2-14-or-later/ - - /enterprise/admin/guides/installation/migrating-elasticsearch-indices-to-github-enterprise-server-2-14-or-later - - /enterprise/admin/installation/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later -versions: - enterprise-server: '*' ---- - -{% data variables.product.prodname_ghe_server %} 2.14 には Elasticsearch 5.6 へのアップグレードが含まれています。{% data variables.product.prodname_ghe_server %} 2.12 または 2.13 から 2.14 以降にアップグレードする前に、Elasticsearch の移行ツールをダウンロードし、インストールし、実行することをお勧めします。それにより、アプライアンスにオンラインアクセスがある間に最大のインデックスがオンラインで移行されます。 - -### 検索インデックス - -移行スクリプトは、まずアプライアンスがオンラインのうちに`search`インデックスをチェックします。 `search`インデックスの移行には、サイズに応じて数分から数日がかかることがあります。 大きなインデックスの例としては、以下のインデックスは私たちのテスト環境での移行に数日を要しました。 - -``` -admin@ip-172-31-2-141:~$ curl -s http://localhost:9200/_cat/indices?v | sort -n -k 6 -green open blog-1 1 0 0 0 144b 144b -green open projects-1 1 0 0 0 144b 144b -green open registry-packages-1 1 0 0 0 144b 144b -green open showcases-1 1 0 0 0 144b 144b -health status index pri rep docs.count docs.deleted store.size pri.store.size -green open pull-requests-1 1 0 1 0 9.3kb 9.3kb -green open wikis-1 1 0 2 0 5kb 5kb -green open hookshot-logs-2018-05-29 5 0 25 0 124.2kb 124.2kb -green open repos-1 1 0 1638 1 1.4mb 1.4mb -green open gists-1 1 0 3531 64 291.9kb 291.9kb -green open audit_log-1-2018-06-1 1 0 11108 0 3mb 3mb -green open users-1 1 0 19866 56 2.7mb 2.7mb -green open hookshot-logs-2018-05-31 5 0 20000 0 33.4mb 33.4mb -green open hookshot-logs-2018-06-04 5 0 20000 0 32.6mb 32.6mb -green open issues-1 1 0 26405 6 82.8mb 82.8mb -green open hookshot-logs-2018-05-30 5 0 119744 0 196.8mb 196.8mb -green open audit_log-1-2018-05-1 1 0 191664 0 50mb 50mb -green open code-search-1 1 0 6932626 44 42.9gb 42.9gb -green open commits-1 1 0 63753587 1485 45.4gb 45.4gb -``` - -`search`インデックスは、以下から始まります。 - -- blog- -- code-search- -- commits- -- gists- -- issues- -- labels- -- marketplace-listings- -- non-marketplace-listings- -- projects- -- pull-requests- -- registry-packages- -- repos- -- showcases- -- topics- -- users- - -### webhookインデックス - -移行スクリプトは必要な`search`インデックスをオンラインで再構築した後、再構築が必要な`webhook`インデックスがあるかを確認します。 {% data variables.product.prodname_ghe_server %} 2.12 または 2.13 でアプライアンスを 14 日以上実行している場合は、`webhook` インデックスのデフォルトの保存ポリシーは 7 日間であるため、`webhook` インデックスを再構築する必要はおそらくないでしょう。 アプライアンスを{% data variables.product.prodname_enterprise %}2.11以前からアップデートするなら、`webhook`インデックスの再構築が必要かもしれません。 - -再構築が必要な`webhook`インデックスがある場合、スクリプトが`webhook`インデックスを再構築できるようになる前にメンテナンスモードを有効化するよう求められます。 `webhook`インデックスの移行にはいくらかのダウンタイムが必要ですが、長期にわたるメンテナンスウィンドウあるいはダウンタイムは必要ありません。 - -`webhook`インデックスは`hookshot-logs-`から始まります。 - -### 利用可能なインデックス - -アプライアンスで利用できるインデックスは、curlを使って見ることができます。 - -``` -admin@ip-172-31-2-141:~$ curl -s http://localhost:9200/_cat/indices?v | sort -n -k 6 -green open blog-1 1 0 0 0 144b 144b -green open projects-1 1 0 0 0 144b 144b -green open registry-packages-1 1 0 0 0 144b 144b -green open showcases-1 1 0 0 0 144b 144b -health status index pri rep docs.count docs.deleted store.size pri.store.size -green open pull-requests-1 1 0 1 0 9.3kb 9.3kb -green open wikis-1 1 0 2 0 5kb 5kb -green open hookshot-logs-2018-05-29 5 0 25 0 124.2kb 124.2kb -green open repos-1 1 0 1638 1 1.4mb 1.4mb -green open gists-1 1 0 3531 64 291.9kb 291.9kb -green open audit_log-1-2018-06-1 1 0 11108 0 3mb 3mb -green open users-1 1 0 19866 56 2.7mb 2.7mb -green open hookshot-logs-2018-05-31 5 0 20000 0 33.4mb 33.4mb -green open hookshot-logs-2018-06-04 5 0 20000 0 32.6mb 32.6mb -green open issues-1 1 0 26405 6 82.8mb 82.8mb -green open hookshot-logs-2018-05-30 5 0 119744 0 196.8mb 196.8mb -green open audit_log-1-2018-05-1 1 0 191664 0 50mb 50mb -green open code-search-1 1 0 6932626 44 42.9gb 42.9gb -green open commits-1 1 0 63753587 1485 45.4gb 45.4gb -``` - -### {% data variables.product.prodname_ghe_server %} 2.12 または 2.13 アプライアンスの準備 - -移行ツールを実行せずに {% data variables.product.prodname_ghe_server %} 2.14 以降にアップグレードすると、既存の Elasticsearch インデックスは無効になり、正しく機能しなくなる可能性があります。 Elasticsearch の移行スクリプトを実行するには、{% data variables.product.prodname_ghe_server %} アプライアンスは {% data variables.product.prodname_enterprise %} 2.12 または 2.13 を実行している必要があります。 - -{% warning %} - -**警告:** -- {% data variables.product.prodname_enterprise_backup_utilities %} を使用すると、5.X と互換性のない古い Elasticsearch インデックスは復元後に破棄されます。 この場合、手動での再インデックスが必要になるかもしれません。 -- {% data variables.product.prodname_ghe_server %} が High Availability 用に設定されている場合は、レプリケーションがまだ実行中の間に移行スクリプトを実行**しなければなりません**。 この変更は、アップグレードを開始する前に他のアプライアンスに完全にレプリケーションされるようになっていなければなりません。 移行スクリプトの実行中にレプリケーションが動作していなければ、Elasticsearchのインデックスは不正になることがあります。 - -{% endwarning %} - -1. High Availabilityが有効になっているプライマリアプライアンスにSSHで認証を受けてください。 -2. 移行スクリプトをダウンロードしてアプライアンスにインストールしてください。 - ```shell - $ wget https://github-enterprise.s3.amazonaws.com/util/es-5x-transition-tools.tar.gz - $ sudo tar -C / -xvf es-5x-transition-tools.tar.gz - ``` - {% data variables.product.prodname_ghe_server %} クラスタを管理する場合は、SSH を使用していずれかの Elasticsearch サーバーノードに認証し、移行ツールをそこにインストールします。 次を使用してそれらを配置します: - ```shell - $ ghe-cluster-each -r elasticsearch -p - ghe-test-data-0 - ghe-test-data-1 - ghe-test-data-2 - ``` -2. 移行スクリプトを実行します: - ```shell - $ /usr/local/share/enterprise/ghe-es-5x-migration -r - ``` - {% note %} - - **ノート:** 移行する`webhook`インデックスがあるなら、オンラインでの移行処理を実行した後、メンテナンスモードを有効にするよう求められます。 - - {% endnote %} -3. {% data variables.product.prodname_ghe_server %} クラスタを実行している場合は、単一 VM または High Availability 環境用の公式アップグレードドキュメント、またはクラスタアップグレードガイドに従ってください。 詳細は「[{% data variables.product.prodname_ghe_server %} をアップグレードする](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-github-enterprise-server/)」または「[クラスタをアップグレードする](/enterprise/{{ currentVersion }}/admin/guides/clustering/upgrading-a-cluster/)」を参照してください。 diff --git a/translations/ja-JP/content/admin/installation/migrating-from-github-enterprise-1110x-to-2123.md b/translations/ja-JP/content/admin/installation/migrating-from-github-enterprise-1110x-to-2123.md deleted file mode 100644 index dbe862e8c9a5..000000000000 --- a/translations/ja-JP/content/admin/installation/migrating-from-github-enterprise-1110x-to-2123.md +++ /dev/null @@ -1,90 +0,0 @@ ---- -title: GitHub Enterprise 11.10.xから2.1.23への移行 -redirect_from: - - /enterprise/admin-guide/migrating/ - - /enterprise/admin/articles/migrating-github-enterprise/ - - /enterprise/admin/guides/installation/migrating-from-github-enterprise-v11-10-34x/ - - /enterprise/admin/articles/upgrading-to-a-newer-release/ - - /enterprise/admin/guides/installation/migrating-to-a-different-platform-or-from-github-enterprise-11-10-34x/ - - /enterprise/admin/guides/installation/migrating-from-github-enterprise-11-10-x-to-2-1-23 - - /enterprise/admin/installation/migrating-from-github-enterprise-1110x-to-2123 -intro: '{% data variables.product.prodname_enterprise %}11.10.xから2.1.23へ移行するには、新しいアプライアンスのインスタンスをセットアップし、以前のインスタンスからデータを移行しなければなりません。' -versions: - enterprise-server: '*' ---- - -{% data variables.product.prodname_enterprise %}11.10.348以降からの移行がサポートされています。 {% data variables.product.prodname_enterprise %}11.10.348以前からの移行はサポートされていません。 いくつかのアップグレードを経て、まず11.10.348にアップグレードしなければなりません。 詳しい情報については11.10.348のアップグレード手順"[最新リリースへのアップグレード](/enterprise/11.10.340/admin/articles/upgrading-to-the-latest-release/)"を参照してください。 - -最新バージョンの {% data variables.product.prodname_enterprise %} にアップグレードするには、まず {% data variables.product.prodname_ghe_server %} 2.1 に移行する必要があります。その後、通常のアップグレードプロセスに従うことができます。 詳細は「[{% data variables.product.prodname_enterprise %} をアップグレードする](/enterprise/admin/guides/installation/upgrading-github-enterprise-server/)」参照してください。 - -### 移行の準備 - -1. プロビジョニング及びインストールガイドをレビューし、{% data variables.product.prodname_enterprise %}2.1.23を自分の環境にプロビジョニングして設定するのに必要な条件が満たされているかを確認してください。 詳しい情報については"[プロビジョニングとインストール](/enterprise/2.1/admin/guides/installation/provisioning-and-installation/)"を参照してください。 -2. 現在のインスタンスがサポートされているアップグレードバージョンを動作させていることを確認してください。 -3. 最新バージョンの {% data variables.product.prodname_enterprise_backup_utilities %} をセットアップします。 詳細は [{% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils) を参照してください。 - - {% data variables.product.prodname_enterprise_backup_utilities %}を使ってすでにスケジューリングされたバックアップを設定しているなら、最新バージョンにアップデートしたことを確認してください。 - - 現時点でスケジューリングされたバックアップを動作させていないなら、{% data variables.product.prodname_enterprise_backup_utilities %}をセットアップしてください。 -4. `ghe-backup`コマンドを使って、現在のインスタンスの初めてのフルバックアップスナップショットを取ってください。 現在のインスタンスですでにスケジューリングされたバックアップを設定しているなら、インスタンスのスナップショットを取る必要はありません。 - - {% tip %} - - **Tip:**スナップショットを取る間は、インスタンスをオンラインのままにして利用し続けられます。 移行作業のメンテナンスモードの間、別のスナップショットを取ることができます。 バックアップはインクリメンタルなので、この初期スナップショットは最終のスナップショットへのデータ転送量を減らしてくれます。それによって、メンテナンスウィンドウが短くなるかもしれません。 - - {% endtip %} - -5. ユーザーネットワークトラフィックを新しいインスタンスに切り替える方法を決定します。 移行した後に、すべての HTTP と Git のネットワークトラフィックは新しいインスタンスに送信されます。 - - **DNS** - この方法はシンプルであり、あるデータセンターから他のデータセンターへの移行であってもうまく働くことから、この方法はすべての環境でおすすめします。 移行を開始する前に、既存のDNSレコードのTTLを5分以下にして、変更が伝播するようにしてください。 移行が完了したら、DNSレコードを新しいインスタンスのIPアドレスを指すように更新してください。 - - **IPアドレスの割り当て** - この方法が利用できるのはVMWareからVMWareへの移行の場合のみであり、DNSを使う方法が利用できない場合以外にはおすすめできません。 移行を始める前に、古いインスタンスをシャットダウンしてそのIPアドレスを新しいインスタンスに割り当てる必要があります。 -6. メンテナンスウィンドウをスケジューリングしてください。 メンテナンスウィンドウには、データをバックアップホストから新しいインスタンスに転送するのに十分な時間が含まれていなければならず、その長さはバックアップスナップショットのサイズと利用可能なネットワーク帯域に基づいて変化します。 この間、現在のインスタンスは利用できなくなり、新しいインスタンスへの移行の間はメンテナンスモードになります。 - -### 移行の実施 - -1. 新しい{% data variables.product.prodname_enterprise %}2.1インスタンスをプロビジョニングしてください。 詳しい情報については、ターゲットのプラットフォームの"[プロビジョニングとインストール](/enterprise/2.1/admin/guides/installation/provisioning-and-installation/)"ガイドを参照してください。 -2. ブラウザで新しいレプリカアプライアンスのIPアドレスにアクセスして、所有する{% data variables.product.prodname_enterprise %}のライセンスをアップロードしてください。 -3. 管理者パスワードを設定してください。 -5. **Migrate（移行）**をクリックしてください。 ![インストールタイプの選択](/assets/images/enterprise/migration/migration-choose-install-type.png) -6. バックアップホストへのアクセス用のSSHキーを"Add new SSH key（新しいSSHキーの追加）"に貼り付けてください。 ![バックアップの認証](/assets/images/enterprise/migration/migration-authorize-backup-host.png) -7. **Add key（キーの追加）**をクリックし、続いて**Continue（続ける）**をクリックしてください。 -8. 新しいインスタンスへデータを移行するためにバックアップホストで実行する`ghe-restore`コマンドをコピーしてください。 ![移行の開始](/assets/images/enterprise/migration/migration-restore-start.png) -9. 古いインスタンスでメンテナンスモードを有効化し、すべてのアクティブなプロセスが完了するのを待ってください。 詳しい情報については"[メンテナンスモードの有効化とスケジューリング](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)"を参照してください。 - - {% note %} - - **ノート:** この時点から、インスタンスは通常の利用ができなくなります。 - - {% endnote %} - -10. バックアップホストで、`ghe-backup` コマンドを実行して最終的なバックアップスナップショットを作成します。 これにより、古いインスタンスからすべてのデータが確実にキャプチャされます。 -11. バックアップホストで、新しいインスタンスの復元ステータス画面でコピーした `ghe-restore` コマンドを実行して、最新のスナップショットを復元します。 - ```shell - $ ghe-restore 169.254.1.1 - The authenticity of host '169.254.1.1:122' can't be established. - RSA key fingerprint is fe:96:9e:ac:d0:22:7c:cf:22:68:f2:c3:c9:81:53:d1. - Are you sure you want to continue connecting (yes/no)? yes - Connect 169.254.1.1:122 OK (v2.0.0) - Starting restore of 169.254.1.1:122 from snapshot 20141014T141425 - Restoring Git repositories ... - Restoring GitHub Pages ... - Restoring asset attachments ... - Restoring hook deliveries ... - Restoring MySQL database ... - Restoring Redis database ... - Restoring SSH authorized keys ... - Restoring Elasticsearch indices ... - Restoring SSH host keys ... - Completed restore of 169.254.1.1:122 from snapshot 20141014T141425 - Visit https://169.254.1.1/setup/settings to review appliance configuration. - ``` - -12. 新しいインスタンスの復元ステータス画面に戻って、復元が完了したことを確認します。![復元完了画面](/assets/images/enterprise/migration/restore-complete-screen.png) -13. [**Continue to settings**] をクリックして、前のインスタンスからインポートされた設定情報を確認して調整します。 ![インポートされた設定をレビュー](/assets/images/enterprise/migration/migration-status-complete.png) -14. **Save settings（設定の保存）**をクリックしてください。 - - {% note %} - - **メモ:** 設定を適用してサーバーを再起動した後は、新しいインスタンスを使用できます。 - - {% endnote %} - -15. DNS または IP アドレスの割り当てのどちらかを使用して、ユーザーのネットワークトラフィックを古いインスタンスから新しいインスタンスに切り替えます。 -16. 最新のパッチリリース {{ currentVersion }} にアップグレードします。 詳細は「[{% data variables.product.prodname_ghe_server %} をアップグレードする](/enterprise/admin/guides/installation/upgrading-github-enterprise-server/)」を参照してください。 diff --git a/translations/ja-JP/content/admin/installation/migrating-to-a-different-git-large-file-storage-server.md b/translations/ja-JP/content/admin/installation/migrating-to-a-different-git-large-file-storage-server.md deleted file mode 100644 index 6351146ebd2a..000000000000 --- a/translations/ja-JP/content/admin/installation/migrating-to-a-different-git-large-file-storage-server.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: 異なるGit Large File Storageサーバへの移行 -intro: '{% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) クライアントを使用して、既存のサーバーからアセットを取得し、それらを新しい場所にプッシュすることで、新しい {% data variables.large_files.product_name_short %} サーバーに移行できます。' -redirect_from: - - /enterprise/admin/guides/installation/migrating-to-different-large-file-storage-server/ - - /enterprise/admin/installation/migrating-to-a-different-git-large-file-storage-server -versions: - enterprise-server: '*' ---- - -異なる{% data variables.large_files.product_name_long %}サーバに移行する前に、サードパーティサーバを使うよう{% data variables.large_files.product_name_short %}を設定しなければなりません。 詳しい情報については"[サードパーティサーバを使う{% data variables.large_files.product_name_long %}の設定](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-git-large-file-storage-to-use-a-third-party-server)"を参照してください。 - -1. 2 番目のリモートでリポジトリを設定します。 - ```shell - $ git remote add NEW-REMOTE https://NEW-REMOTE-HOSTNAME/path/to/repo -   - $ git lfs env - > git-lfs/1.1.0 (GitHub; darwin amd64; go 1.5.1; git 94d356c) - > git version 2.7.4 (Apple Git-66) -   - > Endpoint=https://GITHUB-ENTERPRISE-HOST/path/to/repo/info/lfs (auth=basic) - > Endpoint (NEW-REMOTE)=https://NEW-REMOTE-HOSTNAME/path/to/repo/info/lfs (auth=none) - ``` - -2. 古いリモートからすべてのオブジェクトを取得します。 - ```shell - $ git lfs fetch origin --all - > Scanning for all objects ever referenced... - > ✔ 16 objects found - > Fetching objects... - > Git LFS: (16 of 16 files) 48.71 MB / 48.85 MB - ``` - -3. すべてのオブジェクトを新しいリモートにプッシュします。 - ```shell - $ git lfs push NEW-REMOTE --all - > Scanning for all objects ever referenced... - > ✔ 16 objects found - > Pushing objects... - > Git LFS: (16 of 16 files) 48.00 MB / 48.85 MB, 879.10 KB skipped - ``` diff --git a/translations/ja-JP/content/admin/installation/migrating-to-internal-repositories.md b/translations/ja-JP/content/admin/installation/migrating-to-internal-repositories.md deleted file mode 100644 index 672325471cf8..000000000000 --- a/translations/ja-JP/content/admin/installation/migrating-to-internal-repositories.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: インターナルリポジトリへの移行 -intro: 'インターナルリポジトリへ移行して、{% data variables.product.prodname_ghe_server %}と{% data variables.product.prodname_ghe_cloud %}の両方を使う開発者の内部ソースに関する体験を統合できます。' -permissions: サイト管理者はインターナルリポジトリへ移行できます。 -redirect_from: - - /enterprise/admin/installation/migrating-to-internal-repositories -versions: - enterprise-server: '>=2.20' ---- - -### インターナルリポジトリについて - -インターナルリポジトリは、{% data variables.product.prodname_ghe_server %} 2.20+で利用できます。 {% data reusables.repositories.about-internal-repos %} 詳しい情報については「[リポジトリの可視性について](/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)」を参照してください。 - -{% data variables.product.prodname_ghe_server %}の将来のリリースでは、リポジトリの可視性の動作を調整し、パブリック、インターナル、プライベートという用語が{% data variables.product.prodname_ghe_server %}と{% data variables.product.prodname_ghe_cloud %}の開発者に対して統一的な意味合いを持つようにします。 - -これらの変更に備えるために、もしプライベートモードを有効化しているなら、インスタンスで移行を行ってパブリックリポジトリをインターナルに変換できます。 この移行は現時点ではオプションであり、非プロダクションのインスタンスで変更をテストできるようにするためのものです。 この移行は、将来は必須になります。 - -移行を行うと、インスタンス上でOrganizationが所有するすべてのパブリックリポジトリは、インターナルリポジトリになります。 それらのリポジトリのいずれかがフォークを持っていれば、そのフォークはプライベートになります。 プライベートリポジトリは、プライベートのままになります。 - -インスタンス上でユーザアカウントが所有するすべてのパブリックリポジトリは、プライベートリポジトリになります。 それらのリポジトリのいずれかがフォークを持っていれば、そのフォークもプライベートになります。 各フォークの所有者は、フォークの親に対して読み取り権限が与えられます。 - -インターナルもしくはプライベートになるパブリックリポジトリに対する匿名Git読み取りアクセスは、無効化されます。 - -リポジトリに対する現在のデフォルトの可視性がパブリックであれば、デフォルトはインターナルになります。 現在のデフォルトがプライベートであれば、デフォルトは変更されません。 デフォルトはいつでも変更できます。 詳しい情報については「[アプライアンス上の新しいリポジトリに対するデフォルトの可視性の設定](/enterprise/admin/installation/configuring-the-default-visibility-of-new-repositories-on-your-appliance)」を参照してください。 - -インスタンスに対するリポジトリの作成ポリシーは、パブリックリポジトリの無効化とプライベート及びインターナルリポジトリの許可に変更されます。 このポリシーはいつでも更新できます。 詳しい情報については「[インスタンスでのリポジトリ作成の制限](/enterprise/admin/user-management/restricting-repository-creation-in-your-instance)」を参照してください。 - -プライベートモードを有効化していないなら、移行スクリプトは何もしません。 - -### 移行の実施 - -1. 管理シェルに接続します。 詳しい情報については「[管理シェル（SSH）にアクセスする](/enterprise/admin/installation/accessing-the-administrative-shell-ssh)」を参照してください。 -2. `/data/github/current`ディレクトリにアクセスしてください。 - ``` - cd /data/github/current - ``` -3. 移行コマンドを実行してください。 - ``` - sudo bin/safe-ruby lib/github/transitions/20191210220630_convert_public_ghes_repos_to_internal.rb -v -w | tee -a /tmp/convert_public_ghes_repos_to_internal.log - ``` - -ログの出力は、ターミナルと`/tmp/convert_public_ghes_repos_to_internal.log`に対して行われます。 - -### 参考リンク - -- [プライベートモードの有効化](/enterprise/admin/installation/enabling-private-mode) diff --git a/translations/ja-JP/content/admin/installation/monitoring-activity-on-your-github-enterprise-server-instance.md b/translations/ja-JP/content/admin/installation/monitoring-activity-on-your-github-enterprise-server-instance.md deleted file mode 100644 index 951418a295d0..000000000000 --- a/translations/ja-JP/content/admin/installation/monitoring-activity-on-your-github-enterprise-server-instance.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: GitHub Enterprise Server インスタンスでのモニタリング -mapTopic: true -redirect_from: - - /enterprise/admin/installation/monitoring-activity-on-your-github-enterprise-server-instance -versions: - enterprise-server: '*' ---- - diff --git a/translations/ja-JP/content/admin/installation/monitoring-using-snmp.md b/translations/ja-JP/content/admin/installation/monitoring-using-snmp.md deleted file mode 100644 index 8fd4f6b71bba..000000000000 --- a/translations/ja-JP/content/admin/installation/monitoring-using-snmp.md +++ /dev/null @@ -1,107 +0,0 @@ ---- -title: SNMP での監視 -intro: '{% data variables.product.prodname_enterprise %}は、SNMP経由でディスクの使用や CPU の使用率、メモリーの使用などのデータを提供します。' -redirect_from: - - /enterprise/admin/articles/monitoring-using-snmp/ - - /enterprise/admin/installation/monitoring-using-snmp -versions: - enterprise-server: '*' ---- - -SNMP とは、ネットワーク経由でデバイスを監視するための一般的基準です。 {% data variables.product.product_location_enterprise %}のj状態を監視可能にし、いつホストのマシンにメモリやストレージ、処理能力を追加すべきかを知るために、SNMP を有効にすることを強くおすすめします。 - -{% data variables.product.prodname_enterprise %} には標準の SNMP がインストールされているので、Nagios などのモニタリングシステムに対して利用可能な[数多くのプラグイン](http://www.monitoring-plugins.org/doc/man/check_snmp.html)を活用できます。 - -### SNMP v2c を設定 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.access-monitoring %} -{% data reusables.enterprise_management_console.enable-snmp %} -4. **Community string** の欄では、新しいコミュニティ文字列を入力する。 空白のままだと、`public`という設定になります。 ![コミュニティ文字列型を追加するためのフィールド](/assets/images/enterprise/management-console/community-string.png) -{% data reusables.enterprise_management_console.save-settings %} -5. SNMP に対応している別のワークステーションで次のコマンドを実行して、SNMP のコンフィグレーションをテストする。 - ```shell - # community-string is your community string - # hostname is the IP or domain of your Enterprise instance - $ snmpget -v 2c -c community-string -O e hostname hrSystemDate.0 - ``` - -これにより、{% data variables.product.product_location_enterprise %} ホストでのシステム時刻が返されます。 - -### ユーザベースのセキュリティ - -SNMP v3 を有効にすると、ユーザセキュリティモデル (USM) により、強化されたユーザベースのセキュリティを利用できます。 ユーザごとに、以下のセキュリティレベルを指定できます: -- `noAuthNoPriv`: このセキュリティレベルは認証もプライバシーも提供しません。 -- `authNoPriv`: このセキュリティレベルは認証を提供しますがプライバシーは提供しません。 アプライアンスを照会するには、ユーザ名とパスワード (最低 8 文字) が必要です。 SNMPv2 と同様に、情報は暗号化されずに送信されます。 可能な認証プロトコルは MD5 または SHA であり、デフォルトは SHA です。 -- `authPriv`: このセキュリティレベルはプライバシーと共に認証を提供します。 8 文字以上の認証パスワードを含む認証が必要であり、返信は暗号化されます。 プライバシーパスワードは必須ではありませんが、指定する場合は 8 文字以上でなければなりません。 プライバシーパスワードが指定されない場合は、認証パスワードが使用されます。 プライバシープロトコルは DES または AES のいずれかが可能であり、デフォルトは AES です。 - -### SNMP v3 用にユーザーを設定する - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.access-monitoring %} -{% data reusables.enterprise_management_console.enable-snmp %} -4. [**SNMP v3**] を選択します。 ![SNMP v3 を有効化するボタン](/assets/images/enterprise/management-console/enable-snmpv3.png) -5. [Username] に、SNMP v3 ユーザの固有なユーザ名を入力します。 ![SNMP v3 ユーザ名を入力するためのフィールド](/assets/images/enterprise/management-console/snmpv3-username.png) -6. [**Security Level**] ドロップダウンメニューで、SNMP v3 ユーザ ー用のセキュリティレベルをクリックします。 ![SNMP v3 ユーザのセキュリティレベルを指定するためのドロップダウンメニュー](/assets/images/enterprise/management-console/snmpv3-securitylevel.png) -7. セキュリティレベルが `authnopriv` である SNMP v3 ユーザの場合: ![セキュリティレベル authnopriv の設定](/assets/images/enterprise/management-console/snmpv3-authnopriv.png) - - {% data reusables.enterprise_management_console.authentication-password %} - - {% data reusables.enterprise_management_console.authentication-protocol %} -8. セキュリティレベルが `authpriv` である SNMP v3 ユーザの場合: ![セキュリティレベル authpriv の設定](/assets/images/enterprise/management-console/snmpv3-authpriv.png) - - {% data reusables.enterprise_management_console.authentication-password %} - - {% data reusables.enterprise_management_console.authentication-protocol %} - - 任意で、[Privacy password] にプライバシーパスワードを入力します。 - - [Privacy password] の右側にある [**Protocol**] ドロップダウンメニューで、使用するプライバシープロトコル方式をクリックします。 -9. [**Add user**] をクリックします。 ![SNMP v3 ユーザを追加するボタン](/assets/images/enterprise/management-console/snmpv3-adduser.png) -{% data reusables.enterprise_management_console.save-settings %} - -##### SNMP データの照会 - -アプライアンスに関するハードウェアレベルとソフトウェアレベルの両方の情報が SNMP v3 で利用できます。 `noAuthNoPriv` と `authNoPriv` のセキュリティレベルでは暗号化とプライバシーが欠如しているため、結果の SNMP レポートから `hrSWRun` の表 (1.1.3.6.1.2.1.25.41) は除外されます。 セキュリティレベル `authPriv` を使用している場合は、この表が掲載されます。 - -SNMP v2c では、アプライアンスに関するハードウェアレベルの情報のみが利用できます。 {% data variables.product.prodname_enterprise %} 内のアプリケーションとサービスには、メトリックスを報告するように設定された OID がありません。 いくつかの MIB が利用できます。ネットワーク内において SNMP をサポートしている別のワークステーションで `snmpwalk` を実行することで、利用できる MIB を確認できます。 - -```shell -# community-string is your community string -# hostname is the IP or domain of your Enterprise instance -$ snmpwalk -v 2c -c community-string -O e hostname -``` - -SNMP に対して利用可能な MIB のうち、最も有用なものは `HOST-RESOURCES-MIB` (.1.3.6.1.2.1.25) です。 この MIB のいくつかの重要なオブジェクトについては、以下の表を参照してください: - -| 名前 | OID | 説明 | -| -------------------------- | ------------------------- | ---------------------------------------- | -| hrSystemDate.2 | .1.3.6.1.2.1.25.1.2 | ホストから見たローカルの日付と時間。 | -| hrSystemUptime.0 | .1.3.6.1.2.1.25.1.1.0 | 前回ホストが起動してからの時間。 | -| hrMemorySize.0 | .1.3.6.1.2.1.25.2.2.0 | ホストが持っているRAMの容量。 | -| hrSystemProcesses.0 | .1.3.6.1.2.1.25.1.6.0 | 現在、ホストでロードされている、または作動しているプロセスのコンテキストの数。 | -| hrStorageUsed.1 | .1.3.6.1.2.1.25.2.3.1.6.1 | hrStorageAllocationUnits のホストの使用ストレージ領域。 | -| hrStorageAllocationUnits.1 | .1.3.6.1.2.1.25.2.3.1.4.1 | hrStorageAllocationUnit のバイトでのサイズ | - -たとえば、SNMP v3 で `hrMemorySize` を照会するには、ネットワークで SNMP をサポートしている別のワークステーションで次のコマンドを実行します: -```shell -# username はあなたの SNMP v3 ユーザの一意のユーザ名 -# auth password は認証パスワード -# privacy password はプライバシーパスワード -# hostname はあなたの Enterprise インスタンスの IP またはドメイン -$ snmpget -v 3 -u username -l authPriv \ - -A "auth password" -a SHA \ - -X "privacy password" -x AES \ - -O e hostname HOST-RESOURCES-MIB::hrMemorySize.0 -``` - -SNMP v2c で `hrMemorySize` を照会するには、ネットワークで SNMP をサポートしている別のワークステーションで次のコマンドを実行します: -```shell -# community-string はあなたのコミュニティ文字列 -# hostname はあなたの Enterprise インスタンスの IP またはドメイン -snmpget -v 2c -c community-string hostname HOST-RESOURCES-MIB::hrMemorySize.0 -``` - -{% tip %} - -**メモ:** アプライアンスで実行中のサービスに関する情報の漏洩を防ぐために、SNMP v3 でセキュリティレベル `authPriv` を使用していない限り、結果の SNMP レポートから `hrSWRun` の表 (1.1.3.6.1.2.1.25.41) は除外されます。 セキュリティレベル `authPriv` を使用している場合は、`hrSWRun` の表が掲載されます。 - -{% endtip %} - -SNMP での一般的なシステム属性に対する OID マッピングの詳しい情報については、「[CPU、メモリ、ディスクの統計情報に対する Linux SNMP OID](http://www.linux-admins.net/2012/02/linux-snmp-oids-for-cpumemory-and-disk.html)」を参照してください。 diff --git a/translations/ja-JP/content/admin/installation/monitoring-your-github-enterprise-server-appliance.md b/translations/ja-JP/content/admin/installation/monitoring-your-github-enterprise-server-appliance.md deleted file mode 100644 index 462cdd878cb5..000000000000 --- a/translations/ja-JP/content/admin/installation/monitoring-your-github-enterprise-server-appliance.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: GitHub Enterprise Server アプライアンスのモニタリング -intro: '{% data variables.product.product_location_enterprise %} インスタンスの使用が時間とともに増加するにつれて、CPU、メモリ、ストレージなどのシステムリソースの利用率も増加します。 アプリケーションのパフォーマンスや可用性にマイナスの影響を及ぼすほど重大になる前に潜在的な問題に気づけるよう、モニタリングやアラートを設定することができます。' -redirect_from: - - /enterprise/admin/guides/installation/system-resource-monitoring-and-alerting/ - - /enterprise/admin/guides/installation/monitoring-your-github-enterprise-appliance/ - - /enterprise/admin/installation/monitoring-your-github-enterprise-server-appliance -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/ja-JP/content/admin/installation/network-ports.md b/translations/ja-JP/content/admin/installation/network-ports.md deleted file mode 100644 index 4fef76bc0e65..000000000000 --- a/translations/ja-JP/content/admin/installation/network-ports.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: ネットワークポート -redirect_from: - - /enterprise/admin/articles/configuring-firewalls/ - - /enterprise/admin/articles/firewall/ - - /enterprise/admin/guides/installation/network-configuration/ - - /enterprise/admin/guides/installation/network-ports-to-open/ - - /enterprise/admin/installation/network-ports -intro: オープンするネットワークポートは、管理者、エンドユーザ、メールサポートへ公開する必要があるネットワークサービスに応じて選択してください。 -versions: - enterprise-server: '*' ---- - -### 管理ポート - -{% data variables.product.product_location_enterprise %}を設定し、一部の機能を実行するためにはいくつかの管理ポートが必要です。 管理ポートは、エンドユーザが基本的なアプリケーションを利用するためには必要ありません。 - -| ポート | サービス | 説明 | -| -------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| 8443 | HTTPS | 安全な Web ベースの {% data variables.enterprise.management_console %}。 基本的なインストールと設定に必要です。 | -| 8080 | HTTP | プレーンテキストの Web ベースの {% data variables.enterprise.management_console %}。 SSL を手動で無効にしない限り必要ありません。 | -| 122 | SSH | {% data variables.product.product_location_enterprise %} 用のシェルアクセス。 High Availability 設定では他のすべてのノードからの着信接続に対して開かれている必要があります。 デフォルトの SSHポート (22) は Git と SSH のアプリケーションネットワークトラフィック専用です。 | -| 1194/UDP | VPN | High Availability設定でのセキュアなレプリケーションネットワークトンネル。 その設定では他のすべてのノードに対して開かれている必要があります。 | -| 123/UDP | NTP | timeプロトコルの処理に必要。 | -| 161/UDP | SNMP | ネットワークモニタリングプロトコルの処理に必要。 | - -### エンドユーザーのためのアプリケーションポート - -アプリケーションのポートは、エンドユーザーにWebアプリケーションとGitへのアクセスを提供します。 - -| ポート | サービス | 説明 | -| ---- | ----- | --------------------------------------------------------------------- | -| 443 | HTTPS | WebアプリケーションとGit over HTTPSのアクセス。 | -| 80 | HTTP | Web アプリケーションへのアクセス。 SSL が有効な場合にすべての要求は HTTPS ポートにリダイレクトされます。 | -| 22 | SSH | Git over SSH へのアクセス。 パブリックとプライベートリポジトリへの clone、fetch、push 操作をサポートします。 | -| 9418 | Git | Gitプロトコルのポート。暗号化されないネットワーク通信でのパブリックなリポジトリへのclone及びfetch操作をサポートする。 | - -{% data reusables.enterprise_installation.terminating-tls %} - -### メールのポート - -メールのポートは直接あるいはエンドユーザ用のインバウンドメールサポートのリレーを経由してアクセスできなければなりません。 - -| ポート | サービス | 説明 | -| --- | ---- | -------------------------- | -| 25 | SMTP | 暗号化ありのSMTP（STARTTLS）のサポート。 | diff --git a/translations/ja-JP/content/admin/installation/recommended-alert-thresholds.md b/translations/ja-JP/content/admin/installation/recommended-alert-thresholds.md deleted file mode 100644 index 2c3b93778f2f..000000000000 --- a/translations/ja-JP/content/admin/installation/recommended-alert-thresholds.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: アラートの推奨閾値 -intro: '{% data variables.product.prodname_ghe_server %} アプライアンスのパフォーマンスに影響を与える前に、システムリソースの問題を通知するようにアラートを設定できます。' -redirect_from: - - /enterprise/admin/guides/installation/about-recommended-alert-thresholds/ - - /enterprise/admin/installation/recommended-alert-thresholds -versions: - enterprise-server: '*' ---- - -### ストレージのモニタリング - -ルート及びユーザストレージデバイスの両方をモニタリングし、利用可能なディスク領域が少なくなったときに十分な対応時間が持てるような値でアラートを設定することをおすすめします。 - -| 重要度 | 閾値 | -| ------------ | -------------------- | -| **Warning** | ディスクの使用量が総容量の70%を超えた | -| **Critical** | ディスクの使用量が総容量の85%を超えた | - -これらの値は、割り当てられたストレージの総量、過去の増大パターン、対応が求められる時間に基づいて調整できます。 ストレージリソースは、増加を許容し、追加ストレージの割り当てに必要なダウンタイムを回避するために、多めに割り当てておくことをおすすめします。 - -### CPUとロードアベレージのモニタリング - -リソース集約的なGitの操作によってCPUの利用状況が変動するのは通常のことですが、異常に高いCPU利用状況にはアラートを設定することをおすすめします。これは、長引くスパイクはインスタンスのプロビジョニングが不足しているということかもしれないためです。 15分間のシステムロードアベレージが、仮想マシンに割り当てられたCPUコア数に近いかそれを超える値になっていないかをモニタリングすることをおすすめします。 - -| 重要度 | 閾値 | -| ------------ | -------------------------- | -| **Warning** | 15分間のロードアベレージが1x CPUコアを超える | -| **Critical** | 15分間のロードアベレージが2x CPUコアを超える | - -また、仮想化の"steal"時間をモニタリングして、同一ホスト上で動作している他の仮想マシンがインスタンスのリソースをすべて使ってしまっていることがないことを確認するようおすすめします。 - -### メモリの利用状況のモニタリング - -{% data variables.product.product_location_enterprise %}に割り当てられている物理メモリの量は、全体的なパフォーマンスとアプリケーションの反応性に大きな影響があります。 システムは、Gitの処理を高速化するためにカーネルのディスクキャッシュを頻繁に利用するよう設計されています。 ピークの利用状況で、通常のRSSワーキングセットがRAMの総容量の50%以内に収まるようにすることをおすすめします。 - -| 重要度 | 閾値 | -| ------------ | ------------------------------- | -| **Warning** | 持続的にRSSの利用状況が利用可能なメモリ総量の50%を超える | -| **Critical** | 持続的にRSSの利用状況が利用可能なメモリ総量の70%を超える | - -メモリが使い切られると、カーネルOOMキラーはRAMを大量に使っているアプリケーションプロセスを強制的にkillしてメモリリソースを解放しようとします。これは、サービスの中断につながることがあります。 通常の処理の状況で必要になる以上のメモリを仮想マシンに割り当てることをおすすめします。 diff --git a/translations/ja-JP/content/admin/installation/recovering-a-high-availability-configuration.md b/translations/ja-JP/content/admin/installation/recovering-a-high-availability-configuration.md deleted file mode 100644 index 1641ee04f893..000000000000 --- a/translations/ja-JP/content/admin/installation/recovering-a-high-availability-configuration.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: High Availability設定のリカバリ -intro: '{% data variables.product.prodname_ghe_server %} アプライアンスにフェイルオーバーした後は、単一のアプライアンスに頼るのではなく、できるだけ早く冗長性を取り戻す必要があります。' -redirect_from: - - /enterprise/admin/installation/recovering-a-high-availability-configuration -versions: - enterprise-server: '*' ---- - -フェイルオーバーが計画済みのものだったり、アプライアンスの健全性に関係ないものである場合、以前のプライマリアプライアンスを新しいレプリカアプライアンスとして使用できます。 フェイルオーバーがプライマリアプライアンスの問題に関係しているなら、新しいレプリカアプライアンスを作成する方が良いでしょう。 詳しい情報については"[High Availabilityレプリカの作成](/enterprise/{{ currentVersion }}/admin/guides/installation/creating-a-high-availability-replica/)"を参照してください。 - -### 以前のプライマリアプライアンスを新しいレプリカとして設定する - -1. SSH を使用して以前のプライマリアプライアンスの IP アドレスに接続します。 - ```shell - $ ssh -p 122 admin@FORMER PRIMARY IP - ``` -2. 以前のプライマリアプライアンスで、以前のレプリカの IP アドレスを指定して `ghe-repl-setup` を実行します。 - ```shell - $ ghe-repl-setup FORMER REPLICA IP - ``` -{% data reusables.enterprise_installation.add-ssh-key-to-primary %} -4. 新しいプライマリへの接続を確認し、新しいレプリカのレプリカモードを有効にするには、`ghe-repl-setup` をもう一度実行します。 - ```shell - $ ghe-repl-setup FORMER REPLICA IP - ``` -{% data reusables.enterprise_installation.replication-command %} diff --git a/translations/ja-JP/content/admin/installation/removing-a-high-availability-replica.md b/translations/ja-JP/content/admin/installation/removing-a-high-availability-replica.md deleted file mode 100644 index 9744573221e4..000000000000 --- a/translations/ja-JP/content/admin/installation/removing-a-high-availability-replica.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: High Availabilityレプリカの削除 -intro: '{% data variables.product.prodname_ghe_server %} レプリカへのレプリケーションを一時的に停止することも、レプリケーションを恒久的に削除することもできます。' -redirect_from: - - /enterprise/admin/installation/removing-a-high-availability-replica -versions: - enterprise-server: '*' ---- - -### 一時的なレプリケーションの停止 - -1. 必要に応じて、Geo-replication レプリカ用の Geo DNS エントリを削除することで、そのレプリカにユーザトラフィックを処理させないようにします。 -2. レプリケーションを一時的に停止させたいレプリカで、ghe-repl-stop を実行します。 - ```shell - $ ghe-repl-stop - ``` -3. レプリケーションを再開するには、`ghe-repl-start` を実行します。 - ```shell - $ ghe-repl-start - ``` - -### レプリケーションの恒久的な削除 - -1. 必要に応じて、Geo-replication レプリカ用の Geo DNS エントリを削除することで、そのレプリカにユーザトラフィックを処理させないようにします。 -2. レプリケーションを削除するレプリカで、`ghe-repl-stop` を実行します。 - ```shell - $ ghe-repl-stop - ``` -3. レプリカでレプリケーション状態を解除するには、`ghe-repl-teardown` を実行します。 - ```shell - $ ghe-repl-teardown - ``` diff --git a/translations/ja-JP/content/admin/installation/searching-the-audit-log.md b/translations/ja-JP/content/admin/installation/searching-the-audit-log.md deleted file mode 100644 index ab6fc030ccf1..000000000000 --- a/translations/ja-JP/content/admin/installation/searching-the-audit-log.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: Audit log を検索する -intro: 'サイト管理者は、{% data variables.product.product_location_enterprise %} で[監査されたアクション](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions)の広範なリストを検索することができます。' -redirect_from: - - /enterprise/admin/articles/searching-the-audit-log/ - - /enterprise/admin/installation/searching-the-audit-log -versions: - enterprise-server: '*' ---- - -### 検索クエリの構文 - -AND/ORの論理演算子で区切られた値のペア:1つ以上のキーを使って、検索クエリを構成します。 - -| キー | 値 | -| --------------:| ----------------------------------------------------------------------------------------- | -| `actor_id` | アクションを開始したユーザアカウントの ID | -| `actor` | アクションを開始したユーザアカウントの名前 | -| `oauth_app_id` | アクションに関連付けられている OAuth アプリケーションの ID | -| `action` | [監査されたアクション](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions)の名前 | -| `user_id` | アクションによって影響を受けたユーザの ID | -| `ユーザ` | アクションによって影響を受けたユーザの名前 | -| `repo_id` | アクションによって影響を受けたリポジトリの ID （妥当な場合） | -| `repo` | アクションによって影響を受けたリポジトリの名前 （妥当な場合） | -| `actor_ip` | アクション元の IP アドレス | -| `created_at` | アクションが作成された時間 | -| `from` | アクション元の View | -| `note` | イベント固有の他の情報（プレーンテキストまたは JSON フォーマット） | -| `org` | アクションによって影響を受けたOrganizationの名前（該当する場合） | -| `org_id` | アクションによって影響を受けたOrganizationの ID（該当する場合） | - -たとえば、2017 年の初めからリポジトリ `octocat/Spoon-Knife` に影響を与えたすべてのアクションを確認するには、次のようにします: - - `repo:"octocat/Spoon-Knife" AND created_at:[2017-01-01 TO *]` - -アクションの全リストについては「[監査されたアクション](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions)」を参照してください。 - -### Audit log を検索する - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.audit-log-tab %} -4. 検索クエリを入力します。![検索クエリ](/assets/images/enterprise/site-admin-settings/search-query.png) diff --git a/translations/ja-JP/content/admin/installation/setting-git-push-limits.md b/translations/ja-JP/content/admin/installation/setting-git-push-limits.md deleted file mode 100644 index 6fc103856cb7..000000000000 --- a/translations/ja-JP/content/admin/installation/setting-git-push-limits.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: Git のプッシュ制限を設定 -intro: リポジトリ内のGitオブジェクトに対して最大サイズを強制できます。 -redirect_from: - - /enterprise/admin/guides/installation/git-server-settings/ - - /enterprise/admin/articles/setting-git-push-limits/ - - /enterprise/admin/installation/setting-git-push-limits -versions: - enterprise-server: '*' ---- - -リポジトリのサイズを管理できるように留め、パフォーマンスの問題を避けるために、インスタンス上のリポジトリのファイルサイズに制限を設定できます。 - -デフォルトでは、リポジトリのアップロード制限を適用すると、100MB以上のファイルの追加やアップロードができなくなります。 - -{% if currentVersion ver_lt "enterprise-server@2.20" %} -{% tip %} - -**注：**{% data variables.large_files.warning_size %}以上のサイズのファイルのみが、Gitプッシュの制限に照らし合わせて確認されます。 プッシュ制限をより小さくする必要がある場合は、{% data variables.contact.contact_ent_support %}までお問い合わせください。 - -{% endtip %} -{% endif %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -4. [Repository upload limit] で、ドロップダウンメニューを使用して最大オブジェクトサイズをクリックします。 ![最大オブジェクトサイズのオプションを備えたドロップダウンメニュー](/assets/images/enterprise/site-admin-settings/repo-upload-limit-dropdown.png) -5. あるいは、{% data variables.product.product_location_enterprise %}上のすべてのリポジトリにアップロードの最大制限を適用するために、**Enforce on all repositories（すべてのリポジトリに適用）**を選択してください。 ![すべてのリポジトリにオブジェクトの最大サイズを適用するオプション](/assets/images/enterprise/site-admin-settings/all-repo-upload-limit-option.png) diff --git a/translations/ja-JP/content/admin/installation/setting-up-external-monitoring.md b/translations/ja-JP/content/admin/installation/setting-up-external-monitoring.md deleted file mode 100644 index 696291ce3d16..000000000000 --- a/translations/ja-JP/content/admin/installation/setting-up-external-monitoring.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: 外部モニタリングのセットアップ -intro: 'SNMP または collectd のいずれかの統計収集プロトコルを使用すれば、{% data variables.product.prodname_ghe_server %} アプライアンスで基本的なシステムリソースを監視できます。' -redirect_from: - - /enterprise/admin/installation/setting-up-external-monitoring -versions: - enterprise-server: '*' ---- - -### SNMPについて - -Simple Network Management Protocol (SNMP) は、ネットワークデバイスやサーバのモニタリングの方法として広くサポートされています。 SNMPはデフォルトでは無効化されていますが、{% data variables.product.prodname_enterprise %}モニタリングダッシュボードを通じて設定できます。 UDPポート161は、オープンでネットワーク管理ステーションから到達可能でなければなりません。 詳細は「[SNMPを使用したモニタリング](/enterprise/{{ currentVersion }}/admin/guides/installation/monitoring-using-snmp/)」を参照してください。 - -### collectdについて - -collectdはオープンソースの統計収集及びレポーティングデーモンで、RRDファイルの書き込みサポートが組み込まれています。 CPUの利用状況、メモリ及びディスクの消費、ネットワークインターフェースのトラフィックとエラー、システムの負荷に関する統計を外部のcollectdサーバに転送でき、そこで利用可能な幅広いツールやプラグインを使ってグラフ、分析、アラートを設定できます。 `collectd` 転送を設定するには、「[collectdの設定](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-collectd/)」を参照してください。 - -加えて、下位層の仮想化プラットフォームに組み込まれているモニタリングツールも、システムリソースの基本的なモニタリングとアラートに利用できます。 詳しい情報については[Amazon CloudWatch](https://aws.amazon.com/jp/cloudwatch//)や[vSphere の監視およびパフォー マンス](http://pubs.vmware.com/vsphere-50/topic/com.vmware.ICbase/PDF/vsphere-esxi-vcenter-server-50-monitoring-performance-guide.pdf)といったドキュメンテーションを参照してください。 diff --git a/translations/ja-JP/content/admin/installation/site-admin-dashboard.md b/translations/ja-JP/content/admin/installation/site-admin-dashboard.md deleted file mode 100644 index b25885407eda..000000000000 --- a/translations/ja-JP/content/admin/installation/site-admin-dashboard.md +++ /dev/null @@ -1,178 +0,0 @@ ---- -title: サイトアドミンのダッシュボード -intro: 'サイトアドミンのダッシュボードには、{% data variables.product.product_location_enterprise %} インスタンスを管理するのに役立つ多数のツールが備わっています。' -redirect_from: - - /enterprise/admin/articles/site-admin-dashboard/ - - /enterprise/admin/installation/site-admin-dashboard -versions: - enterprise-server: '*' ---- - -ダッシュボードへアクセスするには、ページ右上の隅にある {% octicon "rocket" aria-label="The rocket ship" %}をクリックしてください。 ![サイトアドミン設定にアクセスするための宇宙船のアイコン](/assets/images/enterprise/site-admin-settings/access-new-settings.png) - -### ライセンスの情報と検索 - -現在の {% data variables.product.prodname_enterprise %} のライセンスを確認する、ユーザとリポジトリを検索する、そして [Audit log](#audit-log) を照会するには、サイトアドミンのダッシュボードのこのセクションを参照してください。 - -### {% data variables.enterprise.management_console %} - -ここで、ドメインや認証、SSL などの仮想アプライアンスの設定を管理するための {% data variables.enterprise.management_console %}を起動することができます。 - -### Explorer - - GitHub の[ 流行ページ](https://github.com/blog/1585-explore-what-is-trending-on-github) のためのデータは、リポジトリとデベロッパーの両方において、日ごと、週ごと、月ごとの期間で計算されます。 **Explore** のセクションで、このデータが最後にいつキャッシュされたのかの確認や、新規流行計算ジョブをキューに挿入することができます。 - -### Audit log - -{% data variables.product.prodname_enterprise %}は、クエリで確認できる、監査されたアクションのログを保持しています。 - -デフォルトでは、Audit log は、監査されたアクション全てを新しい順で表示します。 「[Audit log を検索する](/enterprise/{{ currentVersion }}/admin/guides/installation/searching-the-audit-log)」で説明されているように、[**Query**] テキストボックスにキーと値のペアを入力して [**Search**] をクリックすることで、このリストをフィルタリングできます。 - -監査ログ記録全般の詳しい情報については「[監査ログ記録](/enterprise/{{ currentVersion }}/admin/guides/installation/audit-logging)」を参照してください。監査済みアクションの全リストについては「[監査済みアクション](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions)」を参照してください。 - -### 報告 - -{% data variables.product.product_location_enterprise %}にある、ユーザやOrganization、リポジトリについての情報が必要な場合、一般的には、[GitHub API](http://developer.github.com/v3/) を使って、JSON のデータをフェッチします。 残念ながら、API は、必要なデータを提供しない可能性があり、使用するのには専門知識が必要です。 サイトアドミンのダッシュボードには代替手段として [**Reports**] セクションがあり、ユーザー、Organization、およびリポジトリに必要と思われるほぼすべての情報を掲載した CSV レポートを簡単にダウンロードできます。 - -具体的には、次の情報を含む CSV 報告をダウンロードできます。 - -- 全ユーザ -- 過去一ケ月の間、アクティブだった全ユーザ -- 過去一ケ月、アクティブでなかった全ユーザ -- 停止されている全ユーザ -- 全ての Organization -- 全ての リポジトリ - -サイトアドミンのアカウントを用いて標準の HTTP 認証を使用すれば、これらのレポートにプログラムでアクセスすることもできます。 You must use a personal access token with the `site_admin` scope. For more information, see "[Creating a personal access token](/github/authenticating-to-github/creating-a-personal-access-token)." - -たとえば、cURL を使用して "all users" レポートをダウンロードする方法は次のとおりです: - -```shell -curl -L -u username:token http(s)://hostname/stafftools/reports/all_users.csv -``` - -他の報告にプログラムでアクセスするには、 `all_users` を `active_users`や、 `dormant_users`、`suspended_users`、`all_organizations`、`all_repositories` に置き換えてください。 - -{% note %} - -**注：** キャッシュされた報告がない場合、最初の `curl` リクエストは、 202の HTTP レスポンスを返して、報告は背景で生成されます。 もう一度リクエストを送れば、その報告をダウンロードすることができます。 パスワードの代わりに、`site_admin` スコープでのパスワードまたはOAuthトークンを使うことができます。 - -{% endnote %} - -#### ユーザ報告 - -| キー | 説明 | -| -----------------:| -------------------------------------- | -| `created_at` | ユーザアカウントの作成時間（ISO 8601 のタイムスタンプ） | -| `id` | ユーザまたはOrganization のアカウント ID | -| `login` | アカウントのログイン名 | -| `email` | アカウントのプライマリメールアドレス | -| `ロール` | アカウントがアドミンか一般ユーザか | -| `suspended?` | アカウントが停止されているか | -| `last_logged_ip` | 最後にアカウントにログインしたときの IP アドレス | -| `repos` | アカウントが所有しているリポジトリの数 | -| `ssh_keys` | アカウントに登録されているSSHキーの数 | -| `org_memberships` | アカウントが所属している Organization の数 | -| `dormant?` | アカウントが休眠であるかどうか | -| `last_active` | アカウントが最後にアクティブだったとき（ISO 8601 のタイムスタンプ） | -| `raw_login` | （JSON フォーマットでの）未処理のログイン情報 | -| `2fa_enabled?` | ユーザが二段階認証を有効にしているかどうか | - -#### Organization の報告 - -| キー | 説明 | -| ---------------:| ------------------------------- | -| `id` | Organization の ID | -| `created_at` | Organization の作成時間 | -| `login` | Organization のログイン名 | -| `email` | Organization のプライマリメールアドレス | -| `owners` | Organizationのオーナーの数 | -| `members` | Organization のメンバーの数 | -| `teams` | Organization のチームの数 | -| `repos` | Organization のリポジトリの数 | -| `2fa_required?` | Organization が二段階認証を有効にしているかどうか | - -#### リポジトリ の報告 - -| キー | 説明 | -| ---------------:| ----------------------------- | -| `created_at` | リポジトリの作成時間 | -| `owner_id` | リポジトリのコードオーナーの ID | -| `owner_type` | リポジトリの所有者がユーザか Organization か | -| `owner_name` | リポジトリの所有者の名前 | -| `id` | リポジトリの ID | -| `name` | リポジトリの名前 | -| `visibility` | リポジトリが公開かプライベートか | -| `readable_size` | 人間が読める形式のリポジトリのサイズ | -| `raw_size` | 数字でのリポジトリのサイズ | -| `collaborators` | リポジトリのコラボレータの数 | -| `fork?` | リポジトリがフォークであるかどうか | -| `deleted?` | リポジトリが削除されているかどうか | - -### インデックス化 - - GitHub の[コード検索](https://github.com/blog/1381-a-whole-new-code-search)フィーチャは、[Elasticsearch](http://www.elasticsearch.org/) に駆動されています。 サイトアドミンのダッシュボードのこのセクションには、ElasticSearch クラスターの現在のステータスが表示され、検索とインデックス作成の動作を制御するためのいくつかのツールが用意されています。 このツールは、次の3つのカテゴリーに分類されています。 - -#### コード検索 - -これによって、ソースコードに対する検索とインデックスの作業を有効または無効にすることができます。 - -#### コード検索インデックスの修復 - -これはコード検索インデックスがどのように修復されるかを制御します。 次のことができます: - -- インデックスの修理ジョブを有効または無効にする -- 新規インデックス修理ジョブを開始する -- インデックス修理状態を全てリセットする - -{% data variables.product.prodname_enterprise %}は、修理ジョブを使って、検索インデックスの状態をデータベースで保存されているデータ（Issueやプルリクエスト、リポジトリ、ユーザ）と Git リポジトリに保存されているデータ（ソースコード）を照合することができます。 これは次の場合に使用されます。 - -- 新規検索インデックスが作成される -- 欠損データを埋め戻ししなければいけない場合 -- 古い検索データを更新しなければいけない場合 - -すなわち、修理ジョブは、必要に応じて開始され、背景で作動しています。サイトアドミンが修理ジョブの開始時間を決めるわけではありません。 - -さらに、修理ジョブは、並列化のために"修理オフセット"を使っています。 これは照合されているレコードのデータベーステーブルへのオフセットです。 このオフセットによって、複数の背景ジョブの作業を同期化できます。 - -プログレスバーは、全ての背景ワーカープロセスによる、現在の修理ステータスを表示します。 それは、データベースの中の最高レコード ID と修理オフセットでのパーセント差です。 修復ジョブが完了した後にプログレスバーに表示される値については心配しないでください。それは修復オフセットとデータベース内の最大レコード ID の差を示すものであるため、たとえリポジトリが実際にインデックス付けされていても、{% data variables.product.product_location_enterprise %} にリポジトリが追加されるにつれて値は減少します。 - -いつでも新規コード検索インデックスの修理ジョブを開始できます。 1つの CPU を使って、検索インデックスをデータベース及びGitのリポジトリデータと照合します。 I/O パフォーマンスに与える影響を最小限にするため、および、オペレーションがタイムアウトする可能性を減少するために混雑していない時間帯に修理ジョブを実行してみてください。 `top` のようなユーティリティで、システム負荷と CPU 使用率の平均を監視しましょう。大差がない場合は、混雑している時間帯にもインデックスの修理ジョブを実行しても安全なはずです。 - -#### Issue インデックスの修復 - - これは [Issues](https://github.com/blog/831-issues-2-0-the-next-generation) インデックスがどのように修復されるかを制御します。 次のことができます: - -- インデックスの修理ジョブを有効または無効にする -- 新規インデックス修理ジョブを開始する -- インデックス修理状態を全てリセットする - -### リポジトリ - -これは {% data variables.product.product_location_enterprise %} 上のリポジトリのリストです。 リポジトリ名をクリックしてリポジトリを管理するための機能にアクセスできます。 - -- [リポジトリへのフォースプッシュをブロックする](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository/) -- [{% data variables.large_files.product_name_long %} を設定する](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-git-large-file-storage/#configuring-git-large-file-storage-for-an-individual-repository) -- [リポジトリのアーカイブへの保管と削除](/enterprise/{{ currentVersion }}/admin/guides/user-management/archiving-and-unarchiving-repositories/) - -### 全ユーザ - -ここでは、{% data variables.product.product_location_enterprise %} 上のすべてのユーザーを確認することができ、そして [SSH キー監査を開始する](/enterprise/{{ currentVersion }}/admin/guides/user-management/auditing-ssh-keys)ことができます。 - -### サイトアドミン - -ここでは、{% data variables.product.product_location_enterprise %} 上のすべての管理者を確認することができ、そして [SSH キー監査を開始する](/enterprise/{{ currentVersion }}/admin/guides/user-management/auditing-ssh-keys)ことができます。 - -### 休眠ユーザ - -ここでは、{% data variables.product.product_location_enterprise %} 上のすべての非アクティブなユーザーを確認して、[一時停止](/enterprise/{{ currentVersion }}/admin/guides/user-management/suspending-and-unsuspending-users)することができます。 ユーザアカウントは、次の場合において、非アクティブ（休眠）とみなされます。 - -- {% data variables.product.product_location_enterprise %} 用に設定されている休眠しきい値よりも長く存在している。 -- その期間内にどのアクティビティも生成していない。 -- サイト管理人ではない - -{% data reusables.enterprise_site_admin_settings.dormancy-threshold %} 詳細は「[休眠ユーザを管理する](/enterprise/{{ currentVersion }}/admin/guides/user-management/managing-dormant-users/#configuring-the-dormancy-threshold)」を参照してください。 - -### 停止されたユーザ - -ここでは、{% data variables.product.product_location_enterprise %} で一時停止されているすべてのユーザーを確認することができ、そして [SSH キー監査を開始する](/enterprise/{{ currentVersion }}/admin/guides/user-management/auditing-ssh-keys)ことができます。 diff --git a/translations/ja-JP/content/admin/installation/system-overview.md b/translations/ja-JP/content/admin/installation/system-overview.md deleted file mode 100644 index 4e1dd85f866c..000000000000 --- a/translations/ja-JP/content/admin/installation/system-overview.md +++ /dev/null @@ -1,140 +0,0 @@ ---- -title: システムの概要 -intro: '{% data variables.product.prodname_ghe_server %} は仮想化アプライアンス内に含まれる {% data variables.product.prodname_dotcom %} のお客様の Organization のプライベートなコピーで、オンプレミスあるいはクラウド上でホストされ、お客様が設定およびコントロールできます。' -redirect_from: - - /enterprise/admin/installation/system-overview -versions: - enterprise-server: '*' ---- - -### ストレージアーキテクチャ - -{% data variables.product.prodname_ghe_server %} は、2 つのストレージボリュームを必要とします。1 つは*ルートファイルシステム*パス (`/`) にマウントされるもので、もう 1 つは*ユーザファイルシステム*パス (`/data/user`) にマウントされるものです。 このアーキテクチャは、動作するソフトウェアの環境を永続的なアプリケーションデータから分離することによって、アップグレード、ロールバック、リカバリの手続きをシンプルにします。 - -ルートファイルシステムは、配布されているマシンイメージに含まれています。 ルートファイルシステムにはベースのオペレーティングシステムと {% data variables.product.prodname_ghe_server %} アプリケーション環境が含まれています。 ルートファイルシステムは、一過性のものとして扱われなければなりません。 ルートファイルシステム上にあるデータは、すべて将来の {% data variables.product.prodname_ghe_server %} リリースへのアップグレード時に置き換えられます。 - -ルートファイルシステムには以下が含まれます: - - カスタムの認証局 (CA) 証明書 (*/usr/local/share/ca-certificates*) - - カスタムのネットワーク設定 - - カスタムのファイアウォール設定 - - レプリケーションの状態 - -ユーザファイルシステムには、以下のようなユーザ設定とデータが含まれます: - - Git リポジトリ - - データベース - - 検索インデックス - - {% data variables.product.prodname_pages %} サイトで公開されたコンテンツ - - {% data variables.large_files.product_name_long %} からの大きなファイル - - pre-receive フック環境 - -### デプロイメントの選択肢 - -{% data variables.product.prodname_ghe_server %} は単一の仮想アプライアンスとしても、High Availability 構成としてもデプロイできます。 詳細は「[High Availability 用に {% data variables.product.prodname_ghe_server %} を設定する](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-github-enterprise-server-for-high-availability/)」を参照してください。 - -数万人の開発者がいる組織の場合、{% data variables.product.prodname_ghe_server %} クラスタリングも有益かもしれません。 詳しい情報については「[クラスタリングについて](/enterprise/{{ currentVersion }}/admin/guides/clustering/about-clustering)」を参照してください。 - -### データのリテンションとデータセンターの冗長性 - -{% danger %} - -{% data variables.product.prodname_ghe_server %} を本番環境で使う前に、バックアップとシステム災害復旧計画をセットアップしておくことを強くおすすめします。 詳しい情報については、「[アプライアンスでのバックアップの設定](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-backups-on-your-appliance)」を参照してください。 - -{% enddanger %} - -{% data variables.product.prodname_ghe_server %} には、[{% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils) でのオンラインおよびインクリメンタルバックアップのサポートが含まれています。 インクリメンタルスナップショットは、オフサイトや地理的に離れたストレージのために長距離を経てセキュアなネットワークリンク（SSH管理ポート）経由で取ることができます。 スナップショットは、プライマリデータセンターにおける災害時のリカバリにおいて、新たにプロビジョニングされたアプライアンスにネットワーク経由でリストアできます。 - -ネットワークバックアップに加えて、アプライアンスがオフラインになっているかメンテナンスモードになっている間に、ユーザストレージボリュームのAWS（EBS）やVMWareのディスクスナップショットがサポートされています。 サービスレベルの要求が定期的なオフラインメンテナンスを許せるものであれば、定期的なボリュームのスナップショットは、{% data variables.product.prodname_enterprise_backup_utilities %}のネットワークバックアップの低コストで複雑さの低い代替になります。 - -詳しい情報については、「[アプライアンスでのバックアップの設定](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-backups-on-your-appliance)」を参照してください。 - -### セキュリティ - -{% data variables.product.prodname_ghe_server %} は、お客様のインフラストラクチャ上で動作する仮想アプライアンスで、ファイアウォール、IAM、監視、VPNなどの既存のセキュリティ情報管理により統御されます。 {% data variables.product.prodname_ghe_server %} を使うと、クラウドベースのソリューションから生じる、規制の遵守に関する問題の回避に役立ちます。 - -{% data variables.product.prodname_ghe_server %} には、追加のセキュリティ機能も含まれています。 - -- [オペレーティングシステム、ソフトウェア、パッチ](#operating-system-software-and-patches) -- [ネットワークのセキュリティ](#network-security) -- [アプリケーションのセキュリティ](#application-security) -- [外部サービスおよびサポートへのアクセス](#external-services-and-support-access) -- [暗号化通信](#encrypted-communication) -- [ユーザおよびアクセス権限](#users-and-access-permissions) -- [認証](#authentication) -- [監査およびアクセスのログ取得](#audit-and-access-logging) - -#### オペレーティングシステム、ソフトウェア、パッチ - -{% data variables.product.prodname_ghe_server %} は、必要なアプリケーションとサービスのみを備える、カスタマイズされた Linux を実行します。 {% data variables.product.prodname_dotcom %} は、標準的な製品リリースサイクルの一環として、アプライアンスのコアオペレーティングシステムに対するパッチを管理します。 パッチは、{% data variables.product.prodname_dotcom %} アプライアンスの機能、安定性、および重大でないセキュリティ問題に対処するものです。 また、{% data variables.product.prodname_dotcom %} は、必要に応じて標準的なリリースサイクル外でも重大なセキュリティパッチを提供します。 - -#### ネットワークのセキュリティ - -{% data variables.product.prodname_ghe_server %} の内部ファイアウォールは、アプライアンスのサービスへのネットワークアクセスを制限します。 アプライアンスが機能するために必要なサービスだけが、ネットワークを通じて利用できます。 詳しい情報については、「[ネットワークポート](/enterprise/{{ currentVersion }}/admin/guides/installation/network-ports)」を参照してください。 - -#### アプリケーションのセキュリティ - -{% data variables.product.prodname_dotcom %} の、アプリケーションのセキュリティチームは、{% data variables.product.prodname_ghe_server %} も含めた {% data variables.product.prodname_dotcom %} 製品に対し、脆弱性評価、ペネトレーションテスト、およびコードレビューをフルタイムで重点的に取り組んでいます。 また、{% data variables.product.prodname_dotcom %} は、{% data variables.product.prodname_dotcom %} 製品の特定時点におけるセキュリティ評価を行なうため、外部セキュリティ企業と契約しています。 - -#### 外部サービスおよびサポートへのアクセス - -{% data variables.product.prodname_ghe_server %} は、お客様のネットワークから外部サービスにアクセスすることなしに運用できます。 また、メール配信、外部モニタリング、およびログ転送のため、外部サービスとのインテグレーションを有効にすることも可能です。 詳しい情報については、「[通知のためのメール設定](/enterprise/{{ currentVersion }}/admin/user-management/configuring-email-for-notifications)」、「[外部モニタリングのセットアップ](/enterprise/{{ currentVersion }}/admin/installation/setting-up-external-monitoring)」、および「[ログの転送](/enterprise/{{ currentVersion }}/admin/installation/log-forwarding)」を参照してください。 - -トラブルシューティングデータを手動で収集し、{% data variables.contact.github_support %} に送信できます。 詳しい情報については、「[{% data variables.contact.github_support %} へのデータ提供](/enterprise/{{ currentVersion }}/admin/enterprise-support/providing-data-to-github-support)」を参照してください。 - -#### 暗号化通信 - -{% data variables.product.prodname_dotcom %} は、{% data variables.product.prodname_ghe_server %} がお客様の社内ファイアウォールの背後で動作するよう設計しています。 回線を介した通信を保護するため、Transport Layer Security (TLS) を有効化するようお勧めします。 {% data variables.product.prodname_ghe_server %} は、HTTPS トラフィックに対して、2048 ビット以上の商用 TLS 証明書をサポートしています。 詳しい情報については、「[TLSの設定](/enterprise/{{ currentVersion }}/admin/installation/configuring-tls)」を参照してください。 - -デフォルトでは、Git によるリポジトリへのアクセスと管理目的との両方で、アプライアンスは Secure Shell (SSH) アクセスも提供します。 詳しい情報については、「[SSH について](/enterprise/user/articles/about-ssh)」および「[管理シェル (SSH) にアクセスする](/enterprise/{{ currentVersion }}/admin/installation/accessing-the-administrative-shell-ssh)」を参照してください。 - -#### ユーザおよびアクセス権限 - -{% data variables.product.prodname_ghe_server %} は、3 種類のアカウントを提供しています。 - -- `admin` Linux ユーザアカウントは、ファイルシステムやデータベースへの直接的なアクセスを含め、基底のオペレーティングシステムに対して限定的にアクセスできます。 このアカウントには、少数の信頼できる管理者がアクセスできるようにすべきで、SSH を介してアクセスできます。 詳しい情報については、「[管理シェル (SSH) にアクセスする](/enterprise/{{ currentVersion }}/admin/installation/accessing-the-administrative-shell-ssh)」を参照してください。 -- アプライアンスのウェブアプリケーション内のユーザアカウントは、自らのデータ、および他のユーザや Organization が明示的に許可したあらゆるデータにフルアクセスできます。 -- アプライアンスのウェブアプリケーション内サイト管理者は、高レベルのウェブアプリケーションおよびアプライアンスの設定、ユーザおよび Organization のアカウント設定、ならびにリポジトリデータを管理できるユーザアカウントです。 - -{% data variables.product.prodname_ghe_server %} のユーザ権限に関する詳しい情報については「[GitHub 上のアクセス権限](/enterprise/user/articles/access-permissions-on-github)」を参照してください。 - -#### 認証 - -{% data variables.product.prodname_ghe_server %} は、4 つの認証方式を提供しています。 - -- SSH 公開鍵認証は、Git によるリポジトリへのアクセスと、管理シェルアクセスの両方を提供します。 詳しい情報については、「[SSH について](/enterprise/user/articles/about-ssh)」および「[管理シェル (SSH) にアクセスする](/enterprise/{{ currentVersion }}/admin/installation/accessing-the-administrative-shell-ssh)」を参照してください。 -- HTTP クッキーを用いたユーザ名とパスワードによる認証では、ウェブアプリケーションのアクセスおよびセッションの管理、そして任意で 2 要素認証 (2FA) を提供します。 詳しい情報については、「[ビルトイン認証の利用](/enterprise/{{ currentVersion }}/admin/user-management/using-built-in-authentication)」を参照してください。 -- LDAP サービス、SAML アイデンティティプロバイダ (IdP)、またはその他互換性のあるサービスを用いた外部 LDAP、SAML、および CAS 認証は、ウェブアプリケーションへのアクセスを提供します。 詳しい情報については、「[GitHub Enterprise Server インスタンスでユーザを認証する](/enterprise/{{ currentVersion }}/admin/user-management/authenticating-users-for-your-github-enterprise-server-instance)」を参照してください。 -- OAuth および個人アクセストークンは、外部クライアントとサービスの両方に対して、Git リポジトリデータおよび API へのアクセスを提供します。 For more information, see "[Creating a personal access token](/github/authenticating-to-github/creating-a-personal-access-token)." - -#### 監査およびアクセスのログ取得 - -{% data variables.product.prodname_ghe_server %} は、従来型オペレーティングシステムおよびアプリケーションの両方のログを保存します。 また、アプリケーションは詳細な監査およびセキュリティログも記録し、{% data variables.product.prodname_ghe_server %} はこれを永続的に保存します。 `syslog-ng` プロトコルにより、両タイプのログをリアルタイムで複数の宛先に転送できます。 詳しい情報については、「[ログの転送](/enterprise/{{ currentVersion }}/admin/installation/log-forwarding)」を参照してください。 - -アクセスログと監査ログには、以下のような情報が含まれています。 - -##### アクセスログ - -- ブラウザと API アクセスの両方の、ウェブサーバーの完全なログ -- Git、HTTPS、および SSH プロトコルを介した、リポジトリデータへのアクセスの完全なログ -- HTTPS および SSH を介した、管理アクセスのログ - -##### 監査ログ - -- ユーザのログイン、パスワードのリセット、2 要素認証のリクエスト、メール設定の変更、ならびに許可されたアプリケーションおよび API への変更 -- ユーザアカウントやリポジトリのアンロックなどの、サイト管理者のアクション -- リポジトリのプッシュイベント、アクセス許可、移譲、および名前の変更 -- チームの作成および破棄を含む、Organization のメンバーシップ変更 - -### {% data variables.product.prodname_ghe_server %} のオープンソース依存性 - -使用しているアプライアンスのバージョンの {% data variables.product.prodname_ghe_server %} における依存対象の完全なリストは、それぞれのプロジェクトのライセンスと合わせて `http(s)://HOSTNAME/site/credits` で見ることができます。 - -依存関係と関連するメタデータの完全なリストと合わせて、Tarball 群はアプライアンス上にあります。 -- すべてのプラットフォームに共通の依存関係は `/usr/local/share/enterprise/dependencies--base.tar.gz` にあります。 -- プラットフォームに固有の依存関係は `/usr/local/share/enterprise/dependencies--.tar.gz` にあります。 - -依存対象とメタデータの完全なリストとともにTarball群も`https://enterprise.github.com/releases//download.html`にあります。 - -### 参考リンク - -- [{% data variables.product.prodname_ghe_server %} のトライアルをセットアップする](/articles/setting-up-a-trial-of-github-enterprise-server) -- [{% data variables.product.prodname_ghe_server %} インスタンスをセットアップする](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-github-enterprise-server-instance) diff --git a/translations/ja-JP/content/admin/installation/troubleshooting-ssl-errors.md b/translations/ja-JP/content/admin/installation/troubleshooting-ssl-errors.md deleted file mode 100644 index 87dce7dce854..000000000000 --- a/translations/ja-JP/content/admin/installation/troubleshooting-ssl-errors.md +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: SSLのエラーのトラブルシューティング -intro: アプライアンスでSSLの問題が生じたなら、解決のためのアクションを取ってください。 -redirect_from: - - /enterprise/admin/articles/troubleshooting-ssl-errors/ - - /enterprise/admin/categories/dns-ssl-and-subdomain-configuration/ - - /enterprise/admin/installation/troubleshooting-ssl-errors -versions: - enterprise-server: '*' ---- - -### 鍵ファイルからのパスフレーズの除去 - -OpenSSLがインストールされたLinuxマシンを使うなら、パスフレーズを除去できます。 - -1. オリジナルの鍵ファイルの名前を変えてください。 - ```shell - $ mv yourdomain.key yourdomain.key.orig - ``` -2. パスフレーズなしで新しい鍵を生成してください。 - ```shell - $ openssl rsa -in yourdomain.key.orig -out yourdomain.key - ``` - -このコマンドを実行すると、鍵のパスフレーズを入力するようプロンプトが表示されます。 - -OpenSSL に関する詳しい情報については、[OpenSSL のドキュメンテーション](https://www.openssl.org/docs/)を参照してください。 - -### SSL証明書あるいは鍵のPEMフォーマットへの変換 - -OpenSSL をインストールしている場合、`openssl` コマンドを使って鍵を PEM フォーマットに変換できます。 たとえば鍵を DER フォーマットから PEM フォーマットに変換できます。 - -```shell -$ openssl rsa -in yourdomain.der -inform DER -out yourdomain.key -outform PEM -``` - -あるいは SSL Converter ツールを使って証明書を PEM フォーマットに変換することもできます。 詳しい情報については [SSL Converter ツールのドキュメンテーション](https://www.sslshopper.com/ssl-converter.html)を参照してください。 - -### 鍵のアップロード後の反応のない環境 - -SSL 鍵のアップロード後に {% data variables.product.product_location_enterprise %} の反応がない場合、SSL 証明書のコピーを含む詳細事項と合わせて [{% data variables.product.prodname_enterprise %} Support に連絡](https://enterprise.github.com/support)してください。 - -### 証明書の検証エラー - -Web ブラウザやコマンドラインの Git などのクライアントは、SSL 証明書の正当性が検証できなければエラーメッセージを表示します。 これはしばしば自己署名証明書の場合や、クライアントが認識しない中間ルート証明書から発行された "チェーンドルート" 証明書の場合に生じます。 - -証明書認証局 (CA) によって署名された証明書を使っている場合は、{% data variables.product.prodname_ghe_server %} にアップロードする証明書ファイルには CA のルート証明を持つ証明書チェーンが含まれていなければなりません。 そのようなファイルを作成するには、証明書チェーン全体 (「証明書バンドル」とも呼ばれます) を証明書の終わりにつなげ、プリンシパル証明書の先頭にホスト名が来るようにしてください。 ほとんどのシステムでは、以下のようなコマンドでこの処理を行えます: - -```shell -$ cat yourdomain.com.crt bundle-certificates.crt > yourdomain.combined.crt -``` - -証明書バンドル (たとえば `bundle-certificates.crt`) は、証明書認証局もしくは SSL のベンダーからダウンロードできるはずです。 - -### 自己署名もしくは信頼されない証明書認証者（CA）ルート証明書のインストール - -{% data variables.product.prodname_ghe_server %} アプライアンスが、自己署名もしくは信頼されない証明書を使うネットワーク上の他のマシンとやりとりするのであれば、それらのシステムに HTTPS でアクセスできるようにするために、署名をした CA のルート証明書をシステム全体の証明書ストアにインポートしなければなりません。 - -1. CA のルート証明書をローカルの証明書認証局から取得し、それが PEM フォーマットになっていることを確認してください。 -2. そのファイルを {% data variables.product.prodname_ghe_server %} アプライアンスにポート 122 の SSH 経由で "admin" ユーザとしてコピーしてください。 - ```shell - $ scp -P 122 rootCA.crt admin@HOSTNAME:/home/admin - ``` -3. {% data variables.product.prodname_ghe_server %} の管理シェルにポート 122 の SSH 経由で "admin" ユーザとして接続します。 - ```shell - $ ssh -p 122 admin@HOSTNAME - ``` -4. 証明書をシステム全体の証明書ストアにインポートします。 - ```shell - $ ghe-ssl-ca-certificate-install -c rootCA.crt - ``` diff --git a/translations/ja-JP/content/admin/installation/updating-the-virtual-machine-and-physical-resources.md b/translations/ja-JP/content/admin/installation/updating-the-virtual-machine-and-physical-resources.md deleted file mode 100644 index 8a9496218019..000000000000 --- a/translations/ja-JP/content/admin/installation/updating-the-virtual-machine-and-physical-resources.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: 仮想マシンと物理リソースのアップデート -intro: 仮想ソフトウェアと仮想ハードウェアをアップグレードするためには、インスタンスのダウンタイムが必要になるので、事前にアップグレードについて計画をしておいてください。 -redirect_from: - - '/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-the-vm/' - - '/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-physical-resources/' - - /enterprise/admin/installation/updating-the-virtual-machine-and-physical-resources -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/ja-JP/content/admin/installation/upgrade-requirements.md b/translations/ja-JP/content/admin/installation/upgrade-requirements.md deleted file mode 100644 index 76e3fedb6a49..000000000000 --- a/translations/ja-JP/content/admin/installation/upgrade-requirements.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: アップグレードの要求事項 -intro: '{% data variables.product.prodname_ghe_server %} をアップグレードする前に、アップグレードの方針を計画するために以下の推奨事項と要求事項をレビューしてください。' -redirect_from: - - /enterprise/admin/guides/installation/finding-the-current-github-enterprise-release/ - - /enterprise/admin/installation/upgrade-requirements -versions: - enterprise-server: '*' ---- - -{% note %} - -**注釈:** -- {% data variables.product.prodname_enterprise %} 11.10.348 から {% data variables.product.current-340-version %} までからアップグレードするためには、まず {% data variables.product.prodname_enterprise %} 2.1.23 に移行しなければなりません。 詳細は「[{% data variables.product.prodname_enterprise %} 11.10.x から 2.1.23 へ移行する](/enterprise/{{ currentVersion }}/admin/guides/installation/migrating-from-github-enterprise-11-10-x-to-2-1-23)」を参照してください。 -- サポートされているバージョンについては、アップグレードパッケージが [enterprise.github.com](https://enterprise.github.com/releases) から利用できます。 アップグレードを完了するには、必要なアップグレードパッケージが利用できることを確認してください。 パッケージが利用できない場合は{% data variables.contact.contact_ent_support %}に連絡して支援を求めてください。 -- {% data variables.product.prodname_ghe_server %} クラスタリングを利用している場合は、クラスタリングに固有の手順については {% data variables.product.prodname_ghe_server %} クラスタリングガイド中の「[クラスタをアップグレードする](/enterprise/{{ currentVersion }}/admin/guides/clustering/upgrading-a-cluster/)」を参照してください。 -- {% data variables.product.prodname_ghe_server %} のリリースノートには、{% data variables.product.prodname_ghe_server %} のすべてのバージョンの新機能の包括的なリストがあります。 詳しい情報については[リリースページ](https://enterprise.github.com/releases)を参照してください。 - -{% endnote %} - -### 推奨される対応 - -- アップグレードのプロセスに含めるアップグレードは、できるだけ少なくしてください。 たとえば {% data variables.product.prodname_enterprise %} {{ enterpriseVersions.supported[2] }} から {{ enterpriseVersions.supported[1] }} を経て {{ enterpriseVersions.latest }} にアップグレードする代わりに、{% data variables.product.prodname_enterprise %} {{ enterpriseVersions.supported[2] }} から {{ enterpriseVersions.latest }} にアップグレードできます。 -- バージョンが数バージョン古いのであれば、{% data variables.product.product_location_enterprise %}をアップグレードのプロセスの各ステップでできる限り先までアップグレードしてください。 各アップグレードで可能な限りの最新バージョンを使うことで、パフォーマンスの改善やバグフィックスのメリットが得られます。 たとえば{% data variables.product.prodname_enterprise %}2.7から2.8を経て2.10へアップグレードすることができますが、{% data variables.product.prodname_enterprise %}2.7から2.9を経て2.10へのアップグレードすれば、2番目のステップでより新しいバージョンを利用できます。 -- アップグレードの際には、最新のパッチリリースを使ってください。 {% data reusables.enterprise_installation.enterprise-download-upgrade-pkg %} -- アップグレードのステップのテストには、ステージングインスタンスを使ってください。 詳しい情報については "[ステージングインスタンスのセットアップ](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-staging-instance/)"を参照してください。 -- 複数のアップグレードを実行する際には、フィーチャアップグレードの間に少なくとも24時間を挟み、データの移行とバックグラウンドのアップグレードタスクが完全に終わるようにしてください。 - -### 要件 - -- アップグレードは、**最大でも**2リリース前のフィーチャリリースから行わなければなりません。 たとえば {% data variables.product.prodname_enterprise %} {{ enterpriseVersions.latest }} にアップグレードするためには、{% data variables.product.prodname_enterprise %} {{ enterpriseVersions.supported[1] }} あるいは {{ enterpriseVersions.supported[2] }} でなければなりません。 -- {% data reusables.enterprise_installation.hotpatching-explanation %} -- ホットパッチは、影響するサービス（カーネル、MySQL、Elasticsearchなど）がVMの再起動やサービスの再起動を必要とするなら、ダウンタイムが必要になります。 リブートや再起動が必要になったときには通知されます。 リブートや再起動は後で完了させることができます。 -- ホットパッチでアップグレードをする場合、アップグレードの完了までに特定のサービスの複数バージョンがインストールされることから、追加のルートストレージが利用できなければなりません。 十分なルートディスクストレージがなければ、事前チェックで通知されます。 -- ホットパッチでアップグレードする場合、インスタンスの負荷は高すぎてはなりません。もし負荷が高すぎると、ホットパッチのプロセスに影響するかもしれません。 事前チェックはロードアベレージを考慮し、ロードアベレージが高すぎればアップグレードは失敗します。- {% data variables.product.prodname_ghe_server %} 2.17へのアップグレードによって、Audit logがElasticsearchからMySQLへ移行されます。 この移行により、スナップショットの復元に必要な時間とディスク容量も増加します。 移行の前に、次のコマンドでElasticsearch監査ログのインデックスでバイト数を確認してください。 -``` shell -curl -s http://localhost:9201/audit_log/_stats/store | jq ._all.primaries.store.size_in_bytes -``` -MySQLの監査ログで必要なディスク容量の概算には、この数字を使用します。 スクリプトは、インポートの進行中に空きディスク容量も監視します。 この数字を監視しておくと、空きディスク容量が、移行に必要なディスク容量に近い場合に特に便利です。 - -これらの推奨および要求事項をレビューした後で、{% data variables.product.prodname_ghe_server %} をアップグレードできます。 詳細は「[{% data variables.product.prodname_ghe_server %} をアップグレードする](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-github-enterprise-server/)」を参照してください。 diff --git a/translations/ja-JP/content/admin/installation/upgrading-github-enterprise-server.md b/translations/ja-JP/content/admin/installation/upgrading-github-enterprise-server.md deleted file mode 100644 index 13e4bfd3ed6a..000000000000 --- a/translations/ja-JP/content/admin/installation/upgrading-github-enterprise-server.md +++ /dev/null @@ -1,219 +0,0 @@ ---- -title: GitHub Enterprise Server をアップグレードする -intro: '最新の機能とセキュリティアップデートを入手するために、{% data variables.product.prodname_ghe_server %} をアップグレードしてください。' -redirect_from: - - /enterprise/admin/articles/upgrading-to-the-latest-release/ - - /enterprise/admin/articles/migrations-and-upgrades/ - - /enterprise/admin/guides/installation/upgrading-the-github-enterprise-virtual-machine/ - - /enterprise/admin/guides/installation/upgrade-packages-for-older-releases/ - - /enterprise/admin/articles/upgrading-older-installations/ - - /enterprise/admin/hidden/upgrading-older-installations/ - - /enterprise/admin/hidden/upgrading-github-enterprise-using-a-hotpatch-early-access-program/ - - /enterprise/admin/hidden/upgrading-github-enterprise-using-a-hotpatch/ - - /enterprise/admin/guides/installation/upgrading-github-enterprise/ - - /enterprise/admin/installation/upgrading-github-enterprise-server -versions: - enterprise-server: '*' ---- - -### アップグレードの準備 - -1. アップグレードの戦略を決定し、アップグレード先のバージョンを選択してください。 詳しい情報については、「[アップグレードの要求事項](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)」を参照してください。 -3. {% data variables.product.prodname_enterprise_backup_utilities %} で、プライマリインスタンスの新しいバックアップを作成してください。 詳しい情報については、[{% data variables.product.prodname_enterprise_backup_utilities %}README.md ファイル](https://github.com/github/backup-utils#readme)を参照してください。 -4. アップグレードパッケージを使ってアップグレードをする場合は、{% data variables.product.prodname_ghe_server %} のエンドユーザのためにメンテナンス時間枠をスケジューリングしてください。 ホットパッチを利用している場合、メンテナンスモードは必要ありません。 - - {% note %} - - **注釈:** メンテナンスウィンドウは、実行しようとしているアップグレードの種類によります。 ホットパッチを利用するアップグレードは、通常メンテナンスウィンドウを必要としません。 リブートが必要になることもあります。そのリブートは後で行うことができます。 MAJOR.FEATURE.PATCH というバージョン付けのスキームに従い、アップグレードパッケージを使ったパッチのリリースで生じるダウンタイムは、通常 5 分未満です。 データの移行を含むフィーチャリリースは、ストレージの性能および移行するデータの量に応じた時間がかかります。 詳しい情報については、「[メンテナンスモードの有効化とスケジューリング](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)」を参照してください。 - - {% endnote %} - -### スナップショットの取得 - -スナップショットは、ある時点での仮想マシン（VM）のチェックポイントです。 アップグレードに失敗した場合にスナップショットからVMを回復できるよう、仮想マシンをアップグレードする前にスナップショットを取っておくことを強くおすすめします。 新しいフィーチャリリースにアップグレードするなら、VM のスナップショットを取らなければなりません。 パッチリリースへのアップグレードをするなら、既存のデータディスクをアタッチできます。 - -スナップショットには2種類あります。 - -- **VM スナップショット**は、ユーザデータおよび設定データを含む VM の状態全体を保存します。 このスナップショットの手法には大量のディスク領域が必要になり、時間がかかります。 -- **データディスクスナップショット**はユーザデータだけを保存します。 - - {% note %} - - **注釈:** - - プラットフォームによっては、ユーザのデータディスクだけのスナップショットを取ることができません。 それらのプラットフォームでは、VM 全体のスナップショットを取る必要があります。 - - ハイパーバイザーが完全なVMスナップショットをサポートしていないなら、ルートディスクとデータディスクのスナップショットを時間をおかずに取らなければなりません。 - - {% endnote %} - -| プラットフォーム | スナップショットの取得方法 | スナップショットドキュメンテーションのURL | -| --------------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| Amazon AWS | ディスク | [https://docs.aws.amazon.com/ja_jp/AWSEC2/latest/UserGuide/ebs-creating-snapshot.html](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-creating-snapshot.html) | -| Azure | VM | [https://docs.microsoft.com/ja-jp/azure/backup/backup-azure-vms-first-look-arm](https://azure.microsoft.com/en-us/documentation/articles/backup-azure-vms/) | -| Hyper-V | VM | | -| Google Compute Engine | ディスク | | -| VMware | VM | [https://pubs.vmware.com/vsphere-50/topic/com.vmware.wssdk.pg.doc_50/PG_Ch11_VM_Manage.13.3.html](https://pubs.vmware.com/vsphere-50/topic/com.vmware.wssdk.pg.doc_50/PG_Ch11_VM_Manage.13.3.html) | -| XenServer | VM | | - -### ホットパッチでのアップグレード - -{% data reusables.enterprise_installation.hotpatching-explanation %}{% data variables.enterprise.management_console %} を使うと、ホットパッチを即座にインストールすることや、後にインストールするようにスケジュールすることができます。 管理シェルを使って `ghe-upgrade` ユーティリティでホットパッチをインストールすることもできます。 詳細は「[アップグレードの要求事項](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)」を参照してください。 - -{% note %} - -**注釈**: クラスタ環境では、{% data variables.enterprise.management_console %} を使ったホットパッチのインストールはできません。 クラスタ環境でホットパッチをインストールするには、「[クラスタをアップグレードする](/enterprise/{{ currentVersion }}/admin/clustering/upgrading-a-cluster#upgrading-with-a-hotpatch)」を参照してください。 - -{% endnote %} - -#### ホットパッチでの単一のアプライアンスのアップグレード - -##### {% data variables.enterprise.management_console %} を使ってホットパッチをインストールする - -1. 自動アップデートを有効化してください。 詳しい情報については「[自動アップデートの有効化](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-automatic-update-checks/)」を参照してください。 -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.updates-tab %} -4. 新しいホットパッチがダウンロードされたなら、Install package（パッケージのインストール）ドロップダウンメニューを使ってください。 - - すぐにインストールするなら**Now（即時）**を選択してください。 - - 後でインストールするなら、後の日付を選択してください。 ![ホットパッチインストール日のドロップダウン](/assets/images/enterprise/management-console/hotpatch-installation-date-dropdown.png) -5. [**Install**] をクリックします。 ![ホットパッチインストールボタン](/assets/images/enterprise/management-console/hotpatch-installation-install-button.png) - -##### 管理シェルを使ったホットパッチのインストール - -{% data reusables.enterprise_installation.download-note %} - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. {% data reusables.enterprise_installation.enterprise-download-upgrade-pkg %}アップグレードのホットパッケージ（*.hpkg*ファイル）のURLをコピーしてください。 -{% data reusables.enterprise_installation.download-package %} -4. パッケージのファイル名を使って `ghe-upgrade` コマンドを実行してください。 - ```shell - admin@HOSTNAME:~$ ghe-upgrade GITHUB-UPGRADE.hpkg - *** verifying upgrade package signature... - ``` -5. カーネル、MySQL、Elasticsearch やその他のプログラムのアップグレードにリブートが必要なら、ホットパッチアップグレードスクリプトが通知してくれます。 - -#### ホットパッチを使ったレプリカインスタンスを持つアプライアンスのアップグレード - -{% note %} - -**注釈**: ホットパッチをインストールする場合、メンテナンスモードに入ったりレプリケーションを停止したりする必要はありません。 - -{% endnote %} - -High Availability と Geo-replication が設定されたアプライアンスは、プライマリインスタンスに加えてレプリカインスタンスを使います。 これらのアプライアンスをアップグレードするには、プライマリインスタンスとすべてのレプリカインスタンスの両方を、1 つずつアップグレードしなければなりません。 - -##### プライマリインスタンスのアップグレード - -1. 「[管理シェルを使ってホットパッチをインストールする](#installing-a-hotpatch-using-the-administrative-shell)」の指示に従ってプライマリインスタンスをアップグレードしてください。 - -##### レプリカインスタンスのアップグレード - -{% note %} - -**メモ:** Geo-replication の一部として複数のレプリカインスタンスを動作させているなら、この手順は各レプリカインスタンス 1 つずつに繰り返してください。 - -{% endnote %} - -1. 「[管理シェルを使ってホットパッチをインストールする](#installing-a-hotpatch-using-the-administrative-shell)」の指示に従ってレプリカインスタンスをアップグレードしてください。Geo-replication のために複数のレプリカを使っているなら、この手順は各レプリカ 1 つずつに繰り返さなければなりません。 -{% data reusables.enterprise_installation.replica-ssh %} -{% data reusables.enterprise_installation.replica-verify %} - -### アップグレードパッケージでのアップグレード - -フィーチャシリーズ内の最新のパッチリリースへのアップグレードにはホットパッチが利用できますが、新しいフィーチャリリースへのアップグレードにはアップグレードパッケージを使わなければなりません。 たとえば `2.11.10` から `2.12.4` へのアップグレードの場合、これらは異なるフィーチャシリーズなので、アップグレードパッケージを使わなければなりません。 詳細は「[アップグレードの要求事項](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)」を参照してください。 - -#### アップグレードパッケージでの単一のアプライアンスのアップグレード - -{% data reusables.enterprise_installation.download-note %} - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. {% data reusables.enterprise_installation.enterprise-download-upgrade-pkg %} 適切なプラットフォームを選択し、アップグレードパッケージ (*.pkg*ファイル) の URL をコピーしてください。 -{% data reusables.enterprise_installation.download-package %} -4. メンテナンスモードを有効にし、{% data variables.product.prodname_ghe_server %} インスタンス上のすべてのアクティブなプロセスが完了するのを待ってください。 詳しい情報については"[メンテナンスモードの有効化とスケジューリング](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)"を参照してください。 - - {% note %} - - **メモ**: High Availability 構成のプライマリアプライアンスをアップグレードする場合には、「[プライマリインスタンスをアップグレードする](#upgrading-the-primary-instance)」の指示に従っているならアプライアンスはメンテナンスモードになっているはずです。 - - {% endnote %} - -5. パッケージのファイル名を使って `ghe-upgrade` コマンドを実行してください。 - ```shell - admin@HOSTNAME:~$ ghe-upgrade GITHUB-UPGRADE.pkg - *** verifying upgrade package signature... - ``` -6. アップグレードを続けてパッケージ署名検証後に再起動することを承諾します。 新しいルートファイルシステムがセカンダリパーティションに書かれ、インスタンスは自動的にメンテナンスモードで再起動します。 - ```shell - *** applying update... - This package will upgrade your installation to version version-number - Current root partition: /dev/xvda1 [version-number] - Target root partition: /dev/xvda2 - Proceed with installation? [y/N] - ``` -7. 単一アプライアンスのアップグレードであれば、メンテナンスモードを無効化してユーザが {% data variables.product.product_location_enterprise %} を利用できるようにしてください。 - - {% note %} - - **メモ**: High Availability 設定のアプライアンスをアップグレードする場合、すべてのレプリカをアップグレードし、レプリケーションが最新の状態になるまではメンテナンスモードのままでなければなりません。 詳細は「[レプリカインスタンスをアップグレードする](#upgrading-a-replica-instance)」を参照してください。 - - {% endnote %} - -#### アップグレードパッケージを使ったレプリカインスタンスを持つアプライアンスのアップグレード - -High Availability と Geo-replication が設定されたアプライアンスは、プライマリインスタンスに加えてレプリカインスタンスを使います。 これらのアプライアンスをアップグレードするには、プライマリインスタンスとすべてのレプリカインスタンスの両方を、1 つずつアップグレードしなければなりません。 - -##### プライマリインスタンスのアップグレード - -{% warning %} - -**警告:** レプリケーションが停止されると、プライマリに障害があった場合には、レプリカがアップグレードされてレプリケーションが再開されるまでに行われた作業は失われます。 - -{% endwarning %} - -1. プライマリインスタンスでメンテナンスモードを有効化し、すべてのアクティブなプロセスが完了するのを待ちます。 詳しい情報については、「[メンテナンスモードの有効化](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode/)」を参照してください。 -{% data reusables.enterprise_installation.replica-ssh %} -3. レプリカインスタンス、あるいは Geo-replication の一部として複数のレプリカインスタンスを動作させている場合は、すべてのレプリカインスタンスで `ghe-repl-stop` を実行してレプリケーションを停止させます。 -4. 「[アップグレードパッケージで単一アプライアンスをアップグレードする](#upgrading-a-single-appliance-with-an-upgrade-package)」の指示に従い、プライマリインスタンスをアップグレードしてください。 - -##### レプリカインスタンスのアップグレード - -{% note %} - -**メモ:** Geo-replication の一部として複数のレプリカインスタンスを動作させているなら、この手順は各レプリカインスタンス 1 つずつに繰り返してください。 - -{% endnote %} - -1. 「[アップグレードパッケージで単一のアプライアンスをアップグレードする](#upgrading-a-single-appliance-with-an-upgrade-package)」の指示に従ってレプリカインスタンスをアップグレードしてください。Geo-replication 用に複数のレプリカを利用しているなら、この手順を各レプリカ 1 つずつに繰り返さなければなりません。 -{% data reusables.enterprise_installation.replica-ssh %} -{% data reusables.enterprise_installation.replica-verify %} - -{% data reusables.enterprise_installation.start-replication %} - -{% data reusables.enterprise_installation.replication-status %} コマンドが `Replication is not running` を返すなら、レプリケーションはまだ開始中かもしれません。 `ghe-repl-status` をもう一度実行する前に 1 分間ほど待ってください。 - - {% note %} - - **メモ:** resync の処理が進んでいる間は、`ghe-repl-status` はレプリケーションが遅れていることを示す期待どおりのメッセージを返すかもしれません。 - たとえば `CRITICAL: git replication is behind the primary by more than 1007 repositories and/or gists` のようなメッセージです。 - - {% endnote %} - - `ghe-repl-status` が `OK` を返さない場合は、以下の手順に従って手動でレプリケーションを開始してください。 - - 1. レプリカインスタンスで再度 `ghe-repl-setup ` を実行してください。 - {% data reusables.enterprise_installation.start-replication %} - {% data reusables.enterprise_installation.replication-status %} -6. 最後のレプリカのアップグレードが完了し、resync も完了したなら、ユーザが {% data variables.product.product_location_enterprise %} を使えるようにメンテナンスモードを無効化してください。 - -### 失敗したアップグレードからのリストア - -アップグレードが失敗もしくは中断したなら、インスタンスを以前の状態に復帰させなければなりません。 この処理を完了させるプロセスは、アップグレードの種類によります。 - -#### パッチリリースのロールバック - -パッチリリースをロールバックするには、`--allow-patch-rollback` を付けて `ghe-upgrade` コマンドを使います。 {% data reusables.enterprise_installation.command-line-utilities-ghe-upgrade-rollback %} - -詳細は「[コマンドラインユーティリティ](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities/#ghe-upgrade)」を参照してください。 - -#### フィーチャリリースのロールバック - -フィーチャリリースからロールバックするには、ルートおよびデータパーティションが整合した状態になることを保証するため、VM スナップショットからリストアしてください。 詳細は「[スナップショットを取得する](#taking-a-snapshot)」を参照してください。 diff --git a/translations/ja-JP/content/admin/installation/using-github-enterprise-server-with-a-load-balancer.md b/translations/ja-JP/content/admin/installation/using-github-enterprise-server-with-a-load-balancer.md deleted file mode 100644 index 62b0c661ca53..000000000000 --- a/translations/ja-JP/content/admin/installation/using-github-enterprise-server-with-a-load-balancer.md +++ /dev/null @@ -1,54 +0,0 @@ ---- -title: GitHub Enterprise Server でロードバランサを使用する -intro: 'ロードバランサを、単一の {% data variables.product.prodname_ghe_server %} アプライアンス、あるいは High Availability 構成のアプライアンスのペアの前で使ってください。' -redirect_from: - - /enterprise/admin/guides/installation/using-github-enterprise-with-a-load-balancer/ - - /enterprise/admin/installation/using-github-enterprise-server-with-a-load-balancer -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_clustering.load_balancer_intro %} - -{% data reusables.enterprise_clustering.load_balancer_dns %} - -### クライアントの接続情報の処理 - -{% data variables.product.prodname_ghe_server %} へのクライアント接続はロードバランサから来ることになるため、クライアントの IP アドレスは失われることがあります。 - -{% data reusables.enterprise_clustering.proxy_preference %} - -{% data reusables.enterprise_clustering.proxy_xff_firewall_warning %} - -#### {% data variables.product.product_location_enterprise %}でのPROXYプロトコルサポートの有効化 - -アプライアンスとロードバランサの両方でPROXYプロトコルサポートを有効化することを強くおすすめします。 ロードバランサでPROXYプロトコルを有効化する方法については、ベンダーが提供する指示に従ってください。 詳しい情報については[PROXY プロトコルのドキュメンテーション](http://www.haproxy.org/download/1.6/doc/proxy-protocol.txt)を参照してください。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -3. **External load balancers（外部ロードバランサ）**の下で**Enable support for PROXY protocol（PROXYプロトコルサポートの有効化）**を選択してください。 ![PROXY プロトコルを有効化するチェックボックス](/assets/images/enterprise/management-console/enable-proxy.png) -{% data reusables.enterprise_management_console.save-settings %} - -{% data reusables.enterprise_clustering.proxy_protocol_ports %} - -#### {% data variables.product.product_location_enterprise %}でのX-Forwarded-Forサポートの有効化 - -{% data reusables.enterprise_clustering.x-forwarded-for %} - -{% data reusables.enterprise_installation.terminating-tls %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -3. **External load balancers（外部ロードバランサ）**の下で**Allow HTTP X-Forwarded-For header（HTTP X-Forwarded-Forヘッダの許可）**を選択してください。 ![HTTP X-Forwarded-For ヘッダを許可するチェックボックス](/assets/images/enterprise/management-console/allow-xff.png) -{% data reusables.enterprise_management_console.save-settings %} - -{% data reusables.enterprise_clustering.without_proxy_protocol_ports %} - -### 健全性チェックの設定 - -ロードバランサは健全性チェックによって、事前に設定されたチェックが失敗するようになったノードがあれば、反応しなくなったノードへのトラフィックの送信を止めます。 メンテナンスもしくは予想外の障害のためにアプライアンスがオフラインになっているなら、ロードバランサはステータスページを表示できます。 High Availability（HA）設定では、ロードバランサはフェイルオーバーの戦略の一部として利用できます。 ただし、HAペアの自動フェイルオーバーはサポートされていません。 レプリカインスタンスは、手動で昇格させるとリクエストに応えられるようになります。 詳細は「[High Availability 用に {% data variables.product.prodname_ghe_server %} を設定する](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-github-enterprise-server-for-high-availability/)」を参照してください。 - -{% data reusables.enterprise_clustering.health_checks %} -{% data reusables.enterprise_site_admin_settings.maintenance-mode-status %} diff --git a/translations/ja-JP/content/admin/installation/validating-your-domain-settings.md b/translations/ja-JP/content/admin/installation/validating-your-domain-settings.md deleted file mode 100644 index 1b1289581ff8..000000000000 --- a/translations/ja-JP/content/admin/installation/validating-your-domain-settings.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: ドメイン設定の検証 -intro: '{% data variables.product.product_location_enterprise %}を最初に起動する前に、ドメイン設定が適切に行われていることを確認してください。' -redirect_from: - - /enterprise/admin/installation/validating-your-domain-settings -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.hostname-menu-item %} -4. アプライアンスのDNS及びSSLの設定をテストするには、**Test domain settings（ドメイン設定のテスト）**をクリックしてください。 ![[Test domain settings] ボタン](/assets/images/enterprise/management-console/test-domain-settings.png) -{% data reusables.enterprise_management_console.test-domain-settings-failure %} -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/ja-JP/content/admin/installation/viewing-push-logs.md b/translations/ja-JP/content/admin/installation/viewing-push-logs.md deleted file mode 100644 index c10526f3121c..000000000000 --- a/translations/ja-JP/content/admin/installation/viewing-push-logs.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: プッシュログの表示 -intro: 'サイトの管理者は {% data variables.product.product_location_enterprise %} でのリポジトリに対する Git プッシュ操作の一覧を見ることができます。' -redirect_from: - - /enterprise/admin/articles/viewing-push-logs/ - - /enterprise/admin/installation/viewing-push-logs -versions: - enterprise-server: '*' ---- - -プッシュログの項目には次の情報が含まれています。 - -- プッシュを開始した人 -- フォースプッシュであったかどうか -- プッシュされたブランチ -- プッシュするために使ったプロトコル -- プッシュ元の IP アドレス -- プッシュするために使った Git クライアント -- 操作前と操作後の SHA ハッシュ - -### リポジトリのプッシュログを表示する - -1. リポジトリにアクセスします。 -{% data reusables.enterprise_site_admin_settings.access-settings %} -3. ページ右上にある、 {% octicon "shield" aria-label="The shield" %}**Security（セキュリティ）** をクリックしてください。 ![セキュリティのタブ](/assets/images/enterprise/site-admin-settings/repo/repo-security-top-tab.png) -4. 左のサイドバーで、**Push Log（プッシュログ）** をクリックしてください。 ![プッシュログのタブ](/assets/images/enterprise/site-admin-settings/push-log-tab.png) - -### コマンドラインでリポジトリのプッシュログを表示する - -1. SSHを使ってアプライアンスに接続してください。 詳しくは、"[管理シェル（SSH）へのアクセス方法](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-administrative-shell-ssh/)を参照してください。" -2. 適切な Git リポジトリで Audit log ファイルを開いてください。 - ```shell - ghe-repo コードオーナー/リポジトリ -c "less audit_log" - ``` diff --git a/translations/ja-JP/content/admin/migrations/about-migrations.md b/translations/ja-JP/content/admin/migrations/about-migrations.md deleted file mode 100644 index dd7fee4fa1bb..000000000000 --- a/translations/ja-JP/content/admin/migrations/about-migrations.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: 移行について -intro: '移行とは、「ソース」場所 ({% data variables.product.prodname_dotcom_the_website %} Organization か {% data variables.product.prodname_ghe_server %} インスタンスのいずれか) から「ターゲット」となる {% data variables.product.prodname_ghe_server %} インスタンスにデータを移譲するプロセスです。 移行は、プラットフォームを変更したり、インスタンスのハードウェアをアップグレードしたりする場合にデータを転送するのに利用できます。' -redirect_from: - - /enterprise/admin/migrations/about-migrations -versions: - enterprise-server: '*' ---- - -### 移行の種類 - -行える移行は3種類あります。 - -- {% data variables.product.prodname_ghe_server %} インスタンスから別の {% data variables.product.prodname_ghe_server %} インスタンスへの移行。 インスタンス上の任意のユーザあるいはOrganizationが所有する任意の数のリポジトリを移行できます。 移行を行う前に、双方のインスタンスにサイト管理者としてアクセスできなければなりません。 -- {% data variables.product.prodname_dotcom_the_website %} Organization から {% data variables.product.prodname_ghe_server %} インスタンスへの移行。 Organizationが所有する任意の数のリポジトリを移行できます。 移行を実行するためには、{% data variables.product.prodname_dotcom_the_website %} Organization への[管理アクセス](/enterprise/user/articles/permission-levels-for-an-organization/)と、ターゲットインスタンスへのサイト管理者としてのアクセスが必要です。 -- *トライアル実行*は、データを[ステージングインスタンス](/enterprise/admin/guides/installation/setting-up-a-staging-instance/)にインポートする移行です。 これは、{% data variables.product.product_location_enterprise %} に対して移行を行ったときに何が起こる*ことになる*のかを確認するのに役立ちます。 **本番インスタンスへデータをインポートする前に、ステージングインスタンスで試行することを強くおすすめします。** - -### データの移行 - -移行においては、すべての事項についてリポジトリが中心になります。 リポジトリに関係するほとんどのデータは移行できます。 たとえば Organization 内のリポジトリは、リポジトリ*および*その Organization、またそのリポジトリに関連付けられているユーザ、Team、Issue、プルリクエストのすべてを移行します。 - -以下の表の項目はレポジトリと共に移行できます。 このデータの移行リストに記載されていない項目はどれも移行できません。 - -{% data reusables.enterprise_migrations.fork-persistence %} - -| 移行されたリポジトリに関連するデータ | 注釈 | -| ----------------------------- | ------------------------------------------------------------------------------------------------------------- | -| ユーザ | ユーザの**@メンション**は、ターゲットにマッチするよう書き換えられます。 | -| Organization | Organizationの名前と詳細は移行されます。 | -| リポジトリ | Git ツリー、blob、コミット、および行へのリンクは、ターゲットにマッチするよう書き換えられます。 移行者がリダイレクトできるリポジトリの上限は 3 つです。 | -| Wiki | すべてのWikiのデータは移行されます。 | -| Team | チームの**@メンション**はターゲットにマッチするよう書き換えられます。 | -| マイルストーン | タイムスタンプは保持されます。 | -| プロジェクトボード | リポジトリやリポジトリを所有するOrganizationに関連するプロジェクトボードは移行されます。 | -| 問題 | Issueへの参照とタイムスタンプは保持されます。 | -| Issueのコメント | コメントへの相互参照は、ターゲットインスタンスに合わせて書き換えられます。 | -| プルリクエスト | プルリクエストへの相互参照はターゲットにマッチするよう書き換えられます。 タイムスタンプは保持されます。 | -| プルリクエストのレビュー | プルリクエストのレビューと関連データは移行されます。 | -| プルリクエストのレビューのコメント | コメントへの相互参照は、ターゲットインスタンスに合わせて書き換えられます。 タイムスタンプは保持されます。 | -| コミットのコメント | コメントへの相互参照は、ターゲットインスタンスに合わせて書き換えられます。 タイムスタンプは保持されます。 | -| リリース | すべてのリリースデータは移行されます。 | -| プルリクエストあるいはIssueに対して行われたアクション | ユーザの割り当て、タイトルの変更、ラベルの変更など、プルリクエストあるいはIssueに対するすべての変更は、それぞれのアクションのタイムスタンプと共に保持されます。 | -| 添付ファイル | [Issue およびプルリクエストの添付ファイル](/articles/file-attachments-on-issues-and-pull-requests)は移行されます。 移行に関するこの機能は無効化できます。 | -| webhook | アクティブなwebhookのみが移行されます。 | -| リポジトリのデプロイキー | リポジトリのデプロイキーは移行されます。 | -| 保護されたブランチ | 保護されたブランチの設定と関連データは移行されます。 | diff --git a/translations/ja-JP/content/admin/migrations/applying-the-imported-data-on-github-enterprise-server.md b/translations/ja-JP/content/admin/migrations/applying-the-imported-data-on-github-enterprise-server.md deleted file mode 100644 index ca7985d53268..000000000000 --- a/translations/ja-JP/content/admin/migrations/applying-the-imported-data-on-github-enterprise-server.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: インポートされたデータの GitHub Enterprise Server への適用 -intro: 移行データのレビューを完了したら、ターゲットインスタンスへの変更を恒久的に適用できます。 -redirect_from: - - /enterprise/admin/guides/migrations/applying-the-imported-data-on-github-enterprise/ - - /enterprise/admin/migrations/applying-the-imported-data-on-github-enterprise-server -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_installation.ssh-into-target-instance %} - -2. `ghe-migrator import`コマンドを使ってインポートのプロセスを開始してください。 以下が必要です: - * 移行 GUID. - * Your personal access token for authentication. The personal access token that you use is only for authentication as a site administrator, and does not require any specific scope. For more information, see "[Creating a personal access token](/github/authenticating-to-github/creating-a-personal-access-token)." - - ```shell - $ ghe-migrator import /home/admin/MIGRATION_GUID.tar.gz -g MIGRATION_GUID -u username -p TOKEN - - > Starting GitHub::Migrator - > Import 100% complete / - ``` - - * {% data reusables.enterprise_migrations.specify-staging-path %} diff --git a/translations/ja-JP/content/admin/migrations/completing-the-import-on-github-enterprise-server.md b/translations/ja-JP/content/admin/migrations/completing-the-import-on-github-enterprise-server.md deleted file mode 100644 index e067ce0a92fc..000000000000 --- a/translations/ja-JP/content/admin/migrations/completing-the-import-on-github-enterprise-server.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: GitHub Enterprise Server へのインポートの完了 -intro: ターゲットインスタンスへの移行が適用され、その内容をレビューしたなら、リポジトリをアンロックし、ソースからそれらを削除します。 ソースデータを削除する前に、すべてが期待どおりに機能していることを確認するため2週間ほど待つことをおすすめします。 -redirect_from: - - /enterprise/admin/guides/migrations/completing-the-import-on-github-enterprise/ - - /enterprise/admin/migrations/completing-the-import-on-github-enterprise-server -versions: - enterprise-server: '*' ---- - -### ターゲットインスタンス上でのリポジトリのアンロック - -{% data reusables.enterprise_installation.ssh-into-instance %} -{% data reusables.enterprise_migrations.unlocking-on-instances %} - -### ソース上でのリポジトリのアンロック - -#### {% data variables.product.prodname_dotcom_the_website %} Organization からリポジトリをアンロックする - -{% data variables.product.prodname_dotcom_the_website %} Organization のリポジトリをアンロックするには、`DELETE` リクエストを移行アンロックエンドポイントに送信します。 以下が必要です: - * 認証のためのアクセストークン - * 移行のユニーク`id` - * アンロックするリポジトリの名前 -```shell -curl -H "Authorization: token GITHUB_ACCESS_TOKEN" -X DELETE \ - -H "Accept: application/vnd.github.wyandotte-preview+json" \ - https://api.github.com/orgs/orgname/migrations/id/repos/repo_name/lock -``` - -#### {% data variables.product.prodname_dotcom_the_website %} Organization からリポジトリを削除する - -After unlocking the {% data variables.product.prodname_dotcom_the_website %} organization's repositories, you should delete every repository you previously migrated using [the repository delete endpoint](/enterprise/{{ currentVersion }}/v3/repos/#delete-a-repository). 認証のためのアクセストークンが必要になります。 -```shell -curl -H "Authorization: token GITHUB_ACCESS_TOKEN" -X DELETE \ - https://api.github.com/repos/orgname/repo_name -``` - -#### {% data variables.product.prodname_ghe_server %} インスタンスからリポジトリをアンロックする - -{% data reusables.enterprise_installation.ssh-into-instance %} -{% data reusables.enterprise_migrations.unlocking-on-instances %} diff --git a/translations/ja-JP/content/admin/migrations/exporting-migration-data-from-github-enterprise-server.md b/translations/ja-JP/content/admin/migrations/exporting-migration-data-from-github-enterprise-server.md deleted file mode 100644 index e342d297ca15..000000000000 --- a/translations/ja-JP/content/admin/migrations/exporting-migration-data-from-github-enterprise-server.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: GitHub Enterprise Server から移行データをエクスポートする -intro: '{% data variables.product.prodname_ghe_server %} インスタンスから移行データをエクスポートするには、インスタンスを準備し、リポジトリをロックして、移行アーカイブを生成する必要があります。 プラットフォームの変更を計画している場合、またはトライアルインスタンスから本番インスタンスに進む準備ができた場合、{% data variables.product.prodname_ghe_server %} インスタンスからデータをエクスポートする必要があります。' -redirect_from: - - /enterprise/admin/guides/migrations/exporting-migration-data-from-github-enterprise/ - - /enterprise/admin/migrations/exporting-migration-data-from-github-enterprise-server -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/ja-JP/content/admin/migrations/exporting-migration-data-from-githubcom.md b/translations/ja-JP/content/admin/migrations/exporting-migration-data-from-githubcom.md deleted file mode 100644 index 4de6f374bfc5..000000000000 --- a/translations/ja-JP/content/admin/migrations/exporting-migration-data-from-githubcom.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: GitHub.comからの移行データのエクスポート -intro: '{% data variables.product.prodname_dotcom_the_website %} Organization から移行データをエクスポートするには、API を使用して移行するリポジトリを選択する必要があります。 その後で、{% data variables.product.prodname_ghe_server %} インスタンスにインポートできる移行アーカイブを生成します。' -redirect_from: - - /enterprise/admin/guides/migrations/exporting-migration-data-from-github-com - - /enterprise/admin/migrations/exporting-migration-data-from-githubcom -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/ja-JP/content/admin/migrations/exporting-the-github-enterprise-server-source-repositories.md b/translations/ja-JP/content/admin/migrations/exporting-the-github-enterprise-server-source-repositories.md deleted file mode 100644 index a5b98f880913..000000000000 --- a/translations/ja-JP/content/admin/migrations/exporting-the-github-enterprise-server-source-repositories.md +++ /dev/null @@ -1,84 +0,0 @@ ---- -title: GitHub Enterprise Server ソースリポジトリをエクスポートする -intro: ソースリポジトリをロックした後、1 つずつ、またはテキストファイル中のリポジトリ URL のリストを使用して一括でエクスポートできます。 そして、インポートプロセスのための単一の移行アーカイブを作成します。 -redirect_from: - - /enterprise/admin/guides/migrations/exporting-the-github-enterprise-source-repositories/ - - /enterprise/admin/migrations/exporting-the-github-enterprise-server-source-repositories -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_migrations.locking-repositories %} - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. エクスポートするリポジトリを準備するには、`ghe-migrator add` コマンドをリポジトリの URL と一緒に使用します: - * リポジトリをロックする場合は、コマンドの末尾に `--lock` を付けます。 トライアル実行を行う場合は、`--lock` は必要ありません。 - ```shell - $ ghe-migrator add https://hostname/username/reponame --lock - ``` - * コマンドの後ろに `--exclude_attachments` を付けると添付ファイルを除外できます。 {% data reusables.enterprise_migrations.exclude-file-attachments %} - * エクスポートする複数のリポジトリを同時に準備するには、各リポジトリ URL を 1 行ずつ記載したテキストファイルを作成し、`ghe-migrator add` コマンドに `-i` フラグとテキストファイルのパスを付けて実行します。 - ```shell - $ ghe-migrator add -i PATH/TO/YOUR/REPOSITORY_URLS.txt - ``` - -3. 入力を求められたら、{% data variables.product.prodname_ghe_server %} ユーザ名を入力します: - ```shell - Enter username authorized for migration: admin - ``` -4. 個人用アクセストークンを求められたら、「[{% data variables.product.prodname_ghe_server %}ソースインスタンスの準備](/enterprise/admin/guides/migrations/preparing-the-github-enterprise-server-source-instance/)」で作成したアクセストークンを入力します。 - ```shell - Enter personal access token: ************** - ``` -5. `ghe-migrator add`が終了すると、このエクスポートと追加されたリソースのリストを識別するために生成されたユニークな"移行GUID"が出力されます。 生成されたGUIDは、後の`ghe-migrator add`及び`ghe-migrator export`のステップで同じエクスポートに対して処理を続けるよう`ghe-migrator`に伝えるために使います。 - ```shell - > 101 models added to export - > Migration GUID: example-migration-guid - > Number of records in this migration: - > users | 5 - > organizations | 1 - > repositories | 1 - > teams | 3 - > protected_branches | 1 - > pull_request_reviews | 1 - > milestones | 1 - > issues | 3 - > pull_requests | 5 - > pull_request_review_comments | 4 - > commit_comments | 2 - > issue_comments | 10 - > issue_events | 63 - > releases | 3 - > attachments | 4 - > projects | 2 - ``` - 既存の移行GUIDに対して新しいリポジトリを追加するたびに、既存のエクスポートが更新されます。 Migration GUIDなしで`ghe-migrator add`を再実行すると、新しいエクスポートが始まり、新しいMigration GUIDが生成されます。 **インポートから移行の準備を始める場合には、エクスポート中に生成されるMigration GUIDを再利用しないでください**。 - -3. ソースリポジトリをロックした場合、`ghe-migrator target_url`コマンドを使ってリポジトリの新しい場所へリンクするカスタムのロックメッセージをリポジトリのページに設定できます。 ソースリポジトリのURL、ターゲットリポジトリのURL、そしてステップ5の移行GUIDを渡してください。 - - ```shell - $ ghe-migrator target_url https://hostname/username/reponame https://target_hostname/target_username/target_reponame -g MIGRATION_GUID - ``` - -6. 同じエクスポートにさらにリポジトリを追加するには、`ghe-migrator add` コマンドに `-g` フラグを付けて実行します。 これで新しいリポジトリの URL とステップ 5 の移行 GUID を渡します。 - ```shell - $ ghe-migrator add https://hostname/username/other_reponame -g MIGRATION_GUID --lock - ``` -7. リポジトリを追加し終えたなら、`-g`フラグとステップ5の移行GUIDと共に`ghe-migrator export`を使い、移行アーカイブを生成してください。 - ```shell - $ ghe-migrator export -g MIGRATION_GUID - > Archive saved to: /data/github/current/tmp/MIGRATION_GUID.tar.gz - ``` - * {% data reusables.enterprise_migrations.specify-staging-path %} - -8. {% data variables.product.product_location_enterprise %} への接続をクローズします。 - ```shell - $ exit - > logout - > Connection to hostname closed. - ``` -9. [`scp`](https://linuxacademy.com/blog/linux/ssh-and-scp-howto-tips-tricks#scp)コマンドを使って移行アーカイブを使用中のコンピュータにコピーしてください。 アーカイブファイルの名前には移行GUIDが含まれます。 - ```shell - $ scp -P 122 admin@hostname:/data/github/current/tmp/MIGRATION_GUID.tar.gz ~/Desktop - ``` -{% data reusables.enterprise_migrations.ready-to-import-migrations %} diff --git a/translations/ja-JP/content/admin/migrations/exporting-the-githubcom-organizations-repositories.md b/translations/ja-JP/content/admin/migrations/exporting-the-githubcom-organizations-repositories.md deleted file mode 100644 index 1a62df395f16..000000000000 --- a/translations/ja-JP/content/admin/migrations/exporting-the-githubcom-organizations-repositories.md +++ /dev/null @@ -1,70 +0,0 @@ ---- -title: GitHub.comのOrganizationのリポジトリのエクスポート -intro: 移行 API を使うと、Organization のリポジトリをエクスポートできます。 リポジトリをエクスポートすると、インポートプロセスで使用される移行アーカイブをダウンロードします。 -redirect_from: - - /enterprise/admin/guides/migrations/exporting-the-github-com-organization-s-repositories - - /enterprise/admin/migrations/exporting-the-githubcom-organizations-repositories -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_migrations.fork-persistence %} - -{% data variables.product.prodname_dotcom_the_website %} からリポジトリデータをエクスポートするには、移行 API を使います。 - -移行APIは現在プレビュー期間です。すなわち、エンドポイントとパラメータは将来変更されることがあります。 移行APIにアクセスするには、カスタムの[メディアタイプ](/v3/media)として`application/vnd.github.wyandotte-preview+json`を`Accept`ヘッダで渡さなければなりません。 以下の例にはカスタムのメディアタイプが含まれています。 - -### 移行アーカイブの生成 - -{% data reusables.enterprise_migrations.locking-repositories %} - -1. 移行を行うOrganizationのメンバーに通知します。 エクスポートには、対象のリポジトリ数に応じて数分がかかることがあります。 インポートを含む完全な移行には何時間もかかる可能性があるため、完全な処理にかかる時間を判断するためにまず試行することをおすすめします。 詳細は「[移行について](/enterprise/admin/migrations/about-migrations#types-of-migrations)」を参照してください。 - -2. 移行エンドポイントに `POST` することで移行を開始します。 以下が必要です: - * 認証のためのアクセストークン。 - * 移行する[リポジトリのリスト](/v3/repos/#list-organization-repositories)。 - ```shell - curl -H "Authorization: token GITHUB_ACCESS_TOKEN" -X POST \ - -H "Accept: application/vnd.github.wyandotte-preview+json" \ - -d'{"lock_repositories":true,"repositories":["orgname/reponame", "orgname/reponame"]}' \ - https://api.github.com/orgs/orgname/migrations - ``` - * 移行する前にリポジトリをロックするには、`lock_repositories` が `true` になっていることを確認してください。 これについては強くおすすめします。 - * `exclude_attachments: true` をエンドポイントに渡すと、添付ファイルを除外できます。 {% data reusables.enterprise_migrations.exclude-file-attachments %} 最終的なアーカイブのサイズは 20 GB 未満でなければなりません。 - - このリクエストは移行を表す一意の `id` を返します。 これは次の移行 API の呼び出しに必要となります。 - -3. `GET` リクエストを移行ステータスエンドポイントに送って移行のステータスをフェッチします。 以下が必要です: - * 認証のためのアクセストークン。 - * 移行の一意の `id`。 - ```shell - curl -H "Authorization: token GITHUB_ACCESS_TOKEN" \ - -H "Accept: application/vnd.github.wyandotte-preview+json" \ - https://api.github.com/orgs/orgname/migrations/id - ``` - - 移行のステータスは以下のいずれかになります: - * `pending`。移行がまだ始まっていないことを示します。 - * `exporting`。移行が進行中であることを示します。 - * `exported`。移行が正常に終了したことを示します。 - * `failed`。移行に失敗したことを示します。 - -4. 移行がエクスポートされたら、`GET` リクエストを移行ダウンロードエンドポイントに送って移行アーカイブをダウンロードします。 以下が必要です: - * 認証のためのアクセストークン。 - * 移行の一意の `id`。 - ```shell - curl -H "Accept: application/vnd.github.wyandotte-preview+json" \ - -u GITHUB_USERNAME:GITHUB_ACCESS_TOKEN \ - -L -o migration_archive.tar.gz \ - https://api.github.com/orgs/orgname/migrations/id/archive - ``` - -5. 移行アーカイブは 7 日間経過すると自動的に削除されます。 もっと早く削除したい場合は、`DELETE` リクエストを移行アーカイブ削除エンドポイントに送ることもできます。 以下が必要です: - * 認証のためのアクセストークン。 - * 移行の一意の `id`。 - ```shell - curl -H "Authorization: token GITHUB_ACCESS_TOKEN" -X DELETE \ - -H "Accept: application/vnd.github.wyandotte-preview+json" \ - https://api.github.com/orgs/orgname/migrations/id/archive - ``` -{% data reusables.enterprise_migrations.ready-to-import-migrations %} diff --git a/translations/ja-JP/content/admin/migrations/generating-a-list-of-migration-conflicts.md b/translations/ja-JP/content/admin/migrations/generating-a-list-of-migration-conflicts.md deleted file mode 100644 index 046b5b0a9871..000000000000 --- a/translations/ja-JP/content/admin/migrations/generating-a-list-of-migration-conflicts.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: 移行のコンフリクトのリストの生成 -intro: '`ghe-migrator`がインポートのためのデータを準備しているときにコンフリクトを報告してきたなら、それらのコンフリクトのリストを生成してから、カスタムマッピングでそれらを解決する準備をしなければなりません。' -redirect_from: - - /enterprise/admin/migrations/generating-a-list-of-migration-conflicts -versions: - enterprise-server: '*' ---- - -1. `ghe-migrator conflicts` コマンドに移行 GUID を付けて実行し、*conflicts.csv* ファイルを生成します。 - ```shell - $ ghe-migrator conflicts -g MIGRATION_GUID > conflicts.csv - ``` - - コンフリクトが報告されなければ、「[インポートされたデータの {% data variables.product.prodname_ghe_server %} への適用](/enterprise/admin/guides/migrations/applying-the-imported-data-on-github-enterprise-server/)」の手順に従って安全にデータをインポートできます。 -2. コンフリクトがある場合は、[`scp`](https://linuxacademy.com/blog/linux/ssh-and-scp-howto-tips-tricks#scp) コマンドを使って *conflicts.csv* をローカルコンピュータにコピーします。 - ```shell - $ scp -P 122 admin@hostname:conflicts.csv ~/Desktop - ``` -3. 「[移行コンフリクトの解決もしくはカスタムマッピングのセットアップ](/enterprise/admin/guides/migrations/resolving-migration-conflicts-or-setting-up-custom-mappings/)」に進みます。 diff --git a/translations/ja-JP/content/admin/migrations/importing-data-from-third-party-version-control-systems.md b/translations/ja-JP/content/admin/migrations/importing-data-from-third-party-version-control-systems.md deleted file mode 100644 index 131cec6e36e5..000000000000 --- a/translations/ja-JP/content/admin/migrations/importing-data-from-third-party-version-control-systems.md +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: サードパーティのバージョン管理システムからのデータのインポート -intro: 'git-import スイートのツールを使用すると、Subversion、Mercurial、Team Foundation Version Control から {% data variables.product.prodname_ghe_server %} 上の Git リポジトリにインポートできます。' -redirect_from: - - /enterprise/admin/migrations/importing-data-from-third-party-version-control-systems -versions: - enterprise-server: '*' ---- - -### Mercurialからのプロジェクトのインポート - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. ソースプロジェクトのURLと一時リポジトリへのパスを指定して、以下のコマンドを使ってプロジェクトの生のクローンを作成してください。 - ```shell - $ git-import-hg-raw HG-CLONE-URL /PATH/REPO-NAME.git - # 指定したパスの「refs/import/」に、1つ以上のGit refを持つリポジトリを新たに作成する。 - ``` -{% data reusables.enterprise_migrations.review-the-import-csv %} -4. CSV ファイルを使って作者とブランチを書き直します: - ```shell - $ git-import-rewrite --flavor hg --authors /PATH/AUTHORS-MAP-FILE.csv /PATH/REPO-NAME.git - ``` -5. まだ [{% data variables.product.prodname_ghe_server %} 上に新しい空のリポジトリを作成](/enterprise/{{ currentVersion }}/user/articles/creating-a-new-repository)していない場合は作成してください。 -{% data reusables.command_line.switching_directories_procedural %} -7. インポートされたリポジトリを {% data variables.product.prodname_ghe_server %} にプッシュします。 - ```shell - $ git push --mirror PUSH-URL-ON-GITHUB-ENTERPRISE - ``` - -### SubVersionからのプロジェクトのインポート - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. ソースプロジェクトのURLと一時リポジトリへのパスを指定して、以下のコマンドを使ってプロジェクトの生のクローンを作成してください。 - ```shell - $ git-import-svn-raw SVN-CLONE-URL /PATH/REPO-NAME.git - # 指定したパスの「refs/import/」に、1つ以上のGit refを持つリポジトリを新たに作成する。 - ``` -{% data reusables.enterprise_migrations.review-the-import-csv %} -4. CSV ファイルを使って作者とブランチを書き直します: - ```shell - $ git-import-rewrite --flavor svn --authors /PATH/AUTHORS-MAP-FILE.csv /PATH/REPO-NAME.git - ``` -5. まだ [{% data variables.product.prodname_ghe_server %} 上に新しい空のリポジトリを作成](/enterprise/{{ currentVersion }}/user/articles/creating-a-new-repository)していない場合は作成してください。 -{% data reusables.command_line.switching_directories_procedural %} -7. インポートされたリポジトリを {% data variables.product.prodname_ghe_server %} にプッシュします。 - ```shell - $ git push --mirror PUSH-URL-ON-GITHUB-ENTERPRISE - ``` - -### Team Foundation Version Controlからのプロジェクトのインポート - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. ソースプロジェクトのURLと一時リポジトリへのパスを指定して、以下のコマンドを使ってプロジェクトの生のクローンを作成してください。 - ```shell - $ git-import-tfs-raw TEAM-FOUNDATION-CLONE-URL /PATH/REPO-NAME.git - # 指定したパスの「refs/import/」に、1つ以上のGit refを持つリポジトリを新たに作成する。 - ``` -{% data reusables.enterprise_migrations.review-the-import-csv %} -4. CSV ファイルを使って作者とブランチを書き直します: - ```shell - $ git-import-rewrite --flavor tfs --authors /PATH/AUTHORS-MAP-FILE.csv /PATH/REPO-NAME.git - ``` -5. まだ [{% data variables.product.prodname_ghe_server %} 上に新しい空のリポジトリを作成](/enterprise/{{ currentVersion }}/user/articles/creating-a-new-repository)していない場合は作成してください。 -{% data reusables.command_line.switching_directories_procedural %} -7. インポートされたリポジトリを {% data variables.product.prodname_ghe_server %} にプッシュします。 - ```shell - $ git push --mirror PUSH-URL-ON-GITHUB-ENTERPRISE - ``` - -### 参考リンク - -- "[Command-line-utilities](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities/#import-and-export)" diff --git a/translations/ja-JP/content/admin/migrations/importing-migration-data-to-github-enterprise-server.md b/translations/ja-JP/content/admin/migrations/importing-migration-data-to-github-enterprise-server.md deleted file mode 100644 index 7272f5df0393..000000000000 --- a/translations/ja-JP/content/admin/migrations/importing-migration-data-to-github-enterprise-server.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: 移行データを GitHub Enterprise Server にインポートする -intro: '移行アーカイブを作成すると、ターゲットの {% data variables.product.prodname_ghe_server %} インスタンスにデータをインポートできます。 変更を恒久的にターゲットのインスタンスに適用する前に、潜在的なコンフリクトがないか変更をレビューできます。' -redirect_from: - - /enterprise/admin/guides/migrations/importing-migration-data-to-github-enterprise/ - - /enterprise/admin/migrations/importing-migration-data-to-github-enterprise-server -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/ja-JP/content/admin/migrations/index.md b/translations/ja-JP/content/admin/migrations/index.md deleted file mode 100644 index 2e3d854b476f..000000000000 --- a/translations/ja-JP/content/admin/migrations/index.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: ユーザ、Organization、リポジトリデータの移行 -shortTitle: データの移行 -intro: '{% data variables.product.prodname_ghe_server %} または {% data variables.product.prodname_dotcom_the_website %} からユーザ、Organization、およびリポジトリデータをエクスポートして、そのデータを {% data variables.product.product_location_enterprise %} にインポートできます。' -redirect_from: - - /enterprise/admin/articles/moving-a-repository-from-github-com-to-github-enterprise/ - - /enterprise/admin/categories/migrations-and-upgrades/ - - /enterprise/admin/migrations -versions: - enterprise-server: '*' ---- - - -### 目次 - -{% topic_link_in_list /overview %} - {% link_in_list /about-migrations %} -{% topic_link_in_list /exporting-migration-data-from-github-enterprise-server %} - {% link_in_list /preparing-the-github-enterprise-server-source-instance %} - {% link_in_list /exporting-the-github-enterprise-server-source-repositories %} -{% topic_link_in_list /exporting-migration-data-from-githubcom %} - {% link_in_list /preparing-the-githubcom-source-organization %} - {% link_in_list /exporting-the-githubcom-organizations-repositories %} -{% topic_link_in_list /importing-migration-data-to-github-enterprise-server %} - {% link_in_list /preparing-the-migrated-data-for-import-to-github-enterprise-server %} - {% link_in_list /generating-a-list-of-migration-conflicts %} - {% link_in_list /reviewing-migration-conflicts %} - {% link_in_list /resolving-migration-conflicts-or-setting-up-custom-mappings %} - {% link_in_list /applying-the-imported-data-on-github-enterprise-server %} - {% link_in_list /reviewing-migration-data %} - {% link_in_list /completing-the-import-on-github-enterprise-server %} - {% link_in_list /importing-data-from-third-party-version-control-systems %} diff --git a/translations/ja-JP/content/admin/migrations/overview.md b/translations/ja-JP/content/admin/migrations/overview.md deleted file mode 100644 index 602439b15afe..000000000000 --- a/translations/ja-JP/content/admin/migrations/overview.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: 概要 -intro: '{% data variables.product.product_location_enterprise %}へのデータの移行について学んでください。' -mapTopic: true -redirect_from: - - /enterprise/admin/migrations/overview -versions: - enterprise-server: '*' ---- - diff --git a/translations/ja-JP/content/admin/migrations/preparing-the-github-enterprise-server-source-instance.md b/translations/ja-JP/content/admin/migrations/preparing-the-github-enterprise-server-source-instance.md deleted file mode 100644 index 4b756e97a32f..000000000000 --- a/translations/ja-JP/content/admin/migrations/preparing-the-github-enterprise-server-source-instance.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: GitHub Enterprise Server ソースインスタンスを準備する -intro: '{% data variables.product.prodname_ghe_server %} からデータを移行する前に、インスタンスへの適切な認証と管理アクセスを持っているか確認してください。' -redirect_from: - - /enterprise/admin/guides/migrations/preparing-the-github-enterprise-source-instance/ - - /enterprise/admin/migrations/preparing-the-github-enterprise-server-source-instance -versions: - enterprise-server: '*' ---- - -1. {% data variables.product.prodname_ghe_server %} ソースのサイト管理者であることを確認します。 そのための最善の方法は、[インスタンスへのSSH](/enterprise/admin/guides/installation/accessing-the-administrative-shell-ssh/)が可能であることを確認することです。 - -2. {% data variables.product.prodname_ghe_server %} ソースインスタンス上での {% data reusables.enterprise_migrations.token-generation %}。 - -{% data reusables.enterprise_migrations.make-a-list %} diff --git a/translations/ja-JP/content/admin/migrations/preparing-the-githubcom-source-organization.md b/translations/ja-JP/content/admin/migrations/preparing-the-githubcom-source-organization.md deleted file mode 100644 index ea73314c028a..000000000000 --- a/translations/ja-JP/content/admin/migrations/preparing-the-githubcom-source-organization.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: GitHub.comソースOrganizationの準備 -intro: '{% data variables.product.prodname_dotcom_the_website %} Organization からリポジトリを移行する前に、適切な認証と管理アクセスを持っているか確認してください。' -redirect_from: - - /enterprise/admin/guides/migrations/preparing-the-github-com-source-organization - - /enterprise/admin/migrations/preparing-the-githubcom-source-organization -versions: - enterprise-server: '*' ---- - -1. ソースOrganizationのリポジトリに[オーナー権限](/articles/permission-levels-for-an-organization/)を持っていることを確認してください。 - -2. {% data variables.product.prodname_dotcom_the_website %}上の {% data reusables.enterprise_migrations.token-generation %}。 - -{% data reusables.enterprise_migrations.make-a-list %} diff --git a/translations/ja-JP/content/admin/migrations/preparing-the-migrated-data-for-import-to-github-enterprise-server.md b/translations/ja-JP/content/admin/migrations/preparing-the-migrated-data-for-import-to-github-enterprise-server.md deleted file mode 100644 index 3fd7b42d731b..000000000000 --- a/translations/ja-JP/content/admin/migrations/preparing-the-migrated-data-for-import-to-github-enterprise-server.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: GitHub Enterprise Server にインポートする移行データを準備する -intro: 移行データをターゲットインスタンスに適用する前に、移行アーカイブをターゲットインスタンスにコピーし、インポートの準備をしなければなりません。 -redirect_from: - - /enterprise/admin/guides/migrations/preparing-the-migrated-data-for-import-to-github-enterprise/ - - /enterprise/admin/migrations/preparing-the-migrated-data-for-import-to-github-enterprise-server -versions: - enterprise-server: '*' ---- - -1. [`scp`](https://linuxacademy.com/blog/linux/ssh-and-scp-howto-tips-tricks#scp) コマンドを使って、ソースインスタンスまたは Organization から生成された移行アーカイブを {% data variables.product.prodname_ghe_server %} ターゲットにコピーします: - - ```shell - $ scp -P 122 /path/to/archive/MIGRATION_GUID.tar.gz admin@hostname:/home/admin/ - ``` - -{% data reusables.enterprise_installation.ssh-into-target-instance %} - -3. `ghe-migrator prepare` コマンドを使ってターゲットインスタンスにインポートするためのアーカイブを準備し、次のステップで使用する新たな移行 GUID を生成します。 - - ```shell - ghe-migrator prepare /home/admin/MIGRATION_GUID.tar.gz - ``` - - * 新たにインポートを試みるには、再び `ghe-migrator prepare` を実行して、新しい Migration GUID を取得します。 - * {% data reusables.enterprise_migrations.specify-staging-path %} diff --git a/translations/ja-JP/content/admin/migrations/resolving-migration-conflicts-or-setting-up-custom-mappings.md b/translations/ja-JP/content/admin/migrations/resolving-migration-conflicts-or-setting-up-custom-mappings.md deleted file mode 100644 index f5574f66f3ed..000000000000 --- a/translations/ja-JP/content/admin/migrations/resolving-migration-conflicts-or-setting-up-custom-mappings.md +++ /dev/null @@ -1,70 +0,0 @@ ---- -title: 移行コンフリクトの解決もしくはカスタムマッピングのセットアップ -intro: 移行データをインポートする前に、コンフリクトを解決するために修正をしたり、入力レコードの名前を変えたり、入力レコードを既存のレコードにマップしたりできます。 -redirect_from: - - /enterprise/admin/migrations/resolving-migration-conflicts-or-setting-up-custom-mappings -versions: - enterprise-server: '*' ---- - -コンフリクトを解決したり、移行にカスタムマッピングを追加したりするために、以下のステップが利用できます。 - -### コンフリクトの解決 - -`ghe-migrator`が正しくない変更を行うと考えられるときは、*conflicts.csv*内でデータを変更することによって修正をかけられます。 *conflicts.csv*内の任意の行を変更できます。 - -たとえばソースの`octocat`ユーザがターゲットの`octocat`にマップされていることに気づいたとしましょう。 - -| `model_name` | `source_url` | `target_url` | `recommended_action` | -| ------------ | ----------------------------------- | ----------------------------------- | -------------------- | -| `ユーザ` | `https://example-gh.source/octocat` | `https://example-gh.target/octocat` | `map` | - -このユーザをターゲット上の他のユーザにマップさせることができます。 `octocat`が実際にはターゲットの`monalisa`だということを知っているとしましょう。 *conflicts.csv*の `target_url`を`monalisa`を指すように変更できます。 - -| `model_name` | `source_url` | `target_url` | `recommended_action` | -| ------------ | ----------------------------------- | ------------------------------------ | -------------------- | -| `ユーザ` | `https://example-gh.source/octocat` | `https://example-gh.target/monalisa` | `map` | - -もう1つの例として、もしも`octo-org/widgets`リポジトリをターゲットインスタンス上では`octo-org/amazing-widgets`に名前を変えたいとすれば、`target_url`を`octo-org/amazing-widgets`に、`recommend_action`を`rename`に変更してください。 - -| `model_name` | `source_url` | `target_url` | `recommended_action` | -| ------------ | -------------------------------------------- | ---------------------------------------------------- | -------------------- | -| `リポジトリ` | `https://example-gh.source/octo-org/widgets` | `https://example-gh.target/octo-org/amazing-widgets` | `rename` | - -### カスタムマッピングの追加 - -移行における一般的なシナリオは、移行されたユーザがターゲット上ではソース上とは異なるユーザ名を持つことです。 - -ソースのユーザ名のリストとターゲットのユーザー名のリストがあれば、カスタムマッピングのCSVファイルを構築し、各ユーザのユーザ名とコンテンツが移行の終了時点で正しく割り当てられているようにそのファイルを適用できます。 - -[`ghe-migrator audit`](/enterprise/admin/guides/migrations/reviewing-migration-data)を使えば、カスタムマッピングを適用するのに必要なCSV形式で、移行されるユーザのCSVを素早く生成できます。 - -```shell -$ ghe-migrator audit -m user -g MIGRATION_GUID > users.csv -``` - -これで、このCSVを編集してマップあるいは名前を変更したい各ユーザに新しいURLを入力し、4番目の列を`map`あるいは`rename`を適切に更新できます。 - -たとえばユーザ`octocat`の名前をターゲット`https://example-gh.target`上で`monalisa`に変更したいのであれば、以下の内容の行を作成します。 - -| `model_name` | `source_url` | `target_url` | `状態` | -| ------------ | ----------------------------------- | ------------------------------------ | -------- | -| `ユーザ` | `https://example-gh.source/octocat` | `https://example-gh.target/monalisa` | `rename` | - -同じプロセスは、カスタムマッピングをサポートする各レコードのマッピングを作成するために使うことができます。 詳しい情報については[レコードに可能なマッピング上のテーブル](/enterprise/admin/guides/migrations/reviewing-migration-conflicts#possible-mappings-for-each-record-type)を参照してください。 - -### 修正された移行データの適用 - -1. 変更を加えた後、修正された *conflicts.csv* (または適切な形式のその他のマッピング CSV) を [`scp`](https://linuxacademy.com/blog/linux/ssh-and-scp-howto-tips-tricks#scp) コマンドを使ってターゲットインスタンスに適用します。 - - ```shell - $ scp -P 122 ~/Desktop/conflicts.csv admin@hostname:/home/admin/ - ``` - -2. 修正された CSV ファイルへのパスと移行 GUID を渡して、`ghe-migrator map` を使い、移行データを再マップします。 - - ```shell - $ ghe-migrator map -i conflicts.csv -g MIGRATION_GUID - ``` - -3. `ghe-migrator map -i conflicts.csv -g MIGRATION_GUID` がまだコンフリクトがあると報告してきた場合、移行のコンフリクト解決のプロセスをもう一度行ってください。 diff --git a/translations/ja-JP/content/admin/migrations/reviewing-migration-conflicts.md b/translations/ja-JP/content/admin/migrations/reviewing-migration-conflicts.md deleted file mode 100644 index 1724c8fc1b01..000000000000 --- a/translations/ja-JP/content/admin/migrations/reviewing-migration-conflicts.md +++ /dev/null @@ -1,43 +0,0 @@ ---- -title: 移行コンフリクトのレビュー -intro: 移行コンフリクトのリストを生成した後、それらをレビューして解決の際に`ghe-migrator`が行うデフォルトのアクションで良いことを確認します。 -redirect_from: - - /enterprise/admin/migrations/reviewing-migration-conflicts -versions: - enterprise-server: '*' ---- - -1. テキストエディタもしくは[CSV互換のスプレッドシートソフトウェア](https://en.wikipedia.org/wiki/Comma-separated_values#Application_support)を使って*conflicts.csv*をオープンしてください。 -2. 以下の例とリファレンスのガイダンスと共に*conflicts.csv*ファイルをレビューし、インポートの際に適切なアクションが取られることを確認してください。 - -*conflicts.csv*ファイルには、コンフリクトの*移行マップ*と推奨アクションが含まれています。 移行マップは、ソースから移行されるデータと、そのデータがどのようにターゲットに適用されるかのリストです。 - -| `model_name` | `source_url` | `target_url` | `recommended_action` | -| -------------- | ------------------------------------------------------ | ------------------------------------------------------ | -------------------- | -| `ユーザ` | `https://example-gh.source/octocat` | `https://example-gh.target/octocat` | `map` | -| `Organization` | `https://example-gh.source/octo-org` | `https://example-gh.target/octo-org` | `map` | -| `リポジトリ` | `https://example-gh.source/octo-org/widgets` | `https://example-gh.target/octo-org/widgets` | `rename` | -| `Team` | `https://example-gh.source/orgs/octo-org/teams/admins` | `https://example-gh.target/orgs/octo-org/teams/admins` | `マージ` | - -*conflicts.csv*の各行には以下の情報があります。 - -| 名前 | 説明 | -| -------------------- | --------------------------------------- | -| `model_name` | 変更されるデータの種類。 | -| `source_url` | データのソースURL。 | -| `target_url` | 期待されるデータのターゲットURL。 | -| `recommended_action` | データをインポートする際に`ghe-migrator`が行う推奨のアクション。 | - -### 各レコードタイプで可能なマッピング - -データの転送時に`ghe-migrator`が行えるマッピングアクションは複数あります。 - -| `action` | 説明 | 適用可能なモデル | -| --------------- | ---------------------------------------------------------- | -------------------------------- | -| `import` | （デフォルト）ソースからのデータがターゲットにインポートされます。 | すべてのレコードタイプ | -| `map` | ソースからのデータがターゲット上の既存のデータで置き換えられます。 | Users、organizations、repositories | -| `rename` | ソースからのデータは名前が変更されてターゲットにコピーされます。 | Users、organizations、repositories | -| `map_or_rename` | ターゲットが存在する場合、そのターゲットにマップします。 そうでない場合はインポートされたモデルの名前を変更します。 | ユーザ | -| `マージ` | ソースからのデータはターゲット上の既存のデータと組み合わされます。 | Team | - -***conflicts.csv* ファイルを見直し、[`ghe-migrator audit`](/enterprise/admin/guides/migrations/reviewing-migration-data) を使って適切なアクションがとられることを確認するよう強くお勧めします。**問題がないようであれば、「[インポートされたデータを {% data variables.product.prodname_ghe_server %} に適用する](/enterprise/admin/guides/migrations/applying-the-imported-data-on-github-enterprise-server)」に進んでいただけます。 diff --git a/translations/ja-JP/content/admin/migrations/reviewing-migration-data.md b/translations/ja-JP/content/admin/migrations/reviewing-migration-data.md deleted file mode 100644 index 067969f33ef0..000000000000 --- a/translations/ja-JP/content/admin/migrations/reviewing-migration-data.md +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: 移行データのレビュー -intro: 移行のすべてのステップの後で、移行データの状態をレビューできます。 レコードが適切にマップあるいは名称変更されること、インポートのステップの後にレコードに新しいURLが得られること、移行に失敗したレコードがリストアップされることを確認できます。 -redirect_from: - - '/enterprise/{{ currentVersion }}/admin/guides/migrations/reviewing-the-imported-data/' - - /enterprise/admin/migrations/reviewing-migration-data -versions: - enterprise-server: '*' ---- - -デフォルトでは、`ghe-migrator audit` はすべてのレコードを返します。 また、以下の条件でレコードをフィルタリングすることもできます。 - - * レコードのタイプ。 - * レコードの状態。 - -レコードタイプは[移行データ](/enterprise/admin/guides/migrations/about-migrations/#migrated-data)にあるものとマッチします。 - -### レコードタイプのフィルタ - -| レコードタイプ | フィルタ名 | -| ----------------------------- | ----------------------------- | -| ユーザ | `ユーザ` | -| Organization | `Organization` | -| リポジトリ | `リポジトリ` | -| Team | `Team` | -| マイルストーン | `マイルストーン` | -| プロジェクトボード | `project` | -| 問題 | `Issue` | -| Issueのコメント | `issue_comment` | -| プルリクエスト | `pull_request` | -| プルリクエストのレビュー | `pull_request_review` | -| コミットのコメント | `commit_comment` | -| プルリクエストのレビューのコメント | `pull_request_review_comment` | -| リリース | `リリース` | -| プルリクエストあるいはIssueに対して行われたアクション | `issue_event` | -| 保護されたブランチ | `protected_branch` | - -### レコードの状態フィルタ - -| レコードの状態 | 説明 | -| --------------- | ------------------- | -| `export` | レコードはエクスポートされます。 | -| `import` | レコードはインポートされます。 | -| `map` | レコードはマップされます。 | -| `rename` | レコードの名前が変更されます。 | -| `マージ` | レコードはマージされます。 | -| `exported` | レコードはエクスポートに成功しました。 | -| `imported` | レコードはインポートに成功しました。 | -| `mapped` | レコードはマップに成功しました。 | -| `renamed` | レコードの名前の変更に成功しました。 | -| `merged` | レコードはマージに成功しました。 | -| `failed_export` | レコードはエクスポートに失敗しました。 | -| `failed_import` | レコードはインポートに失敗しました。 | -| `failed_map` | レコードはマップに失敗しました。 | -| `failed_rename` | レコードの名前の変更に失敗しました。 | -| `failed_merge` | レコードはマージに失敗しました。 | - -### 監査されたレコードのフィルタリング - -`ghe-migrator audit`では、`-m`フラグを使ってレコードタイプに基づくフィルタリングができます。 同様に、`-s`フラグでインポートの状態に対してフィルタリングができます。 コマンドは以下のようになります。 - -```shell -$ ghe-migrator audit -m RECORD_TYPE -s STATE -g MIGRATION_GUID -``` - -たとえば、インポートに成功したすべてのOrganizationとチームを見るには以下のようにします。 -```shell -$ ghe-migrator audit -m organization,team -s mapped,renamed -g MIGRATION_GUID -> model_name,source_url,target_url,state -> organization,https://gh.source/octo-org/,https://ghe.target/octo-org/,renamed -``` - -**失敗したすべてのインポートを監査することを強くおすすめします。**そのためには以下のようにします。 -```shell -$ ghe-migrator audit -s failed_import,failed_map,failed_rename,failed_merge -g MIGRATION_GUID -> model_name,source_url,target_url,state -> user,https://gh.source/octocat,https://gh.target/octocat,failed -> repository,https://gh.source/octo-org/octo-project,https://ghe.target/octo-org/octo-project,failed -``` - -失敗したインポートに関する懸念があるなら、{% data variables.contact.contact_ent_support %}に連絡してください。 diff --git a/translations/ja-JP/content/admin/user-management/about-global-webhooks.md b/translations/ja-JP/content/admin/user-management/about-global-webhooks.md deleted file mode 100644 index bdd739d9f61e..000000000000 --- a/translations/ja-JP/content/admin/user-management/about-global-webhooks.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: グローバルwebhookについて -intro: グローバル webhook はイベントについてインスタンスレベルで通知してくれます。 -redirect_from: - - /enterprise/admin/user-management/about-global-webhooks -versions: - enterprise-server: '*' ---- - -グローバルwebhookは、インスタンス上のユーザおよびOrganizationの管理に対するルールの自動的なモニタリング、対応、強制に利用できます。 たとえば以下のような場合に動作するようにwebhookを設定できます: -- ユーザアカウントが作成または削除される -- Organizationが作成または削除される -- コラボレータがリポジトリに追加、またはリポジトリから削除される -- リポジトリがフォークされる - -![グローバル webhook のリスト](/assets/images/enterprise/site-admin-settings/list-of-global-webhooks.png) - -webhook の構成に関する詳しい情報については「[グローバル webhook を管理する](/enterprise/{{ currentVersion }}/admin/guides/user-management/managing-global-webhooks)」を参照してください。 - -{% data reusables.enterprise_user_management.manage-global-webhooks-api %} diff --git a/translations/ja-JP/content/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories.md b/translations/ja-JP/content/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories.md deleted file mode 100644 index 57f139a6d953..000000000000 --- a/translations/ja-JP/content/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: 管理者がパブリックリポジトリへの匿名Git読み取りアクセスを有効化できるようにする -intro: 'カスタムのツールのインスタンス上での動作をシンプルにし、認証の必要性をバイパスするために、リポジトリ管理者が{% data variables.product.product_location_enterprise %}上のパブリックリポジトリに匿名Git読み取りアクセスを有効化することを許可できます。' -redirect_from: - - /enterprise/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_user_management.disclaimer-for-git-read-access %} - -プライベートモードが有効化されている場合、リポジトリ管理者に{% data variables.product.product_location_enterprise %}上のパブリックリポジトリへの匿名Git読み取りアクセスの有効化を許可できます。 プライベートモードに関する詳しい情報については[プライベートモードの有効化](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-private-mode/)を参照してください。 - -匿名Git読み取りアクセスを許可すると、インスタンス上のカスタムツールが認証をバイパスできるようになります。 あなたもしくはリポジトリ管理者がこのアクセス設定をリポジトリで有効化すると、認証を受けていない Git の操作 (そして {% data variables.product.prodname_ghe_server %} へのネットワークアクセスができる人はだれでも) は、認証なしでリポジトリに読み取りアクセスできることになります。 - -{% data variables.product.product_location_enterprise %}のすべてのリポジトリまたは特定のリポジトリについて、匿名Gitアクセスの設定をリポジトリ管理者が変更できないようにすることもできます。 詳細は「[ユーザによる匿名Git読み取りアクセスの変更を禁止する](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)」を参照してください。 - -{% data reusables.enterprise_site_admin_settings.list-of-repos-with-anonymous-git-read-access-enabled %} - -{% data reusables.enterprise_user_management.exceptions-for-enabling-anonymous-git-read-access %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -4. [Anonymous Git read access（匿名 Git 読み取りアクセス）] の下で、ドロップダウンメニューを使って [**Enabled（有効化）**] をクリックしてください。 ![[Enabled] と [Disabled] のメニューオプションが表示されている [Anonymous Git read access] ドロップダウンメニュー](/assets/images/enterprise/site-admin-settings/enable-anonymous-git-read-access.png) -3. インスタンスのすべてのリポジトリでリポジトリ管理者が匿名 Git 読み取りアクセス設定を変更するのを避けるために、[**Prevent repository admins from changing anonymous Git read access（リポジトリ管理者による匿名Git読み取りアクセスの変更の回避）**] を選択することもできます。 ![インスタンス上のすべてのリポジトリへの匿名Git読み取りアクセス設定をリポジトリ管理者が変更するのを避けるための選択チェックボックス](/assets/images/enterprise/site-admin-settings/globally-lock-repos-from-changing-anonymous-git-read-access.png) - -### 特定のリポジトリでの匿名Git読み取りアクセスの有効化 - -{% data reusables.enterprise_user_management.exceptions-for-enabling-anonymous-git-read-access %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -6. "Danger Zone（危険区域）"の下で、"Enable Anonymous Git read access（匿名Git読み取りアクセスの有効化）"の隣の**Enable（有効化）**をクリックしてください。 ![リポジトリのサイト管理設定の危険地域内の "匿名 Git 読み取りアクセスの有効化" の下の "有効化" ボタン ](/assets/images/enterprise/site-admin-settings/site-admin-enable-anonymous-git-read-access.png) -7. 変更を確認します。 確定するには、[**Yes, enable anonymous Git read access**] をクリックします。 ![ポップアップウィンドウの [Confirm anonymous Git read access] 設定](/assets/images/enterprise/site-admin-settings/confirm-anonymous-git-read-access-for-specific-repo-as-site-admin.png) -8. このリポジトリの設定をリポジトリ管理者が変更するのを避けるために、[**Prevent repository admins from changing anonymous Git read access（リポジトリ管理者による匿名Git読み取りアクセスの変更の回避）**] を選択することもできます。 ![このリポジトリへの匿名Git読み取りアクセス設定をリポジトリ管理者が変更するのを避けるための選択チェックボックス](/assets/images/enterprise/site-admin-settings/lock_anonymous_git_access_for_specific_repo.png) diff --git a/translations/ja-JP/content/admin/user-management/allowing-built-in-authentication-for-users-outside-your-identity-provider.md b/translations/ja-JP/content/admin/user-management/allowing-built-in-authentication-for-users-outside-your-identity-provider.md deleted file mode 100644 index dbccf9c04c33..000000000000 --- a/translations/ja-JP/content/admin/user-management/allowing-built-in-authentication-for-users-outside-your-identity-provider.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: 使用しているアイデンティティプロバイダ外のユーザのためのビルトイン認証の許可 -intro: LDAP、SAML、CASを使うアイデンティティプロバイダへのアクセスを持たないユーザを認証するために、ビルトイン認証を設定できます。 -redirect_from: - - /enterprise/admin/user-management/allowing-built-in-authentication-for-users-outside-your-identity-provider -versions: - enterprise-server: '*' ---- - -### 使用しているアイデンティティプロバイダ外のユーザのためのビルトイン認証について - -契約業者やマシンのユーザなど、特定のアカウントを使用中のアイデンティティプロバイダ（IdP）に追加できない場合、外部のユーザのためのビルトイン認証を使うことができます。 また、アイデンティティプロバイダが利用できない場合にフォールバックアカウントにアクセスするためにビルトイン認証を使うこともできます。 - -ビルトイン認証が設定され、ユーザがSAMLもしくはCASでの認証に成功したなら、そのユーザはユーザ名とパスワードでの認証をすることはできません。 ユーザがLDAPでの認証に成功したなら、それ以降クレデンシャルは内部的なものとは見なされません。 - -特定のIdPに対するビルトイン認証は、デフォルトで無効化されています。 - -{% warning %} - -**警告：**ビルトイン認証を無効化した場合、インスタンスへアクセスできなくなったユーザを個別にサスペンドしなければなりません。 詳しい情報については[ユーザのサスペンドとサスペンドの解除](/enterprise/{{ currentVersion }}/admin/guides/user-management/suspending-and-unsuspending-users)を参照してください。 - -{% endwarning %} - -### アイデンティティプロバイダ外のユーザのためのビルトイン認証の設定 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.authentication %} -4. アイデンティティプロバイダを選択してください。 ![アイデンティティプロバイダの選択オプション](/assets/images/enterprise/management-console/identity-provider-select.gif) -5. **Allow creation of accounts with built-in authentication（ビルトイン認証でのアカウントの作成の許可）**を選択してください。 ![ビルトイン認証のオプションの選択](/assets/images/enterprise/management-console/built-in-auth-identity-provider-select.png) -6. 警告を読んで、**Ok**をクリックしてください。 - -{% data reusables.enterprise_user_management.two_factor_auth_header %} -{% data reusables.enterprise_user_management.2fa_is_available %} - -### 使用しているアイデンティティプロバイダ外のユーザをインスタンスで認証するために招待する - -ユーザが招待を受け付けると、ユーザはIdPを通じてサインインするのではなく、ユーザ名とパスワードを使ってサインインできます。 - -{% data reusables.enterprise_site_admin_settings.sign-in %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.invite-user-sidebar-tab %} -{% data reusables.enterprise_site_admin_settings.invite-user-reset-link %} - -### 参考リンク - -- [LDAPの利用](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap) -- [SAMLの利用](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-saml) -- [CASの利用](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-cas) diff --git a/translations/ja-JP/content/admin/user-management/archiving-and-unarchiving-repositories.md b/translations/ja-JP/content/admin/user-management/archiving-and-unarchiving-repositories.md deleted file mode 100644 index 721070d8800c..000000000000 --- a/translations/ja-JP/content/admin/user-management/archiving-and-unarchiving-repositories.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: リポジトリのアーカイブへの保管と削除 -intro: サイト管理者は、サイトの管理ダッシュボードでリポジトリのアーカイブへの保管と削除を行うことができます。 -redirect_from: - - /enterprise/admin/articles/archiving-and-unarchiving-repositories/ - - /enterprise/admin/user-management/archiving-and-unarchiving-repositories -versions: - enterprise-server: '*' ---- - -### リポジトリをアーカイブへ保管 -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -5. Danger Zone（危険地域） で、**Archive（アーカイブ）** をクリックする。 ![アーカイブボタン](/assets/images/enterprise/site-admin-settings/repo-archive.png) -6. **Archive repository（リポジトリのアーカイブ）** をクリックする。 ![リポジトリをアーカイブへ保管するボタン](/assets/images/enterprise/site-admin-settings/repo-archive-confirm.png) - -### リポジトリをアーカイブから展開 -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -5. Danger Zone（危険地域） で、**Unarchive（アーカイブから展開）** をクリックする。 ![アーカイブボタン](/assets/images/enterprise/site-admin-settings/repo-unarchive.png) -6. **Unarchive repository（リポジトリの展開）** をクリックする。 ![リポジトリをアーカイブへ保管するボタン](/assets/images/enterprise/site-admin-settings/repo-unarchive-confirm.png) - -### 参考リンク -- "[リポジトリのアーカイブへの保管について](/enterprise/{{ currentVersion }}/user/articles/about-archiving-repositories)" diff --git a/translations/ja-JP/content/admin/user-management/authenticating-users-for-your-github-enterprise-server-instance.md b/translations/ja-JP/content/admin/user-management/authenticating-users-for-your-github-enterprise-server-instance.md deleted file mode 100644 index defb2a3a1602..000000000000 --- a/translations/ja-JP/content/admin/user-management/authenticating-users-for-your-github-enterprise-server-instance.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: GitHub Enterprise Server インスタンスでユーザを認証する -intro: '{% data variables.product.prodname_ghe_server %} のビルトイン認証を使うか、CAS、LDAP、SAML のいずれかを選択して既存のアカウントを統合し、{% data variables.product.product_location_enterprise %} へのユーザアクセスを集中管理できます。' -redirect_from: - - /enterprise/admin/categories/authentication/ - - /enterprise/admin/guides/installation/user-authentication/ - - /enterprise/admin/articles/inviting-users/ - - /enterprise/admin/guides/migrations/authenticating-users-for-your-github-enterprise-instance/ - - /enterprise/admin/user-management/authenticating-users-for-your-github-enterprise-server-instance -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/ja-JP/content/admin/user-management/basic-account-settings.md b/translations/ja-JP/content/admin/user-management/basic-account-settings.md deleted file mode 100644 index 8ae08156e197..000000000000 --- a/translations/ja-JP/content/admin/user-management/basic-account-settings.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: 基本的なアカウントの設定 -intro: 'ユーザが {% data variables.product.product_location_enterprise %} で認証できるようになったなら、アバターやメール通知など、いくつかの基本的なカスタムプロフィール設定をセットアップしたくなるでしょう。' -redirect_from: - - /enterprise/admin/guides/user-management/enabling-avatars-and-identicons/ - - /enterprise/admin/user-management/basic-account-settings -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/ja-JP/content/admin/user-management/changing-authentication-methods.md b/translations/ja-JP/content/admin/user-management/changing-authentication-methods.md deleted file mode 100644 index c5c757b2e072..000000000000 --- a/translations/ja-JP/content/admin/user-management/changing-authentication-methods.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: 認証方式の変更 -intro: '{% data variables.product.prodname_ghe_server %} が既存のアカウントを認証する方法は、いつでも変更できます。' -redirect_from: - - /enterprise/admin/user-management/changing-authentication-methods -versions: - enterprise-server: '*' ---- - -{% data variables.product.product_location_enterprise %}のユーザアカウントは、認証方式を変更しても保存され、ユーザはユーザ名が変更されない限り、同じアカウントにログインし続けることができます。 - -新しい認証方式でユーザ名が変更される場合、新しいアカウントが作成されます。 As an administrator, you can rename users through the site admin settings or by using [the User Administration API](/enterprise/{{currentVersion}}/v3/enterprise-admin/users/#rename-an-existing-user). - -他に考慮しなければならない問題には以下があります。 - -* **パスワード：**インスタンスでビルトイン認証を使うように切り替えた場合、変更の完了後にユーザは[パスワードを設定](/enterprise/user/articles/how-can-i-reset-my-password/)しなければなりません。 - -* **サイト管理者:** 管理者権限は、[SAML を使う場合はアイデンティティプロバイダによって制御され](/enterprise/admin/guides/user-management/using-saml/#saml-attributes)、[LDAP を使う場合はグループのメンバーシップによって制御されます](/enterprise/admin/guides/user-management/using-ldap/#configuring-ldap-with-your-github-enterprise-server-instance)。 - -* **Team メンバーシップ: **LDAP のみが、ディレクトリサーバからの[Team メンバーシップの制御](/enterprise/admin/guides/user-management/using-ldap/#configuring-ldap-with-your-github-enterprise-server-instance)が可能です。 - -* **ユーザの一時停止:** 認証に LDAP を使う場合、{% data variables.product.prodname_ghe_server %} へのアクセスは_制限グループ_経由で制御できます。 LDAPに切り替えた後、制限グループが設定されているなら、既存のユーザでこれらのグループのいずれかに属してないユーザは一時停止されます。 一時停止は、ユーザがログインするか、次のLDAP Syncの間に生じます。 - -* **グループのメンバーシップ：**認証にLDAPを使う場合、ユーザは自動的に制限グループのメンバーシップとActive Directoryのアカウントのステータスに基づいて[サスペンドあるいはサスペンド解除](/enterprise/admin/guides/user-management/suspending-and-unsuspending-users)されます。 - -* **Git認証：**SAML及びCASは、[個人アクセストークン](/articles/creating-an-access-token-for-command-line-use)を使ったHTTPあるいはHTTPS経由でのGIt認証のみをサポートしています。 HTTPあるいはHTTPS経由でのパスワード認証はサポートされていません。 LDAPは、パスワードベースのGit認証をデフォルトでサポートしていますが、[その方法は無効化して](/enterprise/admin/guides/user-management/using-ldap/#disabling-password-authentication-for-git-operations)個人アクセストークンあるいはSSHキーでの認証を強制することをおすすめします。 - -* **API認証：**SAML及びCASは、[個人アクセストークン](/articles/creating-an-access-token-for-command-line-use)を使ったAPI認証のみをサポートしています。 Basic認証はサポートされていません。 - -* **2 要素認証:** {% data reusables.enterprise_user_management.external_auth_disables_2fa %} - -* **使用しているアイデンティティプロバイダ外のユーザのためのビルトイン認証：**使用中のアイデンティティプロバイダに追加することなく、ユーザを{% data variables.product.product_location_enterprise %}で認証するよう招待できます。 詳細は「[使用中のアイデンティティプロバイダ外のユーザのためにビルトイン認証を許可する](/enterprise/{{ currentVersion }}/admin/guides/user-management/allowing-built-in-authentication-for-users-outside-your-identity-provider)」を参照してください。 diff --git a/translations/ja-JP/content/admin/user-management/disabling-unauthenticated-sign-ups.md b/translations/ja-JP/content/admin/user-management/disabling-unauthenticated-sign-ups.md deleted file mode 100644 index 20d3a41450f2..000000000000 --- a/translations/ja-JP/content/admin/user-management/disabling-unauthenticated-sign-ups.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: 認証のないサインアップの無効化 -redirect_from: - - /enterprise/admin/articles/disabling-sign-ups/ - - /enterprise/admin/user-management/disabling-unauthenticated-sign-ups -intro: ビルトイン認証を使っている場合、認証されていない人がアカウントを作成するのをブロックできます。 -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -3. **Enable sign-up（サインアップの有効化）**の選択を外してください。 ![[Enable sign-up] チェックボックス](/assets/images/enterprise/management-console/enable-sign-up.png) -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/ja-JP/content/admin/user-management/organizations-and-teams.md b/translations/ja-JP/content/admin/user-management/organizations-and-teams.md deleted file mode 100644 index d30d1087fc3d..000000000000 --- a/translations/ja-JP/content/admin/user-management/organizations-and-teams.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: Organization および Team -redirect_from: - - /enterprise/admin/articles/adding-users-and-teams/ - - /enterprise/admin/categories/admin-bootcamp/ - - /enterprise/admin/user-management/organizations-and-teams -intro: Organizationは企業内で、部署や同様のプロジェクトで作業を行うグループなど、個別のユーザグループを作成する素晴らしい手段です。 Organizationに属するパブリックリポジトリは他のOrganizationのユーザからもアクセスできますが、プライベートリポジトリはOrganizationのメンバーでなければアクセスできません。 -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/ja-JP/content/admin/user-management/preventing-users-from-changing-a-repositorys-visibility.md b/translations/ja-JP/content/admin/user-management/preventing-users-from-changing-a-repositorys-visibility.md deleted file mode 100644 index 1972bfa23dcf..000000000000 --- a/translations/ja-JP/content/admin/user-management/preventing-users-from-changing-a-repositorys-visibility.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: ユーザによるリポジトリの可視性の変更の禁止 -intro: '{% data variables.product.prodname_ghe_server %} アプライアンス上で Organization が所有しているリポジトリの可視性を、メンバーが変更できないようすることができます。' -redirect_from: - - /enterprise/admin/guides/user-management/preventing-users-from-changing-a-repository-s-visibility - - /enterprise/admin/user-management/preventing-users-from-changing-a-repositorys-visibility -versions: - enterprise-server: '*' ---- - -メンバーがリポジトリの可視性を変更できないようにすると、パブリックなリポジトリをプライベートにしたり、プライベートなリポジトリをパブリックにしたりできるのはサイト管理者だけになります。 - -サイト管理者がリポジトリの作成を Organization のオーナーのみに制限している場合、メンバーはリポジトリの可視性を変更できません。 サイト管理者がメンバーのリポジトリ作成をプライベート リポジトリのみに制限している場合、メンバーはリポジトリをパブリックからプライベートに変更すること以外はできません。 詳しい情報については、「[インスタンスでリポジトリ作成を制限する](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)」を参照してください。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.policies-tab %} -{% data reusables.enterprise-accounts.repositories-tab %} -5. [Repository visibility change] で、設定変更についての情報を確認します。 {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} - -{% data reusables.enterprise-accounts.repository-visibility-policy %} diff --git a/translations/ja-JP/content/admin/user-management/preventing-users-from-changing-anonymous-git-read-access.md b/translations/ja-JP/content/admin/user-management/preventing-users-from-changing-anonymous-git-read-access.md deleted file mode 100644 index d46ebb693a2a..000000000000 --- a/translations/ja-JP/content/admin/user-management/preventing-users-from-changing-anonymous-git-read-access.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: ユーザによる匿名 Git 読み取りアクセスの変更を禁止する -intro: 'リポジトリ管理者があるリポジトリ{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %}あるいはすべてのリポジトリ{% endif %}への匿名 Git 読み取りアクセスを変更することを禁止できます。' -redirect_from: - - /enterprise/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access-to-a-repository/ - - /enterprise/admin/user-management/preventing-users-from-changing-anonymous-git-read-access -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_user_management.disclaimer-for-git-read-access %} - -リポジトリ管理者が特定のリポジトリへの匿名Git読み取りアクセスを変更できないようにするために、リポジトリのアクセス設定をロックできます。 リポジトリのGit読み取りアクセス設定をロックすると、サイト管理者だけがこの設定を変更できるようになります。 - -リポジトリ管理者は、パブリックリポジトリがフォークでなければ、匿名Git読み取りアクセスを変更できます。 詳しい情報については[管理者にパブリックリポジトリの匿名Git読み取りアクセスの有効化を許可する](/enterprise/{{ currentVersion }}/admin/guides/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories)を参照してください。 - -{% data reusables.enterprise_site_admin_settings.list-of-repos-with-anonymous-git-read-access-enabled %} - -### ユーザによるリポジトリへの匿名 Git 読み取りアクセスの変更の禁止 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -6. "Danger Zone（危険区域）"の下で**Prevent repository admins from enabling anonymous Git read access（リポジトリ管理者による匿名Git読み取りアクセスの有効化の禁止）**を選択してください。 ![リポジトリをロックして匿名Git読み取りアクセス設定を変更できなくするチェックボックスを選択してください。](/assets/images/enterprise/site-admin-settings/lock-repo-from-changing-anonymous-git-read-access.png) - -### ユーザによるすべてのリポジトリへの匿名 Git 読み取りアクセスの変更を禁止する - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -3. [Anonymous Git read access（匿名 Git 読み取りアクセス）] の下で、この設定が有効化されていることを確認し、[**Prevent repository admins from changing anonymous Git read access（リポジトリ管理者による匿名 Git 読み取りアクセスの変更の禁止）**] を選択してください。 ![リポジトリをグローバルにロックして匿名 Git 読み取りアクセス設定を変更できなくするチェックボックスを選択してください。](/assets/images/enterprise/site-admin-settings/globally-lock-repos-from-changing-anonymous-git-read-access.png) - diff --git a/translations/ja-JP/content/admin/user-management/preventing-users-from-deleting-organization-repositories.md b/translations/ja-JP/content/admin/user-management/preventing-users-from-deleting-organization-repositories.md deleted file mode 100644 index 1f758c27d9d2..000000000000 --- a/translations/ja-JP/content/admin/user-management/preventing-users-from-deleting-organization-repositories.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: ユーザによるOrganizationのリポジトリ削除の禁止 -intro: 'メンバーが {% data variables.product.prodname_ghe_server %} アプライアンス上で Organization 内のリポジトリを削除したり移譲したりするのを禁止できます。' -redirect_from: - - /enterprise/admin/user-management/preventing-users-from-deleting-organization-repositories -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.policies-tab %} -{% data reusables.enterprise-accounts.repositories-tab %} -5. 「Repository deletion and transfer」で、設定変更に関する情報を確認します。 {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} - -{% data reusables.enterprise-accounts.repository-deletion-policy %} diff --git a/translations/ja-JP/content/admin/user-management/repositories.md b/translations/ja-JP/content/admin/user-management/repositories.md deleted file mode 100644 index df2dfc542e66..000000000000 --- a/translations/ja-JP/content/admin/user-management/repositories.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: リポジトリ -intro: '{% data variables.product.prodname_ghe_server %} アプライアンス上でリポジトリ管理者が利用できる設定を管理できます。' -mapTopic: true -redirect_from: - - /enterprise/admin/user-management/repositories -versions: - enterprise-server: '*' ---- - diff --git a/translations/ja-JP/content/admin/user-management/restricting-repository-creation-in-your-instance.md b/translations/ja-JP/content/admin/user-management/restricting-repository-creation-in-your-instance.md deleted file mode 100644 index 449225c4858e..000000000000 --- a/translations/ja-JP/content/admin/user-management/restricting-repository-creation-in-your-instance.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: インスタンス内でのリポジトリの作成を制限する -intro: '{% data variables.product.prodname_ghe_server %}のOrganizationのメンバーがリポジトリを作成できるようにするか、そしてメンバーが作成できるリポジトリの種類を選択できます。' -redirect_from: - - /enterprise/admin/user-management/restricting-repository-creation-in-your-instance -versions: - enterprise-server: '*' ---- - -{% data reusables.organizations.repo-creation-constants %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.policies-tab %} -{% data reusables.enterprise-accounts.repositories-tab %} -5. [Repository creation] で、設定変更に関する情報を読みます。 {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} -{% if currentVersion ver_gt "enterprise-server@2.19" %} -{% data reusables.enterprise-accounts.repo-creation-policy %} -{% data reusables.enterprise-accounts.repo-creation-types %} -{% else %} -6. [Repository creation（リポジトリの作成）] で、ドロップダウンメニューを使用してポリシーを選択します。 ![リポジトリ作成ポリシーのドロップダウンメニュー](/assets/images/enterprise/site-admin-settings/repository-creation-drop-down.png) -{% endif %} diff --git a/translations/ja-JP/content/admin/user-management/user-security.md b/translations/ja-JP/content/admin/user-management/user-security.md deleted file mode 100644 index cf77069c84ce..000000000000 --- a/translations/ja-JP/content/admin/user-management/user-security.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: ユーザのセキュリティ -intro: '{% data variables.product.prodname_ghe_server %} ユーザの安全を保証してください。 インスタンス全体にわたって、ユーザのセキュリティ設定を監査したり、ベストプラクティスを強制したりすることができます。' -mapTopic: true -redirect_from: - - /enterprise/admin/user-management/user-security -versions: - enterprise-server: '*' ---- - diff --git a/translations/ja-JP/content/admin/user-management/using-built-in-authentication.md b/translations/ja-JP/content/admin/user-management/using-built-in-authentication.md deleted file mode 100644 index 2ac8a2429d25..000000000000 --- a/translations/ja-JP/content/admin/user-management/using-built-in-authentication.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: ビルトイン認証の利用 -intro: 'デフォルトの認証方式を使用する場合、すべての認証の詳細は {% data variables.product.product_location_enterprise %} に保存されます。 LDAP、SAML、CASのような確立された認証プロバイダをすでに持っているのでなければ、ビルトイン認証がデフォルトの方式になります。' -redirect_from: - - /enterprise/admin/user-management/using-built-in-authentication -versions: - enterprise-server: '*' ---- - -サインインおよびサインアウトページでユーザに表示されるカスタムメッセージを作成できます。 詳しい情報については「[インスタンス上でのユーザメッセージをカスタマイズする](/enterprise/admin/user-management/customizing-user-messages-on-your-instance)」を参照してください。 - -### ビルトイン認証の設定 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.authentication %} -4. **Built in authentication（ビルトイン認証）**を選択してください。 ![ビルトイン認証のオプションの選択](/assets/images/enterprise/management-console/built-in-auth-select.png) - -{% data reusables.enterprise_user_management.two_factor_auth_header %} -{% data reusables.enterprise_user_management.2fa_is_available %} - -### アカウントの作成とユーザの追加 - -インスタンスが作成できたら、自分自身の管理者アカウントを作成し、それを使ってユーザをプロビジョニングします。 - -1. `http(s)://[hostname]/join`の"Create Admin Account（管理者アカウントの作成）"ページで、ユーザ名、パスワード、メールアドレスを選択し、**Create an account（アカウントの作成）**をクリックしてください。 ![[Create Admin Account]](/assets/images/enterprise/site-admin-settings/create-first-admin-acct.png) -{% data reusables.enterprise_site_admin_settings.sign-in %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.invite-user-sidebar-tab %} -{% data reusables.enterprise_site_admin_settings.invite-user-reset-link %} diff --git a/translations/ja-JP/content/admin/user-management/using-cas.md b/translations/ja-JP/content/admin/user-management/using-cas.md deleted file mode 100644 index 0cabbf55b635..000000000000 --- a/translations/ja-JP/content/admin/user-management/using-cas.md +++ /dev/null @@ -1,43 +0,0 @@ ---- -title: CASの利用 -redirect_from: - - /enterprise/admin/articles/configuring-cas-authentication/ - - /enterprise/admin/articles/about-cas-authentication/ - - /enterprise/admin/user-management/using-cas -intro: 'CAS は、複数の Web アプリケーションのためのシングルサインオン (SSO) プロトコルです。 CASのユーザアカウントは、ユーザがサインインするまで{% if currentVersion ver_gt "enterprise-server@2.16" %}ユーザライセンス{% else %}シート{% endif %}を消費しません。' -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_user_management.built-in-authentication %} - -### CASでのユーザ名についての考慮 - -{% data reusables.enterprise_management_console.username_normalization %} - -{% data reusables.enterprise_management_console.username_normalization_sample %} - -{% data reusables.enterprise_user_management.two_factor_auth_header %} -{% data reusables.enterprise_user_management.external_auth_disables_2fa %} - -### CASの属性 - -以下の属性が利用できます。 - -| 属性名 | 種類 | 説明 | -| ------ | -- | ------------------------------------------------------------- | -| `ユーザ名` | 必須 | {% data variables.product.prodname_ghe_server %} のユーザ名 | - -### CASの設定 -{% warning %} - -**警告：**{% data variables.product.product_location_enterprise %}でCASを設定するまでは、ユーザはCASのユーザ名とパスワードをAPIリクエストの認証やHTTP/HTTPS経由のGit操作に使えないことに注意してください。 その代わりに、ユーザは[アクセストークンを作成](/enterprise/{{ currentVersion }}/user/articles/creating-an-access-token-for-command-line-use)しなければなりません。 - -{% endwarning %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.authentication %} -3. **CAS**を選択してください。 ![CAS の選択](/assets/images/enterprise/management-console/cas-select.png) -4. {% data reusables.enterprise_user_management.built-in-authentication-option %} ![CAS ビルトイン認証の選択チェックボックス](/assets/images/enterprise/management-console/cas-built-in-authentication.png) -5. **Server URL（サーバのURL）**フィールドにCASサーバの完全なURLを入力してください。 CAS サーバが {% data variables.product.prodname_ghe_server %} が検証できない証明書を使っているなら、`ghe-ssl-ca-certificate-install` を使えばその証明書を信頼済みの証明書としてインストールできます。 diff --git a/translations/ja-JP/content/admin/user-management/using-ldap.md b/translations/ja-JP/content/admin/user-management/using-ldap.md deleted file mode 100644 index a084500cb018..000000000000 --- a/translations/ja-JP/content/admin/user-management/using-ldap.md +++ /dev/null @@ -1,190 +0,0 @@ ---- -title: LDAPの利用 -redirect_from: - - /enterprise/admin/articles/configuring-ldap-authentication/ - - /enterprise/admin/articles/about-ldap-authentication/ - - /enterprise/admin/articles/viewing-ldap-users/ - - /enterprise/admin/hidden/enabling-ldap-sync/ - - /enterprise/admin/hidden/ldap-sync/ - - /enterprise/admin/user-management/using-ldap -intro: 'LDAP を使えば、既存のアカウントに対して {% data variables.product.prodname_ghe_server %} を認証させることができ、リポジトリへのアクセスを集中管理できます。 LDAPはディレクトリ情報サービスへのアクセスと管理のための広く使われているアプリケーションプロトコルで、大企業のユーザディレクトリとサードパーティのソフトウェアを統合するために使われている最も一般的なプロトコルの1つです。' -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_user_management.built-in-authentication %} - -### サポートされているLDAPサービス - -{% data variables.product.prodname_ghe_server %} は、以下の LDAP サービスと統合できます: - -* Active Directory -* FreeIPA -* Oracle Directory Server Enterprise Edition -* OpenLDAP -* Open Directory -* 389-ds - -### LDAPでのユーザ名についての考慮 - -{% data reusables.enterprise_management_console.username_normalization %} - -{% data reusables.enterprise_management_console.username_normalization_sample %} - -{% data reusables.enterprise_user_management.two_factor_auth_header %} -{% data reusables.enterprise_user_management.2fa_is_available %} - -### {% data variables.product.product_location_enterprise %}とのLDAPの設定 - -LDAPを設定した後、ユーザは自分のLDAPクレデンシャルでインスタンスにサインインできるようになります。 ユーザが初めてサインインするときに、ディレクトリ内のLDAP属性を使ってプロフィール名、メールアドレス、SSHキーが設定されます。 - -{% data variables.enterprise.management_console %}経由でユーザのLDAPアクセスを設定した場合、インスタンスにユーザが初めてサインインするまで、ユーザライセンスは使われません。 ただし、サイト管理設定を使ってマニュアルでアカウントを作成した場合、ユーザライセンスはすぐに使われます。 - -{% warning %} - -**警告：**{% data variables.product.product_location_enterprise %}でLDAPを設定する前に、利用するLDAPサービスがページ化された結果をサポートしていることを確認してください。 - -{% endwarning %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.authentication %} -3. "Authentication（認証）"の下で**LDAP**を選択してください。 ![LDAP の選択](/assets/images/enterprise/management-console/ldap-select.png) -4. {% data reusables.enterprise_user_management.built-in-authentication-option %} ![LDAP のビルトイン認証の選択チェックボックス](/assets/images/enterprise/management-console/ldap-built-in-authentication.png) -5. 設定を追加してください。 - -### LDAPの属性 -{% data variables.product.product_location_enterprise %}のlDAPの設定を完了させるために、以下の属性を使ってください。 - -| 属性名 | 種類 | 説明 | -| ------------------------------------------------ | -- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `Host` | 必須 | LDAP のホスト。例: `ldap.example.com` あるいは `10.0.0.30`。 ホスト名が内部ネットワークからしか利用できないなら、まず{% data variables.product.product_location_enterprise %}のDNSを設定してホスト名を内部のネームサーバを使って解決できるようにする必要があるかもしれません。 | -| `ポート` | 必須 | ホストの LDAP サービスが待ち受けるポート。 例：389及び636（LDAPS用）。 | -| `Encryption` | 必須 | LDAP サーバーとの通信をセキュアにするために使われる暗号化の方法。 例：plain（暗号化なし）、SSL/LDAPS（最初からの暗号化）、StartTLS（接続後に暗号化通信にアップグレード）。 | -| `Domain search user` | 任意 | ユーザのサインインの際に認証のためにユーザのルックアップを行う LDAP ユーザ。 これは通常、サードパーティとのインテグレーションのために特に作成されるサービスアカウントです。 `cn=Administrator,cn=Users,dc=Example,dc=com`のような完全修飾名を使ってください。 Active Directoryでは、ドメイン検索ユーザとして `[DOMAIN]\[USERNAME]`という構文（例：`WINDOWS\Administrator`）を使うこともできます。 | -| `Domain search password` | 任意 | ドメイン検索ユーザのためのパスワード。 | -| `Administrators group` | 任意 | このグループ内のユーザは、アプライアンスへサインインしたときにサイト管理者に昇格します。 LDAPの管理者グループを設定しなければ、アプライアンスに最初にサインインしたLDAPユーザが自動的にサイト管理者に昇格します。 | -| `Domain base` | 必須 | ユーザおよびグループの検索を行う LDAP サブツリーの完全修飾 `Distinguished Name` (DN)。 いくつでも追加できるが、それぞれのグループはユーザが属するのと同じドメインベースで定義されなければなりません。 制限されたユーザグループを指定したなら、それらのグループに属するユーザだけがスコープに入ります。 ドメインベースにはLDAPディレクトリツリーの最上位を指定し、制限されたユーザグループでアクセス制御することをおすすめします。 | -| `Restricted user groups` | 任意 | 指定された場合、このグループ内のユーザだけがログインできます。 指定が必要なのはグループのcommon name（CN）だけで、グループはいくつでも追加できます。 グループが指定されていなければ、指定されたドメインベースのスコープ内の*すべての*ユーザが {% data variables.product.prodname_ghe_server %} インスタンスにサインインできるようになります。 | -| `User ID` | 必須 | 認証を受けようとした LDAP ユーザを特定する LDAP 属性。 マッピングが確立されたら、ユーザは自分の {% data variables.product.prodname_ghe_server %} ユーザ名を変更できます。 このフィールドはほとんどのActive Directoryの環境では`sAMAccountName`にすべきですが、OpenLDAPなどの他のLDAPソリューションでは`uid`になることがあります。 デフォルト値は`uid`です。 | -| `Profile name` | 任意 | ユーザの {% data variables.product.prodname_ghe_server %} プロフィールページに表示される名前。 LDAP Syncが有効化されていなければ、ユーザは自分のプロフィール名を変更できます。 | -| `Emails` | 任意 | ユーザの {% data variables.product.prodname_ghe_server %} アカウントのメールアドレス。 | -| `SSH keys` | 任意 | ユーザの {% data variables.product.prodname_ghe_server %} アカウントにアタッチされた公開 SSH キー。 キーはOpenSSH形式でなければなりません。 | -| `GPG keys` | 任意 | ユーザの {% data variables.product.prodname_ghe_server %} アカウントにアタッチされたGPGキー。 | -| `Disable LDAP authentication for Git operations` | 任意 | 選択した場合、ユーザが LDAP パスワードで Git の操作の認証を受けるのが[オフ](#disabling-password-authentication-for-git-operations)になります。 | -| `Enable LDAP certificate verification` | 任意 | 選択した場合、LDAP 証明書の検証が[オン](#enabling-ldap-certificate-verification)になります。 | -| `Synchronization` | 任意 | 選択した場合、LDAP Sync が[オン](#enabling-ldap-sync)になります。 | - -#### Gitの操作のパスワード認証の無効化 - -LDAP 設定中の [**Disable username and password authentication for Git operations（Git の操作でのユーザ名およびパスワード認証の無効化）**] を選択し、Git アクセスでの個人アクセストークンあるいは SSH キーの使用を強制してください。そうすれば、サーバーが LDAP 認証のリクエストで過負荷になるのを防ぐのに役に立ちます。 特にポーリングによる大量のリクエストと組み合わさると、レスポンスの遅いLDAPサーバーは頻繁にパフォーマンス問題や障害の原因となるので、この設定をおすすめします。 - -![GItチェックボックスのためのLDAPパスワード認証の無効化](/assets/images/enterprise/management-console/ldap-disable-password-auth-for-git.png) - -このオプションが選択されると、ユーザがコマンドライン経由のGitの操作でパスワードを使おうとすると、次のようなエラーメッセージが返されます。`Password authentication is not allowed for Git operations. You must use a personal access token.` - -#### LDAPの証明書検証の有効化 - -TLSと共に使うLDAPサーバの証明書を検証するには、LDAPの設定で**Enable LDAP certificate verification（LDAPの証明書検証の有効化）**を選択してください。 - -![LDAP証明書の検証ボックス](/assets/images/enterprise/management-console/ldap-enable-certificate-verification.png) - -このオプションが選択されると、以下のことを確実にするために証明書が検証されます: -- 証明書にAlternative Name (SAN) が少なくとも1つ含まれている場合には、SANの1つがLDAPホスト名に一致し、 そうでない場合はコモンネーム (CN) がLDAPホスト名に一致すること。 -- 証明書の期限が切れていないこと。 -- 証明書が信頼されている認証局 (CA) によって署名されていること。 - -#### LDAP Syncの有効化 - -LDAP Sync を使うと、{% data variables.product.prodname_ghe_server %} のユーザおよび Team のメンバーシップを、確立された LDAP グループに対して同期できます。 そうすることで、{% data variables.product.prodname_ghe_server %} 内で手作業で行う代わりに、LDAP サーバからユーザのロールベースのアクセス制御を確立できます。 詳細は「[チームを作成する](/enterprise/{{ currentVersion }}/admin/guides/user-management/creating-teams#creating-teams-with-ldap-sync-enabled)」を参照してください。 - -LDAP Sync を有効化するには、[**Synchronize Emails**]、[**Synchronize SSH Keys**]、または [**Synchronize GPG Keys**] を選択します。 - -![同期チェックボックス](/assets/images/enterprise/management-console/ldap-synchronize.png) - -LDAP Sync を有効化すると、同期のジョブが指定された間隔で動作し、各ユーザアカウントに対して以下の操作を行います: - -- アイデンティティプロバイダ外のユーザに対してビルトイン認証を許可し、ユーザがビルトイン認証を使っているなら、次のユーザに進みます。 -- ユーザに LDAP のマッピングが存在しないなら、ユーザをディレクトリ中の LDAP エントリにマップしようとします。 ユーザが LDAP のエントリにマップできなかった場合、ユーザをサスペンドして次のユーザに進みます。 -- LDAP マッピングが存在し、ディレクトリ中の対応する LDAP のエントリが欠けている場合、そのユーザをサスペンドして次のユーザに進みます。 -- 対応する LDAP のエントリが無効としてマークされており、ユーザがまだサスペンドされていないなら、そのユーザをサスペンドして次のユーザに進みます。 -- 対応する LDAP のエントリが無効としてマークされておらず、そのユーザがサスペンドされており、Admin center で [_Reactivate suspended users（サスペンドされたユーザを再アクティベート_] が有効化されているなら、ユーザのサスペンドを解除します。 -- 対応する LDAP エントリが `name` 属性を含んでいるなら、ユーザのプロフィール名を更新します。 -- 対応する LDAP エントリが Administrators グループ内にあるなら、そのユーザをサイト管理者に昇格させます。 -- 対応する LDAP エントリが Administrators グループ内にないなら、そのユーザを通常のアカウントに降格させます。 -- LDAP の User フィールドがメール用に定義されているなら、ユーザのメール設定を LDAP のエントリと同期します。 最初の LDAP の `mail` エントリをプライマリのメールとして設定します。 -- LDAP の User フィールドが公開 SSH キー用に定義されているなら、ユーザの公開 SSH キーを LDAP のエントリと同期します。 -- LDAP の User フィールドが GPG キー用に定義されているなら、ユーザの GPG キーを LDAP のエントリと同期します。 - -{% note %} - -**メモ**: LDAP のエントリが無効としてマークされるのは、Active Directory を使用しており、`userAccountControl` が存在して `ACCOUNTDISABLE` とされている場合のみです。 - -{% endnote %} - -同期ジョブは、LDAP グループにマップされなかった各 Team に対して以下の操作を行うためにも、指定された間隔で動作します。 - -- Team に対応する LDAP グループが削除された場合、すべてのメンバーを Team から削除します。 -- LDAP グループから LDAP のメンバーエントリが削除された場合、対応するユーザを Team から削除します。 その結果、ユーザがリポジトリへのアクセスを失った場合、それらのリポジトリでユーザが持っていたプライベートなフォークを削除します。 -- LDAP グループに LDAP のメンバーエントリが追加された場合、対応するユーザを Team に追加します。 その結果がユーザがリポジトリへのアクセスを再度得ることになった場合、過去 90 日以内にユーザがアクセスを失ったために削除されたリポジトリのプライベートフォークがリストアされます。 - -{% data reusables.enterprise_user_management.ldap-sync-nested-teams %} - -{% warning %} - -**セキュリティの警告:** - -LDAP Sync が有効化されると、サイト管理者と Organization のオーナーは Team をマップするグループを LDAP のディレクトリで検索できます。 - -これは、以下を含む組織に関する機密情報を契約者やその他の権限を持たないユーザに開示してしまう可能性があります。 - -- *ドメイン検索ユーザ*に特定の LDAP グループの存在が見えてしまう。 -- {% data variables.product.prodname_ghe_server %} のユーザアカウントを持つ LDAP グループのメンバーが、その LDAP グループと同期する Team を作ったときに開示されてしまう。 - -こういった情報が開示されることを望まないなら、企業あるいは組織は管理コンソールで設定された*ドメイン検索ユーザ*の権限を制限しなければなりません。 そういった制限ができない場合は、{% data variables.contact.contact_ent_support %} に連絡してください。 - -{% endwarning %} - -#### サポートされるLDAPグループのオブジェクトクラス - -{% data variables.product.prodname_ghe_server %} は、以下の LDAP グループオブジェクトクラスをサポートします。 グループは入れ子にできます。 - -- `group` -- `groupOfNames` -- `groupOfUniqueNames` -- `posixGroup` - -### LDAPユーザの表示と作成 - -インスタンスにアクセスできる LDAP ユーザの完全なリストを表示し、新しいユーザをプロビジョニングできます。 - -{% data reusables.enterprise_site_admin_settings.sign-in %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -3. 左のサイドバーで**LDAP users（LDAPユーザ）**をクリックしてください。 ![LDAP ユーザタブ](/assets/images/enterprise/site-admin-settings/ldap-users-tab.png) -4. ユーザを検索するには、完全なユーザ名もしくはユーザ名の一部を入力し、**Search（検索）**をクリックしてください。 検索結果に該当するユーザが表示されます。 該当するユーザがいなければ、**Create（作成）**をクリックして新しいユーザアカウントをプロビジョニングできます。 ![LDAP検索](/assets/images/enterprise/site-admin-settings/ldap-users-search.png) - -### LDAPアカウントの更新 - -[LDAP Sync が有効化](#enabling-ldap-sync)されていない限り、LDAP アカウントへの変更は自動的には {% data variables.product.prodname_ghe_server %} に同期されません。 - -* 新しい LDAP 管理者グループを使うには、LDAP 内での変更を反映させるためにユーザを {% data variables.product.prodname_ghe_server %} 上で手動で昇格および降格させなければなりません。 -* LDAP 管理者グループに LDAP アカウントを追加あるいは削除するには、[{% data variables.product.prodname_ghe_server %} 上でそのアカウントを昇格もしくは降格](/enterprise/{{ currentVersion }}/admin/guides/user-management/promoting-or-demoting-a-site-administrator)させてください。 -* LDAP アカウントを削除するには、[{% data variables.product.prodname_ghe_server %} アカウントをサスペンド](/enterprise/{{ currentVersion }}/admin/guides/user-management/suspending-and-unsuspending-users)してください。 - -#### 手動でのLDAPアカウントの同期 - -{% data reusables.enterprise_site_admin_settings.sign-in %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.search-user %} -{% data reusables.enterprise_site_admin_settings.click-user %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -5. "LDAP"の下で**Sync now（即時同期）**をクリックして、LDAPサーバからのデータでアカウントを手動更新してください。 ![LDAPの即時同期ボタン](/assets/images/enterprise/site-admin-settings/ldap-sync-now-button.png) - -You can also [use the API to trigger a manual sync](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#ldap). - -### {% data variables.product.product_location_enterprise %}へのアクセスの削除 - -[LDAP Sync が有効化](#enabling-ldap-sync)されているなら、ユーザの LDAP のクレデンシャルを削除すれば、次の同期が行われた後にそのユーザのアカウントはサスペンドされます。 - -LDAP Sync が有効化**されていない**なら、LDAP のクレデンシャルの削除後に {% data variables.product.prodname_ghe_server %} アカウントを手動でサスペンドしなければなりません。 詳細は「[ユーザのサスペンドとサスペンドの解除](/enterprise/{{ currentVersion }}/admin/guides/user-management/suspending-and-unsuspending-users)」を参照してください。 diff --git a/translations/ja-JP/content/admin/user-management/using-saml.md b/translations/ja-JP/content/admin/user-management/using-saml.md deleted file mode 100644 index b4f8283f3668..000000000000 --- a/translations/ja-JP/content/admin/user-management/using-saml.md +++ /dev/null @@ -1,137 +0,0 @@ ---- -title: SAMLの利用 -redirect_from: - - /enterprise/admin/articles/configuring-saml-authentication/ - - /enterprise/admin/articles/about-saml-authentication/ - - /enterprise/admin/user-management/using-saml -intro: 'SAML は認証と認可のための XML ベースの標準です。 {% data variables.product.prodname_ghe_server %} は、内部的な SAML アイデンティティプロバイダ (IdP) とサービスプロバイダ (SP) として動作できます。' -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_user_management.built-in-authentication %} - -### サポートされているSAMLサービス - -{% data reusables.saml.saml-supported-idps %} - -{% data reusables.saml.saml-single-logout-not-supported %} - -### SAMLでのユーザ名についての考慮 - -各{% data variables.product.prodname_ghe_server %}ユーザ名は、SAMLの応答で次のアサーションのいずれかによって決定され、優先順位で並べられます。 - -- カスタムユーザ名属性 (定義済みかつ存在する場合) -- `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name`アサーション (存在する場合) -- `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress`アサーション (存在する場合) -- `NameID`要素 - -`NameID`要素は、他の属性が存在する場合でも必須です。 - -`NameID`と{% data variables.product.prodname_ghe_server %}ユーザ名の間にマッピングが作成されるので、`NameID`は永続的かつ一意でなければならず、ユーザのライフサイクルを通じて変化しないことが必要です。 - -{% data reusables.enterprise_management_console.username_normalization %} - -{% data reusables.enterprise_management_console.username_normalization_sample %} - -{% data reusables.enterprise_user_management.two_factor_auth_header %} -{% data reusables.enterprise_user_management.external_auth_disables_2fa %} - -### SAMLのメタデータ - -{% data variables.product.prodname_ghe_server %} インスタンスのサービスプロバイダメタデータは、`http(s)://[hostname]/saml/metadata` にあります。 - -アイデンティティプロバイダを手動で設定するなら、Assertion Consumer Service (ACS) URLは`http(s)://[hostname]/saml/consume`です。 これは`urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST`バインディングを利用します。 - -### SAMLの属性 - -以下の属性が利用できます。 `administrator`属性以外の属性の名前は[Management Console](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-management-console/)で変更できます。 - -| デフォルトの属性名 | 種類 | 説明 | -| --------------- | -- | -------------------------------------------------------------------------------------------------------------------------------- | -| `NameID` | 必須 | 永続ユーザ識別子。 任意の名前識別子の形式を使用できます。 どの代替アサーションも指定しない場合、{% data variables.product.prodname_ghe_server %}ユーザ名には`NameID`要素が使用されます。 | -| `administrator` | 任意 | この値が 'true' であれば、ユーザは自動的に管理者に昇格します。 他の値、あるいは値が存在しない場合は、ユーザは通常のユーザアカウントに降格します。 | -| `ユーザ名` | 任意 | {% data variables.product.prodname_ghe_server %} のユーザ名 | -| `full_name` | 任意 | ユーザのプロフィールページに表示されるユーザ名です。 ユーザはプロビジョニング後に名前を変更できます。 | -| `emails` | 任意 | ユーザのメールアドレス。 複数指定することができます。 | -| `public_keys` | 任意 | ユーザの公開 SSH キー。 複数指定することができます。 | -| `gpg_keys` | 任意 | ユーザの GPG キー。 複数指定することができます。 | - -### SAMLの設定 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.authentication %} -3. **SAML**を選択してください。 ![SAML認証](/assets/images/enterprise/management-console/auth-select-saml.png) -4. {% data reusables.enterprise_user_management.built-in-authentication-option %} ![SAML ビルトイン認証の選択チェックボックス](/assets/images/enterprise/management-console/saml-built-in-authentication.png) -5. オプションで、未承諾応答SSOを有効化する場合は [**IdP initiated SSO**] を選択します。 デフォルトでは、{% data variables.product.prodname_ghe_server %}は未承認アイデンティティプロバイダ (IdP) 起点のリクエストに対して、IdPへの`AuthnRequest`返信で応答します。 ![SAML idP SSO](/assets/images/enterprise/management-console/saml-idp-sso.png) - - {% tip %} - - **ノート**：この値は**選択しない**でおくことをおすすめします。 この機能を有効にするのは、SAMLの実装がサービスプロバイダ起点のSSOをサポートしないまれな場合と、{% data variables.contact.enterprise_support %}によって推奨された場合**だけ**にすべきです。 - - {% endtip %} - -5. {% data variables.product.product_location_enterprise %} 上のユーザの管理者権限を SAML プロバイダに決めさせたく**ない**場合、[**Disable administrator demotion/promotion**] を選択します。 ![SAMLの無効化の管理者設定](/assets/images/enterprise/management-console/disable-admin-demotion-promotion.png) -6. **Single sign-on URL（シングルサインオンURL）**フィールドに、使用するIdpのシングルサインオンのリクエストのためのHTTPあるいはHTTPSエンドポイントを入力してください。 この値はIdpの設定によって決まります。 ホストが内部のネットワークからしか利用できない場合、[{% data variables.product.product_location_enterprise %}を内部ネームサーバーを利用するように設定](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-dns-nameservers/)する必要があるかもしれません。 ![SAML認証](/assets/images/enterprise/management-console/saml-single-sign-url.png) -7. または、[**Issuer**] フィールドに、SAML の発行者の名前を入力します。 これは、{% data variables.product.product_location_enterprise %} へ送信されるメッセージの真正性を検証します。 ![SAML発行者](/assets/images/enterprise/management-console/saml-issuer.png) -8. [**Signature Method**] および [**Digest Method**] ドロップダウンメニューで、SAML の発行者が {% data variables.product.product_location_enterprise %} からのリクエストの整合性の検証に使うハッシュアルゴリズムを選択します。 ** Name Identifier Format（Name Identifier形式）**ドロップダウンメニューから形式を指定してください。 ![SAML方式](/assets/images/enterprise/management-console/saml-method.png) -9. [**Verification certificate**] の下で、[**Choose File**] をクリックし、IdP からの SAML のレスポンスを検証するための証明書を選択してください。 ![SAML認証](/assets/images/enterprise/management-console/saml-verification-cert.png) -10. 必要に応じてSAMLの属性名はIdPに合わせて修正してください。あるいはデフォルト名をそのまま受け付けてください。 ![SAMLの属性名](/assets/images/enterprise/management-console/saml-verification-cert.png) - -### {% data variables.product.product_location_enterprise %}へのアクセスの削除 - -アイデンティティプロバイダからユーザを削除したなら、そのユーザを手動でサスペンドもしなければなりません。 そうしなければ、そのユーザはアクセストークンあるいはSSHキーを使って引き続き認証を受けることができてしまいます。 詳しい情報については[ユーザのサスペンドとサスペンドの解除](/enterprise/admin/guides/user-management/suspending-and-unsuspending-users)を参照してください。 - -### レスポンスメッセージについての要求 - -レスポンスメッセージは以下の要求を満たさなければなりません。 - -- ``要素はルートレスポンスドキュメントで指定されていなければならず、ACS URLに一致する必要があります。ただし、これはルートレスポンスドキュメントに署名がある場合のみです。 アサーションに署名がある場合は無視されます。 -- ``要素の一部として、``要素は常に指定する必要があります。 それは{% data variables.product.prodname_ghe_server %}のエンティティIdに一致しなければなりません。 これは、`https://ghe.corp.example.com`というような、{% data variables.product.prodname_ghe_server %}インスタンスへのURLです。 -- レスポンス中での各アサーションは、電子署名で保護されていなければ**なりません**。 これは、個々の``要素に署名するか、``要素を署名するかすることによって行います。 -- ``要素の一部として``要素を指定する必要があります。 任意の名前識別子の形式を使用できます。 -- `Recipient` 属性は存在しなければならず、ACS URL に設定されなければなりません。 例: - -```xml - - - - ... - - - - - - - monalisa - - - - -``` - -### エラーメッセージ - -`Recipient`がACS URLと一致しなかった場合、authログに以下のエラーメッセージが残されます。 - -``` -Recipient in the SAML response was not valid. -``` - -`Recipient`がレスポンスメッセージの一部ではなかった場合、authログに以下のエラーメッセージが残されます。 - -``` -Recipient in the SAML response must not be blank. -``` - -SAMLレスポンスが署名されていなかった場合、あるいは署名が内容とマッチしなかった場合、authログに以下のエラーメッセージが残されます。 - -``` -SAML Response is not signed or has been modified. -``` -`Audience` が指定されていない、または{% data variables.product.prodname_ghe_server %} エンティティ Id と一致しない場合は、auth ログに次のようなエラーメッセージが出力されます。 - -``` -Audience is invalid. Audience attribute does not match your_instance_url -``` diff --git a/translations/ja-JP/content/desktop/contributing-and-collaborating-using-github-desktop/accessing-a-pull-request-locally.md b/translations/ja-JP/content/desktop/contributing-and-collaborating-using-github-desktop/accessing-a-pull-request-locally.md deleted file mode 100644 index a183bb3f3f30..000000000000 --- a/translations/ja-JP/content/desktop/contributing-and-collaborating-using-github-desktop/accessing-a-pull-request-locally.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: ローカルでプルリクエストにアクセスする -intro: '{% data variables.product.prodname_desktop %}でオープンプルリクエストで提案された変更を見ることができます。' -redirect_from: - - /desktop/contributing-to-projects/accessing-a-pull-request-locally -versions: - free-pro-team: '*' ---- - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.click-pull-requests %} - ![[Current Branch] のドロップダウンメニュー内にある [Pull Requests] タブ](/assets/images/help/desktop/branch-drop-down-pull-request-tab.png) -{% data reusables.desktop.choose-pr-from-list %} - ![リポジトリ内のオープンプルリクエストのリスト](/assets/images/help/desktop/click-pull-request.png) -4. プルリクエストのリストを更新したい場合は、{% octicon "sync" aria-label="The sync icon" %}をクリックします。 ![更新するための [Sync] ボタン](/assets/images/help/desktop/pull-request-list-sync.png) diff --git a/translations/ja-JP/content/desktop/contributing-to-projects/accessing-a-pull-request-locally.md b/translations/ja-JP/content/desktop/contributing-to-projects/accessing-a-pull-request-locally.md deleted file mode 100644 index 3e2f5a26df75..000000000000 --- a/translations/ja-JP/content/desktop/contributing-to-projects/accessing-a-pull-request-locally.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: ローカルでプルリクエストにアクセスする -intro: '{% data variables.product.prodname_desktop %}でオープンプルリクエストで提案された変更を見ることができます。' -versions: - free-pro-team: '*' ---- - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.click-pull-requests %} - ![[Current Branch] のドロップダウンメニュー内にある [Pull Requests] タブ](/assets/images/help/desktop/branch-drop-down-pull-request-tab.png) -{% data reusables.desktop.choose-pr-from-list %} - ![リポジトリ内のオープンプルリクエストのリスト](/assets/images/help/desktop/click-pull-request.png) -4. プルリクエストのリストを更新したい場合は、{% octicon "sync" aria-label="The sync icon" %}をクリックします。 ![更新するための [Sync] ボタン](/assets/images/help/desktop/pull-request-list-sync.png) diff --git a/translations/ja-JP/content/desktop/contributing-to-projects/adding-a-repository-from-your-local-computer-to-github-desktop.md b/translations/ja-JP/content/desktop/contributing-to-projects/adding-a-repository-from-your-local-computer-to-github-desktop.md deleted file mode 100644 index 8ef0c2099434..000000000000 --- a/translations/ja-JP/content/desktop/contributing-to-projects/adding-a-repository-from-your-local-computer-to-github-desktop.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: ローカルコンピュータからGitHubデスクトップへのリポジトリの追加 -intro: '{% data variables.product.prodname_dotcom %}リポジトリでない場合でも、{% data variables.product.prodname_desktop %}にGitリポジトリを追加できます。' -versions: - free-pro-team: '*' ---- - -{% tip %} - -**ヒント：**フォルダを{% data variables.product.prodname_desktop %}ウィンドウにドラッグすることで、GitリポジトリをローカルコンピュータからGitHub Desktopに追加することができます。 {% data variables.product.prodname_desktop %}に同時に複数のフォルダをドラッグする場合、各フォルダが別々のGitリポジトリとして追加されます。 - -{% endtip %} - -{% mac %} - -1. **File**メニューで、**Add Local Repository**をクリックします。 ![Add Local Repositoryメニューオプション](/assets/images/help/desktop/add-local-repository-mac.png) -2. [**Choose...**]をクリックし、Finderウインドウを使用して追加するローカルリポジトリに移動します。 ![Macアプリケーション内のLocal Pathフィールド](/assets/images/help/desktop/add-repo-choose-button-mac.png) -4. **Add Repository**をクリックします。 ![Macアプリケーション内のAdd repositoryボタン](/assets/images/help/desktop/add-repository-button-mac.png) - -{% endmac %} - -{% windows %} - -1. **File**メニューで、[**Add local repository**] をクリックします。 ![Add Local Repositoryメニューオプション](/assets/images/help/desktop/add-local-repository-windows.png) -2. **Choose...**をクリックし、Windows Explorerを使用して追加するローカルリポジトリに移動します。 ![Windowsアプリケーション内のLocal Pathフィールド](/assets/images/help/desktop/add-repo-choose-button-win.png) -4. **Add repository**をクリックします。 ![Windowsアプリケーション内のAdd repositoryボタン](/assets/images/help/desktop/add-repository-button-windows.png) - -{% endwindows %} diff --git a/translations/ja-JP/content/desktop/contributing-to-projects/adding-an-existing-project-to-github-using-github-desktop.md b/translations/ja-JP/content/desktop/contributing-to-projects/adding-an-existing-project-to-github-using-github-desktop.md deleted file mode 100644 index b8dc9759bcfd..000000000000 --- a/translations/ja-JP/content/desktop/contributing-to-projects/adding-an-existing-project-to-github-using-github-desktop.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: GitHub Desktopを介してのGitHubへの既存プロジェクト追加 -intro: '{% data variables.product.prodname_desktop %}を使用して、{% data variables.product.prodname_dotcom %}に既存のGitリポジトリを追加できます。' -versions: - free-pro-team: '*' ---- - -{% mac %} - -{% data reusables.git.remove-git-remote %} -2. [リポジトリをGitHub Desktopに追加します](/desktop/guides/contributing-to-projects/adding-a-repository-from-your-local-computer-to-github-desktop/). -{% data reusables.desktop.publish-repository %} -4. **Name**フィールドにご希望の名前を入力するか、現在のデフォルトローカルリポジトリの名前を使います。 ![Nameフィールド](/assets/images/help/desktop/publish-repository-name-mac.png) -5. パブリックリポジトリを公開するには、**Keep this code private**の選択を解除してください。 ![Keep this code privateチェックボックス](/assets/images/help/desktop/publish-repository-private-checkbox-mac.png) -6. リポジトリを公開するOrganizationを**Organization**ドロップダウンで選択するか、**None**を選択してリポジトリを個人アカウントに公開します。 ![Organizationのドロップダウン](/assets/images/help/desktop/publish-repository-org-dropdown-mac.png) -7. **Publish Repository**ボタンをクリックします。 ![Publish Repositoryダイアログ内のPublish repositoryボタン](/assets/images/help/desktop/publish-repository-dialog-button-mac.png) - -{% endmac %} - -{% windows %} - -{% data reusables.git.remove-git-remote %} -2. [リポジトリをGitHub Desktopに追加します](/desktop/guides/contributing-to-projects/adding-a-repository-from-your-local-computer-to-github-desktop/). -{% data reusables.desktop.publish-repository %} -4. **Name**フィールドにご希望の名前を入力するか、現在のデフォルトローカルリポジトリの名前を使います。 ![Nameフィールド](/assets/images/help/desktop/publish-repository-name-win.png) -5. パブリックリポジトリを公開するには、**Keep this code private**の選択を解除してください。 ![Keep this code privateチェックボックス](/assets/images/help/desktop/publish-repository-private-checkbox-win.png) -6. リポジトリを公開するOrganizationを**Organization**ドロップダウンで選択するか、**None**を選択してリポジトリを個人アカウントに公開します。 ![Organizationのドロップダウン](/assets/images/help/desktop/publish-repository-org-dropdown-win.png) -7. **Publish repository**ボタンをクリックします。 ![Publish repositoryダイアログ内のPublish repositoryボタン](/assets/images/help/desktop/publish-repository-dialog-button-win.png) - -{% endwindows %} diff --git a/translations/ja-JP/content/desktop/contributing-to-projects/adding-and-cloning-repositories.md b/translations/ja-JP/content/desktop/contributing-to-projects/adding-and-cloning-repositories.md deleted file mode 100644 index f166ee295791..000000000000 --- a/translations/ja-JP/content/desktop/contributing-to-projects/adding-and-cloning-repositories.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: リポジトリの追加とクローン -intro: 'ローカルコンピュータにある既存のリポジトリを{% data variables.product.prodname_desktop %}に追加したり、{% data variables.product.product_name %}のリポジトリをクローンしたりしてください。' -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/ja-JP/content/desktop/contributing-to-projects/changing-a-remotes-url-from-github-desktop.md b/translations/ja-JP/content/desktop/contributing-to-projects/changing-a-remotes-url-from-github-desktop.md deleted file mode 100644 index 813b09abb446..000000000000 --- a/translations/ja-JP/content/desktop/contributing-to-projects/changing-a-remotes-url-from-github-desktop.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: GitHub DesktopからのリモートのURL変更 -intro: '取り扱ってるリポジトリに対してのリモートのURLは{% data variables.product.prodname_desktop %}で変更できます。 リポジトリの名前や、リポジトリを所有するユーザ名、またはOrganizationが変更された場合に役立ちます。' -redirect_from: - - /desktop/contributing-to-projects/changing-a-remote-s-url-from-github-desktop -versions: - free-pro-team: '*' ---- - -{% mac %} - -1. **Repository**メニューで、**Repository Settings...**をクリックします。 ![Repository Settingsメニューオプション](/assets/images/help/desktop/repository-settings-mac.png) -2. **Primary remote repository**フィールドで、ご希望のURLを入力します。 ![Primary remote repositoryフィールド](/assets/images/help/desktop/repository-settings-remote-mac.png) -3. **Save**をクリックします。 ![Saveボタン](/assets/images/help/desktop/repository-settings-save-mac.png) - -{% endmac %} - -{% windows %} - -1. **Repository**メニューで、**Repository settings...**をクリックします。 ![Repository settingsメニューオプション](/assets/images/help/desktop/repository-settings-win.png) -2. **Primary remote repository**フィールドで、ご希望のURLを入力します。 ![Primary remote repositoryフィールド](/assets/images/help/desktop/repository-settings-remote-win.png) -3. **Save**をクリックします。 ![Saveボタン](/assets/images/help/desktop/repository-settings-save-win.png) - -{% endwindows %} diff --git a/translations/ja-JP/content/desktop/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop.md b/translations/ja-JP/content/desktop/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop.md deleted file mode 100644 index fc581ac75be1..000000000000 --- a/translations/ja-JP/content/desktop/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: GitHubからのGitHub Desktopへのリポジトリのクローン方法 -intro: '{% data variables.product.prodname_dotcom %} を使用して、リモートリポジトリを {% data variables.product.prodname_desktop %} にクローンできます。' -versions: - free-pro-team: '*' ---- - -{% tip %} - -**ヒント：**{% data variables.product.prodname_dotcom %}にあるリポジトリをクローンするには、{% data variables.product.prodname_desktop %}も使用できます。 詳しい情報については、「[{% data variables.product.prodname_desktop %}からのリポジトリのクローン方法](/desktop/guides/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop/)」を参照してください。 - -{% endtip %} - -{% mac %} - -1. クローンする前に、{% data variables.product.product_location %}と{% data variables.product.prodname_desktop %}にサインインします。 -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.open-with-github-desktop %} -5. [**Choose...**]をクリックし、Finderウインドウを使用してリポジトリをクローンするローカルパスに移動します。 ![URLタブにあるchooseボタン](/assets/images/help/desktop/clone-choose-button-url-mac.png) - - {% note %} - - **注釈：**リポジトリがLFSを使用するように構成されている場合、{% data variables.large_files.product_name_short %}の初期化を要求するプロンプトが表示されます。 - - {% endnote %} - -5. **Clone**をクリックします。 ![URLタブ内のcloneボタン](/assets/images/help/desktop/clone-button-url-mac.png) - -{% endmac %} - -{% windows %} - -1. クローンする前に、{% data variables.product.product_location %}と{% data variables.product.prodname_desktop %}にサインインします。 -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.open-with-github-desktop %} -5. **Choose...**をクリックし、Windows Explorerを使用してリポジトリをクローンするローカルパスに移動します。 ![Chooseボタン](/assets/images/help/desktop/clone-choose-button-url-win.png) - - {% note %} - - **注釈：**リポジトリがLFSを使用するように構成されている場合、{% data variables.large_files.product_name_short %}の初期化を要求するプロンプトが表示されます。 - - {% endnote %} - -5. **Clone**をクリックします。 ![Cloneボタン](/assets/images/help/desktop/clone-button-url-win.png) - -{% endwindows %} diff --git a/translations/ja-JP/content/desktop/contributing-to-projects/cloning-and-forking-repositories-from-github-desktop.md b/translations/ja-JP/content/desktop/contributing-to-projects/cloning-and-forking-repositories-from-github-desktop.md deleted file mode 100644 index d663e056be74..000000000000 --- a/translations/ja-JP/content/desktop/contributing-to-projects/cloning-and-forking-repositories-from-github-desktop.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: GitHub Desktopからのリポジトリのクローンとフォーク -intro: '{% data variables.product.prodname_desktop %}を使って{% data variables.product.prodname_dotcom %}上にあるリポジトリをクローンしたりフォークしたりできます。' -redirect_from: - - /desktop/contributing-to-projects/cloning-a-repository-from-github-desktop -versions: - free-pro-team: '*' ---- - -### リポジトリのクローン方法 -{% data variables.product.prodname_dotcom %}上のリポジトリは、リモートリポジトリとして存在します。 他の人が所有するパブリックリポジトリをクローンできます。 自分が所有するリポジトリをクローンして、自分のコンピュータ上にローカルコピーを作成し、これら2つの場所の間で同期を行えます。 - -リポジトリを{% data variables.product.prodname_dotcom %}、または{% data variables.product.prodname_enterprise %}から直接クローンすることもできます。 詳しい情報については、「[{% data variables.product.prodname_dotcom %} から {% data variables.product.prodname_desktop %} にリポジトリをクローンする](/desktop/guides/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop/)」を参照してください。 - -{% mac %} - -{% data reusables.desktop.choose-clone-repository %} - ![Mac アプリケーション内の [Clone] メニューオプション](/assets/images/help/desktop/clone-file-menu-mac.png) -{% data reusables.desktop.cloning-location-tab %} - ![[Clone a repository] メニュー内の [Location] タブ](/assets/images/help/desktop/choose-repository-location-mac.png) -{% data reusables.desktop.cloning-repository-list %} - ![リポジトリリストのクローン](/assets/images/help/desktop/clone-a-repository-list-mac.png) -4. [**Choose...**]をクリックし、Finderウインドウを使用してリポジトリをクローンするローカルパスに移動します。 ![Chooseボタン](/assets/images/help/desktop/clone-choose-button-mac.png) -5. **Clone**をクリックします。 ![Cloneボタン](/assets/images/help/desktop/clone-button-mac.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.choose-clone-repository %} - ![Windows アプリケーション内の [Clone] メニューオプション](/assets/images/help/desktop/clone-file-menu-windows.png) -{% data reusables.desktop.cloning-location-tab %} - ![[Clone a repository] メニュー内の [Location] タブ](/assets/images/help/desktop/choose-repository-location-win.png) -{% data reusables.desktop.cloning-repository-list %} - ![リポジトリリストのクローン](/assets/images/help/desktop/clone-a-repository-list-win.png) -4. **Choose...**をクリックし、Windows Explorerを使用してリポジトリをクローンするローカルパスに移動します。 ![Chooseボタン](/assets/images/help/desktop/clone-choose-button-win.png) -5. **Clone**をクリックします。 ![Cloneボタン](/assets/images/help/desktop/clone-button-win.png) - -{% endwindows %} - -### リポジトリのフォーク -書き込みアクセス権がないプロジェクトにコントリビュートするには、{% data variables.product.prodname_desktop %}を使ってそのリポジトリのフォークを作成します。 フォークに対する変更は、オリジナルのリポジトリには影響しません。 フォークに変更をコミットし、そしてオリジナルのリポジトリに対して提案する変更でプルリクエストをオープンできます。 詳しい情報については「[フォークについて](/github/collaborating-with-issues-and-pull-requests/about-forks)」を参照してください。 - -1. 書き込みアクセス権を持っていないリポジトリをクローンし、変更をコミットしようとすると、{% data variables.product.prodname_desktop %}は次の警告を発します。"You don't have write access to **REPOSITORY**." **create a fork（フォークの作成）**をクリックしてください。 ![フォークの作成リンク](/assets/images/help/desktop/create-a-fork.png) -3. **Fork this repository（このリポジトリをフォーク）**をクリックしてください。 ![このリポジトリのフォークボタン](/assets/images/help/desktop/fork-this-repo-button.png) -4. {% data variables.product.prodname_dotcom %}上のフォークを見るには、{% data variables.product.prodname_dotcom %}の右上で自分のプロフィール画像をクリックし、**Your repositories（あなたのリポジトリ）**をクリックしてください。 ![あなたのリポジトリリンク](/assets/images/help/profile/your-repositories.png) diff --git a/translations/ja-JP/content/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project.md b/translations/ja-JP/content/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project.md deleted file mode 100644 index ede79e8c9398..000000000000 --- a/translations/ja-JP/content/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project.md +++ /dev/null @@ -1,99 +0,0 @@ ---- -title: プロジェクトへの変更のコミットやレビュー -intro: '{% data variables.product.prodname_desktop %}では、ファイルを編集すると、全ての変更が追跡されます。 有意義なコミットを作成するために、変更のまとめ方を決めることができます。' -versions: - free-pro-team: '*' ---- - -### コミットについて - -ファイルの保存と同様に、コミットは、ブランチにある１つ以上のファイルの変更です。 Gitは、各コミットに次の情報を追跡するSHA、またはハッシュという固有のIDを割り当てます。 - -- 具体的な変更 -- 変更時間 -- 変更者 - -コミットするときは、変更を簡潔に説明するコミットメッセージを含める必要があります。 共同作業しているコミットに共著者を追加することもできます。 - -### 1. ブランチの選択と変更の実行 - -1. [新規ブランチを作成する](/desktop/guides/contributing-to-projects/managing-branches)か、ツールバーにある{% octicon "git-branch" aria-label="The branch icon" %}**Current Branch**をクリックし、既存ブランチをリストから選択します。 ![現在のブランチを切り替えるドロップダウンメニュー](/assets/images/help/desktop/click-branch-in-drop-down.png) -{% data reusables.desktop.make-changes %} - -### 2. コミットに含める変更の選択方法 - -テキストエディタでファイルに変更を加えて保存していくと、変更は、{% data variables.product.prodname_desktop %}にも反映されます。 - -* 赤い{% octicon "diff-removed" aria-label="The diff removed icon color-red" %}アイコンは、削除されたファイルを表します。 -* 黄色の{% octicon "diff-modified" aria-label="The diff modified icon color-yellow" %}アイコンは変更されたファイルを表します。 -* 緑の{% octicon "diff-added" aria-label="The diff added icon color-green" %}アイコンは、追加されたファイルを表します。 -* stash した変更にアクセスするには、[**Stashed Changes**] をクリックします。 ![[Stash changes] オプション](/assets/images/help/desktop/stashed-changes.png) -* {% data reusables.desktop.commit-all-desc %} -![チェックボックスを選択して、変更されたすべてのファイルをコミットします](/assets/images/help/desktop/commit-all.png) -* {% data reusables.desktop.commit-some-desc %} -![コミットするファイルの横のチェックボックスを選択します](/assets/images/help/desktop/commit-some.png) - -#### 部分的なコミットの作成方法 - -1つのファイルに複数の変更があり、*一部*だけをコミットに含めたい場合は、部分的なコミットを作成できます。 追加変更やコミットできるように、他の変更はそのまま残ります。 これにより、改行の変更をコードや構文の変更から区別するなど、個別で有意義なコミットの作成が可能になります。 - -ファイルのdiffを確認するとき、コミットに含まれる行は青色で強調表示されます。 変更を除外するには、青色が消えるように変更された行をクリックします。 - -![ファイルで選択解除された行](/assets/images/help/desktop/partial-commit.png) - -#### 変更の廃棄 - -1つのファイルや複数のファイルのコミットされていない全ての変更の廃棄、または最新コミット以降の全てのファイルの全ての変更の廃棄ができます。 - -{% mac %} - -{% data reusables.desktop.select-discard-files %} -{% data reusables.desktop.click-discard-files %} - ![コンテキストメニュー内の [Discard Changes] オプション](/assets/images/help/desktop/discard-changes-mac.png) -{% data reusables.desktop.confirm-discard-files %} - ![確定ダイアログ内の [Discard Changes] ボタン](/assets/images/help/desktop/discard-changes-confirm-mac.png) - -{% tip %} - -**ヒント：**廃棄した変更は、Trash内の日付付きファイルに保存され、Trashが空になるまでは復元できます。 - -{% endtip %} - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.select-discard-files %}{% data reusables.desktop.click-discard-files %} - ![コンテキストメニュー内の [Discard Changes] オプション](/assets/images/help/desktop/discard-changes-win.png) -{% data reusables.desktop.confirm-discard-files %} - ![確定ダイアログ内の [Discard Changes] ボタン](/assets/images/help/desktop/discard-changes-confirm-win.png) - -{% tip %} - -**ヒント：**廃棄した変更は、Recycle Bin内のファイルに保存され、空になるまでは復元できます。 - -{% endtip %} - -{% endwindows %} - -### 3. コミットメッセージの入力と変更のプッシュ - -コミットに含めたい変更を決めたら、コミットメッセージを入力して変更をプッシュします。 コミットで共同作業した場合、コミットに 1 人以上の作者を追加できます。 - -{% note %} - -**Note**: {% data reusables.desktop.tags-push-with-commits %} For more information, see "[Managing tags](/desktop/contributing-to-projects/managing-tags)." - -{% endnote %} - -{% data reusables.desktop.commit-message %} - ![Commit messageフィールド](/assets/images/help/desktop/commit-message.png) -2. オプションとして、コミットに別の作者を追加するには、共作者を追加するアイコンをクリックし、追加するユーザ名を入力します。 ![コミットメッセージに共作者を追加](/assets/images/help/desktop/add-co-author-commit.png) -{% data reusables.desktop.commit-button %} - ![[Commit] ボタン](/assets/images/help/desktop/commit-button.png) -4. コミットしようとしているブランチが保護されている場合、Desktopは警告します。 - - 変更を移動するには、**switch branches（ブランチを切り替え）**をクリックしてください。 - - 保護されたブランチに変更をコミットするには、**Commit to _BRANCH_（ブランチにコミット）**をクリックしてください。 - - 保護されたブランチに関する詳しい情報については「[保護されたブランチについて](/github/administering-a-repository/about-protected-branches)」を参照してください。 ![保護されたブランチの警告](/assets/images/help/desktop/protected-branch-warning.png) -{% data reusables.desktop.push-origin %} diff --git a/translations/ja-JP/content/desktop/contributing-to-projects/creating-a-branch-for-your-work.md b/translations/ja-JP/content/desktop/contributing-to-projects/creating-a-branch-for-your-work.md deleted file mode 100644 index 205f9dd01e76..000000000000 --- a/translations/ja-JP/content/desktop/contributing-to-projects/creating-a-branch-for-your-work.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: 作業用ブランチの作成 -intro: リポジトリでコラボレータの権限がある場合、安全に実験的な変更を加えられるため、リポジトリのデフォルトブランチに基づいて、ブランチを作成することができます。 -versions: - free-pro-team: '*' ---- - -### ブランチの作成 - -{% tip %} - -**ヒント：**最初に作成するブランチは、ほとんどの場合`master`であるデフォルトブランチに基づきます。 1つ以上のブランチがある場合、現在チェックアウトされているブランチか、デフォルトブランチに新規ブランチを基づく選択肢が与えられます。 - -{% endtip %} - -{% mac %} - -{% data reusables.desktop.click-base-branch-in-drop-down %} - ![現在のブランチを切り替えるドロップダウンメニュー](/assets/images/help/desktop/click-branch-in-drop-down-mac.png) -{% data reusables.desktop.create-new-branch %} - ![ブランチメニュー内の [New Branch] オプション](/assets/images/help/desktop/new-branch-button-mac.png) -{% data reusables.desktop.name-branch %} - ![新しいブランチの名前を作成するフィールド](/assets/images/help/desktop/create-branch-name-mac.png) -{% data reusables.desktop.select-base-branch %} - ![ベースブランチのオプション](/assets/images/help/desktop/create-branch-choose-branch-mac.png) -{% data reusables.desktop.confirm-new-branch-button %} - ![Create Branchボタン](/assets/images/help/desktop/create-branch-button-mac.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.click-base-branch-in-drop-down %} - ![現在のブランチを切り替えるドロップダウンメニュー](/assets/images/help/desktop/click-branch-in-drop-down-win.png) -{% data reusables.desktop.create-new-branch %} - ![ブランチメニュー内の [New Branch] オプション](/assets/images/help/desktop/new-branch-button-win.png) -{% data reusables.desktop.name-branch %} - ![新しいブランチの名前を作成するフィールド](/assets/images/help/desktop/create-branch-name-win.png) -{% data reusables.desktop.select-base-branch %} - ![ベースブランチのオプション](/assets/images/help/desktop/create-branch-choose-branch-win.png) -{% data reusables.desktop.confirm-new-branch-button %} - ![Create branchボタン](/assets/images/help/desktop/create-branch-button-win.png) - -{% endwindows %} - -### 参考リンク - -- 「[{% data variables.product.prodname_desktop %}からのリポジトリのクローン方法](/desktop/guides/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop)」 diff --git a/translations/ja-JP/content/desktop/contributing-to-projects/creating-an-issue-or-pull-request.md b/translations/ja-JP/content/desktop/contributing-to-projects/creating-an-issue-or-pull-request.md deleted file mode 100644 index 09f113783a19..000000000000 --- a/translations/ja-JP/content/desktop/contributing-to-projects/creating-an-issue-or-pull-request.md +++ /dev/null @@ -1,56 +0,0 @@ ---- -title: Issueもしくはプルリクエストの作成 -intro: リポジトリに対する変更の提案あるいは共同作業のために、Issueあるいはプルリクエストを作成できます。 -redirect_from: - - /desktop/contributing-to-projects/creating-a-pull-request -versions: - free-pro-team: '*' ---- - -### 新しいIssueのオープン -{% data variables.product.prodname_desktop %}でローカルに作業をしていてバグを見つけた時、あるいは拡張を提案したい時は、作業をしているリポジトリでIssueが有効化されているなら、新しいIssueをオープンできます。 Issueでの作業に関する詳しい情報については「[Issueについて](/github/managing-your-work-on-github/about-issues)」を参照してください。 - -{% mac %} - -1. 画面の左上で、**Repository（リポジトリ）**メニューを選択してください。 ![Macメニューバー内のGitHub Desktopメニュー](/assets/images/help/desktop/select-repository-menu-mac.png) -2. **Create Issue on {% data variables.product.prodname_dotcom %}（{% data variables.product.prodname_dotcom %}上でIssueを作成）**をクリックしてください。 ![ブランチメニュー内のリポジトリの値](/assets/images/help/desktop/create-issue-mac.png) -3. {% data variables.product.prodname_dotcom %}上で、**Get started（始める）**をクリックしてIssueテンプレートをオープンするか、**Open a blank issue（空のIssueをオープン）**をクリックしてください。 ![新規Issueの作成オプション](/assets/images/help/desktop/create-new-issue.png) - -{% endmac %} - -{% windows %} - -1. ウィンドウの左上で、**Repository（リポジトリ）**メニューを選択してください。 ![Macメニューバー内のGitHub Desktopメニュー](/assets/images/help/desktop/select-repository-menu-windows.png) -2. **Create Issue on {% data variables.product.prodname_dotcom %}（{% data variables.product.prodname_dotcom %}上でIssueを作成）**をクリックしてください。 ![ブランチメニュー内のリポジトリの値](/assets/images/help/desktop/create-issue-windows.png) -3. {% data variables.product.prodname_dotcom %}上で、**Get started（始める）**をクリックしてIssueテンプレートをオープンするか、**Open a blank issue（空のIssueをオープン）**をクリックしてください。 ![新規Issueの作成オプション](/assets/images/help/desktop/create-new-issue.png) - -{% endwindows %} - -{% note %} - -**ノート**: 現在のリポジトリでIssueテンプレートが有効化されていないなら、{% data variables.product.prodname_desktop %}は{% data variables.product.prodname_dotcom %}上の空のIssueへリダイレクトします。 - -{% endnote %} - -### 新しいプルリクエストの作成 -[ブランチを作成](/desktop/guides/contributing-to-projects/managing-branches)して、[変更をコミット](/desktop/guides/contributing-to-projects/committing-and-reviewing-changes-to-your-project)した後、変更の提案についてフィードバックを受け取るためにプルリクエストを開くことができます。 - -{% mac %} - -1. 画面左上にある**Branch**メニューを選択します。 ![Macメニューバー内のGitHub Desktopメニュー](/assets/images/help/desktop/mac-select-branch-menu.png) -2. **Create Pull Request**をクリックします ![ブランチメニュー内のCreate pull request値](/assets/images/help/desktop/create-pull-request-mac.png) -3. {% data variables.product.prodname_dotcom %}で、ドロップダウンメニュー内のデフォルトの_base_ブランチと_compare_ブランチを検証し、必要であれば変更します。 ![ベースを選択し、ブランチを比較するドロップダウンメニュー](/assets/images/help/pull_requests/choose-base-and-compare-branches.png) -{% data reusables.repositories.pr-title-description %} -{% data reusables.repositories.create-pull-request %} - -{% endmac %} - -{% windows %} - -1. ウィンドウ左上にある**Branch**メニューをクリックします。 ![Windowsメニューバー内のGitHub Desktopメニュー](/assets/images/help/desktop/windows-select-branch-menu.png) -2. **Create pull request**をクリックします。 ![ブランチメニュー内のCreate pull request値](/assets/images/help/desktop/create-pull-request-win.png) -3. {% data variables.product.prodname_dotcom %}で、ドロップダウンメニュー内のデフォルトの_base_ブランチと_compare_ブランチを検証し、必要であれば変更します。 ![ベースを選択し、ブランチを比較するドロップダウンメニュー](/assets/images/help/pull_requests/choose-base-and-compare-branches.png) -{% data reusables.repositories.pr-title-description %} -{% data reusables.repositories.create-pull-request %} - -{% endwindows %} diff --git a/translations/ja-JP/content/desktop/contributing-to-projects/index.md b/translations/ja-JP/content/desktop/contributing-to-projects/index.md deleted file mode 100644 index f191f2fd33d8..000000000000 --- a/translations/ja-JP/content/desktop/contributing-to-projects/index.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: GitHub Desktopを介してのプロジェクトへの貢献 -shortTitle: プロジェクトに貢献する -intro: GitHub Desktopを使って、プロジェクトを管理し、有意義なコミットを作成し、プロジェクトの履歴をコマンドラインではなくアプリで追跡しましょう。 -versions: - free-pro-team: '*' ---- - - -### 目次 - -{% topic_link_in_list /adding-and-cloning-repositories %} - {% link_in_list /adding-a-repository-from-your-local-computer-to-github-desktop %} - {% link_in_list /adding-an-existing-project-to-github-using-github-desktop %} - {% link_in_list /cloning-and-forking-repositories-from-github-desktop %} - {% link_in_list /cloning-a-repository-from-github-to-github-desktop %} -{% topic_link_in_list /making-changes-in-a-branch %} - {% link_in_list /managing-branches %} - {% link_in_list /committing-and-reviewing-changes-to-your-project %} - {% link_in_list /pushing-changes-to-github %} - {% link_in_list /reverting-a-commit %} - {% link_in_list /managing-tags %} - {% link_in_list /viewing-the-branch-history %} -{% topic_link_in_list /working-with-your-remote-repository-on-github-or-github-enterprise %} - {% link_in_list /syncing-your-branch %} - {% link_in_list /creating-an-issue-or-pull-request %} - {% link_in_list /accessing-a-pull-request-locally %} - {% link_in_list /changing-a-remotes-url-from-github-desktop %} diff --git a/translations/ja-JP/content/desktop/contributing-to-projects/making-changes-in-a-branch.md b/translations/ja-JP/content/desktop/contributing-to-projects/making-changes-in-a-branch.md deleted file mode 100644 index c95fd0ca7ad1..000000000000 --- a/translations/ja-JP/content/desktop/contributing-to-projects/making-changes-in-a-branch.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: ブランチでの変更 -intro: '[Atom](https://atom.io/)などお好みのテキストエディタを使用して、プロジェクトに変更を加え、{% data variables.product.prodname_desktop %}を使って有意義なコミットをビジュアル化します。' -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/ja-JP/content/desktop/contributing-to-projects/managing-branches.md b/translations/ja-JP/content/desktop/contributing-to-projects/managing-branches.md deleted file mode 100644 index ec7ad0468bef..000000000000 --- a/translations/ja-JP/content/desktop/contributing-to-projects/managing-branches.md +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: Managing branches -intro: You can create a branch off of a repository's default branch so you can safely experiment with changes. -redirect_from: - - /desktop/contributing-to-projects/creating-a-branch-for-your-work - - /desktop/contributing-to-projects/switching-between-branches -versions: - free-pro-team: '*' ---- - -### About managing branches -You can use branches to safely experiment with changes to your project. Branches isolate your development work from other branches in the repository. For example, you could use a branch to develop a new feature or fix a bug. - -ブランチは常に既存のものから作成します。 通常、リポジトリの `master` ブランチから作成します。 その後、他の人がリポジトリに加えた変更とは別に、新しいブランチで作業できます。 - -Once you're satisfied with your work, you can [open a pull request](/desktop/contributing-to-projects/creating-an-issue-or-pull-request) to merge the changes in the current branch into another branch. 詳しい情報については[プルリクエストについて](/articles/about-pull-requests)を参照してください。 - -You can always create a branch in {% data variables.product.prodname_desktop %} if you have read access to a repository, but you can only push the branch to {% data variables.product.prodname_dotcom %} if you have write access to the repository. - -{% data reusables.desktop.protected-branches %} - -### ブランチの作成 - -{% tip %} - -**ヒント：**最初に作成するブランチは、ほとんどの場合`master`であるデフォルトブランチに基づきます。 If you have more than one branch, you can choose to base the new branch on the currently checked out branch or the default branch. - -{% endtip %} - -{% mac %} - -{% data reusables.desktop.click-base-branch-in-drop-down %} - ![現在のブランチを切り替えるドロップダウンメニュー](/assets/images/help/desktop/click-branch-in-drop-down-mac.png) -{% data reusables.desktop.create-new-branch %} - ![ブランチメニュー内の [New Branch] オプション](/assets/images/help/desktop/new-branch-button-mac.png) -{% data reusables.desktop.name-branch %} - ![新しいブランチの名前を作成するフィールド](/assets/images/help/desktop/create-branch-name-mac.png) -{% data reusables.desktop.select-base-branch %} - ![ベースブランチのオプション](/assets/images/help/desktop/create-branch-choose-branch-mac.png) -{% data reusables.desktop.confirm-new-branch-button %} - ![Create Branchボタン](/assets/images/help/desktop/create-branch-button-mac.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.click-base-branch-in-drop-down %} - ![現在のブランチを切り替えるドロップダウンメニュー](/assets/images/help/desktop/click-branch-in-drop-down-win.png) -{% data reusables.desktop.create-new-branch %} - ![ブランチメニュー内の [New Branch] オプション](/assets/images/help/desktop/new-branch-button-win.png) -{% data reusables.desktop.name-branch %} - ![新しいブランチの名前を作成するフィールド](/assets/images/help/desktop/create-branch-name-win.png) -{% data reusables.desktop.select-base-branch %} - ![ベースブランチのオプション](/assets/images/help/desktop/create-branch-choose-branch-win.png) -{% data reusables.desktop.confirm-new-branch-button %} - ![Create branchボタン](/assets/images/help/desktop/create-branch-button-win.png) - -{% endwindows %} - -### ブランチ間の切り替え -リポジトリのどんなブランチに対しても、コミットを表示したり、コミットを行ったりすることができます。 まだコミットしていない、保存した変更がある場合は、その変更の扱いについて、ブランチを切り替える前に決める必要があります。 現在のブランチに変更をコミットする、現在のブランチに変更を stash する、または変更を新しいブランチに移動することが可能です。 変更を現在のブランチにコミットしたい場合は、ブランチを切り替える前に、「[プロジェクトへの変更をコミットまたはレビューする](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project)」の手順に従ってください。 - -{% tip %} - -**Tip**: **Advanced（高度）**な設定で、ブランチの切り替え時のデフォルトの動作を設定できます。 For more information, see "[Configuring basic settings](/desktop/getting-started-with-github-desktop/configuring-basic-settings)." - -{% endtip %} - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.switching-between-branches %} - ![リポジトリ内ブランチのリスト](/assets/images/help/desktop/click-branch-in-drop-down-mac.png) -3. 保存していて、まだコミットしていない変更がある場合は、[**Leave my changes**] または [**Bring my changes**] を選択してから、[**Switch Branch**] をクリックしてください。 ![[Switch branch] と変更オプション](/assets/images/help/desktop/stash-changes-options.png) - -### stash した変更を取得する -他のブランチで stash した変更にアクセスするには、変更を stash したブランチに切り替えます。 - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.switching-between-branches %} - ![リポジトリ内ブランチのリスト](/assets/images/help/desktop/click-branch-in-drop-down-mac.png) -3. 左サイドバーで [**Stashed Changes**] をクリックします。 ![[Stash changes] オプション](/assets/images/help/desktop/stashed-changes.png) -4. stash した変更を削除するには、[**Discard**] をクリックします。stash した変更を利用するには、[**Restore**] をクリックします。 ![stash した変更の [Discard] または [Restore]](/assets/images/help/desktop/discard-restore-stash-buttons.png) - -### ブランチの削除 - -現時点でブランチがオープンなプルリクエストに関連付けられている場合は、ブランチを削除できません。 You cannot undo deleting a branch. - -{% mac %} - -{% data reusables.desktop.select-branch-to-delete %} - ![Drop-down menu to select which branch to delete](/assets/images/help/desktop/select-branch-to-delete.png) -{% data reusables.desktop.delete-branch-mac %} - ![Delete... option in the Branch menu](/assets/images/help/desktop/delete-branch-mac.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.select-branch-to-delete %} - ![Drop-down menu to select which branch to delete](/assets/images/help/desktop/select-branch-to-delete.png) -{% data reusables.desktop.delete-branch-win %} - ![Delete... option in the Branch menu](/assets/images/help/desktop/delete-branch-win.png) - -{% endwindows %} - -### 参考リンク - -- 「[{% data variables.product.prodname_desktop %}からのリポジトリのクローン方法](/desktop/guides/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop)」 -- {% data variables.product.prodname_dotcom %} 用語集中の[ブランチ](/articles/github-glossary/#branch) -- [ブランチについて](/articles/about-branches) -- Gitのドキュメンテーション中の[ブランチの要約](https://git-scm.com/book/en/v2/Git-Branching-Branches-in-a-Nutshell) diff --git a/translations/ja-JP/content/desktop/contributing-to-projects/managing-tags.md b/translations/ja-JP/content/desktop/contributing-to-projects/managing-tags.md deleted file mode 100644 index 4442c10fdcfa..000000000000 --- a/translations/ja-JP/content/desktop/contributing-to-projects/managing-tags.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: Managing tags -intro: 'You can use {% data variables.product.prodname_desktop %} to create, push, and view tags.' -versions: - free-pro-team: '*' ---- - -### About tags in {% data variables.product.prodname_desktop %} - -{% data variables.product.prodname_desktop %} allows you to create annotated tags. You can use a tag to mark an individual point in your repository's history, including a version number for a release. For more information about release tags, see "[About releases](https://help.github.com/en/github/administering-a-repository/about-releases)." - -{% data reusables.desktop.tags-push-with-commits %} - -### Creating a tag - -{% data reusables.desktop.history-tab %} -{% data reusables.desktop.create-tag %} -{% data reusables.desktop.name-tag %} -{% data reusables.desktop.confirm-tag %} - -### タグを表示する - -{% data reusables.desktop.history-tab %} -2. Click the commit. - {% note %} - - **Note**: {% data variables.product.prodname_desktop %} displays an arrow {% octicon "arrow-up" aria-label="The up arrow icon" %} if the tag has not been pushed to the remote repository. - - {% endnote %} - - ![Viewing a tag in the history](/assets/images/help/desktop/viewing-tags-in-history.png) - -3. All tags associated with the commit are visible in that commit's metadata. ![Viewing a tag in the commit](/assets/images/help/desktop/viewing-tags-in-commit.png) diff --git a/translations/ja-JP/content/desktop/contributing-to-projects/pushing-changes-to-github.md b/translations/ja-JP/content/desktop/contributing-to-projects/pushing-changes-to-github.md deleted file mode 100644 index 60b914518189..000000000000 --- a/translations/ja-JP/content/desktop/contributing-to-projects/pushing-changes-to-github.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Pushing changes to GitHub -shortTitle: Pushing changes -intro: 'As you commit changes to your project locally, you can push those changes to {% data variables.product.prodname_dotcom %} so that others may access them from the remote repository.' -permissions: People with write permissions can push changes to a repository. -versions: - free-pro-team: '*' ---- - -### About pushing changes to {% data variables.product.prodname_dotcom %} - -When you push changes, you send the committed changes in your local repository to the remote repository on {% data variables.product.prodname_dotcom %}. If you change your project locally and want other people to have access to the changes, you must push the changes to {% data variables.product.prodname_dotcom %}. - -Before pushing changes, you should update your local branch to include any commits that have been added to the remote repository. If someone has made commits on the remote that are not on your local branch, {% data variables.product.prodname_desktop %} will prompt you to fetch the new commits before pushing your changes to avoid merge conflicts. For more information, see "[Syncing your branch](/desktop/contributing-to-projects/syncing-your-branch)." - -{% data reusables.desktop.protected-branches %} - -### Pushing changes to {% data variables.product.prodname_dotcom %} - -{% note %} - -**Note:** {% data variables.product.prodname_desktop %} will reject a push if it exceeds certain limits. - -- A push contains a large file over 100MB in size. -- A push is over 2GB in total size. - -{% endnote %} - -{% data reusables.desktop.push-origin %} -2. If {% data variables.product.prodname_desktop %} prompts you to fetch new commits from the remote, click **Fetch**. ![The Fetch button](/assets/images/help/desktop/fetch-newer-commits.png) -3. Optionally, click **Create Pull Request** to open a pull request and collaborate on your changes. For more information, see "[Creating an issue or pull request](/desktop/contributing-to-projects/creating-an-issue-or-pull-request)" ![The Create Pull Request button](/assets/images/help/desktop/create-pull-request.png) - -### 参考リンク -- "[Push](/github/getting-started-with-github/github-glossary/#push)" in the {% data variables.product.prodname_dotcom %} glossary -- "[Committing and reviewing changes to your project](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project)" diff --git a/translations/ja-JP/content/desktop/contributing-to-projects/reverting-a-commit.md b/translations/ja-JP/content/desktop/contributing-to-projects/reverting-a-commit.md deleted file mode 100644 index 6ac59997f3da..000000000000 --- a/translations/ja-JP/content/desktop/contributing-to-projects/reverting-a-commit.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: コミットの打ち消し -intro: 特定のコミットを打ち消して、その変更をブランチから取り除くことができます。 -versions: - free-pro-team: '*' ---- - -コミットを打ち消しすると、打ち消し自体もコミットになります。 元のコミットもリポジトリの履歴に残ります。 - -{% tip %} - -**ヒント：**複数のコミットを打ち消しするときは、最新のコミットから最古のコミットまでの順で打ち消しするのがお勧めです。 別の順番でコミットを打ち消しすると、マージコンフリクトが発生する場合があります。 - -{% endtip %} - -{% mac %} - -{% data reusables.desktop.history-tab %} -{% data reusables.desktop.revert-commit %} - ![Diffビューの上にあるRevertオプション](/assets/images/help/desktop/commit-revert-mac.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.history-tab %} -{% data reusables.desktop.revert-commit %} - ![Diffビューの上にあるRevertオプション](/assets/images/help/desktop/commit-revert-win.png) - -{% endwindows %} diff --git a/translations/ja-JP/content/desktop/contributing-to-projects/switching-between-branches.md b/translations/ja-JP/content/desktop/contributing-to-projects/switching-between-branches.md deleted file mode 100644 index a54ffcf16966..000000000000 --- a/translations/ja-JP/content/desktop/contributing-to-projects/switching-between-branches.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: ブランチ間の切り替え -intro: リポジトリのどんなブランチに対しても、コミットを表示したり、コミットを行ったりすることができます。 -versions: - free-pro-team: '*' ---- - -### ブランチ間の切り替え -まだコミットしていない、保存した変更がある場合は、その変更の扱いについて、ブランチを切り替える前に決める必要があります。 現在のブランチに変更をコミットする、現在のブランチに変更を stash する、または変更を新しいブランチに移動することが可能です。 変更を現在のブランチにコミットしたい場合は、ブランチを切り替える前に、「[プロジェクトへの変更をコミットまたはレビューする](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project)」の手順に従ってください。 - -{% tip %} - -**Tip**: **Advanced（高度）**な設定で、ブランチの切り替え時のデフォルトの動作を設定できます。 詳しい情報については「[基本的な設定](/desktop/getting-started-with-github-desktop/configuring-basic-settings)」を参照してください。 - -{% endtip %} - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.switching-between-branches %} - ![リポジトリ内ブランチのリスト](/assets/images/help/desktop/click-branch-in-drop-down-mac.png) -3. 保存していて、まだコミットしていない変更がある場合は、[**Leave my changes**] または [**Bring my changes**] を選択してから、[**Switch Branch**] をクリックしてください。 ![[Switch branch] と変更オプション](/assets/images/help/desktop/stash-changes-options.png) - -### stash した変更を取得する -他のブランチで stash した変更にアクセスするには、変更を stash したブランチに切り替えます。 - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.switching-between-branches %} - ![リポジトリ内ブランチのリスト](/assets/images/help/desktop/click-branch-in-drop-down-mac.png) -3. 左サイドバーで [**Stashed Changes**] をクリックします。 ![[Stash changes] オプション](/assets/images/help/desktop/stashed-changes.png) -4. stash した変更を削除するには、[**Discard**] をクリックします。stash した変更を利用するには、[**Restore**] をクリックします。 ![stash した変更の [Discard] または [Restore]](/assets/images/help/desktop/discard-restore-stash-buttons.png) diff --git a/translations/ja-JP/content/desktop/contributing-to-projects/syncing-your-branch.md b/translations/ja-JP/content/desktop/contributing-to-projects/syncing-your-branch.md deleted file mode 100644 index 1dd0a6fd492a..000000000000 --- a/translations/ja-JP/content/desktop/contributing-to-projects/syncing-your-branch.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: ブランチの同期 -intro: '{% data variables.product.prodname_dotcom %}にあるプロジェクトにコミットをプッシュしていくと、ローカルコピーをリモートリポジトリと同期させることができます。' -versions: - free-pro-team: '*' ---- - -最初に[ブランチを作成](/desktop/guides/contributing-to-projects/managing-branches)して以降追加されたコミットを、取得するには、ローカルブランチをリモートリポジトリと同期する必要があります。 - -### ローカルブランチの更新方法 - -1. {% data variables.product.prodname_desktop %}で、{% octicon "git-branch" aria-label="The branch icon" %}**Current Branch**をクリックし、リストからブランチを選択して更新するローカルブランチに切り替えます。 -2. ブランチを更新するには**Fetch origin**をクリックします。 ![Fetch originボタン](/assets/images/help/desktop/fetch-button.png) -3. リモートブランチにコミットがある場合、[**Pull origin**] または [**Pull origin with rebase**] をクリックすることでそれらをプルできます。 ![[Pull origin] ボタン](/assets/images/help/desktop/pull-button.png) -{% data reusables.desktop.resolve-merge-conflicts %} - -### プロジェクトブランチへの他のブランチのマージ方法 - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.choose-a-branch-to-merge %} -{% data reusables.desktop.confirm-merging-branch %} - - {% note %} - - **注釈：**マージコンフリクトがある場合、{% data variables.product.prodname_desktop %}は**Merge BRANCH into BRANCH**ボタンの上に警告を表示します。 全てのコンフリクトを解決するまではブランチをマージすることはできません。 - - {% endnote %} - - ![Mergeボタン](/assets/images/help/desktop/merge-branch-button.png) -{% data reusables.desktop.push-origin %} - -### プロジェクトブランチを他のブランチにリベースする -ワークフローによっては、マージではなくリベースが必要または役立つ場合があります。 リベースすることで、コミットの順序を変更したり、編集したり、まとめて squash したりできます。 詳細は「[Git のリベースについて](/articles/about-git-rebase)」を参照してください。 - -1. [**Branch**] ドロップダウンメニューで、[**Rebase Current Branch**] をクリックします。 ![ブランチのドロップダウンメニューにある [Rebase Current Branch]](/assets/images/help/desktop/rebase-current-branch.png) -2. 現在のブランチにリベースしたいブランチをクリックし、[**Start rebase**] をクリックします。 ![[Start rebase] ボタン](/assets/images/help/desktop/start-rebase-button.png) -3. リベースしたい場合は、[**Begin rebase**] をクリックします。 ![[Begin rebase] ボタン](/assets/images/help/desktop/begin-rebase-button.png) -{% data reusables.desktop.resolve-merge-conflicts %} -4. ローカルの変更をプッシュするには、[**Force push origin**] をクリックします。 ![[Force push origin]](/assets/images/help/desktop/force-push-origin.png) diff --git a/translations/ja-JP/content/desktop/contributing-to-projects/viewing-the-branch-history.md b/translations/ja-JP/content/desktop/contributing-to-projects/viewing-the-branch-history.md deleted file mode 100644 index 5ce14623611d..000000000000 --- a/translations/ja-JP/content/desktop/contributing-to-projects/viewing-the-branch-history.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: ブランチ履歴の表示 -intro: '{% data variables.product.prodname_desktop %}内の任意のコミットに関する詳細を見ることができます。これにはコミットによる変更のdiffが含まれます。' -versions: - free-pro-team: '*' ---- - -各コミットには次の情報が含まれています。 - - - コミットメッセージ - - コミットが作成された時間 - - コミットしたユーザの名前と（利用可能な場合）プロフィール画像 - - コミットのSHA-1ハッシュ（固有のID） - -{% data reusables.desktop.history-tab %} -2. **History**タブで、確認するコミットをクリックします。 ![Historyタブのコミット](/assets/images/help/desktop/branch-history-commit.png) -3. コミットに複数のファイルがある場合、個別のファイルをクリックすると、そのコミットのそのファイルに加えられた変更が表示されます。 ![コミット内のファイル](/assets/images/help/desktop/branch-history-file.png) - -### 参考リンク - -- 「[ブランチの同期](/desktop/guides/contributing-to-projects/syncing-your-branch/)」 diff --git a/translations/ja-JP/content/desktop/contributing-to-projects/working-with-your-remote-repository-on-github-or-github-enterprise.md b/translations/ja-JP/content/desktop/contributing-to-projects/working-with-your-remote-repository-on-github-or-github-enterprise.md deleted file mode 100644 index 23ec022ab5df..000000000000 --- a/translations/ja-JP/content/desktop/contributing-to-projects/working-with-your-remote-repository-on-github-or-github-enterprise.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: GitHub、またはGitHub Enterpriseでのリモートリポジトリの操作 -intro: 'ローカルでプロジェクトに変更を加えていくと、リモートリポジトリと同期できます。 Gitでは、「リモート」とは、コードが保管されているサーバーのことです。 あなたの場合、サーバーは、{% data variables.product.prodname_dotcom %}、または{% data variables.product.prodname_enterprise %}にあるリポジトリです。' -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/about-the-github-desktop-windows-installer-package.md b/translations/ja-JP/content/desktop/getting-started-with-github-desktop/about-the-github-desktop-windows-installer-package.md deleted file mode 100644 index 5dbe08c6989d..000000000000 --- a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/about-the-github-desktop-windows-installer-package.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: GitHub Desktop Windowsインストーラーパッケージについて -intro: 'ネットワークの管理者として、グループポリシー、または他の遠隔インストールシステムを介してWindowsのインストーラーパッケージファイル（「.msi」）を使用することによって、Active Directory管理ネットワークでMicrosoft Windowsが作動しているコンピュータに{% data variables.product.prodname_desktop %}を展開できます。' -versions: - free-pro-team: '*' ---- - -Windowsインストーラーパッケージは、単独のインストーラー（`.exe`）を抽出し、ユーザが今度ワークステーションにサインインしたとき、{% data variables.product.prodname_desktop %}がインストールされるようにWindowsを設定します。 ユーザがユーザディレクトリに{% data variables.product.prodname_desktop %}をインストールするには、権限が必要です。 - -ユーザが{% data variables.product.prodname_desktop %}Windowsインストーラーを直接実行する場合、インストールを完了するにはワークステーションからサインアウトして、再びワークステーションにさサインインする必要があります。 diff --git a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/authenticating-to-github.md b/translations/ja-JP/content/desktop/getting-started-with-github-desktop/authenticating-to-github.md deleted file mode 100644 index af363422dcd9..000000000000 --- a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/authenticating-to-github.md +++ /dev/null @@ -1,65 +0,0 @@ ---- -title: GitHubへの認証方法 -intro: '{% data variables.product.product_name %}アカウントを{% data variables.product.prodname_desktop %}に接続してください。' -redirect_from: - - /desktop/getting-started-with-github-desktop/authenticating-to-github-using-the-browser -versions: - free-pro-team: '*' ---- - -認証する前には、{% data reusables.desktop.get-an-account %} - -{% mac %} - -### Authenticating to {% data variables.product.prodname_dotcom %} using the browser - -{% data reusables.desktop.mac-select-desktop-menu %} -{% data reusables.desktop.mac-select-accounts %} -4. To the right of "{% data variables.product.prodname_dotcom %}," click **Sign In**. ![GitHubのサインインボタン](/assets/images/help/desktop/mac-sign-in-github.png) -5. サインインペインで、**Sign in using your browser**をクリックします。 ![ブラウザリンク経由でのサインイン](/assets/images/help/desktop/mac-sign-in-browser.png) -{% data reusables.desktop.authenticate-in-browser %} -{% data reusables.desktop.retrieve-2fa-in-browser %} -{% data reusables.desktop.enter-2fa-in-browser %} -9. {% data variables.product.prodname_dotcom %}にアカウントが認証されたら、{% data variables.product.prodname_desktop %}に戻ります。 - -### Authenticating to {% data variables.product.prodname_dotcom %} using your username and password - -{% data reusables.user_settings.password-authentication-deprecation-desktop %} - -{% data reusables.desktop.mac-select-desktop-menu %} -{% data reusables.desktop.mac-select-accounts %} -{% data reusables.desktop.choose-product-authenticate %} -5. GitHub Enterpriseアカウントを追加するには、「Enterprise server address」のところに認証情報を入力して**Continue**をクリックします。 ![GitHub EnterpriseのSign Inボタン](/assets/images/help/desktop/mac-sign-in-button-enterprise.png) -6. GitHubアカウントを追加するには、GitHub.comの認証情報を入力して、**Sign in**をクリックします。 ![GitHubのサインインボタン](/assets/images/help/desktop/mac-sign-in-button.png) -{% data reusables.desktop.retrieve-2fa %} -{% data reusables.desktop.return-to-desktop %} プロンプトに 2 要素認証コードを入力して [**Sign in**] をクリックします。 ![2FAコードのプロンプト](/assets/images/help/desktop/mac-2fa-code-prompt.png) - -{% endmac %} - -{% windows %} - -### Authenticating to {% data variables.product.prodname_dotcom %} using the browser - -{% data reusables.desktop.windows-choose-options %} -{% data reusables.desktop.windows-select-accounts %} -4. To the right of "GitHub.com," click **Sign in**. ![GitHubのサインインボタン](/assets/images/help/desktop/windows-sign-in-github.png) -5. サインインペインで、**Sign in using your browser**をクリックします。 ![ブラウザリンク経由でのサインイン](/assets/images/help/desktop/windows-sign-in-browser.png) -{% data reusables.desktop.authenticate-in-browser %} -{% data reusables.desktop.retrieve-2fa-in-browser %} -{% data reusables.desktop.enter-2fa-in-browser %} -9. {% data variables.product.prodname_dotcom %}にアカウントが認証されたら、{% data variables.product.prodname_desktop %}に戻ります。 - -### Authenticating to {% data variables.product.prodname_dotcom %} using your username and password - - -{% data reusables.user_settings.password-authentication-deprecation-desktop %} - -{% data reusables.desktop.windows-choose-options %} -{% data reusables.desktop.windows-select-accounts %} -{% data reusables.desktop.choose-product-authenticate %} -5. GitHub Enterpriseアカウントを追加するには、「Enterprise server address」のところに認証情報を入力して**Continue**をクリックします。 ![GitHub EnterpriseのSign Inボタン](/assets/images/help/desktop/windows-sign-in-button-enterprise.png) -6. GitHubアカウントを追加するには、GitHub.comの認証情報を入力して、**Sign in**をクリックします。 ![GitHubのサインインボタン](/assets/images/help/desktop/windows-sign-in-button.png) -{% data reusables.desktop.retrieve-2fa %} -{% data reusables.desktop.return-to-desktop %} プロンプトに 2 要素認証コードを入力して [**Sign in**] をクリックします。 ![2FAコードのプロンプト](/assets/images/help/desktop/windows-2fa-code-prompt.png) - -{% endwindows %} diff --git a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/configuring-a-default-editor.md b/translations/ja-JP/content/desktop/getting-started-with-github-desktop/configuring-a-default-editor.md deleted file mode 100644 index e5d4e907d236..000000000000 --- a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/configuring-a-default-editor.md +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: デフォルトエディタの設定方法 -intro: You can configure GitHub Desktop to open files in your project with your preferred text editor or integrated development environment (IDE). -versions: - free-pro-team: '*' ---- - -### Supported editors - -{% data variables.product.prodname_desktop %} supports the following editors. - -{% mac %} - -- [Atom](https://atom.io/) -- [MacVim](https://macvim-dev.github.io/macvim/) -- [Visual Studio Code](https://code.visualstudio.com/) -- [Visual Studio Codium](https://vscodium.com/) -- [Sublime Text](https://www.sublimetext.com/) -- [BBEdit](http://www.barebones.com/products/bbedit/) -- [JetBrains WebStorm](https://www.jetbrains.com/webstorm/) -- [JetBrains PhpStorm](https://www.jetbrains.com/phpstorm/) -- [JetBrains Rider](https://www.jetbrains.com/rider/) -- [JetBrains PyCharm](https://www.jetbrains.com/pycharm/) -- [JetBrains RubyMine](https://www.jetbrains.com/rubymine/) -- [JetBrains IntelliJ IDEA](https://www.jetbrains.com/idea/) -- [JetBrains GoLand](https://www.jetbrains.com/go/) -- [TextMate](https://macromates.com/) -- [Brackets](http://brackets.io/) - - To use Brackets with {% data variables.product.prodname_desktop %}, you must install the Command Line shortcut. To install the shortcut, open Brackets, click **File** in the menu bar, then click **Install Command Line Shortcut**. -- [Typora](https://typora.io/) -- [CodeRunner](https://coderunnerapp.com/) -- [SlickEdit](https://www.slickedit.com/) -- [Xcode](https://developer.apple.com/xcode/) -- [Android Studio](https://developer.android.com/studio) - -{% endmac %} - -{% windows %} - -- [Atom](https://atom.io/) -- [Visual Studio Code](https://code.visualstudio.com/) -- [Visual Studio Codium](https://vscodium.com/) -- [Sublime Text](https://www.sublimetext.com/) -- [ColdFusion Builder](https://www.adobe.com/products/coldfusion-builder.html) -- [Typora](https://typora.io/) -- [SlickEdit](https://www.slickedit.com/) -- [JetBrains WebStorm](https://www.jetbrains.com/webstorm/) -- [JetBrains PhpStorm](https://www.jetbrains.com/phpstorm/) -- [JetBrains Rider](https://www.jetbrains.com/rider/) -- [Notepad++](https://notepad-plus-plus.org/) - -{% endwindows %} - -### デフォルトエディタの設定方法 - -{% mac %} - -{% data reusables.desktop.mac-select-desktop-menu %} -3. Preferences（環境設定）ウィンドウで** Integrations（インテグレーション）**を選択してください。 ![環境設定ウィンドウのインテグレーションペイン](/assets/images/help/desktop/mac-select-integrations-pane.png) -4. Use the "External Editor" drop-down menu, and choose the editor you want to set as your default. ![Preferencesメニューバー内のExternal editorメニュー](/assets/images/help/desktop/mac-editor-menu.png) -5. **Save**をクリックします。 - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.windows-choose-options %} -3. Options（オプション）ウィンドウで** Integrations（インテグレーション）**を選択してください。 ![オプションウィンドウのインテグレーションペイン](/assets/images/help/desktop/windows-select-integrations-pane.png) -4. Use the "External Editor" drop-down menu, and choose the editor you want to set as your default. ![Optionsメニューバー内のExternal editorメニュー](/assets/images/help/desktop/windows-editor-menu.png) -5. **Save**をクリックします。 - -{% endwindows %} diff --git a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/configuring-and-customizing-github-desktop.md b/translations/ja-JP/content/desktop/getting-started-with-github-desktop/configuring-and-customizing-github-desktop.md deleted file mode 100644 index 1fe9d29f891e..000000000000 --- a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/configuring-and-customizing-github-desktop.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: GitHub Desktopの設定とカスタマイズ -intro: Gitをセットアップし、デフォルトのエディタに接続し、GitHub Desktopをワークフローに適合させるために設定をカスタマイズしてください。 -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/configuring-basic-settings.md b/translations/ja-JP/content/desktop/getting-started-with-github-desktop/configuring-basic-settings.md deleted file mode 100644 index e88eb3a4f808..000000000000 --- a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/configuring-basic-settings.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: ベーシック設定 -intro: プライバシー保護、アカウントのGitHub Desktopへの関連付け、およびGit構成のための設定にアクセスできます。 -versions: - free-pro-team: '*' ---- - -{% mac %} - -{% data reusables.desktop.mac-select-desktop-menu %} -3. 設定の表示、または変更をするには、次のペイン間を切り替えます。 ![Preferencesメニューのナビゲーション](/assets/images/help/desktop/mac-select-accounts-pane.png) -{% data reusables.desktop.preferences-options-tabs %} - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.windows-choose-options %} -2. 設定の表示、または変更をするには、次のペイン間を切り替えます。 ![Optionsメニューのナビゲーション](/assets/images/help/desktop/windows-select-accounts-pane.png) -{% data reusables.desktop.preferences-options-tabs %} - -{% endwindows %} - -### 参考リンク - -- "[{% data variables.product.prodname_desktop %}用のテーマの設定方法](/desktop/guides/getting-started-with-github-desktop/setting-a-theme-for-github-desktop)" diff --git a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/configuring-git-for-github-desktop.md b/translations/ja-JP/content/desktop/getting-started-with-github-desktop/configuring-git-for-github-desktop.md deleted file mode 100644 index b7a76af97128..000000000000 --- a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/configuring-git-for-github-desktop.md +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: GitHub Desktop用のGitの設定方法 -shortTitle: Configuring Git -intro: Gitをまだインストールしていない場合、GitHub Desktopを使う前にGitを設定する必要があります。 -versions: - free-pro-team: '*' ---- - -{% data variables.product.prodname_desktop %} uses the email address you set in your local Git configuration to connect commits with your account on {% data variables.product.product_name %}. - -{% data reusables.desktop.update-email-address %} - -{% tip %} - -**Tip**: 公開コミットをした場合、Gitコンフィグレーションにあるメールアドレスは皆に表示されます。 詳詳細は「[コミットメールアドレスを設定する](/articles/setting-your-commit-email-address/)」を参照してください。 - -{% endtip %} - -{% mac %} - -{% data reusables.desktop.sign-in-choose-product %} -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.emails %} -{% data reusables.desktop.copy-email-git-config %} -{% data reusables.desktop.return-to-desktop %} -{% data reusables.desktop.mac-select-desktop-menu %} -7. In the Preferences window, click **Git**. ![[Preferences] メニュー内の Git ペイン](/assets/images/help/desktop/mac-select-git-pane.png) -{% data reusables.desktop.name-field-git-config %} - ![Git コンフィグレーション内の [Name] フィールド](/assets/images/help/desktop/mac-name-git-config.png) -{% data reusables.desktop.paste-email-git-config %} - ![Gitコンフィグレーションフィールドに貼り付けられたEメールアドレス](/assets/images/help/desktop/mac-email-git-config.png) -{% data reusables.desktop.click-save-git-config %} - ![Save button in Git configuration field](/assets/images/help/desktop/mac-save-git-config.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.sign-in-choose-product %} -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.emails %} -{% data reusables.desktop.copy-email-git-config %} -{% data reusables.desktop.return-to-desktop %} -{% data reusables.desktop.windows-choose-options %} -8. In the Options window, click **Git**. ![[Options] メニュー内の Git ペイン](/assets/images/help/desktop/windows-select-git-pane.png) -{% data reusables.desktop.name-field-git-config %} - ![Git コンフィグレーション内の [Name] フィールド](/assets/images/help/desktop/windows-name-git-config.png) -{% data reusables.desktop.paste-email-git-config %} - ![Gitコンフィグレーションフィールドに貼り付けられたEメールアドレス](/assets/images/help/desktop/windows-email-git-config.png) -{% data reusables.desktop.click-save-git-config %} - ![Save button in Git configuration field](/assets/images/help/desktop/windows-save-git-config.png) - -{% endwindows %} - -### 参考リンク - -- "[GitHubアカウントへのEメールアドレスの追加](/articles/adding-an-email-address-to-your-github-account/)" -- [コミットメールアドレスを設定する](/articles/setting-your-commit-email-address/) diff --git a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/creating-your-first-repository-using-github-desktop.md b/translations/ja-JP/content/desktop/getting-started-with-github-desktop/creating-your-first-repository-using-github-desktop.md deleted file mode 100644 index 354f0287bbc8..000000000000 --- a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/creating-your-first-repository-using-github-desktop.md +++ /dev/null @@ -1,98 +0,0 @@ ---- -title: GitHub Desktop を使った最初のリポジトリ作成方法 -intro: '{% data variables.product.prodname_desktop %} を使って、コマンドラインを使わずに素早く Git リポジトリで作業できます。' -versions: - free-pro-team: '*' ---- - -### はじめに - -このガイドは、{% data variables.product.prodname_desktop %} を使って Git リポジトリで作業する手順を一通り案内します。 {% data variables.product.prodname_desktop %} は、コマンドライン上でテキストコマンドを使うのではなく、ビジュアルインターフェースを使って、あなたの {% data variables.product.prodname_dotcom_the_website %} ワークフローを拡張し簡略化します。 このガイドが終わるまでに、{% data variables.product.prodname_desktop %} でリポジトリを作成し、リポジトリで変更を行い、{% data variables.product.prodname_dotcom_the_website %} または {% data variables.product.prodname_ghe_server %} に変更を公開することになります。 - -{% data variables.product.prodname_desktop %} をダウンロードし、{% data variables.product.prodname_dotcom %} または {% data variables.product.prodname_enterprise %} にサインインした後は、チュートリアルリポジトリを作成およびクローンできます。 チュートリアルは、エディタのインストール、コミットの作成、{% data variables.product.prodname_dotcom_the_website %} へのプッシュ、プルリクエストの作成など、Git および {% data variables.product.prodname_dotcom %} で作業するための基本を紹介します。 チュートリアルは、{% data variables.product.prodname_desktop %} にリポジトリが存在しない状態である限り利用できます。 - -### ステップ 1. {% data variables.product.prodname_desktop %} のインストールとサインイン - -1. {% data variables.product.desktop_link %} から {% data variables.product.prodname_desktop %} をダウンロードします。 {% data variables.product.prodname_desktop %} は、 Windows および macOS の最新バージョンをサポートしています。 お手持ちのオペレーティングシステムにインストールする具体的な方法の詳細は「[Installing {% data variables.product.prodname_desktop %} をインストールする](/desktop/getting-started-with-github-desktop/installing-github-desktop)」を参照してください。 - -2. {% data variables.product.prodname_desktop %} を起動し、画面に表示される手順に従って {% data variables.product.product_name %} アカウントにサインインします。 [Configure Git] ステップが表示されるので、そこで名前とメールアドレスを設定してください。 コミットが {% data variables.product.product_name %} アカウントに確実に関連付けられるようにするため、あなたの {% data variables.product.product_name %} アカウントに関連付けられたメールアドレスを使います。 コミットの属性付けに関する詳細は「[コミットメールアドレスを設定する](/articles/setting-your-commit-email-address)」を参照してください。 - -### ステップ 2. 新しいリポジトリの作成 - -[Let's get started!] ビューが表示され、チュートリアルリポジトリの作成とクローン、既存のリポジトリをクローン、新しいリポジトリの作成、既存のリポジトリの追加を選択できます。 - -#### チュートリアルリポジトリの作成とクローン - -1. [**Create a tutorial repository and clone it**] をクリックします。 ![[Create and clone a tutorial repository] ボタン](/assets/images/help/desktop/getting-started-guide/create-and-clone-a-tutorial-repository.png) -2. チュートリアルのプロンプトに従います。 - -#### 新しいリポジトリの作成 - -1. [**Create a New Repository on your Hard Drive...**] をクリックします。 ![新しいリポジトリの作成](/assets/images/help/desktop/getting-started-guide/creating-a-repository.png) -2. 新しいリポジトリを作成するには、以下のフィールドに入力します: ![リポジトリの作成オプション](/assets/images/help/desktop/getting-started-guide/create-a-new-repository-options.png) - - [Name] は、ローカルと {% data variables.product.product_name %} の両方で使う、リポジトリの名前を定義します。 - - [Description] はオプションのフィールドで、リポジトリの目的に関する情報を提供するために使うことができます。 - - [Local path] は、お手元のコンピューターにおけるリポジトリの場所を設定します。 デフォルトでは、{% data variables.product.prodname_desktop %} は _Documents_ フォルダの中に_GitHub_ フォルダを作成して、そこにリポジトリを保存しますが、保存するフォルダは任意の場所に設定可能です。 新しいリポジトリは、選択した場所の中のフォルダになります。 たとえば、リポジトリに `Tutorial` と名付けた場合、選択したローカルパスのフォルダの中に _Tutorial_ という名前のフォルダが作成されます。 {% data variables.product.prodname_desktop %} は、次に新しいリポジトリをクローンするか作成するときに、選択した場所を記憶します。 - - [**Initialize this repository with a README**] は、最初のコミットを _README.md_ ファイル付きで作成します。 README は、人々がプロジェクトの目的を理解するために役立つので、これを選択して、README に役立つ情報を記載することをおすすめします。 {% data variables.product.product_name %} でリポジトリにアクセスした人は、まず README を読んで、そのプロジェクトについて知ります。 詳細は「[README について](/articles/about-readmes)」を参照してください。 - - [**Git ignore**] ドロップダウンメニューは、バージョン管理で保存したくない、ローカルリポジトリ内で無視するファイルを指定するためのカスタムファイルを追加します。 特定の言語やフレームワークを使っている場合、利用できるリストからオプションを選択できます。 まだ始めたばかりの場合は、この選択について無視して構いません。 詳細は「[ファイルを無視する](/articles/ignoring-files)」を参照してください。 - - [**License**] ドロップダウンメニューは、リポジトリの _LICENSE_ ファイルにオープンソースライセンスを追加します。 ライセンスをすぐに追加する必要はありません。 利用可能なオープンソースライセンスと、それらをリポジトリに追加する方法についての詳細は「[リポジトリのライセンス](/articles/licensing-a-repository)」を参照してください。 -3. [**Create repository**] をクリックします。 - -### ステップ 3. {% data variables.product.prodname_desktop %} を探索する - -リポジトリを作成したので、画面上部にファイルメニューが表示されます。 この画面で、{% data variables.product.prodname_desktop %} の設定や実行可能なアクションにアクセスできます。 作業の効率化のため、ほとんどのアクションにはキーボードショートカットも設定されています。 For a full list of keyboard shortcuts, see "[Keyboard shortcuts](/desktop/getting-started-with-github-desktop/keyboard-shortcuts)." - -1. 以下のメニューは、{% data variables.product.prodname_desktop %} におけるリポジトリの現在の状態を示すバーです: - - [**Current repository**] では、現在作業中のリポジトリ名が表示されます。 [**Current repository**] をクリックすると、{% data variables.product.prodname_desktop %} の別のリポジトリに切り替えることができます。 - - [**Current branch**] では、作業中のブランチ名が表示されます。 [**Current branch**] をクリックすると、リポジトリ内のすべてのブランチの表示、別のブランチへの切り替え、新しいブランチの作成ができます。 リポジトリにプルリクエストを作成すると、[**Current branch**] をクリックしてプルリクエストを表示することもできます。 - - [**Publish repository**] が表示されるのは、まだリポジトリを {% data variables.product.product_name %} に公開していないためです。これについては、次のステップで扱います。 - - ![GitHub Desktop を探索する](/assets/images/help/desktop/getting-started-guide/explore-github-desktop.png) - -2. 左サイドバーには、[**Changes**] ビューと [**History**] ビューが表示されています。 - - - [**Changes**] ビューは、現在のブランチで変更を行い、まだローカルリポジトリにコミットしていないファイルが表示されます。 ビューの下部には、[Summary] および [Description] テキストボックスと、[**Commit to master**] ボタンもあります。 これが、新しい変更をコミットする場所です。 [**Commit**] ボタンは、変更をどのブランチにコミットしようとしているのかを知らせます。 ![コミットエリア](/assets/images/help/desktop/getting-started-guide/commit-area.png) - - - [**History**] ビューには、リポジトリの現在のブランチにおける以前のコミットが表示されます。 リポジトリを作成したときに、{% data variables.product.prodname_desktop %} によって作成された「最初のコミット」が表示されているはずです。 そのコミットの右側に、リポジトリを作成したときのオプションによっては、_.gitattributes_、_.gitignore_、_LICENSE_、_README_ ファイルが表示されているかもしれません。 各ファイルをクリックすると、そのファイルの diff が表示できます。これは、コミットでファイルに行った変更を示すものです。 diff には、ファイル全体の内容ではなく、変更を行った部分のみが表示されます。 ![[History] ビュー](/assets/images/help/desktop/getting-started-guide/history-view.png) - -### ステップ 4. リポジトリの {% data variables.product.product_name %} へのプッシュ - -現在のところ、あなたのリポジトリはお手元のコンピューターにのみ存在しており、そのリポジトリにアクセスできるのはあなただけです。 リポジトリを {% data variables.product.product_name %} に公開することで、同じプロジェクトに属する複数のコンピューターやチームメンバー間で同期を保つことができます。 リポジトリを公開するには、{% data variables.product.product_name %} にプッシュします。そうすると、{% data variables.product.prodname_dotcom_the_website %} でも利用できるようになります。 - -1. [**Publish repository**] をクリックします。 ![[Publish repository]](/assets/images/help/desktop/getting-started-guide/publish-repository.png) - - おなじみのフィールドがいくつか表示されます。 [Name] と [Description] は、リポジトリを作成したときに入力したものと一致します。 - - [**Keep this code private**] というオプションが表示されます。 {% data variables.product.product_name %} の他のユーザに、コードを公にしたくない場合はこのオプションを選択します。 - - [**Organization**] ドロップダウンメニューが表示されている場合があります。これは、{% data variables.product.product_name %} であなたが所属する特定の Organization にリポジトリを公開するためのものです。 まだ Organization のメンバーでない場合も、何の問題もありません。 ![[Publish repository] のステップ](/assets/images/help/desktop/getting-started-guide/publish-repository-steps.png) -2. [**Publish repository**] をクリックします。 -3. {% data variables.product.prodname_desktop %} から {% data variables.product.prodname_dotcom_the_website %} のリポジトリにアクセスできます。 ファイルメニューで、[**Repository**] をクリックしてから [**View on GitHub**] をクリックしてください。 デフォルトブラウザで、リポジトリに直接移動します。 - -これでリポジトリが公開されました。{% data variables.product.prodname_desktop %} に戻って、ローカルリポジトリにもっと変更を行いましょう。 まず、デフォルトのテキストエディタを設定する方法を説明します。 - -### ステップ 5. テキストエディタの設定 - -開発環境の設定にかける時間を節約するために、{% data variables.product.prodname_desktop %} から直接、多くのテキストエディタと統合開発環境 (IDE) を起動できます。 {% data variables.product.prodname_desktop %} のリポジトリから、お好みのテキストエディタでプロジェクトフォルダをシームレスに開けます。 - -1. [**File**] をクリックし、[**Options**] をクリックしてから、[**Advanced**] をクリックします。 -2. [**External editor**] ドロップダウンメニューで、リストからテキストエディタを選択します。 インストール済みの全てのテキストエディタがリストに表示されるはずです。 エディタが何も表示されない場合、 [Atom](https://atom.io) などのサポートされているエディタをインストールしてください。 サポートされているエディタの一覧については、{% data variables.product.prodname_desktop %} リポジトリの[[Open External Editor] の統合](https://github.com/desktop/desktop/blob/development/docs/technical/editor-integration.md#windows)を参照してください。 ![外部エディタ](/assets/images/help/desktop/mac-editor-menu.png) -3. 新しくエディタをインストールした際は、[**External editor**] ドロップダウンメニューでエディタを使えるようにするため、{% data variables.product.prodname_desktop %} を再起動します。 - -### ステップ 6. 変更、変更のコミット、変更のプッシュ - -デフォルトのエディタが設定でき、いよいよ準備が整いました。それではプロジェクトに変更を行って、リポジトリに最初のコミットを作成しましょう。 - -1. {% data variables.product.prodname_desktop %} で外部エディタを起動するには、[**Repository**] をクリックしてから[**Open in EDITOR**] をクリックします。 ![[Open in editor]](/assets/images/help/desktop/getting-started-guide/open-in-editor.png) - -2. 事前に作成した _README.md_ ファイルに変更を行うことから始めましょう。 何をするのか、なぜ役立つのかなどの、プロジェクトに関する情報を追加します。 これが、プロジェクトに参加する人との最初のやりとりに使われるものであることを念頭におきましょう。 これで最初のコミットを行う準備ができました。 -3. テキストエディタから {% data variables.product.prodname_desktop %} に戻り、[**Changes**] タブに移動します。 ファイルのリストに、_README.md_ が表示されているはずです。 _README.md_ ファイルの隣についているチェックマークは、ファイルに行った変更が、コミットの一部になることを示しています。 今後、複数のファイルに変更を行って、そのうちの一部のファイルのみの変更をコミットしたい場合があるかもしれません。 {% data variables.product.prodname_desktop %} では、コミットしたい特定の変更を選ぶことができます。 ![変更を表示する](/assets/images/help/desktop/getting-started-guide/viewing-changes.png) - -4. [**Changes**] リストの下に、コミットメッセージを入力します。 プロフィール画像の右側で、コミットについて簡潔な説明を入力します。 ここでは _README.md_ ファイルを変更するので、「プロジェクトの目的について情報を追加する」などがコミットの要約として良いかもしれません。 要約の下には、[Description] テキストフィールドが表示されています。ここには、コミットの変更について、もっと長い内容を入力できます。これは、プロジェクトの履歴を振り返ったり、変更の理由を理解したりするために役立ちます。 今は _README.md_ ファイルの基本的な更新を行っているところなので、この内容は飛ばしてもかまいません。 ![コミットメッセージ](/assets/images/help/desktop/getting-started-guide/commit-message.png) -5. [**Commit to master**] をクリックします。 コミットのボタンは、現在のブランチを表示します。現在の例では `master` になり、コミットしたいブランチにコミットすることができます。 ![[Commit to master]](/assets/images/help/desktop/getting-started-guide/click-commit-to-master.png) -6. 変更を {% data variables.product.product_name %} のリモートリポジトリにプッシュするには、[**Push origin**] をクリックします。 ![[Push origin]](/assets/images/help/desktop/getting-started-guide/push-to-origin.png) - - {% data variables.product.product_name %} にリポジトリを公開したときに使った [**Publish**] ボタンを覚えていますか。 そのボタンが [`Push origin`] に変わって、右に `1` と表示されているはずです。これは、{% data variables.product.product_name %} にプッシュしていないコミットが 1 つあることを示しています。 - - [**Push origin**] の「origin」とは、`origin` というリモートに変更をプッシュしようとしていることを示しています。この例では、{% data variables.product.prodname_dotcom_the_website %} にあるプロジェクトのリポジトリです。 {% data variables.product.product_name %} に何か新しいコミットをプッシュするまで、お手元のコンピューターにあるプロジェクトのリポジトリと、{% data variables.product.prodname_dotcom_the_website %} にあるプロジェクトのリポジトリには違いがあります。 これにより、作業はローカルで行って、準備ができた場合にのみ {% data variables.product.prodname_dotcom_the_website %} に作業をプッシュすることができます。 -7. [**Changes**] タブの隣にあるオープンなスペースに、次に行うことについての提案が表示されてています。 {% data variables.product.product_name %} にあるリポジトリをブラウザで開くには、[**View on GitHub**] をクリックします。 ![[View on GitHub]](/assets/images/help/desktop/getting-started-guide/view-on-github.png) -8. ブラウザで、[**2 commits**] をクリックします。 {% data variables.product.product_name %} にあるリポジトリの、コミットのリストが表示されます。 最初のコミットは、つい先ほど {% data variables.product.prodname_desktop %} で行ったコミットのはずです。 ![2 つのコミットをクリック](/assets/images/help/desktop/getting-started-guide/click-two-commits.png) - -### おわりに - -おめでとうございます。 ここまでで、リポジトリを作成し、そのリポジトリを {% data variables.product.product_name %} に公開し、コミットを行い、変更をプッシュしました。 ここまで行ってきたことは、{% data variables.product.product_name %} および {% data variables.product.prodname_desktop %} でできるあらゆることのうち、ごく基本的なことだけです。 この練習が、今後のさらなる探求につながれば幸いです。 diff --git a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/index.md b/translations/ja-JP/content/desktop/getting-started-with-github-desktop/index.md deleted file mode 100644 index daac72f8bdfa..000000000000 --- a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/index.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: GitHub Desktop を使ってみる -shortTitle: はじめましょう -intro: プロジェクトの作業を管理するには、GitHub Desktopを設定しましょう。 GitHub.com、またはGitHub Enterprise Serverに認証して、アプリケーションの最新アップデートの取得、および設定の確認ができます。 -redirect_from: - - /desktop/getting-started-with-github-desktop/setting-up-github-desktop/ -versions: - free-pro-team: '*' ---- - - -### 目次 - -{% topic_link_in_list /overview %} - {% link_in_list /creating-your-first-repository-using-github-desktop %} - {% link_in_list /keyboard-shortcuts %} - {% link_in_list /launching-github-desktop-from-the-command-line %} -{% topic_link_in_list /installing-and-authenticating-to-github-desktop %} - {% link_in_list /installing-github-desktop %} - {% link_in_list /authenticating-to-github %} - {% link_in_list /about-the-github-desktop-windows-installer-package %} - {% link_in_list /updating-github-desktop %} - {% link_in_list /uninstalling-github-desktop %} -{% topic_link_in_list /configuring-and-customizing-github-desktop %} - {% link_in_list /configuring-basic-settings %} - {% link_in_list /configuring-git-for-github-desktop %} - {% link_in_list /configuring-a-default-editor %} - {% link_in_list /setting-a-theme-for-github-desktop %} diff --git a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/installing-and-authenticating-to-github-desktop.md b/translations/ja-JP/content/desktop/getting-started-with-github-desktop/installing-and-authenticating-to-github-desktop.md deleted file mode 100644 index 3a9713f99137..000000000000 --- a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/installing-and-authenticating-to-github-desktop.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: GitHub Desktopのインストールと認証 -intro: GitHub Desktopをインストールし、GitHubもしくはGitHub Enterpriseアカウントへ接続してください。 -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/installing-github-desktop.md b/translations/ja-JP/content/desktop/getting-started-with-github-desktop/installing-github-desktop.md deleted file mode 100644 index 6e0951007590..000000000000 --- a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/installing-github-desktop.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: GitHub Desktopのインストール方法 -intro: GitHub Desktopは、サポートされているMicrosoft Windows、またはmacOSオペレーティングシステムにインストールすることができます。 -versions: - free-pro-team: '*' ---- - -{% data variables.product.prodname_desktop %}、を設定する前には、{% data reusables.desktop.get-an-account %} - -### {% data variables.product.prodname_desktop %}のダウンロード、およびインストール方法 - -{% mac %} - -{% data variables.product.prodname_desktop %}は、{% data variables.desktop.mac-osx-versions %}にインストールできます。 - -{% data reusables.desktop.download-desktop-page %} -2. **Download for Mac**を選択します。 -3. お使いのコンピュータの**Downloads**フォルダで、**{% data variables.product.prodname_desktop %}** zipファイルをダブルクリックします。 -4. ファイルが解凍された後、**{% data variables.product.prodname_desktop %}**をダブルクリックします。 - -{% endmac %} - -{% windows %} - -{% data variables.product.prodname_desktop %}は、{% data variables.desktop.windows-versions %}にインストールできます。 - -{% warning %} - -**警告**：{% data variables.product.prodname_desktop %}を使用するには64ビットのオペレーティングシステムが必要です。 - -{% endwarning %} - -{% data reusables.desktop.download-desktop-page %} -2. **Download for Windows**を選択します。 - - {% note %} - - **注釈：**ネットワーク管理者は、{% data variables.product.prodname_desktop %}を展開するには、[{% data variables.product.prodname_desktop %}Windowsインストーラーパッケージ](/desktop/guides/getting-started-with-github-desktop/about-the-github-desktop-windows-installer-package/)を使用できます。 - - {% endnote %} - -3. お使いのコンピュータの**Downloads**フォルダで、**{% data variables.product.prodname_desktop %}**をダブルクリックします。 -4. ポップアップウィンドウで、**Install**をクリックします。 -5. プログラムがインストールされた後、**Run**をクリックします。 - -{% endwindows %} - -### {% data variables.product.prodname_desktop %}の設定方法 - -{% data variables.product.prodname_desktop %}を起動した後、{% data variables.product.prodname_desktop %}をすぐに設定するか、設定プロセスを飛ばすか決めることができます。 diff --git a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/keyboard-shortcuts-in-github-desktop.md b/translations/ja-JP/content/desktop/getting-started-with-github-desktop/keyboard-shortcuts-in-github-desktop.md deleted file mode 100644 index c08692185362..000000000000 --- a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/keyboard-shortcuts-in-github-desktop.md +++ /dev/null @@ -1,115 +0,0 @@ ---- -title: GitHub Desktopのキーボードショートカット -intro: '{% data variables.product.prodname_desktop %}ではキーボードショートカットを利用できます。' -versions: - free-pro-team: '*' ---- - -{% mac %} - -macOSでのGitHub Desktopキーボードショートカット - -### サイト全体のショートカット - -| キーボードショートカット | 説明 | -| ------------------------------------ | --------------------------------------------------------------- | -| ⌘, | 設定に移動 | -| ⌘H | {% data variables.product.prodname_desktop %}のアプリケーションの非表示 | -| ⌥⌘H | 他の全てのアプリケーションの非表示 | -| ⌘Q | {% data variables.product.prodname_desktop %}を終了 | -| ⌃⌘F | フルスクリーン表示をオン/オフにする | -| ⌘0 | ズームをデフォルトのテキストサイズにリセット | -| ⌘= | ズームインして、テキストとグラフィックスを大きくする | -| ⌘- | ズームアウトして、テキストとグラフィックスを小さくする | -| ⌥⌘I | デベロッパーツールの表示/非表示 | - -### リポジトリ - -| キーボードショートカット | 説明 | -| ------------------------------------ | --------------------------------------------------------------- | -| ⌘N | 新規リポジトリの追加 | -| ⌘O | ローカルリポジトリの追加 | -| ⇧⌘O | {% data variables.product.prodname_dotcom %}からリポジトリをクローンする | -| ⌘T | リポジトリリストの表示 | -| ⌘P | 最新コミットを{% data variables.product.prodname_dotcom %}にプッシュ | -| ⇧⌘P | 最新変更を{% data variables.product.prodname_dotcom %}からプルダウン | -| ⌘⌫ | 既存リポジトリの削除 | -| ⇧⌘G | {% data variables.product.prodname_dotcom %}にリポジトリを表示 | -| ⌃` | リポジトリをお好みのターミナルツールで開く | -| ⇧⌘F | Finderでリポジトリを表示 | -| ⇧⌘A | リポジトリをお好みのエディタツールで開く | -| ⌘I | {% data variables.product.prodname_dotcom %}でIssueを作成 | - -### ブランチ - -| キーボードショートカット | 説明 | -| ------------------------------------ | --------------------------------------------------------------- | -| ⌘1 | コミットする前に全ての変更を表示 | -| ⌘2 | コミット履歴を表示 | -| ⌘B | 全てのブランチを表示 | -| ⌘G | コミット概要のフィールドに移動 | -| space | Select or deselect all highlighted files | -| ⇧⌘N | 新規ブランチの作成 | -| ⇧⌘R | 現在ブランチの名前を変更 | -| ⇧⌘D | 現在ブランチの削除 | -| ⇧⌘U | デフォルトブランチから更新 | -| ⇧⌘B | 既存のブランチと比較 | -| ⇧⌘M | 現在ブランチにマージ | -| ⌃H | stash した変更の表示または非表示 | -| ⇧⌘C | {% data variables.product.prodname_dotcom %}のブランチを比較 | -| ⌘R | 現在のプルリクエストを{% data variables.product.prodname_dotcom %}に表示 | - -{% endmac %} - -{% windows %} - -WindowsでのGitHub Desktopキーボードのショートカット - -### サイト全体のショートカット - -| キーボードショートカット | 説明 | -| ------------------------------------------- | --------------------------- | -| Ctrl, | 設定に移動 | -| F11 | フルスクリーン表示をオン/オフにする | -| Ctrl0 | ズームをデフォルトのテキストサイズにリセット | -| Ctrl= | ズームインして、テキストとグラフィックスを大きくする | -| Ctrl- | ズームアウトして、テキストとグラフィックスを小さくする | -| CtrlShiftI | デベロッパーツールの表示/非表示 | - -### リポジトリ - -| キーボード ショート カット | 説明 | -| ------------------------------------------- | --------------------------------------------------------------- | -| CtrlN | 新規リポジトリの追加 | -| CtrlO | ローカルリポジトリの追加 | -| CtrlShiftO | {% data variables.product.prodname_dotcom %}からリポジトリをクローンする | -| CtrlT | リポジトリリストの表示 | -| CtrlP | 最新コミットを{% data variables.product.prodname_dotcom %}にプッシュ | -| CtrlShiftP | 最新変更を{% data variables.product.prodname_dotcom %}からプルダウン | -| CtrlDelete | 既存リポジトリの削除 | -| CtrlShiftG | {% data variables.product.prodname_dotcom %}にリポジトリを表示 | -| Ctrl` | リポジトリをお好みのコマンドラインルツールで開く | -| CtrlShiftF | Explorerでリポジトリを表示 | -| CtrlShiftA | リポジトリをお好みのエディタツールで開く | -| CtrlI | {% data variables.product.prodname_dotcom %}でIssueを作成 | - -### ブランチ - -| キーボードショートカット | 説明 | -| ------------------------------------------- | --------------------------------------------------------------- | -| Ctrl1 | コミットする前に全ての変更を表示 | -| Ctrl2 | コミット履歴を表示 | -| CtrlB | 全てのブランチを表示 | -| CtrlG | コミット概要のフィールドに移動 | -| space | Select or deselect all highlighted files | -| CtrlShiftN | 新規ブランチの作成 | -| CtrlShiftR | 現在ブランチの名前を変更 | -| CtrlShiftD | 現在ブランチの削除 | -| CtrlShiftU | デフォルトブランチから更新 | -| CtrlShiftB | 既存のブランチと比較 | -| CtrlShiftM | 現在ブランチにマージ | -| CtrlH | stash した変更の表示または非表示 | -| CtrlShiftC | {% data variables.product.prodname_dotcom %}のブランチを比較 | -| CtrlR | 現在のプルリクエストを{% data variables.product.prodname_dotcom %}に表示 | - -{% endwindows %} diff --git a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/keyboard-shortcuts.md b/translations/ja-JP/content/desktop/getting-started-with-github-desktop/keyboard-shortcuts.md deleted file mode 100644 index c95fb9a53372..000000000000 --- a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/keyboard-shortcuts.md +++ /dev/null @@ -1,117 +0,0 @@ ---- -title: キーボードショートカット -redirect_from: - - /desktop/getting-started-with-github-desktop/keyboard-shortcuts-in-github-desktop/ -intro: '{% data variables.product.prodname_desktop %}ではキーボードショートカットを利用できます。' -versions: - free-pro-team: '*' ---- - -{% mac %} - -macOSでのGitHub Desktopキーボードショートカット - -### サイト全体のショートカット - -| キーボードショートカット | 説明 | -| ------------------------------------ | --------------------------------------------------------------- | -| ⌘, | 設定に移動 | -| ⌘H | {% data variables.product.prodname_desktop %}のアプリケーションの非表示 | -| ⌥⌘H | 他の全てのアプリケーションの非表示 | -| ⌘Q | {% data variables.product.prodname_desktop %}を終了 | -| ⌃⌘F | フルスクリーン表示をオン/オフにする | -| ⌘0 | ズームをデフォルトのテキストサイズにリセット | -| ⌘= | ズームインして、テキストとグラフィックスを大きくする | -| ⌘- | ズームアウトして、テキストとグラフィックスを小さくする | -| ⌥⌘I | デベロッパーツールの表示/非表示 | - -### リポジトリ - -| キーボードショートカット | 説明 | -| ------------------------------------ | --------------------------------------------------------------- | -| ⌘N | 新規リポジトリの追加 | -| ⌘O | ローカルリポジトリの追加 | -| ⇧⌘O | {% data variables.product.prodname_dotcom %}からリポジトリをクローンする | -| ⌘T | リポジトリリストの表示 | -| ⌘P | 最新コミットを{% data variables.product.prodname_dotcom %}にプッシュ | -| ⇧⌘P | 最新変更を{% data variables.product.prodname_dotcom %}からプルダウン | -| ⌘⌫ | 既存リポジトリの削除 | -| ⇧⌘G | {% data variables.product.prodname_dotcom %}にリポジトリを表示 | -| ⌃` | リポジトリをお好みのターミナルツールで開く | -| ⇧⌘F | Finderでリポジトリを表示 | -| ⇧⌘A | リポジトリをお好みのエディタツールで開く | -| ⌘I | {% data variables.product.prodname_dotcom %}でIssueを作成 | - -### ブランチ - -| キーボードショートカット | 説明 | -| ------------------------------------ | --------------------------------------------------------------- | -| ⌘1 | コミットする前に全ての変更を表示 | -| ⌘2 | コミット履歴を表示 | -| ⌘B | 全てのブランチを表示 | -| ⌘G | コミット概要のフィールドに移動 | -| space | Select or deselect all highlighted files | -| ⇧⌘N | 新規ブランチの作成 | -| ⇧⌘R | 現在ブランチの名前を変更 | -| ⇧⌘D | 現在ブランチの削除 | -| ⇧⌘U | デフォルトブランチから更新 | -| ⇧⌘B | 既存のブランチと比較 | -| ⇧⌘M | 現在ブランチにマージ | -| ⌃H | stash した変更の表示または非表示 | -| ⇧⌘C | {% data variables.product.prodname_dotcom %}のブランチを比較 | -| ⌘R | 現在のプルリクエストを{% data variables.product.prodname_dotcom %}に表示 | - -{% endmac %} - -{% windows %} - -WindowsでのGitHub Desktopキーボードのショートカット - -### サイト全体のショートカット - -| キーボードショートカット | 説明 | -| ------------------------------------------- | --------------------------- | -| Ctrl, | 設定に移動 | -| F11 | フルスクリーン表示をオン/オフにする | -| Ctrl0 | ズームをデフォルトのテキストサイズにリセット | -| Ctrl= | ズームインして、テキストとグラフィックスを大きくする | -| Ctrl- | ズームアウトして、テキストとグラフィックスを小さくする | -| CtrlShiftI | デベロッパーツールの表示/非表示 | - -### リポジトリ - -| キーボード ショート カット | 説明 | -| ------------------------------------------- | --------------------------------------------------------------- | -| CtrlN | 新規リポジトリの追加 | -| CtrlO | ローカルリポジトリの追加 | -| CtrlShiftO | {% data variables.product.prodname_dotcom %}からリポジトリをクローンする | -| CtrlT | リポジトリリストの表示 | -| CtrlP | 最新コミットを{% data variables.product.prodname_dotcom %}にプッシュ | -| CtrlShiftP | 最新変更を{% data variables.product.prodname_dotcom %}からプルダウン | -| CtrlDelete | 既存リポジトリの削除 | -| CtrlShiftG | {% data variables.product.prodname_dotcom %}にリポジトリを表示 | -| Ctrl` | リポジトリをお好みのコマンドラインルツールで開く | -| CtrlShiftF | Explorerでリポジトリを表示 | -| CtrlShiftA | リポジトリをお好みのエディタツールで開く | -| CtrlI | {% data variables.product.prodname_dotcom %}でIssueを作成 | - -### ブランチ - -| キーボードショートカット | 説明 | -| ------------------------------------------- | --------------------------------------------------------------- | -| Ctrl1 | コミットする前に全ての変更を表示 | -| Ctrl2 | コミット履歴を表示 | -| CtrlB | 全てのブランチを表示 | -| CtrlG | コミット概要のフィールドに移動 | -| space | Select or deselect all highlighted files | -| CtrlShiftN | 新規ブランチの作成 | -| CtrlShiftR | 現在ブランチの名前を変更 | -| CtrlShiftD | 現在ブランチの削除 | -| CtrlShiftU | デフォルトブランチから更新 | -| CtrlShiftB | 既存のブランチと比較 | -| CtrlShiftM | 現在ブランチにマージ | -| CtrlH | stash した変更の表示または非表示 | -| CtrlShiftC | {% data variables.product.prodname_dotcom %}のブランチを比較 | -| CtrlR | 現在のプルリクエストを{% data variables.product.prodname_dotcom %}に表示 | - -{% endwindows %} diff --git a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/launching-github-desktop-from-the-command-line.md b/translations/ja-JP/content/desktop/getting-started-with-github-desktop/launching-github-desktop-from-the-command-line.md deleted file mode 100644 index 3eb02f726cfb..000000000000 --- a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/launching-github-desktop-from-the-command-line.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: コマンドラインからのGitHub Desktopの起動方法 -shortTitle: Launching from the command line -intro: GitHub Desktopはコマンドラインで起動できます。 -versions: - free-pro-team: '*' ---- - -{% mac %} - -1. In the menu bar, select the **{% data variables.product.prodname_desktop %}** menu, then click **Install Command Line Tool**. ![Install Command Line Tool option in the {% data variables.product.prodname_desktop %} drop-down menu](/assets/images/help/desktop/mac-install-command-line-tool.png) -2. ターミナルを開きます。 -3. {% data reusables.desktop.launch-desktop-from-command-line %} - - ```shell - $ github /path/to/repo - ``` - - You can also change to your repository path and then type `github .` to open that repository. - - ```shell - $ cd /path/to/repo - [repo]$ github . - ``` - -{% endmac %} - -{% windows %} - -1. コマンドラインプロンプトを開きます。 -2. {% data reusables.desktop.launch-desktop-from-command-line %} - - ```shell - C:\Users\octocat> github path\to\repo - ``` - - You can also change to your repository path and then type `github .` to open that repository. - - ```shell - C:\Users\octocat> cd repo\myrepo - C:\Users\octocat\repo\myrepo> github . - ``` - -{% endwindows %} diff --git a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/overview.md b/translations/ja-JP/content/desktop/getting-started-with-github-desktop/overview.md deleted file mode 100644 index d611e18b0829..000000000000 --- a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/overview.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: 概要 -intro: GitHub Desktopについて学び、最初のリポジトリを素早く作成してください。 -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/setting-a-theme-for-github-desktop.md b/translations/ja-JP/content/desktop/getting-started-with-github-desktop/setting-a-theme-for-github-desktop.md deleted file mode 100644 index 7ea2fe50ee5a..000000000000 --- a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/setting-a-theme-for-github-desktop.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: GitHub Desktop用のテーマ設定方法 -intro: テーマを設定して、GitHub Desktopの見た目をカスタマイズできます。 -versions: - free-pro-team: '*' ---- - -{% mac %} - -{% data reusables.desktop.mac-select-desktop-menu %} -{% data reusables.desktop.choose-a-theme %} - ![Macの外観タブのテーマオプション](/assets/images/help/desktop/mac-appearance-tab-themes.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.windows-choose-options %} -{% data reusables.desktop.choose-a-theme %} - ![Windowsの外観タブのテーマオプション](/assets/images/help/desktop/windows-appearance-tab-themes.png) - -{% endwindows %} diff --git a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/uninstalling-github-desktop.md b/translations/ja-JP/content/desktop/getting-started-with-github-desktop/uninstalling-github-desktop.md deleted file mode 100644 index 9d75d8465983..000000000000 --- a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/uninstalling-github-desktop.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: GitHub Desktopのアンインストール方法 -intro: You can uninstall GitHub Desktop from your computer at any time. -versions: - free-pro-team: '*' ---- - -{% mac %} - -1. In a Finder window, navigate to the Applications folder. ![Applications folder in the Finder window](/assets/images/help/desktop/applications-folder.png) -2. While pressing the **Control** button on your keyboard, click **{% data variables.product.prodname_desktop %}**. -3. **Move to Trash**を選択します。 ![The Move to Trash option](/assets/images/help/desktop/mac-move-to-trash.png) -4. In the menu bar, use the **Finder** drop-down menu, then click **Empty Trash**. ![The Empty Trash option in the menu bar](/assets/images/help/desktop/mac-empty-trash-menu.png) -5. ポップアップボックスの警告を読んで、**Empty Trash**をクリックします。 ![The Empty Trash button](/assets/images/help/desktop/mac-empty-trash-button.png) - -{% endmac %} - -{% windows %} - -1. Open Control Panel. For more information, see [Where is Control Panel?](https://support.microsoft.com/en-us/help/13764/windows-where-is-control-panel) in Windows Help. -2. Under "Programs", click **Uninstall a program**. ![The Uninstall a Program option in Control Panel](/assets/images/help/desktop/windows-uninstall-a-program.png) -3. Right-click the entry named **{% data variables.product.prodname_desktop %}**, then click **Uninstall**. ![The Uninstall option](/assets/images/help/desktop/windows-click-uninstall.png) - -{% endwindows %} diff --git a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/updating-github-desktop.md b/translations/ja-JP/content/desktop/getting-started-with-github-desktop/updating-github-desktop.md deleted file mode 100644 index a06177927489..000000000000 --- a/translations/ja-JP/content/desktop/getting-started-with-github-desktop/updating-github-desktop.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: GitHub Desktopの更新方法 -intro: GitHub Desktopは、自動的にアップデートをダウンロードして、再起動のときにインストールします。 手動でアップデートを確認することもできます。 -versions: - free-pro-team: '*' ---- - -{% mac %} - -1. **GitHub Desktop** メニューで、**About GitHub Desktop**をクリックします。 ![About GitHub Desktopメニューオプション](/assets/images/help/desktop/desktop-menu-about-desktop-mac.png) -2. **Check for Updates**をクリックします。 ![Check for Updatesボタン](/assets/images/help/desktop/check-for-updates.png) -3. アップデートが利用可能な場合、アップデートをインストールするには、{% data variables.product.prodname_desktop %}を終了して、再起動します。 - -{% endmac %} - -{% windows %} - -1. **Help** メニューで、**About GitHub Desktop**をクリックします。 ![About GitHub Desktopメニューオプション](/assets/images/help/desktop/help-about-desktop-win.png) -2. **Check for Updates**をクリックします。 ![Check for Updatesボタン](/assets/images/help/desktop/check-for-updates.png) -3. アップデートが利用可能な場合、アップデートをインストールするには、{% data variables.product.prodname_desktop %}を終了して、再起動します。 - -{% endwindows %} diff --git a/translations/ja-JP/content/github/administering-a-repository/about-github-dependabot.md b/translations/ja-JP/content/github/administering-a-repository/about-github-dependabot.md deleted file mode 100644 index ff18d7dfa70f..000000000000 --- a/translations/ja-JP/content/github/administering-a-repository/about-github-dependabot.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: GitHub Dependabot について -intro: '{% data variables.product.prodname_dependabot %} を使用して、使用するパッケージを最新バージョンに更新しておくことができます。' -versions: - free-pro-team: '*' ---- - -{% data reusables.dependabot.beta-note %} - -### {% data variables.product.prodname_dependabot %}について - -{% data variables.product.prodname_dependabot %} は、依存関係の維持を簡単にする {% data variables.product.prodname_dotcom %} アプリです。 これを使用して、リポジトリが依存するパッケージおよびアプリケーションの最新リリースに自動的に対応できるようにすることができます。 - -{% data variables.product.prodname_dependabot_version_updates %} を有効にするには、リポジトリに設定ファイルをチェックインします。 設定ファイルでは、リポジトリに保存されているマニフェストまたは他のパッケージ定義ファイルの場所を指定します。 アプリはこの情報を使用して、古いパッケージとアプリケーションをチェックします。 The {% data variables.product.prodname_dependabot_short %} app determines if there is a new version of a dependency by looking at the semantic versioning ([semver](https://semver.org/)) of the dependency to decide whether it should update to that version. アプリが古い依存関係を特定すると、プルリクエストが発行され、マニフェストを最新バージョンの依存関係に更新します。 テストに合格したことを確認し、プルリクエストの概要に含まれている変更履歴とリリースノートを確認して、マージします。 詳しい情報については、「[バージョン更新の有効化と無効化](/github/administering-a-repository/enabling-and-disabling-version-updates)」を参照してください。 - -セキュリティアップデートを有効にすると、{% data variables.product.prodname_dependabot %} はプルリクエストを発行し、脆弱性のある依存関係を更新します。 詳しい情報については、「[{% data variables.product.prodname_dependabot_security_updates %} を設定する](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)」を参照してください。 - -{% data reusables.dependabot.dependabot-tos %} - -### {% data variables.product.prodname_dependabot %} のプルリクエストの頻度 - -設定ファイルで、新しいバージョンの各エコシステムをチェックする頻度を、毎日、毎週、毎月の中から指定します。 - -{% data reusables.dependabot.initial-updates %} - -セキュリティアップデートを有効にした場合、セキュリティアップデートの追加に対するプルリクエストが表示されることがあります。 これらは、デフォルトブランチへの依存関係に関する Dependabot アラートによってトリガーされます。 {% data variables.product.prodname_dependabot %} はプルリクエストを自動的に生成し、脆弱性のある依存関係を更新します。 - -### サポートされているリポジトリとエコシステム - -サポートされているパッケージマネージャーのいずれかの依存関係マニフェストまたはロックファイルを含むリポジトリのバージョン更新を設定できます。 - -{% data reusables.dependabot.supported-package-managers %} - -リポジトリですでに依存関係管理にインテグレーションを使用している場合は、{% data variables.product.prodname_dependabot %} を有効にする前にそれを無効にする必要があります。 詳しい情報については、「[インテグレーションについて](/github/customizing-your-github-workflow/about-integrations)」を参照してください。 diff --git a/translations/ja-JP/content/github/administering-a-repository/setting-the-default-branch.md b/translations/ja-JP/content/github/administering-a-repository/setting-the-default-branch.md deleted file mode 100644 index 6dfc69e90c05..000000000000 --- a/translations/ja-JP/content/github/administering-a-repository/setting-the-default-branch.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: デフォルトブランチを設定する -intro: 'If you have more than one branch in your repository, you can choose another branch to be the default branch.' -redirect_from: - - /articles/setting-the-default-branch -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -### About the default branch - -{% data reusables.branches.new-repo-default-branch %} {% data reusables.branches.default-branch-automatically-base-branch %} If you have more than one branch in your repository, anyone with admin rights over a repository can select one of these existing branches as the default branch on the repository. - -### デフォルトブランチを設定する - -{% note %} - -**Note:** To set the default branch you must have more than one branch in your repository. - -{% endnote %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -{% data reusables.repositories.repository-branches %} -4. In the default branch drop-down, choose the new default branch. ![デフォルトブランチ ドロップダウン セレクター](/assets/images/help/repository/repository-options-defaultbranch.png) -5. [**Update**] をクリックします。 - -{% data variables.product.product_location %} 上にすでにあるブランチに限って、切り替えできます。 UI で新しいブランチを作成するには、「[リポジトリ内でブランチを作成および削除する](/articles/creating-and-deleting-branches-within-your-repository)」を参照してください。 - -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} - -You can also set the default branch name for any newly created repositories owned by your user account, organization, or enterprise account. For more information, see "[Managing the default branch for your repositories](/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories)", "[Managing the default branch name for repositories in your organization](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization), or "[Enforcing a policy on the default branch name](/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account#enforcing-a-policy-on-the-default-branch-name)." - -{% endif %} - -{% warning %} - -**Warning**: Setting a different default branch affects your `trunk` branch contents on the [Git-Subversion bridge](https://github.com/blog/1178-collaborating-on-github-with-subversion) and the `HEAD` you'd see when you `git ls-remote` this [repository's upstream URL](https://git-scm.com/docs/git-ls-remote.html). - -{% endwarning %} diff --git a/translations/ja-JP/content/github/articles/README.md b/translations/ja-JP/content/github/articles/README.md deleted file mode 100644 index d692ae9742cf..000000000000 --- a/translations/ja-JP/content/github/articles/README.md +++ /dev/null @@ -1,5 +0,0 @@ -# 非表示のGitHub.com記事 - -`hidden: true` フロントマターが記述された、このディレクトリにある GitHub.com/Enterprise 記事です。 - -非表示ページに関する詳しい情報については、[`content/README`](../README.md#hidden-pages) を参照してください。 diff --git a/translations/ja-JP/content/github/articles/about-the-github-and-visual-studio-bundle.md b/translations/ja-JP/content/github/articles/about-the-github-and-visual-studio-bundle.md deleted file mode 100644 index 004f716dde4e..000000000000 --- a/translations/ja-JP/content/github/articles/about-the-github-and-visual-studio-bundle.md +++ /dev/null @@ -1,54 +0,0 @@ ---- -title: GitHub と Visual Studio のバンドルについて -hidden: true -redirect_from: - - /articles/about-the-github-and-visual-studio-bundle -versions: - free-pro-team: '*' ---- - -{% tip %} - -**ヒント**： -- Organization に参加するようユーザを招待できるのは、Organization オーナーだけです。 詳細は「[Organization の権限レベル](/articles/permission-levels-for-an-organization)」を参照してください。 - -{% endtip %} - - -### ここには以下の内容があります: -- [{% data variables.product.prodname_enterprise %} と Visual Studio のバンドルライセンスについて](#about-github-enterprise-and-visual-studio-bundle-licenses) -- [{% data variables.product.prodname_enterprise %} ユーザライセンスを割り当てる](#assigning-a-github-enterprise-user-license) -- [ユーザライセンスの過剰割り当て](#overallocation-of-user-licenses) - - -### {% data variables.product.prodname_enterprise %} と Visual Studio のバンドルライセンスについて - -{% data variables.product.prodname_dotcom %}-Visual Studio バンドルを購入したお客様は、{% data variables.product.prodname_enterprise %} ユーザライセンスを入手できます。 これらのライセンスは {% data variables.product.prodname_dotcom %} Enterprise アカウントでプロビジョニングされます。Enterprise アカウントは Microsoft Enterprise Agreement にリンクされ、Organization メンバーに割り当てることができます。 - -Enterprise 内の Organization のオーナーが新しいユーザを Organization に参加するよう招待した場合、新しいユーザにライセンスを {% data variables.product.prodname_enterprise %} あるいは {% data variables.product.prodname_enterprise %} with Visual Studio プランのどちらから割り当てるかを選択できます。 - -### {% data variables.product.prodname_enterprise %} ユーザライセンスを割り当てる - -{% data reusables.profile.access_profile %} -{% data reusables.profile.access_org %} -{% data reusables.organizations.people %} -{% data reusables.organizations.invite_member_from_people_tab %} -{% data reusables.organizations.invite_to_org %} -{% data reusables.organizations.choose-to-restore-privileges %} -{% data reusables.organizations.choose-user-role %} -{% data reusables.organizations.choose-user-license %} -{% data reusables.organizations.add-user-to-teams %} -{% data reusables.organizations.send-invitation %} -{% data reusables.organizations.user_must_accept_invite_email %} {% data reusables.organizations.cancel_org_invite %} - -### ユーザライセンスの過剰割り当て - -{% data variables.product.prodname_enterprise %} および {% data variables.product.prodname_enterprise %} with Visual Studio プランで使用しているライセンスの総数は、Enterprise アカウントの支払い設定から見ることができます。 - -Organization および Enterprise のオーナーが、利用中のプランに含まれているライセンス数よりも多くの {% data variables.product.prodname_enterprise %} (Visual Studio) プランのライセンスをユーザに割り当てた場合、次回の調整請求書にはプランに含まれている分を超えたユーザ数の支払いが含まれます。 - -詳細は「[Enterprise アカウントのプランおよび利用状況を見る示](/articles/viewing-the-subscription-and-usage-for-your-enterprise-account)」を参照してください。 - -### 参考リンク -- [Team へのOrganization メンバーの追加](/articles/adding-organization-members-to-a-team) -- Organization が[メンバーに 2 要素認証を使うことを要求](/articles/requiring-two-factor-authentication-in-your-organization)している場合、招待するユーザは招待を受ける前に[ 2 要素認証を有効化](/articles/securing-your-account-with-two-factor-authentication-2fa)する必要があります。 diff --git a/translations/ja-JP/content/github/articles/managing-your-disabled-github-pages-site.md b/translations/ja-JP/content/github/articles/managing-your-disabled-github-pages-site.md deleted file mode 100644 index fa4943912ece..000000000000 --- a/translations/ja-JP/content/github/articles/managing-your-disabled-github-pages-site.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: 無効化した GitHub Pages サイトを管理する -intro: '{% data variables.product.prodname_free_user %} のプライベートリポジトリは {% data variables.product.prodname_pages %} をサポートしませんが、無料のプライベートリポジトリに接続していた限定数の {% data variables.product.prodname_pages %} サイトが誤ってアクティブなままになっていました。 これらのサイトは更新されず、2019 年 5 月 10 日に {% data variables.product.prodname_dotcom %} によって取り下げられます。' -hidden: true -redirect_from: - - /articles/managing-your-disabled-github-pages-site -versions: - free-pro-team: '*' ---- - -{% note %} - -{% data variables.product.prodname_pages %} は、{% data variables.product.prodname_free_user %} ではパブリックリポジトリでのみ使用でき、{% data variables.product.prodname_pro %}、{% data variables.product.prodname_team %}、{% data variables.product.prodname_ghe_cloud %}、{% data variables.product.prodname_ghe_server %} ではパブリックおよびプライベートリポジトリで使用できます。 {% data reusables.gated-features.more-info %} - -{% endnote %} - -無料のプライベートリポジトリに公開した {% data variables.product.prodname_pages %} サイトがある場合は、サイトの公開と更新を継続するか、手動でサイトを取り下げるかのオプションがいくつかあります。 何もしない場合、{% data variables.product.prodname_dotcom %} は 2019 年 5 月 10 日にサイトを取り下げます。 - -- **{% data variables.product.prodname_pages %} サイトの公開と更新を継続する場合**は、リポジトリをパブリックにするか、アカウントを {% data variables.product.prodname_pro %} にアップグレードできます。 プライベートリポジトリをパブリックにする方法については「[リポジトリの可視性を設定する](/articles/setting-repository-visibility#making-a-private-repository-public)」を参照してください。アカウントのアップグレードについては「[GitHub のプランをアップグレードする](/articles/upgrading-your-github-subscription)」を参照してください。 - -- **{% data variables.product.prodname_pages %} サイトの公開を停止する場合**は、[手動で取り下げる](#manually-unpublishing-your-github-pages-site)か、{% data variables.product.prodname_dotcom %} が 2019 年 5 月 10 日に取り下げるまで何もせずに待ちます。 {% data variables.product.prodname_pages %} サイトでカスタム ドメインを設定している場合は、ドメイン乗っ取りのリスクを回避するために、できるだけ早く DNS プロバイダで DNS レコードを更新または削除してください。 {% data variables.product.prodname_pages %} サイトが無効な間に、DNS プロバイダでカスタム ドメインを設定すると、サブドメインのいずれかで誰かにサイトをホストされてしまう恐れがあります。 詳細は「[{% data variables.product.prodname_pages %} でカスタムドメインを使用する](/articles/using-a-custom-domain-with-github-pages)」を参照してください。 - -### {% data variables.product.prodname_pages %} サイトを手動で取り下げる - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -3. 左サイドバーで [**Unpublish {% data variables.product.prodname_pages %}**] をクリックします。 ![{% data variables.product.prodname_pages %} サイトを取り下げるリポジトリ設定](/assets/images/help/pages/unpublish-pages-button-sidebar.png) -4. [**Unpublish this site**] をクリックします。 ![{% data variables.product.prodname_pages %} サイトを取り下げるボタン](/assets/images/help/pages/unpublish-pages-button.png) - -### 参考リンク - -- 「[ユーザ Pages サイトを取り下げる](articles/unpublishing-a-user-pages-site)」 -- 「[プロジェクト Pages サイトを取り下げる](/articles/unpublishing-a-project-pages-site)」 -- 「[リポジトリを移譲する](/articles/transferring-a-repository)」 -- [リポジトリのアーカイブについて](/articles/about-archiving-repositories) -- 「[リポジトリを削除する](/articles/deleting-a-repository)」 diff --git a/translations/ja-JP/content/github/articles/searching-and-navigating-code.md b/translations/ja-JP/content/github/articles/searching-and-navigating-code.md deleted file mode 100644 index 17dec9c2c115..000000000000 --- a/translations/ja-JP/content/github/articles/searching-and-navigating-code.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: 検索およびナビゲーションコード -intro: 検索およびナビゲーションコードは、開発ワークフローにおいてクリティカルな部分であり、GitHub はこの分野で改良を続けています。 Code Search and Navigation Private Beta を選択した Organization にいる場合、強力な新しい検索およびナビゲーションツールにアクセスできます。 この Private Beta についての追加のお問い合わせは、search-beta@github.com にメールをお送りください。 -hidden: true -redirect_from: - - /articles/searching-and-navigating-code -versions: - free-pro-team: '*' ---- - - -### このガイドの内容 - -- [文字通りのコード検索](#literal-code-search) -- [関連性](#relevancy) -- [ナビゲーションにジャンプ](#jump-to-navigation) - -### 文字通りのコード検索 - -この Private Beta 以前は、検索インデックスから多くのシンボルが抜けていました。つまり、`>>` のようなよくある決まり文句が検索できなかったのです。 例えば、リポジトリで `>>` を検索した場合、検索結果は 0 件でした。 Private Beta では、ダブルクオテーションでシンボルを囲むと、正しい検索結果を表示できます。 この能力によって、シンボルを超えて、`"return [] unless"` のような引用フレーズ全体を検索できます。 この機能は、すべての言語でのコード検索で使用できます。 - -### 関連性 - -言語 (Go、JavaScript、Python、Ruby、および TypeScript) のサブセットで、コード検索は宣言の関連性を調整するようになりました。 方法、機能、クラスまたはその他のエンティティは、同じ用語を含むコールまたはコメントの前に表示されます。 - -### ナビゲーションにジャンプ - -言語 (Go、JavaScript、Python、Ruby、および TypeScript) のサブセットで、GitHubは、シンボルをクリックした場合の追加情報とナビゲーションをサポートするようになりました。 このナビゲーションは、素早いナビゲーションと理解を深められるリポジトリ内のリソースへの用語ナビゲーションへのジャンプを含みます。 - -### フィードバック - -Code Search and Navigation Private Beta を現在選択しているすべてのユーザは、[このサーベイ](https://www.research.net/r/CodeSearch-Navigation)に参加することによってフィードバックができます。 追加のフィードバックおよびお問い合わせは、search-beta@github.com にメールをお送りください。 - -### 参考リンク -- [GitHub での検索について](/articles/about-searching-on-github/) -- [プルリクエストで変更されたメソッドや機能を見つける](/articles/finding-changed-methods-and-functions-in-a-pull-request/) diff --git a/translations/ja-JP/content/github/articles/using-gist-playground.md b/translations/ja-JP/content/github/articles/using-gist-playground.md deleted file mode 100644 index 7c80f7c93a20..000000000000 --- a/translations/ja-JP/content/github/articles/using-gist-playground.md +++ /dev/null @@ -1,45 +0,0 @@ ---- -title: Gist Playground を使用する -intro: '' -hidden: true -redirect_from: - - /articles/articles/using-gist-playground -versions: - free-pro-team: '*' ---- - -{% note %} - -**メモ:** Gist Playground は、限定的で非公開のベータプログラムとして使用でき、アーリーアクセス契約が適用されます。 - -{% endnote %} - -### ここには以下の内容があります: -- [Gist Playground について](#about-gist-playground) -- [新しい Gist を作成する](#creating-new-gists) -- [変更を保存する](#saving-your-changes) -- [他のユーザとコラボレーションする](#collaborating-with-others) -- [バグやフィードバックを送信する](#reporting-bugs-and-feedback) - -### Gist Playground について -Gist Playground は、[Gist](https://gist.github.com/) の実験的なバージョンです。 友人や同僚と共に作業している間に、変更が自動的に保存されます。 - -### 新しい Gist を作成する -Gist Playground にアクセスすると、自動的に新しいドラフトが作成されるか、直近のドラフトが表示されます。 Gist を作成して共有する準備ができたら、ヘッダ内の [**Create gist**] をクリックします。 - -Gist Playground で作成されたすべての Gist は*シークレット*です。 現在のところ、Gist Playground 内から Gist をパブリックにする方法はありません。 Gist をパブリックにしたい場合は、既存の [Gist](https://gist.github.com/) を使うことができます。 - -### 変更を保存する -変更は入力するたびに自動的に保存されます。 いつでもタブを閉じることができ、作業内容を失うことなく戻ることができます。 - -チェックポイントに到達したら、ヘッダ内の [**Update gist**] をクリックして、変更した内容で Gist を更新できます。 - -### 他のユーザとコラボレーションする -Gist Playground プライベートベータに参加している誰とでもコラボレーションできます。 [Invite to collaborate] の下にある、コラボレーション URL をクリックしてコピーし、その URL を友人に送信すると、共同で変更を行えるようになります。 - -チェックポイントに到達したら、Gist のコードオーナーは [**Update gist**] をクリックして変更を保存できます。 - -Gist Playground のプライベートベータに参加していない人とコラボレーションしたい場合は、 [gist-playground@github.com](mailto:gist-playground@github.com) までメールを送信してください。その人を追加できるかどうか確認します。 - -### バグやフィードバックを送信する -Gist Playground についての評価や改善点についてご連絡いただければ幸いです。 感想、意見、バグなどがあれば、[gist-playground@github.com](mailto:gist-playground@github.com) までメールを送信してください。 diff --git a/translations/ja-JP/content/github/committing-changes-to-your-project/why-are-my-commits-in-the-wrong-order.md b/translations/ja-JP/content/github/committing-changes-to-your-project/why-are-my-commits-in-the-wrong-order.md deleted file mode 100644 index 08cd50fe50b4..000000000000 --- a/translations/ja-JP/content/github/committing-changes-to-your-project/why-are-my-commits-in-the-wrong-order.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: コミットが間違った順番になっているのはなぜですか？ -intro: 「git rebase」またはフォースプッシュでコミット履歴を書き換えると、プルリクエストを開いたときにコミットシーケンスが乱れていることに気付く場合があります。 -redirect_from: - - /articles/why-are-my-commits-in-the-wrong-order -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -GitHub は、議論の場としてプルリクエストを強調しています。 そのすべての側面 (コメント、参照、およびコミット) は、時系列で表されます。 Git コミット履歴を[リベースの実行中に](/articles/about-git-rebase)書き換えると、時空連続体が変更されます。つまり、GitHub インターフェイスでは、コミットが期待どおりに表現されない可能性があります。 - -常にコミットを順番に表示したい場合は、`git rebase` を使用しないことをおすすめします。 ただし、時系列に並んで表示されていなくても、何も破損してはいませんので、ご安心ください。 diff --git a/translations/ja-JP/content/github/developing-online-with-codespaces/connecting-to-your-codespace-from-visual-studio-code.md b/translations/ja-JP/content/github/developing-online-with-codespaces/connecting-to-your-codespace-from-visual-studio-code.md deleted file mode 100644 index 3f5dee22afdb..000000000000 --- a/translations/ja-JP/content/github/developing-online-with-codespaces/connecting-to-your-codespace-from-visual-studio-code.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: Visual Studio Code から codespace に接続する -intro: '{% data variables.product.product_name %} のアカウントに {% data variables.product.prodname_vs_codespaces %} 機能拡張を接続することにより、{% data variables.product.prodname_vscode %} で codespace を直接開発できます。' -product: '{% data reusables.gated-features.codespaces %}' -versions: - free-pro-team: '*' ---- - -{% data reusables.codespaces.release-stage %} - -### {% data variables.product.prodname_vs_codespaces %} 機能拡張を {% data variables.product.prodname_dotcom %} アカウントに接続する - -{% data variables.product.prodname_vscode %} の codespace で直接開発する前に、{% data variables.product.product_name %} アカウントに接続するように {% data variables.product.prodname_vs_codespaces %} の機能拡張を設定する必要があります。 - -1. {% data variables.product.prodname_vs %} Marketplace を使用して、[{% data variables.product.prodname_vs_codespaces %}](https://marketplace.visualstudio.com/items?itemName=ms-vsonline.vsonline) 機能拡張をインストールします。 詳しい情報については、{% data variables.product.prodname_vscode %} ドキュメントの「[Extension Marketplace](https://code.visualstudio.com/docs/editor/extension-gallery)」を参照してください。 -2. {% data variables.product.prodname_vscode %} の左サイドバーで、[Extensions] アイコンをクリックします。 ![{% data variables.product.prodname_vscode %} の [Extensions] アイコン](/assets/images/help/codespaces/click-extensions-icon-vscode.png) -3. {% data variables.product.prodname_vs_codespaces %} の下で、[Manage] アイコンをクリックしてから、[**Extension Settings**] をクリックします。 ![[Extension Settings] オプション](/assets/images/help/codespaces/select-extension-settings.png) -4. [Vsonline: Account Provider] ドロップダウンメニューを使用して、{% data variables.product.prodname_dotcom %} を選択します。 ![アカウントプロバイダを {% data variables.product.prodname_dotcom %} に設定する](/assets/images/help/codespaces/select-account-provider-vscode.png) -{% data reusables.codespaces.click-remote-explorer-icon-vscode %} -6. ヘッダで {% data variables.product.prodname_codespaces %} がまだ選択されていない場合は、[**{% data variables.product.prodname_codespaces %}**] をクリックします。 ![{% data variables.product.prodname_codespaces %} ヘッダ](/assets/images/help/codespaces/codespaces-header-vscode.png) -7. [**Sign in to view {% data variables.product.prodname_codespaces %}...**] をクリックします。 ![[Signing in to view {% data variables.product.prodname_codespaces %}]](/assets/images/help/codespaces/sign-in-to-view-codespaces-vscode.png) -8. {% data variables.product.prodname_vscode %} からの {% data variables.product.product_name %} のアカウントへのアクセスを承認するには、[**Allow**] をクリックします。 -9. 機能拡張を承認するには、{% data variables.product.product_name %} にサインインします。 - -### {% data variables.product.prodname_vscode %} で codespace を開く - -{% data variables.product.product_name %} アカウントを {% data variables.product.prodname_vs_codespaces %} 機能拡張に接続した後、{% data variables.product.product_name %} で作成した codespace で {% data variables.product.prodname_vscode %} を使って直接開発できます。 - -{% data reusables.codespaces.click-remote-explorer-icon-vscode %} -2. [Codespaces] で、開発する codespace をクリックします。 -3. [Connect to Codespace] アイコンをクリックします。 ![{% data variables.product.prodname_vscode %} の [Connect to Codespace] アイコン](/assets/images/help/codespaces/click-connect-to-codespace-icon-vscode.png) diff --git a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-for-compiled-languages.md b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-for-compiled-languages.md deleted file mode 100644 index 260e080be8e4..000000000000 --- a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-for-compiled-languages.md +++ /dev/null @@ -1,137 +0,0 @@ ---- -title: Configuring code scanning for compiled languages -shortTitle: Configuring for compiled languages -intro: 'You can configure how {% data variables.product.prodname_dotcom %} scans code written in compiled languages for vulnerabilities and errors.' -product: '{% data reusables.gated-features.code-scanning %}' -permissions: 'リポジトリへの書き込み権限を持つユーザは、リポジトリの {% data variables.product.prodname_code_scanning %} を設定できます。' -versions: - free-pro-team: '*' ---- - -{% data reusables.code-scanning.beta %} - -{% note %} - -**Note**: This article refers to {% data variables.product.prodname_code_scanning %} powered by {% data variables.product.prodname_codeql %}, not to {% data variables.product.prodname_code_scanning %} resulting from the upload of third-party static analysis tools. - -{% endnote %} - -### About {% data variables.product.prodname_code_scanning %} and compiled languages - -To enable {% data variables.product.prodname_code_scanning %} for your repository, you add to the repository a {% data variables.product.prodname_actions %} workflow which includes {% data variables.product.prodname_codeql %} analysis. 詳しい情報については、「[{% data variables.product.prodname_code_scanning %} を有効化する](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning)」を参照してください。 - -{% data reusables.code-scanning.edit-workflow %} -For more information about configuring {% data variables.product.prodname_code_scanning %} and editing workflow files, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)" and "[Configuring a workflow](/actions/configuring-and-managing-workflows/configuring-a-workflow)." - -### About autobuild for {% data variables.product.prodname_codeql %} - -{% data reusables.code-scanning.autobuild-compiled-languages %} - -{% note %} - -**Note**: If you use self-hosted runners for {% data variables.product.prodname_actions %}, you may need to install additional software to use the `autobuild` process. Additionally, if your repository requires a specific version of a build tool, you may need to install it manually. 詳しい情報については「[GitHUbホストランナーにインストールされているソフトウェア](/actions/reference/software-installed-on-github-hosted-runners)」を参照してください。 - -{% endnote %} - -#### C/C++ - -| Supported system type | System name | -| --------------------- | ----------------------------------------------------------- | -| オペレーティングシステム | Windows and Linux | -| Build system | Autoconf, CMake, qmake, Meson, Waf, SCons, and Linux Kbuild | - -The behavior of the `autobuild` step varies according to the operating system that the extraction runs on. On Windows, the step has no default actions. On Linux, this step reviews the files present in the repository to determine the build system used: - -1. Look for a build system in the root directory. -2. If none are found, search subdirectories for a unique directory with a build system for C/C++. -3. Run an appropriate command to configure the system. - -#### C - -| Supported system type | System name | -| --------------------- | ------------------------------------------ | -| オペレーティングシステム | Windows and Linux | -| Build system | .NET and MSbuild, as well as build scripts | - -The `autobuild` process attempts to autodetect a suitable build method for C# using the following approach: - -1. Invoke `dotnet build` on the solution (`.sln`) or project (`.csproj`) file closest to the root. -2. Invoke `MSbuild` (Linux) or `MSBuild.exe` (Windows) on the solution or project file closest to the root. If `autobuild` detects multiple solution or project files at the same (shortest) depth from the top level directory, it will attempt to build all of them. -3. Invoke a script that looks like a build script—_build_ and _build.sh_ (in that order, for Linux) or _build.bat_, _build.cmd_, _and build.exe_ (in that order, for Windows). - - -#### Java - -| Supported system type | System name | -| --------------------- | ----------------------------------------- | -| オペレーティングシステム | Windows, macOS and Linux (no restriction) | -| Build system | Gradle, Maven and Ant | - -The `autobuild` process tries to determine the build system for Java codebases by applying this strategy: - -1. Search for a build file in the root directory. Check for Gradle then Maven then Ant build files. -2. Run the first build file found. If both Gradle and Maven files are present, the Gradle file is used. -3. Otherwise, search for build files in direct subdirectories of the root directory. If only one subdirectory contains build files, run the first file identified in that subdirectory (using the same preference as for 1). If more than one subdirectory contains build files, report an error. - -### コンパイル言語のビルドステップを追加する - -{% data reusables.code-scanning.autobuild-add-build-steps %} For information about editing the workflow, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#editing-a-code-scanning-workflow)." - -After removing the `autobuild` step, uncomment the `run` step and add build commands that are suitable for your repository. The workflow `run` step runs command-line programs using the operating system's shell. これらのコマンドを変更し、さらにコマンドを追加して、ビルドプロセスをカスタマイズできます。 - -``` yaml -- run: | - make bootstrap - make release -``` - -`run` キーワードに関する詳しい情報については、「"[{% data variables.product.prodname_actions %}のためのワークフローの構文](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)」を参照してください。 - -You can also use a build matrix to update the workflow to build more than one compiled language, if this is the appropriate approach for your system and doesn't cause conflicts. For more information, see "[Configuring a build matrix](/actions/configuring-and-managing-workflows/configuring-a-workflow#configuring-a-build-matrix)." - - -For example, the workflow below runs one job for C/C++ analysis, and another job for Java analysis. - -```yaml - -name: "Code Scanning - Action" - -on: - pull_request: - branches: [master] - push: - branches: [master] - -jobs: - CodeQL-Build: - - strategy: - fail-fast: false - matrix: - language: [ 'cpp', 'java'] - - # CodeQL runs on ubuntu-latest, windows-latest, and macos-latest - runs-on: ubuntu-latest - - steps: - - name: Checkout repository - uses: actions/checkout@v2 - - # Initializes the CodeQL tools for scanning. - - name: Initialize CodeQL - uses: github/codeql-action/init@v1 - with: - languages: ${{ matrix.language }} - - # Autobuild attempts to build any compiled languages (C/C++, C#, or Java). - # If this step fails, then you should remove it and run the build manually. - - name: Autobuild - uses: github/codeql-action/autobuild@v1 - - - name: Perform CodeQL Analysis - uses: github/codeql-action/analyze@v1 -``` - -For more tips and tricks about why `autobuild` won't build your code, see "[Troubleshooting {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning)". - -If you added manual build steps for compiled languages or used a build matrix and {% data variables.product.prodname_code_scanning %} is still not working on your repository, contact {% data variables.contact.contact_support %}. diff --git a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages.md b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages.md deleted file mode 100644 index 8283e825d0a2..000000000000 --- a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages.md +++ /dev/null @@ -1,134 +0,0 @@ ---- -title: Configuring the CodeQL action for compiled languages -shortTitle: コンパイルされた言語を設定する -intro: 'You can configure how {% data variables.product.prodname_dotcom %} uses the {% data variables.product.prodname_codeql_workflow %} to scan code written in compiled languages for vulnerabilities and errors.' -product: '{% data reusables.gated-features.code-scanning %}' -permissions: 'リポジトリへの書き込み権限を持つユーザは、リポジトリの {% data variables.product.prodname_code_scanning %} を設定できます。' -redirect_from: - - /github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-for-compiled-languages -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.code-scanning.beta %} -{% data reusables.code-scanning.enterprise-enable-code-scanning-actions %} - -### About the {% data variables.product.prodname_codeql_workflow %} and compiled languages - -You enable {% data variables.product.prodname_dotcom %} to run {% data variables.product.prodname_code_scanning %} for your repository by adding a {% data variables.product.prodname_actions %} workflow to the repository. **Note**: This article refers to {% data variables.product.prodname_code_scanning %} powered by {% data variables.product.prodname_codeql %}, not to {% data variables.product.prodname_code_scanning %} resulting from the upload of third-party static analysis tools. デフォルトの {% data variables.product.prodname_code_scanning %} ワークフローは、`on.push` イベントを使用して、ワークフローファイルを含むブランチへのプッシュごとにコードスキャンをトリガーします。 - -{% data reusables.code-scanning.edit-workflow %} -For general information about configuring {% data variables.product.prodname_code_scanning %} and editing workflow files, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)" and "[Configuring a workflow](/actions/configuring-and-managing-workflows/configuring-a-workflow)." - -### {% data variables.product.prodname_codeql %} の autobuild について - -{% data reusables.code-scanning.autobuild-compiled-languages %} - -{% note %} - -**注釈**: {% data variables.product.prodname_actions %} にセルフホストランナーを使用する場合、`autobuild` プロセスを使用するために追加のソフトウェアをインストールする必要がある場合があります。 さらに、リポジトリに特定のバージョンのビルドツールが必要な場合は、手動でインストールする必要があります。 詳しい情報については「[GitHUbホストランナーにインストールされているソフトウェア](/actions/reference/software-installed-on-github-hosted-runners)」を参照してください。 - -{% endnote %} - -#### C/C++ - -| サポートされているシステムの種類 | システム名 | -| ---------------- | ------------------------------------------------- | -| オペレーティングシステム | Windows、Linux | -| ビルドシステム | Autoconf、CMake、qmake、Meson、Waf、SCons、Linux Kbuild | - -`autobuild` ステップの動作は、抽出を実行するオペレーティングシステムによって異なります。 Windows では、ステップにデフォルトのアクションはありません。 Linux では、このステップでリポジトリにあるファイルを確認して、使用されているビルドシステムを判断します。 - -1. ルートディレクトリでビルドシステムを探します。 -2. 何も見つからない場合は、C/C++ のビルドシステムで一意のディレクトリをサブディレクトリで検索します。 -3. 適切なコマンドを実行してシステムを設定します。 - -#### C - -| サポートされているシステムの種類 | システム名 | -| ---------------- | -------------------------- | -| オペレーティングシステム | Windows、Linux | -| ビルドシステム | .NET と MSbuild、およびビルドスクリプト | - -`autobuild` プロセスは、次のアプローチを使用して C# に適したビルドメソッドを自動検出しようとします。 - -1. ルートに最も近いソリューション（`.sln`）またはプロジェクト（`.csproj`）ファイルで `dotnet build` を呼び出します。 -2. ルートに最も近いソリューションまたはプロジェクトファイルで `MSbuild`（Linux）または `MSBuild.exe`（Windows）を呼び出します。 `autobuild` が最上位ディレクトリから同じ（最短）深度で複数のソリューションまたはプロジェクトファイルを検出した場合、それらすべてをビルドしようとします。 -3. ビルドスクリプトのように見えるスクリプト、つまり _build_ と _build.sh_（Linux の場合、この順序で）または _build.bat_、_build.cmd_、および _build.exe_（Windows の場合、この順序で）を呼び出します。 - -#### Java - -| サポートされているシステムの種類 | システム名 | -| ---------------- | ------------------------- | -| オペレーティングシステム | Windows、macOS、Linux（制限なし） | -| ビルドシステム | Gradle、Maven、Ant | - -`autobuild` プロセスは、この戦略を適用して Java コードベースのビルドシステムを決定しようとします。 - -1. ルートディレクトリでビルドファイルを検索します。 Gradle、Maven、Ant の各ビルドファイルを確認します。 -2. 最初に見つかったビルドファイルを実行します。 Gradle ファイルと Maven ファイルの両方が存在する場合は、Gradle ファイルが使用されます。 -3. それ以外の場合は、ルートディレクトリの直接サブディレクトリ内でビルドファイルを検索します。 1 つのサブディレクトリにのみビルドファイルが含まれている場合は、そのサブディレクトリで識別された最初のファイルを実行します（1 と同じ環境設定を使用）。 複数のサブディレクトリにビルドファイルが含まれている場合は、エラーを報告します。 - -### コンパイル言語のビルドステップを追加する - -{% data reusables.code-scanning.autobuild-add-build-steps %} ワークフローの編集については、「[{% data variables.product.prodname_code_scanning %} を設定する](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#editing-a-code-scanning-workflow)」を参照してください。 - -`autobuild` ステップを削除した後、`run` ステップのコメントを外して、リポジトリに適したビルドコマンドを追加します。 ワークフロー `run` ステップは、オペレーティングシステムのシェルを使用してコマンドラインプログラムを実行します。 これらのコマンドを変更し、さらにコマンドを追加して、ビルドプロセスをカスタマイズできます。 - -``` yaml -- run: | - make bootstrap - make release -``` - -`run` キーワードに関する詳しい情報については、「"[{% data variables.product.prodname_actions %}のためのワークフローの構文](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)」を参照してください。 - -ビルドマトリックスを使用してワークフローを更新し、複数のコンパイルされた言語をビルドすることもできます（これがシステムに適切なアプローチであり、競合が発生しない場合）。 詳しい情報については、「[ビルドマトリックスを設定する](/actions/configuring-and-managing-workflows/configuring-a-workflow#configuring-a-build-matrix)」を参照してください。 - - -たとえば、以下のワークフローでは、C/C + 分析用のジョブと、Java 分析用の別のジョブを実行します。 - -```yaml - -name: "Code Scanning - Action" - -on: - pull_request: - branches: [master] - push: - branches: [master] - -jobs: - CodeQL-Build: - - strategy: - fail-fast: false - matrix: - language: [ 'cpp', 'java'] - - # CodeQL runs on ubuntu-latest, windows-latest, and macos-latest - runs-on: ubuntu-latest - - steps: - - name: Checkout repository - uses: actions/checkout@v2 - - # Initializes the CodeQL tools for scanning. - - name: Initialize CodeQL - uses: github/codeql-action/init@v1 - with: - languages: ${{ matrix.language }} - - # Autobuild attempts to build any compiled languages (C/C++, C#, or Java). - # このステップが失敗した場合は、それを削除して手動でビルドを実行する必要があります。 - - name: Autobuild - uses: github/codeql-action/autobuild@v1 - - - name: Perform CodeQL Analysis - uses: github/codeql-action/analyze@v1 -``` - -`autobuild` がコードをビルドしない理由に関するヒントと方法については、「[{% data variables.product.prodname_code_scanning %} のトラブルシューティング](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning)」を参照してください。 - -コンパイルされた言語の手動ビルドステップを追加した場合、またはビルドマトリックスを使用しても、{% data variables.product.prodname_code_scanning %} がリポジトリで機能しない場合は、{% data variables.contact.contact_support %} にお問い合わせください。 diff --git a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning.md b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning.md deleted file mode 100644 index f3e49b9a2787..000000000000 --- a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: コードスキャンを有効化する -intro: 'プロジェクトのリポジトリで {% data variables.product.prodname_code_scanning %} を有効化できます。' -product: '{% data reusables.gated-features.code-scanning %}' -permissions: 'リポジトリへの書き込み権限を持つユーザは、リポジトリの {% data variables.product.prodname_code_scanning %} を有効化できます。' -redirect_from: - - /github/managing-security-vulnerabilities/configuring-automated-code-scanning -versions: - free-pro-team: '*' ---- - -{% data reusables.code-scanning.beta %} - -### {% data variables.product.prodname_code_scanning %} の有効化 - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-security %} -3. [Code scanning] の右側にある [**Set up code scanning**] をクリックします。 ![Security Overview の "Set up code scanning" の右側にある "Set up code scanning" ボタン](/assets/images/help/security/overview-set-up-code-scanning.png) -4. [Get started with code scanning] で、[**Set up this workflow**] をクリックします。 !["Get started with code scanning" 見出しの下の "Set up this workflow" ボタン](/assets/images/help/repository/code-scanning-set-up-this-workflow.png) -5. 必要に応じて、{% data variables.product.prodname_code_scanning %} がコードをスキャンする方法をカスタマイズするには、ワークフローを編集します。 詳しい情報については、「[{% data variables.product.prodname_code_scanning %} を設定する](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)」を参照してください。 -6. [**Start commit**] ドロップダウンを使用して、コミットメッセージを入力します。 ![コミットを開始する](/assets/images/help/repository/start-commit-commit-new-file.png) -7. デフォルトブランチに直接コミットするか、新しいブランチを作成してプルリクエストを開始するかを選択します。 ![コミット先を選択する](/assets/images/help/repository/start-commit-choose-where-to-commit.png) -8. [**Commit new file**] または [**Propose new file**] をクリックします。 - -ワークフローファイルをコミットするかプルリクエストを作成すると、{% data variables.product.prodname_code_scanning %} は、ワークフローファイルで指定した頻度に従ってコードを分析します。 プルリクエストを作成した場合、{% data variables.product.prodname_code_scanning %} は、プルリクエストをリポジトリのデフォルトブランチにマージするまで、プルリクエストのトピックブランチのコードのみを分析します。 - -### 次のステップ - -{% data variables.product.prodname_code_scanning %} を有効にすると、分析を監視し、結果を表示して、コードのスキャン方法をさらにカスタマイズできます。 - -- {% data variables.product.prodname_code_scanning %} の実行ステータスを表示して、実行完了通知を取得できます。 詳しい情報については、「[ワークフローの実行の管理](/actions/configuring-and-managing-workflows/managing-a-workflow-run)」および「[通知を設定する](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)」を参照してください。 -- スキャンが完了したら、完了したスキャンのアラートを表示できます。 詳しい情報については、「[{% data variables.product.prodname_code_scanning %} からのアラートを管理する](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)」を参照してください。 -- {% data variables.product.prodname_code_scanning %} がリポジトリ内のコードをスキャンする方法をカスタマイズできます。 詳しい情報については、「[コードスキャンを設定する](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)」を参照してください。 diff --git a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning.md b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning.md deleted file mode 100644 index c91baf64641d..000000000000 --- a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning.md +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: コードスキャンからのアラートを管理する -shortTitle: アラートを管理する -intro: プロジェクトのコードの潜在的な脆弱性またはエラーのアラートを表示、修正、およびクローズすることができます。 -product: '{% data reusables.gated-features.code-scanning %}' -permissions: 'リポジトリへの書き込み権限を持つユーザは、リポジトリの {% data variables.product.prodname_code_scanning %} アラートを管理できます。' -redirect_from: - - /github/managing-security-vulnerabilities/managing-alerts-from-automated-code-scanning -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.code-scanning.beta %} -{% data reusables.code-scanning.enterprise-enable-code-scanning %} - -### {% data variables.product.prodname_code_scanning %} からのアラートについて - -After you enable {% data variables.product.prodname_code_scanning %}, {% data variables.product.prodname_dotcom %} displays {% data variables.product.prodname_code_scanning %} alerts in your repository. デフォルトの {% data variables.product.prodname_code_scanning %} ワークフローは、`on.push` イベントを使用して、ワークフローファイルを含むブランチへのプッシュごとにコードスキャンをトリガーします。 - -Each alert highlights a problem with the code and the name of the tool that identified it. アラートをトリガーしたコード行と、アラートのプロパティ（問題の重要度や性質など）を確認できます。 アラートは、問題が最初に発生したときにも通知します。 For alerts identified by {% data variables.product.prodname_codeql %} analysis, you will also see information on how to fix the problem. - -![{% data variables.product.prodname_code_scanning %} からのアラートの例](/assets/images/help/repository/code-scanning-alert.png) - -アラートが推奨するアクションを実行しない場合は、アラートを手動で閉じることができます。 たとえば、テストに使用されるコードのアラートを閉じたり、アラートが誤検知であると思われる場合に閉じたりすることができます。 コーディングエラーを修正する手間がコードを改善する潜在的な利点よりも上回る場合は、アラートを閉じることもできます。 - -デフォルトでは、{% data variables.product.prodname_dotcom %} はデフォルトブランチと保護されたブランチのアラートを表示します。 アラートのリストをソートおよびフィルタして、関連するアラートのみを表示できます。 - -プルリクエストで発生したアラートを確認して、すぐに対処できます。 {% data variables.product.prodname_code_scanning %} がプルリクエストで脆弱性またはエラーを検出すると、{% data variables.product.prodname_dotcom %} は、プルリクエストのタイムラインと差分ビューに注釈を表示します。 - -If you enable {% data variables.product.prodname_code_scanning %} using {% data variables.product.prodname_codeql %}, this can also detect data-flow problems in your code. Data-flow analysis finds potential security issues in code, such as: using data insecurely, passing dangerous arguments to functions, and leaking sensitive information. - -{% data variables.product.prodname_code_scanning %} がデータフローアラートを報告すると、{% data variables.product.prodname_dotcom %} はデータがコードを通してどのように移動するかを示します。 {% data variables.product.prodname_code_scanning_capc %} allows you to identify the areas of your code that leak sensitive information, and that could be the entry point for attacks by malicious users. - -{% data reusables.code-scanning.you-can-upload-third-party-analysis %} {% data reusables.code-scanning.get-started-uploading-third-party-data %} - -If you scan your code using a third-party tool or scan your code with custom {% data variables.product.prodname_codeql %} queries, {% data variables.product.prodname_dotcom %} will only use the supported SARIF 2.1.0 properties to display alerts. サードパーティツールまたはカスタムクエリの結果には、{% data variables.product.company_short %} のデフォルトの {% data variables.product.prodname_codeql %} クエリを使用してコードをスキャンしたときに表示されるすべてのプロパティが含まれていない場合があります。 詳しい情報については「[{% data variables.product.prodname_code_scanning %}の SARIF サポート](/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning)」を参照してください。 - -### アラートを表示する - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-security %} -{% data reusables.repositories.sidebar-code-scanning-alerts %} -{% data reusables.code-scanning.click-alert-in-list %} -5. 必要に応じて、アラートでデータフローの問題が強調表示された場合は、[**Show paths**] をクリックしてデータのパスを確認します。 ![データフローアラートの例](/assets/images/help/repository/code-scanning-show-paths.png) - -### アラートを閉じる - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-security %} -{% data reusables.repositories.sidebar-code-scanning-alerts %} -{% data reusables.code-scanning.click-alert-in-list %} -5. [Close] ドロップダウンを使用して、アラートを閉じる理由をクリックします。 ![[Close] ドロップダウンでアラートを閉じる理由を選択する](/assets/images/help/repository/code-scanning-alert-close-drop-down.png) - -### 参考リンク - -- 「[{% data variables.product.prodname_code_scanning_capc %}](http://developer.github.com/v3/code-scanning)」 -- "[{% data variables.product.prodname_code_scanning_capc %} API](/v3/code-scanning)" diff --git a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-results-from-code-scanning.md b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-results-from-code-scanning.md deleted file mode 100644 index 56a7a3704fda..000000000000 --- a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-results-from-code-scanning.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: コードスキャンの結果を管理する -shortTitle: 結果を管理する -intro: '{% data variables.product.prodname_code_scanning %} が検出した脆弱性とエラーを表示してトリアージし、理解して解決できます。' -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning.md b/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning.md deleted file mode 100644 index 36819579483d..000000000000 --- a/translations/ja-JP/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning.md +++ /dev/null @@ -1,130 +0,0 @@ ---- -title: Troubleshooting code scanning -shortTitle: Troubleshooting -intro: 'You can see tips to resolve common issues with {% data variables.product.prodname_code_scanning %}.' -product: '{% data reusables.gated-features.code-scanning %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.code-scanning.beta %} -{% data reusables.code-scanning.enterprise-enable-code-scanning %} - -### Automatic build for a compiled language fails - -If an automatic build of code for a compiled language within your project fails, try the following troubleshooting steps. - -- Remove the `autobuild` step from your {% data variables.product.prodname_code_scanning %} workflow and add specific build steps. For information about editing the workflow, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#editing-a-code-scanning-workflow)." For more information about replacing the `autobuild` step, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." -- If the repository for your project contains code in a specific language that does not build, disable automatic language detection in your {% data variables.product.prodname_code_scanning %} workflow and specify only the languages you want to build. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#overriding-automatic-language-detection)." - -### No code found during the build - -If your workflow fails with an error `No source code was seen during the build` or `The process '/opt/hostedtoolcache/CodeQL/0.0.0-20200630/x64/codeql/codeql' failed with exit code 32`, this indicates that {% data variables.product.prodname_codeql %} was unable to trace your code. Several reasons can explain such a failure: - -1. Automatic language detection identified a supported language, but there is no analyzable code of that language in the repository. A typical example is when our language detection service finds a file associated with a particular programming language like a `.h`, or `.gyp` file, but no corresponding executable code is present in the repository. To solve the problem, you can manually define the languages you want to analyze by updating the `init` step to specify the supported languages that are present in your repository. For example, the following configuration will analyze only Go, and JavaScript. - - ```yaml - - name: Initialize CodeQL - uses: github/codeql-action/init@v1 - with: - languages: go, javascript # Other options are csharp, python, cpp, java - ``` -2. Your {% data variables.product.prodname_code_scanning %} workflow is analyzing a compiled language (C, C++, C#, or Java), but the code was not compiled. By default, the {% data variables.product.prodname_codeql %} analysis workflow contains an `autobuild` step, however, this step represents a best effort process, and may not succeed in building your code, depending on your specific build environment. Compilation may also fail if you have removed the `autobuild` step and did not include build steps manually. For more information about specifying build steps, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." -3. Your workflow is analyzing a compiled language (C, C++, C#, or Java), but portions of your build are cached to improve performance (most likely to occur with build systems like Gradle or Bazel). Since {% data variables.product.prodname_codeql %} observes the activity of the compiler to understand the data flows in a repository, {% data variables.product.prodname_codeql %} requires a complete build to take place in order to perform analysis. -4. Your workflow is analyzing a compiled language (C, C++, C#, or Java), but compilation does not occur between the `init` and `analyze` steps in the workflow. {% data variables.product.prodname_codeql %} requires that your build happens in between these two steps in order to observe the activity of the compiler and perform analysis. -5. Your compiled code (in C, C++, C#, or Java) was compiled successfully, but {% data variables.product.prodname_codeql %} was unable to detect the compiler invocations. The most common causes are certain configuration options like running your build process in a container, if you're building using a distributed build system external to {% data variables.product.prodname_actions %} using a daemon process, or if {% data variables.product.prodname_codeql %} isn't aware of the specific compiler you are using. - 1. For C# projects using either `dotnet build` or `msbuild` which target .NET Core 2, you should specify `/p:UseSharedCompilation=false` in your workflow's `run` step, when you build your code. The `UseSharedCompilation` flag isn't necessary for .NET Core 3.0 and later. - - For example, the following configuration will pass the flag during the first build step. - - ```yaml - - run: | - dotnet build /p:UseSharedCompilation=false - ``` - 2. If you encounter another problem with your specific compiler or configuration, contact {% data variables.contact.contact_support %}. - -For more information about specifying build steps, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." - -### Portions of my repository were not analyzed using `autobuild` - -The {% data variables.product.prodname_codeql %} `autobuild` feature uses heuristics to build the code in a repository, however, sometimes this approach results in incomplete analysis of a repository. For example, when multiple `build.sh` commands exist in a single repository, the analysis may not complete since the `autobuild` step will only execute one of the commands. The solution is to replace the `autobuild` step with build steps which build all of the source code which you wish to analyze. Alternatively, if more than one compiled language is present in your repository and you want {% data variables.product.prodname_code_scanning %} to analyze all these compiled languages, you can use a build matrix in your workflow. {% if currentVersion ver_gt "enterprise-server@2.21" %}To use a build matrix, you should make sure that {% data variables.product.prodname_actions %} is enabled on {% data variables.product.product_location_enterprise %}. {% endif %}For more information, see "[Managing complex workflows](/actions/learn-github-actions/managing-complex-workflows/#using-a-build-matrix)" and -"[Configuring the {% data variables.product.prodname_codeql %} action for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages#adding-build-steps-for-a-compiled-language)." - -### Error: "Server error" - -If the run of a workflow for {% data variables.product.prodname_code_scanning %} fails due to a server error, try running the workflow again. If the problem persists, contact {% data variables.contact.contact_support %}. - -### Error: "Out of disk" or "Out of memory" - -On very large projects, {% data variables.product.prodname_codeql %} may run out of disk or memory on the runner. -{% if currentVersion == "free-pro-team@latest" %}If you encounter this issue on a hosted {% data variables.product.prodname_actions %} runner, contact {% data variables.contact.contact_support %} so that we can investigate the problem. -{% else %}If you encounter this issue, try increasing the memory on the runner.{% endif %} - -### The build takes too long - -If your build with {% data variables.product.prodname_codeql %} analysis takes too long to run, there are several approaches you can try to reduce the build time. - -#### Increase the memory or cores - -If you use self-hosted runners to run {% data variables.product.prodname_codeql %} analysis, you can increase the memory or the number of cores on those runners. - -#### Use matrix builds to parallelize the analysis - -By default, {% data variables.product.prodname_codeql %} performs analysis of each language sequentially, which can impact performance, especially for repositories with more than one language. You can speed analysis up by using a build matrix that splits the analysis by language. {% if currentVersion ver_gt "enterprise-server@2.21" %}To use a build matrix, you should make sure that {% data variables.product.prodname_actions %} is enabled on {% data variables.product.product_location_enterprise %}. {% endif %}For more information, see "[Managing complex workflows](/actions/learn-github-actions/managing-complex-workflows/#using-a-build-matrix)." - -For example, the workflow below will be run with one job for JavaScript analysis, and another job for Go analysis. - -```yaml - -name: "Code Scanning - Action" - -on: - pull_request: - branches: [main] - push: - branches: [main] - -jobs: - CodeQL-Build: - - strategy: - fail-fast: false - matrix: - language: [ 'go', 'javascript'] - - # CodeQL runs on ubuntu-latest, windows-latest, and macos-latest - runs-on: ubuntu-latest - - steps: - - name: Checkout repository - uses: actions/checkout@v2 - - # Initializes the CodeQL tools for scanning. - - name: Initialize CodeQL - uses: github/codeql-action/init@v1 - with: - languages: ${{ matrix.language }} - - # Autobuild attempts to build any compiled languages (C/C++, C#, or Java). - # If this step fails, then you should remove it and run the build manually (see below). - - name: Autobuild - uses: github/codeql-action/autobuild@v1 - - - name: Perform CodeQL Analysis - uses: github/codeql-action/analyze@v1 -``` - -#### Reduce the amount of code being analyzed in a single workflow - -Analysis time is typically proportional to the amount of code being analyzed. You can reduce the analysis time by reducing the amount of code being analyzed at once, for example, by excluding test code, or breaking analysis into multiple workflows that analyze only a subset of your code at a time. - -For compiled languages like Java, C, C++, and C#, {% data variables.product.prodname_codeql %} analyzes all of the code which was built during the workflow run. To limit the amount of code being analyzed, build only the code which you wish to analyze by specifying your own build steps in a `run` block. You can combine specifying your own build steps with using the `paths` or `paths-ignore` filters on the `pull_request` and `push` events to ensure that your workflow only runs when specific code is changed. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)." - -For interpreted languages like Go, JavaScript, Python, and TypeScript, that {% data variables.product.prodname_codeql %} analyzes without a specific build, you can specify additional configuration options to limit the amount of code to analyze. For more information, see "[Specifying directories to scan](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#specifying-directories-to-scan)." - -If you split your analysis into multiple workflows as described above, we still recommend that you have at least one workflow which runs on a `schedule` which analyzes all of the code in your repository. Because {% data variables.product.prodname_codeql %} analyzes data flows between components, some complex security behaviors may only be detected on a complete build. - -#### Run only during a `schedule` event - -If your analysis is still too slow to be run during `push` or `pull_request` events, then you may want to only trigger analysis on the `schedule` event. For more information, see "[Events](/actions/learn-github-actions/introduction-to-github-actions#events)." diff --git a/translations/ja-JP/content/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies.md b/translations/ja-JP/content/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies.md deleted file mode 100644 index 676ca3046588..000000000000 --- a/translations/ja-JP/content/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies.md +++ /dev/null @@ -1,57 +0,0 @@ ---- -title: 脆弱性のある依存関係に対するセキュリティアラートについて -intro: '{% data variables.product.product_name %} は、リポジトリに影響を及ぼす脆弱性を検出すると、セキュリティアラートを送信します。' -redirect_from: - - /articles/about-security-alerts-for-vulnerable-dependencies -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -### セキュリティの脆弱性について - -{% data reusables.repositories.a-vulnerability-is %}重大度やプロジェクトの依存関係により異なりますが、脆弱性はプロジェクトあるいはプロジェクトを利用する人々に、幅広い問題を引き起こすことがあります。 {% data variables.product.product_name %}リポジトリ中の依存関係の特定の種類の脆弱性は、追跡して解決できます。 - -{% data variables.product.prodname_dotcom %} が、リポジトリの依存関係グラフの依存関係の1つで {% data variables.product.prodname_advisory_database %} または [WhiteSource](https://www.whitesourcesoftware.com/GitHubSecurityAlerts) からの脆弱性を検出した場合、セキュリティアラートが送信されます。 {% data variables.product.prodname_advisory_database %}に関する詳しい情報については、「{% data variables.product.prodname_advisory_database %}におけるセキュリティ脆弱性をブラウズする」を参照してください。 - -{% if currentVersion == "free-pro-team@latest" %} -### 脆弱性のある依存関係に対するアラートと自動的なセキュリティアップデート -{% else %} -### 脆弱性のある依存対象に関するセキュリティアラート -{% endif %} - -GitHub Advisory Databaseに新しい脆弱性が追加されると、影響を受けるバージョンの依存関係を使用する{% if currentVersion == "free-pro-team@latest" %}パブリック{% endif %}リポジトリ{% if currentVersion == "free-pro-team@latest" %}（および脆弱性検出をオプトインしたプライベートリポジトリ）{% endif %}を特定し{% if currentVersion == "free-pro-team@latest" %}、セキュリティアラートをリポジトリメンテナに送信し、自動セキュリティアップデートを生成して{% else %}、セキュリティアラートをリポジトリメンテナに送信します{% endif %}。 - -各セキュリティアラートには、重要度{% if currentVersion == "free-pro-team@latest" %}、プロジェクト内で影響を受けるファイルへのリンク、およびその脆弱性を解決する、自動的なセキュリティアップデートを含んだプルリクエストが含まれます{% else %}、およびプロジェクト内で影響を受けるファイルへのリンクが含まれます{% endif %}。 また、脆弱性についての詳細情報が提供されることもあります。 - -{% if currentVersion == "free-pro-team@latest" %}リポジトリの [Alerts] タブまたは{% endif %}リポジトリの依存関係グラフに、特定のプロジェクトに影響するすべてのアラートが表示されます。{% if currentVersion == "free-pro-team@latest" %}詳細は、「[リポジトリ内の脆弱な依存関係を表示・更新する](/articles/viewing-and-updating-vulnerable-dependencies-in-your-repository)」を参照してください。{% endif %} - -デフォルトでは、影響を受けるリポジトリで管理者権限を持つ人々にセキュリティアラートが送られます。 {% data variables.product.product_name %} は、いかなるリポジトリについても特定された脆弱性を公開することはありません。{% if currentVersion == "free-pro-team@latest" %}セキュリティアラートは、Organization が所有しているリポジトリで作業している人々や Team に対して有効化することもできます。 詳細は「[Organization のリポジトリ内の脆弱性のある依存関係に関するアラートを管理する](/articles/managing-alerts-for-vulnerable-dependencies-in-your-organization-s-repositories)」を参照してください。{% endif %} - -{% data reusables.repositories.enable-security-alerts %} -{% if currentVersion == "free-pro-team@latest" %} -自動的なセキュリティアップデートは、脆弱性のある依存関係を、脆弱性を解決する最小のバージョンに更新します。 自動的なセキュリティアップデートは、依存関係グラフとセキュリティアラートを使用しているリポジトリにおいて自動的に有効化されますが、自動的なプルリクエストを無効化して、代わりにセキュリティアップデートをマニュアルで生成するよう選択することも可能です。 詳細は「[自動的なセキュリティアップデートを設定する](/github/managing-security-vulnerabilities/configuring-automated-security-updates)」を参照してください。 - -{% data variables.product.prodname_dotcom %} は、デフォルトで_パブリック_なリポジトリ内の脆弱性を持つ依存関係を検出し、アラートを発します。 _プライベート_リポジトリ内の脆弱性を持つ依存関係に対してセキュリティアラートを受けるには、リポジトリのオーナーまたはリポジトリに管理権限を持つ人がリポジトリの依存グラフと脆弱性アラートを有効にしなければなりません。 詳しい情報については[プライベートリポジトリ用のデータ利用のオプトインもしくはオプトアウト](/articles/opting-into-or-out-of-data-use-for-your-private-repository)を参照してください。 -{% endif %} - -{% data variables.product.product_name %} が脆弱性と依存関係を検出できるサポート言語のリストについては、「[リポジトリが依存するパッケージのリスト](/articles/listing-the-packages-that-a-repository-depends-on)」を参照してください。 - -{% warning %} - -**メモ**: セキュリティアラートのような {% data variables.product.product_name %} のセキュリティの機能は、すべての脆弱性を捕捉するものではありません。 弊社は常に脆弱性データベースを更新し、最新の情報でアラートを発するよう努力していますが、すべての問題を捕捉することや、既知の脆弱性について一定の時間内で確実にアラートを発することは不可能です。 これらの機能は、それぞれの依存関係の潜在的な脆弱性やその他の問題に関する人によるレビューを置き換えるものではなく、必要な場合にはセキュリティサービスによるコンサルティングや、総合的な脆弱性レビューを行うことをおすすめします。 - -{% endwarning %} - -### セキュリティアラートの通知を設定する - -デフォルトでは、{% if currentVersion == "free-pro-team@latest" %}特定の脆弱性ごとにグループ化された{% endif %}セキュリティアラートがメールで送信されます。 セキュリティアラートは、最大10個のリポジトリのアラートをまとめた毎週のメール、Web通知、または {% data variables.product.product_name %} ユーザインターフェースで受信するように選択することもできます。 For more information, see {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}"[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#security-alert-options){% else %}"[Choosing the delivery method for your notifications ](/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications){% endif %}." - -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" % %}{% data reusables.repositories.security-alerts-x-github-severity %} For more information, see {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}"[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#filtering-email-notifications){% else %}"[About email notifications](/github/receiving-notifications-about-activity-on-github/about-email-notifications){% endif %}."{% endif %} - -### 参考リンク - -{% if currentVersion == "free-pro-team@latest" %}- [自動的なセキュリティアップデートを設定する](/github/managing-security-vulnerabilities/configuring-automated-security-updates) -- [リポジトリ内の脆弱な依存関係を表示・更新する](/articles/viewing-and-updating-vulnerable-dependencies-in-your-repository) -- [{% data variables.product.product_name %} によるデータの利用方法と保護方法を理解する](/categories/understanding-how-github-uses-and-protects-your-data){% endif %} -- MITREの[「脆弱性」の定義](https://cve.mitre.org/about/terminology.html#vulnerability) diff --git a/translations/ja-JP/content/github/managing-security-vulnerabilities/configuring-automated-security-updates.md b/translations/ja-JP/content/github/managing-security-vulnerabilities/configuring-automated-security-updates.md deleted file mode 100644 index 11cc7f48f307..000000000000 --- a/translations/ja-JP/content/github/managing-security-vulnerabilities/configuring-automated-security-updates.md +++ /dev/null @@ -1,92 +0,0 @@ ---- -title: 自動セキュリティアップデートを設定する -intro: 自動または手動のプルリクエストを使って、脆弱性のある依存対象を簡単に更新できます。 -redirect_from: - - /articles/configuring-automated-security-fixes - - /github/managing-security-vulnerabilities/configuring-automated-security-fixes -versions: - free-pro-team: '*' ---- - -### 自動セキュリティアップデートについて - -セキュリティアラートと依存関係グラフを使っているどのリポジトリに対しても、自動セキュリティアップデートを有効化できます。 個々のリポジトリ、またはユーザアカウントあるいは Organization が所有するすべてのリポジトリの自動セキュリティアップデートを無効にすることができます。 - -リポジトリで脆弱性のある依存関係についてのセキュリティアラートを受信した場合、そのセキュリティアラートに対応するプルリクエスト内の自動セキュリティアップデートを使って、脆弱性を解決できます。 自動セキュリティアップデートは、依存関係グラフを使っているリポジトリ内で利用できます。 デフォルトでは、{% data variables.product.prodname_dotcom %} は、脆弱性のある依存関係を、脆弱性を避けるために必要な、可能な限り最小のバージョンに更新するため、リポジトリ内に自動的にプルリクエストを作成します。 自動的なプルリクエストを無効にし、手動でプルリクエストを作成して任意で脆弱性を更新するようにすることもできます。 - -自動的なセキュリティリクエストには、リリースノート、変更ログのエントリ、コミットの詳細などの、脆弱性についての情報を含めて、提案された修正を素早く安全にレビューしマージするために必要なものがすべて含まれています。 - -自動セキュリティアップデートは、{% data variables.product.prodname_dotcom %} の代理である Dependabot によりオープンされます。 Dependabot {% data variables.product.prodname_github_app %} は、自動セキュリティアップデートが有効なすべてのリポジトリに、自動的にインストールされます。 - -リポジトリのセキュリティアラートにアクセスできる人には、関連するセキュリティアラートのリンクが表示されます。ただし、リポジトリのセキュリティアラートにアクセスできないがプルリクエストにはアクセスできる人は、プルリクエストがどの脆弱性を解決するかを見ることはできません。 - -自動セキュリティアップデートを含むプルリクエストをマージすると、リポジトリの対応するセキュリティアラートは解決済みとマークされます。 - -{% note %} - -**注釈:** 自動セキュリティアップデートが解決するのは、セキュリティの脆弱性のみです。 自動セキュリティアップデートは、プライベートレジストリや、プライベートリポジトリにホストされたパッケージにある脆弱性を解決するようには作られていません。 - -{% endnote %} - -### サポートされているリポジトリ - -{% data variables.product.prodname_dotcom %} は、これらの要件を満たすすべてのリポジトリの自動セキュリティアップデートを自動的に有効にします。 - -{% note %} - -**注釈**: 2019年11月以前に作成されたリポジトリについては、リポジトリが次の基準を満たし、2019年5月23日以降に少なくとも1回のプッシュを受け取った場合、{% data variables.product.prodname_dotcom %} は自動セキュリティアップデートを自動的に有効にしています。 - -{% endnote %} - -| 要件 | 詳細 | -| ------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| リポジトリがフォークではない | 「[フォークについて](/github/collaborating-with-issues-and-pull-requests/about-forks)」 | -| リポジトリがアーカイブされていない | 「[リポジトリをアーカイブする](/github/creating-cloning-and-archiving-repositories/archiving-repositories)」 | -| リポジトリがパブリックである、またはリポジトリがプライベートであり、リポジトリの設定で {% data variables.product.prodname_dotcom %}、依存関係グラフ、および脆弱性アラートによる読み取り専用分析が有効化されている | 「[プライベートリポジトリのデータ使用をオプトインする](/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-data-use-for-your-private-repository#opting-into-data-use-for-your-private-repository)」 | -| リポジトリに {% data variables.product.prodname_dotcom %} がサポートするパッケージエコシステムの依存関係マニフェストファイルが含まれている | 「[サポートされているパッケージエコシステム](/github/visualizing-repository-data-with-graphs/listing-the-packages-that-a-repository-depends-on#supported-package-ecosystems)」 | -| 自動セキュリティアップデートがリポジトリに対して無効化されていない | 「[リポジトリの自動セキュリティアップデートを管理する](#managing-automated-security-updates-for-your-repository)」 | -| リポジトリが依存関係管理の統合をまだ使用していない | "[インテグレーションについて](/github/customizing-your-github-workflow/about-integrations)" | - -リポジトリで自動セキュリティアップデートが有効になっておらず、その原因が不明の場合は、[サポートにお問い合わせ](https://support.github.com/contact)ください。 - -### 互換性スコアについて - -自動セキュリティアップデートには、互換性スコアも含まれています。これは、脆弱性を更新することで、プロジェクトに破壊的な変更が起こる可能性があるかどうかを知らせるものです。 弊社では、アップデートによりテストが失敗するかどうかを確認するため、既存のセキュリティアップデートを生成したパブリックリポジトリから、以前にパスした CI テストを調べます。 更新の互換性スコアは、依存関係に関するバージョンの更新前後で、実行した CI がパスした割合です。 - -### リポジトリの自動セキュリティアップデートを管理する - -個々のリポジトリの自動セキュリティアップデートは、有効化または無効化できます。 - -自動セキュリティアップデートには、特定のリポジトリ設定が必要です。 詳しい情報については、「[サポートされているリポジトリについて](#supported-repositories)」を参照してください。 - -{% data reusables.repositories.you-can-enable-or-disable-security-features %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-security %} -4. アラート一覧の上にあるドロップダウンメニューで [**Automated security updates**] を選択または選択解除します。 ![自動セキュリティアップデートを有効にするオプションがあるドロップダウンメニュー](/assets/images/help/repository/enable-automated-security-updates-drop-down.png) - -### ユーザアカウントの自動セキュリティアップデートを管理する - -ユーザアカウントが所有するすべてのリポジトリの自動セキュリティアップデートを無効にすることができます。 その場合でも、ユーザアカウントが所有する個々のリポジトリの自動セキュリティアップデートを有効にすることができます。 - -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.security %} -{% data reusables.repositories.opt-out-automated-security-updates %} - -### Organization の自動セキュリティアップデートを管理する - -Organization のオーナーは、Organization が所有するすべてのリポジトリの自動セキュリティアップデートを無効にすることができます。 その場合、Organization が所有する個々のリポジトリに対する管理者権限を持つユーザは、そのリポジトリの自動セキュリティアップデートを有効にすることができます。 - -{% data reusables.repositories.you-can-enable-or-disable-security-features %} - -{% data reusables.profile.access_profile %} -{% data reusables.profile.access_org %} -{% data reusables.organizations.org_settings %} -{% data reusables.organizations.security %} -{% data reusables.repositories.opt-out-automated-security-updates %} - -### 参考リンク - -- 「[脆弱性のある依存関係に対するセキュリティアラートについて](/articles/about-security-alerts-for-vulnerable-dependencies)」 -- 「[プライベートリポジトリのデータ使用をオプトインする](/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-data-use-for-your-private-repository#opting-into-data-use-for-your-private-repository)」 -- 「[サポートされているパッケージエコシステム](/github/visualizing-repository-data-with-graphs/listing-the-packages-that-a-repository-depends-on#supported-package-ecosystems)」 diff --git a/translations/ja-JP/content/github/managing-security-vulnerabilities/managing-alerts-for-vulnerable-dependencies-in-your-organization.md b/translations/ja-JP/content/github/managing-security-vulnerabilities/managing-alerts-for-vulnerable-dependencies-in-your-organization.md deleted file mode 100644 index e00a33f07b3d..000000000000 --- a/translations/ja-JP/content/github/managing-security-vulnerabilities/managing-alerts-for-vulnerable-dependencies-in-your-organization.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: Organization で脆弱性のある依存関係に関するアラートを管理する -intro: 'Organization のリポジトリで脆弱性のある依存関係を検出すると、Organization のオーナーとリポジトリ管理者は {% data variables.product.prodname_dependabot_alerts %} を受け取ります。 書き込みアクセスのある追加の Organization メンバーまたは Team も、脆弱性のある依存関係に関するアラートを受け取るよう指定することができます。' -redirect_from: - - /articles/managing-alerts-for-vulnerable-dependencies-in-your-organization-s-repositories/ - - /articles/managing-alerts-for-vulnerable-dependencies-in-your-organizations-repositories/ - - /articles/managing-alerts-for-vulnerable-dependencies-in-your-organization -versions: - free-pro-team: '*' ---- - -{% if currentVersion == "free-pro-team@latest" %} -{% data reusables.repositories.you-can-manage-access-to-security-alerts %} -{% endif %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -3. 左サイドバーで、[**Dependabot alerts**] をクリックします。 ![[Settings] サイドバーの [Dependabot alerts] タブ](/assets/images/help/settings/settings-sidebar-dependabot-alerts.png) -4. {% data variables.product.product_name %} が脆弱性のある依存関係を検出したときに {% data variables.product.prodname_dependabot_alerts %} を受け取るユーザまたは Team の名前を入力し、ユーザ名または Team 名をクリックして選択します。 -5. {% data variables.product.prodname_dependabot_alerts %} を受け取るすべてのユーザまたは Team を選択したら、[**Save changes**] をクリックします。 - -### 参考リンク - -- 「[脆弱性のある依存関係に対するアラートについて](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)」 -- [リポジトリ内の脆弱な依存関係を表示・更新する](/articles/viewing-and-updating-vulnerable-dependencies-in-your-repository) -- 「[Organization のセキュリティと分析設定を管理する](/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization)」 diff --git a/translations/ja-JP/content/github/searching-for-information-on-github/searching-code-for-exact-matches.md b/translations/ja-JP/content/github/searching-for-information-on-github/searching-code-for-exact-matches.md deleted file mode 100644 index 874ab5c95bd4..000000000000 --- a/translations/ja-JP/content/github/searching-for-information-on-github/searching-code-for-exact-matches.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: コードで完全一致を検索する -intro: '{% data variables.product.prodname_dotcom %}のリポジトリでは、コードで完全一致を検索できます。' -redirect_from: - - /github/searching-for-information-on-github/searching-files-in-a-repository-for-exact-matches -permissions: People with read permissions to a repository can search the repository's files for exact matches. -versions: - free-pro-team: '*' ---- - -{% note %} - -{% data reusables.search.exact-match-beta %} ベータへのアクセスをリクエストするには、[待ちリストに参加](https://github.com/features/code-search-exact-match/signup)してください。 - -{% endnote %} - -### コードでの完全一致の検索について - -{% data reusables.search.exact-match %} - -デフォルトでは、完全一致の検索は大文字小文字と記号を区別し、部分一致と正規表現は使用できません。 たとえば、`let ReactDOM*`と検索しても`let ReactDOM*`しか返されません。 - -### コードで完全一致を検索する - -{% note %} - -リポジトリ内のファイルでの完全一致の検索が機能するのは、ベータリリースでインデックス化されたリポジトリだけです。 - -{% endnote %} - -{% data reusables.repositories.navigate-to-repo %} -2. In the search field, type the string you'd like to find. ![Exact match search string](/assets/images/help/search/exact-match-search-string.png) -3. Optionally, click the **Options** drop-down to narrow your search. ![Exact match search Options drop-down](/assets/images/help/search/exact-match-options.png) -4. Press Enter or Return on your keyboard. -5. 結果のリストで、ファイルをクリックします。 - -### 参考リンク - -- 「[コード検索](/github/searching-for-information-on-github/searching-code)」 -- [ {% data variables.product.product_name %} 上のコード間を移動する](/github/managing-files-in-a-repository/navigating-code-on-github) diff --git a/translations/ja-JP/content/github/site-policy/github-enterprise-cloud-addendum.md b/translations/ja-JP/content/github/site-policy/github-enterprise-cloud-addendum.md deleted file mode 100644 index 0593dd757c33..000000000000 --- a/translations/ja-JP/content/github/site-policy/github-enterprise-cloud-addendum.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: GitHub Enterprise Cloudの補遺 -redirect_from: - - /github-business-cloud-addendum/ - - /articles/github-enterprise-cloud-addendum -versions: - free-pro-team: '*' ---- - -These are the additional terms for GitHub Enterprise Cloud ("Enterprise Cloud Terms"). Any capitalized terms not defined in these Enterprise Cloud Terms will be defined in the [Terms of Service](/articles/github-terms-of-service/) or the [Corporate Terms of Service](/articles/github-corporate-terms-of-service/). By agreeing to these Enterprise Cloud Terms, you also agree to the Terms of Service, as determined by the type of account you have. - -Enterprise Cloud includes an Organization account, SAML single sign-on, access provisioning, and 24/5 support with an 8-hour response time. ここに挙げた機能やサービスは網羅的なものではなく、随時アップデートされる可能性があります。 For more information, see [GitHub's pricing page](https://github.com/pricing). - -### 定義: -- Active User: means a user trying to access our Service at the time of an Outage. -- Customer: person or entity who has purchased Enterprise Cloud from GitHub. -- Eligible User: means an individual who is designated as a member of the Customer's Enterprise Cloud organization by having their individual GitHub account associated with the Customer's Enterprise Cloud account. -- Essential Services: means the services essential to GitHub's core version control functionality, including features and services such as creating, forking, and cloning repositories; creating, committing, and merging branches; creating, reviewing, and merging pull requests; and, web, API, and Git client interfaces to the core Git workflows. The following are examples of peripheral features and services not included: webhooks, Gists, Pages, or email notifications. -- Outage: means the interruption of an Essential Service that affects more than 50% of Active Users. -- Service Credit: a dollar credit, calculated as set forth below, that we may credit back to an eligible account. - -### Enterprise Cloud Uptime SLA - -Program Benefits: -- We guarantee that the service will have a quarterly Uptime percentage of 99.95%. つまり、GitHubの「可欠なサービス」は、50%を超える「アクティブユーザ」に影響するような障害で中断する確率が、四半期当たり0.5%を超えないということです。 -- If we don't meet our 99.95% quarterly Uptime guarantee, we may issue Service Credits to Customers. - -How do we calculate Uptime? -- Our Uptime calculation is based on the percentage of successful requests we serve through our web, API, and Git client interfaces. - -What's excluded from our Uptime guarantee? Outages resulting from: -- Customer's acts, omissions, or misuse of the Services, including violations of the Terms of Service. -- Failures of your internet connectivity -- Factors outside our reasonable control, including Internet access related problems, force majeure events, and third party services or technology -- Your equipment, services, or other technology - -What are Uptime Service Credits, how can I find out if I have them, and how can I redeem them? -- If GitHub's quarterly Uptime percentage drops below our 99.95% Uptime guarantee, then Customer is entitled to receive 25 times the amount that was paid for the Outage time that exceeds the quarterly Uptime guarantee ("Uptime Service Credit"), which will be applied against the Customer's next bill. Uptime Service Credits are calculated at the end of each quarter, and may only be granted upon request. -- To find out about GitHub's Uptime percentage, you can request an Uptime report at the end of each quarter. -- In order to be granted Uptime Service Credits, either an account Owner or Billing Manager must send in a written request, on Customer's behalf, within 30 days of the end of each quarter. Uptime Service Credits may not be saved. After being granted an Uptime Service Credit, it will be automatically applied to Customer's next bill. Written requests should be sent to {% data variables.contact.contact_support %}. - -**Disclaimer and Limitation of Liability:** GitHub's [Status Page](https://www.githubstatus.com/) is not connected to this Uptime SLA and is not an accurate representation of GitHub's Uptime for the purposes of calculating Uptime Service Credits. Service Credits are limited to 30 days of paid service, per quarter. Service Credits are Customer's only remedy for any failure by GitHub to meet any Uptime obligations as identified in this Addendum. diff --git a/translations/ja-JP/content/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-data-use-for-your-private-repository.md b/translations/ja-JP/content/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-data-use-for-your-private-repository.md deleted file mode 100644 index 075302061088..000000000000 --- a/translations/ja-JP/content/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-data-use-for-your-private-repository.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: プライベートリポジトリ用のデータ利用のオプトインもしくはオプトアウト -intro: '{% data variables.product.product_name %} で、関連するツール、人、プロジェクト、情報につなげるには、プライベートリポジトリ用のデータをオプトインします。 プライベートリポジトリ用のデータをオプトインし、{% data variables.product.product_name %} でデータを使用する必要がなくなった場合は、オプトアウトできます。' -redirect_from: - - /articles/opting-into-or-out-of-data-use-for-your-private-repository -versions: - free-pro-team: '*' ---- - -### プライベートリポジトリ用のデータ利用について - -プライベートリポジトリのデータ利用をオプトインすると、依存グラフにアクセスできます。依存グラフでは、リポジトリの依存関係を追跡し、{% data variables.product.product_name %} が脆弱な依存関係を検出したときにセキュリティアラートを受け取ることができます。 詳しい情報については[脆弱性のある依存関係に対するセキュリティアラートについて](/articles/about-security-alerts-for-vulnerable-dependencies)を参照してください。 - -{% data reusables.repositories.you-can-enable-or-disable-security-features %} - -### プライベートリポジトリ用のデータ利用のオプトイン - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -3. [Data services] で、[**Allow {% data variables.product.prodname_dotcom %} to perform read-only analysis of this repository**] を選択します。 ![[Allow {% data variables.product.prodname_dotcom %} to perform read-only analysis of this repository] チェックボックス](/assets/images/help/repository/private-repo-data-use-opt-in.png) -4. オプションで、データ利用を有効にしたい追加のサービスの隣にあるチェックボックスを選択します。 ![追加するサービスとそのチェックボックスのリスト](/assets/images/help/repository/private-repo-data-use-additional-services.png) - -### プライベートリポジトリ用のデータ利用のオプトアウト - -{% tip %} - -**ヒント:** 特定のサービス用のデータ利用をオプトアウトするには、サービスの隣にあるチェックボックスの選択を解除します。 - -{% endtip %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -3. [Data services] で、[**Allow {% data variables.product.prodname_dotcom %} to perform read-only analysis of this repository**] の選択を解除します。 ![[Allow {% data variables.product.prodname_dotcom %} to perform read-only analysis of this repository] チェックボックス](/assets/images/help/repository/private-repo-data-use-opt-out.png) - -### 参考リンク - -- [{% data variables.product.prodname_dotcom %} によるユーザのデータの利用について](/articles/about-github-s-use-of-your-data) -- 「[リポジトリ内の脆弱な依存関係を表示・更新する](/articles/viewing-and-updating-vulnerable-dependencies-in-your-repository)」 -- [Organization のリポジトリ内の脆弱性のある依存関係に関するアラートの管理](/articles/managing-alerts-for-vulnerable-dependencies-in-your-organization-s-repositories) diff --git a/translations/ja-JP/content/github/using-git/changing-author-info.md b/translations/ja-JP/content/github/using-git/changing-author-info.md deleted file mode 100644 index 14c369c971f0..000000000000 --- a/translations/ja-JP/content/github/using-git/changing-author-info.md +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: 作者情報の変更 -redirect_from: - - /change-author-info/ - - /changing-author-info/ - - /articles/changing-author-info -intro: 既存のコミットに記録された名前やメールアドレスを変更するには、Git リポジトリの履歴全体を書き換える必要があります。 -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -{% warning %} - -**警告**: このアクションはリポジトリの履歴を乱します。 リポジトリを他の人と共同で利用している場合、公開済みの履歴を書き換えるのは好ましくない行為です。 これを行うのは、緊急時のみにとどめるべきです。 - -{% endwarning %} - -### スクリプトによるリポジトリの Git 履歴の変更 - -作者またはコミッターのフィールドに、古いメールアドレスがあるものを正しい名前およびメールアドレスに変更するスクリプトを作成しました。 - -{% tip %} - -**メモ**: このスクリプトを実行すると、そのリポジトリの全コラボレータの履歴が書き換えられます。 この手順を実行した後、フォークやクローンをしている人は書き換えられた履歴をフェッチし、書き換えられた履歴にローカルの変更をすべてリベースする必要があります。 - -{% endtip %} - -このスクリプトを実行する前に、以下を準備する必要があります: - -* 変更したい作者/コミッターフィールドに表示されている、古いメールアドレス -* コミットに関連付けたい正しい名前およびメールアドレス - -{% data reusables.command_line.open_the_multi_os_terminal %} -2. 以下のコマンドで、リポジトリの、新しいベアクローンを作成します: - ```shell - git clone --bare https://{% data variables.command_line.codeblock %}/user/repo.git - cd repo.git - ``` -3. スクリプトをコピーして貼り付けます。以下の変数については、収集した情報に基づいて置き換えてください: - * `OLD_EMAIL (古いメールアドレス)` - * `CORRECT_NAME (正しい名前)` - * `CORRECT_EMAIL (正しいメールアドレス)` - - ```shell - #!/bin/sh - - git filter-branch --env-filter ' - - OLD_EMAIL="your-old-email@example.com" - CORRECT_NAME="Your Correct Name" - CORRECT_EMAIL="your-correct-email@example.com" - - if [ "$GIT_COMMITTER_EMAIL" = "$OLD_EMAIL" ] - then - export GIT_COMMITTER_NAME="$CORRECT_NAME" - export GIT_COMMITTER_EMAIL="$CORRECT_EMAIL" - fi - if [ "$GIT_AUTHOR_EMAIL" = "$OLD_EMAIL" ] - then - export GIT_AUTHOR_NAME="$CORRECT_NAME" - export GIT_AUTHOR_EMAIL="$CORRECT_EMAIL" - fi - ' --tag-name-filter cat -- --branches --tags - ``` - -4. [**Enter**] を押してスクリプトを実行します。 -5. 新しい Git 履歴に間違いがないかレビューします。 -6. 以下のコマンドで、修正した履歴を {% data variables.product.product_name %} にプッシュします: - ```shell - git push --force --tags origin 'refs/heads/*' - ``` -7. 以下のコマンドで、テンポラリなクローンをクリーンアップします: - ```shell - cd .. - rm -rf repo.git - ``` diff --git a/translations/ja-JP/content/github/using-git/updating-credentials-from-the-osx-keychain.md b/translations/ja-JP/content/github/using-git/updating-credentials-from-the-osx-keychain.md deleted file mode 100644 index eb251fc528e5..000000000000 --- a/translations/ja-JP/content/github/using-git/updating-credentials-from-the-osx-keychain.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: OSX キーチェーンから認証情報を更新する -intro: '{% data variables.product.product_name %} でユーザ名、パスワード、たまは個人アクセストークンを変更した場合は、保存されている認証情報を `git-credential-osxkeychain` ヘルパーで更新する必要があります。' -redirect_from: - - /articles/updating-credentials-from-the-osx-keychain -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -{% data reusables.user_settings.password-authentication-deprecation %} - -### キーチェーンアクセスを介して認証情報を更新する - -1. [Finder] で、**Keychain Access** アプリケーションを検索します。 ![スポットライト検索バー](/assets/images/help/setup/keychain-access.png) -2. キーチェーン Access で、**{% data variables.command_line.backticks %}** を探してください。 -3. `{% data variables.command_line.backticks %}` の「internet password」エントリを見つけてください。 ![キーチェーンの GitHub パスワード入力内容](/assets/images/help/setup/keychain-entry.png) -4. 適宜、エントリを編集または削除します。 - -### コマンドラインで認証情報を削除する - -コマンドラインを通じて、認証情報ヘルパーを使ってキーチェーン エントリを直接、削除できます。 - -これを行うために、次のコマンドを入力してください: - -```shell -$ git credential-osxkeychain erase -host={% data variables.command_line.codeblock %} -protocol=https -> [Press Return] -``` - -成功した場合、何もプリントアウトされません。 動作をテストするには、{% data variables.product.product_location %} からリポジトリをクローンしてみます。 パスワードを尋ねられた場合、キーチェーンは削除されています。 - -### 参考リンク - -- "[Git で {% data variables.product.prodname_dotcom %} 認証情報をキャッシュ](/github/using-git/caching-your-github-credentials-in-git/)" diff --git a/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository.md b/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository.md deleted file mode 100644 index 4b3cbe7f8e98..000000000000 --- a/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository.md +++ /dev/null @@ -1,65 +0,0 @@ ---- -title: Exploring the dependencies and dependents of a repository -intro: 'Using the dependency graph, you can see the packages your project depends on and the repositories that depend on it. In addition, you can see any vulnerabilities detected in its dependencies.' -redirect_from: - - /articles/listing-the-packages-that-a-repository-depends-on - - /github/visualizing-repository-data-with-graphs/listing-the-packages-that-a-repository-depends-on - - /articles/listing-the-projects-that-depend-on-a-repository - - /github/visualizing-repository-data-with-graphs/listing-the-projects-that-depend-on-a-repository -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -### Viewing the dependency graph - -{% data reusables.repositories.enable-security-alerts %} - -The dependency graph has tabs that show the dependencies and dependents of your repository. For information about how these views are populated and which ecosystems are supported, see "[About the dependency graph](about-the-dependency-graph)." - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.accessing-repository-graphs %} -{% data reusables.repositories.click-dependency-graph %} -4. Optionally, under "Dependency graph", click **Dependents**. ![依存関係グラフ ページの [Dependents] タブ](/assets/images/help/graphs/dependency-graph-dependents-tab.png) - -#### Dependencies view - -Dependencies are grouped by ecosystem. You can expand a dependency to view its dependencies. For dependencies hosted on {% data variables.product.product_name %}, you can also click a dependency to view the repository. If vulnerabilities have been detected in the repository, these are shown at the top of the view for users with access to {% if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %}. - -![依存関係グラフ](/assets/images/help/graphs/dependencies_graph.png) - -#### Dependents view - -For public repositories, the dependents view shows how the repository is used by other repositories. To show only the repositories that contain a library in a package manager, click **NUMBER Packages** immediately above the list of dependent repositories. The dependent counts are approximate and may not always match the dependents listed. - -![依存グラフ](/assets/images/help/graphs/dependents_graph.png) - -{% if currentVersion == "free-pro-team@latest" %} -### Enabling and disabling the dependency graph for a private repository - -Repository administrators can enable or disable the dependency graph for private repositories. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -{% data reusables.repositories.navigate-to-security-and-analysis %} -4. Read the message about granting {% data variables.product.product_name %} read-only access to the repository data to enable the dependency graph, then next to "Dependency Graph", click **Enable**. !["Enable" button for the dependency graph](/assets/images/help/repository/dependency-graph-enable-button.png) - -You can disable the dependency graph at any time by clicking **Disable** next to "Dependency Graph" on the Security & analysis tab. -{% endif %} - -### 依存関係グラフのトラブルシューティング - -If your dependency graph is empty, there may be a problem with the file containing your dependencies. Check the file to ensure that it's correctly formatted for the file type. - -{% if currentVersion == "free-pro-team@latest" %} -If the file is correctly formatted, then check its size. The dependency graph ignores individual manifest and lock files that are over 0.5 Mb, unless you are a {% data variables.product.prodname_enterprise %} user. It processes up to 20 manifest or lock files per repository by default, so you can split dependencies into smaller files in subdirectories of the repository.{% endif %} - -If a manifest or lock file is not processed, its dependencies are omitted from the dependency graph and they can't be checked for vulnerable dependencies. - -### 参考リンク - -- "[About the dependency graph](about-the-dependency-graph)"{% if currentVersion == "free-pro-team@latest" %} -- [Organization のインサイトを表示する](/github/setting-up-and-managing-organizations-and-teams/viewing-insights-for-your-organization) -- [リポジトリ内の脆弱な依存関係を表示・更新する](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository) -- [{% data variables.product.product_name %}によるデータの利用と保護の方法の理解](/github/understanding-how-github-uses-and-protects-your-data) -{% endif %} diff --git a/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/listing-the-packages-that-a-repository-depends-on.md b/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/listing-the-packages-that-a-repository-depends-on.md deleted file mode 100644 index c2906b0ef709..000000000000 --- a/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/listing-the-packages-that-a-repository-depends-on.md +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: リポジトリが依存するパッケージをリストする -intro: プロジェクトの依存関係を表示し、脆弱性が検出された場合にはそれも表示することができます。 -redirect_from: - - /articles/listing-the-packages-that-a-repository-depends-on -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -### 依存関係グラフについて - -依存関係グラフは、サポートされているパッケージエコシステムで、サポートされているファイル形式を使って、{% if currentVersion == "free-pro-team@latest" %}パブリック{% endif %}リポジトリごとに利用できます。{% if currentVersion == "free-pro-team@latest" %}リポジトリ管理者は、プライベートリポジトリの依存関係グラフも設定できます。{% endif %} - -{% data reusables.repositories.enable-security-alerts %} - -リポジトリの依存関係グラフでは、脆弱な依存関係を表示して更新することができます。 他の依存関係より前に、脆弱な依存関係がリストされます。 詳しい情報については[脆弱性のある依存関係に対するセキュリティアラートについて](/articles/about-security-alerts-for-vulnerable-dependencies)を参照してください。 - -{% if currentVersion == "free-pro-team@latest" %} -Organization のリポジトリで使われている依存関係を、1 つのダッシュボードで表示できます。 詳細は「[Organization のインサイトを表示する](/articles/viewing-insights-for-your-organization#viewing-organization-dependency-insights)」を参照してください。{% endif %} - -### サポートされているパッケージエコシステム - -| パッケージマネージャー | 言語 | 推奨されるフォーマット | サポートされているフォーマット | -| ------------ | ---------------------- | -------------------------------------------------- | -------------------------------------------------------------------- | -| Maven | Java、Scala | `pom.xml` | `pom.xml` | -| npm | JavaScript | `package-lock.json` | `package-lock.json`、`package.json` | -| Yarn | JavaScript | `yarn.lock` | `package.json`、`yarn.lock` | -| `dotnet` CLI | .NET 言語 (C#、C++、F#、VB) | `.csproj`、`.vbproj`、`.nuspec`、`.vcxproj`、`.fsproj` | `.csproj`、`.vbproj`、`.nuspec`、`.vcxproj`、`.fsproj`、`packages.config` | -| Python PIP | Python | `requirements.txt`、`pipfile.lock` | `requirements.txt`、`pipfile.lock`、`setup.py`* | -| RubyGems | Ruby | `Gemfile.lock` | `Gemfile.lock`、`Gemfile`、`*.gemspec` | -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}| Composer | PHP | `composer.lock` | `composer.json`、`composer.lock` |{% endif %} - -{% note %} - -**メモ:** `setup.py` ファイルで Python の依存関係をリストする場合、プロジェクトの各依存関係の解析やリスト、あるいは依存関係についてのアラート生成はできないことがあります。 - -{% endnote %} - -### 依存関係グラフを有効にしたリポジトリの依存関係をリストする - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.accessing-repository-graphs %} -{% data reusables.repositories.click-dependency-graph %} - -{% if currentVersion == "free-pro-team@latest" %} -### プライベートリポジトリの依存関係グラフを有効化する - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.accessing-repository-graphs %} -{% data reusables.repositories.click-dependency-graph %} -4. 依存関係グラフを有効化するには、{% data variables.product.product_name %} にリポジトリ データへのアクセスを許可する必要があるというメッセージを読んだうえで、[**Allow access**] をクリックします。 ![リポジトリ データへのアクセスを許可して依存関係グラフを有効化するボタン](/assets/images/help/repository/dependency-graph-allow-access-button.png) - -詳細は「[{% data variables.product.product_name %} によるデータの利用方法と保護方法を理解する](/categories/understanding-how-github-uses-and-protects-your-data)」を参照してください。 - -### プライベートリポジトリの依存関係グラフを無効化する - -{% data reusables.repositories.you-can-enable-or-disable-security-features %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -3. [Data services] で、[**Dependency graph**] の選択を解除します。 ![依存グラフを無効化するチェックボックス](/assets/images/help/repository/private-repo-data-use-dependency-graph-disabled.png) - -リポジトリのデータ利用をオプトアウトするには、「[プライベートリポジトリ用のデータ利用のオプトインもしくはオプトアウト](/articles/opting-into-or-out-of-data-use-for-your-private-repository)」を参照してください。 -{% endif %} - -### 依存関係グラフのトラブルシューティング - -{% data reusables.repositories.troubleshooting-dependency-graph %} - -### 参考リンク - -- [リポジトリに依存するプロジェクトのリスト](/articles/listing-the-projects-that-depend-on-a-repository){% if currentVersion == "free-pro-team@latest" %} -- [{% data variables.product.product_name %}によるデータの利用と保護の方法の理解](/categories/understanding-how-github-uses-and-protects-your-data) -- [リポジトリ内の脆弱な依存関係を表示・更新する](/articles/viewing-and-updating-vulnerable-dependencies-in-your-repository){% endif %} diff --git a/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/listing-the-projects-that-depend-on-a-repository.md b/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/listing-the-projects-that-depend-on-a-repository.md deleted file mode 100644 index eadcb91100a1..000000000000 --- a/translations/ja-JP/content/github/visualizing-repository-data-with-graphs/listing-the-projects-that-depend-on-a-repository.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: リポジトリに依存するプロジェクトのリスト -intro: リポジトリに依存するパッケージおよびプロジェクトを、依存グラフで表示することができます。 -redirect_from: - - /articles/listing-the-projects-that-depend-on-a-repository -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -### 依存グラフについて -依存グラフには、パッケージとアプリケーション両方に関するデータが含まれます。 パッケージはパッケージ マネージャーにライブラリを含むリポジトリであり、アプリケーションは選択したリポジトリに依存するリポジトリです。 依存グラフでのアプリケーションのリストは、リポジトリに依存する直近のプロジェクトごとにソートされます。 - -依存グラフには、次の言語のデータが表示されます: - -- RubyGems -- NPM -- PyPI -- Maven (pom.xml のみ) -- Nuget - -{% data reusables.repositories.enable-security-alerts %} - -{% note %} - -**メモ:** 依存カウントは概数であり、リストされる依存の数に一致しない場合があります。 - -{% endnote %} - -![依存グラフ](/assets/images/help/graphs/dependents_graph.png) - -### 依存グラフにアクセスする - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.accessing-repository-graphs %} -{% data reusables.repositories.click-dependency-graph %} -4. [Dependency graph] で **[Dependents]** をクリックします。 ![依存関係グラフ ページの [Dependents] タブ](/assets/images/help/graphs/dependency-graph-dependents-tab.png) - -### 参考リンク - -- [リポジトリが依存するパッケージのリスト](/articles/listing-the-packages-that-a-repository-depends-on){% if currentVersion == "free-pro-team@latest" %} -- [Organization のインサイトを表示する](/articles/viewing-insights-for-your-organization){% endif %} diff --git a/translations/ja-JP/content/rest/reference/endpoints-available-for-github-apps.md b/translations/ja-JP/content/rest/reference/endpoints-available-for-github-apps.md deleted file mode 100644 index 7444c977520a..000000000000 --- a/translations/ja-JP/content/rest/reference/endpoints-available-for-github-apps.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: Endpoints available for GitHub Apps -intro: Your app can make requests to the following REST endpoints. -redirect_from: - - /v3/apps/available-endpoints -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -You must use an installation access token to access endpoints using your {% data variables.product.prodname_github_app %}. For more information, see "[Authenticating with {% data variables.product.prodname_github_apps %}](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)." - -{% include rest_enabled_for_github_apps_in_current_version %} diff --git a/translations/ja-JP/data/reusables/actions/actions-app-read-permissions-sh-org.md b/translations/ja-JP/data/reusables/actions/actions-app-read-permissions-sh-org.md deleted file mode 100644 index 89cc846f3e23..000000000000 --- a/translations/ja-JP/data/reusables/actions/actions-app-read-permissions-sh-org.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_github_app %}s must have the `self-hosted runners:read` organization permission to use this endpoint. \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/actions/actions-app-secrets-org-permissions.md b/translations/ja-JP/data/reusables/actions/actions-app-secrets-org-permissions.md deleted file mode 100644 index 4f41e05ae20e..000000000000 --- a/translations/ja-JP/data/reusables/actions/actions-app-secrets-org-permissions.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_github_app %}s must have the `secrets` organization permission to use this endpoint. \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/actions/actions-app-secrets-permissions.md b/translations/ja-JP/data/reusables/actions/actions-app-secrets-permissions.md deleted file mode 100644 index 7709eb5b2e53..000000000000 --- a/translations/ja-JP/data/reusables/actions/actions-app-secrets-permissions.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_github_app %}s must have the `secrets` repository permission to use this endpoint. \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/actions/actions-app-write-permissions-sh-org.md b/translations/ja-JP/data/reusables/actions/actions-app-write-permissions-sh-org.md deleted file mode 100644 index f330c2358998..000000000000 --- a/translations/ja-JP/data/reusables/actions/actions-app-write-permissions-sh-org.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_github_app %}s must have the `self-hosted runners:write` organization permission to use this endpoint. \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/actions/actions-downloads.md b/translations/ja-JP/data/reusables/actions/actions-downloads.md deleted file mode 100644 index 4c460aaa0ac4..000000000000 --- a/translations/ja-JP/data/reusables/actions/actions-downloads.md +++ /dev/null @@ -1 +0,0 @@ -`-v`フラグを使ってこのエンドポイントを呼ぶと、出力が詳しくなり、ダウンロードURLをヘッダ内で見ることができるようになります。 現在のワーキングディレクトリにファイルをダウンロードするには、`-o`フラグを使ってファイル名を指定してください。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/actions/actions-secret-encyption-examples.md b/translations/ja-JP/data/reusables/actions/actions-secret-encyption-examples.md deleted file mode 100644 index 5d4170efae6c..000000000000 --- a/translations/ja-JP/data/reusables/actions/actions-secret-encyption-examples.md +++ /dev/null @@ -1,70 +0,0 @@ -#### Node.jsを使用してシークレットを暗号化する例 - -[tweetsodium](https://github.com/github/tweetsodium)ライブラリを使ってシークレットを暗号化する - -```js -const sodium = require('tweetsodium'); - -const key = "base64-encoded-public-key"; -const value = "plain-text-secret"; - -// メッセージとキーをUint8Array(このインターフェースを実装したBuffer)に変換する -const messageBytes = Buffer.from(value); -const keyBytes = Buffer.from(key, 'base64'); - -// LibSodiumを使って暗号化する。 -const encryptedBytes = sodium.seal(messageBytes, keyBytes); - -// 暗号化されたシークレットをBase64化 -const encrypted = Buffer.from(encryptedBytes).toString('base64'); - -console.log(encrypted); -``` - -#### Pythonを使ってシークレットを暗号化する例 - -[pynacl](https://pynacl.readthedocs.io/en/stable/public/#nacl-public-sealedbox)をPython 3と使ってシークレットを暗号化する - -```py -from base64 import b64encode -from nacl import encoding, public - -def encrypt(public_key: str, secret_value: str) -> str: - """Unicode文字列を公開鍵を使って暗号化する。""" - from base64 import b64encode -from nacl import encoding, public - -def encrypt(public_key: str, secret_value: str) -> str: - """Unicode文字列を公開鍵を使って暗号化する。 -``` - -#### C#を使ってシークレットを暗号化する例 - -Encrypt your secret using the [Sodium.Core](https://www.nuget.org/packages/Sodium.Core/) package. - -```csharp -var secretValue = System.Text.Encoding.UTF8.GetBytes("mySecret"); -var publicKey = Convert.FromBase64String("2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvvcCU="); - -var sealedPublicKeyBox = Sodium.SealedPublicKeyBox.Create(secretValue, publicKey); - -Console.WriteLine(Convert.ToBase64String(sealedPublicKeyBox)); -``` - -#### Example encrypting a secret using Ruby - -Encrypt your secret using the [rbnacl](https://github.com/RubyCrypto/rbnacl) gem. - -```ruby -require "rbnacl" -require "base64" - -key = Base64.decode64("+ZYvJDZMHUfBkJdyq5Zm9SKqeuBQ4sj+6sfjlH4CgG0=") -public_key = RbNaCl::PublicKey.new(key) - -box = RbNaCl::Boxes::Sealed.from_public_key(public_key) -encrypted_secret = box.encrypt("my_secret") - -# Print the base64 encoded secret -puts Base64.strict_encode64(encrypted_secret) -``` diff --git a/translations/ja-JP/data/reusables/actions/gh-app-actions-read-permissions.md b/translations/ja-JP/data/reusables/actions/gh-app-actions-read-permissions.md deleted file mode 100644 index 08998b6efb12..000000000000 --- a/translations/ja-JP/data/reusables/actions/gh-app-actions-read-permissions.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_github_app %}s must have the `actions:read` permission to use this endpoint. \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/actions/gh-app-actions-write-permissions.md b/translations/ja-JP/data/reusables/actions/gh-app-actions-write-permissions.md deleted file mode 100644 index c7c714441f31..000000000000 --- a/translations/ja-JP/data/reusables/actions/gh-app-actions-write-permissions.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_github_app %}s must have the `actions:write` permission to use this endpoint. \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/actions/workflow-route-param-by-name.md b/translations/ja-JP/data/reusables/actions/workflow-route-param-by-name.md deleted file mode 100644 index 180e07aca148..000000000000 --- a/translations/ja-JP/data/reusables/actions/workflow-route-param-by-name.md +++ /dev/null @@ -1 +0,0 @@ -`:workflow_id`を`:workflow_file_name`で置き換えることもできます。 たとえば`main.yml`を使用できます。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/actions/workflow-usage.md b/translations/ja-JP/data/reusables/actions/workflow-usage.md deleted file mode 100644 index 90836167de81..000000000000 --- a/translations/ja-JP/data/reusables/actions/workflow-usage.md +++ /dev/null @@ -1 +0,0 @@ -Billable minutes only apply to workflows in private repositories that use {% data variables.product.prodname_dotcom %}-hosted runners. Usage is listed for each {% data variables.product.prodname_dotcom %}-hosted runner operating system in milliseconds. Any job re-runs are also included in the usage. The usage does not include the multiplier for macOS and Windows runners and is not rounded up to the nearest whole minute. For more information, see "[Managing billing for {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)". \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/actions/workflow_runs_parameters_table.md b/translations/ja-JP/data/reusables/actions/workflow_runs_parameters_table.md deleted file mode 100644 index 3bf966759c65..000000000000 --- a/translations/ja-JP/data/reusables/actions/workflow_runs_parameters_table.md +++ /dev/null @@ -1,8 +0,0 @@ -#### パラメータ - -| 名前 | 種類 | 説明 | -| ------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `actor` | `string` | 誰かのワークフローの実行を返します。 チェックスイートもしくはワークフローの実行に関連づけられた`push`を作成したユーザのログインを使います。 | -| `ブランチ` | `string` | ブランチに関連づけられたワークフローの実行を返します。 `push`のブランチ名を使います。 | -| `event` | `string` | 指定したイベントによってトリガーされたワークフローの実行を返します。 たとえば`push`、`pull_request`、`issue`などです。 詳しい情報については「[ワークフローをトリガーするイベント](/actions/automating-your-workflow-with-github-actions/events-that-trigger-workflows)」を参照してください。 | -| `ステータス` | `string` | 指定したチェックランの`status`もしくは`conclusion`に関連づけられたワークフローを返します。 たとえばconclusionは`success`になったり、statusは`completed`になったりします。 詳しい情報については、「[チェックランの作成](/v3/checks/runs/#create-a-check-run)」で利用できる`status`及び`conclusion`オプションを参照してください。 | diff --git a/translations/ja-JP/data/reusables/apps/access_token_parameters_table_and_example.md b/translations/ja-JP/data/reusables/apps/access_token_parameters_table_and_example.md deleted file mode 100644 index d2cbef34fe16..000000000000 --- a/translations/ja-JP/data/reusables/apps/access_token_parameters_table_and_example.md +++ /dev/null @@ -1,13 +0,0 @@ -#### パラメータ - -| 名前 | 種類 | 説明 | -| -------------- | -------- | ---------------------------------- | -| `access_token` | `string` | GitHub APIの認証に用いられるOAuthのアクセストークン。 | - -#### サンプル - -```json -{ - "access_token": "e72e16c7e42f292c6912e7710c838347ae178b4a" -} -``` diff --git a/translations/ja-JP/data/reusables/apps/app_req_account_deletion.md b/translations/ja-JP/data/reusables/apps/app_req_account_deletion.md deleted file mode 100644 index fc8f7cc458bd..000000000000 --- a/translations/ja-JP/data/reusables/apps/app_req_account_deletion.md +++ /dev/null @@ -1 +0,0 @@ -Apps must provide customers with a way to delete their account, without having to email or call a support person. diff --git a/translations/ja-JP/data/reusables/apps/authenticated_user_access.md b/translations/ja-JP/data/reusables/apps/authenticated_user_access.md deleted file mode 100644 index 7cc3cce83986..000000000000 --- a/translations/ja-JP/data/reusables/apps/authenticated_user_access.md +++ /dev/null @@ -1 +0,0 @@ -認証されたユーザは、所有するリポジトリ、コラボレータになっているリポジトリ、Organizationのメンバーシップを通じてアクセスできるリポジトリに対して明示的な権限を持ちます。 diff --git a/translations/ja-JP/data/reusables/apps/authorizations_oauth_tokens_SAML.md b/translations/ja-JP/data/reusables/apps/authorizations_oauth_tokens_SAML.md deleted file mode 100644 index c4170687433a..000000000000 --- a/translations/ja-JP/data/reusables/apps/authorizations_oauth_tokens_SAML.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -{% warning %} - -**警告:** アプリケーションは、GitHub SAML Organizationで利用できるOAuthトークンを取得するのに、[Webアプリケーションフロー](/apps/building-oauth-apps/authorizing-oauth-apps/#web-application-flow)を利用しなければなりません。 Authorizations APIを利用して作成されたOAuthトークンは、GitHub SAML Organizationにアクセスできなくなります。 詳しい情報については[ブログポスト](https://developer.github.com/changes/2019-11-05-deprecated-passwords-and-authorizations-api)を参照してください。 - -{% endwarning %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/apps/deprecating_applications_api_endpoints.md b/translations/ja-JP/data/reusables/apps/deprecating_applications_api_endpoints.md deleted file mode 100644 index c205b8a30ca3..000000000000 --- a/translations/ja-JP/data/reusables/apps/deprecating_applications_api_endpoints.md +++ /dev/null @@ -1,9 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -{% warning %} - -**非推奨の注意:** {% data variables.product.prodname_dotcom %}は、pathパラメーターに`access_token`を含むOAuthのエンドポイントを置き換え、廃止します。 `access_token`を入力パラメータとして使うことによって、OAuthアプリケーションのためにセキュアにトークンを管理できるようにする、新しいエンドポイントが導入されます。{% if currentVersion == "free-pro-team@latest" %}OAuthアプリケーションAPIは2021年5月5日に削除されます。{% endif %}{% if currentVersion == "free-pro-team@latest" %}予定された一時停止を含む{% endif %}詳しい情報については、[ブログポスト](https://developer.github.com/changes/2020-02-14-deprecating-oauth-app-endpoint/)を参照してください。 - -{% if currentVersion != "free-pro-team@latest" %}`access_token`をpathパラメータで利用するOAuthのエンドポイントは、現在利用可能で{% data variables.product.prodname_ghe_server %}ではまだ非推奨となっていません。 {% data variables.product.prodname_dotcom %}は、この機能のサポートの削除に先立って、非推奨化を告知し、通知を行います。{% endif %} - -{% endwarning %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/apps/deprecating_github_services_ghe_compact.md b/translations/ja-JP/data/reusables/apps/deprecating_github_services_ghe_compact.md deleted file mode 100644 index 6ffb0325d760..000000000000 --- a/translations/ja-JP/data/reusables/apps/deprecating_github_services_ghe_compact.md +++ /dev/null @@ -1 +0,0 @@ -GitHub Enterprise release 2.17 and higher no longer allows admins to install GitHub Services. Please see the [Replacing GitHub Services guide](/v3/guides/replacing-github-services) for details. \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/apps/deprecating_oauth_authorizations.md b/translations/ja-JP/data/reusables/apps/deprecating_oauth_authorizations.md deleted file mode 100644 index 335936741e3a..000000000000 --- a/translations/ja-JP/data/reusables/apps/deprecating_oauth_authorizations.md +++ /dev/null @@ -1,9 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -{% warning %} - -**Deprecation Notice:** {% data variables.product.prodname_dotcom %} will discontinue the OAuth Authorizations API, which is used by integrations to create personal access tokens and OAuth tokens, and you must now create these tokens using our [web application flow](/apps/building-oauth-apps/authorizing-oauth-apps/#web-application-flow).{% if currentVersion == "free-pro-team@latest" %} The OAuth Authorizations API will be removed on November, 13, 2020.{% endif %} For more information,{% if currentVersion == "free-pro-team@latest" %} including scheduled brownouts,{% endif %} see the [blog post](https://developer.github.com/changes/2020-02-14-deprecating-oauth-auth-endpoint/). - -{% if currentVersion != "free-pro-team@latest" %}OAuth Authorizations APIは現在利用可能で、{% data variables.product.prodname_ghe_server %}ではまだ非推奨となっていません｡ {% data variables.product.prodname_dotcom %}は、この機能のサポートの削除に先立って、非推奨化を告知し、通知を行います。{% endif %} - -{% endwarning %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/apps/iat_required.md b/translations/ja-JP/data/reusables/apps/iat_required.md deleted file mode 100644 index 5adc160d44f9..000000000000 --- a/translations/ja-JP/data/reusables/apps/iat_required.md +++ /dev/null @@ -1 +0,0 @@ -このエンドポイントにアクセスするには、[インストレーションアクセストークン](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)を使わなければなりません。 diff --git a/translations/ja-JP/data/reusables/apps/iat_required_multiple_endpoints.md b/translations/ja-JP/data/reusables/apps/iat_required_multiple_endpoints.md deleted file mode 100644 index 2147de3e7766..000000000000 --- a/translations/ja-JP/data/reusables/apps/iat_required_multiple_endpoints.md +++ /dev/null @@ -1 +0,0 @@ -You must use an [installation access token](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation) to access these endpoints. diff --git a/translations/ja-JP/data/reusables/apps/jwt_or_client_secret_required.md b/translations/ja-JP/data/reusables/apps/jwt_or_client_secret_required.md deleted file mode 100644 index 91d52c71e346..000000000000 --- a/translations/ja-JP/data/reusables/apps/jwt_or_client_secret_required.md +++ /dev/null @@ -1 +0,0 @@ -GitHub Appsがこのエンドポイントにアクセスするには[JWT](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app)を使わなければなりません。 OAuth Appsは、このエンドポイントにアクセスするのに自分のクライアントIDとクライアントシークレットで[基本認証](/v3/auth/#basic-authentication)を使わなければなりません。 diff --git a/translations/ja-JP/data/reusables/apps/jwt_required.md b/translations/ja-JP/data/reusables/apps/jwt_required.md deleted file mode 100644 index e219500137ea..000000000000 --- a/translations/ja-JP/data/reusables/apps/jwt_required.md +++ /dev/null @@ -1 +0,0 @@ -このエンドポイントへのアクセスには[JWT](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app)を使わなければなりません。 diff --git a/translations/ja-JP/data/reusables/apps/null-headbranch.md b/translations/ja-JP/data/reusables/apps/null-headbranch.md deleted file mode 100644 index 5490a593ec3f..000000000000 --- a/translations/ja-JP/data/reusables/apps/null-headbranch.md +++ /dev/null @@ -1 +0,0 @@ -The Checks API only looks for pushes in the repository where the check suite or check run were created. フォークされたリポジトリ内のブランチへのプッシュは検出されず、空の`pull_requests`配列と、`head_branch`に`null`値が返されます。 diff --git a/translations/ja-JP/data/reusables/apps/pat_or_ba_required.md b/translations/ja-JP/data/reusables/apps/pat_or_ba_required.md deleted file mode 100644 index faa31b84fa9e..000000000000 --- a/translations/ja-JP/data/reusables/apps/pat_or_ba_required.md +++ /dev/null @@ -1 +0,0 @@ -You must use a personal access token (which you can create via the [command line](/articles/creating-a-personal-access-token-for-the-command-line/) or the [OAuth Authorizations API](/v3/oauth_authorizations/#create-a-new-authorization)) or [Basic Authentication](/v3/auth/#basic-authentication) to access this endpoint. diff --git a/translations/ja-JP/data/reusables/apps/u2s_required.md b/translations/ja-JP/data/reusables/apps/u2s_required.md deleted file mode 100644 index 9a5e8ba578ef..000000000000 --- a/translations/ja-JP/data/reusables/apps/u2s_required.md +++ /dev/null @@ -1 +0,0 @@ -このエンドポイントにアクセスするには、GitHub Appを認可したユーザ用に作成された[user-to-server OAuthアクセストークン](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/#identifying-users-on-your-site)を使わなければなりません。 diff --git a/translations/ja-JP/data/reusables/apps/undetected-pushes-to-a-forked-repository-for-check-runs.md b/translations/ja-JP/data/reusables/apps/undetected-pushes-to-a-forked-repository-for-check-runs.md deleted file mode 100644 index 0a9466f38b46..000000000000 --- a/translations/ja-JP/data/reusables/apps/undetected-pushes-to-a-forked-repository-for-check-runs.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**ノート:** Checks APIは、チェックスイートもしくはチェック実行が作成されたリポジトリ内のプッシュのみを探します。 フォークされたリポジトリ内のブランチへのプッシュは検出されず、空の`pull_requests`配列が返されます。 - -{% endnote %} diff --git a/translations/ja-JP/data/reusables/blog/affected_users.md b/translations/ja-JP/data/reusables/blog/affected_users.md deleted file mode 100644 index a390a81ab553..000000000000 --- a/translations/ja-JP/data/reusables/blog/affected_users.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Note**: This update only affects users of GitHub.com and future versions of GitHub Enterprise. - -{% endnote %} diff --git a/translations/ja-JP/data/reusables/branches/apps-permissions.md b/translations/ja-JP/data/reusables/branches/apps-permissions.md deleted file mode 100644 index a549fc7d28dd..000000000000 --- a/translations/ja-JP/data/reusables/branches/apps-permissions.md +++ /dev/null @@ -1 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}Only installed {% data variables.product.prodname_github_app %}s with `write` access to the `contents` permission can be added as authorized actors on a protected branch.{% endif %} diff --git a/translations/ja-JP/data/reusables/branches/limits.md b/translations/ja-JP/data/reusables/branches/limits.md deleted file mode 100644 index 1242d37342d9..000000000000 --- a/translations/ja-JP/data/reusables/branches/limits.md +++ /dev/null @@ -1 +0,0 @@ -**Note**: The list of users{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, apps,{% endif %} and teams in total is limited to 100 items. diff --git a/translations/ja-JP/data/reusables/branches/rename-existing-branch.md b/translations/ja-JP/data/reusables/branches/rename-existing-branch.md deleted file mode 100644 index 174a317ddc65..000000000000 --- a/translations/ja-JP/data/reusables/branches/rename-existing-branch.md +++ /dev/null @@ -1,3 +0,0 @@ -While you can rename your repository's existing default branch, {% data variables.product.company_short %} plans to provide tools to simplify the process of renaming the default branch. For more information on these plans, see [`github/renaming`](https://github.com/github/renaming). - -If you have already renamed the default branch, {% data variables.product.prodname_dotcom %} will automatically redirect links on {% if currentVersion ver_gt "enterprise-server@2.22" %} {% data variables.product.product_location_enterprise %}{% else %}{% data variables.product.prodname_dotcom_the_website %}{% endif %} that contain a deleted `master` branch name to the equivalent link on the repository's default branch. diff --git a/translations/ja-JP/data/reusables/checks/conclusion_values.md b/translations/ja-JP/data/reusables/checks/conclusion_values.md deleted file mode 100644 index 420ceaff1cd9..000000000000 --- a/translations/ja-JP/data/reusables/checks/conclusion_values.md +++ /dev/null @@ -1 +0,0 @@ -**`completed_at`もしくは`completed`という`status`を提供する場合必須**です。 チェックの最終的な結果です。 Can be one of `success`, `failure`, `neutral`, `cancelled`, {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}`skipped`, {% endif %}`timed_out`, or `action_required`. \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/checks/requested_actions.md b/translations/ja-JP/data/reusables/checks/requested_actions.md deleted file mode 100644 index 5f31cca4fb66..000000000000 --- a/translations/ja-JP/data/reusables/checks/requested_actions.md +++ /dev/null @@ -1 +0,0 @@ -チェック実行とリクエストされたアクションについてさらに学ぶには、「[チェック実行とリクエストされたアクション](/v3/checks/runs/#check-runs-and-requested-actions)」を参照してください。 diff --git a/translations/ja-JP/data/reusables/cli/beta.md b/translations/ja-JP/data/reusables/cli/beta.md deleted file mode 100644 index c63338393409..000000000000 --- a/translations/ja-JP/data/reusables/cli/beta.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_cli %}は現在ベータで、変更されることがあります。 diff --git a/translations/ja-JP/data/reusables/collaborators/collaborator-definition.md b/translations/ja-JP/data/reusables/collaborators/collaborator-definition.md deleted file mode 100644 index af37fe0d3162..000000000000 --- a/translations/ja-JP/data/reusables/collaborators/collaborator-definition.md +++ /dev/null @@ -1 +0,0 @@ -the list of collaborators includes outside collaborators, organization members that are direct collaborators, organization members with access through team memberships, organization members with access through default organization permissions, and organization owners. diff --git a/translations/ja-JP/data/reusables/command_line/parameters_filters.md b/translations/ja-JP/data/reusables/command_line/parameters_filters.md deleted file mode 100644 index 69945352b833..000000000000 --- a/translations/ja-JP/data/reusables/command_line/parameters_filters.md +++ /dev/null @@ -1 +0,0 @@ -結果のリストを絞り込むためにパラメータを利用できます。 パラメータの利用に関する詳しい情報については[パラメータ](/v3/#parameters)を参照してください。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/commits/verification-object-definition.md b/translations/ja-JP/data/reusables/commits/verification-object-definition.md deleted file mode 100644 index c33d5b984310..000000000000 --- a/translations/ja-JP/data/reusables/commits/verification-object-definition.md +++ /dev/null @@ -1,28 +0,0 @@ -##### 署名のverificationオブジェクト - -レスポンスには、コミットの署名を検証した結果を記述する`verification`オブジェクトが含まれます。 `verification`オブジェクトには、以下のフィールドが含まれます。 - -| 名前 | 種類 | 説明 | -| ----------- | --------- | ------------------------------------------ | -| `verified` | `boolean` | GitHubがこのコミットの署名を検証すべきと見なしているかを示します。 | -| `reason` | `string` | `verified`値の理由。 取り得る値とその意味は、以下の表に列挙されています。 | -| `signature` | `string` | コミットから抽出された署名。 | -| `payload` | `string` | 署名された値。 | - -以下は、`verification`オブジェクトの`reason`が取り得る値です。 - -| 値 | 説明 | -| ------------------------ | ----------------------------------------------------------------------- | -| `expired_key` | 署名を作成したキーは期限切れです。 | -| `not_signing_key` | "signing"フラグは、署名を作成したGPGキーの利用フラグ中にありません。 | -| `gpgverify_error` | 署名の検証サービスとの通信でエラーがありました。 | -| `gpgverify_unavailable` | 署名の検証サービスが現在利用できません。 | -| `unsigned` | このオブジェクトには署名が含まれていません。 | -| `unknown_signature_type` | コミット中に非PGP署名が見つかりました。 | -| `no_user` | コミット中の`committer`メールアドレスに関連づけたユーザがいません。 | -| `unverified_email` | コミット中の`committer`メールアドレスがユーザに関連づけられていますが、そのメールアドレスはユーザのアカウントで検証されていません。 | -| `bad_email` | コミット中の`committer`メールアドレスは、署名を作成したPGPキーのアイデンティティに含まれていません。 | -| `unknown_key` | 署名を作成したキーは、どのユーザのアカウントにも登録されていません。 | -| `malformed_signature` | 署名のパースでエラーがありました。 | -| `invalid` | 署名中で見つかったキーidのキーを使って、暗号的に署名を検証することができませんでした。 | -| `valid` | 上記のエラーはいずれも適用されないため、署名は検証されたものと考えられます。 | diff --git a/translations/ja-JP/data/reusables/desktop/commit-history-list.md b/translations/ja-JP/data/reusables/desktop/commit-history-list.md deleted file mode 100644 index e38e233c9dda..000000000000 --- a/translations/ja-JP/data/reusables/desktop/commit-history-list.md +++ /dev/null @@ -1 +0,0 @@ -1. コミットの履歴のリストから、取り消したいコミットをクリックしてください。 diff --git a/translations/ja-JP/data/reusables/desktop/enter-2fa-in-browser.md b/translations/ja-JP/data/reusables/desktop/enter-2fa-in-browser.md deleted file mode 100644 index d496f10fc67d..000000000000 --- a/translations/ja-JP/data/reusables/desktop/enter-2fa-in-browser.md +++ /dev/null @@ -1 +0,0 @@ -1. {% data variables.product.prodname_dotcom %} に戻ります。 プロンプトで2 要素認証のコードを入力し、** Verify（検証）**をクリックしてください。 ![2 要素認証の認証コードフィールド](/assets/images/help/desktop/2fa-code-field.png) diff --git a/translations/ja-JP/data/reusables/desktop/retrieve-2fa-in-browser.md b/translations/ja-JP/data/reusables/desktop/retrieve-2fa-in-browser.md deleted file mode 100644 index 0ff33a61aaba..000000000000 --- a/translations/ja-JP/data/reusables/desktop/retrieve-2fa-in-browser.md +++ /dev/null @@ -1,3 +0,0 @@ -1. {% data variables.product.prodname_dotcom %}用の2要素認証を設定したなら、以下のいずれかを行ってください。 - - SMS経由の2 要素認証をセットアップしたなら、SMSメッセージから2 要素認証コードを取得してください。 - - TOTPアプリケーションで2 要素認証をセットアップしたなら、2 要素認証コードを生成してください。 diff --git a/translations/ja-JP/data/reusables/desktop/windows-select-file-menu.md b/translations/ja-JP/data/reusables/desktop/windows-select-file-menu.md deleted file mode 100644 index c1e3883b2dd3..000000000000 --- a/translations/ja-JP/data/reusables/desktop/windows-select-file-menu.md +++ /dev/null @@ -1 +0,0 @@ -1. ウィンドウの左上で、**File（ファイル）**メニューを選択してください。 ![Windowsのメニューバー内の{% data variables.product.prodname_desktop %}メニュー](/assets/images/help/desktop/windows-select-file-menu.png) diff --git a/translations/ja-JP/data/reusables/dotcom_billing/cost-management-tab.md b/translations/ja-JP/data/reusables/dotcom_billing/cost-management-tab.md deleted file mode 100644 index 468afeee4db2..000000000000 --- a/translations/ja-JP/data/reusables/dotcom_billing/cost-management-tab.md +++ /dev/null @@ -1 +0,0 @@ -1. "Billing（支払い）"の下で、**Cost management（コスト管理）**をクリックしてください。 ![コスト管理タブ](/assets/images/help/settings/cost-management-tab.png) diff --git a/translations/ja-JP/data/reusables/dotcom_billing/publishing-nodejs-packages.md b/translations/ja-JP/data/reusables/dotcom_billing/publishing-nodejs-packages.md deleted file mode 100644 index 8e629e174831..000000000000 --- a/translations/ja-JP/data/reusables/dotcom_billing/publishing-nodejs-packages.md +++ /dev/null @@ -1,203 +0,0 @@ ---- -title: Node.jsパッケージの公開 -intro: 継続的インテグレーション（CI）ワークフローの一部として、Node.jsのパッケージをレジストリに公開できます。 -product: '{% data reusables.gated-features.actions %}' -productVersions: - dotcom: '*' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages ---- - -### はじめに - -本ガイドでは、継続的インテグレーション（CI）テストにパスした後、Node.jsのパッケージを{% data variables.product.prodname_registry %}及びnpmレジストリに公開するワークフローの作成方法を紹介します。 1つのワークフローで、パッケージを1つのレジストリや複数のレジストリに公開できます。 - -### 必要な環境 - -ワークフローの設定オプションと、ワークフローファイルの作成方法についての基本的な知識を持っておくことをおすすめします。 詳細は「[ワークフローの設定](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)」を参照してください。 - -Node.jsプロジェクトのためのCIワークフローの作成に関する詳しい情報については「[{% data variables.product.prodname_actions %}でのNode.jsの利用](/actions/automating-your-workflow-with-github-actions/using-nodejs-with-github-actions)」を参照してください。 - -また、以下の基本的な理解があれば役立ちます。 - -- [{% data variables.product.prodname_actions %}の中核的概念](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions) -- [{% data variables.product.prodname_registry %} で利用するために npm を設定する](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages) -- [環境変数の利用](/actions/automating-your-workflow-with-github-actions/using-environment-variables) -- [暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets) -- [GITHUB_TOKENでの認証](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token) - -### パッケージの設定について - - *package.json*ファイル中の`name`及び`version`フィールドは、レジストリがパッケージをレジストリにリンクするために利用するユニークな識別子を作成します。 *package.json*ファイル中に`description`を含めることによって、パッケージのリストページのためのまとめを追加できます。 詳しい情報については、npmのドキュメンテーション中の「[package.jsonファイルの作成](https://docs.npmjs.com/creating-a-package-json-file)」及び「[Node.jsモジュールの作成](https://docs.npmjs.com/creating-node-js-modules)」を参照してください。 - -ローカルの*.npmrc*ファイルがあり、`registry`の値が指定されている場合、`npm publish`コマンドは*.npmrc*ファイルで設定されたレジストリを使います。 {% data reusables.github-actions.setup-node-intro %} - -`setup-node`アクションを使えば、ランナーにインストールされたNode.jsのバージョンを指定できます。 - -*package.json*ファイルに`publishConfig`フィールドを設定するステップをワークフローに追加したなら、`setup-node`アクションを使ってregistry-urlを指定する必要はありませんが、パッケージを公開するレジストリは1つだけに限られます。 詳しい情報についてはnpmドキュメンテーションの「[Configの公開](https://docs.npmjs.com/files/package.json#publishconfig)」を参照してください。 - -### npmレジストリへのパッケージの公開 - -新しいリリースを作成するたびに、パッケージを公開するワークフローを起動できます。 以下の例でのワークフローは、`created`という種類で`release`イベントが発生したときに実行されます。 このワークフローは、CIテストをパスすればnpmレジストリにパッケージを公開します。 - -ワークフロー中でnpmレジストリに対して認証を受けた操作を行うためには、npmの認証トークンをリポジトリの設定中にシークレットとして保存しなければなりません。 たとえば`NPM_TOKEN`というシークレットを生成してください。 詳しい情報については、「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 - -デフォルトでは、npmは*package.json*ファイルの`name`フィールドを使ってnpmレジストリを決めます。 グローバルな名前空間に公開する場合は、パッケージ名だけを含める必要があります。 たとえば`https://www.npmjs.com/package/npm-hello-world-test`に`npm-hello-world-test`という名前のパッケージを公開できます。 - -スコープのプレフィックスを含むパッケージを公開するなら、そのスコープを*package.json*ファイルの名前に含めてください。 たとえばnpmのスコーププレフィックスがoctocatであり、パッケージ名がhello-worldなら、*package.json*ファイル中の`name`は`@octocat/hello-world`とすべきです。 npmパッケージがスコーププレフィックスを使っており、パブリックであるなら、`npm publish --access public`オプションを使う必要があります。 これは、意図せずプライベートパッケージを公開してしまうことを防ぐためにnpmが必要とするオプションです。 - -以下の例は、`NPM_TOKEN`シークレットを環境変数の`NODE_AUTH_TOKEN`に保存します。 `setup-node`アクションが*.npmrc*ファイルを作成する際には、環境変数の`NODE_AUTH_TOKEN`からトークンを参照します。 - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # npmへの公開のための.npmrcファイルのセットアップ - - uses: actions/setup-node@v1 - with: - node-version: '12.x' - registry-url: 'https://registry.npmjs.org' - - run: npm install - - run: npm publish - env: - NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} -``` -{% endraw %} - -上の例では、`setup-node`アクションは以下の内容でランナー上に*.npmrc*ファイルを作成します。 - -``` -//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN} -registry=https://registry.npmjs.org/ -always-auth=true -``` - -### {% data variables.product.prodname_registry %}へのパッケージの公開 - -新しいリリースを作成するたびに、パッケージを公開するワークフローを起動できます。 以下の例でのワークフローは、`created`という種類で`release`イベントが発生したときに実行されます。 このワークフローは、CIテストをパスすれば{% data variables.product.prodname_registry %}にパッケージを公開します。 - -デフォルトでは、{% data variables.product.prodname_registry %}は*package.json*ファイルの`name`フィールドで指定された{% data variables.product.prodname_dotcom %}のリポジトリにパッケージを公開します。 たとえば`@my-org/test`という名前のパッケージを{% data variables.product.prodname_dotcom %}リポジトリの`my-org/test`に公開します。 詳しい情報については、npmドキュメンテーション中の[`npm-scope`](https://docs.npmjs.com/misc/scope)を参照してください。 - -ワークフロー中で{% data variables.product.prodname_registry %}レジストリに対して認証を受けた操作をするには、`GITHUB_TOKEN`が使えます。 `GITHUB_TOKEN`は、デフォルトでリポジトリ中に存在し、ワークフローが実行されるリポジトリ中のパッケージには読み書きの権限があります。 詳しい情報については、「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 - -以下の例は、`GITHUB_TOKEN`シークレットを環境変数の`NODE_AUTH_TOKEN`に保存します。 `setup-node`アクションが*.npmrc*ファイルを作成する際には、環境変数の`NODE_AUTH_TOKEN`からトークンを参照します。 - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # GitHub Packagesへの公開のために.npmrcファイルをセットアップ - - uses: actions/setup-node@v1 - with: - node-version: '12.x' - registry-url: 'https://npm.pkg.github.com' - scope: '@octocat' # Defaults to the user or organization that owns the workflow file - - run: npm install - - run: npm publish - env: - NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} - -`setup-node`アクションは、ランナー上で*.npmrc*ファイルを作成します。 `setup-node`アクションで`scope`インプットを使うと、*.npmrc*ファイルにはスコーププレフィックスが含まれます。 デフォルトでは、`setup-node`アクションは*.npmrc*ファイルのスコープを、ワークフローファイルを含むアカウントに設定します。 - -``` -//npm.pkg.github.com/:_authToken=${NODE_AUTH_TOKEN} -@octocat:registry=https://npm.pkg.github.com -always-auth=true -``` - -### yarnを利用したパッケージの公開 - -パッケージマネージャーのYarnを使う場合、Yarnを使ってパッケージのインストールと公開が行えます。 - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # npmへの公開のために.npmrcファイルをセットアップ - - uses: actions/setup-node@v1 - with: - node-version: '12.x' - registry-url: 'https://registry.npmjs.org' - scope: '@octocat' # Defaults to the user or organization that owns the workflow file - - run: yarn - - run: yarn publish - env: - NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} -``` -{% endraw %} - -### npmと{% data variables.product.prodname_registry %}へのパッケージの公開 - -{% note %} - -**ノート：** 異なるスコーププレフィックスを持つレジストリへ公開する必要がある倍は、ランナー上の*package.json*ファイルを修正してスコーププレフィックスを変更しなければなりません。 たとえばnpmに対しては`@mona`スコープで、{% data variables.product.prodname_registry %}に対しては`@octocat`スコープでパッケージを公開する場合は、npmへの公開後、{% data variables.product.prodname_registry %}への公開前にランナー上の*package.json*ファイルの`@mona`スコープを`@octocat`で置き換えることができます。 - -{% endnote %} - -`setup-node`アクションをそれぞれのレジストリに対して利用すれば、npmレジストリと{% data variables.product.prodname_registry %}の両方にパッケージを公開できます。 - -両方のレジストリにパッケージを公開するなら、npm上のスコーププレフィックスが{% data variables.product.prodname_dotcom %}のユーザ名もしくはOrganization名と一致することを確認する必要があります。 パッケージをスコーププレフィックス付きでパブリックなレジストリに公開するには、`npm publish --access public`コマンドが使えます。 詳しい情報については、npmドキュメンテーション中の[`npm-scope`](https://docs.npmjs.com/misc/scope)及び「[スコープ付きのパブリックパッケージの作成と公開](https://docs.npmjs.com/creating-and-publishing-scoped-public-packages)」を参照してください。 - -*package.json*ファイルに{% data variables.product.prodname_dotcom %}レジストリとnpmレジストリのスコープが含まれていることを確かめてください。 たとえば、`octocat/npm-hello-world-test`リポジトリ内のパッケージを{% data variables.product.prodname_dotcom %}及びhttps://www.npmjs.com/package/@octocat/npm-hello-world-testに公開する計画をしているなら、*package.json*ファイル内の名前は`"name": "@octocat/npm-hello-world-test"`となるでしょう。 - -ワークフロー中で{% data variables.product.prodname_registry %}レジストリに対して認証を受けた操作をするには、`GITHUB_TOKEN`が使えます。 `GITHUB_TOKEN`は、デフォルトでリポジトリ中に存在し、ワークフローが実行されるリポジトリ中のパッケージには読み書きの権限があります。 詳しい情報については、「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 - -`setup-node`アクションで`scope`インプットを使うと、このアクションはスコーププレフィックスを含む*.npmrc*ファイルを作成します。 デフォルトでは、`setup-node`アクションは*.npmrc*ファイル中のスコープを、ワークフローファイルを所有するユーザもしくはOrganizationに設定します。 - -このワークフローは、`setup-node`アクションを2回呼びます。 `setup-node`アクションは、実行されるたびに*.npmrc*ファイルを上書きします。 *.npmrc*ファイルは、パッケージレジストリに対する認証を受けた操作を行えるようにしてくれるトークンを、環境変数の`NODE_AUTH_TOKEN`から参照します。 このワークフローは、環境変数の`NODE_AUTH_TOKEN`を`npm publish`コマンドが実行されるたびに設定します。初回はnpmへの公開のためのトークン（`NPM_TOKEN`）が、続いて{% data variables.product.prodname_registry %}への公開のためのトークン（`GITHUB_TOKEN`）が使われます。 - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # npmへの公開のために.npmrcファイルをセットアップ - - uses: actions/setup-node@v1 - with: - node-version: '10.x' - registry-url: 'https://registry.npmjs.org' - - run: npm install - # npmへの公開 - - run: npm publish --access public - env: - NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} - # GitHub Packages への公開のために.npmrcファイルをセットアップ - - uses: actions/setup-node@v1 - with: - registry-url: 'https://npm.pkg.github.com' - scope: '@octocat' # Defaults to the user or organization that owns the workflow file - # GitHub Packagesへの公開 - - run: npm publish - env: - NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} diff --git a/translations/ja-JP/data/reusables/enterprise-accounts/business-settings.md b/translations/ja-JP/data/reusables/enterprise-accounts/business-settings.md deleted file mode 100644 index ad694350daf3..000000000000 --- a/translations/ja-JP/data/reusables/enterprise-accounts/business-settings.md +++ /dev/null @@ -1 +0,0 @@ -1. ビジネスアカウント名の下で{% octicon "gear" aria-label="The Settings gear" %}** Settings（設定）**をクリックしてください。 ![ビジネスアカウントのプロフィールページ上の設定タブ](/assets/images/help/business-accounts/business-account-settings-tab.png) diff --git a/translations/ja-JP/data/reusables/enterprise-accounts/github-dotcom-connection-tab.md b/translations/ja-JP/data/reusables/enterprise-accounts/github-dotcom-connection-tab.md deleted file mode 100644 index db4c555da1c8..000000000000 --- a/translations/ja-JP/data/reusables/enterprise-accounts/github-dotcom-connection-tab.md +++ /dev/null @@ -1 +0,0 @@ -1. 左のサイドバーで**{% data variables.product.prodname_dotcom_the_website %} connection（{% data variables.product.prodname_dotcom_the_website %}の接続）**をクリックしてください。 ![ビジネスアカウント設定サイドバー内のGitHub.com connectionタブ](/assets/images/enterprise/business-accounts/settings-github-dotcom-connection-tab.png) diff --git a/translations/ja-JP/data/reusables/enterprise-accounts/member-privileges-tab.md b/translations/ja-JP/data/reusables/enterprise-accounts/member-privileges-tab.md deleted file mode 100644 index ea91568c6d12..000000000000 --- a/translations/ja-JP/data/reusables/enterprise-accounts/member-privileges-tab.md +++ /dev/null @@ -1 +0,0 @@ -1. Business setting（ビジネス設定）サイドバー内で**Member privileges（メンバーの権限）**をクリックしてください。 ![ビジネスアカウント設定サイドバー内のメンバー権限タブ](/assets/images/help/business-accounts/settings-member-privileges-tab.png) diff --git a/translations/ja-JP/data/reusables/enterprise/ldap_sync_warning.md b/translations/ja-JP/data/reusables/enterprise/ldap_sync_warning.md deleted file mode 100644 index 7a7408c64bd8..000000000000 --- a/translations/ja-JP/data/reusables/enterprise/ldap_sync_warning.md +++ /dev/null @@ -1,9 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" %} - -{% warning %} - -If your {% data variables.product.prodname_ghe_server %} instance has [LDAP Sync enabled and the option to synchronize emails enabled](/enterprise/admin/guides/user-management/using-ldap/#enabling-ldap-sync), this API is disabled and will return a `403` response. Users managed in LDAP won't be able to add or delete an email address via the API with these options enabled. - -{% endwarning %} - -{% endif %} diff --git a/translations/ja-JP/data/reusables/enterprise_enterprise_support/sign-in-to-enterprise-portal.md b/translations/ja-JP/data/reusables/enterprise_enterprise_support/sign-in-to-enterprise-portal.md deleted file mode 100644 index 1e2b3619d889..000000000000 --- a/translations/ja-JP/data/reusables/enterprise_enterprise_support/sign-in-to-enterprise-portal.md +++ /dev/null @@ -1 +0,0 @@ -1. {% data variables.contact.enterprise_portal %}にサインインするには、ページの右上で**Sign in（サインイン）**をクリックしてください。 ![{% data variables.contact.enterprise_portal %}へのサインイン](/assets/images/enterprise/support/sign-in-support-portal.png) diff --git a/translations/ja-JP/data/reusables/enterprise_installation/increasing-cpus-max.md b/translations/ja-JP/data/reusables/enterprise_installation/increasing-cpus-max.md deleted file mode 100644 index 33f30784cf49..000000000000 --- a/translations/ja-JP/data/reusables/enterprise_installation/increasing-cpus-max.md +++ /dev/null @@ -1,3 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" %} - {% data reusables.enterprise_installation.increasing-cpus-req %} 16以上のCPUを使う場合には、CPUごとに6.5GBのメモリを追加する必要はありませんが、十分なメモリがあることを確認するためにインスタンスをモニタリングすることを推奨します。 -{% endif %} diff --git a/translations/ja-JP/data/reusables/enterprise_installation/resizing-root-disk.md b/translations/ja-JP/data/reusables/enterprise_installation/resizing-root-disk.md deleted file mode 100644 index e453ca9341af..000000000000 --- a/translations/ja-JP/data/reusables/enterprise_installation/resizing-root-disk.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**ノート：**ルートディスクは、新しいアプライアンスを構築するか、既存のアプライアンスを利用してリサイズできます。 詳しい情報については「[ストレージ容量の増加](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-storage-capacity)」を参照してください。 - -{% endnote %} diff --git a/translations/ja-JP/data/reusables/enterprise_installation/root-and-data-disk-requirement.md b/translations/ja-JP/data/reusables/enterprise_installation/root-and-data-disk-requirement.md deleted file mode 100644 index 996a80c84afc..000000000000 --- a/translations/ja-JP/data/reusables/enterprise_installation/root-and-data-disk-requirement.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_ghe_server %}は、ルートディスクとは別に永続化用のデータディスクを必要とします。 詳しい情報については「[システムの概要](/enterprise/admin/guides/installation/system-overview)」を参照してください。 diff --git a/translations/ja-JP/data/reusables/enterprise_installation/storage-disk-requirements.md b/translations/ja-JP/data/reusables/enterprise_installation/storage-disk-requirements.md deleted file mode 100644 index f057af0a0613..000000000000 --- a/translations/ja-JP/data/reusables/enterprise_installation/storage-disk-requirements.md +++ /dev/null @@ -1 +0,0 @@ -ストレージデバイスには、高パフォーマンスの SSD を直接アタッチするか、ストレージエリアネットワーク (SAN) を経由するかの、いずれかをおすすめします。 diff --git a/translations/ja-JP/data/reusables/enterprise_installation/warning-on-polling.md b/translations/ja-JP/data/reusables/enterprise_installation/warning-on-polling.md deleted file mode 100644 index 491df72af343..000000000000 --- a/translations/ja-JP/data/reusables/enterprise_installation/warning-on-polling.md +++ /dev/null @@ -1,5 +0,0 @@ -{% warning %} - -**警告：** 継続的インテグレーション（CI）あるいはそれに類したシステムでリポジトリの変更をフェッチするには、webhookの利用をおすすめします。 定期的な自動チェック、あるいは*ポーリング*は、インスタンスのスケーラビリティを大きく損ないます。 詳しい情報については「[webhookについて](/enterprise/{{ currentVersion }}/user/articles/about-webhooks/)」を参照してください。 - -{% endwarning %} diff --git a/translations/ja-JP/data/reusables/gated-features/actions-api-gated.md b/translations/ja-JP/data/reusables/gated-features/actions-api-gated.md deleted file mode 100644 index a991a90e3d62..000000000000 --- a/translations/ja-JP/data/reusables/gated-features/actions-api-gated.md +++ /dev/null @@ -1,5 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} - -{% data variables.product.prodname_actions %}は{% data variables.product.prodname_free_user %}、{% data variables.product.prodname_pro %}、{% data variables.product.prodname_free_team %}のOrganization、{% data variables.product.prodname_team %}、{% data variables.product.prodname_ghe_cloud %}、{% data variables.product.prodname_ghe_one %}で利用できます。 {% data variables.product.prodname_actions %}は、レガシーのリポジトリごとのプランを使っているアカウントが所有しているプライベートリポジトリでは利用できません。 {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %} - -{% endif %} diff --git a/translations/ja-JP/data/reusables/gated-features/credential-authorizations-org.md b/translations/ja-JP/data/reusables/gated-features/credential-authorizations-org.md deleted file mode 100644 index e095cbb82136..000000000000 --- a/translations/ja-JP/data/reusables/gated-features/credential-authorizations-org.md +++ /dev/null @@ -1,5 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} - -Listing and deleting credential authorizations is available to organizations with {% data variables.product.prodname_ghe_cloud %}. {% data reusables.gated-features.more-info %} - -{% endif %} diff --git a/translations/ja-JP/data/reusables/gated-features/draft-pull-requests.md b/translations/ja-JP/data/reusables/gated-features/draft-pull-requests.md deleted file mode 100644 index c6b8f67b1486..000000000000 --- a/translations/ja-JP/data/reusables/gated-features/draft-pull-requests.md +++ /dev/null @@ -1,2 +0,0 @@ - -ドラフトのプルリクエストは、{% data variables.product.prodname_free_user %}及び{% data variables.product.prodname_free_team %}のOrganizationのパブリックリポジトリ、{% data variables.product.prodname_pro %}、レガシーのリポジトリごとの支払いプラン、{% data variables.product.prodname_team %} のパブリックおよびプライベートリポジトリ{% if currentVersion != "free-pro-team@latest" %}、{% data variables.product.prodname_ghe_server %}2.17+{% endif %}、{% data variables.product.prodname_ghe_cloud %} で利用できます。 {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %} diff --git a/translations/ja-JP/data/reusables/gated-features/policies.md b/translations/ja-JP/data/reusables/gated-features/policies.md deleted file mode 100644 index e3c7ff977391..000000000000 --- a/translations/ja-JP/data/reusables/gated-features/policies.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**ノート:** {% data variables.product.prodname_policies %}は現在アルファです。 このドキュメントは機密であり、NDAの下で利用できます。 配布はしないでください。 - -{% endnote %} \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/gated-features/sponsors-beta.md b/translations/ja-JP/data/reusables/gated-features/sponsors-beta.md deleted file mode 100644 index c46dff4401be..000000000000 --- a/translations/ja-JP/data/reusables/gated-features/sponsors-beta.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**ノート：** Organizationのための{% data variables.product.prodname_sponsors %}は現在ベータで、変更されることがあります。 - -{% endnote %} diff --git a/translations/ja-JP/data/reusables/gated-features/team-sync-gated.md b/translations/ja-JP/data/reusables/gated-features/team-sync-gated.md deleted file mode 100644 index f08a3b783416..000000000000 --- a/translations/ja-JP/data/reusables/gated-features/team-sync-gated.md +++ /dev/null @@ -1,5 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} - -Teamの同期は{% data variables.product.prodname_ghe_cloud %}を使用しているOrganizationで利用できます。 {% data reusables.gated-features.more-info %} - -{% endif %} diff --git a/translations/ja-JP/data/reusables/github-actions/explains-hello-world-example.md b/translations/ja-JP/data/reusables/github-actions/explains-hello-world-example.md deleted file mode 100644 index 627dc01e2372..000000000000 --- a/translations/ja-JP/data/reusables/github-actions/explains-hello-world-example.md +++ /dev/null @@ -1 +0,0 @@ -リポジトリの`OWNER`は`octocat` Organizationで、`REPOSITORY`名は`hello-world`です。 diff --git a/translations/ja-JP/data/reusables/github-actions/github-actions-minutes-change.md b/translations/ja-JP/data/reusables/github-actions/github-actions-minutes-change.md deleted file mode 100644 index e350da8af587..000000000000 --- a/translations/ja-JP/data/reusables/github-actions/github-actions-minutes-change.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**ノート:** 2020年5月14日以降、{% data variables.product.prodname_team %}は1ヶ月あたり3,000{% data variables.product.prodname_actions %}分を含みます。 - -{% endnote %} diff --git a/translations/ja-JP/data/reusables/github-actions/github-actions-usage-limits.md b/translations/ja-JP/data/reusables/github-actions/github-actions-usage-limits.md deleted file mode 100644 index 76242f258b71..000000000000 --- a/translations/ja-JP/data/reusables/github-actions/github-actions-usage-limits.md +++ /dev/null @@ -1,15 +0,0 @@ -{% data variables.product.prodname_actions %}の利用にはいくつかの制限があり、それらは使用しているのが{% data variables.product.prodname_dotcom %}ホストランナーなのか、セルフホストランナーなのかによって変わります。 これらの制限は変更されることがあります。 - -- **ジョブの実行時間** - ワークフロー中のそれぞれのジョブは、最大で6時間の間実行できます。 ジョブがこの制限に達すると、ジョブは終了させられ、完了できずに失敗します。 この制限は、セルフホストランナーには適用されません、 -- **ワークフローの実行時間** - 各ワークフローの実行は72時間までに制限されます。 ワークフローの実行がこの制限に達すると、そのワークフローの実行はキャンセルされます。 この制限は、セルフホストランナーにも適用されます。 -- **ジョブキュー時間** - セルフホストランナーの各ジョブは、最大24時間キューイングできます。 この制限内にセルフホストランナーがジョブの実行を開始しなければ、ジョブは終了させられ、完了に失敗します。 この制限は、{% data variables.product.prodname_dotcom %}ホストランナーには適用されません。 -- **APIリクエスト** - リポジトリ内のすべてのアクションにわたって、1時間のうちに最大1000回のAPIリクエストを実行できます。 この制限を超えた場合、超過のAPIコールは失敗し、それによってジョブも失敗するかもしれません。 この制限は、セルフホストランナーにも適用されます。 -- **並行ジョブ** - アカウント内で実行できる並行ジョブ数は、以下の表に示すとおり、利用しているGitHubのプランによります。 この制限を超えた場合、超過のジョブはキューイングされます。 セルフホストランナーには並行数の制限はありません。 - - | GitHubプラン | 最大同時ジョブ | 最大同時macOSジョブ | - | ---------- | ------- | ------------ | - | 無料 | 20 | 5 | - | Pro | 40 | 5 | - | Team | 60 | 5 | - | Enterprise | 180 | 50 | -- **ジョブマトリックス** - {% data reusables.github-actions.matrix-limits %} diff --git a/translations/ja-JP/data/reusables/github-actions/matrix-limits.md b/translations/ja-JP/data/reusables/github-actions/matrix-limits.md deleted file mode 100644 index 3b898b6ed0dd..000000000000 --- a/translations/ja-JP/data/reusables/github-actions/matrix-limits.md +++ /dev/null @@ -1 +0,0 @@ -ジョブマトリックスは、ワークフローの実行ごとに最大で256のジョブを生成できます。 この制限は、セルフホストランナーにも適用されます。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/github-actions/self-hosted-runner-add-new-runner.md b/translations/ja-JP/data/reusables/github-actions/self-hosted-runner-add-new-runner.md deleted file mode 100644 index b07374be8ec8..000000000000 --- a/translations/ja-JP/data/reusables/github-actions/self-hosted-runner-add-new-runner.md +++ /dev/null @@ -1,20 +0,0 @@ -1. "Self-hosted runners（セルフホストランナー）"の下で、**Add runner（ランナーの追加）**をクリックしてください。 - -1. 使用するセルフホストランナーマシンのオペレーティングシステムとアーキテクチャを選択してください。 ![セルフホストランナーのオペレーティングシステムの選択](/assets/images/help/settings/actions-runner-architecture-os.png) - - -1. ランナーアプリケーションをダウンロードして、使用するセルフホストランナーのマシンにインストールする方法が表示されます。 - - セルフホストランナーのマシンでシェルを開き、表示順に従ってシェルコマンドを実行してください。 - - {% note %} - - **ノート:** Windowsでは、セルフホストランナーアプリケーションをサービスとしてインストールしたいのなら、シェルを管理者権限でオープンしなければなりません。 また、`C:\actions-runner`をセルフホストランナーアプリケーションのためのディレクトリとして利用し、Windowsのシステムアカウントがランナーディレクトリにアクセスできるようにすることをおすすめします。 - - {% endnote %} - - この指示に従えば、以下のタスクが完了します。 - - セルフホストランナーアプリケーションのダウンロードと展開。 - - `config`スクリプトを実行してセルフホストランナーアプリケーションを設定し、{% data variables.product.prodname_actions %}に登録します。 `config`スクリプトには、登録先のURLと、リクエストを認証してもらうための自動的に生成された時間限定のあるトークンが必要です。 - - Windowsでは、`config`スクリプトはセルフホストランナーをサービスとしてインストールするかも聞いてきます。 LinuxとmacOSでは、ランナーの追加を終えた後にサービスをインストールできます。 詳しい情報については「[サービスとしてセルフホストランナーを構成する](/actions/automating-your-workflow-with-github-actions/configuring-the-self-hosted-runner-application-as-a-service)」を参照してください。 - - セルフホストランナーアプリケーションを実行して、マシンを{% data variables.product.prodname_actions %}に接続します。 diff --git a/translations/ja-JP/data/reusables/github-component-kit/intro-for-component-kit.md b/translations/ja-JP/data/reusables/github-component-kit/intro-for-component-kit.md deleted file mode 100644 index d58b67db5962..000000000000 --- a/translations/ja-JP/data/reusables/github-component-kit/intro-for-component-kit.md +++ /dev/null @@ -1 +0,0 @@ -The {% data variables.product.prodname_component_kit %} uses {% data variables.product.prodname_github_app %}s and {% data variables.product.prodname_actions %} to power interactive elements within the {% data variables.product.prodname_dotcom %} UI. For example, you can guide repository users with next steps or prompt them to accept license agreements. diff --git a/translations/ja-JP/data/reusables/github-component-kit/opening-explanation-for-component-kit.md b/translations/ja-JP/data/reusables/github-component-kit/opening-explanation-for-component-kit.md deleted file mode 100644 index 9e7d48686861..000000000000 --- a/translations/ja-JP/data/reusables/github-component-kit/opening-explanation-for-component-kit.md +++ /dev/null @@ -1,3 +0,0 @@ -The {% data variables.product.prodname_component_kit %} enables you to configure an interactive component to appear in a pull request or issue. Interactive components enable people to trigger and manage tasks that appear in the {% data variables.product.prodname_dotcom %} UI while a {% data variables.product.prodname_github_app %} or action performs the requested tasks and shares updates. - -Using the "[Create composable comment](/hidden/github-component-kit/composable-comments#create-composable-comment)" endpoint, a {% data variables.product.prodname_github_app %} or action can create a composable comment in an issue or pull request. The composable comment can include an interactive component, such as a custom button. When someone interacts with the comment, the {% data variables.product.prodname_github_app %} will receive the `interactive_component` webhook event. diff --git a/translations/ja-JP/data/reusables/github-insights/no-configuration-file.md b/translations/ja-JP/data/reusables/github-insights/no-configuration-file.md deleted file mode 100644 index 23b3c70c69d7..000000000000 --- a/translations/ja-JP/data/reusables/github-insights/no-configuration-file.md +++ /dev/null @@ -1 +0,0 @@ -設定ファイルを持っていない場合は、{% data variables.product.prodname_insights %}の初回インストールのための指示に従ってください。 詳しい情報については「[{% data variables.product.prodname_insights %}のインストール](/insights/installing-and-configuring-github-insights/installing-github-insights#installing-github-insights)」を参照してください。 diff --git a/translations/ja-JP/data/reusables/identity-and-permissions/about-connected-teams.md b/translations/ja-JP/data/reusables/identity-and-permissions/about-connected-teams.md deleted file mode 100644 index b3a455b805f5..000000000000 --- a/translations/ja-JP/data/reusables/identity-and-permissions/about-connected-teams.md +++ /dev/null @@ -1,7 +0,0 @@ -いったん {% data variables.product.prodname_dotcom %} Team が IdP グループに接続されると、IdP 管理者はアイデンティティプロバイダを通して Team メンバーシップの変更を行う必要があります。 TeamがIdPグループに接続されると、Teamのメンバーシップは{% data variables.product.product_name %}やAPIを通じて管理することはできません。 - -IdPグループに接続されたTeamを含む任意の{% data variables.product.prodname_dotcom %}のTeamによるリポジトリへのアクセスを管理するには、{% data variables.product.product_name %}上で変更を行わなければなりません。 詳細は「[Team について](/articles/about-teams)」および「[Organization リポジトリへの Team のアクセスを管理する](/articles/managing-team-access-to-an-organization-repository)」を参照してください。 - -デフォルトでTeamのメンバーがアクセスできるようにしたいリポジトリを選択できます。 接続されたIdPグループは、自動的にそれらのリポジトリにアクセスできるようになります。 詳しい情報については「[OrganizationリポジトリへのTeamのアクセス管理](/articles/managing-team-access-to-an-organization-repository)」を参照してください。 - -IdP を通じた Team メンバーシップ変更はすべて、Team 同期ボットによる変更として {% data variables.product.product_name %} の Audit log に記載されます。 IdP は、Team メンバーシップのデータを 1 時間に 1 回 {% data variables.product.prodname_dotcom %} に送信します。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/marketplace/marketplace_RFP_deadline.md b/translations/ja-JP/data/reusables/marketplace/marketplace_RFP_deadline.md deleted file mode 100644 index 094cf7351774..000000000000 --- a/translations/ja-JP/data/reusables/marketplace/marketplace_RFP_deadline.md +++ /dev/null @@ -1 +0,0 @@ -10 年 4 月 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/marketplace/unverified-req.md b/translations/ja-JP/data/reusables/marketplace/unverified-req.md deleted file mode 100644 index f7e6e688b552..000000000000 --- a/translations/ja-JP/data/reusables/marketplace/unverified-req.md +++ /dev/null @@ -1 +0,0 @@ -Unverified apps do not need to meet the "[Requirements for listing an app on GitHub Marketplace](/marketplace/getting-started/requirements-for-listing-an-app-on-github-marketplace/)" or go through the "[Security review process](/marketplace/getting-started/security-review-process/)." \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/nested-teams/include-child-team-members.md b/translations/ja-JP/data/reusables/nested-teams/include-child-team-members.md deleted file mode 100644 index d93277430653..000000000000 --- a/translations/ja-JP/data/reusables/nested-teams/include-child-team-members.md +++ /dev/null @@ -1,5 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.20" %} -If you pass the `hellcat-preview` media type, team members will include the members of child teams. -{% else %} -Teamメンバーには、子チームのメンバーが含まれます。 -{% endif %} diff --git a/translations/ja-JP/data/reusables/organizations/org-settings-repository-roles.md b/translations/ja-JP/data/reusables/organizations/org-settings-repository-roles.md deleted file mode 100644 index f5e6c3cb09eb..000000000000 --- a/translations/ja-JP/data/reusables/organizations/org-settings-repository-roles.md +++ /dev/null @@ -1 +0,0 @@ -4. In the left sidebar, click **Repository roles**. ![Repository roles tab in organization settings](/assets/images/help/organizations/org-settings-repository-roles.png) diff --git a/translations/ja-JP/data/reusables/orgs/deprecating_creation_type.md b/translations/ja-JP/data/reusables/orgs/deprecating_creation_type.md deleted file mode 100644 index 1d553415f080..000000000000 --- a/translations/ja-JP/data/reusables/orgs/deprecating_creation_type.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -{% warning %} - -**Parameter Deprecation Notice:** {% data variables.product.prodname_dotcom %} will replace and discontinue `members_allowed_repository_creation_type` in favor of more granular permissions. The new input parameters are `members_can_create_public_repositories`, `members_can_create_private_repositories` for all organizations and `members_can_create_internal_repositories` for organizations associated with an enterprise account using {% data variables.product.prodname_ghe_cloud %} or {% data variables.product.prodname_ghe_server %} 2.20+. 詳しい情報については[ブログポスト](https://developer.github.com/changes/2019-12-03-internal-visibility-changes)を参照してください。 - -{% endwarning %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/orgs/internal_repos.md b/translations/ja-JP/data/reusables/orgs/internal_repos.md deleted file mode 100644 index e432538b3738..000000000000 --- a/translations/ja-JP/data/reusables/orgs/internal_repos.md +++ /dev/null @@ -1 +0,0 @@ -If your organization is associated with an enterprise account using {% data variables.product.prodname_ghe_cloud %} or {% data variables.product.prodname_ghe_server %} 2.20+, `visibility` can also be `internal`. \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/package_registry/about-spending-limits.md b/translations/ja-JP/data/reusables/package_registry/about-spending-limits.md deleted file mode 100644 index ad918e5c14ef..000000000000 --- a/translations/ja-JP/data/reusables/package_registry/about-spending-limits.md +++ /dev/null @@ -1 +0,0 @@ -デフォルトでは、あなたのアカウントは{% data variables.product.prodname_registry %}と{% data variables.product.prodname_actions %}をあわせた利用に対して$0の利用上限を持ちます。 過剰分を許すには、利用上限を増やすか、無制限にすることができます。 diff --git a/translations/ja-JP/data/reusables/package_registry/accessing-packages.md b/translations/ja-JP/data/reusables/package_registry/accessing-packages.md deleted file mode 100644 index 4fe69f78415f..000000000000 --- a/translations/ja-JP/data/reusables/package_registry/accessing-packages.md +++ /dev/null @@ -1,4 +0,0 @@ -パッケージには、以下の URL からアクセスできます。`OWNER`をあなたの {% data variables.product.prodname_dotcom %} ユーザもしくは Organization 名に、`REPOSITORY`をリポジトリ名に置き換えてください。 - ``` - https://github.com/OWNER/REPOSITORY/packages - ``` diff --git a/translations/ja-JP/data/reusables/package_registry/authenticate-to-container-registry.md b/translations/ja-JP/data/reusables/package_registry/authenticate-to-container-registry.md deleted file mode 100644 index d8f746f67e7b..000000000000 --- a/translations/ja-JP/data/reusables/package_registry/authenticate-to-container-registry.md +++ /dev/null @@ -1,18 +0,0 @@ -1. Create a new personal access token (PAT) with the appropriate scopes for the tasks you want to accomplish. If your organization requires SSO, you must enable SSO for your new token. - - Select the `read:packages` scope to download container images and read their metadata. - - Select the `write:packages` scope to download and upload container images and read and write their metadata. - - Select the `delete:packages` scope to delete container images. - - 詳しい情報については[コマンドラインのための個人のアクセストークンの作成](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)を参照してください。 - -2. Save your PAT. We recommend saving your PAT as an environment variable. - ```shell - $ export CR_PAT=YOUR_TOKEN - ``` -3. Using the CLI for your container type, sign in to the {% data variables.product.prodname_github_container_registry %} service at `ghcr.io`. - {% raw %} - ```shell - $ echo $CR_PAT | docker login ghcr.io -u USERNAME --password-stdin - > Login Succeeded - ``` - {% endraw %} diff --git a/translations/ja-JP/data/reusables/permissions/admin-access-org.md b/translations/ja-JP/data/reusables/permissions/admin-access-org.md deleted file mode 100644 index b4f934126644..000000000000 --- a/translations/ja-JP/data/reusables/permissions/admin-access-org.md +++ /dev/null @@ -1 +0,0 @@ -You must authenticate using an access token with the `admin:org` scope to use this endpoint. \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/permissions/admin-access.md b/translations/ja-JP/data/reusables/permissions/admin-access.md deleted file mode 100644 index d35e7e24173c..000000000000 --- a/translations/ja-JP/data/reusables/permissions/admin-access.md +++ /dev/null @@ -1 +0,0 @@ -You must authenticate using an access token with the `repo` scope to use this endpoint. \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/permissions/code-scanning-app-read-permissions.md b/translations/ja-JP/data/reusables/permissions/code-scanning-app-read-permissions.md deleted file mode 100644 index cbee5c312771..000000000000 --- a/translations/ja-JP/data/reusables/permissions/code-scanning-app-read-permissions.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_github_app %}s must have the `security_events` read permission to use this endpoint. \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/permissions/read-access.md b/translations/ja-JP/data/reusables/permissions/read-access.md deleted file mode 100644 index 1090a36e3e68..000000000000 --- a/translations/ja-JP/data/reusables/permissions/read-access.md +++ /dev/null @@ -1 +0,0 @@ -リポジトリへの読み取りアクセス権を持つユーザは、このエンドポイントを利用できます。 リポジトリがプライベートの場合は、`repo`スコープを持つアクセストークンを使わなければなりません。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/permissions/security-events-scope.md b/translations/ja-JP/data/reusables/permissions/security-events-scope.md deleted file mode 100644 index 00e0b37cd032..000000000000 --- a/translations/ja-JP/data/reusables/permissions/security-events-scope.md +++ /dev/null @@ -1 +0,0 @@ -このエンドポイントを使うには、`security_events`スコープを持つアクセストークンを使わなければなりません。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/permissions/write-access.md b/translations/ja-JP/data/reusables/permissions/write-access.md deleted file mode 100644 index d35e7e24173c..000000000000 --- a/translations/ja-JP/data/reusables/permissions/write-access.md +++ /dev/null @@ -1 +0,0 @@ -You must authenticate using an access token with the `repo` scope to use this endpoint. \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/pre-release-program/ant-man-preview-deployments.md b/translations/ja-JP/data/reusables/pre-release-program/ant-man-preview-deployments.md deleted file mode 100644 index 332ad81b2592..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/ant-man-preview-deployments.md +++ /dev/null @@ -1,11 +0,0 @@ -{% note %} - -**Note:** The `transient_environment` and `production_environment` parameters are currently available for developers to preview. During the preview period, the API may change without advance notice. 完全な詳細については[ブログポスト](https://developer.github.com/changes/2016-04-06-deployment-and-deployment-status-enhancements)を参照してください。 - -To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.ant-man-preview+json -``` - -{% endnote %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/ant-man-preview-statuses.md b/translations/ja-JP/data/reusables/pre-release-program/ant-man-preview-statuses.md deleted file mode 100644 index e0bbc4257774..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/ant-man-preview-statuses.md +++ /dev/null @@ -1,11 +0,0 @@ -{% note %} - -**Note:** The `inactive` state and the `log_url`, `environment_url`, and `auto_inactive` parameters are currently available for developers to preview. 完全な詳細については[ブログポスト](https://developer.github.com/changes/2016-04-06-deployment-and-deployment-status-enhancements)を参照してください。 - -To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.ant-man-preview+json -``` - -{% endnote %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/antiope-preview.md b/translations/ja-JP/data/reusables/pre-release-program/antiope-preview.md deleted file mode 100644 index 95602e1d1aab..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/antiope-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The Checks API is currently available for developers to preview. During the preview period, the API may change without advance notice. 完全な詳細については[ブログポスト](https://developer.github.com/changes/2018-05-07-new-checks-api-public-beta/)を参照してください。 To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.antiope-preview+json -``` - -{% endnote %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/baptiste-keys-preview.md b/translations/ja-JP/data/reusables/pre-release-program/baptiste-keys-preview.md deleted file mode 100644 index 1a309066ba06..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/baptiste-keys-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Note:** The `is_template` and `template_repository` keys are currently available for developer to preview. See [Create a repository using a template](/v3/repos/#create-a-repository-using-a-template) to learn how to create template repositories. To access these new response keys during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.baptiste-preview+json -``` - -{% endnote %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/baptiste-preview.md b/translations/ja-JP/data/reusables/pre-release-program/baptiste-preview.md deleted file mode 100644 index 850b3f271bb4..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/baptiste-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Note:** Creating and using repository templates is currently available for developers to preview. To access this new endpoint during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.baptiste-preview+json -``` - -{% endnote %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/batman-preview.md b/translations/ja-JP/data/reusables/pre-release-program/batman-preview.md deleted file mode 100644 index 079a5b57c932..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/batman-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -{% note %} - -**Note:** Using the {% data variables.product.prodname_component_kit %} API is currently available for developers to preview. To access these endpoints during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.batman-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/checks-public-beta.md b/translations/ja-JP/data/reusables/pre-release-program/checks-public-beta.md deleted file mode 100644 index 9220bede6270..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/checks-public-beta.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Note:** The Checks API is currently in public beta and only available for use with GitHub Apps. - -{% endnote %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/cloak-preview.md b/translations/ja-JP/data/reusables/pre-release-program/cloak-preview.md deleted file mode 100644 index 9b4ed25519a7..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/cloak-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The Commit Search API is currently available for developers to preview. During the preview period, the APIs may change without advance notice. 完全な詳細については[ブログポスト](https://developer.github.com/changes/2017-01-05-commit-search-api/)を参照してください。 - -To access the API you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.cloak-preview -``` -{% endnote %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/code-scanning-beta.md b/translations/ja-JP/data/reusables/pre-release-program/code-scanning-beta.md deleted file mode 100644 index f9be785c151b..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/code-scanning-beta.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** {% data variables.product.prodname_code_scanning_capc %} for open source repositories and private repositories is currently in beta and subject to change. To sign up, see [Advanced Security beta](https://github.com/features/security/advanced-security/signup). - -{% endnote %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/comfort-fade-preview.md b/translations/ja-JP/data/reusables/pre-release-program/comfort-fade-preview.md deleted file mode 100644 index 17e2464a7d19..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/comfort-fade-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** Multi-line comments in a pull request diff is currently available for developers to preview. To access the new response fields during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.comfort-fade-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/doctor-strange-preview.md b/translations/ja-JP/data/reusables/pre-release-program/doctor-strange-preview.md deleted file mode 100644 index 488fa5418a94..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/doctor-strange-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion == "enterprise-server@2.20" %} -{% note %} - -**Note:** New endpoints using OAuth tokens as input parameters instead of path parameters are available for developers to preview in the [OAuth Applications API](/v3/apps/oauth_applications/). To access these endpoints during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.doctor-strange-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/dorian-preview.md b/translations/ja-JP/data/reusables/pre-release-program/dorian-preview.md deleted file mode 100644 index d4141e00a5ab..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/dorian-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Note:** Enabling and disabling dependency alerts for a repository using the REST API is currently available for developers to preview. To access these new endpoints during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.dorian-preview+json -``` - -{% endnote %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/drax-preview.md b/translations/ja-JP/data/reusables/pre-release-program/drax-preview.md deleted file mode 100644 index 720c942e5f60..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/drax-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.13" %} -{% note %} - -**Note:** The [Licenses API](https://developer.github.com/changes/2015-03-09-licenses-api/) is currently available for developers to preview. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.drax-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/echo-preview.md b/translations/ja-JP/data/reusables/pre-release-program/echo-preview.md deleted file mode 100644 index d6897f7f1d82..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/echo-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -{% note %} - -**Note:** The team discussions API is currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2018-02-07-team-discussions-api) for full details. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.echo-preview+json -``` -{% endnote %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/flash-preview.md b/translations/ja-JP/data/reusables/pre-release-program/flash-preview.md deleted file mode 100644 index 75f2b4fd0ecf..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/flash-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% note %} - -**Note:** New features in the Deployments API on {% data variables.product.product_name %} are currently available during a public beta. 完全な詳細については[ブログポスト](https://developer.github.com/changes/2018-10-16-deployments-environments-states-and-auto-inactive-updates/)を参照してください。 - -To access the new `environment` parameter, the two new values for the `state` parameter (`in_progress` and `queued`), and use `auto_inactive` on production deployments during the public beta period, you must provide the following custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.flash-preview+json -``` - -{% endnote %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/gambit-preview.md b/translations/ja-JP/data/reusables/pre-release-program/gambit-preview.md deleted file mode 100644 index ae67b941174b..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/gambit-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.21" %} -{% note %} - -**Note:** Uninstalling {% data variables.product.prodname_github_app %}s and revoking an app's installation token are currently available for developers to preview. To access the new endpoint during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.gambit-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/giant-sentry-fist-pre-release.md b/translations/ja-JP/data/reusables/pre-release-program/giant-sentry-fist-pre-release.md deleted file mode 100644 index 6ea06379025f..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/giant-sentry-fist-pre-release.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "2.8" %} -{% note %} - -**Note:** {% data variables.giant-sentry-fist.product_name_long %} on {% data variables.product.product_name %} is currently available for developers to preview. To access the API, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.giant-sentry-fist-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/github-actions-public-beta.md b/translations/ja-JP/data/reusables/pre-release-program/github-actions-public-beta.md deleted file mode 100644 index 805d8a04975a..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/github-actions-public-beta.md +++ /dev/null @@ -1,11 +0,0 @@ -{% warning %} - -**New release:** {% data variables.product.prodname_actions %} is now available in a new limited public beta. This version offers a new workflow configuration and built-in continuous integration and continuous deployment capabilities. We strongly recommend you avoid using it for high-value workflows and content during this public beta period. To request to join the limited public beta, see the [GitHub Actions page](https://github.com/features/actions). For more information, see "[About GitHub Actions](/articles/about-github-actions)". - -GitHub Support will only provide support for the YAML syntax and no longer provides support for the HCL syntax. - -限定パブリックベータに参加しており、HCL構文の{% data variables.product.prodname_actions %}でワークフローを作成していた場合、YAML構文を使う新しい限定パブリックベータにアップグレードする必要があります。 リポジトリがアップグレードできるようになると、リポジトリ内で招待を受けます。 その招待を受けると、新しい限定パブリックベータが利用できるようになります。 - -Once you've upgraded, any workflows that you created with the HCL syntax will need to be updated to the new YAML syntax. To automatically convert your workflows, see "[Migrating {% data variables.product.prodname_actions %} from HCL syntax to YAML syntax](/articles/migrating-github-actions-from-hcl-syntax-to-yaml-syntax)". - -{% endwarning %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/github-components-public-beta.md b/translations/ja-JP/data/reusables/pre-release-program/github-components-public-beta.md deleted file mode 100644 index 2c242acbc08b..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/github-components-public-beta.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -{% note %} - -**Note:** The {% data variables.product.prodname_component_kit %} API is currently in private beta and subject to change. - -{% endnote %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/groot-preview.md b/translations/ja-JP/data/reusables/pre-release-program/groot-preview.md deleted file mode 100644 index 944243de7c52..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/groot-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Note:** Listing branches or pull requests for a commit in the Commits API is currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2019-04-11-pulls-branches-for-commit/) for more details. To access the new endpoints during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.groot-preview+json -``` - -{% endnote %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/hagar-preview.md b/translations/ja-JP/data/reusables/pre-release-program/hagar-preview.md deleted file mode 100644 index e1cf318f3cc3..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/hagar-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -{% note %} - -**Note:** You can now retrieve someone's hovercard information in different contexts using the Hovercard API. This feature is currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2018-03-21-hovercard-api-preview) for full details. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.hagar-preview+json -``` -{% endnote %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/hellcat-preview.md b/translations/ja-JP/data/reusables/pre-release-program/hellcat-preview.md deleted file mode 100644 index b2268faa5418..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/hellcat-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.20" %} -{% note %} - -**Note:** The Nested Teams API is currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2017-08-30-preview-nested-teams) for full details. To access the API, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.hellcat-preview+json -``` -{% endnote %} - -{% endif %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/inertia-preview.md b/translations/ja-JP/data/reusables/pre-release-program/inertia-preview.md deleted file mode 100644 index d12671fbd8fc..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/inertia-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The Projects API is currently available for developers to preview. During the preview period, the API may change without advance notice. 完全な詳細については[ブログポスト](https://developer.github.com/changes/2016-10-27-changes-to-projects-api)を参照してください。 To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.inertia-preview+json -``` - -{% endnote %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/london-preview.md b/translations/ja-JP/data/reusables/pre-release-program/london-preview.md deleted file mode 100644 index 4fa608045abb..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/london-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** Enabling or disabling automated security fixes is currently available for developers to preview. To access this new endpoint during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.london-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/luke-cage-preview.md b/translations/ja-JP/data/reusables/pre-release-program/luke-cage-preview.md deleted file mode 100644 index a4a7cfe32bbb..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/luke-cage-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The Protected Branches API now has a setting for requiring a specified number of approving pull request reviews before merging. This feature is currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2018-03-16-protected-branches-required-approving-reviews) for full details. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.luke-cage-preview+json -``` - -{% endnote %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/lydian-preview.md b/translations/ja-JP/data/reusables/pre-release-program/lydian-preview.md deleted file mode 100644 index fa5a34527bea..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/lydian-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Note:** Updating the pull request branch with latest upstream changes is currently available for developers to preview. To access this new endpoint during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.lydian-preview+json -``` - -{% endnote %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/mercy-pre-release-replace.md b/translations/ja-JP/data/reusables/pre-release-program/mercy-pre-release-replace.md deleted file mode 100644 index c49f66c4dba1..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/mercy-pre-release-replace.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** Repository topics on {% data variables.product.product_name %} are currently available for developers to preview. To use this endpoint, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.mercy-preview+json -``` - -{% endnote %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/mercy-pre-release.md b/translations/ja-JP/data/reusables/pre-release-program/mercy-pre-release.md deleted file mode 100644 index fa26dc8969ed..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/mercy-pre-release.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** {% data variables.mercy.product_name_long %} on {% data variables.product.product_name %} is currently available for developers to preview. To view the `topics` property in calls that return repository results, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.mercy-preview+json -``` - -{% endnote %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/mister-fantastic-pre-release.md b/translations/ja-JP/data/reusables/pre-release-program/mister-fantastic-pre-release.md deleted file mode 100644 index 4918b1477ee0..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/mister-fantastic-pre-release.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -{% note %} - -**Note:** {% data variables.mister-fantastic.product_name_long %} contains two additional fields in responses, which developers can preview: `html_url` and `source`. To see these two new fields, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.mister-fantastic-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/mockingbird-preview.md b/translations/ja-JP/data/reusables/pre-release-program/mockingbird-preview.md deleted file mode 100644 index aaa04febacec..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/mockingbird-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The API to get issue timeline events is currently available for developers to preview. During the preview period, the APIs may change without advance notice. 完全な詳細については[ブログポスト](https://developer.github.com/changes/2016-05-23-timeline-preview-api/)を参照してください。 To access the API you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.mockingbird-preview -``` - -{% endnote %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/multi-line-comments-public-beta.md b/translations/ja-JP/data/reusables/pre-release-program/multi-line-comments-public-beta.md deleted file mode 100644 index 5aeea167477b..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/multi-line-comments-public-beta.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** Multi-line comments on pull requests are currently in public beta and subject to change. - -{% endnote %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/nebula-preview.md b/translations/ja-JP/data/reusables/pre-release-program/nebula-preview.md deleted file mode 100644 index fa2a43910c15..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/nebula-preview.md +++ /dev/null @@ -1,14 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} - -{% note %} - -**Note:** You can set the visibility of a repository using the new `visibility` parameter in the [Repositories API](/v3/repos/), and get a repository's visibility with a new response key. 詳しい情報については[ブログポスト](https://developer.github.com/changes/2019-12-03-internal-visibility-changes/)を参照してください。 - -To access repository visibility during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.nebula-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/nightshade-preview.md b/translations/ja-JP/data/reusables/pre-release-program/nightshade-preview.md deleted file mode 100644 index 22172eba6443..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/nightshade-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.20" %} -{% note %} - -**Note:** The [Repository Transfer API](https://developer.github.com/changes/2017-11-09-repository-transfer-api-preview) is currently available for developers to preview. To access the API, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.nightshade-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/org-self-hosted-runner-beta.md b/translations/ja-JP/data/reusables/pre-release-program/org-self-hosted-runner-beta.md deleted file mode 100644 index 9c9347541338..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/org-self-hosted-runner-beta.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% warning %} - -**警告:** OrganizationのためのセルフホストランナーAPIは現在パブリックベータであり、変更されることがあります。 - -{% endwarning %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/performed-by-integration-deployment.md b/translations/ja-JP/data/reusables/pre-release-program/performed-by-integration-deployment.md deleted file mode 100644 index 6a888df13e51..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/performed-by-integration-deployment.md +++ /dev/null @@ -1,13 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** If a deployment is created via a {% data variables.product.prodname_github_app %}, the response will include the `performed_via_github_app` object with information about the {% data variables.product.prodname_github_app %}. For more information, see the [related blog post](https://developer.github.com/changes/2016-09-14-Integrations-Early-Access). - -To receive the `performed_via_github_app` object in the response, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.machine-man-preview -``` - -{% endnote %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/performed-by-integration-issue-comment.md b/translations/ja-JP/data/reusables/pre-release-program/performed-by-integration-issue-comment.md deleted file mode 100644 index ad67d849dd85..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/performed-by-integration-issue-comment.md +++ /dev/null @@ -1,13 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** If an issue comment is created via a {% data variables.product.prodname_github_app %}, the response will include the `performed_via_github_app` object with information about the {% data variables.product.prodname_github_app %}. For more information, see the [related blog post](https://developer.github.com/changes/2016-09-14-Integrations-Early-Access). - -To receive the `performed_via_github_app` object in the response, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.machine-man-preview -``` - -{% endnote %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/performed-by-integration-issue-event.md b/translations/ja-JP/data/reusables/pre-release-program/performed-by-integration-issue-event.md deleted file mode 100644 index 54e004859064..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/performed-by-integration-issue-event.md +++ /dev/null @@ -1,13 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** If an issue event is created via a {% data variables.product.prodname_github_app %}, the response will include the `performed_via_github_app` object with information about the {% data variables.product.prodname_github_app %}. For more information, see the [related blog post](https://developer.github.com/changes/2016-09-14-Integrations-Early-Access). - -To receive the `performed_via_github_app` object in the response, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.machine-man-preview -``` - -{% endnote %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/performed-by-integration-issue.md b/translations/ja-JP/data/reusables/pre-release-program/performed-by-integration-issue.md deleted file mode 100644 index ee0240792f4a..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/performed-by-integration-issue.md +++ /dev/null @@ -1,13 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** If an issue is opened via a {% data variables.product.prodname_github_app %}, the response will include the `performed_via_github_app` object with information about the {% data variables.product.prodname_github_app %}. For more information, see the [related blog post](https://developer.github.com/changes/2016-09-14-Integrations-Early-Access). - -To receive the `performed_via_github_app` object in the response, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.machine-man-preview -``` - -{% endnote %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/scarlet-witch-key-preview.md b/translations/ja-JP/data/reusables/pre-release-program/scarlet-witch-key-preview.md deleted file mode 100644 index a82019b82319..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/scarlet-witch-key-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** Developers can preview a new `code_of_conduct` key in responses. For more information, see [Codes of Conduct API](/v3/codes_of_conduct/). - -To access this new response key during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.scarlet-witch-preview+json -``` -{% endnote %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/scarlet-witch-preview.md b/translations/ja-JP/data/reusables/pre-release-program/scarlet-witch-preview.md deleted file mode 100644 index 860b30d517dc..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/scarlet-witch-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The Codes of Conduct API is currently available for developers to preview. - -To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.scarlet-witch-preview+json -``` -{% endnote %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/shadow-cat-preview.md b/translations/ja-JP/data/reusables/pre-release-program/shadow-cat-preview.md deleted file mode 100644 index 3d95ab9ccae5..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/shadow-cat-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.21" %} -{% note %} - -**Note:** The Draft Pull Request API is currently available for developers to preview. You can use this API to create a draft pull request or see whether a pull request is in draft state. See the [blog post](https://developer.github.com/changes/2019-02-14-draft-pull-requests) preview for more details. To access the new `draft` parameter during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.shadow-cat-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/sombra-preview.md b/translations/ja-JP/data/reusables/pre-release-program/sombra-preview.md deleted file mode 100644 index 9298dfa844f5..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/sombra-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** The Interactions API is currently in public preview. See the [blog post](https://developer.github.com/changes/2018-12-18-interactions-preview) preview for more details. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.sombra-preview -``` - -{% endnote %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/squirrel-girl-preview.md b/translations/ja-JP/data/reusables/pre-release-program/squirrel-girl-preview.md deleted file mode 100644 index 52bd9558fc3b..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/squirrel-girl-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Note:** APIs for managing reactions are currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - - ``` - application/vnd.github.squirrel-girl-preview+json - ``` - {% endnote %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/squirrel-girl-response-preview.md b/translations/ja-JP/data/reusables/pre-release-program/squirrel-girl-response-preview.md deleted file mode 100644 index 18d162292a2d..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/squirrel-girl-response-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The [reactions API](/v3/reactions/) is available for developers to preview. The `url` can be used to construct the API location for [listing and creating](/v3/reactions) reactions. See the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details. To receive the `reactions` object in the response for this endpoint you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.squirrel-girl-preview -``` - -{% endnote %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/superpro-preview.md b/translations/ja-JP/data/reusables/pre-release-program/superpro-preview.md deleted file mode 100644 index f0878ed234c6..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/superpro-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The [Global Webhooks API](/rest/reference/enterprise-admin#global-webhooks) is currently available for developers to preview. To access the API during the preview period, you must provide a custom [media type](/rest/overview/media-types) in the `Accept` header: - -``` -application/vnd.github.superpro-preview+json -``` - -{% endnote %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/surtur-preview.md b/translations/ja-JP/data/reusables/pre-release-program/surtur-preview.md deleted file mode 100644 index 9cfdfe8ad8dc..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/surtur-preview.md +++ /dev/null @@ -1,21 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -{% note %} - -**Note:** New repository creation permissions are available to preview. You can now use `members_can_create_public_repositories`, `members_can_create_private_repositories`, and `members_can_create_internal_repositories`. You can only allow members to create internal repositories if your organization is associated with an enterprise account using {% data variables.product.prodname_ghe_cloud %} or {% data variables.product.prodname_ghe_server %} 2.20+. These parameters provide more granular permissions to configure the type of repositories organization members can create. - -To access these new parameters during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.surtur-preview+json -``` -{% endnote %} -{% else %} -{% note %} - -**Note:** New repository creation permissions are available to preview. You can now set the `members_allowed_repository_creation_type` parameter to configure whether organization members can create repositories and the type of repositories they can create. - -To access this new parameter during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.surtur-preview+json -``` -{% endnote %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/switcheroo-preview.md b/translations/ja-JP/data/reusables/pre-release-program/switcheroo-preview.md deleted file mode 100644 index fbbbe3817bd9..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/switcheroo-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Note:** Enabling and disabling Pages in the Pages API is currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2019-03-14-enabling-disabling-pages/) preview for more details. To access the new endpoints during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.switcheroo-preview+json -``` - -{% endnote %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/symmetra-preview.md b/translations/ja-JP/data/reusables/pre-release-program/symmetra-preview.md deleted file mode 100644 index c578f33898be..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/symmetra-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% if currentVersion != ‘dotcom’ and currentVersion ver_lt "enterprise-server@2.20" %} -{% note %} - -**Note:** You can add or edit descriptions in labels. See the [blog post](https://developer.github.com/changes/2018-02-22-label-description-search-preview) for full details. To access this feature during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.symmetra-preview+json -``` -{% endnote %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/thor-pre-release.md b/translations/ja-JP/data/reusables/pre-release-program/thor-pre-release.md deleted file mode 100644 index e034ce622e48..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/thor-pre-release.md +++ /dev/null @@ -1,13 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.13" %} -{% note %} - -**Note:** Team-based review requests in the Review Requests API on {% data variables.product.product_name %} are currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2017-07-26-team-review-request-thor-preview) for full details. - -To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.thor-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/usage-api-beta.md b/translations/ja-JP/data/reusables/pre-release-program/usage-api-beta.md deleted file mode 100644 index 0fb7989fc11c..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/usage-api-beta.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% warning %} - -**Warning:** This {% data variables.product.prodname_actions %} usage endpoint is currently in public beta and subject to change. For more information, see "[GitHub Actions API workflow usage](https://developer.github.com/changes/2020-05-15-actions-api-workflow-usage)." - -{% endwarning %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/wyandotte-preview.md b/translations/ja-JP/data/reusables/pre-release-program/wyandotte-preview.md deleted file mode 100644 index 2d5c90f982c3..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/wyandotte-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** To access the Migrations API, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.wyandotte-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/x-ray-preview.md b/translations/ja-JP/data/reusables/pre-release-program/x-ray-preview.md deleted file mode 100644 index c09b481483ca..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/x-ray-preview.md +++ /dev/null @@ -1,13 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" %} -{% note %} - -**Note:** When a GitHub Enterprise instance is in private mode, site and repository administrators can enable anonymous Git access for a public repository. This feature is currently available for developers to preview. See the [blog post](https://blog.github.com/2018-07-12-introducing-enterprise-2-14/) for full details. - -To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.x-ray-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/pre-release-program/zzzax-preview.md b/translations/ja-JP/data/reusables/pre-release-program/zzzax-preview.md deleted file mode 100644 index 1614b2e1532d..000000000000 --- a/translations/ja-JP/data/reusables/pre-release-program/zzzax-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.12" %} -{% note %} - -**Note:** Protected Branches API can now manage a setting for requiring signed commits. This feature is currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2018-02-22-protected-branches-required-signatures) for full details. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.zzzax-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/pulls/diff_location.md b/translations/ja-JP/data/reusables/pulls/diff_location.md deleted file mode 100644 index 5e9758e14fbe..000000000000 --- a/translations/ja-JP/data/reusables/pulls/diff_location.md +++ /dev/null @@ -1,7 +0,0 @@ -{% note %} - -**ノート:** ファイル中の特定の行にコメントするには、まずdiff中でその行の_位置_を判断しなければなりません。 GitHub REST APIは、`application/vnd.github.v3.diff`という[メディアタイプ](/v3/media/#commits-commit-comparison-and-pull-requests)を提供しています。 プルリクエストのdiffを見るには、このメディアタイプを[single pull request](/v3/pulls/#get-a-pull-request)エンドポイントの呼び出しの`Accept`ヘッダに追加してください。 - -`position`の値は、コメントを追加したいファイル中の最初の"@@"ハンクヘッダから数えた行数に等しくなります。 "@@"の行のすぐ下の行の位置は1、次の行の位置は2というようになります。 diff中の位置は、空白行や追加のハンクの行も含めて、新しいファイルの先頭まで増え続けます。 - -{% endnote %} diff --git a/translations/ja-JP/data/reusables/pulls/multiline_comments_summary_for_responses.md b/translations/ja-JP/data/reusables/pulls/multiline_comments_summary_for_responses.md deleted file mode 100644 index 15e0385c923a..000000000000 --- a/translations/ja-JP/data/reusables/pulls/multiline_comments_summary_for_responses.md +++ /dev/null @@ -1,21 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} - -##### 複数行コメントの概要 - -{% note %} - -**ノート:** 開発者は、新しいパラメータとレスポンスフィールドをプレビューで利用できます。 プレビューの期間中、これらのレスポンスフィールドは事前の通告なしに変更されることがあります。 完全な詳細については[ブログポスト](https://developer.github.com/changes/2019-10-03-multi-line-comments)を参照してください。 - -{% endnote %} - -レスポンス中で複数行のコメントをサポートしているフィールドを示すには、`comfort-fade`プレビューヘッダと`line` パラメータを使ってください。 - -`comfort-fade`プレビューヘッダを使うと、レスポンスは以下を示します。 -- 複数行のコメントについて、`start_line`、`original_start_line`、`start_side`、`line`、`original_line`、`side`の値。 -- 単一行のコメントについて、`line`、`original_line`、`side`の値と、`start_line`、`original_start_line`、`start_side`では`null`値。 - -`comfort-fade`プレビューヘッダを使わない場合、複数行と単一行のコメントは、レスポンスでは単一の` position`属性を持って同じようになります。 レスポンスは以下を示します。 -- 複数行のコメントについては、`position`属性にコメントの範囲の最終行。 -- 単一行のコメントについては、`position`属性に参照コメントのdiffのポジションの方法を採ります。 詳しい情報については、[入力パラメータ](/v3/pulls/comments/#parameters-2)テーブルの`position`を参照してください。 - -{% endif %} diff --git a/translations/ja-JP/data/reusables/pulls/pull_request_access.md b/translations/ja-JP/data/reusables/pulls/pull_request_access.md deleted file mode 100644 index 5a89e560c6b5..000000000000 --- a/translations/ja-JP/data/reusables/pulls/pull_request_access.md +++ /dev/null @@ -1,5 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} - -パブリックリポジトリでプルリクエストをオープンしたり更新したりするには、ヘッドブランチもしくはソースブランチに対する書き込みアクセス権を持っていなければなりません。 Organizationが所有しているリポジトリの場合、プルリクエストをオープンあるいは更新するためには、リポジトリを所有しているOrganizationのメンバーでなければなりません。 - -{% endif %} diff --git a/translations/ja-JP/data/reusables/pulls/pull_request_mergeability.md b/translations/ja-JP/data/reusables/pulls/pull_request_mergeability.md deleted file mode 100644 index 0bbc6768314c..000000000000 --- a/translations/ja-JP/data/reusables/pulls/pull_request_mergeability.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**ノート:** プルリクエストがマージできるかをチェックするテストマージコミットをトリガーするには、明示的に[プルリクエストをリクエスト](/v3/pulls/#get-a-pull-request)しなければなりません。 詳しい情報については「[プルリクエストがマージできるかをチェックする](/v3/git/#checking-mergeability-of-pull-requests)」を参照してください。 - -{% endnote %} diff --git a/translations/ja-JP/data/reusables/pulls/pullrequests_as_issues.md b/translations/ja-JP/data/reusables/pulls/pullrequests_as_issues.md deleted file mode 100644 index dd61235a572c..000000000000 --- a/translations/ja-JP/data/reusables/pulls/pullrequests_as_issues.md +++ /dev/null @@ -1,7 +0,0 @@ -{% note %} - -**Note**: GitHub's REST API considers every pull request an issue, but not every issue is a pull request. そのため、"Issues"エンドポイントはレスポンス中でIssueとプルリクエストの両方を返すことがあります。 プルリクエストは`pull_request`キーによって判別できます。 - -"Issues"エンドポイントから返されるプルリクエストの`id`は_issue id_になることに注意してください。 プルリクエストidを得るには、「[List pull requests](/v3/pulls/#list-pull-requests)」エンドポイントを使ってください。 - -{% endnote %} diff --git a/translations/ja-JP/data/reusables/reminders/install-slack.md b/translations/ja-JP/data/reusables/reminders/install-slack.md deleted file mode 100644 index 6174e37d3f71..000000000000 --- a/translations/ja-JP/data/reusables/reminders/install-slack.md +++ /dev/null @@ -1 +0,0 @@ -リポジトリすべてのSlackをインストールしたいなら、**All repositories（すべてのリポジトリ）**を選択してください。 選択したリポジトリにのみSlackをインストールしたいなら、**Only select repositories（選択されたリポジトリのみ）**を選択してください。 そして、Slackのアクセスを許可したい権限のリストを読み、**Install（インストール）**をクリックしてください。 ![Slackのインストールボタン](/assets/images/help/settings/scheduled-reminders-install-slack.png) diff --git a/translations/ja-JP/data/reusables/reminders/scheduled-reminders-beta.md b/translations/ja-JP/data/reusables/reminders/scheduled-reminders-beta.md deleted file mode 100644 index daed5f62d489..000000000000 --- a/translations/ja-JP/data/reusables/reminders/scheduled-reminders-beta.md +++ /dev/null @@ -1 +0,0 @@ -プルリクエストに対するスケジュールされたリマインダーは現在ベータであり、変更されることがあります。 スケジュールされたリマインダーの次回のベータフェーズへのアクセスをリクエストするには、[GitHub Scheduled Reminders](https://github.com/features/reminders/signup)の待ちリストに加わってください。 diff --git a/translations/ja-JP/data/reusables/repositories/actions-new-workflow.md b/translations/ja-JP/data/reusables/repositories/actions-new-workflow.md deleted file mode 100644 index b31a37907d75..000000000000 --- a/translations/ja-JP/data/reusables/repositories/actions-new-workflow.md +++ /dev/null @@ -1,2 +0,0 @@ -1. 左上で**New workflow（新規ワークフロー）**をクリックしてください。 ![新規ワークフローの選択](/assets/images/help/repository/actions-new-workflow.png) - \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/repositories/actions-set-up-workflow-template.md b/translations/ja-JP/data/reusables/repositories/actions-set-up-workflow-template.md deleted file mode 100644 index 855bf907e22f..000000000000 --- a/translations/ja-JP/data/reusables/repositories/actions-set-up-workflow-template.md +++ /dev/null @@ -1 +0,0 @@ -1. 使いたいテンプレート名の下で、**Set up this workflow（このワークフローをセットアップする）**をクリックしてください。 ![Node.jsの推奨テンプレート](/assets/images/help/repository/actions-recommended-workflow-template.png) diff --git a/translations/ja-JP/data/reusables/repositories/opt-out-automated-security-updates.md b/translations/ja-JP/data/reusables/repositories/opt-out-automated-security-updates.md deleted file mode 100644 index fd339855a8fa..000000000000 --- a/translations/ja-JP/data/reusables/repositories/opt-out-automated-security-updates.md +++ /dev/null @@ -1,2 +0,0 @@ -1. "Automated security updates（自動化されたセキュリティのアップデート）"の下で、 **Opt out of automated security updates（自動化されたセキュリティアップデートのオプトアウト）**を選択もしくは選択解除してください。 ![自動化されたセキュリティのアップデートのオプトアウトのチェックボックス](/assets/images/help/repository/opt-out-automated-security-updates.png) -2. **Save**をクリックします。 diff --git a/translations/ja-JP/data/reusables/repositories/opt-out-dependabot-security-updates.md b/translations/ja-JP/data/reusables/repositories/opt-out-dependabot-security-updates.md deleted file mode 100644 index 3a68c3c20731..000000000000 --- a/translations/ja-JP/data/reusables/repositories/opt-out-dependabot-security-updates.md +++ /dev/null @@ -1 +0,0 @@ -1. To the right of "{% data variables.product.prodname_dependabot_short %} security updates", click **Disable all** or **Enable all**. !["Disable all" or "Enable all" button for {% data variables.product.prodname_dependabot_short %} security updates](/assets/images/help/repository/opt-out-dependabot-security-updates.png) diff --git a/translations/ja-JP/data/reusables/repositories/settings-security-and-analysis-tab-beta.md b/translations/ja-JP/data/reusables/repositories/settings-security-and-analysis-tab-beta.md deleted file mode 100644 index a0ff1d2fe329..000000000000 --- a/translations/ja-JP/data/reusables/repositories/settings-security-and-analysis-tab-beta.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**ノート**: セキュリティと分析設定の管理の新しい体験はベータであり、変更されることがあります。 - -{% endnote %} diff --git a/translations/ja-JP/data/reusables/repositories/sidebar-integrations-and-services.md b/translations/ja-JP/data/reusables/repositories/sidebar-integrations-and-services.md deleted file mode 100644 index 8a5e2c0758c4..000000000000 --- a/translations/ja-JP/data/reusables/repositories/sidebar-integrations-and-services.md +++ /dev/null @@ -1 +0,0 @@ -1. **Integrations & Services（インテグレーション&サービス）**をクリックしてください。 ![インテグレーションとサービスの選択](/assets/images/help/settings/integrations_and_services_menu.png) diff --git a/translations/ja-JP/data/reusables/repositories/troubleshooting-dependency-graph.md b/translations/ja-JP/data/reusables/repositories/troubleshooting-dependency-graph.md deleted file mode 100644 index 601e768cbab3..000000000000 --- a/translations/ja-JP/data/reusables/repositories/troubleshooting-dependency-graph.md +++ /dev/null @@ -1 +0,0 @@ -プロジェクトが依存関係を持っていながら、グラフ中で検出された依存関係がない場合は、依存関係を含むファイルに問題があるかもしれません。 プロジェクトのファイルがファイルタイプに合わせて適切にフォーマットされているかをチェックしてください。 diff --git a/translations/ja-JP/data/reusables/repositories/you-can-enable-or-disable-security-features.md b/translations/ja-JP/data/reusables/repositories/you-can-enable-or-disable-security-features.md deleted file mode 100644 index ce70639e21b6..000000000000 --- a/translations/ja-JP/data/reusables/repositories/you-can-enable-or-disable-security-features.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Note**: The code scanning and secret scanning beta includes a new experience for managing security and analysis settings. If you're participating in the beta, skip the following steps and see "[Managing security and analysis settings for your repository](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository)." - -{% endnote %} diff --git a/translations/ja-JP/data/reusables/repositories/you-can-manage-access-to-security-alerts.md b/translations/ja-JP/data/reusables/repositories/you-can-manage-access-to-security-alerts.md deleted file mode 100644 index 487943cddffa..000000000000 --- a/translations/ja-JP/data/reusables/repositories/you-can-manage-access-to-security-alerts.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**ノート**: コードスキャンニング及びシークレットスキャンニングのベータには、セキュリティアラートへのアクセスとともに人とTeamを管理する新しい体験が含まれています。 ベータに参加しているなら、以下のステップは飛ばして「[リポジトリのセキュリティ及び分析設定の管理](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository#granting-access-to-github-dependabot-alerts)」を参照してください。 - -{% endnote %} diff --git a/translations/ja-JP/data/reusables/saml/scim-unavailable-for-enterprise-accounts.md b/translations/ja-JP/data/reusables/saml/scim-unavailable-for-enterprise-accounts.md deleted file mode 100644 index d0e03a623425..000000000000 --- a/translations/ja-JP/data/reusables/saml/scim-unavailable-for-enterprise-accounts.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**ノート**: SCIMサポートは、現時点で{% data variables.product.prodname_dotcom %}上のEnterpriseアカウントでは利用できません。 - -{% endnote %} diff --git a/translations/ja-JP/data/reusables/scim/complete_user_example.md b/translations/ja-JP/data/reusables/scim/complete_user_example.md deleted file mode 100644 index e444e167ecc8..000000000000 --- a/translations/ja-JP/data/reusables/scim/complete_user_example.md +++ /dev/null @@ -1,7 +0,0 @@ -<%= json \ "schemas":["urn:ietf:params:scim:schemas:core:2.0:User"], "userName":"mona.octocat@okta.example.com", "name":{ "familyName":"Octocat", "givenName":"Mona" }, "emails":[ - { - "value":"mona.octocat@okta.example.com", - "type":"work", - "primary": true - } - ] %> diff --git a/translations/ja-JP/data/reusables/scim/user_required_values.md b/translations/ja-JP/data/reusables/scim/user_required_values.md deleted file mode 100644 index 618daefe38f1..000000000000 --- a/translations/ja-JP/data/reusables/scim/user_required_values.md +++ /dev/null @@ -1 +0,0 @@ -以下の例に示すように、少なくともユーザの必須の値として`userName`、`name`、`emails`を提供しなければなりません。 diff --git a/translations/ja-JP/data/reusables/search/exact-match-beta.md b/translations/ja-JP/data/reusables/search/exact-match-beta.md deleted file mode 100644 index 5613502e4309..000000000000 --- a/translations/ja-JP/data/reusables/search/exact-match-beta.md +++ /dev/null @@ -1 +0,0 @@ -コード検索の完全一致は、限定された数のユーザと{% data variables.product.prodname_dotcom %}上のリポジトリに対するベータであり、変更されることがあります。 diff --git a/translations/ja-JP/data/reusables/search/exact-match.md b/translations/ja-JP/data/reusables/search/exact-match.md deleted file mode 100644 index 18cc8fca7d13..000000000000 --- a/translations/ja-JP/data/reusables/search/exact-match.md +++ /dev/null @@ -1 +0,0 @@ -任意の文字、数字、シンボルの組み合わせを含む完全一致でコードを検索できます。 diff --git a/translations/ja-JP/data/reusables/shortdesc/2fa.md b/translations/ja-JP/data/reusables/shortdesc/2fa.md deleted file mode 100644 index 4b97373f8d78..000000000000 --- a/translations/ja-JP/data/reusables/shortdesc/2fa.md +++ /dev/null @@ -1 +0,0 @@ -2要素認証を設定している場合、このエンドポイントに対する基本認証には、ワンタイムパスワード（OTP）及びトークンの代わりにユーザ名とパスワードを使うことが必要になります。 詳しい情報については「[2要素認証の利用](/v3/auth/#working-with-two-factor-authentication)」を参照してください。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/shortdesc/content_reference_body.md b/translations/ja-JP/data/reusables/shortdesc/content_reference_body.md deleted file mode 100644 index 4b89190d30bf..000000000000 --- a/translations/ja-JP/data/reusables/shortdesc/content_reference_body.md +++ /dev/null @@ -1 +0,0 @@ -You have used an email that already exists for the user_email_uniq field.\n \## DETAILS:\n\nThe (email)=(Octocat@github.com) already exists.\n\n The error was found in core/models.py in get_or_create_user at line 62.\n\n\ self.save() \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/shortdesc/content_reference_title.md b/translations/ja-JP/data/reusables/shortdesc/content_reference_title.md deleted file mode 100644 index 531d7aabf6de..000000000000 --- a/translations/ja-JP/data/reusables/shortdesc/content_reference_title.md +++ /dev/null @@ -1 +0,0 @@ -[A-1234] Error found in core/models.py file \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/sponsors/email-submit-bank-info.md b/translations/ja-JP/data/reusables/sponsors/email-submit-bank-info.md deleted file mode 100644 index 6f307852efad..000000000000 --- a/translations/ja-JP/data/reusables/sponsors/email-submit-bank-info.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_sponsors %} に参加後は、銀行口座情報と納税フォームをサブミットする手順が書かれたメールが送信されます。 diff --git a/translations/ja-JP/data/reusables/sponsors/matching-period.md b/translations/ja-JP/data/reusables/sponsors/matching-period.md deleted file mode 100644 index 079af41d5560..000000000000 --- a/translations/ja-JP/data/reusables/sponsors/matching-period.md +++ /dev/null @@ -1 +0,0 @@ -個人が{% data variables.product.prodname_sponsors %}に参加している最初の一年については、ここで述べられている制限内でスポンサーシップはマッチングに参加する資格がある場合があります。 マッチングへの参加資格は、スポンサーシップのプロフィールを公開している{% data variables.product.prodname_sponsors %}へのアカウントを、{% data variables.product.company_short %}が認めた後から始まります。 マッチングの期間は、いかなる理由によっても拡大できません。 {% data variables.product.prodname_sponsors %}を離れて後に再度加わった場合、参加の空白期間はマッチングの期間としてカウントされたり、マッチングの期間が切れてしまったりすることがあります。 diff --git a/translations/ja-JP/data/reusables/sponsors/org-sponsorship-dashboard.md b/translations/ja-JP/data/reusables/sponsors/org-sponsorship-dashboard.md deleted file mode 100644 index daef2019ebcb..000000000000 --- a/translations/ja-JP/data/reusables/sponsors/org-sponsorship-dashboard.md +++ /dev/null @@ -1 +0,0 @@ -1. Organizationの右で、**Sponsorship dashboard（スポンサーシップダッシュボード）**をクリックしてください。 ![スポンサーシップダッシュボードボタン](/assets/images/help/sponsors/org-sponsorship-dashboard.png) diff --git a/translations/ja-JP/data/reusables/support/advanced-security-support-terms-differ.md b/translations/ja-JP/data/reusables/support/advanced-security-support-terms-differ.md deleted file mode 100644 index 40c12122a3cb..000000000000 --- a/translations/ja-JP/data/reusables/support/advanced-security-support-terms-differ.md +++ /dev/null @@ -1 +0,0 @@ -この記事の条項は{% data variables.product.prodname_advanced_security %}のサポートには適用されません。 詳しい情報については「[{% data variables.product.prodname_advanced_security %}のサポートについて](/enterprise/admin/enterprise-support/about-support-for-advanced-security)」を参照してください。 diff --git a/translations/ja-JP/data/reusables/support/ghec-premium-priority-high-description.md b/translations/ja-JP/data/reusables/support/ghec-premium-priority-high-description.md deleted file mode 100644 index 9edd5d4f7636..000000000000 --- a/translations/ja-JP/data/reusables/support/ghec-premium-priority-high-description.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_ghe_cloud %}上のOrganizationもしくはEnterpriseにおけるアカウントもしくはセキュリティの問題が、ビジネスに限定的な影響を及ぼしている。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/support/ghec-premium-priority-high-examples.md b/translations/ja-JP/data/reusables/support/ghec-premium-priority-high-examples.md deleted file mode 100644 index d68f86b5f0d0..000000000000 --- a/translations/ja-JP/data/reusables/support/ghec-premium-priority-high-examples.md +++ /dev/null @@ -1 +0,0 @@ -
    • OrganizationあるいはEnterpriseのオーナーが、意図せずOrganizationを削除した。
    • OrganizationあるいはEnterpriseのメンバーが、コミット、Issue、プルリクエスト、Issueへの添付ファイル内でセンシティブなデータをアップロードした。
    \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/support/ghec-premium-priority-low-description.md b/translations/ja-JP/data/reusables/support/ghec-premium-priority-low-description.md deleted file mode 100644 index 7aa6b21351ea..000000000000 --- a/translations/ja-JP/data/reusables/support/ghec-premium-priority-low-description.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_ghe_cloud %}上のOrganizationあるいはEnterpriseに関して、時間の問題がない、あるいはチームの生産性を阻害していない疑問や提案がある。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/support/ghec-premium-priority-low-examples.md b/translations/ja-JP/data/reusables/support/ghec-premium-priority-low-examples.md deleted file mode 100644 index 6a5a87bfb853..000000000000 --- a/translations/ja-JP/data/reusables/support/ghec-premium-priority-low-examples.md +++ /dev/null @@ -1 +0,0 @@ -
    • OrganizationあるいはEnterpriseによる過剰なリソースの利用
    • ヘルスチェックのリクエスト
    • Gists、通知、ウィキ、{% data variables.product.prodname_pages %}、{% data variables.product.prodname_desktop %}、Atom、あるいはその他のOrganizationあるいはEnterpriseについての周辺サービスや機能の利用に関する支援
    • 機能リクエスト
    • 製品のフィードバック
    \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/support/ghec-premium-priority-normal-description.md b/translations/ja-JP/data/reusables/support/ghec-premium-priority-normal-description.md deleted file mode 100644 index 0b471275abfc..000000000000 --- a/translations/ja-JP/data/reusables/support/ghec-premium-priority-normal-description.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_ghe_cloud %}上のOrganizationあるいはEnterpriseのメンバーが、{% data variables.product.prodname_dotcom_the_website %}において限定的あるいは中程度の問題を体験している、もしくはOrganizatonもしくはEnterpriseに関する一般的な懸念や疑問がある。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/support/ghec-premium-priority-normal-examples.md b/translations/ja-JP/data/reusables/support/ghec-premium-priority-normal-examples.md deleted file mode 100644 index f51e2f137a42..000000000000 --- a/translations/ja-JP/data/reusables/support/ghec-premium-priority-normal-examples.md +++ /dev/null @@ -1 +0,0 @@ -
    • OrganizationもしくはEnterpriseのためのAPIや機能の利用についての疑問
    • {% data variables.product.company_short %}が提供しているOrganizationのデータ移行のためのツールについての問題
    • OrganizationあるいはEnterpriseに関係する機能が、期待どおりに動作していない
    • OrganizationあるいはEnterpriseに関する一般的なセキュリティの疑問
    \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/support/ghec-premium-priority-urgent-description.md b/translations/ja-JP/data/reusables/support/ghec-premium-priority-urgent-description.md deleted file mode 100644 index 8dd8ffd31102..000000000000 --- a/translations/ja-JP/data/reusables/support/ghec-premium-priority-urgent-description.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_ghe_cloud %}上のOrganizationあるいはEnterpriseのプロダクションワークフローが、重大なサービスのエラーもしくは中断のために失敗しており、その失敗が直接的にビジネスの運用に影響している。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/support/ghec-premium-priority-urgent-examples.md b/translations/ja-JP/data/reusables/support/ghec-premium-priority-urgent-examples.md deleted file mode 100644 index 0911c48c81d1..000000000000 --- a/translations/ja-JP/data/reusables/support/ghec-premium-priority-urgent-examples.md +++ /dev/null @@ -1 +0,0 @@ -
    • {% data variables.product.prodname_dotcom_the_website %}のエラーもしくは中断が、OrganizationもしくはEnterpriseのすべてのメンバーに対し、中核的なGitもしくはWebアプリケーションの機能に影響している。
    \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/support/github-one-premium-plus-response-times-differ.md b/translations/ja-JP/data/reusables/support/github-one-premium-plus-response-times-differ.md deleted file mode 100644 index b87589a30664..000000000000 --- a/translations/ja-JP/data/reusables/support/github-one-premium-plus-response-times-differ.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_ghe_one %}を購入したお客様には、{% data variables.product.prodname_actions %}、{% data variables.product.prodname_insights %}、{% data variables.product.prodname_learning %}、{% data variables.product.prodname_registry %}のサポートが1日24時間、週末と米国の祝日を除く週に5日利用できます。 返信までの標準的な時間は 1 営業日です。 diff --git a/translations/ja-JP/data/reusables/support/github-one-premium-plus-sla-differs.md b/translations/ja-JP/data/reusables/support/github-one-premium-plus-sla-differs.md deleted file mode 100644 index c1e9845529b6..000000000000 --- a/translations/ja-JP/data/reusables/support/github-one-premium-plus-sla-differs.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_ghe_one %}を購入したお客様については、{% data variables.contact.premium_support %}による初期返信時間のSLAは、{% data variables.product.prodname_actions %}、{% data variables.product.prodname_insights %}、{% data variables.product.prodname_learning %}、{% data variables.product.prodname_registry %}のチケットには適用されません。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/support/github-one-premium-plus-support-terms-differ.md b/translations/ja-JP/data/reusables/support/github-one-premium-plus-support-terms-differ.md deleted file mode 100644 index fda2aca4d884..000000000000 --- a/translations/ja-JP/data/reusables/support/github-one-premium-plus-support-terms-differ.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_ghe_one %}を購入したお客様については、{% data variables.product.prodname_actions %}、{% data variables.product.prodname_insights %}、{% data variables.product.prodname_learning %}、{% data variables.product.prodname_registry %}に関する{% data variables.product.premium_plus_support_plan %}のサポートの条件は異なります。 \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/teams/team-sync.md b/translations/ja-JP/data/reusables/teams/team-sync.md deleted file mode 100644 index b161ac3bb726..000000000000 --- a/translations/ja-JP/data/reusables/teams/team-sync.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - - **ノート: ** Organizationのアイデンティティプロバイダ（Idp）でTeamに同期をセットアップしている場合、Teamのメンバーシップを変更するためのこのAPIを使おうとすると、エラーが返されます。 グループのメンバーシップを管理するためにIdpにアクセスできるなら、GitHubのTeamメンバーシップをアイデンティティプロバイダを通じて管理できます。そうすれば、Organizationで自動的にTeamメンバーの追加や削除が行われます。 詳しい情報については「[アイデンティティプロバイダとGitHub間でのTeamの同期](/articles/synchronizing-teams-between-your-identity-provider-and-github/)」を参照してください。 - -{% endnote %} -{% endif %} diff --git a/translations/ja-JP/data/reusables/user-settings/throttling-notice.md b/translations/ja-JP/data/reusables/user-settings/throttling-notice.md deleted file mode 100644 index 78e388a36a8b..000000000000 --- a/translations/ja-JP/data/reusables/user-settings/throttling-notice.md +++ /dev/null @@ -1 +0,0 @@ -コンおエンドポイントは[通知](/articles/about-notifications/)をトリガします。 このエンドポイントを使ってあまりに速くコンテンツを作成すると、不正利用レート制限にかかるかもしれません。 See "[Abuse rate limits](/v3/#abuse-rate-limits)"{% if currentVersion == "free-pro-team@latest" %} and "[Dealing with abuse rate limits](/v3/guides/best-practices-for-integrators/#dealing-with-abuse-rate-limits)"{% endif %} for details. diff --git a/translations/ja-JP/data/reusables/webhooks/interactive_component_short_desc.md b/translations/ja-JP/data/reusables/webhooks/interactive_component_short_desc.md deleted file mode 100644 index 6ec63523f5cd..000000000000 --- a/translations/ja-JP/data/reusables/webhooks/interactive_component_short_desc.md +++ /dev/null @@ -1 +0,0 @@ -Triggered when a user clicks an interactive element that was created using the {% data variables.product.prodname_component_kit %}. {% data variables.product.prodname_github_app %}s are automatically subscribed to the `interactive_component` event so there's no need to manually subscribe to this event. Unlike other webhook events, the `interactive_component` event is only sent to the {% data variables.product.prodname_github_app %} that a user interacted with through an interactive component, such as in a composable comment. {% data variables.product.prodname_oauth_app %}s cannot subscribe to the `interactive_component` event and other installed {% data variables.product.prodname_github_app %}s will not receive the webhook event even if they subscribed to `interactive_component`. \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/webhooks/issue_comment_event_api_properties.md b/translations/ja-JP/data/reusables/webhooks/issue_comment_event_api_properties.md deleted file mode 100644 index 92dc67dd438f..000000000000 --- a/translations/ja-JP/data/reusables/webhooks/issue_comment_event_api_properties.md +++ /dev/null @@ -1,3 +0,0 @@ -| キー | 種類 | 説明 | -| -------- | -------- | ---------------------------------------------------------------------- | -| `action` | `string` | The action that was performed on the comment. Can be one of `created`. | \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/webhooks/package_short_desc.md b/translations/ja-JP/data/reusables/webhooks/package_short_desc.md deleted file mode 100644 index 9b2e7ed32efb..000000000000 --- a/translations/ja-JP/data/reusables/webhooks/package_short_desc.md +++ /dev/null @@ -1 +0,0 @@ -Activity related to GitHub Packages. {% data reusables.webhooks.action_type_desc %} For more information, see "[GitHub Packages](/packages)". \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/webhooks/pull_request_forked_repos_link.md b/translations/ja-JP/data/reusables/webhooks/pull_request_forked_repos_link.md deleted file mode 100644 index 0fad1bebc3a1..000000000000 --- a/translations/ja-JP/data/reusables/webhooks/pull_request_forked_repos_link.md +++ /dev/null @@ -1 +0,0 @@ -See [below](#pull-request-events-for-forked-repositories) to learn how this event works with forked repositories. \ No newline at end of file diff --git a/translations/ja-JP/data/variables/ant-man.yml b/translations/ja-JP/data/variables/ant-man.yml deleted file mode 100644 index fd9020681ae1..000000000000 --- a/translations/ja-JP/data/variables/ant-man.yml +++ /dev/null @@ -1,3 +0,0 @@ ---- -deployments-ant-man-parameter-note: >- - {% if currentVersion == "free-pro-team@latest" %}**Note:** This parameter requires you to use the [`application/vnd.github.ant-man-preview+json`](/v3/previews/#enhanced-deployments) custom media type.{% endif %} diff --git a/translations/ja-JP/data/variables/cloud-9.yml b/translations/ja-JP/data/variables/cloud-9.yml deleted file mode 100644 index 514cc607691b..000000000000 --- a/translations/ja-JP/data/variables/cloud-9.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: The SCIM API diff --git a/translations/ja-JP/data/variables/giant-sentry-fist.yml b/translations/ja-JP/data/variables/giant-sentry-fist.yml deleted file mode 100644 index ae3a16bbeb72..000000000000 --- a/translations/ja-JP/data/variables/giant-sentry-fist.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: The User Blocking API diff --git a/translations/ja-JP/data/variables/korra.yml b/translations/ja-JP/data/variables/korra.yml deleted file mode 100644 index a0e37a535b50..000000000000 --- a/translations/ja-JP/data/variables/korra.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: The Organization Membership API diff --git a/translations/ja-JP/data/variables/mercy.yml b/translations/ja-JP/data/variables/mercy.yml deleted file mode 100644 index 0076f284e63b..000000000000 --- a/translations/ja-JP/data/variables/mercy.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: The `topics` property for repositories diff --git a/translations/ja-JP/data/variables/mister-fantastic.yml b/translations/ja-JP/data/variables/mister-fantastic.yml deleted file mode 100644 index 5040343f790d..000000000000 --- a/translations/ja-JP/data/variables/mister-fantastic.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: The GitHub Pages API diff --git a/translations/ja-JP/data/variables/performed-via-integration.yml b/translations/ja-JP/data/variables/performed-via-integration.yml deleted file mode 100644 index c2d523e86a75..000000000000 --- a/translations/ja-JP/data/variables/performed-via-integration.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: An additional `performed_via_github_app` object in the issue payload diff --git a/translations/ja-JP/data/variables/valkyrie.yml b/translations/ja-JP/data/variables/valkyrie.yml deleted file mode 100644 index 7b921d5113e1..000000000000 --- a/translations/ja-JP/data/variables/valkyrie.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: The GitHub Marketplace API diff --git a/translations/pt-BR/content/actions/building-and-testing-code-with-continuous-integration/about-continuous-integration.md b/translations/pt-BR/content/actions/building-and-testing-code-with-continuous-integration/about-continuous-integration.md deleted file mode 100644 index 4afff53a27d1..000000000000 --- a/translations/pt-BR/content/actions/building-and-testing-code-with-continuous-integration/about-continuous-integration.md +++ /dev/null @@ -1,62 +0,0 @@ ---- -title: Sobre integração contínua -intro: 'Você pode criar fluxos de trabalho personalizados de integração contínua (CI) e implantação contínua (CD) diretamente no seu repositório de {% data variables.product.prodname_dotcom %} com as {% data variables.product.prodname_actions %}.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/about-continuous-integration - - /github/automating-your-workflow-with-github-actions/about-continuous-integration - - /actions/automating-your-workflow-with-github-actions/about-continuous-integration -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Sobre integração contínua - -A integração contínua (CI, Continuous Integration) é uma prática de software que exige commits frequentes de códigos para um repositório compartilhado. Fazer commits de códigos com frequência detecta erros com mais antecedência e reduz a quantidade de código necessária para depuração quando os desenvolvedores chegam à origem de um erro. As atualizações frequentes de código também facilitam o merge de alterações dos integrantes de uma equipe de desenvolvimento de software. Assim, os desenvolvedores podem se dedicar mais à gravação de códigos e se preocupar menos com erros de depuração ou conflitos de merge. - -Ao fazer commit do seu repositório, você pode continuamente compilar e testar o código para garantir que o commit não insira erros. Seus testes podem incluir linters de código (que verificam formatação de estilo), verificações de segurança, cobertura de código, testes funcionais e outras verificações personalizadas. - -Para compilar e testar seu código, é necessário usar um servidor. Você pode criar e testar atualizações no local antes de fazer push do código para um repositório, ou pode usar um servidor de CI que verifica os novos commits de código em um repositório. - -### Sobre integração contínua usando {% data variables.product.prodname_actions %} - -A CI que usa {% data variables.product.prodname_actions %} oferece fluxos de trabalho que podem criar o código no seu repositório e executar os seus testes. Fluxos de trabalho podem ser executados em máquinas virtuais hospedadas em {% data variables.product.prodname_dotcom %} ou em máquinas que você mesmo hospeda. Para obter mais informações, consulte "[Ambientes virtuais para executores hospedados em {% data variables.product.prodname_dotcom %}](/actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)," e "[Sobre executores auto-hospedados](/actions/automating-your-workflow-with-github-actions/about-self-hosted-runners)." - -Você pode configurar seu fluxo de trabalho de CI para ser executado quando ocorre um evento de {% data variables.product.product_name %} (por exemplo, quando um novo código é enviado para o repositório), em uma programação definida, ou quando um evento externo ocorre usando o webhook de envio do repositório. - -{% data variables.product.product_name %} executa seus testes de CI e fornece os resultados de cada teste no pull request para que você possa ver se a mudança no seu branch introduz um erro. Quando todos os testes de CI em um fluxo de trabalho forem aprovados, as alterações que passaram por push estarão prontas para a revisão de um integrante da equipe ou para o merge. Se algum teste falhar, uma de suas alterações pode ter causado a falha. - -Ao configurar o CI no seu repositório, {% data variables.product.product_name %} analisa o código no seu repositório e recomenda fluxos de trabalho CI baseados no idioma e na estrutura do seu repositório. Por exemplo, se você usar o [Node.js](https://nodejs.org/en/), {% data variables.product.product_name %} irá sugerir um arquivo de modelo que instala seus pacotes Node.js e executa seus testes. Você pode usar o modelo do fluxo de trabalho de CI sugerido por {% data variables.product.product_name %}, personalizar o modelo sugerido ou criar o seu próprio arquivo de fluxo de trabalho personalizado para executar seus testes de CI. - -![Captura de tela dos modelos sugeridos de integração contínua](/assets/images/help/repository/ci-with-actions-template-picker.png) - -Além de ajudá-lo a configurar fluxos de trabalho de CI para seu projeto, você pode usar {% data variables.product.prodname_actions %} para criar fluxos de trabalho ao longo de todo o ciclo de vida de desenvolvimento do software. Por exemplo, você pode usar ações para implantar, criar pacotes ou lançar uma versão do seu projeto. Para obter mais informações, consulte "[Sobre {% data variables.product.prodname_actions %}](/articles/about-github-actions)". - -Para obter uma definição de termos comuns, consulte "[Conceitos básicos de {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)". - -### Linguagens compatíveis - -{% data variables.product.product_name %} oferece modelos de fluxo de trabalho de CI para uma variedade de linguagens e estruturas. - -Para obter mais informações, consulte "[Configurar fluxo de trabalho](/articles/configuring-a-workflow)." - -### Notificações para execução de fluxo de trabalho - -{% data reusables.repositories.workflow-notifications %} - -### Selos de status para execução de fluxo de trabalho - -{% data reusables.repositories.actions-workflow-status-badge-into %} - -Para obter mais informações, consulte "[Configurar fluxo de trabalho](/articles/configuring-a-workflow)." - -### Leia mais - -- "[Configurar a integração contínua usando {% data variables.product.prodname_actions %}](/articles/setting-up-continuous-integration-using-github-actions)" -{% if currentVersion == "free-pro-team@latest" %} -- "[Gerenciar a cobrança para {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)" -{% endif %} diff --git a/translations/pt-BR/content/actions/building-and-testing-code-with-continuous-integration/index.md b/translations/pt-BR/content/actions/building-and-testing-code-with-continuous-integration/index.md deleted file mode 100644 index ad9c0ab31a9b..000000000000 --- a/translations/pt-BR/content/actions/building-and-testing-code-with-continuous-integration/index.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: Criando e testando o código com a integração contínua -shortTitle: Integração contínua -intro: 'Você pode usar {% data variables.product.prodname_actions %} para criar fluxos de trabalho de integração contínua personalizada (CI) e implementação contínua (CD) no seu repositório.' -redirect_from: - - /articles/setting-up-continuous-integration-on-github - - /github/automating-your-workflow-with-github-actions/setting-up-continuous-integration-on-github - - /github/automating-your-workflow-with-github-actions/creating-continuous-integration-workflows - - /actions/automating-your-workflow-with-github-actions/creating-continuous-integration-workflows -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -{% link_in_list /about-continuous-integration %} -{% link_in_list /setting-up-continuous-integration-using-github-actions %} diff --git a/translations/pt-BR/content/actions/building-and-testing-code-with-continuous-integration/setting-up-continuous-integration-using-github-actions.md b/translations/pt-BR/content/actions/building-and-testing-code-with-continuous-integration/setting-up-continuous-integration-using-github-actions.md deleted file mode 100644 index 84619ac0f260..000000000000 --- a/translations/pt-BR/content/actions/building-and-testing-code-with-continuous-integration/setting-up-continuous-integration-using-github-actions.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: Configurar a integração contínua usando o GitHub Actions -intro: É possível configurar a integração contínua no seu projeto usando um modelo de fluxo de trabalho correspondente ao idioma e à ferramenta que você quer usar. -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/setting-up-continuous-integration-using-github-actions - - /github/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions - - /actions/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -Qualquer pessoa com permissões de gravação em um repositório pode configurar a integração contínua (CI, Continuous Integration) usando o {% data variables.product.prodname_actions %}. - -Depois de configurar a CI, você pode personalizar o fluxo de trabalho conforme as suas demandas. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -3. Localize o modelo correspondente ao idioma e às ferramentas que você quer usar. Em seguida, clique em **Set up this workflow** (Configurar este fluxo de trabalho). ![Botão Setup workflow (Configurar fluxo de trabalho)](/assets/images/help/repository/setup-workflow-button.png) -5. Clique em **Start commit** (Iniciar commit). ![Botão Start commit (Iniciar commit)](/assets/images/help/repository/start-commit.png) -{% data reusables.files.write_commit_message %} -{% data reusables.files.choose_commit_branch %} -{% data reusables.files.propose_new_file %} - -Depois de fazer push no seu repositório, você pode acompanhar o status e os logs detalhados do fluxo de trabalho de integração contínua no {% data variables.product.prodname_dotcom %} e receber notificações personalizadas. Para obter mais informações, consulte "[Configurando notificações](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)" e " -Gerenciando a execução do fluxo de trabalho".

    - -{% data reusables.repositories.actions-workflow-status-badge-into %} - -Para obter mais informações, consulte "[Configurar fluxo de trabalho](/articles/configuring-a-workflow)." - - - -### Leia mais - -- [Sobre integração contínua](/articles/about-continuous-integration) -- [Gerenciar a execução de fluxos de trabalho](/articles/managing-a-workflow-run) - - {% if currentVersion == "free-pro-team@latest" %} - -- "[Gerenciar a cobrança para {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)" - - {% endif %} diff --git a/translations/pt-BR/content/actions/configuring-and-managing-workflows/about-service-containers.md b/translations/pt-BR/content/actions/configuring-and-managing-workflows/about-service-containers.md deleted file mode 100644 index 339a30ffcc3d..000000000000 --- a/translations/pt-BR/content/actions/configuring-and-managing-workflows/about-service-containers.md +++ /dev/null @@ -1,116 +0,0 @@ ---- -title: Sobre os contêineres de serviço -intro: 'Você pode usar contêineres de serviço para conectar bancos de dados, serviços web, memória cache e outras ferramentas ao seu fluxo de trabalho.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/about-service-containers -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Sobre os contêineres de serviço - -Os contêineres de serviço são contêineres Docker que fornecem uma forma simples e portátil para os seus serviços de hospedagem que você pode precisar testar ou operar a sua aplicação em um fluxo de trabalho. Por exemplo, o seu fluxo de trabalho pode precisar executar testes de integração que necessitem de acesso a um banco de dados e a uma memória cache. - -Você pode configurar os contêineres de serviço para cada trabalho em um fluxo de trabalho. {% data variables.product.prodname_dotcom %} cria um novo contêiner Docker para cada serviço configurado no fluxo de trabalho e destrói o contêiner de serviço quando o trabalho é concluído. As etapas em um trabalho podem comunicar-se com todos os contêineres de serviço que fazem parte do mesmo trabalho. - -{% data reusables.github-actions.docker-container-os-support %} - -### Comunicar-se com os contêineres de serviço - -Você pode configurar trabalhos em um fluxo de trabalho para ser executados diretamente em uma máquina executora ou em um contêiner Docker. A comunicação entre o trabalho e seus contêineres de serviço é diferente, dependendo se um trabalho é executado diretamente na máquina executora ou em um contêiner. - -#### Executar trabalhos em um contêiner - -Ao executar trabalhos em um contêiner, {% data variables.product.prodname_dotcom %} conecta os contêineres de serviço ao trabalho suando as redes de ponte definidas pelo usuário do Docker. Para obter mais informações, consulte "["Usar redes de ponte](https://docs.docker.com/network/bridge/)" na documentação do Docker. - -Executar o trabalho e os serviços em um contêiner simplifica o acesso à rede. Você pode acessar um contêiner de serviço usando a etiqueta que você configurar no fluxo de trabalho. O nome de host do contêiner do serviço é mapeado automaticamente de acordo com o nome da etiqueta. Por exemplo, se você criar um contêiner de serviço com a etiqueta `redis`, o nome de host do contêiner de serviço será `redis`. - -Você não precisa configurar nenhuma porta para os contêineres de serviço. Por padrão, todos os contêineres que fazem parte da mesma rede do Docker expõem todas as portas entre si e nenhuma porta é exposta fora da rede do Docker. - -#### Executar trabalhos na máquina executora - -Ao executar trabalhos diretamente na máquina executora, você poderá acessar os contêineres de serviço usando `localhost:` ou `127.0.0.1:`. {% data variables.product.prodname_dotcom %} configura a rede do contêiner para habilitar a comunicação a partir do contêiner de serviço com o host do Docker. - -Quando um trabalho é executado diretamente em uma máquina executora, o serviço executado no contêiner do Docker não expõe suas portas ao trabalho no executor por padrão. Você deve mapear as portas no contêiner de serviço com o host do Docker. Para obter mais informações, consulte "[Mapeando o host do Docker e as portas do contêiner de serviço](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)". - -### Criar contêineres de serviço - -Você pode usar a palavra-chave `serviços` para criar contêineres de serviço que fazem parte de um trabalho no seu fluxo de trabalho. Para obter mais informações, consulte [`trabalhos..serviços`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idservices). - -Este exemplo cria um serviço denominado `redis` em um trabalho denominado `container-job`. O host do Docker, neste exemplo, é o contêiner `node:10.18-jessie`. - -{% raw %} -```yaml -nome: Exemplo de contêiner Redis -em: push - -trabalhos: - # Etiqueta do trabalho do contêiner - container-job: - # Os contêineres devem ser executados em sistemas operacionais baseados no Linux - runs-on: ubuntu-latest - # Imagem do Docker Hub em que o `container-job` é executado - container: node:10.18-jessie - - # Contêineres de serviço a serem executados com `container-job` - serviços: - # Etiqueta usada para acessar o contêiner de serviço - redis: - # Imagem do Docker Hub - imagem: redis -``` -{% endraw %} - -### Mapear o host do Docker e as portas do contêiner de serviço - -Se o seu trabalho for executado em um contêiner do Docker, você não precisará mapear as portas no host ou no contêiner de serviço. Se o seu trabalho for executado diretamente na máquina executora, você precisará mapear todas as portas do contêiner de serviço necessárias com as portas na máquina executora do host. - -Você pode mapear as portas dos contêineres de serviço com o host do Docker usando a palavra-chave `portas`. Para obter mais informações, consulte [`trabalhos..serviços`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idservices). - -| Valor das `portas` | Descrição | -| ------------------ | ------------------------------------------------------------------------------------------------ | -| `8080:80` | Mapeia a porta 80 TCP no contêiner com a porta 8080 no host do Docker. | -| `8080:80/udp` | Mapeia a porta 80 UDP no contêiner com a porta 8080 no host do Docker. | -| `8080/udp` | Mapeia a porta UDP escolhida aleatoriamente no contêiner com a porta 8080 UDP no host do Docker. | - -Ao mapear portas usando a palavra-chave `portas`, {% data variables.product.prodname_dotcom %}usa o comando `--publicar` para publicar as portas do contêiner no host do Docker. Para obter mais informações, consulte "[Rede do contêiner do Docker](https://docs.docker.com/config/containers/container-networking/)" na documentação do Docker. - -Ao especificar a porta do host do Docker mas não a porta do contêiner, a porta do contêiner será atribuída aleatoriamente a uma porta livre. {% data variables.product.prodname_dotcom %} define a porta do contêiner atribuída no contexto do contêiner de serviço. Por exemplo, para um contêiner de serviço `redis`, se você configurou a porta 5432 do host do Docker, você poderá acessar a porta do contêiner correspondente usando o contexto `job.services.redis.ports[5432]`. Para obter mais informações, consulte "[Contexto e sintaxe de expressão para {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions#job-context)". - -#### Exemplo de mapeamento de portas Redis - -Este exemplo mapeia a porta 6379 do contêiner de serviço `redis` com a porta 6379 do host do Docker. - -{% raw %} -```yaml -nome: Exemplo de serviço Redis -em: push - -trabalhos: - # Etiqueta do trabalho do contêiner - runner-job: - # YoVocê deve usar um ambiente Linux ao usar os contêineres de serviço ou os trabalhos do contêiner - runs-on: ubuntu-latest - - # Contêineres de serviço a ser executados com `runner-job` - serviços: - # Etiqueta usada para acessar o contêiner de serviço - redis: - # Imagem do Docker Hubm - image: redis - # - portas: - # Abre a porta 6379 tcp no host e no contêiner de serviço - - 6379:6379 -``` -{% endraw %} - -### Leia mais - -- [Criando contêineres de serviço Redis](/actions/automating-your-workflow-with-github-actions/creating-redis-service-containers)" -- [Criando contêineres de serviço PostgreSQL](/actions/automating-your-workflow-with-github-actions/creating-postgresql-service-containers)" diff --git a/translations/pt-BR/content/actions/configuring-and-managing-workflows/authenticating-with-the-github_token.md b/translations/pt-BR/content/actions/configuring-and-managing-workflows/authenticating-with-the-github_token.md deleted file mode 100644 index 020bc9f45136..000000000000 --- a/translations/pt-BR/content/actions/configuring-and-managing-workflows/authenticating-with-the-github_token.md +++ /dev/null @@ -1,99 +0,0 @@ ---- -title: Autenticando com o "GITHUB_TOKEN" -intro: '{% data variables.product.prodname_dotcom %} fornece um token que você pode usar para autenticar em nome de {% data variables.product.prodname_actions %}.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /github/automating-your-workflow-with-github-actions/authenticating-with-the-github_token - - /actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -Qualquer pessoa com acesso de `gravar` em um repositório pode criar, ler e usar secredos. - -### Sobre o segredo `GITHUB_TOKEN` - -O {% data variables.product.prodname_dotcom %} cria automaticamente um segredo `GITHUB_TOKEN` para uso no fluxo de trabalho. Você pode usar o `GITHUB_TOKEN` para autenticar em uma execução de fluxo de trabalho. - -Ao habilitar {% data variables.product.prodname_actions %}, {% data variables.product.prodname_dotcom %} instala um {% data variables.product.prodname_github_app %} no seu repositório. O segredo `GITHUB_TOKEN` é um token de acesso de instalação {% data variables.product.prodname_github_app %}. Você pode usar o token de acesso de instalação para autenticar em nome do {% data variables.product.prodname_github_app %} instalado no seu repositório. As permissões do token são restritas ao repositório do fluxo de trabalho. Para obter mais informações, consulte "[Permissões para o `GITHUB_TOKEN`](#permissions-for-the-github_token)". - -Antes de iniciar cada trabalho, {% data variables.product.prodname_dotcom %} busca um token de acesso de instalação para o trabalho. O token expira quando o trabalho é concluído. - -O token também está disponível no contexto `github.token`. Para obter mais informações, consulte "[Contexto e sintaxe de expressão para {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)". - -### Usar o `GITHUB_TOKEN` em um fluxo de trabalho - -Para usar o segredo `GITHUB_TOKEN`, você deve referenciá-lo no arquivo do fluxo de trabalho. Usar um token pode compreender disponibilizar o token como uma entrada para uma ação que o exige ou fazer solicitações de API {% data variables.product.prodname_dotcom %} autenticadas. - -{% data reusables.github-actions.actions-do-not-trigger-workflows %} - -#### Exemplo de passar um `GITHUB_TOKEN` como uma entrada - -Este exemplo de fluxo de trabalho usa a [ação etiquetadora](https://github.com/actions/labeler), que exige o `GITHUB_TOKEN` como o valor para o parâmetro de entrada do `token`: - - {% raw %} - ```yaml - name: Pull request labeler - on: - - pull_request - jobs: - triage: - runs-on: ubuntu-latest - steps: - - uses: actions/labeler@v2 - with: - repo-token: ${{ secrets.GITHUB_TOKEN }} - ``` - {% endraw %} - -#### Exemplo de acessar o API REST - -Você pode usar o `GITHUB_TOKEN` para fazer chamadas de API autenticada. Este exemplo de fluxo de trabalho cria um problema usando a API REST de {% data variables.product.prodname_dotcom %}: - - {% raw %} - ```yaml - name: Create issue on commit - on: - - push - jobs: - create_commit: - runs-on: ubuntu-latest - steps: - - name: Create issue using REST API - run: | - curl --request POST \ - --url https://api.github.com/repos/${{ github.repository }}/issues \ - --header 'authorization: Bearer ${{ secrets.GITHUB_TOKEN }}' \ - --header 'content-type: application/json' \ - --data '{ - "title": "Automated issue for commit: ${{ github.sha }}", - "body": "This issue was automatically created by the GitHub Action workflow **${{ github.workflow }}**. \n\n O hash do commit foi: _${{ github.sha }}_." - }' - ``` - {% endraw %} - -### Permissões para o `GITHUB_TOKEN` - -Para obter informações sobre os pontos de extremidade da API que {% data variables.product.prodname_github_apps %} pode acessar com cada permissão, consulte "[Permissões de {% data variables.product.prodname_github_app %}](/v3/apps/permissions/). " - -| Permissão | Tipo de acesso | Acesso pelos repositórios bifurcados | -| ----------------------- | ---------------- | ------------------------------------ | -| ações | leitura/gravação | leitura | -| Verificações | leitura/gravação | leitura | -| Conteúdo | leitura/gravação | leitura | -| Implantações | leitura/gravação | leitura | -| Problemas | leitura/gravação | leitura | -| metadados | leitura | leitura | -| pacotes | leitura/gravação | leitura | -| Pull requests | leitura/gravação | leitura | -| Projetos de repositório | leitura/gravação | leitura | -| Status | leitura/gravação | leitura | - -Se você precisa de um token que exige premissões que não estão disponíveis no `GITHUB_TOKEN`, é possível criar um token de acesso pessoal e configurá-lo como um segredo no repositório: - -1. Use ou crie um token com as permissões adequadas para o repositório. Para mais informação, consulte "[Criando um token de acesso pessoal](/github/authenticating-to-github/creating-a-personal-access-token)." -1. Adicione o token como um segredo no repositório do fluxo de trabalho e refira-se a ele usando a sintaxe {%raw%}`${{ secrets.SECRET_NAME }}`{% endraw %}. Para obter mais informações, consulte "[Criando e usando segredos encriptados](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". diff --git a/translations/pt-BR/content/actions/configuring-and-managing-workflows/caching-and-storing-workflow-data.md b/translations/pt-BR/content/actions/configuring-and-managing-workflows/caching-and-storing-workflow-data.md deleted file mode 100644 index 95c2c5c9922a..000000000000 --- a/translations/pt-BR/content/actions/configuring-and-managing-workflows/caching-and-storing-workflow-data.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Memorizando e armazenando os dados do fluxo de trabalho -intro: Memorize as dependências e armazene os artefatos para fazer com que o seu fluxo de trabalho seja executado de modo mais eficiente. -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/pt-BR/content/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows.md b/translations/pt-BR/content/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows.md deleted file mode 100644 index 97d7bb9ed962..000000000000 --- a/translations/pt-BR/content/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows.md +++ /dev/null @@ -1,190 +0,0 @@ ---- -title: Memorizar dependências para acelerar os fluxos de trabalho -intro: 'Para agilizar os seus fluxos de trabalho e torná-los mais eficientes, você pode criar e usar caches para dependências e outros arquivos reutilizados geralmente.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /github/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows - - /actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows -versions: - free-pro-team: '*' ---- - -### Sobre a memorização das dependências do fluxo de trabalho - -As execuções do fluxo de trabalho geralmente reutilizam as mesmas saídas ou dependências baixadas de uma execução para outra. Por exemplo, as ferramentas de gerenciamento de pacotes e de dependência, como, por exemplo, Maven, Gradle, npm e Yarn mantêm uma cache local de dependências baixadas. - -Os trabalhos nos executores hospedados em {% data variables.product.prodname_dotcom %} começam em um ambiente virtual limpo e devem baixar as dependências todas as vezes, o que gera uma maior utilização da rede, maior tempo de execução e aumento dos custos. Para ajudar a acelerar o tempo que leva para recrear esses arquivos, {% data variables.product.prodname_dotcom %} pode memorizar as dependências que você usa frequentemente nos fluxos de trabalho. - -Para memorizar as dependências para um trabalho, você precisará usar a ação `cache` do {% data variables.product.prodname_dotcom %}. A ação recupera uma cache identificada por uma chave única. Para obter mais informações, consulte [`ações/cache`](https://github.com/actions/cache). - -{% warning %} - -**Alerta**: Recomendamos que você não armazene nenhuma informação confidencial na cache dos repositórios públicos. Por exemplo, as informações confidenciais podem incluir tokens de acesso ou credenciais de login armazenadas em um arquivo no caminho da cache. Além disso, os programas de interface da linha de comando (CLI) como o `login do Docker` pode salvar as credenciais de acesso em um arquivo de configuração. Qualquer pessoa com acesso de leitura pode criar um pull request em um repositório e acessar o conteúdo da cache. As bifurcações de um repositório também podem criar pull requests no branch-base e acessar as caches no branch-base. - -{% endwarning %} - -### Comparando artefatos e memorização de dependência - -Os artefatos são similares, pois fornecem a habilidade de armazenar arquivos em {% data variables.product.prodname_dotcom %}, mas cada recurso oferece usos diferentes e não podem ser usados de forma intercambiável. - -- Use a memorização quando desejar reutilizar os arquivos que não mudam com frequência entre trabalhos ou execuções de fluxos de trabalho. -- Use artefatos quando desejar salvar arquivos produzidos por um trabalho a ser visualizado após a conclusão de um fluxo de trabalho. Para obter mais informações, consulte "[Dados recorrentes do fluxo de trabalho que usam artefatos](/github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)". - -### Restrições para acessar uma cache - -Com `v2` da ação da `cache`, você pode acessar a cache nos fluxos de trabalho ativados por qualquer evento que tem um `GITHUB_REF`. Se você estiver usando `v1` da ação da `cache`, você só poderá acessar a cache em fluxos de trabalho ativados por eventos de `push` e `pull_request`, exceto para o evento `fechado` de `pull_request`. Para obter mais informações, consulte "[Eventos que acionam fluxos de trabalho](/actions/reference/events-that-trigger-workflows)". - -Um fluxo de trabalho pode acessar e rearmazenar uma cache criada no branch atual, no branch-base (incluindo branches-base de repositórios bifurcados), ou no branch-padrão (geralmente`mestre`). Por exemplo, uma cache criada no branch-padrão `mestre` seria acessível a partir de qualquer pull request. Além disso, se o branch `de recurso-b` tiver um branch-base `de recurso-a`, um fluxo de trabalho ativado no `recurso-b` teria acesso às caches criadas no branch-padrão (`mestre`), `recurso-a` e `recurso-b`. - -As restrições de acesso fornecem o isolamento da cache e a segurança ao criar um limite lógico entre os diferentes fluxos e branches. Por exemplo, uma cache criada para o branch `recurso-a` (com a base `mestre`) não seria acessível para um pull request para o branch `recurso-b` (com a base `mestre`). - -### Usar a ação `cache` - -A ação `cache` tentará restaurar uma cache com base na `chave` que você fornecer. Quando a ação encontrar uma cache, ela irá restaurar os arquivos memorizados no `caminho` que você configurar. - -Se não houver uma correspondência perfeita, a ação criará uma nova entrada da cache se o trabalho for concluído com sucesso. A nova cache usará a `chave` que você forneceu e conterá os arquivos no diretório do `caminho`. - -Como alternativa, você pode fornecer uma lista de `chaves de restauração` a serem usadas quando a `chave` não corresponder à cache existente. Uma lista de `chaves de restauração` é importante quando você está tentando restaurar uma cache de outro branch, pois `as chaves de restauração`=2.22' ---- - -Pessoas com permissões de gravação ou administração para um repositório podem criar, editar ou visualizar fluxos de trabalho. - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Sobre fluxos de trabalho - -Fluxos de trabalho são processos automatizados personalizados que você pode configurar em seu repositório para construir, testar, empacotar, liberar ou implantar qualquer projeto em {% data variables.product.prodname_dotcom %}. Com fluxos de trabalho, você pode automatizar seu ciclo de vida de desenvolvimento de software com uma ampla gama de ferramentas e serviços. Para obter mais informações, consulte "[Sobre {% data variables.product.prodname_actions %}](/articles/about-github-actions).". - -Você pode criar mais de um fluxo de trabalho em um repositório. Você deve armazenar fluxos de trabalho no `.github/fluxos de trabalho` diretório na raiz do seu repositório. - -Os fluxos de trabalho devem ter pelo menos um trabalho, e os trabalhos contêm um conjunto de etapas que executam tarefas individuais. As etapas podem executar comandos ou usar uma ação. Você pode criar suas próprias ações ou usar ações compartilhadas pela comunidade {% data variables.product.prodname_dotcom %} e personalizá-las conforme necessário. - -Você pode configurar um fluxo de trabalho para iniciar quando um evento {% data variables.product.prodname_dotcom %} ocorre, em um cronograma ou a partir de um evento externo. - -Você precisa configurar fluxos de trabalho usando a sintaxe YAML e salvá-los como arquivos de fluxo de trabalho em seu repositório. Depois de criar com sucesso um arquivo de fluxo de trabalho YAML e acionar o fluxo de trabalho, você verá os registros de compilação, resultados de testes, artefatos e status para cada etapa do seu fluxo de trabalho. Para obter mais informações, consulte "[Gerenciamento de um fluxo de trabalho](/articles/managing-a-workflow-run)." - - ![Imagem de execução do fluxo de trabalho anotado](/assets/images/help/repository/annotated-workflow.png) - -Você também pode receber notificações para atualizações de status do fluxo de trabalho. Para obter mais informações sobre as opções de notificação, consulte "[Configurando notificações](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options).". - -Os limites de uso se aplicam a fluxos de trabalho individuais. Para obter mais informações, consulte "[Limites de uso para fluxos de trabalho](/articles/workflow-syntax-for-github-actions#usage-limits)." - -### Criando um arquivo de fluxo de trabalho - -Em um nível alto, essas são as etapas para adicionar um arquivo de fluxo de trabalho. Você pode encontrar exemplos de configuração específicos nas seções seguintes. - -1. Na raiz do seu repositório, crie um diretório chamado `.github/fluxos de trabalho` para armazenar seus arquivos de fluxo de trabalho. - -1. Em ``.github/fluxos de trabalho, adicione um `.yml` ou `arquivo` .yaml para o seu fluxo de trabalho. Por exemplo, `.github/fluxos de trabalho/continuous-integração-workflow.yml`. - -1. Use a sintaxe de referência "[Workflow para {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions)" para escolher eventos para acionar uma ação, adicionar ações e personalizar seu fluxo de trabalho. - -1. Comprometa suas alterações no arquivo de fluxo de trabalho para a filial onde deseja que seu fluxo de trabalho seja executado. - -#### Exemplo de arquivo de fluxo de trabalho - -{% raw %} -```yaml -nome: Greet Everyone -# Este fluxo de trabalho é acionado em empurrões para o repositório. -on: [push] - -jobs: - build: - # Nome do trabalho é Greeting - nome: Greeting - # This job runs on on Linux - runs-on: ubuntu-latest - steps: - # This step uses GitHub's hello-world-javascript-action: https://github.com/actions/hello-world-javascript-action - - nome: Olá mundo - usa: actions/hello-world-javascript-action@v1.1 - com: - quem cumprimentar: 'Mona, a Octocat' - id: Olá - # Esta etapa imprime uma saída (tempo) da ação da etapa anterior. - - nome: Echo o tempo da saudação - executado: eco 'A hora era ${{ steps.hello.outputs.time }}.' -``` -{% endraw %} - -{% data reusables.github-actions.invalid-workflow-files %} - -### Desencadeando um fluxo de trabalho com eventos - -Você pode configurar um fluxo de trabalho para iniciar uma vez: -- Um evento sobre {% data variables.product.prodname_dotcom %} ocorre, como quando alguém empurra um compromisso com um repositório ou quando um problema ou solicitação de puxar é criado. -- Um evento agendado começa. -- Ocorre um evento externo. - -Para acionar um fluxo de trabalho após um evento acontecer em {% data variables.product.prodname_dotcom %}, adicione `em:` e um valor de evento após o nome do fluxo de trabalho. Por exemplo, esse fluxo de trabalho é acionado quando as alterações são empurradas para qualquer ramo no repositório. - -```yaml -nome: descritivo-workflow-name -em: push -``` - -Para agendar um fluxo de trabalho, você pode usar a sintaxe de cron POSIX em seu arquivo de fluxo de trabalho. O intervalo mais curto que você pode executar fluxos de trabalho programados é uma vez a cada 5 minutos. Por exemplo, esse fluxo de trabalho é acionado a cada hora. - -```yaml -em: - horário: - - cron: '0 * * * * * * -``` - -#### Executando manualmente um fluxo de trabalho - -Para executar manualmente um fluxo de trabalho, você deve primeiro configurar seu fluxo de trabalho para usar o `workflow_dispatch` evento. Você pode configurar propriedades de entrada definidas por personalizadas, valores de entrada padrão e entradas necessárias diretamente no seu fluxo de trabalho. Quando o fluxo de trabalho é executado, você pode acessar os valores de entrada no `github.event.inputs` contexto. Para obter mais informações, consulte "[Eventos que desencadeiam fluxos de trabalho](/actions/reference/events-that-trigger-workflows/#workflow_dispatch)" e "[Contexto e sintaxe de expressão para {% data variables.product.prodname_dotcom %} Actions](/actions/reference/context-and-expression-syntax-for-github-actions#github-context).". - -Este exemplo define o nome `` e `entradas de` domésticas e as imprime usando os contextos `github.event.inputs.name` e `github.event.inputs.home` . Se um `nome` não for fornecido, o valor padrão 'Mona, o Octocat' será impresso. - -{% raw %} -```yaml -nome: Fluxo de trabalho acionado manualmente -em: - workflow_dispatch: entradas - : - nome: - descrição: 'Pessoa para cumprimentar' - necessário: verdadeiro - padrão: 'Mona, o Octocat ' - casa: - descrição: 'localização' - necessário: falsos trabalhos de - -: - say_hello: - run-on: ubuntu-mais recente - passos: - - executar: | - eco "Olá ${{ github.event.inputs.name }}!" - eco "- em ${{ github.event.inputs.home }}!" -``` -{% endraw %} - -Você pode acionar o `workflow_dispatch` evento a partir da guia Ações na {% data variables.product.prodname_dotcom %} ou usando a API REST. Para obter mais informações sobre como usar a API REST, consulte o "[Criar um evento de expedição de fluxo de trabalho](/rest/reference/actions/#create-a-workflow-dispatch-event)." Ao usar a API REST, você configura as entradas de `` e `ref` como parâmetros do corpo de solicitação. Se as entradas forem omitidas, os valores padrão definidos no arquivo de fluxo de trabalho ão usados. - -Para acionar o `workflow_dispatch` evento em {% data variables.product.prodname_dotcom %}, seu fluxo de trabalho deve estar no ramo padrão. Siga estas etapas para acionar manualmente uma execução do fluxo de trabalho. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -1. Na barra lateral esquerda, clique no fluxo de trabalho que deseja executar. ![ações selecionam fluxo de trabalho](/assets/images/actions-select-workflow.png) -1. Acima da lista de execuções de fluxo de trabalho, selecione **Executar**de fluxo de trabalho . ![expedição de fluxo de trabalho ações](/assets/images/actions-workflow-dispatch.png) -1. Selecione o ramo onde o fluxo de trabalho será executado e digite os parâmetros de entrada usados pelo fluxo de trabalho. Clique em **Executar**de fluxo de trabalho . ![ações executar manualmente fluxo de trabalho](/assets/images/actions-manually-run-workflow.png) - -#### Desencadeando fluxos de trabalho de eventos externos - -Para acionar um fluxo de trabalho após um evento externo ocorrer, você pode invocar um `repository_dispatch` evento webhook chamando o ponto final de API "Criar um evento de despacho de repositório" REST. Para obter mais informações, consulte "[Criar um evento de despacho de repositório](/v3/repos/#create-a-repository-dispatch-event)." - -Para obter mais informações e exemplos, consulte "[Eventos que desencadeiam fluxos de trabalho](/articles/events-that-trigger-workflows#webhook-events)." - -### Filtragem para ramos, etiquetas e caminhos específicos - -Você pode configurar seu fluxo de trabalho para funcionar apenas em determinados ramos. - -Por exemplo, esse fluxo de trabalho é executado quando um push que inclui arquivos no `teste` diretório é feito na filial mestre `ou empurra para a tag` `v1.

    - -
    em:
-  push:
-    filiais:
-      - master
-    tags:
-      - v1
-    # file paths a considerar no evento. Opcional; padrão para todos.
-    caminhos:
-      - 'teste/*'
-`
    - -Para obter mais informações sobre a sintaxe do filtro de ramificação, etiqueta e de caminho, consulte "[`on..`](/articles/workflow-syntax-for-github-actions#onpushpull_requestbranchestags)" e "[`..caminhos`](/articles/workflow-syntax-for-github-actions#onpushpull_requestpaths).". - -### Escolhendo um corredor - -Você pode executar fluxos de trabalho em corredores hospedados em {% data variables.product.prodname_dotcom %}ou corredores auto-hospedados. Os trabalhos podem ser executados diretamente na máquina ou em um contêiner Docker. - -Você pode especificar o corredor para cada trabalho em um fluxo de trabalho usando ``de corridas . Para obter mais informações sobre ``de correções, consulte "[sintaxe do Workflow para {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idruns-on)." - -{% data reusables.actions.enterprise-github-hosted-runners %} - -#### Usando um corredor hospedado em {% data variables.product.prodname_dotcom %} - -Você pode selecionar entre diferentes tipos e versões de máquinas virtuais de host, incluindo Linux, Windows e macOS. Cada trabalho em um fluxo de trabalho é executado em uma nova instância do ambiente virtual, e as etapas dentro de um trabalho podem compartilhar informações usando o sistema de arquivos. Para obter mais informações, consulte "[ambientes virtuais para corredores hospedados {% data variables.product.prodname_actions %}](/articles/virtual-environments-for-github-actions)." - -Por exemplo, você pode usar `` mais recente do ubuntu para especificar a versão mais recente de um corredor hospedado no Ubuntu {% data variables.product.prodname_dotcom %}. - -```yaml -runs-on: ubuntu-latest -``` - -#### Usando um corredor auto-hospedado - -Você pode usar rótulos para direcionar trabalhos para tipos específicos de corredores auto-hospedados. Todos os corredores auto-hospedados recebem o `rótulo de` auto-hospedado e cada corredor auto-hospedado tem rótulos para seu sistema operacional e arquitetura de sistema. Para obter mais informações, consulte "[Usando corredores auto-hospedados em um fluxo de trabalho](/actions/automating-your-workflow-with-github-actions/using-self-hosted-runners-in-a-workflow)." - -Por exemplo, se você adicionou um corredor auto-hospedado com um sistema operacional Linux e arquitetura ARM32, você pode selecionar esse corredor usando oauto-hospedado `, `linux e `` rótulos. - -```yaml -em funcionamento: [auto-hospedado, linux, ARM32] -``` - -### Configurando uma matriz de construção - -Para testar em vários sistemas operacionais, plataformas e versões de idioma ao mesmo tempo, você pode configurar uma matriz de compilação. - -Uma matriz de compilação permite testar seu código com diferentes configurações de software e sistema operacional. Por exemplo, um fluxo de trabalho pode executar um trabalho para mais de uma versão suportada de um idioma, sistema operacional ou ferramenta. Para cada configuração, uma cópia do trabalho é executada e relata um status. - -Você pode especificar uma matriz de compilação em seu arquivo de fluxo de trabalho com um array que lista as opções de configuração em `estratégia:`. Por exemplo, esta matriz de compilação executará um trabalho com diferentes versões do Node.js e do Ubuntu, um sistema operacional Linux. - -{% data reusables.repositories.actions-matrix-builds-os %} - -{% raw %} -```yaml -runs-on: ${{ matrix.os }} -estratégia: - matricial: - os: [ubuntu-16.04, ubuntu-18.04] - nó: [6, 8, 10] -``` -{% endraw %} - -Para obter mais informações, consulte "[sintaxe do Fluxo de Trabalho para {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix)." - -### Usando a ação de checkout - -Existem várias ações padrão que você pode usar em seu fluxo de trabalho. A ação de checkout é uma ação padrão que você deve incluir em seu fluxo de trabalho antes de outras ações quando: -- Seu fluxo de trabalho requer uma cópia do código do seu repositório, como quando você está construindo e testando seu repositório ou usando integração contínua. -- Há pelo menos uma ação em seu fluxo de trabalho que é definida no mesmo repositório. Para obter mais informações, consulte "[Referenciando ações em seu fluxo de trabalho](#referencing-actions-in-your-workflow)." - -Para usar a ação padrão de checkout sem especificações adicionais, inclua esta etapa: -```yaml -- usos: ações/checkout@v2 -``` -O uso `` v2 neste exemplo garante que você esteja usando uma versão estável da ação de checkout. Para obter mais informações, consulte [a ação de checkout](https://github.com/actions/checkout). - -### Escolher o tipo de ações para o seu fluxo de trabalho - -Existem diferentes tipos de ações que você pode usar em seu fluxo de trabalho para atender às necessidades do seu projeto: -- Ações de contêiner docker -- Ações JavaScript -- Ações de etapas de execução composta - -Para obter mais informações, consulte "[Sobre ações](/articles/about-actions#types-of-actions).". - -Ao escolher o tipo de ações para usar em seu fluxo de trabalho, recomendamos explorar ações existentes em repositórios públicos ou no hub Docker e potencialmente personalizar essas ações para o seu projeto. - -Você pode navegar e usar ações construídas por {% data variables.product.prodname_dotcom %} na organização [github.com/actions](https://github.com/actions) . Para visitar o Docker Hub, consulte "[Docker Hub](https://www.docker.com/products/docker-hub)" no site do Docker. - -### Referenciando ações em seu fluxo de trabalho - -Para referenciar ações em seu arquivo de fluxo de trabalho com a sintaxe correta, você deve considerar onde a ação é definida. - -Os fluxos de trabalho podem usar ações definidas em: -- Um repositório público -- O mesmo repositório onde seu arquivo de fluxo de trabalho faz referência às ações -- Uma imagem publicada do contêiner Docker no Docker Hub - -Para usar uma ação definida em um repositório privado, tanto o arquivo de fluxo de trabalho quanto a ação devem estar no mesmo repositório. Seu fluxo de trabalho não pode usar ações definidas em outros repositórios privados, mesmo que o outro repositório privado esteja na mesma organização. - -Para manter seu fluxo de trabalho estável mesmo quando as atualizações são feitas em uma ação, você pode fazer referência à versão da ação que está usando especificando um ref Git ou número de tag Docker em seu arquivo de fluxo de trabalho. Por exemplo, consulte "[sintaxe do Fluxo de Trabalho para {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idstepsuses)." - -{% if currentVersion == "free-pro-team@latest" %} -{% data reusables.dependabot.version-updates-for-actions %} -{% endif %} - -Para obter opções de configuração mais detalhadas, consulte "[sintaxe do Fluxo de Trabalho para {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)." - -#### Referenciando uma ação de um repositório público - -Se uma ação for definida em um repositório público, você deve fazer referência à ação usando a sintaxe `{owner}/{repo}@{ref}` ou `{owner}/{repo}/{path}@{ref}`. - -```yaml - - my_first_job: nome - : Meu Nome do Trabalho - etapas: - - usos: ações/node@v1 - de configuração com: - versão de nó: 10.x -``` - -Para ver um exemplo completo de fluxo de trabalho, consulte o [doído de configuração](https://github.com/actions/setup-node) repositório de modelo. - -#### Referenciando uma ação no mesmo repositório onde um arquivo de fluxo de trabalho usa a ação - -Se uma ação for definida no mesmo repositório onde seu arquivo de fluxo de trabalho usa a ação, você pode referenciar a ação com o`{owner}/{repo}@{ref}` ou `./path/to/dir` sintaxe no seu arquivo de fluxo de trabalho. - -Estrutura de arquivos do repositório de exemplo: - -``` -|-- Hello-world (repositório) -| |__ .github -| fluxos de trabalho └sadessa -| └➤➤ my-first-workflow.yml -| ações └➤➤ -| |__ Hello-world-action -| └➤➤ ação.yml -``` - -Arquivo de fluxo de trabalho de exemplo: - -```yaml -empregos: - construir: - runs-on: ubuntu-latest - passos: - # Esta etapa confere uma cópia do seu repositório. - - usa: ações/checkout@v2 - # Esta etapa faz referência ao diretório que contém a ação. - - usa: ./.github/actions/hello-world-action -``` - -#### Referenciando um contêiner no Docker Hub - -Se uma ação for definida em uma imagem de contêiner Docker publicada no Docker Hub, você deve fazer referência à ação com o `docker://{image}:{tag}` sintaxe em seu arquivo de fluxo de trabalho. Para proteger seu código e dados, recomendamos fortemente que verifique a integridade da imagem do contêiner Docker do Docker Hub antes de usá-la em seu fluxo de trabalho. - -```yaml -empregos: - my_first_job: - passos: - - nome: Meu primeiro passo - usa: docker://alpine:3.8 -``` - -Para alguns exemplos de ações do Docker, consulte o fluxo de trabalho [Docker-image.yml](https://github.com/actions/starter-workflows/blob/master/ci/docker-image.yml) e "[Criando uma ação de contêiner Docker](/articles/creating-a-docker-container-action)." - -Para obter mais informações, consulte "[sintaxe do Fluxo de Trabalho para {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idstepsuses)." - -### Adicionando um crachá de status do fluxo de trabalho ao seu repositório - -{% data reusables.repositories.actions-workflow-status-badge-into %} - -Se o seu fluxo de trabalho usar o nome `` palavra-chave, você deve fazer referência ao fluxo de trabalho pelo nome. Se o nome do seu fluxo de trabalho contiver espaço branco, você precisará substituir o espaço pela sequência codificada por URL `%20`. Para obter mais informações sobre o nome `` palavra-chave, consulte "[sintaxe do Fluxo de Trabalho para {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#name)." - -``` -https://github.com///fluxos de trabalho//badge.svg -``` - -Alternativamente, se o seu fluxo de trabalho não tiver um nome ``, você deve fazer referência ao arquivo de fluxo de trabalho usando o caminho do arquivo em relação ao diretório raiz do repositório. - -{% note %} - -**Nota:** Fazer referência ao arquivo de fluxo de trabalho usando o caminho do arquivo não funciona se o fluxo de trabalho tiver um nome ``. - -{% endnote %} - -``` -https://github.com///fluxos de trabalho//badge.svg -``` - -#### Exemplo usando um nome de fluxo de trabalho - -Este exemplo de Markdown adiciona um crachá de status para um fluxo de trabalho com o nome "Cumprimente a Todos". O proprietário `do repositório é a ações` organização e o nome repositório `é `hello-world . - -``` -! [nome do fluxo de trabalho de exemplo] (https://github.com/actions/hello-world/workflows/Greet%20Everyone/badge.svg) -``` - -#### Exemplo usando um caminho de arquivo de fluxo de trabalho - -Este exemplo de Markdown adiciona um crachá de status para um fluxo de trabalho com o caminho do arquivo `.github/workflows/main.yml`. O proprietário `do repositório é a ações` organização e o nome repositório `é `hello-world . - -``` -! [exemplo caminho do arquivo de fluxo de trabalho] (https://github.com/actions/hello-world/workflows/.github/workflows/main.yml/badge.svg) -``` - -#### Exemplo usando o parâmetro do ramo ` - -

    Este exemplo de Markdown adiciona um crachá de status para uma filial com o nome recurso-1`.

    - -``` -! [parâmetro de ramo de exemplo] (https://github.com/actions/hello-world/workflows/Greet%20Everyone/badge.svg?branch=feature-1) -``` - -#### Exemplo usando o parâmetro `` de eventos - -Este exemplo de Markdown adiciona um crachá que exibe o status das corridas de fluxo de trabalho desencadeadas pelo `pull_request` evento. - -``` -! [parâmetro de evento de exemplo] (https://github.com/actions/hello-world/workflows/Greet%20Everyone/badge.svg?event=pull_request) -``` - -{% if currentVersion == "free-pro-team@latest" %} -### Leia mais - -- "[gestão de faturamento para {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)" -{% endif %} diff --git a/translations/pt-BR/content/actions/configuring-and-managing-workflows/configuring-and-managing-workflow-files-and-runs.md b/translations/pt-BR/content/actions/configuring-and-managing-workflows/configuring-and-managing-workflow-files-and-runs.md deleted file mode 100644 index d3e19c8ae62a..000000000000 --- a/translations/pt-BR/content/actions/configuring-and-managing-workflows/configuring-and-managing-workflow-files-and-runs.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: Configurar e gerenciar arquivos e execuções de fluxo de trabalho -intro: Criar e configurar fluxos de trabalho para automatizar partes do desenvolvimento do seu projeto. -mapTopic: true -redirect_from: - - /articles/configuring-workflows - - /github/automating-your-workflow-with-github-actions/configuring-workflows - - /actions/automating-your-workflow-with-github-actions/configuring-workflows -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/pt-BR/content/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets.md b/translations/pt-BR/content/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets.md deleted file mode 100644 index 9740cac1bdda..000000000000 --- a/translations/pt-BR/content/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets.md +++ /dev/null @@ -1,220 +0,0 @@ ---- -title: Criar e armazenar segredos encriptados -intro: Os segredos encriptados permitem que você armazene informações confidenciais no seu repositório ou organização. -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets - - /actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Sobre os segredos encriptados - -Segredos são variáveis de ambiente encriptadas que você cria em um repositório ou organização. Os segredos que você cria estão disponíveis para utilização nos fluxos de trabalho em {% data variables.product.prodname_actions %}. O {% data variables.product.prodname_dotcom %} usa uma [caixa selada de libsodium](https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes) para ajudar a garantir que os segredos sejam criptografados antes de chegar ao {% data variables.product.prodname_dotcom %} e permanecer criptografados até que você os use em um fluxo de trabalho. - -{% data reusables.github-actions.secrets-org-level-overview %} - -#### Nomear os seus segredos - -As regras a seguir aplicam-se aos nomes dos segredos: - -* Os nomes dos segredos podem conter apenas caracteres alfanuméricos (`[a-z]`, `[A-Z]`, `[0-9]`) or sublinhado (`_`). Não são permitidos espaços. -* Os nomes dos segredos não devem começar com o prefixo `GITHUB_`. -* Os nomes dos segredos não devem começar com um número. -* Os nomes dos segredos devem ser únicos no nível em que são criados. Por exemplo, um segredo criado no nível da organização deve ter um nome único nesse nível, e um segredo criado no nível do repositório deve ter um nome único nesse repositório. Se o segredo do nível de uma organização tiver o mesmo nome do segredo do nível do repositório, o segredo do nível do repositório prevalecerá. - -Para ajudar a garantir que {% data variables.product.prodname_dotcom %} remova o seu segredo dos registros, evite usar dados estruturados como valores dos segredos. Por exemplo, evite criar segredos que contêm JSON ou Git blobs. - -#### Acessar os seus segredos - -Para disponibilizar um segredo para uma ação, você deve configurá-lo como uma entrada ou variável de ambiente no arquivo do fluxo de trabalho. Revise o arquivo LEIAME da ação para saber quais entradas e variáveis de ambientes a ação exige. Para obter mais informações, consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepsenv)". - -Você pode usar e ler segredos encriptados em um arquivo de fluxo de trabalho se tiver permissão para editar o arquivo. Para obter mais informações, consulte "[Permissões de acesso em {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/access-permissions-on-github)." - -{% warning %} - -**Aviso:** {% data variables.product.prodname_dotcom %} elimina automaticamente os segredos impressos no registro, mas você deve evitar a impressão intencional de segredos no log. - -{% endwarning %} - -Você também pode gerenciar segredos usando o API REST. Para obter mais informações, consulte "[Segredos](/v3/actions/secrets/)". - -#### Permissões limitadas de credenciais - -Ao gerar credenciais, recomendamos que você conceda as permissões mínimas possíveis. Por exemplo, em vez de usar credenciais pessoais, use [chaves de implantação](/v3/guides/managing-deploy-keys/#deploy-keys) ou uma conta de serviço. Considere conceder permissões somente leitura se isso o necessário e limite o acesso tanto quanto possível. Ao gerar um token de acesso pessoal (PAT), selecione o menor escopo necessário. - -### Criar segredos encriptados para um repositório - -{% data reusables.github-actions.permissions-statement-secrets-repository %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -{% data reusables.github-actions.sidebar-secret %} -1. Clique em **Adicionar novo segredo**. -1. Digite um nome para o seu segredo na caixa de entrada **Nome**. -1. Insira o valor para o seu segredo. -1. Clique em **Add secret** (Adicionar segredo). - -Se o seu repositório puder acessar segredos a partir da organização-mãe, esses segredos também serão listados nesta página. - -### Criar segredos encriptados para uma organização - -Ao criar um segredo em uma organização, você pode usar uma política para limitar quais repositórios podem acessar esse segredo. Por exemplo, você pode conceder acesso a todos os repositórios ou limitar o acesso a apenas repositórios privados ou a uma lista específica de repositórios. - -{% data reusables.github-actions.permissions-statement-secrets-organization %} - -{% data reusables.organizations.navigate-to-org %} -{% data reusables.organizations.org_settings %} -{% data reusables.github-actions.sidebar-secret %} -1. Clique em **Novo segredo**. -1. Digite um nome para o seu segredo na caixa de entrada **Nome**. -1. Insira o **Valor** para o seu segredo. -1. Na lista suspensa **Acesso do repositório**, escolha uma política de acesso. -1. Clique em **Add secret** (Adicionar segredo). - -### Rever o acesso para os segredos do nível da organização - -Você pode verificar quais políticas de acesso são aplicadas a um segredo na sua organização. - -{% data reusables.organizations.navigate-to-org %} -{% data reusables.organizations.org_settings %} -{% data reusables.github-actions.sidebar-secret %} -1. A lista de segredos inclui quaisquer permissões e políticas configuradas. Por exemplo: ![Lista de segredos](/assets/images/help/settings/actions-org-secrets-list.png) -1. Para obter mais detalhes sobre as permissões configuradas para cada segredo, clique em **Atualizar**. - -### Usando segredos encriptados em um fluxo de trabalho - -Com exceção do `GITHUB_TOKEN`, os segredos não são disponibilizados para o executor quando um fluxo de trabalho é acionado a partir de um repositório bifurcado. - -Para fornecer uma ação com um segredo como uma entrada ou variável de ambiente, você pode usar o contexto de `segredos` para acessar os segredos que você criou no seu repositório. Para obter mais informações, consulte "[Contexto e sintaxe de expressão para {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)" e "[Sintaxe do fluxo de trabalho para {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)." - -{% raw %} -```yaml -steps: - - name: Hello world action - with: # Configura o segredo como uma entrada - super_secret: ${{ secrets.SuperSecret }} - env: # Ou como uma variável de ambiente - super_secret: ${{ secrets.SuperSecret }} -``` -{% endraw %} - -Evite a transmissão de segredos entre processos da linha de comando sempre que possível. Os processos da linha de comando podem ser visíveis para outros usuários (usando o comando `ps`) ou capturado por [eventos de auditoria de segurança](https://docs.microsoft.com/en-us/windows-server/identity/ad-ds/manage/component-updates/command-line-process-auditing). Para ajudar a proteger os segredos, considere o uso de variáveis de ambiente, `STDIN`, ou outros mecanismos compatíveis com o processo de destino. - -Se você passar segredos dentro de uma linha de comando, inclua-os dentro das regras de aspas corretas. Muitas vezes, os segredos contêm caracteres especiais que não intencionalmente podem afetar o seu shell. Para escapar desses caracteres especiais, use aspas com suas variáveis de ambiente. Por exemplo: - -#### Exemplo de uso do Bash - -{% raw %} -```yaml -etapas: - - shell: bash - env: - SUPER_SECRET: ${{ secrets.SuperSecret }} - run: | - example-command "$SUPER_SECRET" -``` -{% endraw %} - -#### Exemplo de uso do PowerShell - -{% raw %} -```yaml -etapas: - - shell: pwsh - env: - SUPER_SECRET: ${{ secrets.SuperSecret }} - run: | - example-command "$env:SUPER_SECRET" -``` -{% endraw %} - -#### Exemplo de uso do Cmd.exe - -{% raw %} -```yaml -etapas: - - shell: cmd - env: - SUPER_SECRET: ${{ secrets.SuperSecret }} - run: | - example-command "%SUPER_SECRET%" -``` -{% endraw %} - -### Limites para segredos - -O seu fluxo de trabalho pode ter até 100 segredos. Os nomes das variáveis do ambiente de segredo devem ser únicas em um repositório. - -Os segredos são limitados a 64 kB. Para usar segredos maiores que 64 kB, você pode armazenar segredos criptografados no seu repositório e salvar a frase secreta de descodificação como um segredo no {% data variables.product.prodname_dotcom %}. Por exemplo, você pode usar `gpg` para criptografar suas credenciais localmente antes de colocar o arquivo no repositório do {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte a "[página do manual gpg](https://www.gnupg.org/gph/de/manual/r1023.html)". - -{% warning %} - -**Aviso**: cuide para seus segredos não serem impressos quando a ação é executada. Quando usar essa alternativa, o {% data variables.product.prodname_dotcom %} não eliminará segredos que estão impressos nos logs. - -{% endwarning %} - -1. Execute o seguinte comando no seu terminal para criptografar o arquivo `my_secret.json` usando `gpg` e o algoritmo de cifragem AES256. - - ``` shell - $ gpg --symmetric --cipher-algo AES256 my_secret.json - ``` - -1. Você receberá a solicitação para inserir a frase secreta. Guarde a frase secreta, pois você precisará criar um novo segredo no {% data variables.product.prodname_dotcom %} que usa a frase secreta como valor. - -1. Criar um novo segredo que contém a frase secreta. Por exemplo, crie um novo segredo com o nome `LARGE_SECRET_PASSPHRASE` e defina o valor do segredo para a frase secreta que você escolheu na etapa anterior. - -1. Copie o arquivo criptografado no repositório e faça commit. Nesse exemplo, o arquivo criptografado é `my_secret.json.gpg`. - -1. Crie um script shell para decifrar a senha. Salve o arquivo como `decrypt_secret.sh`. - - ``` shell - #!/bin/sh - - # Decrypt the file - mkdir $HOME/secrets - # --lote para evitar o comando interativo - # --sim para supor "sim" para as perguntas - gpg --quiet --batch --yes --decrypt --passphrase="$LARGE_SECRET_PASSPHRASE" \ - --output $HOME/secrets/my_secret.json my_secret.json.gpg - ``` - -1. Confirme que o shell script é executável antes de colocá-lo no repositório. - - ``` shell - $ chmod +x decrypt_secret.sh - $ git add decrypt_secret.sh - $ git commit -m "Add new decryption script" - $ git push - ``` - -1. A partir de seu fluxo de trabalho, use `step` para chamar o shell script e decifrar o segredo. Para ter uma cópia do seu repositório no ambiente em que o seu fluxo de trabalho é executado, você deverá executar a ação [`actions/checkout`](https://github.com/actions/checkout). Faça referência ao shell script usando o comando `run` relativo à raiz do repositório. - -{% raw %} - ```yaml - nome: Fluxos de trabalho com grandes segredos - - : empurrar - - empregos: - meu trabalho: - nome: My Job - runs-on: ubuntu-latest - steps: - - usa: actions/checkout@v2 - - nome: Descriptografar grandes segredos - executar: ./.github/scripts/decrypt_secret.sh - env: - LARGE_SECRET_PASSPHRASE: ${{ secrets.LARGE_SECRET_PASSPHRASE }} - # Este comando é apenas um exemplo para mostrar seu segredo sendo impresso - # Certifique-se de remover quaisquer declarações impressas de seus segredos. O GitHub - # não oculta segredos que usam essa alternativa. - - name: Test printing your secret (Remove this step in production) - run: cat $HOME/secrets/my_secret.json - ``` -{% endraw %} diff --git a/translations/pt-BR/content/actions/configuring-and-managing-workflows/creating-postgresql-service-containers.md b/translations/pt-BR/content/actions/configuring-and-managing-workflows/creating-postgresql-service-containers.md deleted file mode 100644 index 44250103c2f7..000000000000 --- a/translations/pt-BR/content/actions/configuring-and-managing-workflows/creating-postgresql-service-containers.md +++ /dev/null @@ -1,335 +0,0 @@ ---- -title: Criar contêineres de serviço PostgreSQL -intro: Você pode criar um contêiner de serviço PostgreSQL para usar no seu fluxo de trabalho. Este guia mostra exemplos para criar um serviço PostgreSQL para trabalhos executados em contêineres ou diretamente na máquina executora. -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/creating-postgresql-service-containers -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Introdução - -Este guia mostra exemplos de fluxo de trabalho que configuram um contêiner de serviço usando a imagem `postgres` do Docker Hub. O fluxo de trabalho executa um script para criar um cliente PostgreSQL e preencher os dados do cliente. Para testar se o fluxo de trabalho cria e preenche o cliente PostgreSQL, o script imprime os dados do cliente no console. - -{% data reusables.github-actions.docker-container-os-support %} - -### Pré-requisitos - -{% data reusables.github-actions.service-container-prereqs %} - -Também pode ser útil ter um entendimento básico de YAML, a sintaxe para {% data variables.product.prodname_actions %} e PostgreSQL. Para obter mais informações, consulte: - -- "[Configurando um fluxo de trabalho](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)" -- "[Tutorial do PostgreSQL](https://www.postgresqltutorial.com/)" na documentação do PostgreSQL -- "[Conceitos básicos para{% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)" -- "[Usando variáveis de ambiente](/actions/automating-your-workflow-with-github-actions/using-environment-variables)" - -### Executar trabalhos em contêineres - -{% data reusables.github-actions.container-jobs-intro %} - -{% data reusables.github-actions.copy-workflow-file %} - -{% raw %} -```yaml -nome: exemplo de serviço PostgreSQL -em: push - -trabalhos: - # Etiqueta do trabalho do contêiner - container-job: - # Os contêineres devem ser executados em sistemas operacionais baseados no Linux - runs-on: ubuntu-latest - # Imagem do Docker Hub em que o `container-job` é executado - contêiner: node:10.18-jessie - - # Contêineres de serviço a serem executados com `container-job` - serviços: - # Etiqueta usada para acessar o contêiner de serviço - postgres: - # Imagem do Docker Hub - imagem: postgres - # Fornece a senha para postgres - env: - POSTGRES_PASSWORD: postgres - # Define verificações gerais até a inicialização do postgres - options: >- - --health-cmd pg_isready - --health-interval 10s - --health-timeout 5s - --health-retries 5 - - etapas: - # Faz o download de uma cópia do código no seu repositório antes de executar testes de CI - - nome: Verifica o código do repositório - usa: actions/checkout@v2 - - # Realiza uma instalação limpa de todas as dependências no arquivo `package.json` - # Para obter mais informações, consulte https://docs.npmjs.com/cli/ci.html - - nome: Instalar dependências - executar: npm ci - - - nome: Conectar-se ao PostgreSQL - # Executa um script que cria um cliente PostgreSQL client, preenche - # os dados do cliente e recupera dados - executar: node client.js - # Variável de ambiente usada pelo script `client.js` para criar um novo PostgreSQL client. - env: - # O nome do host usado para comunicar-se com o contêiner de serviço do PostgreSQL - POSTGRES_HOST: postgres - # A porta-padrão do PostgreSQL - POSTGRES_PORT: 5432 -``` -{% endraw %} - -#### Configurar o trabalho executor - -{% data reusables.github-actions.service-container-host %} - -{% data reusables.github-actions.postgres-label-description %} - -```yaml -trabalhos: - # Etiqueta do trabalho do contêiner - container-job: - # Os contêineres devem ser executados em sistemas operacionais baseados no Linux - runs-on: ubuntu-latest - # Imagem do Docker Hub em que o `container-job` é executado - contêiner: node:10.18-jessie - - # Contêineres de serviço a serem executados com `container-job` - serviços: - # Etiqueta usada para acessar o contêiner de serviço - postgres: - # Imagem do Docker Hub - imagem: postgres - # Fornece a senha para o postgres - env: - POSTGRES_PASSWORD: postgres - # Define as verificações gerais até a inicialização do postgres - opções: >- - --health-cmd pg_isready - --health-interval 10s - --health-timeout 5s - --health-retries 5 -``` - -#### Configurar as etapas - -{% data reusables.github-actions.service-template-steps %} - -```yaml -etapas: - # Faz o download de uma cópia do código no seu repositório antes de executar testes de CI - - nome: Verifica o código do repositório - usa: actions/checkout@v2 - - # Executa uma instalação limpa de todas as dependências no arquivo `package.json` - # Para obter mais informações, consulte https://docs.npmjs.com/cli/ci.html - - Nome: Instalar dependências - executar: npm ci - - - nome: Conectar-se ao PostgreSQL - # Executa um script que cria um cliente PostgreSQL client, preenche - # os dados do cliente e recupera dados - executar: node client.js - # Variável do ambiente usada pelo script `client.js` script para criar - # um novo cliente PostgreSQL. - env: - # O nome do host usado para comunicar-se com o contêiner de serviço do PostgreSQL - POSTGRES_HOST: postgres - # A porta-padrão do PostgreSQL - POSTGRES_PORT: 5432 -``` - -{% data reusables.github-actions.postgres-environment-variables %} - -O nome do host do serviço do PostgreSQL é a etiqueta que você configurou no seu fluxo de trabalho, nesse caso, `postgres`. Uma vez que os contêineres do Docker na mesma rede da ponte definida pelo usuário abrem todas as portas por padrão, você poderá acessar o contêiner de serviço na porta-padrão 5432 do PostgreSQL. - -### Executar trabalhos diretamente na máquina executora - -Ao executar um trabalho diretamente na máquina executora, você deverá mapear as portas no contêiner de serviço com as portas no host do Docker. Você pode acessar os contêineres de serviço do host do Docker usando `localhost` e o número da porta do host do Docker. - -{% data reusables.github-actions.copy-workflow-file %} - -{% raw %} -```yaml -nome: Exemplo de serviço do PostgreSQL -em: push - -trabalhos: - # Etiqueta do trabalho executor - runner-job: - # Você deve usar um ambiente do Linux ao usar os contêineres de serviço ou os trabalhos do contêiner - runs-on: ubuntu-latest - - # Os serviços dos contêineres a serem executados com `runner-job` - serviços: - # Etiqueta usada para acessar o contêiner de serviço - postgres: - # Imagem do Docker Hub - imagem: postgres - # Fornece a senha para postgres - env: - POSTGRES_PASSWORD: postgres - # Define verificações gerais até a inicialização do postgres - opções: >- - --health-cmd pg_isready - --health-interval 10s - --health-timeout 5s - --health-retries 5 - portas: - # Mapeia a porta port 5432 tcp no contêiner de serviço com o host - - 5432:5432 - - etapas: - # Faz o download de uma cópia do código no seu repositório antes de executar um teste de CI - - nome: Verifica o código do repositório - usa: actions/checkout@v2 - - # Realiza uma instalação limpa de todas as dependências no arquivo `package.json` - # Para obter mais informações, consulte https://docs.npmjs.com/cli/ci.html - - nome: Instalar dependências - executar: npm ci - - - nome: Conectar-se ao PostgreSQL - # Executa um script que cria um cliente PostgreSQL, preenche - # os dados do cliente e recupera dados - executar: node client.js - # Variável de ambiente usada pelo script `client.js` para criar - # um novo cliente PostgreSQL. - env: - # O nome do host usado para comunicar-se com o contêiner de serviço PostgreSQL - POSTGRES_HOST: localhost - # A porta-padrão do PostgreSQL - POSTGRES_PORT: 5432 -``` -{% endraw %} - -#### Configurar o trabalho executor - -{% data reusables.github-actions.service-container-host-runner %} - -{% data reusables.github-actions.postgres-label-description %} - -O fluxo de trabalho mapeia a porta 5432 no contêiner de serviço do PostgreSQL com o host do Docker. Para obter mais informações sobre a palavra-chave `portas`, consulte "[Sobre contêineres de serviço](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)". - -```yaml -trabalhos: - # Etiqueta do trabalho executor - runner-job: - # Você deve usar um ambiente do Linux ao usar os contêineres de serviço ou trabalhos do contêiner - runs-on: ubuntu-latest - - # Contêineres de serviços a serem executados com `runner-job` - serviços: - # Etiqueta usada para acessar o contêiner de serviço - postgres: - # Imagem do Docker Hub - image: postgres - # Fornece a senha para postgres - env: - POSTGRES_PASSWORD: postgres - # Define verificações gerais até a inicialização do postgres - opções: >- - --health-cmd pg_isready - --health-interval 10s - --health-timeout 5s - --health-retries 5 - portas: - # Mapeia a porta port 5432 tcp no contêiner de serviço com o host - - 5432:5432 -``` - -#### Configurar as etapas - -{% data reusables.github-actions.service-template-steps %} - -```yaml -etapas: - # Faz o download de uma cópia do código no seu repositório antes de executar testes de CI - - nome: Verifica o código do repositório - usa: actions/checkout@v2 - - # Executa uma instalação limpa de todas as dependências no arquivo `package.json` - # Para obter mais informações, consulte https://docs.npmjs.com/cli/ci.html - - Nome: Instalar dependências - executar: npm ci - - - nome: Conectar-se ao PostgreSQL - # Executa um script que cria um cliente PostgreSQL client, preenche - # os dados do cliente e recupera dados - executar: node client.js - # Variável do ambiente usada pelo script `client.js` script para criar - # um novo cliente PostgreSQL. - env: - # O nome do host usado para comunicar-se com o contêiner de serviço do PostgreSQL - POSTGRES_HOST: localhost - # A porta-padrão do PostgreSQL - POSTGRES_PORT: 5432 -``` - -{% data reusables.github-actions.postgres-environment-variables %} - -{% data reusables.github-actions.service-container-localhost %} - -### Testar o contêiner de serviço do PostgreSQL - -Você pode testar o seu fluxo de trabalho usando o script a seguir, que cria um cliente PostgreSQL e adiciona uma tabela com alguns dados com espaços reservados. Em seguida, o script imprime no terminal os valores armazenados no cliente PostgreSQL. O seu script pode usar qualquer linguagem que você desejar, mas este exemplo usa Node.js e o módulo npm `pg`. Para obter mais informações, consulte [módulo npm pg](https://www.npmjs.com/package/pg). - -Você pode modificar o *client.js* para incluir qualquer operação do PostgreSQL exigida pelo seu fluxo de trabalho. Neste exemplo, o script cria a instância do cliente PostgreSQL, cria uma tabela, adiciona dados de espaços reservados e, em seguida, recupera os dados. - -{% data reusables.github-actions.service-container-add-script %} - -```javascript -const { Client } = require('pg'); - -const pgclient = new Client({ - host: process.env.POSTGRES_HOST, - porta: process.env.POSTGRES_PORT, - usuário: 'postgres', - senha: 'postgres', - banco de dados: 'postgres' -}); - -pgclient.connect(); - -const table = 'CREATE TABLE student(id SERIAL PRIMARY KEY, firstName VARCHAR(40) NOT NULL, lastName VARCHAR(40) NOT NULL, age INT, address VARCHAR(80), email VARCHAR(40))' -const text = 'INSERT INTO student(firstname, lastname, age, address, email) VALUES($1, $2, $3, $4, $5) RETURNING *' -const values = ['Mona the', 'Octocat', 9, '88 Colin P Kelly Jr St, San Francisco, CA 94107, United States', 'octocat@github.com'] - -pgclient.query(table, (err, res) => { - if (err) throw err -}); - -pgclient.query(text, values, (err, res) => { - if (err) throw err -}); - -pgclient.query('SELECT * FROM student', (err, res) => { - if (err) throw err - console.log(err, res.rows) // Print the data in student table - pgclient.end() -}); -``` - -O script cria um novo `Client` PostgreSQL, que aceita um `host` e o parâmetro da `porta`. O script usa as variáveis de ambiente `POSTGRES_HOST` e `POSTGRES_PORT` para definir o endereço IP e a porta do cliente. Se o `host` e a `porta` não forem definidos, o host-padrão será `localhost` e a porta-padrão será 5432. - -O script cria uma tabela e preenche com dados de espaço reservado. Para testar se o banco de dados do PostgreSQL contém os dados, o script imprime o conteúdo da tabela no registro do console. - -Ao executar este fluxo de trabalho, você deve ver a saída a seguir na etapa "Conectar-se ao PostgreSQL", que confirma que você criou o cliente PostgreSQL e adicionou dados: - -``` -null [ { id: 1, - primeiro nome: 'Mona the', - último nome: 'Octocat', - idade: 9, - endereço: - '88 Colin P Kelly Jr St, São Francisco, CA 94107, Estados Unidos', - e-mail: 'octocat@github.com' } ] -``` diff --git a/translations/pt-BR/content/actions/configuring-and-managing-workflows/creating-redis-service-containers.md b/translations/pt-BR/content/actions/configuring-and-managing-workflows/creating-redis-service-containers.md deleted file mode 100644 index 249df1fb4871..000000000000 --- a/translations/pt-BR/content/actions/configuring-and-managing-workflows/creating-redis-service-containers.md +++ /dev/null @@ -1,325 +0,0 @@ ---- -title: Criar contêineres de serviço Redis -intro: Você pode usar os contêineres de serviço para criar um cliente Redis no seu fluxo de trabalho. Este guia mostra exemplos de criação de serviço Redis para trabalhos executados em contêineres ou diretamente na máquina executora. -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/creating-redis-service-containers -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Introdução - -Este guia mostra os exemplos do seu fluxo de trabalho que configuram um contêiner de serviço usando a imagem `redis` do Docker Hub. O fluxo de trabalho executa um script para criar um cliente Redis e preencher os dados do cliente. Para testar se o fluxo de trabalho cria e preenche o cliente Redis, o script imprime os dados do cliente no console. - -{% data reusables.github-actions.docker-container-os-support %} - -### Pré-requisitos - -{% data reusables.github-actions.service-container-prereqs %} - -Também pode ser útil ter um entendimento básico de YAML, a sintaxe para {% data variables.product.prodname_actions %} e Redis. Para obter mais informações, consulte: - -- "[Configurando um fluxo de trabalho](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)" -- "[Introdução ao Redis](https://redislabs.com/get-started-with-redis/)" na documentação do Redis -- "[Conceitos básicos para{% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)" -- "[Usando variáveis de ambiente](/actions/automating-your-workflow-with-github-actions/using-environment-variables)" - -### Executar trabalhos em contêineres - -{% data reusables.github-actions.container-jobs-intro %} - -{% data reusables.github-actions.copy-workflow-file %} - -{% raw %} -```yaml -nome: exemplo do contêiner Redis -em: push - -trabalhos: - # Etiqueta do trabalho do contêiner - container-job: - # Os contêineres devem ser executados em sistemas operacionais baseados no Linux - runs-on: ubuntu-latest - # Imagem do Docker Hub em que o `container-job` é executado - contêiner: node:10.18-jessie - - # Contêineres de serviço a serem executados com `container-job` - serviços: - # Etiqueta usada para acessar o contêiner de serviço - redis: - # Imagem do Docker Hub - imagem: redis - # Define verificações gerais até a inicialização do redis - opções: >- - --health-cmd "redis-cli ping" - --health-interval 10s - --health-timeout 5s - --health-retries 5 - - etapas: - # Faz o download de uma cópia do código no seu repositório antes de executar os testes de CI - - nome: Verifica o código do repositório - usa: actions/checkout@v2 - - # Realiza uma instalação limpa de todas as dependências no arquivo `package.json` - # Para obter mais informações, consulte https://docs.npmjs.com/cli/ci.html - - nome: Instalar dependências - executar: npm ci - - - nome: Conectar-se ao Redis - # Executa um script que cria um cliente Redis, preenche - # os dados do cliente e recupera dados - executar: node client.js - # Variável do ambiente usada pelo script `client.js` para criar um novo Redis. - env: - # O nome do host usado para comunicar-se com o contêiner de serviço do Redis - REDIS_HOST: redis - # The default Redis port - REDIS_PORT: 6379 -``` -{% endraw %} - -#### Configurar o trabalho do contêiner - -{% data reusables.github-actions.service-container-host %} - -{% data reusables.github-actions.redis-label-description %} - -```yaml -trabalhos: - # Etiqueta do trabalho do contêiner - container-job: - # Os contêineres devem ser executados em sistemas operacionais baseados no Linux - runs-on: ubuntu-latest - # Imagem do Docker Hub em que o `container-job` é executado - contêiner: node:10.18-jessie - - # Contêineres de serviço a serem executados com `container-job` - serviços: - # Etiqueta usada para acessar o contêiner de serviço - redis: - # Imagem do Docker Hub - imagem: redis - # Define verificações gerais até a inicialização do redis - opções: >- - --health-cmd "redis-cli ping" - --health-interval 10s - --health-timeout 5s - --health-retries 5 -``` - -#### Configurar as etapas - -{% data reusables.github-actions.service-template-steps %} - -```yaml -etapas: - # Faz o download de uma cópia do código no seu repositório antes de executar testes de CI - - nome: Verifica o código do repositório - usa: actions/checkout@v2 - - # Realiza uma instalação limpa de todas as dependências do arquivo `package.json` - # Para obter mais informações, consulte https://docs.npmjs.com/cli/ci.html - - nome: Instalar dependências - executar: npm ci - - - nome: Conectar-se ao Redis - # Executa um script que cria um cliente Redis client, preenche - # os dados do cliente e recupera dados - executar: node client.js - # Variável do ambiente usada pelo script `client.js` para criar um novo cliente Redis. - env: - # O nome do host usado para comunicar-se com o contêiner de serviço do Redis - REDIS_HOST: redis - # A porta-padrão do Redis - REDIS_PORT: 6379 -``` - -{% data reusables.github-actions.redis-environment-variables %} - -O nome do host do serviço Redis é a etiqueta que você configurou no seu fluxo de trabalho, nesse caso `redis`. Uma vez que os contêineres do Docker na mesma rede da ponte definida pelo usuário abrem todas as portas por padrão, você poderá acessar o contêiner de serviço na porta-padrão 6379 do Redis. - -### Executar trabalhos diretamente na máquina executora - -Ao executar um trabalho diretamente na máquina executora, você deverá mapear as portas no contêiner de serviço com as portas no host do Docker. Você pode acessar os contêineres de serviço do host do Docker usando `localhost` e o número da porta do host do Docker. - -{% data reusables.github-actions.copy-workflow-file %} - -{% raw %} -```yaml -nome: Exemplo do executor do Redis -em: push - -trabalhos: - # Etiqueta do trabalho executor - runner-job: - # Você deve usar um ambiente do Linux ao usar contêineres de serviço ou trabalhos de contêiner - runs-on: ubuntu-latest - - # Contêineres de serviço a serem executados com `runner-job` - serviços: - # Etiqueta usada para acessar o contêiner de serviço - redis: - # Imagem do Docker Hub - imagem: redis - # Define verificações gerais até a inicialização do redis - opções: >- - --health-cmd "redis-cli ping" - --health-interval 10s - --health-timeout 5s - --health-retries 5 - portas: - # Mapeia a porta port 6379 no contêiner de serviço com o host - - 6379:6379 - - etapas: - # Faz um download de uma cópia do código no seu repositório antes de executar testes de CI - - nome: Verifica o código do repositório - usa: actions/checkout@v2 - - # Realiza uma instalação limpa de todas as dependências no arquivo `package.json` - # Para obter mais informações, consulte https://docs.npmjs.com/cli/ci.html - - nome: Instalar dependências - executar: npm ci - - - nome: Conectar-se ao Redis - # Executa um script que cria um cliente Redis, preenche - # os dados do cliente e recupera dados - executar: node client.js - # Variável do ambiente usada pelo script `client.js` para criar - # um novo cliente Redis. - env: - # O nome do host usado para comunicar-se com o contêiner de serviço Reds - REDIS_HOST: localhost - # A porta-padrão do Redis - REDIS_PORT: 6379 -``` -{% endraw %} - -#### Configurar o trabalho executor - -{% data reusables.github-actions.service-container-host-runner %} - -{% data reusables.github-actions.redis-label-description %} - -O fluxo de trabalho mapeia a porta 6379 no contêiner de serviço do Redis com o host do Docker. Para obter mais informações sobre a palavra-chave `portas`, consulte "[Sobre contêineres de serviço](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)". - -```yaml -trabalhos: - # Etiqueta do trabalho executor - runner-job: - # Você deve usar um ambiente do Linux ao usar contêineres de serviço ou trabalhos de contêiner - runs-on: ubuntu-latest - - # Contêineres de serviço a serem executados com `runner-job` - serviços: - # Etiqueta usada para acessar o contêiner de serviço - redis: - # Imagem do Docker Hub - imagem: redis - # Define as verificações gerais até a inicialização do redis - opções: >- - --health-cmd "redis-cli ping" - --health-interval 10s - --health-timeout 5s - --health-retries 5 - portas: - # Mapeia a porta 6379 no contêiner de serviço com o host - - 6379:6379 -``` - -#### Configurar as etapas - -{% data reusables.github-actions.service-template-steps %} - -```yaml -etapas: - # Faz o download de uma cópia do código no seu repositório antes de executar os testes de CI - - nome: Verifica o código do repositório - usa: actions/checkout@v2 - - # Realiza uma instalação limpa de todas as dependências no arquivo `package.json` - # Para obter mais informações, consulte https://docs.npmjs.com/cli/ci.html - - nome: Instalar dependências - executar: npm ci - - - nome: Conectar-se ao Redis - # Executa um script que cria um cliente Redis, preenche - # os dados do cliente e recupera os dados - executar: node client.js - # Variável do ambiente usada pelo script `client.js` para criar - # um novo cliente Redis. - env: - # O nome do host usado para comunicar-se com o contêiner de serviço Redis - REDIS_HOST: localhost - # A porta-padrão Redis - REDIS_PORT: 6379 -``` - -{% data reusables.github-actions.redis-environment-variables %} - -{% data reusables.github-actions.service-container-localhost %} - -### Testar o contêiner de serviço Redis - -Você pode testar o seu fluxo de trabalho usando o script a seguir, que cria um cliente Redis e adiciona uma tabela com alguns dados com espaços reservados. Em seguida, o script imprime no terminal os valores armazenados no cliente Redis. O seu script pode usar qualquer linguagem que você desejar, mas este exemplo usa Node.js e o módulo npm `redis`. Para obter mais informações, consulte o [módulo redis npm](https://www.npmjs.com/package/redis). - -Você pode modificar o *client.js* para incluir qualquer operação necessária para o seu fluxo de trabalho. Neste exemplo, o script cria a instância do cliente Redis, cria uma tabela, adiciona dados de espaços reservados e, em seguida, recupera os dados. - -{% data reusables.github-actions.service-container-add-script %} - -```javascript -const redis = require("redis"); - -// Cria um novo cliente Redis -// Se REDIS_HOST não for definido, o host-padrão será localhost -// Se REDIS_PORT não for definido, a porta-padrão será 6379 -const redisClient = redis.createClient({ - host: process.env.REDIS_HOST, - port: process.env.REDIS_PORT -}); - -redisClient.on("error", function(err) { - console.log("Error " + err); -}); - -// Define a chave "octocat" como um valor de "Mona the octocat" -redisClient.set("octocat", "Mona the Octocat", redis.print); -// Define uma chave como "octocat", campo de "species", e "value" como "Cat and Octopus" -redisClient.hset("species", "octocat", "Cat and Octopus", redis.print); -// Define uma chave como "octocat", campo de "species", e "value" como "Dinosaur and Octopus" -redisClient.hset("species", "dinotocat", "Dinosaur and Octopus", redis.print); -// Define uma chave como "octocat", campo de "species", e "value" como "Cat and Robot" -redisClient.hset(["species", "robotocat", "Cat and Robot"], redis.print); -// Obtém todos os campos na chave "species" - -redisClient.hkeys("species", function (err, replies) { - console.log(replies.length + " replies:"); - replies.forEach(function (reply, i) { - console.log(" " + i + ": " + reply); - }); - redisClient.quit(); -}); -``` - -O script cria um novo cliente Redis, usando o método `createClient`, que aceita um `host` e um parâmetro da `porta`. O script usa as variáveis do ambiente `REDIS_HOST` e `REDIS_PORT` para definir o endereço IP e a porta do cliente. Se o `host` e a `porta` não forem definidos, o host-padrão será `localhost` e a porta-padrão será 6379. - -O script usa os métodos `set` e `hset` para preencher o banco de dados com algumas chaves, campos e valores. Para confirmar se o cliente Redis contém os dados, o script imprime o conteúdo do banco de dados no registro do console. - -Ao executar este fluxo de trabalho, você deve ver a saída a seguir na etapa "Conectar-se ao Redis", confirmando que você criou o cliente Redis e adicionou os dados: - -``` -Resposta: OK -Resposta: 1 -Resposta: 1 -Resposta: 1 -3 respostas: - 0: octocat - 1: dinotocat - 2: robotocat -``` diff --git a/translations/pt-BR/content/actions/configuring-and-managing-workflows/index.md b/translations/pt-BR/content/actions/configuring-and-managing-workflows/index.md deleted file mode 100644 index 34ceee2332c1..000000000000 --- a/translations/pt-BR/content/actions/configuring-and-managing-workflows/index.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Configurar e gerenciar fluxos de trabalho -shortTitle: Fluxos de trabalho -intro: Você pode criar fluxos de trabalho personalizados e gerenciar execuções para controlar os processos do ciclo de vida do desenvolvimento do software do seu projeto. -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -{% topic_link_in_list /configuring-and-managing-workflow-files-and-runs %} - {% link_in_list /configuring-a-workflow %} - {% link_in_list /managing-a-workflow-run %} - {% link_in_list /sharing-workflow-templates-within-your-organization %} -{% topic_link_in_list /using-variables-and-secrets-in-a-workflow %} - {% link_in_list /creating-and-storing-encrypted-secrets %} - {% link_in_list /using-environment-variables %} - {% link_in_list /authenticating-with-the-github_token %} -{% topic_link_in_list /caching-and-storing-workflow-data %} - {% link_in_list /persisting-workflow-data-using-artifacts %} - {% link_in_list /caching-dependencies-to-speed-up-workflows %} -{% topic_link_in_list /using-databases-and-service-containers %} - {% link_in_list /about-service-containers %} - {% link_in_list /creating-redis-service-containers %} - {% link_in_list /creating-postgresql-service-containers %} diff --git a/translations/pt-BR/content/actions/configuring-and-managing-workflows/managing-a-workflow-run.md b/translations/pt-BR/content/actions/configuring-and-managing-workflows/managing-a-workflow-run.md deleted file mode 100644 index 9d125f12239f..000000000000 --- a/translations/pt-BR/content/actions/configuring-and-managing-workflows/managing-a-workflow-run.md +++ /dev/null @@ -1,186 +0,0 @@ ---- -title: Gerenciar a execução de fluxos de trabalho -intro: 'Você pode visualizar o status e os resultados de cada etapa no seu fluxo de trabalho, cancelar um fluxo de trabalho pendente, visualizar os minutos de execução do trabalho faturável, depurar e reexecutar o fluxo de trabalho com falha, pesquisar e fazer o download de registros e de artefatos.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/viewing-your-repository-s-workflows - - /articles/viewing-your-repositorys-workflows - - /articles/managing-a-workflow-run - - /github/automating-your-workflow-with-github-actions/managing-a-workflow-run - - /actions/automating-your-workflow-with-github-actions/managing-a-workflow-run -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Sobre o gerenciamento de fluxos de trabalho - -Na página de execução de fluxo de trabalho, você pode verificar se a execução está em andamento ou foi concluída. Se a execução estiver em andamento, será possível cancelá-la. Você deve estar conectado a uma conta {% data variables.product.prodname_dotcom %} para visualizar as informações da execução do seu fluxo de trabalho, incluindo os repositórios públicos. Para obter mais informações, consulte "[Permissões de acesso no GitHub](/articles/access-permissions-on-github)". - -Se a execução estiver concluída, será possível ver se o resultado teve êxito, se houve falha, se foi cancelado ou se ficou neutro. Em caso de falha, você poderá exibir e pesquisar os logs de criação para diagnosticar a falha e executar o fluxo de trabalho novamente. Você também pode visualizar os minutos da execução do trabalho faturável ou fazer o download dos registros e criar artefatos. - - ![Imagem de execução do fluxo de trabalho anotado](/assets/images/help/repository/annotated-workflow.png) - -O {% data variables.product.prodname_actions %} usa a API de Verificação para mostrar os status, resultados e logs de um fluxo de trabalho. O {% data variables.product.prodname_dotcom %} cria um novo conjunto de verificações para cada execução de fluxo de trabalho. O conjunto de verificações contêm uma execução de verificação para cada trabalho no fluxo de trabalho, e cada trabalho inclui etapas. As ações do {% data variables.product.prodname_actions %} são executadas como etapas no fluxo de trabalho. Para obter mais informações sobre a API de verificações, consulte "[Verificações](/v3/checks/)". - -{% data reusables.github-actions.invalid-workflow-files %} - -### Exibir o histórico do fluxo de trabalho - -Você pode exibir todos os trabalhos em uma execução de fluxo de trabalho e todas as etapas de um trabalho. Para obter mais informações, consulte "[Conceitos básicos para {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions#job)". {% data reusables.repositories.permissions-statement-read %} - -Além das etapas configuradas no arquivo de fluxo de trabalho, cada trabalho também inclui tarefas adicionais para iniciar e concluir a execução do trabalho. Essas etapas estão registradas na execução do fluxo de trabalho como "Configurar trabalho" e "Concluir trabalho". - -Para trabalhos executados em executores hospedados no {% data variables.product.prodname_dotcom %}, "Configurar trabalho" registra os detalhes do ambiente virtual do executor e inclui um link para a lista de ferramentas pré-instaladas que estavam presentes na máquina do executor. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -6. Para executar o fluxo de trabalho novamente em caso de falha, use o menu suspenso **Re-run checks** (Executar verificações novamente) no canto superior direito e selecione **Re-run all checks** (Executar todas as verificações novamente). ![Menu suspenso Re-run checks (Executar verificações novamente)](/assets/images/help/repository/rerun-checks-drop-down.png) - -### Cancelar a execução do fluxo de trabalho - -Ao cancelar a execução de um fluxo de trabalho, o {% data variables.product.prodname_dotcom %} cancela todos os trabalhos e as etapas que integram esse fluxo de trabalho. {% data reusables.repositories.permissions-statement-write %} - -Ao cancelar a execução do fluxo de trabalho, você poderá estar executando outro software que utiliza recursos relacionados à execução do fluxo de trabalho. Para ajudar você a liberar recursos relacionados à execução do fluxo de trabalho, pode ser útil entender as etapas que {% data variables.product.prodname_dotcom %} realiza para cancelar a execução de um fluxo de trabalho. Para obter mais informações, consulte "[Etapas que o {% data variables.product.prodname_dotcom %} realiza para cancelar uma execução do fluxo de trabalho](#steps-github-takes-to-cancel-a-workflow-run)". - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -1. No canto superior direito do fluxo de trabalho, clique em **Cancel check suite** (Cancelar conjunto de verificações). ![Botão Cancel check suite (Cancelar conjunto de verificações)](/assets/images/help/repository/cancel-check-suite.png) -1. Após clicar em **Cancelar o conjunto de verificações**. - -#### Etapas que o {% data variables.product.prodname_dotcom %} realiza para cancelar uma execução de fluxo de trabalho - -1. Para cancelar a execução do fluxo de trabalho, o servidor avalia novamente as condições `if` para todas as tarefas em execução atualmente. Se a condição for avaliada como `verdadeira`, o trabalho não será cancelado. Por exemplo, a condição `if: always()` seria avaliada como verdadeira e o trabalho continuaria a ser executado. Quando não há nenhuma condição, isso é equivalente à condição `if: success()`, que só é executado se a etapa anterior foi concluída com sucesso. -2. Para trabalhos que devem ser cancelados, o servidor envia uma mensagem de cancelamento para todas as máquinas dos executores com trabalhos que precisam ser cancelados. -3. Para os trabalhos que continuam a ser executados, o servidor avalia as condições `if` para as etapas não concluídas. Se a condição for avaliada como `verdadeiro`, a etapa continuará sendo executada. -4. Para etapas que precisam ser canceladas, a máquina do executor envia `SIGINT/Ctrl-C` para o processo de entrada da etapa (`nó` para ação javascript, `docker` para ação de contêiner e `bash/cmd/pwd` quando estiver usando `execução` em uma etapa). Se o processo não sair em 7500 ms, o executor enviará `SIGTERM/Ctrl-Break` para o processo. Em seguida, espere 2500 ms para que o processo saia. Se o processo ainda estiver em execução, o corredor finalizará abruptamente a árvore do processo. -5. Após o tempo-limite de cancelamento de 5 minutos, o servidor irá forçar o encerramento de todos os trabalhos e etapas que não terminarem de ser executadas ou não concluírem o processo de cancelamento. - -### Eliminar execução de um fluxo de trabalho - -Você pode excluir uma execução do fluxo de trabalho que foi concluída ou que tem mais de 2 semanas. {% data reusables.repositories.permissions-statement-write %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -1. Para excluir a execução de um fluxo de trabalho, use o menu suspenso {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} e selecione **Excluir execução de fluxo de trabalho**. - - ![Eliminar execução de um fluxo de trabalho](/assets/images/help/settings/workflow-delete-run.png) -1. Revise a solicitação de confirmação e clique em **Sim, excluir permanentemente esta execução do fluxo de trabalho**. - - ![Excluir uma confirmação de execução de fluxo de trabalho](/assets/images/help/settings/workflow-delete-run-confirmation.png) - -{% if currentVersion == "free-pro-team@latest" %} - -### Visualizar os minutos de execução do trabalho faturável - -Você pode visualizar o tempo de execução de um trabalho, incluindo os minutos faturáveis que um trabalho acumulou. - -Os minutos de execução de um trabalho faturável são exibidos para trabalhos executados em repositórios privados que usam executores hospedados em {% data variables.product.prodname_dotcom %}. Não há minutos faturáveis ao usar {% data variables.product.prodname_actions %} nos repositórios públicos ou para trabalhos executados em executores auto-hospedados. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -1. No resumo do trabalho, clique em **Informações sobre tempo faturável e execução**. ![Link com informações sobre o tempo faturável e execução](/assets/images/help/repository/view-run-billable-time.png) - - {% note %} - - **Observação:**O tempo faturável exibido não inclui arredondamentos ou multiplicadores de minutos. Para visualizar o uso total de {% data variables.product.prodname_actions %}, incluindo arredondamento e multiplicadores de minutos, consulte "[Visualizando o seu uso {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage)". - - {% endnote %} - -{% endif %} - -### Exibir logs para diagnosticar falhas - -Se houver falha na execução do fluxo de trabalho, você poderá ver qual etapa causou a falha e revisar os logs de criação da etapa com falha para resolver os problemas. Também é possível ver a duração da execução de cada etapa. Além disso, você pode copiar um permalink para determinada linha no arquivo de log a fim de compartilhar com a sua equipe. {% data reusables.repositories.permissions-statement-read %} - -O {% data variables.product.product_name %} armazena registros de criação e artefatos completos por 90 dias. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -{% data reusables.repositories.navigate-to-job %} -6. Para expandir o log de uma etapa com falha, clique na etapa. ![Nome da etapa com falha](/assets/images/help/repository/failed-check-step.png) -7. Para obter um link para uma linha específica nos logs, clique no número da linha da etapa. Você pode copiar o link da barra de endereços do navegador da web. ![Botão para copiar link](/assets/images/help/repository/copy-link-button.png) - -### Pesquisar logs - -É possível pesquisar os logs de criação em determinadas etapas. Na pesquisa dos logs, somente as etapas expandidas são incluídas nos resultados. {% data reusables.repositories.permissions-statement-read %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -{% data reusables.repositories.navigate-to-job %} -6. Para expandir cada etapa que você pretende incluir na pesquisa, clique na etapa.![Nome da etapa](/assets/images/help/repository/failed-check-step.png) -7. No canto superior direito da saída do log, na caixa **Search logs** (Pesquisar logs), digite um termo de consulta. ![Caixa de pesquisa de logs](/assets/images/help/repository/search-log-box.png) - -### Fazer download dos registros - -Você pode fazer o download dos arquivos de registro da execução do seu fluxo de trabalho. Você também pode fazer o download dos artefatos de um fluxo de trabalho. Para obter mais informações, consulte "[Dados recorrentes do fluxo de trabalho que usam artefatos](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)". {% data reusables.repositories.permissions-statement-read %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -5. Para baixar os logs, use o menu suspenso **Download logs** (Baixar logs) e selecione os logs que você pretende baixar. ![Menu suspenso Download logs (Baixar logs)](/assets/images/help/repository/download-logs-drop-down.png) - -### Excluir registros - -Você pode excluir arquivos de registro da execução do seu fluxo de trabalho. {% data reusables.repositories.permissions-statement-write %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -5. Para excluir os arquivos de registro, clique no botão **Excluir todos os registros** e revise a instrução de confirmação. ![Delete all logs](/assets/images/help/repository/delete-all-logs.png)Após excluir os registros, o botão **Excluir todos os registros** será removido para indicar que não restaram arquivos de registro na execução do fluxo de trabalho. - -### Habilitar log de depuração - -Se os logs do fluxo de trabalho não fornecerem detalhes suficientes para diagnosticar o motivo pelo qual um fluxo de trabalho, um trabalho ou uma etapa não está funcionando como esperado, habilite o log de depuração adicional. - -Esses registros adicionais são habilitados pela definição dos segredos no repositório que contém o fluxo de trabalho. Portanto, aplicam-se os mesmos requisitos de permissão: - -- {% data reusables.github-actions.permissions-statement-secrets-organization %} -- {% data reusables.github-actions.permissions-statement-secrets-repository %} -- {% data reusables.github-actions.permissions-statement-secrets-api %} - -Para obter mais informações sobre segredos de configuração, consulte "[Criar e usar segredos criptografados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". - -#### Habilitar log de diagnóstico do runner - -O log de diagnóstico do executor fornece arquivos de log adicionais que contêm informações sobre como um executor está executando um trabalho. Dois arquivos de log extras foram adicionados ao arquivo de log: - -* O log de processo do runner, que inclui informações sobre a coordenação e a configuração de runners para executar trabalhos. -* O log de processo do worker, que registra em log a execução de um trabalho. - -1. Para habilitar o log de diagnóstico do runner, defina a seguinte chave secreta no repositório que contém o fluxo de trabalho: `ACTIONS_RUNNER_DEBUG` como `true`. - -1. Para baixar os logs de diagnóstico do runner, baixe o arquivo de log da execução de fluxo de trabalho. Os logs de diagnóstico do runner ficam na pasta `runner-diagnostic-logs`. Para obter mais informações sobre o download de logs, consulte "[Fazer download de registros](#downloading-logs)". - -#### Habilitar log de depuração da etapa - -O log de depuração da etapa aumenta o detalhamento dos logs de um trabalho durante e depois da execução dele. - -1. Para habilitar o log de diagnóstico da etapa, defina a seguinte chave secreta no repositório que contém o fluxo de trabalho: `ACTIONS_STEP_DEBUG` como `true`. - -1. Após a configuração da chave secreta, mais eventos de depuração são exibidos nos logs da etapa. Para obter mais informações, consulte ["Exibir logs para diagnosticar falhas"](#viewing-logs-to-diagnose-failures). - - -### Leia mais - -- [Sobre o {% data variables.product.prodname_actions %}](/articles/about-github-actions) -- [Configurar fluxo de trabalho](/articles/configuring-a-workflow) -- [Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions) -- [Eventos que acionam fluxos de trabalho](/articles/events-that-trigger-workflows) -- "[Ambientes virtuais para executores hospedados em {% data variables.product.prodname_dotcom %}](/actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)" diff --git a/translations/pt-BR/content/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts.md b/translations/pt-BR/content/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts.md deleted file mode 100644 index 1d1a6bcec446..000000000000 --- a/translations/pt-BR/content/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts.md +++ /dev/null @@ -1,249 +0,0 @@ ---- -title: Persistir dados de fluxo de trabalho usando artefatos -intro: Artefatos permitem que você compartilhe dados entre trabalhos em um fluxo e armazene dados quando o fluxo de trabalho estiver concluído. -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/persisting-workflow-data-using-artifacts - - /github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts - - /actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Sobre artefatos de fluxos de trabalho - -Os artefatos permitem que você persista com os dados após um trabalho ter sido concluído e compartilhe os dados com outro trabalho no mesmo fluxo de trabalho. Um artefato é um arquivo ou uma coleção de arquivos produzidos durante a execução de um fluxo de trabalho. Por exemplo, você pode usar artefatos para salvar a sua criação e testar a saída após uma conclusão da execução do fluxo de trabalho. Para pushes e pull requestes, {% data variables.product.product_name %} armazena artefatos por 90 dias. O período de retenção para um pull request é reiniciado cada vez que alguém faz o push de um novo commit para o pull request. - -Esses são alguns dos artefatos comuns cujo upload você pode fazer: - -- Arquivos de log e descartes de memória; -- Resultados de testes, falhas e capturas de tela; -- Arquivos binários ou comprimidos -- Resultados de teste de estresse e resultados de cobertura do código. - -{% if currentVersion == "free-pro-team@latest" %} - -Armazenar artefatos consome espaço de armazenamento em {% data variables.product.product_name %}. {% data reusables.github-actions.actions-billing %} Para mais informações, consulte "[Gerenciando cobrança para {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)". - -{% else %} - -Os artefatos expiram automaticamente após 90 dias, mas você pode recuperar armazenamento utilizado {% data variables.product.prodname_actions %}, excluindo os artefatos antes de expirarem em {% data variables.product.product_name %}. - -{% endif %} - -Faz-se o upload dos artefatos durante a execução de um fluxo de trabalho e você pode visualizar o nome e o tamanho do artefato na UI. Quando se faz o download de um artefato usando a UI {% data variables.product.product_name %}, todos os arquivos cujo upload foi feito individualmente como parte do get do artefato zipado em um arquivo único. Isso significa que a cobrança é calculada com base no tamanho do artefato subido e não com base no tamanho do arquivo zip. - -O {% data variables.product.product_name %} fornece duas ações que você pode usar para fazer upload e baixar artefatos de compilação. Para obter mais informações, consulte [ações/fazer upload de artefatos](https://github.com/actions/upload-artifact) e [ações/fazer download de artefatos](https://github.com/actions/download-artifact). - -Para compartilhar dados entre trabalhos: - -* **Fazendo o upload dos arquivos**: Fornece ao arquivo subido um nome e faz o upload dos dados antes da conclusão do trabalho. -* **Fazendo o download dos arquivos**: Você pode apenas fazer o download dos artefatos que foram subidos durante a mesma execução do fluxo de trabalho. Ao fazer o download de um arquivo, você pode fazer referenciá-lo pelo nome. - -As etapas de um trabalho compartilham o mesmo ambiente na máquina executora, mas são executados em seus próprios processos individuais. Para transmitir dados entre etapas de um trabalho, você pode usar entradas e saídas. Para obter mais informações sobre entradas e saídas, consulte "[Sintaxe de metadados para o {% data variables.product.prodname_actions %}](/articles/metadata-syntax-for-github-actions)". - -### Transmitir dados entre trabalhos em um fluxo - -Você pode usar as ações `upload-artifact` e `download-artifact` para compartilhar os dados entre os trabalhos em um fluxo de trabalho. Este exemplo de fluxo de trabalho ilustra como transmitir dados entre trabalhos em um mesmo fluxo. Para obter mais informações, consulte [ações/fazer upload de artefatos](https://github.com/actions/upload-artifact) e [ações/fazer download de artefatos](https://github.com/actions/download-artifact). - -Os trabalhos que são dependentes de artefatos de um trabalho anterior devem aguardar a finalização do trabalho dependente. Esse fluxo de trabalho usa a palavra-chave `needs` para garantir que `job_1`, `job_2` e `job_3` sejam executados sequencialmente. Por exemplo, `job_2` requer `job_1` usando a sintaxe `needs: job_1`. - -O Job 1 (Trabalho 1) executa estas etapas: -- Realiza um cálculo de correspondência e salva o resultado em um arquivo de texto denominado `math-homework.txt`. -- Usa a ação `upload-artifact` para fazer upload do arquivo `math-homework.txt` com o nome `homework`. A ação coloca o arquivo em um diretório denominado `homework`. - -O Job 2 (Trabalho 2) usa o resultado do trabalho anterior: -- Baixa o artefato `homework` carregado no trabalho anterior. Por padrão, a ação `download-artifact` baixa artefatos no diretório da área de trabalho no qual a etapa está sendo executada. Você pode usar o parâmetro da entrada do `caminho` para especificar um diretório diferente para o download. -- Lê o valor no arquivo `homework/math-homework.txt`, efetua um cálculo matemático e salva o resultado em `math-homework.txt`. -- Faz upload do arquivo `math-homework.txt`. Esse upload sobrescreve o upload anterior, pois ambos compartilham o mesmo nome. - -O Job 3 (Trabalho 3) mostra o resultado carregado no trabalho anterior: -- Baixa o artefato `homework`. -- Imprime o resultado da operação matemática no log. - -A operação matemática completa executada nesse fluxo de trabalho é `(3 + 7) x 9 = 90`. - -```yaml -name: Share data between jobs - -on: [push] - -jobs: - job_1: - name: Add 3 and 7 - runs-on: ubuntu-latest - steps: - - shell: bash - run: | - expr 3 + 7 > math-homework.txt - - name: Upload math result for job 1 - uses: actions/upload-artifact@v2 - with: - name: homework - path: math-homework.txt - - job_2: - name: Multiply by 9 - needs: job_1 - runs-on: windows-latest - steps: - - name: Download math result for job 1 - uses: actions/download-artifact@v2 - with: - name: homework - - shell: bash - run: | - value=`cat math-homework.txt` - expr $value \* 9 > math-homework.txt - - name: Upload math result for job 2 - uses: actions/upload-artifact@v2 - with: - name: homework - path: math-homework.txt - - job_3: - name: Display results - needs: job_2 - runs-on: macOS-latest - steps: - - name: Download math result for job 2 - uses: actions/download-artifact@v2 - with: - name: homework - - name: Print the final result - shell: bash - run: | - value=`cat math-homework.txt` - echo The result is $value -``` - -![Fluxo de trabalho que transmite dados entre trabalhos para executar cálculos matemáticos](/assets/images/help/repository/passing-data-between-jobs-in-a-workflow.png) - -### Compartilhar dados entre execuções de fluxo de trabalho - -Após a conclusão do fluxo de trabalho, você pode fazer o download de um arquivo comprimido do artefato {% data variables.product.product_name %}, encontrando a execução do fluxo de trabalho na subido na aba **Ações**. Você também pode usar o API REST {% data variables.product.prodname_dotcom %} para fazer o download dos artefatos. Para obter mais informações, consulte "[Artefatos](/v3/actions/artifacts/)". - -O {% data variables.product.product_name %} fornece duas ações que você pode usar para fazer upload e baixar artefatos de compilação. Para obter mais informações, consulte [ações/fazer upload de artefatos](https://github.com/actions/upload-artifact) e [ações/fazer download de artefatos](https://github.com/actions/download-artifact). - -### Fazer upload da compilação e testar artefatos - -Você pode criar um fluxo de trabalho de integração contínua (CI) para criar e testar o seu código. Para obter mais informações sobre o uso do {% data variables.product.prodname_actions %} para executar CI, consulte "[Sobre integração contínua](/articles/about-continuous-integration)." - -A saída da compilação e teste de seu código muitas vezes produz arquivos que podem ser usados para depurar falhas em testes e códigos de produção que você pode implantar. É possível configurar um fluxo de trabalho para compilar e testar o código com push no repositório e relatar um status de sucesso ou falha. Você pode fazer upload da saída de compilação e teste para usar em implantações, para depurar falhas e testes com falhas e visualizar a cobertura do conjunto de teste. - -Você pode usar a ação `upload-artifact` para fazer o upload dos artefatos. Ao fazer o upload de um artefato, você pode especificar um arquivo ou diretório único, ou vários arquivos ou diretórios. Você também pode excluir certos arquivos ou diretórios e usar padrões coringa. Recomendamos que você forneça um nome para um artefato, mas se nenhum nome for fornecido, `artefato` será usado como nome-padrão. Para obter mais informações sobre a sintaxe, consulte a ação [actions/upload-artifact](https://github.com/actions/upload-artifact). - -#### Exemplo - -Por exemplo, o seu repositório ou um aplicativo web pode conter arquivos SASS e TypeScript que você deve converter para CSS e JavaScript. Pressupondo que sua configuração de compilação envia os arquivos compilados para o diretório `dist`, você implementaria os arquivos no diretório `dist` no seu servidor de aplicativo web, se todos os testes foram concluídos com sucesso. - -``` -|-- hello-world (repository) -| └── dist -| └── tests -| └── src -| └── sass/app.scss -| └── app.ts -| └── output -| └── test -| -``` - -Esse exemplo mostra como criar um fluxo de trabalho para um projeto Node.js que `builds` (compila) o código no diretório `src` e executa os testes no diretório `tests`. Você pode partir do princípio que executar `npm test` produz um relatório de cobertura de código denominado `code-coverage.html`, armazenado no diretório `output/test/`. - -O fluxo de trabalho faz o upload dos artefatos de produção no diretório `dist`, mas exclui todos os arquivos de markdown. Ele também e faz o upload do relatório de `code-coverage.html` como outro artefato. - -```yaml -name: Node CI - -on: [push] - -jobs: - build_and_test: - runs-on: ubuntu-latest - steps: - - name: Checkout repository - uses: actions/checkout@v2 - - name: npm install, build, and test - run: | - npm install - npm run build --if-present - npm test - - name: Archive production artifacts - uses: actions/upload-artifact@v2 - with: - name: dist-without-markdown - path: | - dist - !dist/**/*.md - - name: Archive code coverage results - uses: actions/upload-artifact@v2 - with: - name: code-coverage-report - path: output/test/code-coverage.html -``` - -![Imagem de execução de fluxo de trabalho de artefato carregado em fluxo de trabalho](/assets/images/help/repository/upload-build-test-artifact.png) - -### Fazer o download ou excluir artefatos - -Durante a execução de um fluxo de trabalho, você pode baixar artefatos que foram previamente carregados na mesma execução do fluxo de trabalho. Após a conclusão da execução de um fluxo de trabalho, você poderá fazer o download ou excluir artefatos no GitHub usando o histórico de execução de fluxo de trabalho. - -#### Fazer o download dos artefatos durante a execução de um fluxo de trabalho - -A ação [actions/download-artefact](https://github.com/actions/download-artifact) pode ser usada para fazer o download de artefatos carregados anteriormente durante a execução de um fluxo de trabalho. - -{% note %} - -**Observação:** Você só pode baixar artefatos em um fluxo de trabalho que foram carregados durante a mesma execução do fluxo de trabalho. - -{% endnote %} - -Especifique o nome de um artefato para fazer o download de um artefato individual. Se você fez o upload de um artefato sem especificar um nome, o nome-padrão será `artefato`. - -```yaml -- name: Download a single artifact - uses: actions/download-artifact@v2 - with: - name: my-artifact -``` - -Você também pode baixar todos os artefatos em uma execução de fluxo de trabalho sem especificar um nome. Isso pode ser útil se você estiver trabalhando com muitos artefatos. - -```yaml -- name: Download all workflow run artifacts - uses: actions/download-artifact@v2 -``` - -Se você fizer o download de todos os artefatos da execução de um fluxo de trabalho, será criado um diretório para cada artefato usando seu nome. - -Para obter mais informações sobre a sintaxe, consulte as ações {% if currentVersion == "free-pro-team@latest" %}[/download-artefato](https://github.com/actions/download-artifact) ação{% else %} `ações/download-artefato` ação em {% data variables.product.product_location %}{% endif %}. - -#### O download e a exclusão dos artefatos após a execução de um fluxo de trabalho foi concluído - -Os artefatos expiram automaticamente após 90 dias, mas você pode recuperar armazenamento utilizado {% data variables.product.prodname_actions %}, excluindo os artefatos antes de expirarem em {% data variables.product.product_name %}. - -{% warning %} - -**Aviso:** Após a exclusão de um artefato, este não poderá ser restaurado. - -{% endwarning %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -1. Para baixar artefatos, use o menu suspenso **Artifacts** (Artefatos) e selecione o artefato que você pretende baixar. ![Menu suspenso do para fazer download do artefato](/assets/images/help/repository/artifact-drop-down.png) -1. Para excluir artefatos, use o menu suspenso **Artefatos** e clique em {% octicon "trashcan" aria-label="The trashcan icon" %}. ![Menu suspenso para excluir o artefato](/assets/images/help/repository/actions-delete-artifact.png) - -{% if currentVersion == "free-pro-team@latest" %} - -### Leia mais - -- "[Gerenciando cobrança para {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)". - -{% endif %} diff --git a/translations/pt-BR/content/actions/configuring-and-managing-workflows/sharing-workflow-templates-within-your-organization.md b/translations/pt-BR/content/actions/configuring-and-managing-workflows/sharing-workflow-templates-within-your-organization.md deleted file mode 100644 index f044cace0c59..000000000000 --- a/translations/pt-BR/content/actions/configuring-and-managing-workflows/sharing-workflow-templates-within-your-organization.md +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: Compartilhar modelos de fluxo de trabalho na sua organização -intro: É possível criar um conjunto padronizado de modelos de fluxo de trabalho especificamente para sua organização. Os integrantes da organização podem usar os modelos na criação de novos fluxos de trabalho nos repositórios das organizações. -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -Os modelos do fluxo de trabalh podem ser criados por usuários com acesso de gravação ao repositório `.github` da organização. Em seguida, os modelos podem ser usados por integrantes da organização com permissão para criar fluxos de trabalho. - -Os modelos do fluxo de trabalho podem ser usados para criar novos fluxos de trabalho nos repositórios públicos de uma organização; para usar modelos para criar fluxos de trabalho em repositórios privados, a organização deve fazer parte de um plano corporativo ou do GitHub One. - -### Criar um modelo do fluxo de trabalho - -Este procedimento demonstra como criar um modelo de fluxo de trabalho e um arquivo de metadados. O arquivo de metadados descreve como o modelo é apresentado aos usuários quando estão criando um novo fluxo de trabalho. - -1. Se já não existir, crie um novo repositório público denominado `.github` na sua organização. -1. Crie um diretório denominado `workflow-templates`. -1. Crie seu novo arquivo de fluxo de trabalho dentro do diretório `workflow-templates`. - - Se você precisar referir-se ao branch-padrão de um repositório, você poderá usar o espaço reservado `branch$default`. Quando um fluxo de trabalho é criado usando seu modelo, o espaço reservado será automaticamente substituído pelo nome do branch-padrão do repositório. - - Por exemplo, este arquivo denominado `octo-organization-ci.yml` demonstra um fluxo de trabalho básico. - - ```yaml - name: Octo Organization CI - - on: - push: - branches: [ $default-branch ] - pull_request: - branches: [ $default-branch ] - - jobs: - build: - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - - name: Run a one-line script - run: echo Hello from Octo Organization - ``` -1. Crie um arquivo de metadados dentro do diretório `workflow-templates`. O arquivo de metadados deve ter o mesmo nome do arquivo de fluxo de trabalho, mas em vez da extensão `.yml`, deve-se adicionar `.properties.json`. Por exemplo, este arquivo denominado `octo-organization-ci.properties.json` contém os metadados para um arquivo de fluxo de trabalho denominado `octo-organization-ci.yml`: - ```yaml - { - "name": "Octo Organization Workflow", - "description": "Octo Organization CI workflow template.", - "iconName": "example-icon", - "categories": [ - "Go" - ], - "filePatterns": [ - "package.json$", - "^Dockerfile", - ".*\\.md$" - ] - } - ``` - * `nome` - **Obrigatório.** O nome do modelo de fluxo de trabalho. Isto é exibido na lista de modelos disponíveis. - * `descrição` - **Obrigatória.** A descrição do modelo de fluxo de trabalho. Isto é exibido na lista de modelos disponíveis. - * `iconName` - **Obrigatório.** Define um ícone para a entrada do fluxo de trabalho na lista de modelos. O `iconName` deve ser um ícone SVG com o mesmo nome e deve ser armazenado no diretório `workflow-templates`. Por exemplo, um arquivo SVG denominado `exemplo-icon.svg` é referenciado como `example-icon`. - * `categorias` - **Opcional.** Define a categoria de idioma do fluxo de trabalho. Quando um usuário visualiza os modelos disponíveis, esses modelos que correspondem àao mesmo idioma terão mais destaque. Para obter informações sobre as categorias de idioma disponíveis, consulte https://github.com/github/linguist/blob/master/lib/linguist/languages.yml. - * `filePatterns` - **Opcional.** Permite que o modelo seja usado se o repositório do usuário tiver um arquivo no diretório-raiz que corresponde a uma expressão regular definida. - -Para adicionar outro modelo de fluxo de trabalho, adicione seus arquivos ao mesmo diretório `workflow-templates`. Por exemplo: - -![Arquivos do modelo do fluxo de trabalho](/assets/images/help/images/workflow-template-files.png) - -### Usar um modelo do fluxo de trabalho - -Este procedimento demonstra como um membro da sua organização pode localizar e usar um modelo de fluxo de trabalho para criar um novo fluxo de trabalho. Os modelos de fluxo de trabalho de uma organização podem ser usados por qualquer pessoa que seja integrante da organização. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -1. Caso o seu repositório tenha fluxos de trabalho existentes: No canto superior esquerdo, clique em **Novo fluxo de trabalho**. ![Criar um novo fluxo de trabalho](/assets/images/help/repository/actions-new-workflow.png) -1. Os modelos de fluxo de trabalho da sua organização estão localizados em sua própria seção intitulada "Fluxos de trabalho criados pelo _nome da organização_". Sob, nome do template que você gostaria de usar, clique em **Configurar este fluxo de trabalho**. ![Configurar este fluxo de trabalho](/assets/images/help/settings/actions-create-starter-workflow.png) diff --git a/translations/pt-BR/content/actions/configuring-and-managing-workflows/using-databases-and-service-containers.md b/translations/pt-BR/content/actions/configuring-and-managing-workflows/using-databases-and-service-containers.md deleted file mode 100644 index 107312548add..000000000000 --- a/translations/pt-BR/content/actions/configuring-and-managing-workflows/using-databases-and-service-containers.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Usar bancos de dados e contêineres de serviço -intro: Conectar bancos de dados e contêineres de serviço para gerenciar ferramentas de fluxo de trabalho. -mapTopic: true -redirect_from: - - /actions/automating-your-workflow-with-github-actions/using-databases-and-services -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/pt-BR/content/actions/configuring-and-managing-workflows/using-environment-variables.md b/translations/pt-BR/content/actions/configuring-and-managing-workflows/using-environment-variables.md deleted file mode 100644 index fcf9f77d331e..000000000000 --- a/translations/pt-BR/content/actions/configuring-and-managing-workflows/using-environment-variables.md +++ /dev/null @@ -1,68 +0,0 @@ ---- -title: Usar variáveis de ambiente -intro: '{% data variables.product.prodname_dotcom %} define as variáveis do ambiente para cada execução do fluxo de trabalho {% data variables.product.prodname_actions %}. Você também pode definir variáveis de ambiente personalizadas no seu arquivo do fluxo de trabalho.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /github/automating-your-workflow-with-github-actions/using-environment-variables - - /actions/automating-your-workflow-with-github-actions/using-environment-variables -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Sobre as variáveis de ambiente - -{% data variables.product.prodname_dotcom %} define as variáveis-padrão do ambiente disponíveis para cada etapa da execução de um fluxo de trabalho. As variáveis de ambiente diferenciam entre maiúsculas e minúsculas. Os comandos executados em ações ou etapas podem criar, ler e modificar as variáveis do ambiente. - -Para definir as variáveis do ambiente personalizadas, você deverá especificar as variáveis no arquivo do fluxo de trabalho. Você pode definir as variáveis de ambiente para uma etapa, trabalho ou para todo o fluxo de trabalho usando as palavras-chave [`jobs..steps.env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsenv), [`jobs..env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idenv), e [`env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#env). Para obter mais informações, consulte "[sintaxe do Fluxo de Trabalho para {% data variables.product.prodname_dotcom %}](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepsenv)." - -```yaml -passos: - - nome: Olá mundo - run: echo Hello world $FIRST_NAME $middle_name $Last_Name! - env: - FIRST_NAME: Mona - middle_name: The - Last_Name: Octocat -``` - -Você também pode usar o comando do fluxo de trabalho `set-env` para definir uma variável de ambiente que as etapas a seguir podem usar em um fluxo de trabalho. O comando `set-env` pode ser usado diretamente por outra ação ou como um comando do shell em um arquivo do fluxo de trabalho usando a palavra-chave `executar` executar. Para obter mais informações, consulte "[Comandos do fluxo de trabalho para {% data variables.product.prodname_actions %}](/actions/reference/workflow-commands-for-github-actions/#setting-an-environment-variable)". - -### Variáveis padrão de ambiente - -É altamente recomendável que as ações usem as variáveis do ambiente para acessar o sistema do arquivo em vez de usar os caminhos do arquivo com codificação rígida. {% data variables.product.prodname_dotcom %} define as variáveis de ambiente para ações a serem usadas em todos os ambientes executores. - -| Variável de ambiente | Descrição | -| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `CI` | Definido sempre como `verdadeiro`. | -| `HOME` | Caminho para o diretório inicial do {% data variables.product.prodname_dotcom %} usado para armazenar dados do usuário. Por exemplo, `/github/home`. | -| `GITHUB_WORKFLOW` | Nome do fluxo de trabalho. | -| `GITHUB_RUN_ID` | {% data reusables.github-actions.run_id_description %} | -| `GITHUB_RUN_NUMBER` | {% data reusables.github-actions.run_number_description %} | -| `GITHUB_ACTION` | Identificador único (`id`) da ação. | -| `GITHUB_ACTIONS` | Definido sempre como `verdadeiro` quando {% data variables.product.prodname_actions %} estiver executando o fluxo de trabalho. Você pode usar esta variável para diferenciar quando os testes estão sendo executados localmente ou por {% data variables.product.prodname_actions %}. | -| `GITHUB_ACTOR` | Nome da pessoa ou aplicativo que iniciou o fluxo de trabalho. Por exemplo, `octocat`. | -| `GITHUB_REPOSITORY` | Nome do repositório e o proprietário. Por exemplo, `octocat/Hello-World`. | -| `GITHUB_EVENT_NAME` | Nome do evento de webhook que acionou o workflow. | -| `GITHUB_EVENT_PATH` | Caminho do arquivo com a carga completa do evento webhook. Por exemplo, `/github/workflow/event.json`. | -| `GITHUB_WORKSPACE` | Caminho do diretório do espaço de trabalho do {% data variables.product.prodname_dotcom %}. O diretório espaço de trabalho contém um subdiretório com uma cópia do repositório, caso o seu fluxo de trabalho utilize a ação [actions/checkout](https://github.com/actions/checkout). Se você não usar a ação `actions/checkout`, o diretório estará vazio. Por exemplo, `/home/runner/work/my-repo-name/my-repo-name`. | -| `GITHUB_SHA` | Commit SHA que acionou o fluxo de trabalho. Por exemplo, `ffac537e6cbbf934b08745a378932722df287a53`. | -| `GITHUB_REF` | Branch ou ref tag que acionou o fluxo de trabalho. Por exemplo, `refs/heads/feature-branch-1`. Se não houver branch ou tag disponível para o tipo de evento, a variável não existirá. | -| `GITHUB_HEAD_REF` | Configurado somente para repositórios bifurcados. O branch do repositório head. | -| `GITHUB_BASE_REF` | Configurado somente para repositórios bifurcados. O branch do repositório base. | -| `GITHUB_SERVER_URL` | Retorna a URL do servidor {% data variables.product.product_name %}. Por exemplo: `https://github.com`. | -| `GITHUB_API_URL` | Retorna a URL da API. Por exemplo: `https://api.github.com`. | -| `GITHUB_GRAPHQL_URL` | Retorna a URL API do GraphQL. Por exemplo: `https://api.github.com/graphql`. | - -### Convenções de nomenclatura para variáveis de ambiente - -{% note %} - -**Observação**{% data variables.product.prodname_dotcom %} reserva o prefixo da variável de ambiente `GITHUB_` para uso interno por {% data variables.product.prodname_dotcom %}. Definir uma variável de ambiente ou segredo com o prefixo `GITHUB_` resultará em erro. - -{% endnote %} - -Qualquer variável de ambiente nova que você definir e apontar para um local no sistema de arquivos deve ter um sufixo `_PATH`. As variáveis padrão `HOME` e `GITHUB_WORKSPACE` são exceções a essa convenção porque as palavras "inicial" e "espaço de trabalho" já indicam o local. diff --git a/translations/pt-BR/content/actions/configuring-and-managing-workflows/using-variables-and-secrets-in-a-workflow.md b/translations/pt-BR/content/actions/configuring-and-managing-workflows/using-variables-and-secrets-in-a-workflow.md deleted file mode 100644 index ac4c487f4b1b..000000000000 --- a/translations/pt-BR/content/actions/configuring-and-managing-workflows/using-variables-and-secrets-in-a-workflow.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Usar variáveis e segredos em um fluxo de trabalho -intro: 'Use segredos encriptados, variáveis e tokens no seu fluxo para proteger o seu repositório.' -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/pt-BR/content/actions/getting-started-with-github-actions/about-github-actions.md b/translations/pt-BR/content/actions/getting-started-with-github-actions/about-github-actions.md deleted file mode 100644 index b56520673105..000000000000 --- a/translations/pt-BR/content/actions/getting-started-with-github-actions/about-github-actions.md +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: Sobre ações do GitHub -intro: 'O {% data variables.product.prodname_actions %} permite que você crie fluxos de trabalho personalizados de ciclo de vida de desenvolvimento de software (SDLC, Software Development Life Cycle) diretamente no seu repositório do {% data variables.product.prodname_dotcom %}.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/migrating-github-actions-from-hcl-syntax-to-yaml-syntax/ - - /articles/about-github-actions - - /github/automating-your-workflow-with-github-actions/about-github-actions - - /actions/automating-your-workflow-with-github-actions/about-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Sobre o {% data variables.product.prodname_actions %} - -Fluxos de trabalho do {% data reusables.repositories.about-github-actions %} são processos automatizados personalizados que você pode configurar no repositório para criar, testar, fazer pacotes, gerar versões ou implantar qualquer projeto de código no {% data variables.product.prodname_dotcom %}. - -{% data reusables.repositories.actions-ci-cd %}{% data variables.product.prodname_actions %} aciona o serviço de integração contínua integrado de {% data variables.product.prodname_dotcom %} Para obter mais informações, consulte "[Sobre integração contínua](/articles/about-continuous-integration)". - -Os fluxos de trabalho são executados no Linux, macOS, Windows e contêineres em máquinas hospedadas em {% data variables.product.prodname_dotcom %}, denominadas "executoras". Como alternativa, você também pode hospedar seus próprios executores para executar ou gerenciar fluxos de trabalho em máquinas que você possui. Para obter mais informações, consulte "[Sobre os executores auto-hospedados](/actions/automating-your-workflow-with-github-actions/about-self-hosted-runners)". - -Você pode criar fluxos de trabalho usando ações definidas no seu repositório, ações de código aberto em repositórios públicos no {% data variables.product.prodname_dotcom %} ou imagens de contêiner Docker publicadas. Os fluxos de trabalho em repositórios bifurcados não são executados por padrão. - -É possível descobrir ações a serem usadas no seu fluxo de trabalho no {% data variables.product.prodname_dotcom %} e compilar ações para compartilhar com a comunidade do {% data variables.product.prodname_dotcom %}. Para obter mais informações sobre como criar uma ação personalizada, consulte "[Criando ações"](/actions/creating-actions)". - -Você pode criar um arquivo de fluxo de trabalho configurado para execução em eventos específicos. Para obter mais informações, consulte "[Configurar fluxo de trabalho](/articles/configuring-a-workflow)" e "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions)". - -Para obter uma definição dos termos comuns, consulte "[Conceitos principais para {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)". - -### Descobrir ações na comunidade do {% data variables.product.prodname_dotcom %} - -{% data variables.product.prodname_marketplace %} é um local central para você encontrar, compartilhar e usar ações criadas pela comunidade {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte "[Usando ações de {% data variables.product.prodname_marketplace %} no seu fluxo de trabalho](/actions/automating-your-workflow-with-github-actions/using-actions-from-github-marketplace-in-your-workflow)". - -Você também pode personalizar o seu projeto com ações de código aberto compartilhadas nos repositórios públicos em {% data variables.product.prodname_dotcom %} e usar ações criadas por {% data variables.product.prodname_dotcom %} na organização [ações](https://github.com/actions). - -### Desativar ou limitar {% data variables.product.prodname_actions %} para o seu repositório ou organização - -{% data reusables.github-actions.disabling-github-actions %} - -Para obter mais informações, consulte "[Desabilitar ou limitar {% data variables.product.prodname_actions %} para um repositório](/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository)" ou "[Desabilitar ou limitar {% data variables.product.prodname_actions %} para sua organização](/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization)". - -### Notificações para execução de fluxo de trabalho - -{% data reusables.repositories.workflow-notifications %} - -### Limites de uso - -{% data reusables.github-actions.github-actions-usage-limits %} - -{% if currentVersion == "free-pro-team@latest" %} - -### Política de uso - -Além dos limites de uso, você deve garantir que você usa {% data variables.product.prodname_actions %} nos [Termos de serviço](/articles/github-terms-of-service/) do GitHub. Para obter mais informações sobre termos específicos de {% data variables.product.prodname_actions %}, consulte os [Termos adicionais do produto do GitHub](/github/site-policy/github-additional-product-terms#a-actions-usage). - -### Sobre a cobrança do {% data variables.product.prodname_actions %} - -{% data reusables.github-actions.actions-billing %} Para obter mais informações, consulte "[Sobre a cobrança do {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions)". - -### Entrar em contato com o suporte - -{% data reusables.github-actions.contacting-support %} - -{% endif %} - -### Leia mais - -- [Gerenciar a execução de fluxos de trabalho](/articles/managing-a-workflow-run) -- [Eventos que acionam fluxos de trabalho](/articles/events-that-trigger-workflows) -- "[Ambientes virtuais para executores hospedados em {% data variables.product.prodname_dotcom %}](/actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)" -"[Gerenciar cobrança do {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)" diff --git a/translations/pt-BR/content/actions/getting-started-with-github-actions/core-concepts-for-github-actions.md b/translations/pt-BR/content/actions/getting-started-with-github-actions/core-concepts-for-github-actions.md deleted file mode 100644 index 0bd37b5e0a55..000000000000 --- a/translations/pt-BR/content/actions/getting-started-with-github-actions/core-concepts-for-github-actions.md +++ /dev/null @@ -1,76 +0,0 @@ ---- -title: Conceitos principais para o GitHub Actions -shortTitle: Conceitos principais -intro: 'Abaixo há uma lista de termos comuns de {% data variables.product.prodname_actions %} que usamos em nossos sites e na documentação de {% data variables.product.prodname_actions %}.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions - - /actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Ação - -Tarefas individuais que você combina como etapas para criar um trabalho. As ações são o menor bloco de criação portátil de um fluxo de trabalho. Você pode criar as suas próprias ações, usar ações compartilhadas pela comunidade {% data variables.product.prodname_dotcom %} e personalizar ações públicas. Para usar uma ação em um fluxo de trabalho, você deverá incluí-la como uma etapa. - -### Artefato - -Artefatos são os arquivos que surgem quando você compila e testa seu código. Por exemplo, os artefatos podem incluir arquivos binários ou de pacotes, resultados de testes, capturas de tela ou arquivos de log. Os artefatos são associados à execução do fluxo de trabalho em que foram criados e podem ser usados ou implementados por outro trabalho. - -### Integração contínua (CI) - -A prática de desenvolvimento de software de fazer frequentemente pequenas alterações de código em um repositório compartilhado. Com {% data variables.product.prodname_actions %}, você pode criar fluxos de trabalho personalizados de CI que automatizam a construção e o teste do seu código. Do seu repositório, é possível visualizar o status das alterações do código e os registros detalhados para cada ação no seu fluxo de trabalho. A CI economiza tempo dos desenvolvedores, fornecendo feedback imediato sobre as alterações nos códigos para detectar e resolver erros mais rapidamente. - -### Implementação contínua (CD) - -A implementação contínua tem por base a integração contínua. Quando um novo código é confirmado e é aprovado em seus testes de CI, o código é implementado automaticamente na produção. Com {% data variables.product.prodname_actions %}, você pode criar fluxos de trabalho de CD personalizados para implementar automaticamente seu código em qualquer nuvem, serviço auto-hospedado ou plataforma do seu repositório. A CD economiza tempo dos desenvolvedores automatizando o processo de implementação, além de implementar alterações de código estáveis e testadas mais rapidamente para seus clientes. - -### Evento - -Uma atividade específica que aciona a execução de um fluxo de trabalho. Por exemplo, uma atividade pode originar de {% data variables.product.prodname_dotcom %} quando alguém faz o push de um commit em um repositório ou quando são criados um problema ou um pull request. Também é possível configurar um fluxo de trabalho para ser executado quando um evento externo ocorre usando o webhook de envio do repositório. - -### Executor hospedado em {% data variables.product.prodname_dotcom %} -{% data variables.product.prodname_dotcom %} hospeda executores do Linux, Windows e macOS. Os trabalhos são executados em uma nova instância de uma máquina virtual que inclui software pré-instalado usado comumente. {% data variables.product.prodname_dotcom %} realiza todas as atualizações e manutenção dos executores hospedados em {% data variables.product.prodname_dotcom %}. Você não pode personalizar a configuração de hardware dos executores hospedados no {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte "[Ambientes virtuais para executores hospedados em {% data variables.product.prodname_dotcom %}](/github/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)". - -### Trabalho - -Um conjunto de etapas que são executadas no mesmo executor. É possível definir as regras de dependência para o modo como as tarefas são executadas em um arquivo do fluxo de trabalho. Os trabalhos podem ser executados ao mesmo tempo e em paralelo ou executados em sequência, dependendo do status de um trabalho anterior. Por exemplo, um fluxo de trabalho pode ter dois trabalhos sequenciais que criam e testam códigos. em que o trabalho de teste depende do status do trabalho de criação. Se ocorrer uma falha no trabalho de criação, o trabalho de teste não será executado. Para os executores hospedados em {% data variables.product.prodname_dotcom %}, cada trabalho em um fluxo de trabalho é executado em uma nova instância de um ambiente virtual. - -### Executor - -Qualquer máquina com o aplicativo executor {% data variables.product.prodname_actions %} instalado. Você pode usar um executor hospedado por {% data variables.product.prodname_dotcom %} ou hospedar seu próprio executor. Um executor aguarda trabalhos disponíveis. Quando um executor escolhe um trabalho, ele executa as ações do trabalho e relata o progresso, os registros e os resultados finais para {% data variables.product.prodname_dotcom %}. Os executores executam um trabalho de cada vez. Para obter mais informações, consulte "[executor hospedado em {% data variables.product.prodname_dotcom %}](#github-hosted-runner)" e "[executor auto-hospedado](#self-hosted-runner)". - -{% note %} - -**Observação:** {% data reusables.github-actions.runner-app-open-source %} - -{% endnote %} - -### Executor auto-hospedado - -Uma máquina que você gerencia e mantém com o aplicativo do executor auto-hospedado instalado. {% data reusables.github-actions.self-hosted-runner-description %} Para obter mais informações, consulte "[Hospedando seus próprios executores](/github/automating-your-workflow-with-github-actions/hosting-your-own-runners)". - -### etapa - -Uma etapa é uma tarefa individual que pode executar comandos ou ações. Um trabalho configura uma ou mais etapas. Cada etapa em um trabalho é executada no mesmo executor, o que permite que as ações no trabalho compartilhem informações usando o arquivo do sistema. - -### Ambiente virtual - -O ambiente virtual de um executor hospedado no {% data variables.product.prodname_dotcom %} inclui a configuração de hardware da máquina virtual, sistema operacional e software instalado. Para obter mais informações, consulte "[Ambientes virtuais para executores hospedados em {% data variables.product.prodname_dotcom %}](/github/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)". - -### Fluxo de trabalho - -Um processo automatizado configurável que você pode definir no seu repositório para criar, testar, empacotar, aprovar ou implementar qualquer projeto em {% data variables.product.prodname_dotcom %}. Os fluxos de trabalho são constituídos de um ou mais empregos e podem ser programados ou ativados por um evento. - -### Arquivo do fluxo de trabalho - -O arquivo YAML que define a configuração do fluxo de trabalho com, pelo menos, uma tarefa. Este arquivo vive na raiz do repositório {% data variables.product.prodname_dotcom %} no diretório `.github/workflows`. - -### Execução do fluxo de trabalho - -Uma instância do seu fluxo de trabalho executada quando ocorrem os eventos pré-configurados. Você pode ver os trabalhos, ações, registros e status para cada execução do fluxo de trabalho. diff --git a/translations/pt-BR/content/actions/getting-started-with-github-actions/index.md b/translations/pt-BR/content/actions/getting-started-with-github-actions/index.md deleted file mode 100644 index b5d235729a22..000000000000 --- a/translations/pt-BR/content/actions/getting-started-with-github-actions/index.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: Indrodução ao GitHub Actions -shortTitle: Introdução -intro: 'O {% data variables.product.prodname_actions %} tem um ambiente de execução avançado e integrado a cada etapa do seu fluxo de trabalho. Você pode descobrir, criar e compartilhar o {% data variables.product.prodname_actions %} para fazer qualquer trabalho.' -redirect_from: - - /articles/getting-started-with-github-actions - - /github/automating-your-workflow-with-github-actions/getting-started-with-github-actions - - /actions/automating-your-workflow-with-github-actions/getting-started-with-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -{% topic_link_in_list /overview %} - {% link_in_list /about-github-actions %} - {% link_in_list /core-concepts-for-github-actions %} - {% link_in_list /security-hardening-for-github-actions %} -{% topic_link_in_list /using-community-workflows-and-actions %} - {% link_in_list /starting-with-preconfigured-workflow-templates %} - {% link_in_list /using-actions-from-github-marketplace %} diff --git a/translations/pt-BR/content/actions/getting-started-with-github-actions/overview.md b/translations/pt-BR/content/actions/getting-started-with-github-actions/overview.md deleted file mode 100644 index d3f8199f7bc4..000000000000 --- a/translations/pt-BR/content/actions/getting-started-with-github-actions/overview.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Visão Geral -intro: 'Aprenda mais sobre conceitos e terminologia {% data variables.product.prodname_actions %}.' -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/pt-BR/content/actions/getting-started-with-github-actions/security-hardening-for-github-actions.md b/translations/pt-BR/content/actions/getting-started-with-github-actions/security-hardening-for-github-actions.md deleted file mode 100644 index d2bc6cdf1ade..000000000000 --- a/translations/pt-BR/content/actions/getting-started-with-github-actions/security-hardening-for-github-actions.md +++ /dev/null @@ -1,93 +0,0 @@ ---- -title: Fortalecimento de segurança para o GitHub Actions -shortTitle: Fortalecimento de segurança -intro: 'Boas práticas de segurança para usar recursos do {% data variables.product.prodname_actions %}.' -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -Este guia explica como configurar o fortalecimento de segurança para certos recursos de {% data variables.product.prodname_actions %}. Se os conceitos do {% data variables.product.prodname_actions %} forem desconhecidos, consulte "[Principais conceitos para o GitHub Actions](/actions/getting-started-with-github-actions/core-concepts-for-github-actions) - -### Usar segredos - -Valores sensíveis nunca devem ser armazenados como texto simples em arquivos de fluxo de trabalho, mas como segredos. [Os segredos](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets) podem ser configurados no nível da organização ou do repositório e permitem que você armazene informações confidenciais em {% data variables.product.product_name %}. - -Os segredos usam [caixas fechadas de Libsodium](https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes) de modo que sejam criptografadas antes de atingir {% data variables.product.product_name %}. Isso ocorre quando o segredo é enviado [usando a interface de usuário](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets#creating-encrypted-secrets-for-a-repository) ou através da [API REST](/rest/reference/actions#secrets). Esta criptografia do lado do cliente ajuda a minimizar os riscos relacionados ao registro acidental (por exemplo, registros de exceções e de solicitação, entre outros) dentro da infraestrutura do {% data variables.product.product_name %}. Uma vez realizado o upload do segredo, o {% data variables.product.product_name %} poderá descriptografá-lo para que possa ser injetado no tempo de execução do fluxo de trabalho. - -Para ajudar a prevenir a divulgação acidental, o {% data variables.product.product_name %} usa um mecanismo que tenta redigir quaisquer segredos que aparecem nos registros de execução. Esta redação procura correspondências exatas de quaisquer segredos configurados, bem como codificações comuns dos valores, como Base64. No entanto, como há várias maneiras de transformar o valor de um segredo, essa anulação não é garantida. Como resultado, existem certas etapas proativas e boas práticas que você deve seguir para ajudar a garantir que os segredos sejam editados, e para limitar outros riscos associados aos segredos: - -- **Nunca usar dados estruturados como um segredo** - - Os dados não estruturados podem fazer com que ocorra uma falha na redação secreta nos registros, porque a redação depende, em grande parte, de encontrar uma correspondência exata para o valor específico do segredo. Por exemplo, não use um blob de JSON, XML, ou YAML (ou similar) para encapsular o valor de um segredo, já que isso reduz significativamente a probabilidade de os segredos serem devidamente redigidos. Em vez disso, crie segredos individuais para cada valor sensível. -- **Registre todos os segredos usados nos fluxos de trabalho** - - Se um segredo for usado para gerar outro valor sensível dentro de um fluxo de trabalho, esse valor gerado deve ser formalmente [registrado como um segredo](https://github.com/actions/toolkit/tree/master/packages/core#setting-a-secret) para que seja reproduzido se alguma vez aparecer nos registros. Por exemplo, se, ao usar uma chave privada para gerar um JWT assinado para acessar uma API web, certifique-se de registrar que JWT é um segredo ou não será redigido se entrar na saída de do registro. - - O registro de segredos também aplica-se a qualquer tipo de transformação/codificação. Se seu segredo foi transformado de alguma forma (como Base64 ou URL codificada), certifique-se de registrar o novo valor como um segredo também. -- **Audite como segredos são tratados** - - Audite como os segredos são usados, para ajudar a garantir que estejam sendo tratados conforme o esperado. Você pode fazer isso revisando o código-fonte do repositório que executa o fluxo de trabalho e verificando quaisquer ações usadas no fluxo de trabalho. Por exemplo, verifique se eles não são enviados para hosts não pretendidos, ou impressos explicitamente na saída de um registro. - - Visualize os registros de execução do seu fluxo de trabalho depois de testar entradas válidas/inválidas e, em seguida, verifique se os segredos estão sendo editados corretamente ou não são mostrados. Nem sempre é sempre óbvio como um comando ou ferramenta que você está invocando irá enviar erros para `STDOUT` e `STDERR`, e os segredos podem depois acabar em registros de erro. Como resultado, considera-se uma boa prática rever manualmente os registros do fluxo de trabalho depois de testar entradas válidas e inválidas. -- **Use as credenciais que tenham escopos mínimos** - - Certifique-se de que as credenciais usadas nos fluxos de trabalho têm o menor privilégio necessário e esteja ciente de que qualquer usuário com acesso de gravação ao repositório terá acesso de leitura a todos os segredos configurados no seu repositório. -- **Audite e gire os segredos registrados** - - Reveja, periodicamente, os segredos registrados para confirmar se ainda são necessários. Remova aqueles que não são mais necessários. - - Gire os segredos periodicamente para reduzir a janela de tempo durante a qual um segredo comprometido é válido. - -### Usando ações de terceiros - -Os trabalhos individuais em fluxo de trabalho podem interagir com (e comprometer) outros trabalhos. Por exemplo, um trabalho que consulta as variáveis de ambiente usadas por um trabalho posterior, que escreve arquivos para um diretório compartilhado que um trabalho posterior processa, ou ainda mais diretamente, que interage com o conector do Docker e inspeciona outros contêineres em execução e executa comandos neles. - -Isso significa que comprometer uma única ação dentro de um fluxo de trabalho pode ser muito significativo, uma vez que essa ação comprometida teria acesso a todos os segredos configurados no seu repositório e pode usar o `GITHUB_TOKEN` para gravar no repositório. Consequentemente, há um risco significativo em fornecer de ações de repositórios de terceiros no {% data variables.product.prodname_dotcom %}. Você pode ajudar a mitigar esse risco seguindo estas boas práticas: - -* **Fixe as ações para um commit SHA de comprimento completo** - - Fixar uma ação para um commit SHA de comprimento completo é, atualmente, a única maneira de usar uma ação como uma versão imutável. Fixar um SHA em particular ajuda a mitigar o risco de um ator malicioso adicionar uma porta traseira ao repositório da ação, porque precisariam gerar uma colisão de SHA-1 para uma carga válida do objeto de Git. - - {% warning %} - - **Aviso:** A versão curta do commit SHA é insegura e nunca deve ser usada para especificar a referência do Git de uma ação. Devido ao modo como funcionam as redes de repositório, qualquer usuário pode bifurcar o repositório e fazer push de um commit criado que colida com o SHA curto. Isso faz com que os clones subsequentes falhem nesse SHA, pois se converte em um commit ambíguo. Como resultado, todos os fluxos de trabalho que usam o SHA encurtado falharão imediatamente. - - {% endwarning %} -* **Audite o código-fonte da ação** - - Certifique-se de que a ação está tratando o conteúdo do seu repositório e os segredos, como esperado. Por exemplo, verifique se os segredos não são enviados para os hosts não intencionais, ou se não são registrados inadvertidamente. - -* **Fixe ações em uma etiqueta apenas se confiar no criador** - - Embora a fixação de um commit de SHA seja a opção mais segura, especificar uma etiqueta é a opção mais conveniente, além de ser amplamente usada. Se você desejar de especificar uma etiqueta, certifique-se de que você confia nos criadores da ação. O selo "Criador verificado" em {% data variables.product.prodname_marketplace %} é um sinal útil, já que indica que a ação foi escrita por uma equipe cuja identidade foi verificada por {% data variables.product.prodname_dotcom %}. Observe que há risco para esta abordagem, mesmo que você confie no autor, porque uma etiqueta pode ser movida ou excluída se um ator malicioso obtiver acesso ao repositório que armazena a ação. - -### Considerar acesso entre repositórios - -O {% data variables.product.product_name %} tem um escopo intencional para um único repositório por vez. O `GITHUB_TOKEN` usado no ambiente de fluxo de trabalho concede o mesmo nível de acesso que um usuário com acesso de gravação, porque qualquer usuário com acesso de gravação pode acessar esse token criando ou modificando arquivos de fluxo de trabalho. Os usuários têm permissões específicas para cada repositório. Portanto, fazer com que o `GITHUB_TOKEN` para um repositório conceda acesso a outro impactaria o modelo de permissão {% data variables.product.prodname_dotcom %} se não for implementado cuidadosamente. Da mesma forma, deve-se ter cuidado ao adicionar tokens de autenticação do {% data variables.product.prodname_dotcom %} ao ambiente do fluxo de trabalho, porque isto também pode afetar o modelo de permissão de {% data variables.product.prodname_dotcom %} concedendo, inadvertidamente, amplo acesso aos colaboradores. - -Temos [ um plano no roteiro de {% data variables.product.prodname_dotcom %}](https://github.com/github/roadmap/issues/74) para suportar um fluxo que permite o acesso de todos os repositórios em {% data variables.product.product_name %}, embora ainda não seja um recurso compatível. Atualmente, a única maneira de executar interações privilegiadas entre repositórios é colocar um token de autenticação do {% data variables.product.prodname_dotcom %} ou chave SSH como um segredo dentro do ambiente de fluxo de trabalho. Uma vez que muitos tipos de token de autenticação não permitem acesso granular a recursos específicos, há um risco significativo no uso do tipo incorreto de token, pois ele pode conceder acesso muito mais amplo do que o pretendido. - -Esta lista descreve as abordagens recomendadas para acessar os dados do repositório dentro de um fluxo de trabalho, em ordem decrescente de preferência: - -1. **O `GITHUB_TOKEN` no ambiente de fluxo de trabalho** - - Este token tem um escopo intencional para o único repositório que invocou o fluxo de trabalho, e tem o mesmo nível de acesso que um usuário de acesso de gravação no repositório. O token é criado antes de cada trabalho começar e expira quando o trabalho é finalizado. Para obter mais informações, consulte "[Autenticação com o GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)". - - O `GITHUB_TOKEN` deve ser usado sempre que possível. -2. **Chave de implantação do repositório** - - Chaves de implantação são um dos únicos tipos de credenciais que concedem acesso de leitura ou gravação a um único repositório, e podem ser usadas para interagir com outro repositório dentro de um fluxo de trabalho. Para obter mais informações, consulte "[Gerenciar chaves de implantação](/developers/overview/managing-deploy-keys#deploy-keys)". - - Observe que as chaves de implantação só podem clonar e fazer push para o repositório usando o Git, e não podem ser usada para interagir com a API REST ou o GraphQL. Portanto, elas podem não ser apropriadas para os suas necessidades. -3. **Tokens de {% data variables.product.prodname_github_app %}** - - {% data variables.product.prodname_github_apps %} podem ser instalados em repositórios selecionados e até mesmo ter permissões granulares nos recursos dentro deles. É possível criar um {% data variables.product.prodname_github_app %} interno na sua organização, instalá-lo nos repositórios os quais você precisa acessar dentro do seu fluxo de trabalho, e autenticar como instalação dentro de seu fluxo de trabalho para acessar esses repositórios. -4. **Tokens de acesso pessoal** - - Você nunca deve usar tokens de acesso pessoais da sua própria conta. Esses tokens concedem acesso a todos os repositórios nas organizações às quais você tem acesso, bem como a todos os repositórios pessoais na sua conta de usuário. Isto concede indiretamente amplo acesso a todos os usuários com acesso de gravação do repositório no qual se encontra o fluxo de trabalho. Além disso, se você deixar uma organização mais adiante, os fluxos de trabalho que usam este token falharão imediatamente e a depuração deste problema pode ser difícil. - - Se um token de acesso pessoal for usado, ele deverá ser gerado para uma nova conta que só tenha acesso aos repositórios específicos necessários para o fluxo de trabalho. Observe que esta abordagem não é escalável e deve ser evitada em detrimento de alternativas, como as chaves de implantação. -5. **Chaves SSH em uma conta de usuário** - - Os fluxos de trabalho nunca devem usar as chaves SSH em uma conta de usuário. Semelhante aos tokens de acesso pessoais, eles concedem permissões de leitura/gravação a todos os seus repositórios pessoais, bem como a todos os repositórios aos quais você tem acesso por meio da associação à organização. Isto concede indiretamente amplo acesso a todos os usuários com acesso de gravação do repositório no qual se encontra o fluxo de trabalho. Se você pretende usar uma chave SSH porque você só precisa executar clones ou push do repositório, e não precisar interagir com APIs públicas, você deverá usar chaves de implantação individuais. - -### Fortalecimento para executores auto-hospedados - -Os executores ** hospedados em {% data variables.product.prodname_dotcom %}** executam o código dentro de máquinas virtuais efêmeras e limpas e isoladas. Isso quer isto dizer que não há maneira de comprometer persistentemente este ambiente ou obter, de outra forma, acesso a mais informações do que foram colocadas neste ambiente durante o processo de inicialização. - -Executores **auto-hospedados** em {% data variables.product.product_name %} não têm garantias com relação ao funcionamento em máquinas virtuais limpas efêmeras e podem ser persistentemente comprometidos por código não confiável em um fluxo de trabalho. - -Como resultado, os executores auto-hospedados quase [nunca devem ser usados para repositórios públicos](/actions/hosting-your-own-runners/about-self-hosted-runners#self-hosted-runner-security-with-public-repositories) em {% data variables.product.product_name %}, porque qualquer usuário pode abrir pull requests contra o repositório e comprometer o ambiente. Da mesma forma, tenha cuidado ao usar executores auto-hospedados em repositórios privados, uma vez que qualquer pessoa que possa bifurcar o repositório e abrir um PR (geralmente aqueles com acesso de leitura ao repositório) são capazes de comprometer o ambiente de executores auto-hospedados, incluindo a obtenção de acesso a segredos e `GITHUB_TOKEN` mais privilegiado, que concede permissões de gravação no repositório. - -Você também deve considerar o ambiente das máquinas de executores auto-hospedadas: -- Que informação sensível reside na máquina configurada como um executor auto-hospedado? Por exemplo, chaves SSH privadas, tokens de acesso à API, entre outros. -- A máquina tem acesso à rede a serviços sensíveis? Por exemplo, serviços de metadados do Azure ou AWS. A quantidade de informações confidenciais neste ambiente deve ser limitada ao mínimo, e você deve estar sempre ciente de que qualquer usuário capaz de invocar fluxos de trabalho terá acesso a esse ambiente. diff --git a/translations/pt-BR/content/actions/getting-started-with-github-actions/starting-with-preconfigured-workflow-templates.md b/translations/pt-BR/content/actions/getting-started-with-github-actions/starting-with-preconfigured-workflow-templates.md deleted file mode 100644 index 3af5b1e243b8..000000000000 --- a/translations/pt-BR/content/actions/getting-started-with-github-actions/starting-with-preconfigured-workflow-templates.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: Começando com modelos de fluxo de trabalho pré-configurados -intro: 'O {% data variables.product.prodname_dotcom %} fornece modelos de fluxo de trabalho pré-configurados para automatizar seu fluxo de trabalho ou criar um fluxo de trabalho de CI para idiomas e estruturas específicos.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/starting-with-preconfigured-workflow-templates -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Sobre os modelos do fluxo de trabalho - -O {% data variables.product.product_name %} analisa seu código e mostra os modelos de CI mais adequados para o seu repositório. Por exemplo, se o seu repositório contiver o código Node.js, você verá sugestões para projetos Node.js. Você pode usar os modelos do fluxo de trabalho como um ponto de partida para criar o fluxo de trabalho personalizado ou usá-los como se apresentam. - -Você pode pesquisar a lista completa de modelos de CI no repositório [ações/fluxos de trabalho de início](https://github.com/actions/starter-workflows/tree/master/ci). Também é possível encontrar modelos para automatizar seu fluxo de trabalho. Também é possível encontrar modelos para automatizar seu fluxo de trabalho. - -### Adicionar seu primeiro modelo de fluxo de trabalho - -Se você ainda não adicionou um fluxo de trabalho ao seu repositório, você verá uma lista de modelos de fluxo de trabalho para escolher. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.actions-set-up-workflow-template %} - -### Adicionar outros modelos do fluxo de trabalho - -Se você já tiver um fluxo de trabalho e desejar adicionar um novo modelo do fluxo de trabalho, você poderá navegar até os modelos de fluxo de trabalho. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.actions-new-workflow %} -{% data reusables.repositories.actions-set-up-workflow-template %} diff --git a/translations/pt-BR/content/actions/getting-started-with-github-actions/using-actions-from-github-marketplace.md b/translations/pt-BR/content/actions/getting-started-with-github-actions/using-actions-from-github-marketplace.md deleted file mode 100644 index 9f09341c182c..000000000000 --- a/translations/pt-BR/content/actions/getting-started-with-github-actions/using-actions-from-github-marketplace.md +++ /dev/null @@ -1,51 +0,0 @@ ---- -title: Usar ações do GitHub Marketplace -intro: 'Você pode pesquisar ações em {% data variables.product.prodname_marketplace %} para usar nos seus fluxos de trabalho.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/using-github-marketplace-actions - - /actions/automating-your-workflow-with-github-actions/using-actions-from-github-marketplace-in-your-workflow -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Sobre ações em {% data variables.product.prodname_marketplace %} - -{% data variables.product.prodname_marketplace %} é um local central para você encontrar ações criadas pela comunidade de {% data variables.product.prodname_dotcom %}. Ações com um selo que indicam {% data variables.product.prodname_dotcom %} verificou o criador da ação como uma organização parceira. - -{% data reusables.actions.enterprise-marketplace-actions %} - -Você pode descobrir novas ações no editor do fluxo de trabalho em {% data variables.product.prodname_dotcom %} e na página [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace/actions/). - -Visualizar as ações diretamente no editor do fluxo de trabalho fornece um acesso rápido para todas as ações em {% data variables.product.prodname_marketplace %}. A página de ações {% data variables.product.prodname_marketplace %} oferece mais flexibilidade para filtrar ações por categoria. - -### Procurar ações no editor do fluxo de trabalho - -Você pode pesquisar ações diretamente no seu editor do seu fluxo de trabalho do repositório. Na barra lateral, você pode pesquisar uma ação específica, visualizar ações em destaque e pesquisar categorias em destaque. Você também pode visualizar o número de estrelas que uma ação recebeu da comunidade {% data variables.product.prodname_dotcom %}. - -1. No seu repositório, pesquise o arquivo do fluxo de trabalho que você deseja editar. -1. No canto superior direito da vista do arquivo, clique em {% octicon "pencil" aria-label="The edit icon" %} para abrir o editor do fluxo de trabalho. ![Edite o botão do arquivo do fluxo de trabalho](/assets/images/help/repository/actions-edit-workflow-file.png) -1. No lado direito do editor, use a barra lateral {% data variables.product.prodname_marketplace %} para procurar ações. ![Barra lateral do fluxo de trabalho do Marketplace](/assets/images/help/repository/actions-marketplace-sidebar.png) - -### Procurar ações em {% data variables.product.prodname_marketplace %} - -Você pode encontrar as mesmas ações na página de ações [{% data variables.product.prodname_marketplace %} ](https://github.com/marketplace/actions/). Na página {% data variables.product.prodname_marketplace %}, você tem mais flexibilidade para filtrar as ações por categoria e verificação. - -### Adicionar uma ação ao seu fluxo de trabalho a partir do editor fluxo de trabalho - -Uma página de lista de ações incluem a versão da ação e a sintaxe do fluxo de trabalho necessárias para usar a ação. - -1. Navegue para a ação que você deseja usar no seu fluxo de trabalho. -1. Em "Instalação", clique em {% octicon "clippy" aria-label="The edit icon" %} para copiar a sintaxe do fluxo de trabalho. ![Visualizar lista de ação](/assets/images/help/repository/actions-sidebar-detailed-view.png) -1. Cole a sintaxe como uma nova etapa no seu fluxo de trabalho. Para obter mais informações, consulte a sintaxe "[ para {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idsteps)." -1. Se a ação exigir que você forneça variáveis, defina-as no seu fluxo de trabalho. Para obter informações sobre quais variáveis uma ação pode exigir, consulte a lista completa da ação em {% data variables.product.prodname_marketplace %}. - -{% if currentVersion == "free-pro-team@latest" %} - -{% data reusables.dependabot.version-updates-for-actions %} - -{% endif %} diff --git a/translations/pt-BR/content/actions/getting-started-with-github-actions/using-community-workflows-and-actions.md b/translations/pt-BR/content/actions/getting-started-with-github-actions/using-community-workflows-and-actions.md deleted file mode 100644 index 48d6754ad45b..000000000000 --- a/translations/pt-BR/content/actions/getting-started-with-github-actions/using-community-workflows-and-actions.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Usar fluxos de trabalho e ações da comunidade -intro: 'Use ações e fluxos de trabalho criados por outras pessoas e organizações, incluindo {% data variables.product.prodname_dotcom %}.' -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/pt-BR/content/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners.md b/translations/pt-BR/content/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners.md deleted file mode 100644 index 486d46a0494c..000000000000 --- a/translations/pt-BR/content/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: Gerenciar o acesso aos executores auto-hospedados -intro: Você pode controlar quais repositórios podem enviar trabalhos para os executores auto-hospedados de uma organização. -versions: - free-pro-team: '*' ---- - -Os executores auto-hospedados adicionados no nível da organização podem processar trabalhos para todos os repositórios na organização. Se você precisar limitar o acesso aos seus executores auto-hospedados, você poderá configurar a política para processar apenas trabalhos em repositórios privados ou você pode definir uma lista de repositórios permitidos. - -### Controlar quais repositórios têm acesso aos executores de uma organização - -{% data reusables.organizations.navigate-to-org %} -{% data reusables.organizations.org_settings %} -{% data reusables.organizations.settings-sidebar-actions %} -1. Ao lado de "executores auto-hospedados", clique em **Gerenciar permissões do repositório**. ![Gerenciar permissões do repositório](/assets/images/help/settings/actions-runner-manage-permissions.png) - -1. No menu suspenso, escolha uma das opções a seguir: - - * **Todos os repositórios** - Todos os repositórios públicos e privados da organização podem enviar trabalhos para os executores auto-hospedados da organização. - * **Repositórios privados** - Somente repositórios privados da organização podem enviar trabalhos para os executores auto-hospedados da organização. - * **Repositórios selecionados** - Use o menu de seleção do repositório para escolher quais repositórios na organização podem enviar trabalhos para os executores auto-hospedados da organização. diff --git a/translations/pt-BR/content/actions/language-and-framework-guides/building-and-testing-java-with-ant.md b/translations/pt-BR/content/actions/language-and-framework-guides/building-and-testing-java-with-ant.md deleted file mode 100644 index 5cfb1365aacc..000000000000 --- a/translations/pt-BR/content/actions/language-and-framework-guides/building-and-testing-java-with-ant.md +++ /dev/null @@ -1,107 +0,0 @@ ---- -title: Criar e estar o Java com o Ant -intro: Você pode criar um fluxo de trabalho de integração contínua (CI) no GitHub Actions para criar e testar o seu projeto Java com o Ant. -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Introdução - -Este guia mostra como criar um fluxo de trabalho que realiza a integração contínua (CI) para o seu projeto Java usando o sistema de criação do Ant. O fluxo de trabalho que você criar permitirá que você veja quando commits em um pull request gerarão falhas de criação ou de teste em comparação com o seu branch-padrão. Essa abordagem pode ajudar a garantir que seu código seja sempre saudável. Você pode estender seu fluxo de trabalho de CI para enviar artefatos a partir da execução de um fluxo de trabalho. - -Os executores hospedados em {% data variables.product.prodname_dotcom %} têm uma cache de ferramentas com com software pré-instalado, que inclui kits de desenvolvimento Java (JDKs) e Ant. Para obter uma lista do software e das versões pré-instaladas para JDK e Ant, consulte "[Software instalado em executores hospedados em {% data variables.product.prodname_dotcom %}](/actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners)". - -### Pré-requisitos - -Você deve estar familiarizado com o YAML e a sintaxe do {% data variables.product.prodname_actions %}. Para obter mais informações, consulte: -- "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)" -- "[Configurando um fluxo de trabalho](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)" - -Recomendamos que você tenha um entendimento básico da estrutura do Java e do Ant. Para obter mais informações, consulte o [Manual do Apache Ant](https://ant.apache.org/manual/). - -{% data reusables.actions.enterprise-setup-prereq %} - -### Introdução com o modelo do fluxo de trabalho do Ant - -{% data variables.product.prodname_dotcom %} fornece um modelo de fluxo de trabalho Ant que funcionará para a maioria dos projetos Java baseados no Ant. Para obter mais informações, consulte o [modelo do fluxo de trabalho do Ant](https://github.com/actions/starter-workflows/blob/master/ci/ant.yml). - -Para começar rapidamente, você pode escolher o modelo do Ant pré-configurado ao criar um novo fluxo de trabalho. Para obter mais informações, consulte "[Iniciando com modelos de fluxo de trabalho pré-configurados](/actions/automating-your-workflow-with-github-actions/starting-with-preconfigured-workflow-templates)". - -Você também pode adicionar este fluxo de trabalho manualmente, criando um novo arquivo no diretório `.github/workflows` do seu repositório. - -{% raw %} -```yaml -nome: Java CI - -em: [push] - -trabalho: - build: - runs-on: ubuntu-latest - - etapa: - - usa: actions/checkout@v2 - - nome: Configure JDK 1. - uso: actionp-java@v1 - com: - java-version: 1. - - nome: Construir com Ant - executar: ant -noinput -buildfile build.xml -``` -{% endraw %} - -Este fluxo de trabalho executa os seguintes passos: - -1. O `checkout` faz o download de uma cópia do seu repositório no executor. -2. A etapa `setup-java` configura o Java 1.8 JDK. -3. A etapa "Criar com Ant" executa o alvo-padrão em seu `build.xml` de modo não interativo. - -Os modelos-padrão do fluxo de trabalho são excelentes pontos de partida ao criar seu fluxo de trabalho de compilação e teste, e você pode personalizar o modelo para atender às necessidades do seu projeto. - -{% data reusables.github-actions.example-github-runner %} - -{% data reusables.github-actions.java-jvm-architecture %} - -### Criar e testar seu código - -Você pode usar os mesmos comandos usados localmente para criar e testar seu código. - -O fluxo de trabalho inicial executará o alvo-padrão especificado no arquivo _build.xml_. Seu alvo-padrão será comumente definido para criar classes, executar testes e classes de pacote em seu formato distribuível como, por exemplo, um arquivo JAR. - -Se você usa comandos diferentes para criar seu projeto ou se você quer executar um alvo diferente, você poderá especificá-los. Por exemplo, você pode desejar executar o `jar` alvo configurado no arquivo _build-ci.xml_. - -{% raw %} -```yaml -etapas: - - usa: actions/checkout@v2 - - usa: actions/setup-java@v1 - com: - java-version: 1.8 - - nome: Executa o alvo do Ant jar - executa: ant -noinput -buildfile build-ci.xml jar -``` -{% endraw %} - -### Empacotar dados do fluxo de trabalho como artefatos - -Após a sua criação ter sido criada com sucesso e os seus testes aprovados, é possível que você deseje fazer o upload dos Java resultantes como um artefato de criação. Isso armazenará os pacotes criados como parte da execução do fluxo de trabalho e permitirá que você faça o download desses pacotes. Os artefatos podem ajudá-lo a testar e depurar os pull requests no seu ambiente local antes de serem mesclados. Para obter mais informações, consulte "[Dados recorrentes do fluxo de trabalho que usam artefatos](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)". - -De modo geral, o Ant cria arquivos de saída como JARs, EARs ou WARs no diretório `build/jar`. Você pode fazer upload do conteúdo desse diretório usando a ação `upload-artefact`. - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - - run: ant -noinput -buildfile build.xml - - uses: actions/upload-artifact@v2 - with: - name: Package - path: build/jar -``` -{% endraw %} diff --git a/translations/pt-BR/content/actions/language-and-framework-guides/building-and-testing-java-with-gradle.md b/translations/pt-BR/content/actions/language-and-framework-guides/building-and-testing-java-with-gradle.md deleted file mode 100644 index 83788592d43e..000000000000 --- a/translations/pt-BR/content/actions/language-and-framework-guides/building-and-testing-java-with-gradle.md +++ /dev/null @@ -1,132 +0,0 @@ ---- -title: Criar e estar o Java com o Gradle -intro: Você pode criar um fluxo de trabalho de integração contínua (CI) no GitHub Actions para criar e testar o seu projeto Java com o Gradle. -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Introdução - -Este guia mostra como criar um fluxo de trabalho que realiza a integração contínua (CI) para o seu projeto Java usando o sistema de criação do Gradle. O fluxo de trabalho que você criar permitirá que você veja quando commits em um pull request gerarão falhas de criação ou de teste em comparação com o seu branch-padrão. Essa abordagem pode ajudar a garantir que seu código seja sempre saudável. Você pode estender seu fluxo de trabalho de CI para memorizar arquivos e fazer o upload de artefatos a partir da execução de um fluxo de trabalho. - -Os executores hospedados em {% data variables.product.prodname_dotcom %} têm uma cache de ferramentas com com software pré-instalado, que inclui kits de desenvolvimento Java (JDKs) e Gradle. Para obter uma lista do software e das versões pré-instaladas para JDK e Gradle, consulte "[Software instalado em executores hospedados em {% data variables.product.prodname_dotcom %}](/actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners)". - -### Pré-requisitos - -Você deve estar familiarizado com o YAML e a sintaxe do {% data variables.product.prodname_actions %}. Para obter mais informações, consulte: -- "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)" -- "[Configurando um fluxo de trabalho](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)" - -Recomendamos que você tenha um entendimento básico da estrutura do Java e do Gradle. Para obter mais informações, consulte "[Introdução](https://docs.gradle.org/current/userguide/getting_started.html)" na documentação do Gradle. - -{% data reusables.actions.enterprise-setup-prereq %} - -### Introdução com um modelo de fluxo de trabalho do Gradle - -{% data variables.product.prodname_dotcom %} fornece um modelo de fluxo de trabalho Gradle que funcionará para a maioria dos projetos Java baseados no Gradle. Para obter mais informações, consulte o [modelo do fluxo de trabalho do Gradle](https://github.com/actions/starter-workflows/blob/master/ci/gradle.yml). - -Para começar rapidamente, você pode escolher o modelo do Gradle pré-configurado ao criar um novo fluxo de trabalho. Para obter mais informações, consulte "[Iniciando com modelos de fluxo de trabalho pré-configurados](/actions/automating-your-workflow-with-github-actions/starting-with-preconfigured-workflow-templates)". - -Você também pode adicionar este fluxo de trabalho manualmente, criando um novo arquivo no diretório `.github/workflows` do seu repositório. - -{% raw %} -```yaml -nome: Java CI - -em: [push] - -trabalhos: - criar: - runs-on: ubuntu-latest - - etapas: - - usa: actions/checkout@v2 - - nome: Set up JDK 1.8 - usa: actions/setup-java@v1 - com: - java-version: 1.8 - - nome: Criar com Gradle - executar: ./gradlew build -``` -{% endraw %} - -Este fluxo de trabalho executa os seguintes passos: - -1. O `checkout` faz o download de uma cópia do seu repositório no executor. -2. A etapa `setup-java` configura o Java 1.8 JDK. -3. A etapa "Criar com Gradle" executa o script wrapper `gradlew` para garantir que o seu código seja criado, o seu teste seja aprovado e que seja possível criar um pacote. - -Os modelos-padrão do fluxo de trabalho são excelentes pontos de partida ao criar seu fluxo de trabalho de compilação e teste, e você pode personalizar o modelo para atender às necessidades do seu projeto. - -{% data reusables.github-actions.example-github-runner %} - -{% data reusables.github-actions.java-jvm-architecture %} - -### Criar e testar seu código - -Você pode usar os mesmos comandos usados localmente para criar e testar seu código. - -O fluxo de tarbalho inicial executará a tarefa `criar` por padrão. Na configuração-padrão do Gradle, este comando irá baixar dependências, criar classes, executar testes e classes de pacotes em seu formato distribuível, como, por exemplo, um arquivo JAR. - -Se você usa comandos diferentes para criar seu projeto ou se você desejar usar uma atividade diferente, você poderá especificá-los. Por exemplo, é possível que você deseje executar a tarefa `pacote` configurada no seu arquivo _ci.gradle_. - -{% raw %} -```yaml -etapas: - - usa: actions/checkout@v2 - - ususaes: actions/setup-java@v1 - com: - java-version: 1.8 - - Nome: Executa a tarefa do pacote do Gradle - executar: ./gradlew -b ci.gradle package -``` -{% endraw %} - -### Memorizar dependências - -Você pode armazenar as suas dependências para acelerar as execuções do seu fluxo de trabalho. Após a conclusão bem-sucedida, a sua cache do pacote do Gradle local será armazenada na infraestrutura do GitHub Actions. Para os fluxos de trabalho futuros, a cache será restaurada para que as dependências não precisem ser baixadas dos repositórios de pacotes remotos. Para obter mais informações, consulte "[Memorizando dependências para acelerar os fluxos de trabalho](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)" e a ação [`cache`](https://github.com/marketplace/actions/cache). - -{% raw %} -```yaml -etapas: - - usa: actions/checkout@v2 - - nome: Set up JDK 1.8 - usa: actions/setup-java@v1 - com: - java-version: 1.8 - - nome: Cache Gradle packages - usa: actions/cache@v2 - com: - caminho: ~/.gradle/caches - Chave: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle') }} - restore-keys: ${{ runner.os }}-gradle - - Nome: Criar com Gradle - executar: ./gradlew build -``` -{% endraw %} - -Este fluxo de trabalho salvará o conteúdo da sua cache local do pacote Gradle, localizado no diretório `.gradle/caches` do diretório principal do executor. A chave da cache será o conteúdo em hash dos arquivos de criação do Gradle. Portanto, suas alterações irão invalidar a cache. - -### Empacotar dados do fluxo de trabalho como artefatos - -Após a sua criação ter sido criada com sucesso e os seus testes aprovados, é possível que você deseje fazer o upload dos Java resultantes como um artefato de criação. Isso armazenará os pacotes criados como parte da execução do fluxo de trabalho e permitirá que você faça o download desses pacotes. Os artefatos podem ajudá-lo a testar e depurar os pull requests no seu ambiente local antes de serem mesclados. Para obter mais informações, consulte "[Dados recorrentes do fluxo de trabalho que usam artefatos](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)". - -De modo geral, o Gradle cria arquivos de saída como JARs, EARs ou WARs no diretório `build/libs`. Você pode fazer upload do conteúdo desse diretório usando a ação `upload-artefact`. - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - - run: ./gradlew build - - uses: actions/upload-artifact@v2 - with: - name: Package - path: build/libs -``` -{% endraw %} diff --git a/translations/pt-BR/content/actions/language-and-framework-guides/building-and-testing-java-with-maven.md b/translations/pt-BR/content/actions/language-and-framework-guides/building-and-testing-java-with-maven.md deleted file mode 100644 index f5b6e38c3799..000000000000 --- a/translations/pt-BR/content/actions/language-and-framework-guides/building-and-testing-java-with-maven.md +++ /dev/null @@ -1,133 +0,0 @@ ---- -title: Criar e estar o Java com o Maven -intro: Você pode criar um fluxo de trabalho de integração contínua (CI) no GitHub Actions para criar e testar o seu projeto Java com o Maven. -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Introdução - -Este guia mostra como criar um fluxo de trabalho que realiza a integração contínua (CI) para o seu projeto Java usando a ferramenta de gerenciamento de projeto do software Maven. O fluxo de trabalho que você criar permitirá que você veja quando commits em um pull request gerarão falhas de criação ou de teste em comparação com o seu branch-padrão. Essa abordagem pode ajudar a garantir que seu código seja sempre saudável. Você pode estender seu fluxo de trabalho de CI para memorizar arquivos e fazer o upload de artefatos a partir da execução de um fluxo de trabalho. - -Os executores hospedados em {% data variables.product.prodname_dotcom %} têm uma cache de ferramentas com um software pré-instalado, que inclui kits de desenvolvimento Java (JDKs) e Maven. Para obter uma lista do software e das versões pré-instaladas para JDK e Maven, consulte "[Software instalado em executores hospedados em {% data variables.product.prodname_dotcom %}](/actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners)". - -### Pré-requisitos - -Você deve estar familiarizado com o YAML e a sintaxe do {% data variables.product.prodname_actions %}. Para obter mais informações, consulte: -- "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)" -- "[Configurando um fluxo de trabalho](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)" - -Recomendamos que você tenha um entendimento básico da estrutura do Java e do Maven. Para obter mais informações, consulte "[Guia de introdução ao Maven](http://maven.apache.org/guides/getting-started/index.html)" na documentação do Maven. - -{% data reusables.actions.enterprise-setup-prereq %} - -### Introdução com um modelo de fluxo de trabalho do Maven - -{% data variables.product.prodname_dotcom %} fornece um modelo de fluxo de trabalho Maven que funcionará para a maioria dos projetos Java baseados no Maven. Para obter mais informações, consulte o [modelo do fluxo de trabalho do Maven](https://github.com/actions/starter-workflows/blob/master/ci/maven.yml). - -Para começar rapidamente, você pode escolher o modelo do Maven pré-configurado ao criar um novo fluxo de trabalho. Para obter mais informações, consulte "[Iniciando com modelos de fluxo de trabalho pré-configurados](/actions/automating-your-workflow-with-github-actions/starting-with-preconfigured-workflow-templates)". - -Você também pode adicionar este fluxo de trabalho manualmente, criando um novo arquivo no diretório `.github/workflows` do seu repositório. - -{% raw %} -```yaml -nome: Java CI - -em: [push] - -trabalhos: - criar: - runs-on: ubuntu-latest - - etapas: - - usa: actions/checkout@v2 - - nome: Set up JDK 1.8 - usa: actions/setup-java@v1 - com: - java-version: 1.8 - - nome: Criado com Maven - executar: mvn -B package --file pom.xml -``` -{% endraw %} - -Este fluxo de trabalho executa os seguintes passos: - -1. O `checkout` faz o download de uma cópia do seu repositório no executor. -2. A etapa `setup-java` configura o Java 1.8 JDK. -3. A etapa "Construir com Maven" executa o `pacote`-alvo Maven alvo de modo não interativo para garantir que seu código de seja criado, o seu teste seja aprovado e que seja possível criar um pacote. - -Os modelos-padrão do fluxo de trabalho são excelentes pontos de partida ao criar seu fluxo de trabalho de compilação e teste, e você pode personalizar o modelo para atender às necessidades do seu projeto. - -{% data reusables.github-actions.example-github-runner %} - -{% data reusables.github-actions.java-jvm-architecture %} - -### Criar e testar seu código - -Você pode usar os mesmos comandos usados localmente para criar e testar seu código. - -O fluxo de trabalho inicial executará o `pacote`-alvo por padrão. Na configuração-padrão do Maven, este comando fará o download das dependências, criará classes, executará testes e classes de pacotes em seu formato distribuível, como, por exemplo, um arquivo JAR. - -Se você usa comandos diferentes para criar seu projeto ou se desejar usar um alvo diferente, você poderá especificá-los. Por exemplo, você pode desejar executar o alvo de `verificar`, configurado em um arquivo _pom-ci.xml_. - -{% raw %} -```yaml -etapas: - - usa: actions/checkout@v2 - - usa: actions/setup-java@v1 - com: - java-version: 1.8 - - nome: Executar a fase de verificação do Maven - executar: mvn -B verify --file pom-ci.xml -``` -{% endraw %} - -### Memorizar dependências - -Você pode armazenar as suas dependências para acelerar as execuções do seu fluxo de trabalho. Após a conclusão bem-sucedida, o seu repositório local do Maven será armazenado na infraestrutura do GitHub Actions. Para os fluxos de trabalho futuros, a cache será restaurada para que as dependências não precisem ser baixadas dos repositórios remotos do Maven. Para obter mais informações, consulte "[Memorizando dependências para acelerar os fluxos de trabalho](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)" e a ação [`cache`](https://github.com/marketplace/actions/cache). - -{% raw %} -```yaml -etapas: - - usa: actions/checkout@v2 - - nome: Set up JDK 1.8 - usa: actions/setup-java@v1 - cpm: - java-version: 1.8 - - nome: Cache Maven packages - usa: actions/cache@v2 - com: - caminho: ~/.m2 - chave: ${{ runner.os }}-m2-${{ hashFiles('**/pom.xml') }} - restore-keys: ${{ runner.os }}-m2 - - nome: Construir com Maven - executar: mvn -B package --file pom.xml -``` -{% endraw %} - -Este fluxo de trabalho salvará o conteúdo do repositório local do Maven, localizado no diretório `.m2` do diretório inicial do executor. A chave da cache será o conteúdo em hash do _pom.xml_. Portanto, as alterações em _pom.xml_ invalidarão a cache. - -### Empacotar dados do fluxo de trabalho como artefatos - -Após a sua criação ter sido criada com sucesso e os seus testes aprovados, é possível que você deseje fazer o upload dos Java resultantes como um artefato de criação. Isso armazenará os pacotes criados como parte da execução do fluxo de trabalho e permitirá que você faça o download desses pacotes. Os artefatos podem ajudá-lo a testar e depurar os pull requests no seu ambiente local antes de serem mesclados. Para obter mais informações, consulte "[Dados recorrentes do fluxo de trabalho que usam artefatos](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)". - -De modo geral, o Maven criará arquivos de saída como JARs, EARs ou WARs no diretório `alvo`. Para fazer o upload como artefatos, você pode copiá-los em um novo diretório que contém artefatos a serem subidos. Por exemplo, você pode criar um diretório denominado `treinamento`. Em seguida, você pode fazer o upload do conteúdo desse diretório usando a ação `upload-artifact`. - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - - run: mvn -B package --file pom.xml - - run: mkdir staging && cp target/*.jar staging - - uses: actions/upload-artifact@v2 - with: - name: Package - path: staging -``` -{% endraw %} diff --git a/translations/pt-BR/content/actions/language-and-framework-guides/github-actions-for-docker.md b/translations/pt-BR/content/actions/language-and-framework-guides/github-actions-for-docker.md deleted file mode 100644 index a15c78d49296..000000000000 --- a/translations/pt-BR/content/actions/language-and-framework-guides/github-actions-for-docker.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: GitHub Actions para Docker -intro: Criar fluxos de trabalho que criame publicam projetos Docker. -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/pt-BR/content/actions/language-and-framework-guides/github-actions-for-java.md b/translations/pt-BR/content/actions/language-and-framework-guides/github-actions-for-java.md deleted file mode 100644 index 91d7a9a0a355..000000000000 --- a/translations/pt-BR/content/actions/language-and-framework-guides/github-actions-for-java.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: GitHub Actions para Java -intro: Criar fluxos de trabalho que criam e testam projetos escritos em Java. -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/pt-BR/content/actions/language-and-framework-guides/github-actions-for-javascript-and-typescript.md b/translations/pt-BR/content/actions/language-and-framework-guides/github-actions-for-javascript-and-typescript.md deleted file mode 100644 index b8070b924fcb..000000000000 --- a/translations/pt-BR/content/actions/language-and-framework-guides/github-actions-for-javascript-and-typescript.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: GitHub Actions para JavaScript e TypeScript -intro: Criar fluxos de trabalho que criam e testam projetos escritos nas bibliotecas JavaScript e TypeScript. -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/pt-BR/content/actions/language-and-framework-guides/github-actions-for-python.md b/translations/pt-BR/content/actions/language-and-framework-guides/github-actions-for-python.md deleted file mode 100644 index 0b73da4c0e54..000000000000 --- a/translations/pt-BR/content/actions/language-and-framework-guides/github-actions-for-python.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: GitHub Actions para Python -intro: Criar fluxos de trabalho que criam e testam projetos escritos em Python. -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/pt-BR/content/actions/language-and-framework-guides/index.md b/translations/pt-BR/content/actions/language-and-framework-guides/index.md deleted file mode 100644 index 3ba8b2cf695c..000000000000 --- a/translations/pt-BR/content/actions/language-and-framework-guides/index.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Guias de idioma e estrutura -intro: É possível criar fluxos de trabalho de integração contínua (CI) que criam e testam projetos escritos em diferentes linguagens de programação. -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -{% topic_link_in_list /github-actions-for-javascript-and-typescript %} - {% link_in_list /using-nodejs-with-github-actions %} - {% link_in_list /publishing-nodejs-packages %} -{% topic_link_in_list /github-actions-for-python %} - {% link_in_list /using-python-with-github-actions %} -{% topic_link_in_list /github-actions-for-java %} - {% link_in_list /building-and-testing-java-with-maven %} - {% link_in_list /building-and-testing-java-with-gradle %} - {% link_in_list /building-and-testing-java-with-ant %} - {% link_in_list /publishing-java-packages-with-maven %} - {% link_in_list /publishing-java-packages-with-gradle %} -{% topic_link_in_list /github-actions-for-docker %} - {% link_in_list /publishing-docker-images %} diff --git a/translations/pt-BR/content/actions/language-and-framework-guides/publishing-docker-images.md b/translations/pt-BR/content/actions/language-and-framework-guides/publishing-docker-images.md deleted file mode 100644 index 1cb9a7f41897..000000000000 --- a/translations/pt-BR/content/actions/language-and-framework-guides/publishing-docker-images.md +++ /dev/null @@ -1,157 +0,0 @@ ---- -title: Publicar imagens do Docker -intro: 'Você pode publicar imagens Docker para um registro, como o Docker Hub ou {% data variables.product.prodname_registry %}, como parte do seu fluxo de trabalho de integração contínua (CI).' -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Introdução - -Este guia mostra como criar um fluxo de trabalho que realiza uma criação do Docker e, em seguida, publica imagens do Docker no Docker Hub ou no {% data variables.product.prodname_registry %}. Com um único fluxo de trabalho, você pode publicar imagens em um único registro ou em vários registros. - -{% note %} - -**Observação:** Se você desejar fazer push para outro registro do Docker de terceiros, o exemplo na seção "[Publicar imagens em {% data variables.product.prodname_registry %}](#publishing-images-to-github-packages)" poderá servir como um bom modelo. - -{% endnote %} - -### Pré-requisitos - -Recomendamos que você tenha um entendimento básico das opções de configuração do fluxo de trabalho e de como criar um arquivo do fluxo de trabalho. Para obter mais informações, consulte "[Configurar fluxo de trabalho](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)." - -Você também pode achar útil ter um entendimento básico do seguinte: - -- "[Conceitos básicos para{% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)" -- "[Criar e usar segredos criptografados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)" -- "[Autenticando com o GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)" -- "[Configurar o Docker para uso com o {% data variables.product.prodname_registry %}](/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages)" - -### Sobre a configuração da imagem - -Este guia pressupõe que você tem uma definição completa para uma imagem Docker armazenada em um repositório {% data variables.product.prodname_dotcom %}. Por exemplo, seu repositório deve conter um _arquivo Docker_ e quaisquer outros arquivos necessários para executar uma criação do Docker para criar uma imagem. - -Neste guia, usaremos a ação `build-push-action` do Docker para criar a imagem do Docker e enviá-la para um ou mais registros do Docker. Para obter mais informações, consulte [`build-push-action`](https://github.com/marketplace/actions/build-and-push-docker-images). - -{% data reusables.actions.enterprise-marketplace-actions %} - -### Publicar imagens no Docker Hub - -{% data reusables.github-actions.release-trigger-workflow %} - -No exemplo do fluxo de trabalho abaixo, usamos a ação `build-push-action` do Docker para criar a imagem e, se a construção for bem-sucedida, faça o push da imagem criada para o Docker Hub. - -Para fazer push para o Docker Hub, você deverá ter uma conta Docker Hub e ter criado um repositório Docker Hub. Para obter mais informações, consulte "[Compartilhar imagens no Docker Hub](https://docs.docker.com/get-started/part3/)" na documentação do Docker. - -As opções `build-push-action` necessárias para o Docker Hub são: - -* `nome de usuário` e `senha`: Este é o seu nome de usuário e senha do Docker Hub. Recomendamos armazenar seu nome de usuário e senha do Docker Hub como segredos encriptados no repositório {% data variables.product.prodname_dotcom %} para que não sejam expostos no seu arquivo de fluxo de trabalho. Para obter mais informações, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". -* `repositório`: Seu repositório do Docker Hub no formato `DOCKER-HUB-NAMESPACE/DOCKER-HUB-REPOSITORY`. - -{% raw %} -```yaml -nome: Publicar imagem do Docker -em: - versão: - tipos: [published] -trabalhos: - push_to_registry: - Nome: Push Docker image to Docker Hub - runs-on: ubuntu-latest - etapas: - - nome: Verificar repo - usa: actions/checkout@v2 - - nome: Push to Docker Hub - usa: docker/build-push-action@v1 - com: - nome de usuário: ${{ secrets.DOCKER_USERNAME }} - senha: ${{ secrets.DOCKER_PASSWORD }} - repositório: my-docker-hub-namespace/my-docker-hub-repository - tag_with_ref: true -``` -{% endraw %} - -{% data reusables.github-actions.docker-tag-with-ref %} - -### Publicar imagens em {% data variables.product.prodname_registry %} - -{% data reusables.github-actions.release-trigger-workflow %} - -No exemplo abaixo, usamos a ação `build-push-action` do Docker para criar a imagem do Docker, e se a criação for bem-sucedida, faça o push da imagem criada para {% data variables.product.prodname_registry %}. - -As opções de `build-push-action` necessárias para {% data variables.product.prodname_registry %} são: - -* `nome de usuário`: Você pode usar o contexto {% raw %}`${{ github.actor }}`{% endraw %} para usar automaticamente o nome de usuário que acionou a execução do fluxo de trabalho. Para obter mais informações, consulte "[Contexto e sintaxe de expressão para GitHub Actions](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)". -* `senha`: Você pode usar o segredo `GITHUB_TOKEN` gerado automaticamente para a senha. Para obter mais informações, consulte "[Permissões para o GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)". -* `registro`: Deve ser definido como `docker.pkg.github.com`. -* `repositório`: Deve ser definido no formato `OWNER/REPOSITORY/IMAGE_NAME`. Por exemplo, para uma imagem denominada `octo-image` armazenada no {% data variables.product.prodname_dotcom %} em `http://github. Um/octo-org/octo-repo`, a opção `repositório` deve ser definida como `octo-org/octo-repo/octo-image`. - -{% raw %} -```yaml -nome: Publish Docker image -em: - versão: - tipos: [published] -trabalhos: - push_to_registry: - nome: Push Docker image to GitHub Packages - runs-on: ubuntu-latest - etapas: - - nome: Check out the repo - usa: actions/checkout@v2 - - nome: Push to GitHub Packages - usa: docker/build-push-action@v1 - com: - nome de usuário: ${{ github.actor }} - senha: ${{ secrets.GITHUB_TOKEN }} - registro: docker.pkg.github.com - repositório: my-org/my-repo/my-image - tag_with_ref: true - -``` -{% endraw %} - -{% data reusables.github-actions.docker-tag-with-ref %} - -### Publicar imagens no Docker Hub e {% data variables.product.prodname_registry %} - -Em um único fluxo de trabalho, você pode publicar sua imagem do Docker em vários registros usando a ação `build-push-action` para cada registro. - -O exemplo do fluxo de trabalho a seguir usa as etapas `build-push-action` das seções anteriores ("[Publicar imagens para o Docker Hub](#publishing-images-to-docker-hub)" e "[Publicar imagens em {% data variables.product.prodname_registry %}](#publishing-images-to-github-packages)") para criar um único fluxo de trabalho que faça push em ambos os registros. - -{% raw %} -```yaml -nome: Publicar imagem do Docker -em: - versão: - tipos: [published] -trabalhos: - push_to_registries: - nome: Fazer push da imagem do Docker em múltiplos registros - runs-on: ubuntu-latest - etapas: - - nome: Verificar o repo - usa: actions/checkout@v2 - - nome: Push to Docker Hub - usa: docker/build-push-action@v1 - with: - nome de usuário: ${{ secrets.DOCKER_USERNAME }} - senha: ${{ secrets.DOCKER_PASSWORD }} - repositório: my-docker-hub-namespace/my-docker-hub-repository - tag_with_ref: true - - nome: Push to GitHub Packages - usa: docker/build-push-action@v1 - com: - nome de usuário: ${{ github.actor }} - senha: ${{ secrets.GITHUB_TOKEN }} - registro: docker.pkg.github.com - repositório: my-org/my-repo/my-image - tag_with_ref: true -``` -{% endraw %} - -O fluxo de trabalho acima verifica o repositório {% data variables.product.prodname_dotcom %} e usa a ação `construção-push-action` duas vezes para criar e fazer push da imagem do Docker Hub e {% data variables.product.prodname_registry %}. Para ambas as etapas, ele define a opção `construção-push-action` [`tag_with_ref`](https://github.com/marketplace/actions/build-and-push-docker-images#tag_with_ref) para marcar automaticamente a imagem do Docker criada com a referêcia do Git do evento do fluxo de trabalho. Este fluxo de trabalho é acionado na publicação de uma versão do {% data variables.product.prodname_dotcom %}. Portanto, a referência para ambos os registros será a tag do Git para a versão. diff --git a/translations/pt-BR/content/actions/language-and-framework-guides/publishing-java-packages-with-gradle.md b/translations/pt-BR/content/actions/language-and-framework-guides/publishing-java-packages-with-gradle.md deleted file mode 100644 index e9207b81481b..000000000000 --- a/translations/pt-BR/content/actions/language-and-framework-guides/publishing-java-packages-with-gradle.md +++ /dev/null @@ -1,218 +0,0 @@ ---- -title: Publicar pacotes Java com Gradle -intro: Você pode usar o Gradle para publicar pacotes Java para um registro como parte do seu fluxo de trabalho de integração contínua (CI). -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Introdução - -{% data reusables.github-actions.publishing-java-packages-intro %} - -### Pré-requisitos - -Recomendamos que você tenha um entendimento básico dos arquivos de fluxo de trabalho e das opções de configuração. Para obter mais informações, consulte "[Configurar fluxo de trabalho](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)." - -Para obter mais informações sobre a criação de um fluxo de trabalho de CI para seu projeto Java com Gradle, consulte "[Criando e testando o Java com Gradle](/actions/language-and-framework-guides/building-and-testing-java-with-gradle)" - -Você também pode achar útil ter um entendimento básico do seguinte: - -- "[Conceitos básicos para{% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)" -- "[Configurar o npm para uso com o {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)" -- "[Usando variáveis de ambiente](/actions/automating-your-workflow-with-github-actions/using-environment-variables)" -- "[Criar e usar segredos criptografados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)" -- "[Autenticando com o GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)" - -### Sobre a configuração do pacote - -Os campos `groupId` e `artefactId` na seção `MavenPublication` do arquivo _build.gradle_ criam um identificador exclusivo para o seu pacote que os registros usam para vinculá-lo a um registro. Isto é semelhante aos campos `groupId` e `artifactId` do arquivo Maven _pom.xml_. Para obter mais informações, consulte o "[Plugin de publicação do Maven](https://docs.gradle.org/current/userguide/publishing_maven.html)" na documentação do Gradle. - -O arquivo _build.gradle_ também contém a configuração para os repositórios de gerenciamento de distribuição nos quais o Gradle publicará pacotes. Cada repositório deve ter um nome, uma URL de implementação e e credenciais para autenticação. - -### Publicar pacotes no Repositório Central do Maven - -Cada vez que você criar uma nova versão, você poderá acionar um fluxo de trabalho para publicar o seu pacote. O fluxo de trabalho no exemplo abaixo é executado quando o evento `versão` é acionado com o tipo `criado`. O fluxo de trabalho publica o pacote no Repositório Central Maven se o teste de CI for aprovado. Para obter mais informações sobre o evento da `versão`, consulte "[Eventos que acionam fluxos de trabalho](/actions/reference/events-that-trigger-workflows#release)". - -É possível definir um novo repositório do Maven no bloco de publicação do seu arquivo _build.gradle_ que aponta para o repositório de pacotes. Por exemplo, se você estava fazendo uma implementaão no Central Repositório do Maven por meio do projeto de hospedagem OSSRH, seu _build.gradle_ poderá especificar um repositório com o nome `"OSSRH"`. - -{% raw %} -```groovy -publicando { - ... - - repositories { - maven { - name = "OSSRH" - url = "https://oss.sonatype.org/service/local/staging/deploy/maven2/" - credentials { - username = System.getenv("MAVEN_USERNAME") - password = System.getenv("MAVEN_PASSWORD") - } - } - } -} -``` -{% endraw %} - -Com essa configuração, é possível criar um fluxo de trabalho que publica seu pacote no Repositório Central do Maven ao executar o comando `publicação do gradle`. Você também deverá fornecer variáveis de ambiente que contenham o nome de usuário e senha para fazer a autenticação no repositório. - -Na etapa de implementação, você deverá definir variáveis de ambiente para o nome de usuário e senha ou token usado para fazer a autenticação no repositório do Maven. Para obter mais informações, consulte "[Criando e usando segredos encriptados](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". - - -{% raw %} -```yaml -nome: Publicar pacote no Repositório Central do Maven -em: - versão: - tipos: [created] -trabalhos: - publicar: - runs-on: ubuntu-latest - etapas: - - usa: actions/checkout@v2 - - nome: Configurar Java - usa: actions/setup-java@v1 - com: - java-version: 1.8 - - nome: Publicar pacote - executar: gradle publish - env: - MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }} - MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }} -``` -{% endraw %} - -{% data reusables.github-actions.gradle-workflow-steps %} -1. Executa o comando `publicação do gradle` para fazer a publicação no repositório do Maven `OSSRH`. A variável de ambiente `MAVEN_USERNAME` será definida com o conteúdo do seu segredo `OSSRH_USERNAME`, e a variável de ambiente `MAVEN_PASSWORD` será definida com o conteúdo do seu segredo `OSSRH_TOKEN`. - - Para obter mais informações sobre o uso de segredos no seu fluxo de trabalho, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". - -### Publicar pacotes em {% data variables.product.prodname_registry %} - -Cada vez que você criar uma nova versão, você poderá acionar um fluxo de trabalho para publicar o seu pacote. O fluxo de trabalho no exemplo abaixo é executado quando o evento `versão` é acionado com o tipo `criado`. O fluxo de trabalho publica o pacote em {% data variables.product.prodname_registry %} se o teste de CI for aprovado. Para obter mais informações sobre o evento da `versão`, consulte "[Eventos que acionam fluxos de trabalho](/actions/reference/events-that-trigger-workflows#release)". - -Você pode definir um novo repositório do Maven no bloco de publicação do _build.gradle_ que aponta para {% data variables.product.prodname_registry %}. Nessa configuração do repositório, também é possível aproveitar as variáveis de ambiente definidas na execução do fluxo de trabalho de CI. Você pode usar a variável de ambiente `GITHUB_ACTOR` como um nome de usuário e você pode definir a variável de ambiente `GITHUB_TOKEN` com seu segredo `GITHUB_TOKEN`. - -O `GITHUB_TOKEN` existe no repositório por padrão e tem permissões de leitura e gravação para pacotes no repositório em que o fluxo de trabalho é executado. Para obter mais informações, consulte "[Autenticação com o GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)". - -Por exemplo, se sua organização é denominado "octocat" e seu repositório é denominado de "hello-world", a configuração do {% data variables.product.prodname_registry %} no _build.gradle_ será parecida ao exemplo abaixo. - -{% raw %} -```groovy -publicando { - ... - - repositories { - maven { - name = "GitHubPackages" - url = "https://maven.pkg.github.com/octocat/hello-world" - credentials { - username = System.getenv("GITHUB_ACTOR") - password = System.getenv("GITHUB_TOKEN") - } - } - } -} -``` -{% endraw %} - -Com essa configuração, é possível criar um fluxo de trabalho que publica seu pacote no Repositório Central do Maven ao executar o comando `publicação do gradle`. - -{% raw %} -```yaml -nome: Publicar pacote nos pacotes do GitHub -em: - versão: - tipos: [created] -trabalhos: - publicar: - runs-on: ubuntu-latest - etapas: - - usa: actions/checkout@v2 - - usa: actions/setup-java@v1 - com: - java-version: 1.8 - - nome: Publicar pacote - executar: publicação do gradle - env: - GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} - -{% data reusables.github-actions.gradle-workflow-steps %} -1. Executa o comando `publicação do gradle` para publicar no {% data variables.product.prodname_registry %}. A variável de ambiente `GITHUB_TOKEN` será definida com o conteúdo do segredo `GITHUB_TOKEN`. - - Para obter mais informações sobre o uso de segredos no seu fluxo de trabalho, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". - -### Publicar imagens no Repositório Central do Maven e em {% data variables.product.prodname_registry %} - -Você pode publicar seus pacotes no Repositório Central Maven e em {% data variables.product.prodname_registry %}, configurando cada um no seu arquivo _build.gradle_. - -Certifique-se de que seu arquivo _build.gradle_ inclua um repositório para seu repositório {% data variables.product.prodname_dotcom %} e seu provedor do Repositório Central do Maven. - -Por exemplo, se fizer a implementação no Repositório Central por meio do projecto de hospedagem OSSRH, é possível que você deseje especificá-lo em um repositório de gerenciamento de distribuição com o `nome` definido como `OSSRH`. Se você fizer a implementação em {% data variables.product.prodname_registry %}, é possível que você deseje especificá-lo em um repositório de gerenciamento de distribuição com o nome `` definido como `GitHubPackages`. - -Se sua organização for denominada "octocat" e seu repositório for denominado "hello-world", a configuração de {% data variables.product.prodname_registry %} em _build.gradle_ será parecida ao exemplo abaixo. - -{% raw %} -```groovy -publicando { - ... - - repositories { - maven { - name = "OSSRH" - url = "https://oss.sonatype.org/service/local/staging/deploy/maven2/" - credentials { - username = System.getenv("MAVEN_USERNAME") - password = System.getenv("MAVEN_PASSWORD") - } - } - maven { - name = "GitHubPackages" - url = "https://maven.pkg.github.com/octocat/hello-world" - credentials { - username = System.getenv("GITHUB_ACTOR") - password = System.getenv("GITHUB_TOKEN") - } - } - } -} -``` -{% endraw %} - -Com esta configuração, você pode criar um fluxo de trabalho que publica seu pacote no Repositório Central do Maven e em {% data variables.product.prodname_registry %}, executando o comando `publicação do gradle`. - -{% raw %} -```yaml -nome: Publicar pacote no Repositório Central do Maven e nos Pacotes do GitHub -em: - versão: - tipos: [created] -trabalhos: - publicar: - runs-on: ubuntu-latest - etapas: - - usa: actions/checkout@v2 - - nome: Configura o Java - usa: actions/setup-java@v1 - com: - java-version: 1.8 - - nome: Publica no Repositório Central do Maven - executa: publicação do gradle - env: - MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }} - MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }} - GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} - -{% data reusables.github-actions.gradle-workflow-steps %} -1. Executa o comando `publicação do gradle` para publicar no repositório do Maven `OSSRH` e em {% data variables.product.prodname_registry %}. A variável de ambiente `MAVEN_USERNAME` será definida com o conteúdo do seu segredo `OSSRH_USERNAME`, e a variável de ambiente `MAVEN_PASSWORD` será definida com o conteúdo do seu segredo `OSSRH_TOKEN`. A variável de ambiente `GITHUB_TOKEN` será definida com o conteúdo do segredo `GITHUB_TOKEN`. - - Para obter mais informações sobre o uso de segredos no seu fluxo de trabalho, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". diff --git a/translations/pt-BR/content/actions/language-and-framework-guides/publishing-java-packages-with-maven.md b/translations/pt-BR/content/actions/language-and-framework-guides/publishing-java-packages-with-maven.md deleted file mode 100644 index 24e2ed399da0..000000000000 --- a/translations/pt-BR/content/actions/language-and-framework-guides/publishing-java-packages-with-maven.md +++ /dev/null @@ -1,209 +0,0 @@ ---- -title: Publicar pacotes Java com Maven -intro: Você pode usar o Maven para publicar pacotes Java para um registro como parte do seu fluxo de trabalho de integração contínua (CI). -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Introdução - -{% data reusables.github-actions.publishing-java-packages-intro %} - -### Pré-requisitos - -Recomendamos que você tenha um entendimento básico dos arquivos de fluxo de trabalho e das opções de configuração. Para obter mais informações, consulte "[Configurar fluxo de trabalho](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)." - -Para obter mais informações sobre a criação de um fluxo de trabalho de CI para seu projeto Java com Maven, consulte "[Criando e testando o Java com Maven](/actions/language-and-framework-guides/building-and-testing-java-with-maven)" - -Você também pode achar útil ter um entendimento básico do seguinte: - -- "[Conceitos básicos para{% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)" -- "[Configurar o npm para uso com o {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)" -- "[Usando variáveis de ambiente](/actions/automating-your-workflow-with-github-actions/using-environment-variables)" -- "[Criar e usar segredos criptografados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)" -- "[Autenticando com o GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)" - -### Sobre a configuração do pacote - -Os campos `groupId` e `artefactId` no arquivo _x-id="4">pom.xml_ criam a um identificador exclusivo para o seu pacote que os registros usam para vincular o seu pacote a um registro. Para obter mais informações, consulte [Guia para fazer o upload de artefatos no Repositório Central](http://maven.apache.org/repository/guide-central-repository-upload.html) na documentação do Apache Maven. - -O arquivo _pom.xml_ também contém a configuração para os repositórios de gerenciamento de distribuição nos quais o Maven implementará pacotes. Cada repositório deve ter um nome e uma URL de implementação. A autenticação para estes repositórios pode ser configurada no arquivo _.m2/settings.xml_ no diretório inicial do usuário que está executando o Maven. - -É possível usar a ação de `setup-java` para configurar o repositório de imeplementação, bem como a autenticação para esse repositório. Para obter mais informações, consulte [`setup-java`](https://github.com/actions/setup-java). - -### Publicar pacotes no Repositório Central do Maven - -Cada vez que você criar uma nova versão, você poderá acionar um fluxo de trabalho para publicar o seu pacote. O fluxo de trabalho no exemplo abaixo é executado quando o evento `versão` é acionado com o tipo `criado`. O fluxo de trabalho publica o pacote no Repositório Central Maven se o teste de CI for aprovado. Para obter mais informações sobre o evento da `versão`, consulte "[Eventos que acionam fluxos de trabalho](/actions/reference/events-that-trigger-workflows#release)". - -Neste fluxo de trabalho, você pode usar a ação `setup-java`. Esta ação instala uma determinada versão do JDK no `PATH`, mas também define _settings.xml_ do Maven para publicação de pacotes. Por padrão, o arquivo de configurações será definido como {% data variables.product.prodname_registry %}. No entanto, ele pode ser configurado para implementar outro registro de pacote, como, por exemplo, o Repositório Central do Maven. Se você já tem um repositório de gerenciamento de distribuição configurado em _pom.xml_, você poderá especificar esse `id` durante a chamada da ação `setup-java`. - -Por exemplo, se você estava implantando no Repositório Central do Maven por meio do projeto de hospedagem OSSRH, seu _pom.xml_ poderia especificar um repositório de gerenciamento de distribuição com o `id` de `ossrh`. - -{% raw %} -```xml - - ... - - - ossrh - Central Repository OSSRH - https://oss.sonatype.org/service/local/staging/deploy/maven2/ - - - -``` -{% endraw %} - -Com esta configuração, é possível criar um fluxo de trabalho que publique seu pacote no Repositório Central do Maven especificando o `id` do gerenciamento do repositório para a ação `setup-java`. Você também deverá fornecer variáveis de ambiente que contenham o nome de usuário e senha para fazer a autenticação no repositório. - -Na etapa de implementação, você deverá definir as variáveis de ambiente para o nome de usuário com o qual deseja fazer a autenticação no repositório e para um segredo que você configurou com a senha ou token para autenticação. Para obter mais informações, consulte "[Criando e usando segredos encriptados](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". - - -{% raw %} -```yaml -nome: Publicar pacote no Repositório Central do Maven -em: - versão: - tipos: [created] -trabalhos: - publicar: - runs-on: ubuntu-latest - etapas: - - usa: actions/checkout@v2 - - nome: Configurar no Repositório Central do Maven - usa: actions/setup-java@v1 - com: - java-version: 1.8 - server-id: ossrh - server-username: MAVEN_USERNAME - server-password: MAVEN_PASSWORD - - nome: Publicar pacote - executar: mvn -B deploy - env: - MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }} - MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }} -``` -{% endraw %} - -Este fluxo de trabalho executa os seguintes passos: - -1. Verifica uma cópia do repositório do projeto. -1. Configura o Java JDK e o arquivo _settings.xml_ do Maven para adicionar autenticação ao repositório `ossrh` usando as variáveis de ambiente `MAVEN_USERNAME` e `MAVEN_PASSWORD`. -1. {% data reusables.github-actions.publish-to-maven-workflow-step %} - - Para obter mais informações sobre o uso de segredos no seu fluxo de trabalho, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". - -### Publicar pacotes em {% data variables.product.prodname_registry %} - -Cada vez que você criar uma nova versão, você poderá acionar um fluxo de trabalho para publicar o seu pacote. O fluxo de trabalho no exemplo abaixo é executado quando o evento `versão` é acionado com o tipo `criado`. O fluxo de trabalho publica o pacote em {% data variables.product.prodname_registry %} se o teste de CI for aprovado. Para obter mais informações sobre o evento da `versão`, consulte "[Eventos que acionam fluxos de trabalho](/actions/reference/events-that-trigger-workflows#release)". - -Neste fluxo de trabalho, você pode usar a ação `setup-java`. Esta ação instala a versão determinada do JDK no `PATH`, e também configura _settings.xml_ do Maven para a publicação {% data variables.product.prodname_registry %}. O _settings.xml_ gerado define a autenticação para um servidor com um `id` do `github`, usando a variável de ambiente `GITHUB_ACTOR` como o nome de usuário e a variável de ambiente `GITHUB_TOKEN` como a senha. - -O `GITHUB_TOKEN` existe no repositório por padrão e tem permissões de leitura e gravação para pacotes no repositório em que o fluxo de trabalho é executado. Para obter mais informações, consulte "[Autenticação com o GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)". - -Para um projeto baseado no Maven, você pode usar essas configurações ao criar um repositório de distribuição no seu arquivo _pom.xml_ com um `id` do `github` que aponta para seu ponto final {% data variables.product.prodname_registry %}. - -Por exemplo, se sua organização é denominada "octocat" e seu repositório é denominado "hello-world", a configuração do {% data variables.product.prodname_registry %} no _pom.xml_ será parecida ao exemplo abaixo. - -{% raw %} -```xml - - ... - - - github - GitHub Packages - https://maven.pkg.github.com/octocat/hello-world - - - -``` -{% endraw %} - -Com esta configuração, você pode criar um fluxo de trabalho que publica seu pacote em {% data variables.product.prodname_registry %}, fazendo uso do _settings.xml_ gerado automaticamente. - -{% raw %} -```yaml -nome: Publicar pacote nos pacotes do GitHub -em: - versão: - tipos: [created] -trabalhos: - publicar: - runs-on: ubuntu-latest - etapas: - - usa: actions/checkout@v2 - - usa: actions/setup-java@v1 - com: - java-version: 1.8 - - nome: Publicar pacote - executar: mvn -B deploy - env: - GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} - -Este fluxo de trabalho executa os seguintes passos: - -1. Verifica uma cópia do repositório do projeto. -1. Configura o Java JDK e também configura automaticamente o arquivo _settings.xml_ do Maven para adicionar autenticação para o repositório do `github` do Maven para usar a variável de ambiente `GITHUB_TOKEN`. -1. {% data reusables.github-actions.publish-to-packages-workflow-step %} - - Para obter mais informações sobre o uso de segredos no seu fluxo de trabalho, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". - -### Publicar imagens no Repositório Central do Maven e em {% data variables.product.prodname_registry %} - -Você pode publicar seus pacotes no Repositório Central Maven e em {% data variables.product.prodname_registry %}, usando a ação de `setup-java` para cada registro. - -Certifique-se de que seu arquivo _pom.xml_ inclui um repositório de gerenciamento de distribuição tanto para seu repositório {% data variables.product.prodname_dotcom %} como para o seu provedor de Repositório Central do Maven. Por exemplo, se você fizer a implementação em um Repositório Central por meio do projeto de hospedagem OSSRH, é possível que você deseje especificá-la em um repositório de gerenciamento de distribuição com o `id` definido como `ossrh`. Além disso, você pode desejar especificar {% data variables.product.prodname_registry %} em um repositório de gerenciamento de distribuição com o `id` definido como `github`. - -{% raw %} -```yaml -nome: Publicar pacote no Repositório Central do Maven e nos Pacotes do GitHub -em: - versão: - tipos: [created] -trabalhos: - publicar: - runs-on: ubuntu-latest - etapas: - - usar: actions/checkout@v2 - - nome: Configurar o Java para publicação no Repositório Central do Maven - uses: actions/setup-java@v1 - with: - java-version: 1.8 - server-id: ossrh - server-username: MAVEN_USERNAME - server-password: MAVEN_PASSWORD - - nome: Publicar no Repositório Central do Maven - run: mvn -B deploy - env: - MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }} - MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }} - - name: Set up Java for publishing to GitHub Packages - usa: actions/setup-java@v1 - com: - java-version: 1.8 - - nome: Publicar nos pacotes do GitHub - executar: mvn -B deploy - env: - GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} - -Este fluxo de trabalho chama a ação `setup-java` duas vezes. Cada vez que a ação `setup-java` é executada, ela sobrescreve o arquivo _settings.xml_ do Maven para a publicação de pacotes. Para autenticação no repositório, o arquivo _settings.xml_ faz referência ao `ID`do repositório de gerenciamento de distribuição e ao nome de usuário e senha. - -Este fluxo de trabalho executa os seguintes passos: - -1. Verifica uma cópia do repositório do projeto. -1. Chama `setup-java` pela primeira vez. Isso configura o arquivo _settings.xml_ do Maven para o repositório `ossrh` e define as opções de autenticação para variáveis de ambiente definidas na próxima etapa. -1. {% data reusables.github-actions.publish-to-maven-workflow-step %} -1. Chama `setup-java` pela segunda vez. Isso configura automaticamente o arquivo _settings.xml_ do Maven para {% data variables.product.prodname_registry %}. -1. {% data reusables.github-actions.publish-to-packages-workflow-step %} - - Para obter mais informações sobre o uso de segredos no seu fluxo de trabalho, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". diff --git a/translations/pt-BR/content/actions/language-and-framework-guides/publishing-nodejs-packages.md b/translations/pt-BR/content/actions/language-and-framework-guides/publishing-nodejs-packages.md deleted file mode 100644 index ebbaf10f94a4..000000000000 --- a/translations/pt-BR/content/actions/language-and-framework-guides/publishing-nodejs-packages.md +++ /dev/null @@ -1,210 +0,0 @@ ---- -title: Publicar pacotes do Node.js -intro: Você pode publicar pacotes do Node.js em um registro como parte do seu fluxo de trabalho de integração contínua (CI). -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Introdução - -Este guia mostra como criar um fluxo de trabalho que publica pacotes do Node.js em {% data variables.product.prodname_registry %} e nos registros npm após os testes de integração contínua (CI) serem aprovados. Com um único fluxo de trabalho, você pode publicar pacotes em um único registro ou em vários registros. - -### Pré-requisitos - -Recomendamos que você tenha um entendimento básico das opções de configuração do fluxo de trabalho e de como criar um arquivo do fluxo de trabalho. Para obter mais informações, consulte "[Configurar fluxo de trabalho](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)." - -Para obter mais informações sobre a criação de um fluxo de trabalho de CI para seu projeto Node.js, consulte "[Usando Node.js com {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/using-nodejs-with-github-actions)". - -Você também pode achar útil ter um entendimento básico do seguinte: - -- "[Conceitos básicos para{% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)" -- "[Configurar o npm para uso com o {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)" -- "[Usando variáveis de ambiente](/actions/automating-your-workflow-with-github-actions/using-environment-variables)" -- "[Criar e usar segredos criptografados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)" -- "[Autenticando com o GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)" - -### Sobre a configuração do pacote - - Os campos `nome` e `versão` no arquivo *package.json* cria um identificador único que os registros usam para vincular seu pacote a um registro. Você pode adicionar um resumo para página de listagem do pacote ao incluir um campo `descrição` no arquivo *package.json*. Para obter mais informações, consulte "[Criando um pacote package.json](https://docs.npmjs.com/creating-a-package-json-file)" e "[Criando módulos Node.js](https://docs.npmjs.com/creating-node-js-modules)" na documentação do npm. - -Quando um arquivo *.npmrc* local existe e tem um valor de `registro` especificado, o comando `publicação do npm` usa o registro configurado no arquivo *.npmrc*. {% data reusables.github-actions.setup-node-intro %} - -Você pode especificar a versão do Node.js instalada no executor usando a ação `setup-node`. - -Se você adicionar etapas ao seu fluxo de trabalho para configurar os campos `publishConfig` no seu arquivo *package.json*, você não precisará especificar o registry-url usando a ação de `setup-node`. No entanto, você estará limitado à publicação do pacote em um registro. Para obter mais informações, consulte "[publishConfig](https://docs.npmjs.com/files/package.json#publishconfig)" na documentação npm. - -### Publicar pacotes no registro npm - -Cada vez que você criar uma nova versão, você poderá acionar um fluxo de trabalho para publicar o seu pacote. O fluxo de trabalho no exemplo abaixo é executado quando o evento `versão` é acionado com o tipo `criado`. O fluxo de trabalho publica o pacote no registro npm se o teste de CI for aprovado. - -Para executar operações autenticadas com o registro npm em seu fluxo de trabalho, você deverá armazenar seu token de autenticação npm como um segredo nas configurações do repositório. Por exemplo, crie um segredo denominado `NPM_TOKEN`. Para obter mais informações, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". - -Por padrão, o npm usa o campo `nome` do arquivo *package.json* para determinar o registro do npm. Ao publicar em um namespace global, você precisa incluir apenas o nome do pacote. Por exemplo, você publicaria um pacote denominado `npm-hello-world-test` em `https://www.npmjs.com/package/npm-hello-world-test`. - -Se você estiver publicando um pacote que inclui um prefixo de escopo, inclua o escopo no nome do arquivo *package.json*. Por exemplo, se o prefixo de escopo do npm é octocat e o nome do pacote é hello-world, o `nome` no seu arquivo *package.json* deverá ser `@octocat/hello-world`. Se seu pacote npm usar um prefixo de escopo e for público, você deverá usar a opção `npm publish --access public`. Essa é uma opção que o npm requer para impedir que alguém publique um pacote privado de forma não intencional. - -Este exemplo armazena o segredo `NPM_TOKEN` na variável de ambiente `NODE_AUTH_TOKEN`. Quando a ação `setup-node` cria um arquivo *.npmrc*, ela faz referência ao token da variável de ambiente `NODE_AUTH_TOKEN`. - -{% raw %} -```yaml -nome: Pacote Node.js -em: - versão: - tipos: [created] -trabalhos: - criar: - runs-on: ubuntu-latest - etapas: - - usa: actions/checkout@v2 - # Configura o arquivo .npmrc a ser publicado no npm - - usa: actions/setup-node@v1 - com: - node-version: '12.x' - registry-url: 'https://registry.npmjs.org' - - executar: npm install - - executar: npm publish - env: - NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} -``` -{% endraw %} - -No exemplo acima, a ação `setup-node` cria um arquivo *.npmrc* no executor com o conteúdo a seguir: - -``` -//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN} -registry=https://registry.npmjs.org/ -always-auth=true -``` - -### Publicar pacotes em {% data variables.product.prodname_registry %} - -Cada vez que você criar uma nova versão, você poderá acionar um fluxo de trabalho para publicar o seu pacote. O fluxo de trabalho no exemplo abaixo é executado sempre que ocorre o evento `versão` com o tipo `criado`. O fluxo de trabalho publica o pacote em {% data variables.product.prodname_registry %} se o teste de CI for aprovado. - -Por padrão, o {% data variables.product.prodname_registry %} publica um pacote no repositório {% data variables.product.prodname_dotcom %} que você especificar no campo `nome` do arquivo *package.json*. Por exemplo, você publicaria um pacote denominado `@my-org/test` no repositório `my-org/test` do {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte [`npm-scope`](https://docs.npmjs.com/misc/scope) na documentação do npm. - -Para realizar operações autenticadas no registro do {% data variables.product.prodname_registry %} em seu fluxo de trabalho, você pode usar o `GITHUB_TOKEN`. O `GITHUB_TOKEN` existe no repositório por padrão e tem permissões de leitura e gravação para pacotes no repositório em que o fluxo de trabalho é executado. Para obter mais informações, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". - -Este exemplo armazena o segredo `GITHUB_TOKEN` na variável de ambiente `NODE_AUTH_TOKEN`. Quando a ação `setup-node` cria um arquivo *.npmrc*, ela faz referência ao token da variável de ambiente `NODE_AUTH_TOKEN`. - -{% raw %} -```yaml -nome: Pacote Node.js -em: - versão: - tipos: [created] -trabalhos: - criar: - runs-on: ubuntu-latest - etapas: - - usa: actions/checkout@v2 - # Configura o arquivo .npmrc a ser publicado nos pacotes do GitHub - - usa: actions/setup-node@v1 - com: - node-version: '12.x' - registry-url: 'https://npm.pkg.github.com' - # Tem como padrão o usuário ou organização proprietário do arquivo do fluxo de trabalho - escopo: '@octocat' - - executar: npm install - - run: npm publish - env: - NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} - -A ação `setup-node` cria um arquivo *.npmrc* no executor. Ao usar a entrada do `escopo` para a ação `setup-node`, o arquivo *.npmrc* incluirá o prefixo do escopo. Por padrão, a ação `setup-node` define o escopo no arquivo *.npmrc* na conta que contém esse arquivo do fluxo de trabalho. - -``` -//npm.pkg.github.com/:_authToken=${NODE_AUTH_TOKEN} -@octocat:registry=https://npm.pkg.github.com -always-auth=true -``` - -### Publicar pacotes usando o yarn - -Se você usar o gerenciador de pacotes Yarn, você poderá instalar e publicar pacotes usando o Yarn. - -{% raw %} -```yaml -nome: Pacote Node.js -em: - versão: - tipos: [created] -trabalhos: - criar: - runs-on: ubuntu-latest - etapas: - - usa: actions/checkout@v2 - # Configura o arquivo .npmrc a ser publicado no npm - - usa: actions/setup-node@v1 - com: - node-version: '12.x' - registry-url: 'https://registry.npmjs.org' - # Tem como padrão o usuário ou a organização que é proprietário do arquivo do fluxo de trabalho - escopo: '@octocat' - - executar: yarn - - executar: yarn publish - env: - NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} -``` -{% endraw %} - -### Publicar pacotes no npm e em {% data variables.product.prodname_registry %} - -{% note %} - -**Nota:** Se você precisar publicar para registros que têm diferentes prefixos de escopo, você deverá modificar o arquivo *package.json* no executor para alterar o prefixo de escopo. Por exemplo, se você publicar um pacote no escopo `@mona` para o npm e para o escopo `@octocat` para {% data variables.product.prodname_registry %}, você poderá substituir o escopo `@mona` por `@octocat` no arquivo *package.json* no executor, após fazer a publicação no npm e antes de publicar em {% data variables.product.prodname_registry %}. - -{% endnote %} - -Você pode publicar seus pacotes no registro do npm e em {% data variables.product.prodname_registry %}, usando a ação de `setup-node` para cada registro. - -Se você publicar um pacote em ambos os registros, você deverá garantir que seu prefixo de escopo no npm corresponda ao nome do usuário ou da organização do {% data variables.product.prodname_dotcom %}. Para publicar pacotes em um registro público com um prefixo de escopo, você pode usar o comando `npm publish --access public`. Para obter mais informações, consulte [`npm-scope`](https://docs.npmjs.com/misc/scope) e "[Criar e publicar pacotes públicos com escopos](https://docs.npmjs.com/creating-and-publishing-scoped-public-packages)" na documentação do npm. - -Certifique-se de que seu arquivo *package.json* inclua o escopo do seu repositório {% data variables.product.prodname_dotcom %} e o registro npm. Por exemplo, se você planeja publicar um pacote no repositório `octocat/npm-hello-world-test` em {% data variables.product.prodname_dotcom %} e em https://www.npmjs. om/package/@octocat/npm-hello-world-test, o nome no arquivo do seu *package.json* seria `"name": "@octocat/npm-hello-world-test"`. - -Para realizar operações autenticadas no registro do {% data variables.product.prodname_registry %} em seu fluxo de trabalho, você pode usar o `GITHUB_TOKEN`. O `GITHUB_TOKEN` existe no repositório por padrão e tem permissões de leitura e gravação para pacotes no repositório em que o fluxo de trabalho é executado. Para obter mais informações, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". - -Ao usar a entrada do `escopo` para a ação `setup-node`, esta cria um arquivo *.npmrc* que inclui o prefixo do escopo. Por padrão, a ação `setup-node` define o escopo no arquivo *.npmrc* para o usuário ou organização proprietário do arquivo do fluxo de trabalho. - -Este fluxo de trabalho chama a ação `setup-node` duas vezes. Cada vez que a ação `setup-node` é executada, ela substitui o arquivo *.npmrc*. O arquivo *.npmrc* faz referência ao token que permite que você execute operações autenticadas com o registro do pacote a partir da variável de ambiente `NODE_AUTH_TOKEN`. O fluxo de trabalho define a variável de ambiente `NODE_AUTH_TOKEN` toda vez que o comando `publicação do npm` é executado. Primeiro com um token para publicar no npm (`NPM_TOKEN`) e, em seguida, com um token para publicar em {% data variables.product.prodname_registry %} (`GITHUB_TOKEN`). - -{% raw %} -```yaml -nome: Pacote Node.js -em: - versão: - tipos: [created] -trabalhos: - criar: - runs-on: ubuntu-latest - etapas: - - usa: actions/checkout@v2 - # Configura o arquivo .npmrc a ser publicado no npm - - usa: actions/setup-node@v1 - com: - node-version: '10.x' - registry-url: 'https://registry.npmjs.org' - - executa: npm install - # Publica no npm - - executa: npm publish --access public - env: - NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} - # Configura o arquivo .npmrc a ser publicado nos pacotes do GitHub - - usa: actions/setup-node@v1 - com: - registry-url: 'https://npm.pkg.github.com' - # Tem como padrão o usuário ou a organização proprietário do arquivo do fluxo de trabalho - escopo: '@octocat' - # Publicar nos pacotes do GitHub - - executar: npm publish - env: - NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} diff --git a/translations/pt-BR/content/actions/language-and-framework-guides/using-nodejs-with-github-actions.md b/translations/pt-BR/content/actions/language-and-framework-guides/using-nodejs-with-github-actions.md deleted file mode 100644 index 26a307828603..000000000000 --- a/translations/pt-BR/content/actions/language-and-framework-guides/using-nodejs-with-github-actions.md +++ /dev/null @@ -1,277 +0,0 @@ ---- -title: Usar Node.js com GitHub Actions -intro: É possível criar um fluxo de trabalho de integração contínua (CI) para criar e testar o seu projeto Node.js. -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/using-nodejs-with-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Introdução - -Este guia mostra como criar um fluxo de trabalho de integração contínua (CI) que cria e testa o código Node.js. Se o seu teste de CI for aprovado, é possível que você deseje publicar seu código ou um pacote. - -### Pré-requisitos - -Recomendamos que você tenha um entendimento básico do Node.js, YAML, das opções de configuração do fluxo de trabalho e de como criar um arquivo do fluxo de trabalho. Para obter mais informações, consulte "[Configurando um fluxo de trabalho](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)" e "[Primeiros passos com o Node.js](https://nodejs.org/en/docs/guides/getting-started-guide/)". - -Você também pode achar útil ter um entendimento básico do seguinte: - -- "[Conceitos básicos para{% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)" -- "[Usando variáveis de ambiente](/actions/automating-your-workflow-with-github-actions/using-environment-variables)" - -{% data reusables.actions.enterprise-setup-prereq %} - -### Introdução com o modelo de workflow do Node.js - -O {% data variables.product.prodname_dotcom %} fornece um modelo de fluxo de trabalho do Node.js que funcionará para a maioria dos projetos Node.js. Esse guia inclui exemplos de npm e Yarn que você pode usar para personalizar o modelo. Para obter mais informações, consulte o [modelo do fluxo de trabalho do Node.js](https://github.com/actions/starter-workflows/blob/master/ci/node.js.yml). - -Para iniciar rapidamente, adicione o modelo ao diretório `.github/workflows` do repositório. - -{% raw %} -```yaml -Nome: Node.js CI - -em: [push] - -trabalhos: - criar: - - runs-on: ubuntu-latest - - estratégia: - matriz: - node-version: [8.x, 10.x, 12.x] - - etapas: - - usa: actions/checkout@v2 - - nome: Use Node.js ${{ matrix.node-version }} - usa: actions/setup-node@v1 - com: - node-version: ${{ matrix.node-version }} - - executa: npm install - - executa: npm run build --if-present - - executa: npm test - env: - CI: true -``` -{% endraw %} - -{% data reusables.github-actions.example-github-runner %} - -### Especificar a versão do Node.js - -A maneira mais fácil de especificar uma versão do Node.js é usar a ação `setup-node` fornecida pelo {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte [`setup-node`](https://github.com/actions/setup-node/). - -A ação `setup-node` considera uma versão do Node.js como uma entrada e configura essa versão no executor. A ação `setup-node` localiza uma versão específica do Node.js da cache das ferramentas em casa executor e adiciona os binários necessários ao `PATH`, que persiste no resto do trabalho. Usar a ação `setup-node` é a forma recomendada de usar o Node.js com {% data variables.product.prodname_actions %}, pois garante um comportamento consistente nos diferentes executores e nas diferentes versões do Node.js. Se você estiver usando um executor auto-hospedado, você deverá instalar o Node.js e adicioná-lo ao `PATH`. - -O modelo inclui uma estratégia de matriz que cria e testa o seu código com três versões do Node.js: 8.x, 10.x, e 12.x. O "x" é um caractere curinga que corresponde à última versão menor e à versão do patch disponível para uma versão. Cada versão do Node.js especificada na matriz `node-version` cria uma tarefa que executa as mesmas etapas. - -Cada trabalho pode acessar o valor definido na matriz `node-version` usando o contexto `matriz`. A ação `setup-node` usa o contexto como entrada de `node-version`. A ação `setup-node` configura cada tarefa com uma versão diferente de Node.js antes de criar e testar o código. Para obter mais informações sobre os contextos e estratégias da matriz, consulte ""[Sintaxe do fluxo de trabalho para {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix)" e "[Contexto e sintaxe de expressão para {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)". - -{% raw %} -```yaml -estratégia: - matriz: - node-version: [8.x, 10.x, 12.x] - -etapas: -- usa: actions/checkout@v2 -- Nome: Use Node.js ${{ matrix.node-version }} - usa: actions/setup-node@v1 - com: - node-version: ${{ matrix.node-version }} -``` -{% endraw %} - -Como alternativa, você pode criar e fazes testes com versões exatas do Node.js. - -```yaml -estratégia: - matriz: - node-version: [8.16.2, 10.17.0] -``` - -Você também pode criar e testar usando uma versão única do Node.js. - -{% raw %} -```yaml -Nome: Node.js CI - -em: [push] - -trabalhos: - criar: - - runs-on: ubuntu-latest - - etapas: - - usa: actions/checkout@v2 - - Nome: Usa o Node.js - usa: actions/setup-node@v1 - com: - node-version: '12.x' - - executar: npm install - - executar: npm run build --if-present - - executar: npm test - env: - CI: true -``` -{% endraw %} - -Se você não especificar uma versão do Node.js, o {% data variables.product.prodname_dotcom %} usará a versão-padrão do Node.js do ambiente. Para obter mais informações, consulte "[Software instalado em executores hospedados em {% data variables.product.prodname_dotcom %}](/actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners)". - -### Instalar dependências - -Executores hospedados em {% data variables.product.prodname_dotcom %} têm gerenciadores de dependências npm e Yarn instalados. Você pode usar o npm e o Yarn para instalar dependências no seu fluxo de trabalho antes de criar e testar seu código. Os executores do Windows e Linux hospedados em {% data variables.product.prodname_dotcom %} também têm o Grunt, Gulp, e Bower instalado. - -Você também pode memorizar as dependências para acelerar seu fluxo de trabalho. Para obter mais informações, consulte "[Memorizando dependências para acelerar seu fluxo de trabalho](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)". - -#### Exemplo de uso do npm - -Este exemplo instala as dependências definidas no arquivo *package.json*. Para obter mais informações, consulte [`instalação do npm`](https://docs.npmjs.com/cli/install). - -```yaml -etapas: -- usa: actions/checkout@v2 -- nome: Use Node.js - usa: actions/setup-node@v1 - com: - node-version: '12.x' -- nome: Instalar dependências - executar: npm install -``` - -O uso do `npm ci` instala as versões no arquivo *package-lock.json* ou *npm-shrinkwrap.json* e impede as atualizações do arquivo de bloqueio. Usar `npm ci` geralmente é mais rápido que executar a `instalação do npm`. Para obter mais informações, consulte [`npm ci`](https://docs.npmjs.com/cli/ci.html) e "[Introduzindo `npm` para criações mais rápidas e confiáveis](https://blog.npmjs.org/post/171556855892/introducing-npm-ci-for-faster-more-reliable)". - -{% raw %} -```yaml -etapas: -- usa: actions/checkout@v2 -- nome: Use Node.js - usa: actions/setup-node@v1 - com: - node-version: '12.x' -- nome: Instalar dependências - executar: npm ci -``` -{% endraw %} - -#### Exemplo de uso do Yarn - -Este exemplo instala as dependências definidas no arquivo *package.json*. Para obter mais informações, consulte [`instalação do yarn`](https://yarnpkg.com/en/docs/cli/install). - -```yaml -etapas: -- usa: actions/checkout@v2 -- nome: Use Node.js - usa: actions/setup-node@v1 - com: - node-version: '12.x' -- nome: Instalar dependências - executar: yarn -``` - -Como alternativa, você pode aprovar o `--frozen-lockfile` para instalar as versões no arquivo *yarn.lock* e impedir atualizações no arquivo *yarn.lock*. - -```yaml -etapas: -- usa: actions/checkout@v2 -- nome: Use Node.js - usa: actions/setup-node@v1 - com: - node-version: '12.x' -- nome: Instalar dependências - executar: yarn --frozen-lockfile -``` - -#### Exemplo do uso de um registro privado e de criação o arquivo .npmrc - -{% data reusables.github-actions.setup-node-intro %} - -Para fazer a autenticação no seu registro privado, você deverá armazenar seu token de autenticação npm como um segredo nas configurações do seu repositório. Por exemplo, crie um segredo denominado `NPM_TOKEN`. Para obter mais informações, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". - -No exemplo abaixo, o segredo `NPM_TOKEN` armazena o token de autenticação npm. A ação `setup-node` configura o arquivo *.npmrc* para ler o token de autenticação npm a partir da variável de ambiente `NODE_AUTH_TOKEN`. Ao usar a ação `setup-node` para criar um arquivo *.npmrc*, você deverá definir a variável de ambiente `NPM_AUTH_TOKEN` com o segredo que contém seu token de autenticação npm. - -Antes de instalar as dependências, use a ação `setup-node` para criar o arquivo *.npmrc* file. A ação tem dois parâmetros de entrada. O parâmetro `node-version` define a versão do Node.js e o parâmetro `registry-url` define o registro-padrão. Se o registro do seu pacote usar escopos, você deverá usar o parâmetro `escopo`. Para obter mais informações, consulte [`npm-scope`](https://docs.npmjs.com/misc/scope). - -{% raw %} -```yaml -etapas: -- usa: actions/checkout@v2 -- nome: Use Node.js - usa: actions/setup-node@v1 - com: - always-auth: true - node-version: '12.x' - registry-url: https://registry.npmjs.org - escopo: '@octocat' -- nome: Instalar dependências - executar: npm ci - env: - NODE_AUTH_TOKEN: ${{secrets.NPM_TOKEN}} -``` -{% endraw %} - -O exemplo acima cria um arquivo *.npmrc* com o conteúdo a seguir: - -``` -//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN} -@octocat:registry=https://registry.npmjs.org/ -always-auth=true -``` - -#### Exemplo de memorização de dependências - -Você pode memorizar dependências usando uma chave única e restaurar as dependências ao executar fluxos de trabalho futuros usando a ação `cache`. Para obter mais informações, consulte "[Memorizando dependências para acelerar os fluxos de trabalho](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)" e a ação [`cache`](https://github.com/marketplace/actions/cache). - -{% raw %} -```yaml -etapas: -- usa: actions/checkout@v2 -- nome: Use Node.js - usa: actions/setup-node@v1 - com: - node-version: '12.x' -- nome: Cache Node.js modules - usa: actions/cache@v2 - com: - # Os arquivos da cache do npm estão armazenados em `~/.npm` no Linux/macOS - caminho: ~/.npm - chave: ${{ runner.OS }}-node-${{ hashFiles('**/package-lock.json') }} - restore-keys: | - ${{ runner.OS }}-node- - ${{ runner.OS }}- -- nome: Instalar dependências - executar: npm ci -``` -{% endraw %} - -### Criar e testar seu código - -Você pode usar os mesmos comandos usados localmente para criar e testar seu código. Por exemplo, se você executar `criação da execução do npm` para executar os passos de compilação definidos no seu arquivo *package.json* e o `teste do npm` para executar seu conjunto de testes, você adicionaria esses comandos no seu arquivo de fluxo de trabalho. - -```yaml -etapas: -- usa: actions/checkout@v2 -- nome: Use Node.js - usa: actions/setup-node@v1 - com: - node-version: '12.x' -- executar: npm install -- executar: npm run build --if-present -- executar: npm test -``` - -### Empacotar dados do fluxo de trabalho como artefatos - -Você pode salvar artefatos das suas etapas de criação e teste para serem visualizados após a conclusão de um trabalho. Por exemplo, é possível que você precise salvar os arquivos de registro, os despejos de núcleo, os resultados de teste ou capturas de tela. Para obter mais informações, consulte "[Dados recorrentes do fluxo de trabalho que usam artefatos](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)". - -### Publicar nos registros do pacote - -Você pode configurar o seu fluxo de trabalho para publicar o seu pacote Node.js em um pacote de registro após os seus testes de CI serem aprovados. Para obter mais informações sobre a publicação no npm e em {% data variables.product.prodname_registry %}, consulte "[Publicando pacotes do Node.js](/actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages)". diff --git a/translations/pt-BR/content/actions/language-and-framework-guides/using-python-with-github-actions.md b/translations/pt-BR/content/actions/language-and-framework-guides/using-python-with-github-actions.md deleted file mode 100644 index 3e06636292e1..000000000000 --- a/translations/pt-BR/content/actions/language-and-framework-guides/using-python-with-github-actions.md +++ /dev/null @@ -1,426 +0,0 @@ ---- -title: Usar Python com GitHub Actions -intro: É possível criar um fluxo de trabalho de integração contínua (CI) para criar e testar o seu projeto Python. -redirect_from: - - /actions/automating-your-workflow-with-github-actions/using-python-with-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Introdução - -Este guia mostra como criar, testar e publicar um pacote no Python. - -Os executores hospedados em {% data variables.product.prodname_dotcom %} possuem uma cache de ferramentas com um software pré-instalado, que inclui o Python e o PyPy. Você não precisa instalar nada! Para obter uma lista completa do software atualizado e das versões pré-instaladas do Python e do PyPy, consulte [software instalado em executores hospedados em {% data variables.product.prodname_dotcom %}](/actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners). - -### Pré-requisitos - -Você deve estar familiarizado com o YAML e a sintaxe do {% data variables.product.prodname_actions %}. Para obter mais informações, consulte a sintaxe "[ para {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)." - -Recomendamos que você tenha um entendimento básico do Python, PyPy e pip. Para obter mais informações, consulte: -- [Primeiros passos com o Python](https://www.python.org/about/gettingstarted/) -- [PyPy](https://pypy.org/) -- [Gerenciador de pacotes do Pip](https://pypi.org/project/pip/) - -{% data reusables.actions.enterprise-setup-prereq %} - -### Introdução com o modelo do fluxo de trabalho do Python - -O {% data variables.product.prodname_dotcom %} fornece um modelo de fluxo de trabalho do Python que deve funcionar na maioria dos projetos Python. Este guia inclui exemplos que você pode usar para personalizar o modelo. Para obter mais informações, consulte o [modelo de fluxo de trabalho do Python](https://github.com/actions/starter-workflows/blob/master/ci/python-package.yml). - -Para iniciar rapidamente, adicione o modelo ao diretório `.github/workflows` do repositório. - -{% raw %} -```yaml -nome: Pacote do Python - -em: [push] - -trabalhos: - criar: - - runs-on: ubuntu-latest - estratégia: - matriz: - python-version: [2.7, 3.5, 3.6, 3.7, 3.8] - - etapas: - - usa: actions/checkout@v2 - - nome: Configura o Python ${{ matrix.python-version }} - usa: actions/setup-python@v2 - com: - python-version: ${{ matrix.python-version }} - - nome: Instalar dependências - executar: | - python -m pip install --upgrade pip - pip install flake8 pytest - if [ -f requirements.txt ]; then pip install -r requirements.txt; fi - - nome : Lint with flake8 - executar: | - # interrompe a criação em caso de erros de sintaxe do Python ou de nomes indefinidos - flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics - # exit-zero trata todos os errors como avisos. O editor do GitHub tem 127 caracteres - flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics - - nome: Testar com pytest - executar: | - pytest -``` -{% endraw %} - -### Especificar uma versão do Python - -Para usar uma versão pré-instalada do Python ou do PyPy em um executor hospedado em {% data variables.product.prodname_dotcom %}, use a ação `setup-python`. Esta ação encontra uma versão específica do Python ou do PyPy na cache das ferramenatas em cada executor e adiciona os binários necessários ao `PATH`, que persiste para o restante do trabalho. Se uma versão específica do Python não for pré-instalada na cache de ferramentas, a `setup-python` ação fará o download e irá configurar a versão apropriada do repositório [`python-versions`](https://github.com/actions/python-versions). - -Using the `setup-action` is the recommended way of using Python with {% data variables.product.prodname_actions %} because it ensures consistent behavior across different runners and different versions of Python. Se você estiver usando um executor auto-hospedado, você deverá instalar Python e adicioná-lo ao `PATH`. Para obter mais informações, consulte a ação [`setup-python`](https://github.com/marketplace/actions/setup-python). - -A tabela abaixo descreve os locais para o armazenamento de ferramentas em cada executor hospedado em {% data variables.product.prodname_dotcom %}. - -| | Ubuntu | Mac | Windows | -| ------------------------------------ | ------------------------------- | ---------------------------------------- | ------------------------------------------ | -| **Diretório da cache da ferramenta** | `/opt/hostedtoolcache/*` | `/Users/runner/hostedtoolcache/*` | `C:\hostedtoolcache\windows\*` | -| **Cache da ferramenta do Python** | `/opt/hostedtoolcache/Python/*` | `/Users/runner/hostedtoolcache/Python/*` | `C:\hostedtoolcache\windows\Python\*` | -| **Cache da ferramenta do PyPy** | `/opt/hostedtoolcache/PyPy/*` | `/Users/runner/hostedtoolcache/PyPy/*` | `C:\hostedtoolcache\windows\PyPy\*` | - -Se você estiver usando um executor auto-hospedado, você poderá configurá-lo para usar a ação `setup-python` para gerenciar suas dependências. Para obter mais informações, consulte [usando o setup-python com um executor auto-hospedado](https://github.com/actions/setup-python#using-setup-python-with-a-self-hosted-runner) na LEIAME do `setup-python`. - -O {% data variables.product.prodname_dotcom %} é compatível com a sintaxe semântica de versionamento. Para obter mais informações, consulte "[Usar o versionamento semântico](https://docs.npmjs.com/about-semantic-versioning#using-semantic-versioning-to-specify-update-types-your-package-can-accept)" e "[Especificação do versionamento semântico](https://semver.org/)". - -#### Usar várias versões do Python - -{% raw %} -```yaml -nome: Pacote Python - -em: [push] - -trabalhos: - criar: - - runs-on: ubuntu-latest - estratégia: - # Você pode usar as versões do PyPy em python-version. - # Por exemplo, pypy2 and pypy3 - matriz: - python-version: [2.7, 3.5, 3.6, 3.7, 3.8] - - etapas: - - usa: actions/checkout@v2 - - nome: Configura o Python ${{ matrix.python-version }} - usa: actions/setup-python@v2 - com: - python-version: ${{ matrix.python-version }} - # Você pode testar a sua matriz imprimindo a versão atual do Python - - nome: Exibe a versão do Python - executar: python -c "import sys; print(sys.version)" -``` -{% endraw %} - -#### Usar uma versão específica do Python - -Você pode configurar uma versão específica do python. Por exemplo, 3,8. Como alternativa, você pode usar a sintaxe da versão semântica para obter a última versão secundária. Este exemplo usa a última versão secundária do Python 3. - -{% raw %} -```yaml -nome: Pacote Python - -em: [push] - -trabalhos: - criar: - - runs-on: ubuntu-latest - - etapas: - - usa: actions/checkout@v2 - - nome: Configura Python 3.x - usa: actions/setup-python@v2 - com: - # Sintaxe do intervalo da versão semântica ou versão exata de uma versão do Python - python-version: '3.x' - # Opcional - x64 or x86 architecture, defaults to x64 - arquitetura: 'x64' - # Você pode testar a sua matriz imprimindo a versão atual do Python - - nome: Exibir uma versão do Python - executar: python -c "import sys; print(sys.version)" -``` -{% endraw %} - -#### Excluir uma versão - -Se especificar uma versão do Python que estiver indisponível, `setup-python` ocorrerá uma falha com um erro como: `##[error]Version 3.4 with arch x64 not found`. A mensagem de erro inclui as versões disponíveis. - -Também é possível usar a palavra-chave `excluir` no seu fluxo de trabalho se houver uma configuração do Python que você não deseja executar. Para obter mais informações, consulte a sintaxe "[ para {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategy)." - -{% raw %} -```yaml -name: Python package - -on: [push] - -jobs: - build: - - runs-on: ${{ matrix.os }} - strategy: - matrix: - os: [ubuntu-latest, macos-latest, windows-latest] - python-version: [2.7, 3.6, 3.7, 3.8, pypy2, pypy3] - exclude: - - os: macos-latest - python-version: 3.6 - - os: windows-latest - python-version: 3.6 -``` -{% endraw %} - -#### Usar a versão padrão do Python - -Recomendamos usar `setup-python` para configurar a versão do Python usada nos seus fluxos de trabalho, porque isso ajuda a deixar as suas dependências explícitas. Se você não usar `setup-python`, a versão padrão do Python definida em `PATH` será usada em qualquer shell quando você chamar `python`. A versão-padrão do Python varia entre executores hospedados no {% data variables.product.prodname_dotcom %}, o que pode causar mudanças inesperadas ou usar uma versão mais antiga do que o esperado. - -| Executor hospedado em {% data variables.product.prodname_dotcom %} | Descrição | -| ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Ubuntu | Os executores do Ubuntu têm várias versões do sistema do Python instaladas em `/usr/bin/python` e `/usr/bin/python3`. As versões do Python que vêm empacotadas com o Ubuntu são adicionais às versões que o {% data variables.product.prodname_dotcom %} instala na cache das ferramentas. | -| Windows | Excluindo as versões do Python que estão na cache de ferramentas, o Windows não é compatível com uma versão equivalente do sistema do Python. Para manter um comportamento consistente com outros executores e permitir que o Python seja usado de forma inovadora sem a ação `setup-python` , {% data variables.product.prodname_dotcom %} adiciona algumas versões da cache das ferramentas ao `PATH`. | -| macOS | Os executores do macOS têm mais de uma versão do sistema do Python instalada, além das versões que fazem parte da cache de ferramentas. As versões do sistema do Python estão localizadas no diretório `/usr/local/Cellar/python/*`. | - -### Instalar dependências - -Os executores hospedados em {% data variables.product.prodname_dotcom %} têm instalado o gerenciador do pacote pip. Você pode usar o pip para instalar dependências do registro de pacotes do PyPI antes de criar e testar o seu código. Por exemplo, o YAML abaixo instala ou atualiza o instalador de pacotes `pip` e as os pacotes `setuptools` e `wheel`. - -Você também pode memorizar as dependências para acelerar seu fluxo de trabalho. Para obter mais informações, consulte "[Memorizando dependências para acelerar seu fluxo de trabalho](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)". - -{% raw %} -```yaml -etapas: -- usa: actions/checkout@v2 -- nome: Configurar Python - usa: actions/setup-python@v2 - com: - python-version: '3.x' -- Nome: Instalar dependências - executar: python -m pip install --upgrade pip setuptools wheel -``` -{% endraw %} - -#### Arquivo de requisitos - -Depois de atualizar o `pip`, um o próximo passo típico é instalar as dependências de *requirements.txt*. - -{% raw %} -```yaml -etapas: -- usa: actions/checkout@v2 -- nome: Configurar Python - usa: actions/setup-python@v2 - com: - python-version: '3.x' -- nome: Instalar dependências - executar: | - python -m pip install --upgrade pip - pip install -r requirements.txt -``` -{% endraw %} - -#### Memorizar dependências - -Você pode armazenar dependências do pip usando uma chave única e restaurar as dependências quando você executar fluxos de trabalho futuros usando a ação [`cache`](https://github.com/marketplace/actions/cache). Para obter mais informações, consulte "[Memorizando dependências para acelerar fluxos de trabalho](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)". - -O Pip armazena dependências em diferentes locais, dependendo do sistema operacional do executor. O caminho que você precisa efetuar o armazenamento em cache pode ser diferente do exemplo do Ubuntu abaixo, dependendo do sistema operacional que você usa. Para obter mais informações, consulte [Exemplos de armazenamento em cache do Python](https://github.com/actions/cache/blob/master/examples.md#python---pip). - -{% raw %} -```yaml -etapas: -- usa: actions/checkout@v2 -- nome: Setup Python - usa: actions/setup-python@v2 - com: - python-version: '3.x' -- nome: Cache pip - usa: actions/cache@v2 - com: - # Este caminho é específico para o Ubuntu - caminho: ~/.cache/pip - # Observe se há uma correspondência da cache para o arquivo de requisitos correspondente - chave: ${{ runner.os }}-pip-${{ hashFiles('requirements.txt') }} - restore-keys: | - ${{ runner.os }}-pip- - ${{ runner.os }}- -- nome: Instalar dependências - executar: pip install -r requirements.txt -``` -{% endraw %} - -{% note %} - -**Observação:** Dependendo do número de dependências, pode ser mais rápido para usar o armazenamento de dependências. Os projetos com muitas dependências grandes devem ver um aumento no desempenho conforme reduz o tempo necessário para fazer o download. Os projetos com menos dependências podem não ver um aumento significativo no desempenho e até mesmo ver um ligeiro diminuir devido à forma como o pip instala dependências armazenadas em cache. O desempenho varia de projeto para projeto. - -{% endnote %} - -### Testar seu código - -Você pode usar os mesmos comandos usados localmente para criar e testar seu código. - -#### Testar com pytest e pytest-cov - -Este exemplo instala ou atualiza `pytest` e `pytest-cov`. Em seguida, os testes são executados e retornados no formato JUnit enquanto os resultados da cobertura do código são emitidos em Cobertura. Para obter mais informações, consulte [JUnit](https://junit.org/junit5/) e [Cobertura](https://cobertura.github.io/cobertura/). - -{% raw %} -```yaml -etapas: -- usa: actions/checkout@v2 -- nome: Set up Python - usa: actions/setup-python@v2 - com: - python-version: '3.x' -- nome: Instalar dependências - executar: | - python -m pip install --upgrade pip - pip install -r requirements.txt -- Nome: Testar com pytest - executar: | - pip install pytest - pip install pytest-cov - pytest tests.py --doctest-modules --junitxml=junit/test-results.xml --cov=com --cov-report=xml --cov-report=html -``` -{% endraw %} - -#### UsarFlake8 para código lint - -O exemplo a seguir instala ou atualiza o `flake8` e o usa para limpar todos os arquivos. Para obter mais informações, consulte [Flake8](http://flake8.pycqa.org/en/latest/). - -{% raw %} -```yaml -etapas: -- usa: actions/checkout@v2 -- nome: Configurar Python - usa: actions/setup-python@v2 - com: - python-version: '3.x' -- nome: Instalar dependências - executar: | - python -m pip install --upgrade pip - pip install -r requirements.txt -- nome: Lint with flake8 - run: | - pip install flake8 - flake8 . -``` -{% endraw %} - -#### Executar testes com tox - -Com {% data variables.product.prodname_actions %}, você pode executar testes com tox e distribuir o trabalho para vários trabalhos. Você precisará invocar tox usando a opção `-e py` para escolher a versão do Python no seu `PATH`, em vez de especificar uma versão específica. Para obter mais informações, consulte [tox](https://tox.readthedocs.io/en/latest/). - -{% raw %} -```yaml -nome: Pacote Python - -em: [push] - -trabalhos: - criar: - - runs-on: ubuntu-latest - estratégia: - matriz: - python: [2.7, 3.7, 3.8] - - etapa: - - usa: actions/checkout@v2 - - nome: Setup Python - usa: actions/setup-python@v2 - com: - python-version: ${{ matrix.python }} - - nome: Instalar Toxe e todos os outros pacotes - executar: pip install tox - - nome: Executar Tox - # Executar tox usando a versão do Python no `PATH` - run: tox -e py -``` -{% endraw %} - -### Empacotar dados do fluxo de trabalho como artefatos - -Você pode fazer o upload de artefatos para visualização após a conclusão de um fluxo de trabalho. Por exemplo, é possível que você precise salvar os arquivos de registro, os despejos de núcleo, os resultados de teste ou capturas de tela. Para obter mais informações, consulte "[Dados recorrentes do fluxo de trabalho que usam artefatos](/github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)". - -O exemplo a seguir demonstra como você pode usar a ação `upload-artefact` para arquivar os resultados de teste da execução do `pytest`. Para obter mais informações, consulte a ação <[`upload-artifact`](https://github.com/actions/upload-artifact). - -{% raw %} -```yaml -name: Python package - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - strategy: - matrix: - python-version: [2.7, 3.5, 3.6, 3.7, 3.8] - - steps: - - uses: actions/checkout@v2 - - name: Setup Python # Set Python version - uses: actions/setup-python@v2 - with: - python-version: ${{ matrix.python-version }} - # Install pip and pytest - - name: Install dependencies - run: | - python -m pip install --upgrade pip - pip install pytest - - name: Test with pytest - run: pytest tests.py --doctest-modules --junitxml=junit/test-results-${{ matrix.python-version }}.xml - - name: Upload pytest test results - uses: actions/upload-artifact@v2 - with: - name: pytest-results-${{ matrix.python-version }} - path: junit/test-results-${{ matrix.python-version }}.xml - # Use always() to always run this step to publish test results when there are test failures - if: ${{ always() }} -``` -{% endraw %} - -### Publicar nos registros do pacote - -Você pode configurar o seu fluxo de trabalho para publicar seu pacote de Python em qualquer registro de pacote que você desejar quando forem aprovados os seus testes de CI. - -Você pode armazenar qualquer token de acesso ou credenciais necessárias para publicar seu pacote usando segredos do repositório. O exemplo a seguir cria e publica um pacote no PyPI usando `twine` e `dist`. Para obter mais informações, consulte "[Criando e usando segredos encriptados](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". - -{% raw %} -```yaml -Nome: Fazer o upload no pacote Python - -em: - versão: - tipos: [created] - -trabalhos: - implementar: - runs-on: ubuntu-latest - etapas: - - usa: actions/checkout@v2 - - nome: Configurar Python - usa: actions/setup-python@v2 - com: - python-version: '3.x' - - nome: Instalar dependências - executar: | - python -m pip install --upgrade pip - pip install setuptools wheel twine - - nome: Criar e publicar - env: - TWINE_USERNAME: ${{ secrets.PYPI_USERNAME }} - TWINE_PASSWORD: ${{ secrets.PYPI_PASSWORD }} - executar: | - python setup.py sdist bdist_wheel - twine upload dist/* -``` -{% endraw %} - -Para obter mais informações sobre o fluxo de trabalho de template, consulte [`python-publish`](https://github.com/actions/starter-workflows/blob/master/ci/python-publish.yml). diff --git a/translations/pt-BR/content/actions/migrating-to-github-actions/index.md b/translations/pt-BR/content/actions/migrating-to-github-actions/index.md deleted file mode 100644 index c4443620d3b4..000000000000 --- a/translations/pt-BR/content/actions/migrating-to-github-actions/index.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: Migrar para o GitHub Actions -intro: 'Migrar de outros provedores de integração contínua (CI) para {% data variables.product.prodname_actions %}.' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -{% link_in_list /migrating-from-circleci-to-github-actions %} -{% link_in_list /migrating-from-azure-pipelines-to-github-actions %} -{% link_in_list /migrating-from-jenkins-to-github-actions %} diff --git a/translations/pt-BR/content/actions/migrating-to-github-actions/migrating-from-azure-pipelines-to-github-actions.md b/translations/pt-BR/content/actions/migrating-to-github-actions/migrating-from-azure-pipelines-to-github-actions.md deleted file mode 100644 index 61d4d7af3376..000000000000 --- a/translations/pt-BR/content/actions/migrating-to-github-actions/migrating-from-azure-pipelines-to-github-actions.md +++ /dev/null @@ -1,325 +0,0 @@ ---- -title: Migrar do Azure Pipelines para o GitHub Actions -intro: 'O {% data variables.product.prodname_actions %} e o Azure Pipelines compartilham várias semelhanças de configuração, o que torna a migração para {% data variables.product.prodname_actions %} relativamente simples.' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Introdução - -O Azure Pipelines e o {% data variables.product.prodname_actions %} permitem criar fluxos de trabalho que automaticamente criam, testam, publicam, lançam e implantam códigos. O Azure Pipelines e o {% data variables.product.prodname_actions %} compartilham algumas similaridades na configuração do fluxo de trabalho: - -- Os arquivos de configuração do fluxo de trabalho são gravados YAML e armazenados no repositório do código. -- Os fluxos de trabalho incluem um ou mais trabalhos. -- Os trabalhos incluem uma ou mais etapas ou comandos individuais. -- É possível reutilizar e compartilhar novamente etapas ou tarefas com a comunidade. - -Para obter mais informações, consulte "[Conceitos básicos para {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)". - -### Principais diferenças - -Ao migrar do Azure Pipelines, considere as diferenças a seguir: - -- O Azure Pipelines suporta um legado do _editor clássico_, que permite que você defina sua configuração de CI em um editor GUI em vez de criar a definição do pipeline em um arquivo YAML. O {% data variables.product.prodname_actions %} usa arquivos YAML para definir fluxos de trabalho e não é compatível com um editor gráfico. -- O Azure Pipelines permite que você omita algumas estruturas nas definições de trabalho. Por exemplo, se você tem apenas um único trabalho, não é necessário definir o trabalho. Você precisa definir apenas as etapas. O {% data variables.product.prodname_actions %} requer configuração explícita e não é possível omitir a estrutura do YAML. -- O Azure Pipelines é compatível com as _etapas_ definidas no arquivo YAML, que pode ser usado para criar fluxos de trabalho de implantação. O {% data variables.product.prodname_actions %} exige que você que você separe as etapas em arquivos separados do fluxo de trabalho do YAML. -- É possível selecionar os agentes de criação locais do Azure Pipelines com recursos. {% data variables.product.prodname_actions %} executores auto-hospedados podem ser selecionados com etiquetas. - -### Migrar trabalhos e etapas - -Os trabalhos e as etapas no Azure Pipelines são muito semelhantes a trabalhos e etapas do {% data variables.product.prodname_actions %}. Em ambos os sistemas, os trabalhos têm as características a seguir: - -* Os trabalhos contêm uma série de etapas executadas em sequência. -* Os trabalhos são executados em máquinas virtuais separadas ou em contêineres separados. -* Por padrão, os trabalhos executados em paralelo, mas podem ser configuradas para serem executados em sequência. - -### Migrar etapas de script - -Você pode executar um script ou um comando de shell como uma etapa em um fluxo de trabalho. No Azure Pipelines, as etapas do script podem ser especificadas usando a chave `script`, ou usando as chaves `bash`, `powershell`, ou `pwsh`. É possível especificar os scripts como entrada para uma [tarefa de Bash](https://docs.microsoft.com/en-us/azure/devops/pipelines/tasks/utility/bash?view=azure-devops) ou a como uma [tarefa de PowerShell](https://docs.microsoft.com/en-us/azure/devops/pipelines/tasks/utility/powershell?view=azure-devops). - -Em {% data variables.product.prodname_actions %}, todos os scripts são especificados usando a chave `executar`. Para selecionar um shell específico, você pode especificar a chave `shell` ao fornecer o script. Para obter mais informações, consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)". - -Abaixo, há um exemplo da sintaxe para cada sistema: - - - - - - - - - - -
    -Azure Pipelines - -{% data variables.product.prodname_actions %} -
    -{% raw %} -```yaml -trabalhos: -- trabalho: scripts - pool: - vmImage: 'windows-latest' - etapas: - - script: echo "Esta etapa é executada no shell-padrão" - - bash: echo "Esta etapa é executada em bash" - - pwsh: Write-Host "Esta etapa é executada no centro do PowerShell" - - tarefa: PowerShell@2 - entrada: - script: Write-Host "Esta etapa é executada em PowerShell" -``` -{% endraw %} - -{% raw %} -```yaml -trabalhos: - scripts: - runs-on: windows-latest - etapas: - - executar: echo "Esta etapa é executada no shell-padrão" - - run: echo "Esta etapa é executada em bash" - shell: bash - - executar : Write-Host "Esta etapa é executada no centro do PowerShell" - shell: pwsh - - run: Write-Host "Esta etapa é executada no PowerShell" - shell: powershell -``` -{% endraw %} -
    - -### Diferenças na manipulação de erros de script - -No Azure Pipelines, os scripts podem ser configurados com erro se houver uma saída for enviada para `stderr`. {% data variables.product.prodname_actions %} não suporta esta configuração. - -{% data variables.product.prodname_actions %} configura shells como "falha rápida" sempre que possível, que interrompe o script imediatamente caso um dos comandos em um script saia com um código de erro. Em contrapartida, o Azure Pipelines exige uma configuração explícita para sair imediatamente de um erro. Para obter mais informações, consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#exit-codes-and-error-action-preference)". - -### Diferenças no shell-padrão no Windows - -No Azure Pipelines, o shell-padrão para scripts nas plataformas do Windows é o shell de comando (_cmd.exe_). Em {% data variables.product.prodname_actions %}, o shell-padrão para os scripts nas plataformas do Windows é o PowerShell. O PowerShell tem várias diferenças em comandos integrados, expansão de variáveis e controle de fluxo. - -Se você estiver executando um comando simples, você poderá executar um script do shell do comando no PowerShell sem alterações. No entanto, na maioria dos casos, você deverá atualizar seu script com sintaxe PowerShell ou instruir {% data variables.product.prodname_actions %} para executar o script com a shell de comando em vez de executar o PowerShell. Você pode fazer isso especificando o `shell` como `cmd`. - -Abaixo, há um exemplo da sintaxe para cada sistema: - - - - - - - - - - -
    -Azure Pipelines - -{% data variables.product.prodname_actions %} -
    -{% raw %} -```yaml -trabalhos: -- trabalho: run_command - pool: - vmImage: 'windows-latest' - trabalhos: - - script: echo "Esta etapa é executada em CMD no Windows por padrão" -``` -{% endraw %} - -{% raw %} -```yaml -trabalhos: - run_command: - runs-on: windows-latest - steps: - - executar: echo "Esta etapa é executada no PowerShell no Windows por padrão" - - executar: echo "Esta etapa é executada em CMD no Windows explicitamente" - shell: cmd -``` -{% endraw %} -
    - -Para obter mais informações, consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#using-a-specific-shell)". - -### Migrar condicionais e sintaxe de expressão - -O Azure Pipelines e {% data variables.product.prodname_actions %} podem executar as etapas condicionalmente. No Azure Pipelines, expressões condicionais são especificadas usando a chave `condição`. Em {% data variables.product.prodname_actions %}, as expressões condicionais são especificadas usando a chave `se`. - -O Azure Pipelines usa funções dentro de expressões para executar as etapas condicionalmente. Em contrapartida, {% data variables.product.prodname_actions %} usa uma notação de infixo. Por exemplo, você deve substituir a função `eq` no Azure Pipelines pelo operador `==` em {% data variables.product.prodname_actions %}. - -Abaixo, há um exemplo da sintaxe para cada sistema: - - - - - - - - - - -
    -Azure Pipelines - -{% data variables.product.prodname_actions %} -
    -{% raw %} -```yaml -trabalhos: -- trabalho: condicional - pool: - vmImage: 'ubuntu-latest' - etapas: - - script: echo "Esta etapa é executada com str equals 'ABC' and num equals 123" - condição: and(eq(variables.str, 'ABC'), eq(variables.num, 123)) -``` -{% endraw %} - -{% raw %} -```yaml -trabalhos: - condicional: - runs-on: ubuntu-latest - etapas: - - executar: echo "Esta etapa é executada com str equals 'ABC' and num equals 123" - if: ${{ env.str == 'ABC' && env.num == 123 }} -``` -{% endraw %} -
    - -Para obter mais informações, consulte "[Contexto e sintaxe de expressão para {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)". - -### Dependências entre trabalhos - -Tanto o Pipelines Azure quanto o {% data variables.product.prodname_actions %} permitem que você defina as dependências para um trabalho. Em ambos os sistemas, os trabalhos são executados em paralelo por padrão, mas as dependências do trabalho podem ser especificadas explicitamente. No Azure Pipelines, isso é feito com a chave `dependsOn`. Em {% data variables.product.prodname_actions %}, isso é feito com a chave `needs`. - -Abaixo, há um exemplo da sintaxe para cada sistema. O fluxo de trabalho inicia um primeiro trabalho denominado `inicial` e, quando esse trabalho é concluído, dois trabalhos denominados `fanout1` e `fanout2` serão executados. Por fim, quando esses trabalhos forem concluídos, o trabalho `fanin` será executado. - - - - - - - - - - -
    -Azure Pipelines - -{% data variables.product.prodname_actions %} -
    -{% raw %} -```yaml -trabalhos: -- trabalho: inicial - pool: - vmImage: 'ubuntu-latest' - etapas: - - script: echo "Este trabalho será executado primeiro." -- trabalho: fanout1 - pool: - vmImage: 'ubuntu-latest' - dependsOn: inicial - etapas: - - script: echo "Este trabalho será executado após o trabalho inicial, em paralelo com o fanout2." -- trabalho: fanout2 - pool: - vmImage: 'ubuntu-latest' - dependsOn: inicial - etapas: - - script: echo "Este trabalho será executado após o trabalho inicial, em paralelo com fanout1." -- trabalho: fanin: - pool: - vmImage: 'ubuntu-latest' - dependsOn: [fanout1, fanout2] - etapas: - - script: echo "Este trabalho será executado após fanout1 e fanout2 serem concluídos." -``` -{% endraw %} - -{% raw %} -```yaml -trabalhos: - inicial: - runs-on: ubuntu-latest - etapas: - - executar: echo "Este trabalho será executado primeiro." - fanout1: - runs-on: ubuntu-latest - needs: inicial - etapas: - - run: echo "Este trabalho será executado após o trabalho inicial, em paralelo com fanout2." - fanout2: - runs-on: ubuntu-latest - needs: inicial - etapas: - - run: echo "Este trabalho será executado após o trabalho inicial, em paralelo com fanout1." - fanin: - runs-on: ubuntu-latest - needs: [fanout1, fanout2] - etapas: - - executar: echo "Este trabalho será executado após fanout1 e fanout2 serem concluídos." -``` -{% endraw %} -
    - -Para obter mais informações, consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)". - -### Migrar tarefas para ações - -O Azure Pipelines usa as _tarefas_, que são componentes do aplicativo que podem ser reutilizados em vários fluxos de trabalho. O {% data variables.product.prodname_actions %} usa as _ações_, que podem ser usadas para realizar tarefas e personalizar seu fluxo de trabalho. Em ambos os sistemas, é possível especificar o nome da tarefa ou ação a executar, junto com quaisquer entradas necessárias como pares chave/valor. - -Abaixo, há um exemplo da sintaxe para cada sistema: - - - - - - - - - - -
    -Azure Pipelines - -{% data variables.product.prodname_actions %} -
    -{% raw %} -```yaml -trabalhos: -- trabalho: run_python - pool: - vmImage: 'ubuntu-latest' - etapas: - - tarefa: UsePythonVersion@0 - entradas: - versionSpec: '3.7' - architecture: 'x64' - - script: python script.py -``` -{% endraw %} - -{% raw %} -```yaml -trabalhos: - run_python: - runs-on: ubuntu-latest - etapas: - - usa: actions/setup-python@v2 - com: - python-version: '3.7' - arquitetura: 'x64' - - executar: python script.py -``` -{% endraw %} -
    - -Você pode encontrar ações que podem ser usadas em seu fluxo de trabalho em [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace?type=actions) ou você pode criar suas próprias ações. Para obter mais informações, consulte "[Criar ações](/actions/creating-actions)". - diff --git a/translations/pt-BR/content/actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions.md b/translations/pt-BR/content/actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions.md deleted file mode 100644 index 9661bdef05be..000000000000 --- a/translations/pt-BR/content/actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions.md +++ /dev/null @@ -1,445 +0,0 @@ ---- -title: Migrar do CircleCI para o GitHub Actions -intro: 'O GitHub Actions e o CircleCI compartilham várias semelhanças em termos de configuração, o que torna a migração para o GitHub Actions relativamente fácil.' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Introdução - -O CircleCI e {% data variables.product.prodname_actions %} permitem criar fluxos de trabalho que criam, testam, publicam, lançam e implementam código automaticamente. O CircleCI e o {% data variables.product.prodname_actions %} compartilham algumas semelhanças em termos de configuração do fluxo de trabalho: - -- Os arquivos de configuração do fluxo de trabalho são gravados no YAML e armazenados no repositório. -- Os fluxos de trabalho incluem um ou mais trabalhos. -- Os trabalhos incluem uma ou mais etapas ou comandos individuais. -- É possível reutilizar e compartilhar novamente etapas ou tarefas com a comunidade. - -Para obter mais informações, consulte "[Conceitos básicos para {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)". - -### Principais diferenças - -Ao fazer a migração do CircleCI, considere as seguintes diferenças: - -- O paralelismo do teste automático do CircleCI agrupa automaticamente os testes de acordo com regras especificadas pelo usuário ou com informações históricas de temporização. Esta funcionalidade não foi criada em {% data variables.product.prodname_actions %}. -- As ações que são executadas em contêineres Docker são sensíveis a problemas de permissões, uma vez que os contêineres têm um mapeamento diferente de usuários. Você pode evitar muitos desses problemas se não usar a instrução `USUÁRIO` no seu *arquivo Docker*. Para obter mais informações sobre o sistema de arquivos Docker, consulte "[Ambientes virtuais para executores hospedados em {% data variables.product.product_name %}](/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem)". - -### Migrar fluxos de trabalhos e trabalhos - -O CircleCI define os `fluxos de trabalho` no arquivo *config.yml*, o que permite configurar mais de um fluxo de trabalho. O {% data variables.product.product_name %} exige um arquivo de fluxo de trabalho por fluxo de trabalho e, consequentemente, não exige que você declare os `fluxos de trabalho`. Será necessário criar um novo arquivo de fluxo de trabalho para cada fluxo de trabalho configurado em *config.yml*. - -Tanto o CircleCI quanto o {% data variables.product.prodname_actions %} configuram `trabalhos` no arquivo de configuração usando uma sintaxe similar. Se você configurar qualquer dependência entre trabalhos usando `requires` em seu fluxo de trabalho CircleCI, você poderá usar a sintaxe equivalente {% data variables.product.prodname_actions %} `needs`. Para obter mais informações, consulte "[Sintaxe de fluxo de trabalho para o {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)". - -### Migrar orbes para ações - -Tanto o CircleCI quanto o {% data variables.product.prodname_actions %} fornecem um mecanismo para reutilizar e compartilhar tarefas em um fluxo de trabalho. O CircleCI usa um conceito chamado orbs, escrito em YAML, para fornecer tarefas que as pessoas podem reutilizar em um fluxo de trabalho. O {% data variables.product.prodname_actions %} tem componentes potentes, reutilizáveis e flexíveis denominados ações, que você cria com arquivos JavaScript ou imagens Docker. Você pode criar ações gravando códigos personalizados que interajam com o seu repositório da maneira que você quiser, inclusive fazendo integrações com as APIs do {% data variables.product.product_name %} e qualquer API de terceiros disponível publicamente. Por exemplo, as ações podem publicar módulos npm, enviar alertas SMS quando problemas urgentes forem criados ou implantar códigos prontos para produção. Para obter mais informações, consulte "[Criar ações](/actions/creating-actions)". - -O CircleCI pode reutilizar partes dos fluxos de trabalho com âncoras e aliases YAML. O {% data variables.product.prodname_actions %} suporta a necessidade mais comum de reutilização usando matrizes de criação. Para obter mais informações sobre matrizes de criação, consulte "[Configurando um fluxo de trabalho](/actions/configuring-and-managing-workflows/configuring-a-workflow#configuring-a-build-matrix)". - -### Usar imagens do Docker - - -Tanto o CircleCI quanto o {% data variables.product.prodname_actions %} suportam executar etapas dentro de uma imagem do Docker. - -O CircleCI fornece um conjunto de imagens pré-construídas com dependências comuns. Estas imagens têm o `USUÁRIO` definido como `circleci`, o que faz com que as permissões entrem em conflito com {% data variables.product.prodname_actions %}. - -Recomendamos que você se afaste das imagens pré-criadas do CircleCI, ao migrar para {% data variables.product.prodname_actions %}. Em muitos casos, você pode usar ações para instalar as dependências adicionais de que você precisa. - -Para obter mais informações sobre o sistema de arquivos Docker, consulte "[Ambientes virtuais para executores hospedados em {% data variables.product.product_name %}](/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem)". - -Para obter mais informações sobre ferramentas e pacotes disponíveis em ambientes virtuais hospedados em {% data variables.product.prodname_dotcom %}, consulte "[Software instalado em executores hospedados no GitHub](/actions/reference/software-installed-on-github-hosted-runners)". - -### Usar variáveis e segredos - -O CircleCI e o {% data variables.product.prodname_actions %} suportam configurações das variáveis de ambiente no arquivo de configuração e criação de segredos usando o CircleCI ou a interface de usuário do {% data variables.product.product_name %}. - -Para obter mais informações, consulte "[Usar variáveis de ambiente](/actions/configuring-and-managing-workflows/using-environment-variables)" e "[Criar e usar segredos encriptados](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)". - -### Armazenar em cache - -O CircleCI e o {% data variables.product.prodname_actions %} fornecem um método para armazenar arquivos de cache no arquivo de configuração manualmente. - -Abaixo, há um exemplo da sintaxe para cada sistema. - - - - - - - - - - -
    -CircleCI - -GitHub Actions -
    -{% raw %} -```yaml -- restore_cache: - keys: - - v1-npm-deps-{{ checksum "package-lock.json" }} - - v1-npm-deps- -``` -{% endraw %} - -{% raw %} -```yaml -- nome: Módulos do nó da cache - usa: actions/cache@v2 - com: - caminho: ~/.npm - key: v1-npm-deps-${{ hashFiles('**/package-lock.json') }} - restore-keys: v1-npm-deps- -``` -{% endraw %} -
    - -Para obter mais informações, consulte "[Memorizando dependências para acelerar fluxos de trabalho](/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows)". - -{% data variables.product.prodname_actions %} não tem o equivalente ao Docker Layer Caching (DLC) do CircleCI. - -### Dados persistentes entre trabalhos - -Tanto a CircleCI quanto a {% data variables.product.prodname_actions %} fornecem mecanismos para persistir dados entre trabalhos. - -Abaixo está um exemplo no CircleCI e na sintaxe de configuração do {% data variables.product.prodname_actions %}. - - - - - - - - - - -
    -CircleCI - -GitHub Actions -
    -{% raw %} -```yaml -- persist_to_workspace: - root: workspace - paths: - - math-homework.txt - -... - -- attach_workspace: - at: /tmp/workspace -``` -{% endraw %} - -{% raw %} -```yaml -- name: Upload math result for job 1 - uses: actions/upload-artifact@v2 - with: - name: homework - path: math-homework.txt - -... - -- name: Download math result for job 1 - uses: actions/download-artifact@v2 - with: - name: homework -``` -{% endraw %} -
    - -Para obter mais informações, consulte "[Dados persistentes do fluxo de trabalho que usam artefatos](/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts)". - -### Usar bancos de dados e contêineres de serviço - -Ambos os sistemas permitem que você inclua contêineres adicionais para bases de dados, memorização ou outras dependências. - -No CircleCI, a primeira imagem listada no *config.yaml* é a imagem principal usada para executar comandos. O {% data variables.product.prodname_actions %} usa seções explícitas: usa o`contêiner` para o contêiner primário e lista contêineres adicionais em `serviços`. - -Abaixo está um exemplo no CircleCI e na sintaxe de configuração do {% data variables.product.prodname_actions %}. - - - - - - - - - - -
    -CircleCI - -GitHub Actions -
    -{% raw %} -```yaml ---- -version: 2.1 - -trabalhos: - - ruby-26: - docker: - - image: circleci/ruby:2.6.3-node-browsers-legacy - ambiente: - PGHOST: localhost - PGUSER: administrate - RAILS_ENV: test - - imagem: postgres:10.1-alpine - ambiente: - POSTGRES_USER: administrate - POSTGRES_DB: ruby26 - POSTGRES_PASSWORD: "" - - working_directory: ~/administrate - - steps: - - checkout - - # Agrupar a instalação de dependências - - run: bundle install --path vendor/bundle - - # Aguardar DB - - executar: dockerize -wait tcp://localhost:5432 -timeout 1m - - # Configurar o ambiente - - run: cp .sample.env .env - - # Configurar o banco de dados - - run: bundle exec rake db:setup - - # Executar os testes - - run: bundle exec rake - - -fluxos de trabalho: - version: 2 - criar: - trabalhos: - - ruby-26 -... - -- attach_workspace: - at: /tmp/workspace -``` -{% endraw %} - -{% raw %} -```yaml -nome: Contêineres - -em: [push] - -trabalhos: - construir: - - runs-on: ubuntu-latest - contêiner: circleci/ruby:2.6.3-node-browsers-legacy - - env: - PGHOST: postgres - PGUSER: administrate - RAILS_ENV: test - - serviços: - postgres: - imagem: postgres:10.1-alpine - env: - POSTGRES_USER: administrate - POSTGRES_DB: ruby25 - POSTGRES_PASSWORD: "" - portas: - - 5432:5432 - # Adicionar uma verificação geral - opções: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 5 - - etapas: - # Este arquivo Docker altera as configurações de USUÁRIO para circleci em vez de usar o usuário-padrão. Portanto, precisamos atualizar as permissões do arquivo para esta imagem funcionar no Actions. - # Veja https://docs.github.com/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem - - name: Configurar permissões do sistema de arquivos - run: sudo chmod -R 777 $GITHUB_WORKSPACE /github /__w/_temp - - uses: actions/checkout@v2 - - name: Instalar dependências - run: bundle install --path vendor/bundle - - name: Configuração do ambiente de instalação - run: cp .sample.env .env - - name: Configurar banco de dados - run: bundle exec rake db:setup - - name: Executar testes - run: bundle exec rake -``` -{% endraw %} -
    - -Para obter mais informações, consulte "[Sobre contêineres de serviço](/actions/configuring-and-managing-workflows/about-service-containers)". - -### Exemplo completo - -Abaixo, há um exemplo concreto. O lado esquerdo mostra o CircleCI *config.yml* atual para o repositório [thoughtbot/administrador](https://github.com/thoughtbot/administrate). O lado direito mostra o equivalente {% data variables.product.prodname_actions %}. - - - - - - - - - - -
    -CircleCI - -GitHub Actions -
    -{% raw %} -```yaml ---- -versão: 2.1 - -comandos: - shared_steps: - etapas: - - checkout - - # Restaurar dependências memorizadas - - restore_cache: - nome: Restore bundle cache - chave: administrate-{{ checksum "Gemfile.lock" }} - - # Agrupar instalação de dependências - - executar: bundle install --path vendor/bundle - - # Memorizar dependências - - save_cache: - nome: Armazenar agrupamento da cache - chave: administrate-{{ checksum "Gemfile.lock" }} - caminho: - - vendor/bundle - - # Aguardar DB - - executar: dockerize -wait tcp://localhost:5432 -timeout 1m - - # Configurar o ambiente - - executar: cp .sample.env .env - - # Configurar o ambiente - - executar: bundle exec rake db:setup - - # Executar os testes - - executar: bundle exec rake - -default_job: &default_job - working_directory: ~/administrate - etapas: - - shared_steps - # Executar os testes com múltiplas versões do Rails - - executar: bundle exec appraisal install - - executar: bundle exec appraisal rake - -trabalhos: - ruby-25: - <<: *default_job - docker: - - image: circleci/ruby:2.5.0-node-browsers - environment: - PGHOST: localhost - PGUSER: administrate - RAILS_ENV: test - - image: postgres:10.1-alpine - environment: - POSTGRES_USER: administrate - POSTGRES_DB: ruby25 - POSTGRES_PASSWORD: "" - - ruby-26: - <<: *default_job - docker: - - image: circleci/ruby:2.6.3-node-browsers-legacy - environment: - PGHOST: localhost - PGUSER: administrate - RAILS_ENV: test - - image: postgres:10.1-alpine - environment: - POSTGRES_USER: administrate - POSTGRES_DB: ruby26 - POSTGRES_PASSWORD: "" - - -fluxos de trabalho: - versão: 2 - multiple-rubies: - trabalhos: - - ruby-26 - - ruby-25 -``` -{% endraw %} - -{% raw %} -```yaml -nome: Contêineres - -em: [push] - -trabalhos: - criar: - - estratégia: - matriz: - ruby: [2.5, 2.6.3] - - runs-on: ubuntu-latest - - env: - PGHOST: localhost - PGUSER: administrate - RAILS_ENV: test - - serviços: - postgres: - imagem: postgres:10.1-alpine - env: - POSTGRES_USER: administrate - POSTGRES_DB: ruby25 - POSTGRES_PASSWORD: "" - portas: - - 5432:5432 - # Adicionar verificação geral - options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 5 - - etapas: - - usa: actions/checkout@v2 - - nome: Configurar Ruby - usa: eregon/use-ruby-action@master - com: - ruby-version: ${{ matrix.ruby }} - - nome: Memorizar dependências - usa: actions/cache@v2 - com: - caminho: vendor/bundle - chave: administrate-${{ matrix.image }}-${{ hashFiles('Gemfile.lock') }} - - nome: Instalar títulos do postgres - executar : sudo apt-get install libpq-dev - - nome: Install dependencies - executar : bundle install --path vendor/bundle - - Nome: Definir configuração do ambiente - executar: cp .sample.env .env - - nome: Configurar banco de dados - executar: bundle exec rake db:setup - - nome: Executar testes - executar: bundle exec rake - - nome: Install appraisal - executar: bundle exec appraisal install - - Nome: Run appraisal - executar: bundle exec appraisal rake -``` -{% endraw %} -
    diff --git a/translations/pt-BR/content/actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions.md b/translations/pt-BR/content/actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions.md deleted file mode 100644 index e695598dacf4..000000000000 --- a/translations/pt-BR/content/actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions.md +++ /dev/null @@ -1,291 +0,0 @@ ---- -title: Migrar do Jenkins para o GitHub Actions -intro: 'O {% data variables.product.prodname_actions %} e o Jenkins compartilham múltiplas semelhanças, o que torna a migração para {% data variables.product.prodname_actions %} relativamente simples.' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Introdução - -O Jenkins e o {% data variables.product.prodname_actions %} permitem criar fluxos de trabalho que criam, testam, publicam, lançam e implementam código automaticamente. O Jenkins e o {% data variables.product.prodname_actions %} compartilham algumas semelhanças em termos de configuração do fluxo de trabalho: - -- O Jenkins cria fluxos de trabalho usando _Declarative Pipelines_, que são semelhantes aos arquivos do fluxo de trabalho {% data variables.product.prodname_actions %}. -- O Jenkins usa _stages_ para executar uma coleção de etapas, enquanto o {% data variables.product.prodname_actions %} usa trabalhos para agrupar uma ou mais etapas ou comandos individuais. -- O Jenkins e o {% data variables.product.prodname_actions %} são compatíveis com criações baseadas em contêineres. Para obter mais informações, consulte "[Criar uma ação de contêiner do Docker](/articles/creating-a-docker-container-action)". -- É possível reutilizar e compartilhar novamente etapas ou tarefas com a comunidade. - -Para obter mais informações, consulte "[Conceitos básicos para {% data variables.product.prodname_actions %}](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)". - -### Principais diferenças - -- O Jenkins tem dois tipos de sintaxe para a criação de pipelines: Declarative Pipeline e Scripted Pipeline. O {% data variables.product.prodname_actions %} usa o YAML para criar fluxos de trabalho e arquivos de configuração. Para obter mais informações, consulte "[Sintaxe do fluxo de trabalho para o GitHub Actions](/actions/reference/workflow-syntax-for-github-actions)". -- As implementações do Jenkins são tipicamente auto-hospedadas, com usuários mantendo os servidores em seus próprios centros de dados. O {% data variables.product.prodname_actions %} oferece uma abordagem de nuvem híbrida, hospedando seus próprios executores que você pode usar para executar trabalhos, ao mesmo tempo em que também oferece suporte aos executores auto-hospedados. Para obter mais informações, consulte [Sobre os executores auto-hospedados](/actions/hosting-your-own-runners/about-self-hosted-runners). - -### Comparar recursos - -#### Distribuir suas criações - -O Jenkins permite que se envie criações para um único agente de criação, ou você pode distribuí-las entre vários agentes. Você também pode classificar esses agentes de acordo com vários atributos, como, por exemplo, tipos de sistema operacional. - -De modo similar, o {% data variables.product.prodname_actions %} pode enviar trabalhos para executores hospedados em {% data variables.product.prodname_dotcom %} ou executores auto-hospedados, e você pode usar as etiquetas para classificar os executores de acordo com vários atributos. A tabela a seguir compara como o conceito de criação distribuída é implementado tanto para o Jenkins e quanto para o {% data variables.product.prodname_actions %}. - -| Jenkins | {% data variables.product.prodname_actions %} | -| ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| [`agentes`](https://wiki.jenkins.io/display/JENKINS/Distributed+builds) | [`executores`](/actions/getting-started-with-github-actions/core-concepts-for-github-actions#runner)
    [`executores auto-hospedados`](/actions/hosting-your-own-runners/about-self-hosted-runners) | - -#### Usar seções para organizar pipelines - -O Jenkins divide seus Declarative Pipelines em múltiplas seções. De forma similar, o {% data variables.product.prodname_actions %} organiza seus fluxos de trabalho em seções separadas. A tabela abaixo compara as seções do Jenkins com o fluxo de trabalho {% data variables.product.prodname_actions %}. - -| Diretivas do Jenkins | {% data variables.product.prodname_actions %} | -| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| [`agente`](https://jenkins.io/doc/book/pipeline/syntax/#agent) | [`jobs..runs-on`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idruns-on)
    [`jobs..container`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idcontainer) | -| [`post`](https://jenkins.io/doc/book/pipeline/syntax/#post) | | -| [`stages`](https://jenkins.io/doc/book/pipeline/syntax/#stages) | [`jobs`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobs) | -| [`steps`](https://jenkins.io/doc/book/pipeline/syntax/#steps) | [`jobs..steps`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idsteps) | - - -### Usar diretivas - -O Jenkins usa diretivas para gerenciar os _Declarative Pipelines_. Essas diretivas definem as características do seu fluxo de trabalho e como ele será executado. A tabela abaixo demonstra como estas diretivas são mapeadas com conceitos dentro do {% data variables.product.prodname_actions %}. - -| Diretivas do Jenkins | {% data variables.product.prodname_actions %} | -| ---------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [`ambiente`](https://jenkins.io/doc/book/pipeline/syntax/#environment) | [`jobs..env`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#env)
    [`jobs..steps.env`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsenv) | -| [`options`](https://jenkins.io/doc/book/pipeline/syntax/#parameters) | [`jobs..strategy`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategy)
    [`jobs..strategy.fail-fast`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategyfail-fast)
    [`jobs..timeout-minutes`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idtimeout-minutes) | -| [`parâmetros`](https://jenkins.io/doc/book/pipeline/syntax/#parameters) | [`entradas`](/actions/creating-actions/metadata-syntax-for-github-actions#inputs)
    [`saídas`](/actions/creating-actions/metadata-syntax-for-github-actions#outputs) | -| [`gatilhos`](https://jenkins.io/doc/book/pipeline/syntax/#triggers) | [`em`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#on)
    [`on..types`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onevent_nametypes)
    [on..](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onpushpull_requestbranchestags)
    [on..paths](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onpushpull_requestpaths) | -| [`aciona { upstreamprojects() }`](https://jenkins.io/doc/book/pipeline/syntax/#triggers) | [`jobs..needs`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idneeds) | -| [Sintaxe cron do Jenkins](https://jenkins.io/doc/book/pipeline/syntax/#cron-syntax) | [`on.schedule`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onschedule) | -| [`stage`](https://jenkins.io/doc/book/pipeline/syntax/#stage) | [`jobs.`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_id)
    [`jobs..name`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idname) | -| [`tools`](https://jenkins.io/doc/book/pipeline/syntax/#tools) | [Software instalado em executores hospedados no GitHub](/actions/reference/software-installed-on-github-hosted-runners) | -| [`entrada`](https://jenkins.io/doc/book/pipeline/syntax/#input) | [`inputs`](/actions/automating-your-workflow-with-github-actions/metadata-syntax-for-github-actions#inputs) | -| [`quando`](https://jenkins.io/doc/book/pipeline/syntax/#when) | [`jobs..if`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idif) | - - -### Usar estágios sequenciais - -#### Processamento paralelo do trabalho - -O Jenkins pode executar os `stages` e as `etapas` em paralelo, enquanto o {% data variables.product.prodname_actions %} está executando os trabalhos em paralelo. - -| Jenkins em paralelo | {% data variables.product.prodname_actions %} | -| ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [`paralelo`](https://jenkins.io/doc/book/pipeline/syntax/#parallel) | [`jobs..strategy.max-parallel`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymax-parallel) | - -#### Criar matriz - -Tanto o {% data variables.product.prodname_actions %} quanto o Jenkins permitem que você use uma matriz de criação para definir várias combinações de sistema. - -| Jenkins | {% data variables.product.prodname_actions %} | -| ---------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [`eixo`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-axes) | [`estratégia/matriz`](/actions/configuring-and-managing-workflows/configuring-a-workflow#configuring-a-build-matrix)
    [`contexto`](/actions/reference/context-and-expression-syntax-for-github-actions) | -| [`stages`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-stages) | [`steps-context`](/actions/reference/context-and-expression-syntax-for-github-actions#steps-context) | -| [`exclui`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-stages) | | - -#### Usar passos para executar tarefas - -O Jenkins agrupa as `etapas` em `stages`. Cada uma dessas etapas pode ser um script, função ou comando, entre outros. Da mesma forma, o {% data variables.product.prodname_actions %} usa `trabalhos` para executar grupos específicos de `etapas`. - -| Etapas do Jenkins | {% data variables.product.prodname_actions %} | -| --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | -| [`script`](https://jenkins.io/doc/book/pipeline/syntax/#script) | [`jobs..steps`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idsteps) | - -### Exemplos de tarefas comuns - -#### Agendar um pipeline para ser executado com `cron` - - - - - - - - - - -
    -Pipeline do Jenkins - -Fluxo de trabalho do {% data variables.product.prodname_actions %} -
    - - ```yaml - pipeline { - agent any - triggers { - cron('H/15 * * * 1-5') - } - } - ``` - - - - ```yaml - on: - schedule: - - cron: '*/15 * * * 1-5' - ``` - -
    - -#### Configurar variáveis de ambiente em um pipeline - - - - - - - - - - -
    -Pipeline do Jenkins - -Fluxo de trabalho do {% data variables.product.prodname_actions %} -
    - - ```yaml - pipeline { - agent any - environment { - MAVEN_PATH = '/usr/local/maven' - } - } - ``` - - - - ```yaml - jobs: - maven-build: - env: - MAVEN_PATH: '/usr/local/maven' - - ``` - -
    - -#### Criar projetos projetos de upstream - - - - - - - - - - -
    -Pipeline do Jenkins - -Fluxo de trabalho do {% data variables.product.prodname_actions %} -
    - - ```yaml - pipeline { - triggers { - upstream( - upstreamProjects: 'job1,job2', - threshold: hudson.model.Result.SUCCESS) - } - } - } - - ``` - - - - ```yaml - jobs: - job1: - job2: - needs: job1 - job3: - needs: [job1, job2] - - ``` - -
    - -#### Criar com vários sistemas operacionais - - - - - - - - - - -
    -Pipeline do Jenkins - -Fluxo de trabalho do {% data variables.product.prodname_actions %} -
    - - ```yaml -pipeline { - agent none - stages { - stage('Run Tests') { - parallel { - stage('Test On MacOS') { - agent { label "macos" } - tools { nodejs "node-12" } - steps { - dir("scripts/myapp") { - sh(script: "npm install -g bats") - sh(script: "bats tests") - } - } - } - stage('Test On Linux') { - agent { label "linux" } - tools { nodejs "node-12" } - steps { - dir("script/myapp") { - sh(script: "npm install -g bats") - sh(script: "bats tests") - } - } - } - } - } - } -} - ``` - - - -{% raw %} - ```yaml - nome: demo-workflow - em: - push: - trabalhos: - teste: - runs-on: ${{ matrix.os }} - estratégia: - fail-fast: false - matriz: - os: [macos-latest, ubuntu-latest] - etapas: - - usa: actions/checkout@v1 - - usa: actions/setup-node@v1 - com: - node-version: 12 - - executar: npm install -g bats - - executar: bats tests - working-directory: scripts/myapp - ``` -{% endraw %} - -
    diff --git a/translations/pt-BR/content/actions/publishing-packages-with-github-actions/about-packaging-with-github-actions.md b/translations/pt-BR/content/actions/publishing-packages-with-github-actions/about-packaging-with-github-actions.md deleted file mode 100644 index 1fca608573f2..000000000000 --- a/translations/pt-BR/content/actions/publishing-packages-with-github-actions/about-packaging-with-github-actions.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: Sobre o empacotamento com GitHub Actions -intro: 'Você pode configurar fluxos de trabalho em {% data variables.product.prodname_actions %} para produzir pacotes e fazer o upload em {% data variables.product.prodname_registry %} ou em outro fornecedor de hospedagem do pacote.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/about-packaging-with-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Sobre as etapas do empacotamento - -Uma etapa de empacotamento é uma parte comum de um fluxo de trabalho de integração contínua ou de continuous delivery. Após criar e testar o seu aplicativo, será produzido um artefato executável ou aplicável produzido na forma de um pacote. Por exemplo, um fluxo de trabalho de integração contínua para um projeto Java pode executar o `pacote mvn` para produzir um arquivo JAR. Ou um fluxo de trabalho CI para um aplicativo Node.js pode criar um contêiner Docker. - -Dependendo do tipo de aplicativo que você estiver criando, este pacote pode ser baixado localmente para teste manual, disponibilizado para download dos usuários ou implementado em um ambiente de teste ou produção. - -### Empacotamento em fluxos de trabalho de integração contínua - -Criar um pacote ao fim de um fluxo de trabalho de integração contínua pode ajudar durante as análises de código ou durante o pull request. Após criar e testar o seu código, uma etapa de empacotamento pode produzir um artefato executável ou aplicável. Em seguida, o seu fluxo de trabalho pode pegar esse artefato e fazer o upload como parte do fluxo de trabalho. - -Agora, ao revisar um pull request, você poderá ver a execução do fluxo de trabalho e fazer o download do artefato produzido. - -![Menu suspenso do para fazer download do artefato](/assets/images/help/repository/artifact-drop-down.png) - -Isso permitirá que você execute o código no pull request em sua máquina, o que pode ajudar a depurar ou testar o pull request. - -### Fluxos de trabalho para publicação de pacotes - -Além de fazer o upload dos artefatos de empacotamento para teste em um fluxo de trabalho de integração contínua, você poderá criar fluxos de trabalho que criam o seu projeto e publicam pacotes no pacote de registro. - -* **A publicação de pacotes em {% data variables.product.prodname_registry %}** - {% data variables.product.prodname_registry %} pode funcionar como um serviço de hospedagem de pacote para muitos tipos de pacote. Você pode escolher compartilhar os seus pacotes com todos {% data variables.product.prodname_dotcom %} ou compartilhar pacotes privados com colaboradores ou uma organização. Para obter mais informações, consulte "[Sobre {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/about-github-packages)." - - Você pode desejar publicar pacotes em {% data variables.product.prodname_registry %} em cada push no branch-mestre. Isso fará com que os desenvolvedores no seu projeto sempre consigam executar e testar facilmente a última criação feita a partir do mestre, instalando-a a partir de {% data variables.product.prodname_registry %}. - -* **Publicar pacotes em um registro de pacote** Para muitos projetos, a publicação de um registro de pacote é realizada sempre que uma versão nova de um projeto é lançada. Por exemplo, um projeto que produz um arquivo JAR pode fazer o upload de novas versões no repositório central do Maven. Ou um projeto .NET pode produzir um pacote nuget e fazer o upload na Galeria NuGet. - - Você pode automatizar isso criando um fluxo de trabalho que publica pacotes em um registro de pacote em cada versão. Para obter mais informações, consulte "[Criando versões](/github/administering-a-repository/creating-releases)." - -### Leia mais - -- "[Publicando pacotes Node.js](/actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages)" diff --git a/translations/pt-BR/content/actions/publishing-packages-with-github-actions/index.md b/translations/pt-BR/content/actions/publishing-packages-with-github-actions/index.md deleted file mode 100644 index b766220a6629..000000000000 --- a/translations/pt-BR/content/actions/publishing-packages-with-github-actions/index.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: Publicar pacotes com o GitHub Actions -shortTitle: Publicar pacotes -intro: 'Criar e publicar pacotes para {% data variables.product.prodname_registry %} ou outro provedor de hospedagem de pacotes.' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -{% link_in_list /about-packaging-with-github-actions %} diff --git a/translations/pt-BR/content/actions/reference/software-installed-on-github-hosted-runners.md b/translations/pt-BR/content/actions/reference/software-installed-on-github-hosted-runners.md deleted file mode 100644 index f7ec1734e954..000000000000 --- a/translations/pt-BR/content/actions/reference/software-installed-on-github-hosted-runners.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: Software instalado em executores hospedados no GitHub -intro: 'Este artigo faz vínculos com as referências para os pacotes e ferramentas disponíveis nos ambientes virtuais hospedados no {% data variables.product.prodname_dotcom %}.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/software-in-virtual-environments-for-github-actions - - /github/automating-your-workflow-with-github-actions/software-in-virtual-environments-for-github-actions - - /github/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners - - /actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -As ferramentas incluídas nos executores hospedados no {% data variables.product.prodname_dotcom %} são atualizadas semanalmente. Para a lista mais recente das ferramentas incluídas para cada sistema operacional do executor, consulte os links abaixo: - -* [Ubuntu 20.04 LTS](https://github.com/actions/virtual-environments/blob/master/images/linux/Ubuntu2004-README.md) -* [Ubuntu 18.04 LTS](https://github.com/actions/virtual-environments/blob/master/images/linux/Ubuntu1804-README.md) -* [Ubuntu 16.04 LTS](https://github.com/actions/virtual-environments/blob/master/images/linux/Ubuntu1604-README.md) -* [Windows Server 2019](https://github.com/actions/virtual-environments/blob/master/images/win/Windows2019-Readme.md) -* [Windows Server 2016](https://github.com/actions/virtual-environments/blob/master/images/win/Windows2016-Readme.md) -* [MacOS 10.15](https://github.com/actions/virtual-environments/blob/master/images/macos/macos-10.15-Readme.md) - -{% data reusables.github-actions.ubuntu-runner-preview %} - -Executores hospedados no {% data variables.product.prodname_dotcom %} incluem as ferramentas integradas padrão do sistema operacional, além dos pacotes listados nas referências acima. Por exemplo, os executores do Ubuntu e do macOS incluem `grep`, `find` e `which`, entre outras ferramentas-padrão. - -Se houver uma ferramenta que você queira solicitar, abra um problema em [actions/virtual-environments](https://github.com/actions/virtual-environments). diff --git a/translations/pt-BR/content/actions/reference/virtual-environments-for-github-hosted-runners.md b/translations/pt-BR/content/actions/reference/virtual-environments-for-github-hosted-runners.md deleted file mode 100644 index beb4ce7bd5ec..000000000000 --- a/translations/pt-BR/content/actions/reference/virtual-environments-for-github-hosted-runners.md +++ /dev/null @@ -1,131 +0,0 @@ ---- -title: Ambientes virtuais para os executores do GitHub Actions -intro: 'O {% data variables.product.prodname_dotcom %} oferece máquinas virtuais hospedadas para executar fluxos de trabalho. A máquina virtual tem um ambiente de ferramentas, pacotes e configurações disponíveis para uso no {% data variables.product.prodname_actions %}.' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/virtual-environments-for-github-actions - - /github/automating-your-workflow-with-github-actions/virtual-environments-for-github-actions - - /github/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners - - /actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### Sobre os executores hospedados no {% data variables.product.prodname_dotcom %} - -Um executor hospedado no {% data variables.product.prodname_dotcom %} é uma máquina virtual hospedada pelo {% data variables.product.prodname_dotcom %} com o aplicativo do executor {% data variables.product.prodname_actions %} instalado. O {% data variables.product.prodname_dotcom %} oferece executores com os sistemas operacionais Linux, Windows e macOS. - -Ao usar um executor hospedada no {% data variables.product.prodname_dotcom %}, a manutenção e as atualizações da máquina são feitas para você. É possível executar fluxos de trabalho diretamente na máquina virtual ou em um contêiner Docker. - -Você pode especificar o tipo de executor para cada trabalho em um fluxo de trabalho. Cada trabalho em um fluxo de trabalho é executado em uma nova instância da máquina virtual. Todas as etapas de um trabalho são executadas na mesma instância da máquina virtual, o que permite que ações de cada trabalho compartilhem informações usando o sistema de arquivos. - -{% data reusables.github-actions.runner-app-open-source %} - -#### Hosts da nuvem para os executores hospedados em {% data variables.product.prodname_dotcom %} - -O {% data variables.product.prodname_dotcom %} hospeda executores do Linux e Windows no Standard_DS2_v2 máquinas virtuais no Microsoft Azure com o aplicativo do executor {% data variables.product.prodname_actions %} instalado. A o aplicativo do executor hospedado no {% data variables.product.prodname_dotcom %} é uma bifurcação do agente do Azure Pipelines. Os pacotes ICMP de entrada estão bloqueados para todas as máquinas virtuais do Azure. Portanto, é possível que os comandos ping ou traceroute não funcionem. Para obter mais informações sobre os recursos da máquina Standard_DS2_v2, consulte "[Dv2 e DSv2-series](https://docs.microsoft.com/en-us/azure/virtual-machines/dv2-dsv2-series#dsv2-series)" na documentação do Microsoft Azure. - -O {% data variables.product.prodname_dotcom %} usa [MacStadium](https://www.macstadium.com/) para hospedar os executores do macOS. - -#### Privilégios administrativos os executores hospedados no {% data variables.product.prodname_dotcom %} - -As máquinas virtuais Linux e macOS executam usando autenticação sem senha `sudo`. Quando precisar executar comandos ou instalar ferramentas que exigem mais permissões que o usuário atual possui, você pode usar `sudo` sem a necessidade de fornecer uma senha. Para obter mais informações, consulte o "[Manual do Sudo](https://www.sudo.ws/man/1.8.27/sudo.man.html)". - -As máquinas virtuais do Windows estão configuradas para ser executadas como administradores com Controle de Conta de Usuário (UAC) desativado. Para obter mais informações, consulte "[Como funciona o Controle de Conta de Usuário](https://docs.microsoft.com/en-us/windows/security/identity-protection/user-account-control/how-user-account-control-works)" na documentação do Windows. - -### Executores e recursos de hardware compatíveis - -Cada máquina virtual tem os mesmos recursos de hardware disponíveis. - -- CPU dual core -- 7 GB de memória RAM -- 14 GB de espaço de disco SSD - -{% data reusables.github-actions.supported-github-runners %} - -{% data reusables.github-actions.ubuntu-runner-preview %} - -Para obter uma lista de softwares, ferramentas e pacotes para cada executor, consulte "[Software instalado em executores hospedados em {% data variables.product.prodname_dotcom %}](/actions/reference/software-installed-on-github-hosted-runners)". - -Você pode visualizar os registros de uma execução do fluxo de trabalho para ver o ambiente exato do executor usado para um trabalho, bem como um link para as ferramentas pré-instaladas que estavam no executor. Para obter mais informações, consulte "[Gerenciar a execução de fluxos de trabalho](/actions/configuring-and-managing-workflows/managing-a-workflow-run#viewing-your-workflow-history)". - - -#### Os endereços IP dos executores hospedados no {% data variables.product.prodname_dotcom %} - -{% note %} - -**Observação:** Se você usar uma lista de permissões de endereço IP para a sua organização ou conta corporativa de {% data variables.product.prodname_dotcom %}, você não poderá usar executores hospedados em {% data variables.product.prodname_dotcom %}. Em vez disso, deverá usar executores auto-hospedados. Para obter mais informações, consulte "[Sobre os executores auto-hospedados](/actions/hosting-your-own-runners/about-self-hosted-runners)." - -{% endnote %} - -Executores do Windows e Ubuntu são hospedados no Azure e têm os mesmos intervalos de endereços IP dos centros de dados Azure. Atualmente, todos os executores hospedados em {% data variables.product.prodname_dotcom %} do Windows e Ubuntu encontram-se nas seguintes regiões do Azure: - -- Leste dos EUA (`eastus`) -- Leste dos EUA 2 (`eastus2`) -- Oeste dos EU 2 (`westus2`) -- Centro dos EUA (`centralus`) -- Centro-sul dos EUA (`southcentralus`) - -A Microsoft atualiza os intervalos de endereços IP Azure semanalmente em um arquivo JSON que você pode baixar no site [Azure intervalos IP e tags de serviço - nuvem pública](https://www.microsoft.com/en-us/download/details.aspx?id=56519). Você pode usar esse intervalo de endereços IP se precisar de uma lista de permissão para evitar acesso não-autorizado em seus recursos internos. - -O arquivo JSON contém um array chamado `values` (valores). Dentro desse array, você pode encontrar os endereços IP suportados em um objeto com `nome` e `id` da região Azure, por exemplo `"AzureCloud. astus2"`. - -Você pode encontrar os intervalos de endereços IP compatíveis no objeto `"addressPrefixes"`. Este é um exemplo resumido do arquivo JSON. - -```json -{ - "changeNumber": 84, - "cloud": "Public", - "values": [ - { - "name": "AzureCloud.eastus2", - "id": "AzureCloud.eastus2", - "properties": { - "changeNumber": 33, - "region": "eastus2", - "platform": "Azure", - "systemService": "", - "addressPrefixes": [ - "13.68.0.0/17", - "13.77.64.0/18", - "13.104.147.0/25", - ... - ] - } - } - ] -} -``` - -### Sistemas de arquivos nos executores hospedados no {% data variables.product.prodname_dotcom %} - -O {% data variables.product.prodname_dotcom %} executa ações e comandos de shell em diretórios específicos na máquina virtual. Os caminhos dos arquivos nas máquinas virtuais não são estáticos. Use as variáveis de ambiente que {% data variables.product.prodname_dotcom %} fornece para construir caminhos de arquivos para os diretórios `home`, `workspace` e `workflow`. - -| Diretório | Variável de ambiente | Descrição | -| --------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `casa` | `HOME` | Contém dados relacionados ao usuário. Por exemplo, esse diretório pode conter credenciais de uma tentativa de login. | -| `área de trabalho` | `GITHUB_WORKSPACE` | As ações e comandos do shell executados neste diretório. Uma ação pode modificar o conteúdo desse diretório, que fica acessível nas ações subsequentes. | -| `workflow/event.json` | `GITHUB_EVENT_PATH` | A carga `POST` do evento webhook que acionou o fluxo de trabalho. O {% data variables.product.prodname_dotcom %} o rescreve sempre que uma ação é executada para isolar o conteúdo do arquivo entre as ações. | - -Para obter uma lista das variáveis de ambiente que {% data variables.product.prodname_dotcom %} cria para cada fluxo de trabalho, consulte "[Usar variáveis de ambiente](/github/automating-your-workflow-with-github-actions/using-environment-variables)". - -#### Sistema de arquivos do contêiner Docker - -Ações executadas em contêineres Docker têm diretórios estáticos no caminho `/github`. No entanto, é altamente recomendável usar as variáveis de ambiente padrão para elaborar caminhos de arquivos em contêineres do Docker. - -O {% data variables.product.prodname_dotcom %} reserva o prefixo de caminho `/github` e cria três diretórios para ações. - -- `/github/home` -- `/github/workspace` - {% data reusables.repositories.action-root-user-required %} -- `/github/workflow` - -{% if currentVersion == "free-pro-team@latest" %} - -### Leia mais -- "[gestão de faturamento para {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)" - -{% endif %} diff --git a/translations/pt-BR/content/admin/articles/README.md b/translations/pt-BR/content/admin/articles/README.md deleted file mode 100644 index 3157c575fa22..000000000000 --- a/translations/pt-BR/content/admin/articles/README.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -redirect_from: - - /enterprise/admin/articles/README ---- -# Artigos de administração corporativa ocultos - -O artigos sobre administração empresarial com a página inicial `hidden: true` são encontrados neste diretório. - -Consulte [`content/README`](../../README.md#hidden-pages) para saber mais sobre páginas ocultas. diff --git a/translations/pt-BR/content/admin/articles/configuring-unified-contributions-between-github-enterprise-and-githubcom.md b/translations/pt-BR/content/admin/articles/configuring-unified-contributions-between-github-enterprise-and-githubcom.md deleted file mode 100644 index 47a74d952ac1..000000000000 --- a/translations/pt-BR/content/admin/articles/configuring-unified-contributions-between-github-enterprise-and-githubcom.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: Configurar contribuições unificadas entre o GitHub Enterprise e o GitHub.com -intro: 'Como administrador do site, se tiver habilitado o {% data variables.product.prodname_github_connect %}, você poderá permitir que os usuários finais vejam as contagens de contribuição anônimas do trabalho feito no {% data variables.product.prodname_enterprise %} em seus respectivos gráficos de contribuição do {% data variables.product.prodname_dotcom_the_website %}.' -hidden: true -redirect_from: - - /enterprise/admin/articles/configuring-unified-contributions-between-github-enterprise-and-github-com - - /enterprise/admin/articles/configuring-unified-contributions-between-github-enterprise-and-githubcom -versions: - enterprise-server: '*' ---- - - -Após habilitar o {% data variables.product.prodname_github_connect %} e o {% data variables.product.prodname_unified_contributions %} nos dois ambientes, os usuários finais na sua instância podem se conectar a suas respectivas contas do {% data variables.product.prodname_dotcom_the_website %} e enviar contagens de contribuição do {% data variables.product.prodname_enterprise %} para o {% data variables.product.prodname_dotcom_the_website %}. Para obter mais informações, consulte os artigos "[Habilitar o {% data variables.product.prodname_unified_contributions %} entre o {% data variables.product.prodname_enterprise %} e o {% data variables.product.prodname_dotcom_the_website %}](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/enabling-unified-contributions-between-github-enterprise-server-and-github-com)" e "[Enviar suas contribuições do {% data variables.product.prodname_ghe_server %} para o perfil do {% data variables.product.prodname_dotcom_the_website %}](/articles/sending-your-github-enterprise-server-contributions-to-your-github-com-profile/)". - -Se o administrador do site desativar a funcionalidade ou se os desenvolvedores interromperem a conexão, as contagens de contribuição do {% data variables.product.prodname_enterprise %} serão excluídas no {% data variables.product.prodname_dotcom_the_website %}. Se o desenvolvedor reconectar os perfis após desabilitá-los, as contagens de contribuição dos últimos 90 dias serão restauradas. - -1. No shell administrativo, habilite a configuração do {% data variables.product.prodname_unified_contributions %} na {% data variables.product.product_location_enterprise %}: - ```shell - $ ghe-config 'app.github.dotcom-contributions-configurable' 'true' - $ ghe-config-apply - ``` -2. Retorne ao {% data variables.product.prodname_enterprise %}. -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.business-settings %} -{% data reusables.enterprise-accounts.github-connect-tab %} -7. Em "Usuários podem compartilhar contagens de contribuição no {% data variables.product.prodname_dotcom_the_website %}", use o menu suspenso e clique em **Habilitado**. -8. Após seu redirecionamento ao {% data variables.product.prodname_dotcom_the_website %} para gravar suas contas de contribuição no {% data variables.product.prodname_enterprise %} nas contas dos usuários conectados, você deverá atualizar o {% data variables.product.prodname_github_app %}. Um administrador da organização conectada do {% data variables.product.prodname_dotcom_the_website %} deve aprovar a atualização do {% data variables.product.prodname_github_app %} com permissões de `external_contributions`. - diff --git a/translations/pt-BR/content/admin/articles/including-github-enterprise-contributions-in-your-githubcom-profile.md b/translations/pt-BR/content/admin/articles/including-github-enterprise-contributions-in-your-githubcom-profile.md deleted file mode 100644 index ad235f5d59d6..000000000000 --- a/translations/pt-BR/content/admin/articles/including-github-enterprise-contributions-in-your-githubcom-profile.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: Incluir as contribuições do GitHub Enterprise no perfil do GitHub.com -redirect_from: - - /enterprise/admin/articles/including-github-enterprise-contributions-in-your-github-com-profile - - /enterprise/admin/articles/including-github-enterprise-contributions-in-your-githubcom-profile -intro: 'É possível conectar a {% data variables.product.product_location_enterprise %} ao {% data variables.product.prodname_dotcom_the_website %} e permitir que os usuários finais enviem contribuições da {% data variables.product.product_location_enterprise %} para seus perfis do {% data variables.product.prodname_dotcom_the_website %} como parte de um Programa de acesso antecipado.' -hidden: true -versions: - enterprise-server: '*' ---- - -Incluir as contribuições do {% data variables.product.prodname_enterprise %} no seu perfil do {% data variables.product.prodname_dotcom_the_website %} é parte de um Programa de acesso antecipado do {% data variables.product.prodname_enterprise %} 2.14. Para obter mais informações, consulte "[Incluir contribuições do {% data variables.product.prodname_enterprise %} no seu perfil do {% data variables.product.prodname_dotcom_the_website %}](/enterprise/2.14/admin/hidden/including-github-enterprise-contributions-in-your-github-com-profile/)." diff --git a/translations/pt-BR/content/admin/articles/using-github-task-runner.md b/translations/pt-BR/content/admin/articles/using-github-task-runner.md deleted file mode 100644 index 55d168b8eee7..000000000000 --- a/translations/pt-BR/content/admin/articles/using-github-task-runner.md +++ /dev/null @@ -1,109 +0,0 @@ ---- -title: Usar o Executor de tarefas do GitHub -intro: 'Você pode usar o Executor de tarefas do {% data variables.product.prodname_dotcom %} como sistema CI/CD que integra o Programa de acesso antecipado. Com o Executor de tarefas do {% data variables.product.product_name %}, é possível criar, testar e implantar seu código automaticamente a partir de um {% data variables.product.prodname_github_app %} com base em um arquivo de configuração no seu repositório.' -hidden: true -redirect_from: - - /enterprise/admin/articles/using-github-task-runner -versions: - enterprise-server: '*' ---- - - -{% note %} - -**Observação:** antes de solicitar acesso ao Executor de tarefas do {% data variables.product.prodname_dotcom %}, você deve ler e aceitar as informações de Isenção e Limitação de Responsabilidade do Programa de acesso antecipado em `LINK DE ACESSO ANTECIPADO` para a {% data variables.product.product_location_enterprise %}. A documentação é abrangida por esses termos. - -{% endnote %} - -### Neste guia -- [Sobre o Executor de tarefas do {% data variables.product.prodname_dotcom %}](#about-github-task-runner) -- [Baixar o binário do Executor de tarefas do {% data variables.product.prodname_dotcom %}](#downloading-the-github-task-runner-binary) -- [Criar o Executor de tarefas do {% data variables.product.prodname_dotcom %} no appliance {% data variables.product.prodname_github_app %}](#creating-the-github-task-runner-github-app-on-your-appliance) -- [Instalar o aplicativo do Executor de tarefas do {% data variables.product.prodname_dotcom %}](#installing-the-github-task-runner-app) -- [Executar tarefas em um projeto](#running-tasks-for-a-project) - -### Sobre o Executor de tarefas do {% data variables.product.prodname_dotcom %} - -O Executor de tarefas do {% data variables.product.product_name %} é responsável por executar as tarefas organizadas em fila pelo Dispatcher, um serviço independente que lida com eventos webhooks push e organiza as tarefas em fila. - -O Dispatcher já vem integrado à {% data variables.product.product_location_enterprise %}, mas o Executor de tarefas deve ser instalado manualmente no appliance do {% data variables.product.product_name %}. Para configurar o Executor de tarefas do {% data variables.product.product_name %}, você deve baixar o binário Runner, criar um {% data variables.product.prodname_github_app %} no seu appliance e configurar um servidor para interagir com o Dispatcher. - -### Baixar o binário do Executor de tarefas do {% data variables.product.prodname_dotcom %} - -Você deve ter o arquivo binário do aplicativo do Executor de tarefas do {% data variables.product.product_name %} na {% data variables.product.product_location_enterprise %}. Para baixar o binário para a plataforma de sua escolha, acesse `https://HOSTNAME/_dispatcher/downloads/` e substitua `hostname` pelo nome de host ou endereço IP da {% data variables.product.product_location_enterprise %}: - -Use o comando `chmod` a fim de alterar as permissões para usar o Executor de tarefas do {% data variables.product.product_name %} na linha de comando. - -{% mac %} - -```shell -$ chmod +x task-runner_darwin_amd64 -``` - -{% endmac %} - -{% windows %} - -```shell -$ move task-runner_windows_amd64 task-runner_windows_amd64.exe -``` - -{% endwindows %} - -{% linux %} - -```shell -$ chmod +x task-runner_linux_amd64 -``` - -{% endlinux %} - -### Criar o Executor de tarefas do {% data variables.product.prodname_dotcom %} no appliance {% data variables.product.prodname_github_app %} - -1. Crie o arquivo de configuração `.task-runner.yaml` no seu diretório atual. Você pode usar o sinalizador `--config` para mover o arquivo para outro diretório. - -```shell -configuração do executor de tarefas -``` - -2. Informe o nome do host da {% data variables.product.product_location_enterprise %}. -3. Digite um token de acesso pessoal, configurado com permissões especializadas. Para obter mais informações, consulte [Criar um token de acesso pessoal para a linha de comando](/articles/creating-a-personal-access-token-for-the-command-line/). Você pode usar as permissões de `user` se estiver criando o {% data variables.product.prodname_github_app %} para a sua conta, ou de `admin:org` se estiver criando o {% data variables.product.prodname_github_app %} para a organização. -4. Informe um nome para o {% data variables.product.prodname_github_app %}, algo como `Executor de tarefas do Octocat`. -5. Se estiver criando um {% data variables.product.prodname_github_app %} para a organização, informe o nome da organização. -6. Inicie o Executor de tarefas. - -```shell -iniciar executor de tarefas -``` - -### Instalar o aplicativo do Executor de tarefas do {% data variables.product.prodname_dotcom %} - -1. No canto superior direito de qualquer página, clique na sua foto de perfil e depois em Settings (Configurações).![Ícone Settings (Configurações) na barra de usuário](/assets/images/help/images/userbar-account-settings.png) -2. Na barra lateral esquerda, clique em **Developer settings** (Configurações do desenvolvedor). ![Seção de configurações do desenvolvedor](/assets/images/help/images/developer_settings.png) -3. Na barra lateral esquerda, clique em **{% data variables.product.prodname_dotcom %} Apps** (Aplicativos do {% data variables.product.prodname_dotcom %}). ![Seção de aplicativos do GitHub](/assets/images/help/images/github_apps.png) -4. Clique no aplicativo que você deseja instalar. -5. Na barra lateral esquerda, clique em **Public page** (Página pública). ![Seção Página pública](/assets/images/help/images/public-page-tab.png) -6. Clique em **Install** (Instalar). ![Botão Instalar na página pública do aplicativo GitHub](/assets/images/help/images/install-runner-public-page.png) -7. Selecione **Only select repositories** (Somente repositórios selecionados) e digite os nomes dos repositórios em que você pretende instalar o Executor de tarefas do {% data variables.product.prodname_dotcom %}. ![Selecionar repositórios em que a instalação será feita](/assets/images/help/images/repositories-install-task-runner.png) -8. Clique em **Install** (Instalar). ![Botão Instalar na página de instalação do aplicativo GitHub](/assets/images/help/images/install-runner-installation-page.png) -9. Navegue para um repositório em que você tenha instalado o aplicativo. -10. Crie um arquivo de código `github/tasks.gf`, por exemplo: - - ``` -task "minha tarefa" { -command = "comando-para-executar" -runnerType = "Shell" -env = { - FOO="bar", - BAR="baz" -} -} - ``` -12. Abra uma pull request para adicionar o arquivo ao repositório. -13. Faça push das alerações para ver a execução das tarefas de CI. - -### Executar tarefas em um projeto - -Depois de criar a pull request, o {% data variables.product.prodname_github_app %} fará push do evento para o Dispatcher, onde a tarefa entrará em fila e será enviada para o Executor de tarefas do {% data variables.product.prodname_dotcom %}. Depois que o executor de tarefas do {% data variables.product.prodname_dotcom %} receber, executar as tarefas e fizer os relatórios, o Dispatcher atualizará a pull request com os resultados. - -![Resultados de teste de CI da pull request](/assets/images/help/images/task-results.png) diff --git a/translations/pt-BR/content/admin/clustering/about-cluster-nodes.md b/translations/pt-BR/content/admin/clustering/about-cluster-nodes.md deleted file mode 100644 index edca2a2ebb00..000000000000 --- a/translations/pt-BR/content/admin/clustering/about-cluster-nodes.md +++ /dev/null @@ -1,69 +0,0 @@ ---- -title: Sobre nós de cluster -intro: '*Nós* são instâncias do {% data variables.product.prodname_ghe_server %} que operam em um cluster. Cada nó executa um conjunto de serviços fornecidos para o cluster e, consequentemente, para os usuários.' -redirect_from: - - /enterprise/admin/clustering/about-cluster-nodes -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_clustering.clustering-requires-https %} - -### Recomendações básicas de hardware -Cada nó deve ter um volume raiz e um volume de dados separado. Essas são as recomendações básicas de hardware. Podem ser necessários mais recursos dependendo do uso, como atividade do usuário e integrações selecionadas. - -| Serviços | Requisito mínimo de memória | Requisito mínimo de espaço livre para volume de dados | -|:----------------------------------------------------------------------------:|:---------------------------:|:-----------------------------------------------------:| -| `job-server`,
    `memcache-server`,
    `web-server` | 14 GB | 1 GB | -| `consul-server`,
    `mysql-server`,
    `redis-server` | 14 GB | 10 GB | -| `git-server`,
    `metrics-server`,
    `pages-server`,
    `storage-server` | 7 GB | 10 GB | -| `elasticsearch-server` | 14 GB | 10 GB | - -### Requisito de serviços para clustering -Para manter a redundância adequada, use esses nós mínimos ao operar cada serviço. - -{% tip %} - -**Observação:** as demandas de dimensionamento da sua organização dependerão de vários fatores, como tamanho e número de repositórios, número de usuários e uso geral. - -{% endtip %} - -| Serviços | Requisito mínimo de nós | -|:---------------------------------------------------------------------------:|:-----------------------:| -| `job-server`,
    `memcache-server`,
    `metrics-server`,
    `web-server` | 2 | -| `mysql-server`,
    `redis-server` | 2 | -| `consul-server` | 3 | -| `git-server`,
    `pages-server`,
    `storage-server` | 3 | -| `elasticsearch-server` | 3 | - -### Recomendações de criação de cluster - -O clustering permite que os serviços que compõem o {% data variables.product.prodname_ghe_server %} sejam dimensionados de maneira independente. Essa flexibilidade pode ser usada para projetar e implementar um cluster que se adapte a organizações com diferentes requisitos de dimensionamento. Por exemplo, talvez algumas organizações precisem de mais taxa de transferência de armazenamento para fetches grandes ou frequentes, mas o uso do servidor da web pode ser relativamente baixo. Outras organizações podem ter bom desempenho com menos recursos de armazenamento, mas precisar de vários nós `pages-server` ou `elasticsearch-server` em execução. Muitas combinações são possíveis. Converse com seu representante de conta para determinar a configuração de cluster ideal para o seu caso. - -- Use nós redundantes em todo o hardware independente. Compartilhar dispositivos de armazenamento, memória ou CPU reduz o desempenho e aumenta as chances de pontos únicos de falha. Componentes de rede compartilhada também podem reduzir o rendimento e aumentar o risco de perda de conectividade em caso de interrupção. -- Use o armazenamento rápido. As redes de área de armazenamento (SAN) costumam ser otimizadas para explorar ao máximo o espaço, a disponibilidade e a tolerância a falhas, mas não o rendimento. Além de oferecer redundância e disponibilidade, o clustering do {% data variables.product.prodname_ghe_server %} terá melhor desempenho no armazenamento mais rápido disponível. Recomenda-se fazer o armazenamento local em SSD. -- Estabeleça camadas de nós relevantes para a sua organização. Veja esta configuração de exemplo: - - Camada de front-end com dois nós e os seguintes serviços: - - `web-server` - - `jobs-server` - - `memcache-server` - - Camada de banco de dados com dois nós e os seguintes serviços: - - `consul-server` - - `mysql-server` - - `redis-server` - - Camada de busca com três nós e o seguinte serviço: - - `elasticsearch-server` - - Camada de armazenamento com três nós e os seguintes serviços: - - `git-server` - - `pages-server` - - `storage-server` - - `metrics-server` - -#### Diagrama de cluster de exemplo -{% note %} - -**Observação: isto é apenas um exemplo.** O cluster ideal dependerá das demandas exclusivas de cada organização. Converse com seu representante exclusivo ou com {% data variables.contact.contact_enterprise_sales %} para que possamos ajudá-lo a determinar a melhor configuração de cluster. - -{% endnote %} - -Cluster de exemplo diff --git a/translations/pt-BR/content/admin/clustering/about-clustering.md b/translations/pt-BR/content/admin/clustering/about-clustering.md deleted file mode 100644 index 69dbefb433a9..000000000000 --- a/translations/pt-BR/content/admin/clustering/about-clustering.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Sobre clustering -intro: 'Com o clustering do {% data variables.product.prodname_ghe_server %}, os serviços que compõem o {% data variables.product.prodname_ghe_server %} podem ser dimensionados em vários nós.' -redirect_from: - - /enterprise/admin/clustering/clustering-overview/ - - /enterprise/admin/clustering/about-clustering -versions: - enterprise-server: '*' ---- - -### Arquitetura de clustering - -O {% data variables.product.prodname_ghe_server %} é formado por um conjunto de serviços. Em um cluster, esses serviços são executados em vários nós e as solicitações são balanceadas por carga entre eles. As alterações são armazenadas automaticamente com cópias redundantes em nós separados. A maioria dos serviços são pares iguais com outras instâncias do mesmo serviço. As exceções são os serviços `mysql-server` e `redis-server`, que operam em um único nó _primário_ com um ou mais nós _réplica_. - -Saiba mais sobre os [serviços necessários para clustering](/enterprise/{{ currentVersion }}/admin/guides/clustering/about-cluster-nodes#services-required-for-clustering). - -### Clustering é a opção ideal para a minha organização? - -{% data reusables.enterprise_clustering.clustering-scalability %} No entanto, configurar um cluster redundante e dimensionável pode ser uma tarefa complexa e requer planejamento cuidadoso. A complexidade adicional deve ser planejada para a instalação, os cenários de recuperação de desastre e as atualizações. - -O {% data variables.product.prodname_ghe_server %} requer baixa latência entre os nós e não foi feito para a redundância entre locais geográficos. - -O clustering fornece redundância, mas não foi feito para substituir uma configuração de alta disponibilidade. Para obter mais informações, consulte [Configuração de alta disponibilidade](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-github-enterprise-server-for-high-availability). A configuração de um failover primário/secundário é muito mais simples do que o clustering e funcionará perfeitamente para várias organizações. Para obter mais informações, consulte [Diferenças entre clustering e alta disponibilidade](/enterprise/{{ currentVersion }}/admin/guides/clustering/differences-between-clustering-and-high-availability-ha/). - -### Como faço para obter acesso ao clustering? - -O clustering foi feito para situações específicas de dimensionamento e não se aplica a todas as organizações. Se você está pensando em usar o clustering, converse com seu representante exclusivo ou {% data variables.contact.contact_enterprise_sales %}. diff --git a/translations/pt-BR/content/admin/clustering/cluster-network-configuration.md b/translations/pt-BR/content/admin/clustering/cluster-network-configuration.md deleted file mode 100644 index f94c295da787..000000000000 --- a/translations/pt-BR/content/admin/clustering/cluster-network-configuration.md +++ /dev/null @@ -1,122 +0,0 @@ ---- -title: Configuração de rede de cluster -intro: 'O funcionamento correto do clustering do {% data variables.product.prodname_ghe_server %} depende da resolução adequada de nome DNS, do balanceamento de carga e da comunicação entre os nós.' -redirect_from: - - /enterprise/admin/clustering/network-configuration - - /enterprise/admin/clustering/cluster-network-configuration -versions: - enterprise-server: '*' ---- - -### Considerações de rede - -A composição de rede mais simples para o clustering é deixar os nós em uma única LAN. Se for necessário que um cluster redundante envolva sub-redes, as rotas adequadas devem estar disponíveis entre as sub-redes e a latência deve ser inferior a 1 ms. - -#### Portas de aplicativo para usuários finais - -As portas de aplicativo fornecem aplicativos da web e acesso dos usuários finais ao Git. - -| Porta | Descrição | Criptografia | -|:-------- |:------------------------------------------------------------------- |:-------------------------------------------------------------- | -| 22/TCP | Git em SSH | Sim | -| 25/TCP | SMTP | Requer STARTTLS | -| 80/TCP | HTTP | Não
    (com SSL habilitado, essa porta redireciona para HTTPS) | -| 443/TCP | HTTPS | Sim | -| 9418/TCP | Porta de protocolo simples do Git
    (desabilitada no modo privado) | Não | - -#### Portas administrativas - -Não é preciso haver portas administrativas para os usuários finais aproveitarem os recursos básicos do aplicativo. - -| Porta | Descrição | Criptografia | -|:-------- |:--------------------------------- |:-------------------------------------------------------------- | -| ICMP | Ping ICMP | Não | -| 122/TCP | SSH administrativa | Sim | -| 161/UDP | SNMP | Não | -| 8080/TCP | HTTP de console de gerenciamento | Não
    (com SSL habilitado, essa porta redireciona para HTTPS) | -| 8443/TCP | HTTPS de console de gerenciamento | Sim | - -#### Portas de comunicação de cluster - -Se houver um firewall no nível da rede entre os nós, essas portas terão que estar acessíveis. A comunicação entre os nós não é criptografada, e essas portas não devem ficar acessíveis externamente. - -| Porta | Descrição | -|:--------- |:------------------------------------- | -| 1336/TCP | API interna | -| 3033/TCP | Acesso SVN interno | -| 3037/TCP | Acesso SVN interno | -| 3306/TCP | MySQL | -| 4486/TCP | Acesso do controlador | -| 5115/TCP | Backend de armazenamento | -| 5208/TCP | Acesso SVN interno | -| 6379/TCP | Redis | -| 8001/TCP | Grafana | -| 8090/TCP | Acesso GPG interno | -| 8149/TCP | Acesso GitRPC ao servidor de arquivos | -| 8300/TCP | Consul | -| 8301/TCP | Consul | -| 8302/TCP | Consul | -| 9000/TCP | Git Daemon | -| 9102/TCP | Servidor de arquivos do Pages | -| 9105/TCP | Servidor LFS | -| 9200/TCP | ElasticSearch | -| 9203/TCP | Serviço de código semântico | -| 9300/TCP | ElasticSearch | -| 11211/TCP | Memcache | -| 161/UDP | SNMP | -| 8125/UDP | Statsd | -| 8301/UDP | Consul | -| 8302/UDP | Consul | -| 25827/UDP | Collectd | - - -### Configurar um balanceador de carga - - É recomendável usar um balanceador de carga baseado em TCP compatível com o protocolo PROXY para distribuir o tráfego entre os nós. Veja estas configurações de balanceador de carga: - - - Portas TCP (abaixo) devem ser encaminhadas para nós que executem o serviço `web-server`; são os únicos nós que funcionam com solicitações de clientes externos. - - Sessões temporárias não devem ser habilitadas. - -{% data reusables.enterprise_installation.terminating-tls %} - -### Informações de conexão do cliente - -Como as conexões do cliente com o cluster vêm do balanceador de carga, pode ocorrer a perda do endereço IP do cliente. Para captar as informações de conexão do cliente de maneira adequada, é preciso fazer considerações adicionais. - -{% data reusables.enterprise_clustering.proxy_preference %} - -{% data reusables.enterprise_clustering.proxy_xff_firewall_warning %} - -#### Habilitar o suporte PROXY no {% data variables.product.prodname_ghe_server %} - -É altamente recomendável ativar o suporte PROXY para sua instância e o balanceador de carga. - - - Na instância, use este comando: - ```shell - $ ghe-config 'loadbalancer.proxy-protocol' 'true' && ghe-cluster-config-apply - ``` - - No balanceador de carga, siga as instruções do seu fornecedor. - - {% data reusables.enterprise_clustering.proxy_protocol_ports %} - -#### Habilitar o suporte X-Forwarded-For no {% data variables.product.prodname_ghe_server %} - -{% data reusables.enterprise_clustering.x-forwarded-for %} - -Para habilitar o header `X-Fowarded-For`, use este comando: - -```shell -$ ghe-config 'loadbalancer.http-forward' 'true' && ghe-cluster-config-apply -``` - -{% data reusables.enterprise_clustering.without_proxy_protocol_ports %} - -#### Configurar verificações de integridade -As verificações de integridade permitem que um balanceador de carga pare de enviar tráfego para um nó que não responde em caso de falha na verificação pré-configurada do nó em questão. Em caso de falha em um nó do cluster, as verificações de integridade emparelhadas com nós redundantes fornecerão alta disponibilidade. - -{% data reusables.enterprise_clustering.health_checks %} -{% data reusables.enterprise_site_admin_settings.maintenance-mode-status %} - -### Requisitos de DNS - -{% data reusables.enterprise_clustering.load_balancer_dns %} diff --git a/translations/pt-BR/content/admin/clustering/differences-between-clustering-and-high-availability-ha.md b/translations/pt-BR/content/admin/clustering/differences-between-clustering-and-high-availability-ha.md deleted file mode 100644 index a02ac37d4af0..000000000000 --- a/translations/pt-BR/content/admin/clustering/differences-between-clustering-and-high-availability-ha.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: Diferenças entre clustering e alta disponibilidade -intro: 'A configuração de alta disponibilidade do {% data variables.product.prodname_ghe_server %} é uma configuração de failover primário/secundário que fornece redundância, enquanto o cluster fornece redundância e dimensionamento distribuindo a carga de leitura e gravação em vários nós.' -redirect_from: - - /enterprise/admin/clustering/differences-between-clustering-and-high-availability-ha -versions: - enterprise-server: '*' ---- - -### Cenários de falha - -Tanto a alta disponibilidade (High Availability, HA) quanto o cluster fornecem redundância ao eliminar o nó único como ponto de falha. Ambos podem fornecer disponibilidade nos seguintes cenários: - -{% data reusables.enterprise_installation.ha-and-clustering-failure-scenarios %} - -### Dimensionamento - -{% data reusables.enterprise_clustering.clustering-scalability %} Na alta disponibilidade (HA), a dimensão do appliance depende exclusivamente do nó primário, e a carga não é distribuída para o servidor réplica. - -### Diferenças entre configuração e método de failover - -| Funcionalidade | Configuração de failover | Método de failover | -|:------------------------------------ |:---------------------------------------------------------------------------------------- |:----------------------------------------------------------------------------------------------------------------------------- | -| Configuração de alta disponibilidade | Registro DNS com TTL baixo apontado para o appliance principal, ou balanceador de carga. | É preciso promover manualmente o appliance réplica nas configurações de balanceador de carga e failover de DNS. | -| Clustering | O registro de DNS deve apontar para um balanceador de carga. | Se um nó por trás do balanceador de carga falhar, o tráfego será automaticamente enviado para os outros nós em funcionamento. | - -### Backups e recuperação de desastre - -Nem o clustering nem a HA devem ser considerados como substitutos para as medidas regulares de backup. Para obter mais informações, consulte "[Configurar backups no appliance](/enterprise/admin/guides/installation/configuring-backups-on-your-appliance)". - -### Monitoramento - -Os recursos de disponibilidade, especialmente os que têm failover automático, como clustering, podem mascarar falhas porque geralmente o serviço não é interrompido em caso de falha. Seja qual for a opção em uso (HA ou cluster), é importante monitorar a integridade de cada instância para você se manter a par das possíveis falhas. Para obter mais informações sobre monitoramento, consulte "[Limites recomendados de alerta](/enterprise/{{ currentVersion }}/admin/guides/installation/recommended-alert-thresholds/)" e "[Monitoramento de nós de cluster](/enterprise/{{ currentVersion}}/admin/guides/clustering/monitoring-cluster-nodes/)." - -### Leia mais -- Para obter mais informações sobre clustering no {% data variables.product.prodname_ghe_server %}, consulte "[Sobre clustering](/enterprise/{{ currentVersion}}/admin/guides/clustering/about-clustering/)". -- Para obter mais informações sobre HA, consulte "[Configurar o {% data variables.product.prodname_ghe_server %} para alta disponibilidade](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-github-enterprise-server-for-high-availability/)". diff --git a/translations/pt-BR/content/admin/clustering/evacuating-a-cluster-node.md b/translations/pt-BR/content/admin/clustering/evacuating-a-cluster-node.md deleted file mode 100644 index 364586ba0ecc..000000000000 --- a/translations/pt-BR/content/admin/clustering/evacuating-a-cluster-node.md +++ /dev/null @@ -1,52 +0,0 @@ ---- -title: Remover um nó de cluster -intro: É possível remover serviços de dados em um nó do cluster. -redirect_from: - - /enterprise/admin/clustering/evacuating-a-cluster-node -versions: - enterprise-server: '*' ---- - -Se houver somente três nós no seu cluster de serviços de dados, não será possível removê-los porque o `ghe-spokes` não tem outro local para fazer cópia. Se houver quatro ou mais nós, o `ghe-spokes` vai retirar todos os repositórios do nó removido. - -Se você estiver usando um nó offline que tenha qualquer tipo de serviços de dados (como git, páginas ou armazenamento), remova cada nó antes de deixar o nó offline. - -1. Encontre o `uuid` do nó com o comando `ghe-config`. - - ``` - $ ghe-config cluster._hostname_.uuid - ``` - -2. Você terá que monitorar o status do seu nó durante a operação de cópia dos dados. O ideal é que o nó não fique offline até a conclusão da operação de cópia. Para monitorar o status do seu nó, execute qualquer um dos comandos a seguir: - - Para o Git - ``` - ghe-spokes evac-status - ``` - Para o {% data variables.product.prodname_pages %} - ``` - echo "select count(*) from pages_replicas where host = 'pages-server-'" | ghe-dbconsole -y - ``` - Para o armazenamento - ``` - ghe-storage evacuation-status - ``` - -3. Após a conclusão do processo de cópia, você poderá remover o serviço de armazenamento. Execute qualquer um dos comandos a seguir: - - Para o Git - ``` - ghe-spokes server evacuate git-server- - ``` - Para o {% data variables.product.prodname_pages %} - ``` - ghe-dpages evacuate pages-server- - ``` - Para o armazenamento, use o nó offline - ``` - ghe-storage offline storage-server- - ``` - e remova - ``` - ghe-storage evacuate storage-server- - ``` diff --git a/translations/pt-BR/content/admin/clustering/index.md b/translations/pt-BR/content/admin/clustering/index.md deleted file mode 100644 index 6603b6d7cabf..000000000000 --- a/translations/pt-BR/content/admin/clustering/index.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Configurar e gerenciar um cluster para o GitHub Enterprise Server -shortTitle: Clustering -intro: 'Este guia descreve como trabalhar com seu representante de conta para determinar se o clustering do {% data variables.product.prodname_enterprise %} é uma boa solução para a sua organização. O guia também mostra como configurar um cluster.' -redirect_from: - - /enterprise/admin/clustering -versions: - enterprise-server: '*' ---- - -### Índice - -{% topic_link_in_list /overview %} - {% link_in_list /about-clustering %} - {% link_in_list /differences-between-clustering-and-high-availability-ha %} -{% topic_link_in_list /setting-up-the-cluster-instances %} - {% link_in_list /about-cluster-nodes %} - {% link_in_list /cluster-network-configuration %} - {% link_in_list /initializing-the-cluster %} -{% topic_link_in_list /managing-a-github-enterprise-server-cluster %} - {% link_in_list /upgrading-a-cluster %} - {% link_in_list /replacing-a-cluster-node %} - {% link_in_list /evacuating-a-cluster-node %} - {% link_in_list /monitoring-cluster-nodes %} diff --git a/translations/pt-BR/content/admin/clustering/initializing-the-cluster.md b/translations/pt-BR/content/admin/clustering/initializing-the-cluster.md deleted file mode 100644 index 8460d2d10613..000000000000 --- a/translations/pt-BR/content/admin/clustering/initializing-the-cluster.md +++ /dev/null @@ -1,113 +0,0 @@ ---- -title: Inicializar o cluster -intro: 'Um cluster do {% data variables.product.prodname_ghe_server %} deve ser configurado com uma licença e inicializado usando o shell administrativo (SSH).' -redirect_from: - - /enterprise/admin/clustering/initializing-the-cluster -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_clustering.clustering-requires-https %} - -### Instalar o {% data variables.product.prodname_ghe_server %} - -1. Em cada nó de cluster, provisione e instale o {% data variables.product.prodname_ghe_server %}. Para obter mais informações, consulte "[Configurar uma instância do {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-github-enterprise-server-instance)". -2. Usando o shell administrativo ou DHCP, configure **somente** o endereço IP de cada nó. Não altere outras configurações. - -### Configurar o primeiro nó - -1. Conecte-se ao nó a ser designado como `mysql-master` no `cluster.conf`. Para obter mais informações, consulte “[Sobre o arquivo de configuração do cluster](/enterprise/{{ currentVersion }}/admin/guides/clustering/initializing-the-cluster/#about-the-cluster-configuration-file)." -2. No navegador, acesse `https://:8443/setup/`. -{% data reusables.enterprise_installation.upload-a-license-file %} -{% data reusables.enterprise_installation.save-settings-in-web-based-mgmt-console %} -{% data reusables.enterprise_installation.instance-will-restart-automatically %} - -### Inicializar o cluster - -Para inicializar o cluster, você precisa de um arquivo de configuração de cluster (`cluster.conf`). Para obter mais informações, consulte “[Sobre o arquivo de configuração do cluster](/enterprise/{{ currentVersion }}/admin/guides/clustering/initializing-the-cluster/#about-the-cluster-configuration-file)". - -1. Desde o primeiro nó configurado, execute `ghe-cluster-config-init`. Essa ação inicializará o cluster caso haja nós no arquivo de configuração que não estão configurados. -2. Execute `ghe-cluster-config-apply`. Fazer isso vai validar o arquivo `cluster.conf`, aplicar a configuração a cada arquivo de nó e ativar os serviços configurados em cada nó. - -Para verificar o status de um cluster em execução, use o comando `ghe-cluster-status`. - -### Sobre o arquivo de configuração do cluster - -O arquivo de configuração do cluster (`cluster.conf`) define os nós no cluster e os serviços que cada nó executa. Para obter mais informações, consulte "[Sobre os nós do cluster](/enterprise/{{ currentVersion }}/admin/guides/clustering/about-cluster-nodes)." - -O exemplo `cluster.conf` define um cluster com cinco nós. - - - Dois nós (chamados `ghe-app-node-\*`) executam os serviços `web-server` e `job-server` responsáveis por responder às solicitações do cliente. - - Três nós (chamados `ghe-data-node-\*`) executam o serviço de armazenamento e recuperação de dados do {% data variables.product.prodname_ghe_server %}. - -Os nomes dos nós podem ser qualquer nome de host válido. Cada nome é definido como nome de host e será adicionado a `/etc/hosts` em cada nó. Assim, os nós podem ser resolvidos localmente entre si. - -Especifique o primeiro nó de cluster configurado como MySQL master `mysql-server` e `mysql-master`. - -``` -[cluster] - mysql-master = ghe-data-node-1 - redis-master = ghe-data-node-1 - primary-datacenter = default -[cluster "ghe-app-node-1"] - hostname = ghe-app-node-1 - ipv4 = 192.168.0.2 - # ipv6 = fd12:3456:789a:1::2 - web-server = true - job-server = true -[cluster "ghe-app-node-2"] - hostname = ghe-app-node-2 - ipv4 = 192.168.0.3 - # ipv6 = fd12:3456:789a:1::3 - web-server = true - job-server = true -[cluster "ghe-data-node-1"] - hostname = ghe-data-node-1 - ipv4 = 192.168.0.4 - # ipv6 = fd12:3456:789a:1::4 - consul-server = true - consul-datacenter = default - git-server = true - pages-server = true - mysql-server = true - elasticsearch-server = true - redis-server = true - memcache-server = true - metrics-server = true - storage-server = true -[cluster "ghe-data-node-2"] - hostname = ghe-data-node-2 - ipv4 = 192.168.0.5 - # ipv6 = fd12:3456:789a:1::5 - consul-server = true - consul-datacenter = default - git-server = true - pages-server = true - mysql-server = true - elasticsearch-server = true - redis-server = true - memcache-server = true - metrics-server = true - storage-server = true -[cluster "ghe-data-node-3"] - hostname = ghe-data-node-3 - ipv4 = 192.168.0.6 - # ipv6 = fd12:3456:789a:1::6 - consul-server = true - consul-datacenter = default - git-server = true - pages-server = true - mysql-server = true - elasticsearch-server = true - redis-server = true - memcache-server = true - metrics-server = true - storage-server = true -``` - -Crie o arquivo `/data/user/common/cluster.conf` no primeiro nó configurado. Por exemplo, usando `vim`: - - ```shell - ghe-data-node-1:~$ sudo vim /data/user/common/cluster.conf - ``` - diff --git a/translations/pt-BR/content/admin/clustering/managing-a-github-enterprise-server-cluster.md b/translations/pt-BR/content/admin/clustering/managing-a-github-enterprise-server-cluster.md deleted file mode 100644 index 928b7321e27d..000000000000 --- a/translations/pt-BR/content/admin/clustering/managing-a-github-enterprise-server-cluster.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Gerenciar cluster do GitHub Enterprise Server -intro: 'Planeje operações de manutenção para um cluster do {% data variables.product.prodname_ghe_server %}, como atualizações, aumento de capacidade e substituição de nós com falha.' -redirect_from: - - /enterprise/admin/guides/clustering/managing-a-github-enterprise-cluster/ - - /enterprise/admin/clustering/managing-a-github-enterprise-server-cluster -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/pt-BR/content/admin/clustering/monitoring-cluster-nodes.md b/translations/pt-BR/content/admin/clustering/monitoring-cluster-nodes.md deleted file mode 100644 index c17b9b6adf42..000000000000 --- a/translations/pt-BR/content/admin/clustering/monitoring-cluster-nodes.md +++ /dev/null @@ -1,105 +0,0 @@ ---- -title: Monitorar nós de cluster -intro: 'Um cluster do {% data variables.product.prodname_ghe_server %} é formado por serviços redundantes distribuídos em dois ou mais nós. Em caso de falha de um serviço ou de um nó inteiro, a falha não será aparente de imediato para os usuários do cluster. No entanto, como o desempenho e a redundância são afetados, é importante monitorar a integridade de um cluster do {% data variables.product.prodname_ghe_server %}.' -redirect_from: - - /enterprise/admin/clustering/monitoring-cluster-nodes -versions: - enterprise-server: '*' ---- - -### Verificar o status do cluster manualmente - -O {% data variables.product.prodname_ghe_server %} tem um utilitário integrado de linha de comando para monitorar a integridade do cluster. No shell administrativo, acionar o comando `ghe-cluster-status` executa uma série de verificações de integridade em cada nó, verificando também o status do serviço e da conectividade. A saída mostra todos os resultados de teste, inclusive o texto `ok` ou `erro`. Por exemplo, para exibir somente os testes com falha, execute: - -```shell -admin@ghe-data-node-0:~$ status-ghe-cluster | grep erro -> mysql-replicacao no-dados-ghe-0: erro Parado -> mysql cluster: erro -``` -{% note %} - -**Observação:** se não houver testes com falha, o comando não vai gerar saída. Nesse caso, a integridade do cluster terá sido preservada. - -{% endnote %} - -### Monitorar o status do cluster com o Nagios - -É possível configurar o [Nagios](https://www.nagios.org/) para monitorar o {% data variables.product.prodname_ghe_server %}. Além de monitorar a conectividade básica para cada nó do cluster, você pode verificar o status do cluster configurando o Nagios para usar o comando `ghe-cluster-status -n`. Fazer isso gera uma saída em um formato que o Nagios consegue interpretar. - -#### Pré-requisitos -* Host Linux com Nagios; -* Acesso de rede ao cluster do {% data variables.product.prodname_ghe_server %}. - -#### Configurar o host do Nagios -1. Gere uma chave SSH com a frase secreta em branco. O Nagios usa essa informação para fazer a autenticação ao cluster do {% data variables.product.prodname_ghe_server %}. - ```shell - nagiosuser@nagios:~$ ssh-keygen -t rsa -b 4096 - > Gerando par de chaves rsa pública/privada. - > Digite o arquivo no qual salvar a chave (/home/nagiosuser/.ssh/id_rsa): - > Digite a frase secreta (vazia para nenhuma frase secreta): deixe em branco pressionando enter - > Digite a mesma frase secreta novamente: pressione enter novamente - > Sua identificação foi salva em /home/nagiosuser/.ssh/id_rsa. - > Sua chave pública foi salva no /home/nagiosuser/.ssh/id_rsa.pub. - ``` - {% danger %} - - **Aviso de segurança:** chaves SSH sem senha podem representar um risco de segurança se tiverem permissão de acesso total a um host. Limite o acesso desse tipo de chave a comandos de somente leitura. - - {% enddanger %} -2. Copie a chave privada (`id_rsa`) para a pasta inicial `nagios` e defina a propriedade adequada. - ```shell - nagiosuser@nagios:~$ sudo cp .ssh/id_rsa /var/lib/nagios/.ssh/ - nagiosuser@nagios:~$ sudo chown nagios:nagios /var/lib/nagios/.ssh/id_rsa - ``` - -3. Para autorizar a chave pública a executar *somente* o comando `ghe-cluster-status-n`, use o prefixo `command=` no arquivo `/data/user/common/authorized_keys`. No shell administrativo de qualquer nó, modifique esse arquivo para incluir a chave pública gerada na etapa 1. Por exemplo: `command="/usr/local/bin/ghe-cluster-status -n" ssh-rsa AAAA....` - -4. Valide e copie a configuração para cada nó do cluster executando `ghe-cluster-config-apply` no nó em que você modificou o arquivo `/data/user/common/authorized_keys`. - - ```shell - admin@ghe-data-node-0:~$ ghe-cluster-config-apply - > Validando a configuração - > ... - > Configuração de cluster concluída - ``` - -5. Para testar se o plugin do Nagios consegue executar o comando, execute-o de forma interativa no host do Nagios. - ```shell - nagiosuser@nagios:~$ /usr/lib/nagios/plugins/check_by_ssh -l admin -p 122 -H hostname -C "ghe-cluster-status -n" -t 30 - > OK - Nenhum erro detectado - ``` - -6. Crie uma definição de comando na sua configuração do Nagios. - - ###### Definição de exemplo - - ``` - definir comando { - nome_comando verificar_ssh_ghe_cluster - linha_comando $USER1$/verificar_por_ssh -H $HOSTADDRESS$ -C "status-cluster-ghe -n" -l admin -p 122 -t 30 - } - ``` -7. Adicione este comando a uma definição de serviço para um nó no cluster do {% data variables.product.prodname_ghe_server %}. - - - ###### Definição de exemplo - - ``` - definir host{ - uso host-genérico - nome_host nó-dados-ghe-0 - alias nó-dados-ghe-0 - endereço 10.11.17.180 - } - - definir serviço{ - uso serviço-genérico - nome_host nó-dados-ghe-0 - descrição_serviço Status GitHub Cluster - verificar_comando verificar_cluster_ssh_ghe - } - ``` - -Depois de adicionar a definição ao Nagios, a verificação de serviço será executada conforme a sua configuração. Você deve conseguir ver o serviço recém-configurado na interface da web do Nagios. - -![Exemplo Nagios](/assets/images/enterprise/cluster/nagios-example.png) diff --git a/translations/pt-BR/content/admin/clustering/overview.md b/translations/pt-BR/content/admin/clustering/overview.md deleted file mode 100644 index 9ecbe2ae9175..000000000000 --- a/translations/pt-BR/content/admin/clustering/overview.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Visão Geral -intro: Saiba mais sobre clustering e diferenças com alta disponibilidade. -mapTopic: true -redirect_from: - - /enterprise/admin/clustering/overview -versions: - enterprise-server: '*' ---- - diff --git a/translations/pt-BR/content/admin/clustering/replacing-a-cluster-node.md b/translations/pt-BR/content/admin/clustering/replacing-a-cluster-node.md deleted file mode 100644 index 74ee30abdfd0..000000000000 --- a/translations/pt-BR/content/admin/clustering/replacing-a-cluster-node.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: Substituir um nó de cluster -intro: 'Para substituir um nó do {% data variables.product.prodname_ghe_server %}, você deve marcar os nós afetados offline no arquivo de configuração do cluster (`cluster.conf`) e adicionar os nós de substituição. Fazer isso pode ser necessário em caso de falha de algum nó ou para adicionar nós com mais recursos a fim de melhorar o desempenho.' -redirect_from: - - /enterprise/admin/clustering/replacing-a-cluster-node -versions: - enterprise-server: '*' ---- - -{% warning %} - -**Aviso:** para evitar conflitos, o nó de substituição deve usar um nome de host exclusivo no cluster. - -{% endwarning %} - -### Substituir um nó funcional -{% data reusables.enterprise_clustering.replacing-a-cluster-node-provision %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-admin-configure-ip %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-modify-cluster-conf %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-initialize-new-node %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-config-node %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-need-three-nodes %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-mark-offline %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-validate-config %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-replacement-name %} - -### Substituir um nó em caso de emergência -{% data reusables.enterprise_clustering.replacing-a-cluster-node-provision %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-admin-configure-ip %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-mark-offline %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-validate-config %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-modify-cluster-conf %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-replacement-name %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-initialize-new-node %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-config-node %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-need-three-nodes %} diff --git a/translations/pt-BR/content/admin/clustering/setting-up-the-cluster-instances.md b/translations/pt-BR/content/admin/clustering/setting-up-the-cluster-instances.md deleted file mode 100644 index 706fb8a7726e..000000000000 --- a/translations/pt-BR/content/admin/clustering/setting-up-the-cluster-instances.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Definir as instâncias de cluster -intro: 'O clustering do {% data variables.product.prodname_ghe_server %} requer que várias instâncias sejam definidas e configuradas para executar os serviços do {% data variables.product.prodname_ghe_server %}.' -mapTopic: true -redirect_from: - - /enterprise/admin/clustering/setting-up-the-cluster-instances -versions: - enterprise-server: '*' ---- - diff --git a/translations/pt-BR/content/admin/clustering/upgrading-a-cluster.md b/translations/pt-BR/content/admin/clustering/upgrading-a-cluster.md deleted file mode 100644 index 28688c9bef6d..000000000000 --- a/translations/pt-BR/content/admin/clustering/upgrading-a-cluster.md +++ /dev/null @@ -1,76 +0,0 @@ ---- -title: Atualizar o cluster -intro: 'Use o shell administrativo (SSH) para atualizar o cluster do {% data variables.product.prodname_ghe_server %} para a versão mais recente.' -redirect_from: - - /enterprise/admin/clustering/upgrading-a-cluster -versions: - enterprise-server: '*' ---- - -### Atualizar com hotpatch -{% data reusables.enterprise_installation.hotpatching-explanation %} O script de instalação do hotpatch instala o hotpatch em cada nó do cluster e reinicia os serviços na sequência adequada para evitar tempo de inatividade. - -1. Faça backup dos seus dados com o [{% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils#readme). -2. No shell administrativo de qualquer nó, use o comando `ghe-cluster-hotpatch` para instalar o hotpatch mais recente. Você pode informar uma URL para o hotpatch ou baixá-la manualmente e especificar um nome de arquivo local. - ```shell - $ ghe-cluster-hotpatch https://HOTPATCH-URL/NOMEARQUIVO.hpkg - ``` - -### Atualizar com pacote de atualização -Atualize para a versão mais recente do cluster do {% data variables.product.prodname_ghe_server %} usando um pacote de atualização. Por exemplo, você pode atualizar da versão `2.11` para a versão `2.13`. - -#### Preparar para a atualização - -1. Revise a [Configuração de rede de clustering](/enterprise/admin/guides/clustering/cluster-network-configuration) da versão para a qual você pretende atualizar e faça os ajustes necessários em sua configuração. -2. Faça backup dos seus dados com o [{% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils#readme). -3. Programe um período de manutenção para os usuários finais do cluster do {% data variables.product.prodname_ghe_server %}, já que ele ficará indisponível para uso regular durante a atualização. O modo de manutenção bloqueia o acesso de usuários e impede alterações de dados durante a atualização do cluster. -4. Na [Página de download do {% data variables.product.prodname_ghe_server %}](https://enterprise.github.com/download), copie a URL do arquivo *.pkg* da atualização para a área de transferência. -5. No shell administrativo de qualquer nó, use o comando `ghe-cluster-each` combinado ao código `curl` para baixar o pacote de versão de cada nó em uma única etapa. Como argumento, use a URL que você copiou na etapa anterior. - ```shell - $ ghe-cluster-each -- "cd /home/admin && curl -L -O https://PACKAGE-URL.pkg" - > ghe-app-node-1: % Total % Received % Xferd Average Speed Time Time Time Current - > ghe-app-node-1: Dload Upload Total Spent Left Speed - > 100 496M 100 496M 0 0 24.2M 0 0:00:20 0:00:20 --:--:-- 27.4M - > ghe-data-node-2: % Total % Received % Xferd Average Speed Time Time Time Current - > ghe-data-node-2: Dload Upload Total Spent Left Speed - > 100 496M 100 496M 0 0 21.3M 0 0:00:23 0:00:23 --:--:-- 25.8M - > ghe-data-node-1: % Total % Received % Xferd Average Speed Time Time Time Current - > ghe-data-node-1: Dload Upload Total Spent Left Speed - > 100 496M 100 496M 0 0 19.7M 0 0:00:25 0:00:25 --:--:-- 25.6M - > ghe-app-node-2: % Total % Received % Xferd Average Speed Time Time Time Current - > ghe-app-node-2: Dload Upload Total Spent Left Speed - > 100 496M 100 496M 0 0 19.8M 0 0:00:25 0:00:25 --:--:-- 17.6M - > ghe-data-node-3: % Total % Received % Xferd Average Speed Time Time Time Current - > ghe-data-node-3: Dload Upload Total Spent Left Speed - > 100 496M 100 496M 0 0 19.7M 0 0:00:25 0:00:25 --:--:-- 25.5M - ``` -6. Identifique o nó primário MySQL, definido como `mysql-master = ` em `cluster.conf`. Esse nó será atualizado por último. - -#### Atualizar os nós de cluster - -1. Ative o modo de manutenção conforme o período planejado conectando-se ao shell administrativo de qualquer nó do cluster e executando o código `ghe-cluster-maintenance -s`. -2. **Com exceção do nó primário MySQL**, conecte-se ao shell administrativo de cada nó do {% data variables.product.prodname_ghe_server %}. Execute o comando `ghe-upgrade` informando o nome do arquivo que você baixou na Etapa 4 do procedimento [Preparar para a atualização](#preparing-to-upgrade): - ```shell - $ ghe-upgrade PACKAGE-FILENAME.pkg - > *** verifying upgrade package signature... - > 497MB 0:00:04 [ 117MB/s] [==========================================>] 100% - > gpg: Signature made Fri 19 Feb 2016 02:33:50 PM UTC using RSA key ID 0D65D57A - > gpg: checking the trustdb - > gpg: 3 marginal(s) needed, 1 complete(s) needed, PGP trust model - > gpg: depth: 0 valid: 1 signed: 0 trust: 0-, 0q, 0n, 0m, 0f, 1u - > gpg: Good signature from "GitHub Enterprise (Upgrade Package Key) > " - ``` -3. Assim que for concluído, o processo de atualização reinicializará o nó. Verifique se você consegue fazer `ping` em cada nó após a reinicialização. -4. Conecte-se ao shell administrativo do nó primário MySQL. Execute o comando `ghe-upgrade` informando o nome do arquivo que você baixou na Etapa 4 do procedimento [Preparar para a atualização](#preparing-to-upgrade): - ```shell - $ ghe-upgrade PACKAGE-FILENAME.pkg - > *** verifying upgrade package signature... - > 497MB 0:00:04 [ 117MB/s] [==========================================>] 100% - > gpg: Signature made Fri 19 Feb 2016 02:33:50 PM UTC using RSA key ID 0D65D57A - > gpg: checking the trustdb - > gpg: 3 marginal(s) needed, 1 complete(s) needed, PGP trust model - > gpg: depth: 0 valid: 1 signed: 0 trust: 0-, 0q, 0n, 0m, 0f, 1u - > gpg: Good signature from "GitHub Enterprise (Upgrade Package Key) > " - ``` -5. Assim que for concluído, o processo de atualização reinicializará o nó primário MySQL. Verifique se você consegue fazer `ping` em cada nó após a reinicialização. -6. Saia do modo de manutenção do shell administrativo de qualquer nó executando o código `ghe-cluster-maintenance -u`. diff --git a/translations/pt-BR/content/admin/configuration/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md b/translations/pt-BR/content/admin/configuration/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md deleted file mode 100644 index f0fe1e520d89..000000000000 --- a/translations/pt-BR/content/admin/configuration/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: Habilitar alertas de segurança para dependências vulneráveis no GitHub Enterprise Server -intro: 'Você pode conectar a {% data variables.product.product_location_enterprise %} ao {% data variables.product.prodname_ghe_cloud %} e habilitar os alertas de segurança para dependências vulneráveis nos repositórios na sua instância.' -redirect_from: - - /enterprise/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server - - /enterprise/admin/configuration/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server -permissions: 'Os administradores de sites para {% data variables.product.prodname_ghe_server %} que também são proprietários de uma conta corporativa ou organização conectada do {% data variables.product.prodname_ghe_cloud %} podem ativar alertas de segurança para dependências vulneráveis em {% data variables.product.prodname_ghe_server %}.' -versions: - enterprise-server: '*' ---- - -### Sobre alertas para dependências vulneráveis no {% data variables.product.prodname_ghe_server %} - -{% data reusables.repositories.tracks-vulnerabilities %} Para obter mais informações, consulte "[Sobre alertas de dependências vulneráveis](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)". - -Você pode conectar a {% data variables.product.product_location_enterprise %} ao {% data variables.product.prodname_dotcom_the_website %}, sincronizar os dados de vulnerabilidade com a sua instância e gerar alertas de segurança em repositórios com dependência vulnerável. - -Depois de conectar o {% data variables.product.product_location_enterprise %} ao {% data variables.product.prodname_dotcom_the_website %} e habilitar os alertas de segurança para dependências vulneráveis, os dados de vulnerabilidade serão sincronizados do {% data variables.product.prodname_dotcom_the_website %} para a sua instância a cada hora. Também é possível sincronizar os dados de vulnerabilidade manualmente a qualquer momento. Nenhum código ou informações sobre o código da {% data variables.product.product_location_enterprise %} são carregados para o {% data variables.product.prodname_dotcom_the_website %}. - -Ao receber informações sobre vulnerabilidades, a {% data variables.product.product_location_enterprise %} identificará os repositórios da sua instância que usam a versão afetada da dependência e enviará alertas de segurança para os proprietários e usuários com acesso administrativo nos repositórios em questão. É possível personalizar o recebimento dos alertas de segurança. Para obter mais informações, consulte "[Sobre alertas para dependências vulneráveis](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies/#configuring-notifications-for-security-alerts)" - -### Habilitar alertas de segurança para dependências vulneráveis no {% data variables.product.prodname_ghe_server %} - -Antes de habilitar os alertas de segurança para as dependências de vulnerabilidade na {% data variables.product.product_location_enterprise %}, conecte a {% data variables.product.product_location_enterprise %} ao {% data variables.product.prodname_dotcom_the_website %}. Para obter mais informações, consulte "[Conectar o {% data variables.product.prodname_ghe_server %} ao {% data variables.product.prodname_ghe_cloud %}](/enterprise/{{ currentVersion }}/admin/guides/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)". - -{% if currentVersion ver_gt "enterprise-server@2.20" %} Recomendamos configurar alertas de segurança sem notificações nos primeiros dias para evitar uma sobrecarga de e-mails. Após alguns dias, você pode habilitar notificações para receber alertas de segurança como de costume.{% endif %} - -{% data reusables.enterprise_site_admin_settings.sign-in %} -2. No shell administrativo, habilite os alertas de segurança para dependências de vulnerabilidade na {% data variables.product.product_location_enterprise %}: - ``` shell -$ ghe-dep-graph-enable -``` -3. Volte para o {% data variables.product.prodname_ghe_server %}. -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %}{% if currentVersion ver_gt "enterprise-server@2.20" %} -5. Em "Repositories can be scanned for vulnerabilities" (Os repositórios podem ser examinados para vulnerabilidades), use o menu suspenso e clique em **Enabled without notifications** (Habilitado sem notificações). Opcionalmente, para habilitar alertas com notificações, selecione **Enabled with notifications**(Habilitado com notificações).{% else %} -5. Em "Repositories can be scanned for vulnerabilities" (Verificar vulnerabilidades nos repositórios), use o menu suspenso e clique em **Enabled** (Habilitado). -{% endif %} - ![Menu suspenso para habilitar a verificação vulnerabilidades nos repositórios](/assets/images/enterprise/site-admin-settings/enable-vulnerability-scanning-in-repositories.png) - -### Exibir dependências vulneráveis no {% data variables.product.prodname_ghe_server %} - -Você pode exibir todas as vulnerabilidades na {% data variables.product.product_location_enterprise %} e sincronizar manualmente os dados de vulnerabilidade do {% data variables.product.prodname_dotcom_the_website %} para atualizar a lista. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -2. Na barra lateral esquerda, clique em **Vulnerabilities** (Vulnerabilidades). ![Guia Vulnerabilities (Vulnerabilidades) na barra lateral de administração do site](/assets/images/enterprise/business-accounts/vulnerabilities-tab.png) -3. Para sincronizar os dados de vulnerabilidade, clique em **Sync Vulnerabilities now** (Sincronizar vulnerabilidades agora). ![Botão Sync Vulnerabilities now (Sincronizar vulnerabilidades agora)](/assets/images/enterprise/site-admin-settings/sync-vulnerabilities-button.png) diff --git a/translations/pt-BR/content/admin/developer-workflow/about-pre-receive-hooks.md b/translations/pt-BR/content/admin/developer-workflow/about-pre-receive-hooks.md deleted file mode 100644 index 0072e4b2561e..000000000000 --- a/translations/pt-BR/content/admin/developer-workflow/about-pre-receive-hooks.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: Sobre hooks pre-receive -intro: '*Hooks pre-receive* são scripts executados no appliance do {% data variables.product.prodname_ghe_server %} que você pode usar para implementar verificações de qualidade.' -redirect_from: - - /enterprise/admin/developer-workflow/about-pre-receive-hooks -versions: - enterprise-server: '*' ---- - -Quando ocorre um push, cada script é executado em um ambiente isolado e pode executar verificações no conteúdo do push. Os scripts farão o push ser aceito se o status de saída for 0, ou farão o push ser rejeitado se o status de saída for diferente de zero. - -### Cenários de uso -Use os hooks pre-receive para cumprir com as regras corporativas, aplicar a conformidade regulamentar e evitar certos erros comuns. - -Exemplos de uso dos hooks pre-receive: - -- Exigir que as mensagens de commit sigam determinado padrão ou formato, como incluir um número de ticket válido ou ter um tamanho especificado; -- Bloquear um branch ou repositório rejeitando todos os pushes; -- Evitar a inclusão de dados confidenciais no repositório bloqueando palavras-chave, padrões ou tipos de arquivos; -- Evitar que o autor da pull request faça merge em suas próprias alterações. - -### Fluxos de trabalho e impacto no desempenho -O impacto para os desenvolvedores e seus fluxos de trabalho pode ser significativo e deve ser considerado atentamente. Hooks pre-receive baseados nas demandas corporativas e implementados com cuidado trarão mais benefícios para a organização como um todo. - -Os hooks pre-receive podem ter efeitos indesejados no desempenho do {% data variables.product.product_location_enterprise %}, devendo ser implementados e analisados com atenção. diff --git a/translations/pt-BR/content/admin/developer-workflow/about-protected-branches-and-required-status-checks.md b/translations/pt-BR/content/admin/developer-workflow/about-protected-branches-and-required-status-checks.md deleted file mode 100644 index 8329073659b9..000000000000 --- a/translations/pt-BR/content/admin/developer-workflow/about-protected-branches-and-required-status-checks.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Sobre branches protegidos e verificações de status obrigatórias -intro: 'Branches protegidos garantem que os colaboradores de um repositório não consigam fazer alterações irreversíveis nos branches. As verificações de status obrigatórias garantem que todos os testes de CI sejam aprovados antes que os colaboradores possam fazer alterações em um branch protegido. Os branches dentro de repositórios pertencentes a organizações podem ser configurados de forma que somente determinados usuários {% if currentVersion ver_gt "enterprise-server@2.18" %}{% else %}, {% endif %} equipes{% if currentVersion ver_gt "enterprise-server@2.18" %} ou aplicativos{% endif %} possam fazer push em um branch.' -redirect_from: - - /enterprise/admin/developer-workflow/about-protected-branches-and-required-status-checks -versions: - enterprise-server: '*' ---- - -Os *branches protegidos* bloqueiam vários recursos do Git nos branches que o administrador decidir proteger. Em um branch protegido, os usuários não podem: - -* Usar pushes forçados; -* Fazer exclusões; -* Fazer merge das alterações até a [aprovação das verificações de status exigidas](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/configuring-protected-branches-and-required-status-checks#enabling-required-status-checks). - -Qualquer pessoa com permissões de administrador para um repositório tem acesso livre para fazer push em um branch protegido. Se você habilitar *restrições de branch*, apenas usuários{% if currentVersion ver_gt "enterprise-server@2.18" %}{% else %},{% endif %} equipes{% if currentVersion ver_gt "enterprise-server@2.18" %} ou aplicativos{% endif %} que receberam permissões podem fazer push para um branch protegido. Para obter mais informações, consulte "[Configurar branches protegidos e verificações de status obrigatórias](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/configuring-protected-branches-and-required-status-checks)". - -![Permissões de branch restritas](/assets/images/help/repository/restrict-branch-users.png). - -{% tip %} - -**Observação:** Se a opção "Include administrators" (Incluir administradores) estiver selecionada e você [tiver habilitado as verificações de status obrigatórias](/articles/enabling-required-status-checks) no branch e elas falharem, qualquer tentativa de fazer push das alterações no branch protegido também falhará, mesmo para pessoas{% if currentVersion ver_gt "enterprise-server@2.18" %} e aplicativos{% endif %} com permissões de administrador. - -{% endtip %} diff --git a/translations/pt-BR/content/admin/developer-workflow/blocking-force-pushes-on-your-appliance.md b/translations/pt-BR/content/admin/developer-workflow/blocking-force-pushes-on-your-appliance.md deleted file mode 100644 index 83496b99f157..000000000000 --- a/translations/pt-BR/content/admin/developer-workflow/blocking-force-pushes-on-your-appliance.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: Bloquear pushes forçados no appliance -redirect_from: - - /enterprise/admin/articles/blocking-force-pushes-on-your-appliance/ - - /enterprise/admin/developer-workflow/blocking-force-pushes-on-your-appliance -intro: 'Qualquer administrador do site pode bloquear todos os pushs forçados em um appliance do {% data variables.product.prodname_ghe_server %}' -versions: - enterprise-server: '*' ---- - -Cada repositório herda uma configuração padrão de push forçado das configurações da conta de usuário ou da organização à qual pertence. Da mesma forma, cada organização e conta de usuário herda uma configuração padrão de push forçado a partir da configuração de push forçado para todo o appliance. Se você alterar a configuração de push forçado no appliance, ela será alterada em todos os repositórios pertencentes a qualquer usuário ou organização. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -4. Em "Force pushes" (Pushes forçados), use o menu suspenso e clique em **Allow** (Permitir), **Block** (Bloquear) ou **Block to the default branch** (Bloquear no branch padrão). ![Menu suspenso pushes forçados](/assets/images/enterprise/site-admin-settings/force-pushes-dropdown.png) -5. Você também pode selecionar a opção **Enforce on all repositories** (Forçar em todos os repositórios), que substituirá as configurações no nível da organização e do repositório por push forçados. - -### Further reading - -- [Bloquear pushes forçados em repositórios pertencentes a uma organização ou conta de usuário](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization) -- [Bloquear pushes forçados em um repositório](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository) diff --git a/translations/pt-BR/content/admin/developer-workflow/blocking-force-pushes-to-a-repository.md b/translations/pt-BR/content/admin/developer-workflow/blocking-force-pushes-to-a-repository.md deleted file mode 100644 index 242a75b2ad7c..000000000000 --- a/translations/pt-BR/content/admin/developer-workflow/blocking-force-pushes-to-a-repository.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Bloquear pushes forçados em um repositório -redirect_from: - - /enterprise/admin/articles/blocking-force-pushes-to-a-repository/ - - /enterprise/admin/articles/block-force-pushes/ - - /enterprise/admin/developer-workflow/blocking-force-pushes-to-a-repository -intro: Você pode bloquear pushes forçados (`git push --force`) em todos os branches (ou somente no branch padrão) de um repositório. -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_site_admin_settings.override-policy %} - -{% data reusables.enterprise_site_admin_settings.sign-in %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -4. Selecione **Block** (Bloquear) ou **Block to the default branch** (Bloquear no branch padrão) em **Push and Pull** (Operações de push e pull). ![Bloquear pushes forçados](/assets/images/enterprise/site-admin-settings/repo/repo-block-force-pushes.png) - -As alterações entram em vigor de imediato. Se mudar de ideia depois, você poderá permitir os pushes forçados novamente. - -## Leia mais - -- [Bloquear pushes forçados em repositórios pertencentes a uma organização ou conta de usuário](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization) -- "[Bloquear pushes forçados no appliance](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-on-your-appliance)" diff --git a/translations/pt-BR/content/admin/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization.md b/translations/pt-BR/content/admin/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization.md deleted file mode 100644 index 4dc4bb516a3e..000000000000 --- a/translations/pt-BR/content/admin/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: Bloquear pushes forçados em repositórios pertencentes a uma organização ou conta de usuário -redirect_from: - - /enterprise/admin/articles/blocking-force-pushes-for-a-user-account/ - - /enterprise/admin/articles/blocking-force-pushes-for-an-organization/ - - /enterprise/admin/articles/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization/ - - /enterprise/admin/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization -intro: Você pode bloquear pushes forçados (`git push --force`) em todos os branches ou somente no branch padrão dos repositórios pertencentes a uma organização ou conta de usuário. -versions: - enterprise-server: '*' ---- - -Os repositórios herdam as configurações de push forçado da conta do usuário ou da organização à qual pertencem. Por sua vez, as organizações e contas de usuário herdam suas configurações de push forçado a partir das configurações de push forçado para todo o appliance. - -Você pode substituir as configurações padrão herdadas definindo as configurações da conta de usuário ou da organização. - -{% data reusables.enterprise_site_admin_settings.sign-in %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.search-user-or-org %} -{% data reusables.enterprise_site_admin_settings.click-user-or-org %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -5. Em "Repository default settings" (Configurações padrão do repositório) na seção "Force pushes" (Pushes forçados), selecione - - **Block** (Bloquear) para bloquear os pushes forçados em todos os branches. - - **Block to the default branch** (Bloquear no branch padrão) para bloquear os pushes forçados apenas no branch padrão. ![Bloquear pushes forçados](/assets/images/enterprise/site-admin-settings/user/user-block-force-pushes.png) -6. Você também pode selecionar a opção **Enforce on all repositories** (Forçar em todos os repositórios), que substituirá as configurações específicas do repositório. Observe que essa ação **não** substitui políticas no nível do appliance. ![Block force pushes](/assets/images/enterprise/site-admin-settings/user/user-block-all-force-pushes.png) A alteração entra em vigor de imediato. Se mudar de ideia depois, você poderá permitir os pushes forçados novamente. - -### Further reading - -- [Bloquear pushes forçados em um repositório](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository) -- "[Bloquear pushes forçados no appliance](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-on-your-appliance)" diff --git a/translations/pt-BR/content/admin/developer-workflow/blocking-force-pushes.md b/translations/pt-BR/content/admin/developer-workflow/blocking-force-pushes.md deleted file mode 100644 index 9dba786f7206..000000000000 --- a/translations/pt-BR/content/admin/developer-workflow/blocking-force-pushes.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Bloquear pushes forçados -intro: 'Você pode bloquear a opção de pushes forçados em todos os repositórios no appliance do {% data variables.product.prodname_ghe_server %}, bem como em todos os repositórios pertencentes a uma organização ou em determinado repositório.' -mapTopic: true -redirect_from: - - /enterprise/admin/developer-workflow/blocking-force-pushes -versions: - enterprise-server: '*' ---- - diff --git a/translations/pt-BR/content/admin/developer-workflow/configuring-protected-branches-and-required-status-checks.md b/translations/pt-BR/content/admin/developer-workflow/configuring-protected-branches-and-required-status-checks.md deleted file mode 100644 index b575256f326d..000000000000 --- a/translations/pt-BR/content/admin/developer-workflow/configuring-protected-branches-and-required-status-checks.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: Configurar branches protegidos e verificações de status obrigatórias -intro: 'Você pode habilitar branches protegidos para limitar a manipulação dos branches, além de impor verificações de status obrigatórias antes de fazer merge de um branch em uma pull request ou antes de fazer push de commits em um branch local para o branch remoto protegido.' -redirect_from: - - /enterprise/admin/developer-workflow/configuring-protected-branches-and-required-status-checks -versions: - enterprise-server: '*' ---- - -Qualquer pessoa com permissões de administrador em um repositório pode habilitar restrições de branch. - -### Habilitar branches protegidos em um repositório - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -{% data reusables.repositories.repository-branches %} -{% data reusables.repositories.add-branch-protection-rules %} -5. Clique **Criar**. - -### Tipos de verificações de status obrigatórias - -| Tipo de verificação de status obrigatória | Configuração | Requisitos de merge | Considerações | -| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| **Rígida** | A caixa de seleção **Require branches to be up-to-date before merging** (Exigir a atualização dos branches antes de fazer merge) fica marcada. | O branch **precisa** ser atualizado no branch base antes do merge. | Este é o comportamento padrão para verificações de status obrigatórias. Podem ser necessárias mais compilações, já que você precisará atualizar o branch head depois que outros colaboradores fizerem merge de pull requests no branch base protegido. | -| **Flexível** | A caixa de seleção **Require branches to be up-to-date before merging** (Exigir a atualização dos branches antes de fazer merge) **não** fica marcada. | O branch **não precisa** ser atualizado no branch base antes do merge. | Serão necessárias menos compilações, já que você não precisará atualizar o branch head depois que outros colaboradores fizerem merge de pull requests. As verificações de status poderão falhar depois que você fizer merge do branch, caso haja alterações incompatíveis com o branch base. | -| **Desabilitada** | A caixa de seleção **Require status checks to pass before merging** (Exigir verificações de status para aprovação antes de fazer merge) **não** fica marcada. | O branch não tem restrições de merge. | Se as verificações de status obrigatórias não estiverem habilitadas, os colaboradores poderão fazer merge do branch a qualquer momento, estando ou não atualizados com o branch base. Isso aumenta a possibilidade de alterações incompatíveis. | - -### Habilitar verificações de status obrigatórias - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -{% data reusables.repositories.repository-branches %} -{% data reusables.repositories.add-branch-protection-rules %} -5. Selecione **Require status checks to pass before merging** (Exigir verificações de status para aprovação antes de fazer merge). ![Opção Required status checks (Verificações de status obrigatórias)](/assets/images/help/repository/required-status-checks.png) -6. Na lista de verificações de status disponíveis, selecione aquelas que você deseja tornar obrigatórias. ![Lista de verificações de status disponíveis](/assets/images/help/repository/required-statuses-list.png) -{% data reusables.repositories.include-administrators %} -8. Outra opção é desmarcar **Require branches to be up to date before merging** (Exigir que os branches sejam atualizados antes de fazer merge). Se selecionada, isso garante que o branch foi testado com o código mais recente no branch básico. ![Caixa de seleção Status obrigatório rígido ou flexível](/assets/images/help/repository/protecting-branch-loose-status-new.png) -9. Opcionalmente, selecione {% if currentVersion ver_gt "enterprise-server@2.18" %}**Restringir quem pode fazer push em branches correspondentes**{% else %}**Restringir quem pode fazer push neste branch**{% endif %}. ![Caixa de seleção restrição de branch]{% if currentVersion ver_gt "enterprise-server@2.18" %}(/assets/images/help/repository/restrict-branch.png){% else %}(/assets/images/help/repository/restrict-branch-push.png){% endif %} -10. Pesquise e selecione as pessoas{% if currentVersion ver_gt "enterprise-server@2.18" %},{% else %} ou{% endif %} equipes{% if currentVersion ver_gt "enterprise-server@2.18" %} ou apps{% endif %} que terão permissão para fazer push no branch protegido. ![Pesquisa de restrição de branch](/assets/images/help/repository/restrict-branch-search.png) -11. Clique **Criar**. - -{% data reusables.repositories.required-status-merge-tip %} diff --git a/translations/pt-BR/content/admin/developer-workflow/continuous-integration-using-jenkins.md b/translations/pt-BR/content/admin/developer-workflow/continuous-integration-using-jenkins.md deleted file mode 100644 index 086cec2d62cb..000000000000 --- a/translations/pt-BR/content/admin/developer-workflow/continuous-integration-using-jenkins.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: Integração contínua usando o Jenkins -intro: 'Você pode acionar automaticamente tarefas de criação em um servidor Jenkins quando houver pushes para um repositório na {% data variables.product.product_location_enterprise %}.' -redirect_from: - - /enterprise/admin/developer-workflow/continuous-integration-using-jenkins -versions: - enterprise-server: '*' ---- - -### Requisitos - -- Leia nosso artigo "[Guia prático de integração com o Jenkins e o GitHub](https://resources.github.com/whitepapers/practical-guide-to-CI-with-Jenkins-and-GitHub/)" para ver instruções detalhadas sobre como acionar automaticamente tarefas de criação em um servidor Jenkins quando houver pushes para um repositório na {% data variables.product.product_location_enterprise %}. diff --git a/translations/pt-BR/content/admin/developer-workflow/creating-a-pre-receive-hook-environment.md b/translations/pt-BR/content/admin/developer-workflow/creating-a-pre-receive-hook-environment.md deleted file mode 100644 index c3f279b319ed..000000000000 --- a/translations/pt-BR/content/admin/developer-workflow/creating-a-pre-receive-hook-environment.md +++ /dev/null @@ -1,92 +0,0 @@ ---- -title: Criar um ambiente de hook pre-receive -intro: 'Para executar hooks pre-receive, use o ambiente pre-receive padrão ou crie um ambiente personalizado.' -redirect_from: - - /enterprise/admin/developer-workflow/creating-a-pre-receive-hook-environment -versions: - enterprise-server: '*' ---- - -Um ambiente pre-receive para o {% data variables.product.prodname_ghe_server %} é um ambiente Linux [`chroot`](https://en.wikipedia.org/wiki/Chroot). Como são executados em todos os eventos de push, os hooks pre-receive devem ser rápidos e leves. Em geral, o ambiente necessário para tais verificações é mínimo. - -O {% data variables.product.prodname_ghe_server %} fornece um ambiente padrão que inclui os seguintes pacotes: `awk`, `bash`, `coreutils`, `curl`, `find`, `gnupg`, `grep`, `jq`, `sed`. - -Se você tiver algum requisito específico não atendido por esse ambiente, como suporte a determinado idioma, é possível criar e fazer upload do seu próprio ambiente Linux `chroot` de 64 bits. - -### Criar um ambiente de hook pre-receive usando o Docker - -Você pode usar uma ferramenta de gerenciamento de contêineres do Linux para criar um ambiente de hook pre-receive. Este exemplo usa o [Alpine Linux](http://www.alpinelinux.org/) e o [Docker](https://www.docker.com/). - -{% data reusables.linux.ensure-docker %} -2. Crie o arquivo `Dockerfile.alpine-3.3` que contém estas informações: - - ``` - FROM gliderlabs/alpine:3.3 - RUN apk add --no-cache git bash - ``` -3. No diretório que contém `Dockerfile.alpine-3.3`, crie uma imagem: - - ```shell - $ docker build -f Dockerfile.alpine-3.3 -t pre-receive.alpine-3.3 . - > Sending build context to Docker daemon 12.29 kB - > Step 1 : FROM gliderlabs/alpine:3.3 - > ---> 8944964f99f4 - > Step 2 : RUN apk add --no-cache git bash - > ---> Using cache - > ---> 0250ab3be9c5 - > Successfully built 0250ab3be9c5 - ``` -4. Crie um contêiner: - - ```shell - $ docker create --name pre-receive.alpine-3.3 pre-receive.alpine-3.3 /bin/true - ``` -5. Exporte o contêiner Docker para um arquivo `tar` compactado por `gzip`: - - ```shell - $ docker export pre-receive.alpine-3.3 | gzip > alpine-3.3.tar.gz - ``` - - O arquivo `alpine-3.3.tar.gz` está pronto para o upload no appliance do {% data variables.product.prodname_ghe_server %}. - -### Criar um ambiente de hook pre-receive usando chroot - -1. Crie um ambiente Linux `chroot`. -2. Crie um arquivo `tar` do diretório `chroot` compactado em um `gzip`. - ```shell - $ cd /path/to/chroot - $ tar -czf /path/to/pre-receive-environment.tar.gz . - ``` - - {% note %} - - **Observações:** - - Não inclua caminhos do diretório principal de arquivos dentro do arquivo tar, como `/path/to/chroot`. - - `/bin/sh` deve existir e ser executável, como o ponto de entrada no ambiente chroot. - - Ao contrário de chroots tradicionais, o diretório `dev` não é exigido pelo ambiente chroot para hooks pre-receive. - - {% endnote %} - -Para obter mais informações sobre como criar um ambiente chroot, consulte "[Chroot](https://wiki.debian.org/chroot)" na *Debian Wiki*, "[BasicChroot](https://help.ubuntu.com/community/BasicChroot)" na *Ubuntu Community Help Wiki* ou "[Instalar Alpine Linux em chroot](http://wiki.alpinelinux.org/wiki/Installing_Alpine_Linux_in_a_chroot)" na *Alpine Linux Wiki*. - -### Fazer upload de um ambiente de hook pre-receive no {% data variables.product.prodname_ghe_server %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.hooks-tab %} -5. Clique em **Manage environments** (Gerenciar ambientes). ![Gerenciar ambientes](/assets/images/enterprise/site-admin-settings/manage-pre-receive-environments.png) -6. Clique em **Add environments** (Adicionar ambientes). ![Adicionar ambiente](/assets/images/enterprise/site-admin-settings/add-pre-receive-environment.png) -7. Digite o nome desejado no campo **Environment name** (Nome do ambiente). ![Nome do ambiente](/assets/images/enterprise/site-admin-settings/pre-receive-environment-name.png) -8. Informe a URL do arquivo `*.tar.gz` que contém o ambiente. ![Fazer upload de um ambiente a partir da URL](/assets/images/enterprise/site-admin-settings/upload-environment-from-url.png) -9. Clique em **Add environments** (Adicionar ambientes). ![Botão Adicionar ambiente](/assets/images/enterprise/site-admin-settings/add-environment-button.png) - -### Fazer upload de um ambiente de hook pre-receive via shell administrativo -1. Faça upload do arquivo legível `*.tar.gz` que contém o seu ambiente para um host na web e copie a URL, ou transfira o arquivo para o appliance do {% data variables.product.prodname_ghe_server %} via `scp`. Ao usar o `scp`, você deve ajustar as permissões do arquivo `*.tar.gz` para que ele seja legível. -1. Conecte-se ao shell administrativo. -2. Use o comando `ghe-hook-env-create` e digite o nome que você deseja para o ambiente como o primeiro argumento. Em seguida, informe o caminho local completo ou a URL do arquivo `*.tar.gz` que contém seu ambiente como segundo argumento. - - ```shell - admin@ghe-host:~$ ghe-hook-env-create AlpineTestEnv /home/admin/alpine-3.3.tar.gz - > Pre-receive hook environment 'AlpineTestEnv' (2) has been created. - ``` diff --git a/translations/pt-BR/content/admin/developer-workflow/creating-a-pre-receive-hook-script.md b/translations/pt-BR/content/admin/developer-workflow/creating-a-pre-receive-hook-script.md deleted file mode 100644 index 7540a6a576ea..000000000000 --- a/translations/pt-BR/content/admin/developer-workflow/creating-a-pre-receive-hook-script.md +++ /dev/null @@ -1,199 +0,0 @@ ---- -title: Criar um script de hook pre-receive -intro: Use os scripts de hooks pre-receive a fim de criar requisitos para aceitar ou rejeitar um push com base no conteúdo. -redirect_from: - - /enterprise/admin/developer-workflow/creating-a-pre-receive-hook-script -versions: - enterprise-server: '*' ---- - -Veja exemplos de hooks pre-receive para o {% data variables.product.prodname_ghe_server %} no repositório [`github/platform-samples`](https://github.com/github/platform-samples/tree/master/pre-receive-hooks). - -### Gravar um script de hook pre-receive -Um script de hook pre-receive é executado em um ambiente de hook pre-receive no appliance do {% data variables.product.prodname_ghe_server %}. Ao criar um script de hook pre-receive, pense nas variáveis disponíveis de entrada, saída, status de saída e ambiente. - -#### Entrada (stdin) -Após a ocorrência de um push e antes que qualquer ref seja atualizada no repositório remoto, o processo `git-receive-pack` invoca o script de hook pre-receive com a entrada padrão de uma linha por ref a ser atualizada: - -` SP SP LF` - -Essa string representa os seguintes argumentos: - -| Argumento | Descrição | -|:------------------- |:----------------------------------------------------------------------------------------------------------------- | -| `` | Nome antigo do objeto armazenado na `ref`.
    Quando você *cria* uma `ref`, o valor fica igual a 40 zeros. | -| `` | Nome novo do objeto a ser armazenado na `ref`.
    Quando você *exclui* uma `ref`, o valor fica igual a 40 zeros. | -| `` | Nome completo da `ref`. | - -Para obter mais informações sobre o `git-receive-pack`, consulte "[git-receive-pack](https://git-scm.com/docs/git-receive-pack)" na documentação do Git. Para obter mais informações sobre as `refs` consulte "[Referências do Git](https://git-scm.com/book/en/v2/Git-Internals-Git-References)" em *Pro Git*. - -#### Saída (stdout) - -A saída do script (` stdout `) é passada de volta para o cliente. Portanto, qualquer instrução ` echo ` fica visível para o usuário na linha de comando ou na interface do usuário. - -#### Status de saída (exit-status) - -O `exit-status` de um script pre-receive determina se o push será aceito. - -| Valor exit-status | Ação | -|:-----------------:|:----------------------:| -| 0 | O push será aceito. | -| Diferente de zero | O push será rejeitado. | - -#### Variáveis de ambiente -Fora dos valores fornecidos para `stdin`, há variáveis adicionais disponíveis para o script de hook pre-receive em execução no {% data variables.product.prodname_ghe_server %}. - -| Variável | Descrição | -|:------------------------------------- |:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| $GITHUB_USER_LOGIN | ID do usuário que criou a `ref`. | -| $GIT_DIR | Caminho do repositório remoto no appliance. | -| $GITHUB_USER_IP | Endereço IP do usuário que fez o push. | -| $GITHUB_REPO_NAME | Nome do repositório que está sendo atualizado, no formato `proprietário`/`repositório`. | -| $GITHUB_PULL_REQUEST_AUTHOR_LOGIN | ID de usuário do autor de uma pull request aberta na sua instância. | -| $GITHUB_REPO_PUBLIC | Valor booleano que representa um repositório público quando é `true` e representa um repositório privado quando é `false`. | -| $GITHUB_PUBLIC_KEY_FINGERPRINT | Impressão digital da chave pública do usuário. | -| $GITHUB_PULL_REQUEST_HEAD | String no formato: `user:branch` para o HEAD do PR.
    Exemplo: `octocat:fix-bug` | -| $GITHUB_PULL_REQUEST_BASE | String no formato: `user:branch` para a BASE do PR.
    Exemplo: `octocat:master` | -| $GITHUB_VIA | Método de criação da ref.
    **Valores possíveis:**
    - `api de desenvolvimento automerge`
    - `edição blob`
    - `api de merge branch`
    - `botão de exclusão de página de branches`
    - `api de criação de refs git`
    - `api de exclusão de refs git`
    - `api de atualização de refs git`
    - `api de merge`
    - `botão de exclusão de branch de pull request`
    - `botão de desfazer branch de pull request`
    - `api de merge de pull request`
    - `botão de merge de pull request`
    - `api de reverter pull request`
    - `botão de exclusão de versões`
    - `restauração de branch de ferramentas de equipe`
    - `slumlord (#{sha})` | -| $GIT_PUSH_OPTION_COUNT | Número de opções de push enviadas pelo cliente. Para obter mais informações sobre as opções de push, consulte "[git-push](https://git-scm.com/docs/git-push#git-push---push-optionltoptiongt)" na documentação do Git. | -| $GIT_PUSH_OPTION_N | Quando N for um número inteiro a partir de 0, esta variável vai conter a string de opção de push enviada pelo cliente. A primeira opção enviada é armazenada em GIT_PUSH_OPTION_0, a segunda é armazenada em GIT_PUSH_OPTION_1 e assim por diante. Para obter mais informações sobre as opções de push, consulte "[git-push](https://git-scm.com/docs/git-push#git-push---push-optionltoptiongt)" na documentação do Git. | - -### Configurar permissões e fazer push de um hook pre-receive para o {% data variables.product.prodname_ghe_server %} - -Um script de hook pre-receive está contido em um repositório no appliance do {% data variables.product.prodname_ghe_server %}. O administrador do site deve considerar as permissões do repositório e garantir que somente os usuários adequados tenham acesso. - -Recomendamos consolidar os hooks em um único repositório. Se o repositório consolidado do hook for público, será possível usar `LEIAME.md` para explicar a execução das políticas. Além disso, é possível aceitar contribuições via pull request. No entanto, os hooks pre-receive só podem ser adicionados pelo branch padrão. Em fluxos de trabalho de teste, devem ser usados forks do repositório com a devida configuração. - -1. Para usuários de Mac, certifique-se de que os scripts tenham estas permissões de execução: - - ```shell - $ sudo chmod +x SCRIPT_FILE.sh - ``` - Para usuários de Windows, certifique-se de que os scripts tenham estas permissões de execução: - - ```shell - git update-index --chmod=+x SCRIPT_FILE.sh - ``` - -2. Faça commit e push para o seu repositório designado de hooks pre-receive na instância do {% data variables.product.prodname_ghe_server %}. - - ```shell - $ git commit -m "YOUR COMMIT MESSAGE" - $ git push - ``` - -3. [Crie o hook pre-receive](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance/#creating-pre-receive-hooks) na instância do {% data variables.product.prodname_ghe_server %}. - -### Testar scripts pre-receive no local -Antes de criar ou atualizar um script de hook pre-receive no appliance do {% data variables.product.prodname_ghe_server %}, você pode testá-lo no local. Uma forma de fazer isso é criar um ambiente Docker local para funcionar como repositório remoto que pode executar o hook pre-receive. - -{% data reusables.linux.ensure-docker %} - -2. Crie um arquivo de nome `Dockerfile.dev` contendo: - - ``` - FROM gliderlabs/alpine:3.3 - RUN \ - apk add --no-cache git openssh bash && \ - ssh-keygen -A && \ - sed -i "s/#AuthorizedKeysFile/AuthorizedKeysFile/g" /etc/ssh/sshd_config && \ - adduser git -D -G root -h /home/git -s /bin/bash && \ - passwd -d git && \ - su git -c "mkdir /home/git/.ssh && \ - ssh-keygen -t rsa -b 4096 -f /home/git/.ssh/id_rsa -P '' && \ - mv /home/git/.ssh/id_rsa.pub /home/git/.ssh/authorized_keys && \ - mkdir /home/git/test.git && \ - git --bare init /home/git/test.git" - - VOLUME ["/home/git/.ssh", "/home/git/test.git/hooks"] - WORKDIR /home/git - - CMD ["/usr/sbin/sshd", "-D"] - ``` - -3. Crie um script pre-receive de teste chamado `always_reject.sh`. Este exemplo de script rejeitará todos os pushes, o que é importante para bloquear um repositório: - - ``` - #!/usr/bin/env bash - - echo "error: rejeitar todos os pushes" - exit 1 - ``` - -4. Certifique-se de que os scripts `always_reject.sh` têm permissões de execução: - - ```shell - $ chmod +x always_reject.sh - ``` - -5. No diretório contendo `Dockerfile.dev`, crie uma imagem: - - ```shell - $ docker build -f Dockerfile.dev -t pre-receive.dev . - > Sending build context to Docker daemon 3.584 kB - > Step 1 : FROM gliderlabs/alpine:3.3 - > ---> 8944964f99f4 - > Step 2 : RUN apk add --no-cache git openssh bash && ssh-keygen -A && sed -i "s/#AuthorizedKeysFile/AuthorizedKeysFile/g" /etc/ssh/sshd_config && adduser git -D -G root -h /home/git -s /bin/bash && passwd -d git && su git -c "mkdir /home/git/.ssh && ssh-keygen -t rsa -b 4096 -f /home/git/.ssh/id_rsa -P ' && mv /home/git/.ssh/id_rsa.pub /home/git/.ssh/authorized_keys && mkdir /home/git/test.git && git --bare init /home/git/test.git" - > ---> Running in e9d79ab3b92c - > fetch http://alpine.gliderlabs.com/alpine/v3.3/main/x86_64/APKINDEX.tar.gz - > fetch http://alpine.gliderlabs.com/alpine/v3.3/community/x86_64/APKINDEX.tar.gz - ....truncated output.... - > OK: 34 MiB in 26 packages - > ssh-keygen: generating new host keys: RSA DSA ECDSA ED25519 - > Password for git changed by root - > Generating public/private rsa key pair. - > Sua identificação foi salva em /home/git/.ssh/id_rsa. - > Sua chave pública foi salva em /home/git/.ssh/id_rsa.pub. - ....saída truncada.... - > Initialized empty Git repository in /home/git/test.git/ - > Successfully built dd8610c24f82 - ``` - -6. Execute um contêiner de dados que contenha uma chave SSH gerada: - - ```shell - $ docker run --name data pre-receive.dev /bin/true - ``` - -7. Copie o hook pre-receive de teste `always_reject.sh` no contêiner de dados: - - ```shell - $ docker cp always_reject.sh data:/home/git/test.git/hooks/pre-receive - ``` - -8. Execute um contêiner de aplicativo que execute `sshd` e o hook. Anote o ID do contêiner: - - ```shell - $ docker run -d -p 52311:22 --volumes-from data pre-receive.dev - > 7f888bc700b8d23405dbcaf039e6c71d486793cad7d8ae4dd184f4a47000bc58 - ``` - -9. Copie a chave SSH gerada do contêiner de dados para a máquina local: - - ```shell - $ docker cp data:/home/git/.ssh/id_rsa . - ``` - -10. Modifique o remote de um repositório de teste e faça push para o repo `test.git` no contêiner Docker. Este exemplo usa o `git@github.com:octocat/Hello-World.git`, mas você pode usar o repositório de sua preferência. Este exemplo pressupõe que a sua máquina local (127.0.0.1) está vinculando a porta 52311, mas você pode usar outro endereço IP se o docker estiver sendo executado em uma máquina remota. - - ```shell - $ git clone git@github.com:octocat/Hello-World.git - $ cd Hello-World - $ git remote add test git@127.0.0.1:test.git - $ GIT_SSH_COMMAND="ssh -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no -p 52311 -i ../id_rsa" git push -u test master - > Warning: Permanently added '[192.168.99.100]:52311' (ECDSA) to the list of known hosts. - > Contando objetos: 7, concluído. - > Delta compression using up to 4 threads. - > Comprimindo objetos: 100% (3/3), concluído. - > Gravando objetos: 100% (7/7), 700 bytes | 0 bytes/s, concluído. - > Total 7 (delta 0), reused 7 (delta 0) - > remote: error: rejecting all pushes - > To git@192.168.99.100:test.git - > ! [remote rejected] master -> master (pre-receive hook declined) - > error: failed to push some refs to 'git@192.168.99.100:test.git' - ``` - - Observe que o push foi rejeitado após a execução do hook pre-receive e o eco da saída do script. - -### Leia mais - - "[Personalizar o Git - Um exemplo da aplicação da política do Git](https://git-scm.com/book/en/v2/Customizing-Git-An-Example-Git-Enforced-Policy)" no *site do Pro Git* diff --git a/translations/pt-BR/content/admin/developer-workflow/customizing-your-instance-with-integrations.md b/translations/pt-BR/content/admin/developer-workflow/customizing-your-instance-with-integrations.md deleted file mode 100644 index e3d7177f2444..000000000000 --- a/translations/pt-BR/content/admin/developer-workflow/customizing-your-instance-with-integrations.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Personalizar sua instância com integrações -intro: 'Você pode integrar aplicativos de terceiros à {% data variables.product.product_location_enterprise %}.' -mapTopic: true -redirect_from: - - /enterprise/admin/developer-workflow/customizing-your-instance-with-integrations -versions: - enterprise-server: '*' ---- - diff --git a/translations/pt-BR/content/admin/developer-workflow/establishing-pull-request-merge-conditions.md b/translations/pt-BR/content/admin/developer-workflow/establishing-pull-request-merge-conditions.md deleted file mode 100644 index 2745d20a4ab7..000000000000 --- a/translations/pt-BR/content/admin/developer-workflow/establishing-pull-request-merge-conditions.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Estabelecer condições de merge em pull requests -intro: 'É possível exigir que as pull requests passem por uma série de verificações antes do merge. Por exemplo, você pode bloquear pull requests reprovadas nas verificações de status.' -mapTopic: true -redirect_from: - - /enterprise/admin/developer-workflow/establishing-pull-request-merge-conditions -versions: - enterprise-server: '*' ---- - diff --git a/translations/pt-BR/content/admin/developer-workflow/index.md b/translations/pt-BR/content/admin/developer-workflow/index.md deleted file mode 100644 index 59a5d28119ce..000000000000 --- a/translations/pt-BR/content/admin/developer-workflow/index.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: Aplicar políticas e personalizar o fluxo de trabalho do desenvolvedor -redirect_from: - - /enterprise/admin/guides/installation/integrations/ - - /enterprise/admin/categories/integration/ - - /enterprise/admin/developer-workflow -intro: 'Este guia descreve as ferramentas disponíveis no {% data variables.product.prodname_enterprise %} para implementar um fluxo de trabalho de desenvolvedor e impor políticas organizacionais a fim de reduzir riscos e aumentar a qualidade.' -versions: - enterprise-server: '*' ---- - - -### Índice - -{% topic_link_in_list /blocking-force-pushes %} - {% link_in_list /blocking-force-pushes-on-your-appliance %} - {% link_in_list /blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization %} - {% link_in_list /blocking-force-pushes-to-a-repository %} -{% topic_link_in_list /using-webhooks-for-continuous-integration %} - {% link_in_list /continuous-integration-using-jenkins %} - {% link_in_list /troubleshooting-service-hooks %} -{% topic_link_in_list /using-pre-receive-hooks-to-enforce-policy %} - {% link_in_list /about-pre-receive-hooks %} - {% link_in_list /creating-a-pre-receive-hook-environment %} - {% link_in_list /creating-a-pre-receive-hook-script %} - {% link_in_list /managing-pre-receive-hooks-on-the-github-enterprise-server-appliance %} -{% topic_link_in_list /establishing-pull-request-merge-conditions %} - {% link_in_list /about-protected-branches-and-required-status-checks %} - {% link_in_list /configuring-protected-branches-and-required-status-checks %} -{% topic_link_in_list /customizing-your-instance-with-integrations %} - {% link_in_list /managing-projects-using-jira %} diff --git a/translations/pt-BR/content/admin/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance.md b/translations/pt-BR/content/admin/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance.md deleted file mode 100644 index 22deb7e7d777..000000000000 --- a/translations/pt-BR/content/admin/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance.md +++ /dev/null @@ -1,59 +0,0 @@ ---- -title: Gerenciar hooks pre-receive no appliance do GitHub Enterprise Server -intro: 'Configure o uso que as pessoas farão dos hooks pre-receive em seus appliances do {% data variables.product.prodname_ghe_server %}.' -redirect_from: - - /enterprise/admin/guides/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-appliance/ - - /enterprise/admin/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance -versions: - enterprise-server: '*' ---- - -### Criar hooks pre-receive - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.hooks-tab %} -4. Clique em **Add pre-receive hook** (Adicionar hooks pre-receive). ![Adicionar hook pre-receive](/assets/images/enterprise/site-admin-settings/add-pre-receive-hook.png) -5. No campo **Hook name** (Nome do hook), informe o nome do hook que você pretende criar. ![Nomear hook pre-receive](/assets/images/enterprise/site-admin-settings/hook-name.png) -6. No menu suspenso **Environment** (Ambiente), selecione o ambiente em que você pretende executar o hook. ![Ambiente de hook](/assets/images/enterprise/site-admin-settings/environment.png) -7. Em **Script**, no menu suspenso **Select hook repository** (Selecionar repositório de hook), selecione o repositório que contém o script de hook pre-receive. No menu suspenso **Select file** (Selecionar arquivo), selecione o nome do arquivo de scripts do hook pre-receive. ![Script de hook](/assets/images/enterprise/site-admin-settings/hook-script.png) -8. Selecione **Use the exit-status to accept or reject pushes** (Usar status de saída para aceitar ou rejeitar pushes) para aplicar seu script. Ao desmarcar essa opção, você pode testar o script enquanto o valor do status de saída é ignorado. Nesse modo, a saída do script ficará visível para o usuário na linha de comando, mas não na interface da web. ![Usar status de saída](/assets/images/enterprise/site-admin-settings/use-exit-status.png) -9. Selecione **Enable this pre-receive hook on all repositories by default** (Habilitar este hooks pre-receive em todos os repositórios por padrão) se quiser que o hook pre-receive seja executado em todos os repositórios. ![Habilitar hooks em todos os repositório](/assets/images/enterprise/site-admin-settings/enable-hook-all-repos.png) -10. Selecione **Administrators can enable and disable this hook** (Administradores podem habilitar e desabilitar este hook) para permitir que os integrantes da organização com permissões de administrador ou proprietário decidam se querem habilitar ou desabilitar esse hook pre-receive. ![Habilitar ou desabilitar hooks para administradores](/assets/images/enterprise/site-admin-settings/admins-enable-hook.png) - -### Editar hooks pre-receive - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.hooks-tab %} -1. Ao lado do hook pre-receive que deseja editar, clique em {% octicon "pencil" aria-label="The edit icon" %}.![Editar hooks pre-receive](/assets/images/enterprise/site-admin-settings/edit-pre-receive-hook.png) - -### Excluir hooks pre-receive - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.hooks-tab %} -2. Ao lado do hook pre-receive que deseja excluir, clique em {% octicon "x" aria-label="X symbol" %}.![Editar hooks pre-receive](/assets/images/enterprise/site-admin-settings/delete-pre-receive-hook.png) - -### Configurar hooks pre-receive para uma organização - -O administrador da organização só pode configurar permissões de hook para a organização se o administrador do site tiver selecionado a opção **Administrators can enable or disable this hook** (Administradores podem habilitar e desabilitar este hook) ao criar o hook pre-receive. Para configurar hooks pre-receive em um repositório, você deve ser administrador ou proprietário da organização. - -{% data reusables.profile.enterprise_access_profile %} -{% data reusables.profile.access_org %} -{% data reusables.organizations.org_settings %} -4. Na barra lateral esquerda, clique em **Hooks**. ![Barra lateral de hooks](/assets/images/enterprise/orgs-and-teams/hooks-sidebar.png) -5. Ao lado do hook pre-receive que você pretende configurar, clique no menu suspenso **Hook permissions** (Permissões de hook). Selecione se deseja habilitar ou desabilitar o hook pre-receive, ou permitir que ele seja configurado pelos administradores do repositório. ![Permissões de hook](/assets/images/enterprise/orgs-and-teams/hook-permissions.png) - -### Configurar hooks pre-receive para um repositório - -O proprietário do repositório só pode configurar um hook se o administrador do site tiver selecionado a opção **Administrators can enable or disable this hook** (Administradores podem habilitar e desabilitar este hook) ao criar o hook pre-receive. Em uma organização, o proprietário da organização também deve ter selecionado a permissão de hook **Configurable** (Configurável). Para configurar hooks pre-receive em um repositório, você deve ser proprietário do repositório. - -{% data reusables.profile.enterprise_access_profile %} -2. Clique em **Repositories** (Repositórios) e selecione em qual repsitório você deseja configurar hooks pre-receive. ![Repositórios](/assets/images/enterprise/repos/repositories.png) -{% data reusables.repositories.sidebar-settings %} -4. Na barra lateral esquerda, clique em **Hooks & Services** (Hooks e serviços). ![Hooks e serviços](/assets/images/enterprise/repos/hooks-services.png) -5. Ao lado do hook pre-receive que você pretende configurar, clique no menu suspenso **Hook permissions** (Permissões de hook). Defina se você vai habilitar ou desabilitar os hooks pre-receive. ![Permissões de hook repo](/assets/images/enterprise/repos/repo-hook-permissions.png) diff --git a/translations/pt-BR/content/admin/developer-workflow/managing-projects-using-jira.md b/translations/pt-BR/content/admin/developer-workflow/managing-projects-using-jira.md deleted file mode 100644 index 1a967e4fcbd6..000000000000 --- a/translations/pt-BR/content/admin/developer-workflow/managing-projects-using-jira.md +++ /dev/null @@ -1,55 +0,0 @@ ---- -title: Gerenciar projetos usando JIRA -intro: 'Você pode integrar o JIRA ao {% data variables.product.prodname_enterprise %} para gerenciar projetos.' -redirect_from: - - /enterprise/admin/guides/installation/project-management-using-jira/ - - /enterprise/admin/articles/project-management-using-jira/ - - /enterprise/admin/developer-workflow/managing-projects-using-jira -versions: - enterprise-server: '*' ---- - -### Conectar o JIRA a uma organização do {% data variables.product.prodname_enterprise %} - -1. Entre na sua conta do {% data variables.product.prodname_enterprise %} em http[s]://[hostname]/login. -1. No canto superior direito de qualquer página, clique no ícone de configuração da conta (engrenagem). -1. Na barra lateral esquerda, clique no nome da organização. -1. Na barra lateral esquerda, clique em **Applications** (Aplicativos). -1. No canto superior direito da caixa **Organization applications** (Aplicativos da organização), clique em **Register new application** (Registrar novo aplicativo). -1. Defina as configurações do aplicativo: - - No campo **Application name** (Nome do aplicativo), digite "JIRA". - - No campo **Homepage URL** (URL da página inicial), digite a URL completa da sua instância do JIRA. - - No campo **URL de callback de autorização**, digite a URL completa da sua instância do JIRA. -1. Clique em **Register application** (Registrar aplicativo). -1. Na parte superior da página, anote os dados dos campos **Client ID** (ID do cliente) e **Client Secret** (Segredo do cliente). Você precisará dessas informações para configurar sua instância do JIRA. - -### Conectar o JIRA a uma conta pessoal do {% data variables.product.prodname_enterprise %} - -1. Entre na sua conta do {% data variables.product.prodname_enterprise %} em http[s]://[hostname]/login. -1. No canto superior direito de qualquer página, clique no ícone de configuração da conta (engrenagem). -1. Na barra lateral esquerda, clique em **Applications** (Aplicativos). -1. No canto superior direito da caixa **Developer applications** (Aplicativos do desenvolvedor), clique em **Register new application** (Registrar novo aplicativo). -1. Defina as configurações do aplicativo: - - No campo **Application name** (Nome do aplicativo), digite "JIRA". - - No campo **Homepage URL** (URL da página inicial), digite o URL completo da sua instância do JIRA. - - No campo **URL de callback de autorização**, digite o URL completo da sua instância do JIRA. -1. Clique em **Register application** (Registrar aplicativo). -1. Na parte superior da página, anote os dados dos campos **Client ID** (ID do cliente) e **Client Secret** (Segredo do cliente). Você precisará dessas informações para configurar sua instância do JIRA. - -### Configurar a instância do JIRA - -1. Na instância do JIRA, entre em uma conta com acesso administrativo. -1. Na parte superior da página, clique no ícone de configuração (engrenagem). -1. No menu suspenso de configuração, clique em **Add-ons** (Complementos). -1. Na barra lateral esquerda, em **Source control** (Controle de fontes), clique em **DVCS accounts** (Contas DVCS). -1. Clique em **Link Bitbucket or GitHub account** (Vincular conta do Bitbucket ou GitHub). -1. No modal **Add New Account** (Adicionar nova conta), defina as configurações do {% data variables.product.prodname_enterprise %}: - - No menu suspenso **Host**, clique em **GitHub Enterprise**. - - No campo **Team or User Account** (Conta de equipe ou usuário), digite o nome da sua organização ou conta pessoal do {% data variables.product.prodname_enterprise %}. - - No campo **OAuth Key** (Chave OAuth), informe o Client ID (ID do cliente) do seu aplicativo de desenvolvedor do {% data variables.product.prodname_enterprise %}. - - No campo **OAuth Secret** (Segredo OAuth), informe o Client Secret (Segredo do cliente) do seu aplicativo de desenvolvedor do {% data variables.product.prodname_enterprise %}. - - Se você não quiser vincular novos repositórios pertencentes à sua organização ou conta pessoal do {% data variables.product.prodname_enterprise %}, desmarque a opção **Auto Link New Repositories** (Vincular automaticamente novos repositórios). - - Se você não quiser habilitar os commits inteligentes, desmarque a opção **Habilitar commits inteligentes**. - - Clique em **Add** (Adicionar). -1. Revise as permissões que você vai conceder à sua conta do {% data variables.product.prodname_enterprise %} e clique em **Authorize application** (Autorizar aplicativo). -1. Se necessário, digite a senha para continuar. diff --git a/translations/pt-BR/content/admin/developer-workflow/troubleshooting-service-hooks.md b/translations/pt-BR/content/admin/developer-workflow/troubleshooting-service-hooks.md deleted file mode 100644 index 87e974d31351..000000000000 --- a/translations/pt-BR/content/admin/developer-workflow/troubleshooting-service-hooks.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: Solução de problemas com hooks de serviço -intro: 'Se as cargas não estiverem sendo entregues, verifique se há problemas comuns.' -redirect_from: - - /enterprise/admin/articles/troubleshooting-service-hooks/ - - /enterprise/admin/developer-workflow/troubleshooting-service-hooks -versions: - enterprise-server: '*' ---- - -### Obter informações nas entregas - -Você pode encontrar informações sobre a resposta mais recente de todas as entregas de hooks de serviço em qualquer repositório. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -2. Navegue até o repositório que você está investigando. -3. Clique no link **Hooks** na barra de navegação lateral. ![Barra lateral de hooks](/assets/images/enterprise/settings/Enterprise-Hooks-Sidebar.png) -4. Clique no link **Latest Delivery** (Entrega mais recente) no hook de serviço que apresentou problemas. ![Detalhes de hooks](/assets/images/enterprise/settings/Enterprise-Hooks-Details.png) -5. Em **Remote Calls** (Chamadas remotas), você verá os cabeçalhos usados durante o POST para o servidor remoto e a resposta que o servidor remoto enviou de volta à instalação. - -### Exibir a carga - -{% data reusables.enterprise_site_admin_settings.access-settings %} -2. Navegue até o repositório que você está investigando. -3. Clique no link **Hooks** na barra de navegação lateral. ![Barra lateral de hooks](/assets/images/enterprise/settings/Enterprise-Hooks-Sidebar.png) -4. Clique no link **Latest Delivery** (Entrega mais recente) no hook de serviço que apresentou problemas. -5. Clique em **Delivery** (Entrega). ![Exibir a carga](/assets/images/enterprise/settings/Enterprise-Hooks-Payload.png) - -### Exibir entregas anteriores - -As entregas ficam armazenadas por 15 dias. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -2. Navegue até o repositório que você está investigando. -3. Clique no link **Hooks** na barra de navegação lateral. ![Barra lateral de hooks](/assets/images/enterprise/settings/Enterprise-Hooks-Sidebar.png) -4. Clique no link **Latest Delivery** (Entrega mais recente) no hook de serviço que apresentou problemas. -5. Para exibir outras entregas de um hook específico, clique em **More for this Hook ID** (Mais informações sobre este ID de hook): ![Exibir mais entregas](/assets/images/enterprise/settings/Enterprise-Hooks-More-Deliveries.png) diff --git a/translations/pt-BR/content/admin/developer-workflow/using-pre-receive-hooks-to-enforce-policy.md b/translations/pt-BR/content/admin/developer-workflow/using-pre-receive-hooks-to-enforce-policy.md deleted file mode 100644 index 4a50ee88d2d2..000000000000 --- a/translations/pt-BR/content/admin/developer-workflow/using-pre-receive-hooks-to-enforce-policy.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Usar hooks pre-receive para aplicar a política -intro: Use hooks pre-receive para impor os padrões de fluxo de trabalho na organização. Os hooks pre-receive precisam de um código para fazer uma série predefinida de verificações de qualidade antes que o push seja aceito no repositório. -mapTopic: true -redirect_from: - - /enterprise/admin/developer-workflow/using-pre-receive-hooks-to-enforce-policy -versions: - enterprise-server: '*' ---- - diff --git a/translations/pt-BR/content/admin/developer-workflow/using-webhooks-for-continuous-integration.md b/translations/pt-BR/content/admin/developer-workflow/using-webhooks-for-continuous-integration.md deleted file mode 100644 index 07fcb7733f45..000000000000 --- a/translations/pt-BR/content/admin/developer-workflow/using-webhooks-for-continuous-integration.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Usar webhooks para integração contínua -intro: 'Se já tiver um ecossistema de desenvolvimento e implantação, você poderá integrá-lo ao {% data variables.product.prodname_ghe_server %} usando webhooks.' -mapTopic: true -redirect_from: - - /enterprise/admin/developer-workflow/continuous-integration-using-travis-ci - - /enterprise/admin/developer-workflow/using-webhooks-for-continuous-integration -versions: - enterprise-server: '*' ---- - diff --git a/translations/pt-BR/content/admin/enterprise-management/monitoring-using-analytics.md b/translations/pt-BR/content/admin/enterprise-management/monitoring-using-analytics.md deleted file mode 100644 index f9a84d2907a1..000000000000 --- a/translations/pt-BR/content/admin/enterprise-management/monitoring-using-analytics.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: Monitoramento com análise -intro: 'Você pode habilitar ferramentas de análise da web para acompanhar e analisar o tráfego para sua instância de {% data variables.product.prodname_ghe_server %}.' -redirect_from: - - /enterprise/admin/enterprise-management/monitoring-using-analytics -versions: - enterprise-server: '>2.21' ---- - -### Configurar o Google Analytics - -Para configurar o Google Analytics, você deve ter um [ID do Google Analytics](https://analytics.google.com/) e efetuar a autenticação na sua instância do {% data variables.product.prodname_ghe_server %} com SSH. Para obter mais informações, consulte "[Acessar o shell administrativo (SSH)](/enterprise/admin/configuration/accessing-the-administrative-shell-ssh)". - -```shell -$ ghe-config website-analytics.enabled true -$ ghe-config website-analytics.google-analytics-id GOOGLE-ANALYTICS-ID -$ ghe-config-apply -``` diff --git a/translations/pt-BR/content/admin/installation/about-enterprise-accounts.md b/translations/pt-BR/content/admin/installation/about-enterprise-accounts.md deleted file mode 100644 index 271dc64c7388..000000000000 --- a/translations/pt-BR/content/admin/installation/about-enterprise-accounts.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: Sobre contas corporativas -intro: 'Com {% data variables.product.prodname_ghe_server %}, você pode criar uma conta corporativa para dar aos administradores um único ponto de visibilidade e gestão para seu faturamento e uso da licença.' -redirect_from: - - /enterprise/admin/installation/about-enterprise-accounts -versions: - enterprise-server: '*' ---- - -### Sobre as contas corporativas do {% data variables.product.prodname_ghe_server %} - -Uma conta corporativa permite que você gerencie múltiplas organizações {% data variables.product.prodname_dotcom %} e instâncias {% data variables.product.prodname_ghe_server %}. Sua conta corporativa deve ter um manipulador, como uma conta pessoal ou organizacional no {% data variables.product.prodname_dotcom %}. Os administradores corporativos podem gerenciar configurações e preferências, como: - -- Acesso e gerenciamento de integrantes (integrantes da organização, colaboradores externos) -- Faturamento e uso de instâncias ({% data variables.product.prodname_ghe_server %}, licenças de usuário, pacotes {% data variables.large_files.product_name_short %}) -- Segurança (logon único, autenticação de dois fatores) -- Solicitações e compartilhamento de pacote de suporte com {% data variables.contact.enterprise_support %} - -{% data reusables.enterprise-accounts.enterprise-accounts-billing %} - -Para obter mais informações sobre o {% data variables.product.prodname_ghe_cloud %} e {% data variables.product.prodname_ghe_server %}, consulte "[Produtos do {% data variables.product.prodname_dotcom %}](/articles/github-s-products)". Para atualizar para {% data variables.product.prodname_enterprise %} ou para começar com uma conta corporativa, entre em contato com {% data variables.contact.contact_enterprise_sales %}. - -### Gerenciando as licenças {% data variables.product.prodname_ghe_server %} vinculadas à sua conta corporativa - -{% data reusables.enterprise-accounts.admin-managing-licenses %} diff --git a/translations/pt-BR/content/admin/installation/about-geo-replication.md b/translations/pt-BR/content/admin/installation/about-geo-replication.md deleted file mode 100644 index cdc38ceb896a..000000000000 --- a/translations/pt-BR/content/admin/installation/about-geo-replication.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Sobre a replicação geográfica -intro: 'A replicação geográfica no {% data variables.product.prodname_ghe_server %} usa várias réplicas ativas para atender às solicitações de datacenters distribuídos geograficamente.' -redirect_from: - - /enterprise/admin/installation/about-geo-replication -versions: - enterprise-server: '*' ---- - -Usar várias réplicas ativas diminui a distância até a réplica mais próxima. Por exemplo, uma organização com escritórios em San Francisco, Nova York e Londres pode executar o appliance primário em um datacenter próximo a Nova York e duas réplicas em datacenters próximos a San Francisco e Londres. Ao usar um DNS compatível com localização geográfica, os usuários podem ser direcionados para o servidor mais próximo disponível e acessar os dados do repositório em menos tempo. Definir o appliance próximo a Nova York como o primário ajuda a reduzir a latência entre os hosts, em comparação a definir o appliance próximo a San Francisco como o principal, que tem maior latência para Londres. - -Os proxies de réplica ativos informam que não podem processar a si mesmos para a instância principal. As réplicas funcionam como ponto de presença, encerrando todas as conexões SSL. O tráfego entre hosts é enviado por meio de uma conexão VPN criptografada, semelhante a uma configuração de alta disponibilidade de dois nós sem replicação geográfica. - -As solicitações do Git e as solicitações específicas do servidor de arquivos, como LFS e uploads de arquivos, podem ser atendidas diretamente na réplica, sem carregar dados do servidor principal. As solicitações da web são sempre roteadas para o servidor principal. No entanto, se a réplica estiver mais próxima do usuário, as solicitações serão mais rápidas devido ao SSL mais próximo. - -É necessário ter um DNS de localização geográfica, como o [Amazon Route 53](http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-geo), para garantir o bom funcionamento da replicação geográfica. O nome de host da instância deve ser resolvido na réplica mais próxima do local do usuário. - -### Limitações - -As solicitações de gravação para a réplica exigem o envio dos dados para o servidor principal e todas as réplicas. Ou seja, o desempenho de todas as gravações fica limitado pela réplica mais lenta {% if currentVersion ver_gt "enterprise-server@2.17" %}, embora as novas réplicas geográficas possam propagar a maioria de seus dados das réplicas geográficas localizadas existentes, em vez de propagar a partir do principal {% endif %}. A replicação geográfica não aumentará a capacidade de uma instância do {% data variables.product.prodname_ghe_server %} nem resolverá problemas de desempenho relacionados a CPU ou recursos de memória insuficientes. Se o appliance primário estiver offline, as réplicas ativas não poderão atender a solicitações de leitura ou gravação. - -### Monitorar a configuração da replicação geográfica - -{% data reusables.enterprise_installation.monitoring-replicas %} - -### Leia mais -- [Criar réplicas de replicação geográfica](/enterprise/{{ currentVersion }}/admin/guides/installation/creating-a-high-availability-replica/#creating-geo-replication-replicas) diff --git a/translations/pt-BR/content/admin/installation/about-high-availability-configuration.md b/translations/pt-BR/content/admin/installation/about-high-availability-configuration.md deleted file mode 100644 index b28482922b27..000000000000 --- a/translations/pt-BR/content/admin/installation/about-high-availability-configuration.md +++ /dev/null @@ -1,181 +0,0 @@ ---- -title: Sobre a configuração de alta disponibilidade -intro: 'Na configuração de alta disponibilidade, um appliance do {% data variables.product.prodname_ghe_server %} secundário totalmente redundante é mantido em sincronização com o appliance primário pela replicação de todos os principais armazenamentos de dados.' -redirect_from: - - /enterprise/admin/installation/about-high-availability-configuration -versions: - enterprise-server: '*' ---- - -Quando você configura alta disponibilidade, há uma configuração automatizada de replicação assíncrona e unidirecional de todos os armazenamentos de dados (repositórios do Git, MySQL, Redis e Elasticsearch) do appliance primário para o appliance réplica. - -O {% data variables.product.prodname_ghe_server %} dá suporte a uma configuração ativa/passiva, em que o appliance réplica é executado em espera com os serviços de banco de dados em execução no modo de replicação, mas os serviços de aplicativos são interrompidos. - -### Cenários de falha - -Use a configuração de alta disponibilidade para proteção contra: - -{% data reusables.enterprise_installation.ha-and-clustering-failure-scenarios %} - -A configuração de alta disponibilidade não é uma boa solução para: - - - **Dimensionamento**. Mesmo que você possa distribuir o tráfego geograficamente usando a replicação geográfica, o desempenho das gravações fica limitado à velocidade e à disponibilidade do appliance primário. Para obter mais informações, consulte "[Sobre a replicação geográfica](/enterprise/{{ currentVersion }}/admin/guides/installation/about-geo-replication/)". - - **Backup do appliance primário**. Uma réplica de alta disponibilidade não substitui os backups externos do seu plano de recuperação de desastres. Algumas formas de violação ou perda de dados podem ser replicadas de imediato do appliance primário para o de réplica. Para garantir a reversão segura a um estado anterior estável, você deve fazer backups regulares com instantâneos de histórico. - - **Atualizações sem tempo de inatividade**. Para evitar a perda de dados e situações de split-brain em cenários de promoção controlados, deixe o appliance primário em modo de manutenção e aguarde a conclusão de todas as gravações antes de promover o de réplica. - -### Estratégias de failover no tráfego de rede - -Durante o failover, você deve configurar e gerenciar separadamente o redirecionamento do tráfego de rede do appliance primário para o de réplica. - -#### Failover DNS - -Com o failover DNS, use valores curtos de TTL nos registros DNS que apontam para o appliance primário {% data variables.product.prodname_ghe_server %}. Recomenda-se um TTL entre 60 segundos e cinco minutos. - -Durante o failover, você deve deixar o appliance primário no modo de manutenção e redirecionar seus registros DNS para o endereço IP do appliance réplica. O tempo para redirecionar o tráfego do appliance primário para o de réplica dependerá da configuração do TTL e do tempo necessário para atualizar os registros DNS. - -Se estiver usando replicação geográfica, você deverá configurar o DNS de localização geográfica para direcionar o tráfego à réplica mais próxima. Para obter mais informações, consulte "[Sobre a replicação geográfica](/enterprise/{{ currentVersion }}/admin/guides/installation/about-geo-replication/)". - -#### Balanceador de carga - -{% data reusables.enterprise_clustering.load_balancer_intro %} {% data reusables.enterprise_clustering.load_balancer_dns %} - -Durante o failover, você deve deixar o appliance principal em modo de manutenção. É possível configurar o balanceador de carga para detectar automaticamente quando o de réplica for promovido a primário, ou ele pode exigir uma alteração manual na configuração. Antes que o de réplica responda ao tráfego do usuário, você deve promovê-lo manualmente a primário. Para obter mais informações, consulte "[Usar o {% data variables.product.prodname_ghe_server %} com balanceador de carga](/enterprise/{{ currentVersion }}/admin/guides/installation/using-github-enterprise-server-with-a-load-balancer/)". - -{% data reusables.enterprise_installation.monitoring-replicas %} - -### Utilitários para o gerenciamento de replicações - -Para gerenciar a replicação no {% data variables.product.prodname_ghe_server %}, use estes utilitários de linha de comando ao se conectar ao appliance réplica usando SSH. - -#### ghe-repl-setup - -O comando `ghe-repl-setup` deixa o appliance do {% data variables.product.prodname_ghe_server %} em modo de espera de réplica. - - - Um túnel criptografado {% if currentVersion ver_gt "enterprise-server@2.17" %}WireGuard VPN{% else %}OpenVPN{% endif %} é configurado para a comunicação entre os dois appliances. - - Os serviços de banco de dados são configurados para replicação e iniciados. - - Os serviços de aplicativos ficam desabilitados. As tentativas de acessar o appliance réplica por HTTP, Git ou outros protocolos com suporte levarão a uma página de manutenção "appliance em modo de réplica" ou a uma mensagem de erro. - -```shell -admin@169-254-1-2:~$ ghe-repl-setup 169.254.1.1 -Verificando conectividade ssh com 169.254.1.1 ... -Verificação de conexão com êxito. -Configurando replicação de banco de em relação ao primário... -Êxito: o modo de réplica está configurado em 169.254.1.1. -Para desabilitar o modo de réplica e desfazer essas alterações, execute 'ghe-repl-teardown'. -Execute `ghe-repl-start' para começar a replicar em relação ao primário recém-configurado. -``` - -#### ghe-repl-start - -O comando `ghe-repl-start` habilita a replicação ativa de todos os armazenamentos de dados. - -```shell -admin@169-254-1-2:~$ ghe-repl-start{% if currentVersion ver_lt "enterprise-server@2.18" %} -Iniciando túnel OpenVPN... {% endif %} -Iniciando replicação MySQL... -Iniciando replicação Redis... -Iniciando replicação Elasticsearch... -Iniciando replicação Pages... -Iniciando replicação Git... -Sucesso: replicação em execução em todos os serviços. -Use 'ghe-repl-status' para monitorar a integridade e o andamento da replicação. -``` - -#### ghe-repl-status - -O comando `ghe-repl-status` retorna um status `OK`, `WARNING` ou `CRITICAL` para cada fluxo de replicação de armazenamento de dados. Quando qualquer um dos canais de replicação estiver em estado `WARNING`, o comando sairá com código `1`. Quando qualquer um dos canais de replicação estiver em estado `CRITICAL`, o comando sairá com código `2`. - -```shell -admin@169-254-1-2:~$ ghe-repl-status -OK: replicação mysql em sincronização -OK: replicação redis em sincronização -OK: replicação cluster elasticsearch em sincronização -OK: dados do git em sincronização (10 repos, 2 wikis, 5 gists) -OK: dados do pages em sincronização -``` - -As opções `-v` e `-vv` mostram detalhes sobre o estado da replicação de cada armazenamento de dados: - -```shell -$ ghe-repl-status -v -OK: replicação mysql em sincronização - | IO em execução: Sim, SQL em execução: Sim, atraso: 0 - -OK: replicação redis em sincronização - | master_host:169.254.1.1 - | master_port:6379 - | master_link_status:up - | master_last_io_seconds_ago:3 - | master_sync_in_progress:0 - -OK: cluster elasticsearch em sincronização - | { - | "cluster_name" : "github-enterprise", - | "status" : "green", - | "timed_out" : false, - | "number_of_nodes" : 2, - | "number_of_data_nodes" : 2, - | "active_primary_shards" : 12, - | "active_shards" : 24, - | "relocating_shards" : 0, - | "initializing_shards" : 0, - | "unassigned_shards" : 0 - | } - -OK: dados do git em sincronização (366 repos, 31 wikis, 851 gists) - | TOTAL OK AUSENTE PENDENTE ATRASO - | repositórios 366 366 0 0 0.0 - | wikis 31 31 0 0 0.0 - | gists 851 851 0 0 0.0 - | total 1248 1248 0 0 0.0 - -OK: dados do pages em sincronização - | Pages em sincronização -``` - -#### ghe-repl-stop - -O comando `ghe-repl-stop` desativa temporariamente a replicação para todos os armazenamentos de dados e interrompe os serviços de replicação. Para retomar a replicação, use o comando [ghe-repl-start](#ghe-repl-start). - -```shell -admin@168-254-1-2:~$ ghe-repl-stop -Parando replicação Pages... -Parando replicação Git... -Parando replicação MySQL... -Parando replicação Redis... -Parando replicação Elasticsearch...{% if currentVersion ver_lt "enterprise-server@2.18" %} -Parando túnel OpenVPN...{% endif %} -Sucesso: replicação parada em todos os serviços. -``` - -#### ghe-repl-promote - -O comando `ghe-repl-promote` desativa a replicação e converte o appliance réplica em appliance primário. O appliance é configurado com as mesmas configurações do primário original, e todos os serviços ficam ativados. - -{% data reusables.enterprise_installation.promoting-a-replica %} - -```shell -admin@168-254-1-2:~$ ghe-repl-promote -Habilitando modo de manutenção em primário para evitar gravações... -Parando replicação... - Parando replicação Pages... - | Parando replicação Git... - | Parando replicação MySQL... - | Parando replicação Redis... - | Parando replicação Elasticsearch...{% if currentVersion ver_lt "enterprise-server@2.18" %} - | Parando túnel OpenVPN...{% endif %} - | Sucesso: replicação parada em todos os serviços. -Alternando modo réplica... - | Sucesso: configuração de replicação removida. - | Execute `ghe-repl-setup' para habilitar novamente o modo réplica. -Aplicando configuração e iniciando serviços... -Sucesso: a réplica foi promovida para primária e agora aceita solicitações. -``` - -#### ghe-repl-teardown - -O comando `ghe-repl-teardown` desativa por completo o modo de replicação, removendo a configuração da réplica. - -### Leia mais - -- [Criar réplica de alta disponibilidade](/enterprise/{{ currentVersion }}/admin/guides/installation/creating-a-high-availability-replica) diff --git a/translations/pt-BR/content/admin/installation/about-the-github-enterprise-server-api.md b/translations/pt-BR/content/admin/installation/about-the-github-enterprise-server-api.md deleted file mode 100644 index 44d042fb4ef4..000000000000 --- a/translations/pt-BR/content/admin/installation/about-the-github-enterprise-server-api.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: Sobre a API do GitHub Enterprise Server -intro: 'O {% data variables.product.prodname_ghe_server %} dá suporte à mesma API avançada disponível no {% data variables.product.prodname_dotcom_the_website %} e tem seu próprio conjunto de pontos de extremidade de API.' -redirect_from: - - /enterprise/admin/articles/about-the-enterprise-api/ - - /enterprise/admin/articles/using-the-api/ - - /enterprise/admin/categories/api/ - - /enterprise/admin/installation/about-the-github-enterprise-server-api -versions: - enterprise-server: '*' ---- - -A documentação completa do {% data variables.product.prodname_enterprise_api %} está disponível em . A API permite automatizar várias tarefas administrativas. Veja alguns exemplos: - -- Fazer alterações no {% data variables.enterprise.management_console %}. Para obter mais informações, consulte "[{% data variables.enterprise.management_console %}](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#management-console)." -- Coletar dados estatísticos sobre a sua instância. Para obter mais informações, consulte "[Estatísticas do administrador](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#admin-stats)". -- Configurar a sincronização LDAP. Para obter mais informações, consulte "[LDAP](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#admin-stats)".{% if currentVersion ver_gt "enterprise-server@2.18" %} -- Gerenciar sua conta corporativa. Para obter mais informações, consulte "[Contas corporativas](/v4/guides/managing-enterprise-accounts)".{% endif %} diff --git a/translations/pt-BR/content/admin/installation/accessing-the-administrative-shell-ssh.md b/translations/pt-BR/content/admin/installation/accessing-the-administrative-shell-ssh.md deleted file mode 100644 index 76f328dd3c0a..000000000000 --- a/translations/pt-BR/content/admin/installation/accessing-the-administrative-shell-ssh.md +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: Acesar o shell administrativo (SSH) -redirect_from: - - /enterprise/admin/articles/ssh-access/ - - /enterprise/admin/articles/adding-an-ssh-key-for-shell-access/ - - /enterprise/admin/guides/installation/administrative-shell-ssh-access/ - - /enterprise/admin/articles/troubleshooting-ssh-permission-denied-publickey/ - - /enterprise/admin/2.13/articles/troubleshooting-ssh-permission-denied-publickey/ - - /enterprise/admin/2.14/articles/troubleshooting-ssh-permission-denied-publickey/ - - /enterprise/admin/2.15/articles/troubleshooting-ssh-permission-denied-publickey/ - - /enterprise/admin/installation/accessing-the-administrative-shell-ssh -intro: 'O acesso por SSH permite executar os utilitários de linha de comando {% data variables.product.prodname_ghe_server %} e é útil para solucionar problemas, fazer backups e configurar a replicação.' -versions: - enterprise-server: '*' ---- - -### Sobre o acesso ao shell administrativo - -Se tiver acesso por SSH ao shell administrativo, você poderá executar os utilitários de linha de comando do {% data variables.product.prodname_ghe_server %}. O acesso SSH também é útil para solucionar problemas, fazer backups e configurar a replicação. O acesso a SSH administrativa é gerenciado separadamente do acesso SSH do Git e fica acessível apenas pela porta 122. - -### Habilitar o acesso ao shell administrativo por SSH - -Para habilitar o acesso a SSH administrativa, você deve adicionar sua chave pública SSH à lista de chaves autorizadas da instância. - -{% tip %} - -**Dica:** as alterações nas chaves SSH autorizadas entram em vigor de imediato. - -{% endtip %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -3. Em "SSH access" (Acesso SSH), cole a chave no campo de texto e clique em **Add key** (Adicionar chave). ![Caixa de texto e botão para adicionar uma chave SSH](/assets/images/enterprise/settings/add-authorized-ssh-key-admin-shell.png) -{% data reusables.enterprise_management_console.save-settings %} - -### Conectar-se ao shell administrativo por SSH - -Depois de adicionar sua chave SSH à lista, conecte-se à instância por SSH como usuário `admin` na porta 122. - -```shell -$ ssh -p 122 admin@github.example.com -Last login: Sun Nov 9 07:53:29 2014 from 169.254.1.1 -admin@github-example-com:~$ █ -``` - -#### Solucionar problemas de conectividade com SSH - -Se o erro `Permission denied (publickey)` (Permissão negada [chave pública]) ocorrer quando você tentar se conectar à {% data variables.product.product_location_enterprise %} via SSH, confirme se a conexão está sendo feita pela porta 122. Talvez seja necessário especificar explicitamente a chave SSH privada em uso. - -Para especificar uma chave SSH privada usando a linha de comando, execute `ssh` com o argumento `-i`. - -```shell -ssh -i /path/to/ghe_private_key -p 122 admin@hostname -``` - -Você também pode especificar uma chave SSH privada usando o arquivo de configuração SSH (`~/.ssh/config`). - -```shell -Host hostname - IdentityFile /path/to/ghe_private_key - User admin - Port 122 -``` - -### Acesar o shell administrativo usando o console local - -Em uma situação de emergência, se o acesso por SSH estiver indisponível, você poderá acessar o shell administrativo localmente. Entre como usuário `admin` usando a senha definida na configuração inicial do {% data variables.product.prodname_ghe_server %}. - -### Limitações de acesso ao shell administrativo - -O acesso ao shell administrativo é permitido apenas para solucionar problemas e executar procedimentos de operações documentadas. Modificar arquivos de aplicativos e sistemas, executar programas ou instalar pacotes de software não compatíveis pode anular seu contrato de suporte. Entre em contato com o {% data variables.contact.contact_ent_support %} em caso de perguntas sobre as atividades permitidas pelo contrato. diff --git a/translations/pt-BR/content/admin/installation/accessing-the-management-console.md b/translations/pt-BR/content/admin/installation/accessing-the-management-console.md deleted file mode 100644 index e43cd24396c7..000000000000 --- a/translations/pt-BR/content/admin/installation/accessing-the-management-console.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: Acessar o console de gerenciamento -intro: 'Use o {% data variables.enterprise.management_console %} para definir e configurar a {% data variables.product.product_location %}, agendar períodos de manutenção, solucionar problemas e gerenciar a licença.' -redirect_from: - - /enterprise/admin/articles/about-the-management-console/ - - /enterprise/admin/articles/management-console-for-emergency-recovery/ - - /enterprise/admin/articles/web-based-management-console/ - - /enterprise/admin/categories/management-console/ - - /enterprise/admin/articles/accessing-the-management-console/ - - /enterprise/admin/guides/installation/web-based-management-console/ - - /enterprise/admin/installation/accessing-the-management-console -versions: - enterprise-server: '*' ---- - -### Sobre o {% data variables.enterprise.management_console %} - -Use o {% data variables.enterprise.management_console %} para atividades administrativas básicas: -- **Configuração inicial**: conheça o processo de configuração inicial ao entrar pela primeira vez na {% data variables.product.product_location_enterprise %} acessando o endereço IP da {% data variables.product.product_location_enterprise %} no navegador. -- **Configurações básicas da instância**: configure DNS, nome do host, SSL, autenticação do usuário, e-mail, serviços de monitoramento e encaminhamento de logs na página Settings (Configurações). -- **Agendamento de períodos de manutenção**: deixe a {% data variables.product.product_location_enterprise %} offline durante a manutenção usando o {% data variables.enterprise.management_console %} ou o shell administrativo. -- **Solução de problemas**: gere um pacote de suporte ou exiba informações de diagnóstico de alto nível. -- **Gerenciamento de licenças**: exiba ou atualize a licença do {% data variables.product.prodname_enterprise %}. - -É possível chegar ao {% data variables.enterprise.management_console %} usando o endereço IP da {% data variables.product.product_location_enterprise %}, mesmo quando a instância estiver em modo de manutenção, ou quando houver uma falha grave de aplicativo ou problema de configuração de SSL. - -Para acessar o {% data variables.enterprise.management_console %}, você deve usar a senha de administrador definida na configuração inicial da {% data variables.product.product_location_enterprise %}. Você também deve poder se conectar ao host da máquina virtual na porta 8443. Se tiver problemas para chegar ao {% data variables.enterprise.management_console %}, verifique as configurações intermediárias de firewall e grupo de segurança. - -### Acessar o {% data variables.enterprise.management_console %} como administrador do site - -Na primeira vez que acessar o {% data variables.enterprise.management_console %} como administrador do site, você deve fazer upload do seu arquivo de licença do {% data variables.product.prodname_enterprise %} para fazer a autenticação no aplicativo. Para obter mais informações, consulte "[Gerenciar sua licença {% data variables.product.prodname_enterprise %}](/enterprise/{{ currentVersion }}/admin/guides/installation/managing-your-github-enterprise-license)". - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.type-management-console-password %} - -### Acessar o {% data variables.enterprise.management_console %} como usuário não autenticado - -1. Acesse esta URL no navegador substituindo `hostname` pelo nome de host ou endereço IP do {% data variables.product.prodname_ghe_server %}: - ```shell - http(s)://HOSTNAME/setup - ``` -{% data reusables.enterprise_management_console.type-management-console-password %} - -### Desbloquear o {% data variables.enterprise.management_console %} após tentativas de login com falha - -O {% data variables.enterprise.management_console %} trava após dez tentativas de login com falha em um período de dez minutos. Antes de tentar novamente, aguarde o desbloqueio automático da tela de login, que ocorrerá após um período de dez minutos. A contagem é redefinida depois do login bem-sucedido. - -Para bloquear o {% data variables.enterprise.management_console %} imediatamente, use o comando `ghe-reactivate-admin-login` pelo shell administrativo. Para obter mais informações, consulte "[Utilitários da linha de comando](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities#ghe-reactivate-admin-login)" e "[Acessar o shell administrativo (SSH)](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-administrative-shell-ssh/)". diff --git a/translations/pt-BR/content/admin/installation/accessing-the-monitor-dashboard.md b/translations/pt-BR/content/admin/installation/accessing-the-monitor-dashboard.md deleted file mode 100644 index b76ac524c6d2..000000000000 --- a/translations/pt-BR/content/admin/installation/accessing-the-monitor-dashboard.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: Acessar o painel de monitoramento -intro: 'O {% data variables.product.prodname_ghe_server %} inclui um painel de monitoramento baseado na web que exibe os dados de histórico do seu appliance do {% data variables.product.prodname_ghe_server %}, como uso de CPU e armazenamento, tempos de resposta de aplicativos e autenticação, e informações gerais sobre a integridade do sistema.' -redirect_from: - - /enterprise/admin/installation/accessing-the-monitor-dashboard -versions: - enterprise-server: '*' ---- - -### Acessar o painel de monitoramento - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -2. Na parte superior da página, clique em **Monitor** (Monitorar). ![Link para o Painel de monitoramento ](/assets/images/enterprise/management-console/monitor-dash-link.png) - -### Resolver problemas comuns de alocação de recursos no appliance - -{% note %} - -**Observação**: fazer sondagens regularmente na {% data variables.product.product_location_enterprise %} com integração contínua (CI, Continuous Integration) ou criar servidores pode causar um ataque de negação de serviço e gerar problemas. Portanto, recomendamos o uso de webhooks para fazer push das atualizações. Para obter mais informações, consulte "[Sobre webhooks](/enterprise/{{ currentVersion }}/user/articles/about-webhooks/)". - -{% endnote %} - -Use o painel de monitoramento para se manter a par da integridade dos recursos do seu appliance e decidir como corrigir os problemas de uso excessivo. - -| Problema | Possíveis causas | Recomendações | -| ----------------------------------------- | ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Uso excessivo de CPU | Contenção da VM por outros serviços ou programas executados no mesmo host | Se possível, reconfigure outros serviços ou programas para usar menos recursos de CPU. Para otimizar todos os recursos de CPU na VM, consulte "[Otimizar os recursos de CPU ou memória](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)". | -| Uso excessivo de memória | Contenção da VM por outros serviços ou programas executados no mesmo host | Se possível, reconfigure outros serviços ou programas para usar menos memória. Para otimizar o uso da memória disponível na VM, consulte "[Otimizar os recursos de CPU ou memória](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)". | -| Pouco espaço em disco | Consumo do espaço em disco por arquivos grandes binários ou de log | Se possível, hospede os arquivos binários grandes em outro servidor e compacte ou arquive os arquivos de log. Se necessário, aumente o espaço em disco na VM seguindo as etapas da sua plataforma em "[Aumentar a capacidade de armazenamento](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-storage-capacity/)". | -| Tempos de resposta maiores do que o comum | Costuma ser causado por um dos problemas acima | Identifique e corrija os problema subjacentes. Se os tempos de resposta continuarem altos, entre em contato com o {% data variables.contact.contact_ent_support %}. | -| Altos índices de erro | Problemas de software | Entre em contato com o {% data variables.contact.contact_ent_support %} e inclua seu pacote de suporte. Para obter mais informações, consulte "[Enviar dados ao suporte do {% data variables.product.prodname_enterprise %}](/enterprise/{{ currentVersion}}/admin/guides/enterprise-support/providing-data-to-github-support#creating-and-sharing-support-bundles)". | diff --git a/translations/pt-BR/content/admin/installation/activity-dashboard.md b/translations/pt-BR/content/admin/installation/activity-dashboard.md deleted file mode 100644 index 3b16431cf8a7..000000000000 --- a/translations/pt-BR/content/admin/installation/activity-dashboard.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: Painel Atividade -intro: 'O painel Atividade mostra um panorama de todas as atividades na {% data variables.product.product_location_enterprise %}.' -redirect_from: - - /enterprise/admin/articles/activity-dashboard/ - - /enterprise/admin/installation/activity-dashboard -versions: - enterprise-server: '*' ---- - -O painel Atividade gera gráficos semanais, mensais e anuais informando o número de: -- Novas pull requests; -- Pull requests com merge; -- Novos problemas; -- Problemas encerrados; -- Comentários de novos problemas; -- Novos repositórios; -- Novas contas de usuário; -- Novas organizações; -- Novas equipes. - -![Painel Atividade](/assets/images/enterprise/activity/activity-dashboard-yearly.png) - -Para mais análises baseadas em dados de {% data variables.product.prodname_enterprise %}, você pode comprar o {% data variables.product.prodname_insights %}. Para obter mais informações, consulte "[Sobre {% data variables.product.prodname_insights %}](/insights/installing-and-configuring-github-insights/about-github-insights)." - -### Acessar o painel Atividade - -1. Na parte superior da página, clique em **Explore** (Explorar). ![Guia Explore (Explorar)](/assets/images/enterprise/settings/ent-new-explore.png) -2. No canto superior direito da página, clique em **Activity** (Atividade). ![Botão Activity (Atividade)](/assets/images/enterprise/activity/activity-button.png) diff --git a/translations/pt-BR/content/admin/installation/audit-logging.md b/translations/pt-BR/content/admin/installation/audit-logging.md deleted file mode 100644 index ce1ae765b240..000000000000 --- a/translations/pt-BR/content/admin/installation/audit-logging.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: Gerar logs de auditoria -intro: 'O {% data variables.product.prodname_enterprise %} registra logs de usuários, organizações, repositórios e eventos de sistema que passaram por auditoria. Os logs são úteis para fins de depuração e conformidade interna e externa.' -redirect_from: - - /enterprise/admin/articles/audit-logging/ - - /enterprise/admin/installation/audit-logging -versions: - enterprise-server: '*' ---- - -Para ver uma lista completa, consulte "[Ações auditadas](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions)". Para obter mais informações sobre como encontrar uma ação específica, consulte "[Pesquisar no log de auditoria](/enterprise/{{ currentVersion }}/admin/guides/installation/searching-the-audit-log)". - -### Logs de push - -Todas as operações de push no Git têm um log. Para obter mais informações, consulte "[Exibir logs de push](/enterprise/{{ currentVersion }}/admin/guides/installation/viewing-push-logs)". - -### Eventos do sistema - -Todos os eventos auditados do sistema, inclusive pushes e pulls, são registrados em logs no caminho `/var/log/github/audit.log`. Os logs passam por rotação a cada 24 horas e ficam guardados por sete dias. - -O pacote de suporte inclui logs de sistema. Para obter mais informações, consulte "[Enviar dados ao suporte do {% data variables.product.prodname_dotcom %}](/enterprise/{{ currentVersion }}/admin/guides/enterprise-support/providing-data-to-github-support)". - -### Pacotes de suporte - -Todas as informações de auditoria são registradas no arquivo `audit.log`, no diretório `github-logs` de qualquer pacote de suporte. Se o encaminhamento de logs estiver habilitado, você poderá transmitir esses dados para um consumidor de fluxo de syslog externo, como o [Splunk](http://www.splunk.com/) ou o [Logstash](http://logstash.net/). Todas as entradas desse log usam a palavra-chave `github_audit` e podem ser filtradas por ela. Para obter mais informações, consulte "[Encaminhamento de logs](/enterprise/{{ currentVersion }}/admin/guides/installation/log-forwarding)". - -Por exemplo, esta entrada mostra que um repositório foi criado. - -``` -Oct 26 01:42:08 github-ent github_audit: {:created_at=>1351215728326, :actor_ip=>"10.0.0.51", :data=>{}, :user=>"some-user", :repo=>"some-user/some-repository", :actor=>"some-user", :actor_id=>2, :user_id=>2, :action=>"repo.create", :repo_id=>1, :from=>"repositories#create"} -``` - -Este exemplo mostra que houve push dos commits para um repositório. - -``` -Oct 26 02:19:31 github-ent github_audit: { "pid":22860, "ppid":22859, "program":"receive-pack", "git_dir":"/data/repositories/some-user/some-repository.git", "hostname":"github-ent", "pusher":"some-user", "real_ip":"10.0.0.51", "user_agent":"git/1.7.10.4", "repo_id":1, "repo_name":"some-user/some-repository", "transaction_id":"b031b7dc7043c87323a75f7a92092ef1456e5fbaef995c68", "frontend_ppid":1, "repo_public":true, "user_name":"some-user", "user_login":"some-user", "frontend_pid":18238, "frontend":"github-ent", "user_email":"some-user@github.example.com", "user_id":2, "pgroup":"github-ent_22860", "status":"post_receive_hook", "features":" report-status side-band-64k", "received_objects":3, "receive_pack_size":243, "non_fast_forward":false, "current_ref":"refs/heads/master" } -``` diff --git a/translations/pt-BR/content/admin/installation/audited-actions.md b/translations/pt-BR/content/admin/installation/audited-actions.md deleted file mode 100644 index e3c5cce77ef2..000000000000 --- a/translations/pt-BR/content/admin/installation/audited-actions.md +++ /dev/null @@ -1,133 +0,0 @@ ---- -title: Ações auditadas -intro: Você pode pesquisar uma série de ações no log de auditoria. -redirect_from: - - /enterprise/admin/articles/audited-actions/ - - /enterprise/admin/installation/audited-actions -versions: - enterprise-server: '*' ---- - -#### Autenticação - -| Nome | Descrição | -| ------------------------------------:| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `oauth_access.create` | Um [token de acesso OAuth](/v3/oauth/) foi [gerado](/articles/creating-an-access-token-for-command-line-use) para uma conta de usuário. | -| `oauth_access.destroy` | Um [token de acesso OAuth](/v3/oauth/) foi excluído de uma conta de usuário. | -| `oauth_application.destroy` | Um [aplicativo OAuth](/guides/basics-of-authentication/#registering-your-app) foi excluído de uma organização ou conta de usuário. | -| `oauth_application.reset_secret` | A chave secreta de um [aplicativo OAuth](/guides/basics-of-authentication/#registering-your-app) foi redefinida. | -| `oauth_application.transfer` | Um [aplicativo OAuth](/guides/basics-of-authentication/#registering-your-app) foi transferido de uma organização ou conta de usuário para outra. | -| `public_key.create` | Uma chave SSH foi [adicionada](/articles/adding-a-new-ssh-key-to-your-github-account) a uma conta de usuário ou uma [chave de implantação](/guides/managing-deploy-keys/#deploy-keys) foi adicionada ao repositório. | -| `public_key.delete` | Uma chave SSH foi removida de uma conta de usuário ou uma [chave de implantação](/guides/managing-deploy-keys/#deploy-keys) foi removida de um repositório. | -| `public_key.update` | A chave SSH de uma conta de usuário ou a [chave de implantação](/guides/managing-deploy-keys/#deploy-keys) de um repositório foi atualizada. | -| `two_factor_authentication.enabled` | A [autenticação de dois fatores](/articles/about-two-factor-authentication) foi habilitada para uma conta de usuário. | -| `two_factor_authentication.disabled` | A [autenticação de dois fatores](/articles/about-two-factor-authentication) foi desabilitada para uma conta de usuário. | - -#### Hooks - -| Nome | Descrição | -| ---------------------:| --------------------------------------------------- | -| `hook.create` | Um novo hook foi adicionado ao repositório. | -| `hook.config_changed` | A configuração de um hook foi alterada. | -| `hook.destroy` | Um hook foi excluído. | -| `hook.events_changed` | Os eventos configurados de um hook foram alterados. | - -#### Configurações de instância - -| Nome | Descrição | -| -------------------------------------------------------:| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `business.update_member_repository_creation_permission` | Um administrador do site restringe a criação de repositórios em organizações na instância. Para obter mais informações, consulte "[Restringir a criação de repositórios na instância](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)". | -| `business.clear_members_can_create_repos` | Um administrador do site retira uma restrição de criação de repositórios nas organizações na instância. Para obter mais informações, consulte "[Restringir a criação de repositórios na instância](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)". | -| `enterprise.config.lock_anonymous_git_access` | Um administrador do site bloqueia acessos de leitura anônimos do Git para impedir que os administradores do repositório alterem as configurações de acessos de leitura anônimos do Git existentes nos repositórios na instância. Para obter mais informações, consulte "[Impedir os usuários de alterarem o acesso de leitura anônimo do Git](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)". | -| `enterprise.config.unlock_anonymous_git_access` | Um administrador do site desbloqueia acessos de leitura anônimos do Git para permitir que administradores alterem as configurações de acessos de leitura anônimos do Git existentes nos repositórios na instância. Para obter mais informações, consulte "[Impedir os usuários de alterarem o acesso de leitura anônimo do Git](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)". | - -#### Problemas e pull requests - -| Nome | Descrição | -| ------------------------------------:| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `issue.update` | O texto de um problema (comentário inicial) foi alterado. | -| `issue_comment.update` | Um comentário em um problema (que não seja o inicial) foi alterado. | -| `pull_request_review_comment.delete` | Um comentário em uma pull request foi excluído. | -| `issue.destroy` | Um problema foi excluído do repositório. Para obter mais informações, consulte "[Excluir um problema](/enterprise/{{ currentVersion }}/user/articles/deleting-an-issue)". | - -#### Organizações - -| Nome | Descrição | -| ------------------:| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `org.async_delete` | Um usuário iniciou um trabalho em segundo plano para excluir uma organização. | -| `org.delete` | Uma organização foi excluída por um trabalho em segundo plano iniciado pelo usuário. | -| `org.transform` | A conta de usuário foi convertida em organização. Para obter mais informações, consulte [Converter usuário em organização](/enterprise/{{ currentVersion}}/user/articles/converting-a-user-into-an-organization/). | - -#### Branches protegidos - -| Nome | Descrição | -| ------------------------------------------------------------------:| ------------------------------------------------------------------------------------- | -| `protected_branch.create` | A proteção do branch está habilitada em um branch. | -| `protected_branch.destroy` | A proteção do branch está desabilitada em um branch. | -| `protected_branch.update_admin_enforced` | A proteção do branch é exigida para os administradores do repositório. | -| `protected_branch.update_require_code_owner_review` | A exigência da revisão do proprietário do código é atualizada em um branch. | -| `protected_branch.dismiss_stale_reviews` | A exigência de ignorar pull requests obsoletas é atualizada em um branch. | -| `protected_branch.update_signature_requirement_enforcement_level` | A exigência de assinatura de commit obrigatória é atualizada em um branch. | -| `protected_branch.update_pull_request_reviews_enforcement_level` | A exigência de revisões obrigatórias de pull request é atualizada em um branch. | -| `protected_branch.update_required_status_checks_enforcement_level` | A exigência de verificações de status obrigatórias é atualizada em um branch. | -| `protected_branch.rejected_ref_update` | Uma tentativa de atualização do branch é rejeitada. | -| `protected_branch.policy_override` | Um requisito de proteção do branch é sobrescrito por um administrador do repositório. | - -#### Repositórios - -| Nome | Descrição | -| ------------------------------------------:| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `repo.access` | Um repositório privado passou a ser público, ou um repositório público passou a ser privado. | -| `repo.archive` | Um repositório foi arquivado. Para obter mais informações, consulte [Arquivar e cancelar o arquivamento de repositórios](/enterprise/{{ currentVersion }}/admin/guides/user-management/archiving-and-unarchiving-repositories/). | -| `repo.add_member` | Um colaborador foi adicionado ao repositório. | -| `repo.config` | Um administrador do site bloqueou a opção de forçar pushes. Para obter mais informações, consulte [Bloquear pushes forçados em um repositório](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository/). | -| `repo.create` | Um repositório foi criado. | -| `repo.destroy` | Um repositório foi excluído. | -| `repo.remove_member` | Um colaborador foi removido do repositório. | -| `repo.rename` | Um repositório foi renomeado. | -| `repo.transfer` | Um usuário aceitou uma solicitação para receber um repositório transferido. | -| `repo.transfer_start` | Um usuário enviou uma solicitação para transferir um repositório a outro usuário ou organização. | -| `repo.unarchive` | Um repositório teve o arquivamento cancelado. Para obter mais informações, consulte [Arquivar e cancelar o arquivamento de repositórios](/enterprise/{{ currentVersion }}/admin/guides/user-management/archiving-and-unarchiving-repositories/). | -| `repo.config.disable_anonymous_git_access` | O acesso de leitura anônimo do Git está desabilitado em um repositório público. Para obter mais informações, consulte "[Habilitar acesso de leitura anônimo do Git para um repositório](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)". | -| `repo.config.enable_anonymous_git_access` | O acesso de leitura anônimo do Git está habilitado em um repositório público. Para obter mais informações, consulte "[Habilitar acesso de leitura anônimo do Git para um repositório](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)". | -| `repo.config.lock_anonymous_git_access` | O acesso de leitura anônimo de um repositório do Git está bloqueado, impedindo que os administradores de repositório alterem (habilitem ou desabilitem) essa configuração. Para obter mais informações, consulte "[Impedir os usuários de alterarem o acesso de leitura anônimo do Git](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)". | -| `repo.config.unlock_anonymous_git_access` | O acesso de leitura anônimo de um repositório do Git está desbloqueado, permitindo que os administradores de repositório alterem (habilitem ou desabilitem) essa configuração. Para obter mais informações, consulte "[Impedir os usuários de alterarem o acesso de leitura anônimo do Git](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)". | - -#### Ferramentas de administração do site - -| Nome | Descrição | -| --------------------:| -------------------------------------------------------------------------------------------------------------------------- | -| `staff.disable_repo` | Um administrador do site desabilitou o acesso a um repositório e a todas as suas bifurcações. | -| `staff.enable_repo` | Um administrador do site habilitou novamente o acesso a um repositório e a todas as suas bifurcações. | -| `staff.fake_login` | Um administrador do site fez login no {% data variables.product.prodname_enterprise %} como outro usuário. | -| `staff.repo_unlock` | Um administrador do site desbloqueou (obteve acesso total temporariamente a) um dos repositórios privados de um usuário. | -| `staff.unlock` | Um administrador do site desbloqueou (obteve acesso total temporariamente a) todos os repositórios privados de um usuário. | - -#### Equipes - -| Nome | Descrição | -| --------------:| --------------------------------------------------------------- | -| `team.create` | Um repositório ou conta de usuário foi adicionado a uma equipe. | -| `team.delete` | Um repositório ou conta de usuário foi removido de uma equipe. | -| `team.destroy` | Uma equipe foi excluída. | - -#### Usuários - -| Nome | Descrição | -| ---------------------------:| -------------------------------------------------------------------------------------------------------------- | -| `user.add_email` | Um endereço de e-mail foi adicionado a uma conta de usuário. | -| `user.async_delete` | Um trabalho assíncrono foi iniciado para destruir uma conta de usuário, acionando eventualmente `user.delete`. | -| `user.change_password` | Um usuário alterou a própria senha. | -| `user.create` | Uma nova conta de usuário foi criada. | -| `user.delete` | Uma conta de usuário foi destruída por um trabalho assíncrono. | -| `user.demote` | Um administrador do site foi rebaixado a uma conta de usuário regular. | -| `user.destroy` | Um usuário excluiu a própria conta, acionando `user.async_delete`. | -| `user.failed_login` | Um usuário tentou fazer login com nome de usuário, senha ou código de autenticação de dois fatores incorretos. | -| `user.forgot_password` | Um usuário solicitou redefinição de senha pela página de login. | -| `user.login` | Um usuário fez login. | -| `user.promote` | Uma conta de usuário regular foi promovida a administrador do site. | -| `user.remove_email` | Um endereço de e-mail foi removido de uma conta de usuário. | -| `user.rename` | Um nome de usuário foi alterado. | -| `user.suspend` | Uma conta de usuário foi suspensa por um administrador do site. | -| `user.two_factor_requested` | Um usuário recebeu a solicitação de informar o código de autenticação de dois fatores. | -| `user.unsuspend` | Uma conta de usuário teve a suspensão cancelada por um administrador do site. | diff --git a/translations/pt-BR/content/admin/installation/command-line-utilities.md b/translations/pt-BR/content/admin/installation/command-line-utilities.md deleted file mode 100644 index 522c18620de9..000000000000 --- a/translations/pt-BR/content/admin/installation/command-line-utilities.md +++ /dev/null @@ -1,787 +0,0 @@ ---- -title: Utilitários de linha de comando -intro: 'O {% data variables.product.prodname_ghe_server %} tem uma série de utilitários que ajudam a resolver problemas específicos ou a executar determinadas tarefas.' -redirect_from: - - /enterprise/admin/articles/viewing-all-services/ - - /enterprise/admin/articles/command-line-utilities/ - - /enterprise/admin/installation/command-line-utilities -miniTocMaxHeadingLevel: 4 -versions: - enterprise-server: '*' ---- - -Depois de entrar como usuário administrador com SSH, você pode executar esses comandos de qualquer lugar na VM. Para obter mais informações, consulte "[Acessar o shell administrativo (SSH)](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-administrative-shell-ssh/)". - -### Geral - -#### ghe-announce - -Este utilitário insere um banner no topo de cada página do {% data variables.product.prodname_enterprise %}. Você pode usá-lo para enviar uma comunicação a todos os usuários. - -```shell -# Configura uma mensagem visível para todos -$ ghe-announce -s MESSAGE -> Mensagem de anúncio configurada -# Remove uma mensagem já configurada -$ ghe-announce -u -> Mensagem de anúncio removida -``` - -#### ghe-check-disk-usage - -Este utilitário verifica se há arquivos grandes ou arquivos excluídos no disco, mas que ainda têm identificadores abertos. Deve ser executado para liberar espaço na partição raiz. - -```shell -ghe-check-disk-usage -``` - -#### ghe-cleanup-caches - -Este utilitário limpa uma série de caches que podem vir a ocupar espaço extra em disco no volume raiz. Se você perceber que o uso do espaço em disco do volume raiz aumenta muito ao longo do tempo, talvez seja uma boa ideia executar este utilitário e verificar se ele ajuda a reduzir o uso geral. - -```shell -ghe-cleanup-caches -``` -#### ghe-cleanup-settings - -Este utilitário apaga todas as configurações do {% data variables.enterprise.management_console %}. - -{% tip %} - -**Dica**: {% data reusables.enterprise_enterprise_support.support_will_ask_you_to_run_command %} - -{% endtip %} - -```shell -ghe-cleanup-settings -``` - -#### ghe-config - -Com este utilitário, você pode recuperar e modificar as definições de configuração da {% data variables.product.product_location_enterprise %}. - -```shell -$ ghe-config core.github-hostname -# Gera o valor de configuração de `core.github-hostname` -$ ghe-config core.github-hostname 'example.com' -# Define o valor de configuração de `core.github-hostname` como `example.com` -$ ghe-config -l -# Lista todos os valores de configuração -``` -Permite encontrar o uuid do nó em `cluster.conf`. - -``` shell - $ ghe-config _hostname_.uuid -``` - -#### ghe-config-apply - -Este utilitário aplica configurações do {% data variables.enterprise.management_console %}, recarrega os serviços do sistema, prepara um dispositivo de armazenamento, recarrega os serviços de aplicativos e executa as migrações pendentes de banco de dados. Ele equivale a clicar em **Save settings** (Salvar configurações) na IU da web do {% data variables.enterprise.management_console %} ou a enviar uma solicitação POST [ao endpoint `/setup/api/configure`](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#management-console). - -É provável que você não precise executar essa ação manualmente, mas é possível fazer isso caso você queira automatizar o processo de salvar suas configurações via SSH. - -```shell -ghe-config-apply -``` - -#### ghe-console - -Este utilitário abre o console do GitHub Rails no appliance do {% data variables.product.prodname_enterprise %}. {% data reusables.command_line.use_with_support_only %} - -```shell -ghe-console -``` - -#### ghe-dbconsole - -Este utilitário abre uma sessão do banco de dados MySQL no appliance do {% data variables.product.prodname_enterprise %}. {% data reusables.command_line.use_with_support_only %} - -```shell -ghe-dbconsole -``` - -#### ghe-es-index-status -Este utilitário retorna um resumo dos índices do Elasticsearch no formato CSV. - -Imprimir um resumo do índice com uma linha de header em `STDOUT`: -```shell -$ ghe-es-index-status -do -> warning: parser/current está carregando parser/ruby23, que reconhece -> warning: sintaxe 2.3.3-compliant, mas você está executando 2.3.4. -> warning: consulte https://github.com/whitequark/parser#compatibility-with-ruby-mri. -> Name,Primary,Searchable,Writable,UpToDate,RepairProgress,Version -> code-search-1,true,true,true,true,100.0,72e27df7c631b45e026b42bfef059328fa040e17 -> commits-5,true,true,true,true,100.0,7ed28813100c47813ef654c0ee2bb9abf21ab744 -> gists-4,true,true,true,true,100.0,cf8e7d04fcf2564c902e2873c424a279cc41079d -> issues-4,false,false,false,true,100.0,d0bb08f71eebf6e7b070572aa399b185dbdc8a76 -> issues-5,true,true,true,true,100.0,d0bb08f71eebf6e7b070572aa399b185dbdc8a76 -> projects-2,true,true,true,true,100.0,c5cac1c4b3c66d42e609d088d174dbc3dd44469a -> pull-requests-6,true,true,true,true,100.0,6a466ad6b896a3499509990979bf9a18d7d41de3 -> repos-6,true,true,true,true,100.0,6c8b5fbba0fc1e409558db411d05e092c1387082 -> users-5,true,true,true,true,100.0,38984875552bb826c9ec42999f409cb2e95556eb -> wikis-4,true,true,true,true,100.0,2613dec44bd14e14577803ac1f9e4b7e07a7c234 -``` - -Imprimir um resumo do índice e os resultados em `column` para facilitar a leitura: - -```shell -$ ghe-es-index-status -do | column -ts, -> warning: parser/current está carregando parser/ruby23, que reconhece -> warning: sintaxe 2.3.3-compliant, mas você está executando 2.3.4. -> warning: consulte https://github.com/whitequark/parser#compatibility-with-ruby-mri. -> Name Primary Searchable Writable UpToDate RepairProgress Version -> code-search-1 true true true true 100.0 72e27df7c631b45e026b42bfef059328fa040e17 -> commits-5 true true true true 100.0 7ed28813100c47813ef654c0ee2bb9abf21ab744 -> gists-4 true true true true 100.0 cf8e7d04fcf2564c902e2873c424a279cc41079d -> issues-4 false false false true 100.0 d0bb08f71eebf6e7b070572aa399b185dbdc8a76 -> issues-5 true true true true 100.0 d0bb08f71eebf6e7b070572aa399b185dbdc8a76 -> projects-2 true true true true 100.0 c5cac1c4b3c66d42e609d088d174dbc3dd44469a -> pull-requests-6 true true true true 100.0 6a466ad6b896a3499509990979bf9a18d7d41de3 -> repos-6 true true true true 100.0 6c8b5fbba0fc1e409558db411d05e092c1387082 -> users-5 true true true true 100.0 38984875552bb826c9ec42999f409cb2e95556eb -> wikis-4 true true true true 100.0 2613dec44bd14e14577803ac1f9e4b7e07a7c234 -``` - -#### ghe-legacy-github-services-report - -Este utilitário lista os repositórios no appliance que usam o {% data variables.product.prodname_dotcom %} Services, um método de integração que será descontinuado em 1 de outubro de 2018. Os usuários do seu appliance podem ter configurado o {% data variables.product.prodname_dotcom %} Services para criar notificações de pushes em determinados repositórios. Para obter mais informações, consulte "[Anunciar a descontinuação dos Serviços {% data variables.product.prodname_dotcom %} ](https://developer.github.com/changes/2018-04-25-github-services-deprecation/)" no {% data variables.product.prodname_blog %} ou "[Substituir os Serviços {% data variables.product.prodname_dotcom %} ](/v3/guides/replacing-github-services/)". Para mais informações sobre este comando ou opções adicionais, use o sinalizador `-h`. - -```shell -ghe-legacy-github-services-report - -``` - -#### ghe-logs-tail - -Este utilitário permite registrar todos os arquivos de log relevantes da sua instalação. Você pode passar as opções para limitar os logs a conjuntos específicos. Para consultar opções adicionais, use o sinalizador -h. - -```shell -ghe-logs-tail -``` - -#### ghe-maintenance - -Este utilitário permite controlar o estado do modo de manutenção da instalação. Ele foi desenvolvido para uso principalmente nos bastidores do {% data variables.enterprise.management_console %}, mas também pode ser usado diretamente. - -```shell -ghe-maintenance -h -``` - -{% if currentVersion ver_gt "enterprise-server@2.17" %} -#### ghe-motd - -Este utilitário exibe novamente a mensagem do dia (MOTD) que os administradores veem quando acessam a instância através do shell administrativo. A saída contém uma visão geral do estado da instância. - -```shell -ghe-motd -``` -{% endif %} - -#### ghe-nwo - -Este utilitário retorna o nome e o proprietário de um repositório com base no ID do repositório. - -```shell -ghe-nwo REPOSITORY_ID -``` - -#### ghe-org-admin-promote - -Use este comando para conceder privilégios de proprietário da organização a usuários com privilégios de administrador do site no appliance ou a qualquer usuário em uma única organização. Você deve especificar um usuário e/ou organização. O comando `ghe-org-admin-promote` sempre solicitará a confirmação antes da execução, a menos que você use o sinalizador `-y` para ignorar essa etapa. - -É possível usar estas opções com o utilitário: - -- O sinalizador `-u` especifica um nome de usuário. Use este sinalizador para conceder privilégios de proprietário da organização a um usuário. Omita o sinalizador `-u` para promover todos os administradores do site à organização especificada. -- O sinalizador `-o` especifica uma organização. Use este sinalizador para conceder privilégios de proprietário em uma organização. Omita o sinalizador `-o` para conceder permissões de proprietário em todas as organizações a um administrador do site. -- O sinalizador `-a` concede privilégios de proprietário em todas as organizações a todos os administradores do site. -- O sinalizador `-y` ignora a confirmação manual. - -Este utilitário não pode promover um administrador externo a proprietário de todas as organizações. Para promover uma conta de usuário comum a administrador do site, use [ghe-user-promote](#ghe-user-promote). - -Conceder privilégios de proprietário da organização a um usuário em uma organização específica - -```shell -ghe-org-admin-promote -u USERNAME -o ORGANIZATION -``` - -Conceder privilégios de proprietário da organização a um administrador do site em todas as organizações - -```shell -ghe-org-admin-promote -u USERNAME -``` - -Conceder privilégios de proprietário da organização a todos os administradores do site em uma organização específica - -```shell -ghe-org-admin-promote -o ORGANIZATION -``` - -Conceder privilégios de proprietário da organização a todos os administradores do site em todas as organizações - -```shell -ghe-org-admin-promote -a -``` - -#### ghe-reactivate-admin-login - -Use este comando para desbloquear imediatamente o {% data variables.enterprise.management_console %} após 10 tentativas de login com falha no período de 10 minutos. - -```shell -$ ghe-reactivate-admin-login -``` - -#### ghe-resque-info - -Este utilitário exibe informações sobre trabalhos em segundo plano, ativos e em fila. Ele fornece os mesmos números de contagem de trabalhos que a barra de estatísticas de administração, na parte superior de todas as páginas. - -Este utilitário pode ajudar a identificar se o servidor Resque está tendo problemas ao processar trabalhos em segundo plano. Quaisquer dos cenários a seguir podem indicar problemas com o Resque: - -* O número de trabalhos em segundo plano está aumentando, e os trabalhos ativos continuam iguais. -* Os feeds de evento não estão sendo atualizados. -* Webhooks não estão sendo acionados. -* A interface web não atualiza após um push do Git. - -Se você desconfiar de falha no Resque, entre em contato com o {% data variables.contact.contact_ent_support %}. - -Com este comando, também é possível pausar ou retomar trabalhos na fila. - -```shell -$ ghe-resque-info -# lista filas e o número de trabalhos em fila -$ ghe-resque-info -p QUEUE -# pausa a fila especificada -$ ghe-resque-info -r QUEUE -# retoma a fila especificada -``` - -#### ghe-saml-mapping-csv - -Este utilitário pode ajudar a mapear os registros SAML. - -Para criar um arquivo CSV contendo todo o mapeamento SAML para os seus usuários do {% data variables.product.product_name %}: -```shell -$ ghe-saml-mapping-csv -d -``` - -Para executar uma execução seca de atualização de mapeamentos SAML com novos valores: -```shell -$ ghe-saml-mapping-csv -u -n -f /path/to/file -``` - -Para atualizar os mapeamentos SAML com novos valores: -```shell -$ ghe-saml-mapping-csv -u -f /path/to/file -``` - -#### ghe-service-list - -Este utilitário lista todos os serviços iniciados ou parados (em execução ou em espera) no appliance. - -```shell -$ ghe-service-list -start/running - - github-resqued, process 12711 - - github-unicorn, process 12726 - - github-gitauth, process 12743 - - git-daemon, process 12755 - - babeld, process 12771 - - github-svn-proxy, process 12802 - - gist-unicorn, process 12832 - - gist-resqued, process 12881 - - render-unicorn, process 12939 - - hookshot-unicorn, process 13076 - - nodeload2, process 13192 - - slumlord-unicorn, process 13304 - - ghe-storage, process 2012 - - enterprise-manage-unicorn, process 2024 - - enterprise-manage-resque, process 2053 - -stop/waiting - - ghe-replica-mode -``` - -{% tip %} - -Os nomes de serviço retornados deste comando podem ser usados com comandos "[`systemctl`](https://www.freedesktop.org/software/systemd/man/systemctl.html)" para interromper, iniciar ou reiniciar esses serviços manualmente, se necessário. Como por exemplo: - -```shell -$ sudo systemctl restart github-resqued -``` - -A interrupção dos serviços causará tempo de inatividade na instalação. Portanto, é recomendável entrar em contato com o {% data variables.contact.contact_ent_support %} antes de parar ou reiniciar qualquer serviço. - -{% endtip %} - -#### ghe-set-password - -Com `ghe-set-password`, você pode definir uma nova senha para autenticação no [{% data variables.enterprise.management_console %}](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-management-console). - -```shell -ghe-set-password -``` - -#### ghe-ssh-check-host-keys - -Este utilitário verifica as chaves do host SSH atuais para identificar chaves vazadas conhecidas. - -```shell -$ ghe-ssh-check-host-keys -``` - -Se houver alguma chave vazada, o utilitário exibirá o status `1` e a seguinte mensagem: -```shell -> Uma ou mais chaves do host SSH foram encontradas na lista de bloqueio. -> Redefina suas chaves de host usando ghe-ssh-roll-host-keys. -``` - -Se não houver chaves de host vazadas, o utilitário exibirá o status `0` e a seguinte mensagem: -```shell -> As chaves de host SSH não foram encontradas na lista de bloqueio. -> No momento, nenhuma etapa adicional é necessária/recomendada. -``` - -#### ghe-ssh-roll-host-keys - -Este utilitário acumula as chaves do host SSH e as substitui por chaves recém-geradas. - -```shell -$ sudo ghe-ssh-roll-host-keys -Continuar para acumular chaves de host SSH? Esta ação excluirá as -chaves atuais em /etc/ssh/ssh_host_* para gerar chaves novas. [y/N] - -# Pressione 'Y' para confirmar a exclusão ou use o switch -y para ignorar esta solicitação - -> chaves de host SSH foram acumuladas com êxito. -``` - -#### ghe-ssh-weak-fingerprints - -Este utilitário retorna um relatório de chaves SSH fracas conhecidas armazenadas no appliance do {% data variables.product.prodname_enterprise %}. Você também pode revogar as chaves do usuário como uma ação em lote. O utilitário relatará as chaves de sistema fracas, que você deve revogar manualmente no [{% data variables.enterprise.management_console %}](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-management-console). - -```shell -# Imprimir um relatório de chaves SSH fracas do usuário e do sistema -$ ghe-ssh-weak-fingerprints - -# Revogar todas as chaves fracas de usuário -$ ghe-ssh-weak-fingerprints --revoke -``` - -#### ghe-ssl-acme - -Este utilitário permite instalar um certificado Let's Encrypt no seu appliance do {% data variables.product.prodname_enterprise %}. Para obter mais informações, consulte "[Configurar o TLS](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-tls)". - -Você pode usar o sinalizador `-x` para remover a configuração ACME. - -```shell -ghe-ssl-acme -e -``` - -#### ghe-ssl-ca-certificate-install - -Este utilitário permite instalar um certificado CA personalizado de raiz no seu appliance do {% data variables.product.prodname_enterprise %}. O certificado deve estar no formato PEM. Além disso, se o seu provedor de certificados incluir vários certificados CA em um só arquivo, você deverá separá-los em arquivos a serem passados individualmente para ` ghe-ssl-ca-certificate-install`. - -Execute este utilitário para adicionar uma cadeia de certificados para verificação de assinatura de commits S/MIME. Para obter mais informações, consulte "[Sobre a verificação de assinatura de commit](/enterprise/{{ currentVersion }}/user/articles/about-commit-signature-verification/)". - -Execute este utilitário quando a {% data variables.product.product_location_enterprise %} não conseguir se conectar a outro servidor por ele estar usando um certificado SSL autoassinado ou um certificado SSL para o qual não há o pacote CA necessário. Uma forma de confirmar essa questão é executar `openssl s_client -connect host:port -verify 0 -CApath /etc/ssl/certs` na {% data variables.product.product_location_enterprise %}. Se o certificado SSL do servidor remoto puder ser verificado, sua `SSL-Session` deverá ter um código de retorno 0, conforme mostrado abaixo. - -``` -SSL-Session: - Protocol : TLSv1 - Cipher : AES128-SHA - Session-ID: C794EBCC3CBC10F747C9AFC029C03C1048FC99CFC34D13D7444E0F267C58DF4C - Session-ID-ctx: - Master-Key: 02A7C47CFD6EEC87D3C710E9DD87390E04EF82DDD7514AE03127D5DC1945FC0CAEFB5395791AEA598667EFA61B9EA8C5 - Key-Arg : None - Start Time: 1394581597 - Timeout : 300 (sec) - Verify return code: 0 (ok) -``` - -Por outro lado, se o certificado SSL do servidor remoto *não* puder ser verificado, sua `SSL-Session` deverá ter um código de retorno diferente de zero: - -``` -SSL-Session: - Protocol : TLSv1 - Cipher : AES128-SHA - Session-ID: 82CB288051A6DB66094C50A69CF1292AEE7E54C6B01B659B98AB336F8C33863E - Session-ID-ctx: - Master-Key: 01B025B2F764043A27919A8D1355AAECD8844FF0831B1D664042334790574A6F4025BAB085D4ED71D71AAB3091B849E5 - Key-Arg : None - Start Time: 1394581782 - Timeout : 300 (sec) - Verify return code: 27 (certificate not trusted) -``` - -É possível usar estas opções adicionais com o utilitário: -- O sinalizador `-r` permite desinstalar um certificado CA; -- O sinalizador `-h` exibe mais informações de uso. - -```shell -ghe-ssl-ca-certificate-install -c /path/to/certificate -``` - -#### ghe-ssl-generate-csr - -Com este utilitário, você pode gerar uma chave privada e uma solicitação de assinatura de certificado (CSR, Certificate Signing Request) a ser compartilhada com uma autoridade certificada comercial ou privada para obter um certificado válido na sua instância. Para obter mais informações, consulte "[Configurar o TLS](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-tls)". - -Para saber mais sobre este comando ou consultar opções adicionais, use o sinalizador `-h`. - -```shell -ghe-ssl-generate-csr -``` - -#### ghe-storage-extend - -Algumas plataformas exigem este script para aumentar o volume de usuários. Para obter mais informações, consulte "[Aumentar a capacidade de armazenamento](/enterprise/admin/guides/installation/increasing-storage-capacity/)". - -```shell -$ ghe-storage-extend -``` - -#### ghe-version - -Este utilitário imprime a versão, a plataforma e a compilação da {% data variables.product.product_location_enterprise %}. - -```shell -$ ghe-version -``` - -#### ghe-webhook-logs - -Este utilitário retorna logs de entrega de webhook para os administradores revisarem e identificarem problemas. - -```shell -ghe-webhook-logs -``` - -Para exibir todas as entregas de hook falhas do último dia: -```shell -ghe-webhook-logs -f -a YYYYMMDD -``` - -Para exibir a carga útil total do hook, o resultado e quaisquer exceções para a entrega: -```shell -ghe-webhook-logs -g delivery-guid -v -``` - -Para exibir entregas globais do webhook: -```shell -ghe-webhook-logs --global -``` - -### Clustering - -#### ghe-cluster-support-bundle - -Este utilitário cria um pacote de suporte tarball com logs importantes de cada nó em configurações de replicação geográfica ou de cluster. - -O comando cria o tarball em */tmp* por padrão, mas você também pode criar em `cat` para `STDOUT` a fim de facilitar a transmissão por SSH. Fazer isso é útil caso a interface da web não responda ou baixe um pacote de suporte de */setup/support* que não funcione. Você deve usar este comando se quiser gerar um pacote *estendido*, com logs mais antigos. Também é possível usá-lo para fazer upload do pacote de suporte de cluster diretamente para o suporte do {% data variables.product.prodname_enterprise %}. - -Para criar um pacote padrão: -```shell -$ ssh -p 122 admin@hostname -- 'ghe-cluster-support-bundle -o' > cluster-support-bundle.tgz -``` - -Para criar um pacote estendido: -```shell -$ ssh -p 122 admin@hostname -- 'ghe-cluster-support-bundle -x -o' > cluster-support-bundle.tgz -``` - -Para enviar um pacote para {% data variables.contact.github_support %}: -```shell -$ ssh -p 122 admin@hostname -- 'ghe-cluster-support-bundle -u' -``` - -Para enviar um pacote para {% data variables.contact.github_support %} e associar o pacote a um tíquete: -```shell -$ ssh -p 122 admin@hostname -- 'ghe-cluster-support-bundle -t ticket-id' -``` - -#### ghe-dpages - -Este utilitário permite que você gerencie o servidor distribuído {% data variables.product.prodname_pages %}. - -```shell -ghe-dpages -``` - -Para mostrar um resumo da localização e saúde do repositório: -```shell -ghe-dpages status -``` - -Para evacuar um serviço de armazenamento {% data variables.product.prodname_pages %} antes de evacuar um nó de cluster: -``` shell -ghe-dpages evacuate pages-server- -``` - -#### ghe-spokes - -Este utilitário permite gerenciar as três cópias de cada repositório nos servidores distribuídos do git. - -```shell -ghe-spokes -``` - -Para mostrar um resumo da localização e saúde do repositório: - -```shell -ghe-spokes status -``` - -Para mostrar os servidores em que o repositório está armazenado: - -```shell -ghe-spokes route -``` - -Para evacuar os serviços de armazenamento em um nó de cluster: - -``` shell -ghe-spokes server evacuate git-server- -``` - -#### ghe-storage - -Este utilitário permite remover todos os serviços de armazenamento antes de remover um nó de cluster. - -``` shell -ghe-storage evacuate storage-server- -``` - -### Git - -#### ghe-btop - -Interface do tipo `top` para as operações atuais do Git. - -```shell -ghe-btop [ | --help | --usage ] -``` - -#### ghe-repo - -Este utilitário permite mudar para o diretório de um repositório e abrir um shell interativo como usuário do `git`. Você pode fazer a inspeção ou manutenção manual de um repositório usando comandos como `git-*` ou `git-nw-*`. - -```shell -ghe-repo username/reponame -``` - -#### ghe-repo-gc - -Este utilitário reempacota manualmente uma rede de repositórios para otimizar o armazenamento do pacote. Se você tem um repositório muito grande, esse comando pode ajudar a reduzir o tamanho. O {% data variables.product.prodname_enterprise %} executa automaticamente este comando durante toda a sua interação com uma rede de repositórios. - -Você pode adicionar o argumento opcional `--prune` para remover objetos inacessíveis do Git que não são referenciados em um branch, tag ou qualquer outra referência. Fazer isso é útil principalmente para remover de imediato [informações confidenciais já eliminadas](/enterprise/user/articles/remove-sensitive-data/). - -```shell -ghe-repo-gc username/reponame -``` - -### Importação e exportação - -#### ghe-migrator - -O `ghe-migrator` é uma ferramenta de alta fidelidade que ajuda a fazer migrações de uma instância do GitHub para outra. Você pode consolidar suas instâncias ou mover a organização, os usuários, as equipes e os repositórios do GitHub.com para o {% data variables.product.prodname_enterprise %}. - -Para obter mais informações, consulte nosso guia sobre [como migrar dados de usuário, organização e repositório](/enterprise/admin/guides/migrations/). - -#### git-import-detect - -Em uma URL, detecta qual tipo de sistema de gerenciamento de controle de origem está na outra extremidade. Provavelmente esse processo já é conhecido nas importações manuais, mas pode ser muito útil em scripts automatizados. -```shell -git-import-detect -``` - -#### git-import-hg-raw - -Este utilitário importa um repositório Mercurial para este repositório Git. Para obter mais informações, consulte [Importar dados de sistemas de controle de versões de terceiros](/enterprise/{}/admin/guides/migrations/importing-data-from-third-party-version-control-systems/)." -```shell -git-import-hg-raw -``` - -#### git-import-svn-raw - -Este utilitário importa histórico do Subversion e dados de arquivos para um branch do Git. Trata-se de uma cópia direta da árvore, ignorando qualquer distinção de trunk ou branch. Para obter mais informações, consulte [Importar dados de sistemas de controle de versões de terceiros](/enterprise/{}/admin/guides/migrations/importing-data-from-third-party-version-control-systems/)." -```shell -git-import-svn-raw -``` - -#### git-import-tfs-raw - -Este utilitário importa de Controle de versões do Team Foundation. Para obter mais informações, consulte [Importar dados de sistemas de controle de versões de terceiros](/enterprise/{}/admin/guides/migrations/importing-data-from-third-party-version-control-systems/)." -```shell -git-import-tfs-raw -``` - -#### git-import-rewrite - -Este utilitário reescreve o repositório importado. Isso lhe dá a chance de renomear os autores e, para Subversion e TFS, produz branches Git baseados em pastas. Para obter mais informações, consulte [Importar dados de sistemas de controle de versões de terceiros](/enterprise/{}/admin/guides/migrations/importing-data-from-third-party-version-control-systems/)." -```shell -git-import-rewrite -``` - -### Suporte - -#### ghe-diagnostics - -Este utilitário faz uma série de verificações e reúne informações sobre a instalação que você pode enviar ao suporte para ajudar a diagnosticar problemas. - -No momento, a saída do utilitário é semelhante ao download das informações de diagnóstico no {% data variables.enterprise.management_console %}, mas ele pode ter melhorias adicionais ao longo do tempo que não estão disponíveis na interface da web. Para obter mais informações, consulte "[Criar e compartilhar arquivos de diagnóstico](/enterprise/admin/guides/enterprise-support/providing-data-to-github-support#creating-and-sharing-diagnostic-files)". - -```shell -ghe-diagnostics -``` - -#### ghe-support-bundle - -{% data reusables.enterprise_enterprise_support.use_ghe_cluster_support_bundle %} -Esse utilitário cria um tarball do pacote de suporte com logs importantes da sua instância. - -O comando cria o tarball em */tmp* por padrão, mas você também pode criar em `cat` para `STDOUT` a fim de facilitar a transmissão por SSH. Fazer isso é útil caso a interface da web não responda ou baixe um pacote de suporte de */setup/support* que não funcione. Você deve usar este comando se quiser gerar um pacote *estendido*, com logs mais antigos. Também é possível usá-lo para fazer upload do pacote de suporte diretamente para o suporte do {% data variables.product.prodname_enterprise %}. - -Para criar um pacote padrão: -```shell -$ ssh -p 122 admin@hostname -- 'ghe-support-bundle -o' > support-bundle.tgz -``` - -Para criar um pacote estendido: -```shell -$ ssh -p 122 admin@hostname -- 'ghe-support-bundle -x -o' > support-bundle.tgz -``` - -Para enviar um pacote para {% data variables.contact.github_support %}: -```shell -$ ssh -p 122 admin@hostname -- 'ghe-support-bundle -u' -``` - -Para enviar um pacote para {% data variables.contact.github_support %} e associar o pacote a um tíquete: - -```shell -$ ssh -p 122 admin@hostname -- 'ghe-support-bundle -t ticket-id' -``` - -#### ghe-support-upload - -Este utilitário envia informações do seu appliance para o suporte do {% data variables.product.prodname_enterprise %}. Você pode especificar um arquivo local ou fornecer um fluxo de até 100 MB de dados via `STDIN`. Os dados carregados também podem ser associados a um tíquete de suporte. - -Para enviar um arquivo para {% data variables.contact.github_support %} e associar o arquivo a um tíquete: -```shell -ghe-support-upload -f path/to/your/file -t ticket-id -``` - -Para fazer upload de dados via `STDIN` e associá-los a dados de um tíquete: -```shell -ghe-repl-status -vv | ghe-support-upload -t ticket-id -d "Verbose Replication Status" -``` - -Neste exemplo, `ghe-repl-status -vv` envia informações detalhadas do status de um appliance réplica. Substitua `ghe-repl-status -vv` pelos dados que você deseja transmitir a `STDIN` e faça uma breve descrição dos dados em `Verbose Replication Status`. {% data reusables.enterprise_enterprise_support.support_will_ask_you_to_run_command %} - -### Atualização do {% data variables.product.prodname_ghe_server %} - -#### ghe-upgrade - -Este utilitário instala ou verifica um pacote de atualização. Também é possível usá-lo para voltar a uma versão de patch em casos de falha ou interrupção de uma atualização. Para obter mais informações, consulte "[Atualizar o {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-github-enterprise-server/)". - -Para verificar um pacote de atualização: -```shell -ghe-upgrade --verify UPGRADE-PACKAGE-FILENAME -``` - -Para instalar um pacote de atualização: -```shell -ghe-upgrade UPGRADE-PACKAGE-FILENAME -``` - -{% data reusables.enterprise_installation.command-line-utilities-ghe-upgrade-rollback %} - -#### ghe-upgrade-scheduler - -Este utilitário gerencia a instalação programada de pacotes de atualização. Você pode exibir, criar ou remover instalações programadas. Crie as programações usando expressões cron. Para obter mais informações, leia mais sobre [Cron na Wikipedia](https://en.wikipedia.org/wiki/Cron#Overview). - -Para agendar uma nova instalação para um pacote: -```shell -$ ghe-upgrade-scheduler -c "0 2 15 12 *" UPGRADE-PACKAGE-FILENAME -``` - -Para exibir instalações programadas para um pacote: -```shell -$ ghe-upgrade-scheduler -s UPGRADE PACKAGE FILENAME -> 0 2 15 12 * /usr/local/bin/ghe-upgrade -y -s UPGRADE-PACKAGE-FILENAME > /data/user/common/UPGRADE-PACKAGE-FILENAME.log 2>&1 -``` - -Para remover instalações programadas para um pacote: -```shell -$ ghe-upgrade-scheduler -r UPGRADE PACKAGE FILENAME -``` - -#### ghe-update-check - -Este utilitário verificará se uma nova versão do patch do {% data variables.product.prodname_enterprise %} está disponível. Se estiver e se houver espaço disponível na sua instância, ele baixará o pacote. Por padrão, a versão fica salva em */var/lib/ghe-updates*. Um administrador pode [realizar a atualização](/enterprise/admin/guides/installation/updating-the-virtual-machine-and-physical-resources/). - -Um arquivo contendo o status do download fica disponível em */var/lib/ghe-updates/ghe-update-check.status*. - -Para verificar a versão mais recente do {% data variables.product.prodname_enterprise %}, use o switch `-i`. - -```shell -$ ssh -p 122 admin@hostname -- 'ghe-update-check' -``` - -### Gerenciamento de usuários - -#### ghe-license-usage - -Este utilitário exporta uma lista de usuários da instalação em formato JSON. Se sua instância estiver conectada ao {% data variables.product.prodname_ghe_cloud %}, {% data variables.product.prodname_ghe_server %} usa essa informação para reportar informações de licenciamento ao {% data variables.product.prodname_ghe_cloud %}. Para obter mais informações, consulte "[Conctando {% data variables.product.prodname_ghe_server %} ao {% data variables.product.prodname_ghe_cloud %}](/enterprise/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)". - -Por padrão, a lista de usuários no arquivo JSON resultante é criptografada. Use o sinalizador `-h` para ver mais opções. - -```shell -ghe-license-usage -``` - -#### ghe-org-membership-update - -Este utilitário aplicará a configuração padrão de visibilidade da associação da organização a todos os integrantes da sua instância. Para obter mais informações, consulte "[Configurar a visibilidade da associação à organização](/enterprise/{{ currentVersion }}/admin/guides/user-management/configuring-visibility-for-organization-membership)". As opções de configuração são `pública` ou `privada`. - -```shell -ghe-org-membership-update --visibility=SETTING -``` - -#### ghe-user-csv - -Este utilitário exporta uma lista de todos os usuários na instalação em formato CSV. O arquivo CSV inclui o endereço de e-mail, o tipo de usuário (por exemplo, administrador), a quantidade de repositórios, chaves SSH e associações os usuários têm na organização, o endereço IP mais recente e outras informações. Use o sinalizador `-h` para ver mais opções. - -```shell -ghe-user-csv -o > users.csv -``` - -#### ghe-user-demote - -Este utilitário rebaixa o usuário especificado do status de administrador para o status de usuário regular. É recomendável usar a IU da web para executar esta ação, mas informe esse utilitário em caso de erro na execução do utilitário `ghe-user-promotion` se você precisar rebaixar um usuário novamente da CLI. - -```shell -ghe-user-demote some-user-name -``` - -#### ghe-user-promote - -Este utilitário promove a conta de usuário especificada a administrador do site. - -```shell -ghe-user-promote some-user-name -``` - -#### ghe-user-suspend - -Este utilitário suspende o usuário especificado, impedindo-o de fazer login, push ou pull nos seus repositórios. - -```shell -ghe-user-suspend some-user-name -``` - -#### ghe-user-unsuspend - -Este utilitário cancela a suspensão do usuário especificado, liberando o acesso para fazer login, push ou pull nos seus repositórios. - -```shell -ghe-user-unsuspend some-user-name -``` diff --git a/translations/pt-BR/content/admin/installation/configuring-a-hostname.md b/translations/pt-BR/content/admin/installation/configuring-a-hostname.md deleted file mode 100644 index 0cf0a135c0d6..000000000000 --- a/translations/pt-BR/content/admin/installation/configuring-a-hostname.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: Configurar nome de host -intro: 'Em vez de usar um endereço IP codificado, é recomendável definir um nome de host para o seu appliance.' -redirect_from: - - /enterprise/admin/guides/installation/configuring-hostnames/ - - /enterprise/admin/installation/configuring-a-hostname -versions: - enterprise-server: '*' ---- - -Se configurar um nome de host em vez de um endereço IP codificado, você poderá alterar o hardware físico em que a {% data variables.product.product_location_enterprise %} é executada sem afetar os usuários ou o software cliente. - -A configuração do nome de host no {% data variables.enterprise.management_console %} deve ser definida como um nome de domínio totalmente qualificado (FQDN) que seja resolvido na internet ou dentro da sua rede interna. Por exemplo, a configuração do nome de host pode ser `github.nomedaempresa.com.` Também recomendamos habilitar o isolamento de subdomínio para o nome do host escolhido a fim de mitigar várias vulnerabilidades no estilo de script entre sites. Para obter mais informações sobre as configurações de nome de host, consulte a [Seção 2.1 em HTTP RFC](https://tools.ietf.org/html/rfc1123#section-2). - -{% data reusables.enterprise_installation.changing-hostname-not-supported %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.hostname-menu-item %} -4. Digite o nome do host que você pretende definir para a {% data variables.product.product_location_enterprise %}. ![Campo para configurar um nome de host](/assets/images/enterprise/management-console/hostname-field.png) -5. Para testar as configurações DNS e SSL do novo nome de host, clique em **Test domain settings** (Testar configurações de domínio). ![Botão Test domain settings (Testar configurações de domínio)](/assets/images/enterprise/management-console/test-domain-settings.png) -{% data reusables.enterprise_management_console.test-domain-settings-failure %} -{% data reusables.enterprise_management_console.save-settings %} - -Depois de configurar um nome de host, recomendamos que você habilite o isolamento de subdomínio para a {% data variables.product.product_location_enterprise %}. Para obter mais informações, consulte "[Habilitar isolamento de subdomínio](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-subdomain-isolation/)". diff --git a/translations/pt-BR/content/admin/installation/configuring-an-outbound-web-proxy-server.md b/translations/pt-BR/content/admin/installation/configuring-an-outbound-web-proxy-server.md deleted file mode 100644 index d7163f6b4c1a..000000000000 --- a/translations/pt-BR/content/admin/installation/configuring-an-outbound-web-proxy-server.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Configurar servidor proxy web de saída -intro: 'Servidores proxy geram uma camada extra de segurança para a {% data variables.product.product_location_enterprise %}.' -redirect_from: - - /enterprise/admin/guides/installation/configuring-a-proxy-server/ - - /enterprise/admin/installation/configuring-an-outbound-web-proxy-server -versions: - enterprise-server: '*' ---- - -Quando houver um servidor proxy habilitado para a {% data variables.product.product_location_enterprise %}, as mensagens de saída enviadas para o {% data variables.product.prodname_ghe_server %} sairão primeiramente pelo servidor proxy, a menos que o host de destino seja adicionado como exclusão de proxy HTTP. Os tipos de mensagens de saída incluem webhooks de saída, pacotes para upload e fetch de avatares herdados. A URL do servidor proxy é o protocolo, domínio ou endereço IP e o número da porta, por exemplo: `http://127.0.0.1:8123`. - -{% note %} - -**Observação:** para conectar a {% data variables.product.product_location_enterprise %} ao {% data variables.product.prodname_dotcom_the_website %}, a sua configuração de proxy deve permitir conectividade com `github.com` e `api.github.com`. Para obter mais informações, consulte "[Conectar o {% data variables.product.prodname_ghe_server %} ao {% data variables.product.prodname_dotcom_the_website %}](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/connecting-github-enterprise-server-to-github-com)". - -{% endnote %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -4. Em **HTTP Proxy Server** (Servidor proxy HTTP), digite a URL do seu servidor proxy. ![Campo para digitar a URL do servidor proxy HTTP](/assets/images/enterprise/management-console/http-proxy-field.png) -5. Você também pode ir até **HTTP Proxy Exclusion** (Exclusão de proxy HTTP) e digitar qualquer host que não exija acesso por proxy, separando os hosts por vírgulas. ![Campo para digitar qualquer exclusão de proxy HTTP](/assets/images/enterprise/management-console/http-proxy-exclusion-field.png) -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/pt-BR/content/admin/installation/configuring-applications.md b/translations/pt-BR/content/admin/installation/configuring-applications.md deleted file mode 100644 index c63fd19e2b06..000000000000 --- a/translations/pt-BR/content/admin/installation/configuring-applications.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: Configurar aplicativos -intro: 'É possível configurar aplicativos internos para a {% data variables.product.product_location_enterprise %}.' -redirect_from: - - /enterprise/admin/installation/configuring-applications -versions: - enterprise-server: '*' ---- - -### Ajustar cache de imagem - -Você pode escolher por quanto tempo a {% data variables.product.product_location_enterprise %} armazena avatares em cache. Ao aumentar o tempo do cache, você aumenta o tempo que o avatar do usuário levará para carregar. Configurar o tempo de cache com um valor muito baixo pode sobrecarregar os processos de trabalho da {% data variables.product.product_location_enterprise %}. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -3. Na barra lateral esquerda, clique em **Applications** (Aplicativos). ![Guia Applications (Aplicativos) na barra lateral Settings (Configurações)](/assets/images/enterprise/management-console/sidebar-applications.png) -4. Em "Avatar image cache time (seconds)" (Tempo de cache para imagem do avatar [segundos]), digite por quantos segundos você deseja que a {% data variables.product.product_location_enterprise %} armazene as imagens do avatar em cache. ![Campo de formulário imagem de avatar em cache](/assets/images/enterprise/management-console/add-image-caching-value-field.png) -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/pt-BR/content/admin/installation/configuring-backups-on-your-appliance.md b/translations/pt-BR/content/admin/installation/configuring-backups-on-your-appliance.md deleted file mode 100644 index 49e242bdab95..000000000000 --- a/translations/pt-BR/content/admin/installation/configuring-backups-on-your-appliance.md +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: Configurar backups no appliance -redirect_from: - - /enterprise/admin/categories/backups-and-restores/ - - /enterprise/admin/articles/backup-and-recovery/ - - /enterprise/admin/articles/backing-up-github-enterprise/ - - /enterprise/admin/articles/restoring-github-enterprise/ - - /enterprise/admin/articles/backing-up-repository-data/ - - /enterprise/admin/articles/restoring-enterprise-data/ - - /enterprise/admin/articles/restoring-repository-data/ - - /enterprise/admin/articles/backing-up-enterprise-data/ - - /enterprise/admin/guides/installation/backups-and-disaster-recovery/ - - /enterprise/admin/installation/configuring-backups-on-your-appliance -intro: 'Como parte de um plano de recuperação de desastre, é possível proteger os dados de produção na {% data variables.product.product_location_enterprise %} configurando backups automatizados.' -versions: - enterprise-server: '*' ---- - -### Sobre o {% data variables.product.prodname_enterprise_backup_utilities %} - -O {% data variables.product.prodname_enterprise_backup_utilities %} é um sistema de backup a ser instalado em um host separado, que tira instantâneos de backup da {% data variables.product.product_location_enterprise %} em intervalos regulares em uma conexão de rede SSH segura. É possível usar um instantâneo para voltar uma instância do {% data variables.product.prodname_ghe_server %} a um estado anterior do host de backup. - -Somente os dados adicionados desde o último instantâneo serão transferidos pela rede e ocuparão espaço adicional de armazenamento físico. Para minimizar o impacto no desempenho, os backups são feitos online com a menor prioridade de E/S de CPU. Não é necessário programar um período de manutenção para fazer backups. - -Para obter informações mais detalhadas sobre recursos, requisitos e uso avançado, consulte o [LEIAME do {% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils#readme). - -### Pré-requisitos - -Para usar o {% data variables.product.prodname_enterprise_backup_utilities %}, você deve ter um sistema host Linux ou Unix separado da {% data variables.product.product_location_enterprise %}. - -Também é possível integrar o {% data variables.product.prodname_enterprise_backup_utilities %} a um ambiente para fins de armazenamento permanente em longo prazo de dados essenciais. - -É recomendável que o host de backup e a {% data variables.product.product_location_enterprise %} estejam geograficamente distantes. Essa medida garante que os backups estejam disponíveis para recuperação em casos de grandes desastres ou falhas de rede no site primário. - -Os requisitos de armazenamento físico variam com base no uso do disco do repositório Git e nos padrões de crescimento esperados: - -| Hardware | Recomendação | -| ----------------- | --------------------------------------------------------- | -| **vCPUs** | 2 | -| **Memória** | 2 GB | -| **Armazenamento** | Cinco vezes o armazenamento alocado da instância primária | - -Podem ser necessários mais recursos dependendo do uso, como atividade do usuário e integrações selecionadas. - -### Instalar o {% data variables.product.prodname_enterprise_backup_utilities %} - -{% note %} - -**Observação:** para garantir a disponibilidade imediata de um appliance recuperado, faça backups visando a instância principal, mesmo em uma configuração de replicação geográfica. - -{% endnote %} - -1. Baixe a [versão mais recente do {% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils/releases) e extraia o arquivo com o comando `tar`. - ```shell - $ tar -xzvf /path/to/github-backup-utils-vMAJOR.MINOR.PATCH.tar.gz - ``` -2. Copie o arquivo `backup.config-example` para `backup.config` e abra em um editor. -3. Defina o valor `GHE_HOSTNAME` para o nome de host ou endereço IP da instância primária do {% data variables.product.prodname_ghe_server %}. -4. Defina o valor `GHE_DATA_DIR` no local do arquivo do sistema onde você deseja arquivar os instantâneos de backup. -5. Abra a página das configurações da instância primária em `https://HOSTNAME/setup/settings` e adicione a chave SSH do host de backup à lista de chaves SSH autorizadas. Para obter mais informações, consulte [Acessar o shell administrativo (SSH)](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-administrative-shell-ssh/). -5. Verifique a conectividade SSH com a {% data variables.product.product_location_enterprise %} usando o comando `ghe-host-check`. - ```shell - $ bin/ghe-host-check - ``` - 6. Para criar um backup completo inicial, execute o comando `ghe-backup`. - ```shell - $ bin/ghe-backup - ``` - -Para obter mais informações sobre uso avançado, consulte o [arquivo LEIAME do {% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils#readme). - -### Programar um backup - -É possível programar backups regulares no host de backup com o comando `cron(8)` ou um serviço de agendamento semelhante. A frequência configurada determinará o objetivo do ponto de recuperação (RPO) nos piores cenários do seu plano de recuperação. Por exemplo, ao programar backups diários à meia-noite, você pode perder até 24 horas de dados em caso de desastre. É recomendável começar com backups a cada hora, garantindo a possibilidade de perdas menores (no máximo de uma hora) caso os dados primários do site sejam destruídos. - -Se houver sobreposição de tentativas de backup, o comando `ghe-backup` será interrompido com uma mensagem de erro, informando a existência de um backup simultâneo. Nesse caso, é recomendável diminuir a frequência dos backups programados. Para obter mais informações, consulte a seção "Agendar backups" do [ arquivo LEIAME do {% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils#scheduling-backups). - -### Restaurar um backup - -Em caso de interrupção prolongada ou evento catastrófico no site primário, é possível restaurar a {% data variables.product.product_location_enterprise %} provisionando outro appliance do {% data variables.product.prodname_enterprise %} e executando uma restauração no host de backup. Antes de restaurar um appliance, você deve adicionar a chave SSH do host de backup ao appliance de destino do {% data variables.product.prodname_enterprise %} como chave SSH autorizada. - -Para restaurar a {% data variables.product.product_location_enterprise %} do instantâneo mais recente bem-sucedido, use o comando `ghe-restore`. Você verá um conteúdo semelhante a este: - -```shell -$ ghe-restore -c 169.154.1.1 -> Verificando chaves vazadas no instantâneo do backup em restauração... -> * Sem chaves vazadas -> Conexão 169.154.1.1:122 OK (v2.9.0) - -> AVISO: todos os dados no appliance GitHub Enterprise 169.154.1.1 (v2.9.0) -> serão substituídos por dados do instantâneo 20170329T150710. -> Antes de prosseguir, confirme se o host de restauração está correto. -> Digite 'sim' para continuar: sim - -> Iniciando restauração de 169.154.1.1:122 a partir do instantâneo 20170329T150710 -# ...saída truncada -> Restauração concluída de 169.154.1.1:122 a partir do instantâneo 20170329T150710 -> Acesse https://169.154.1.1/setup/settings para revisar a configuração do appliance. -``` - -{% note %} - -**Observação:** as configurações de rede são excluídas do instantâneo de backup. Você deve configurar manualmente a rede no appliance de destino do {% data variables.product.prodname_ghe_server %} conforme o seu ambiente. - -{% endnote %} - -Você pode usar estas opções adicionais com o comando `ghe-restore`: -- O sinalizador `-c` substitui as configurações, os certificados e os dados de licença no host de destino, mesmo que já configurado. Omita esse sinalizador se você estiver configurando uma instância de preparo para fins de teste e se quiser manter a configuração no destino. Para obter mais informações, consulte a seção "Usar comandos de backup e restauração" do [LEIAME do {% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils#using-the-backup-and-restore-commands). -- O sinalizador `-s` permite selecionar outro instantâneo de backup. - diff --git a/translations/pt-BR/content/admin/installation/configuring-built-in-firewall-rules.md b/translations/pt-BR/content/admin/installation/configuring-built-in-firewall-rules.md deleted file mode 100644 index 94579ffe4403..000000000000 --- a/translations/pt-BR/content/admin/installation/configuring-built-in-firewall-rules.md +++ /dev/null @@ -1,115 +0,0 @@ ---- -title: Configurar regras de firewall integrado -intro: 'É possível exibir as regras padrão de firewall e personalizar outras regras da {% data variables.product.product_location_enterprise %}.' -redirect_from: - - /enterprise/admin/guides/installation/configuring-firewall-settings/ - - /enterprise/admin/installation/configuring-built-in-firewall-rules -versions: - enterprise-server: '*' ---- - -### Sobre o firewall da {% data variables.product.product_location_enterprise %} - -O {% data variables.product.prodname_ghe_server %} usa o Uncomplicated Firewall (UFW) do Ubuntu no appliance virtual. Para obter mais informações, consulte "[UFW](https://help.ubuntu.com/community/UFW)" na documentação do Ubuntu. O {% data variables.product.prodname_ghe_server %} atualiza automaticamente a lista de desbloqueio de firewall dos serviços permitidos em cada versão. - -Depois da instalação do {% data variables.product.prodname_ghe_server %}, todas as portas de rede necessárias ficam abertas automaticamente para aceitar conexões. As portas desnecessárias são configuradas automaticamente como `deny`, e a política de saída padrão é configurada como `allow`. O rastreamento com estado fica habilitado para novas conexões; em geral, são pacotes de rede com o conjunto de bits `SYN`. Para obter mais informações, consulte "[Portas de rede](/enterprise/admin/guides/installation/network-ports)". - -O firewall UFW também abre várias outras portas necessárias para o funcionamento adequado do {% data variables.product.prodname_ghe_server %}. Para obter mais informações sobre o conjunto de regras do UFW, consulte [o LEIAME do UFW](https://bazaar.launchpad.net/~jdstrand/ufw/0.30-oneiric/view/head:/README#L213). - -### Exibir as regras padrão de firewall - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. Para exibir as regras de firewall padrão, use o comando `sudo ufw status`. Você verá um conteúdo semelhante a este: - ```shell - $ sudo ufw status - > Status: active - > To Action From - > -- ------ ---- - > ghe-1194 ALLOW Anywhere - > ghe-122 ALLOW Anywhere - > ghe-161 ALLOW Anywhere - > ghe-22 ALLOW Anywhere - > ghe-25 ALLOW Anywhere - > ghe-443 ALLOW Anywhere - > ghe-80 ALLOW Anywhere - > ghe-8080 ALLOW Anywhere - > ghe-8443 ALLOW Anywhere - > ghe-9418 ALLOW Anywhere - > ghe-1194 (v6) ALLOW Anywhere (v6) - > ghe-122 (v6) ALLOW Anywhere (v6) - > ghe-161 (v6) ALLOW Anywhere (v6) - > ghe-22 (v6) ALLOW Anywhere (v6) - > ghe-25 (v6) ALLOW Anywhere (v6) - > ghe-443 (v6) ALLOW Anywhere (v6) - > ghe-80 (v6) ALLOW Anywhere (v6) - > ghe-8080 (v6) ALLOW Anywhere (v6) - > ghe-8443 (v6) ALLOW Anywhere (v6) - > ghe-9418 (v6) ALLOW Anywhere (v6) - ``` - -### Adicionar regras personalizadas de firewall - -{% warning %} - -**Aviso:** antes de adicionar regras personalizadas de firewall, faça backup das regras atuais caso você precise voltar a um estado de trabalho conhecido. Se você não conseguir acessar o servidor, entre em contato com o {% data variables.contact.contact_ent_support %} para reconfigurar as regras originais do firewall. Restaurar as regras originais gera tempo de inatividade no servidor. - -{% endwarning %} - -1. Configure uma regra personalizada de firewall. -2. Verifique o status de cada regra com o comando `status numbered`. - ```shell - $ sudo ufw status numbered - ``` -3. Para fazer backup das regras personalizadas de firewall, use o comando `cp` a fim de movê-las para um novo arquivo. - ```shell - $ sudo cp -r /lib/ufw ~/ufw.backup - ``` - -Após a atualização da {% data variables.product.product_location_enterprise %}, você deve reaplicar suas regras personalizadas de firewall. Para isso, é recomendável criar um script. - -### Restaurar as regras padrão de firewall - -Se a alteração das regras do firewall ocasionar erros, você poderá redefinir as regras originais no backup. - -{% warning %} - -**Aviso:** se você não fez backup das regras originais antes de alterar o firewall, entre em contato com o {% data variables.contact.contact_ent_support %} para obter assistência. - -{% endwarning %} - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. Para restaurar as regras de backup anteriores, copie-as de volta para o firewall com o comando `cp`. - ```shell - $ sudo cp -f ~/ufw.backup/*rules /lib/ufw - ``` -3. Reinicie o firewall com o comando `systemctl`. - ```shell - $ sudo systemctl restart ufw - ``` -4. Confirme a retomada das regras padrão com o comando `ufw status`. - ```shell - $ sudo ufw status - > Status: active - > To Action From - > -- ------ ---- - > ghe-1194 ALLOW Anywhere - > ghe-122 ALLOW Anywhere - > ghe-161 ALLOW Anywhere - > ghe-22 ALLOW Anywhere - > ghe-25 ALLOW Anywhere - > ghe-443 ALLOW Anywhere - > ghe-80 ALLOW Anywhere - > ghe-8080 ALLOW Anywhere - > ghe-8443 ALLOW Anywhere - > ghe-9418 ALLOW Anywhere - > ghe-1194 (v6) ALLOW Anywhere (v6) - > ghe-122 (v6) ALLOW Anywhere (v6) - > ghe-161 (v6) ALLOW Anywhere (v6) - > ghe-22 (v6) ALLOW Anywhere (v6) - > ghe-25 (v6) ALLOW Anywhere (v6) - > ghe-443 (v6) ALLOW Anywhere (v6) - > ghe-80 (v6) ALLOW Anywhere (v6) - > ghe-8080 (v6) ALLOW Anywhere (v6) - > ghe-8443 (v6) ALLOW Anywhere (v6) - > ghe-9418 (v6) ALLOW Anywhere (v6) - ``` diff --git a/translations/pt-BR/content/admin/installation/configuring-collectd.md b/translations/pt-BR/content/admin/installation/configuring-collectd.md deleted file mode 100644 index 2c9bb6103ca7..000000000000 --- a/translations/pt-BR/content/admin/installation/configuring-collectd.md +++ /dev/null @@ -1,57 +0,0 @@ ---- -title: Configurar collectd -intro: 'O {% data variables.product.prodname_enterprise %} pode coletar dados com `collectd` e enviá-los para um servidor externo `collectd`. Reunimos um conjunto padrão de dados e outras métricas, como uso de CPU, consumo de memória e disco, tráfego e erros da interface de rede e carga geral da VM.' -redirect_from: - - /enterprise/admin/articles/configuring-collectd/ - - /enterprise/admin/installation/configuring-collectd -versions: - enterprise-server: '*' ---- - -### Configurar um servidor externo `collectd` - -Se você ainda não configurou um servidor externo `collectd`, será preciso fazê-lo antes de ativar o encaminhamento `collectd` na {% data variables.product.product_location_enterprise %}. Seu servidor `collectd` deve ser configurado executando uma versão `collectd` 5.x ou mais recente. - -1. Faça login no servidor `collectd`. -2. Crie ou edite o arquivo de configuração `collectd` para carregar o plugin de rede e preencher as diretivas de servidor e porta com os valores adequados. Na maioria das distribuições, esses dados ficam em `/etc/collectd/collectd.conf` - -Exemplo de *collectd.conf* para executar um servidor `collectd`: - - LoadPlugin network - ... - ... - - Listen "0.0.0.0" "25826" - - -### Habilitar o encaminhamento collectd no {% data variables.product.prodname_enterprise %} - -Por padrão, o encaminhamento `collectd` fica desabilitado no {% data variables.product.prodname_enterprise %}. Siga as etapas abaixo para habilitar e configurar o encaminhamento `collectd`: - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -1. Abaixo das configurações de encaminhamento de log, selecione **Enable collectd forwarding** (Habilitar encaminhamento collectd). -1. No campo **Server address** (Endereço do servidor), digite o endereço do servidor `collectd` para o qual você deseja encaminhar as estatísticas do appliance do {% data variables.product.prodname_enterprise %}. -1. No campo **Port** (Porta), digite a porta usada para conexão com o servidor `collectd` (o padrão é 25826). -1. No menu suspenso **Cryptographic setup** (Configuração criptográfica), selecione o nível de segurança das comunicações com o servidor `collectd` (nenhum, pacotes assinados ou pacotes criptografados). -{% data reusables.enterprise_management_console.save-settings %} - -### Exportar dados coletados com `ghe-export-graphs` - -A ferramenta de linha de comando `ghe-export-graphs` exportará os dados que `collectd` armazenar em bancos de dados RRD. O comando transforma os dados em XML e os exporta para um único tarball (.tgz). - -Seu uso principal é fornecer à equipe do {% data variables.contact.contact_ent_support %} dados sobre o desempenho de uma VM sem que seja necessário baixar um pacote de suporte completo. Ele não deve ser incluído nas exportações de backup regulares e não há contrapartida de importação. Se você entrar em contato com o {% data variables.contact.contact_ent_support %} para fins de solução de problemas, esses dados podem ser solicitados. - -#### Uso - -```shell -ssh -p 122 admin@[hostname] -- 'ghe-export-graphs' && scp -P 122 admin@[hostname]:~/graphs.tar.gz . -``` - -### Solução de Problemas - -#### Central do servidor collectd não recebe dados - -O envios do {% data variables.product.prodname_enterprise %} com `collectd` versão 5.x. `collectd` 5.x não são compatíveis com a série das versões 4.x. Seu servidor central `collectd` precisa ser da versão 5.x para aceitar os dados enviados pela {% data variables.product.product_location_enterprise %}. - -Em caso de dúvidas ou perguntas, entre em contato com o {% data variables.contact.contact_ent_support %}. diff --git a/translations/pt-BR/content/admin/installation/configuring-dns-nameservers.md b/translations/pt-BR/content/admin/installation/configuring-dns-nameservers.md deleted file mode 100644 index a927c0a624bc..000000000000 --- a/translations/pt-BR/content/admin/installation/configuring-dns-nameservers.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: Configurar servidores de nomes DNS -intro: 'O {% data variables.product.prodname_ghe_server %} usa o protocolo de configuração dinâmica de host (DHCP) para configurações de DNS quando as concessões de DHCP fornecem servidores de nomes. Se os servidores de nomes não forem fornecidos por uma concessão do protocolo DHCP, ou caso você precise usar configurações DNS específicas, será possível especificá-los manualmente.' -redirect_from: - - /enterprise/admin/guides/installation/about-dns-nameservers/ - - /enterprise/admin/installation/configuring-dns-nameservers -versions: - enterprise-server: '*' ---- - -Os servidores de nomes que você especificar devem resolver o nome de host da {% data variables.product.product_location_enterprise %}. - -{% data reusables.enterprise_installation.changing-hostname-not-supported %} - -### Configurar servidores de nomes usando o console de máquina virtual - -{% data reusables.enterprise_installation.open-vm-console-start %} -2. Configure os servidores de nomes da sua instância. -{% data reusables.enterprise_installation.vm-console-done %} - -### Configurar servidores de nomes usando o shell administrativo - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. Para editar seus servidores de nomes, insira: - ```shell - $ sudo vim /etc/resolvconf/resolv.conf.d/head - ``` -3. Adicione quaisquer entradas `nameserver` e salve o arquivo. -4. Depois de verificar suas alterações, salve o arquivo. -5. Para adicionar suas novas entradas de servidor de nomes à {% data variables.product.product_location_enterprise %}, insira: - ```shell - $ sudo service resolvconf restart - ``` diff --git a/translations/pt-BR/content/admin/installation/configuring-git-large-file-storage-on-github-enterprise-server.md b/translations/pt-BR/content/admin/installation/configuring-git-large-file-storage-on-github-enterprise-server.md deleted file mode 100644 index 669edcb2112c..000000000000 --- a/translations/pt-BR/content/admin/installation/configuring-git-large-file-storage-on-github-enterprise-server.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Configurar o Git Large File Storage no GitHub Enterprise Server -intro: '{% data reusables.enterprise_site_admin_settings.configuring-large-file-storage-short-description %}' -redirect_from: - - /enterprise/admin/guides/installation/configuring-git-large-file-storage-on-github-enterprise/ - - /enterprise/admin/installation/configuring-git-large-file-storage-on-github-enterprise-server -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/pt-BR/content/admin/installation/configuring-git-large-file-storage-to-use-a-third-party-server.md b/translations/pt-BR/content/admin/installation/configuring-git-large-file-storage-to-use-a-third-party-server.md deleted file mode 100644 index 037bf393ab15..000000000000 --- a/translations/pt-BR/content/admin/installation/configuring-git-large-file-storage-to-use-a-third-party-server.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: Configurar o Git Large File Storage para uso em servidores de terceiros -intro: 'É possível usar o {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) em um servidor de terceiros desabilitando o {% data variables.large_files.product_name_short %} no appliance do {% data variables.product.prodname_ghe_server %} e configurando o cliente {% data variables.large_files.product_name_short %} com a URL do servidor em que você pretende armazenar os ativos de grande volume.' -redirect_from: - - /enterprise/admin/installation/configuring-git-large-file-storage-to-use-a-third-party-server -versions: - enterprise-server: '*' ---- - -{% data reusables.large_files.storage_assets_location %} -{% data reusables.large_files.rejected_pushes %} - -1. Desabilite o appliance do {% data variables.large_files.product_name_short %} no {% data variables.product.prodname_ghe_server %}. Para obter mais informações, consulte "[Configurar o {% data variables.large_files.product_name_long %}](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-git-large-file-storage#configuring-git-large-file-storage-for-your-appliance)". - -2. Crie um arquivo de configuração do {% data variables.large_files.product_name_short %} que aponte para o servidor de terceiros. - ```shell - # Show default configuration - $ git lfs env - > git-lfs/1.1.0 (GitHub; darwin amd64; go 1.5.1; git 94d356c) - > git version 2.7.4 (Apple Git-66) -   - > Endpoint=https://GITHUB-ENTERPRISE-HOST/path/to/repo/info/lfs (auth=basic) -   - # Create .lfsconfig that points to third party server. - $ git config -f .lfsconfig remote.origin.lfsurl https://THIRD-PARTY-LFS-SERVER/path/to/repo - $ git lfs env - > git-lfs/1.1.0 (GitHub; darwin amd64; go 1.5.1; git 94d356c) - > git version 2.7.4 (Apple Git-66) -   - > Endpoint=https://THIRD-PARTY-LFS-SERVER/path/to/repo/info/lfs (auth=none) -   - # Show the contents of .lfsconfig - $ cat .lfsconfig - [remote "origin"] - lfsurl = https://THIRD-PARTY-LFS-SERVER/path/to/repo - ``` - -3. Para manter a mesma configuração do {% data variables.large_files.product_name_short %} em todos os usuários, faça commit de um arquivo `.lfsconfig` personalizado no repositório. - ```shell - $ git add .lfsconfig - $ git commit -m "Adding LFS config file" - ``` -3. Migre qualquer ativo do {% data variables.large_files.product_name_short %}. Para obter mais informações, consulte "[Migrar para outro servidor do {% data variables.large_files.product_name_long %}](/enterprise/{{ currentVersion }}/admin/guides/installation/migrating-to-a-different-git-large-file-storage-server)". - -### Further reading - -- [Sobre o {% data variables.large_files.product_name_long %}](/articles/about-git-large-file-storage/) -- [Configurar o {% data variables.large_files.product_name_long %}](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-git-large-file-storage) -- [Migrar para outro servidor do {% data variables.large_files.product_name_long %}](/enterprise/{{ currentVersion }}/admin/guides/installation/migrating-to-a-different-git-large-file-storage-server) -- [Site de projeto do {% data variables.large_files.product_name_long %}](https://git-lfs.github.com/) diff --git a/translations/pt-BR/content/admin/installation/configuring-git-large-file-storage.md b/translations/pt-BR/content/admin/installation/configuring-git-large-file-storage.md deleted file mode 100644 index 282620533bf4..000000000000 --- a/translations/pt-BR/content/admin/installation/configuring-git-large-file-storage.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: Configurar o GitLarge File Storage -intro: 'Assim que o [{% data variables.large_files.product_name_short %} estiver instalado](/articles/installing-git-large-file-storage/), você precisará associá-lo a um arquivo grande no seu repositório.' -redirect_from: - - /enterprise/admin/articles/configuring-git-large-file-storage-for-a-repository/ - - /enterprise/admin/articles/configuring-git-large-file-storage-for-every-repository-owned-by-a-user-account-or-organization/ - - /enterprise/admin/articles/configuring-git-large-file-storage-for-your-appliance/ - - /enterprise/admin/installation/configuring-git-large-file-storage -versions: - enterprise-server: '*' ---- - -### Sobre o {% data variables.large_files.product_name_long %} - -{% data reusables.enterprise_site_admin_settings.configuring-large-file-storage-short-description %} Você pode usar o {% data variables.large_files.product_name_long %} com um único repositório, com todos os seus repositórios pessoais ou da organização, ou com todos os repositórios na {% data variables.product.product_location_enterprise %}. Antes de poder habilitar o {% data variables.large_files.product_name_short %} para repositórios ou organizações específicos, é necessário habilitar o {% data variables.large_files.product_name_short %} no appliance. - -{% data reusables.large_files.storage_assets_location %} -{% data reusables.large_files.rejected_pushes %} - -Para obter mais informações, consulte "[Sobre o {% data variables.large_files.product_name_long %}](/articles/about-git-large-file-storage)", "[Controlar versões em arquivos grandes](/enterprise/user/articles/versioning-large-files/)" e acesse o [site do projeto do {% data variables.large_files.product_name_long %}](https://git-lfs.github.com/). - -### Configurar o {% data variables.large_files.product_name_long %} no appliance - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -4. No menu suspenso em "{% data variables.large_files.product_name_short %} access" (Acesso ao {% data variables.large_files.product_name_short %}), clique em **Enabled** (Habilitado) ou **Disabled** (Desabilitado). ![Acesso ao Git LFS](/assets/images/enterprise/site-admin-settings/git-lfs-admin-center.png) - -### Configurar o {% data variables.large_files.product_name_long %} em um repositório específico - -{% data reusables.enterprise_site_admin_settings.override-policy %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -{% data reusables.enterprise_site_admin_settings.git-lfs-toggle %} - -### Configurar o {% data variables.large_files.product_name_long %} para cada repositório pertencente a uma conta ou organização - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.search-user-or-org %} -{% data reusables.enterprise_site_admin_settings.click-user-or-org %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -{% data reusables.enterprise_site_admin_settings.git-lfs-toggle %} diff --git a/translations/pt-BR/content/admin/installation/configuring-github-enterprise-server-for-high-availability.md b/translations/pt-BR/content/admin/installation/configuring-github-enterprise-server-for-high-availability.md deleted file mode 100644 index 7b9a56078d3d..000000000000 --- a/translations/pt-BR/content/admin/installation/configuring-github-enterprise-server-for-high-availability.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: Configurar o GitHub Enterprise Server para alta disponibilidade -redirect_from: - - /enterprise/admin/guides/installation/high-availability-cluster-configuration/ - - /enterprise/admin/guides/installation/high-availability-configuration/ - - /enterprise/admin/guides/installation/configuring-github-enterprise-for-high-availability/ - - /enterprise/admin/installation/configuring-github-enterprise-server-for-high-availability -intro: 'O {% data variables.product.prodname_ghe_server %} dá suporte ao modo de alta disponibilidade da operação visando minimizar o tempo de inatividade do serviço em caso de falha de hardware ou interrupção prolongada da rede.' -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/pt-BR/content/admin/installation/configuring-github-pages-on-your-appliance.md b/translations/pt-BR/content/admin/installation/configuring-github-pages-on-your-appliance.md deleted file mode 100644 index 6e081434bc4a..000000000000 --- a/translations/pt-BR/content/admin/installation/configuring-github-pages-on-your-appliance.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: Configurar o GitHub Pages no appliance -intro: 'É possível habilitar ou desabilitar o {% data variables.product.prodname_pages %} na instância. Você pode deixar os sites do {% data variables.product.prodname_pages %} acessíveis publicamente.' -redirect_from: - - /enterprise/admin/guides/installation/disabling-github-enterprise-pages/ - - /enterprise/admin/guides/installation/configuring-github-enterprise-pages/ - - /enterprise/admin/installation/configuring-github-pages-on-your-appliance -versions: - enterprise-server: '*' ---- - -### Deixar os sites do {% data variables.product.prodname_pages %} acessíveis publicamente - -Se o modo privado estiver habilitado na instância, o público não poderá acessar os sites do {% data variables.product.prodname_pages %} hospedados na {% data variables.product.product_location_enterprise %}. - -{% warning %} - -**Aviso:** se você habilitar os sites públicos do {% data variables.product.prodname_pages %}, todos os sites do {% data variables.product.prodname_pages %} em todos os repositórios da sua instância ficarão acessíveis para o público. - -{% endwarning %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.pages-tab %} -4. Selecione **Public Pages** (Pages público). ![Caixa de seleção para deixar o Pages acessível publicamente](/assets/images/enterprise/management-console/public-pages-checkbox.png) -{% data reusables.enterprise_management_console.save-settings %} - -### Desabilitar o {% data variables.product.prodname_pages %} na {% data variables.product.product_location_enterprise %} - -Se o isolamento de subdomínio estiver desabilitado para a {% data variables.product.product_location_enterprise %}, você também deve desabilitar o {% data variables.product.prodname_pages %} para se proteger de possíveis vulnerabilidades de segurança. Para obter mais informações, consulte "[Habilitar isolamento de subdomínio](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-subdomain-isolation)". - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.pages-tab %} -4. Desmarque a seleção na caixa **Enable Pages** (Habilitar Pages). ![Caixa de seleção para desabilitar o{% data variables.product.prodname_pages %}](/assets/images/enterprise/management-console/pages-select-button.png) -{% data reusables.enterprise_management_console.save-settings %} - -### Leia mais - -- [Habilitar modo privado](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-private-mode) diff --git a/translations/pt-BR/content/admin/installation/configuring-rate-limits.md b/translations/pt-BR/content/admin/installation/configuring-rate-limits.md deleted file mode 100644 index 8aa12e32eb05..000000000000 --- a/translations/pt-BR/content/admin/installation/configuring-rate-limits.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: Configurar limites de taxa -intro: 'É possível definir limites de taxa no {% data variables.product.prodname_ghe_server %} usando o {% data variables.enterprise.management_console %}.' -redirect_from: - - /enterprise/admin/installation/configuring-rate-limits -versions: - enterprise-server: '*' ---- - -### Habilitar limites de taxa para a {% data variables.product.prodname_enterprise_api %} - -Habilitar limites de taxa na {% data variables.product.prodname_enterprise_api %} pode impedir o uso excessivo de recursos por usuários individuais ou não autenticados. Para obter mais informações, consulte "[Limitação de taxa](/enterprise/{{ currentVersion }}/v3/#rate-limiting)". - -{% note %} - -**Observação:** o {% data variables.enterprise.management_console %} lista o período (por minuto ou hora) para cada limite de taxa. - -{% endnote %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -2. Em "Limites de taxa", selecione **Enable API Rate Limiting** (Habilitar limite de taxa da API). ![Caixa de seleção para habilitar limite de taxas de API](/assets/images/enterprise/management-console/api-rate-limits-checkbox.png) -3. Informe os limites para solicitações autenticadas e não autenticadas de cada API ou aceite os limites padrão sugeridos. -{% data reusables.enterprise_management_console.save-settings %} - -### Habilitar limites de taxa de abuso - -Definir limites de taxa de abuso protege o nível geral de serviço na {% data variables.product.product_location_enterprise %}. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -2. Em "Limites de taxa", selecione **Enable Abuse Rate Limiting** (Habilitar limite de taxa de abuso). ![Caixa de seleção para habilitar limite de taxas de abuso](/assets/images/enterprise/management-console/abuse-rate-limits-checkbox.png) -3. Informe os limites para Solicitações totais, Limite de CPU e Limite de CPU para pesquisa ou aceite os limites padrão sugeridos. -{% data reusables.enterprise_management_console.save-settings %} - -### Habilitar limites de taxa do Git - -É possível aplicar limites de taxa do Git por rede de repositório ou ID do usuário. Os limites da taxa do Git são expressos em operações simultâneas por minuto e são adaptáveis com base na carga atual da CPU. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -2. Em "Rate Limiting" (Limites de taxa), selecione **Enable Git Rate Limiting** (Habilitar limite de taxa do Git). ![Caixa de seleção para habilitar limite de taxas do Git](/assets/images/enterprise/management-console/git-rate-limits-checkbox.png) -3. Digite limites para cada rede de repositório ou ID do usuário. ![Campos para limites de rede de repositório e ID do usuário](/assets/images/enterprise/management-console/example-git-rate-limits.png) -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/pt-BR/content/admin/installation/configuring-the-default-visibility-of-new-repositories-on-your-appliance.md b/translations/pt-BR/content/admin/installation/configuring-the-default-visibility-of-new-repositories-on-your-appliance.md deleted file mode 100644 index 1332c68f6e95..000000000000 --- a/translations/pt-BR/content/admin/installation/configuring-the-default-visibility-of-new-repositories-on-your-appliance.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: Configurar a visibilidade padrão de novos repositórios no appliance -intro: 'Você pode definir a visibilidade padrão de todos os repositórios criados pela interface da web no appliance do {% data variables.product.prodname_ghe_server %} como privada ou pública.' -redirect_from: - - /enterprise/admin/installation/configuring-the-default-visibility-of-new-repositories-on-your-appliance -versions: - enterprise-server: '*' ---- - -Cada vez que alguém criar um novo repositório no {% data variables.product.product_location_enterprise %}, essa pessoa deve escolher uma visibilidade para o repositório. Ao optar por uma configuração de visibilidade padrão para a instância, você escolhe qual visibilidade será selecionada por padrão. Para obter mais informações sobre a visibilidade de repositório, consulte "[Sobre a visibilidade do repositório](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)". - -Se um administrador do site impedir que os membros criem certos tipos de repositórios, os membros não serão capazes de criar esse tipo de repositório, mesmo se a configuração de visibilidade for padrão para esse tipo. Para obter mais informações, consulte "[Restringir a criação de repositórios na instância](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)". - -{% tip %} - -**Dica:** é possível restringir a capacidade de alterar a visibilidade do repositório apenas a administradores do site. Para obter mais informações, consulte "[Impedir os usuários de alterarem a visibilidade do repositório](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-a-repository-s-visibility)". - -{% endnote %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -1. Em "Default repository visibility" (Visibilidade padrão do repositório), clique no menu suspenso e selecione uma visibilidade padrão.![Menu suspenso para definir a visibilidade padrão do repositório da instância](/assets/images/enterprise/site-admin-settings/default-repository-visibility-settings.png) - -{% data reusables.enterprise_installation.image-urls-viewable-warning %} diff --git a/translations/pt-BR/content/admin/installation/configuring-the-github-enterprise-server-appliance.md b/translations/pt-BR/content/admin/installation/configuring-the-github-enterprise-server-appliance.md deleted file mode 100644 index 1f2f7b00ad59..000000000000 --- a/translations/pt-BR/content/admin/installation/configuring-the-github-enterprise-server-appliance.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: Configurar o appliance do GitHub Enterprise Server -intro: 'Quando o {% data variables.product.prodname_ghe_server %} estiver pronto para uso, você poderá configurar o appliance conforme as demandas da sua organização.' -redirect_from: - - /enterprise/admin/guides/installation/basic-configuration/ - - /enterprise/admin/guides/installation/administrative-tools/ - - /enterprise/admin/articles/restricting-ssh-access-to-specific-hosts/ - - /enterprise/admin/guides/installation/configuring-the-github-enterprise-appliance/ - - /enterprise/admin/installation/configuring-the-github-enterprise-server-appliance -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/pt-BR/content/admin/installation/configuring-the-ip-address-using-the-virtual-machine-console.md b/translations/pt-BR/content/admin/installation/configuring-the-ip-address-using-the-virtual-machine-console.md deleted file mode 100644 index 95f0cc2422ab..000000000000 --- a/translations/pt-BR/content/admin/installation/configuring-the-ip-address-using-the-virtual-machine-console.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: Configurar endereço IP usando o console de máquina virtual -intro: 'Por padrão, o {% data variables.product.prodname_ghe_server %} recupera as configurações de rede pelo protocolo de configuração dinâmica de host (DHCP). Se a sua plataforma for compatível ou se o DHCP estiver indisponível, você também poderá definir as configurações de rede usando o console da máquina virtual.' -redirect_from: - - /enterprise/admin/installation/configuring-the-ip-address-using-the-virtual-machine-console -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_installation.open-vm-console-start %} -3. Escolha configurar o protocolo `IPv4` ou `IPv6`. ![Escolha entre os protocolos IPv4 ou IPv6](/assets/images/enterprise/network-configuration/IPv4-or-IPv6-protocol.png) -4. Configure as opções para o protocolo escolhido. ![Menu com opções de protocolo IP](/assets/images/enterprise/network-configuration/network-settings-selection.png) -{% data reusables.enterprise_installation.vm-console-done %} diff --git a/translations/pt-BR/content/admin/installation/configuring-time-synchronization.md b/translations/pt-BR/content/admin/installation/configuring-time-synchronization.md deleted file mode 100644 index 798f7fe7a404..000000000000 --- a/translations/pt-BR/content/admin/installation/configuring-time-synchronization.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: Configurar a sincronização de hora -intro: 'O {% data variables.product.prodname_ghe_server %} sincroniza automaticamente o relógio conectando-se a servidores NTP. Você pode definir os servidores NTP usados para sincronizar o relógio ou pode usar os servidores NTP padrão.' -redirect_from: - - /enterprise/admin/articles/adjusting-the-clock/ - - /enterprise/admin/articles/configuring-time-zone-and-ntp-settings/ - - /enterprise/admin/articles/setting-ntp-servers/ - - /enterprise/admin/categories/time/ - - /enterprise/admin/installation/configuring-time-synchronization -versions: - enterprise-server: '*' ---- - -### Alterar os servidores NTP padrão - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -2. Na barra lateral esquerda, clique em **Time** (Hora). ![Botão Time (Hora) na barra lateral do {% data variables.enterprise.management_console %}](/assets/images/enterprise/management-console/sidebar-time.png) -3. Em "Primary NTP server" (Servidor NTP primário), digite o nome do host do servidor NTP primário. Em "Secondary NTP server" (Servidor NTP secundário), digite o nome do host do servidor NTP secundário. ![Campos de servidores NTP primário e secundário no {% data variables.enterprise.management_console %}](/assets/images/enterprise/management-console/ntp-servers.png) -4. Na parte inferior da página, clique em **Save settings** (Salvar configurações). ![Botão Save settings (Salvar configurações) no {% data variables.enterprise.management_console %}](/assets/images/enterprise/management-console/save-settings.png) -5. Aguarde a conclusão da execução de suas configurações. - -### Corrigir descompassos de tempo - -O protocolo NTP corrige continuamente pequenas discrepâncias de sincronização de tempo. Você pode usar o shell administrativo para sincronizar a hora de imediato. - -{% note %} - -**Notas:** - - Você não pode modificar o Tempo Universal Coordenado (UTC); - - Você deve impedir seu hipervisor de tentar configurar o relógio da máquina virtual. Para obter mais informações, consulte a documentação fornecida pelo provedor de virtualização. - -{% endnote %} - -- Use o comando `chronyc` para sincronizar seu servidor com o servidor NTP configurado. Como por exemplo: - -```shell -$ sudo chronyc -a makestep -``` diff --git a/translations/pt-BR/content/admin/installation/configuring-tls.md b/translations/pt-BR/content/admin/installation/configuring-tls.md deleted file mode 100644 index 94509257cd55..000000000000 --- a/translations/pt-BR/content/admin/installation/configuring-tls.md +++ /dev/null @@ -1,69 +0,0 @@ ---- -title: Configurar o TLS -intro: 'Você pode configurar o protocolo de Segurança de Camada de Transporte (TLS, Transport Layer Security) na {% data variables.product.product_location_enterprise %} para uso de certificados assinados por uma autoridade de certificação confiável.' -redirect_from: - - /enterprise/admin/articles/ssl-configuration/ - - /enterprise/admin/guides/installation/about-tls/ - - /enterprise/admin/installation/configuring-tls -versions: - enterprise-server: '*' ---- - -### Sobre o protocolo Transport Layer Security - -O TLS, protocolo que substituiu o SSL, fica habilitado e configurado com um certificado autoassinado quando o {% data variables.product.prodname_ghe_server %} é iniciado pela primeira vez. Como os certificados autoassinados não são considerados confiáveis por navegadores da web e clientes Git, esses clientes reportarão avisos de certificados até você desabilitar o TLS ou fazer upload de um certificado assinado por uma autoridade confiável, como o Let's Encrypt. - -O appliance do {% data variables.product.prodname_ghe_server %} enviará os headers de HTTP Strict Transport Security quando o SSL for habilitado. Desabilitar o TLS fará os usuários perderem o acesso ao appliance, pois seus navegadores não permitirão o downgrade de protocolo para HTTP. Para obter mais informações, consulte "[HTTP Strict Transport Security (HSTS)](https://en.wikipedia.org/wiki/HTTP_Strict_Transport_Security)" na Wikipedia. - -{% data reusables.enterprise_installation.terminating-tls %} - -Para permitir o uso do FIDO U2F para autenticação de dois fatores, você deve habilitar o TLS na sua instância. Para obter mais informações, consulte "[Configurar a autenticação de dois fatores](/articles/configuring-two-factor-authentication)". - -### Pré-requisitos - -Para usar o TLS em produção, você deve ter um certificado em formato PEM não criptografado assinado por uma autoridade de certificação confiável. - -Seu certificado também precisará de nomes alternativos da entidade (SAN, Subject Alternative Names) configurados para os subdomínios listados em "[Habilitar isolamento de subdomínio](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-subdomain-isolation#about-subdomain-isolation)" e deverá incluir a cadeia completa de certificados, caso tenha sido assinado por uma autoridade de certificação intermediária. Para obter mais informações, consulte "[Subject Alternative Name](http://en.wikipedia.org/wiki/SubjectAltName)" na Wikipedia. - -Você pode gerar uma solicitação de assinatura de certificado (CSR, Certificate Signing Request) para sua instância usando o comando `ghe-ssl-generate-csr`. Para obter mais informações, consulte "[Utilitários de linha de comando](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities/#ghe-ssl-generate-csr)". - -### Fazer upload de um certificado TLS personalizado - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -{% data reusables.enterprise_management_console.select-tls-only %} -4. Em "TLS Protocol support" (Suporte ao protocolo TLS), selecione os protocolos que deseja permitir. ![Botões com opções de protocolos TLS](/assets/images/enterprise/management-console/tls-protocol-support.png) -5. Em "Certificate" (Certificado), clique em **Choose File** (Escolher arquivo) para escolher um certificado TLS ou uma cadeia de certificados (no formato PEM) para instalação. Em geral, esse arquivo tem extensão *.pem*, *.crt* ou *.cer*. ![Botão para localizar arquivo de certificado TLS](/assets/images/enterprise/management-console/install-tls-certificate.png) -6. Em "Unencrypted key" (Chave não criptografada), clique em **Choose File** (Escolher arquivo) para escolher a chave TLS (em formato PEM) para instalação. Em geral, esse arquivo tem extensão *.key*. ![Botão para localizar arquivo de chave TLS](/assets/images/enterprise/management-console/install-tls-key.png) - - {% warning %} - - **Aviso**: a chave TLS não deve ter frase secreta. Para obter mais informações, consulte "[Remover a frase secreta de um arquivo de chave](/enterprise/{{ currentVersion }}/admin/guides/installation/troubleshooting-ssl-errors#removing-the-passphrase-from-your-key-file)". - - {% endwarning %} -{% data reusables.enterprise_management_console.save-settings %} - -### Sobre o suporte Let's Encrypt - -Let's Encrypt é uma autoridade de certificação pública que emite certificados TLS gratuitos, automatizados e reconhecidos como confiáveis pelos navegadores usando o protocolo ACME. Você pode obter e renovar automaticamente os certificados Let's Encrypt no seu appliance sem depender de manutenção manual. - -{% data reusables.enterprise_installation.lets-encrypt-prerequisites %} - -Ao habilitar a automação do gerenciamento de certificados TLS usando o Let's Encrypt, sua {% data variables.product.product_location_enterprise %} entrará em contato com os servidores do Let's Encrypt para obter um certificado. Para renovar um certificado, os servidores do Let's Encrypt devem validar o controle do nome de domínio configurado com solicitações HTTP de entrada. - -Você também pode usar o utilitário de linha de comando `ghe-ssl-acme` na {% data variables.product.product_location_enterprise %} para gerar automaticamente um certificado Let's Encrypt. Para obter mais informações, consulte "[Utilitários de linha de comando](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities#ghe-ssl-acme)". - -### Configurar o TLS usando Let's Encrypt - -{% data reusables.enterprise_installation.lets-encrypt-prerequisites %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -{% data reusables.enterprise_management_console.select-tls-only %} -5. Selecione **Enable automation of TLS certificate management using Let's Encrypt** (Habilitar a automação do gerenciamento de certificados TLS com Let's Encrypt). ![Caixa de seleção para habilitar Let's Encrypt](/assets/images/enterprise/management-console/lets-encrypt-checkbox.png) -{% data reusables.enterprise_management_console.save-settings %} -{% data reusables.enterprise_management_console.privacy %} -7. Clique em **Request TLS certificate** (Solicitar certificado TSL). ![Botão Request TLS certificate (Solicitar certificado TSL)](/assets/images/enterprise/management-console/request-tls-button.png) -8. Clique em **Save configuration** (Salvar configuração). diff --git a/translations/pt-BR/content/admin/installation/configuring-your-github-enterprise-server-network-settings.md b/translations/pt-BR/content/admin/installation/configuring-your-github-enterprise-server-network-settings.md deleted file mode 100644 index 6146568303e4..000000000000 --- a/translations/pt-BR/content/admin/installation/configuring-your-github-enterprise-server-network-settings.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: Definir as configurações de rede do GitHub Enterprise Server -redirect_from: - - /enterprise/admin/guides/installation/dns-hostname-subdomain-isolation-and-ssl/ - - /enterprise/admin/articles/about-dns-ssl-and-subdomain-settings/ - - /enterprise/admin/articles/configuring-dns-ssl-and-subdomain-settings/ - - /enterprise/admin/guides/installation/configuring-your-github-enterprise-network-settings/ - - /enterprise/admin/installation/configuring-your-github-enterprise-server-network-settings -intro: 'Configure o {% data variables.product.prodname_ghe_server %} com os nomes de host e servidores de nomes DNS obrigatórios na sua rede. Você também pode configurar um servidor proxy ou regras de firewall. Para fins administrativos e de usuário, é preciso permitir o acesso a determinadas portas.' -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/pt-BR/content/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud.md b/translations/pt-BR/content/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud.md deleted file mode 100644 index f772dcc4d720..000000000000 --- a/translations/pt-BR/content/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud.md +++ /dev/null @@ -1,62 +0,0 @@ ---- -title: Conectar o GitHub Enterprise Server ao GitHub Enterprise Cloud -intro: 'Ao habilitar o {% data variables.product.prodname_github_connect %}, você poderá compartilhar recursos e fluxos de trabalho específicos entre a {% data variables.product.product_location_enterprise %} e o {% data variables.product.prodname_ghe_cloud %}.' -redirect_from: - - /enterprise/admin/guides/developer-workflow/connecting-github-enterprise-to-github-com/ - - /enterprise/admin/guides/developer-workflow/connecting-github-enterprise-server-to-github-com - - /enterprise/admin/developer-workflow/connecting-github-enterprise-server-to-githubcom/ - - /enterprise/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud -permissions: 'Administradores de sites para {% data variables.product.prodname_ghe_server %} que também são proprietários de uma conta corporativa ou organização do {% data variables.product.prodname_ghe_cloud %} podem ativar {% data variables.product.prodname_github_connect %}.' -versions: - enterprise-server: '*' ---- - -### Sobre o {% data variables.product.prodname_github_connect %} - -Para habilitar o {% data variables.product.prodname_github_connect %}, você deve configurar a conexão na {% data variables.product.product_location_enterprise %} e na sua organização do {% data variables.product.prodname_ghe_cloud %} ou na conta corporativa. - -Para configurar uma conexão, sua configuração de proxy deve permitir conectividade com o `github.com` e o `api.github.com`. Para obter mais informações, consulte "[Configurar servidor proxy web de saída](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-an-outbound-web-proxy-server)". - -Após habilitar o {% data variables.product.prodname_github_connect %}, você poderá ativar recursos como a pesquisa unificada e as contribuições unificadas. Para obter mais informações sobre todos os recursos disponíveis, consulte "[Gerenciar conexões entre o {% data variables.product.prodname_ghe_server %} e o {% data variables.product.prodname_ghe_cloud %}](/enterprise/{{ currentVersion }}/admin/installation/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud)". - -Ao conectar a {% data variables.product.product_location_enterprise %} ao {% data variables.product.prodname_ghe_cloud %}, um registro no {% data variables.product.prodname_dotcom_the_website %} armazena as informações sobre a conexão: -- A parte da chave pública da sua licença do {% data variables.product.prodname_ghe_server %}; -- Um hash da sua licença do {% data variables.product.prodname_ghe_server %}; -- O nome do cliente da sua licença do {% data variables.product.prodname_ghe_server %}; -- O nome de host da {% data variables.product.product_location_enterprise %}; -- A versão da {% data variables.product.product_location_enterprise %}; -- A conta corporativa ou organização no {% data variables.product.prodname_dotcom_the_website %} conectada à {% data variables.product.product_location_enterprise %}; -- O token de autenticação usado pela {% data variables.product.product_location_enterprise %} para fazer solicitações ao {% data variables.product.prodname_dotcom_the_website %}. - -Habilitar o {% data variables.product.prodname_github_connect %} também cria um {% data variables.product.prodname_github_app %} pertencente à sua conta corporativa ou organização do {% data variables.product.prodname_ghe_cloud %}. O {% data variables.product.prodname_ghe_server %} usa as credenciais do {% data variables.product.prodname_github_app %} para fazer solicitações ao {% data variables.product.prodname_dotcom_the_website %}. - -O {% data variables.product.prodname_ghe_server %} armazena as credenciais do {% data variables.product.prodname_github_app %}. Essas credenciais serão replicadas em qualquer ambiente de clustering ou alta disponibilidade e serão armazenadas em qualquer backup, inclusive os instantâneos criados pelo {% data variables.product.prodname_enterprise_backup_utilities %}. -- Um token de autenticação válido por uma hora; -- Uma chave privada usada para gerar um novo token de autenticação. - -Habilitar o {% data variables.product.prodname_github_connect %} não permitirá que os usuários do {% data variables.product.prodname_dotcom_the_website %} façam alterações no {% data variables.product.prodname_ghe_server %}. - -{% if currentVersion ver_gt "enterprise-server@2.18" %} -Para obter mais informações sobre o gerenciamento de contas corporativas usando a API GraphQL, consulte "[Contas corporativas](/v4/guides/managing-enterprise-accounts)". -{% endif %} -### Habilitar o {% data variables.product.prodname_github_connect %} - -1. Entre na {% data variables.product.product_location_enterprise %} e no {% data variables.product.prodname_dotcom_the_website %}. -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %} -5. Em "{% data variables.product.prodname_dotcom_the_website %} ainda não está habilitado", clique em **Enable {% data variables.product.prodname_github_connect %}** (Habilitar o {% data variables.product.prodname_github_connect %}). Ao clicar em **Enable {% data variables.product.prodname_github_connect %}** (Habilitar o {% data variables.product.prodname_github_connect %}), você concorda com o {% data variables.product.prodname_github_connect %} Adendo ao contrato de licença do {% data variables.product.prodname_enterprise %}. ![Botão Enable GitHub Connect (Habilitar o GitHub Connect)](/assets/images/enterprise/business-accounts/enable-github-connect-button.png) -6. Ao lado da conta corporativa ou organização que você pretende conectar, clique em **Connect** (Conectar). ![Botão Connect (Conectar) ao lado de uma conta corporativa ou empresa](/assets/images/enterprise/business-accounts/choose-enterprise-or-org-connect.png) - -### Desconectar uma conta corporativa ou organização do {% data variables.product.prodname_ghe_cloud %} da {% data variables.product.product_location_enterprise %} - -Ao se desconectar do {% data variables.product.prodname_ghe_cloud %}, o {% data variables.product.prodname_github_app %} do {% data variables.product.prodname_github_connect %} é excluído da sua conta corporativa ou organização e as credenciais armazenadas na {% data variables.product.product_location_enterprise %} são excluídas. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %} -5. Ao lado da conta corporativa ou organização que você gostaria de desconectar, clique em **Disable {% data variables.product.prodname_github_connect %})** (Desabilitar o {% data variables.product.prodname_github_connect %}). ![Desabilitar o botão GitHub Connect ao lado do nome de uma conta corporativa ou organização](/assets/images/enterprise/business-accounts/disable-github-connect-button.png) -6. Leia as informações sobre a desconexão e clique em **Disable {% data variables.product.prodname_github_connect %}** (Desabilitar o {% data variables.product.prodname_github_connect %}). ![Botão Modal com informações de aviso sobre desconexão e confirmação](/assets/images/enterprise/business-accounts/confirm-disable-github-connect.png) - diff --git a/translations/pt-BR/content/admin/installation/creating-a-high-availability-replica.md b/translations/pt-BR/content/admin/installation/creating-a-high-availability-replica.md deleted file mode 100644 index 33bef0d3a61f..000000000000 --- a/translations/pt-BR/content/admin/installation/creating-a-high-availability-replica.md +++ /dev/null @@ -1,101 +0,0 @@ ---- -title: Criar réplica de alta disponibilidade -intro: 'Em uma configuração ativa/passiva, o appliance réplica é uma cópia redundante do appliance primário. Em caso de falha no appliance primário, o modo de alta disponibilidade permitirá que a réplica atue como appliance primário, mitigando as interrupções de serviço.' -redirect_from: - - /enterprise/admin/installation/creating-a-high-availability-replica -versions: - enterprise-server: '*' ---- - -### Criar réplica de alta disponibilidade - -1. Configure um novo appliance do {% data variables.product.prodname_ghe_server %} na plataforma desejada. O appliance réplica deve refletir as configurações de CPU, RAM e armazenamento do appliance primário. É recomendável instalar o appliance réplica em um ambiente independente. Hardware, software e componentes de rede subjacentes devem ser isolados dos do appliance primário. Se estiver em um provedor de nuvem, use uma região ou zona separada. Para obter mais informações, consulte [Configurar uma instância do {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-github-enterprise-server-instance). -2. Em um navegador, vá até o novo endereço IP do appliance réplica e faça o upload da sua licença do {% data variables.product.prodname_enterprise %}. -3. Defina uma senha de administrador correspondente à senha no appliance primário e continue. -4. Clique em **Configure as Replica** (Configurar como réplica). ![Opções de instalação com link para configurar a nova instância como réplica](/assets/images/enterprise/management-console/configure-as-replica.png) -5. Em "Add new SSH key" (Adicionar nova chave SSH), digite a chave SSH. ![Adicionar chave SSH](/assets/images/enterprise/management-console/add-ssh-key.png) -6. Clique em **Add key** (Adicionar chave) e em **Continue** (Continuar). -6. Conecte-se ao endereço IP do appliance réplica usando SSH. - ```shell - $ ssh -p 122 admin@REPLICA IP - ``` -7. Para gerar um par de chaves para replicação, use o comando `ghe-repl-setup` com o endereço IP do appliance primário e copie a chave pública que ele retorna. - ```shell - $ ghe-repl-setup PRIMARY IP - ``` -{% data reusables.enterprise_installation.add-ssh-key-to-primary %} -9. Para verificar a conexão com o primário e habilitar o modo de réplica para a nova réplica, execute `ghe-repl-setup` novamente. - ```shell - $ ghe-repl-setup PRIMARY IP - ``` -{% data reusables.enterprise_installation.replication-command %} -11. Para verificar o status do canal de replicação de cada armazenamento de dados, use o comando `ghe-repl-status`. - ```shell - $ ghe-repl-status - ``` - -### Criar réplicas com replicação geográfica - -Este exemplo de configuração usa um primário e duas réplicas, localizados em três regiões geográficas diferentes. Mesmo que os três nós estejam em redes diferentes, todos os nós precisam estar acessíveis entre si. No mínimo, as portas administrativas necessárias devem ficar abertas para todos os outros nós. Para obter mais informações sobre os requisitos de portas, consulte "[Portas de rede](/enterprise/{{ currentVersion }}/admin/guides/installation/network-ports/#administrative-ports)". - -1. Crie a primeira réplica da mesma forma que você faria em uma configuração padrão de dois nós executando `ghe-repl-setup` na primeira réplica. - ```shell - (replica1)$ ghe-repl-setup PRIMARY IP - (replica1)$ ghe-repl-start - ``` -2. Crie a segunda réplica e use o comando `ghe-repl-setup --add`. O sinalizador `--add` impede a substituição da configuração de replicação atual e adiciona a nova réplica à configuração. - ```shell - (replica2)$ ghe-repl-setup --add PRIMARY IP - (replica2)$ ghe-repl-start - ``` -3. Por padrão, as réplicas são configuradas no mesmo datacenter{% if currentVersion ver_gt "enterprise-server@2.17" %} e agora vão tentar propagar a partir de um nó existente no mesmo datacenter{% endif %}. Configure as réplicas para datacenters diferentes definindo outros valores na opção do datacenter. Você pode especificar os valores que preferir, desde que sejam diferentes uns dos outros. Execute o comando `ghe-repl-node` em cada nó e especifique o datacenter. - - No primário: - ```shell - (primary)$ ghe-repl-node --datacenter [PRIMARY DC NAME] - ``` - Na primeira réplica: - ```shell - (replica1)$ ghe-repl-node --datacenter [FIRST REPLICA DC NAME] - ``` - Na segunda réplica: - ```shell - (replica2)$ ghe-repl-node --datacenter [SECOND REPLICA DC NAME] - ``` - {% tip %} - - **Dica:** você pode definir as opções `--datacenter` e `--active` simultaneamente. - - {% endtip %} -4. Um nó de réplica ativo armazenará cópias dos dados do appliance e solicitações do usuário final do serviço. Um nó inativo armazenará cópias dos dados do appliance, mas não as solicitações do usuário final do serviço. Habilite o modo ativo usando o sinalizador `--active` ou use o sinalizador `--inactive` para o modo inativo. - - Na primeira réplica: - ```shell - (replica1)$ ghe-repl-node --active - ``` - Na segunda réplica: - ```shell - (replica2)$ ghe-repl-node --active - ``` -5. Para aplicar a configuração, use o comando `ghe-config-apply` no primário. - ```shell - (primary)$ ghe-config-apply - ``` - -### Configurar DNS de localização geográfica - -Configure o Geo DNS usando os endereços IP dos nós primário e das réplicas. Você também pode criar um DNS CNAME para o nó primário (por exemplo, `primary.github.example.com`) para acessar o nó primário via SSH ou fazer backup usando `backup-utils`. - -Para fins de teste, é possível adicionar entradas ao arquivo `hosts` da estação de trabalho local (por exemplo, `/etc/hosts`). Essas entradas de exemplo resolverão as solicitações de `HOSTNAME` para `replica2`. É possível segmentar hosts específicos comentando linhas diferentes. - -``` -# HOSTNAME -# HOSTNAME - HOSTNAME -``` - -### Leia mais - -- [Sobre a configuração de alta disponibilidade](/enterprise/{{ currentVersion }}/admin/guides/installation/about-high-availability-configuration) -- [Utilitários para gerenciamento de replicações](/enterprise/{{ currentVersion }}/admin/guides/installation/about-high-availability-configuration/#utilities-for-replication-management) -- [Sobre a replicação geográfica](/enterprise/{{ currentVersion }}/admin/guides/installation/about-geo-replication/) diff --git a/translations/pt-BR/content/admin/installation/disabling-git-ssh-access-on-github-enterprise-server.md b/translations/pt-BR/content/admin/installation/disabling-git-ssh-access-on-github-enterprise-server.md deleted file mode 100644 index 04a823fd3537..000000000000 --- a/translations/pt-BR/content/admin/installation/disabling-git-ssh-access-on-github-enterprise-server.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: Desabilitar o acesso por SSH do Git no GitHub Enterprise Server -redirect_from: - - /enterprise/admin/hidden/disabling-ssh-access-for-a-user-account/ - - /enterprise/admin/articles/disabling-ssh-access-for-a-user-account/ - - /enterprise/admin/hidden/disabling-ssh-access-for-your-appliance/ - - /enterprise/admin/articles/disabling-ssh-access-for-your-appliance/ - - /enterprise/admin/hidden/disabling-ssh-access-for-an-organization/ - - /enterprise/admin/articles/disabling-ssh-access-for-an-organization/ - - /enterprise/admin/hidden/disabling-ssh-access-to-a-repository/ - - /enterprise/admin/articles/disabling-ssh-access-to-a-repository/ - - /enterprise/admin/guides/installation/disabling-git-ssh-access-on-github-enterprise/ - - /enterprise/admin/installation/disabling-git-ssh-access-on-github-enterprise-server -intro: 'É possível impedir que as pessoas usem o Git por SSH para alguns ou todos os repositórios na {% data variables.product.product_location_enterprise %}.' -versions: - enterprise-server: '*' ---- - -### Desabilitar o acesso por SSH do Git a repositórios específicos - -{% data reusables.enterprise_site_admin_settings.override-policy %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -1. Em "Git SSH access" (Acesso por SSH do Git), use o menu suspenso e clique em **Disabled** (Desabilitado). ![Menu suspenso de acesso por SSH do Git com a opção Desabilitado](/assets/images/enterprise/site-admin-settings/git-ssh-access-repository-setting.png) - -### Desabilitar o acesso por SSH do Git a todos os repositórios pertencentes a um usuário ou organização - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.search-user-or-org %} -{% data reusables.enterprise_site_admin_settings.click-user-or-org %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -7. Em "Git SSH access" (Acesso por SSH do Git), use o menu suspenso e clique em **Disabled** (Desabilitado). Em seguida, selecione **Enforce on all repositories** (Aplicar a todos os repositórios). ![Menu suspenso de acesso por SSH do Git com a opção Desabilitado](/assets/images/enterprise/site-admin-settings/git-ssh-access-organization-setting.png) - -### Desabilitar o acesso por SSH do Git a todos os repositórios no appliance - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -7. Em "Git SSH access" (Acesso por SSH do Git), use o menu suspenso e clique em **Disabled** (Desabilitado). Em seguida, selecione **Enforce on all repositories** (Aplicar a todos os repositórios). ![Menu suspenso de acesso por SSH do Git com a opção Desabilitado](/assets/images/enterprise/site-admin-settings/git-ssh-access-appliance-setting.png) diff --git a/translations/pt-BR/content/admin/installation/disabling-the-merge-conflict-editor-for-pull-requests-between-repositories.md b/translations/pt-BR/content/admin/installation/disabling-the-merge-conflict-editor-for-pull-requests-between-repositories.md deleted file mode 100644 index 20afe28998f4..000000000000 --- a/translations/pt-BR/content/admin/installation/disabling-the-merge-conflict-editor-for-pull-requests-between-repositories.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: Desabilitar o editor de conflito de merge para pull requests entre repositórios -intro: 'Você pode exigir que as pessoas resolvam conflitos de merge no local desabilitando o editor de conflito de merge no {% data variables.product.prodname_ghe_server %} para as pull requests quando o branch base e o branch principal estiverem em repositórios diferentes.' -redirect_from: - - /enterprise/admin/installation/disabling-the-merge-conflict-editor-for-pull-requests-between-repositories -versions: - enterprise-server: '*' ---- - -Solicitar que os usuário resolvam conflitos de merge em seus respectivos computadores pode impedir gravações inadvertidas em repositórios upstream a partir de uma bifurcação. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -1. Em "Conflict editor for pull requests between repositories" (Editor de conflitos para pull requests entre repositórios), use o menu suspenso e clique em **Disabled** (Desabilitar). ![Menu suspenso com opção para desabilitar o editor de conflito de merge](/assets/images/enterprise/settings/conflict-editor-settings.png) diff --git a/translations/pt-BR/content/admin/installation/enabling-and-scheduling-maintenance-mode.md b/translations/pt-BR/content/admin/installation/enabling-and-scheduling-maintenance-mode.md deleted file mode 100644 index c5e52d5e9074..000000000000 --- a/translations/pt-BR/content/admin/installation/enabling-and-scheduling-maintenance-mode.md +++ /dev/null @@ -1,61 +0,0 @@ ---- -title: Habilitar e programar o modo de manutenção -intro: 'Alguns procedimentos de manutenção padrão, como atualizar a {% data variables.product.product_location_enterprise %} ou fazer backups de restauração, exigem que a instância esteja offline para uso normal.' -redirect_from: - - /enterprise/admin/maintenance-mode/ - - /enterprise/admin/categories/maintenance-mode/ - - /enterprise/admin/articles/maintenance-mode/ - - /enterprise/admin/articles/enabling-maintenance-mode/ - - /enterprise/admin/articles/disabling-maintenance-mode/ - - /enterprise/admin/guides/installation/maintenance-mode/ - - /enterprise/admin/installation/enabling-and-scheduling-maintenance-mode -versions: - enterprise-server: '*' ---- - -### Sobre o modo de manutenção - -Alguns tipos de operações requerem que a {% data variables.product.product_location_enterprise %} esteja offline e no modo de manutenção: -- Atualizar para uma nova versão do {% data variables.product.prodname_ghe_server %}; -- Aumentar a capacidade dos recursos de CPU, memória ou armazenamento alocados na máquina virtual; -- Migrar dados de uma máquina virtual para outra; -- Restaurar dados de um instantâneo do {% data variables.product.prodname_enterprise_backup_utilities %}; -- Solucionar determinados tipos de problemas graves no aplicativo. - -É recomendável programar um período de manutenção de no mínimo 30 minutos para que os usuários tenham tempo de se preparar. Quando houver um período de manutenção programado, todos os usuários verão um banner ao acessar o site. - -![Banner para usuário final sobre manutenção programada](/assets/images/enterprise/maintenance/maintenance-scheduled.png) - -Quando a instância estiver em modo de manutenção, todos os acessos regulares por HTTP e Git serão recusados. Operações de fetch, clonagem e push também são rejeitadas, e uma mensagem de erro indicará que o site está temporariamente indisponível. O acesso ao site por navegador levará a uma página de manutenção. - -![Tela inicial do modo de manutenção](/assets/images/enterprise/maintenance/maintenance-mode-maintenance-page.png) - -### Habilitar o modo de manutenção imediatamente ou programar um período de manutenção mais tarde - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -2. Na parte superior do {% data variables.enterprise.management_console %}, clique em **Maintenance** (Manutenção). ![Guia de manutenção](/assets/images/enterprise/management-console/maintenance-tab.png) -3. Em "Enable and schedule" (Habilitar e programar), decida se você quer habilitar o modo de manutenção imediatamente ou programar um período de manutenção depois. - - Para habilitar o modo de manutenção imediatamente, use o menu suspenso e clique em **Now** (Agora). ![Menu suspenso com a opção para habilitar o modo de manutenção agora](/assets/images/enterprise/maintenance/enable-maintenance-mode-now.png) - - Para programar um período de manutenção depois, use o menu suspenso e clique no horário em que você pretende iniciar o período de manutenção.![Menu suspenso com a opção para habilitar o modo de manutenção em duas horas](/assets/images/enterprise/maintenance/schedule-maintenance-mode-two-hours.png) -4. Selecione **Enable maintenance mode** (Habilitar modo de manutenção). ![Caixa de seleção para habilitar ou programar o modo de manutenção](/assets/images/enterprise/maintenance/enable-maintenance-mode-checkbox.png) -{% data reusables.enterprise_management_console.save-settings %} - -### Programar o modo de manutenção com a {% data variables.product.prodname_enterprise_api %} - -Você pode programar o modo de manutenção para horas ou datas diferentes na {% data variables.product.prodname_enterprise_api %}. Para obter mais informações, consulte "[Console de gerenciamento](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#enable-or-disable-maintenance-mode)". - -### Habilitar ou desabilitar o modo de manutenção para todos os nós do cluster - -Com o utilitário `ghe-cluster-maintenance`, você pode definir ou cancelar as definições do modo de manutenção para cada nó de um cluster. - -```shell -$ ghe-cluster-maintenance -h -# Mostra opções -$ ghe-cluster-maintenance -q -# Consultas no modo atual -$ ghe-cluster-maintenance -s -# Define o modo de manutenção -$ ghe-cluster-maintenance -u -# Cancela a definição do modo de manutenção -``` diff --git a/translations/pt-BR/content/admin/installation/enabling-automatic-update-checks.md b/translations/pt-BR/content/admin/installation/enabling-automatic-update-checks.md deleted file mode 100644 index a93c07d5df81..000000000000 --- a/translations/pt-BR/content/admin/installation/enabling-automatic-update-checks.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: Verificações de atualizações automáticas -intro: 'É possível habilitar as verificações de atualizações automáticas para que a {% data variables.product.product_location_enterprise %} verifique e baixe as versões mais recentes do {% data variables.product.prodname_ghe_server %}.' -redirect_from: - - /enterprise/admin/installation/enabling-automatic-update-checks -versions: - enterprise-server: '*' ---- - -Quando um pacote de atualização for baixado automaticamente para a {% data variables.product.product_location_enterprise %}, você receberá uma mensagem informando que pode atualizar o {% data variables.product.prodname_ghe_server %}. Os pacotes baixados ficam no diretório `/var/lib/ghe-updates` na {% data variables.product.product_location_enterprise %}. Para obter mais informações, consulte "[Atualizar o {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-github-enterprise-server)". - -Se houver algum hotpatch disponível para atualização, o `.hpkg` fará o download automaticamente. No console de gerenciamento, você pode instalar o hotpatch imediatamente ou agendar a instalação para outro período. Para obter mais informações, consulte "[Atualizar com hotpatch](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-github-enterprise-server#upgrading-with-a-hotpatch)". - -{% tip %} - -**Dica:** para habilitar as verificações de atualizações automáticas, a {% data variables.product.product_location_enterprise %} deve poder se conectar a `https://github-enterprise.s3.amazonaws.com`. - -{% endtip %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.updates-tab %} -4. Clique em **Yes, automatically check for updates** (Sim, verificar atualizações automaticamente). ![Botão para habilitar atualizações automáticas](/assets/images/enterprise/management-console/enable_updates_button.png) -{% data reusables.enterprise_management_console.save-settings %} - -Para ver se a sua instância está atualizada, verifique o banner na guia Updates (Atualizações). - -![Banner indicativo da versão do GitHub Enterprise Server](/assets/images/enterprise/management-console/up-to-date-banner.png) - -Em **Logs**, consulte o status da verificação de atualização mais recente. - -![Logs para atualização](/assets/images/enterprise/management-console/update-log.png) diff --git a/translations/pt-BR/content/admin/installation/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud.md b/translations/pt-BR/content/admin/installation/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud.md deleted file mode 100644 index 35e0e8fd3a3a..000000000000 --- a/translations/pt-BR/content/admin/installation/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: Habilitar a sincronização automática de licenças de usuários entre o GitHub Enterprise Server e o GitHub Enterprise Cloud -intro: 'É possível conectar a {% data variables.product.product_location_enterprise %} ao {% data variables.product.prodname_ghe_cloud %} e permitir que o {% data variables.product.prodname_ghe_server %} faça upload das informações de licença do usuário para a sua conta corporativa no {% data variables.product.prodname_dotcom_the_website %}.' -permissions: 'Administradores de sites para {% data variables.product.prodname_ghe_server %} que também são proprietários de uma conta corporativa ou organização conectada do {% data variables.product.prodname_ghe_cloud %} podem ativar a sincronização automática de licença de usuário.' -redirect_from: - - /enterprise/admin/installation/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud -versions: - enterprise-server: '*' ---- - -### Sobre a sincronização de licenças - -Depois de habilitar a sincronização de licença, você poderá visualizar o uso da licença em toda a sua conta corporativa, no {% data variables.product.prodname_ghe_server %} e no {% data variables.product.prodname_ghe_cloud %}. O {% data variables.product.prodname_github_connect %} sincroniza a licença entre {% data variables.product.prodname_ghe_server %} e {% data variables.product.prodname_ghe_cloud %} semanalmente. Para obter mais informações, consulte "[Gerenciar sua licença {% data variables.product.prodname_enterprise %}](/enterprise/{{currentVersion}}/admin/installation/managing-your-github-enterprise-server-license)". - -Você também pode fazer upload manualmente das informações de licença do usuário do {% data variables.product.prodname_ghe_server %} para o {% data variables.product.prodname_ghe_cloud %}. Para obter mais informações, consulte "[Conectar o {% data variables.product.prodname_ghe_server %} ao {% data variables.product.prodname_ghe_cloud %}](/enterprise/{{ currentVersion }}/admin/guides/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)". - -### Habilitar a sincronização de licenças - -Antes de habilitar a sincronização de licença na {% data variables.product.product_location_enterprise %}, conecte a {% data variables.product.product_location_enterprise %} ao {% data variables.product.prodname_dotcom_the_website %}. Para obter mais informações, consulte "[Conectar o {% data variables.product.prodname_ghe_server %} ao {% data variables.product.prodname_ghe_cloud %}](/enterprise/{{ currentVersion }}/admin/guides/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)". - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %} -5. Em "Server can sync user license count and usage" (Servidor pode sincronizar contagem e uso de licenças de usuário), selecione **Enabled** (Habilitado) no menu suspenso. ![Menu suspenso para habilitar a sincronização automática de licenças de usuário](/assets/images/enterprise/site-admin-settings/enable-user-license-drop-down.png) diff --git a/translations/pt-BR/content/admin/installation/enabling-private-mode.md b/translations/pt-BR/content/admin/installation/enabling-private-mode.md deleted file mode 100644 index 1807d0748193..000000000000 --- a/translations/pt-BR/content/admin/installation/enabling-private-mode.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: Habilitar o modo privado -intro: 'No modo privado, o {% data variables.product.prodname_ghe_server %} exige que todos os usuários façam login para acessar a instalação.' -redirect_from: - - /enterprise/admin/articles/private-mode/ - - /enterprise/admin/guides/installation/security/ - - /enterprise/admin/guides/installation/securing-your-instance/ - - /enterprise/admin/installation/enabling-private-mode -versions: - enterprise-server: '*' ---- - -Você deve habilitar o modo privado se a {% data variables.product.product_location_enterprise %} estiver acessível publicamente pela Internet. No modo privado, os usuários não podem clonar anonimamente repositórios em `git://`. Se a autenticação integrada também estiver habilitada, o administrador deverá convidar novos usuários para criar uma conta na instância. Para obter mais informações, consulte "[Usar autenticação integrada](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-built-in-authentication)". - -{% data reusables.enterprise_installation.image-urls-viewable-warning %} - -Com o modo privado habilitado, você pode permitir que operações não autenticadas do Git (e qualquer pessoa com acesso de rede à {% data variables.product.product_location_enterprise %}) leia o código de um repositório público na sua instância com o acesso de leitura anônimo do Git habilitado. Para obter mais informações, consulte "[Permitir que administradores habilitem o acesso de leitura anônimo do Git a repositórios públicos](/enterprise/{{ currentVersion }}/admin/guides/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories)". - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -4. Selecione **Private mode** (Modo privado). ![Caixa de seleção para habilitar o modo privado](/assets/images/enterprise/management-console/private-mode-checkbox.png) -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/pt-BR/content/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md b/translations/pt-BR/content/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md deleted file mode 100644 index 798a51a3d105..000000000000 --- a/translations/pt-BR/content/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: Habilitar alertas de segurança para dependências vulneráveis no GitHub Enterprise Server -intro: 'Você pode conectar a {% data variables.product.product_location_enterprise %} ao {% data variables.product.prodname_ghe_cloud %} e habilitar os alertas de segurança para dependências vulneráveis nos repositórios na sua instância.' -permissions: 'Os administradores de sites para {% data variables.product.prodname_ghe_server %} que também são proprietários de uma conta corporativa ou organização conectada do {% data variables.product.prodname_ghe_cloud %} podem ativar alertas de segurança para dependências vulneráveis em {% data variables.product.prodname_ghe_server %}.' -redirect_from: - - /enterprise/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server -versions: - enterprise-server: '*' ---- - -### Sobre alertas para dependências vulneráveis no {% data variables.product.prodname_ghe_server %} - -{% data reusables.repositories.tracks-vulnerabilities %} Para obter mais informações, consulte "[Sobre alertas de dependências vulneráveis](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)". - -Você pode conectar a {% data variables.product.product_location_enterprise %} ao {% data variables.product.prodname_dotcom_the_website %}, sincronizar os dados de vulnerabilidade com a sua instância e gerar alertas de segurança em repositórios com dependência vulnerável. - -Depois de conectar o {% data variables.product.product_location_enterprise %} ao {% data variables.product.prodname_dotcom_the_website %} e habilitar os alertas de segurança para dependências vulneráveis, os dados de vulnerabilidade serão sincronizados do {% data variables.product.prodname_dotcom_the_website %} para a sua instância a cada hora. Também é possível sincronizar os dados de vulnerabilidade manualmente a qualquer momento. Nenhum código ou informações sobre o código da {% data variables.product.product_location_enterprise %} são carregados para o {% data variables.product.prodname_dotcom_the_website %}. - -Ao receber informações sobre vulnerabilidades, a {% data variables.product.product_location_enterprise %} identificará os repositórios da sua instância que usam a versão afetada da dependência e enviará alertas de segurança para os proprietários e usuários com acesso administrativo nos repositórios em questão. É possível personalizar o recebimento dos alertas de segurança. Para obter mais informações, consulte "[Sobre alertas para dependências vulneráveis](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies/#configuring-notifications-for-security-alerts)" - -### Habilitar alertas de segurança para dependências vulneráveis no {% data variables.product.prodname_ghe_server %} - -Antes de habilitar os alertas de segurança para as dependências de vulnerabilidade na {% data variables.product.product_location_enterprise %}, conecte a {% data variables.product.product_location_enterprise %} ao {% data variables.product.prodname_dotcom_the_website %}. Para obter mais informações, consulte "[Conectar o {% data variables.product.prodname_ghe_server %} ao {% data variables.product.prodname_ghe_cloud %}](/enterprise/{{ currentVersion }}/admin/guides/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)". - -{% if currentVersion ver_gt "enterprise-server@2.20" %} Recomendamos configurar alertas de segurança sem notificações nos primeiros dias para evitar uma sobrecarga de e-mails. Após alguns dias, você pode habilitar notificações para receber alertas de segurança como de costume.{% endif %} - -{% data reusables.enterprise_site_admin_settings.sign-in %} -2. No shell administrativo, habilite os alertas de segurança para dependências de vulnerabilidade na {% data variables.product.product_location_enterprise %}: - ``` shell -$ ghe-dep-graph-enable -``` -3. Volte para o {% data variables.product.prodname_ghe_server %}. -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %}{% if currentVersion ver_gt "enterprise-server@2.20" %} -5. Em "Repositories can be scanned for vulnerabilities" (Os repositórios podem ser examinados para vulnerabilidades), use o menu suspenso e clique em **Enabled without notifications** (Habilitado sem notificações). Opcionalmente, para habilitar alertas com notificações, selecione **Enabled with notifications**(Habilitado com notificações).{% else %} -5. Em "Repositories can be scanned for vulnerabilities" (Verificar vulnerabilidades nos repositórios), use o menu suspenso e clique em **Enabled** (Habilitado). -{% endif %} - ![Menu suspenso para habilitar a verificação vulnerabilidades nos repositórios](/assets/images/enterprise/site-admin-settings/enable-vulnerability-scanning-in-repositories.png) - -### Exibir dependências vulneráveis no {% data variables.product.prodname_ghe_server %} - -Você pode exibir todas as vulnerabilidades na {% data variables.product.product_location_enterprise %} e sincronizar manualmente os dados de vulnerabilidade do {% data variables.product.prodname_dotcom_the_website %} para atualizar a lista. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -2. Na barra lateral esquerda, clique em **Vulnerabilities** (Vulnerabilidades). ![Guia Vulnerabilities (Vulnerabilidades) na barra lateral de administração do site](/assets/images/enterprise/business-accounts/vulnerabilities-tab.png) -3. Para sincronizar os dados de vulnerabilidade, clique em **Sync Vulnerabilities now** (Sincronizar vulnerabilidades agora). ![Botão Sync Vulnerabilities now (Sincronizar vulnerabilidades agora)](/assets/images/enterprise/site-admin-settings/sync-vulnerabilities-button.png) diff --git a/translations/pt-BR/content/admin/installation/enabling-subdomain-isolation.md b/translations/pt-BR/content/admin/installation/enabling-subdomain-isolation.md deleted file mode 100644 index d79dffedb774..000000000000 --- a/translations/pt-BR/content/admin/installation/enabling-subdomain-isolation.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: Habilitar isolamento de subdomínio -intro: 'É possível configurar o isolamento de subdomínio para separar com segurança o conteúdo enviado pelo usuário de outras partes do seu appliance do {% data variables.product.prodname_ghe_server %}.' -redirect_from: - - /enterprise/admin/guides/installation/about-subdomain-isolation/ - - /enterprise/admin/installation/enabling-subdomain-isolation -versions: - enterprise-server: '*' ---- - -### Sobre isolamento de subdomínio - -O isolamento de subdomínios reduz os problemas de script entre sites e outras vulnerabilidades relacionadas. Para obter mais informações, leia mais sobre [scripts entre sites](http://en.wikipedia.org/wiki/Cross-site_scripting) na Wikipedia. É altamente recomendável habilitar o isolamento de subdomínio para a {% data variables.product.product_location_enterprise %}. - -Quando o isolamento do subdomínio está ativado, o {% data variables.product.prodname_ghe_server %} substitui vários caminhos pelos subdomínios. - -| Caminho sem isolamento de subdomínio | Caminho com isolamento de subdomínio | -| ------------------------------------ | ------------------------------------ | -| `http(s)://HOSTNAME/assets/` | `http(s)://assets.HOSTNAME/` | -| `http(s)://HOSTNAME/avatars/` | `http(s)://avatars.HOSTNAME/` | -| `http(s)://HOSTNAME/codeload/` | `http(s)://codeload.HOSTNAME/` | -| `http(s)://HOSTNAME/gist/` | `http(s)://gist.HOSTNAME/` | -| `http(s)://HOSTNAME/media/` | `http(s)://media.HOSTNAME/` | -| `http(s)://HOSTNAME/pages/` | `http(s)://pages.HOSTNAME/` | -| `http(s)://HOSTNAME/raw/` | `http(s)://raw.HOSTNAME/` | -| `http(s)://HOSTNAME/render/` | `http(s)://render.HOSTNAME/` | -| `http(s)://HOSTNAME/reply/` | `http(s)://reply.HOSTNAME/` | -| `http(s)://HOSTNAME/uploads/` | `http(s)://uploads.HOSTNAME/` | - -### Pré-requisitos - -{% data reusables.enterprise_installation.disable-github-pages-warning %} - -Antes de habilitar o isolamento de subdomínio, você deve definir as configurações de rede do novo domínio. - -- Em vez de um endereço IP, especifique um nome de domínio válido como nome de host. Para obter mais informações, consulte "[Configurar nome de host](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-a-hostname)". - -{% data reusables.enterprise_installation.changing-hostname-not-supported %} - -- Configure um registro curinga do Sistema de Nomes de Domínio (DNS) ou registros DNS individuais para os subdomínios listados acima. É recomendável criar um registro A para `*.HOSTNAME` que aponte para o endereço IP do servidor, de modo que não seja preciso criar vários registros para cada subdomínio. -- Obtenha um certificado curinga de Segurança da Camada de Transporte (TLS) para `*.HOSTNAME` com Nome Alternativo da Entidade (SAN) para `HOSTNAME` e o domínio curinga `*.HOSTNAME`. Por exemplo, se o nome de host for `github.octoinc.com`, obtenha um certificado com valor de nome comum definido como `*.github.octoinc.com` e valor SAN definido para `github.octoinc.com` e `*.github.octoinc.com`. -- Habilite o TLS no appliance. Para obter mais informações, consulte "[Configurar TLS](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-tls/)". - -### Habilitar isolamento de subdomínio - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.hostname-menu-item %} -4. Selecione **Subdomain isolation (recommended)** (Isolamento de subdomínio [recomendado]). ![Caixa de seleção para habilitar o isolamento de subdomínio](/assets/images/enterprise/management-console/subdomain-isolation.png) -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/pt-BR/content/admin/installation/enabling-unified-contributions-between-github-enterprise-server-and-githubcom.md b/translations/pt-BR/content/admin/installation/enabling-unified-contributions-between-github-enterprise-server-and-githubcom.md deleted file mode 100644 index bdc5d29aa847..000000000000 --- a/translations/pt-BR/content/admin/installation/enabling-unified-contributions-between-github-enterprise-server-and-githubcom.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: Habilitar contribuições unificadas entre o GitHub Enterprise Server e o GitHub.com -intro: 'Depois de habilitar o {% data variables.product.prodname_github_connect %}, você pode permitir que os integrantes do {% data variables.product.prodname_ghe_cloud %} destaquem o próprio trabalho no {% data variables.product.prodname_ghe_server %} enviando as contagens de contribuição para seus respectivos perfis do {% data variables.product.prodname_dotcom_the_website %}.' -redirect_from: - - /enterprise/admin/guides/developer-workflow/enabling-unified-contributions-between-github-enterprise-and-github-com/ - - /enterprise/admin/guides/developer-workflow/enabling-unified-contributions-between-github-enterprise-server-and-github-com/ - - /enterprise/admin/developer-workflow/enabling-unified-contributions-between-github-enterprise-server-and-githubcom/ - - /enterprise/admin/installation/enabling-unified-contributions-between-github-enterprise-server-and-githubcom -permissions: 'Administradores de sites para {% data variables.product.prodname_ghe_server %} que também são proprietários de uma conta corporativa ou organização conectada do {% data variables.product.prodname_ghe_cloud %} podem ativar contribuições unificadas entre {% data variables.product.prodname_ghe_server %} e {% data variables.product.prodname_dotcom_the_website %}.' -versions: - enterprise-server: '*' ---- - -Como administrador do site, você pode permitir que os usuários finais enviem as contagens de contribuição anônimas do trabalho deles no {% data variables.product.prodname_ghe_server %} pelos respectivos gráficos de contribuição no {% data variables.product.prodname_dotcom_the_website %}. - -Após habilitar o {% data variables.product.prodname_github_connect %} e o {% data variables.product.prodname_unified_contributions %} nos dois ambientes, os usuários finais da instância podem se conectar a suas respectivas contas do {% data variables.product.prodname_dotcom_the_website %} e enviar contagens de contribuição do {% data variables.product.prodname_ghe_server %} para o {% data variables.product.prodname_dotcom_the_website %}. {% data reusables.github-connect.sync-frequency %} Para obter mais informações, consulte "[Enviar contribuições do {% data variables.product.prodname_ghe_server %} para o perfil do {% data variables.product.prodname_dotcom_the_website %}](/articles/sending-your-github-enterprise-server-contributions-to-your-github-com-profile/)". - -Se o administrador do site desabilitar a funcionalidade ou se os desenvolvedores interromperem a conexão, as contagens de contribuição do {% data variables.product.prodname_ghe_server %} serão excluídas no {% data variables.product.prodname_dotcom_the_website %}. Se o desenvolvedor reconectar os perfis após desabilitá-los, as contagens de contribuição dos últimos 90 dias serão restauradas. - -O {% data variables.product.prodname_ghe_server %} envia a contagem de contribuição e a origem **somente** para os usuários conectados ({% data variables.product.prodname_ghe_server %}). Nenhuma informação sobre a contribuição ou sobre como ela foi feita é enviada. - -Antes de habilitar o {% data variables.product.prodname_unified_contributions %} na {% data variables.product.product_location_enterprise %}, conecte a {% data variables.product.product_location_enterprise %} ao {% data variables.product.prodname_dotcom_the_website %}. Para obter mais informações, consulte "[Conectar o {% data variables.product.prodname_ghe_server %} ao {% data variables.product.prodname_dotcom_the_website %}](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/connecting-github-enterprise-server-to-github-com)". - -{% data reusables.github-connect.access-dotcom-and-enterprise %} -{% data reusables.enterprise_site_admin_settings.access-settings %}{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %} -4. Em "Users can share contribution counts to {% data variables.product.prodname_dotcom_the_website %}" (Usuários podem compartilhar contagens de contribuição com o {% data variables.product.prodname_dotcom_the_website %}), clique em **Request access** (Solicitar acesso). ![Solicitar acesso à opção de contribuições unificadas](/assets/images/enterprise/site-admin-settings/dotcom-ghe-connection-request-access.png) -5. [Faça login](https://enterprise.github.com/login) no site do {% data variables.product.prodname_ghe_server %} para obter mais instruções. - -Ao solicitar acesso, você será redirecionado para o site do {% data variables.product.prodname_ghe_server %} a fim de verificar seus termos de serviço. Se a {% data variables.product.product_location_enterprise %} usar os termos de serviço padrão, a solicitação redirecionará você automaticamente para as instruções sobre como ativar o {% data variables.product.prodname_unified_contributions %}. Se você estiver usando termos de serviço personalizados, vamos registrar sua solicitação e entrar em contato para configurar o acesso. diff --git a/translations/pt-BR/content/admin/installation/enabling-unified-search-between-github-enterprise-server-and-githubcom.md b/translations/pt-BR/content/admin/installation/enabling-unified-search-between-github-enterprise-server-and-githubcom.md deleted file mode 100644 index 7f74a4ff65d0..000000000000 --- a/translations/pt-BR/content/admin/installation/enabling-unified-search-between-github-enterprise-server-and-githubcom.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: Habilitar pesquisa unificada entre o GitHub Enterprise Server e o GitHub.com -intro: 'Após habilitar o {% data variables.product.prodname_github_connect %}, você pode permitir a pesquisa no {% data variables.product.prodname_dotcom_the_website %} pela {% data variables.product.product_location_enterprise %}.' -redirect_from: - - /enterprise/admin/guides/developer-workflow/enabling-unified-search-between-github-enterprise-and-github-com/ - - /enterprise/admin/guides/developer-workflow/enabling-unified-search-between-github-enterprise-server-and-github-com/ - - /enterprise/admin/developer-workflow/enabling-unified-search-between-github-enterprise-server-and-githubcom/ - - /enterprise/admin/installation/enabling-unified-search-between-github-enterprise-server-and-githubcom -permissions: 'Administradores de sites para {% data variables.product.prodname_ghe_server %} que também são proprietários de uma conta corporativa ou organização conectada do {% data variables.product.prodname_ghe_cloud %} podem ativar a pesquisa unificada entre {% data variables.product.prodname_ghe_server %} e {% data variables.product.prodname_dotcom_the_website %}.' -versions: - enterprise-server: '*' ---- - -Quando você habilita a pesquisa unificada, os usuários podem ver resultados em conteúdos públicos e privados no {% data variables.product.prodname_dotcom_the_website %} quando pesquisam pela {% data variables.product.product_location_enterprise %}. - -Os usuários não conseguirão pesquisar na {% data variables.product.product_location_enterprise %} pelo {% data variables.product.prodname_dotcom_the_website %}, mesmo se tiverem acesso aos dois ambientes. Eles só poderão pesquisar nos repositórios privados em que você habilitou a {% data variables.product.prodname_unified_search %} e não terão acesso às organizações conectadas do {% data variables.product.prodname_ghe_cloud %}. Para obter mais informações, consulte "[Sobre a pesquisa no {% data variables.product.prodname_dotcom %}](/articles/about-searching-on-github/#searching-across-github-enterprise-and-githubcom-simultaneously)" e "[Habilitar a pesquisa em repositórios privados do {% data variables.product.prodname_dotcom_the_website %} na conta do {% data variables.product.prodname_ghe_server %}](/articles/enabling-private-github-com-repository-search-in-your-github-enterprise-server-account)". - -A pesquisa via APIs REST e GraphQL não inclui resultados do {% data variables.product.prodname_dotcom_the_website %}. Não há suporte para a pesquisa avançada e a pesquisa de wikis no {% data variables.product.prodname_dotcom_the_website %}. - -{% data reusables.github-connect.access-dotcom-and-enterprise %} -{% data reusables.enterprise_site_admin_settings.access-settings %}{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %} -5. Em "Users can search {% data variables.product.prodname_dotcom_the_website %}" (Usuários podem pesquisar no {% data variables.product.prodname_dotcom_the_website %}), use o menu suspenso e clique em **Enabled** (Habilitado). ![Habilitar a opção de pesquisa no menu suspenso de pesquisa do GitHub.com](/assets/images/enterprise/site-admin-settings/github-dotcom-enable-search.png) -6. Em "Users can search private repositories on {% data variables.product.prodname_dotcom_the_website %}" (Usuários podem pesquisar em repositórios privados no {% data variables.product.prodname_dotcom_the_website %}), use o menu suspenso e clique em **Enabled** (Habilitado). ![Habilitar a opção de pesquisa em repositórios privados no menu suspenso de pesquisa do GitHub.com](/assets/images/enterprise/site-admin-settings/enable-private-search.png) - -### Further reading - -- [Conectar o {% data variables.product.prodname_ghe_server %} ao {% data variables.product.prodname_dotcom_the_website %}](/enterprise/admin/guides/developer-workflow/connecting-github-enterprise-server-to-github-com) diff --git a/translations/pt-BR/content/admin/installation/getting-started-with-github-enterprise-server.md b/translations/pt-BR/content/admin/installation/getting-started-with-github-enterprise-server.md deleted file mode 100644 index 259745959026..000000000000 --- a/translations/pt-BR/content/admin/installation/getting-started-with-github-enterprise-server.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Introdução ao GitHub Enterprise Server -shortTitle: Introdução -intro: 'Saiba mais sobre {% data variables.product.prodname_ghe_server %} e como gerenciar sua licença.' -mapTopic: true -redirect_from: - - /enterprise/admin/installation/getting-started-with-github-enterprise-server -versions: - enterprise-server: '*' ---- - diff --git a/translations/pt-BR/content/admin/installation/increasing-cpu-or-memory-resources.md b/translations/pt-BR/content/admin/installation/increasing-cpu-or-memory-resources.md deleted file mode 100644 index 84c79821b8d5..000000000000 --- a/translations/pt-BR/content/admin/installation/increasing-cpu-or-memory-resources.md +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: Aprimorar os recursos de CPU ou memória -intro: 'Para adicionar recursos de CPU ou memória a uma instância do {% data variables.product.prodname_ghe_server %}, desligue a instância e use as ferramentas da plataforma virtual subjacente para alocar os recursos para a máquina virtual. Os recursos recém-alocados são reconhecidos automaticamente na inicialização, e nenhuma configuração adicional é necessária.' -redirect_from: - - /enterprise/admin/installation/increasing-cpu-or-memory-resources -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_installation.warning-on-upgrading-physical-resources %} - -### Adicionar recursos de CPU ou memória para AWS - -{% note %} - -**Observação:** para adicionar recursos de CPU ou memória ao AWS, você deve saber usar o console de gerenciamento do AWS ou a interface da linha de comandos `aws ec2` para gerenciar instâncias do EC2. Para obter detalhes sobre o uso das ferramentas do AWS escolhidas para o redimensionamento, consulte a documentação do AWS sobre [redimensionar uma instância da Amazon com EBS](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-resize.html). - -{% endnote %} - -#### Considerações de redimensionamento - -Antes de aumentar recursos de CPU ou memória do {% data variables.product.product_location_enterprise %}: -{% if currentVersion != "free-pro-team@latest" %} -- **Amplie sua memória com CPUs** - {% data reusables.enterprise_installation.increasing-cpus-max %}{% endif %} -- **Verifique se há uma IP elástica atribuída à instância** - - Se não houver IP elástica atribuída, você terá que ajustar os registros DNS A do seu host do {% data variables.product.prodname_ghe_server %} após o reinício para explicar a alteração no endereço IP público. Depois que a instância for reiniciada, a IP elástica (EIP) será automaticamente mantida se a instância for iniciada em uma VPC. Se a instância for iniciada no EC2-Classic, a IP elástica deverá ser associada outra vez manualmente. - -#### Tipos de instância do AWS compatíveis - -É necessário determinar o tipo de instância para a qual você pretende atualizar com base nas especificações de CPU/memória. -{% data reusables.enterprise_installation.aws-supported-instance-types %} - -#### Tipos de instância do AWS recomendados - -{% data reusables.enterprise_installation.aws-recommended-instance-types %} - -{% data reusables.enterprise_installation.warning-on-scaling %} - -#### Redimensionar para o AWS - -{% note %} - -**Observação:** para instâncias iniciadas no EC2-Classic, anote o endereço IP elástico associado à instância e o ID da instância. Depois de reiniciar a instância, reassocie o endereço IP elástico. - -{% endnote %} - -Não é possível adicionar recursos de CPU ou memória a uma instância atual do AWS/EC2. Faça o seguinte: - -1. Interrompa a instância. -2. Altere o tipo de instância. -3. Inicie a instância. -{% data reusables.enterprise_installation.configuration-recognized %} - -### Adicionar recursos de CPU ou memória para OpenStack KVM - -Não é possível adicionar recursos de CPU ou memória a uma instância atual do OpenStack KVM. Faça o seguinte: - -1. Tire um instantâneo da instância atual; -2. Pare a instância; -3. Selecione um novo tipo de instância que tenha os recursos de CPU e/ou memória desejados. - -### Adicionar recursos de CPU ou memória para VMware - -Se houver lentidão das operações na {% data variables.product.product_location_enterprise %}, pode ser necessário adicionar recursos de CPU ou memória. - -{% data reusables.enterprise_installation.increasing-cpus-max %} - -1. Use o cliente vSphere para conexão com o host VMware ESXi. -2. Desligue a {% data variables.product.product_location_enterprise %}. -3. Selecione a máquina virtual e clique em **Edit Settings** (Editar configurações). -4. Em "Hardware", ajuste a CPU e/ou os recursos de memória alocados à máquina virtual, conforme necessário. ![Recursos de configuração VMware](/assets/images/enterprise/vmware/vsphere-hardware-tab.png) -5. Para iniciar a máquina virtual, clique em **OK**. -{% data reusables.enterprise_installation.configuration-recognized %} diff --git a/translations/pt-BR/content/admin/installation/increasing-storage-capacity.md b/translations/pt-BR/content/admin/installation/increasing-storage-capacity.md deleted file mode 100644 index 26710c79b918..000000000000 --- a/translations/pt-BR/content/admin/installation/increasing-storage-capacity.md +++ /dev/null @@ -1,57 +0,0 @@ ---- -title: Aumentar a capacidade de armazenamento -intro: 'Você pode aumentar ou alterar a quantidade de armazenamento disponível para repositórios, bancos de dados, índices de pesquisa e outros dados persistentes de aplicativo no Git.' -redirect_from: - - /enterprise/admin/installation/increasing-storage-capacity -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_installation.warning-on-upgrading-physical-resources %} - -À medida que mais usuários se juntam à sua {% data variables.product.product_location_enterprise %}, talvez seja necessário redimensionar o volume de armazenamento. Consulte a documentação da sua plataforma de virtualização para obter informações sobre como fazer isso. - -### Requisitos e recomendações - -{% note %} - -**Observação:** antes de redimensionar o volume de armazenamento do usuário, deixe sua instância em modo de manutenção. Para obter mais informações, consulte "[Habilitar e programar o modo de manutenção](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)". - -{% endnote %} - -{% data reusables.enterprise_installation.hardware-rec-table %} - -### Aumentar o tamanho da partição de dados - -1. Redimensione o disco de volume de usuário existente usando as ferramentas da plataforma de virtualização. -{% data reusables.enterprise_installation.ssh-into-instance %} -3. Deixe o appliance em modo de manutenção. Para obter mais informações, consulte "[Habilitar e programar o modo de manutenção](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)". -4. Reinicie o appliance para detectar a alocação do novo armazenamento. -5. Execute o comando `ghe-storage-extend` para expandir o sistema de arquivos `/data`: - ```shell - $ ghe-storage-extend - ``` - -### Aumentar o tamanho da partição de dados raiz usando um novo appliance - -1. Configure uma nova instância do {% data variables.product.prodname_ghe_server %} com um disco raiz maior usando a mesma versão do appliance atual. Para obter mais informações, consulte "[Configurar uma instância do {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-github-enterprise-server-instance)". -2. Desligue o appliance atual. -3. Desvincule o disco de dados do appliance atual usando as ferramentas da plataforma de virtualização. -4. Vincule o disco de dados ao novo appliance com o disco raiz maior. - -### Aumentar o tamanho da partição de dados raiz usando um appliance existente - -1. Vincule o novo disco ao appliance do {% data variables.product.prodname_ghe_server %}. -2. Execute o comando `parted` para formatar o disco: - ```shell - $ sudo parted /dev/xvdg mklabel msdos - $ sudo parted /dev/xvdg mkpart primary ext4 0% 50% - $ sudo parted /dev/xvdg mkpart primary ext4 50% 100% - ``` -3. Execute o comando `ghe-upgrade` para instalar um pacote completo específico da plataforma no disco recém-particionado. Pacotes de atualização de hotpatch universais, como `github-enterprise-2.11.9.hpkg`, não funcionarão conforme o esperado. - ```shell - $ ghe-upgrade PACKAGE-NAME.pkg -s -t /dev/xvdg1 - ``` -4. Desligue o appliance. -5. No hipervisor, remova o disco raiz antigo e vincule o novo disco raiz no mesmo local do antigo. -6. Inicie o appliance. diff --git a/translations/pt-BR/content/admin/installation/initiating-a-failover-to-your-replica-appliance.md b/translations/pt-BR/content/admin/installation/initiating-a-failover-to-your-replica-appliance.md deleted file mode 100644 index f8557aae4eb4..000000000000 --- a/translations/pt-BR/content/admin/installation/initiating-a-failover-to-your-replica-appliance.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Iniciar failover do appliance réplica -intro: 'É possível fazer failover de um appliance réplica do {% data variables.product.prodname_ghe_server %} usando a linha de comando para manutenção e teste ou em caso de falha do appliance primário.' -redirect_from: - - /enterprise/admin/installation/initiating-a-failover-to-your-replica-appliance -versions: - enterprise-server: '*' ---- - -O tempo do failover dependerá do tempo necessário para promover manualmente a réplica e redirecionar o tráfego. Em média, o procedimento leva de dois a dez minutos. - -{% data reusables.enterprise_installation.promoting-a-replica %} - -1. Para permitir que a replicação termine antes de você alternar os appliances, coloque o appliance principal no modo de manutenção: - - Para usar o console de gerenciamento, consulte "[Habilitar e programar o modo de manutenção](/enterprise/admin/guides/installation/enabling-and-scheduling-maintenance-mode/)"; - - Você também pode usar o comando `ghe-maintenance -s`. - ```shell - $ ghe-maintenance -s - ``` -2. Quando o número de operações ativas do Git chegar a zero, aguarde 30 segundos. -3. Para verificar todos os canais de replicação que reportarem `OK`, use o comando `ghe-repl-status -vv`. - ```shell - $ ghe-repl-status -vv - ``` -4. Para parar a replicação e promover o appliance réplica ao status de primário, use o comando `ghe-repl-promote`. A ação também colocará automaticamente o nó primário no nó de manutenção, se ele for acessível. - ```shell - $ ghe-repl-promote - ``` -5. Atualize o registro DNS para apontar para o endereço IP do appliance réplica. O tráfego é direcionado para o réplica após o término do período TTL. Se você estiver usando um balanceador de carga, verifique se ele está configurado para enviar tráfego para o réplica. -6. Avise aos usuários que eles podem voltar a trabalhar normalmente. -7. Se desejar, configure a replicação do novo primário para os appliances existentes e o primário anterior. Para obter mais informações, consulte "[Sobre a configuração de alta disponibilidade](/enterprise/{{ currentVersion }}/admin/guides/installation/about-high-availability-configuration/#utilities-for-replication-management)". - -### Further reading - -- [Utilitários para gerenciamento de replicações](/enterprise/{{ currentVersion }}/admin/guides/installation/about-high-availability-configuration/#utilities-for-replication-management) diff --git a/translations/pt-BR/content/admin/installation/log-forwarding.md b/translations/pt-BR/content/admin/installation/log-forwarding.md deleted file mode 100644 index 64aa5383f05a..000000000000 --- a/translations/pt-BR/content/admin/installation/log-forwarding.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Encaminhamento de logs -intro: 'O {% data variables.product.prodname_enterprise %} usa `syslog-ng` para encaminhar logs do sistema e de aplicativos para o servidor especificado nas configurações do {% data variables.enterprise.management_console %}.' -redirect_from: - - /enterprise/admin/articles/log-forwarding/ - - /enterprise/admin/installation/log-forwarding -versions: - enterprise-server: '*' ---- - -Qualquer sistema de coleta de logs com suporte a fluxos de logs do estilo syslog é compatível (por exemplo, [Logstash](http://logstash.net/) e [Splunk](http://docs.splunk.com/Documentation/Splunk/latest/Data/Monitornetworkports)). - -### Habilitar o encaminhamento de logs - -1. Na página de configurações do {% data variables.enterprise.management_console %}, na barra lateral esquerda, clique em **Monitoring** (Monitoramento). -1. Selecione **Enable log forwarding** (Habilitar encaminhamento de logs). -1. No campo **Server address** (Endereço do servidor), digite o endereço do servidor para o qual você pretende encaminhar os logs. É possível especificar vários endereços em uma lista separada por vírgulas. -1. No menu suspenso Protocol (Protocolo), selecione o protocolo a ser usado para comunicação com o servidor de logs. O protocolo será aplicado a todos os destinos de log especificados. -1. Selecione **Enable TLS** (Habilitar TLS). -1. Clique em **Choose File** (Escolher arquivo) e escolha um certificado CA para criptografar a comunicação entre os pontos de extremidade do syslog. Toda a cadeia de certificados será validada e deverá terminar em um certificado raiz. Para obter mais informações, consulte [as opções de TLS na documentação syslog-ng](https://support.oneidentity.com/technical-documents/syslog-ng-open-source-edition/3.16/administration-guide/56#TOPIC-956599). - -### Solução de problemas - -Em caso de problemas com o encaminhamento de logs, entre em contato com o {% data variables.contact.contact_ent_support %} e anexe o arquivo de saída de `http(s)://[hostname]/setup/diagnostics` ao seu e-mail. diff --git a/translations/pt-BR/content/admin/installation/managing-billing-for-github-enterprise.md b/translations/pt-BR/content/admin/installation/managing-billing-for-github-enterprise.md deleted file mode 100644 index 5174ba7ad507..000000000000 --- a/translations/pt-BR/content/admin/installation/managing-billing-for-github-enterprise.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: Gerenciando a cobrança do GitHub Enterprise -intro: 'Você pode visualizar o uso da licença, as faturas, o histórico de pagamentos e outras informações de cobrança para sua conta corporativa e instâncias {% data variables.product.prodname_ghe_server %}.' -product: '{% data reusables.gated-features.enterprise-accounts %}' -redirect_from: - - /enterprise/admin/installation/managing-billing-for-github-enterprise -versions: - enterprise-server: '*' ---- - -### Sobre a cobrança de contas corporativas - -As contas corporativas atualmente estão disponíveis para clientes do {% data variables.product.prodname_enterprise %} que pagam com fatura. A cobrança de todas as organizações e instâncias {% data variables.product.prodname_ghe_server %} conectadas à sua conta corporativa é agregada em uma única fatura para todos os seus serviços pagos do {% data variables.product.prodname_dotcom_the_website %} (incluindo licenças pagas nas organizações, pacotes de dados do {% data variables.large_files.product_name_long %} e assinaturas de apps do {% data variables.product.prodname_marketplace %}). - -Proprietários corporativos e gerentes de cobrança podem acessar e gerenciar todas as configurações de cobrança relativas a contas corporativas. Para obter mais informações sobre contas corporativas, consulte "[Funções de uma conta corporativa](/github/setting-up-and-managing-your-enterprise-account/roles-for-an-enterprise-account)". Para obter mais informações sobre como administrar gerentes de cobrança, consulte "[Convidar pessoas para gerenciar sua conta corporativa](/github/setting-up-and-managing-your-enterprise-account/inviting-people-to-manage-your-enterprise-account)". - -### Visualizando sua fatura atual - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.billing-tab %} -4. Em "Quick Actions" (Ações rápidas), clique em **View invoice** (Visualizar fatura). ![Link de visualização da fatura](/assets/images/help/business-accounts/view-invoice-link.png) - -### Pagando sua fatura atual - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.billing-tab %} -4. Em "Quick Actions" (Ações rápidas), clique em **Pay invoice** (Pagar fatura). ![Link de pagamento da fatura](/assets/images/help/business-accounts/pay-invoice-link.png) -5. Em "Pagar fatura", digite as informações do seu cartão de crédito no formulário de segurança e clique em **Pay Invoice** (Pagar fatura). ![Confirmar e pagar a fatura](/assets/images/help/business-accounts/pay-invoice.png) - -### Baixando sua fatura atual - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.billing-tab %} -4. Em "Quick Actions" (Ações rápidas), clique em **Download current invoice** (Baixar fatura atual). ![Link para baixar fatura atual](/assets/images/help/business-accounts/download-current-invoice.png) - -### Visualizando seu histórico de pagamento - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.billing-tab %} -4. Em "Faturamento", clique na aba **Past Invoices** (Últimas Faturas) para ver um resumo de sua atividade anterior de faturamento. ![Aba de visualização de histórico de pagamento](/assets/images/help/business-accounts/view-payment-history.png) diff --git a/translations/pt-BR/content/admin/installation/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud.md b/translations/pt-BR/content/admin/installation/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud.md deleted file mode 100644 index cdc89fde7d19..000000000000 --- a/translations/pt-BR/content/admin/installation/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: Gerenciar conexões entre o GitHub Enterprise Server e o GitHub Enterprise Cloud -intro: 'Com o {% data variables.product.prodname_github_connect %}, você pode compartilhar determinados recursos entre a {% data variables.product.product_location_enterprise %} e a sua conta corporativa ou de organização do {% data variables.product.prodname_ghe_cloud %} no {% data variables.product.prodname_dotcom_the_website %}.' -mapTopic: true -redirect_from: - - /enterprise/admin/developer-workflow/connecting-github-enterprise-to-github-com - - /enterprise/admin/guides/developer-workflow/connecting-github-enterprise-and-github-com/ - - /enterprise/admin/guides/developer-workflow/connecting-github-enterprise-server-and-github-com/ - - /enterprise/admin/developer-workflow/connecting-github-enterprise-server-and-githubcom/ - - /enterprise/admin/installation/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud -versions: - enterprise-server: '*' ---- - diff --git a/translations/pt-BR/content/admin/installation/managing-your-github-enterprise-license.md b/translations/pt-BR/content/admin/installation/managing-your-github-enterprise-license.md deleted file mode 100644 index 3c7dcb9448c6..000000000000 --- a/translations/pt-BR/content/admin/installation/managing-your-github-enterprise-license.md +++ /dev/null @@ -1,70 +0,0 @@ ---- -title: Gerenciando sua licença do GitHub Enterprise -intro: 'Você pode visualizar, gerenciar e atualizar sua licença do {% data variables.product.prodname_enterprise %}.' -redirect_from: - - /enterprise/admin/categories/licenses/ - - /enterprise/admin/articles/license-files/ - - /enterprise/admin/installation/about-license-files/ - - /enterprise/admin/articles/downloading-your-license/ - - /enterprise/admin/installation/downloading-your-license/ - - /enterprise/admin/articles/upgrading-your-license/ - - /enterprise/admin/installation/updating-your-license/ - - /enterprise/admin/installation/managing-your-github-enterprise-server-license - - /enterprise/admin/installation/managing-your-github-enterprise-license -versions: - enterprise-server: '*' ---- - -### Sobre as licenças do {% data variables.product.prodname_enterprise %} - -Ao comprar ou renovar o {% data variables.product.prodname_enterprise %}, você recebe um arquivo de licença para validar seu aplicativo. Um arquivo de licença tem data de validade e controla o número de licenças de usuário que você pode adicionar ao {% data variables.product.prodname_enterprise %}. Depois de baixar e instalar o {% data variables.product.prodname_enterprise %}, fazer upload do arquivo de licença desbloqueia o aplicativo para uso. - -Você pode alocar as licenças de usuário incluídas na sua licença da {% data variables.product.prodname_enterprise %} a usuários na {% data variables.product.product_location_enterprise %} e a uma conta corporativa do {% data variables.product.prodname_ghe_cloud %}. Quando você adiciona um usuário a um dos ambientes, ele consome uma licença. Se um usuário tem contas em ambos os ambientes, para consumir apenas uma licença, seu endereço de e-mail principal de {% data variables.product.prodname_enterprise %} deve ser o mesmo que seu endereço de e-mail verificado em {% data variables.product.prodname_ghe_cloud %}. Você pode sincronizar a contagem e o uso de licenças entre os ambientes. - -Se a sua licença do {% data variables.product.prodname_ghe_server %} expirar, você não poderá acessar a {% data variables.product.product_location_enterprise %} via navegador da web ou Git. Se necessário, você poderá usar os utilitários de linha de comando para fazer backup de todos os seus dados. Para obter mais informações, consulte "[Configurar backups no appliance](/enterprise/admin/guides/installation/configuring-backups-on-your-appliance)". Se você tiver alguma dúvida sobre a renovação da sua licença, contate {% data variables.contact.contact_enterprise_sales %}. - -### Fazer upload de uma nova licença para o {% data variables.product.prodname_ghe_server %} - -Depois de comprar uma nova licença ou atualizar uma licença existente de {% data variables.contact.contact_enterprise_sales %}, você deve baixar seu novo arquivo de licença e fazer upload desse arquivo no {% data variables.product.prodname_ghe_server %} para desbloquear suas novas licenças de usuário. - -Caso queira renovar ou adicionar licenças de usuário com o {% data variables.product.prodname_enterprise %}, entre em contato com {% data variables.contact.contact_enterprise_sales %}. Seu novo arquivo de licença estará disponível para download logo após a conclusão do pedido. - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.enterprise-licensing-tab %} -4. Em "Enterprise Server Instances", clique em {% octicon "download" aria-label="The download icon" %} para fazer o download do seu arquivo de licença. ![Baixar licença do GitHub Enterprise Server](/assets/images/help/business-accounts/download-ghes-license.png) -5. Faça login na sua instância do {% data variables.product.prodname_ghe_server %} como administrador do site. -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.license-tab %} -12. Em "Quick links" (Links rápidos), clique em **Update license** (Atualizar licença). ![Link de atualização de licença](/assets/images/enterprise/business-accounts/update-license-link.png) -13. Para selecionar sua licença, clique em **License file** (Arquivo de licença) ou arraste o arquivo de licença para o **License file** (Arquivo de licença). ![Fazer upload do arquivo de licença](/assets/images/enterprise/management-console/upload-license.png) -14. Clique em **Upload**. ![Iniciar atualização](/assets/images/enterprise/management-console/begin-upload.png) - -### Exibir o uso de licenças - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.enterprise-licensing-tab %} -4. Revise sua licença atual de {% data variables.product.prodname_enterprise %}, bem como licenças de usuário consumidas e disponíveis. - -### Sincronizar automaticamente o uso da licença de usuário com o {% data variables.product.prodname_ghe_cloud %} - -É possível usar o {% data variables.product.prodname_github_connect %} para sincronizar automaticamente o uso e a contagem da licença de usuários entre o {% data variables.product.prodname_ghe_server %} e o {% data variables.product.prodname_ghe_cloud %}. Para obter mais informações, consulte "[Habilitar a sincronização de licenças de usuário entre o {% data variables.product.prodname_ghe_server %} e o {% data variables.product.prodname_ghe_cloud %}](/enterprise/{{currentVersion}}/admin/installation/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud)". - -### Sincronizando manualmente o uso da licença de usuário entre {% data variables.product.prodname_ghe_server %} e {% data variables.product.prodname_ghe_cloud %} - -Para sincronizar manualmente o uso das licenças de usuário entre as duas implantações, você pode baixar um arquivo JSON do {% data variables.product.prodname_ghe_server %} e fazer upload desse arquivo no {% data variables.product.prodname_ghe_cloud %}. - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.license-tab %} -5. Em "Quick links" (Links rápidos), para baixar um arquivo com o uso da sua licença atual no {% data variables.product.prodname_ghe_server %}, clique em **Export license usage** (Exportar uso de licença). ![Exportar link de uso de licença](/assets/images/enterprise/business-accounts/export-license-usage-link.png) -6. Navegue até o {% data variables.product.prodname_ghe_cloud %}. -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.enterprise-licensing-tab %} -10. Em "Instâncias Enterprise Server", clique em **Add server usage** (Adicionar uso de servidor). ![Fazer upload do link de uso do GitHub Enterprise Server](/assets/images/help/business-accounts/upload-ghe-server-usage-link.png) -11. Faça upload do arquivo JSON que você baixou do {% data variables.product.prodname_ghe_server %}.![Arrastar e soltar ou selecionar um arquivo para upload](/assets/images/help/business-accounts/upload-ghe-server-usage-file.png) diff --git a/translations/pt-BR/content/admin/installation/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later.md b/translations/pt-BR/content/admin/installation/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later.md deleted file mode 100644 index d224567945be..000000000000 --- a/translations/pt-BR/content/admin/installation/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later.md +++ /dev/null @@ -1,128 +0,0 @@ ---- -title: Migrar índices do Elasticsearch para o GitHub Enterprise Server 2.14 ou mais recente -intro: 'Ao se preparar para atualizar para o {% data variables.product.prodname_ghe_server %} 2.14, você terá que migrar seus índices para o Elasticsearch 5.6 com nosso script de migração.' -redirect_from: - - /enterprise/admin/guides/installation/migrating-elasticsearch-indices-to-github-enterprise-2-14-or-later/ - - /enterprise/admin/guides/installation/migrating-elasticsearch-indices-to-github-enterprise-server-2-14-or-later - - /enterprise/admin/installation/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later -versions: - enterprise-server: '*' ---- - -O {% data variables.product.prodname_ghe_server %} 2.14 inclui a atualização para o Elasticsearch 5.6. Antes de atualizar para o {% data variables.product.prodname_ghe_server %} 2.14 ou mais recente partindo da versão 2.12 ou 2.13, é recomendável baixar, instalar e executar as ferramentas de migração do Elasticsearch para que os maiores índices sejam migrados online enquanto o appliance ainda tem acesso online. - -### Índices de pesquisa - -O script de migração verifica qualquer índice `search` enquanto o appliance está online. A migração dos índices `search` pode levar de minutos a dias, dependendo do tamanho dos índices. Para ver um exemplo de índices grandes, a migração desses índices levou alguns dias em nosso ambiente de teste. - -``` -admin@ip-172-31-2-141:~$ curl -s http://localhost:9200/_cat/indices?v | sort -n -k 6 -green open blog-1 1 0 0 0 144b 144b -green open projects-1 1 0 0 0 144b 144b -green open registry-packages-1 1 0 0 0 144b 144b -green open showcases-1 1 0 0 0 144b 144b -health status index pri rep docs.count docs.deleted store.size pri.store.size -green open pull-requests-1 1 0 1 0 9.3kb 9.3kb -green open wikis-1 1 0 2 0 5kb 5kb -green open hookshot-logs-2018-05-29 5 0 25 0 124.2kb 124.2kb -green open repos-1 1 0 1638 1 1.4mb 1.4mb -green open gists-1 1 0 3531 64 291.9kb 291.9kb -green open audit_log-1-2018-06-1 1 0 11108 0 3mb 3mb -green open users-1 1 0 19866 56 2.7mb 2.7mb -green open hookshot-logs-2018-05-31 5 0 20000 0 33.4mb 33.4mb -green open hookshot-logs-2018-06-04 5 0 20000 0 32.6mb 32.6mb -green open issues-1 1 0 26405 6 82.8mb 82.8mb -green open hookshot-logs-2018-05-30 5 0 119744 0 196.8mb 196.8mb -green open audit_log-1-2018-05-1 1 0 191664 0 50mb 50mb -green open code-search-1 1 0 6932626 44 42.9gb 42.9gb -green open commits-1 1 0 63753587 1485 45.4gb 45.4gb -``` - -Os índices `search` começam por: - -- blog- -- code-search- -- commits- -- gists- -- issues- -- labels- -- marketplace-listings- -- non-marketplace-listings- -- projects- -- pull-requests- -- registry-packages- -- repos- -- showcases- -- topics- -- users- - -### Índices de webhook - -Depois que o script de migração recriar online os índices `search` necessários, o script verificará se algum índice `webhook` precisa ser recompilado. Se executou seu appliance com o {% data variables.product.prodname_ghe_server %} 2.12 ou 2.13 por 14 dias ou mais, provavelmente você não precisará dos índices `webhook` recompilados, já que os índices `webhook` têm uma política de retenção padrão de sete dias. Se você estiver atualizando seu appliance a partir do {% data variables.product.prodname_enterprise %} 2.11 ou anterior, talvez seja necessário recompilar os índices `webhook`. - -Se algum índice `webhook` tiver que ser recompilado, você receberá uma solicitação para habilitar o modo de manutenção antes que o script possa recompilar os índices `webhook`. Embora a migração dos índices `webhook` cause algum tempo de inatividade, não é necessário programar longos períodos de manutenção ou inatividade. - -Os índices `webhook` começam por `hookshot-logs-`. - -### Índices disponíveis - -Veja os índices disponíveis no seu appliance usando curl. - -``` -admin@ip-172-31-2-141:~$ curl -s http://localhost:9200/_cat/indices?v | sort -n -k 6 -green open blog-1 1 0 0 0 144b 144b -green open projects-1 1 0 0 0 144b 144b -green open registry-packages-1 1 0 0 0 144b 144b -green open showcases-1 1 0 0 0 144b 144b -health status index pri rep docs.count docs.deleted store.size pri.store.size -green open pull-requests-1 1 0 1 0 9.3kb 9.3kb -green open wikis-1 1 0 2 0 5kb 5kb -green open hookshot-logs-2018-05-29 5 0 25 0 124.2kb 124.2kb -green open repos-1 1 0 1638 1 1.4mb 1.4mb -green open gists-1 1 0 3531 64 291.9kb 291.9kb -green open audit_log-1-2018-06-1 1 0 11108 0 3mb 3mb -green open users-1 1 0 19866 56 2.7mb 2.7mb -green open hookshot-logs-2018-05-31 5 0 20000 0 33.4mb 33.4mb -green open hookshot-logs-2018-06-04 5 0 20000 0 32.6mb 32.6mb -green open issues-1 1 0 26405 6 82.8mb 82.8mb -green open hookshot-logs-2018-05-30 5 0 119744 0 196.8mb 196.8mb -green open audit_log-1-2018-05-1 1 0 191664 0 50mb 50mb -green open code-search-1 1 0 6932626 44 42.9gb 42.9gb -green open commits-1 1 0 63753587 1485 45.4gb 45.4gb -``` - -### Preparar um appliance do {% data variables.product.prodname_ghe_server %} 2.12 ou 2.13 - -Se você atualizar para o {% data variables.product.prodname_ghe_server %} 2.14 ou mais recente sem executar as ferramentas de migração, os índices do Elasticsearch podem ficar inválidos e não funcionar corretamente. Para executar o scripts de migração do Elasticsearch, seu appliance do {% data variables.product.prodname_ghe_server %} deve estar executando o {% data variables.product.prodname_enterprise %} 2.12 ou o 2.13. - -{% warning %} - -**Aviso:** -- Usar o {% data variables.product.prodname_enterprise_backup_utilities %} destruirá índices antigos do Elasticsearch não compatíveis com as versões 5.X após a restauração. Nesse caso, talvez seja necessário fazer a reindexação manual. -- Se o {% data variables.product.prodname_ghe_server %} estiver configurado para alta disponibilidade, o script de migração **deve** ser executado ainda durante a execução da replicação. Antes de iniciar a atualização, é necessário permitir que as alterações sejam replicadas totalmente no outro appliance. Se a replicação não estiver em execução enquanto o script de migração for executado, os índices do Elasticsearch poderão ficar inválidos. - -{% endwarning %} - -1. Autentique para o appliance primário com a Alta Disponibilidade habilitada usando SSH. -2. Baixe e instale o script de migração para o appliance: - ```shell - $ wget https://github-enterprise.s3.amazonaws.com/util/es-5x-transition-tools.tar.gz - $ sudo tar -C / -xvf es-5x-transition-tools.tar.gz - ``` - Se você gerenciar um cluster do {% data variables.product.prodname_ghe_server %}, autentique em um dos nós do servidor Elasticsearch usando SSH e instale as ferramentas de migração nele. Localize usando o seguinte: - ```shell - $ ghe-cluster-each -r elasticsearch -p - ghe-test-data-0 - ghe-test-data-1 - ghe-test-data-2 - ``` -2. Execute o script de migração: - ```shell - $ /usr/local/share/enterprise/ghe-es-5x-migration -r - ``` - {% note %} - - **Observação:** se tiver índices `webhook` para migrar, você receberá uma solicitação para ativar o modo de manutenção após executar as migrações online. - - {% endnote %} -3. Se você estiver executando um cluster do {% data variables.product.prodname_ghe_server %}, siga a documentação oficial da atualização para ambientes únicos de VMs ou alta disponibilidade, ou consulte o guia de atualização do cluster. Para obter mais informações, consulte "[Atualizar o {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-github-enterprise-server/)" ou "[Atualizar um cluster](/enterprise/{{ currentVersion }}/admin/guides/clustering/upgrading-a-cluster/)". diff --git a/translations/pt-BR/content/admin/installation/migrating-from-github-enterprise-1110x-to-2123.md b/translations/pt-BR/content/admin/installation/migrating-from-github-enterprise-1110x-to-2123.md deleted file mode 100644 index 702975627a04..000000000000 --- a/translations/pt-BR/content/admin/installation/migrating-from-github-enterprise-1110x-to-2123.md +++ /dev/null @@ -1,90 +0,0 @@ ---- -title: Migrar do GitHub Enterprise 11.10.x para o 2.1.23 -redirect_from: - - /enterprise/admin-guide/migrating/ - - /enterprise/admin/articles/migrating-github-enterprise/ - - /enterprise/admin/guides/installation/migrating-from-github-enterprise-v11-10-34x/ - - /enterprise/admin/articles/upgrading-to-a-newer-release/ - - /enterprise/admin/guides/installation/migrating-to-a-different-platform-or-from-github-enterprise-11-10-34x/ - - /enterprise/admin/guides/installation/migrating-from-github-enterprise-11-10-x-to-2-1-23 - - /enterprise/admin/installation/migrating-from-github-enterprise-1110x-to-2123 -intro: 'Para migrar do {% data variables.product.prodname_enterprise %} 11.10.x para o 2.1.23, você precisará configurar uma nova instância do appliance e migrar os dados da instância anterior.' -versions: - enterprise-server: '*' ---- - -Há suporte para migrações do {% data variables.product.prodname_enterprise %} 11.10.348 e mais recentes. Não há suporte para migrações do {% data variables.product.prodname_enterprise %} 11.10.348 e versões anteriores. Você deve atualizar o 11.10.348 em várias etapas de atualização. Para obter mais informações, consulte o procedimento de atualização do 11.10.348, "[Atualizar para a versão mais recente](/enterprise/11.10.340/admin/articles/upgrading-to-the-latest-release/)". - -Para atualizar para a versão mais recente do {% data variables.product.prodname_enterprise %}, você deve migrar para a versão {% data variables.product.prodname_ghe_server %} 2.1 e só então poderá seguir o processo regular. Para obter mais informações, consulte "[Atualizar o {% data variables.product.prodname_enterprise %}](/enterprise/admin/guides/installation/upgrading-github-enterprise-server/)". - -### Preparar para a migração - -1. Revise o guia de provisionamento e instalação e verifique se foram atendidos todos os pré-requisitos necessários para provisionar e configurar o {% data variables.product.prodname_enterprise %} 2.1.23 no seu ambiente. Para obter mais informações, consulte "[Provisionar e instalar](/enterprise/2.1/admin/guides/installation/provisioning-and-installation/)". -2. Verifique se a instância atual está sendo executada em uma versão de atualização compatível. -3. Configure a versão mais recente do {% data variables.product.prodname_enterprise_backup_utilities %}. Para obter mais informações, consulte [{% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils). - - Se você já configurou backups programados usando o {% data variables.product.prodname_enterprise_backup_utilities %}, certifique-se de atualizar para a versão mais recente. - - Se você não estiver executando backups programados no momento, configure o {% data variables.product.prodname_enterprise_backup_utilities %}. -4. Faça um instantâneo inicial de backup completo da instância atual usando o comando `ghe-backup`. Se você já configurou backups programados na instância atual, não será necessário obter o instantâneo. - - {% tip %} - - **Dica:** durante a obtenção do instantâneo, você pode deixar a instância online e em uso. Você fará outro instantâneo durante a parte de manutenção da migração. Como os backups são incrementais, o instantâneo inicial reduz a quantidade de dados transferidos no instantâneo final, o que pode reduzir o período de manutenção. - - {% endtip %} - -5. Determine o método para alternar o tráfego de rede do usuário para a nova instância. Após a migração, todo o tráfego de rede HTTP e Git será direcionado para a nova instância. - - **DNS** - Esse método é recomendável para todos os ambientes porque é simples e funciona bem, mesmo ao migrar de um datacenter para outro. Antes de iniciar a migração, reduza o TTL do registro DNS para cinco minutos ou menos e permita a propagação da alteração. Quando a migração for concluída, atualize o(s) registro(s) DNS de modo a apontar para o endereço IP da nova instância. - - **Atribuição de endereço IP** - Este método só está disponível na migração de VMware para VMware e é recomendado apenas se o método DNS não estiver disponível. Antes de iniciar a migração, você terá que desligar a instância antiga e atribuir seu endereço IP à nova instância. -6. Programe um período de manutenção. O período de manutenção deve abranger tempo suficiente para transferir os dados do host de backup para a nova instância. Esse período varia com base no tamanho do instantâneo de backup e na largura de banda de rede disponível. Durante esse período, sua instância atual ficará indisponível e em modo de manutenção enquanto você migra para a nova instância. - -### Fazer a migração - -1. Provisione uma nova instância do {% data variables.product.prodname_enterprise %} 2.1. Para obter mais informações, consulte o guia "[Provisionar e instalar](/enterprise/2.1/admin/guides/installation/provisioning-and-installation/)" da plataforma de destino. -2. Em um navegador, vá até o novo endereço IP do appliance réplica e faça o upload da sua licença do {% data variables.product.prodname_enterprise %}. -3. Defina uma senha de administrador. -5. Clique em **Migrate** (Migrar). ![Escolher o tipo de instalação](/assets/images/enterprise/migration/migration-choose-install-type.png) -6. Cole a chave SSH de acesso ao host de backup em "Add new SSH key" (Adicionar nova chave SSH). ![Autorizar o backup](/assets/images/enterprise/migration/migration-authorize-backup-host.png) -7. Clique em **Add key** (Adicionar chave) e em **Continue** (Continuar). -8. Copie o comando `ghe-restore` a ser executado no host do backup para migrar os dados para a nova instância. ![Iniciar a migração](/assets/images/enterprise/migration/migration-restore-start.png) -9. Habilite o modo de manutenção na instância antiga e aguarde a conclusão de todos os processos ativos. Para obter mais informações, consulte "[Habilitar e programar o modo de manutenção](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)". - - {% note %} - - **Observação:** a partir deste momento, a instância ficará indisponível para uso regular. - - {% endnote %} - -10. No host do backup, execute o comando `ghe-backup` para fazer o último instantâneo de backup. Essa ação garante a obtenção de todos os dados da instância antiga. -11. No host de backup, execute o comando `ghe-restore` que você copiou na tela de status de restauração da nova instância para restaurar o instantâneo mais recente. - ```shell - $ ghe-restore 169.254.1.1 - The authenticity of host '169.254.1.1:122' can't be established. - A impressão digital da chave RSA é fe:96:9e:ac:d0:22:7c:cf:22:68:f2:c3:c9:81:53:d1. - Tem certeza de que deseja continuar com a conexão (sim/não)? yes - Connect 169.254.1.1:122 OK (v2.0.0) - Starting restore of 169.254.1.1:122 from snapshot 20141014T141425 - Restoring Git repositories ... - Restaurando o GitHub Pages... - Restaurando anexos de ativos... - Restaurando entregas de hooks... - Restaurando o database MySQL... - Restaurando o database Redis... - Restaurando chaves SSH autorizadas... - Restaurando índices do Elasticsearch... - Restaurando chaves SSH de host... - Completed restore of 169.254.1.1:122 from snapshot 20141014T141425 - Visit https://169.254.1.1/setup/settings to review appliance configuration. - ``` - -12. Volte à tela de status de restauração da nova instância para confirmar a conclusão da restauração. ![Tela de restauração concluída](/assets/images/enterprise/migration/restore-complete-screen.png) -13. Clique em **Continue to settings** (Continuar em configurações) para revisar e ajustar as informações de configuração importadas da instância anterior. ![Revisar configurações importadas](/assets/images/enterprise/migration/migration-status-complete.png) -14. Clique em **Save settings** (Salvar configurações). - - {% note %} - - **Observação:** você pode usar a nova instância depois de aplicar as definições de configuração e reiniciar o servidor. - - {% endnote %} - -15. Alterne o tráfego de rede do usuário da instância antiga para a nova instância usando a atribuição de endereço DNS ou IP. -16. Atualize para a versão de patch mais recente da versão {{ currentVersion }}. Para obter mais informações, consulte "[Atualizar o {% data variables.product.prodname_ghe_server %}](/enterprise/admin/guides/installation/upgrading-github-enterprise-server/)". diff --git a/translations/pt-BR/content/admin/installation/migrating-to-a-different-git-large-file-storage-server.md b/translations/pt-BR/content/admin/installation/migrating-to-a-different-git-large-file-storage-server.md deleted file mode 100644 index d43907f46cb4..000000000000 --- a/translations/pt-BR/content/admin/installation/migrating-to-a-different-git-large-file-storage-server.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Migrar para outro servidor do Git Large File Storage -intro: 'Você pode migrar para um novo servidor do {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) usando o cliente do {% data variables.large_files.product_name_short %} para fazer fetch de ativos do servidor atual e fazer push deles para o novo local.' -redirect_from: - - /enterprise/admin/guides/installation/migrating-to-different-large-file-storage-server/ - - /enterprise/admin/installation/migrating-to-a-different-git-large-file-storage-server -versions: - enterprise-server: '*' ---- - -Antes de migrar para outro servidor do {% data variables.large_files.product_name_long %}, configure o {% data variables.large_files.product_name_short %} para usar um servidor de terceiros. Para obter mais informações, consulte "[Configurar o {% data variables.large_files.product_name_long %} para usar um servidor de terceiros](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-git-large-file-storage-to-use-a-third-party-server)". - -1. Configure o repositório com outro remote. - ```shell - $ git remote add NEW-REMOTE https://NEW-REMOTE-HOSTNAME/path/to/repo -   - $ git lfs env - > git-lfs/1.1.0 (GitHub; darwin amd64; go 1.5.1; git 94d356c) - > git version 2.7.4 (Apple Git-66) -   - > Endpoint=https://GITHUB-ENTERPRISE-HOST/path/to/repo/info/lfs (auth=basic) - > Endpoint (NEW-REMOTE)=https://NEW-REMOTE-HOSTNAME/path/to/repo/info/lfs (auth=none) - ``` - -2. Faça fetch de todos os objetos do remote antigo. - ```shell - $ git lfs fetch origin --all - > Scanning for all objects ever referenced... - > ✔ 16 objects found - > Fetching objects... - > Git LFS: (16 de 16 arquivos) 48.71 MB / 48.85 MB - ``` - -3. Faça push de todos os objetos para o remote novo. - ```shell - $ git lfs push NEW-REMOTE --all - > Scanning for all objects ever referenced... - > ✔ 16 objects found - > Pushing objects... - > Git LFS: (16 de 16 arquivos) 48.00 MB / 48.85 MB, 879.10 KB ignorados - ``` diff --git a/translations/pt-BR/content/admin/installation/migrating-to-internal-repositories.md b/translations/pt-BR/content/admin/installation/migrating-to-internal-repositories.md deleted file mode 100644 index bca1b68034fe..000000000000 --- a/translations/pt-BR/content/admin/installation/migrating-to-internal-repositories.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: Migrando para repositórios internos -intro: 'Você pode migrar para repositórios internos para unificar a experiência interna para desenvolvedores usando {% data variables.product.prodname_ghe_server %} e {% data variables.product.prodname_ghe_cloud %}.' -permissions: Os administradores do site podem migrar para repositórios internos. -redirect_from: - - /enterprise/admin/installation/migrating-to-internal-repositories -versions: - enterprise-server: '>=2.20' ---- - -### Sobre repositórios internos - -Os repositórios internos estão disponíveis em {% data variables.product.prodname_ghe_server %} 2.20+. {% data reusables.repositories.about-internal-repos %} Para obter mais informações, consulte "[Sobre a visibilidade do repositório](/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)". - -Em versões futuras do {% data variables.product.prodname_ghe_server %}, ajustaremos como a visibilidade do repositório funciona para que os termos público, interno e privado tenham significados uniformes para desenvolvedores em {% data variables.product.prodname_ghe_server %} e {% data variables.product.prodname_ghe_cloud %}. - -Para se preparar para essas alterações, se você tiver o modo privado ativado, é possível executar uma migração em sua instância para converter repositórios públicos em internos. Essa migração é atualmente opcional, para permitir que você teste as mudanças em uma instância não produtiva. A migração será obrigatória no futuro. - -Quando você efetuar a migração, todos os repositórios públicos pertencentes a organizações na sua instância se tornarão repositórios internos. Se qualquer um desses repositórios tiver bifurcações, as bifurcações vão se tornar privadas. Repositórios privados permanecerão privados. - -Todos os repositórios públicos pertencentes a contas de usuário na sua instância se tornarão repositórios privados. Se qualquer um desses repositórios tiver bifurcações, as bifurcações vão se tornar privadas. O proprietário de cada bifurcação receberá permissões de leitura para o principal da bifurcação. - -O acesso de leitura anônimo Git será desativado para cada repositório público que se tornar interno ou privado. - -Se sua visibilidade padrão atual for pública, o padrão se tornará interno. Se o padrão atual for privado, o padrão não será alterado. Você pode alterar o padrão a qualquer momento. Para obter mais informações, consulte "[Configurar a visibilidade padrão de novos repositórios no seu appliance](/enterprise/admin/installation/configuring-the-default-visibility-of-new-repositories-on-your-appliance)". - -A política de criação de repositórios para a instância mudará para desativar repositórios públicos e permitir repositórios privados e internos. Você pode atualizar a política a qualquer momento. Para obter mais informações, consulte "[Restringir a criação de repositórios nas suas instâncias](/enterprise/admin/user-management/restricting-repository-creation-in-your-instance)". - -Se você não tiver o modo privado ativado, o script de migração não terá efeito. - -### Executando a migração - -1. Conecte-se ao shell administrativo. Para obter mais informações, consulte "[Acessar o shell administrativo (SSH)](/enterprise/{}/admin/installation/accessing-the-administrative-shell-ssh)". -2. Navegue no diretório `/data/github/current`. - ``` - cd /data/github/current - ``` -3. Execute o comando de migração. - ``` - sudo bin/safe-ruby lib/github/transitions/20191210220630_convert_public_ghes_repos_to_internal.rb -v -w | tee -a /tmp/convert_public_ghes_repos_to_internal.log - ``` - -O output do log aparecerá no terminal e no `/tmp/convert_public_ghes_repos_to_internal.log`. - -### Leia mais - -- [Habilitar modo privado](/enterprise/{}/admin/guides/installation/enabling-private-mode)" diff --git a/translations/pt-BR/content/admin/installation/monitoring-activity-on-your-github-enterprise-server-instance.md b/translations/pt-BR/content/admin/installation/monitoring-activity-on-your-github-enterprise-server-instance.md deleted file mode 100644 index b707b8c65190..000000000000 --- a/translations/pt-BR/content/admin/installation/monitoring-activity-on-your-github-enterprise-server-instance.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Monitorar a atividade na instância do GitHub Enterprise Server -mapTopic: true -redirect_from: - - /enterprise/admin/installation/monitoring-activity-on-your-github-enterprise-server-instance -versions: - enterprise-server: '*' ---- - diff --git a/translations/pt-BR/content/admin/installation/monitoring-using-snmp.md b/translations/pt-BR/content/admin/installation/monitoring-using-snmp.md deleted file mode 100644 index b22a3c926615..000000000000 --- a/translations/pt-BR/content/admin/installation/monitoring-using-snmp.md +++ /dev/null @@ -1,107 +0,0 @@ ---- -title: Monitorar usando SNMP -intro: 'O {% data variables.product.prodname_enterprise %} fornece dados sobre o uso de disco, CPU, memória e muito mais no SNMP.' -redirect_from: - - /enterprise/admin/articles/monitoring-using-snmp/ - - /enterprise/admin/installation/monitoring-using-snmp -versions: - enterprise-server: '*' ---- - -O SNMP é um padrão comum para monitorar dispositivos em uma rede. É altamente recomendável ativar o SNMP para monitorar a integridade da {% data variables.product.product_location_enterprise %} e saber quando adicionar mais memória, armazenamento ou potência do processador à máquina host. - -O {% data variables.product.prodname_enterprise %} tem uma instalação SNMP padrão que permite aproveitar [vários plugins](http://www.monitoring-plugins.org/doc/man/check_snmp.html) disponíveis para Nagios ou qualquer outro sistema de monitoramento. - -### Configurar SMTP v2c - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.access-monitoring %} -{% data reusables.enterprise_management_console.enable-snmp %} -4. No campo **Community string** (String de comunidade), insira a nova string da comunidade. Se deixada em branco, essa informação fica como `public` por padrão. ![Campo para adicionar a string da comunidade](/assets/images/enterprise/management-console/community-string.png) -{% data reusables.enterprise_management_console.save-settings %} -5. Teste a configuração SNMP executando o seguinte comando em uma estação de trabalho separada com suporte a SNMP na rede: - ```shell - # community-string is your community string - # hostname is the IP or domain of your Enterprise instance - $ snmpget -v 2c -c community-string -O e hostname hrSystemDate.0 - ``` - -Isso deve retornar o horário do sistema no host do {% data variables.product.product_location_enterprise %}. - -### Segurança baseada no usuário - -Se habilitar o SNMP v3, você poderá aproveitar o aumento da segurança baseada no usuário por meio do User Security Model (USM). É possível especificar um nível de segurança para cada usuário: -- `noAuthNoPriv`: este nível de segurança não oferece autenticação nem privacidade. -- `authNoPriv`: este nível de segurança oferece autenticação, mas não privacidade. Para consultar o appliance, você precisará de nome de usuário e senha (com pelo menos oito caracteres). As informações são enviadas sem criptografia, de modo semelhante ao SNMPv2. O protocolo de autenticação pode ser MD5 ou SHA, e o padrão é SHA. -- `authPriv`: este nível de segurança oferece autenticação e privacidade. A autenticação (com senha de no mínimo oito caracteres) é necessária, e as respostas são criptografadas. Não é necessário usar uma senha de privacidade, mas, se houver, ela deve ter no mínimo oito caracteres. Se não houver senha de privacidade, a senha de autenticação será usada. O protocolo de privacidade pode ser DES ou AES, e o padrão é AES. - -### Configurar usuários para o SNMP v3 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.access-monitoring %} -{% data reusables.enterprise_management_console.enable-snmp %} -4. Selecione **SNMP v3**. ![Botão para habilitar o SNMP v3](/assets/images/enterprise/management-console/enable-snmpv3.png) -5. Em "Username" (Nome de usuário), digite o nome exclusivo do seu usuário SNMP v3. ![Campo para digitar o nome de usuário SNMP v3](/assets/images/enterprise/management-console/snmpv3-username.png) -6. No menu suspenso **Security Level** (Nível de segurança), clique no nível de segurança do seu usuário SNMP v3. ![Menu suspenso para o nível de segurança do usuário SNMP v3](/assets/images/enterprise/management-console/snmpv3-securitylevel.png) -7. Para usuários SNMP v3 com nível de segurança `authnopriv`: ![Configurações para o nível de segurança authnopriv](/assets/images/enterprise/management-console/snmpv3-authnopriv.png) - - {% data reusables.enterprise_management_console.authentication-password %} - - {% data reusables.enterprise_management_console.authentication-protocol %} -8. Para usuários SNMP v3 com nível de segurança `authpriv`: ![Configurações para o nível de segurança authpriv](/assets/images/enterprise/management-console/snmpv3-authpriv.png) - - {% data reusables.enterprise_management_console.authentication-password %} - - {% data reusables.enterprise_management_console.authentication-protocol %} - - Como alternativa, em "Privacy password" (senha de privacidade), digite a senha de privacidade. - - No lado direito de "Privacy password" (Senha de privacidade), no menu suspenso **Protocol** (Protocolo), clique no protocolo de privacidade que você deseja usar. -9. Clique em **Add user** (Adicionar usuário). ![Botão para adicionar usuário SNMP v3](/assets/images/enterprise/management-console/snmpv3-adduser.png) -{% data reusables.enterprise_management_console.save-settings %} - -##### Consultar dados SNMP - -As informações de hardware e software do appliance estão disponíveis no SNMP v3. Devido à falta de criptografia e privacidade para os níveis de segurança `noAuthNoPriv` e `authNoPriv`, a tabela `hrSWRun` (1.1.3.6.1.2.1.25.41) foi excluída dos relatórios SNMP resultantes. Incluímos esta tabela para o caso de você estar usando o nível de segurança `authPriv`. - -Com o SNMP v2c, ficam disponíveis somente as informações em nível de hardware. Os aplicativos e serviços no {% data variables.product.prodname_enterprise %} não têm OIDs configurados para reportar métricas. Diversas MIBs estão disponíveis, o que pode ser visto ao executar `snmpwalk` em uma estação de trabalho à parte com suporte SNMP na rede: - -```shell -# community-string é a string de sua comunidade -# hostname é o IP ou domínio da sua instância Enterprise -$ snmpwalk -v 2c -c community-string -O e hostname -``` - -Das MIBs disponíveis para SNMP, a mais útil é a `HOST-RESOURCES-MIB` (.1.3.6.1.2.1.25). Consulte a tabela a seguir para ver objetos importantes dessa MIB: - -| Nome | OID | Descrição | -| -------------------------- | ------------------------- | ------------------------------------------------------------------------------------- | -| hrSystemDate.2 | .1.3.6.1.2.1.25.1.2 | A noção dos hosts de data e hora locais de um dia. | -| hrSystemUptime.0 | .1.3.6.1.2.1.25.1.1.0 | Tempo transcorrido desde a última inicialização do host. | -| hrMemorySize.0 | .1.3.6.1.2.1.25.2.2.0 | Quantidade de RAM no host. | -| hrSystemProcesses.0 | .1.3.6.1.2.1.25.1.6.0 | Número de contextos de processo carregados ou em execução no host. | -| hrStorageUsed.1 | .1.3.6.1.2.1.25.2.3.1.6.1 | Quantidade de espaço de armazenamento consumido no host, em hrStorageAllocationUnits. | -| hrStorageAllocationUnits.1 | .1.3.6.1.2.1.25.2.3.1.4.1 | Tamanho em bytes de um hrStorageAllocationUnit. | - -Por exemplo, para consultar `hrMemorySize` com SNMP v3, execute o seguinte comando em outra estação de trabalho com suporte a SNMP na sua rede: -```shell -# username é o nome exclusivo do seu usuário do SNMP v3 -# auth password é a senha de autenticação -# privacy password é a senha de privacidade -# hostname é o IP ou domínio da sua instância do Enterprise -$ snmpget -v 3 -u username -l authPriv \ - -A "auth password" -a SHA \ - -X "privacy password" -x AES \ - -O e hostname HOST-RESOURCES-MIB::hrMemorySize.0 -``` - -Para consultar `hrMemorySize` com SNMP v2c, execute o seguinte comando em outra estação de trabalho com suporte a SNMP na sua rede: -```shell -# community-string é a string da sua comunidade -# hostname é o IP ou domínio da sua instância do Enterprise -snmpget -v 2c -c community-string hostname HOST-RESOURCES-MIB::hrMemorySize.0 -``` - -{% tip %} - -**Observação:** para evitar o vazamento de informações sobre os serviços em execução no seu appliance, a tabela `hrSWRun` (1.1.3.6.1.2.1.25.41) foi excluída dos relatórios SNMP resultantes, a menos que você esteja usando o nível de segurança `authPriv` com SNMP v3. Incluímos a tabela `hrSWRun` para o caso de você estar usando o nível de segurança `authPriv`. - -{% endtip %} - -Para obter mais informações sobre mapeamentos OID para atributos comuns do sistema no SNMP, consulte "[OID de SNMP do Linux para estatísticas de CPU, memória e disco](http://www.linux-admins.net/2012/02/linux-snmp-oids-for-cpumemory-and-disk.html)". diff --git a/translations/pt-BR/content/admin/installation/monitoring-your-github-enterprise-server-appliance.md b/translations/pt-BR/content/admin/installation/monitoring-your-github-enterprise-server-appliance.md deleted file mode 100644 index 5c9617fe4461..000000000000 --- a/translations/pt-BR/content/admin/installation/monitoring-your-github-enterprise-server-appliance.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: Monitorar o appliance do GitHub Enterprise Server -intro: 'O aumento do uso da {% data variables.product.product_location_enterprise %} ao longo do tempo acarreta também o aumento do uso dos recursos do sistema, como CPU, memória e armazenamento. Você pode configurar o monitoramento e os alertas para identificar os possíveis problemas antes que eles impactem negativamente o desempenho ou a disponibilidade do aplicativo.' -redirect_from: - - /enterprise/admin/guides/installation/system-resource-monitoring-and-alerting/ - - /enterprise/admin/guides/installation/monitoring-your-github-enterprise-appliance/ - - /enterprise/admin/installation/monitoring-your-github-enterprise-server-appliance -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/pt-BR/content/admin/installation/network-ports.md b/translations/pt-BR/content/admin/installation/network-ports.md deleted file mode 100644 index 8af04204f3cb..000000000000 --- a/translations/pt-BR/content/admin/installation/network-ports.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: Portas de rede -redirect_from: - - /enterprise/admin/articles/configuring-firewalls/ - - /enterprise/admin/articles/firewall/ - - /enterprise/admin/guides/installation/network-configuration/ - - /enterprise/admin/guides/installation/network-ports-to-open/ - - /enterprise/admin/installation/network-ports -intro: 'Abra as portas de rede seletivamente com base nos serviços que você precisa expor para administradores, usuários finais e suporte por e-mail.' -versions: - enterprise-server: '*' ---- - -### Portas administrativas - -Certas portas administrativas são obrigatórias para configurar a {% data variables.product.product_location_enterprise %} e executar determinados recursos. Não é preciso haver portas administrativas para os usuários finais aproveitarem os recursos básicos do aplicativo. - -| Porta | Serviço | Descrição | -| -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| 8443 | HTTPS | {% data variables.enterprise.management_console %} seguro na web. Obrigatória para instalação e configuração básicas. | -| 8080 | HTTP | {% data variables.enterprise.management_console %} de texto simples na web. Não é obrigatória, a menos que o SSL seja desativado manualmente. | -| 122 | SSH | Acesso de shell à {% data variables.product.product_location_enterprise %}. É obrigatório ficar aberta para conexões de entrada de todos os outros nós em configurações de Alta Disponibilidade. A porta SSH padrão (22) é dedicada ao tráfego de rede de aplicativos Git e SSH. | -| 1194/UDP | VPN | Túnel de rede de replicação segura em configurações de Alta Disponibilidade. É obrigatório ficar aberta para todos os outros nós na configuração. | -| 123/UDP | NTP | Obrigatória para operações de protocolo de tempo. | -| 161/UDP | SNMP | Obrigatória para operações de protocolo de monitoramento de rede. | - -### Portas de aplicativo para usuários finais - -As portas de aplicativo fornecem aplicativos da web e acesso dos usuários finais ao Git. - -| Porta | Serviço | Descrição | -| ----- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------- | -| 443 | HTTPS | Acesso ao aplicativo da web e ao Git por HTTPS. | -| 80 | HTTP | Acesso ao aplicativo da web. Todas as solicitações são redirecionadas para a porta HTTPS quando o SSL está ativado. | -| 22 | SSH | Acesso ao Git por SSH. Compatível com operações de clonagem, fetch e push em repositórios públicos e privados. | -| 9418 | Git | A porta do protocolo Git é compatível com operações de clonagem e fetch em repositórios públicos com comunicação de rede não criptografada. | - -{% data reusables.enterprise_installation.terminating-tls %} - -### Portas de e-mail - -As portas de e-mail devem estar acessíveis diretamente ou via retransmissão para oferecer suporte de e-mail aos usuários finais. - -| Porta | Serviço | Descrição | -| ----- | ------- | ------------------------------------------- | -| 25 | SMTP | Suporte a SMTP com criptografia (STARTTLS). | diff --git a/translations/pt-BR/content/admin/installation/recommended-alert-thresholds.md b/translations/pt-BR/content/admin/installation/recommended-alert-thresholds.md deleted file mode 100644 index 161b83bec806..000000000000 --- a/translations/pt-BR/content/admin/installation/recommended-alert-thresholds.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: Limites de alerta recomendados -intro: 'É possível configurar um alerta para receber notificações sobre os problemas de recursos do sistema antes que eles afetem o desempenho do appliance do {% data variables.product.prodname_ghe_server %}.' -redirect_from: - - /enterprise/admin/guides/installation/about-recommended-alert-thresholds/ - - /enterprise/admin/installation/recommended-alert-thresholds -versions: - enterprise-server: '*' ---- - -### Monitorar o armazenamento - -É recomendável monitorar seus dispositivos de armazenamento raiz e de usuário, bem como configurar um alerta com valores que definam um tempo de resposta longo quando o espaço em disco disponível estiver baixo. - -| gravidade | Limite | -| ----------- | -------------------------------------------- | -| **Aviso** | Uso do disco excede 70% do total disponível. | -| **Crítico** | Uso do disco excede 85% do total disponível. | - -Você pode ajustar esses valores com base na quantidade de armazenamento total alocada, nos padrões históricos de crescimento e no tempo esperado de resposta. Recomendamos a superalocação dos recursos de armazenamento para permitir o crescimento e evitar o tempo de inatividade necessário para alocar armazenamento adicional. - -### Monitoramento de CPU e uso médio de carga - -Embora seja normal haver oscilação no uso de CPU conforme as operações do Git, é recomendável configurar um alerta para identificar usos de CPU altos demais, já que os picos prolongados podem indicar provisionamento insuficiente da sua instância. Recomendamos monitorar a média de carga do sistema a cada quinze minutos para valores próximos ou superiores ao número de núcleos de CPU alocados à máquina virtual. - -| gravidade | Limite | -| ----------- | ---------------------------------------------------------- | -| **Aviso** | Média de carga de quinze minutos excede 1x núcleos de CPU. | -| **Crítico** | Média de carga de quinze minutos excede 2x núcleos de CPU. | - -Também é recomendável monitorar o tempo de "roubo" da virtualização para garantir que outras máquinas virtuais em execução no mesmo sistema host não usem todos os recursos da instância. - -### Monitorar o uso de memória - -A quantidade de memória física alocada para a {% data variables.product.product_location_enterprise %} pode ter um grande impacto no desempenho geral e na capacidade de resposta do aplicativo. O sistema é projetado para fazer uso intenso do cache de disco do kernel a fim de acelerar as operações do Git. Recomendamos que o conjunto de trabalho RSS normal caiba em 50% do total de RAM disponível no uso máximo. - -| Gravidade | Limite | -| ----------- | ---------------------------------------------------------------- | -| **Aviso** | Uso de RSS sustentado excede 50% do total de memória disponível. | -| **Crítico** | Uso de RSS sustentado excede 70% do total de memória disponível. | - -Se a memória estiver esgotada, o killer OOM do kernel tentará liberar recursos de memória eliminando à força os processos de aplicativos pesados da RAM, o que pode causar a interrupção do serviço. É recomendável alocar mais memória do que o necessário para a máquina virtual no curso normal das operações. diff --git a/translations/pt-BR/content/admin/installation/recovering-a-high-availability-configuration.md b/translations/pt-BR/content/admin/installation/recovering-a-high-availability-configuration.md deleted file mode 100644 index d448f4eeb9e0..000000000000 --- a/translations/pt-BR/content/admin/installation/recovering-a-high-availability-configuration.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Recuperar configuração de alta disponibilidade -intro: 'Após o failover para um appliance do {% data variables.product.prodname_ghe_server %}, você deve recuperar a redundância o quanto antes, em vez de usar somente um appliance.' -redirect_from: - - /enterprise/admin/installation/recovering-a-high-availability-configuration -versions: - enterprise-server: '*' ---- - -Você pode usar o appliance primário anterior como novo appliance de réplica em caso de failover planejado ou não relacionado à integridade do appliance. Se o failover estiver relacionado a um problema no appliance primário, talvez você prefira criar outro appliance de réplica. Para obter mais informações, consulte "[Criar réplica de alta disponibilidade](/enterprise/{{ currentVersion }}/admin/guides/installation/creating-a-high-availability-replica/)". - -### Configurar appliance primário anterior como nova réplica - -1. Conecte-se ao endereço IP do appliance primário anterior usando SSH. - ```shell - $ ssh -p 122 admin@FORMER PRIMARY IP - ``` -2. No appliance primário anterior, execute `ghe-repl-setup` com o endereço IP da réplica anterior. - ```shell - $ ghe-repl-setup FORMER REPLICA IP - ``` -{% data reusables.enterprise_installation.add-ssh-key-to-primary %} -4. Para verificar a conexão com o novo primário e habilitar o modo de réplica para a nova réplica, execute `ghe-repl-setup` novamente. - ```shell - $ ghe-repl-setup FORMER REPLICA IP - ``` -{% data reusables.enterprise_installation.replication-command %} diff --git a/translations/pt-BR/content/admin/installation/removing-a-high-availability-replica.md b/translations/pt-BR/content/admin/installation/removing-a-high-availability-replica.md deleted file mode 100644 index 245b0c2d22d8..000000000000 --- a/translations/pt-BR/content/admin/installation/removing-a-high-availability-replica.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: Remover réplica de alta disponibilidade -intro: 'É possível parar temporariamente a replicação de uma réplica do {% data variables.product.prodname_ghe_server %} ou remover a replicação permanentemente.' -redirect_from: - - /enterprise/admin/installation/removing-a-high-availability-replica -versions: - enterprise-server: '*' ---- - -### Parar a replicação temporariamente - -1. Se necessário, interrompa o serviço da réplica de replicação geográfica no tráfego do usuário removendo as entradas de DNS de localização geográfica da réplica. -2. Na réplica em que você pretende parar a replicação temporariamente, execute ghe-repl-stop. - ```shell - $ ghe-repl-stop - ``` -3. Para iniciar a replicação novamente, execute `ghe-repl-start`. - ```shell - $ ghe-repl-start - ``` - -### Remover replicação permanentemente - -1. Se necessário, interrompa o serviço da réplica de replicação geográfica no tráfego do usuário removendo as entradas de DNS de localização geográfica da réplica. -2. Na réplica da qual você pretende remover a replicação, execute `ghe-repl-stop`. - ```shell - $ ghe-repl-stop - ``` -3. Na réplica, para destituir o estado de replicação, execute `ghe-repl-teardown`. - ```shell - $ ghe-repl-teardown - ``` diff --git a/translations/pt-BR/content/admin/installation/searching-the-audit-log.md b/translations/pt-BR/content/admin/installation/searching-the-audit-log.md deleted file mode 100644 index 1f0f5edcf9b3..000000000000 --- a/translations/pt-BR/content/admin/installation/searching-the-audit-log.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: Pesquisar no log de auditoria -intro: 'Os administradores do site podem pesquisar em uma vasta lista de [ações auditadas](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions) na {% data variables.product.product_location_enterprise %}.' -redirect_from: - - /enterprise/admin/articles/searching-the-audit-log/ - - /enterprise/admin/installation/searching-the-audit-log -versions: - enterprise-server: '*' ---- - -### Sintaxe de consulta de pesquisa - -Crie uma consulta de pesquisa com um ou mais pares chave-valor separados por operadores lógicos AND/OR. - -| Tecla | Valor | -| --------------:| -------------------------------------------------------------------------------------------------- | -| `actor_id` | ID da conta do usuário que iniciou a ação. | -| `actor` | Nome da conta do usuário que iniciou a ação. | -| `oauth_app_id` | ID do aplicativo OAuth associado à ação. | -| `action` | Nome da [ação auditada](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions). | -| `user_id` | ID do usuário afetado pela ação. | -| `usuário` | Nome do usuário afetado pela ação. | -| `repo_id` | ID do repositório afetado pela ação (se aplicável). | -| `repo` | Nome do repositório afetado pela ação (se aplicável). | -| `actor_ip` | Endereço IP do qual a ação foi iniciada. | -| `created_at` | Hora em que a ação ocorreu. | -| `from` | Exibição da qual a ação foi iniciada. | -| `note` | Informações diversas sobre eventos específicos (em texto sem formatação ou formato JSON). | -| `org` | Nome da organização afetada pela ação (se aplicável). | -| `org_id` | ID da organização afetada pela ação (se aplicável). | - -Por exemplo, para ver todas as ações que afetaram o repositório `octocat/Spoon-Knife` desde o início de 2017: - - `repo:"octocat/Spoon-Knife" AND created_at:[2017-01-01 TO *]` - -Para ver a lista completa de ações, consulte "[Ações auditadas](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions)". - -### Pesquisar no log de auditoria - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.audit-log-tab %} -4. Digite uma consulta de pesquisa.![Consulta de pesquisa](/assets/images/enterprise/site-admin-settings/search-query.png) diff --git a/translations/pt-BR/content/admin/installation/setting-git-push-limits.md b/translations/pt-BR/content/admin/installation/setting-git-push-limits.md deleted file mode 100644 index 59aca61ec8e7..000000000000 --- a/translations/pt-BR/content/admin/installation/setting-git-push-limits.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: Definir limites de push do Git -intro: É possível exigir um tamanho máximo para objetos Git em um repositório. -redirect_from: - - /enterprise/admin/guides/installation/git-server-settings/ - - /enterprise/admin/articles/setting-git-push-limits/ - - /enterprise/admin/installation/setting-git-push-limits -versions: - enterprise-server: '*' ---- - -Para manter o tamanho do repositório gerenciável e evitar problemas de desempenho, você pode configurar um limite de tamanho de arquivo para os repositórios em sua instância. - -Por padrão, quando você impõe os limites de upload do repositório, as pessoas não podem adicionar ou atualizar arquivos maiores que 100 MB. - -{% if currentVersion ver_lt "enterprise-server@2.20" %} -{% tip %} - -**Observação:** o limite de push do Git será verificado somente em arquivos com mais de {% data variables.large_files.warning_size %}. Se quiser definir um limite de push mais baixo, entre em contato com o {% data variables.contact.contact_ent_support %} para obter assistência. - -{% endtip %} -{% endif %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -4. Em "Repository upload limit" (Limite de upload de repositório), use o menu suspenso e clique para definir o tamanho máximo do objeto. ![Menu suspenso com opções de tamanho máximo de objeto](/assets/images/enterprise/site-admin-settings/repo-upload-limit-dropdown.png) -5. Opcionalmente, para aplicar um limite de upload máximo para todos os repositórios no {% data variables.product.product_location_enterprise %}, selecione **Limitar todos os repositórios** ![Opção de limitar o tamanho máximo de objeto em todos os repositórios](/assets/images/enterprise/site-admin-settings/all-repo-upload-limit-option.png) diff --git a/translations/pt-BR/content/admin/installation/setting-up-external-monitoring.md b/translations/pt-BR/content/admin/installation/setting-up-external-monitoring.md deleted file mode 100644 index 2d75d0daa5b9..000000000000 --- a/translations/pt-BR/content/admin/installation/setting-up-external-monitoring.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: Configurar monitoramento externo -intro: 'É possível monitorar os recursos básicos do sistema no appliance do {% data variables.product.prodname_ghe_server %} usando os protocolos de coleta de estatísticas SNMP ou collectd.' -redirect_from: - - /enterprise/admin/installation/setting-up-external-monitoring -versions: - enterprise-server: '*' ---- - -### Sobre o SNMP - -O protocolo Simple Network Management Protocol (SNMP) é uma forma amplamente difundida de monitorar servidores e dispositivos de rede. O SNMP fica desabilitado por padrão, mas pode ser configurado pelo painel de monitoramento do {% data variables.product.prodname_enterprise %}. A porta UDP 161 deve ficar aberta e acessível na estação de gerenciamento de rede. Para obter mais informações, consulte "[Monitorar usando SNMP](/enterprise/{{ currentVersion }}/admin/guides/installation/monitoring-using-snmp/)". - -### Sobre collectd - -O collectd é um daemon de código aberto de geração de relatórios e coleta de estatísticas com suporte integrado para gravação em arquivos RRD. As estatísticas de uso de CPU, consumo de memória e disco, tráfego e erros da interface de rede e carga do sistema podem ser encaminhadas para um servidor collectd externo, onde gráficos, análises e alertas podem ser configurados usando uma série de ferramentas e plugins. Para configurar o encaminhamento de `collectd`, consulte "[Configurar collectd](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-collectd/)". - -Além disso, as ferramentas de monitoramento integradas às plataformas de virtualização subjacentes podem ser usadas para monitoramento e alerta básico dos recursos do sistema. Para obter mais informações, consulte [Amazon CloudWatch](http://aws.amazon.com/cloudwatch/) e a documentação sobre o [monitoramento do VMware vSphere](http://pubs.vmware.com/vsphere-50/topic/com.vmware.ICbase/PDF/vsphere-esxi-vcenter-server-50-monitoring-performance-guide.pdf). diff --git a/translations/pt-BR/content/admin/installation/site-admin-dashboard.md b/translations/pt-BR/content/admin/installation/site-admin-dashboard.md deleted file mode 100644 index 5f4be40ae831..000000000000 --- a/translations/pt-BR/content/admin/installation/site-admin-dashboard.md +++ /dev/null @@ -1,178 +0,0 @@ ---- -title: Painel de administração do site -intro: 'O painel de administração do site mostra uma série de ferramentas que ajudam no gerenciamento da {% data variables.product.product_location_enterprise %}.' -redirect_from: - - /enterprise/admin/articles/site-admin-dashboard/ - - /enterprise/admin/installation/site-admin-dashboard -versions: - enterprise-server: '*' ---- - -Para acessar o painel, clique em {% octicon "rocket" aria-label="The rocket ship" %} no canto superior direito de qualquer página. ![Ícone de foguete para acessar as configurações de administrador do site](/assets/images/enterprise/site-admin-settings/access-new-settings.png) - -### Informações de licença e pesquisa - -Consulte esta seção do painel de administração do site para verificar sua licença atual do {% data variables.product.prodname_enterprise %}, pesquisar usuários e repositórios e consultar o [log de auditoria](#audit-log). - -### {% data variables.enterprise.management_console %} - -Neste espaço, é possível iniciar o {% data variables.enterprise.management_console %} para gerenciar configurações do appliance virtual, como domínio, autenticação e SSL. - -### Explorar - - Os dados da [página de tendências](https://github.com/blog/1585-explore-what-is-trending-on-github) do GitHub são calculados em intervalos diários, semanais e mensais para repositórios e desenvolvedores. Veja qual foi a última vez que os dados ficaram em cache e organize em fila os trabalhos de cálculo de tendências na seção **Explorar**. - -### Log de auditoria - -O {% data variables.product.prodname_enterprise %} mantém um log de execução das ações auditadas, e essas informações ficam disponíveis para consulta. - -Por padrão, o log de auditoria mostra uma lista de todas as ações auditadas em ordem cronológica inversa. Você pode filtrar essa lista inserindo pares chave-valor na caixa de texto **Query** (Consulta) e clicando em **Search** (Pesquisar), conforme a explicação em "[Pesquisar no log de auditoria](/enterprise/{{ currentVersion }}/admin/guides/installation/searching-the-audit-log)". - -Para obter mais informações gerais sobre logs de auditoria, consulte "[Gerar logs de auditoria](/enterprise/{{ currentVersion }}/admin/guides/installation/audit-logging)". Para ver a lista completa de ações auditadas, consulte "[Ações auditadas](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions)". - -### Relatórios - -Para obter informações sobre usuários, organizações e repositórios da {% data variables.product.product_location_enterprise %}, você normalmente faria fetch de dados JSON na [API do GitHub](http://developer.github.com/v3/). Infelizmente, a API pode não fornecer todos os dados necessários e ainda requer um pouco de conhecimento técnico. O painel de administração do site oferece uma seção **Reports** (Relatórios) como alternativa, facilitando o download de relatórios CSV com a maioria das informações necessárias para usuários, organizações e repositórios. - -Especificamente, é possível baixar relatórios CSV que listem o seguinte: - -- todos os usuários; -- todos os usuários ativos no último mês; -- todos os usuários inativos por um mês (ou mais); -- todos os usuários suspensos; -- todas as organizações; -- todos os repositórios. - -Você também pode acessar esses relatórios de forma programática pela autenticação HTTP padrão com uma conta de administrador do site. Você deve usar um token de acesso pessoal com o escopo `site_admin`. Para mais informação, consulte "[Criando um token de acesso pessoal](/github/authenticating-to-github/creating-a-personal-access-token)." - -Por exemplo, veja uma forma de baixar o relatório "todos os usuários" com cURL: - -```shell -curl -L -u username:token http(s)://hostname/stafftools/reports/all_users.csv -``` - -Para acessar os outros relatórios de forma programática, substitua `all_users` por `active_users`, `dormant_users`, `suspended_users`, `all_organizations` ou `all_repositories`. - -{% note %} - -**Observação:** a solicitação inicial `curl` retornará uma resposta HTTP 202 se não houver relatórios em cache disponíveis; em segundo plano, será gerado um relatório. Você pode enviar uma segunda solicitação para baixar o relatório. Em vez de usar uma senha, você pode definir uma senha ou token OAuth com escopo `site_admin`. - -{% endnote %} - -#### Relatórios de usuário - -| Tecla | Descrição | -| -----------------:| ---------------------------------------------------------------------- | -| `created_at` | Momento da criação da conta do usuário (carimbo de data/hora ISO 8601) | -| `id` | ID da conta de usuário ou organização | -| `login` | Nome de login da conta | -| `e-mail` | Endereço de e-mail principal da conta | -| `função` | Conta de administrador ou usuário regular | -| `suspended?` | Se a conta foi suspensa | -| `last_logged_ip` | Endereço IP mais recente a fazer login na conta | -| `repos` | Número de repositórios pertencentes à conta | -| `ssh_keys` | Número de chaves SSH registradas na conta | -| `org_memberships` | Número de organizações às quais a conta pertence | -| `dormant?` | Se a conta está inativa | -| `last_active` | Última vez em que a conta ficou ativa (carimbo de data/hora ISO 8601) | -| `raw_login` | Informações brutas de login (formato JSON) | -| `2fa_enabled?` | Se o usuário habilitou a autenticação de dois fatores | - -#### Relatórios da organização - -| Tecla | Descrição | -| ---------------:| --------------------------------------------------- | -| `id` | ID da organização | -| `created_at` | Momento de criação da organização | -| `login` | Nome de login da organização | -| `e-mail` | Endereço de e-mail principal da organização | -| `owners` | Número de proprietários da organização | -| `members` | Número de integrantes da organização | -| `teams` | Número de equipes da organização | -| `repos` | Número de repositórios da organização | -| `2fa_required?` | Se a organização exige autenticação de dois fatores | - -#### Relatórios do repositório - -| Tecla | Descrição | -| ---------------:| ----------------------------------------------------- | -| `created_at` | Momento de criação do repositório | -| `owner_id` | ID do proprietário do repositório | -| `owner_type` | Se o repositório pertence a um usuário ou organização | -| `owner_name` | Nome do proprietário do repositório | -| `id` | ID do repositório | -| `name` | Nome do repositório | -| `visibilidade` | Se o repositório é público ou privado | -| `readable_size` | Tamanho do repositório em formato legível por humanos | -| `raw_size` | Tamanho do repositório como número | -| `collaborators` | Número de colaboradores do repositório | -| `fork?` | Se o repositório é uma bifurcação | -| `deleted?` | Se o repositório foi excluído | - -### Índices - - Os recursos de [pesquisa de códigos](https://github.com/blog/1381-a-whole-new-code-search) do GitHub têm tecnologia [ElasticSearch](http://www.elasticsearch.org/). Esta seção do painel de administração do site mostra o status atual do cluster do ElasticSearch e oferece várias ferramentas para controlar o comportamento de pesquisa e geração de índices. Essas ferramentas se dividem em três categorias: - -#### Pesquisa de código - -Esta ação permite habilitar ou desabilitar as operações de pesquisa e índice no código-fonte. - -#### Reparo de índice de pesquisa de códigos - -Esta categoria controla a forma como ocorre o reparo do índice de pesquisa de códigos. Você pode: - -- habilitar ou desabilitar trabalhos de reparo de índice; -- iniciar um novo trabalho de reparo de índice; -- redefinir o estado de todo o reparo de índice. - -O {% data variables.product.prodname_enterprise %} usa trabalhos de reparo para reconciliar o estado do índice de pesquisa com dados armazenados em bancos de dados (problemas, pull requests, repositórios e usuários) e dados armazenados em repositórios do Git (código-fonte). Isso acontece quando: - -- um novo índice de pesquisa é criado; -- dados ausentes precisam ser aterrados; ou -- dados antigos de pesquisa precisam ser atualizados. - -Em outras palavras, os trabalhos de reparo são iniciados conforme necessário e executados em segundo plano. Esses trabalhos não são programados pelos administradores do site. - -Além disso, trabalhos de reparo usam uma "compensação de reparo" para paralelização. Trata-se de uma compensação na tabela do banco de dados para o registro a ser reconciliado. Vários trabalhos em segundo plano podem sincronizar tarefas com base nessa compensação. - -Uma barra de progresso mostra o status atual de um trabalho de reparo em todos os trabalhadores relacionados em segundo plano. Trata-se da diferença percentual da compensação do reparo com o ID de registro mais alto no banco de dados. Não se preocupe com o valor mostrado na barra de progresso após a conclusão de um trabalho de reparo; ele mostra a diferença entre a compensação do reparo e o ID de registro mais alto no banco de dados, e diminuirá à medida que mais repositórios forem adicionados à {% data variables.product.product_location_enterprise %}, mesmo que esses repositórios estejam indexados no momento. - -Você pode iniciar um novo trabalho de reparo do índice de pesquisa de código a qualquer momento. Ele usará uma única CPU, pois reconcilia o índice de pesquisa com os dados do banco de dados e do repositório Git. Para minimizar os efeitos no desempenho de E/S e reduzir as chances de tempo limite das operações, tente fazer um trabalho de reparo fora dos horários de pico. Monitore as médias de carga do sistema e o uso da CPU usando um utilitário como `top`. Se você notar que não houve alterações significativas, isso indica que provavelmente será seguro fazer um trabalho de reparo de índice nos horários de pico. - -#### Reparo de índice de problemas - - Esta categoria controla a forma como o índice [Problemas](https://github.com/blog/831-issues-2-0-the-next-generation) é reparado. Você pode: - -- habilitar ou desabilitar trabalhos de reparo de índice; -- iniciar um novo trabalho de reparo de índice; -- redefinir o estado de todo o reparo de índice. - -### Repositórios - -Este espaço lista os repositórios da {% data variables.product.product_location_enterprise %}. Você pode clicar no nome de um repositório e acessar suas funções de administração. - -- [Bloquear pushes forçados em um repositório](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository/) -- [Configurar o {% data variables.large_files.product_name_long %};](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-git-large-file-storage/#configuring-git-large-file-storage-for-an-individual-repository) -- [Arquivar e cancelar o arquivamento de repositórios](/enterprise/{{ currentVersion }}/admin/guides/user-management/archiving-and-unarchiving-repositories/) - -### Todos os usuários - -Aqui você verá todos os usuários da {% data variables.product.product_location_enterprise %} e poderá [iniciar uma auditoria de chave SSH](/enterprise/{{ currentVersion }}/admin/guides/user-management/auditing-ssh-keys). - -### Administradores do site - -Aqui você verá todos os administradores da {% data variables.product.product_location_enterprise %} e poderá [iniciar uma auditoria de chave SSH](/enterprise/{{ currentVersion }}/admin/guides/user-management/auditing-ssh-keys). - -### Usuários inativos - -Aqui você pode ver e [suspender](/enterprise/{{ currentVersion }}/admin/guides/user-management/suspending-and-unsuspending-users) todos os usuários inativos da {% data variables.product.product_location_enterprise %}. Uma conta de usuário é considerada inativa quando: - -- Seu tempo de existência supera o limite de inatividade configurado na {% data variables.product.product_location_enterprise %}; -- Não gerou qualquer atividade em seu período de existência; -- Não é uma conta de administrador do site. - -{% data reusables.enterprise_site_admin_settings.dormancy-threshold %} Para obter mais informações, consulte "[Gerenciar usuários inativos](/enterprise/{{ currentVersion }}/admin/guides/user-management/managing-dormant-users/#configuring-the-dormancy-threshold)". - -### Usuários suspensos - -Aqui você verá todos os usuários que foram suspensos da {% data variables.product.product_location_enterprise %} e poderá [iniciar uma auditoria de chave SSH](/enterprise/{{ currentVersion }}/admin/guides/user-management/auditing-ssh-keys). diff --git a/translations/pt-BR/content/admin/installation/system-overview.md b/translations/pt-BR/content/admin/installation/system-overview.md deleted file mode 100644 index 6d5d92ec0cf6..000000000000 --- a/translations/pt-BR/content/admin/installation/system-overview.md +++ /dev/null @@ -1,140 +0,0 @@ ---- -title: Visão geral do sistema -intro: 'O {% data variables.product.prodname_ghe_server %} é a cópia privada da sua organização do {% data variables.product.prodname_dotcom %} contida em um appliance virtual configurado e controlado por você, hospedado no local ou na nuvem.' -redirect_from: - - /enterprise/admin/installation/system-overview -versions: - enterprise-server: '*' ---- - -### Arquitetura de armazenamento - -O {% data variables.product.prodname_ghe_server %} precisa de dois volumes de armazenamento: um no caminho do *sistema de arquivos raiz* (`/`) e outro no caminho do *sistema de arquivos do usuário* (`/data/user`). Essa arquitetura simplifica os procedimentos de atualização, reversão e recuperação separando o ambiente do software em execução dos dados persistentes do aplicativo. - -O sistema de arquivos raiz está incluído na imagem da máquina distribuída. Ele contém o sistema operacional de base e o ambiente de aplicativo do {% data variables.product.prodname_ghe_server %}. O sistema de arquivos raiz deve ser tratado como efêmero. Todos os dados no sistema de arquivos raiz serão substituídos nas atualizações futuras do {% data variables.product.prodname_ghe_server %}. - -O sistema de arquivos raiz tem o seguinte: - - Certificados personalizados de uma autoridade certificada (CA) (em */usr/local/share/ca-certificates*); - - Configurações de rede personalizadas; - - Configurações de firewall personalizadas; - - O estado da replicação. - -O sistema de arquivos do usuário tem dados e configurações do usuário, como: - - Repositórios do Git; - - Banco de dados; - - Índices de pesquisa; - - Conteúdo publicado nos sites do {% data variables.product.prodname_pages %}; - - Arquivos grandes do {% data variables.large_files.product_name_long %}; - - Ambientes de hook pre-receive. - -### Opções de implantação - -Você pode implantar o {% data variables.product.prodname_ghe_server %} como appliance virtual único ou em uma configuração de alta disponibilidade. Para obter mais informações, consulte "[Configurar o {% data variables.product.prodname_ghe_server %} para alta disponibilidade](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-github-enterprise-server-for-high-availability/)". - -Algumas organizações com dezenas de milhares de desenvolvedores também podem se beneficiar do clustering do {% data variables.product.prodname_ghe_server %}. Para obter mais informações, consulte "[Sobre clustering](/enterprise/{{ currentVersion }}/admin/guides/clustering/about-clustering)." - -### Retenção de dados e redundância de datacenter - -{% danger %} - -Antes de usar o {% data variables.product.prodname_ghe_server %} em um ambiente de produção, é altamente recomendável configurar backups e um plano de recuperação de desastres. Para obter mais informações, consulte "[Configurar backups no appliance](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-backups-on-your-appliance)". - -{% enddanger %} - -O {% data variables.product.prodname_ghe_server %} dá suporte a backups online e incrementais com o [{% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils). Você pode obter instantâneos incrementais em um link de rede seguro (porta administrativa SSH) por longas distâncias para fins de armazenamento externo ou geograficamente disperso. Em caso de desastre no datacenter primário, é possível restaurar instantâneos pela rede em um appliance virtual recém-provisionado no momento da recuperação. - -Além dos backups de rede, os instantâneos de volumes de armazenamento do usuário no AWS (EBS) e no VMware serão compatíveis enquanto o appliance estiver offline ou em modo de manutenção. Se os requisitos de nível de serviço permitirem manutenção offline regular, os instantâneos de volumes regulares podem ser usados como alternativa de baixo custo e complexidade aos backups de rede com o {% data variables.product.prodname_enterprise_backup_utilities %}. - -Para obter mais informações, consulte "[Configurar backups no appliance](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-backups-on-your-appliance)". - -### Segurança - -O {% data variables.product.prodname_ghe_server %} é um appliance virtual que é executado em sua infraestrutura e é administrado por controles de segurança da informação existentes, como firewalls, IAM, monitoramento e VPNs. Usar o {% data variables.product.prodname_ghe_server %} pode ajudá-lo a evitar problemas de conformidade regulatória que surgem de soluções baseadas na nuvem. - -O {% data variables.product.prodname_ghe_server %} também apresenta outros recursos de segurança. - -- [Sistema operacional, software e patches](#operating-system-software-and-patches) -- [Segurança de rede](#network-security) -- [Segurança do aplicativo](#application-security) -- [Serviços externos e acesso ao suporte](#external-services-and-support-access) -- [Comunicação criptografada](#encrypted-communication) -- [Usuários e permissões de acesso](#users-and-access-permissions) -- [Autenticação](#authentication) -- [Log de auditoria e acesso](#audit-and-access-logging) - -#### Sistema operacional, software e patches - -O {% data variables.product.prodname_ghe_server %} executa um sistema operacional Linux personalizado somente com os aplicativos e serviços necessários. O {% data variables.product.prodname_dotcom %} gerencia patches do sistema operacional central do appliance como parte do ciclo padrão de versões do produto. Os patches tratam de problemas de segurança não críticos, funcionalidade e estabilidade nos aplicativos do {% data variables.product.prodname_dotcom %}. O {% data variables.product.prodname_dotcom %} também oferece pacthes de segurança críticos, conforme necessário e fora do ciclo regular de versões. - -#### Segurança de rede - -O firewall interno do {% data variables.product.prodname_ghe_server %} limita o acesso à rede para os serviços do appliance. Apenas os serviços necessários para o funcionamento do appliance estão disponíveis na rede. Para obter mais informações, consulte "[Portas de rede](/enterprise/{{ currentVersion }}/admin/guides/installation/network-ports)". - -#### Segurança do aplicativo - -A equipe de segurança de aplicativos do {% data variables.product.prodname_dotcom %} trabalha em tempo integral na avaliação de vulnerabilidades, testes de invasão e revisão de códigos dos produtos do {% data variables.product.prodname_dotcom %} e também do {% data variables.product.prodname_ghe_server %}. O {% data variables.product.prodname_dotcom %} também contrata empresas de segurança externas para fornecer avaliações específicas dos produtos do {% data variables.product.prodname_dotcom %}. - -#### Serviços externos e acesso ao suporte - -O {% data variables.product.prodname_ghe_server %} pode operar sem acessos de saída da sua rede para serviços externos. Alternativamente, você pode habilitar a integração com serviços externos de correio eletrônico, monitoramento externo e encaminhamento de logs. Para obter mais informações, consulte "[Configurar o e-mail para notificações](/enterprise/{{ currentVersion }}/admin/user-management/configuring-email-for-notifications)", "[Configurar monitoramento externo](/enterprise/{{ currentVersion }}/admin/installation/setting-up-external-monitoring)" e "[Encaminhamento de log](/enterprise/{{ currentVersion }}/admin/installation/log-forwarding)". - -Você pode levantar e enviar dados de soluções de problemas para o {% data variables.contact.github_support %}. Para obter mais informações, consulte "[Enviar dados para o {% data variables.contact.github_support %}](/enterprise/{{ currentVersion }}/admin/enterprise-support/providing-data-to-github-support)". - -#### Comunicação criptografada - -O {% data variables.product.prodname_dotcom %} desenvolveu o {% data variables.product.prodname_ghe_server %} para ser executado atrás do firewall corporativo. Para garantir a comunicação com fio, incentivamos que o Transport Layer Security (TLS) seja habilitado. O {% data variables.product.prodname_ghe_server %} é compatível com certificados TLS comerciais de 2048 bits ou mais para tráfego HTTPS. Para obter mais informações, consulte "[Configurar o TLS](/enterprise/{{ currentVersion }}/admin/installation/configuring-tls)". - -Por padrão, o appliance também fornece acesso Secure Shell (SSH) para acesso a repositórios com o Git e para finalidades administrativas. Para obter mais informações, consulte "[Sobre SSH](/enterprise/user/articles/about-ssh)" e "[Acessar o shell administrativo (SSH)](/enterprise/{{ currentVersion }}/admin/installation/accessing-the-administrative-shell-ssh)". - -#### Usuários e permissões de acesso - -O {% data variables.product.prodname_ghe_server %} oferece três tipos de contas. - -- A conta de usuário Linux `admin` tem acesso controlado ao sistema operacional subjacente, com acesso direto ao sistema de arquivos e banco de dados. Um número reduzido de administradores deve ter acesso a essa conta, o que pode ser feito por SSH. Para obter mais informações, consulte "[Acessar o shell administrativo (SSH)](/enterprise/{{ currentVersion }}/admin/installation/accessing-the-administrative-shell-ssh)". -- As contas de usuários no aplicativo web do appliance têm acesso total aos seus próprios dados e quaisquer dados que outros usuários ou organizações permitirem explicitamente. -- Administradores de site no aplicativo web do appliance são contas de usuários que podem gerenciar configurações de alto nível dos aplicativos web e do appliance, configurações de contas de usuários e organização e dados de repositório. - -Para obter mais informações sobre as permissões de usuários do {% data variables.product.prodname_ghe_server %}, consulte "[Permissões de acesso no GitHub](/enterprise/user/articles/access-permissions-on-github)". - -#### Autenticação - -O {% data variables.product.prodname_ghe_server %} oferece quatro métodos de autenticação. - -- A autenticação com chave pública SSH oferece acesso a repositórios usando Git e acesso shell administrativo. Para obter mais informações, consulte "[Sobre SSH](/enterprise/user/articles/about-ssh)" e "[Acessar o shell administrativo (SSH)](/enterprise/{{ currentVersion }}/admin/installation/accessing-the-administrative-shell-ssh)". -- A autenticação de nome de usuário e senha com cookies HTTP oferece acesso ao aplicativo web e gerenciamento de sessão, com autenticação de dois fatores (2FA) opcional. Para obter mais informações, consulte "[Usar autenticação integrada](/enterprise/{{ currentVersion }}/admin/user-management/using-built-in-authentication)". -- Autenticações LDAP, SAML ou CAS externas usando um serviço LDAP, provedor de identidade (IdP) SAML ou outros serviços compatíveis fornecem acesso ao aplicativo web. Para obter mais informações, consulte "[Autenticar usuários na instância do GitHub Enterprise Server](/enterprise/{{ currentVersion }}/admin/user-management/authenticating-users-for-your-github-enterprise-server-instance)". -- Tokens OAuth e de acesso pessoal oferecem acesso a dados de repositórios e APIs Git para clientes e serviços externos. Para mais informação, consulte "[Criando um token de acesso pessoal](/github/authenticating-to-github/creating-a-personal-access-token)." - -#### Log de auditoria e acesso - -O {% data variables.product.prodname_ghe_server %} armazena logs do sistema operacional tradicional e de aplicativos. O aplicativo também grava logs de auditoria e segurança detalhados, que são armazenados permanentemente pelo {% data variables.product.prodname_ghe_server %}. Os dois tipos de logs podem ser encaminhados em tempo real para destinos múltiplos via protocolo `syslog-ng`. Para obter mais informações, consulte "[Encaminhamento de logs](/enterprise/{{ currentVersion }}/admin/installation/log-forwarding)". - -Logs de acesso e auditoria contêm informações como as seguintes. - -##### Logs de acesso - -- Logs de servidor web completos para acessos ao navegador e API -- Logs completos para acesso aos dados do repositório no Git, HTTPS e protocolos SSH -- Logs de acesso administrativo em HTTPS e SSH - -##### Logs de auditoria - -- Login de usuários, redefinição de senhas, solicitações 2FA, alteração de configurações de e-mails e alterações em aplicativos e APIs autorizados -- Ações de administrador do site, como desbloqueio de contas de usuários e repositórios -- Eventos de push do repositório, concessão de acesso, transferências e renomeações -- Alterações nos integrantes da organização, incluindo criação e exclusão de equipes - -### Dependências de código aberto para o {% data variables.product.prodname_ghe_server %} - -Veja uma lista completa de dependências na sua versão do appliance do {% data variables.product.prodname_ghe_server %}, além das licenças de cada projeto em `http(s)://HOSTNAME/site/credits`. - -Os tarballs e uma lista completa de dependências e metadados associados estão disponíveis no seu appliance: -- Para dependências comuns a todas as plataformas, em `/usr/local/share/enterprise/dependencies--base.tar.gz` -- Para dependências específicas de uma plataforma, em `/usr/local/share/enterprise/dependencies--.tar.gz` - -Os tarballs também estão disponíveis com uma lista completa de dependências e metadados em `https://enterprise.github.com/releases//download.html`. - -### Leia mais - -- [Configurar uma versão de avaliação do {% data variables.product.prodname_ghe_server %}](/articles/setting-up-a-trial-of-github-enterprise-server) -- "[Configurar uma instância do {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-github-enterprise-server-instance)" diff --git a/translations/pt-BR/content/admin/installation/troubleshooting-ssl-errors.md b/translations/pt-BR/content/admin/installation/troubleshooting-ssl-errors.md deleted file mode 100644 index 5da1f7c2adf9..000000000000 --- a/translations/pt-BR/content/admin/installation/troubleshooting-ssl-errors.md +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: Solução de problemas de SSL -intro: 'Em caso de problemas de SSL com seu appliance, veja o que você pode fazer para resolvê-los.' -redirect_from: - - /enterprise/admin/articles/troubleshooting-ssl-errors/ - - /enterprise/admin/categories/dns-ssl-and-subdomain-configuration/ - - /enterprise/admin/installation/troubleshooting-ssl-errors -versions: - enterprise-server: '*' ---- - -### Remover a frase secreta do arquivo de chave - -Se você tiver uma máquina Linux com OpenSSL instalado, será possível remover a frase secreta. - -1. Renomeie seu arquivo de chave original. - ```shell - $ mv yourdomain.key yourdomain.key.orig - ``` -2. Gere uma nova chave SSH sem frase secreta. - ```shell - $ openssl rsa -in yourdomain.key.orig -out yourdomain.key - ``` - -A senha da chave será solicitada quando você executar esse comando. - -Para obter mais informações sobre o OpenSSL, consulte a [Documentação do OpenSSL](https://www.openssl.org/docs/). - -### Converter o certificado ou chave SSL em formato PEM - -Se você tiver o OpenSSL instalado, é possível converter sua chave em formato PEM com o comando `openssl`. Por exemplo, você pode converter uma chave do formato DER para o formato PEM. - -```shell -$ openssl rsa -in yourdomain.der -inform DER -out yourdomain.key -outform PEM -``` - -Se não tiver, você pode usar a ferramenta SSL Converter para converter seu certificado em formato PEM. Para obter mais informações, consulte a [documentação da ferramenta SSL Converter](https://www.sslshopper.com/ssl-converter.html). - -### Instalação parada após upload de chave - -Se a {% data variables.product.product_location_enterprise %} parar de funcionar após o upload de uma chave SSL, [entre em contato com o suporte do {% data variables.product.prodname_enterprise %}](https://enterprise.github.com/support) informando detalhes específicos, inclusive uma cópia do seu certificado SSL. - -### Erros de validade de certificado - -Se não conseguirem verificar a validade de um certificado SSL, clientes como navegadores da web e Gits de linha de comando exibirão uma mensagem de erro. Isso costuma acontecer com certificados autoassinados e certificados de "raiz encadeada" emitidos a partir de um certificado raiz intermediário não reconhecido pelo cliente. - -Se você estiver usando um certificado assinado por uma autoridade de certificação (CA), o arquivo de certificado que você carregar no {% data variables.product.prodname_ghe_server %} deverá incluir uma cadeia de certificados com o certificado raiz da autoridade certificada em questão. Para criar esse arquivo, concatene toda a sua cadeia de certificados (ou "pacote de certificados") até o fim, garantindo que o certificado principal com o nome de host seja o primeiro. Na maioria dos sistemas, fazer isso é possível com um comando semelhante ao seguinte: - -```shell -$ cat yourdomain.com.crt bundle-certificates.crt > yourdomain.combined.crt -``` - -Você deve poder baixar um pacote de certificados (por exemplo, `bundle-certificates.crt`) da sua autoridade certificada ou do fornecedor de SSL. - -### Instalar certificados raiz de autoridade de certificação (CA) autoassinada ou não confiável - -Se o seu appliance do {% data variables.product.prodname_ghe_server %} interage na rede com outras máquinas que usam certificados autoassinados ou não confiáveis, será necessário importar o certificado raiz da CA de assinatura para o armazenamento geral do sistema a fim de acessar esses sistemas por HTTPS. - -1. Obtenha o certificado raiz da autoridade de certificação local e verifique se ele está no formato PEM. -2. Copie o arquivo para o seu appliance do {% data variables.product.prodname_ghe_server %} via SSH como usuário "admin" na porta 122. - ```shell - $ scp -P 122 rootCA.crt admin@HOSTNAME:/home/admin - ``` -3. Conecte-se ao shell administrativo do {% data variables.product.prodname_ghe_server %} via SSH como usuário "admin" na porta 122. - ```shell - $ ssh -p 122 admin@HOSTNAME - ``` -4. Importe o certificado no armazenamento geral do sistema. - ```shell - $ ghe-ssl-ca-certificate-install -c rootCA.crt - ``` diff --git a/translations/pt-BR/content/admin/installation/updating-the-virtual-machine-and-physical-resources.md b/translations/pt-BR/content/admin/installation/updating-the-virtual-machine-and-physical-resources.md deleted file mode 100644 index af8391168db1..000000000000 --- a/translations/pt-BR/content/admin/installation/updating-the-virtual-machine-and-physical-resources.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: Atualizar a máquina virtual e os recursos físicos -intro: 'A atualização de software e hardware virtuais envolve algum tempo de inatividade para sua instância. Portanto, planeje a atualização com bastante antecedência.' -redirect_from: - - '/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-the-vm/' - - '/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-physical-resources/' - - /enterprise/admin/installation/updating-the-virtual-machine-and-physical-resources -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/pt-BR/content/admin/installation/upgrade-requirements.md b/translations/pt-BR/content/admin/installation/upgrade-requirements.md deleted file mode 100644 index 166d64a0aadd..000000000000 --- a/translations/pt-BR/content/admin/installation/upgrade-requirements.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Requisitos de atualização -intro: 'Antes de atualizar o {% data variables.product.prodname_ghe_server %}, veja as recomendações e requisitos a seguir para planejar sua estratégia de atualização.' -redirect_from: - - /enterprise/admin/guides/installation/finding-the-current-github-enterprise-release/ - - /enterprise/admin/installation/upgrade-requirements -versions: - enterprise-server: '*' ---- - -{% note %} - -**Observações:** -- Para atualizar do {% data variables.product.prodname_enterprise %} 11.10.348 até o {% data variables.product.current-340-version %}, você deve migrar para o {% data variables.product.prodname_enterprise %} 2.1.23. Para obter mais informações, consulte "[Migrar do {% data variables.product.prodname_enterprise %} 11.10.x para o 2.1.23](/enterprise/{{ currentVersion }}/admin/guides/installation/migrating-from-github-enterprise-11-10-x-to-2-1-23)". -- Nas versões com suporte, há pacotes de atualização disponíveis em [enterprise.github.com](https://enterprise.github.com/releases). Verifique a disponibilidade dos pacotes de atualização necessários para concluir a atualização. Se um pacote não estiver disponível, entre em contato com o {% data variables.contact.contact_ent_support %} para obter assistência. -- Se estiver usando o clustering do {% data variables.product.prodname_ghe_server %}, consulte "[Atualizar cluster](/enterprise/{{ currentVersion }}/admin/guides/clustering/upgrading-a-cluster/)" no guia de clustering do {% data variables.product.prodname_ghe_server %} para obter instruções específicas. -- As notas de versão do {% data variables.product.prodname_ghe_server %} mostram uma lista abrangente dos novos recursos de cada versão do {% data variables.product.prodname_ghe_server %}. Para obter mais informações, consulte a [página de versões](https://enterprise.github.com/releases). - -{% endnote %} - -### Recomendações - -- Inclua o mínimo possível de atualizações no seu processo. Por exemplo, em vez de atualizar do {% data variables.product.prodname_enterprise %} {{ enterpriseVersions.supported[2] }} para o {{ enterpriseVersions.supported[1] }} e depois para o {{ enterpriseVersions.latest }}, atualize do {% data variables.product.prodname_enterprise %} {{ enterpriseVersions.supported[2] }} para o {{ enterpriseVersions.latest }}. -- Se a sua versão estiver muito defasada, atualize a {% data variables.product.product_location_enterprise %} para a versão mais atual disponível a cada etapa do processo. Ao usar a versão mais recente em cada atualização, você pode aproveitar as melhorias de desempenho e as correções de erros. Por exemplo, você poderia atualizar do {% data variables.product.prodname_enterprise %} 2.7 para o 2.8 e depois para o 2.10. No entanto, atualizar do {% data variables.product.prodname_enterprise %} 2.7 para o 2.9 e depois para o 2.10 usa uma versão mais recente na segunda etapa. -- Ao atualizar, use a versão mais recente do patch. {% data reusables.enterprise_installation.enterprise-download-upgrade-pkg %} -- Use uma instância de preparo para testar as etapas da atualização. Para obter mais informações, consulte "[Configurar instância de preparo](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-staging-instance/)". -- Ao fazer várias atualizações, aguarde pelo menos 24 horas entre cada atualização de recursos para permitir a conclusão total das migrações de dados e das tarefas em segundo plano. - -### Requisitos - -- Você deve atualizar quando a versão do recurso estiver defasada por **no máximo** duas versões. Por exemplo, ao atualizar para o {% data variables.product.prodname_enterprise %} {{ enterpriseVersions.latest }}, você deve estar nas versões {% data variables.product.prodname_enterprise %} {{ enterpriseVersions.supported[1] }} ou {{ enterpriseVersions.supported[2] }}. -- {% data reusables.enterprise_installation.hotpatching-explanation %} -- Um hotpatch pode causar tempo de inatividade se os serviços afetados (como kernel, MySQL ou Elasticsearch) exigirem reinicialização da VM ou do serviço. Você receberá uma notificação quando/se a reinicialização for necessária. Será possível reinicializar em outro momento. -- Procure disponibilizar um armazenamento adicional na raiz durante a atualização, já que o hotpatching instala várias versões de alguns serviços até a conclusão da atualização. Caso não haja espaço suficiente, você receberá uma notificação das verificações preliminares. -- Ao atualizar pelo hotpatching, sua instância não pode ficar carregada demais (isso pode afetar o processo). As verificações preliminares avaliarão se a média de carga e a atualização irão falhar se a média de carga for muito alta. - Atualizar para {% data variables.product.prodname_ghe_server %} 2.17 migra seus logs de auditoria do Elasticsearch para MySQL. Além disso, essa migração aumenta a quantidade de tempo e espaço em disco necessários para restaurar um instantâneo. Antes de migrar, verifique o número de bytes nos índices de log de auditoria do Elasticsearch com este comando: -``` shell -curl -s http://localhost:9201/audit_log/_stats/store | jq ._all.primaries.store.size_in_bytes -``` -Use o número para estimar o espaço em disco necessário para os logs de auditoria do MySQL. O script também monitora seu espaço livre em disco durante o andamento da importação. Monitorar esse número é útil principalmente se o espaço livre em disco estiver próximo da quantidade de espaço em disco necessária para a migração. - -Após ler essas recomendações e requisitos, você poderá atualizar para o {% data variables.product.prodname_ghe_server %}. Para obter mais informações, consulte "[Atualizar o {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-github-enterprise-server/)." diff --git a/translations/pt-BR/content/admin/installation/upgrading-github-enterprise-server.md b/translations/pt-BR/content/admin/installation/upgrading-github-enterprise-server.md deleted file mode 100644 index 94cc52a8ac11..000000000000 --- a/translations/pt-BR/content/admin/installation/upgrading-github-enterprise-server.md +++ /dev/null @@ -1,219 +0,0 @@ ---- -title: Atualizar o GitHub Enterprise Server -intro: 'Atualize o {% data variables.product.prodname_ghe_server %} para usar os recursos e atualizações de segurança mais recentes.' -redirect_from: - - /enterprise/admin/articles/upgrading-to-the-latest-release/ - - /enterprise/admin/articles/migrations-and-upgrades/ - - /enterprise/admin/guides/installation/upgrading-the-github-enterprise-virtual-machine/ - - /enterprise/admin/guides/installation/upgrade-packages-for-older-releases/ - - /enterprise/admin/articles/upgrading-older-installations/ - - /enterprise/admin/hidden/upgrading-older-installations/ - - /enterprise/admin/hidden/upgrading-github-enterprise-using-a-hotpatch-early-access-program/ - - /enterprise/admin/hidden/upgrading-github-enterprise-using-a-hotpatch/ - - /enterprise/admin/guides/installation/upgrading-github-enterprise/ - - /enterprise/admin/installation/upgrading-github-enterprise-server -versions: - enterprise-server: '*' ---- - -### Preparar para a atualização - -1. Determine uma estratégia de atualização e escolha uma versão para atualizar. Para obter mais informações, consulte "[Requisitos de atualização](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)". -3. Crie um backup da instância primária usando o {% data variables.product.prodname_enterprise_backup_utilities %}. Para obter mais informações, consulte o [Arquivo LEIAME.md do {% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils#readme). -4. Se você estiver atualizando com um pacote de atualização, programe um período de manutenção para os usuários finais do {% data variables.product.prodname_ghe_server %}. Se estiver usando um hotpatch, não será necessário recorrer ao modo de manutenção. - - {% note %} - - **Observação:** o período de manutenção depende do tipo de atualização a ser feita. Atualizações com hotpatch normalmente não exigem período de manutenção. É preciso reinicializar a instância em alguns casos, mas o processo pode ser feito em outro momento. Seguindo o esquema de versões do MAJOR.FEATURE.PATCH, as versões de patch que usam pacote de atualização costumam gerar menos de cinco minutos de tempo de inatividade. Versões de recursos que incluem migrações de dados levam mais tempo, dependendo do desempenho do armazenamento e da quantidade de dados migrados. Para obter mais informações, consulte "[Habilitar e programar o modo de manutenção](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)". - - {% endnote %} - -### Obter um instantâneo - -Instantâneo é um ponto de verificação de uma máquina virtual (VM) em um momento específico. É altamente recomendável obter um instantâneo antes de atualizar sua máquina virtual para que você possa recuperar a VM em caso de falha. Se você estiver atualizando para uma nova versão do recurso, obtenha um instantâneo da VM. Se você estiver atualizando para uma versão de patch, vincule o disco de dados existente. - -Há dois tipos de instantâneo: - -- **Instantâneos de VM** salvam todo o estado da VM, inclusive dados do usuário e da configuração. Esse método de instantâneo é demorado e requer muito espaço livre em disco. -- **Instantâneos em disco de dados** salvam somente os dados do usuário. - - {% note %} - - **Observações:** - - Algumas plataformas não permitem usar instantâneos apenas do disco de dados. Nesse caso, você terá que obter um instantâneo de toda a VM. - - Se o hipervisor não der suporte a instantâneos completos de VM, obtenha um instantâneo do disco raiz e do disco de dados em rápida sucessão. - - {% endnote %} - -| Plataforma | Método de instantâneo | URL de documentação de instantâneo | -| --------------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| Amazon AWS | Disco | | -| Azure | VM | | -| Hyper-V | VM | | -| Google Compute Engine | Disco | | -| VMware | VM | [https://pubs.vmware.com/vsphere-50/topic/com.vmware.wssdk.pg.doc_50/PG_Ch11_VM_Manage.13.3.html](https://pubs.vmware.com/vsphere-50/topic/com.vmware.wssdk.pg.doc_50/PG_Ch11_VM_Manage.13.3.html) | -| XenServer | VM | | - -### Atualizar com hotpatch - -{% data reusables.enterprise_installation.hotpatching-explanation %} Ao usar o {% data variables.enterprise.management_console %}, é possível instalar um hotpatch na mesma hora ou programar a instalação para depois. Você pode usar o shell administrativo para instalar um hotpatch com o utilitário `ghe-upgrade`. Para obter mais informações, consulte "[Requisitos de atualização](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)". - -{% note %} - -**Observação**: A instalação de hotpatch com o {% data variables.enterprise.management_console %} não está disponível para ambientes em cluster. Para instalar um hotpatch em um ambiente em cluster, consulte "[Atualizar um cluster](/enterprise/{{ currentVersion }}/admin/clustering/upgrading-a-cluster#upgrading-with-a-hotpatch)". - -{% endnote %} - -#### Atualizar um appliance com hotpatch - -##### Instalar um hotpatch usando o {% data variables.enterprise.management_console %} - -1. Habilite atualizações automáticas. Para obter mais informações, consulte "[Habilitar atualizações automáticas](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-automatic-update-checks/)". -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.updates-tab %} -4. Quando um novo hotpatch for baixado, use o menu suspenso Install package (Instalar pacote): - - Para instalar na mesma hora, selecione **Now** (Agora): - - Para instalar depois, selecione outra data. ![Menu suspenso com datas para instalação de hotpatch](/assets/images/enterprise/management-console/hotpatch-installation-date-dropdown.png) -5. Clique em **Install** (Instalar). ![Botão de instalação de hotpatch](/assets/images/enterprise/management-console/hotpatch-installation-install-button.png) - -##### Instalar hotpatch usando o shell administrativo - -{% data reusables.enterprise_installation.download-note %} - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. {% data reusables.enterprise_installation.enterprise-download-upgrade-pkg %} Copie a URL do hotpackage de atualização (arquivo *.hpkg*). -{% data reusables.enterprise_installation.download-package %} -4. Execute o comando `ghe-upgrade` usando o nome de arquivo do pacote: - ```shell - admin@HOSTNAME:~$ ghe-upgrade GITHUB-UPGRADE.hpkg - *** verifying upgrade package signature... - ``` -5. Se for necessário reinicializar para aplicar as atualizações no kernel, MySQL, Elasticsearch ou em outros programas, você receberá uma notificação do script de atualização do hotpatch. - -#### Atualizar um appliance com instâncias de réplica usando hotpatch - -{% note %} - -**Observação**: Se estiver instalando um hotpatch, não há necessidade de entrar no modo de manutenção ou parar a replicação. - -{% endnote %} - -Appliances configurados para alta disponibilidade e replicação geográfica usam instâncias de réplica, além de instâncias principais. Para atualizar esses appliance, você terá que atualizar a instância primária e todas as instâncias de réplica, uma por vez. - -##### Atualizar a instância primária - -1. Atualize a instância primária seguindo as instruções em "[Instalar hotpatch usando o shell administrativo](#installing-a-hotpatch-using-the-administrative-shell)". - -##### Atualizar uma instância de réplica - -{% note %} - -**Observação:** se você estiver executando várias instâncias de réplica como parte da replicação geográfica, repita esse procedimento para cada instância de réplica, uma por vez. - -{% endnote %} - -1. Atualize a instância da réplica seguindo as instruções em "[Instalar hotpatch usando o shell administrativo](#installing-a-hotpatch-using-the-administrative-shell)". Se você estiver usando várias réplicas de replicação geográfica, repita esse procedimento para atualizar cada réplica, uma por vez. -{% data reusables.enterprise_installation.replica-ssh %} -{% data reusables.enterprise_installation.replica-verify %} - -### Atualizar com pacote de atualização - -Mesmo que seja possível usar um hotpatch para fazer a atualização do patch em uma série, você deve usar um pacote de atualização a fim de atualizar para uma versão mais recente. Por exemplo, use um pacote ao atualizar da versão `2.11.10` para a `2.12.4`, já que elas estão em séries diferentes. Para obter mais informações, consulte "[Requisitos de atualização](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)". - -#### Atualizar um appliance com pacote de atualização - -{% data reusables.enterprise_installation.download-note %} - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. {% data reusables.enterprise_installation.enterprise-download-upgrade-pkg %} Selecione a plataforma adequada e copie a URL do pacote de atualização (arquivo *.pkg*). -{% data reusables.enterprise_installation.download-package %} -4. Habilite o modo de manutenção e aguarde a conclusão de todos os processos ativos na instância do {% data variables.product.prodname_ghe_server %}. Para obter mais informações, consulte "[Habilitar e programar o modo de manutenção](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)". - - {% note %} - - **Observação**: ao atualizar o appliance primário em uma configuração de alta disponibilidade, o appliance já deverá estar no modo de manutenção se você seguir as instruções em "[Atualizar a instância primária](#upgrading-the-primary-instance)". - - {% endnote %} - -5. Execute o comando `ghe-upgrade` usando o nome de arquivo do pacote: - ```shell - admin@HOSTNAME:~$ ghe-upgrade GITHUB-UPGRADE.pkg - *** verifying upgrade package signature... - ``` -6. Confirme que você gostaria de continuar a atualização e de reiniciar após a verificação da assinatura do pacote. O novo sistema de arquivos raiz grava na partição secundária, e a instância é reiniciada automaticamente em modo de manutenção: - ```shell - *** aplicando atualização... - This package will upgrade your installation to version version-number - Current root partition: /dev/xvda1 [version-number] - Target root partition: /dev/xvda2 - Proceed with installation? [y/N] - ``` -7. Em atualizações de appliance único, desabilite o modo de manutenção para os usuários poderem trabalhar com a {% data variables.product.product_location_enterprise %}. - - {% note %} - - **Observação**: ao atualizar appliances em configurações de alta disponibilidade, mantenha o modo de manutenção até atualizar todas as réplicas e a replicação estar atual. Para obter mais informações, consulte "[Atualizar instância de réplica](#upgrading-a-replica-instance)". - - {% endnote %} - -#### Atualizar um appliance com instâncias de réplica usando um pacote de atualização - -Appliances configurados para alta disponibilidade e replicação geográfica usam instâncias de réplica, além de instâncias principais. Para atualizar esses appliance, você terá que atualizar a instância primária e todas as instâncias de réplica, uma por vez. - -##### Atualizar a instância primária - -{% warning %} - -**Aviso:** se a replicação for interrompida em caso de falha da instância primária, será perdido qualquer trabalho feito antes da atualização da réplica e do reinício da replicação. - -{% endwarning %} - -1. Na instância primária, habilite o modo de manutenção e aguarde a conclusão de todos os processos ativos. Para obter mais informações, consulte "[Habilitar o modo de manutenção](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode/)". -{% data reusables.enterprise_installation.replica-ssh %} -3. Na instância de réplica (ou em todas as instâncias de réplica), se você estiver executando várias réplicas como parte da replicação geográfica, execute `ghe-repl-stop` para parar a replicação. -4. Atualize a instância primária seguindo as instruções em "[Atualizar um appliance com pacote de atualização](#upgrading-a-single-appliance-with-an-upgrade-package)". - -##### Atualizar uma instância de réplica - -{% note %} - -**Observação:** se você estiver executando várias instâncias de réplica como parte da replicação geográfica, repita esse procedimento para cada instância de réplica, uma por vez. - -{% endnote %} - -1. Atualize a instância de réplica seguindo as instruções em "[Atualizar um appliance com pacote de atualização](#upgrading-a-single-appliance-with-an-upgrade-package)". Se você estiver usando várias réplicas de replicação geográfica, repita esse procedimento para atualizar cada réplica, uma por vez. -{% data reusables.enterprise_installation.replica-ssh %} -{% data reusables.enterprise_installation.replica-verify %} - -{% data reusables.enterprise_installation.start-replication %} - -{% data reusables.enterprise_installation.replication-status %} Se o comando retornar `Replicação não executada`, pode ser que a replicação ainda esteja começando. Aguarde cerca de um minuto para executar `ghe-repl-status` novamente. - - {% note %} - - **Observação:** enquanto a ressincronização estiver em andamento, o código `ghe-repl-status` pode retornar mensagens esperadas indicando que a replicação está atrasada. - Por exemplo: `CRÍTICO: a replicação git está atrás do primário em mais de 1007 repositórios e/ou gists` - - {% endnote %} - - Se `ghe-repl-status` não retornar `OK`, siga estas etapas para iniciar a replicação manualmente. - - 1. Na instância de réplica, execute `ghe-repl-setup ` mais uma vez. - {% data reusables.enterprise_installation.start-replication %} - {% data reusables.enterprise_installation.replication-status %} -6. Ao concluir a atualização da última réplica e quando a ressincronização terminar, desabilite o modo de manutenção para que os usuários possam trabalhar na {% data variables.product.product_location_enterprise %}. - -### Restaurar após uma atualização com falha - -Em caso de falha ou interrupção da atualização, volte a sua instância ao estado anterior. Esse processo dependerá do tipo de atualização. - -#### Voltar a uma versão de patch - -Para reverter uma versão de patch, use o comando `ghe-upgrade` com o switch `--allow-patch-rollback`. {% data reusables.enterprise_installation.command-line-utilities-ghe-upgrade-rollback %} - -Para obter mais informações, consulte "[Utilitários de linha de comando](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities/#ghe-upgrade)". - -#### Voltar a uma versão de recurso - -Para voltar a partir de uma versão de recurso, faça a restauração partindo de um instantâneo da VM para garantir o estado consistente das partições raiz e de dados. Para obter mais informações, consulte "[Obter um instantâneo](#taking-a-snapshot)". diff --git a/translations/pt-BR/content/admin/installation/using-github-enterprise-server-with-a-load-balancer.md b/translations/pt-BR/content/admin/installation/using-github-enterprise-server-with-a-load-balancer.md deleted file mode 100644 index a6c61fa87f25..000000000000 --- a/translations/pt-BR/content/admin/installation/using-github-enterprise-server-with-a-load-balancer.md +++ /dev/null @@ -1,54 +0,0 @@ ---- -title: Usar o GitHub Enterprise Server com balanceador de carga -intro: 'Use um balanceador de carga na frente de um appliance ou de um par de appliances do {% data variables.product.prodname_ghe_server %} em uma configuração de alta disponibilidade.' -redirect_from: - - /enterprise/admin/guides/installation/using-github-enterprise-with-a-load-balancer/ - - /enterprise/admin/installation/using-github-enterprise-server-with-a-load-balancer -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_clustering.load_balancer_intro %} - -{% data reusables.enterprise_clustering.load_balancer_dns %} - -### Informações de conexão do cliente - -Como as conexões do cliente com o {% data variables.product.prodname_ghe_server %} vêm do balanceador de carga, pode ocorrer a perda do endereço IP do cliente. - -{% data reusables.enterprise_clustering.proxy_preference %} - -{% data reusables.enterprise_clustering.proxy_xff_firewall_warning %} - -#### Habilitar o suporte de protocolo PROXY na {% data variables.product.product_location_enterprise %} - -É altamente recomendável ativar o suporte de protocolo PROXY para o appliance e o balanceador de carga. Use as instruções do fornecedor para habilitar o protocolo PROXY no balanceador de carga. Para obter mais informações, consulte a [documentação do protocolo PROXY](http://www.haproxy.org/download/1.6/doc/proxy-protocol.txt). - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -3. Em **External load balancers** (Balanceadores de carga externos), selecione **Enable support for PROXY protocol** (Habilitar suporte do protocolo PROXY). ![Caixa de seleção para habilitar o suporte do protocolo PROXY](/assets/images/enterprise/management-console/enable-proxy.png) -{% data reusables.enterprise_management_console.save-settings %} - -{% data reusables.enterprise_clustering.proxy_protocol_ports %} - -#### Habilitar o suporte X-Forwarded-For na {% data variables.product.product_location_enterprise %} - -{% data reusables.enterprise_clustering.x-forwarded-for %} - -{% data reusables.enterprise_installation.terminating-tls %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -3. Em **External load balancers** (Balanceadores de carga externos), selecione **Allow HTTP X-Forwarded-For header** (Habilitar header HTTP X-Forwarded-For). ![Caixa de seleção para permitir o header HTTP X-Forwarded-For](/assets/images/enterprise/management-console/allow-xff.png) -{% data reusables.enterprise_management_console.save-settings %} - -{% data reusables.enterprise_clustering.without_proxy_protocol_ports %} - -### Configurar verificações de integridade - -As verificações de integridade permitem que um balanceador de carga pare de enviar tráfego para um nó que não responde em caso de falha na verificação pré-configurada do nó em questão. Se o appliance estiver offline devido a manutenção ou falha inesperada, o balanceador de carga poderá exibir uma página de status. Em configurações de alta disponibilidade (HA), é possível usar balanceadores de carga como parte da estratégia de failover. No entanto, não há suporte para failover automático de pares de HA. Promova manualmente o appliance réplica antes que ele comece a atender a solicitações. Para obter mais informações, consulte "[Configurar o {% data variables.product.prodname_ghe_server %} para alta disponibilidade](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-github-enterprise-server-for-high-availability/)". - -{% data reusables.enterprise_clustering.health_checks %} -{% data reusables.enterprise_site_admin_settings.maintenance-mode-status %} diff --git a/translations/pt-BR/content/admin/installation/validating-your-domain-settings.md b/translations/pt-BR/content/admin/installation/validating-your-domain-settings.md deleted file mode 100644 index 5afc461849fc..000000000000 --- a/translations/pt-BR/content/admin/installation/validating-your-domain-settings.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: Validar configurações de domínio -intro: 'Antes de iniciar a {% data variables.product.product_location_enterprise %} pela primeira vez, verifique se as configurações de domínio estão ajustadas adequadamente.' -redirect_from: - - /enterprise/admin/installation/validating-your-domain-settings -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.hostname-menu-item %} -4. Para testar as configurações DNS e SSL, clique em **Test domain settings** (Testar configurações de domínio). ![Botão Test domain settings (Testar configurações de domínio)](/assets/images/enterprise/management-console/test-domain-settings.png) -{% data reusables.enterprise_management_console.test-domain-settings-failure %} -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/pt-BR/content/admin/installation/viewing-push-logs.md b/translations/pt-BR/content/admin/installation/viewing-push-logs.md deleted file mode 100644 index c4d621fe0a9b..000000000000 --- a/translations/pt-BR/content/admin/installation/viewing-push-logs.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: Exibir logs de push -intro: 'Os administradores do site podem exibir uma lista de operações push do Git para qualquer repositório na {% data variables.product.product_location_enterprise %}.' -redirect_from: - - /enterprise/admin/articles/viewing-push-logs/ - - /enterprise/admin/installation/viewing-push-logs -versions: - enterprise-server: '*' ---- - -As entradas de log de push mostram o seguinte: - -- Quem iniciou o push; -- Se o push foi forçado ou não; -- O branch para o qual o push foi feito; -- O protocolo usado para fazer push; -- O endereço IP de origem; -- O cliente Git usado para fazer push; -- Os hashes SHA de antes e depois da operação. - -### Exibir os logs de push do repositório - -1. Navegue até um repositório. -{% data reusables.enterprise_site_admin_settings.access-settings %} -3. No canto superior direito da página, clique em {% octicon "shield" aria-label="The shield" %} **Security** (Segurança). ![Guia de segurança](/assets/images/enterprise/site-admin-settings/repo/repo-security-top-tab.png) -4. Na barra lateral esquerda, clique em **Push Log** (Log de push). ![Guia de log de push](/assets/images/enterprise/site-admin-settings/push-log-tab.png) - -### Exibir os logs de push do repositório na linha de comando - -1. Acesse o SSH no appliance. Para obter mais informações, consulte "[Acessar o shell administrativo (SSH)](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-administrative-shell-ssh/)". -2. No repositório do Git adequado, abra o arquivo de log de auditoria: - ```shell - ghe-repo owner/repository -c "less audit_log" - ``` diff --git a/translations/pt-BR/content/admin/migrations/about-migrations.md b/translations/pt-BR/content/admin/migrations/about-migrations.md deleted file mode 100644 index 962990d5c89e..000000000000 --- a/translations/pt-BR/content/admin/migrations/about-migrations.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: Sobre migrações -intro: 'Migração é o processo de transferência de dados de um local de *origem* (organização do {% data variables.product.prodname_dotcom_the_website %} ou uma instância do {% data variables.product.prodname_ghe_server %}) para uma instância de *destino* do {% data variables.product.prodname_ghe_server %}. É possível usar as migrações para transferir os dados ao alterar plataformas ou atualizar o hardware na sua instância.' -redirect_from: - - /enterprise/admin/migrations/about-migrations -versions: - enterprise-server: '*' ---- - -### Tipos de migração - -Você pode fazer três tipos de migração: - -- Migração de uma instância do {% data variables.product.prodname_ghe_server %} para outra do {% data variables.product.prodname_ghe_server %}: você pode migrar qualquer número de repositórios pertencentes a qualquer usuário ou organização na instância. Para executar a migração, você deve ter acesso de administrador do site a ambas as instâncias. -- Migração de uma organização do {% data variables.product.prodname_dotcom_the_website %} para uma instância do {% data variables.product.prodname_ghe_server %}: você pode migrar qualquer número de repositórios pertencentes à organização. Para fazer a migração, você deve ter [acesso administrativo](/enterprise/user/articles/permission-levels-for-an-organization/) à organização do {% data variables.product.prodname_dotcom_the_website %} e acesso de administrador do site na instância de destino. -- *Execuções de experiência* são migrações que importam dados para uma [instância de preparo](/enterprise/admin/guides/installation/setting-up-a-staging-instance/). Elas podem ser úteis para ver o que *aconteceria* se uma migração fosse aplicada à {% data variables.product.product_location_enterprise %}. **É altamente recomendável fazer uma execução de experiência em uma instância de preparo antes de importar dados para a sua instância de produção.** - -### Dados migrados - -Durante uma migração, tudo gira em torno do repositório. A maioria dos dados associados ao repositório pode ser migrada. Por exemplo, um repositório dentro de uma organização migrará o repositório *e* a organização, além dos usuários, equipes, problemas e pull requests associados ao repositório. - -Os itens na tabela abaixo podem ser migrados com um repositório. Não é possível migrar os itens que não constam na lista. - -{% data reusables.enterprise_migrations.fork-persistence %} - -| Dados associados a um repositório migrado | Observações | -| --------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Usuários | As **@menções** aos usuários são rescritas para corresponder ao destino. | -| Organizações | Os nomes e detalhes das organizações são migrados. | -| Repositórios | Links para árvores, blobs, commits e linhas do Git são rescritas para corresponder ao destino. O migrador segue no máximo três redirecionamentos de repositório. | -| Wikis | Todos os dados da wiki são migrados. | -| Equipes | As **@menções** às equipes são rescritas para corresponder ao destino. | -| Marcos | Os registros de data e hora são preservados. | -| Quadros de projeto | Os quadros de projeto associados ao repositório e à organização proprietária do repositório são migrados. | -| Questões | As referências a problemas e os registros de data e hora são preservados. | -| Comentários dos problemas | As referências cruzadas a comentários são rescritas para a instância de destino. | -| Pull requests | As referências cruzadas a pull requests são rescritas para corresponder ao destino. Os registros de data e hora são preservados. | -| Revisões de pull request | As revisões de pull request e os dados associados são migrados. | -| Comentários das revisões de pull request | As referências cruzadas aos comentários são rescritas para a instância de destino. Os registros de data e hora são preservados. | -| Comentários de commit | As referências cruzadas a comentários são rescritas para a instância de destino. Os registros de data e hora são preservados. | -| Versões | Todos os dados das versões são migrados. | -| Ações feitas em problemas ou em pull requests | São preservadas todas as modificações em problemas ou pull requests, como atribuir usuários, renomear títulos e modificar etiquetas, bem como os registros de data e hora de cada ação. | -| Anexos de arquivo | [Anexos de arquivo em problemas e pull requests](/articles/file-attachments-on-issues-and-pull-requests) são migrados. Você pode desabilitar essa opção como parte da migração. | -| Webhooks | Somente os webhooks ativos são migrados. | -| Chaves de implantação de repositório | As chaves de implantação de repositório são migradas. | -| Branches protegidos | As configurações de branches protegidos e os dados associados são migrados. | diff --git a/translations/pt-BR/content/admin/migrations/applying-the-imported-data-on-github-enterprise-server.md b/translations/pt-BR/content/admin/migrations/applying-the-imported-data-on-github-enterprise-server.md deleted file mode 100644 index e5a1625baa39..000000000000 --- a/translations/pt-BR/content/admin/migrations/applying-the-imported-data-on-github-enterprise-server.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Aplicar dados importados no GitHub Enterprise Server -intro: 'Depois de concluir a revisão dos dados de migração, você poderá aplicar permanentemente as alterações à instância de destino.' -redirect_from: - - /enterprise/admin/guides/migrations/applying-the-imported-data-on-github-enterprise/ - - /enterprise/admin/migrations/applying-the-imported-data-on-github-enterprise-server -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_installation.ssh-into-target-instance %} - -2. Usando o comando `ghe-migrator import`, comece o processo de importação. Você precisará do seguinte: - * Seu Migration GUID. - * Seu token de acesso pessoal para autenticação. O token de acesso pessoal que você usa é apenas para autenticação como administrador do site e não requer nenhum escopo específico. Para mais informação, consulte "[Criando um token de acesso pessoal](/github/authenticating-to-github/creating-a-personal-access-token)." - - ```shell - $ ghe-migrator import /home/admin/MIGRATION_GUID.tar.gz -g MIGRATION_GUID -u username -p TOKEN - - > Starting GitHub::Migrator - > Import 100% complete / - ``` - - * {% data reusables.enterprise_migrations.specify-staging-path %} diff --git a/translations/pt-BR/content/admin/migrations/completing-the-import-on-github-enterprise-server.md b/translations/pt-BR/content/admin/migrations/completing-the-import-on-github-enterprise-server.md deleted file mode 100644 index 50788f8f980c..000000000000 --- a/translations/pt-BR/content/admin/migrations/completing-the-import-on-github-enterprise-server.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Concluir a importação no GitHub Enterprise Server -intro: 'Depois de aplicar sua migração à instância de destino e após a revisão da migração, você vai desbloquear os repositórios e excluí-los da origem. Antes de excluir os dados da origem, é recomendável aguardar cerca de duas semanas para garantir o funcionamento adequado de todos os procedimentos.' -redirect_from: - - /enterprise/admin/guides/migrations/completing-the-import-on-github-enterprise/ - - /enterprise/admin/migrations/completing-the-import-on-github-enterprise-server -versions: - enterprise-server: '*' ---- - -### Desbloquear repositórios na instância de destino - -{% data reusables.enterprise_installation.ssh-into-instance %} -{% data reusables.enterprise_migrations.unlocking-on-instances %} - -### Desbloquear repositórios na origem - -#### Desbloquear repositórios de uma organização do {% data variables.product.prodname_dotcom_the_website %} - -Para desbloquear repositórios em uma organização do {% data variables.product.prodname_dotcom_the_website %}, você enviará uma solicitação `DELETE` para o ponto de extremidade de desbloqueio da migração. Você precisará do seguinte: - * Token de acesso para autenticação; - * `id` exclusivo da migração; - * Nome do repositório a ser desbloqueado. -```shell -curl -H "Authorization: token GITHUB_ACCESS_TOKEN" -X DELETE \ - -H "Accept: application/vnd.github.wyandotte-preview+json" \ - https://api.github.com/orgs/orgname/migrations/id/repos/repo_name/lock -``` - -#### Excluir repositórios de uma organização do {% data variables.product.prodname_dotcom_the_website %} - -Depois de desbloquear os repositórios da organização do {% data variables.product.prodname_dotcom_the_website %}, você deve excluir todos os repositórios migrados anteriormente usando o [endpoint de exclusão de repositórios](/enterprise/{{ currentVersion }}/v3/repos/#delete-a-repository). Você precisará do token de acesso para autenticação: -```shell -curl -H "Authorization: token GITHUB_ACCESS_TOKEN" -X DELETE \ - https://api.github.com/repos/orgname/repo_name -``` - -#### Desbloquear repositórios de uma instância do {% data variables.product.prodname_ghe_server %} - -{% data reusables.enterprise_installation.ssh-into-instance %} -{% data reusables.enterprise_migrations.unlocking-on-instances %} diff --git a/translations/pt-BR/content/admin/migrations/exporting-migration-data-from-github-enterprise-server.md b/translations/pt-BR/content/admin/migrations/exporting-migration-data-from-github-enterprise-server.md deleted file mode 100644 index 958e8d87d2fe..000000000000 --- a/translations/pt-BR/content/admin/migrations/exporting-migration-data-from-github-enterprise-server.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Exportar dados de migração do GitHub Enterprise Server -intro: 'Para exportar os dados de migração de uma instância do {% data variables.product.prodname_ghe_server %}, você deverá preparar a instância, bloquear os repositórios e gerar um arquivo de migração. Você deve exportar os dados da instância do {% data variables.product.prodname_ghe_server %} se estiver planejando mudar de plataforma ou se estiver com tudo pronto para migrar de uma instância de experiência para uma instância de produção.' -redirect_from: - - /enterprise/admin/guides/migrations/exporting-migration-data-from-github-enterprise/ - - /enterprise/admin/migrations/exporting-migration-data-from-github-enterprise-server -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/pt-BR/content/admin/migrations/exporting-migration-data-from-githubcom.md b/translations/pt-BR/content/admin/migrations/exporting-migration-data-from-githubcom.md deleted file mode 100644 index 5caee79f7db4..000000000000 --- a/translations/pt-BR/content/admin/migrations/exporting-migration-data-from-githubcom.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Exportar dados de migração do GitHub.com -intro: 'Para exportar os dados de migração de uma organização do {% data variables.product.prodname_dotcom_the_website %}, você deverá usar a API para selecionar os repositórios a serem migrados. Feito isso, você vai gerar um arquivo de migração que pode ser importado na instância do {% data variables.product.prodname_ghe_server %}.' -redirect_from: - - /enterprise/admin/guides/migrations/exporting-migration-data-from-github-com - - /enterprise/admin/migrations/exporting-migration-data-from-githubcom -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/pt-BR/content/admin/migrations/exporting-the-github-enterprise-server-source-repositories.md b/translations/pt-BR/content/admin/migrations/exporting-the-github-enterprise-server-source-repositories.md deleted file mode 100644 index e19b804fbd9e..000000000000 --- a/translations/pt-BR/content/admin/migrations/exporting-the-github-enterprise-server-source-repositories.md +++ /dev/null @@ -1,84 +0,0 @@ ---- -title: Exportar os repositórios de origem do GitHub Enterprise Server -intro: 'Depois de bloquear os repositórios de origem, você pode exportá-los individualmente ou em lote usando uma lista de URLs de repositório em um arquivo de texto. Feito isso, você criará um único arquivo de migração para o processo de importação.' -redirect_from: - - /enterprise/admin/guides/migrations/exporting-the-github-enterprise-source-repositories/ - - /enterprise/admin/migrations/exporting-the-github-enterprise-server-source-repositories -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_migrations.locking-repositories %} - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. Para preparar a exportação de um repositório, use o comando `ghe-migrator add` com a URL do repositório: - * Se você estiver bloqueando o repositório, adicione `--lock` ao comando. Se estiver executando um teste, não será necessário incluir `--lock`. - ```shell - $ ghe-migrator add https://hostname/username/reponame --lock - ``` - * Você pode excluir anexos de arquivos adicionando `--exclude_attachments` ao comando. {% data reusables.enterprise_migrations.exclude-file-attachments %} - * Para preparar a exportação de vários repositórios de uma só vez, crie um arquivo de texto listando cada URL do repositório em uma linha separada e execute o comando `ghe-migrator add` com o sinalizador `-i` e o caminho para o seu arquivo de texto. - ```shell - $ ghe-migrator add -i PATH/TO/YOUR/REPOSITORY_URLS.txt - ``` - -3. Quando solicitado, informe seu nome de usuário do {% data variables.product.prodname_ghe_server %}: - ```shell - Insira o nome de usuário autorizado para a migração: admin - ``` -4. Quando o token de acesso pessoal for solicitado, informe o token de acesso que você criou na seção "[Preparar a instância de origem do {% data variables.product.prodname_ghe_server %}](/enterprise/admin/guides/migrations/preparing-the-github-enterprise-server-source-instance/)": - ```shell - Insira o token de acesso pessoal: ************** - ``` -5. Após a conclusão do `ghe-migrator add`, ele imprimirá o "GUID de Migração" exclusivo gerado para identificar a exportação e a lista dos recursos adicionados à exportação. Você usará o GUID de Migração gerado nas etapas subsequentes `ghe-migrator add` e `ghe-migrator export` para informar que o `ghe-migrator` deve continuar operando na mesma exportação. - ```shell - > 101 models added to export - > Migration GUID: example-migration-guid - > Number of records in this migration: - > users | 5 - > organizations | 1 - > repositories | 1 - > teams | 3 - > protected_branches | 1 - > pull_request_reviews | 1 - > milestones | 1 - > issues | 3 - > pull_requests | 5 - > pull_request_review_comments | 4 - > commit_comments | 2 - > issue_comments | 10 - > issue_events | 63 - > releases | 3 - > attachments | 4 - > projects | 2 - ``` - Sempre que você adicionar um novo repositório com o GUID de Migração atual, ele atualizará a exportação atual. Se você executar `ghe-migrator add` novamente sem GUID de Migração, ele vai iniciar uma nova exportação e gerar um novo GUID de Migração. **Não reutilize o GUID de Migração gerado durante uma exportação quando você começar a preparar a migração para importar**. - -3. Se você bloqueou o repositório de origem, é possível usar o comando `ghe-migrator target_url` para personalizar uma mensagem de bloqueio na página de repositório que vincula ao novo local do repositório. Informe a URL do repositório de origem, a URL do repositório de destino e o GUID de Migração da Etapa 5: - - ```shell - $ ghe-migrator target_url https://hostname/username/reponame https://target_hostname/target_username/target_reponame -g MIGRATION_GUID - ``` - -6. Para adicionar mais repositórios à mesma exportação, use o comando `ghe-migrator add` com o sinalizador `-g`. Informe a nova URL do repositório e o GUID de Migração da Etapa 5: - ```shell - $ ghe-migrator add https://hostname/username/other_reponame -g MIGRATION_GUID --lock - ``` -7. Quando terminar de adicionar os repositórios, gere o arquivo de migração usando o comando `ghe-migrator export` com o sinalizador `-g` e o GUID de Migração da Etapa 5: - ```shell - $ ghe-migrator export -g MIGRATION_GUID - > Archive saved to: /data/github/current/tmp/MIGRATION_GUID.tar.gz - ``` - * {% data reusables.enterprise_migrations.specify-staging-path %} - -8. Fechar a conexão com {% data variables.product.product_location_enterprise %}: - ```shell - $ exit - > logout - > Connection to hostname closed. - ``` -9. Copie o arquivo de migração para o seu computador usando o comando [`scp`](https://linuxacademy.com/blog/linux/ssh-and-scp-howto-tips-tricks#scp). O arquivo terá o nome do GUID de Migração: - ```shell - $ scp -P 122 admin@hostname:/data/github/current/tmp/MIGRATION_GUID.tar.gz ~/Desktop - ``` -{% data reusables.enterprise_migrations.ready-to-import-migrations %} diff --git a/translations/pt-BR/content/admin/migrations/exporting-the-githubcom-organizations-repositories.md b/translations/pt-BR/content/admin/migrations/exporting-the-githubcom-organizations-repositories.md deleted file mode 100644 index 7fbfd43c1e67..000000000000 --- a/translations/pt-BR/content/admin/migrations/exporting-the-githubcom-organizations-repositories.md +++ /dev/null @@ -1,70 +0,0 @@ ---- -title: Exportar os repositórios da organização do GitHub.com -intro: 'Usando a API de Migrações, é possível exportar os repositórios de uma organização. Após a exportação dos repositórios, você vai baixar o arquivo de migração usado para o processo de importação.' -redirect_from: - - /enterprise/admin/guides/migrations/exporting-the-github-com-organization-s-repositories - - /enterprise/admin/migrations/exporting-the-githubcom-organizations-repositories -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_migrations.fork-persistence %} - -Para exportar os dados do repositório do {% data variables.product.prodname_dotcom_the_website %}, use a API de Migrações. - -No momento, a API de Migrações está em período de exibição. Ou seja, os pontos de extremidade e os parâmetros podem mudar no futuro. Para acessar a API de Migrações, você deve informar um [tipo de mídia](/v3/media) personalizado no cabeçalho `Accept`: `application/vnd.github.wyandotte-preview+json`. Os exemplos abaixo incluem o tipo de mídia personalizado. - -### Gerar arquivos de migração - -{% data reusables.enterprise_migrations.locking-repositories %} - -1. Informe os integrantes da organização que você fará uma migração. Dependendo do número de repositórios exportados, a exportação pode levar vários minutos. A migração completa (com importação) pode levar horas. Portanto, é recomendável fazer uma avaliação para determinar a duração do processo completo. Para obter mais informações, consulte "[Sobre migrações](/enterprise/admin/migrations/about-migrations#types-of-migrations)". - -2. Comece a migração fazendo `POST` no ponto de extremidade da migração. Você precisará do seguinte: - * Token de acesso para autenticação; - * Uma [lista de repositórios](/v3/repos/#list-organization-repositories) que você pretende migrar: - ```shell - curl -H "Authorization: token GITHUB_ACCESS_TOKEN" -X POST \ - -H "Accept: application/vnd.github.wyandotte-preview+json" \ - -d'{"lock_repositories":true,"repositories":["orgname/reponame", "orgname/reponame"]}' \ - https://api.github.com/orgs/orgname/migrations - ``` - * Se quiser bloquear os repositórios antes da migração, verifique se `lock_repositories` está definido como `true`. Fazer isso é altamente recomendável. - * Você pode excluir anexos de arquivos adicionando `exclude_attachments: true` ao ponto de extremidade. {% data reusables.enterprise_migrations.exclude-file-attachments %} O tamanho do arquivo final deve ser menor do que 20 GB. - - A solicitação retorna um `id ` exclusivo que representa a migração. Você precisará dele em ações subsequentes que envolvam a API de Migrações. - -3. Envie uma solicitação `GET` para o ponto de extremidade de status da migração para fazer fetch do status da migração. Você precisará do seguinte: - * Token de acesso para autenticação; - * `id` exclusivo da migração. - ```shell - curl -H "Authorization: token GITHUB_ACCESS_TOKEN" \ - -H "Accept: application/vnd.github.wyandotte-preview+json" \ - https://api.github.com/orgs/orgname/migrations/id - ``` - - Os estados das migrações são os seguintes: - * `pending`, a migração ainda não começou; - * `exporting`, a migração está em andamento; - * `exported`, a migração foi concluída com êxito; - * `failed`, houve falha na migração. - -4. Depois de exportar a migração, baixe o aquivo de migração enviando uma solicitação `GET` para o ponto de extremidade de download da migração. Você precisará do seguinte: - * Token de acesso para autenticação; - * `id` exclusivo da migração. - ```shell - curl -H "Accept: application/vnd.github.wyandotte-preview+json" \ - -u GITHUB_USERNAME:GITHUB_ACCESS_TOKEN \ - -L -o migration_archive.tar.gz \ - https://api.github.com/orgs/orgname/migrations/id/archive - ``` - -5. O arquivo de migração é excluído automaticamente após sete dias. Para excluí-lo antes, você pode enviar a solicitação `DELETE` para o ponto de extremidade de exclusão do arquivo de migração. Você precisará do seguinte: - * Token de acesso para autenticação; - * `id` exclusivo da migração. - ```shell - curl -H "Authorization: token GITHUB_ACCESS_TOKEN" -X DELETE \ - -H "Accept: application/vnd.github.wyandotte-preview+json" \ - https://api.github.com/orgs/orgname/migrations/id/archive - ``` -{% data reusables.enterprise_migrations.ready-to-import-migrations %} diff --git a/translations/pt-BR/content/admin/migrations/generating-a-list-of-migration-conflicts.md b/translations/pt-BR/content/admin/migrations/generating-a-list-of-migration-conflicts.md deleted file mode 100644 index 629fd3812c7f..000000000000 --- a/translations/pt-BR/content/admin/migrations/generating-a-list-of-migration-conflicts.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: Gerar uma lista de conflitos de migração -intro: 'Se houver conflitos nos relatórios `ghe-migrator` durante a preparação dos dados para importação, você deverá gerar uma lista dos conflitos antes de se preparar para resolvê-los com mapeamentos personalizados.' -redirect_from: - - /enterprise/admin/migrations/generating-a-list-of-migration-conflicts -versions: - enterprise-server: '*' ---- - -1. Usando o comando `ghe-migrator conflicts` com o GUID de migração, gere um arquivo *conflicts.csv*: - ```shell - $ ghe-migrator conflicts -g MIGRATION_GUID > conflicts.csv - ``` - - Se nenhum conflito for relatado, você poderá importar os dados com segurança conforme as etapas descritas em "[Aplicar os dados importados no {% data variables.product.prodname_ghe_server %}](/enterprise/admin/guides/migrations/applying-the-imported-data-on-github-enterprise-server/)". -2. Se houver conflitos, usando o comando [`scp`](https://linuxacademy.com/blog/linux/ssh-and-scp-howto-tips-tricks#scp), copie *conflicts.csv* para o seu computador local: - ```shell - $ scp -P 122 admin@hostname:conflicts.csv ~/Desktop - ``` -3. Continue em "[Resolver conflitos de migração ou configurar mapeamentos personalizados](/enterprise/admin/guides/migrations/resolving-migration-conflicts-or-setting-up-custom-mappings/)". diff --git a/translations/pt-BR/content/admin/migrations/importing-data-from-third-party-version-control-systems.md b/translations/pt-BR/content/admin/migrations/importing-data-from-third-party-version-control-systems.md deleted file mode 100644 index f89a22b8d5d6..000000000000 --- a/translations/pt-BR/content/admin/migrations/importing-data-from-third-party-version-control-systems.md +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: Importar dados de sistemas de controle de versão de terceiros -intro: 'Usando o conjunto de ferramentas git-import, é possível fazer importações dos controles de versão do Subversion, do Mercurial e do Team Foundation para repositórios do Git no {% data variables.product.prodname_ghe_server %}.' -redirect_from: - - /enterprise/admin/migrations/importing-data-from-third-party-version-control-systems -versions: - enterprise-server: '*' ---- - -### Importar projetos do Mercurial - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. Faça um clone bruto do projeto usando o comando abaixo. Especifique a URL do projeto de origem e um caminho para um repositório temporário: - ```shell - $ git-import-hg-raw HG-CLONE-URL /PATH/REPO-NAME.git - # Creates a new repository with one or more Git refs in "refs/import/" in the specified path. - ``` -{% data reusables.enterprise_migrations.review-the-import-csv %} -4. Rescreva os autores e branches usando o arquivo CSV: - ```shell - $ git-import-rewrite --flavor hg --authors /PATH/AUTHORS-MAP-FILE.csv /PATH/REPO-NAME.git - ``` -5. Caso ainda não tenha feito isso, [crie um repositório vazio no {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/user/articles/creating-a-new-repository). -{% data reusables.command_line.switching_directories_procedural %} -7. Faça push do repositório importado para o {% data variables.product.prodname_ghe_server %}: - ```shell - $ git push --mirror PUSH-URL-ON-GITHUB-ENTERPRISE - ``` - -### Importar projetos do Subversion - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. Faça um clone bruto do projeto usando o comando abaixo. Especifique a URL do projeto de origem e um caminho para um repositório temporário: - ```shell - $ git-import-svn-raw SVN-CLONE-URL /PATH/REPO-NAME.git - # Creates a new repository with one or more Git refs in "refs/import/" in the specified path. - ``` -{% data reusables.enterprise_migrations.review-the-import-csv %} -4. Rescreva os autores e branches usando o arquivo CSV: - ```shell - $ git-import-rewrite --flavor svn --authors /PATH/AUTHORS-MAP-FILE.csv /PATH/REPO-NAME.git - ``` -5. Caso ainda não tenha feito isso, [crie um repositório vazio no {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/user/articles/creating-a-new-repository). -{% data reusables.command_line.switching_directories_procedural %} -7. Faça push do repositório importado para o {% data variables.product.prodname_ghe_server %}: - ```shell - $ git push --mirror PUSH-URL-ON-GITHUB-ENTERPRISE - ``` - -### Importar projetos do Team Foundation - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. Faça um clone bruto do projeto usando o comando abaixo. Especifique a URL do projeto de origem e um caminho para um repositório temporário: - ```shell - $ git-import-tfs-raw TEAM-FOUNDATION-CLONE-URL /PATH/REPO-NAME.git - # Creates a new repository with one or more Git refs in "refs/import/" in the specified path. - ``` -{% data reusables.enterprise_migrations.review-the-import-csv %} -4. Rescreva os autores e branches usando o arquivo CSV: - ```shell - $ git-import-rewrite --flavor tfs --authors /PATH/AUTHORS-MAP-FILE.csv /PATH/REPO-NAME.git - ``` -5. Caso ainda não tenha feito isso, [crie um repositório vazio no {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/user/articles/creating-a-new-repository). -{% data reusables.command_line.switching_directories_procedural %} -7. Faça push do repositório importado para o {% data variables.product.prodname_ghe_server %}: - ```shell - $ git push --mirror PUSH-URL-ON-GITHUB-ENTERPRISE - ``` - -### Leia mais - -- "[Command-line-utilities](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities/#import-and-export)" diff --git a/translations/pt-BR/content/admin/migrations/importing-migration-data-to-github-enterprise-server.md b/translations/pt-BR/content/admin/migrations/importing-migration-data-to-github-enterprise-server.md deleted file mode 100644 index 2721e151627c..000000000000 --- a/translations/pt-BR/content/admin/migrations/importing-migration-data-to-github-enterprise-server.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Importar dados de migração para o GitHub Enterprise Server -intro: 'Após gerar um arquivo de migração, você poderá importar os dados para a sua instância de destino do {% data variables.product.prodname_ghe_server %}. Antes de aplicar as alterações permanentemente na instância de destino, será possível revisá-las para resolver possíveis conflitos.' -redirect_from: - - /enterprise/admin/guides/migrations/importing-migration-data-to-github-enterprise/ - - /enterprise/admin/migrations/importing-migration-data-to-github-enterprise-server -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/pt-BR/content/admin/migrations/index.md b/translations/pt-BR/content/admin/migrations/index.md deleted file mode 100644 index 16e103d94c05..000000000000 --- a/translations/pt-BR/content/admin/migrations/index.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: 'Migrar dados de usuário, organização e repositório' -shortTitle: Migrando dados -intro: 'É possível exportar dados de usuário, organização e repositório de {% data variables.product.prodname_ghe_server %} ou {% data variables.product.prodname_dotcom_the_website %}, e depois importar esses dados para o {% data variables.product.product_location_enterprise %}.' -redirect_from: - - /enterprise/admin/articles/moving-a-repository-from-github-com-to-github-enterprise/ - - /enterprise/admin/categories/migrations-and-upgrades/ - - /enterprise/admin/migrations -versions: - enterprise-server: '*' ---- - - -### Índice - -{% topic_link_in_list /overview %} - {% link_in_list /about-migrations %} -{% topic_link_in_list /exporting-migration-data-from-github-enterprise-server %} - {% link_in_list /preparing-the-github-enterprise-server-source-instance %} - {% link_in_list /exporting-the-github-enterprise-server-source-repositories %} -{% topic_link_in_list /exporting-migration-data-from-githubcom %} - {% link_in_list /preparing-the-githubcom-source-organization %} - {% link_in_list /exporting-the-githubcom-organizations-repositories %} -{% topic_link_in_list /importing-migration-data-to-github-enterprise-server %} - {% link_in_list /preparing-the-migrated-data-for-import-to-github-enterprise-server %} - {% link_in_list /generating-a-list-of-migration-conflicts %} - {% link_in_list /reviewing-migration-conflicts %} - {% link_in_list /resolving-migration-conflicts-or-setting-up-custom-mappings %} - {% link_in_list /applying-the-imported-data-on-github-enterprise-server %} - {% link_in_list /reviewing-migration-data %} - {% link_in_list /completing-the-import-on-github-enterprise-server %} - {% link_in_list /importing-data-from-third-party-version-control-systems %} diff --git a/translations/pt-BR/content/admin/migrations/overview.md b/translations/pt-BR/content/admin/migrations/overview.md deleted file mode 100644 index 10d3ff6e76b0..000000000000 --- a/translations/pt-BR/content/admin/migrations/overview.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Visão Geral -intro: 'Saiba mais sobre a migração de dados para {% data variables.product.product_location_enterprise %}.' -mapTopic: true -redirect_from: - - /enterprise/admin/migrations/overview -versions: - enterprise-server: '*' ---- - diff --git a/translations/pt-BR/content/admin/migrations/preparing-the-github-enterprise-server-source-instance.md b/translations/pt-BR/content/admin/migrations/preparing-the-github-enterprise-server-source-instance.md deleted file mode 100644 index 8a7975454327..000000000000 --- a/translations/pt-BR/content/admin/migrations/preparing-the-github-enterprise-server-source-instance.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: Preparar a instância de origem do GitHub Enterprise Server -intro: 'Antes de migrar os dados do {% data variables.product.prodname_ghe_server %}, verifique se você tem a autenticação e o acesso administrativo adequados à instância.' -redirect_from: - - /enterprise/admin/guides/migrations/preparing-the-github-enterprise-source-instance/ - - /enterprise/admin/migrations/preparing-the-github-enterprise-server-source-instance -versions: - enterprise-server: '*' ---- - -1. Verifique se você é administrador do site na origem do {% data variables.product.prodname_ghe_server %}. A melhor maneira de fazer isso é verificar se você consegue fazer [SSH na instância](/enterprise/admin/guides/installation/accessing-the-administrative-shell-ssh/). - -2. {% data reusables.enterprise_migrations.token-generation %} na instância de origem do {% data variables.product.prodname_ghe_server %}. - -{% data reusables.enterprise_migrations.make-a-list %} diff --git a/translations/pt-BR/content/admin/migrations/preparing-the-githubcom-source-organization.md b/translations/pt-BR/content/admin/migrations/preparing-the-githubcom-source-organization.md deleted file mode 100644 index 8ffafc887cad..000000000000 --- a/translations/pt-BR/content/admin/migrations/preparing-the-githubcom-source-organization.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: Preparar a organização de origem do GitHub.com -intro: 'Antes de migrar os repositórios de uma organização do {% data variables.product.prodname_dotcom_the_website %}, verifique se você tem a autenticação e o acesso administrativo adequados à instância.' -redirect_from: - - /enterprise/admin/guides/migrations/preparing-the-github-com-source-organization - - /enterprise/admin/migrations/preparing-the-githubcom-source-organization -versions: - enterprise-server: '*' ---- - -1. Verifique se você tem [permissões de proprietário](/articles/permission-levels-for-an-organization/) nos repositórios de origem da organização. - -2. {% data reusables.enterprise_migrations.token-generation %} no {% data variables.product.prodname_dotcom_the_website %}. - -{% data reusables.enterprise_migrations.make-a-list %} diff --git a/translations/pt-BR/content/admin/migrations/preparing-the-migrated-data-for-import-to-github-enterprise-server.md b/translations/pt-BR/content/admin/migrations/preparing-the-migrated-data-for-import-to-github-enterprise-server.md deleted file mode 100644 index 6fe76a82e663..000000000000 --- a/translations/pt-BR/content/admin/migrations/preparing-the-migrated-data-for-import-to-github-enterprise-server.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: Preparar os dados migrados para a importação no GitHub Enterprise Server -intro: 'Antes de aplicar os dados migrados à sua instância de destino, você terá que copiar o arquivo de migração para a instância de destino e prepará-lo para importação.' -redirect_from: - - /enterprise/admin/guides/migrations/preparing-the-migrated-data-for-import-to-github-enterprise/ - - /enterprise/admin/migrations/preparing-the-migrated-data-for-import-to-github-enterprise-server -versions: - enterprise-server: '*' ---- - -1. Usando o comando [`scp`](https://linuxacademy.com/blog/linux/ssh-and-scp-howto-tips-tricks#scp), copie o arquivo de migração gerado na organização ou instância de origem para o destino no {% data variables.product.prodname_ghe_server %}: - - ```shell - $ scp -P 122 /path/to/archive/MIGRATION_GUID.tar.gz admin@hostname:/home/admin/ - ``` - -{% data reusables.enterprise_installation.ssh-into-target-instance %} - -3. Use o comando `ghe-migrator prepare` para preparar o arquivo para importação na instância de destino e gerar um novo GUID de Migração para uso nas etapas subsequentes: - - ```shell - ghe-migrator prepare /home/admin/MIGRATION_GUID.tar.gz - ``` - - * Para começar uma nova tentativa de importação, execute o comando `ghe-migrator` novamente e obtenha um novo GUID de Migração. - * {% data reusables.enterprise_migrations.specify-staging-path %} diff --git a/translations/pt-BR/content/admin/migrations/resolving-migration-conflicts-or-setting-up-custom-mappings.md b/translations/pt-BR/content/admin/migrations/resolving-migration-conflicts-or-setting-up-custom-mappings.md deleted file mode 100644 index 2c43ec4a3444..000000000000 --- a/translations/pt-BR/content/admin/migrations/resolving-migration-conflicts-or-setting-up-custom-mappings.md +++ /dev/null @@ -1,70 +0,0 @@ ---- -title: Resolver conflitos de migração ou configurar mapeamentos personalizados -intro: 'Antes de importar os dados de migração, você pode fazer correções para resolver conflitos, renomear registros recebidos ou mapear os registros recebidos para registros existentes.' -redirect_from: - - /enterprise/admin/migrations/resolving-migration-conflicts-or-setting-up-custom-mappings -versions: - enterprise-server: '*' ---- - -É possível usar as etapas a seguir para resolver conflitos ou adicionar mapeamentos personalizados à sua migração. - -### Resolver conflitos - -Se achar que o `ghe-migrator` fará uma alteração incorreta, você poderá fazer correções alterando os dados em *conflicts.csv*. Você pode alterar qualquer linha no arquivo *conflicts.csv*. - -Por exemplo, digamos que você perceba que o usuário `octocat` da origem está sendo mapeado para `octocat` no destino: - -| `nome_modelo` | `url_origem` | `url_destino` | `ação_recomendada` | -| ------------- | ----------------------------------- | ----------------------------------- | ------------------ | -| `usuário` | `https://exemplo-gh.source/octocat` | `https://exemplo-gh.target/octocat` | `map` | - -Você pode optar por mapear o usuário para outro usuário no destino. Suponha que você saiba que `octocat` deveria ser `monalisa` no destino. É possível alterar a coluna `url_destino` no arquivo *conflicts.csv* para se referir a `monalisa`: - -| `nome_modelo` | `url_origem` | `url_destino` | `ação_recomendada` | -| ------------- | ----------------------------------- | ------------------------------------ | ------------------ | -| `usuário` | `https://exemplo-gh.source/octocat` | `https://exemplo-gh.target/monalisa` | `map` | - -Em outra situação, se você quiser renomear o repositório `octo-org/widgets` como `octo-org/amazing-widgets` na instância de destino, altere `url_destino` para `octo-org/amazing-widgets` e `ação_recomendada` para `rename`: - -| `nome_modelo` | `url_origem` | `url_destino` | `ação_recomendada` | -| ------------- | -------------------------------------------- | ---------------------------------------------------- | ------------------ | -| `repositório` | `https://exemplo-gh.source/octo-org/widgets` | `https://exemplo-gh.target/octo-org/amazing-widgets` | `rename` | - -### Adicionar mapeamentos personalizados - -Uma situação comum durante as migrações é o cenário em que os usuários migrados têm nomes de usuários diferentes no destino e na origem. - -Com uma lista de nomes de usuários da origem e uma lista de nomes de usuários do destino, você pode criar um arquivo CSV com mapeamentos personalizados e aplicá-la para garantir que o nome de usuário e o conteúdo de cada usuário sejam atribuídos corretamente no fim da migração. - -Você pode gerar um arquivo em formato CSV dos usuários que estão sendo migrados para aplicar mapeamentos personalizados usando o comando [`ghe-migrator audit`](/enterprise/admin/guides/migrations/reviewing-migration-data): - -```shell -$ ghe-migrator audit -m user -g MIGRATION_GUID > users.csv -``` - -Agora você pode editar esse CSV, inserir a nova URL para cada usuário que pretende mapear ou renomear e atualizar a quarta coluna para aplicar `map` ou `rename`. - -Por exemplo, para renomear o usuário `octocat` como `monalisa` no destino `https://example-gh.target`, você deveria criar uma linha com o seguinte conteúdo: - -| `nome_modelo` | `url_origem` | `url_destino` | `estado` | -| ------------- | ----------------------------------- | ------------------------------------ | -------- | -| `usuário` | `https://exemplo-gh.source/octocat` | `https://exemplo-gh.target/monalisa` | `rename` | - -O mesmo processo pode ser usado para criar mapeamentos em cada registro compatível com mapeamentos personalizados. Para obter mais informações, consulte a nossa [tabela com as possibilidades de mapeamento em registros](/enterprise/admin/guides/migrations/reviewing-migration-conflicts#possible-mappings-for-each-record-type). - -### Aplicar dados de migração modificados - -1. Depois de fazer as alterações, use o comando [`scp`](https://linuxacademy.com/blog/linux/ssh-and-scp-howto-tips-tricks#scp) para aplicar seu arquivo *conflicts.csv* modificado (ou qualquer outro csv de mapeamento no formato correto) à instância de destino: - - ```shell - $ scp -P 122 ~/Desktop/conflicts.csv admin@hostname:/home/admin/ - ``` - -2. Remapeie os dados de migração usando o comando `ghe-migrator map`, passando pelo caminho do seu arquivo csv modificado e do GUID de Migração: - - ```shell - $ ghe-migrator map -i conflicts.csv -g MIGRATION_GUID - ``` - -3. Se o comando `ghe-migrator map -i conflicts.csv -g MIGRATION_GUID` ainda reportar conflitos, execute o processo de resolução de conflitos de migração novamente. diff --git a/translations/pt-BR/content/admin/migrations/reviewing-migration-conflicts.md b/translations/pt-BR/content/admin/migrations/reviewing-migration-conflicts.md deleted file mode 100644 index be645c83d0b4..000000000000 --- a/translations/pt-BR/content/admin/migrations/reviewing-migration-conflicts.md +++ /dev/null @@ -1,43 +0,0 @@ ---- -title: Revisar conflitos de migração -intro: 'Depois de gerar uma lista de conflitos de migração, revise-os para garantir que você concorda com as ações padrão que o `ghe-migrator` vai executar para resolvê-los.' -redirect_from: - - /enterprise/admin/migrations/reviewing-migration-conflicts -versions: - enterprise-server: '*' ---- - -1. Usando o editor de texto ou um [software de planilha compatível com CSV](https://en.wikipedia.org/wiki/Comma-separated_values#Application_support), abra o arquivo *conflicts.csv*. -2. Seguindo os exemplos e tabelas de referência abaixo, revise o arquivo *conflicts.csv* para garantir a execução das ações adequadas na importação. - -O arquivo *conflicts.csv* contém um *mapa de migração* de conflitos e ações recomendadas. O mapa de migração lista quais dados estão sendo migrados da origem e como eles serão aplicados ao destino. - -| `nome_modelo` | `url_origem` | `url_destino` | `ação_recomendada` | -| -------------- | ------------------------------------------------------ | ------------------------------------------------------ | ------------------ | -| `usuário` | `https://exemplo-gh.source/octocat` | `https://exemplo-gh.target/octocat` | `map` | -| `organization` | `https://exemplo-gh.source/octo-org` | `https://exemplo-gh.target/octo-org` | `map` | -| `repositório` | `https://exemplo-gh.source/octo-org/widgets` | `https://exemplo-gh.target/octo-org/widgets` | `rename` | -| `equipe` | `https://exemplo-gh.source/orgs/octo-org/teams/admins` | `https://exemplo-gh.target/orgs/octo-org/teams/admins` | `merge` | - -Cada linha do arquivo *conflicts.csv* mostra as seguintes informações: - -| Nome | Descrição | -| -------------------- | ------------------------------------------------------------------------- | -| `model_name` | Tipo de dado que está sendo alterado. | -| `source_url` | URL de origem dos dados. | -| `target_url` | URL esperada de destino dos dados. | -| `recommended_action` | Ação preferencial que o `ghe-migrator` vai executar ao importar os dados. | - -### Mapeamentos possíveis para cada tipo de registro - -O `ghe-migrator` pode executar várias ações de mapeamento diferentes quando transfere os dados: - -| `Ação` | Descrição | Modelos aplicáveis | -| --------------- | ------------------------------------------------------------------------------------- | ------------------------------------ | -| `import` | (padrão) Os dados da origem são importados para o destino. | Todos os tipos de registro | -| `map` | Os dados da origem são substituídos pelos dados existentes no destino. | Usuários, organizações, repositórios | -| `rename` | Os dados da origem são renomeados e copiados para o destino. | Usuários, organizações, repositórios | -| `map_or_rename` | Se houver destino, mapeie para o destino. Se não houver, renomeie o modelo importado. | Usuários | -| `merge` | Os dados da origem são combinados com os dados existentes no destino. | Equipes | - -**É altamente recomendável que você revise o arquivo *conflicts.csv* e faça a [`auditoria do ghe-migrator`](/enterprise/admin/guides/migrations/reviewing-migration-data) para confirmar a execução das ações adequadas.** Se tudo estiver bem, você poderá continuar para a seção "[Aplicar os dados importados no {% data variables.product.prodname_ghe_server %}](/enterprise/admin/guides/migrations/applying-the-imported-data-on-github-enterprise-server)". diff --git a/translations/pt-BR/content/admin/migrations/reviewing-migration-data.md b/translations/pt-BR/content/admin/migrations/reviewing-migration-data.md deleted file mode 100644 index 20753ad00c59..000000000000 --- a/translations/pt-BR/content/admin/migrations/reviewing-migration-data.md +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: Revisar dados de migração -intro: 'Depois de cada etapa da migração, você pode revisar o estado dos dados migrados. Será possível garantir que os registros estejam sendo mapeados ou renomeados corretamente, obter as novas URLs dos registros após a etapa de importação e listar todos os registros que não foram migrados.' -redirect_from: - - '/enterprise/{{ currentVersion }}/admin/guides/migrations/reviewing-the-imported-data/' - - /enterprise/admin/migrations/reviewing-migration-data -versions: - enterprise-server: '*' ---- - -Por padrão, o `ghe-migrator audit` devolve todos os registros. Também é possível filtrar os registros por: - - * Tipos de registro; - * Estado de registro. - -Os tipos de registro correspondem aos encontrados nos [dados migrados](/enterprise/admin/guides/migrations/about-migrations/#migrated-data). - -### Filtros por tipo de registro - -| Tipo de registro | Nome do filtro | -| --------------------------------------------- | ----------------------------- | -| Usuários | `user` | -| Organizações | `organization` | -| Repositórios | `repository` | -| Equipes | `equipe` | -| Marcos | `milestone` | -| Quadros de projeto | `project` | -| Problemas | `issue` | -| Comentários dos problemas | `issue_comment` | -| Pull requests | `pull_request` | -| Revisões de pull request | `pull_request_review` | -| Comentários de commit | `commit_comment` | -| Comentários das revisões de pull request | `pull_request_review_comment` | -| Versões | `release` | -| Ações feitas em problemas ou em pull requests | `issue_event` | -| Branches protegidos | `protected_branch` | - -### Filtros por estado de registro - -| Estado de registro | Descrição | -| ------------------ | --------------------------------------- | -| `export` | O registro será exportado. | -| `import` | O registro será importado. | -| `map` | O registro será mapeado. | -| `rename` | O registro será renomeado. | -| `merge` | O registro passará por merge. | -| `exported` | O registro foi exportado com êxito. | -| `imported` | O registro foi importado com êxito. | -| `mapped` | O registro foi mapeado com êxito. | -| `renamed` | O registro foi renomeado com êxito. | -| `merged` | O registro passou por merge com êxito. | -| `failed_export` | Houve falha ao exportar o registro. | -| `failed_import` | Houve falha ao importar o registro. | -| `failed_map` | Houve falha ao mapear o registro. | -| `failed_rename` | Houve falha ao renomear o registro. | -| `failed_merge` | Houve falha ao fazer merge no registro. | - -### Filtrar registros auditados - -Com o comando `ghe-migrator audit`, é possível filtrar com base no tipo de registro usando o sinalizador `-m`. Da mesma forma, você pode filtrar no estado de importação usando o sinalizador `-s`. O comando fica parecido com o seguinte: - -```shell -$ ghe-migrator audit -m RECORD_TYPE -s STATE -g MIGRATION_GUID -``` - -Por exemplo, para visualizar todas as organizações e equipes importadas com êxito, você digitaria: -```shell -$ ghe-migrator audit -m organization,team -s mapped,renamed -g MIGRATION_GUID -> model_name,source_url,target_url,state -> organization,https://gh.source/octo-org/,https://ghe.target/octo-org/,renamed -``` - -**É altamente recomendável fazer auditoria em todas as importações que tiveram falha.** Para fazer isso, insira: -```shell -$ ghe-migrator audit -s failed_import,failed_map,failed_rename,failed_merge -g MIGRATION_GUID -> model_name,source_url,target_url,state -> user,https://gh.source/octocat,https://gh.target/octocat,failed -> repository,https://gh.source/octo-org/octo-project,https://ghe.target/octo-org/octo-project,failed -``` - -Em caso de problemas com falhas na importação, entre em contato com o {% data variables.contact.contact_ent_support %}. diff --git a/translations/pt-BR/content/admin/user-management/about-global-webhooks.md b/translations/pt-BR/content/admin/user-management/about-global-webhooks.md deleted file mode 100644 index ebd7663e90d5..000000000000 --- a/translations/pt-BR/content/admin/user-management/about-global-webhooks.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: Sobre webhooks globais -intro: Os webhooks globais enviam notificações sobre eventos no nível da instância. -redirect_from: - - /enterprise/admin/user-management/about-global-webhooks -versions: - enterprise-server: '*' ---- - -Você pode usar webhooks globais para monitorar, responder ou impor regras automaticamente para o gerenciamento de usuários e de organizações na sua instância. Por exemplo, você pode configurar os webhooks para serem executados sempre que: -- Uma conta de usuário for criada ou excluída; -- Uma organização for criada ou excluída; -- Um colaborador for adicionado ou removido de um repositório; -- Um repositório tiver bifurcação. - -![Lista de webhooks globais](/assets/images/enterprise/site-admin-settings/list-of-global-webhooks.png) - -Para obter mais informações sobre como configurar webhooks, consulte "[Gerenciar webhooks globais](/enterprise/{{ currentVersion }}/admin/guides/user-management/managing-global-webhooks)". - -{% data reusables.enterprise_user_management.manage-global-webhooks-api %} diff --git a/translations/pt-BR/content/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories.md b/translations/pt-BR/content/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories.md deleted file mode 100644 index 9e9a0469a4bc..000000000000 --- a/translations/pt-BR/content/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Permitir que administradores habilitem o acesso de leitura anônimo do Git a repositórios públicos -intro: 'Para simplificar o funcionamento das ferramentas personalizadas na sua instância e ignorar os requisitos de autenticação, você pode permitir que os administradores de repositório habilitem o acesso de leitura anônimo do Git a repositórios públicos na {% data variables.product.product_location_enterprise %}.' -redirect_from: - - /enterprise/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_user_management.disclaimer-for-git-read-access %} - -Se o modo privado estiver habilitado, você poderá permitir que os administradores de repositório habilitem o acesso de leitura anônimo do Git a repositórios públicos na {% data variables.product.product_location_enterprise %}. Para obter mais informações sobre o modo privado, consulte "[Habilitar modo privado](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-private-mode/)". - -Conceder o acesso de leitura anônimo do Git permite ignorar a autenticação de ferramentas personalizadas na sua instância. Quando você ou um administrador de repositório habilitar essa configuração de acesso em um repositório, as operações não autenticadas do Git (e qualquer pessoa com acesso de rede ao {% data variables.product.prodname_ghe_server %}) terão acesso de leitura sem autenticação ao repositório. - -Você também pode impedir que os administradores do repositório alterem as configurações de acesso anônimo do Git a todos os repositórios ou a um repositório específico na {% data variables.product.product_location_enterprise %}. Para obter mais informações, consulte "[Impedir os usuários de alterarem o acesso de leitura anônimo do Git](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)". - -{% data reusables.enterprise_site_admin_settings.list-of-repos-with-anonymous-git-read-access-enabled %} - -{% data reusables.enterprise_user_management.exceptions-for-enabling-anonymous-git-read-access %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -4. Em "Anonymous Git read access" (Acesso de leitura anônimo do Git), use o menu suspenso e clique em **Enabled** (Habilitado). ![Menu suspenso de acesso de leitura anônimo do Git com as opções "Enabled" (Habilitado) e "Disabled" (Desabilitado) -](/assets/images/enterprise/site-admin-settings/enable-anonymous-git-read-access.png) -3. Para impedir que os administradores de repositório alterem as configurações de acesso de leitura anônimo do Git em todos os repositórios da instância, você também pode selecionar **Prevent repository admins from changing anonymous Git read access** (Impedir administradores de repositório de alterarem o acesso de leitura anônimo do Git). ![Marcar a caixa de seleção para impedir que administradores de repositório alterem as configurações de acesso de leitura anônimo do Git em todos os repositórios da instância](/assets/images/enterprise/site-admin-settings/globally-lock-repos-from-changing-anonymous-git-read-access.png) - -### Habilitar o acesso de leitura anônimo do Git a determinado repositório - -{% data reusables.enterprise_user_management.exceptions-for-enabling-anonymous-git-read-access %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -6. Em "Danger Zone" (Zona de perigo), ao lado de "Enable anonymous Git read access" (Habilitar acesso de leitura anônimo do Git), clique em **Enable** (Habilitar). ![Botão "Enabled" (Habilitado) na opção "Enable anonymous Git read access" (Habilitar acesso de leitura anônimo do Git) na zona de perigo das configurações de administração do site ](/assets/images/enterprise/site-admin-settings/site-admin-enable-anonymous-git-read-access.png) -7. Revise as alterações. Para confirmar, clique em **Yes, enable anonymous Git read access** (Sim, permitir acesso de leitura anônimo ao Git). ![Confirmar configuração de acesso de leitura anônimo do Git na janela pop-up](/assets/images/enterprise/site-admin-settings/confirm-anonymous-git-read-access-for-specific-repo-as-site-admin.png) -8. Para impedir que os administradores de repositório alterem a configuração nesse repositório, você também pode selecionar **Prevent repository admins from changing anonymous Git read access** (Impedir administradores de repositório de alterarem o acesso de leitura anônimo do Git). ![Marcar a caixa de seleção para impedir que administradores de repositório alterem as configurações de acesso de leitura anônimo do Git em todos os repositórios da instância](/assets/images/enterprise/site-admin-settings/lock_anonymous_git_access_for_specific_repo.png) diff --git a/translations/pt-BR/content/admin/user-management/allowing-built-in-authentication-for-users-outside-your-identity-provider.md b/translations/pt-BR/content/admin/user-management/allowing-built-in-authentication-for-users-outside-your-identity-provider.md deleted file mode 100644 index 85059843ff67..000000000000 --- a/translations/pt-BR/content/admin/user-management/allowing-built-in-authentication-for-users-outside-your-identity-provider.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: Permitir a autenticação integrada para usuários de fora do provedor de identidade -intro: 'Com a autenticação integrada, você pode autenticar usuários que não têm acesso ao seu provedor de identidade que usa LDAP, SAML ou CAS.' -redirect_from: - - /enterprise/admin/user-management/allowing-built-in-authentication-for-users-outside-your-identity-provider -versions: - enterprise-server: '*' ---- - -### Sobre a autenticação integrada para usuários de fora do provedor de identidade - -É possível usar a autenticação integrada para usuários externos quando você não conseguir adicionar contas específicas ao seu provedor de identidade (IdP), como contas de contratados ou usuários de máquinas. Você também pode usar a autenticação integrada para acessar uma conta de fallback se o provedor de identidade não estiver disponível. - -Após a configuração da autenticação integrada, quando um usuário se autenticar com êxito via SAML ou CAS, ele não poderá se autenticar com nome de usuário e senha. Se o usuário se autenticar com êxito via LDAP, as credenciais não serão mais consideradas internas. - -A autenticação integrada para um IdP específico fica desabilitada por padrão. - -{% warning %} - -**Aviso:** se desabilitar a autenticação integrada, você terá que suspender individualmente todos os usuários que não devem mais ter acesso à instância. Para obter mais informações, consulte "[Suspender e cancelar a suspensão de usuários](/enterprise/{{ currentVersion }}/admin/guides/user-management/suspending-and-unsuspending-users)". - -{% endwarning %} - -### Configurar a autenticação integrada para usuários de fora do provedor de identidade - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.authentication %} -4. Selecione seu provedor de identidade. ![Opção Select identity provider (Selecionar provedor de identidade) -](/assets/images/enterprise/management-console/identity-provider-select.gif) -5. Selecione **Allow creation of accounts with built-in authentication** (Permitir a criação de contas com autenticação integrada). ![Opção Select built-in authentication (Selecionar autenticação integrada)](/assets/images/enterprise/management-console/built-in-auth-identity-provider-select.png) -6. Leia o aviso e clique em **Ok**. - -{% data reusables.enterprise_user_management.two_factor_auth_header %} -{% data reusables.enterprise_user_management.2fa_is_available %} - -### Convidar usuários de fora do provedor de identidade para autenticação na sua instância - -Quando aceitar o convite, o usuário poderá fazer login com seu próprio nome de usuário e senha, em vez de fazer login via IdP. - -{% data reusables.enterprise_site_admin_settings.sign-in %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.invite-user-sidebar-tab %} -{% data reusables.enterprise_site_admin_settings.invite-user-reset-link %} - -### Leia mais - -- [Usar LDAP](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap) -- [Usar SAML](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-saml) -- [Usar CAS](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-cas) diff --git a/translations/pt-BR/content/admin/user-management/archiving-and-unarchiving-repositories.md b/translations/pt-BR/content/admin/user-management/archiving-and-unarchiving-repositories.md deleted file mode 100644 index 537f3a1ea78c..000000000000 --- a/translations/pt-BR/content/admin/user-management/archiving-and-unarchiving-repositories.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: Arquivar e cancelar o arquivamento de repositórios -intro: 'Como administrador do site, você pode arquivar e cancelar o arquivamento de repositórios no painel de administração.' -redirect_from: - - /enterprise/admin/articles/archiving-and-unarchiving-repositories/ - - /enterprise/admin/user-management/archiving-and-unarchiving-repositories -versions: - enterprise-server: '*' ---- - -### Arquivar um repositório -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -5. Em Danger Zone (Zona de perigo), clique em **Archive** (Arquivar). ![Botão Archive (Arquivar)](/assets/images/enterprise/site-admin-settings/repo-archive.png) -6. Clique em **Archive Repository** (Arquivar repositório). ![Botão Archive repository (Arquivar repositório)](/assets/images/enterprise/site-admin-settings/repo-archive-confirm.png) - -### Cancelar o arquivamento de um repositório -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -5. Em Danger Zone (Zona de perigo), clique em **Unarchive** (Cancelar o arquivamento). ![Botão Archive (Arquivar)](/assets/images/enterprise/site-admin-settings/repo-unarchive.png) -6. Clique em **Unarchive Repository** (Cancelar o arquivamento do repositório). ![Botão Archive repository (Arquivar repositório)](/assets/images/enterprise/site-admin-settings/repo-unarchive-confirm.png) - -### Leia mais -- [Sobre o arquivamento de repositórios](/enterprise/{{ currentVersion }}/user/articles/about-archiving-repositories) diff --git a/translations/pt-BR/content/admin/user-management/authenticating-users-for-your-github-enterprise-server-instance.md b/translations/pt-BR/content/admin/user-management/authenticating-users-for-your-github-enterprise-server-instance.md deleted file mode 100644 index b448120e1272..000000000000 --- a/translations/pt-BR/content/admin/user-management/authenticating-users-for-your-github-enterprise-server-instance.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: Autenticar usuários para a instância do GitHub Enterprise Server -intro: 'Você pode usar a autenticação integrada do {% data variables.product.prodname_ghe_server %} ou escolher entre CAS, LDAP ou SAML para integrar suas contas e gerenciar centralmente o acesso dos usuários à {% data variables.product.product_location_enterprise %}.' -redirect_from: - - /enterprise/admin/categories/authentication/ - - /enterprise/admin/guides/installation/user-authentication/ - - /enterprise/admin/articles/inviting-users/ - - /enterprise/admin/guides/migrations/authenticating-users-for-your-github-enterprise-instance/ - - /enterprise/admin/user-management/authenticating-users-for-your-github-enterprise-server-instance -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/pt-BR/content/admin/user-management/basic-account-settings.md b/translations/pt-BR/content/admin/user-management/basic-account-settings.md deleted file mode 100644 index f9c86484cd01..000000000000 --- a/translations/pt-BR/content/admin/user-management/basic-account-settings.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Configurações básicas de conta -intro: 'Depois que conseguirem se autenticar na {% data variables.product.product_location_enterprise %}, os usuários vão querer definir algumas configurações básicas de perfil, como avatar e notificações de e-mail.' -redirect_from: - - /enterprise/admin/guides/user-management/enabling-avatars-and-identicons/ - - /enterprise/admin/user-management/basic-account-settings -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/pt-BR/content/admin/user-management/changing-authentication-methods.md b/translations/pt-BR/content/admin/user-management/changing-authentication-methods.md deleted file mode 100644 index f6021be031b2..000000000000 --- a/translations/pt-BR/content/admin/user-management/changing-authentication-methods.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: Alterar os métodos de autenticação -intro: 'A qualquer momento, você pode alterar a forma como o {% data variables.product.prodname_ghe_server %} se autentica com as contas existentes.' -redirect_from: - - /enterprise/admin/user-management/changing-authentication-methods -versions: - enterprise-server: '*' ---- - -As contas de usuário no {% data variables.product.product_location_enterprise %} são preservadas quando você altera o método de autenticação, e os usuários continuarão fazendo login na mesma conta (desde que não haja alteração nos nomes de usuário). - -Se o novo método de autenticação alterar nomes de usuários, serão criadas novas contas. Como administrador, você pode renomear os usuários nas configurações de administração do site ou usando a [a API de administração do usuário](/enterprise/{{currentVersion}}/v3/enterprise-admin/users/#rename-an-existing-user). - -Veja outras questões que você deve manter em mente: - -* **Senhas:** se você mudar para o uso da autenticação integrada na sua instância, os usuários deverão [definir uma senha](/enterprise/user/articles/how-can-i-reset-my-password/) após a conclusão da mudança. - -* **Administradores do site:** privilégios administrativos são [controlados pelo provedor de identidade quando você usa SAML](/enterprise/admin/guides/user-management/using-saml/#saml-attributes) e podem ser [controlados pela associação ao grupo quando você usa LDAP](/enterprise/admin/guides/user-management/using-ldap/#configuring-ldap-with-your-github-enterprise-server-instance). - -* **Associação a equipes:** somente o LDAP permite [controlar associações a equipes](/enterprise/admin/guides/user-management/using-ldap/#configuring-ldap-with-your-github-enterprise-server-instance) no servidor do diretório. - -* **Suspensão de usuários:** quando você usa o LDAP para fazer a autenticação, o acesso ao {% data variables.product.prodname_ghe_server %} pode ser controlado pelos _grupos restritos_. Depois de alternar para o LDAP, se os grupos restritos estiverem configurados, os usuários que não estiverem nesses grupos serão suspensos. A suspensão ocorrerá quando eles fizerem login ou durante a próxima sincronização LDAP. - -* **Associação a grupos:** quando você usa o LDAP para fazer a autenticação, os usuários passam automaticamente por [suspensão e cancelamento de suspensão](/enterprise/admin/guides/user-management/suspending-and-unsuspending-users) com base em associações a grupos restritos e no status da conta no Active Directory. - -* **Autenticação do Git:** o SAML e o CAS dão suporte à autenticação do Git somente em HTTP ou HTTPS usando um [token de acesso pessoal](/articles/creating-an-access-token-for-command-line-use). Não há suporte para a autenticação de senha em HTTP ou HTTPS. Por padrão, o LDAP dá suporte à autenticação do Git com base em senha, mas é recomendável [desabilitar esse método](/enterprise/admin/guides/user-management/using-ldap/#disabling-password-authentication-for-git-operations) e forçar a autenticação via token de acesso pessoal ou chave SSH. - -* **Autenticação de API:** o SAML e o CAS dão suporte à autenticação de API somente usando um [token de acesso pessoal](/articles/creating-an-access-token-for-command-line-use). Não há suporte para a autenticação básica. - -* **Autenticação de dois fatores:** {% data reusables.enterprise_user_management.external_auth_disables_2fa %} - -* **Autenticação integrada para usuários de fora do provedor de identidade:** você pode convidar os usuários para se autenticarem na {% data variables.product.product_location_enterprise %} sem adicioná-los ao seu provedor de identidade. Para obter mais informações, consulte "[Permitir a autenticação integrada para usuários de fora do provedor de identidade](/enterprise/{{ currentVersion }}/admin/guides/user-management/allowing-built-in-authentication-for-users-outside-your-identity-provider)". diff --git a/translations/pt-BR/content/admin/user-management/disabling-unauthenticated-sign-ups.md b/translations/pt-BR/content/admin/user-management/disabling-unauthenticated-sign-ups.md deleted file mode 100644 index f69d07b616b4..000000000000 --- a/translations/pt-BR/content/admin/user-management/disabling-unauthenticated-sign-ups.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: Desabilitar assinaturas não autenticadas -redirect_from: - - /enterprise/admin/articles/disabling-sign-ups/ - - /enterprise/admin/user-management/disabling-unauthenticated-sign-ups -intro: 'Se você estiver usando a autenticação integrada, será possível impedir que pessoas não autenticadas criem uma conta.' -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -3. Desmarque a seleção na caixa **Enable sign-up** (Habilitar assinatura). ![Caixa de seleção Enable sign-up (Habilitar assinatura)](/assets/images/enterprise/management-console/enable-sign-up.png) -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/pt-BR/content/admin/user-management/organizations-and-teams.md b/translations/pt-BR/content/admin/user-management/organizations-and-teams.md deleted file mode 100644 index 7b372fd172a9..000000000000 --- a/translations/pt-BR/content/admin/user-management/organizations-and-teams.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: Organizações e equipes -redirect_from: - - /enterprise/admin/articles/adding-users-and-teams/ - - /enterprise/admin/categories/admin-bootcamp/ - - /enterprise/admin/user-management/organizations-and-teams -intro: 'As organizações são uma forma excelente de criar conjuntos distintos de usuários na empresa, como divisões ou grupos que trabalham em projetos semelhantes. Os repositórios públicos de uma organização ficam acessíveis para os usuários de outras organizações, enquanto os repositórios privados são inacessíveis para qualquer pessoa que não seja integrante da organização.' -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/pt-BR/content/admin/user-management/preventing-users-from-changing-a-repositorys-visibility.md b/translations/pt-BR/content/admin/user-management/preventing-users-from-changing-a-repositorys-visibility.md deleted file mode 100644 index 6548bb8e26ed..000000000000 --- a/translations/pt-BR/content/admin/user-management/preventing-users-from-changing-a-repositorys-visibility.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: Impedir os usuários de alterarem a visibilidade do repositório -intro: 'É possível impedir que os usuários alterem a visibilidade dos repositórios pertencentes à organização no seu appliance do {% data variables.product.prodname_ghe_server %}.' -redirect_from: - - /enterprise/admin/guides/user-management/preventing-users-from-changing-a-repository-s-visibility - - /enterprise/admin/user-management/preventing-users-from-changing-a-repositorys-visibility -versions: - enterprise-server: '*' ---- - -Se você impedir que os integrantes alterem a visibilidade do repositório, somente os administradores do site poderão tornar privados os repositórios públicos ou tornar públicos os repositórios privados. - -Se um administrador do site tiver restringido a criação do repositório somente aos proprietários da organização, os integrantes não poderão alterar a visibilidade do repositório. Além disso, se o administrador do site restringir a criação de repositórios apenas aos repositórios privados, os integrantes só conseguirão tornar privados os repositórios públicos. Para obter mais informações, consulte "[Restringir a criação de repositórios na instância](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)". - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.policies-tab %} -{% data reusables.enterprise-accounts.repositories-tab %} -5. Em "Repository visibility change" (Alteração da visibilidade do repositório), revise as informações sobre a alteração da configuração. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} - -{% data reusables.enterprise-accounts.repository-visibility-policy %} diff --git a/translations/pt-BR/content/admin/user-management/preventing-users-from-changing-anonymous-git-read-access.md b/translations/pt-BR/content/admin/user-management/preventing-users-from-changing-anonymous-git-read-access.md deleted file mode 100644 index 17c16a3e268e..000000000000 --- a/translations/pt-BR/content/admin/user-management/preventing-users-from-changing-anonymous-git-read-access.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Impedir os usuários de alterarem o acesso de leitura anônimo do Git -intro: 'Você pode impedir que os administradores de repositórios alterem o acesso de leitura anônimo do Git a um repositório{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %} ou a todos os repositórios{% endif %}.' -redirect_from: - - /enterprise/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access-to-a-repository/ - - /enterprise/admin/user-management/preventing-users-from-changing-anonymous-git-read-access -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_user_management.disclaimer-for-git-read-access %} - -Para impedir que os administradores de repositório alterem as configurações de acesso de leitura anônimo do Git em determinado repositório, é possível bloquear as configurações de acesso do repositório. Após o bloqueio, somente um administrador de site poderá alterar a configuração do acesso de leitura anônimo do Git. - -Os administradores de repositório poderão alterar a configuração do acesso de leitura anônimo do Git de um repositório público se não for uma bifurcação. Para obter mais informações, consulte "[Permitir que administradores habilitem o acesso de leitura anônimo do Git a repositórios públicos](/enterprise/{{ currentVersion }}/admin/guides/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories)". - -{% data reusables.enterprise_site_admin_settings.list-of-repos-with-anonymous-git-read-access-enabled %} - -### Impedir os usuários de alterarem o acesso de leitura anônimo do Git no repositório - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -6. Em "Danger Zone" (Zona de perigo), selecione **Prevent repository admins from enabling anonymous Git read access** (Impedir administradores de repositório de habilitarem o acesso de leitura anônimo do Git). ![Marcar a caixa de seleção para impedir o repositório de alterar a configuração de acesso de leitura anônimo do Git](/assets/images/enterprise/site-admin-settings/lock-repo-from-changing-anonymous-git-read-access.png) - -### Impedir os usuários de alterarem o acesso de leitura anônimo do Git em todos os repositórios - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -3. Em "Anonymous Git read access" (Acesso de leitura anônimo do Git), confirme que a configuração está habilitada e selecione **Prevent repository admins from changing anonymous Git read access** (Impedir administradores de repositório de habilitarem o acesso de leitura anônimo do Git). ![Marcar a caixa de seleção para impedir todos os repositórios de alterarem a configuração de acesso de leitura anônimo do Git](/assets/images/enterprise/site-admin-settings/globally-lock-repos-from-changing-anonymous-git-read-access.png) - diff --git a/translations/pt-BR/content/admin/user-management/preventing-users-from-deleting-organization-repositories.md b/translations/pt-BR/content/admin/user-management/preventing-users-from-deleting-organization-repositories.md deleted file mode 100644 index f4557a28fc0d..000000000000 --- a/translations/pt-BR/content/admin/user-management/preventing-users-from-deleting-organization-repositories.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: Impedir os usuários de excluírem repositórios da organização -intro: 'É possível impedir que os usuários excluam ou transfiram repositórios em organizações no seu appliance do {% data variables.product.prodname_ghe_server %}.' -redirect_from: - - /enterprise/admin/user-management/preventing-users-from-deleting-organization-repositories -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.policies-tab %} -{% data reusables.enterprise-accounts.repositories-tab %} -5. Em "Repository deletion and transfer" (Exclusão e transferência de repositórios), revise as informações sobre como alterar as configurações. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} - -{% data reusables.enterprise-accounts.repository-deletion-policy %} diff --git a/translations/pt-BR/content/admin/user-management/repositories.md b/translations/pt-BR/content/admin/user-management/repositories.md deleted file mode 100644 index 7ba24877d699..000000000000 --- a/translations/pt-BR/content/admin/user-management/repositories.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Repositórios -intro: 'Você pode gerenciar as configurações disponíveis para os administradores de repositório no appliance do {% data variables.product.prodname_ghe_server %}.' -mapTopic: true -redirect_from: - - /enterprise/admin/user-management/repositories -versions: - enterprise-server: '*' ---- - diff --git a/translations/pt-BR/content/admin/user-management/restricting-repository-creation-in-your-instance.md b/translations/pt-BR/content/admin/user-management/restricting-repository-creation-in-your-instance.md deleted file mode 100644 index d6f480287039..000000000000 --- a/translations/pt-BR/content/admin/user-management/restricting-repository-creation-in-your-instance.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: Restringir a criação de repositórios na instância -intro: 'Você pode escolher se os membros da organização em seu appliance {% data variables.product.prodname_ghe_server %} podem criar repositórios e quais tipos de repositórios os membros podem criar.' -redirect_from: - - /enterprise/admin/user-management/restricting-repository-creation-in-your-instance -versions: - enterprise-server: '*' ---- - -{% data reusables.organizations.repo-creation-constants %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.policies-tab %} -{% data reusables.enterprise-accounts.repositories-tab %} -5. Em "Repository creation" (Criação de repositório), revise as informações sobre como alterar a configuração. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} -{% if currentVersion ver_gt "enterprise-server@2.19" %} -{% data reusables.enterprise-accounts.repo-creation-policy %} -{% data reusables.enterprise-accounts.repo-creation-types %} -{% else %} -6. Em "Repository creation" (Criação de repositórios), use o menu suspenso e escolha uma política. ![Menu suspenso com opções de políticas de criação de repositórios](/assets/images/enterprise/site-admin-settings/repository-creation-drop-down.png) -{% endif %} diff --git a/translations/pt-BR/content/admin/user-management/user-security.md b/translations/pt-BR/content/admin/user-management/user-security.md deleted file mode 100644 index ee410abfc64c..000000000000 --- a/translations/pt-BR/content/admin/user-management/user-security.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Segurança de usuário -intro: 'Garanta a segurança dos usuários do {% data variables.product.prodname_ghe_server %}. Você pode auditar as configurações de segurança dos usuários ou impor práticas recomendadas na sua instância.' -mapTopic: true -redirect_from: - - /enterprise/admin/user-management/user-security -versions: - enterprise-server: '*' ---- - diff --git a/translations/pt-BR/content/admin/user-management/using-built-in-authentication.md b/translations/pt-BR/content/admin/user-management/using-built-in-authentication.md deleted file mode 100644 index 40470a71f508..000000000000 --- a/translations/pt-BR/content/admin/user-management/using-built-in-authentication.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: Usar a autenticação integrada -intro: 'Quando você usa o método de autenticação padrão, todos os detalhes de autenticação ficam armazenados na {% data variables.product.product_location_enterprise %}. Se você ainda não tiver um provedor de autenticação estabelecido, como LDAP, SAML ou CAS, a autenticação integrada é o método padrão.' -redirect_from: - - /enterprise/admin/user-management/using-built-in-authentication -versions: - enterprise-server: '*' ---- - -Você pode criar mensagens personalizadas que os usuários verão nas páginas de login e logout. Para obter mais informações, consulte "[Personalizar mensagens de usuário na instância](/enterprise/admin/user-management/customizing-user-messages-on-your-instance)". - -### Configurar a autenticação integrada - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.authentication %} -4. Selecione **Built in authentication** (Autenticação integrada). ![Opção Select built-in authentication (Selecionar autenticação integrada)](/assets/images/enterprise/management-console/built-in-auth-select.png) - -{% data reusables.enterprise_user_management.two_factor_auth_header %} -{% data reusables.enterprise_user_management.2fa_is_available %} - -### Criar uma conta e adicionar usuários - -Após a criação da sua instância, você terá que criar a sua conta de administrador e usá-la para provisionar os usuários. - -1. Na página "Create Admin Account" (Criar conta de administrador) em `http(s)://[hostname]/join`, defina seu nome de usuário, senha e endereço de e-mail. Em seguida, clique em **Create an account** (Criar conta). ![Criar conta de administrador](/assets/images/enterprise/site-admin-settings/create-first-admin-acct.png) -{% data reusables.enterprise_site_admin_settings.sign-in %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.invite-user-sidebar-tab %} -{% data reusables.enterprise_site_admin_settings.invite-user-reset-link %} diff --git a/translations/pt-BR/content/admin/user-management/using-cas.md b/translations/pt-BR/content/admin/user-management/using-cas.md deleted file mode 100644 index 12e804210eeb..000000000000 --- a/translations/pt-BR/content/admin/user-management/using-cas.md +++ /dev/null @@ -1,43 +0,0 @@ ---- -title: Usar CAS -redirect_from: - - /enterprise/admin/articles/configuring-cas-authentication/ - - /enterprise/admin/articles/about-cas-authentication/ - - /enterprise/admin/user-management/using-cas -intro: 'O CAS é um protocolo de logon único (SSO) para vários aplicativos da web. Uma conta de usuário CAS não consome uma {% if currentVersion ver_gt "enterprise-server@2.16" %}licença de{% else %}usuário{% endif %} até o usuário fazer login.' -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_user_management.built-in-authentication %} - -### Considerações de nome de usuário no CAS - -{% data reusables.enterprise_management_console.username_normalization %} - -{% data reusables.enterprise_management_console.username_normalization_sample %} - -{% data reusables.enterprise_user_management.two_factor_auth_header %} -{% data reusables.enterprise_user_management.external_auth_disables_2fa %} - -### Atributos CAS - -Os atributos a seguir estão disponíveis. - -| Nome do atributo | Tipo | Descrição | -| ---------------- | ----------- | --------------------------------------------------------------------------- | -| `username` | Obrigatório | Nome do usuário no {% data variables.product.prodname_ghe_server %}. | - -### Configurar o CAS -{% warning %} - -**Aviso:** antes de configurar o CAS na {% data variables.product.product_location_enterprise %}, observe que os usuários não poderão usar seus nomes e senhas do CAS para autenticar solicitações de API ou operações do Git por HTTP/HTTPS. Para isso, eles deverão [criar tokens de acesso](/enterprise/{{ currentVersion }}/user/articles/creating-an-access-token-for-command-line-use). - -{% endwarning %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.authentication %} -3. Selecione **CAS**. ![Selecionar CAS](/assets/images/enterprise/management-console/cas-select.png) -4. {% data reusables.enterprise_user_management.built-in-authentication-option %} ![Selecionar caixa de autenticação integrada CAS](/assets/images/enterprise/management-console/cas-built-in-authentication.png) -5. No campo **Server URL** (URL do servidor), digite a URL completa do seu servidor CAS. Se o servidor CAS usar um certificado que não pode ser validado pelo {% data variables.product.prodname_ghe_server %}, você poderá usar o comando `ghe-ssl-ca-certificate-install` para instalá-lo como certificado confiável. diff --git a/translations/pt-BR/content/admin/user-management/using-ldap.md b/translations/pt-BR/content/admin/user-management/using-ldap.md deleted file mode 100644 index 51cfb54d9824..000000000000 --- a/translations/pt-BR/content/admin/user-management/using-ldap.md +++ /dev/null @@ -1,190 +0,0 @@ ---- -title: Usar LDAP -redirect_from: - - /enterprise/admin/articles/configuring-ldap-authentication/ - - /enterprise/admin/articles/about-ldap-authentication/ - - /enterprise/admin/articles/viewing-ldap-users/ - - /enterprise/admin/hidden/enabling-ldap-sync/ - - /enterprise/admin/hidden/ldap-sync/ - - /enterprise/admin/user-management/using-ldap -intro: 'O LDAP permite autenticar o {% data variables.product.prodname_ghe_server %} em suas contas existentes e gerenciar centralmente o acesso ao repositório. O LDAP é um protocolo de aplicativo popular de acesso e manutenção dos serviços de informações de diretório, além de ser um dos protocolos mais comuns para integrar software de terceiros a diretórios de usuários em grandes empresas.' -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_user_management.built-in-authentication %} - -### Serviços LDAP compatíveis - -O {% data variables.product.prodname_ghe_server %} se integra aos seguintes serviços LDAP: - -* Active Directory; -* FreeIPA; -* Oracle Directory Server Enterprise Edition; -* OpenLDAP; -* Open Directory; -* 389-ds. - -### Considerações de nome de usuário no LDAP - -{% data reusables.enterprise_management_console.username_normalization %} - -{% data reusables.enterprise_management_console.username_normalization_sample %} - -{% data reusables.enterprise_user_management.two_factor_auth_header %} -{% data reusables.enterprise_user_management.2fa_is_available %} - -### Configurar o LDAP na {% data variables.product.product_location_enterprise %} - -Depois que você configurar o LDAP, os usuários poderão acessar a instância com as credenciais LDAP. Quando os usuários acessarem pela primeira vez, seus nomes de perfil, endereços de e-mail e chaves SSH serão definidos com os atributos LDAP do diretório. - -Quando você configurar o acesso LDAP dos usuários pelo {% data variables.enterprise.management_console %}, suas licenças de usuário não serão usadas até que o primeiro usuário faça login na sua instância. No entanto, se você criar uma conta manualmente usando as configurações de administrador do site, a licença do usuário é imediatamente contabilizada. - -{% warning %} - -**Aviso:** antes de configurar o LDAP na {% data variables.product.product_location_enterprise %}, verifique se o serviço LDAP oferece suporte a resultados paginados. - -{% endwarning %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.authentication %} -3. Em "Authentication" (Autenticação), selecione **LDAP**. ![Selecionar LDAP](/assets/images/enterprise/management-console/ldap-select.png) -4. {% data reusables.enterprise_user_management.built-in-authentication-option %} ![Selecionar caixa de autenticação integrada](/assets/images/enterprise/management-console/ldap-built-in-authentication.png) -5. Defina as configurações. - -### Atributos LDAP -Use estes atributos para finalizar a configuração LDAP na {% data variables.product.product_location_enterprise %}. - -| Nome do atributo | Tipo | Descrição | -| --------------------------------------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `Host` | Obrigatório | Host LDAP, por exemplo, `ldap.example.com` ou `10.0.0.30`. Se o nome do host só estiver disponível na rede interna, talvez seja necessário configurar antes o DNS da {% data variables.product.product_location_enterprise %} para que ele resolva o nome do host usando seus servidores de nomes internos. | -| `Porta` | Obrigatório | Porta em que os serviços de host LDAP estão escutando. Por exemplo: 389 e 636 (para LDAPS). | -| `Criptografia` | Obrigatório | Método de criptografia usado para proteger as comunicações com o servidor LDAP. Por exemplo, básico (sem criptografia), SSL/LDAPS (criptografia desde o início) e StartTLS (atualizar para comunicação com criptografia no momento da conexão). | -| `Usuário de pesquisa de domínio` | Opcional | Usuário LDAP que faz consultas de usuários para autenticar outros usuários quando eles fazem login. Em geral, é uma conta de serviço criada especificamente para integrações de terceiros. Use um nome totalmente qualificado, como `cn=Administrador,cn=Usuários,dc=Exemplo,dc=com`. Com o Active Directory, também é possível usar a sintaxe `[DOMAIN]\[USERNAME]` (por exemplo, `WINDOWS\Administrator`) para o usuário de pesquisa de domínio. | -| `Senha de pesquisa de domínio` | Opcional | Senha do usuário de pesquisa de domínio. | -| `Grupos de administradores` | Opcional | Ao fazerem login no seu appliance, os usuários deste grupo são promovidos a administradores do site. Se você não configurar um grupo de administradores LDAP, a primeira conta de usuário LDAP que acessar seu appliance será automaticamente promovida a administrador do site. | -| `Base de domínio` | Obrigatório | `Distinguished Name` (DN) totalmente qualificado de uma subárvore LDAP em que você pretende procurar usuários e grupos. Você pode adicionar quantos quiser, mas cada grupo deve ser definido na mesma base de domínio que os usuários pertencentes a ele. Se você especificar grupos de usuários restritos, somente os usuários pertencentes a esses grupos estarão no escopo. É recomendável especificar o nível superior da sua árvore de diretórios LDAP como base de domínio e usar grupos de usuários restritos para controlar o acesso. | -| `Grupos de usuários restritos` | Opcional | Se especificados, somente os usuários desses grupos poderão efetuar login. Você só precisa especificar os nomes comuns (CNs, Common Names) dos grupos e adicionar quantos grupos quiser. Se não houver grupos especificados, *todos* os usuários no escopo da base de domínio especificada poderão fazer login na sua instância do {% data variables.product.prodname_ghe_server %}. | -| `ID de usuário` | Obrigatório | Atributo LDAP que identifica o usuário LDAP que tenta fazer a autenticação. Quando houver mapeamento estabelecido, os usuários poderão alterar seus nomes de usuário no {% data variables.product.prodname_ghe_server %}. Este campo deve ser `sAMAccountName` para a maioria das instalações do Active Directory, mas pode ser `uid` para outras soluções LDAP, como OpenLDAP. O valor padrão é `uid`. | -| `Nome de perfil` | Opcional | Nome exibido na págin de perfil do usuário no {% data variables.product.prodname_ghe_server %}. Se a Sincronização LDAP estiver habilitada, os usuários poderão alterar seus nomes de perfil. | -| `E-mails` | Opcional | Endereço de e-mail para a conta de usuário no {% data variables.product.prodname_ghe_server %}. | -| `Chaves SSH` | Opcional | Chaves SSH públicas vinculadas à conta de um usuário no {% data variables.product.prodname_ghe_server %}. As chaves devem estar no formato OpenSSH. | -| `Chaves GPG` | Opcional | Chaves GPG vinculadas à conta de um usuário no {% data variables.product.prodname_ghe_server %}. | -| `Desabilitar autenticação LDAP em operações no Git` | Opcional | Se estiver selecionada, essa opção [desativa](#disabling-password-authentication-for-git-operations) o recurso dos usuários para usar senhas LDAP a fim de autenticar as operações no Git. | -| `Habilitar verificação certificada LDAP` | Opcional | Se estiver selecionada, essa opção [desativa](#enabling-ldap-certificate-verification) a verificação de certificado LDAP. | -| `Sincronização` | Opcional | Se estiver selecionada, essa opção [ativa](#enabling-ldap-sync) a Sincronização LDAP. | - -#### Desabilitar autenticação de senha nas operações no Git - -Selecione **Disable username and password authentication for Git operations** (Desabilitar autenticação de nome de usuário e senha para operações do Git) nas configurações LDAP para impor o uso de tokens de acesso pessoal ou chaves SSH, o que pode ajudar a impedir a sobrecarga do servidor por solicitações de autenticação LDAP. Essa configuração é recomendável porque servidores LDAP com resposta lenta, especialmente combinados a um grande número de solicitações devido à sondagem, são uma causa comum de interrupções e problemas de desempenho. - -![Desabilitar autenticação de senha LDAP na caixa de seleção do Git](/assets/images/enterprise/management-console/ldap-disable-password-auth-for-git.png) - -Quando esta opção estiver selecionada, se tentar usar uma senha para as operações do Git pela linha de comando, o usuário receberá está mensagem de erro: `A autenticação de senha não é permitida para operações do Git. Use um token de acesso pessoal`. - -#### Habilitar verificação certificada LDAP - -Selecione **Enable LDAP certificate verification** (Habilitar verificação certificada LDAP) nas suas configurações LDAP para validar o certificado de servidor LDAP que você usa com o TLS. - -![Caixa de seleção de verificação certificada LDAP](/assets/images/enterprise/management-console/ldap-enable-certificate-verification.png) - -Quando esta opção estiver selecionada, o certificado será validado para garantir o seguinte: -- Se o certificado contiver ao menos um nome alternativo da entidade (SAN, Subject Alternative Name), um dos SANs deve corresponder ao nome do host LDAP. Do contrário, o nome comum (CN) corresponderá ao nome de host LDAP. -- O certificado não deve estar expirado. -- O certificado deve estar assinado por uma autoridade de certificação (CA, Certificate Authority) confiável. - -#### Habilitar a Sincronização LDAP - -A Sincronização LDAP permite sincronizar os usuários do {% data variables.product.prodname_ghe_server %} e a associação da equipe nos seus grupos LDAP estabelecidos. Assim, é possível estabelecer o controle de acesso baseado em função para os usuários do seu servidor LDAP, em vez de fazer isso manualmente no {% data variables.product.prodname_ghe_server %}. Para obter mais informações, consulte "[Criar equipes](/enterprise/{{ currentVersion }}/admin/guides/user-management/creating-teams#creating-teams-with-ldap-sync-enabled)". - -Para habilitar a Sincronização LDAP, selecione **Synchronize Emails** (Sincronizar e-mails), **Synchronize SSH Keys** (Sincronizar chaves SSH) ou **Synchronize GPG Keys** (Sincronizar chaves GPG) nas configurações LDAP. - -![Caixa de seleção de sincronização](/assets/images/enterprise/management-console/ldap-synchronize.png) - -Depois que você habilitar a sincronização LDAP, um trabalho de sincronização será executado no período especificado para fazer as seguintes operações em cada conta de usuário: - -- Se você tiver permitido a autenticação integrada para usuários de fora do provedor de identidade e o usuário estiver usando a autenticação integrada, vá para o próximo usuário. -- Se não houver mapeamento LDAP para o usuário, tente mapeá-lo para uma entrada LDAP no diretório. Se não for possível mapear o usuário para uma entrada LDAP, suspenda o usuário em questão e passe para o seguinte. -- Se houver um mapeamento LDAP e a entrada LDAP correspondente no diretório estiver ausente, suspenda o usuário e passe para o seguinte. -- Se a entrada LDAP correspondente tiver sido marcada como desativada e o usuário ainda não estiver suspenso, suspenda o usuário e passe para o seguinte. -- Se a entrada LDAP correspondente não estiver marcada como desabilitada, se o usuário estiver suspenso e se a opção _Reativar usuários suspensos_ estiver habilitada na central do administrador, cancele a suspensão do usuário. -- Se a entrada LDAP correspondente incluir um atributo `name`, atualize o nome do perfil do usuário. -- Se a entrada LDAP correspondente estiver no grupo de administradores, promova o usuário a administrador do site. -- Se a entrada LDAP correspondente não estiver no grupo de administradores, rebaixe o usuário para uma conta regular. -- Se um campo LDAP User (Usuário LDAP) estiver definido para e-mails, sincronize as configurações de e-mail do usuário com a entrada LDAP. Defina a primeira entrada LDAP `mail` como e-mail principal. -- Se um campo LDAP User (Usuário LDAP) estiver definido para chaves SSH públicas, sincronize as chaves SSH públicas do usuário com a entrada LDAP. -- Se um campo LDAP User (Usuário LDAP) estiver definido para chaves GPG públicas, sincronize as chaves GPG públicas do usuário com a entrada LDAP. - -{% note %} - -**Observação**: as entradas LDAP só podem ser marcadas como desabilitadas se você usar o Active Directory, e se o atributo `userAccountControl` estiver presente e sinalizado com `ACCOUNTDISABLE`. - -{% endnote %} - -Um trabalho de sincronização também será executado no período especificado para fazer as seguintes operações em cada equipe mapeada para um grupo LDAP: - -- Se um grupo LDAP correspondente de uma equipe tiver sido removido, remova todos os integrantes da equipe. -- Se as entradas do integrante LDAP tiverem sido removidas do grupo LDAP, remova os usuários correspondentes da equipe. Se o usuário perder o acesso a qualquer repositórios, exclua todas as bifurcações privadas que ele possa ter nesses repositórios. -- Se as entradas do integrante LDAP tiverem sido adicionadas ao grupo LDAP, adicione os usuários correspondentes à equipe. Se o usuário recuperar o acesso a quaisquer repositórios, restaure todas as bifurcações privadas dos repositórios que foram excluídos porque o usuário perdeu o acesso nos últimos 90 dias. - -{% data reusables.enterprise_user_management.ldap-sync-nested-teams %} - -{% warning %} - -**Aviso de segurança:** - -Quando a Sincronização LDAP está ativada, os administradores do site e os proprietários da organização podem pesquisar grupos no diretório LDAP aos quais pretendem mapear a equipe. - -Esse procedimento pode resultar na divulgação de informações confidenciais da organização para contratados ou outros usuários sem privilégios, inclusive: - -- A existência de grupos LDAP específicos visíveis para o *usuário de pesquisa de domínio*; -- Integrantes do grupo LDAP que tenham contas de usuário no {% data variables.product.prodname_ghe_server %}, divulgadas ao criar uma equipe sincronizada com o grupo LDAP. - -Se não houver intenção de divulgar essas informações, sua empresa ou organização deve restringir as permissões do *usuário de pesquisa de domínio* configurado no Console de administração. Caso não seja possível fazer essa restrição, entre em contato com o {% data variables.contact.contact_ent_support %}. - -{% endwarning %} - -#### Classes de grupo de objeto LDAP compatíveis - -O {% data variables.product.prodname_ghe_server %} é compatível com as seguintes classes de grupo de objeto LDAP. Os grupos podem ser aninhados. - -- `group` -- `groupOfNames` -- `groupOfUniqueNames` -- `posixGroup` - -### Exibir e criar usuários LDAP - -É possível exibir a lista completa de usuários LDAP que têm acesso à sua instância, e você também pode provisionar novos usuários. - -{% data reusables.enterprise_site_admin_settings.sign-in %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -3. Na barra lateral esquerda, clique em **LDAP users** (Usuários LDAP). ![Guia de usuários LDAP](/assets/images/enterprise/site-admin-settings/ldap-users-tab.png) -4. Para procurar um usuário, digite um nome (total ou parcialmente) do usuário e clique em **Search** (Pesquisar). Os usuários serão exibidos nos resultados da pesquisa. Se o usuário não existir, clique em **Create** (Criar) para provisionar a nova conta. ![Pesquisa LDAP](/assets/images/enterprise/site-admin-settings/ldap-users-search.png) - -### Atualizar contas LDAP - -Se a [Sincronização LDAP estiver desabilitada](#enabling-ldap-sync), as alterações nas contas LDAP não serão sincronizadas automaticamente com o {% data variables.product.prodname_ghe_server %}. - -* Para usar um novo grupo de administradores LDAP, os usuários devem ser promovidos e rebaixados manualmente no {% data variables.product.prodname_ghe_server %} a fim de refletir as mudanças no LDAP. -* Para adicionar ou remover contas LDAP nos grupos de administração LDAP, [promova ou rebaixe as contas no {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/guides/user-management/promoting-or-demoting-a-site-administrator). -* Para remover contas LDAP, [suspenda as contas do {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/guides/user-management/suspending-and-unsuspending-users). - -#### Sincronizar contas LDAP manualmente - -{% data reusables.enterprise_site_admin_settings.sign-in %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.search-user %} -{% data reusables.enterprise_site_admin_settings.click-user %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -5. Em "LDAP," clique em **Sync now** (Sincronizar agora) para atualizar manualmente a conta com os dados do seu servidor LDAP. ![Botão LDAP sync now (Sincronizar LDAP agora)](/assets/images/enterprise/site-admin-settings/ldap-sync-now-button.png) - -Você também pode [usar a API para acionar uma sincronização manual](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#ldap). - -### Revogar o acesso à {% data variables.product.product_location_enterprise %} - -Se a [Sincronização LDAP estiver habilitada](#enabling-ldap-sync), remover as credenciais LDAP do usuário suspenderá a conta do usuário após a execução de sincronização seguinte. - -Se a Sincronização LDAP **não** estiver habilitada, você deve suspender manualmente a conta do {% data variables.product.prodname_ghe_server %} após remover as credenciais LDAP. Para obter mais informações, consulte "[Suspender e cancelar a suspensão de usuários](/enterprise/{{ currentVersion }}/admin/guides/user-management/suspending-and-unsuspending-users)". diff --git a/translations/pt-BR/content/admin/user-management/using-saml.md b/translations/pt-BR/content/admin/user-management/using-saml.md deleted file mode 100644 index 8de1ebc20208..000000000000 --- a/translations/pt-BR/content/admin/user-management/using-saml.md +++ /dev/null @@ -1,137 +0,0 @@ ---- -title: Usar SAML -redirect_from: - - /enterprise/admin/articles/configuring-saml-authentication/ - - /enterprise/admin/articles/about-saml-authentication/ - - /enterprise/admin/user-management/using-saml -intro: 'O SAML é um padrão de autenticação e autorização baseado em XML. O {% data variables.product.prodname_ghe_server %} pode agir como provedor de serviços (SP, Service Provider) com seu provedor de identidade (IdP, Identity Provider) SAML interno.' -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_user_management.built-in-authentication %} - -### Serviços SAML compatíveis - -{% data reusables.saml.saml-supported-idps %} - -{% data reusables.saml.saml-single-logout-not-supported %} - -### Considerações de nome de usuário no SAML - -Cada nome de usuário do {% data variables.product.prodname_ghe_server %} é determinado por uma das seguintes afirmações na resposta SAML, ordenada por prioridade: - -- Nome de usuário personalizado, se houver; -- Declaração `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name`, se houver; -- Declaração `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress`, se houver; -- Elemento `NameID`. - -O elemento `NameID` é obrigatório, mesmo que os outros atributos estejam presentes. - -É criado um mapeamento entre `NameID` e o nome de usuário do {% data variables.product.prodname_ghe_server %}; assim, `NameID` deve ser persistente, exclusivo e não estar sujeito a alterações no ciclo de vida do usuário. - -{% data reusables.enterprise_management_console.username_normalization %} - -{% data reusables.enterprise_management_console.username_normalization_sample %} - -{% data reusables.enterprise_user_management.two_factor_auth_header %} -{% data reusables.enterprise_user_management.external_auth_disables_2fa %} - -### Metadados SAML - -Os metadados do provedor de serviços da sua instância do {% data variables.product.prodname_ghe_server %} estão disponíveis em `http(s)://[hostname]/saml/metadata`. - -Para configurar seu provedor de identidade manualmente, a URL do serviço de consumidor de declaração (ACS, Assertion Consumer Service) é `http(s)://[hostname]/saml/consume` e usa a associação `urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST`. - -### Atributos SAML - -Os atributos a seguir estão disponíveis. Você pode alterar seus nomes no [console de gerenciamento](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-management-console/), exceto o atributo `administrator`. - -| Nome padrão do atributo | Tipo | Descrição | -| ----------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `NameID` | Obrigatório | Identificador de usuário persistente. Qualquer formato de identificador de nome persistente pode ser usado. O elemento `NameID` será usado para um nome de usuário do {% data variables.product.prodname_ghe_server %}, a menos que uma das declarações alternativas seja fornecida. | -| `administrator` | Opcional | Quando o valor for 'true', o usuário será promovido automaticamente como administrador. Qualquer outro valor ou um valor não existente rebaixará o usuário para uma conta regular. | -| `nome de usuário` | Opcional | Nome do usuário no {% data variables.product.prodname_ghe_server %}. | -| `full_name` | Opcional | Nome do usuário exibido na página de perfil. Após o provisionamento, os usuários podem alterar seus nomes. | -| `emails` | Opcional | Endereços de e-mail para o usuário. É possível especificar mais de um. | -| `public_keys` | Opcional | Chaves SSH públicas para o usuário. É possível especificar mais de um. | -| `gpg_keys` | Opcional | Chaves chaves GPG para o usuário. É possível especificar mais de um. | - -### Definir configurações SAML - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.authentication %} -3. Selecione **SAML**. ![Autenticação SAML](/assets/images/enterprise/management-console/auth-select-saml.png) -4. {% data reusables.enterprise_user_management.built-in-authentication-option %} ![Selecionar caixa de autenticação integrada SAML](/assets/images/enterprise/management-console/saml-built-in-authentication.png) -5. Para habilitar SSO de resposta não solicitada, selecione **IdP initiated SSO** (SSO iniciado pelo IdP). Por padrão, o {% data variables.product.prodname_ghe_server %} responderá a uma solicitação iniciada pelo Provedor de identidade (IdP) não solicitado com `AuthnRequest`. ![SAML idP SSO](/assets/images/enterprise/management-console/saml-idp-sso.png) - - {% tip %} - - **Observação**: é recomendável manter esse valor **desmarcado**. Você deve habilitar esse recurso **somente ** na rara instância em que sua implementação SAML não oferecer suporte ao SSO iniciado pelo provedor de serviços e quando recomendado pelo {% data variables.contact.enterprise_support %}. - - {% endtip %} - -5. Selecione **Disable administrator demotion/promotion** (Desabilitar rebaixamento/promoção do administrador) se você **não** quiser que o provedor SAML determine direitos de administrador para usuários no {% data variables.product.product_location_enterprise %}. ![Configuração desativar administrador SAML](/assets/images/enterprise/management-console/disable-admin-demotion-promotion.png) -6. No campo **Sign on URL** (URL de logon), digite o ponto de extremidade HTTP ou HTTPS do seu IdP para solicitações de logon único. Esse valor é fornecido pela configuração do IdP. Se o nome do host só estiver disponível na rede interna, talvez seja necessário [configurar a {% data variables.product.product_location_enterprise %} para usar servidores de nomes internos](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-dns-nameservers/). ![Autenticação SAML](/assets/images/enterprise/management-console/saml-single-sign-url.png) -7. Como alternativa, no campo **Issuer** (Emissor), digite o nome do emissor de SAML. Fazer isso verifica a autenticidade das mensagens enviadas para a {% data variables.product.product_location_enterprise %}. ![Emissor SAML](/assets/images/enterprise/management-console/saml-issuer.png) -8. Nos menus suspensos **Signature Method** (Método de assinatura) e **Digest Method** (Método de compilação), escolha o algoritmo de hash usado pelo emissor SAML para verificar a integridade das solicitações do {% data variables.product.product_location_enterprise %}. Especifique o formato no menu suspenso **Name Identifier Format** (Formato de identificador de nome). ![Método SAML ](/assets/images/enterprise/management-console/saml-method.png) -9. Em **Verification certificate** (Certificado de verificação), clique em **Choose File** (Escolher arquivo) e escolha um certificado para validar as respostas SAML do IdP. ![Autenticação SAML](/assets/images/enterprise/management-console/saml-verification-cert.png) -10. Modifique os nomes do atributo SAML para corresponder ao IdP, se necessário, ou aceite os nomes padrão. ![Nomes de atributos SAML](/assets/images/enterprise/management-console/saml-attributes.png) - -### Revogar o acesso à {% data variables.product.product_location_enterprise %} - -Se remover um usuário do seu provedor de identidade, você também deverá suspendê-lo manualmente. Caso contrário, ele continuará podendo fazer autenticação usando tokens de acesso ou chaves SSH. Para obter mais informações, consulte "[Suspender e cancelar a suspensão de usuários](/enterprise/admin/guides/user-management/suspending-and-unsuspending-users)". - -### Requisitos de mensagem de resposta - -A mensagem de resposta deve atender aos seguintes requisitos: - -- O `` elemento deve sempre ser fornecido no documento de resposta raiz e deve corresponder ao URL do ACS somente quando o documento de resposta raiz estiver assinado. Se for assinada, a declaração será ignorada. -- O elemento `` deve sempre ser fornecido como parte do elemento ``. Ele corresponde ao ID da Entidade {% data variables.product.prodname_ghe_server %}. Esta é a URL para a instância do {% data variables.product.prodname_ghe_server %}, como `https://ghe.corp.example.com`. -- Todas as declarações na resposta **devem** ser precedidas de assinatura digital. É possível fazer isso assinando cada elemento `` ou assinando o elemento ``. -- Um elemento `` deve ser fornecido como parte do elemento ``. Qualquer formato de identificador de nome persistente pode ser usado. -- O atributo `Recipient` deve estar presente e definido na URL do ACS. Como por exemplo: - -```xml - - - - ... - - - - - - - monalisa - - - - -``` - -### Mensagens de erro - -Se `Recipient` não corresponder à URL do ACS, o log de autenticação mostrará a seguinte mensagem de erro: - -``` -Recipient na resposta SAML não era válido. -``` - -Se `Recipient` não for parte da mensagem de resposta, o log de autenticação mostrará a seguinte mensagem de erro: - -``` -Recipient na resposta SAML não pode ficar em branco. -``` - -Se a resposta SAML não estiver assinada ou se a assinatura não corresponder ao conteúdo, o log de autenticação mostrará a seguinte mensagem de erro: - -``` -Resposta SAML não assinada ou modificada. -``` -Se `Audience` estiver ausente ou não corresponder ao ID de entidade do {% data variables.product.prodname_ghe_server %}, o log de autenticação mostrará a seguinte mensagem de erro: - -``` -Audience inválido. O atributo Audience não corresponde a url_sua_instância -``` diff --git a/translations/pt-BR/content/desktop/contributing-and-collaborating-using-github-desktop/accessing-a-pull-request-locally.md b/translations/pt-BR/content/desktop/contributing-and-collaborating-using-github-desktop/accessing-a-pull-request-locally.md deleted file mode 100644 index f91f346e5416..000000000000 --- a/translations/pt-BR/content/desktop/contributing-and-collaborating-using-github-desktop/accessing-a-pull-request-locally.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: Acessar uma pull request no local -intro: 'É possível visualizar as alterações propostas nas pull requests em aberto no {% data variables.product.prodname_desktop %}.' -redirect_from: - - /desktop/contributing-to-projects/accessing-a-pull-request-locally -versions: - free-pro-team: '*' ---- - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.click-pull-requests %} - ![Guia Pull requests no menu suspenso Branch atual](/assets/images/help/desktop/branch-drop-down-pull-request-tab.png) -{% data reusables.desktop.choose-pr-from-list %} - ![Lista de pull requests em aberto no repositório](/assets/images/help/desktop/click-pull-request.png) -4. Para atualizar a lista de pull requests, você também pode clicar em {% octicon "sync" aria-label="The sync icon" %}. ![Botão Sync (Sincronizar) para atualizar](/assets/images/help/desktop/pull-request-list-sync.png) diff --git a/translations/pt-BR/content/desktop/contributing-to-projects/accessing-a-pull-request-locally.md b/translations/pt-BR/content/desktop/contributing-to-projects/accessing-a-pull-request-locally.md deleted file mode 100644 index 2352422d2b37..000000000000 --- a/translations/pt-BR/content/desktop/contributing-to-projects/accessing-a-pull-request-locally.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: Acessar uma pull request no local -intro: 'É possível visualizar as alterações propostas nas pull requests em aberto no {% data variables.product.prodname_desktop %}.' -versions: - free-pro-team: '*' ---- - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.click-pull-requests %} - ![Guia Pull requests no menu suspenso Branch atual](/assets/images/help/desktop/branch-drop-down-pull-request-tab.png) -{% data reusables.desktop.choose-pr-from-list %} - ![Lista de pull requests em aberto no repositório](/assets/images/help/desktop/click-pull-request.png) -4. Para atualizar a lista de pull requests, você também pode clicar em {% octicon "sync" aria-label="The sync icon" %}. ![Botão Sync (Sincronizar) para atualizar](/assets/images/help/desktop/pull-request-list-sync.png) diff --git a/translations/pt-BR/content/desktop/contributing-to-projects/adding-a-repository-from-your-local-computer-to-github-desktop.md b/translations/pt-BR/content/desktop/contributing-to-projects/adding-a-repository-from-your-local-computer-to-github-desktop.md deleted file mode 100644 index ece0ef78f14f..000000000000 --- a/translations/pt-BR/content/desktop/contributing-to-projects/adding-a-repository-from-your-local-computer-to-github-desktop.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: Adicionar um repositório do computador local ao GitHub Desktop -intro: 'É possível adicionar qualquer repositório Git ao {% data variables.product.prodname_desktop %}, mesmo que não seja um repositório do {% data variables.product.prodname_dotcom %}.' -versions: - free-pro-team: '*' ---- - -{% tip %} - -**Dica:** é possível adicionar um repositório Git do computador local ao GitHub Desktop arrastando a pasta para a janela do {% data variables.product.prodname_desktop %}. Ao arrastar várias pastas do Git para o {% data variables.product.prodname_desktop %} simultaneamente, cada pasta será acessada como um repositório Git individual. - -{% endtip %} - -{% mac %} - -1. No menu **File** (Arquivo), clique em **Add Local Repository** (Adicionar repositório local). ![Opção de menu Add Local Repository (Adicionar repositório local)](/assets/images/help/desktop/add-local-repository-mac.png) -2. Clique em **Choose...** (Escolher...). Em seguida, navegue pela janela Finder (Localizador) até o local do repositório que você pretende adicionar. ![Campo Local Path (Caminho local) no app Mac](/assets/images/help/desktop/add-repo-choose-button-mac.png) -4. Clique em **Add Repository** (Adicionar repositório). ![Botão Add repository (Adicionar repositório) no app Mac](/assets/images/help/desktop/add-repository-button-mac.png) - -{% endmac %} - -{% windows %} - -1. No menu **File** (Arquivo), clique em **Add Local Repository** (Adicionar repositório local). ![Opção de menu Add Local Repository (Adicionar repositório local)](/assets/images/help/desktop/add-local-repository-windows.png) -2. Clique em **Choose...** (Escolher...). Em seguida, navegue pela janela Windows Explorer (Explorador do Windows) até o local do repositório que você pretende adicionar. ![Campo Local Path (Caminho local) no app Windows](/assets/images/help/desktop/add-repo-choose-button-win.png) -4. Clique em **Add Repository** (Adicionar repositório). ![Botão Add repository (Adicionar repositório) no app Windows](/assets/images/help/desktop/add-repository-button-windows.png) - -{% endwindows %} diff --git a/translations/pt-BR/content/desktop/contributing-to-projects/adding-an-existing-project-to-github-using-github-desktop.md b/translations/pt-BR/content/desktop/contributing-to-projects/adding-an-existing-project-to-github-using-github-desktop.md deleted file mode 100644 index 42e07b6d31c6..000000000000 --- a/translations/pt-BR/content/desktop/contributing-to-projects/adding-an-existing-project-to-github-using-github-desktop.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: Adicionar um projeto ao GitHub via GitHub Desktop -intro: 'É possível adicionar um repositório Git ao {% data variables.product.prodname_dotcom %} usando o {% data variables.product.prodname_desktop %}.' -versions: - free-pro-team: '*' ---- - -{% mac %} - -{% data reusables.git.remove-git-remote %} -2. [Adicione o repositório ao GitHub Desktop](/desktop/guides/contributing-to-projects/adding-a-repository-from-your-local-computer-to-github-desktop/). -{% data reusables.desktop.publish-repository %} -4. Digite o nome desejado do repositório no campo **Name** (Nome) ou use o nome padrão do repositório local. ![Campo Name (Nome)](/assets/images/help/desktop/publish-repository-name-mac.png) -5. Para publicar um repositório público, desmarque a opção **Keep this code private** (Manter este código privado). ![Caixa de seleção Keep this code private (Manter este código privado)](/assets/images/help/desktop/publish-repository-private-checkbox-mac.png) -6. Escolha a organização no menu suspenso **Organization** (Organização) onde você deseja publicar o repositório ou selecione **None** (Nenhum) para publicar o repositório na sua conta pessoal. ![Lista suspensa Organization (Organização)](/assets/images/help/desktop/publish-repository-org-dropdown-mac.png) -7. Clique no botão **Publish Repository** (Publicar repositório). ![Botão Publish repository (Publicar repositório) na caixa de diálogo Publish repository (Publicar repositório)](/assets/images/help/desktop/publish-repository-dialog-button-mac.png) - -{% endmac %} - -{% windows %} - -{% data reusables.git.remove-git-remote %} -2. [Adicione o repositório ao GitHub Desktop](/desktop/guides/contributing-to-projects/adding-a-repository-from-your-local-computer-to-github-desktop/). -{% data reusables.desktop.publish-repository %} -4. Digite o nome desejado do repositório no campo **Name** (Nome) ou use o nome padrão do repositório local. ![Campo Name (Nome)](/assets/images/help/desktop/publish-repository-name-win.png) -5. Para publicar um repositório público, desmarque a opção **Keep this code private** (Manter este código privado). ![Caixa de seleção Keep this code private (Manter este código privado)](/assets/images/help/desktop/publish-repository-private-checkbox-win.png) -6. Escolha a organização no menu suspenso **Organization** (Organização) onde você deseja publicar o repositório ou selecione **None** (Nenhum) para publicar o repositório na sua conta pessoal. ![Lista suspensa Organization (Organização)](/assets/images/help/desktop/publish-repository-org-dropdown-win.png) -7. Clique no botão **Publish Repository** (Publicar repositório). ![Botão Publish repository (Publicar repositório) na caixa de diálogo Publish repository (Publicar repositório)](/assets/images/help/desktop/publish-repository-dialog-button-win.png) - -{% endwindows %} diff --git a/translations/pt-BR/content/desktop/contributing-to-projects/adding-and-cloning-repositories.md b/translations/pt-BR/content/desktop/contributing-to-projects/adding-and-cloning-repositories.md deleted file mode 100644 index b619da009fbb..000000000000 --- a/translations/pt-BR/content/desktop/contributing-to-projects/adding-and-cloning-repositories.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: Adicionar e clonar repositórios -intro: 'Adicione repositórios existentes do seu computador local ao {% data variables.product.prodname_desktop %} ou clone os repositórios do {% data variables.product.product_name %}.' -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/pt-BR/content/desktop/contributing-to-projects/changing-a-remotes-url-from-github-desktop.md b/translations/pt-BR/content/desktop/contributing-to-projects/changing-a-remotes-url-from-github-desktop.md deleted file mode 100644 index 6a312b82b8b5..000000000000 --- a/translations/pt-BR/content/desktop/contributing-to-projects/changing-a-remotes-url-from-github-desktop.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Alterar repositório remote de URL no GitHub Desktop -intro: 'É possível alterar a URL remota do repositório com o qual você estiver trabalhando via {% data variables.product.prodname_desktop %}. Você pode fazer isso em caso de alteração do nome do repositório, do nome do usuário ou do nome da organização proprietária do repositório.' -redirect_from: - - /desktop/contributing-to-projects/changing-a-remote-s-url-from-github-desktop -versions: - free-pro-team: '*' ---- - -{% mac %} - -1. No menu **Repository** (Repositório), clique em **Repository Settings...** (Configurações do repositório...). ![Opção de menu Repository Settings (Configurações do repositório)](/assets/images/help/desktop/repository-settings-mac.png) -2. No campo **Primary remote repository** (Repositório remote principal), digite a URL. ![Campo Primary remote repository (Repositório remote principal)](/assets/images/help/desktop/repository-settings-remote-mac.png) -3. Clique em **Save** (Salvar). ![Botão Save (Salvar)](/assets/images/help/desktop/repository-settings-save-mac.png) - -{% endmac %} - -{% windows %} - -1. No menu **Repository** (Repositório), clique em **Repository Settings...** (Configurações do repositório...). ![Opção de menu Repository Settings (Configurações do repositório)](/assets/images/help/desktop/repository-settings-win.png) -2. No campo **Primary remote repository** (Repositório remote principal), digite a URL. ![Campo Primary remote repository (Repositório remote principal)](/assets/images/help/desktop/repository-settings-remote-win.png) -3. Clique em **Save** (Salvar). ![Botão Save (Salvar)](/assets/images/help/desktop/repository-settings-save-win.png) - -{% endwindows %} diff --git a/translations/pt-BR/content/desktop/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop.md b/translations/pt-BR/content/desktop/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop.md deleted file mode 100644 index e3a8905aaf97..000000000000 --- a/translations/pt-BR/content/desktop/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: Clonar um repositório do GitHub para o GitHub Desktop -intro: 'É possível usar o {% data variables.product.prodname_dotcom %} a fim de clonar repositórios remote para o {% data variables.product.prodname_desktop %}.' -versions: - free-pro-team: '*' ---- - -{% tip %} - -**Dica:** você também pode usar o {% data variables.product.prodname_desktop %} para clonar repositórios existentes no {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte "[Clonar um repositório no {% data variables.product.prodname_desktop %}](/desktop/guides/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop/)." - -{% endtip %} - -{% mac %} - -1. Entre no {% data variables.product.product_location %} e no {% data variables.product.prodname_desktop %} antes de começar a clonar. -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.open-with-github-desktop %} -5. Clique em **Choose...** (Escolher...). Em seguida, navegue pela janela Finder (Localizador) até o local em que você pretende clonar o repositório. ![Botão Choose (Escolher) na guia URL](/assets/images/help/desktop/clone-choose-button-url-mac.png) - - {% note %} - - **Observação:** se o repositório estiver configurado para usar o LFS, você deverá inicializar o {% data variables.large_files.product_name_short %}. - - {% endnote %} - -5. Clique em **Clone** (Clonar). ![Botão Clone (Clonar) na guia URL](/assets/images/help/desktop/clone-button-url-mac.png) - -{% endmac %} - -{% windows %} - -1. Entre no {% data variables.product.product_location %} e no {% data variables.product.prodname_desktop %} antes de começar a clonar. -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.open-with-github-desktop %} -5. Clique em **Choose...** (Escolher...). Em seguida, navegue pelo Windows Explorer (Explorador do Windows) até o local em que você pretende clonar o repositório. ![Botão Choose (Escolher)](/assets/images/help/desktop/clone-choose-button-url-win.png) - - {% note %} - - **Observação:** se o repositório estiver configurado para usar o LFS, você deverá inicializar o {% data variables.large_files.product_name_short %}. - - {% endnote %} - -5. Clique em **Clone** (Clonar). ![Botão Clone (Clonar)](/assets/images/help/desktop/clone-button-url-win.png) - -{% endwindows %} diff --git a/translations/pt-BR/content/desktop/contributing-to-projects/cloning-and-forking-repositories-from-github-desktop.md b/translations/pt-BR/content/desktop/contributing-to-projects/cloning-and-forking-repositories-from-github-desktop.md deleted file mode 100644 index 3c4c2abfc2dd..000000000000 --- a/translations/pt-BR/content/desktop/contributing-to-projects/cloning-and-forking-repositories-from-github-desktop.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: Cloning and forking repositories from GitHub Desktop -intro: 'É possível usar o {% data variables.product.prodname_desktop %} para clonar e bifurcar os repositórios do {% data variables.product.prodname_dotcom %}.' -redirect_from: - - /desktop/contributing-to-projects/cloning-a-repository-from-github-desktop -versions: - free-pro-team: '*' ---- - -### Clonar repositórios -Os repositórios no {% data variables.product.prodname_dotcom %} existem como repositórios remotos. É possível clonar repositórios públicos pertencentes a outras pessoas. É possível clonar o seu próprio repositório para criar uma cópia loca* no seu computador e fazer a sincronia entre os dois locais. - -Também é possível clonar um repositório diretamente no {% data variables.product.prodname_dotcom %} ou no {% data variables.product.prodname_enterprise %}. Para obter mais informações, consulte "[Clonar um repositório do {% data variables.product.prodname_dotcom %} para o {% data variables.product.prodname_desktop %}](/desktop/guides/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop/)". - -{% mac %} - -{% data reusables.desktop.choose-clone-repository %} - ![Opção de menu Clone (Clonar) no app Mac](/assets/images/help/desktop/clone-file-menu-mac.png) -{% data reusables.desktop.cloning-location-tab %} - ![Guias Location (Local) no menu Clone a repository (Clonar um repositório)](/assets/images/help/desktop/choose-repository-location-mac.png) -{% data reusables.desktop.cloning-repository-list %} - ![Clonar uma lista de repositórios](/assets/images/help/desktop/clone-a-repository-list-mac.png) -4. Clique em **Choose...** (Escolher...). Em seguida, navegue pela janela Finder (Localizador) até o local em que você pretende clonar o repositório. ![Botão Choose (Escolher)](/assets/images/help/desktop/clone-choose-button-mac.png) -5. Clique em **Clone** (Clonar). ![Botão Clone (Clonar)](/assets/images/help/desktop/clone-button-mac.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.choose-clone-repository %} - ![Opção de menu Clone (Clonar) no app Windows](/assets/images/help/desktop/clone-file-menu-windows.png) -{% data reusables.desktop.cloning-location-tab %} - ![Guias Location (Local) no menu Clone a repository (Clonar um repositório)](/assets/images/help/desktop/choose-repository-location-win.png) -{% data reusables.desktop.cloning-repository-list %} - ![Clonar uma lista de repositórios](/assets/images/help/desktop/clone-a-repository-list-win.png) -4. Clique em **Choose...** (Escolher...). Em seguida, navegue pelo Windows Explorer (Explorador do Windows) até o local em que você pretende clonar o repositório. ![Botão Choose (Escolher)](/assets/images/help/desktop/clone-choose-button-win.png) -5. Clique em **Clone** (Clonar). ![Botão Clone (Clonar)](/assets/images/help/desktop/clone-button-win.png) - -{% endwindows %} - -### Bifurcar os repositórios -Para contribuir para um projeto em que você não tem acesso de gravação, você pode usar o {% data variables.product.prodname_desktop %} para criar uma bifurcação do repositório. As alterações na sua bifurcação não afetam o repositório original. Você pode fazer commit das alterações na sua bifurcação e, em seguida, abrir um pull request no repositório original com as alterações propostas. Para obter mais informações, consulte "[Sobre bifurcações](/github/collaborating-with-issues-and-pull-requests/about-forks)". - -1. Se você clonar um repositório em que você não tem acesso de gravação e tentar fazer commit das alterações, {% data variables.product.prodname_desktop %} informará que "você não tem acesso de gravação para o **REPOSITÓRIO**. Clique em **criar uma bifurcação**. ![Criar um link debifurcação](/assets/images/help/desktop/create-a-fork.png) -3. Clique em **Bifurcar este repositório**. ![Botão bifurcar este repositório](/assets/images/help/desktop/fork-this-repo-button.png) -4. Para visualizar a sua bifurcação no {% data variables.product.prodname_dotcom %}, no canto superior direito do {% data variables.product.prodname_dotcom %}, clique na imagem do seu perfil e, em seguida, clique em **Seus repositórios**. ![Seu link para repositórios](/assets/images/help/profile/your-repositories.png) diff --git a/translations/pt-BR/content/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project.md b/translations/pt-BR/content/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project.md deleted file mode 100644 index 3d3871dbbbe2..000000000000 --- a/translations/pt-BR/content/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project.md +++ /dev/null @@ -1,99 +0,0 @@ ---- -title: Fazer commit e revisar as alterações do projeto -intro: 'À medida que você edita os arquivos, o {% data variables.product.prodname_desktop %} monitora todas as alterações feitas. É possível decidir como você pretende agrupar as alterações para criar commits relevantes.' -versions: - free-pro-team: '*' ---- - -### Sobre commits - -Em um processo semelhante ao de salvar um arquivo, um commit é uma alteração em um ou mais arquivos do branch. O Git atribui um ID exclusivo (chamado SHA ou hash) a cada commit, e o ID monitora: - -- Cada uma das alterações feitas; -- O momento em que as alterações foram feitas; -- O autor das alterações. - -Ao fazer um commit, você deve incluir uma mensagem que descreva brevemente as alterações. Também é possível incluir um coautor em quaisquer commits que envolverem trabalho colaborativo. - -### 1. Escolher um branch e fazer alterações - -1. [Crie um branch](/desktop/guides/contributing-to-projects/managing-branches) ou selecione um branch existente clicando em {% octicon "git-branch" aria-label="The branch icon" %} **Current Branch** (Branch atual) na barra de ferramentas. Em seguida, selecione o branch na lista. ![Menu suspenso para alternar o branch atual](/assets/images/help/desktop/click-branch-in-drop-down.png) -{% data reusables.desktop.make-changes %} - -### 2. Selecionar alterações para inclusão em um commit - -As alterações feitas nos arquivos via editor de texto e salvas no local também aparecerão no {% data variables.product.prodname_desktop %}. - -* O ícone vermelho {% octicon "diff-removed" aria-label="The diff removed icon color-red" %} indica os arquivos removidos. -* O ícone amarelo {% octicon "diff-modified" aria-label="The diff modified icon color-yellow" %} indica os arquivos alterados. -* O ícone verde {% octicon "diff-added" aria-label="The diff added icon color-green" %} indica os arquivos adicionados. -* Para acessar as alterações stashed, clique em **Stashed Changes** (Alterações stashed). ![Opção Stashed Changes (Alterações stashed)](/assets/images/help/desktop/stashed-changes.png) -* {% data reusables.desktop.commit-all-desc %} -![Caixa de seleção para fazer commit em todos os arquivos alterados](/assets/images/help/desktop/commit-all.png) -* {% data reusables.desktop.commit-some-desc %} -![Caixas de seleção ao lado dos arquivos em que deseja fazer commit](/assets/images/help/desktop/commit-some.png) - -#### Criar um commit parcial - -Se um arquivo tiver várias alterações e você quiser incluir somente *algumas* no commit, será possível criar um commit parcial. O restante das alterações ficará intacto, de modo que você possa fazer outras modificações e commits. Essa opção permite fazer commits separados mais relevantes, como manter alterações de quebra de linha em um commit separado das alterações de código. - -Durante a revisão do diff do arquivo, as linhas a serem incluídas no commit ficam destacadas em azul. Para excluir a alteração, clique na linha alterada para que o destaque azul desapareça. - -![Linhas desmarcadas em um arquivo](/assets/images/help/desktop/partial-commit.png) - -#### Descartar alterações - -Você pode descartar todas as alterações sem commits em um arquivo ou intervalo de arquivos. Também é possível descartar todas as alterações em todos os arquivos desde a última confirmação. - -{% mac %} - -{% data reusables.desktop.select-discard-files %} -{% data reusables.desktop.click-discard-files %} - ![Opção Discard Changes (Descartar alterações) no menu de contexto](/assets/images/help/desktop/discard-changes-mac.png) -{% data reusables.desktop.confirm-discard-files %} - ![Botão Discard Changes (Descartar alterações) na caixa de diálogo Confirmation (Confirmação)](/assets/images/help/desktop/discard-changes-confirm-mac.png) - -{% tip %} - -**Dica:** as alterações descartadas são salvas em um arquivo com data em Trash (Lixeira), e será possível recuperá-las até que a lixeira seja esvaziada. - -{% endtip %} - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.select-discard-files %}{% data reusables.desktop.click-discard-files %} - ![Opção Discard Changes (Descartar alterações) no menu de contexto](/assets/images/help/desktop/discard-changes-win.png) -{% data reusables.desktop.confirm-discard-files %} - ![Botão Discard Changes (Descartar alterações) na caixa de diálogo Confirmation (Confirmação)](/assets/images/help/desktop/discard-changes-confirm-win.png) - -{% tip %} - -**Dica:** as alterações descartadas são salvas em um arquivo com data em Recycle Bin (Lixo), e será possível recuperá-las até a lixeira ser esvaziada. - -{% endtip %} - -{% endwindows %} - -### 3. Mensagem de commit e envio das alterações - -Ao concluir as alterações que você decidiu fazer no commit, escreva a mensagem do commit e envie as alterações. Se o commit envolveu trabalho em colaboração, será possível atribuí-lo a mais de um autor. - -{% note %} - -**Observação**: {% data reusables.desktop.tags-push-with-commits %} Para obter mais informações, consulte "[Gerenciando tags](/desktop/contributing-to-projects/managing-tags)". - -{% endnote %} - -{% data reusables.desktop.commit-message %} - ![Campo Commit message (Mensagem do commit)](/assets/images/help/desktop/commit-message.png) -2. Para atribuir um commit a outro autor, você também pode clicar no ícone para adicionar coautores e digitar o(s) nome(s) de usuário que pretende incluir. ![Adicionar um coautor à mensagem do commit](/assets/images/help/desktop/add-co-author-commit.png) -{% data reusables.desktop.commit-button %} - ![Botão Commit (Fazer commit)](/assets/images/help/desktop/commit-button.png) -4. Se o branch com a qual você está tentando fazer commit estiver protegido, o desktop irá avisá-lo. - - Para mover as alterações, clique em **alternar branches**. - - Para confirmar suas alterações no branch protegido, clique em **Commit para _BRANCH_**. - - Para obter mais informações sobre branches protegidos, consulte "[Sobre branches protegidos](/github/administering-a-repository/about-protected-branches)". ![Aviso de branch protegido](/assets/images/help/desktop/protected-branch-warning.png) -{% data reusables.desktop.push-origin %} diff --git a/translations/pt-BR/content/desktop/contributing-to-projects/creating-a-branch-for-your-work.md b/translations/pt-BR/content/desktop/contributing-to-projects/creating-a-branch-for-your-work.md deleted file mode 100644 index ac0ffae89de8..000000000000 --- a/translations/pt-BR/content/desktop/contributing-to-projects/creating-a-branch-for-your-work.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: Criar um branch para teste -intro: 'Se tiver permissões de colaborador em um repositório, você poderá criar um branch a partir do branch padrão do repositório para testar suas alterações com segurança.' -versions: - free-pro-team: '*' ---- - -### Criar um branch - -{% tip %} - -**Dica:** o primeiro branch que você criar terá como base o branch padrão, que costuma ser `master`. Se houver mais de um branch, será possível basear seu novo branch no branch verificado ou no branch padrão. - -{% endtip %} - -{% mac %} - -{% data reusables.desktop.click-base-branch-in-drop-down %} - ![Menu suspenso para alternar o branch atual](/assets/images/help/desktop/click-branch-in-drop-down-mac.png) -{% data reusables.desktop.create-new-branch %} - ![Opção New Branch (Novo branch) no menu Branch](/assets/images/help/desktop/new-branch-button-mac.png) -{% data reusables.desktop.name-branch %} - ![Campo para criar um nome para o novo branch](/assets/images/help/desktop/create-branch-name-mac.png) -{% data reusables.desktop.select-base-branch %} - ![Opções do branch base](/assets/images/help/desktop/create-branch-choose-branch-mac.png) -{% data reusables.desktop.confirm-new-branch-button %} - ![Botão Create Branch (Criar branch)](/assets/images/help/desktop/create-branch-button-mac.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.click-base-branch-in-drop-down %} - ![Menu suspenso para alternar o branch atual](/assets/images/help/desktop/click-branch-in-drop-down-win.png) -{% data reusables.desktop.create-new-branch %} - ![Opção New Branch (Novo branch) no menu Branch](/assets/images/help/desktop/new-branch-button-win.png) -{% data reusables.desktop.name-branch %} - ![Campo para criar um nome para o novo branch](/assets/images/help/desktop/create-branch-name-win.png) -{% data reusables.desktop.select-base-branch %} - ![Opções do branch base](/assets/images/help/desktop/create-branch-choose-branch-win.png) -{% data reusables.desktop.confirm-new-branch-button %} - ![Botão Create branch (Criar branch)](/assets/images/help/desktop/create-branch-button-win.png) - -{% endwindows %} - -### Leia mais - -- "[Clonar um repositório no {% data variables.product.prodname_desktop %}](/desktop/guides/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop)" diff --git a/translations/pt-BR/content/desktop/contributing-to-projects/creating-an-issue-or-pull-request.md b/translations/pt-BR/content/desktop/contributing-to-projects/creating-an-issue-or-pull-request.md deleted file mode 100644 index 1fa2ef51ecdc..000000000000 --- a/translations/pt-BR/content/desktop/contributing-to-projects/creating-an-issue-or-pull-request.md +++ /dev/null @@ -1,56 +0,0 @@ ---- -title: Criar um problema ou um pull request -intro: É possível criar um problema ou um pull request para propor e colaborar com alterações em um repositório. -redirect_from: - - /desktop/contributing-to-projects/creating-a-pull-request -versions: - free-pro-team: '*' ---- - -### Abrir um problema novo -Ao encontrar um erro ou desejar sugerir uma melhoria ao trabalhar localmente com o {% data variables.product.prodname_desktop %}, você poderá abrir um novo problema no repositório em que se encontra se os problemas estiverem habilitados. Para obter mais informações sobre como trabalhar com problemas, consulte "[Sobre problemas](/github/managing-your-work-on-github/about-issues)". - -{% mac %} - -1. No canto superior esquerdo da tela, selecione o menu **Repositório**. ![Menu GitHub Desktop na barra de menu do Mac](/assets/images/help/desktop/select-repository-menu-mac.png) -2. Clique em **Criar problema no {% data variables.product.prodname_dotcom %}**. ![Valor do repositório no menu Branch](/assets/images/help/desktop/create-issue-mac.png) -3. Em {% data variables.product.prodname_dotcom %}, clique em **Começar** para abrir um modelo do problema ou clique em **Abrir um problema em branco**. ![Criar novas opções do problema](/assets/images/help/desktop/create-new-issue.png) - -{% endmac %} - -{% windows %} - -1. No canto superior esquerdo da janela, selecione o menu **Repositório**. ![Menu GitHub Desktop na barra de menus do Mac](/assets/images/help/desktop/select-repository-menu-windows.png) -2. Clique em **Criar problema no {% data variables.product.prodname_dotcom %}**. ![O valor do repositório no menu Branch](/assets/images/help/desktop/create-issue-windows.png) -3. Em {% data variables.product.prodname_dotcom %}, clique em **Começar** para abrir um modelo do problema ou clique em **Abrir um problema em branco**. ![Criar novas opções do problema](/assets/images/help/desktop/create-new-issue.png) - -{% endwindows %} - -{% note %} - -**Observação**: Se os modelos do problema não estiverem habilitados em seu repositório atual, o {% data variables.product.prodname_desktop %} irá direcionar você para um problema em branco no {% data variables.product.prodname_dotcom %}. - -{% endnote %} - -### Criar um novo pull request -Depois de [criar um branch](/desktop/guides/contributing-to-projects/managing-branches) e [fazer commit das alterações](/desktop/guides/contributing-to-projects/committing-and-reviewing-changes-to-your-project), você pode abrir uma pull request para receber feedback das alterações propostas. - -{% mac %} - -1. No canto superior esquerdo da tela, selecione o menu **Branch**. ![Menu GitHub Desktop na barra de menus do Mac](/assets/images/help/desktop/mac-select-branch-menu.png) -2. Clique em **Create Pull Request** (Criar pull request). ![Valor Create pull request (Criar pull request) no menu Branch](/assets/images/help/desktop/create-pull-request-mac.png) -3. No {% data variables.product.prodname_dotcom %}, verifique o padrão do branch _base_ e do branch _compare_ nos menus suspensos e faça a alteração, se necessário. ![Menus suspenso para escolher a base e comparar os branches](/assets/images/help/pull_requests/choose-base-and-compare-branches.png) -{% data reusables.repositories.pr-title-description %} -{% data reusables.repositories.create-pull-request %} - -{% endmac %} - -{% windows %} - -1. No canto superior esquerdo da janela, selecione o menu **Branch**. ![Menu GitHub Desktop na barra de menus do Windows](/assets/images/help/desktop/windows-select-branch-menu.png) -2. Clique em **Create pull request** (Criar pull request). ![Valor Create pull request (Criar pull request) no menu Branch](/assets/images/help/desktop/create-pull-request-win.png) -3. No {% data variables.product.prodname_dotcom %}, verifique o padrão do branch _base_ e do branch _compare_ nos menus suspensos e faça a alteração, se necessário. ![Menus suspenso para escolher a base e comparar os branches](/assets/images/help/pull_requests/choose-base-and-compare-branches.png) -{% data reusables.repositories.pr-title-description %} -{% data reusables.repositories.create-pull-request %} - -{% endwindows %} diff --git a/translations/pt-BR/content/desktop/contributing-to-projects/index.md b/translations/pt-BR/content/desktop/contributing-to-projects/index.md deleted file mode 100644 index e1ee4ca280af..000000000000 --- a/translations/pt-BR/content/desktop/contributing-to-projects/index.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: Contribuir em projetos com o GitHub Desktop -shortTitle: Contribuir para projetos -intro: 'Use o GitHub Desktop para gerenciar projetos, criar commits relevantes e monitorar o histórico de cada projeto em um aplicativo em vez de usar a linha de comando.' -versions: - free-pro-team: '*' ---- - - -### Índice - -{% topic_link_in_list /adding-and-cloning-repositories %} - {% link_in_list /adding-a-repository-from-your-local-computer-to-github-desktop %} - {% link_in_list /adding-an-existing-project-to-github-using-github-desktop %} - {% link_in_list /cloning-and-forking-repositories-from-github-desktop %} - {% link_in_list /cloning-a-repository-from-github-to-github-desktop %} -{% topic_link_in_list /making-changes-in-a-branch %} - {% link_in_list /managing-branches %} - {% link_in_list /committing-and-reviewing-changes-to-your-project %} - {% link_in_list /pushing-changes-to-github %} - {% link_in_list /reverting-a-commit %} - {% link_in_list /managing-tags %} - {% link_in_list /viewing-the-branch-history %} -{% topic_link_in_list /working-with-your-remote-repository-on-github-or-github-enterprise %} - {% link_in_list /syncing-your-branch %} - {% link_in_list /creating-an-issue-or-pull-request %} - {% link_in_list /accessing-a-pull-request-locally %} - {% link_in_list /changing-a-remotes-url-from-github-desktop %} diff --git a/translations/pt-BR/content/desktop/contributing-to-projects/making-changes-in-a-branch.md b/translations/pt-BR/content/desktop/contributing-to-projects/making-changes-in-a-branch.md deleted file mode 100644 index 3fe8142a050d..000000000000 --- a/translations/pt-BR/content/desktop/contributing-to-projects/making-changes-in-a-branch.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: Fazer alterações em um branch -intro: 'Faça alterações no projeto usando seu editor de texto favorito, como o [Atom] (https://atom.io/). Em seguida, use o {% data variables.product.prodname_desktop %} para exibir commits relevantes.' -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/pt-BR/content/desktop/contributing-to-projects/managing-branches.md b/translations/pt-BR/content/desktop/contributing-to-projects/managing-branches.md deleted file mode 100644 index d836ace0e4fa..000000000000 --- a/translations/pt-BR/content/desktop/contributing-to-projects/managing-branches.md +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: Managing branches -intro: You can create a branch off of a repository's default branch so you can safely experiment with changes. -redirect_from: - - /desktop/contributing-to-projects/creating-a-branch-for-your-work - - /desktop/contributing-to-projects/switching-between-branches -versions: - free-pro-team: '*' ---- - -### About managing branches -You can use branches to safely experiment with changes to your project. Branches isolate your development work from other branches in the repository. For example, you could use a branch to develop a new feature or fix a bug. - -You always create a branch from an existing branch. Typically, you might create a branch from the `master` branch of your repository. You can then work on this new branch in isolation from changes that other people are making to the repository. - -Once you're satisfied with your work, you can [open a pull request](/desktop/contributing-to-projects/creating-an-issue-or-pull-request) to merge the changes in the current branch into another branch. Para obter mais informações, consulte "[Sobre pull requests](/articles/about-pull-requests)". - -You can always create a branch in {% data variables.product.prodname_desktop %} if you have read access to a repository, but you can only push the branch to {% data variables.product.prodname_dotcom %} if you have write access to the repository. - -{% data reusables.desktop.protected-branches %} - -### Criar um branch - -{% tip %} - -**Dica:** o primeiro branch que você criar terá como base o branch padrão, que costuma ser `master`. If you have more than one branch, you can choose to base the new branch on the currently checked out branch or the default branch. - -{% endtip %} - -{% mac %} - -{% data reusables.desktop.click-base-branch-in-drop-down %} - ![Menu suspenso para alternar o branch atual](/assets/images/help/desktop/click-branch-in-drop-down-mac.png) -{% data reusables.desktop.create-new-branch %} - ![Opção New Branch (Novo branch) no menu Branch](/assets/images/help/desktop/new-branch-button-mac.png) -{% data reusables.desktop.name-branch %} - ![Campo para criar um nome para o novo branch](/assets/images/help/desktop/create-branch-name-mac.png) -{% data reusables.desktop.select-base-branch %} - ![Opções do branch base](/assets/images/help/desktop/create-branch-choose-branch-mac.png) -{% data reusables.desktop.confirm-new-branch-button %} - ![Botão Create Branch (Criar branch)](/assets/images/help/desktop/create-branch-button-mac.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.click-base-branch-in-drop-down %} - ![Menu suspenso para alternar o branch atual](/assets/images/help/desktop/click-branch-in-drop-down-win.png) -{% data reusables.desktop.create-new-branch %} - ![Opção New Branch (Novo branch) no menu Branch](/assets/images/help/desktop/new-branch-button-win.png) -{% data reusables.desktop.name-branch %} - ![Campo para criar um nome para o novo branch](/assets/images/help/desktop/create-branch-name-win.png) -{% data reusables.desktop.select-base-branch %} - ![Opções do branch base](/assets/images/help/desktop/create-branch-choose-branch-win.png) -{% data reusables.desktop.confirm-new-branch-button %} - ![Botão Create branch (Criar branch)](/assets/images/help/desktop/create-branch-button-win.png) - -{% endwindows %} - -### Alternar entre branches -É possível exibir e fazer commits em qualquer branch do seu repositório. Se houver alterações salvas sem commit, você terá que decidir o que fazer com elas antes de poder alternar entre os branches. Você pode fazer commit das alterações no branch atual, armazená-las no branch atual ou levá-las para o novo branch. Se optar por fazer commit das alterações no branch atual, siga as etapas indicadas em "[Fazer commit e revisar as alterações do projeto](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project)" antes de alternar entre os branches. - -{% tip %} - -**Dica**: Você pode definir um comportamento-padrão para alternar branches nas configurações **Avançadas**. For more information, see "[Configuring basic settings](/desktop/getting-started-with-github-desktop/configuring-basic-settings)." - -{% endtip %} - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.switching-between-branches %} - ![Lista de branches no repositório](/assets/images/help/desktop/click-branch-in-drop-down-mac.png) -3. Se você tiver alterações salvas sem commit, escolha entre **Leave my changes** (Deixar as alterações) ou **Bring my changes** (Levar as alterações) e clique em **Switch Branch** (Alternar branch). ![Alternar branch com opções de alteração](/assets/images/help/desktop/stash-changes-options.png) - -### Recuperar alterações stashed -Para acessar as alterações com stash em outro branch, volte para o branch em que foi feito o stash das alterações em questão. - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.switching-between-branches %} - ![Lista de branches no repositório](/assets/images/help/desktop/click-branch-in-drop-down-mac.png) -3. Na barra lateral à esquerda, clique em **Stashed Changes** (Alterações stashed). ![Opção Stashed Changes (Alterações stashed)](/assets/images/help/desktop/stashed-changes.png) -4. Para excluir as alterações stashed, clique em **Discard** (Descartar). Para usá-las, clique em **Restore** (Restaurar). ![Descartar ou restaurar alterações stashed](/assets/images/help/desktop/discard-restore-stash-buttons.png) - -### Excluir um branch - -You can't delete a branch if it's currently associated with an open pull request. You cannot undo deleting a branch. - -{% mac %} - -{% data reusables.desktop.select-branch-to-delete %} - ![Drop-down menu to select which branch to delete](/assets/images/help/desktop/select-branch-to-delete.png) -{% data reusables.desktop.delete-branch-mac %} - ![Delete... option in the Branch menu](/assets/images/help/desktop/delete-branch-mac.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.select-branch-to-delete %} - ![Drop-down menu to select which branch to delete](/assets/images/help/desktop/select-branch-to-delete.png) -{% data reusables.desktop.delete-branch-win %} - ![Delete... option in the Branch menu](/assets/images/help/desktop/delete-branch-win.png) - -{% endwindows %} - -### Leia mais - -- "[Clonar um repositório no {% data variables.product.prodname_desktop %}](/desktop/guides/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop)" -- "[Branch](/articles/github-glossary/#branch)" no glossário do {% data variables.product.prodname_dotcom %} -- "[Sobre branches](/articles/about-branches)" -- "[Branches em um Nutshell](https://git-scm.com/book/en/v2/Git-Branching-Branches-in-a-Nutshell)" na documentação do Git diff --git a/translations/pt-BR/content/desktop/contributing-to-projects/managing-tags.md b/translations/pt-BR/content/desktop/contributing-to-projects/managing-tags.md deleted file mode 100644 index a5eafcd4e0a3..000000000000 --- a/translations/pt-BR/content/desktop/contributing-to-projects/managing-tags.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: Gerenciar tags -intro: 'Você pode usar {% data variables.product.prodname_desktop %} para criar, fazer push e visualizar tags.' -versions: - free-pro-team: '*' ---- - -### Sobre tags no {% data variables.product.prodname_desktop %} - -O {% data variables.product.prodname_desktop %} permite que você crie tags anotadas. É possível usar uma tag para marcar um ponto individual no histórico do seu repositório, incluindo um número de versão para uma versão. Para obter mais informações sobre tags de versão, consulte "[Sobre versões](https://help.github.com/en/github/administering-a-repository/about-releases)" - -{% data reusables.desktop.tags-push-with-commits %} - -### Criar uma tag - -{% data reusables.desktop.history-tab %} -{% data reusables.desktop.create-tag %} -{% data reusables.desktop.name-tag %} -{% data reusables.desktop.confirm-tag %} - -### Visualizar tags - -{% data reusables.desktop.history-tab %} -2. Clique em commit. - {% note %} - - **Observação**: {% data variables.product.prodname_desktop %} exibe uma seta {% octicon "arrow-up" aria-label="The up arrow icon" %} se a tag não foi tiver sido empurrada para o repositório remoto. - - {% endnote %} - - ![Visualizar uma tag no histórico](/assets/images/help/desktop/viewing-tags-in-history.png) - -3. Todas as tags associadas ao commit são visíveis nos metadados desse commit. ![Visualizar uma tag no commit](/assets/images/help/desktop/viewing-tags-in-commit.png) diff --git a/translations/pt-BR/content/desktop/contributing-to-projects/pushing-changes-to-github.md b/translations/pt-BR/content/desktop/contributing-to-projects/pushing-changes-to-github.md deleted file mode 100644 index 89536e3d8831..000000000000 --- a/translations/pt-BR/content/desktop/contributing-to-projects/pushing-changes-to-github.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Pushing changes to GitHub -shortTitle: Pushing changes -intro: 'As you commit changes to your project locally, you can push those changes to {% data variables.product.prodname_dotcom %} so that others may access them from the remote repository.' -permissions: People with write permissions can push changes to a repository. -versions: - free-pro-team: '*' ---- - -### About pushing changes to {% data variables.product.prodname_dotcom %} - -When you push changes, you send the committed changes in your local repository to the remote repository on {% data variables.product.prodname_dotcom %}. If you change your project locally and want other people to have access to the changes, you must push the changes to {% data variables.product.prodname_dotcom %}. - -Before pushing changes, you should update your local branch to include any commits that have been added to the remote repository. If someone has made commits on the remote that are not on your local branch, {% data variables.product.prodname_desktop %} will prompt you to fetch the new commits before pushing your changes to avoid merge conflicts. For more information, see "[Syncing your branch](/desktop/contributing-to-projects/syncing-your-branch)." - -{% data reusables.desktop.protected-branches %} - -### Pushing changes to {% data variables.product.prodname_dotcom %} - -{% note %} - -**Note:** {% data variables.product.prodname_desktop %} will reject a push if it exceeds certain limits. - -- A push contains a large file over 100MB in size. -- A push is over 2GB in total size. - -{% endnote %} - -{% data reusables.desktop.push-origin %} -2. If {% data variables.product.prodname_desktop %} prompts you to fetch new commits from the remote, click **Fetch**. ![The Fetch button](/assets/images/help/desktop/fetch-newer-commits.png) -3. Optionally, click **Create Pull Request** to open a pull request and collaborate on your changes. For more information, see "[Creating an issue or pull request](/desktop/contributing-to-projects/creating-an-issue-or-pull-request)" ![The Create Pull Request button](/assets/images/help/desktop/create-pull-request.png) - -### Leia mais -- "[Push](/github/getting-started-with-github/github-glossary/#push)" in the {% data variables.product.prodname_dotcom %} glossary -- "[Committing and reviewing changes to your project](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project)" diff --git a/translations/pt-BR/content/desktop/contributing-to-projects/reverting-a-commit.md b/translations/pt-BR/content/desktop/contributing-to-projects/reverting-a-commit.md deleted file mode 100644 index 5f07fd4b44ea..000000000000 --- a/translations/pt-BR/content/desktop/contributing-to-projects/reverting-a-commit.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: Reverter um commit -intro: Você pode reverter um commit específico para remover suas alterações do seu branch. -versions: - free-pro-team: '*' ---- - -Ao reverter para um commit anterior, a reversão também passa a ser um commit. Além disso, o commit original fica no histórico do repositório. - -{% tip %} - -**Dica:** ao reverter vários commits, é melhor fazer a reversão do mais recente para o mais antigo. Reverter commits em outra ordem pode gerar conflitos de merge. - -{% endtip %} - -{% mac %} - -{% data reusables.desktop.history-tab %} -{% data reusables.desktop.revert-commit %} - ![Opção Revert (Reverter) acima da exibição diff](/assets/images/help/desktop/commit-revert-mac.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.history-tab %} -{% data reusables.desktop.revert-commit %} - ![Opção Revert (Reverter) acima da exibição diff](/assets/images/help/desktop/commit-revert-win.png) - -{% endwindows %} diff --git a/translations/pt-BR/content/desktop/contributing-to-projects/switching-between-branches.md b/translations/pt-BR/content/desktop/contributing-to-projects/switching-between-branches.md deleted file mode 100644 index b14dd1d19e69..000000000000 --- a/translations/pt-BR/content/desktop/contributing-to-projects/switching-between-branches.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: Alternar entre branches -intro: É possível exibir e fazer commits em qualquer branch do seu repositório. -versions: - free-pro-team: '*' ---- - -### Alternar entre branches -Se houver alterações salvas sem commit, você terá que decidir o que fazer com elas antes de poder alternar entre os branches. Você pode fazer commit das alterações no branch atual, armazená-las no branch atual ou levá-las para o novo branch. Se optar por fazer commit das alterações no branch atual, siga as etapas indicadas em "[Fazer commit e revisar as alterações do projeto](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project)" antes de alternar entre os branches. - -{% tip %} - -**Dica**: Você pode definir um comportamento-padrão para alternar branches nas configurações **Avançadas**. Para obter mais informações, consulte “[Definindo as configurações básicas](/desktop/getting-started-with-github-desktop/configuring-basic-settings)". - -{% endtip %} - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.switching-between-branches %} - ![Lista de branches no repositório](/assets/images/help/desktop/click-branch-in-drop-down-mac.png) -3. Se você tiver alterações salvas sem commit, escolha entre **Leave my changes** (Deixar as alterações) ou **Bring my changes** (Levar as alterações) e clique em **Switch Branch** (Alternar branch). ![Alternar branch com opções de alteração](/assets/images/help/desktop/stash-changes-options.png) - -### Recuperar alterações stashed -Para acessar as alterações com stash em outro branch, volte para o branch em que foi feito o stash das alterações em questão. - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.switching-between-branches %} - ![Lista de branches no repositório](/assets/images/help/desktop/click-branch-in-drop-down-mac.png) -3. Na barra lateral à esquerda, clique em **Stashed Changes** (Alterações stashed). ![Opção Stashed Changes (Alterações stashed)](/assets/images/help/desktop/stashed-changes.png) -4. Para excluir as alterações stashed, clique em **Discard** (Descartar). Para usá-las, clique em **Restore** (Restaurar). ![Descartar ou restaurar alterações stashed](/assets/images/help/desktop/discard-restore-stash-buttons.png) diff --git a/translations/pt-BR/content/desktop/contributing-to-projects/syncing-your-branch.md b/translations/pt-BR/content/desktop/contributing-to-projects/syncing-your-branch.md deleted file mode 100644 index ebfbde86a2ee..000000000000 --- a/translations/pt-BR/content/desktop/contributing-to-projects/syncing-your-branch.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: Sincronizar o branch -intro: 'Ao enviar commits para o seu projeto no {% data variables.product.prodname_dotcom %}, é possível manter uma cópia local do projeto sincronizada com o repositório remote.' -versions: - free-pro-team: '*' ---- - -Sincronize o branch local com o repositório remote para ver outros commits que possam ter sido adicionados ao branch upstream desde a [criação do branch original](/desktop/guides/contributing-to-projects/managing-branches). - -### Atualizar o branch local - -1. No {% data variables.product.prodname_desktop %}, alterne para o branch local que você pretende atualizar clicando em {% octicon "git-branch" aria-label="The branch icon" %} **Current Branch** (Branch atual). Em seguida, selecione o branch na lista. -2. Clique em **Fetch origin** (Fetch de origem) para atualizar o branch. ![Botão Fetch origin (Fetch de origem)](/assets/images/help/desktop/fetch-button.png) -3. Se houver commits no branch remote, será possível enviá-los clicando em **Pull origin** (Enviar origem) ou **Pull origin with rebase** (Enviar origem com rebase). ![Botão Pull origin (Origem do pull)](/assets/images/help/desktop/pull-button.png) -{% data reusables.desktop.resolve-merge-conflicts %} - -### Fazer merge entre o branch do projeto e outro branch - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.choose-a-branch-to-merge %} -{% data reusables.desktop.confirm-merging-branch %} - - {% note %} - - **Observação:** se houver conflitos de merge, o {% data variables.product.prodname_desktop %} enviará uma notificação acima do botão **Merge BRANCH into BRANCH** (Fazer merge de branch em branch). Não será possível fazer merge dos branches até a solução de todos os conflitos. - - {% endnote %} - - ![Botão Merge](/assets/images/help/desktop/merge-branch-button.png) -{% data reusables.desktop.push-origin %} - -### Fazer rebase entre o branch do projeto e outro branch -Alguns fluxos de trabalho exigem ou preferem o rebasing ao merging. Ao fazer o rebase, é possível reordenar, editar ou juntar commits. Para obter mais informações, consulte "[Rebase no Git](/articles/about-git-rebase)". - -1. Use o menu suspenso **Branch** e clique em **Rebase Current Branch** (Fazer rebase do branch atual). ![Rebase do branch atual na lista suspensa de branches](/assets/images/help/desktop/rebase-current-branch.png) -2. Clique no branch desejado para fazer rebase com o branch atual. Em seguida, clique em **Start rebase** (Iniciar rebase). ![Botão Start rebase (Iniciar rebase)](/assets/images/help/desktop/start-rebase-button.png) -3. Se tiver certeza da operação de rebase, clique em **Begin rebase** (Começar rebase). ![Botão Begin rebase (Começar rebase)](/assets/images/help/desktop/begin-rebase-button.png) -{% data reusables.desktop.resolve-merge-conflicts %} -4. Para fazer push das alterações locais, clique em **Force push origin** (Forçar push da origem). ![Force push origin (Forçar push de origem)](/assets/images/help/desktop/force-push-origin.png) diff --git a/translations/pt-BR/content/desktop/contributing-to-projects/viewing-the-branch-history.md b/translations/pt-BR/content/desktop/contributing-to-projects/viewing-the-branch-history.md deleted file mode 100644 index 1c802fd0d814..000000000000 --- a/translations/pt-BR/content/desktop/contributing-to-projects/viewing-the-branch-history.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: Exibir o histórico do branch -intro: 'Você pode ver informações sobre qualquer commit no {% data variables.product.prodname_desktop %}, incluindo uma diff das alterações introduzidas pelo commit.' -versions: - free-pro-team: '*' ---- - -Cada commit mostra o seguinte: - - - A mensagem do commit; - - O momento em que o commit foi criado; - - O nome de usuário e a foto de perfil do autor do commit; - - O hash SHA-1 (ID exclusivo) do commit. - -{% data reusables.desktop.history-tab %} -2. Na guia **History** (Histórico), clique no commit que deseja revisar. ![Commit na guia History (Histórico)](/assets/images/help/desktop/branch-history-commit.png) -3. Se houver vários arquivos no commit, clique em um deles para ver as mudanças feitas no arquivo e no commit em questão. ![Arquivo no commit](/assets/images/help/desktop/branch-history-file.png) - -### Further reading - -- "[Sincronizar o branch](/desktop/guides/contributing-to-projects/syncing-your-branch/)" diff --git a/translations/pt-BR/content/desktop/contributing-to-projects/working-with-your-remote-repository-on-github-or-github-enterprise.md b/translations/pt-BR/content/desktop/contributing-to-projects/working-with-your-remote-repository-on-github-or-github-enterprise.md deleted file mode 100644 index f98bb0d15f6e..000000000000 --- a/translations/pt-BR/content/desktop/contributing-to-projects/working-with-your-remote-repository-on-github-or-github-enterprise.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: Usar repositórios remote no GitHub ou no GitHub Enterprise -intro: 'As alterações feitas no seu projeto local podem ser refletidas no repositório remote. No Git, o termo *remote* descreve o servidor onde o seu código está armazenado. No seu caso, esse servidor é um repositório no {% data variables.product.prodname_dotcom %} ou no {% data variables.product.prodname_enterprise %}.' -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/about-the-github-desktop-windows-installer-package.md b/translations/pt-BR/content/desktop/getting-started-with-github-desktop/about-the-github-desktop-windows-installer-package.md deleted file mode 100644 index 91cc2340fa58..000000000000 --- a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/about-the-github-desktop-windows-installer-package.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Sobre o pacote Windows Installer do GitHub Desktop -intro: 'O administrador da rede pode usar o arquivo do pacote Windows Installer (`.msi`) com a Política de Grupo ou outro sistema de instalação remota para implantar o {% data variables.product.prodname_desktop %} em computadores com o Microsoft Windows em uma rede gerenciada do Active Directory.' -versions: - free-pro-team: '*' ---- - -O pacote Windows Installer extrai o instalador autônomo (`.exe `) e configura o Windows para instalar o {% data variables.product.prodname_desktop %} quando um usuário faz login na estação de trabalho. Os usuários devem ter permissão para instalar o {% data variables.product.prodname_desktop %} em seus respectivos diretórios. - -Se executar diretamente o pacote Windows Installer do {% data variables.product.prodname_desktop %}, o usuário terá que sair e voltar à estação de trabalho para concluir a instalação. diff --git a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/authenticating-to-github.md b/translations/pt-BR/content/desktop/getting-started-with-github-desktop/authenticating-to-github.md deleted file mode 100644 index 50fcb064ea30..000000000000 --- a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/authenticating-to-github.md +++ /dev/null @@ -1,65 +0,0 @@ ---- -title: Autenticar com o GitHub -intro: 'Conecte sua conta {% data variables.product.product_name %} ao {% data variables.product.prodname_desktop %}.' -redirect_from: - - /desktop/getting-started-with-github-desktop/authenticating-to-github-using-the-browser -versions: - free-pro-team: '*' ---- - -Antes de autenticar, {% data reusables.desktop.get-an-account %} - -{% mac %} - -### Fazer a autenticação no {% data variables.product.prodname_dotcom %} usando o navegador - -{% data reusables.desktop.mac-select-desktop-menu %} -{% data reusables.desktop.mac-select-accounts %} -4. À direita de "{% data variables.product.prodname_dotcom %}," clique **Iniciar sessão**. ![Botão Sign In (Entrar) do GitHub](/assets/images/help/desktop/mac-sign-in-github.png) -5. No painel Sign in (Entrar), clique em **Sign in using your browser** (Entrar via navegador). ![Link Sign in using your browser (Entrar via navegador)](/assets/images/help/desktop/mac-sign-in-browser.png) -{% data reusables.desktop.authenticate-in-browser %} -{% data reusables.desktop.retrieve-2fa-in-browser %} -{% data reusables.desktop.enter-2fa-in-browser %} -9. Depois que o {% data variables.product.prodname_dotcom %} autenticar sua conta, volte ao {% data variables.product.prodname_desktop %}. - -### Fazer a autenticação no {% data variables.product.prodname_dotcom %} usando seu nome de usuário e senha - -{% data reusables.user_settings.password-authentication-deprecation-desktop %} - -{% data reusables.desktop.mac-select-desktop-menu %} -{% data reusables.desktop.mac-select-accounts %} -{% data reusables.desktop.choose-product-authenticate %} -5. Para adicionar uma conta do GitHub Enterprise, digite suas credenciais em "Enterprise server address" (Endereço do servidor Enterprise) e clique em **Continue** (Continuar). ![Botão Sign In (Entrar) do GitHub Enterprise](/assets/images/help/desktop/mac-sign-in-button-enterprise.png) -6. Para adicionar uma conta do GitHub, digite as credenciais do GitHub.com e clique em **Sign in** (Entrar). ![Botão Sign In (Entrar) do GitHub](/assets/images/help/desktop/mac-sign-in-button.png) -{% data reusables.desktop.retrieve-2fa %} -{% data reusables.desktop.return-to-desktop %} No prompt, insira seu código 2FA e clique em **Sign in** (Entrar). ![Solicitação do código 2FA](/assets/images/help/desktop/mac-2fa-code-prompt.png) - -{% endmac %} - -{% windows %} - -### Fazer a autenticação no {% data variables.product.prodname_dotcom %} usando o navegador - -{% data reusables.desktop.windows-choose-options %} -{% data reusables.desktop.windows-select-accounts %} -4. À direita do "GitHub.com", clique **Iniciar sessão**. ![Botão Sign In (Entrar) do GitHub](/assets/images/help/desktop/windows-sign-in-github.png) -5. No painel Sign in (Entrar), clique em **Sign in using your browser** (Entrar via navegador). ![Link Sign in using your browser (Entrar via navegador)](/assets/images/help/desktop/windows-sign-in-browser.png) -{% data reusables.desktop.authenticate-in-browser %} -{% data reusables.desktop.retrieve-2fa-in-browser %} -{% data reusables.desktop.enter-2fa-in-browser %} -9. Depois que o {% data variables.product.prodname_dotcom %} autenticar sua conta, volte ao {% data variables.product.prodname_desktop %}. - -### Fazer a autenticação no {% data variables.product.prodname_dotcom %} usando seu nome de usuário e senha - - -{% data reusables.user_settings.password-authentication-deprecation-desktop %} - -{% data reusables.desktop.windows-choose-options %} -{% data reusables.desktop.windows-select-accounts %} -{% data reusables.desktop.choose-product-authenticate %} -5. Para adicionar uma conta do GitHub Enterprise, digite suas credenciais em "Enterprise server address" (Endereço do servidor Enterprise) e clique em **Continue** (Continuar). ![Botão Sign In (Entrar) do GitHub Enterprise](/assets/images/help/desktop/windows-sign-in-button-enterprise.png) -6. Para adicionar uma conta do GitHub, digite as credenciais do GitHub.com e clique em **Sign in** (Entrar). ![Botão Sign In (Entrar) do GitHub](/assets/images/help/desktop/windows-sign-in-button.png) -{% data reusables.desktop.retrieve-2fa %} -{% data reusables.desktop.return-to-desktop %} No prompt, insira seu código 2FA e clique em **Sign in** (Entrar). ![Solicitação do código 2FA](/assets/images/help/desktop/windows-2fa-code-prompt.png) - -{% endwindows %} diff --git a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/configuring-a-default-editor.md b/translations/pt-BR/content/desktop/getting-started-with-github-desktop/configuring-a-default-editor.md deleted file mode 100644 index 1b1b2a3da79b..000000000000 --- a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/configuring-a-default-editor.md +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: Configurar o editor padrão -intro: Você pode configurar o GitHub Desktop para abrir arquivos em seu projeto com seu editor de texto preferido ou ambiente de desenvolvimento integrado (IDE). -versions: - free-pro-team: '*' ---- - -### Editores compatíveis - -O {% data variables.product.prodname_desktop %} é compatível com os seguintes editores. - -{% mac %} - -- [Atom](https://atom.io/) -- [MacVim](https://macvim-dev.github.io/macvim/) -- [Visual Studio Code](https://code.visualstudio.com/) -- [Visual Studio Codium](https://vscodium.com/) -- [Sublime Text](https://www.sublimetext.com/) -- [BBEdit](http://www.barebones.com/products/bbedit/) -- [JetBrains WebStorm](https://www.jetbrains.com/webstorm/) -- [JetBrains PhpStorm](https://www.jetbrains.com/phpstorm/) -- [JetBrains Rider](https://www.jetbrains.com/rider/) -- [JetBrains PyCharm](https://www.jetbrains.com/pycharm/) -- [JetBrains RubyMine](https://www.jetbrains.com/rubymine/) -- [JetBrains IntelliJ IDEA](https://www.jetbrains.com/idea/) -- [JetBrains GoLand](https://www.jetbrains.com/go/) -- [TextMate](https://macromates.com/) -- [Brackets](http://brackets.io/) - - Para usar Brackets com {% data variables.product.prodname_desktop %}, você deve instalar o atalho da Linha de Comando. Para instalar o atalho, abra o Brackets, clique em **Arquivo** na barra de menu e, em seguida, clique em **Instalar atalho da linha de comando**. -- [Typora](https://typora.io/) -- [CodeRunner](https://coderunnerapp.com/) -- [SlickEdit](https://www.slickedit.com/) -- [Xcode](https://developer.apple.com/xcode/) -- [Android Studio](https://developer.android.com/studio) - -{% endmac %} - -{% windows %} - -- [Atom](https://atom.io/) -- [Visual Studio Code](https://code.visualstudio.com/) -- [Visual Studio Codium](https://vscodium.com/) -- [Sublime Text](https://www.sublimetext.com/) -- [ColdFusion Builder](https://www.adobe.com/products/coldfusion-builder.html) -- [Typora](https://typora.io/) -- [SlickEdit](https://www.slickedit.com/) -- [JetBrains WebStorm](https://www.jetbrains.com/webstorm/) -- [JetBrains PhpStorm](https://www.jetbrains.com/phpstorm/) -- [JetBrains Rider](https://www.jetbrains.com/rider/) -- [Notepad++](https://notepad-plus-plus.org/) - -{% endwindows %} - -### Configurar o editor padrão - -{% mac %} - -{% data reusables.desktop.mac-select-desktop-menu %} -3. Na janela preferências, selecione **Integrações**. ![O painel integrações na janela preferências](/assets/images/help/desktop/mac-select-integrations-pane.png) -4. Use o menu suspenso "Editor externo" e escolha o editor que deseja definir como padrão. ![Menu External editor (Editor externo) na barra de menus Preferences (Preferências)](/assets/images/help/desktop/mac-editor-menu.png) -5. Clique em **Save** (Salvar). - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.windows-choose-options %} -3. Na janela opções, selecione **Integrações**. ![O painel de integrações na janela opções](/assets/images/help/desktop/windows-select-integrations-pane.png) -4. Use o menu suspenso "Editor externo" e escolha o editor que deseja definir como padrão. ![Menu External editor (Editor externo) na barra de menus Options (Opções)](/assets/images/help/desktop/windows-editor-menu.png) -5. Clique em **Save** (Salvar). - -{% endwindows %} diff --git a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/configuring-and-customizing-github-desktop.md b/translations/pt-BR/content/desktop/getting-started-with-github-desktop/configuring-and-customizing-github-desktop.md deleted file mode 100644 index c0a5c6b1d1f5..000000000000 --- a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/configuring-and-customizing-github-desktop.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: Configurar e personalizar o GitHub Desktop -intro: 'Configure o Git, conecte o seu editor-padrão e personalize as configurações para alinhar o GitHub Desktop com seu fluxo de trabalho.' -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/configuring-basic-settings.md b/translations/pt-BR/content/desktop/getting-started-with-github-desktop/configuring-basic-settings.md deleted file mode 100644 index 738afbe6b904..000000000000 --- a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/configuring-basic-settings.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: Definir configurações básicas -intro: 'É possível acessar as configurações para proteger a privacidade, conectar contas ao GitHub Desktop e configurar o Git.' -versions: - free-pro-team: '*' ---- - -{% mac %} - -{% data reusables.desktop.mac-select-desktop-menu %} -3. Para visualizar ou alterar as suas configurações, alterne entre os painéis a seguir: ![Navegação no menu Preferences (Preferências)](/assets/images/help/desktop/mac-select-accounts-pane.png) -{% data reusables.desktop.preferences-options-tabs %} - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.windows-choose-options %} -2. Para visualizar ou alterar as suas configurações, alterne entre os painéis a seguir: ![Navegação no menu Options (Opções)](/assets/images/help/desktop/windows-select-accounts-pane.png) -{% data reusables.desktop.preferences-options-tabs %} - -{% endwindows %} - -### Further reading - -- "[Configurar tema para o {% data variables.product.prodname_desktop %}](/desktop/guides/getting-started-with-github-desktop/setting-a-theme-for-github-desktop)" diff --git a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/configuring-git-for-github-desktop.md b/translations/pt-BR/content/desktop/getting-started-with-github-desktop/configuring-git-for-github-desktop.md deleted file mode 100644 index 37c10dc7c09f..000000000000 --- a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/configuring-git-for-github-desktop.md +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: Configurar o Git para o GitHub Desktop -shortTitle: Configurar o Git -intro: 'Caso ainda não tenha o Git instalado, configure-o antes de usar o GitHub Desktop.' -versions: - free-pro-team: '*' ---- - -{% data variables.product.prodname_desktop %} usa o endereço de e-mail que você definiu na configuração local do Git para conectar commits à sua conta no {% data variables.product.product_name %}. - -{% data reusables.desktop.update-email-address %} - -{% tip %} - -**Dica**: Qualquer pessoa poderá ver o endereço de e-mail na configuração do seu Git se fizer commits públicos. Para obter mais informações, consulte "[Configurar o endereço de e-mail do commit](/articles/setting-your-commit-email-address/)"; - -{% endtip %} - -{% mac %} - -{% data reusables.desktop.sign-in-choose-product %} -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.emails %} -{% data reusables.desktop.copy-email-git-config %} -{% data reusables.desktop.return-to-desktop %} -{% data reusables.desktop.mac-select-desktop-menu %} -7. Na janela de Preferências, clique em **Git**. ![O Painel Git no menu Preferences (Preferências)](/assets/images/help/desktop/mac-select-git-pane.png) -{% data reusables.desktop.name-field-git-config %} - ![O campo de nome da configuração do Git](/assets/images/help/desktop/mac-name-git-config.png) -{% data reusables.desktop.paste-email-git-config %} - ![Endereço de e-mail colado no campo de configuração do Git](/assets/images/help/desktop/mac-email-git-config.png) -{% data reusables.desktop.click-save-git-config %} - ![Botão para salvar no campo de configuração do Git](/assets/images/help/desktop/mac-save-git-config.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.sign-in-choose-product %} -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.emails %} -{% data reusables.desktop.copy-email-git-config %} -{% data reusables.desktop.return-to-desktop %} -{% data reusables.desktop.windows-choose-options %} -8. Na janela de Opções, clique em **Git**. ![O Painel Git no menu Options (Opções)](/assets/images/help/desktop/windows-select-git-pane.png) -{% data reusables.desktop.name-field-git-config %} - ![O campo de nome da configuração do Git](/assets/images/help/desktop/windows-name-git-config.png) -{% data reusables.desktop.paste-email-git-config %} - ![Endereço de e-mail colado no campo de configuração do Git](/assets/images/help/desktop/windows-email-git-config.png) -{% data reusables.desktop.click-save-git-config %} - ![Botão para salvar no campo de configuração do Git](/assets/images/help/desktop/windows-save-git-config.png) - -{% endwindows %} - -### Further reading - -- "[Adicionar um endereço de e-mail à conta do GitHub](/articles/adding-an-email-address-to-your-github-account/)" -- "[Configurar o endereço de e-mail do commit no Git](/articles/setting-your-commit-email-address/)" diff --git a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/creating-your-first-repository-using-github-desktop.md b/translations/pt-BR/content/desktop/getting-started-with-github-desktop/creating-your-first-repository-using-github-desktop.md deleted file mode 100644 index 60232a17d5b2..000000000000 --- a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/creating-your-first-repository-using-github-desktop.md +++ /dev/null @@ -1,98 +0,0 @@ ---- -title: Criar o primeiro repositório usando o GitHub Desktop -intro: 'Você pode usar o {% data variables.product.prodname_desktop %} para começar a trabalhar com um repositório Git sem depender da linha de comando.' -versions: - free-pro-team: '*' ---- - -### Introdução - -Este guia documenta o processo de uso do {% data variables.product.prodname_desktop %} para trabalhar em um repositório Git. O {% data variables.product.prodname_desktop %} amplia e simplifica o fluxo de trabalho no {% data variables.product.prodname_dotcom_the_website %} com uma interface visual, em vez de comandos de texto na linha de comando. Ao fim da leitura deste guia, você terá usado o {% data variables.product.prodname_desktop %} para criar um repositório, alterá-lo e publicar as alterações no {% data variables.product.prodname_dotcom_the_website %} ou no {% data variables.product.prodname_ghe_server %}. - -Depois de baixar o {% data variables.product.prodname_desktop %} e entrar no {% data variables.product.prodname_dotcom %} ou {% data variables.product.prodname_enterprise %}, você pode criar e clonar um repositório de tutorial. O tutorial apresentará os conceitos básicos de trabalhar com o Git e o {% data variables.product.prodname_dotcom %}, incluindo instalar um editor, criar um branch, fazer um commit, enviar para o {% data variables.product.prodname_dotcom_the_website %} e criar uma pull request. O tutorial será disponibilizado desde que você ainda não tenha repositórios no {% data variables.product.prodname_desktop %}. - -### Etapa 1. Instalar e entrar no {% data variables.product.prodname_desktop %} - -1. Baixe o {% data variables.product.prodname_desktop %} em {% data variables.product.desktop_link %}. O {% data variables.product.prodname_desktop %} dá suporte às versões mais recentes do Windows e do Mac. Para obter as instruções específicas de instalação no seu sistema operacional, consulte "[Instalar o {% data variables.product.prodname_desktop %}](/desktop/getting-started-with-github-desktop/installing-github-desktop)." - -2. Inicie o {% data variables.product.prodname_desktop %} e siga o fluxo inicial de boas-vindas para acessar sua conta do {% data variables.product.product_name %}. Na etapa "Configure Git" (Configurar Git), será possível definir seu nome e endereço de e-mail. Para garantir a atribuição adequada dos commits à sua conta do {% data variables.product.product_name %}, use o endereço de e-mail associado à conta do {% data variables.product.product_name %}. Para obter mais informações sobre a atribuição de commits, consulte "[Configurar o endereço de e-mail do commit](/articles/setting-your-commit-email-address)". - -### Etapa 2. Criar um repositório - -Você verá uma exibição "Let's get started!" (Vamos começar!), onde é possível optar por criar e clonar um repositório de tutorial, clonar um repositório existente, criar um repositório ou adicionar um repositório existente. - -#### Criar e clonar um repositório de tutorial - -1. Clique em **Create a tutorial repository and clone it** (Criar um repositório de tutorial e cloná-lo). ![Botão Create and clone a tutorial repository (Criar e clonar um repositório de tutorial)](/assets/images/help/desktop/getting-started-guide/create-and-clone-a-tutorial-repository.png) -2. Siga as solicitações no tutorial. - -#### Criar um repositório - -1. Clique em **Create a New Repository on your hard drive** (Criar um repositório no disco rígido). ![Criar um repositório](/assets/images/help/desktop/getting-started-guide/creating-a-repository.png) -2. Para criar um novo repositório, preencha os campos: ![Opções de criar um repositório](/assets/images/help/desktop/getting-started-guide/create-a-new-repository-options.png) - - "Name" (Nome) define o nome do repositório no local e no {% data variables.product.product_name %}. - - "Description" (Descrição) é um campo opcional com mais informações sobre o propósito do repositório. - - "Local path" (Caminho local) define o local do repositório no computador. Por padrão, o {% data variables.product.prodname_desktop %} cria uma pasta _GitHub_ dentro da pasta _Documents_ (Documentos) para armazenar seus repositórios, mas é possível escolher qualquer local no computador. O novo repositório será uma pasta dentro do local escolhido. Por exemplo, se você nomear o repositório como `Tutorial`, será criada uma pasta de nome _Tutorial_ dentro da pasta no caminho selecionado. O {% data variables.product.prodname_desktop %} registra o local escolhido para as próximas vezes que você criar ou clonar repositórios. - - A opção **Initialize this repository with a README** (Inicializar este repositório com um LEIAME) cria o commit com um arquivo _LEIAME.md_. Arquivos LEIAME ajudam as pessoas a entenderem o objetivo do seu projeto. Portanto, é recomendável usar esse item e adicionar informações úteis a ele. Quando alguém acessar seu repositório no {% data variables.product.product_name %}, a primeira informação exibida será o LEIAME. Para obter mais informações, consulte "[Sobre LEIAME](/articles/about-readmes)". - - O menu suspenso **Git ignore** (Git para ignorar) permite incluir um arquivo personalizado para ignorar determinados arquivos no repositório local, isto é, informações que você não quer armazenar no controle de versão. Se houver uma linguagem ou framework específico para uso, você poderá selecionar uma opção na lista disponível. Se você estiver começando agora, fique à vontade para ignorar essa opção. Para obter mais informações, consulte "[Ignorar arquivos](/articles/ignoring-files)". - - O menu suspenso **License** (Licença) permite adicionar uma licença de código aberto a um arquivo _LICENSE_ no repositório. Não se preocupe em adicionar uma licença de imediato. Para obter mais informações sobre as licenças de código aberto disponíveis e sobre como adicioná-las ao repositório, consulte "[Criar a licença de um repositório](/articles/licensing-a-repository)." -3. Clique em **Create Repository** (Criar repositório). - -### Etapa 3. Explorar o {% data variables.product.prodname_desktop %} - -Agora que você criou um repositório, o menu de arquivos aparecerá na parte superior da tela. É nele que você pode acessar as configurações e ações possíveis no {% data variables.product.prodname_desktop %}. A maioria das ações tem atalhos de teclado para aumentar a eficiência do seu trabalho. Para obter uma lista completa de atalhos de teclado, consulte "[Atalhos de teclado](/desktop/getting-started-with-github-desktop/keyboard-shortcuts)". - -1. Abaixo do menu, uma barra mostra o estado atual do repositório no {% data variables.product.prodname_desktop %}: - - **Current repository** (Repositório atual) mostra o nome do repositório em que você está trabalhando. Você pode clicar em **Current repository** (Repositório atual) para alternar entre repositórios no {% data variables.product.prodname_desktop %}. - - **Current branch** (Branch atual) mostra o nome do branch em que você está trabalhando. Você pode clicar em **Current branch** (Branch atual) para exibir todos os branches do repositório, alternar entre branches ou criar um branch. Depois de criar pull requests no repositório, você também poderá exibi-las clicando em **Current branch** (Branch atual). - - A opção **Publish repository** (Publicar repositório) aparece porque você ainda não publicou o repositório no {% data variables.product.product_name %}. A publicação será feita depois, em outra etapa. - - ![Explorar o GitHub Desktop](/assets/images/help/desktop/getting-started-guide/explore-github-desktop.png) - -2. Na barra lateral à esquerda, você verá **Changes** (Alterações) e **History** (Histórico). - - - A opção **Changes** (Alterações) mostra as mudanças que você fez nos arquivos do branch atual, mas que ainda estão sem commit no repositório local. Na parte inferior, você verá as caixas "Summary" (Resumo) e "Description" (Descrição), além do botão **Commit to master** (Fazer commit para o mestre). É nessa área que você fará o commit das novas alterações. O botão **Commit** (Fazer commit) mostra para qual branch você fará o commit das alterações. ![Área do commit](/assets/images/help/desktop/getting-started-guide/commit-area.png) - - - A opção **History** (Histórico) mostra os commits anteriores no branch atual do repositório. Provavelmente você verá um "Initial commit" (Commit inicial) criado pelo {% data variables.product.prodname_desktop %} quando você criou o repositório. À direita do commit, dependendo das opções escolhidas durante a criação do repositório, você poderá ver arquivos _.gitattributes_, _.gitignore_, _LICENÇA_ ou _LEIAME_. Ao clicar em cada arquivo você verá o diff, que consiste no registro das alterações feitas no arquivo do commit em questão. O diff não mostra todo o conteúdo do arquivo, mas somente as partes que foram alteradas. ![Exibição de histórico](/assets/images/help/desktop/getting-started-guide/history-view.png) - -### Etapa 4. Fazer push do repositório para o {% data variables.product.product_name %} - -No momento, o repositório só existe no seu computador e somente você pode acessá-lo. Publicar o repositório no {% data variables.product.product_name %} vai mantê-lo sincronizado em vários computadores e para todos os integrantes das equipes do projeto em questão. Para publicar o repositório, você fará o "push" dele no {% data variables.product.product_name %}, o que também o deixará disponível no {% data variables.product.prodname_dotcom_the_website %}. - -1. Clique em **Publish repository** (Publicar repositório). ![Publicar repositório](/assets/images/help/desktop/getting-started-guide/publish-repository.png) - - Você verá alguns campos familiares. "Name" (Nome) e "Description" (Descrição) são os mesmos que você preencheu ao criar o repositório. - - Você verá a opção **Keep this code private** (Manter este código privado). Selecione-a se não quiser compartilhar seu código publicamente com outros usuários no {% data variables.product.product_name %}. - - A opção suspensa **Organization** (Organização), se houver, permite publicar o repositório em uma organização específica a que você pertença no {% data variables.product.product_name %}. Não tem problema se você ainda não for integrante de uma organização. ![Etapas para publicar repositório](/assets/images/help/desktop/getting-started-guide/publish-repository-steps.png) -2. Clique em **Publish repository** (Publicar repositório). -3. É possível acessar o repositório no {% data variables.product.prodname_dotcom %} pelo {% data variables.product.prodname_desktop %}. No menu do arquivo, clique em **Repository** (Repositório) e em **View on GitHub** (Exibir no GitHub). Fazer isso levará você diretamente para o repositório no seu navegador padrão. - -Agora que o repositório foi publicado, vamos voltar ao {% data variables.product.prodname_desktop %} e fazer mais alterações no repositório local. Começaremos mostrando como configurar um editor de texto padrão. - -### Etapa 5. Configurar um editor de texto - -Para reduzir o tempo de configuração do ambiente de desenvolvimento, é possível iniciar vários editores de texto e ambientes de desenvolvimento integrado (IDE) diretamente no {% data variables.product.prodname_desktop %}. Em um repositório no {% data variables.product.prodname_desktop %}, você pode abrir a pasta do projeto no seu editor de texto favorito. - -1. Clique em **File** (Arquivo), **Options** (Opções) e **Advanced** (Avançado). -2. Use o menu suspenso **External editor** (Editor externo) e selecione um editor. A lista mostrará todos os editores instalados. Se a lista estiver vazia, instale um editor compatível, como o [Atom](https://atom.io). Para obter uma lista dos editores compatíveis, consulte a integração ["Abrir editores externos" ](https://github.com/desktop/desktop/blob/development/docs/technical/editor-integration.md#windows) no repositório do {% data variables.product.prodname_desktop %}. ![Editor externo](/assets/images/help/desktop/mac-editor-menu.png) -3. Caso tenha instalado um editor, reinicie o {% data variables.product.prodname_desktop %} para fazê-lo aparecer na lista suspensa **External editor** (Editor externo). - -### Etapa 6. Fazer commit e push das alterações - -Agora que você configurou um editor padrão, será possível fazer alterações no projeto e começar a criar seu primeiro commit no repositório. - -1. Para iniciar o editor externo pelo {% data variables.product.prodname_desktop %}, clique em **Repository** (Repositório) e em **Open in EDITOR** (Abrir no EDITOR). ![Abrir no editor](/assets/images/help/desktop/getting-started-guide/open-in-editor.png) - -2. Comece fazendo algumas alterações no arquivo _README.md_ criado anteriormente. Adicione informações que descrevam o projeto, como a função, a relevância e a utilidade dele. Lembre-se de que esta será a primeira interação das pessoas com o seu projeto. Depois disso, estará tudo pronto para fazer o seu primeiro commit! -3. Saia do editor de texto, volte para o {% data variables.product.prodname_desktop %} e navegue até a guia **Changes** (Alterações). Na lista de arquivos, você verá o _README.md_ alterado. A marca de verificação no arquivo _README.md_ indica que as alterações feitas serão parte do seu commit. Talvez você queira fazer alterações em vários arquivos no futuro, mas sem fazer o commit das alterações de todos eles. O {% data variables.product.prodname_desktop %} permite selecionar somente as alterações que você pretende incluir no commit. ![Exibir alterações](/assets/images/help/desktop/getting-started-guide/viewing-changes.png) - -4. Na parte inferior da lista **Changes** (Alterações), adicione uma mensagem ao commit. À direita da sua foto de perfil, digite uma breve descrição do commit. Já que estamos alterando o arquivo _README.md_, algo como "Adicionar informações sobre o propósito do projeto" seria um bom resumo. Abaixo do resumo, o campo de texto "Description" (Descrição) permite digitar uma descrição mais longa das alterações feitas no commit. Essa descrição pode ser útil para analisar o histórico de um projeto e entender o motivo das alterações. Como estamos fazendo uma atualização básica do arquivo _README.md_, fique à vontade para ignorar a descrição. ![Mensagem do commit](/assets/images/help/desktop/getting-started-guide/commit-message.png) -5. Clique em **Commit to master** (Fazer commit para o mestre). O botão do commit mostra o branch atual (`mestre`, neste caso) para que você tenha certeza de fazer commit para o branch desejado. ![Fazer commit para o mestre](/assets/images/help/desktop/getting-started-guide/click-commit-to-master.png) -6. Para fazer push das alterações no repositório remote no {% data variables.product.product_name %}, clique em **Push origin** (Fazer push da origem). ![Fazer push de origem](/assets/images/help/desktop/getting-started-guide/push-to-origin.png) - - Você se lembra do botão **Publish** (Publicar) usado para publicar o repositório no {% data variables.product.product_name %}? Agora, ele deve mostrar `Push origin` (Fazer push da origem) com um número `1` ao lado, indicando que ainda não foi feito o push de um commit para o {% data variables.product.product_name %}. - - O termo "origem" na opção **Push origin** (Fazer push da origem) indica que estamos fazendo push das alterações para o remote chamado `origem` que, neste caso, é o repositório do seu projeto no {% data variables.product.prodname_dotcom_the_website %}. Até você fazer o push de qualquer commit para o {% data variables.product.product_name %}, haverá diferenças entre o repositório do seu projeto no computador e o repositório do seu projeto no {% data variables.product.prodname_dotcom_the_website %}. Assim, você pode trabalhar no local e deixar para fazer push do seu trabalho no {% data variables.product.prodname_dotcom_the_website %} quando estiver tudo pronto. -7. Na área aberta ao lado da guia **Changes** (Alterações), você verá uma série de sugestões das suas próximas ações. Para abrir o repositório no {% data variables.product.product_name %} no navegador, clique em **View on GitHub** (Exibir no GitHub). ![Exibir no GitHub](/assets/images/help/desktop/getting-started-guide/view-on-github.png) -8. No navegador, clique em **2 commits**. Você verá uma lista dos commits neste repositório no {% data variables.product.product_name %}. O primeiro commit deve ser o que você acabou de fazer no {% data variables.product.prodname_desktop %}! ![Clicar em dois commits](/assets/images/help/desktop/getting-started-guide/click-two-commits.png) - -### Conclusão - -Parabéns! Você acabou de criar e publicar um repositório no {% data variables.product.product_name %}, e também fez um commit e fez push das alterações. Isso é apenas o começo! Você pode fazer muito mais com o {% data variables.product.product_name %} e o {% data variables.product.prodname_desktop %}. Esperamos que esse exercício estimule a sua vontade de conhecer ainda mais nossos recursos e possibilidades. diff --git a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/index.md b/translations/pt-BR/content/desktop/getting-started-with-github-desktop/index.md deleted file mode 100644 index c12b336f8a88..000000000000 --- a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/index.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: Introdução ao GitHub Desktop -shortTitle: Guia de Introdução -intro: 'Configure o GitHub Desktop para gerenciar o trabalho no seu projeto. Faça a autenticação no GitHub.com ou no GitHub Enterprise Server, mantenha o aplicativo atualizado e revise suas configurações preferenciais.' -redirect_from: - - /desktop/getting-started-with-github-desktop/setting-up-github-desktop/ -versions: - free-pro-team: '*' ---- - - -### Índice - -{% topic_link_in_list /overview %} - {% link_in_list /creating-your-first-repository-using-github-desktop %} - {% link_in_list /keyboard-shortcuts %} - {% link_in_list /launching-github-desktop-from-the-command-line %} -{% topic_link_in_list /installing-and-authenticating-to-github-desktop %} - {% link_in_list /installing-github-desktop %} - {% link_in_list /authenticating-to-github %} - {% link_in_list /about-the-github-desktop-windows-installer-package %} - {% link_in_list /updating-github-desktop %} - {% link_in_list /uninstalling-github-desktop %} -{% topic_link_in_list /configuring-and-customizing-github-desktop %} - {% link_in_list /configuring-basic-settings %} - {% link_in_list /configuring-git-for-github-desktop %} - {% link_in_list /configuring-a-default-editor %} - {% link_in_list /setting-a-theme-for-github-desktop %} diff --git a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/installing-and-authenticating-to-github-desktop.md b/translations/pt-BR/content/desktop/getting-started-with-github-desktop/installing-and-authenticating-to-github-desktop.md deleted file mode 100644 index 3bf19e603d5b..000000000000 --- a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/installing-and-authenticating-to-github-desktop.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: Instalar e efetuar a autenticação no GitHub Desktop -intro: Instale o GitHub Desktop e conecte suas contas do GitHub ou do GitHub Enterprise. -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/installing-github-desktop.md b/translations/pt-BR/content/desktop/getting-started-with-github-desktop/installing-github-desktop.md deleted file mode 100644 index 936f55c7db4a..000000000000 --- a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/installing-github-desktop.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: Instalar o GitHub Desktop -intro: É possível instalar o GitHub Desktop nos sistemas operacionais Microsoft Windows ou macOS suportados. -versions: - free-pro-team: '*' ---- - -Antes de configurar o {% data variables.product.prodname_desktop %}, {% data reusables.desktop.get-an-account %} - -### Baixar e instalar o {% data variables.product.prodname_desktop %} - -{% mac %} - -Você pode instalar o {% data variables.product.prodname_desktop %} nas versões {% data variables.desktop.mac-osx-versions %}. - -{% data reusables.desktop.download-desktop-page %} -2. Escolha a opção **Download for Mac** (Baixar para Mac). -3. Na pasta **Downloads** do computador, clique duas vezes no arquivo zip **{% data variables.product.prodname_desktop %}**. -4. Depois de descompatar o arquivo zip, clique duas vezes no **{% data variables.product.prodname_desktop %}**. - -{% endmac %} - -{% windows %} - -Você pode instalar o {% data variables.product.prodname_desktop %} nas versões {% data variables.desktop.windows-versions %}. - -{% warning %} - -**Aviso**: para executar o {% data variables.product.prodname_desktop %}, o sistema operacional deve ter 64 bits. - -{% endwarning %} - -{% data reusables.desktop.download-desktop-page %} -2. Escolha a opção **Download for Windows** (Baixar para Windows). - - {% note %} - - **Observação:** administradores de rede podem usar o [ pacote Windows Installer do {% data variables.product.prodname_desktop %}](/desktop/guides/getting-started-with-github-desktop/about-the-github-desktop-windows-installer-package/) para implantar o {% data variables.product.prodname_desktop %}. - - {% endnote %} - -3. Na pasta de **Downloads** do computador, clique duas vezes no **{% data variables.product.prodname_desktop %}**. -4. Na janela pop-up, clique em **Install** (Instalar). -5. Após a instalação do programa, clique em **Run** (Executar). - -{% endwindows %} - -### Configurar o {% data variables.product.prodname_desktop %} - -É possível configurar o {% data variables.product.prodname_desktop %} logo após iniciar o {% data variables.product.prodname_desktop %}, mas você também pode ignorar o processo de configuração. diff --git a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/keyboard-shortcuts-in-github-desktop.md b/translations/pt-BR/content/desktop/getting-started-with-github-desktop/keyboard-shortcuts-in-github-desktop.md deleted file mode 100644 index 53a6650f66ce..000000000000 --- a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/keyboard-shortcuts-in-github-desktop.md +++ /dev/null @@ -1,115 +0,0 @@ ---- -title: Atalhos de teclado no GitHub Desktop -intro: 'É possível usar atalhos de teclado no {% data variables.product.prodname_desktop %}.' -versions: - free-pro-team: '*' ---- - -{% mac %} - -Atalhos de teclado do GitHub Desktop no macOS - -### Atalhos para o site - -| Atalho | Descrição | -| ------------------------------------ | -------------------------------------------------------------------------- | -| ⌘, | Ir para Preferences (Preferências) | -| ⌘H | Ocultar o aplicativo do {% data variables.product.prodname_desktop %} | -| ⌥⌘H | Ocultar todos os outros aplicativos | -| ⌘Q | Sair do {% data variables.product.prodname_desktop %} | -| ⌃⌘F | Alternar a exibição em tela cheia | -| ⌘0 | Redefinir o zoom para o tamanho de texto padrão | -| ⌘= | Aumentar o zoom em textos e imagens | -| ⌘- | Diminuir o zoom em textos e imagens | -| ⌥⌘I | Alternar as ferramentas de desenvolvedor | - -### Repositórios - -| Atalho | Descrição | -| ------------------------------------ | ------------------------------------------------------------------------------------- | -| ⌘N | Adicionar um novo repositório | -| ⌘O | Adicionar um repositório local | -| ⇧⌘O | Clonar um repositório do {% data variables.product.prodname_dotcom %} | -| ⌘T | Exibir uma lista dos repositórios | -| ⌘P | Usar os commits mais recentes do {% data variables.product.prodname_dotcom %} | -| ⇧⌘P | Usar as alterações mais recentes do {% data variables.product.prodname_dotcom %} | -| ⌘⌫ | Remover um repositório | -| ⇧⌘G | Exibir o repositório no {% data variables.product.prodname_dotcom %} | -| ⌃` | Abrir o repositório na sua ferramenta de terminal preferida | -| ⇧⌘F | Exibir o repositório no Localizador | -| ⇧⌘A | Abrir o repositório na sua ferramenta de edição preferida | -| ⌘I | Criar um problema em {% data variables.product.prodname_dotcom %} | - -### Branches - -| Atalho | Descrição | -| ------------------------------------ | -------------------------------------------------------------------------------- | -| ⌘1 | Exibir todas as alterações antes de fazer o commit | -| ⌘2 | Exibir o histórico de commits | -| ⌘B | Exibir todos os branches | -| ⌘G | Ir para o campo de resumo de commits | -| space (Espaço) | Selecione ou desmarque todos os arquivos destacados | -| ⇧⌘N | Criar um branch | -| ⇧⌘R | Renomear o branch atual | -| ⇧⌘D | Excluir o branch atual | -| ⇧⌘U | Atualizar o branch padrão | -| ⇧⌘B | Comparar a outro branch | -| ⇧⌘M | Fazer um merge com o branch atual | -| ⌃H | Exibir ou ocultar alterações stashed | -| ⇧⌘C | Comparar branches no {% data variables.product.prodname_dotcom %} | -| ⌘R | Exibir a pull request atual no {% data variables.product.prodname_dotcom %} | - -{% endmac %} - -{% windows %} - -Atalhos de teclado do GitHub Desktop no Windows - -### Atalhos para o site - -| Atalho | Descrição | -| ------------------------------------------- | ----------------------------------------------- | -| Ctrl, | Ir para Opções | -| F11 | Alternar a exibição em tela cheia | -| Ctrl0 | Redefinir o zoom para o tamanho de texto padrão | -| Ctrl= | Aumentar o zoom em textos e imagens | -| Ctrl- | Diminuir o zoom em textos e imagens | -| CtrlShiftI | Alternar as ferramentas de desenvolvedor | - -### Repositórios - -| Atalho de teclado | Descrição | -| ------------------------------------------- | ------------------------------------------------------------------------------------- | -| CtrlN | Adicionar um novo repositório | -| CtrlO | Adicionar um repositório local | -| CtrlShiftO | Clonar um repositório do {% data variables.product.prodname_dotcom %} | -| CtrlT | Exibir uma lista dos repositórios | -| CtrlP | Usar os commits mais recentes do {% data variables.product.prodname_dotcom %} | -| CtrlShiftP | Usar as alterações mais recentes do {% data variables.product.prodname_dotcom %} | -| CtrlDelete | Remover um repositório | -| CtrlShiftG | Exibir o repositório no {% data variables.product.prodname_dotcom %} | -| Ctrl` | Abrir o repositório na sua ferramenta de linha de comando preferida | -| CtrlShiftF | Exibir o repositório no Explorador | -| CtrlShiftA | Abrir o repositório na sua ferramenta de edição preferida | -| CtrlI | Criar um problema em {% data variables.product.prodname_dotcom %} | - -### Branches - -| Atalho | Descrição | -| ------------------------------------------- | -------------------------------------------------------------------------------- | -| Ctrl1 | Exibir todas as alterações antes de fazer o commit | -| Ctrl2 | Exibir o histórico de commits | -| CtrlB | Exibir todos os branches | -| CtrlG | Ir para o campo de resumo de commits | -| space (Espaço) | Selecionar ou desmarque todos os arquivos destacados | -| CtrlShiftN | Criar um branch | -| CtrlShiftR | Renomear o branch atual | -| CtrlShiftD | Excluir o branch atual | -| CtrlShiftU | Atualizar o branch padrão | -| CtrlShiftB | Comparar a outro branch | -| CtrlShiftM | Fazer um merge com o branch atual | -| CtrlH | Exibir ou ocultar alterações stashed | -| CtrlShiftC | Comparar branches no {% data variables.product.prodname_dotcom %} | -| CtrlR | Exibir a pull request atual no {% data variables.product.prodname_dotcom %} | - -{% endwindows %} diff --git a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/keyboard-shortcuts.md b/translations/pt-BR/content/desktop/getting-started-with-github-desktop/keyboard-shortcuts.md deleted file mode 100644 index 2858bd1e48a5..000000000000 --- a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/keyboard-shortcuts.md +++ /dev/null @@ -1,117 +0,0 @@ ---- -title: Atalhos de teclado -redirect_from: - - /desktop/getting-started-with-github-desktop/keyboard-shortcuts-in-github-desktop/ -intro: 'É possível usar atalhos de teclado no {% data variables.product.prodname_desktop %}.' -versions: - free-pro-team: '*' ---- - -{% mac %} - -Atalhos de teclado do GitHub Desktop no macOS - -### Atalhos para o site - -| Atalho | Descrição | -| ------------------------------------ | -------------------------------------------------------------------------- | -| ⌘, | Ir para Preferences (Preferências) | -| ⌘H | Ocultar o aplicativo do {% data variables.product.prodname_desktop %} | -| ⌥⌘H | Ocultar todos os outros aplicativos | -| ⌘Q | Sair do {% data variables.product.prodname_desktop %} | -| ⌃⌘F | Alternar a exibição em tela cheia | -| ⌘0 | Redefinir o zoom para o tamanho de texto padrão | -| ⌘= | Aumentar o zoom em textos e imagens | -| ⌘- | Diminuir o zoom em textos e imagens | -| ⌥⌘I | Alternar as ferramentas de desenvolvedor | - -### Repositórios - -| Atalho | Descrição | -| ------------------------------------ | ------------------------------------------------------------------------------------- | -| ⌘N | Adicionar um novo repositório | -| ⌘O | Adicionar um repositório local | -| ⇧⌘O | Clonar um repositório do {% data variables.product.prodname_dotcom %} | -| ⌘T | Exibir uma lista dos repositórios | -| ⌘P | Usar os commits mais recentes do {% data variables.product.prodname_dotcom %} | -| ⇧⌘P | Usar as alterações mais recentes do {% data variables.product.prodname_dotcom %} | -| ⌘⌫ | Remover um repositório | -| ⇧⌘G | Exibir o repositório no {% data variables.product.prodname_dotcom %} | -| ⌃` | Abrir o repositório na sua ferramenta de terminal preferida | -| ⇧⌘F | Exibir o repositório no Localizador | -| ⇧⌘A | Abrir o repositório na sua ferramenta de edição preferida | -| ⌘I | Criar um problema em {% data variables.product.prodname_dotcom %} | - -### Branches - -| Atalho | Descrição | -| ------------------------------------ | -------------------------------------------------------------------------------- | -| ⌘1 | Exibir todas as alterações antes de fazer o commit | -| ⌘2 | Exibir o histórico de commits | -| ⌘B | Exibir todos os branches | -| ⌘G | Ir para o campo de resumo de commits | -| space (Espaço) | Selecione ou desmarque todos os arquivos destacados | -| ⇧⌘N | Criar um branch | -| ⇧⌘R | Renomear o branch atual | -| ⇧⌘D | Excluir o branch atual | -| ⇧⌘U | Atualizar o branch padrão | -| ⇧⌘B | Comparar a outro branch | -| ⇧⌘M | Fazer um merge com o branch atual | -| ⌃H | Exibir ou ocultar alterações stashed | -| ⇧⌘C | Comparar branches no {% data variables.product.prodname_dotcom %} | -| ⌘R | Exibir a pull request atual no {% data variables.product.prodname_dotcom %} | - -{% endmac %} - -{% windows %} - -Atalhos de teclado do GitHub Desktop no Windows - -### Atalhos para o site - -| Atalho | Descrição | -| ------------------------------------------- | ----------------------------------------------- | -| Ctrl, | Ir para Opções | -| F11 | Alternar a exibição em tela cheia | -| Ctrl0 | Redefinir o zoom para o tamanho de texto padrão | -| Ctrl= | Aumentar o zoom em textos e imagens | -| Ctrl- | Diminuir o zoom em textos e imagens | -| CtrlShiftI | Alternar as ferramentas de desenvolvedor | - -### Repositórios - -| Atalho de teclado | Descrição | -| ------------------------------------------- | ------------------------------------------------------------------------------------- | -| CtrlN | Adicionar um novo repositório | -| CtrlO | Adicionar um repositório local | -| CtrlShiftO | Clonar um repositório do {% data variables.product.prodname_dotcom %} | -| CtrlT | Exibir uma lista dos repositórios | -| CtrlP | Usar os commits mais recentes do {% data variables.product.prodname_dotcom %} | -| CtrlShiftP | Usar as alterações mais recentes do {% data variables.product.prodname_dotcom %} | -| CtrlDelete | Remover um repositório | -| CtrlShiftG | Exibir o repositório no {% data variables.product.prodname_dotcom %} | -| Ctrl` | Abrir o repositório na sua ferramenta de linha de comando preferida | -| CtrlShiftF | Exibir o repositório no Explorador | -| CtrlShiftA | Abrir o repositório na sua ferramenta de edição preferida | -| CtrlI | Criar um problema em {% data variables.product.prodname_dotcom %} | - -### Branches - -| Atalho | Descrição | -| ------------------------------------------- | -------------------------------------------------------------------------------- | -| Ctrl1 | Exibir todas as alterações antes de fazer o commit | -| Ctrl2 | Exibir o histórico de commits | -| CtrlB | Exibir todos os branches | -| CtrlG | Ir para o campo de resumo de commits | -| space (Espaço) | Selecionar ou desmarque todos os arquivos destacados | -| CtrlShiftN | Criar um branch | -| CtrlShiftR | Renomear o branch atual | -| CtrlShiftD | Excluir o branch atual | -| CtrlShiftU | Atualizar o branch padrão | -| CtrlShiftB | Comparar a outro branch | -| CtrlShiftM | Fazer um merge com o branch atual | -| CtrlH | Exibir ou ocultar alterações stashed | -| CtrlShiftC | Comparar branches no {% data variables.product.prodname_dotcom %} | -| CtrlR | Exibir a pull request atual no {% data variables.product.prodname_dotcom %} | - -{% endwindows %} diff --git a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/launching-github-desktop-from-the-command-line.md b/translations/pt-BR/content/desktop/getting-started-with-github-desktop/launching-github-desktop-from-the-command-line.md deleted file mode 100644 index 90b1bc4d8b50..000000000000 --- a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/launching-github-desktop-from-the-command-line.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: Iniciar o GitHub Desktop na linha de comando -shortTitle: Lançar a partir da linha de comando -intro: É possível iniciar o GitHub Desktop na linha de comando. -versions: - free-pro-team: '*' ---- - -{% mac %} - -1. Na barra de menu, selecione o menu **{% data variables.product.prodname_desktop %}** e, em seguida, clique em **Instalar Ferramenta da Linha de Comando**. ![Instalar opção de Ferramenta de Linha de Comando no menu suspenso {% data variables.product.prodname_desktop %}](/assets/images/help/desktop/mac-install-command-line-tool.png) -2. Abra o terminal. -3. {% data reusables.desktop.launch-desktop-from-command-line %} - - ```shell - $ github /path/to/repo - ``` - - Também é possível alterar o caminho do repositório e digite o `github .` para abrir esse repositório. - - ```shell - $ cd /path/to/repo - [repo]$ github . - ``` - -{% endmac %} - -{% windows %} - -1. Abra um prompt de comando. -2. {% data reusables.desktop.launch-desktop-from-command-line %} - - ```shell - C:\Users\octocat> github path\to\repo - ``` - - Você também pode alterar para o caminho do seu repositório e, em seguida, digitar `github .` para abrir esse repositório. - - ```shell - C:\Users\octocat> cd repo\myrepo - C:\Users\octocat\repo\myrepo> github . - ``` - -{% endwindows %} diff --git a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/overview.md b/translations/pt-BR/content/desktop/getting-started-with-github-desktop/overview.md deleted file mode 100644 index 5eaba2191be3..000000000000 --- a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/overview.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: Visão Geral -intro: Aprenda sobre o GitHub Desktop e crie rapidamente o seu primeiro repositório. -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/setting-a-theme-for-github-desktop.md b/translations/pt-BR/content/desktop/getting-started-with-github-desktop/setting-a-theme-for-github-desktop.md deleted file mode 100644 index 22eaa7644b80..000000000000 --- a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/setting-a-theme-for-github-desktop.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: Definir um tema para o GitHub Desktop -intro: É possível definir um tema para personalizar a aparência do GitHub Desktop. -versions: - free-pro-team: '*' ---- - -{% mac %} - -{% data reusables.desktop.mac-select-desktop-menu %} -{% data reusables.desktop.choose-a-theme %} - ![The theme options on the Appearance tab for Mac](/assets/images/help/desktop/mac-appearance-tab-themes.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.windows-choose-options %} -{% data reusables.desktop.choose-a-theme %} - ![The theme options on the Appearance tab for Windows](/assets/images/help/desktop/windows-appearance-tab-themes.png) - -{% endwindows %} diff --git a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/uninstalling-github-desktop.md b/translations/pt-BR/content/desktop/getting-started-with-github-desktop/uninstalling-github-desktop.md deleted file mode 100644 index 30cb6444c000..000000000000 --- a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/uninstalling-github-desktop.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Desinstalar o GitHub Desktop -intro: Você pode desinstalar o GitHub Desktop no seu computador a qualquer momento. -versions: - free-pro-team: '*' ---- - -{% mac %} - -1. Em uma janela do Finder, navegue até a pasta Aplicativos. ![Pasta de aplicativos na janela do Finder](/assets/images/help/desktop/applications-folder.png) -2. Ao pressionar o botão **Controle** no seu teclado, clique em **{% data variables.product.prodname_desktop %}**. -3. Escolha **Move to Trash** (Mover para a lixeira). ![A opção Mover para a lixeira](/assets/images/help/desktop/mac-move-to-trash.png) -4. Na barra do menu, use o menu suspenso **Finder** e, em seguida, clique em **Esvaziar lixeira**. ![A opção Esvaziar lixeira na barra do menu](/assets/images/help/desktop/mac-empty-trash-menu.png) -5. Leia o aviso na caixa pop-up e clique em **Empty Trash** (Esvaziar lixeira). ![O botão de Esvaziar lixeira](/assets/images/help/desktop/mac-empty-trash-button.png) - -{% endmac %} - -{% windows %} - -1. Abrir Painel de controle Para obter mais informações, consulte [Onde está o Painel de Controle?](https://support.microsoft.com/en-us/help/13764/windows-where-is-control-panel) no Windows Help. -2. Em "Programas", clique em **Desinstalar um programa**. ![A opção Desinstalar um Programa no Painel de Controle](/assets/images/help/desktop/windows-uninstall-a-program.png) -3. Clique com o botão direito no item denominado **{% data variables.product.prodname_desktop %}** e, em seguida, clique em **Desinstalar**. ![A opção de Desinstalar](/assets/images/help/desktop/windows-click-uninstall.png) - -{% endwindows %} diff --git a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/updating-github-desktop.md b/translations/pt-BR/content/desktop/getting-started-with-github-desktop/updating-github-desktop.md deleted file mode 100644 index 4ecc153aa07f..000000000000 --- a/translations/pt-BR/content/desktop/getting-started-with-github-desktop/updating-github-desktop.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: Atualizar o GitHub Desktop -intro: O GitHub Desktop baixa atualizações automaticamente e faz essas atualizações quando você o reinicia. Também é possível verificar as atualizações manualmente. -versions: - free-pro-team: '*' ---- - -{% mac %} - -1. No menu **GitHub Desktop**, clique em **About GitHub Desktop** (Sobre o GitHub Desktop). ![Opção de menu Sobre o GitHub Desktop](/assets/images/help/desktop/desktop-menu-about-desktop-mac.png) -2. Clique em **Check for Updates** (Verificar atualizações). ![Botão Check for Updates (Verificar atualizações)](/assets/images/help/desktop/check-for-updates.png) -3. Se houver alguma atualização disponível, saia e inicie o {% data variables.product.prodname_desktop %} novamente para fazer a instalação. - -{% endmac %} - -{% windows %} - -1. No menu **Help** (Ajuda), clique em **About GitHub Desktop** (Sobre o GitHub Desktop). ![Opção de menu Sobre o GitHub Desktop](/assets/images/help/desktop/help-about-desktop-win.png) -2. Clique em **Check for Updates** (Verificar atualizações). ![Botão Check for Updates (Verificar atualizações)](/assets/images/help/desktop/check-for-updates.png) -3. Se houver alguma atualização disponível, saia e inicie o {% data variables.product.prodname_desktop %} novamente para fazer a instalação. - -{% endwindows %} diff --git a/translations/pt-BR/content/github/administering-a-repository/about-github-dependabot.md b/translations/pt-BR/content/github/administering-a-repository/about-github-dependabot.md deleted file mode 100644 index 769b260acdd9..000000000000 --- a/translations/pt-BR/content/github/administering-a-repository/about-github-dependabot.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: Sobre o GitHub Dependabot -intro: 'Você pode usar o {% data variables.product.prodname_dependabot %} para manter os pacotes que usa atualizados para as versões mais recentes.' -versions: - free-pro-team: '*' ---- - -{% data reusables.dependabot.beta-note %} - -### Sobre o {% data variables.product.prodname_dependabot %} - -{% data variables.product.prodname_dependabot %} é um app {% data variables.product.prodname_dotcom %} que dispensa o esforço de manter suas dependências. Você pode usá-lo para garantir que seu repositório se mantenha atualizado automaticamente com as versões mais recentes dos pacotes e aplicações do qual ele depende. - -Você habilita o {% data variables.product.prodname_dependabot_version_updates %} verificando um arquivo de configuração no seu repositório. O arquivo de configuração especifica a localização do manifesto ou outros arquivos de definição de pacote, armazenados no seu repositório. O app usa estas informações para verificar pacotes e aplicações desatualizados. O aplicativo {% data variables.product.prodname_dependabot_short %} determina se há uma nova versão de uma dependência ao olhar para o versionamento semântico ([semver](https://semver.org/)) da dependência para decidir se ela deve atualizar para essa versão. Quando o aplicativo identifica uma dependência desatualizada, ele cria uma pull request para atualizar o manifesto para a última versão da dependência. Você verifica se os seus testes passam, revisa o changelog e lança observações incluídas no resumo do pull request e, em seguida, faz a mesclagem. Para obter detalhes, consulte "[Habilitando e desabilitando atualizações da versão](/github/administering-a-repository/enabling-and-disabling-version-updates)." - -Se você habilitar atualizações de segurança, {% data variables.product.prodname_dependabot %} também promove pull requests para atualizar dependências vulneráveis. Para obter mais informações, consulte "[Configurando {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)." - -{% data reusables.dependabot.dependabot-tos %} - -### Frequência de {% data variables.product.prodname_dependabot %} pull requests - -Você especifica com que frequência verifica cada ecossistema para novas versões no arquivo de configuração: diariamente, semanalmente ou mensalmente. - -{% data reusables.dependabot.initial-updates %} - -Se tiver habilitado atualizações de segurança, às vezes você verá atualizações de segurança extras de pull requests. Elas são acionadas por um alerta Dependabot para uma dependência do seu branch padrão. {% data variables.product.prodname_dependabot %} gera automaticamente um pull request para atualizar a dependência vulnerável. - -### Repositórios e ecossistemas suportados - -É possível configurar atualizações de versão para repositórios que contenham um manifesto de dependência ou arquivo de bloqueio para um dos gerentes de pacotes suportados. - -{% data reusables.dependabot.supported-package-managers %} - -Se o seu repositório já usa uma integração para gerenciamento de dependências, você precisará desativar isso antes de habilitar o {% data variables.product.prodname_dependabot %}. Para obter mais informações, consulte "[Sobre integrações](/github/customizing-your-github-workflow/about-integrations)". diff --git a/translations/pt-BR/content/github/administering-a-repository/setting-the-default-branch.md b/translations/pt-BR/content/github/administering-a-repository/setting-the-default-branch.md deleted file mode 100644 index 906548011b5a..000000000000 --- a/translations/pt-BR/content/github/administering-a-repository/setting-the-default-branch.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Definir o branch padrão -intro: 'Se você tiver mais de um branch no seu repositório, você poderá escolher outro branch para ser o branch-padrão.' -redirect_from: - - /articles/setting-the-default-branch -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -### Sobre o branch-padrão - -{% data reusables.branches.new-repo-default-branch %} {% data reusables.branches.default-branch-automatically-base-branch %} se você tiver mais de um branch no seu repositório, qualquer pessoa com direitos de administrador sobre um repositório pode selecionar um desses branches existentes como branch-padrão no repositório. - -### Definir o branch padrão - -{% note %} - -**Observação:** Para definir o branch-padrão você deve ter mais de um branch no seu repositório. - -{% endnote %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -{% data reusables.repositories.repository-branches %} -4. No menu suspenso do branch-padrão, selecione o novo branch-padrão. ![Seletor suspenso de branch padrão](/assets/images/help/repository/repository-options-defaultbranch.png) -5. Clique em **Atualizar**. - -Você pode selecionar somente branches que já existem no {% data variables.product.product_location %}. Para criar um novo branch por meio da UI, consulte "[Criar e excluir branches no repositório](/articles/creating-and-deleting-branches-within-your-repository)". - -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} - -Também é possível definir o nome do branch-padrão para quaisquer repositórios recém-criados, pertencentes à conta de usuário, organização ou conta corporativa. Para obter mais informações, consulte "[Gerenciar o branch-padrão para seus repositórios](/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories)", "[Gerenciar o nome do branch-padrão para repositórios na sua organização](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization), ou "[Exigir uma política com o nome do branch-padrão](/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account#enforcing-a-policy-on-the-default-branch-name)". - -{% endif %} - -{% warning %} - -**Aviso**: Configurar um branch-padrão diferente afeta o conteúdo de `trunk` no seu branch e na [ponte do Git-Subversion](https://github.com/blog/1178-collaborating-on-github-with-subversion) e no `HEAD` que veria ao fazer `git ls-remote` na [URL crescente do repositório](https://git-scm.com/docs/git-ls-remote.html). - -{% endwarning %} diff --git a/translations/pt-BR/content/github/articles/README.md b/translations/pt-BR/content/github/articles/README.md deleted file mode 100644 index 1654054f54e3..000000000000 --- a/translations/pt-BR/content/github/articles/README.md +++ /dev/null @@ -1,5 +0,0 @@ -# Artigos ocultos do GitHub.com - -O artigos do GitHub.com/Usuário corporativo com a página inicial `hidden: true` são encontrados neste diretório. - -Consulte [`content/README`](../README.md#hidden-pages) para saber mais sobre páginas ocultas. diff --git a/translations/pt-BR/content/github/articles/about-the-github-and-visual-studio-bundle.md b/translations/pt-BR/content/github/articles/about-the-github-and-visual-studio-bundle.md deleted file mode 100644 index c4c6ffc6f1f0..000000000000 --- a/translations/pt-BR/content/github/articles/about-the-github-and-visual-studio-bundle.md +++ /dev/null @@ -1,54 +0,0 @@ ---- -title: Sobre o GitHub e o pacote do Visual Studio -hidden: true -redirect_from: - - /articles/about-the-github-and-visual-studio-bundle -versions: - free-pro-team: '*' ---- - -{% tip %} - -**Dicas**: -- Somente proprietários da organização podem convidar usuários para participar de uma organização. Para obter mais informações, consulte "[Níveis de permissão para uma organização](/articles/permission-levels-for-an-organization)". - -{% endtip %} - - -### Neste artigo -- [Sobre as licenças do {% data variables.product.prodname_enterprise %} e do pacote do Visual Studio](#about-github-enterprise-and-visual-studio-bundle-licenses) -- [Atribuir uma licença de usuário do {% data variables.product.prodname_enterprise %}](#assigning-a-github-enterprise-user-license) -- [Superalocação de licenças de usuário](#overallocation-of-user-licenses) - - -### Sobre as licenças do {% data variables.product.prodname_enterprise %} e do pacote do Visual Studio - -Os clientes que compraram o pacote do Visual Studio pelo {% data variables.product.prodname_dotcom %} estão qualificados para uma licença de usuário do {% data variables.product.prodname_enterprise %}. Essas licenças são provisionadas em uma conta corporativa do {% data variables.product.prodname_dotcom %}, que é vinculada ao Microsoft Enterprise Agreement e pode ser atribuída aos integrantes da organização. - -Quando os proprietários das organizações em sua empresa convidam um novo usuário para ingressar em uma organização, eles podem escolher se atribuem ao novo usuário uma licença do {% data variables.product.prodname_enterprise %} ou {% data variables.product.prodname_enterprise %} com as assinaturas do Visual Studio. - -### Atribuir uma licença de usuário do {% data variables.product.prodname_enterprise %} - -{% data reusables.profile.access_profile %} -{% data reusables.profile.access_org %} -{% data reusables.organizations.people %} -{% data reusables.organizations.invite_member_from_people_tab %} -{% data reusables.organizations.invite_to_org %} -{% data reusables.organizations.choose-to-restore-privileges %} -{% data reusables.organizations.choose-user-role %} -{% data reusables.organizations.choose-user-license %} -{% data reusables.organizations.add-user-to-teams %} -{% data reusables.organizations.send-invitation %} -{% data reusables.organizations.user_must_accept_invite_email %} {% data reusables.organizations.cancel_org_invite %} - -### Superalocação de licenças de usuário - -Você pode ver o número total de licenças que usou para suas assinaturas do {% data variables.product.prodname_enterprise %} e {% data variables.product.prodname_enterprise %} com Visual Studio nas configurações de cobrança da sua conta corporativa. - -Se a organização e os proprietários de empresa atribuírem aos usuários mais licenças de assinatura do {% data variables.product.prodname_enterprise %} (Visual Studio) do que as licenças incluídas na sua assinatura, a próxima fatura incluirá cobranças pelo número de usuários acima da quantidade permitida pela assinatura. - -Para obter mais informações, consulte "[Exibir a assinatura e o uso de sua conta corporativa](/articles/viewing-the-subscription-and-usage-for-your-enterprise-account)". - -### Leia mais -- "[Adicionar integrantes da organização a uma equipe](/articles/adding-organization-members-to-a-team)" -- Se sua organização [exigir que integrantes usem autenticação de dois fatores](/articles/requiring-two-factor-authentication-in-your-organization), os usuários que você convida deverão [habilitar a autenticação de dois fatores](/articles/securing-your-account-with-two-factor-authentication-2fa) antes de aceitar o convite. diff --git a/translations/pt-BR/content/github/articles/managing-your-disabled-github-pages-site.md b/translations/pt-BR/content/github/articles/managing-your-disabled-github-pages-site.md deleted file mode 100644 index b534ec783f7d..000000000000 --- a/translations/pt-BR/content/github/articles/managing-your-disabled-github-pages-site.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: Gerenciar seu site GitHub Pages desabilitado -intro: 'Repositórios privados no {% data variables.product.prodname_free_user %} não são compatíveis com {% data variables.product.prodname_pages %}, entretanto, um número limitado de sites {% data variables.product.prodname_pages %} conectados a repositórios privados grátis ficaram ativos equivocadamente. Esses sites não estão mais sendo atualizados e a publicação deles será cancelada pelo {% data variables.product.prodname_dotcom %} em 10 de maio de 2019.' -hidden: true -redirect_from: - - /articles/managing-your-disabled-github-pages-site -versions: - free-pro-team: '*' ---- - -{% note %} - -O {% data variables.product.prodname_pages %} está disponível somente em repositórios públicos com {% data variables.product.prodname_free_user %} e em repositórios públicos e privados com {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, e {% data variables.product.prodname_ghe_server %}. {% data reusables.gated-features.more-info %} - -{% endnote %} - -Se você tem um site {% data variables.product.prodname_pages %} publicado em um repositório privado grátis, você tem algumas opções para continuar publicando e atualizando seu site ou para cancelar a publicação dele manualmente. Se você não tomar nenhuma medida, o {% data variables.product.prodname_dotcom %} cancelará a publicação do site por você em 10 de maio de 2019. - -- **Para continuar a publicar e atualizar seu site {% data variables.product.prodname_pages %}**, você pode converter seu repositório em público ou atualizar sua conta para {% data variables.product.prodname_pro %}. Para obter mais informações sobre como transformar seu repositório privado em público, consulte "[Configurar a visibilidade do repositório](/articles/setting-repository-visibility#making-a-private-repository-public)". Para obter mais informações sobre como atualizar sua conta, consulte "[Atualizar sua assinatura GitHub](/articles/upgrading-your-github-subscription)". - -- **Para parar de publicar seu site {% data variables.product.prodname_pages %}**, é possível [cancelar manualmente a publicação](#manually-unpublishing-your-github-pages-site) ou não fazer nada e o {% data variables.product.prodname_dotcom %} cancelará a publicação de seu site por você em 10 de maio de 2019. Se o seu site {% data variables.product.prodname_pages %} tem um domínio personalizado configurado, você deve atualizar ou remover seus registros DNS com o seu provedor DNS o quanto antes possível para evitar o risco de uma incorporação do domínio. Configurar seu domínio personalizado com seu provedor DNS enquanto o seu site {% data variables.product.prodname_pages %} está desabilitado, poderia resultar em alguma outra pessoa hospedando um site em um de seus subdomínios. Para obter mais informações, consulte "[Usar um domínio personalizado com o {% data variables.product.prodname_pages %}](/articles/using-a-custom-domain-with-github-pages)". - -### Cancelar a publicação de seu site {% data variables.product.prodname_pages %} manualmente - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -3. Na barra lateral esquerda, clique em **Unpublish {% data variables.product.prodname_pages %}** (Cancelar publicação do {% data variables.product.prodname_pages %}). ![Configurações de repositório para cancelar publicação de site {% data variables.product.prodname_pages %}](/assets/images/help/pages/unpublish-pages-button-sidebar.png) -4. Clique em **Unpublish this site** (Cancelar publicação deste site). ![Botão para unpublish (cancelar a publicação) de site {% data variables.product.prodname_pages %}](/assets/images/help/pages/unpublish-pages-button.png) - -### Leia mais - -- "[Cancelar publicação de um site User Pages](articles/unpublishing-a-user-pages-site)" -- "[Cancelar a publicação de um site Project Pages](/articles/unpublishing-a-project-pages-site)" -- "[Transferir um repositório](/articles/transferring-a-repository)" -- "[Sobre arquivar repositórios](/articles/about-archiving-repositories)" -- "[Excluir um repositório](/articles/deleting-a-repository)" diff --git a/translations/pt-BR/content/github/articles/searching-and-navigating-code.md b/translations/pt-BR/content/github/articles/searching-and-navigating-code.md deleted file mode 100644 index 2135c6db75ce..000000000000 --- a/translations/pt-BR/content/github/articles/searching-and-navigating-code.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: Pesquisar e navegar no código -intro: 'Pesquisar e navegar no código são partes críticas do fluxo de trabalho de desenvolvimento, e o GitHub está aprimorando essas áreas. Se você fizer parte de uma organização que está participando da versão beta privada de pesquisa e navegação, terá acesso a novas ferramentas avançadas de pesquisa e navegação. Para dúvidas adicionais sobre esta versão beta privada, envie um e-mail para beta@github.com.' -hidden: true -redirect_from: - - /articles/searching-and-navigating-code -versions: - free-pro-team: '*' ---- - - -### Neste guia - -- [Pesquisa literal no código](#literal-code-search) -- [Relevância](#relevancy) -- [Navegação com acesso direto](#jump-to-navigation) - -### Pesquisa literal no código - -Antes dessa versão beta privada, muito símbolos eram retirados dos índices de pesquisa, e expressões comuns como `>>` não eram pesquisadas. Por exemplo, ao pesquisar `>>` em um repositório, nenhum resultado era retornado. Com a versão beta privada, você pode colocar o símbolo entre aspas duplas e ver os resultados corretos. Esse recurso vai além dos símbolos e permite pesquisar frases inteiras entre aspas, como `"return [] unless"`. Esse recurso se aplica à pesquisa de código em todas as linguagens. - -### Relevância - -Para um subconjunto de linguagens (Go, JavaScript, Python, Ruby e TypeScript), a pesquisa no código agora modula a relevância das declarações. A declaração de um método, função, classe ou outra entidade será retornada antes das chamadas ou comentários que incluem o mesmo termo. - -### Navegação com acesso direto - -Para um subconjunto de idiomas (Go, JavaScript, Python, Ruby e TypeScript), o GitHub agora oferece suporte a informações adicionais e navegação ao clicar em um símbolo. Essa navegação inclui a navegação de acesso à definição para recursos no repositório, o que aumenta a velocidade da navegação e melhora o insight. - -### Feedback - -Os usuários que estão usando a versão beta privada de pesquisa e navegação podem fornecer feedback por meio [desta pesquisa](https://www.research.net/r/CodeSearch-Navigation). Para feedback e dúvidas adicionais, envie um e-mail para search-beta@github.com. - -### Leia mais -- [Sobre a pesquisa no GitHub](/articles/about-searching-on-github/) -- [Localizar métodos e funções modificados em uma pull request](/articles/finding-changed-methods-and-functions-in-a-pull-request/) diff --git a/translations/pt-BR/content/github/articles/using-gist-playground.md b/translations/pt-BR/content/github/articles/using-gist-playground.md deleted file mode 100644 index 8af6697b5348..000000000000 --- a/translations/pt-BR/content/github/articles/using-gist-playground.md +++ /dev/null @@ -1,45 +0,0 @@ ---- -title: Usar o Gist Playground -intro: '' -hidden: true -redirect_from: - - /articles/articles/using-gist-playground -versions: - free-pro-team: '*' ---- - -{% note %} - -**Observação:** o Gist Playground está disponível como um programa beta privado limitado e, portanto, está sujeito ao acordo de acesso antecipado. - -{% endnote %} - -### Neste artigo -- [Sobre o Gist Playground](#about-gist-playground) -- [Criar gists](#creating-new-gists) -- [Salvar alterações](#saving-your-changes) -- [Colaborar com outras pessoas](#collaborating-with-others) -- [Reportar erros e comentários](#reporting-bugs-and-feedback) - -### Sobre o Gist Playground -O Gist Playground é uma iteração experimental do [Gist](https://gist.github.com/). As alterações são salvas automaticamente enquanto você trabalha com amigos e colegas. - -### Criar gists -Quando você acessa o Gist Playground, ele cria automaticamente um rascunho ou mostra seu rascunho mais recente. Quando estiver pronto, clique em **Criar gist** no cabeçalho para criar e compartilhar o gist. - -Todos os gists feitos no Gist Playground são *secretos*. Ainda não há nenhuma maneira de tornar um gist público a partir do Gist Playground. Caso queira fazer isso, use o [Gist](https://gist.github.com/) existente. - -### Salvar alterações -As alterações são salvas automaticamente enquanto você digita. Você pode fechar a guia em qualquer ponto e voltar sem perder nenhum trabalho. - -Quando você estiver em um ponto de verificação, poderá atualizar o gist com essas alterações clicando em **Atualizar gist** no cabeçalho. - -### Colaborar com outras pessoas -Você pode colaborar com qualquer pessoa que participe do programa beta privado Gist Playground. Em "Invite to collaborate" (Convidar a colaborar), clique na URL de colaboração para copiá-la e envie-a a um amigo. Assim vocês poderão fazer as alterações juntos. - -Quando você estiver em um ponto de verificação, o proprietário do gist poderá manter as alterações clicando em **Atualizar gist**. - -Se você quiser colaborar com alguém que não participa do beta privado Gist Playground, envie um e-mail para nós em [gist-playground@github.com](mailto:gist-playground@github.com) e verificaremos a possibilidade de adicioná-lo. - -### Reportar erros e comentários -Gostaríamos muito de ouvir sua opinião sobre Gist Playground e como podemos melhorá-lo! Envie um e-mail para nós em [gist-playground@github.com](mailto:gist-playground@github.com) com ideias, erros ou comentários. diff --git a/translations/pt-BR/content/github/committing-changes-to-your-project/why-are-my-commits-in-the-wrong-order.md b/translations/pt-BR/content/github/committing-changes-to-your-project/why-are-my-commits-in-the-wrong-order.md deleted file mode 100644 index f3457694e6ac..000000000000 --- a/translations/pt-BR/content/github/committing-changes-to-your-project/why-are-my-commits-in-the-wrong-order.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: Por que meus commits estão na ordem errada? -intro: 'Se você reescrever seu histórico de commits por meio de ''git rebase'' ou de um push forçado, poderá perceber que a sequência de commits está fora de ordem ao abrir uma pull request.' -redirect_from: - - /articles/why-are-my-commits-in-the-wrong-order -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -O GitHub enfatiza pull requests como um espaço para discussão. Todos os aspectos (comentários, referências e commits) são representados em ordem cronológica. Reescrever o histórico de commits do Git [ao executar rebases](/articles/about-git-rebase) altera o continuum espaço-tempo, o que significa que talvez os commits não sejam representados conforme esperado na interface do Github. - -Se você sempre quiser ver os commits em ordem, recomendamos não usar`git rebase`. No entanto, tenha certeza de que nada está errado quando você vê as coisas fora da ordem cronológica! diff --git a/translations/pt-BR/content/github/developing-online-with-codespaces/connecting-to-your-codespace-from-visual-studio-code.md b/translations/pt-BR/content/github/developing-online-with-codespaces/connecting-to-your-codespace-from-visual-studio-code.md deleted file mode 100644 index fd97908d696e..000000000000 --- a/translations/pt-BR/content/github/developing-online-with-codespaces/connecting-to-your-codespace-from-visual-studio-code.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: Conectar-se ao seu codespace do Visual Studio Code -intro: 'Você pode desenvolver seu codespace diretamente em {% data variables.product.prodname_vscode %}, conectando a extensão de {% data variables.product.prodname_vs_codespaces %} à sua conta no {% data variables.product.product_name %}.' -product: '{% data reusables.gated-features.codespaces %}' -versions: - free-pro-team: '*' ---- - -{% data reusables.codespaces.release-stage %} - -### Conectar a extensão de {% data variables.product.prodname_vs_codespaces %} à sua conta {% data variables.product.prodname_dotcom %} - -Antes de poder desenvolver em um código diretamente em {% data variables.product.prodname_vscode %}, você deverá configurar a extensão {% data variables.product.prodname_vs_codespaces %} para conectar-se à sua conta do {% data variables.product.product_name %}. - -1. Use o {% data variables.product.prodname_vs %} Marketplace para instalar a extensão [{% data variables.product.prodname_vs_codespaces %}](https://marketplace.visualstudio.com/items?itemName=ms-vsonline.vsonline). Para obter mais informações, consulte [Extensão do Marketplace](https://code.visualstudio.com/docs/editor/extension-gallery) na documentação do {% data variables.product.prodname_vscode %}. -2. Clique no ícone Extensões na barra lateral esquerda do {% data variables.product.prodname_vscode %}. ![O ícone das extensões em {% data variables.product.prodname_vscode %}](/assets/images/help/codespaces/click-extensions-icon-vscode.png) -3. Abaixo do {% data variables.product.prodname_vs_codespaces %}, clique no ícone Gerenciar e, em seguida, clique em **Configurações de extensão**. ![A opção Configurações de extensão](/assets/images/help/codespaces/select-extension-settings.png) -4. Use o menu suspenso "Vsonline: Provedor de Conta", e selecione {% data variables.product.prodname_dotcom %}. ![Definir o provedor de conta para {% data variables.product.prodname_dotcom %}](/assets/images/help/codespaces/select-account-provider-vscode.png) -{% data reusables.codespaces.click-remote-explorer-icon-vscode %} -6. Se {% data variables.product.prodname_codespaces %} não estiver selecionado no cabeçalho, clique em **{% data variables.product.prodname_codespaces %}**. ![Cabeçalho do {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/codespaces-header-vscode.png) -7. Clique em **Iniciar sessão para visualizar {% data variables.product.prodname_codespaces %}...**. ![Registrar-se para visualizar {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/sign-in-to-view-codespaces-vscode.png) -8. Para autorizar o {% data variables.product.prodname_vscode %} a acessar sua conta no {% data variables.product.product_name %}, clique em **Permitir**. -9. Registre-se e, {% data variables.product.product_name %} para aprovar a extensão. - -### Abrir um codespace em {% data variables.product.prodname_vscode %} - -Depois de conectar a sua conta do {% data variables.product.product_name %} à extensão de {% data variables.product.prodname_vs_codespaces %}, você poderá desenvolver em codespace criado no {% data variables.product.product_name %} diretamente em {% data variables.product.prodname_vscode %}. - -{% data reusables.codespaces.click-remote-explorer-icon-vscode %} -2. Em Codespaces, clique no codespace que você deseja desenvolver. -3. Clique no ícone Conectar-se ao Codespace. ![Ícone de conectar-se a um Codespace em {% data variables.product.prodname_vscode %}](/assets/images/help/codespaces/click-connect-to-codespace-icon-vscode.png) diff --git a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-for-compiled-languages.md b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-for-compiled-languages.md deleted file mode 100644 index 0308491030b7..000000000000 --- a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-for-compiled-languages.md +++ /dev/null @@ -1,153 +0,0 @@ ---- -title: Configurar varredura de código para linguagens compiladas -shortTitle: Configurar para linguagens compiladas -intro: 'Você pode configurar como o código {% data variables.product.prodname_dotcom %} faz a varredura de código escrito em linguagens compiladas com relação a vulnerabilidades e erros.' -product: '{% data reusables.gated-features.code-scanning %}' -permissions: 'Pessoas com permissões de gravação para um repositório podem configurar {% data variables.product.prodname_code_scanning %} para o repositório.' -versions: - free-pro-team: '*' ---- - -{% data reusables.code-scanning.beta %} - -{% note %} - -**Observação**: Este artigo refere-se a {% data variables.product.prodname_code_scanning %} movido por {% data variables.product.prodname_codeql %}, não a {% data variables.product.prodname_code_scanning %}, resultante do upload das ferramentas de análise estática de terceiros. - -{% endnote %} - -### Sobre {% data variables.product.prodname_code_scanning %} e linguagens compiladas - -Para habilitar o {% data variables.product.prodname_code_scanning %} para seu repositório, você deve adicionar ao repositório um fluxo de trabalho do {% data variables.product.prodname_actions %} que inclui análise do {% data variables.product.prodname_codeql %}. Para obter mais informações, consulte "[Habilitando {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning). ". - -{% data reusables.code-scanning.edit-workflow %} -Para obter mais informações sobre a configuração de {% data variables.product.prodname_code_scanning %} e edição de arquivos do fluxo de trabalho, consulte "[Configurar o {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)" e "[Configurar um fluxo de trabalho](/actions/configuring-and-managing-workflows/configuring-a-workflow)". - -### Sobre a autobuild para {% data variables.product.prodname_codeql %} - -{% data reusables.code-scanning.autobuild-compiled-languages %} - -{% note %} - -**Observação**: Se você usa executores auto-hospedados para {% data variables.product.prodname_actions %}, talvez seja necessário instalar um software adicional para usar o processo de `autobuild`. Além disso, se seu repositório precisar de uma versão específica de uma ferramenta de criação, talvez seja necessário instalá-lo manualmente. Para obter mais informações, consulte "[Software instalado nos executores hospedados no GitHub](/actions/reference/software-installed-on-github-hosted-runners)". - -{% endnote %} - -#### C/C++ - -| Tipo de sistema compatível | Nome do sistema | -| -------------------------- | -------------------------------------------------------- | -| Sistema operacional | Windows e Linux | -| Sistema de criação | Autoconf, CMake, qmake, Meson, Waf, SCons e Linux Kbuild | - -O comportamento da etapa de autobuild` varia de acordo com o sistema operacional em que a extração é executada. No Windows, a etapa não tem ações-padrão. No Linux, esta etapa revisa os arquivos presentes no repositório para determinar o sistema de criação usado:

    - -
      -
    1. Procure um sistema de criação no diretório-raiz.
      2. -
    2. Se nenhum for encontrado, procure um diretório único nos subdiretórios com um sistema de criação para C/C++.
      3. -
    3. Execute um comando apropriado para configurar o sistema.
      4. -
    - -

    C

    - - - - - - - - - - - - - - - - - - -
    Tipo de sistema compatívelNome do sistema
    Sistema operacionalWindows e Linux
    Sistema de criação.NET, MSbuild e scripts de criação
    - -

    O processo de autobuild` tenta detectar automaticamente um método de criação adequado para C# usando a seguinte abordagem: - -1. Invocar o arquivo `dotnet build` na solução (`.sln`) ou projeto (`.csproj`) mais próximo da raiz. -2. Invocar `MSbuild` (Linux) ou `MSBuild.exe` (Windows) na solução ou no arquivo do projeto mais próximo da raiz. Se o `autobuild` detectar várias soluções ou arquivos de projeto na mesma profundidade (mais curta) do diretório de nível superior, ele tentará criar todos eles. -3. Invoca um script que parece um script de criação—_build_ e _build.sh_ (nessa ordem, para o Linux) ou _build.bat_, _build.cmd_, _e build.exe_ (nessa ordem para o Windows). - - -#### Java - -| Tipo de sistema compatível | Nome do sistema | -| -------------------------- | -------------------------------------- | -| Sistema operacional | Windows, macOS e Linux (sem restrição) | -| Sistema de criação | Gradle, Maven e Ant | - -O processo de `autobuild` tenta determinar o sistema de criação para bases de código do Java aplicando esta estratégia: - -1. Procurar um arquivo de criação no diretório-raiz. Verifique o arquivos do Gradle, do Maven e, em seguida, do Ant. -2. Execute o primeiro arquivo de criação encontrado. Se os arquivos do Gradle e do Maven estiverem presentes, será usado o arquivo do Gradle. -3. Caso contrário, procure arquivos de criação nos subdiretórios diretos do diretório-raiz. Se apenas um subdiretório contiver arquivos de criação, execute o primeiro arquivo identificado nesse subdiretório (usando a mesma preferência de 1). Se mais de um subdiretório conter arquivos de criação, relate um erro. - -### Adicionar passos de criação a uma linguagem compilada - -{% data reusables.code-scanning.autobuild-add-build-steps %} Para obter informações sobre a edição do fluxo de trabalho, consulte "[Configurar {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#editing-a-code-scanning-workflow)". - -Depois de remover a etapa de `autobuild`, remova o comentário da etapa `executar` e adicione comandos de criação adequados ao seu repositório. A etapa do fluxo de trabalho `executar` executa programas da linha de comando que usam o shell do sistema operacional. Você pode modificar esses comandos e adicionar mais comandos para personalizar o processo de criação. - -``` yaml -- run: | - make bootstrap - make release -``` - -Para obter mais informações sobre a palavra-chave `executar`, consulte "[Sintaxe de fluxo de trabalho para {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)". - -Também é possível usar uma matriz para atualizar o fluxo de trabalho para criar mais de uma linguagem compilada, se esta for a abordagem apropriada para o seu sistema e não causar conflitos. Para obter mais informações, consulte "[Configurar uma matriz de criação](/actions/configuring-and-managing-workflows/configuring-a-workflow#configuring-a-build-matrix)". - - -Por exemplo, o fluxo de trabalho abaixo executa um trabalho para análise C/C++ e outro para análise do Java. - -```yaml - -name: "Code Scanning - Action" - -on: - pull_request: - branches: [master] - push: - branches: [master] - -jobs: - CodeQL-Build: - - strategy: - fail-fast: false - matrix: - language: [ 'cpp', 'java'] - - # CodeQL runs on ubuntu-latest, windows-latest, and macos-latest - runs-on: ubuntu-latest - - steps: - - name: Checkout repository - uses: actions/checkout@v2 - - # Initializes the CodeQL tools for scanning. - - name: Initialize CodeQL - uses: github/codeql-action/init@v1 - with: - languages: ${{ matrix.language }} - - # Autobuild attempts to build any compiled languages (C/C++, C#, or Java). - # Se esta etapa falhar, você deverá removê-lo e executar a criação manualmente. - - name: Autobuild - uses: github/codeql-action/autobuild@v1 - - - name: Perform CodeQL Analysis - uses: github/codeql-action/analyze@v1 -``` - -Para obter mais dicas e truques sobre por que o `autobuild` não criará seu código, consulte[Solução de problemas para {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning)". - -Se você adicionou etapas manuais de criação para linguagens compiladas ou usou uma matriz de criação e o {% data variables.product.prodname_code_scanning %} ainda não está funcionando no seu repositório, entre em contato com {% data variables.contact.contact_support %}. diff --git a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages.md b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages.md deleted file mode 100644 index 0e452d3ab72c..000000000000 --- a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages.md +++ /dev/null @@ -1,151 +0,0 @@ ---- -title: Configuring the CodeQL action for compiled languages -shortTitle: Configurar para linguagens compiladas -intro: 'You can configure how {% data variables.product.prodname_dotcom %} uses the {% data variables.product.prodname_codeql_workflow %} to scan code written in compiled languages for vulnerabilities and errors.' -product: '{% data reusables.gated-features.code-scanning %}' -permissions: 'Pessoas com permissões de gravação para um repositório podem configurar {% data variables.product.prodname_code_scanning %} para o repositório.' -redirect_from: - - /github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-for-compiled-languages -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.code-scanning.beta %} -{% data reusables.code-scanning.enterprise-enable-code-scanning-actions %} - -### About the {% data variables.product.prodname_codeql_workflow %} and compiled languages - -Para habilitar o {% data variables.product.prodname_code_scanning %} para seu repositório, você deve adicionar ao repositório um fluxo de trabalho do {% data variables.product.prodname_actions %} que inclui análise do {% data variables.product.prodname_codeql %}. For {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %}, you add the {% data variables.product.prodname_codeql_workflow %}. Para obter mais informações, consulte "[Habilitando {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning). - -{% data reusables.code-scanning.edit-workflow %} -For general information about configuring {% data variables.product.prodname_code_scanning %} and editing workflow files, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)" and "[Configuring a workflow](/actions/configuring-and-managing-workflows/configuring-a-workflow)." - -### Sobre a autobuild para {% data variables.product.prodname_codeql %} - -{% data reusables.code-scanning.autobuild-compiled-languages %} - -{% note %} - -**Observação**: Se você usa executores auto-hospedados para {% data variables.product.prodname_actions %}, talvez seja necessário instalar um software adicional para usar o processo de `autobuild`. Além disso, se seu repositório precisar de uma versão específica de uma ferramenta de criação, talvez seja necessário instalá-lo manualmente. Para obter mais informações, consulte "[Software instalado nos executores hospedados no GitHub](/actions/reference/software-installed-on-github-hosted-runners)". - -{% endnote %} - -#### C/C++ - -| Tipo de sistema compatível | Nome do sistema | -| -------------------------- | -------------------------------------------------------- | -| Sistema operacional | Windows e Linux | -| Sistema de criação | Autoconf, CMake, qmake, Meson, Waf, SCons e Linux Kbuild | - -O comportamento da etapa de autobuild` varia de acordo com o sistema operacional em que a extração é executada. No Windows, a etapa não tem ações-padrão. No Linux, esta etapa revisa os arquivos presentes no repositório para determinar o sistema de criação usado:

    - -
      -
    1. Procure um sistema de criação no diretório-raiz.
      2. -
    2. Se nenhum for encontrado, procure um diretório único nos subdiretórios com um sistema de criação para C/C++.
      3. -
    3. Execute um comando apropriado para configurar o sistema.
      4. -
    - -

    C

    - - - - - - - - - - - - - - - - - - -
    Tipo de sistema compatívelNome do sistema
    Sistema operacionalWindows e Linux
    Sistema de criação.NET, MSbuild e scripts de criação
    - -

    O processo de autobuild` tenta detectar automaticamente um método de criação adequado para C# usando a seguinte abordagem: - -1. Invocar o arquivo `dotnet build` na solução (`.sln`) ou projeto (`.csproj`) mais próximo da raiz. -2. Invocar `MSbuild` (Linux) ou `MSBuild.exe` (Windows) na solução ou no arquivo do projeto mais próximo da raiz. Se o `autobuild` detectar várias soluções ou arquivos de projeto na mesma profundidade (mais curta) do diretório de nível superior, ele tentará criar todos eles. -3. Invoca um script que parece um script de criação—_build_ e _build.sh_ (nessa ordem, para o Linux) ou _build.bat_, _build.cmd_, _e build.exe_ (nessa ordem para o Windows). - -#### Java - -| Tipo de sistema compatível | Nome do sistema | -| -------------------------- | -------------------------------------- | -| Sistema operacional | Windows, macOS e Linux (sem restrição) | -| Sistema de criação | Gradle, Maven e Ant | - -O processo de `autobuild` tenta determinar o sistema de criação para bases de código do Java aplicando esta estratégia: - -1. Procurar um arquivo de criação no diretório-raiz. Verifique o arquivos do Gradle, do Maven e, em seguida, do Ant. -2. Execute o primeiro arquivo de criação encontrado. Se os arquivos do Gradle e do Maven estiverem presentes, será usado o arquivo do Gradle. -3. Caso contrário, procure arquivos de criação nos subdiretórios diretos do diretório-raiz. Se apenas um subdiretório contiver arquivos de criação, execute o primeiro arquivo identificado nesse subdiretório (usando a mesma preferência de 1). Se mais de um subdiretório conter arquivos de criação, relate um erro. - -### Adicionar passos de criação a uma linguagem compilada - -{% data reusables.code-scanning.autobuild-add-build-steps %} Para obter informações sobre a edição do fluxo de trabalho, consulte "[Configurar {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#editing-a-code-scanning-workflow)". - -Depois de remover a etapa de `autobuild`, remova o comentário da etapa `executar` e adicione comandos de criação adequados ao seu repositório. A etapa do fluxo de trabalho `executar` executa programas da linha de comando que usam o shell do sistema operacional. Você pode modificar esses comandos e adicionar mais comandos para personalizar o processo de criação. - -``` yaml -- run: | - make bootstrap - make release -``` - -Para obter mais informações sobre a palavra-chave `executar`, consulte "[Sintaxe de fluxo de trabalho para {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)". - -Também é possível usar uma matriz para atualizar o fluxo de trabalho para criar mais de uma linguagem compilada, se esta for a abordagem apropriada para o seu sistema e não causar conflitos. Para obter mais informações, consulte "[Configurar uma matriz de criação](/actions/configuring-and-managing-workflows/configuring-a-workflow#configuring-a-build-matrix)". - - -Por exemplo, o fluxo de trabalho abaixo executa um trabalho para análise C/C++ e outro para análise do Java. - -```yaml - -name: "CodeQL" - -on: - push: - branches: [main, ] - pull_request: - branches: [main] - -jobs: - CodeQL-Build: - - strategy: - fail-fast: false - matrix: - language: ['cpp', 'java'] - -{% if currentVersion ver_gt "enterprise-server@2.21" %} runs-on: self-hosted -{% else %} # CodeQL runs on ubuntu-latest, windows-latest, and macos-latest - runs-on: ubuntu-latest{% endif %} - - steps: - - name: Checkout repository - uses: actions/checkout@v2 - - # Initializes the CodeQL tools for scanning. - - name: Initialize CodeQL - uses: github/codeql-action/init@v1 - with: - languages: ${{ matrix.language }} - - # Autobuild attempts to build any compiled languages (C/C++, C#, or Java). - # Se esta etapa falhar, você deverá removê-lo e executar a criação manualmente. - - name: Autobuild - uses: github/codeql-action/autobuild@v1 - - - name: Perform CodeQL Analysis - uses: github/codeql-action/analyze@v1 -``` - -Para obter mais dicas e truques sobre por que o `autobuild` não criará seu código, consulte[Solução de problemas para {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning)". - -Se você adicionou etapas manuais de criação para linguagens compiladas ou usou uma matriz de criação e o {% data variables.product.prodname_code_scanning %} ainda não está funcionando no seu repositório, entre em contato com {% data variables.contact.contact_support %}. diff --git a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning.md b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning.md deleted file mode 100644 index 0185f99ca950..000000000000 --- a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: Habilitar a varredura de código -intro: 'Você pode habilitar o {% data variables.product.prodname_code_scanning %} para o repositório do seu projeto.' -product: '{% data reusables.gated-features.code-scanning %}' -permissions: 'As pessoas com permissões de gravação em um repositório podem habilitar o {% data variables.product.prodname_code_scanning %} para o repositório.' -redirect_from: - - /github/managing-security-vulnerabilities/configuring-automated-code-scanning -versions: - free-pro-team: '*' ---- - -{% data reusables.code-scanning.beta %} - -### Habilitar o {% data variables.product.prodname_code_scanning %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-security %} -3. À direita de "Varredura de código", clique em **Configurar a varredura de código**. ![Botão de "Configurar a varredura de código" à direita de "Varredura de código" na Visão Geral de Segurança](/assets/images/help/security/overview-set-up-code-scanning.png) -4. Em "Comece com a varredura de código", clique em **Configurar este fluxo de trabalho**. ![Botão "Configurar este fluxo de trabalho" no cabeçalho "Comece com a varredura do código" cabeçalho](/assets/images/help/repository/code-scanning-set-up-this-workflow.png) -5. Opcionalmente, para personalizar a forma como {% data variables.product.prodname_code_scanning %} faz a varredura do seu código, edite o fluxo de trabalho. Para obter mais informações, consulte "[Configurando {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)." -6. Use o menu suspenso **Iniciar commit** e digite uma mensagem de commit. ![Iniciar commit](/assets/images/help/repository/start-commit-commit-new-file.png) -7. Escolha se você gostaria de fazer commit diretamente no branch-padrão ou criar um novo branch e iniciar um pull request. ![Escolher onde fazer commit](/assets/images/help/repository/start-commit-choose-where-to-commit.png) -8. Clique em **Fazer commit do novo arquivo** ou **Propor novo arquivo**. - -Depois que você confirmar o arquivo de fluxo de trabalho ou criar um pull request, {% data variables.product.prodname_code_scanning %} analisará seu código de acordo com a frequência especificada no arquivo de fluxo de trabalho. Se você criou um pull request, o {% data variables.product.prodname_code_scanning %} somente analisará o código no branch de tópico do pull request até você mesclar o pull request no branch-padrão do repositório. - -### Próximas etapas - -Após ativar o {% data variables.product.prodname_code_scanning %}, você poderá monitorar a análise, visualizar os resultados e personalizar ainda mais a forma como faz a varredura do seu código. - -- Você pode visualizar o status de execução de {% data variables.product.prodname_code_scanning %} e obter notificações referentes às execuções concluídas. Para obter mais informações, consulte "[Gerenciar a execução de um fluxo de trabalho](/actions/configuring-and-managing-workflows/managing-a-workflow-run)" e "[Configurar notificações](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)". -- Após a conclusão de uma varredura, você pode visualizar alertas de uma varredura concluída. Para obter mais informações, consulte "[Gerenciando alertas do {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)." -- É possível personalizar a forma como o {% data variables.product.prodname_code_scanning %} faz a varredura do código no repositório. Para obter mais informações, consulte "[Configurar a verificação de código](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)". diff --git a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning.md b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning.md deleted file mode 100644 index 08e59c012917..000000000000 --- a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning.md +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: Gerenciar alertas da varredura de código -shortTitle: Gerenciando alertas -intro: 'Você pode visualizar, corrigir e fechar alertas de possíveis vulnerabilidades ou erros no código do seu projeto.' -product: '{% data reusables.gated-features.code-scanning %}' -permissions: 'As pessoas com permissões de gravação em um repositório podem gerenciar os alertas de {% data variables.product.prodname_code_scanning %} para o repositório.' -redirect_from: - - /github/managing-security-vulnerabilities/managing-alerts-from-automated-code-scanning -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.code-scanning.beta %} -{% data reusables.code-scanning.enterprise-enable-code-scanning %} - -### Sobre os alertas de {% data variables.product.prodname_code_scanning %} - -Depois que você habilitar o {% data variables.product.prodname_code_scanning %}, {% data variables.product.prodname_dotcom %} exibirá alertas do {% data variables.product.prodname_code_scanning %} no seu repositório. Para obter mais informações, consulte "[Habilitando {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning). - -Cada alerta destaca um problema com o código e o nome da ferramenta que o identificou. Você pode ver a linha de código que acionou o alerta, bem como propriedades do alerta, como, por exemplo, a gravidade e a natureza do problema. Os alertas também informam quando o problema foi introduzido pela primeira vez. Para os alertas identificados pela análise do {% data variables.product.prodname_codeql %} , você também verá informações sobre como corrigir o problema. - -![Exemplo de alerta de {% data variables.product.prodname_code_scanning %}](/assets/images/help/repository/code-scanning-alert.png) - -Se você não tomar a ação recomendada pelo alerta, você poderá fechar o alerta manualmente. Por exemplo, você pode fechar um alerta para o código usado para testes ou se você achar que o alerta é um falso positivo. Você também pode querer fechar um alerta se o esforço de corrigir o erro de codificação for maior do que o benefício potencial de melhorar o código. - -Por padrão, o {% data variables.product.prodname_dotcom %} exibe alertas para o branch-padrão e para quaisquer branches protegidos. Você pode classificar e filtrar a lista de alertas para ver apenas os alertas pelos quais você se interessa. - -Você pode ver os alertas introduzidos em um pull request e tomar medidas imediatas. Quando {% data variables.product.prodname_code_scanning %} encontra vulnerabilidades ou erros em um pull request, {% data variables.product.prodname_dotcom %} exibe anotações na linha do tempo e nas visualizações diferenciais do pull request. - -Se você habilitar o {% data variables.product.prodname_code_scanning %} usando {% data variables.product.prodname_codeql %}, isso também poderá detectar problemas no fluxo de dados no seu código. A análise do fluxo de dados encontra potenciais problemas de segurança no código, tais como: usar dados de forma insegura, passar argumentos perigosos para funções e vazar informações confidenciais. - -Quando {% data variables.product.prodname_code_scanning %} relata alertas de fluxo de dados, {% data variables.product.prodname_dotcom %} mostra como os dados se movem através do código. {% data variables.product.prodname_code_scanning_capc %} permite que você identifique as áreas do seu código que vazam informações confidenciais que poderia ser o ponto de entrada para ataques de usuários maliciosos. - -{% data reusables.code-scanning.you-can-upload-third-party-analysis %} {% data reusables.code-scanning.get-started-uploading-third-party-data %} - -Se você fizer a varredura do seu código usando uma ferramenta de terceiros ou fizer a varredura do seu código com consultas personalizadas de {% data variables.product.prodname_codeql %}, {% data variables.product.prodname_dotcom %} só usará as propriedades compatíveis do SARIF 2.1.0 para exibir alertas. Os resultados de ferramentas de terceiros ou consultas personalizadas podem não incluir todas as propriedades que você vê ao fazer a varredura do seu código usando as consultas-padrão de {% data variables.product.prodname_codeql %} no {% data variables.product.company_short %}. Para obter mais informações, consulte "[Suporte SARIF para {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning)". - -### Visualizar um alerta - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-security %} -{% data reusables.repositories.sidebar-code-scanning-alerts %} -{% data reusables.code-scanning.click-alert-in-list %} -5. Opcionalmente, se o alerta destaca um problema com o fluxo de dados, clique em **Mostrar caminhos** para revisar o caminho dos dados. ![Exemplo de alerta de fluxo de dados](/assets/images/help/repository/code-scanning-show-paths.png) - -### Fechar um alerta - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-security %} -{% data reusables.repositories.sidebar-code-scanning-alerts %} -{% data reusables.code-scanning.click-alert-in-list %} -5. Use o menu suspenso "Fechar", e clique em um motivo para fechar o alerta. ![Escolher o motivo para fechar o alerta no menu suspenso "Fechar"](/assets/images/help/repository/code-scanning-alert-close-drop-down.png) - -### Leia mais - -- "[{% data variables.product.prodname_code_scanning_capc %}](http://developer.github.com/v3/code-scanning)" -- "[{% data variables.product.prodname_code_scanning_capc %} API](/v3/code-scanning)" diff --git a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-results-from-code-scanning.md b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-results-from-code-scanning.md deleted file mode 100644 index 0853c1c0704c..000000000000 --- a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-results-from-code-scanning.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Gerenciar resultados da varredura de código -shortTitle: Gerenciar resultados -intro: 'Você pode visualizar, triar, entender e resolver vulnerabilidades e erros que o {% data variables.product.prodname_code_scanning %} encontra.' -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning.md b/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning.md deleted file mode 100644 index 36819579483d..000000000000 --- a/translations/pt-BR/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning.md +++ /dev/null @@ -1,130 +0,0 @@ ---- -title: Troubleshooting code scanning -shortTitle: Troubleshooting -intro: 'You can see tips to resolve common issues with {% data variables.product.prodname_code_scanning %}.' -product: '{% data reusables.gated-features.code-scanning %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.code-scanning.beta %} -{% data reusables.code-scanning.enterprise-enable-code-scanning %} - -### Automatic build for a compiled language fails - -If an automatic build of code for a compiled language within your project fails, try the following troubleshooting steps. - -- Remove the `autobuild` step from your {% data variables.product.prodname_code_scanning %} workflow and add specific build steps. For information about editing the workflow, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#editing-a-code-scanning-workflow)." For more information about replacing the `autobuild` step, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." -- If the repository for your project contains code in a specific language that does not build, disable automatic language detection in your {% data variables.product.prodname_code_scanning %} workflow and specify only the languages you want to build. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#overriding-automatic-language-detection)." - -### No code found during the build - -If your workflow fails with an error `No source code was seen during the build` or `The process '/opt/hostedtoolcache/CodeQL/0.0.0-20200630/x64/codeql/codeql' failed with exit code 32`, this indicates that {% data variables.product.prodname_codeql %} was unable to trace your code. Several reasons can explain such a failure: - -1. Automatic language detection identified a supported language, but there is no analyzable code of that language in the repository. A typical example is when our language detection service finds a file associated with a particular programming language like a `.h`, or `.gyp` file, but no corresponding executable code is present in the repository. To solve the problem, you can manually define the languages you want to analyze by updating the `init` step to specify the supported languages that are present in your repository. For example, the following configuration will analyze only Go, and JavaScript. - - ```yaml - - name: Initialize CodeQL - uses: github/codeql-action/init@v1 - with: - languages: go, javascript # Other options are csharp, python, cpp, java - ``` -2. Your {% data variables.product.prodname_code_scanning %} workflow is analyzing a compiled language (C, C++, C#, or Java), but the code was not compiled. By default, the {% data variables.product.prodname_codeql %} analysis workflow contains an `autobuild` step, however, this step represents a best effort process, and may not succeed in building your code, depending on your specific build environment. Compilation may also fail if you have removed the `autobuild` step and did not include build steps manually. For more information about specifying build steps, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." -3. Your workflow is analyzing a compiled language (C, C++, C#, or Java), but portions of your build are cached to improve performance (most likely to occur with build systems like Gradle or Bazel). Since {% data variables.product.prodname_codeql %} observes the activity of the compiler to understand the data flows in a repository, {% data variables.product.prodname_codeql %} requires a complete build to take place in order to perform analysis. -4. Your workflow is analyzing a compiled language (C, C++, C#, or Java), but compilation does not occur between the `init` and `analyze` steps in the workflow. {% data variables.product.prodname_codeql %} requires that your build happens in between these two steps in order to observe the activity of the compiler and perform analysis. -5. Your compiled code (in C, C++, C#, or Java) was compiled successfully, but {% data variables.product.prodname_codeql %} was unable to detect the compiler invocations. The most common causes are certain configuration options like running your build process in a container, if you're building using a distributed build system external to {% data variables.product.prodname_actions %} using a daemon process, or if {% data variables.product.prodname_codeql %} isn't aware of the specific compiler you are using. - 1. For C# projects using either `dotnet build` or `msbuild` which target .NET Core 2, you should specify `/p:UseSharedCompilation=false` in your workflow's `run` step, when you build your code. The `UseSharedCompilation` flag isn't necessary for .NET Core 3.0 and later. - - For example, the following configuration will pass the flag during the first build step. - - ```yaml - - run: | - dotnet build /p:UseSharedCompilation=false - ``` - 2. If you encounter another problem with your specific compiler or configuration, contact {% data variables.contact.contact_support %}. - -For more information about specifying build steps, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." - -### Portions of my repository were not analyzed using `autobuild` - -The {% data variables.product.prodname_codeql %} `autobuild` feature uses heuristics to build the code in a repository, however, sometimes this approach results in incomplete analysis of a repository. For example, when multiple `build.sh` commands exist in a single repository, the analysis may not complete since the `autobuild` step will only execute one of the commands. The solution is to replace the `autobuild` step with build steps which build all of the source code which you wish to analyze. Alternatively, if more than one compiled language is present in your repository and you want {% data variables.product.prodname_code_scanning %} to analyze all these compiled languages, you can use a build matrix in your workflow. {% if currentVersion ver_gt "enterprise-server@2.21" %}To use a build matrix, you should make sure that {% data variables.product.prodname_actions %} is enabled on {% data variables.product.product_location_enterprise %}. {% endif %}For more information, see "[Managing complex workflows](/actions/learn-github-actions/managing-complex-workflows/#using-a-build-matrix)" and -"[Configuring the {% data variables.product.prodname_codeql %} action for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages#adding-build-steps-for-a-compiled-language)." - -### Error: "Server error" - -If the run of a workflow for {% data variables.product.prodname_code_scanning %} fails due to a server error, try running the workflow again. If the problem persists, contact {% data variables.contact.contact_support %}. - -### Error: "Out of disk" or "Out of memory" - -On very large projects, {% data variables.product.prodname_codeql %} may run out of disk or memory on the runner. -{% if currentVersion == "free-pro-team@latest" %}If you encounter this issue on a hosted {% data variables.product.prodname_actions %} runner, contact {% data variables.contact.contact_support %} so that we can investigate the problem. -{% else %}If you encounter this issue, try increasing the memory on the runner.{% endif %} - -### The build takes too long - -If your build with {% data variables.product.prodname_codeql %} analysis takes too long to run, there are several approaches you can try to reduce the build time. - -#### Increase the memory or cores - -If you use self-hosted runners to run {% data variables.product.prodname_codeql %} analysis, you can increase the memory or the number of cores on those runners. - -#### Use matrix builds to parallelize the analysis - -By default, {% data variables.product.prodname_codeql %} performs analysis of each language sequentially, which can impact performance, especially for repositories with more than one language. You can speed analysis up by using a build matrix that splits the analysis by language. {% if currentVersion ver_gt "enterprise-server@2.21" %}To use a build matrix, you should make sure that {% data variables.product.prodname_actions %} is enabled on {% data variables.product.product_location_enterprise %}. {% endif %}For more information, see "[Managing complex workflows](/actions/learn-github-actions/managing-complex-workflows/#using-a-build-matrix)." - -For example, the workflow below will be run with one job for JavaScript analysis, and another job for Go analysis. - -```yaml - -name: "Code Scanning - Action" - -on: - pull_request: - branches: [main] - push: - branches: [main] - -jobs: - CodeQL-Build: - - strategy: - fail-fast: false - matrix: - language: [ 'go', 'javascript'] - - # CodeQL runs on ubuntu-latest, windows-latest, and macos-latest - runs-on: ubuntu-latest - - steps: - - name: Checkout repository - uses: actions/checkout@v2 - - # Initializes the CodeQL tools for scanning. - - name: Initialize CodeQL - uses: github/codeql-action/init@v1 - with: - languages: ${{ matrix.language }} - - # Autobuild attempts to build any compiled languages (C/C++, C#, or Java). - # If this step fails, then you should remove it and run the build manually (see below). - - name: Autobuild - uses: github/codeql-action/autobuild@v1 - - - name: Perform CodeQL Analysis - uses: github/codeql-action/analyze@v1 -``` - -#### Reduce the amount of code being analyzed in a single workflow - -Analysis time is typically proportional to the amount of code being analyzed. You can reduce the analysis time by reducing the amount of code being analyzed at once, for example, by excluding test code, or breaking analysis into multiple workflows that analyze only a subset of your code at a time. - -For compiled languages like Java, C, C++, and C#, {% data variables.product.prodname_codeql %} analyzes all of the code which was built during the workflow run. To limit the amount of code being analyzed, build only the code which you wish to analyze by specifying your own build steps in a `run` block. You can combine specifying your own build steps with using the `paths` or `paths-ignore` filters on the `pull_request` and `push` events to ensure that your workflow only runs when specific code is changed. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)." - -For interpreted languages like Go, JavaScript, Python, and TypeScript, that {% data variables.product.prodname_codeql %} analyzes without a specific build, you can specify additional configuration options to limit the amount of code to analyze. For more information, see "[Specifying directories to scan](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#specifying-directories-to-scan)." - -If you split your analysis into multiple workflows as described above, we still recommend that you have at least one workflow which runs on a `schedule` which analyzes all of the code in your repository. Because {% data variables.product.prodname_codeql %} analyzes data flows between components, some complex security behaviors may only be detected on a complete build. - -#### Run only during a `schedule` event - -If your analysis is still too slow to be run during `push` or `pull_request` events, then you may want to only trigger analysis on the `schedule` event. For more information, see "[Events](/actions/learn-github-actions/introduction-to-github-actions#events)." diff --git a/translations/pt-BR/content/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies.md b/translations/pt-BR/content/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies.md deleted file mode 100644 index 0320b1d510ec..000000000000 --- a/translations/pt-BR/content/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies.md +++ /dev/null @@ -1,57 +0,0 @@ ---- -title: Sobre alertas de segurança para dependências vulneráveis -intro: '{% data variables.product.product_name %} sends security alerts when we detect vulnerabilities affecting your repository.' -redirect_from: - - /articles/about-security-alerts-for-vulnerable-dependencies -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -### Sobre vulnerabilidades de segurança - -{% data reusables.repositories.a-vulnerability-is %} Depending on the severity level and the way your project uses the dependency, vulnerabilities can cause a range of problems for your project or the people who use it. Você pode rastrear e resolver vulnerabilidades para determinados tipos de dependência no seu repositório do {% data variables.product.product_name %}. - -If {% data variables.product.prodname_dotcom %} detects a vulnerability from the {% data variables.product.prodname_advisory_database %} or [WhiteSource](https://www.whitesourcesoftware.com/GitHubSecurityAlerts) in one of the dependencies in your repository's dependency graph, we'll send you a security alert. For more information about the {% data variables.product.prodname_advisory_database %}, see "Browsing security vulnerabilities in the {% data variables.product.prodname_advisory_database %}." - -{% if currentVersion == "free-pro-team@latest" %} -### Alerts and automated security updates for vulnerable dependencies -{% else %} -### Alertas de segurança para dependências vulneráveis -{% endif %} - -When a new vulnerability is added to the GitHub Advisory Database, we identify{% if currentVersion == "free-pro-team@latest" %} public{% endif %} repositories{% if currentVersion == "free-pro-team@latest" %} (and private repositories that have opted in to vulnerability detection){% endif %} that use the affected version of the dependency{% if currentVersion == "free-pro-team@latest" %}, send a security alert to repository maintainers, and generate an automated security update{% else %} and send a security alert to repository maintainers{% endif %}. - -Each security alert includes a severity level{% if currentVersion == "free-pro-team@latest" %}, a link to the affected file in your project, and a link to a pull request containing an automated security update that resolves the vulnerability{% else %} and a link to the affected file in your project{% endif %}. Quando disponível, o alerta incluirá mais detalhes sobre a vulnerabilidade. - -Você pode ver todos os alertas que afetam um projeto específico{% if currentVersion == "free-pro-team@latest" %} na guia Alerts (Alertas) do repositório ou{% endif %} no gráfico de dependência do repositório.{% if currentVersion == "free-pro-team@latest" %} Para obter mais informações, consulte "[Exibir e atualizar dependências vulneráveis no repositório](/articles/viewing-and-updating-vulnerable-dependencies-in-your-repository)".{% endif %} - -Enviamos alertas de segurança para as pessoas com permissões de administrador nos repositórios afetados por padrão. O {% data variables.product.product_name %} nunca divulga publicamente vulnerabilidades identificadas em algum repositório.{% if currentVersion == "free-pro-team@latest" %} Você também pode habilitar alertas de segurança para mais pessoas ou equipes que trabalham nos repositórios que pertencem à organização. Para obter mais informações, consulte "[Gerenciar alertas para dependências vulneráveis nos repositórios da sua organização](/articles/managing-alerts-for-vulnerable-dependencies-in-your-organization-s-repositories)".{% endif %} - -{% data reusables.repositories.enable-security-alerts %} -{% if currentVersion == "free-pro-team@latest" %} -Automated security updates update vulnerable dependencies to the minimum version that resolves the vulnerability. Automated security updates are automatically enabled in repositories that use the dependency graph and security alerts, but you can choose to disable automatic pull requests and generate security updates manually instead. For more information, see "[Configuring automated security updates](/github/managing-security-vulnerabilities/configuring-automated-security-updates)." - -O {% data variables.product.prodname_dotcom %} detecta e alerta sobre dependências vulneráveis em repositórios _públicos_ por padrão. Para receber alertas de segurança para dependências vulneráveis em um repositório _privado_, um proprietário ou uma pessoa com acesso de administrador ao repositório deve habilitar o gráfico de dependência e os alertas de segurança no repositório. Para obter mais informações, consulte "[Aceitar ou recusar o uso de dados de seu repositório privado](/articles/opting-into-or-out-of-data-use-for-your-private-repository)". -{% endif %} - -Para obter uma lista de linguagens aceitas em que o {% data variables.product.product_name %} pode detectar vulnerabilidades e dependências, consulte "[Listar os pacotes dos quais um repositório depende](/articles/listing-the-packages-that-a-repository-depends-on)". - -{% warning %} - -**Observação**: os recursos de segurança do {% data variables.product.product_name %}, como os alertas de segurança, não têm a pretensão de capturar todas as vulnerabilidades. Embora estejamos sempre tentando atualizar nosso banco de dados de vulnerabilidades e alertar você com nossas informações mais atualizadas, não podemos capturar tudo nem alertar sobre vulnerabilidades conhecidas dentro de um prazo garantido. Esses recursos não substituem a revisão humana de cada dependência em busca de possíveis vulnerabilidades ou algum outro problema, e nossa sugestão é consultar um serviço de segurança ou realizar uma revisão completa de vulnerabilidade quando necessário. - -{% endwarning %} - -### Configurar notificações para alertas de segurança - -By default, you will receive security alerts by email{% if currentVersion == "free-pro-team@latest" %}, grouped by the specific vulnerability{% endif %}. You can also choose to receive security alerts in a weekly email summarizing alerts for up to 10 of your repositories, in your web notifications, or in the {% data variables.product.product_name %} user interface. For more information, see {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}"[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#security-alert-options){% else %}"[Choosing the delivery method for your notifications ](/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications){% endif %}." - -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" % %}{% data reusables.repositories.security-alerts-x-github-severity %} For more information, see {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}"[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#filtering-email-notifications){% else %}"[About email notifications](/github/receiving-notifications-about-activity-on-github/about-email-notifications){% endif %}."{% endif %} - -### Leia mais - -{% if currentVersion == "free-pro-team@latest" %}- "[Configuring automated security updates](/github/managing-security-vulnerabilities/configuring-automated-security-updates)" -- "[Exibir e atualizar dependências vulneráveis no repositório](/articles/viewing-and-updating-vulnerable-dependencies-in-your-repository)" -- "[Entender como o {% data variables.product.product_name %} usa e protege seus dados](/categories/understanding-how-github-uses-and-protects-your-data)"{% endif %} -- [Definição de "vulnerabilidade"](https://cve.mitre.org/about/terminology.html#vulnerability) da MITRE diff --git a/translations/pt-BR/content/github/managing-security-vulnerabilities/configuring-automated-security-updates.md b/translations/pt-BR/content/github/managing-security-vulnerabilities/configuring-automated-security-updates.md deleted file mode 100644 index 7eae5c84bc82..000000000000 --- a/translations/pt-BR/content/github/managing-security-vulnerabilities/configuring-automated-security-updates.md +++ /dev/null @@ -1,92 +0,0 @@ ---- -title: Configuring automated security updates -intro: Você pode usar pull request automatizadas ou manuais para atualizar facilmente dependências vulneráveis. -redirect_from: - - /articles/configuring-automated-security-fixes - - /github/managing-security-vulnerabilities/configuring-automated-security-fixes -versions: - free-pro-team: '*' ---- - -### About automated security updates - -You can enable automated security updates for any repository that uses security alerts and the dependency graph. You can disable automated security updates for an individual repository or for all repositories owned by your user account or organization. - -When you receive a security alert about a vulnerable dependency in your repository, you can resolve the vulnerability using an automated security update in a pull request that corresponds to the security alert. Automated security updates are available in repositories that use the dependency graph. Por padrão, o {% data variables.product.prodname_dotcom %} cria automaticamente uma pull request no repositório de modo a atualizar a dependência vulnerável para a menor versão segura necessária para evitar a vulnerabilidade. Se preferir, você pode desabilitar as pull requests automáticas e criá-las manualmente para atualizar dependências somente quando for conveniente. - -As solicitações de segurança automatizadas contêm tudo o que você precisa para fazer a revisão e o merge de modo rápido e seguro de uma correção proposta no seu projeto, incluindo informações sobre a vulnerabilidade, como notas de versão, entradas no log de mudanças e detalhes do commit. - -Automated security updates are opened by Dependabot on behalf of {% data variables.product.prodname_dotcom %}. The Dependabot {% data variables.product.prodname_github_app %} is automatically installed on every repository where automated security updates are enabled. - -As pessoas com acesso aos alertas de segurança do seu repositório verão um link para o alerta de segurança relevante, embora outras pessoas com acesso à pull request não possam ver qual vulnerabilidade a pull request resolve. - -When you merge a pull request that contains an automated security update, the corresponding security alert is marked as resolved for your repository. - -{% note %} - -**Note:** Automated security updates resolve security vulnerabilities only. Automated security updates are not created to resolve vulnerabilities in private registries or packages hosted in private repositories. - -{% endnote %} - -### Supported repositories - -{% data variables.product.prodname_dotcom %} automatically enables automated security updates for every repository that meets these requirements. - -{% note %} - -**Note**: For repositories created before November 2019, {% data variables.product.prodname_dotcom %} has automatically enabled automated security updates if the repository meets the following criteria and has received at least one push since May 23, 2019. - -{% endnote %} - -| Requirement | More information | -| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| Repository is not a fork | "[About forks](/github/collaborating-with-issues-and-pull-requests/about-forks)" | -| Repository is not archived | "[Archiving repositories](/github/creating-cloning-and-archiving-repositories/archiving-repositories)" | -| Repository is public, or repository is private and you have enabled read-only analysis by {% data variables.product.prodname_dotcom %}, dependency graph, and vulnerability alerts in the repository's settings | "[Opting into data use for your private repository](/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-data-use-for-your-private-repository#opting-into-data-use-for-your-private-repository)" | -| Repository contains dependency manifest file from a package ecosystem that {% data variables.product.prodname_dotcom %} supports | "[Supported package ecosystems](/github/visualizing-repository-data-with-graphs/listing-the-packages-that-a-repository-depends-on#supported-package-ecosystems)" | -| Automated security updates are not disabled for the repository | "[Managing automated security updates for your repository](#managing-automated-security-updates-for-your-repository)" | -| Repository is not already using an integration for dependency management | "[Sobre integrações](/github/customizing-your-github-workflow/about-integrations)" | - -If automated security updates are not enabled for your repository and you don't know why, you can [contact support](https://support.github.com/contact). - -### Sobre pontuações de compatibilidade - -Automated security updates also include compatibility scores to let you know whether updating a vulnerability could cause breaking changes to your project. We look at previously-passing CI tests from public repositories where we've generated a given automated security update to learn whether the update causes tests to fail. Uma pontuação de compatibilidade da atualização é a porcentagem de execuções de CI que foram aprovadas durante a atualização entre versões relevantes da dependência. - -### Managing automated security updates for your repository - -You can enable or disable automated security updates for an individual repository. - -Automated security updates require specific repository settings. For more information, see "[Supported repositories](#supported-repositories)." - -{% data reusables.repositories.you-can-enable-or-disable-security-features %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-security %} -4. Above the list of alerts, use the drop-down menu and select or unselect **Automated security updates**. ![Drop-down menu with the option to enable automated security updates](/assets/images/help/repository/enable-automated-security-updates-drop-down.png) - -### Managing automated security updates for your user account - -You can disable automated security updates for all repositories owned by your user account. If you do, you can still enable automated security updates for individual repositories owned by your user account. - -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.security %} -{% data reusables.repositories.opt-out-automated-security-updates %} - -### Managing automated security updates for your organization - -Organization owners can disable automated security updates for all repositories owned by the organization. If you do, anyone with admin permissions to an individual repository owned by the organization can still enable automated security updates on that repository. - -{% data reusables.repositories.you-can-enable-or-disable-security-features %} - -{% data reusables.profile.access_profile %} -{% data reusables.profile.access_org %} -{% data reusables.organizations.org_settings %} -{% data reusables.organizations.security %} -{% data reusables.repositories.opt-out-automated-security-updates %} - -### Leia mais - -- "[Sobre alertas de segurança para dependências vulneráveis](/articles/about-security-alerts-for-vulnerable-dependencies)" -- "[Opting into data use for your private repository](/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-data-use-for-your-private-repository#opting-into-data-use-for-your-private-repository)" -- "[Supported package ecosystems](/github/visualizing-repository-data-with-graphs/listing-the-packages-that-a-repository-depends-on#supported-package-ecosystems)" diff --git a/translations/pt-BR/content/github/managing-security-vulnerabilities/managing-alerts-for-vulnerable-dependencies-in-your-organization.md b/translations/pt-BR/content/github/managing-security-vulnerabilities/managing-alerts-for-vulnerable-dependencies-in-your-organization.md deleted file mode 100644 index 3d5455fdc86f..000000000000 --- a/translations/pt-BR/content/github/managing-security-vulnerabilities/managing-alerts-for-vulnerable-dependencies-in-your-organization.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: Gerenciar alertas para dependências vulneráveis na organização -intro: 'Os proprietários e administradores de repositórios da organização recebem {% data variables.product.prodname_dependabot_alerts %} quando detectamos uma dependência vulnerável no repositório de uma organização. Você pode especificar outros membros ou equipes com acesso de gravação para também receber alertas de dependências vulneráveis.' -redirect_from: - - /articles/managing-alerts-for-vulnerable-dependencies-in-your-organization-s-repositories/ - - /articles/managing-alerts-for-vulnerable-dependencies-in-your-organizations-repositories/ - - /articles/managing-alerts-for-vulnerable-dependencies-in-your-organization -versions: - free-pro-team: '*' ---- - -{% if currentVersion == "free-pro-team@latest" %} -{% data reusables.repositories.you-can-manage-access-to-security-alerts %} -{% endif %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -3. Na barra lateral esquerda, clique em **alertas do Dependabot**. ![Aba de alertas do Dependabot na barra lateral de configurações](/assets/images/help/settings/settings-sidebar-dependabot-alerts.png) -4. Digite o nome da pessoa ou equipe que você gostaria de receber {% data variables.product.prodname_dependabot_alerts %} quando {% data variables.product.product_name %} detectar uma dependência vulnerável e, em seguida, clique no nome do usuário ou equipe para selecioná-lo. -5. Após selecionar todas as pessoas ou equipes que deseja receber {% data variables.product.prodname_dependabot_alerts %}, clique em **Salvar alterações**. - -### Further reading - -- "[Sobre alertas para dependências vulneráveis](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)" -- "[Exibir e atualizar dependências vulneráveis no repositório](/articles/viewing-and-updating-vulnerable-dependencies-in-your-repository)" -- "[Gerenciando configurações de segurança e análise para sua organização](/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization)" diff --git a/translations/pt-BR/content/github/searching-for-information-on-github/searching-code-for-exact-matches.md b/translations/pt-BR/content/github/searching-for-information-on-github/searching-code-for-exact-matches.md deleted file mode 100644 index 997da9383a30..000000000000 --- a/translations/pt-BR/content/github/searching-for-information-on-github/searching-code-for-exact-matches.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: Searching code for exact matches -intro: 'You can search code for exact matches in repositories on {% data variables.product.prodname_dotcom %}.' -redirect_from: - - /github/searching-for-information-on-github/searching-files-in-a-repository-for-exact-matches -permissions: People with read permissions to a repository can search the repository's files for exact matches. -versions: - free-pro-team: '*' ---- - -{% note %} - -{% data reusables.search.exact-match-beta %} To request access to the beta, [join the waitlist](https://github.com/features/code-search-exact-match/signup). - -{% endnote %} - -### About searching code for exact matches - -{% data reusables.search.exact-match %} - -By default, searches for exact matches are case and symbol-sensitive, and don't include partial matches or normalized grammar. For example, searching for `let ReactDOM*` will only return `let ReactDOM*`. - -### Searching code for exact matches - -{% note %} - -Searching files within a repository for exact matches only works with indexed repositories for the beta release. - -{% endnote %} - -{% data reusables.repositories.navigate-to-repo %} -2. In the search field, type the string you'd like to find. ![Exact match search string](/assets/images/help/search/exact-match-search-string.png) -3. Optionally, click the **Options** drop-down to narrow your search. ![Exact match search Options drop-down](/assets/images/help/search/exact-match-options.png) -4. Press Enter or Return on your keyboard. -5. In the list of results, click the file. - -### Leia mais - -- "[Pesquisar código](/github/searching-for-information-on-github/searching-code)" -- "[Navigating code on {% data variables.product.product_name %}](/github/managing-files-in-a-repository/navigating-code-on-github)" diff --git a/translations/pt-BR/content/github/site-policy/github-enterprise-cloud-addendum.md b/translations/pt-BR/content/github/site-policy/github-enterprise-cloud-addendum.md deleted file mode 100644 index cb28c16aa421..000000000000 --- a/translations/pt-BR/content/github/site-policy/github-enterprise-cloud-addendum.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: Adendo do GitHub Enterprise Cloud -redirect_from: - - /github-business-cloud-addendum/ - - /articles/github-enterprise-cloud-addendum -versions: - free-pro-team: '*' ---- - -Estes são os termos adicionais para o GitHub Enterprise Cloud ("Termos do Enterprise Cloud"). Quaisquer termos capitalizados não definidos nestes Termos do Enterprise Cloud serão definidos nos [Termos de Serviço](/articles/github-terms-of-service/) ou nos [Termos de Serviço Corporativos](/articles/github-corporate-terms-of-service/). Ao concordar com estes Termos do Enterprise Cloud, você também concorda com os Termos de Serviço, conforme determinado pelo tipo de conta que você tem. - -O Enterprise Cloud inclui uma conta da organização, login único SAML, provisionamento de acesso e suporte 24 horas por dia, 5 dias por semana, com um tempo de resposta de 8 horas. Esta lista de recursos e serviços não é completa e pode ser atualizada de tempos em tempos. Para obter mais informações, consulte a "[página de preços do GitHub](https://github.com/pricing)". - -### Definições: -- Usuário ativo: usuário que tenta acessar nosso Serviço no momento de uma pane. -- Cliente: pessoa ou entidade que comprou o Enterprise Cloud do GitHub. -- Usuário Elegível: um indivíduo designado como membro da organização Enterprise Cloud do cliente por ter sua conta GitHub individual associada à conta Enterprise Cloud do cliente. -- Serviços essenciais: serviços essenciais para a funcionalidade de controle da versão principal do GitHub, incluindo recursos e serviços como criação, bifurcação e clonagem de reporsitórios; criação, commit e merge de branches; criação, revisão e merge de pull requests; e interfaces de cliente Git, API e web para os fluxos de trabalho principais do Git. Estes são exemplos de serviços e recursos periféricos não incluídos: webhooks, Gists, Pages e notificações por e-mail. -- Pane: interrupção de um Serviço essencial que afeta mais de 50% dos Usuários Ativos. -- Crédito de serviço: um crédito em dólar, calculado conforme estabelecido abaixo, que o GitHub pode creditar de volta em uma conta qualificada. - -### SLA do tempo de atividade no Enterprise Cloud - -Benefícios do Programa: -- Garantimos que o serviço terá um tempo de atividade trimestral de 99,95%. Isso significa que os Serviços essenciais do GitHub não serão interrompidos por uma pane que afete mais de 50% dos Usuários ativos, por mais de 0,05% do trimestre. -- Se não cumprirmos essa garantia de tempo de atividade trimestral de 99,95%, poderemos emitir Créditos de Serviço aos clientes. - -Como calculamos o Tempo de Atividade? -- Nosso cálculo do tempo de atividade do é baseado na porcentagem de solicitações bem-sucedidas que ele atende por meio de interfaces de cliente Git, API e web. - -O que está excluído da nossa garantia de tempo de atividade? Panes resultantes de: -- Atos, omissões ou uso indevido dos Serviços pelo cliente, incluindo violações dos Termos de Serviço. -- Falhas na sua conectividade com a internet -- Fatores fora do nosso controle razoável, incluindo problemas relacionados ao acesso à internet, eventos de força maior e serviços ou tecnologia de terceiros -- Seus equipamentos, serviços ou outra tecnologia - -O que são Créditos de Serviço de Tempo de Atividade, como posso descobrir se os tenho, e como posso resgatá-los? -- Se o percentual de tempo de atividade trimestral do GitHub cair abaixo da garantia de 99,95%, o Cliente terá direito de receber um valor equivalente a 25 vezes o valor pago pelo tempo de Pane que exceder a garantia de tempo de atividade trimestral ("Crédito de Serviço por Tempo de Atividade"), que será aplicado na próxima fatura do Cliente. Os Créditos de Serviço por Tempo de Atividade são calculados no final de cada trimestre e só podem ser concedidos mediante solicitação. -- Para saber mais sobre o percentual de tempo de atividade do GitHub, você pode solicitar um relatório de tempo de atividade no final de cada trimestre. -- Para receber Créditos de Serviço por Tempo de Atividade, um gerente de cobrança ou proprietário de conta deve enviar um pedido por escrito em nome do Cliente, no prazo de 30 dias a partir do final de cada trimestre. Os Créditos de Serviço por Tempo de Atividade não podem ser poupados. Após ser concedido um Crédito de Serviço por Tempo de Atividade, ele será aplicado automaticamente à próxima fatura do Cliente. Solicitações por escrito devem ser enviadas para {% data variables.contact.contact_support %}. - -**Isenção e Limitação de Responsabilidade:**a [Página de Status](https://www.githubstatus.com/) do GitHub não está conectada à SLA de Tempo de Atividade e não é uma representação precisa do Tempo de atividade do GitHub para fins de cálculo de Créditos de Serviço por Tempo de Atividade. Os Créditos de Serviço são limitados a 30 dias de serviço pago, por trimestre. Os Créditos de Serviço são a única reparação do Cliente por qualquer falha do GitHub em cumprir com as obrigações de Tempo de atividade identificadas neste Adendo. diff --git a/translations/pt-BR/content/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-data-use-for-your-private-repository.md b/translations/pt-BR/content/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-data-use-for-your-private-repository.md deleted file mode 100644 index aabdc337cd12..000000000000 --- a/translations/pt-BR/content/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-data-use-for-your-private-repository.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: Aceitar ou recusar o uso de dados no repositório privado -intro: 'Para ajudar o {% data variables.product.product_name %} a conectar você a ferramentas, pessoas, projetos e informações relevantes, você pode aceitar o uso de dados no repositório privado. Se você aceitou o uso de dados em seu repositório privado e não quer mais que o {% data variables.product.product_name %} use seus dados, você pode recusar.' -redirect_from: - - /articles/opting-into-or-out-of-data-use-for-your-private-repository -versions: - free-pro-team: '*' ---- - -### About data use for your private repository - -Ao aceitar o uso de dados no seu repositório privado, você poderá acessar o gráfico de dependências, que possibilita o rastreamento das dependências do repositório e o recebimento de alertas de segurança quando o {% data variables.product.product_name %} detecta dependências vulneráveis. Para obter mais informações, consulte "[Sobre alertas de segurança para dependências vulineráveis](/articles/about-security-alerts-for-vulnerable-dependencies)" - -{% data reusables.repositories.you-can-enable-or-disable-security-features %} - -### Aceitar o uso de dados no repositório privado - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -3. Em "Data services" (Serviços de Dados), selecione **Allow {% data variables.product.prodname_dotcom %} to perform read-only analysis of this repository** (Permitir que o {% data variables.product.prodname_dotcom %} faça análises somente leitura neste repositório) . ![Caixa de seleção para permitir que o {% data variables.product.prodname_dotcom %} faça análises somente leitura neste repositório](/assets/images/help/repository/private-repo-data-use-opt-in.png) -4. Opcionalmente, marque a caixa de seleção ao lado de cada serviço adicional para o qual você deseja habilitar o uso de dados. ![Lista de serviços adicionais com as suas próprias caixas de seleção](/assets/images/help/repository/private-repo-data-use-additional-services.png) - -### Recusar o uso de dados no repositório privado - -{% tip %} - -**Dica:** para recusar o uso de dados em serviços específicos, desmarque a caixa de seleção ao lado do serviço. - -{% endtip %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -3. Em "Data services" (Serviços de Dados), desmarque **Allow {% data variables.product.prodname_dotcom %} to perform read-only analysis of this repository** (Permitir que o {% data variables.product.prodname_dotcom %} faça análises somente leitura neste repositório) . ![Caixa de seleção para não permitir que o {% data variables.product.prodname_dotcom %} faça análises somente leitura neste repositório](/assets/images/help/repository/private-repo-data-use-opt-out.png) - -### Leia mais - -- "[Sobre o uso de seus dados pelo {% data variables.product.prodname_dotcom %}](/articles/about-github-s-use-of-your-data)" -- "[Exibir e atualizar dependências vulneráveis no repositório](/articles/viewing-and-updating-vulnerable-dependencies-in-your-repository)" -- "[Gerenciar alertas para dependências vulneráveis nos repositórios da sua organização](/articles/managing-alerts-for-vulnerable-dependencies-in-your-organization-s-repositories)" diff --git a/translations/pt-BR/content/github/using-git/changing-author-info.md b/translations/pt-BR/content/github/using-git/changing-author-info.md deleted file mode 100644 index f9912ac01c15..000000000000 --- a/translations/pt-BR/content/github/using-git/changing-author-info.md +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Alterar informações de autor -redirect_from: - - /change-author-info/ - - /changing-author-info/ - - /articles/changing-author-info -intro: 'Para alterar o nome e/ou endereço de e-mail registrado em commits existentes, você deve reescrever todo o histórico do seu repositório Git.' -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -{% warning %} - -**Aviso**: esta ação é destrutiva para o histórico do repositório. Se você estiver colaborando em um repositório com outras pessoas, não é uma boa ideia reescrever o histórico publicado. Você só deve fazer isso em caso de emergência. - -{% endwarning %} - -### Alterar o histórico do seu repositório no Git usando um script - -Criamos um script que vai alterar todos os commits que anteriormente tinham o endereço de e-mail antigo em seus campos de autor ou committer para usar o nome e o endereço de e-mail corretos. - -{% tip %} - -**Observação**: executar esse script reescreve o histórico de todos os colaboradores do repositório. Após conclusão dessas etapas, qualquer pessoa com bifurcações ou clones devem fazer fetch do histórico reescrito e fazer rebase de todas as alterações locais no histórico reescrito. - -{% endtip %} - -Antes de executar esse script, você precisará: - -* Do endereço de e-mail antigo que aparece nos campos de autor/commiter que deseja alterar -* Do nome e endereço de e-mail corretos aos quais deseja que os commits sejam atribuídos - -{% data reusables.command_line.open_the_multi_os_terminal %} -2. Crie um clone vazio do seu repositório: - ```shell - git clone --bare https://{% data variables.command_line.codeblock %}/user/repo.git - cd repo.git - ``` -3. Copie e cole o script, substituindo as seguintes variáveis com base nas informações coletadas: - * `OLD_EMAIL` - * `CORRECT_NAME` - * `CORRECT_EMAIL` - - ```shell - #!/bin/sh - - git filter-branch --env-filter ' - - OLD_EMAIL="your-old-email@example.com" - CORRECT_NAME="Your Correct Name" - CORRECT_EMAIL="your-correct-email@example.com" - - if [ "$GIT_COMMITTER_EMAIL" = "$OLD_EMAIL" ] - then - export GIT_COMMITTER_NAME="$CORRECT_NAME" - export GIT_COMMITTER_EMAIL="$CORRECT_EMAIL" - fi - if [ "$GIT_AUTHOR_EMAIL" = "$OLD_EMAIL" ] - then - export GIT_AUTHOR_NAME="$CORRECT_NAME" - export GIT_AUTHOR_EMAIL="$CORRECT_EMAIL" - fi - ' --tag-name-filter cat -- --branches --tags - ``` - -4. Pressione **Enter** para executar o script. -5. Revise o novo histórico do Git a fim de verificar se há erros. -6. Publique o histórico corrigido no {% data variables.product.product_name %}: - ```shell - git push --force --tags origin 'refs/heads/*' - ``` -7. Limpe o clone temporário: - ```shell - cd .. - rm -rf repo.git - ``` diff --git a/translations/pt-BR/content/github/using-git/updating-credentials-from-the-osx-keychain.md b/translations/pt-BR/content/github/using-git/updating-credentials-from-the-osx-keychain.md deleted file mode 100644 index fd54786c10e4..000000000000 --- a/translations/pt-BR/content/github/using-git/updating-credentials-from-the-osx-keychain.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: Atualizar credenciais da keychain OSX -intro: 'You''ll need to update your saved credentials in the `git-credential-osxkeychain` helper if you change your username, password, or personal access token on {% data variables.product.product_name %}.' -redirect_from: - - /articles/updating-credentials-from-the-osx-keychain -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -{% data reusables.user_settings.password-authentication-deprecation %} - -### Atualizar credenciais pelo Keychain Access - -1. Procure o app **Keychain Access** (Acesso a keychain) no Finder (Localizador). ![Barra de pesquisa do Spotlight](/assets/images/help/setup/keychain-access.png) -2. No Keychain Access, procure por **{% data variables.command_line.backticks %}**. -3. Localize a entrada "internet password" (senha da internet) referente a `{% data variables.command_line.backticks %}`. ![Entrada de senha do GitHub na keychain](/assets/images/help/setup/keychain-entry.png) -4. Edite ou exclua a entrada de acordo. - -### Excluir credenciais pela linha de comando - -É possível usar o auxiliar de credenciais diretamente na linha de comando para apagar a entrada de keychain. - -Para fazer isso, digite este comando: - -```shell -$ git credential-osxkeychain erase -host={% data variables.command_line.codeblock %} -protocol=https -> [Pressione Return] -``` - -Se a ação for bem-sucedida, nada será impresso. Para testar se funcionou, experimente clonar um repositório do {% data variables.product.product_location %}. Se for solicitada uma senha, significa que a entrada de keychain foi excluída. - -### Leia mais - -- "[Caching your {% data variables.product.prodname_dotcom %} credentials in Git](/github/using-git/caching-your-github-credentials-in-git/)" diff --git a/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository.md b/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository.md deleted file mode 100644 index 7ba3908d5cfc..000000000000 --- a/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository.md +++ /dev/null @@ -1,65 +0,0 @@ ---- -title: Exploring the dependencies and dependents of a repository -intro: 'Using the dependency graph, you can see the packages your project depends on and the repositories that depend on it. In addition, you can see any vulnerabilities detected in its dependencies.' -redirect_from: - - /articles/listing-the-packages-that-a-repository-depends-on - - /github/visualizing-repository-data-with-graphs/listing-the-packages-that-a-repository-depends-on - - /articles/listing-the-projects-that-depend-on-a-repository - - /github/visualizing-repository-data-with-graphs/listing-the-projects-that-depend-on-a-repository -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -### Viewing the dependency graph - -{% data reusables.repositories.enable-security-alerts %} - -The dependency graph has tabs that show the dependencies and dependents of your repository. For information about how these views are populated and which ecosystems are supported, see "[About the dependency graph](about-the-dependency-graph)." - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.accessing-repository-graphs %} -{% data reusables.repositories.click-dependency-graph %} -4. Optionally, under "Dependency graph", click **Dependents**. ![Aba Dependents (Dependentes) na página dependency graph (gráfico de dependências)](/assets/images/help/graphs/dependency-graph-dependents-tab.png) - -#### Dependencies view - -Dependencies are grouped by ecosystem. You can expand a dependency to view its dependencies. For dependencies hosted on {% data variables.product.product_name %}, you can also click a dependency to view the repository. If vulnerabilities have been detected in the repository, these are shown at the top of the view for users with access to {% if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %}. - -![Gráfico de dependências](/assets/images/help/graphs/dependencies_graph.png) - -#### Dependents view - -For public repositories, the dependents view shows how the repository is used by other repositories. To show only the repositories that contain a library in a package manager, click **NUMBER Packages** immediately above the list of dependent repositories. The dependent counts are approximate and may not always match the dependents listed. - -![gráfico de dependentes](/assets/images/help/graphs/dependents_graph.png) - -{% if currentVersion == "free-pro-team@latest" %} -### Enabling and disabling the dependency graph for a private repository - -Repository administrators can enable or disable the dependency graph for private repositories. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -{% data reusables.repositories.navigate-to-security-and-analysis %} -4. Read the message about granting {% data variables.product.product_name %} read-only access to the repository data to enable the dependency graph, then next to "Dependency Graph", click **Enable**. !["Enable" button for the dependency graph](/assets/images/help/repository/dependency-graph-enable-button.png) - -You can disable the dependency graph at any time by clicking **Disable** next to "Dependency Graph" on the Security & analysis tab. -{% endif %} - -### Solução de problemas para o gráfico de dependências - -If your dependency graph is empty, there may be a problem with the file containing your dependencies. Check the file to ensure that it's correctly formatted for the file type. - -{% if currentVersion == "free-pro-team@latest" %} -If the file is correctly formatted, then check its size. The dependency graph ignores individual manifest and lock files that are over 0.5 Mb, unless you are a {% data variables.product.prodname_enterprise %} user. It processes up to 20 manifest or lock files per repository by default, so you can split dependencies into smaller files in subdirectories of the repository.{% endif %} - -If a manifest or lock file is not processed, its dependencies are omitted from the dependency graph and they can't be checked for vulnerable dependencies. - -### Leia mais - -- "[About the dependency graph](about-the-dependency-graph)"{% if currentVersion == "free-pro-team@latest" %} -- "[Visualizar informações da organização](/github/setting-up-and-managing-organizations-and-teams/viewing-insights-for-your-organization)" -- "[Exibir e atualizar dependências vulneráveis no repositório](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository)" -- "[Entender como o {% data variables.product.product_name %} usa e protege seus dados](/github/understanding-how-github-uses-and-protects-your-data)" -{% endif %} diff --git a/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/listing-the-packages-that-a-repository-depends-on.md b/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/listing-the-packages-that-a-repository-depends-on.md deleted file mode 100644 index 4fd4ef35bf38..000000000000 --- a/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/listing-the-packages-that-a-repository-depends-on.md +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: Listar os pacotes dos quais o repositório depende -intro: 'No gráfico de dependências, você pode ver as dependências de seu projeto, assim como quaisquer vulnerabilidades detectadas.' -redirect_from: - - /articles/listing-the-packages-that-a-repository-depends-on -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -### Sobre o gráfico de dependências - -The dependency graph is available for every{% if currentVersion == "free-pro-team@latest" %} public{% endif %} repository that define dependencies in a supported package ecosystem using a supported file format.{% if currentVersion == "free-pro-team@latest" %} Repository administrators can also set up the dependency graph for private repositories.{% endif %} - -{% data reusables.repositories.enable-security-alerts %} - -Você pode visualizar e atualizar dependências vulneráveis no gráfico de dependências do repositório. O gráfico de dependências lista dependências vulneráveis antes de outras dependências. Para obter mais informações, consulte "[Sobre alertas de segurança para dependências vulneráveis](/articles/about-security-alerts-for-vulnerable-dependencies)". - -{% if currentVersion == "free-pro-team@latest" %} -Você pode visualizar as dependências usadas em repositórios da organização em um painel único. Para obter mais informações, consulte "[Visualizar informações na organização](/articles/viewing-insights-for-your-organization#viewing-organization-dependency-insights)".{% endif %} - -### Supported package ecosystems - -| Gerenciador de pacotes | Linguagem | Formatos recomendados | Formatos compatíveis | -| ---------------------- | -------------------------------- | ------------------------------------------------------ | ------------------------------------------------------------------------- | -| Maven | Java, Scala | `pom.xml` | `pom.xml` | -| npm | JavaScript | `package-lock.json` | `package-lock.json`, `package.json` | -| Yarn | JavaScript | `yarn.lock` | `package.json`, `yarn.lock` | -| `dotnet` CLI | .NET languages (C#, C++, F#, VB) | `.csproj`, `.vbproj`, `.nuspec`, `.vcxproj`, `.fsproj` | `.csproj`, `.vbproj`, `.nuspec`, `.vcxproj`, `.fsproj`, `packages.config` | -| Python PIP | Python | `requirements.txt`, `pipfile.lock` | `requirements.txt`, `pipfile.lock`, `setup.py`* | -| RubyGems | Ruby | `Gemfile.lock` | `Gemfile.lock`,`Gemfile`, `*.gemspec` | -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}| Composer | PHP | `composer.lock` | `composer.json`, `composer.lock` |{% endif %} - -{% note %} - -**Observação:** se você listar suas dependências Python em um arquivo `setup.py`, pode não ser possível analisar, listar e alertar sobre cada dependência de seu projeto. - -{% endnote %} - -### Listar dependências em um repositório com gráfico de dependências habilitado - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.accessing-repository-graphs %} -{% data reusables.repositories.click-dependency-graph %} - -{% if currentVersion == "free-pro-team@latest" %} -### Habilitar o gráfico de dependências em um repositório privado - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.accessing-repository-graphs %} -{% data reusables.repositories.click-dependency-graph %} -4. Leia a mensagem sobre concessão de {% data variables.product.product_name %} acesso a dados de repositórios para habilitar o gráfico de dependências e depois clique em **Allow access** (Habilitar acesso). ![Botão para permitir acesso a dados do repositório para habilitar o gráfico de dependências](/assets/images/help/repository/dependency-graph-allow-access-button.png) - -Para obter mais informações, consulte "[Entender como o {% data variables.product.product_name %} usa e protege seus dados](/categories/understanding-how-github-uses-and-protects-your-data)". - -### Desabilitar o gráfico de dependências em um repositório privado - -{% data reusables.repositories.you-can-enable-or-disable-security-features %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -3. Em "Data services" (Serviços de dados), desmarque **Dependency graph** (Gráfico de dependências). ![Caixa de seleção para desabilitar o gráfico de dependências](/assets/images/help/repository/private-repo-data-use-dependency-graph-disabled.png) - -Para optar por recusar o uso de dados do repositório, consulte "[Aceitar ou recusar o uso de dados do repositório privado](/articles/opting-into-or-out-of-data-use-for-your-private-repository)". -{% endif %} - -### Solução de problemas para o gráfico de dependências - -{% data reusables.repositories.troubleshooting-dependency-graph %} - -### Leia mais - -- "[Listar os projetos com dependências em um repositório](/articles/listing-the-projects-that-depend-on-a-repository)"{% if currentVersion == "free-pro-team@latest" %} -- "[Entender como o {% data variables.product.product_name %} usa e protege seus dados](/categories/understanding-how-github-uses-and-protects-your-data)" -- "[Exibir e atualizar dependências vulneráveis no repositório](/articles/viewing-and-updating-vulnerable-dependencies-in-your-repository)"{% endif %} diff --git a/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/listing-the-projects-that-depend-on-a-repository.md b/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/listing-the-projects-that-depend-on-a-repository.md deleted file mode 100644 index c43d4616adaa..000000000000 --- a/translations/pt-BR/content/github/visualizing-repository-data-with-graphs/listing-the-projects-that-depend-on-a-repository.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: Listar os projetos dependentes de um repositório -intro: É possível visualizar pacotes e projetos que dependem de um repositório em um gráfico de dependentes. -redirect_from: - - /articles/listing-the-projects-that-depend-on-a-repository -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -### Sobre o gráfico de dependentes -O gráfico de dependentes contém dados de pacotes e aplicativos. Pacotes são repositórios que possuem uma biblioteca em um gerenciador de pacotes, enquanto aplicativos são repositórios que dependem do repositório selecionado. A lista de aplicativos no gráfico de dependentes é categorizada pelo projeto mais recente que depende de um repositório. - -O gráfico de dependentes contém dados para estas linguagens: - -- RubyGems -- NPM -- PyPI -- Maven (somente pom.xml) -- Nuget - -{% data reusables.repositories.enable-security-alerts %} - -{% note %} - -**Observação:** a contagem de dependentes é aproximada e pode não corresponder à lista de dependentes. - -{% endnote %} - -![gráfico de dependentes](/assets/images/help/graphs/dependents_graph.png) - -### Acessar o gráfico de dependentes - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.accessing-repository-graphs %} -{% data reusables.repositories.click-dependency-graph %} -4. Em "Dependency graph" (Gráfico de dependências), clique em **Dependents** (Dependentes). ![Aba Dependents (Dependentes) na página dependency graph (gráfico de dependências)](/assets/images/help/graphs/dependency-graph-dependents-tab.png) - -### Leia mais - -- "[Listar os pacotes dos quais um repositório depende](/articles/listing-the-packages-that-a-repository-depends-on)"{% if currentVersion == "free-pro-team@latest" %} -- "[Visualizar informações da organização](/articles/viewing-insights-for-your-organization)"{% endif %} diff --git a/translations/pt-BR/content/rest/reference/endpoints-available-for-github-apps.md b/translations/pt-BR/content/rest/reference/endpoints-available-for-github-apps.md deleted file mode 100644 index 7444c977520a..000000000000 --- a/translations/pt-BR/content/rest/reference/endpoints-available-for-github-apps.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: Endpoints available for GitHub Apps -intro: Your app can make requests to the following REST endpoints. -redirect_from: - - /v3/apps/available-endpoints -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -You must use an installation access token to access endpoints using your {% data variables.product.prodname_github_app %}. For more information, see "[Authenticating with {% data variables.product.prodname_github_apps %}](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)." - -{% include rest_enabled_for_github_apps_in_current_version %} diff --git a/translations/pt-BR/data/reusables/actions/actions-app-read-permissions-sh-org.md b/translations/pt-BR/data/reusables/actions/actions-app-read-permissions-sh-org.md deleted file mode 100644 index 2a7ae651d6e5..000000000000 --- a/translations/pt-BR/data/reusables/actions/actions-app-read-permissions-sh-org.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_github_app %}s devem ter permissão da organização `self-hosted runners:read` para acessar o ponto final. \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/actions/actions-app-secrets-org-permissions.md b/translations/pt-BR/data/reusables/actions/actions-app-secrets-org-permissions.md deleted file mode 100644 index cef21c50e488..000000000000 --- a/translations/pt-BR/data/reusables/actions/actions-app-secrets-org-permissions.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_github_app %}s devem ter permissão da organização `secrets` para acessar o ponto final. \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/actions/actions-app-secrets-permissions.md b/translations/pt-BR/data/reusables/actions/actions-app-secrets-permissions.md deleted file mode 100644 index cda8c994f653..000000000000 --- a/translations/pt-BR/data/reusables/actions/actions-app-secrets-permissions.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_github_app %}s devem ter permissão da organização `secrets` para acessar o ponto de extremidade. \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/actions/actions-app-write-permissions-sh-org.md b/translations/pt-BR/data/reusables/actions/actions-app-write-permissions-sh-org.md deleted file mode 100644 index 7e13e37d98e9..000000000000 --- a/translations/pt-BR/data/reusables/actions/actions-app-write-permissions-sh-org.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_github_app %}s devem ter permissão da organização `self-hosted runners:write` para utilizar este ponto de extremidade. \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/actions/actions-downloads.md b/translations/pt-BR/data/reusables/actions/actions-downloads.md deleted file mode 100644 index e408dbdc760c..000000000000 --- a/translations/pt-BR/data/reusables/actions/actions-downloads.md +++ /dev/null @@ -1 +0,0 @@ -Chame este ponto de extremidade usando a bandeira `-v`, que permite a saída de verbose e permite que você veja a URL de download no cabeçalho. Para baixar o arquivo para o diretório de trabalho atual, especifique o nome do arquivo usando a bandeira `-o`. \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/actions/actions-secret-encyption-examples.md b/translations/pt-BR/data/reusables/actions/actions-secret-encyption-examples.md deleted file mode 100644 index 1fb937139bec..000000000000 --- a/translations/pt-BR/data/reusables/actions/actions-secret-encyption-examples.md +++ /dev/null @@ -1,73 +0,0 @@ -#### Exemplo de criptografia de um segredo usando Node.js - -Criptografe seu segredo usando a biblioteca [tweetsodium](https://github.com/github/tweetsodium). - -```js -const sodium = require('tweetsodium'); - -const key = "base64-encoded-public-key"; -const value = "plain-text-secret"; - -// Converta a mensagem e a chave para Uint8Array's (Buffer implementa essa interface) -const messageBytes = Buffer.from(value); -const keyBytes = Buffer.from(key, 'base64'); - -// Criptografe usando LibSodium. -const encryptedBytes = sodium.seal(messageBytes, keyBytes); - -// Base64 o segredo criptografado -const encrypted = Buffer.from(encryptedBytes).toString('base64'); - -console.log(encrypted); -``` - -#### Exemplo de criptografar um segredo usando Python - -Criptografe seu segredo usando [pynacl](https://pynacl.readthedocs.io/en/stable/public/#nacl-public-sealedbox) com Python 3. - -```py -from base64 import b64encode -from nacl import encoding, public - -def encrypt(public_key: str, secret_value: str) -> str: - """Encrypt a Unicode string using the public key.""" - const sodium = require('tweetsodium'); - -const key = "base64-encoded-public-key"; -const value = "plain-text-secret"; - -// Converta a mensagem e a chave para Uint8Array's (Buffer implementa essa interface) -const messageBytes = Buffer.from(value); -const keyBytes = Buffer.from(key, 'base64'); - -// Criptografe usando LibSodium. -``` - -#### Exemplo de criptografar um segredo usando C\# - -Criptografe seu segredo usando o [Sodium. Core](https://www.nuget.org/packages/Sodium. Core/) package. - -```csharp -var secretValue = System. Text. Encoding.UTF8. GetBytes("mySecret"); -var publicKey = Convert. FromBase64String("2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvvcCU="); - -var sealedPublicKeyBox = Sodium. SealedPublicKeyBox. Create(secretValue, publicKey); Console. WriteLine(Convert. ToBase64String(sealedPublicKeyBox)); -``` - -#### Example encrypting a secret using Ruby - -Criptografe seu segredo usando o gem [rbnacl](https://github.com/RubyCrypto/rbnacl). - -```ruby -require "rbnacl" -require "base64" - -key = Base64.decode64("+ZYvJDZMHUfBkJdyq5Zm9SKqeuBQ4sj+6sfjlH4CgG0=") -public_key = RbNaCl::PublicKey.new(key) - -box = RbNaCl::Boxes::Sealed.from_public_key(public_key) -encrypted_secret = box.encrypt("my_secret") - -# Print the base64 encoded secret -puts Base64.strict_encode64(encrypted_secret) -``` diff --git a/translations/pt-BR/data/reusables/actions/gh-app-actions-read-permissions.md b/translations/pt-BR/data/reusables/actions/gh-app-actions-read-permissions.md deleted file mode 100644 index f5dbcc08e911..000000000000 --- a/translations/pt-BR/data/reusables/actions/gh-app-actions-read-permissions.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_github_app %}s deve ter permissão da `actions:read` para utilizar este ponto de extremidade. \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/actions/gh-app-actions-write-permissions.md b/translations/pt-BR/data/reusables/actions/gh-app-actions-write-permissions.md deleted file mode 100644 index 38b4fde6144a..000000000000 --- a/translations/pt-BR/data/reusables/actions/gh-app-actions-write-permissions.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_github_app %}s deve ter permissão da `actions:write` para utilizar este ponto de extremidade. \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/actions/workflow-route-param-by-name.md b/translations/pt-BR/data/reusables/actions/workflow-route-param-by-name.md deleted file mode 100644 index f8e16e923ba5..000000000000 --- a/translations/pt-BR/data/reusables/actions/workflow-route-param-by-name.md +++ /dev/null @@ -1 +0,0 @@ -Você também pode substituir `:workflow_id` com `:workflow_file_name`. Por exemplo, você poderia usar `main.yml`. \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/actions/workflow-usage.md b/translations/pt-BR/data/reusables/actions/workflow-usage.md deleted file mode 100644 index 9ef86059cb0c..000000000000 --- a/translations/pt-BR/data/reusables/actions/workflow-usage.md +++ /dev/null @@ -1 +0,0 @@ -Os minutos faturáveis só se aplicam aos fluxos de trabalho em repositórios privados que usam executores auto-hospedados do {% data variables.product.prodname_dotcom %}. O uso está listado para cada sistema operacional de executor hospedado {% data variables.product.prodname_dotcom %}- em milissegundos. Qualquer reexecução do trabalho também está incluída no uso. O uso não inclui o multiplicador para os executores do macOS e do Windows e não é arredondado para o minuto inteiro mais próximo. Para obter mais informações, consulte "[Managing billing for {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)". \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/actions/workflow_runs_parameters_table.md b/translations/pt-BR/data/reusables/actions/workflow_runs_parameters_table.md deleted file mode 100644 index 2239e56ccd66..000000000000 --- a/translations/pt-BR/data/reusables/actions/workflow_runs_parameters_table.md +++ /dev/null @@ -1,8 +0,0 @@ -#### Parâmetros - -| Nome | Tipo | Descrição | -| -------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `actor` | `string` | Retorna execuções no fluxo de trabalho de alguém. Use o login para o usuário que criou o `push` associado ao conjunto de verificação ou execução de fluxo de trabalho. | -| `branch` | `string` | Retorna o fluxo de trabalho executado associado a um branch. Use o nome do branch do `push`. | -| `event` | `string` | Retorna a execução do fluxo de trabalho acionada pelo evento especificado. Por exemeplo, `push`, `pull_request` ou `issue`. Para obter mais informações, consulte "[Events that trigger workflows](/actions/automating-your-workflow-with-github-actions/events-that-trigger-workflows)". | -| `status` | `string` | Retorna fluxo de trabalho associado com o comando `status` ou `conclusion` que você especificar. Por exemplo, uma conclusão pode ser `success` ou um status pode ser `completed`. Para obter mais informações, consulte as opções de `status` e `conclusion` disponíveis em "[Create a check run](/v3/checks/runs/#create-a-check-run)." | diff --git a/translations/pt-BR/data/reusables/apps/access_token_parameters_table_and_example.md b/translations/pt-BR/data/reusables/apps/access_token_parameters_table_and_example.md deleted file mode 100644 index 8dc23849bf48..000000000000 --- a/translations/pt-BR/data/reusables/apps/access_token_parameters_table_and_example.md +++ /dev/null @@ -1,13 +0,0 @@ -#### Parâmetros - -| Nome | Tipo | Descrição | -| -------------- | -------- | --------------------------------------------------------------- | -| `access_token` | `string` | O token de acesso OAuth usado para autenticar na API do GitHub. | - -#### Exemplo - -```json -{ - "access_token": "e72e16c7e42f292c6912e7710c838347ae178b4a" -} -``` diff --git a/translations/pt-BR/data/reusables/apps/app_req_account_deletion.md b/translations/pt-BR/data/reusables/apps/app_req_account_deletion.md deleted file mode 100644 index f1054caa471f..000000000000 --- a/translations/pt-BR/data/reusables/apps/app_req_account_deletion.md +++ /dev/null @@ -1 +0,0 @@ -Os aplicativos devem fornecer aos clientes uma forma de excluir sua conta, sem ter que enviar um e-mail ou ligar para uma pessoa de suporte. diff --git a/translations/pt-BR/data/reusables/apps/authenticated_user_access.md b/translations/pt-BR/data/reusables/apps/authenticated_user_access.md deleted file mode 100644 index 26aeae031d58..000000000000 --- a/translations/pt-BR/data/reusables/apps/authenticated_user_access.md +++ /dev/null @@ -1 +0,0 @@ -O usuário autenticado tem permissão explícita para acessar os repositórios que eles possuem, repositórios onde são colaboradores e repositórios que podem acessar por meio de uma associação à organização. diff --git a/translations/pt-BR/data/reusables/apps/authorizations_oauth_tokens_SAML.md b/translations/pt-BR/data/reusables/apps/authorizations_oauth_tokens_SAML.md deleted file mode 100644 index 44025507ab50..000000000000 --- a/translations/pt-BR/data/reusables/apps/authorizations_oauth_tokens_SAML.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -{% warning %} - -**Warning:** Aplicativos devem usar [web application flow](/apps/building-oauth-apps/authorizing-oauth-apps/#web-application-flow) para obter tokens OAuth que funcionam com as organizações do GitHub SAML. Os tokens OAuth criados usando a API de Autorizações não poderão acessar as organizações de GitHub SAML. Para obter mais informações, consulte [blog post](https://developer.github.com/changes/2019-11-05-deprecated-passwords-and-authorizations-api). - -{% endwarning %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/apps/deprecating_applications_api_endpoints.md b/translations/pt-BR/data/reusables/apps/deprecating_applications_api_endpoints.md deleted file mode 100644 index 5140abe6fc6b..000000000000 --- a/translations/pt-BR/data/reusables/apps/deprecating_applications_api_endpoints.md +++ /dev/null @@ -1,9 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -{% warning %} - -**Aviso de método obsoleto:** {% data variables.product.prodname_dotcom %} irá substituir e descontinuar os pontos de extremidade OAuth contendo `access_token` no parâmetro de caminho. Estamos introduzindo novos pontos de extremidade que permitem gerenciar de forma segura os tokens dos aplicativos OAuth usando `access_token` como um parâmetro de entrada.{% if currentVersion == "free-pro-team@latest" %} O aplicativo OAuth API será removido em 5 de maio, 2021.{% endif %} Para mais informações,{% if currentVersion == "free-pro-team@latest" %} incluindo brownouts programados,{% endif %} ver a [blog post](https://developer.github.com/changes/2020-02-14-deprecating-oauth-app-endpoint/). - -{% if currentVersion != "free-pro-team@latest" %} Pontos de extremidade usando um `access_token` no parâmetro de caminho estão atualmente disponíveis e ainda não estão obsoletos no {% data variables.product.prodname_ghe_server %}. {% data variables.product.prodname_dotcom %} anunciará a depreciação e fornecerá um aviso antecipadamente antes de remover o suporte para este recurso.{% endif %} - -{% endwarning %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/apps/deprecating_github_services_ghe_compact.md b/translations/pt-BR/data/reusables/apps/deprecating_github_services_ghe_compact.md deleted file mode 100644 index 32579167b85a..000000000000 --- a/translations/pt-BR/data/reusables/apps/deprecating_github_services_ghe_compact.md +++ /dev/null @@ -1 +0,0 @@ -A versão 2.17 ou superior do GitHub Enterprise não permite mais que os administradores instalem Serviços GitHub. Consulte o [Replacing GitHub Services guide](/v3/guides/replacing-github-services) para obter detalhes. \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/apps/deprecating_oauth_authorizations.md b/translations/pt-BR/data/reusables/apps/deprecating_oauth_authorizations.md deleted file mode 100644 index 43321b063a66..000000000000 --- a/translations/pt-BR/data/reusables/apps/deprecating_oauth_authorizations.md +++ /dev/null @@ -1,9 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -{% warning %} - -**Aviso de Depreciação:** {% data variables.product.prodname_dotcom %} irá cancelar a API de Autorizações OAuth, que é usado por integrações para criar tokens de acesso pessoais e tokens OAuth, e agora você deve criar esses tokens usando nosso fluxo [web application flow](/apps/building-oauth-apps/authorizing-oauth-apps/#web-application-flow).{% if currentVersion == "free-pro-team@latest" %} A API de Autorizações OAuth será removida em 13 de Novembro 2020.{% endif %} Para mais informações,{% if currentVersion == "free-pro-team@latest" %} incluindo brownouts agendados{% endif %} veja a postagem [blog post](https://developer.github.com/changes/2020-02-14-deprecating-oauth-auth-endpoint/). - -{% if currentVersion != "free-pro-team@latest" %} A API de Autorizações OAuth está disponível e ainda não está obsoleta no {% data variables.product.prodname_ghe_server %}. {% data variables.product.prodname_dotcom %} anunciará a depreciação e fornecerá um aviso antecipadamente antes de remover o suporte para este recurso.{% endif %} - -{% endwarning %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/apps/iat_required.md b/translations/pt-BR/data/reusables/apps/iat_required.md deleted file mode 100644 index a36e02971816..000000000000 --- a/translations/pt-BR/data/reusables/apps/iat_required.md +++ /dev/null @@ -1 +0,0 @@ -Você deve usar um [installation access token](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation) para acessar este ponto de extremidade. diff --git a/translations/pt-BR/data/reusables/apps/iat_required_multiple_endpoints.md b/translations/pt-BR/data/reusables/apps/iat_required_multiple_endpoints.md deleted file mode 100644 index 30be3a082d98..000000000000 --- a/translations/pt-BR/data/reusables/apps/iat_required_multiple_endpoints.md +++ /dev/null @@ -1 +0,0 @@ -Você deve usar um [installation access token](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation) para acessar estes pontos de extremidade. diff --git a/translations/pt-BR/data/reusables/apps/jwt_or_client_secret_required.md b/translations/pt-BR/data/reusables/apps/jwt_or_client_secret_required.md deleted file mode 100644 index c055bebb6b00..000000000000 --- a/translations/pt-BR/data/reusables/apps/jwt_or_client_secret_required.md +++ /dev/null @@ -1 +0,0 @@ -GitHub Apps devem usar um [JWT](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) para acessar este ponto de extremidade. Os aplicativos OAuth devem usar [basic authentication](/v3/auth/#basic-authentication) com o ID do cliente e o segredo do cliente para acessar este ponto de extremidade. diff --git a/translations/pt-BR/data/reusables/apps/jwt_required.md b/translations/pt-BR/data/reusables/apps/jwt_required.md deleted file mode 100644 index e8c9abc48e06..000000000000 --- a/translations/pt-BR/data/reusables/apps/jwt_required.md +++ /dev/null @@ -1 +0,0 @@ -Você deve usar um [JWT](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) para acessar este ponto de extremidade. diff --git a/translations/pt-BR/data/reusables/apps/null-headbranch.md b/translations/pt-BR/data/reusables/apps/null-headbranch.md deleted file mode 100644 index d303803f5947..000000000000 --- a/translations/pt-BR/data/reusables/apps/null-headbranch.md +++ /dev/null @@ -1 +0,0 @@ -A API de verificação procura apenas por pushes no repositório onde o conjunto de verificação ou a execução de verificação foram criados. Pushes para um branch em um repositório bifurcado não foi detectado e retorna um array `pull_requests` vazio e um valor `null` para `head_branch`. diff --git a/translations/pt-BR/data/reusables/apps/pat_or_ba_required.md b/translations/pt-BR/data/reusables/apps/pat_or_ba_required.md deleted file mode 100644 index 868f8993bb48..000000000000 --- a/translations/pt-BR/data/reusables/apps/pat_or_ba_required.md +++ /dev/null @@ -1 +0,0 @@ -Você deve usar um token de acesso pessoal (que pode criar através da [command line](/articles/creating-a-personal-access-token-for-the-command-line/) ou da [OAuth Authorizations API](/v3/oauth_authorizations/#create-a-new-authorization)) ou [Basic Authentication](/v3/auth/#basic-authentication) para acessar este ponto de extremidade. diff --git a/translations/pt-BR/data/reusables/apps/u2s_required.md b/translations/pt-BR/data/reusables/apps/u2s_required.md deleted file mode 100644 index 45dca0108a81..000000000000 --- a/translations/pt-BR/data/reusables/apps/u2s_required.md +++ /dev/null @@ -1 +0,0 @@ -Você deve usar um [user-to-server OAuth access token](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/#identifying-users-on-your-site), criado para um usuário que autorizou seu GitHub App, para acessar este ponto de extremidade. diff --git a/translations/pt-BR/data/reusables/apps/undetected-pushes-to-a-forked-repository-for-check-runs.md b/translations/pt-BR/data/reusables/apps/undetected-pushes-to-a-forked-repository-for-check-runs.md deleted file mode 100644 index b9b3be3a368a..000000000000 --- a/translations/pt-BR/data/reusables/apps/undetected-pushes-to-a-forked-repository-for-check-runs.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Nota:** A API Checks procura apenas por pushes no repositório onde o conjunto de verificação ou execução de verificação foram criadas. Pushes para uma branch em um repositório bifurcado não são detectadas e retorna uma array vazia `pull_requests`. - -{% endnote %} diff --git a/translations/pt-BR/data/reusables/blog/affected_users.md b/translations/pt-BR/data/reusables/blog/affected_users.md deleted file mode 100644 index 37241b0dacbe..000000000000 --- a/translations/pt-BR/data/reusables/blog/affected_users.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Nota**: Esta atualização afeta apenas os usuários do GitHub.com e futuras versões do GitHub Enterprise. - -{% endnote %} diff --git a/translations/pt-BR/data/reusables/branches/apps-permissions.md b/translations/pt-BR/data/reusables/branches/apps-permissions.md deleted file mode 100644 index 9513614f287a..000000000000 --- a/translations/pt-BR/data/reusables/branches/apps-permissions.md +++ /dev/null @@ -1 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}apenas {% data variables.product.prodname_github_app %}s instalados com acesso de `write` à permissão `contents` podem ser adicionados como atores autorizados em uma branch protegida.{% endif %} diff --git a/translations/pt-BR/data/reusables/branches/limits.md b/translations/pt-BR/data/reusables/branches/limits.md deleted file mode 100644 index da06e0ed5ec5..000000000000 --- a/translations/pt-BR/data/reusables/branches/limits.md +++ /dev/null @@ -1 +0,0 @@ -**Nota**: A lista de usuários{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, aplicativos,{% endif %} e equipes no total é limitada a 100 itens. diff --git a/translations/pt-BR/data/reusables/branches/rename-existing-branch.md b/translations/pt-BR/data/reusables/branches/rename-existing-branch.md deleted file mode 100644 index 174a317ddc65..000000000000 --- a/translations/pt-BR/data/reusables/branches/rename-existing-branch.md +++ /dev/null @@ -1,3 +0,0 @@ -While you can rename your repository's existing default branch, {% data variables.product.company_short %} plans to provide tools to simplify the process of renaming the default branch. For more information on these plans, see [`github/renaming`](https://github.com/github/renaming). - -If you have already renamed the default branch, {% data variables.product.prodname_dotcom %} will automatically redirect links on {% if currentVersion ver_gt "enterprise-server@2.22" %} {% data variables.product.product_location_enterprise %}{% else %}{% data variables.product.prodname_dotcom_the_website %}{% endif %} that contain a deleted `master` branch name to the equivalent link on the repository's default branch. diff --git a/translations/pt-BR/data/reusables/checks/conclusion_values.md b/translations/pt-BR/data/reusables/checks/conclusion_values.md deleted file mode 100644 index 0ff5afef5393..000000000000 --- a/translations/pt-BR/data/reusables/checks/conclusion_values.md +++ /dev/null @@ -1 +0,0 @@ -**Obrigatório de você fornecer `completed_at` ou um `status` de `completed`**. A conclusão final da verificação. Pode ser um dos `success`, `failure`, `neutral`, `cancelled`, {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}`skipped`, {% endif %}`timed_out`, ou `action_required`. \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/checks/requested_actions.md b/translations/pt-BR/data/reusables/checks/requested_actions.md deleted file mode 100644 index a49c4f98a4e8..000000000000 --- a/translations/pt-BR/data/reusables/checks/requested_actions.md +++ /dev/null @@ -1 +0,0 @@ -Para saber mais sobre verificações realizadas e ações solicitadas, consulte "[Check runs and requested actions](/v3/checks/runs/#check-runs-and-requested-actions)." diff --git a/translations/pt-BR/data/reusables/cli/beta.md b/translations/pt-BR/data/reusables/cli/beta.md deleted file mode 100644 index 1343ae7748a1..000000000000 --- a/translations/pt-BR/data/reusables/cli/beta.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_cli %} está atualmente em beta e está sujeito a alterações. diff --git a/translations/pt-BR/data/reusables/collaborators/collaborator-definition.md b/translations/pt-BR/data/reusables/collaborators/collaborator-definition.md deleted file mode 100644 index 7b8183d0e594..000000000000 --- a/translations/pt-BR/data/reusables/collaborators/collaborator-definition.md +++ /dev/null @@ -1 +0,0 @@ -a lista de colaboradores inclui colaboradores externos, membros da organização que são colaboradores diretos, integrantes da organização com acesso por meio de associações de equipe, integrantes da organização com acesso por meio das permissões padrão da organização e proprietários da organização. diff --git a/translations/pt-BR/data/reusables/command_line/parameters_filters.md b/translations/pt-BR/data/reusables/command_line/parameters_filters.md deleted file mode 100644 index 818d62791c54..000000000000 --- a/translations/pt-BR/data/reusables/command_line/parameters_filters.md +++ /dev/null @@ -1 +0,0 @@ -Você pode usar parâmetros para restringir a lista de resultados. Para obter mais informações sobre o uso de parâmetros, consulte [Parameters](/v3/#parameters). \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/commits/verification-object-definition.md b/translations/pt-BR/data/reusables/commits/verification-object-definition.md deleted file mode 100644 index ea06a763fcc2..000000000000 --- a/translations/pt-BR/data/reusables/commits/verification-object-definition.md +++ /dev/null @@ -1,28 +0,0 @@ -##### Verificação de assinatura para objetos - -A resposta incluirá um objeto de `verification` que descreve o resultado de verificar a assinatura do commit. Os seguintes campos estão incluídos no objeto `verification`: - -| Nome | Tipo | Descrição | -| ------------ | --------- | ---------------------------------------------------------------------------------------------------- | -| `verificado` | `boolean` | Indica se o GitHub considera verificada a assinatura neste commit. | -| `motivo` | `string` | O motivo do valor `verified`. Possíveis valores e seus significados são enumerados na tabela abaixo. | -| `assinatura` | `string` | A assinatura que foi extraída do commit. | -| `carga` | `string` | O valor que foi assinado. | - -Estes são os possíveis valores para `reason` no objeto `verification`: - -| Valor | Descrição | -| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------ | -| `expired_key` | A chave que fez a assinatura está expirada. | -| `not_signing_key` | A bandeira "assinar" não está entre as bandeiras de uso na chave GPG que fez a assinatura. | -| `gpgverify_error` | Ocorreu um erro ao se comunicar com o serviço de verificação de assinaturas. | -| `gpgverify_unavailable` | O serviço de verificação de assinatura está indisponível no momento. | -| `não assinado` | O objeto não inclui uma assinatura. | -| `unknown_signature_type` | Uma assinatura não PGP foi encontrada no commit. | -| `no_user` | Nenhum usuário foi associado ao endereço de e-mail `committer` no commit. | -| `unverified_email` | O endereço de e-mail `committer` no commit foi associado a um usuário, mas o endereço de e-mail não é verificado na sua conta. | -| `bad_email` | O endereço de e-mail `committer` do commit não está incluído nas identidades da chave PGP que fez a assinatura. | -| `unknown_key` | A chave que fez a assinatura não foi registrada com a conta de nenhum usuário. | -| `malformed_signature` | Ocorreu um erro ao analisar a assinatura. | -| `invalid` | A assinatura não pôde ser verificada criptograficamente usando a chave cuja key-id foi encontrada na assinatura. | -| `valid` | Nenhum dos erros acima aplicados, por isso a assinatura é considerada verificada. | diff --git a/translations/pt-BR/data/reusables/desktop/commit-history-list.md b/translations/pt-BR/data/reusables/desktop/commit-history-list.md deleted file mode 100644 index 8b6c93208e45..000000000000 --- a/translations/pt-BR/data/reusables/desktop/commit-history-list.md +++ /dev/null @@ -1 +0,0 @@ -1. Na lista do histórico de commit, clique no commit que deseja reverter. diff --git a/translations/pt-BR/data/reusables/desktop/enter-2fa-in-browser.md b/translations/pt-BR/data/reusables/desktop/enter-2fa-in-browser.md deleted file mode 100644 index 3a0be4f0521f..000000000000 --- a/translations/pt-BR/data/reusables/desktop/enter-2fa-in-browser.md +++ /dev/null @@ -1 +0,0 @@ -1. Retorne ao {% data variables.product.prodname_dotcom %}. No prompt, insira seu código 2FA e clique em **Verify** (Verificar). ![Campo de autenticação do código 2FA](/assets/images/help/desktop/2fa-code-field.png) diff --git a/translations/pt-BR/data/reusables/desktop/retrieve-2fa-in-browser.md b/translations/pt-BR/data/reusables/desktop/retrieve-2fa-in-browser.md deleted file mode 100644 index 8e78237da2d9..000000000000 --- a/translations/pt-BR/data/reusables/desktop/retrieve-2fa-in-browser.md +++ /dev/null @@ -1,3 +0,0 @@ -1. Se você configurou a autenticação de dois fatores no {% data variables.product.prodname_dotcom %}, execute uma das seguintes opções: - - Se você configurou a 2FA via SMS, recupere seu código 2FA na mensagem SMS. - - Se você configurou a 2FA com um aplicativo TOTP, gere um código 2FA. diff --git a/translations/pt-BR/data/reusables/desktop/windows-select-file-menu.md b/translations/pt-BR/data/reusables/desktop/windows-select-file-menu.md deleted file mode 100644 index 07711d6aea03..000000000000 --- a/translations/pt-BR/data/reusables/desktop/windows-select-file-menu.md +++ /dev/null @@ -1 +0,0 @@ -1. No canto superior esquerdo da janela, selecione o menu **File** (Arquivo). ![Menu do {% data variables.product.prodname_desktop %} na barra de menu do Windows](/assets/images/help/desktop/windows-select-file-menu.png) diff --git a/translations/pt-BR/data/reusables/dotcom_billing/cost-management-tab.md b/translations/pt-BR/data/reusables/dotcom_billing/cost-management-tab.md deleted file mode 100644 index c5aea0fce18b..000000000000 --- a/translations/pt-BR/data/reusables/dotcom_billing/cost-management-tab.md +++ /dev/null @@ -1 +0,0 @@ -1. Em "Billing" (Faturamento), clique em **Cost management** (Gestão de Custos). ![Aba de gestão de custos](/assets/images/help/settings/cost-management-tab.png) diff --git a/translations/pt-BR/data/reusables/dotcom_billing/publishing-nodejs-packages.md b/translations/pt-BR/data/reusables/dotcom_billing/publishing-nodejs-packages.md deleted file mode 100644 index bb3e7c3a0b82..000000000000 --- a/translations/pt-BR/data/reusables/dotcom_billing/publishing-nodejs-packages.md +++ /dev/null @@ -1,203 +0,0 @@ ---- -title: Publicar pacotes do Node.js -intro: Você pode publicar pacotes do Node.js em um registro como parte do seu fluxo de trabalho de integração contínua (CI). -product: '{% data reusables.gated-features.actions %}' -productVersions: - dotcom: '*' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages ---- - -### Introdução - -Este guia mostra como criar um fluxo de trabalho que publica pacotes do Node.js em {% data variables.product.prodname_registry %} e nos registros npm após os testes de integração contínua (CI) serem aprovados. Com um único fluxo de trabalho, você pode publicar pacotes em um único registro ou em vários registros. - -### Pré-requisitos - -Recomendamos que você tenha um entendimento básico das opções de configuração do fluxo de trabalho e de como criar um arquivo do fluxo de trabalho. Para obter mais informações, consulte "[Configurar fluxo de trabalho](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)." - -Para obter mais informações sobre a criação de um fluxo de trabalho de CI para seu projeto Node.js, consulte "[Usando Node.js com {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/using-nodejs-with-github-actions)". - -Você também pode achar útil ter um entendimento básico do seguinte: - -- "[Conceitos básicos para{% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)" -- "[Configurar o npm para uso com o {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)" -- "[Usando variáveis de ambiente](/actions/automating-your-workflow-with-github-actions/using-environment-variables)" -- "[Criar e usar segredos criptografados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)" -- "[Autenticando com o GITHUB_TOKEN](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)" - -### Sobre a configuração do pacote - - Os campos `nome` e `versão` no arquivo *package.json* cria um identificador único que os registros usam para vincular seu pacote a um registro. Você pode adicionar um resumo para página de listagem do pacote ao incluir um campo `descrição` no arquivo *package.json*. Para obter mais informações, consulte "[Criando um pacote package.json](https://docs.npmjs.com/creating-a-package-json-file)" e "[Criando módulos Node.js](https://docs.npmjs.com/creating-node-js-modules)" na documentação do npm. - -Quando um arquivo *.npmrc* local existe e tem um valor de `registro` especificado, o comando `publicação do npm` usa o registro configurado no arquivo *.npmrc*. {% data reusables.github-actions.setup-node-intro %} - -Você pode especificar a versão do Node.js instalada no executor usando a ação `setup-node`. - -Se você adicionar etapas ao seu fluxo de trabalho para configurar os campos `publishConfig` no seu arquivo *package.json*, você não precisará especificar o registry-url usando a ação de `setup-node`. No entanto, você estará limitado à publicação do pacote em um registro. Para obter mais informações, consulte "[publishConfig](https://docs.npmjs.com/files/package.json#publishconfig)" na documentação npm. - -### Publicar pacotes no registro npm - -Cada vez que você criar uma nova versão, você poderá acionar um fluxo de trabalho para publicar o seu pacote. O fluxo de trabalho no exemplo abaixo é executado quando o evento `versão` é acionado com o tipo `criado`. O fluxo de trabalho publica o pacote no registro npm se o teste de CI for aprovado. - -Para executar operações autenticadas com o registro npm em seu fluxo de trabalho, você deverá armazenar seu token de autenticação npm como um segredo nas configurações do repositório. Por exemplo, crie um segredo denominado `NPM_TOKEN`. Para obter mais informações, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". - -Por padrão, o npm usa o campo `nome` do arquivo *package.json* para determinar o registro do npm. Ao publicar em um namespace global, você precisa incluir apenas o nome do pacote. Por exemplo, você publicaria um pacote denominado `npm-hello-world-test` em `https://www.npmjs.com/package/npm-hello-world-test`. - -Se você estiver publicando um pacote que inclui um prefixo de escopo, inclua o escopo no nome do arquivo *package.json*. Por exemplo, se o prefixo de escopo do npm é octocat e o nome do pacote é hello-world, o `nome` no seu arquivo *package.json* deverá ser `@octocat/hello-world`. Se seu pacote npm usar um prefixo de escopo e for público, você deverá usar a opção `npm publish --access public`. Essa é uma opção que o npm requer para impedir que alguém publique um pacote privado de forma não intencional. - -Este exemplo armazena o segredo `NPM_TOKEN` na variável de ambiente `NODE_AUTH_TOKEN`. Quando a ação `setup-node` cria um arquivo *.npmrc*, ela faz referência ao token da variável de ambiente `NODE_AUTH_TOKEN`. - -{% raw %} -```yaml -nome: Pacote Node.js -em: - versão: - tipos: [created] -trabalhos: - criar: - runs-on: ubuntu-latest - etapas: - - usa: actions/checkout@v2 - # Configura o arquivo .npmrc a ser publicado no npm - - usa: actions/setup-node@v1 - com: - node-version: '12.x' - registry-url: 'https://registry.npmjs.org' - - executar: npm install - - executar: npm publish - env: - NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} -``` -{% endraw %} - -No exemplo acima, a ação `setup-node` cria um arquivo *.npmrc* no executor com o conteúdo a seguir: - -``` -//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN} -registry=https://registry.npmjs.org/ -always-auth=true -``` - -### Publicar pacotes em {% data variables.product.prodname_registry %} - -Cada vez que você criar uma nova versão, você poderá acionar um fluxo de trabalho para publicar o seu pacote. O fluxo de trabalho no exemplo abaixo é executado sempre que ocorre o evento `versão` com o tipo `criado`. O fluxo de trabalho publica o pacote em {% data variables.product.prodname_registry %} se o teste de CI for aprovado. - -Por padrão, o {% data variables.product.prodname_registry %} publica um pacote no repositório {% data variables.product.prodname_dotcom %} que você especificar no campo `nome` do arquivo *package.json*. Por exemplo, você publicaria um pacote denominado `@my-org/test` no repositório `my-org/test` do {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte [`npm-scope`](https://docs.npmjs.com/misc/scope) na documentação do npm. - -Para realizar operações autenticadas no registro do {% data variables.product.prodname_registry %} em seu fluxo de trabalho, você pode usar o `GITHUB_TOKEN`. O `GITHUB_TOKEN` existe no repositório por padrão e tem permissões de leitura e gravação para pacotes no repositório em que o fluxo de trabalho é executado. Para obter mais informações, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". - -Este exemplo armazena o segredo `GITHUB_TOKEN` na variável de ambiente `NODE_AUTH_TOKEN`. Quando a ação `setup-node` cria um arquivo *.npmrc*, ela faz referência ao token da variável de ambiente `NODE_AUTH_TOKEN`. - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # Setup .npmrc file to publish to GitHub Packages - - uses: actions/setup-node@v1 - with: - node-version: '12.x' - registry-url: 'https://npm.pkg.github.com' - scope: '@octocat' # Defaults to the user or organization that owns the workflow file - - run: npm install - - run: npm publish - env: - NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} - -A ação `setup-node` cria um arquivo *.npmrc* no executor. Ao usar a entrada do `escopo` para a ação `setup-node`, o arquivo *.npmrc* incluirá o prefixo do escopo. Por padrão, a ação `setup-node` define o escopo no arquivo *.npmrc* na conta que contém esse arquivo do fluxo de trabalho. - -``` -//npm.pkg.github.com/:_authToken=${NODE_AUTH_TOKEN} -@octocat:registry=https://npm.pkg.github.com -always-auth=true -``` - -### Publicar pacotes usando o yarn - -Se você usar o gerenciador de pacotes Yarn, você poderá instalar e publicar pacotes usando o Yarn. - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # Setup .npmrc file to publish to npm - - uses: actions/setup-node@v1 - with: - node-version: '12.x' - registry-url: 'https://registry.npmjs.org' - scope: '@octocat' # Defaults to the user or organization that owns the workflow file - - run: yarn - - run: yarn publish - env: - NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} -``` -{% endraw %} - -### Publicar pacotes no npm e em {% data variables.product.prodname_registry %} - -{% note %} - -**Nota:** Se você precisar publicar para registros que têm diferentes prefixos de escopo, você deverá modificar o arquivo *package.json* no executor para alterar o prefixo de escopo. Por exemplo, se você publicar um pacote no escopo `@mona` para o npm e para o escopo `@octocat` para {% data variables.product.prodname_registry %}, você poderá substituir o escopo `@mona` por `@octocat` no arquivo *package.json* no executor, após fazer a publicação no npm e antes de publicar em {% data variables.product.prodname_registry %}. - -{% endnote %} - -Você pode publicar seus pacotes no registro do npm e em {% data variables.product.prodname_registry %}, usando a ação de `setup-node` para cada registro. - -Se você publicar um pacote em ambos os registros, você deverá garantir que seu prefixo de escopo no npm corresponda ao nome do usuário ou da organização do {% data variables.product.prodname_dotcom %}. Para publicar pacotes em um registro público com um prefixo de escopo, você pode usar o comando `npm publish --access public`. Para obter mais informações, consulte [`npm-scope`](https://docs.npmjs.com/misc/scope) e "[Criar e publicar pacotes públicos com escopos](https://docs.npmjs.com/creating-and-publishing-scoped-public-packages)" na documentação do npm. - -Certifique-se de que seu arquivo *package.json* inclua o escopo do seu repositório {% data variables.product.prodname_dotcom %} e o registro npm. Por exemplo, se você planeja publicar um pacote no repositório `octocat/npm-hello-world-test` em {% data variables.product.prodname_dotcom %} e em https://www.npmjs. om/package/@octocat/npm-hello-world-test, o nome no arquivo do seu *package.json* seria `"name": "@octocat/npm-hello-world-test"`. - -Para realizar operações autenticadas no registro do {% data variables.product.prodname_registry %} em seu fluxo de trabalho, você pode usar o `GITHUB_TOKEN`. O `GITHUB_TOKEN` existe no repositório por padrão e tem permissões de leitura e gravação para pacotes no repositório em que o fluxo de trabalho é executado. Para obter mais informações, consulte "[Criando e usando segredos encriptados](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". - -Ao usar a entrada do `escopo` para a ação `setup-node`, esta cria um arquivo *.npmrc* que inclui o prefixo do escopo. Por padrão, a ação `setup-node` define o escopo no arquivo *.npmrc* para o usuário ou organização proprietário do arquivo do fluxo de trabalho. - -Este fluxo de trabalho chama a ação `setup-node` duas vezes. Cada vez que a ação `setup-node` é executada, ela substitui o arquivo *.npmrc*. O arquivo *.npmrc* faz referência ao token que permite que você execute operações autenticadas com o registro do pacote a partir da variável de ambiente `NODE_AUTH_TOKEN`. O fluxo de trabalho define a variável de ambiente `NODE_AUTH_TOKEN` toda vez que o comando `publicação do npm` é executado. Primeiro com um token para publicar no npm (`NPM_TOKEN`) e, em seguida, com um token para publicar em {% data variables.product.prodname_registry %} (`GITHUB_TOKEN`). - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # Setup .npmrc file to publish to npm - - uses: actions/setup-node@v1 - with: - node-version: '10.x' - registry-url: 'https://registry.npmjs.org' - - run: npm install - # Publish to npm - - run: npm publish --access public - env: - NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} - # Setup .npmrc file to publish to GitHub Packages - - uses: actions/setup-node@v1 - with: - registry-url: 'https://npm.pkg.github.com' - scope: '@octocat' # Defaults to the user or organization that owns the workflow file - # Publish to GitHub Packages - - run: npm publish - env: - NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} diff --git a/translations/pt-BR/data/reusables/enterprise-accounts/business-settings.md b/translations/pt-BR/data/reusables/enterprise-accounts/business-settings.md deleted file mode 100644 index b4cf521f28f4..000000000000 --- a/translations/pt-BR/data/reusables/enterprise-accounts/business-settings.md +++ /dev/null @@ -1 +0,0 @@ -1. Sob o nome da sua conta, clique em {% octicon "gear" aria-label="The Settings gear" %} **Settings**. ![Aba de configurações na página do perfil da empresa](/assets/images/help/business-accounts/business-account-settings-tab.png) diff --git a/translations/pt-BR/data/reusables/enterprise-accounts/github-dotcom-connection-tab.md b/translations/pt-BR/data/reusables/enterprise-accounts/github-dotcom-connection-tab.md deleted file mode 100644 index 24c64a38d7fc..000000000000 --- a/translations/pt-BR/data/reusables/enterprise-accounts/github-dotcom-connection-tab.md +++ /dev/null @@ -1 +0,0 @@ -1. Na barra lateral esquerda, clique em **{% data variables.product.prodname_dotcom_the_website %} connection**. ![Aba de conexão GitHub.com na barra lateral de configurações da conta de negócios](/assets/images/enterprise/business-accounts/settings-github-dotcom-connection-tab.png) diff --git a/translations/pt-BR/data/reusables/enterprise-accounts/member-privileges-tab.md b/translations/pt-BR/data/reusables/enterprise-accounts/member-privileges-tab.md deleted file mode 100644 index 37e5b8632c64..000000000000 --- a/translations/pt-BR/data/reusables/enterprise-accounts/member-privileges-tab.md +++ /dev/null @@ -1 +0,0 @@ -1. Na barra lateral de configurações de negócios, clique em **Member privileges** (privilégios de membros). ![Aba de privilégios de membro na barra lateral de configurações da conta empresarial](/assets/images/help/business-accounts/settings-member-privileges-tab.png) diff --git a/translations/pt-BR/data/reusables/enterprise/ldap_sync_warning.md b/translations/pt-BR/data/reusables/enterprise/ldap_sync_warning.md deleted file mode 100644 index 068c060a16f1..000000000000 --- a/translations/pt-BR/data/reusables/enterprise/ldap_sync_warning.md +++ /dev/null @@ -1,9 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" %} - -{% warning %} - -Se sua instância do {% data variables.product.prodname_ghe_server %} tiver [LDAP Sync enabled and the option to synchronize emails enabled](/enterprise/admin/authentication/using-ldap#enabling-ldap-sync), esta API está desativada e retornará uma resposta `403`. Os usuários gerenciados no LDAP não poderão adicionar ou excluir um endereço de e-mail através da API com estas opções ativadas. - -{% endwarning %} - -{% endif %} diff --git a/translations/pt-BR/data/reusables/enterprise_enterprise_support/sign-in-to-enterprise-portal.md b/translations/pt-BR/data/reusables/enterprise_enterprise_support/sign-in-to-enterprise-portal.md deleted file mode 100644 index d951b25921a2..000000000000 --- a/translations/pt-BR/data/reusables/enterprise_enterprise_support/sign-in-to-enterprise-portal.md +++ /dev/null @@ -1 +0,0 @@ -1. Para entrar no portal de suporte {% data variables.contact.enterprise_portal %}, clique no canto superior direito da página em **Sign in**. ![Entre no {% data variables.contact.enterprise_portal %}](/assets/images/enterprise/support/sign-in-support-portal.png) diff --git a/translations/pt-BR/data/reusables/enterprise_installation/increasing-cpus-max.md b/translations/pt-BR/data/reusables/enterprise_installation/increasing-cpus-max.md deleted file mode 100644 index 0a0ebadd59cc..000000000000 --- a/translations/pt-BR/data/reusables/enterprise_installation/increasing-cpus-max.md +++ /dev/null @@ -1,3 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" %} - {% data reusables.enterprise_installation.increasing-cpus-req %} Quando você usa mais de 16 CPUs, você não precisa adicionar 6.5 GB de memória para cada CPU, mas você deve monitorar sua instância para garantir que ela tenha memória suficiente. -{% endif %} diff --git a/translations/pt-BR/data/reusables/enterprise_installation/resizing-root-disk.md b/translations/pt-BR/data/reusables/enterprise_installation/resizing-root-disk.md deleted file mode 100644 index 042f68a1a65d..000000000000 --- a/translations/pt-BR/data/reusables/enterprise_installation/resizing-root-disk.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Nota:** O disco raiz pode ser redimensionado construindo um novo appliance ou usando um appliance existente. Para obter mais informações, consulte "[Increasing storage capacity](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-storage-capacity)." - -{% endnote %} diff --git a/translations/pt-BR/data/reusables/enterprise_installation/root-and-data-disk-requirement.md b/translations/pt-BR/data/reusables/enterprise_installation/root-and-data-disk-requirement.md deleted file mode 100644 index 52a3179148cc..000000000000 --- a/translations/pt-BR/data/reusables/enterprise_installation/root-and-data-disk-requirement.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_ghe_server %} requer um disco de dados persistente separado do disco raiz. Para obter mais informações, consulte "[System overview](/enterprise/admin/guides/installation/system-overview)." diff --git a/translations/pt-BR/data/reusables/enterprise_installation/storage-disk-requirements.md b/translations/pt-BR/data/reusables/enterprise_installation/storage-disk-requirements.md deleted file mode 100644 index ba0a45103b4c..000000000000 --- a/translations/pt-BR/data/reusables/enterprise_installation/storage-disk-requirements.md +++ /dev/null @@ -1 +0,0 @@ -Para seu dispositivos de armazenamento, recomendamos um SSD de alto desempenho seja anexado diretamente ou de uma rede de área de armazenamento (SAN). diff --git a/translations/pt-BR/data/reusables/enterprise_installation/warning-on-polling.md b/translations/pt-BR/data/reusables/enterprise_installation/warning-on-polling.md deleted file mode 100644 index a144d6e3f0b2..000000000000 --- a/translations/pt-BR/data/reusables/enterprise_installation/warning-on-polling.md +++ /dev/null @@ -1,5 +0,0 @@ -{% warning %} - -**Aviso:** Recomendamos que você use webhooks para buscar alterações de repositório para integração contínua (CI) ou sistemas similares. Verificações automáticas regulares, ou *polling*, reduzirão significativamente a escalabilidade de sua instância. Para obter mais informações, consulte "[Sobre webhooks](/enterprise/{{ currentVersion }}/user/articles/about-webhooks/)" - -{% endwarning %} diff --git a/translations/pt-BR/data/reusables/gated-features/actions-api-gated.md b/translations/pt-BR/data/reusables/gated-features/actions-api-gated.md deleted file mode 100644 index d19eef95d824..000000000000 --- a/translations/pt-BR/data/reusables/gated-features/actions-api-gated.md +++ /dev/null @@ -1,5 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} - -{% data variables.product.prodname_actions %} está disponível com {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_free_team %} para organizações, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %} e {% data variables.product.prodname_ghe_one %}. O {% data variables.product.prodname_actions %} não está disponível para repositórios privados de contas que utilizam planos antigos por-repositório. {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %} - -{% endif %} diff --git a/translations/pt-BR/data/reusables/gated-features/credential-authorizations-org.md b/translations/pt-BR/data/reusables/gated-features/credential-authorizations-org.md deleted file mode 100644 index a0a9f2845771..000000000000 --- a/translations/pt-BR/data/reusables/gated-features/credential-authorizations-org.md +++ /dev/null @@ -1,5 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} - -Listar e excluir autorizações de credenciais está disponível para organizações com {% data variables.product.prodname_ghe_cloud %}. {% data reusables.gated-features.more-info %} - -{% endif %} diff --git a/translations/pt-BR/data/reusables/gated-features/draft-pull-requests.md b/translations/pt-BR/data/reusables/gated-features/draft-pull-requests.md deleted file mode 100644 index 5cd6677339d4..000000000000 --- a/translations/pt-BR/data/reusables/gated-features/draft-pull-requests.md +++ /dev/null @@ -1,2 +0,0 @@ - -Pull requests de rascunho estão disponíveis em repositórios públicos com {% data variables.product.prodname_free_user %} e {% data variables.product.prodname_free_team %} para organizações, {% data variables.product.prodname_pro %} e planos de cobrança antigos por repositório e em repositórios públicos e privados com {% data variables.product.prodname_team %}{% if currentVersion != "free-pro-team@latest" %}, {% data variables.product.prodname_ghe_server %} 2.17+,{% endif %} and {% data variables.product.prodname_ghe_cloud %}.site.data.variables.product.prodname_ghe_cloud }}. {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %} diff --git a/translations/pt-BR/data/reusables/gated-features/policies.md b/translations/pt-BR/data/reusables/gated-features/policies.md deleted file mode 100644 index e71df97a5209..000000000000 --- a/translations/pt-BR/data/reusables/gated-features/policies.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Nota:** {% data variables.product.prodname_policies %} está atualmente em alfa. Esta documentação é confidencial e disponibilizada pela NDA. Não distribuir. - -{% endnote %} \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/gated-features/sponsors-beta.md b/translations/pt-BR/data/reusables/gated-features/sponsors-beta.md deleted file mode 100644 index de589a316568..000000000000 --- a/translations/pt-BR/data/reusables/gated-features/sponsors-beta.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Atenção:** {% data variables.product.prodname_sponsors %} para organizações está atualmente em versão beta e sujeito a alterações. - -{% endnote %} diff --git a/translations/pt-BR/data/reusables/gated-features/team-sync-gated.md b/translations/pt-BR/data/reusables/gated-features/team-sync-gated.md deleted file mode 100644 index 688fc732c9ce..000000000000 --- a/translations/pt-BR/data/reusables/gated-features/team-sync-gated.md +++ /dev/null @@ -1,5 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} - -A sincronização da equipe está disponível para organizações que usam {% data variables.product.prodname_ghe_cloud %}. {% data reusables.gated-features.more-info %} - -{% endif %} diff --git a/translations/pt-BR/data/reusables/github-actions/explains-hello-world-example.md b/translations/pt-BR/data/reusables/github-actions/explains-hello-world-example.md deleted file mode 100644 index 802679c95086..000000000000 --- a/translations/pt-BR/data/reusables/github-actions/explains-hello-world-example.md +++ /dev/null @@ -1 +0,0 @@ -O `OWNER` do repositório `octocat` é a organização e o nome do `REPOSITORY` é `hello-world`. diff --git a/translations/pt-BR/data/reusables/github-actions/github-actions-minutes-change.md b/translations/pt-BR/data/reusables/github-actions/github-actions-minutes-change.md deleted file mode 100644 index 0d3f51e87890..000000000000 --- a/translations/pt-BR/data/reusables/github-actions/github-actions-minutes-change.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Nota:** Depois de maio, 14 de Maio, 2020, {% data variables.product.prodname_team %} incluirá 3.000 {% data variables.product.prodname_actions %} minutos por mês. - -{% endnote %} diff --git a/translations/pt-BR/data/reusables/github-actions/github-actions-usage-limits.md b/translations/pt-BR/data/reusables/github-actions/github-actions-usage-limits.md deleted file mode 100644 index b9c2f9f02f76..000000000000 --- a/translations/pt-BR/data/reusables/github-actions/github-actions-usage-limits.md +++ /dev/null @@ -1,15 +0,0 @@ -Há alguns limites no uso do {% data variables.product.prodname_actions %} , e variará dependendo se você usa executores hospedados {% data variables.product.prodname_dotcom %}ou auto-hospedados. Estes limites estão sujeitos a mudanças. - -- **Tempo de execução de tarefas ** - Cada trabalho em um fluxo de trabalho pode ser executado por até 6 horas de tempo de execução. Se um trabalho atingir esse limite, o trabalho será terminado e não será completado. Este limite não se aplica a executores auto-hospedados. -- **Tempo de execução do fluxo de trabalho** - Cada execução do fluxo de trabalho é limitada a 72 horas. Se a execução de um fluxo de trabalho atingir esse limite, a execução do fluxo de trabalho será cancelada. Este limite também se aplica a executores auto-hospedados. -- **Tempo de fila de tarefas** - Cada trabalho para executores auto-hospedados pode ser enfileirado por um máximo de 24 horas. Se um executor auto-hospedado não começar a executar a tarefa dentro deste limite, a tarefa será encerrada e não será concluída. Este limite não se aplica a executores hospedados para {% data variables.product.prodname_dotcom %}. -- **Solicitações de API** - Você pode executar até 1000 solicitações de API por hora em todas as ações dentro de um repositório. Se excedido, as chamadas de API adicionais falharão, o que pode causar falha nas tarefas. Este limite também se aplica a executores auto-hospedados. -- **Tarefas correntes** - O número de trabalhos simultâneos que você pode executar em sua conta depende do seu plano GitHub, conforme indicado na tabela a seguir. Se excedido, quaisquer tarefas adicionais serão colocadas na fila. Não há limites de concorrência para os executores auto-hospedados. - - | Plano GitHub | Total de tarefas simultâneas | Máximo de tarefas macOS simultâneas | - | ------------ | ---------------------------- | ----------------------------------- | - | Grátis | 20 | 5 | - | Pro | 40 | 5 | - | Equipe | 60 | 5 | - | Enterprise | 180 | 50 | -- **Matriz de vagas** - {% data reusables.github-actions.matrix-limits %} diff --git a/translations/pt-BR/data/reusables/github-actions/matrix-limits.md b/translations/pt-BR/data/reusables/github-actions/matrix-limits.md deleted file mode 100644 index 71fa5cb9f40e..000000000000 --- a/translations/pt-BR/data/reusables/github-actions/matrix-limits.md +++ /dev/null @@ -1 +0,0 @@ -Uma matriz de tarefas pode gerar 256 tarefas no máximo por execução do fluxo de trabalho. Este limite também se aplica a executores auto-hospedados. \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-add-new-runner.md b/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-add-new-runner.md deleted file mode 100644 index 66beb5a4f020..000000000000 --- a/translations/pt-BR/data/reusables/github-actions/self-hosted-runner-add-new-runner.md +++ /dev/null @@ -1,20 +0,0 @@ -1. Em "Self-hosted runners" (Executores auto-hospedados), clique em **Add runner** (Adicionar executor). - -1. Selecione o sistema operacional e a arquitetura da sua máquina de executor auto-hospedada. ![Selecionar sistema operacional de executor auto-hospedado](/assets/images/help/settings/actions-runner-architecture-os.png) - - -1. Você verá instruções mostrando como baixar o executor e instalá-lo em sua máquina de executor auto-hospedada. - - Abra um shell em sua máquina de executor auto-hospedado e execute cada comando shell na ordem mostrada. - - {% note %} - - **Nota:** No Windows, se você quiser instalar a aplicação de executor auto-hospedada como um serviço, você deve abrir um shell com privilégios de administrador. Também recomendamos que você use `C:\actions-runner` como diretório para o aplicativo runner auto-hospedado para que as contas de sistema Windows possam acessar o diretório do executor. - - {% endnote %} - - As instruções te ajudam a completar estas tarefas: - - Transferindo e extraindo o aplicativo do executor auto-hospedado. - - Executando o script `config` para configurar a aplicação de executor auto-hospedada e registrá-lo no {% data variables.product.prodname_actions %}. O script `config` requer a URL de destino e um token de tempo limitado gerado automaticamente para autenticar a solicitação. - - No Windows, o script `config` também pergunta se você gostaria de instalar o aplicativo de execução auto-hospedado como um serviço. Para Linux e macOS, você pode instalar um serviço depois de terminar de adicionar o executor. Para obter mais informações, consulte "[Configuring the self-hosted runner application as a service](/actions/automating-your-workflow-with-github-actions/configuring-the-self-hosted-runner-application-as-a-service)." - - Executando o aplicativo do executor auto-hospedado para conectar a máquina ao {% data variables.product.prodname_actions %}. diff --git a/translations/pt-BR/data/reusables/github-component-kit/intro-for-component-kit.md b/translations/pt-BR/data/reusables/github-component-kit/intro-for-component-kit.md deleted file mode 100644 index fd264b8cff3d..000000000000 --- a/translations/pt-BR/data/reusables/github-component-kit/intro-for-component-kit.md +++ /dev/null @@ -1 +0,0 @@ -O {% data variables.product.prodname_component_kit %} usa {% data variables.product.prodname_github_app %} e {% data variables.product.prodname_actions %} para alimentar elementos interativos dentro da interface do usuário {% data variables.product.prodname_dotcom %} UI. Por exemplo, você pode guiar usuários do repositório com as próximas etapas ou solicitar para eles aceitarem contratos de licença. diff --git a/translations/pt-BR/data/reusables/github-component-kit/opening-explanation-for-component-kit.md b/translations/pt-BR/data/reusables/github-component-kit/opening-explanation-for-component-kit.md deleted file mode 100644 index 775f1eee2b73..000000000000 --- a/translations/pt-BR/data/reusables/github-component-kit/opening-explanation-for-component-kit.md +++ /dev/null @@ -1,3 +0,0 @@ -O {% data variables.product.prodname_component_kit %} permite que você configure um componente interativo para aparecer em uma pull request ou problema. Componentes interativos permitem que as pessoas acionem e gerenciem tarefas que aparecem na interface do usuário do {% data variables.product.prodname_dotcom %} enquanto uma {% data variables.product.prodname_github_app %} ou a ação executa as tarefas solicitadas e compartilha as atualizações. - -Usando o ponto de extremidade "[Criar comentário compostável](/hidden/github-component-kit/composable-comments#create-composable-comment)", um {% data variables.product.prodname_github_app %} ou ação pode criar um comentário compostável em um problema ou pull request. O comentário composable pode incluir um componente interativo, como um botão personalizado. Quando alguém interage com o comentário, o {% data variables.product.prodname_github_app %} receberá o evento webhook `interactive_component`. diff --git a/translations/pt-BR/data/reusables/github-insights/no-configuration-file.md b/translations/pt-BR/data/reusables/github-insights/no-configuration-file.md deleted file mode 100644 index d918cb7214ca..000000000000 --- a/translations/pt-BR/data/reusables/github-insights/no-configuration-file.md +++ /dev/null @@ -1 +0,0 @@ -Se você não tem um arquivo de configuração, siga as instruções para instalar {% data variables.product.prodname_insights %} pela primeira vez. Para obter mais informações, consulte "[Installing {% data variables.product.prodname_insights %}](/insights/installing-and-configuring-github-insights/installing-github-insights#installing-github-insights)." diff --git a/translations/pt-BR/data/reusables/identity-and-permissions/about-connected-teams.md b/translations/pt-BR/data/reusables/identity-and-permissions/about-connected-teams.md deleted file mode 100644 index 09638cab3def..000000000000 --- a/translations/pt-BR/data/reusables/identity-and-permissions/about-connected-teams.md +++ /dev/null @@ -1,7 +0,0 @@ -Depois que as equipes do {% data variables.product.prodname_dotcom %} estiverem conectadas a um grupo de IdP, o administrador do IdP deve fazer as alterações na associação a equipes por meio do provedor de identidade. Se uma equipe estiver conectada a um grupo de IdP, você não poderá gerenciar a associação à equipe no {% data variables.product.product_name %} ou usando a API. - -Para gerenciar o acesso ao repositório de qualquer equipe do {% data variables.product.prodname_dotcom %} incluindo equipes conectadas a um grupo de IdP, você deve fazer alterações no {% data variables.product.product_name %}. Para obter mais informações, consulte "[Sobre equipes](/articles/about-teams)" e "[Gerenciar o acesso da equipe ao repositório de uma organização](/articles/managing-team-access-to-an-organization-repository)". - -Você pode selecionar os repositórios aos quais você deseja que os membros da equipe tenham acesso por padrão. Os grupos de IdP conectados terão acesso automaticamente a esses repositórios. Para obter mais informações, consulte "[Managing team access to an organization repository](/articles/managing-team-access-to-an-organization-repository)." - -Todas as alterações de membros da equipe feitas através do seu IdP aparecerão no log de auditoria do {% data variables.product.product_name %} como alterações feitas pelo bot de sincronização de equipe. Seu IdP enviará dados de membros da equipe para {% data variables.product.prodname_dotcom %} uma vez a cada hora. \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/marketplace/marketplace_RFP_deadline.md b/translations/pt-BR/data/reusables/marketplace/marketplace_RFP_deadline.md deleted file mode 100644 index 1188c5036139..000000000000 --- a/translations/pt-BR/data/reusables/marketplace/marketplace_RFP_deadline.md +++ /dev/null @@ -1 +0,0 @@ -Abril de 10 \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/marketplace/unverified-req.md b/translations/pt-BR/data/reusables/marketplace/unverified-req.md deleted file mode 100644 index 8ad7359d0487..000000000000 --- a/translations/pt-BR/data/reusables/marketplace/unverified-req.md +++ /dev/null @@ -1 +0,0 @@ -Aplicativos não verificados não precisam atender aos "[Requisitos para listar um aplicativo no GitHub Marketplace](/marketplace/getting-started/requirements-for-listing-an-app-on-github-marketplace/)" ou passar pelo processo de "[Processo de revisão de segurança](/marketplace/getting-started/security-review-process/)." \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/nested-teams/include-child-team-members.md b/translations/pt-BR/data/reusables/nested-teams/include-child-team-members.md deleted file mode 100644 index f9e06a5ef41e..000000000000 --- a/translations/pt-BR/data/reusables/nested-teams/include-child-team-members.md +++ /dev/null @@ -1,5 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.20" %} -Se você passar pelo tipo de mídia `hellcat-preview`, os membros da equipe incluirão os membros de equipes infantis. -{% else %} -Os membros da equipe incluirão os membros de equipes infantis. -{% endif %} diff --git a/translations/pt-BR/data/reusables/organizations/org-settings-repository-roles.md b/translations/pt-BR/data/reusables/organizations/org-settings-repository-roles.md deleted file mode 100644 index 935d5d7e64ba..000000000000 --- a/translations/pt-BR/data/reusables/organizations/org-settings-repository-roles.md +++ /dev/null @@ -1 +0,0 @@ -4. Na barra lateral esquerda, clique em **Repository roles** (Funções do repositório). ![Aba de funções do repositório nas configurações da organização](/assets/images/help/organizations/org-settings-repository-roles.png) diff --git a/translations/pt-BR/data/reusables/orgs/deprecating_creation_type.md b/translations/pt-BR/data/reusables/orgs/deprecating_creation_type.md deleted file mode 100644 index 54c3587e500c..000000000000 --- a/translations/pt-BR/data/reusables/orgs/deprecating_creation_type.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -{% warning %} - -**Aviso de depreciação:** {% data variables.product.prodname_dotcom %} irá substituir e descontinuar `members_allowed_repository_creation_type` em favor de mais permissões granulares. Os novos parâmetros de entrada são `members_can_create_public_repositories`, `members_can_create_private_repositories` para todas as organizações e `members_can_create_internal_repositories` para organizações associadas a uma conta corporativa usando {% data variables.product.prodname_ghe_cloud %} ou {% data variables.product.prodname_ghe_server %} 2.20+. Para obter mais informações, consulte o [blog post](https://developer.github.com/changes/2019-12-03-internal-visibility-changes) (postagem de blog). - -{% endwarning %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/orgs/internal_repos.md b/translations/pt-BR/data/reusables/orgs/internal_repos.md deleted file mode 100644 index 0180ce396ea5..000000000000 --- a/translations/pt-BR/data/reusables/orgs/internal_repos.md +++ /dev/null @@ -1 +0,0 @@ -Se sua organização está associada a uma conta corporativa usando {% data variables.product.prodname_ghe_cloud %} ou {% data variables.product.prodname_ghe_server %} 2.20+, `visibility` também pode ser `internal`. \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/package_registry/about-spending-limits.md b/translations/pt-BR/data/reusables/package_registry/about-spending-limits.md deleted file mode 100644 index 817f2306a410..000000000000 --- a/translations/pt-BR/data/reusables/package_registry/about-spending-limits.md +++ /dev/null @@ -1 +0,0 @@ -Por padrão, sua conta terá um limite de gastos de $0 para o seu uso combinado de {% data variables.product.prodname_registry %} e {% data variables.product.prodname_actions %}. Para permitir superações, você pode aumentar o limite de gastos ou permitir gastos ilimitados. diff --git a/translations/pt-BR/data/reusables/package_registry/accessing-packages.md b/translations/pt-BR/data/reusables/package_registry/accessing-packages.md deleted file mode 100644 index dd18a59bc1e1..000000000000 --- a/translations/pt-BR/data/reusables/package_registry/accessing-packages.md +++ /dev/null @@ -1,4 +0,0 @@ -Você pode acessar seus pacotes a partir deste URL substituindo `OWNER` pelo nome de usuário ou organização do {% data variables.product.prodname_dotcom %} e `REPOSITORY` pelo nome do repositório: - ``` - https://github.com/OWNER/REPOSITORY/packages - ``` diff --git a/translations/pt-BR/data/reusables/package_registry/authenticate-to-container-registry.md b/translations/pt-BR/data/reusables/package_registry/authenticate-to-container-registry.md deleted file mode 100644 index 2d9ed6226017..000000000000 --- a/translations/pt-BR/data/reusables/package_registry/authenticate-to-container-registry.md +++ /dev/null @@ -1,18 +0,0 @@ -1. Create a new personal access token (PAT) with the appropriate scopes for the tasks you want to accomplish. If your organization requires SSO, you must enable SSO for your new token. - - Select the `read:packages` scope to download container images and read their metadata. - - Select the `write:packages` scope to download and upload container images and read and write their metadata. - - Select the `delete:packages` scope to delete container images. - - Para obter mais informações, consulte "[Criar um token de acesso pessoal para a linha de comando](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)". - -2. Save your PAT. We recommend saving your PAT as an environment variable. - ```shell - $ export CR_PAT=YOUR_TOKEN - ``` -3. Using the CLI for your container type, sign in to the {% data variables.product.prodname_github_container_registry %} service at `ghcr.io`. - {% raw %} - ```shell - $ echo $CR_PAT | docker login ghcr.io -u USERNAME --password-stdin - > Login Succeeded - ``` - {% endraw %} diff --git a/translations/pt-BR/data/reusables/permissions/admin-access-org.md b/translations/pt-BR/data/reusables/permissions/admin-access-org.md deleted file mode 100644 index b4f934126644..000000000000 --- a/translations/pt-BR/data/reusables/permissions/admin-access-org.md +++ /dev/null @@ -1 +0,0 @@ -You must authenticate using an access token with the `admin:org` scope to use this endpoint. \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/permissions/admin-access.md b/translations/pt-BR/data/reusables/permissions/admin-access.md deleted file mode 100644 index d35e7e24173c..000000000000 --- a/translations/pt-BR/data/reusables/permissions/admin-access.md +++ /dev/null @@ -1 +0,0 @@ -You must authenticate using an access token with the `repo` scope to use this endpoint. \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/permissions/code-scanning-app-read-permissions.md b/translations/pt-BR/data/reusables/permissions/code-scanning-app-read-permissions.md deleted file mode 100644 index cbee5c312771..000000000000 --- a/translations/pt-BR/data/reusables/permissions/code-scanning-app-read-permissions.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_github_app %}s must have the `security_events` read permission to use this endpoint. \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/permissions/read-access.md b/translations/pt-BR/data/reusables/permissions/read-access.md deleted file mode 100644 index eeff40633e5b..000000000000 --- a/translations/pt-BR/data/reusables/permissions/read-access.md +++ /dev/null @@ -1 +0,0 @@ -Qualquer pessoa com acesso de leitura ao repositório pode usar este ponto de extremidade. Se o repositório for privado, você deverá usar um token de acesso com o escopo `repo`. \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/permissions/security-events-scope.md b/translations/pt-BR/data/reusables/permissions/security-events-scope.md deleted file mode 100644 index afbd0ee17302..000000000000 --- a/translations/pt-BR/data/reusables/permissions/security-events-scope.md +++ /dev/null @@ -1 +0,0 @@ -Você deve usar um token de acesso com o escopo `security_events` para usar este ponto de extremidade. \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/permissions/write-access.md b/translations/pt-BR/data/reusables/permissions/write-access.md deleted file mode 100644 index d35e7e24173c..000000000000 --- a/translations/pt-BR/data/reusables/permissions/write-access.md +++ /dev/null @@ -1 +0,0 @@ -You must authenticate using an access token with the `repo` scope to use this endpoint. \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/pre-release-program/ant-man-preview-deployments.md b/translations/pt-BR/data/reusables/pre-release-program/ant-man-preview-deployments.md deleted file mode 100644 index 4dbd7ba1b8af..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/ant-man-preview-deployments.md +++ /dev/null @@ -1,11 +0,0 @@ -{% note %} - -**Note:** The `transient_environment` and `production_environment` parameters are currently available for developers to preview. During the preview period, the API may change without advance notice. Veja o post do [blogue](https://developer.github.com/changes/2016-04-06-deployment-and-deployment-status-enhancements) para obter informações completas. - -To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.ant-man-preview+json -``` - -{% endnote %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/ant-man-preview-statuses.md b/translations/pt-BR/data/reusables/pre-release-program/ant-man-preview-statuses.md deleted file mode 100644 index ade0fcf428bc..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/ant-man-preview-statuses.md +++ /dev/null @@ -1,11 +0,0 @@ -{% note %} - -**Note:** The `inactive` state and the `log_url`, `environment_url`, and `auto_inactive` parameters are currently available for developers to preview. Veja o post do [blogue](https://developer.github.com/changes/2016-04-06-deployment-and-deployment-status-enhancements) para obter informações completas. - -To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.ant-man-preview+json -``` - -{% endnote %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/antiope-preview.md b/translations/pt-BR/data/reusables/pre-release-program/antiope-preview.md deleted file mode 100644 index 96eee60b530d..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/antiope-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The Checks API is currently available for developers to preview. During the preview period, the API may change without advance notice. Veja o post do [blogue](https://developer.github.com/changes/2018-05-07-new-checks-api-public-beta/) para obter informações completas. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.antiope-preview+json -``` - -{% endnote %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/baptiste-keys-preview.md b/translations/pt-BR/data/reusables/pre-release-program/baptiste-keys-preview.md deleted file mode 100644 index 1a309066ba06..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/baptiste-keys-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Note:** The `is_template` and `template_repository` keys are currently available for developer to preview. See [Create a repository using a template](/v3/repos/#create-a-repository-using-a-template) to learn how to create template repositories. To access these new response keys during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.baptiste-preview+json -``` - -{% endnote %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/baptiste-preview.md b/translations/pt-BR/data/reusables/pre-release-program/baptiste-preview.md deleted file mode 100644 index 850b3f271bb4..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/baptiste-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Note:** Creating and using repository templates is currently available for developers to preview. To access this new endpoint during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.baptiste-preview+json -``` - -{% endnote %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/batman-preview.md b/translations/pt-BR/data/reusables/pre-release-program/batman-preview.md deleted file mode 100644 index 079a5b57c932..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/batman-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -{% note %} - -**Note:** Using the {% data variables.product.prodname_component_kit %} API is currently available for developers to preview. To access these endpoints during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.batman-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/checks-public-beta.md b/translations/pt-BR/data/reusables/pre-release-program/checks-public-beta.md deleted file mode 100644 index 9220bede6270..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/checks-public-beta.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Note:** The Checks API is currently in public beta and only available for use with GitHub Apps. - -{% endnote %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/cloak-preview.md b/translations/pt-BR/data/reusables/pre-release-program/cloak-preview.md deleted file mode 100644 index bb8ec40692d5..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/cloak-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The Commit Search API is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Veja o post do [blogue](https://developer.github.com/changes/2017-01-05-commit-search-api/) para obter informações completas. - -To access the API you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.cloak-preview -``` -{% endnote %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/code-scanning-beta.md b/translations/pt-BR/data/reusables/pre-release-program/code-scanning-beta.md deleted file mode 100644 index f9be785c151b..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/code-scanning-beta.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** {% data variables.product.prodname_code_scanning_capc %} for open source repositories and private repositories is currently in beta and subject to change. To sign up, see [Advanced Security beta](https://github.com/features/security/advanced-security/signup). - -{% endnote %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/comfort-fade-preview.md b/translations/pt-BR/data/reusables/pre-release-program/comfort-fade-preview.md deleted file mode 100644 index 17e2464a7d19..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/comfort-fade-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** Multi-line comments in a pull request diff is currently available for developers to preview. To access the new response fields during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.comfort-fade-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/doctor-strange-preview.md b/translations/pt-BR/data/reusables/pre-release-program/doctor-strange-preview.md deleted file mode 100644 index 488fa5418a94..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/doctor-strange-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion == "enterprise-server@2.20" %} -{% note %} - -**Note:** New endpoints using OAuth tokens as input parameters instead of path parameters are available for developers to preview in the [OAuth Applications API](/v3/apps/oauth_applications/). To access these endpoints during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.doctor-strange-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/dorian-preview.md b/translations/pt-BR/data/reusables/pre-release-program/dorian-preview.md deleted file mode 100644 index d4141e00a5ab..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/dorian-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Note:** Enabling and disabling dependency alerts for a repository using the REST API is currently available for developers to preview. To access these new endpoints during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.dorian-preview+json -``` - -{% endnote %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/drax-preview.md b/translations/pt-BR/data/reusables/pre-release-program/drax-preview.md deleted file mode 100644 index 720c942e5f60..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/drax-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.13" %} -{% note %} - -**Note:** The [Licenses API](https://developer.github.com/changes/2015-03-09-licenses-api/) is currently available for developers to preview. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.drax-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/echo-preview.md b/translations/pt-BR/data/reusables/pre-release-program/echo-preview.md deleted file mode 100644 index d6897f7f1d82..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/echo-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -{% note %} - -**Note:** The team discussions API is currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2018-02-07-team-discussions-api) for full details. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.echo-preview+json -``` -{% endnote %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/flash-preview.md b/translations/pt-BR/data/reusables/pre-release-program/flash-preview.md deleted file mode 100644 index 7492d30ea799..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/flash-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% note %} - -**Note:** New features in the Deployments API on {% data variables.product.product_name %} are currently available during a public beta. Veja o post do [blogue](https://developer.github.com/changes/2018-10-16-deployments-environments-states-and-auto-inactive-updates/) para obter informações completas. - -To access the new `environment` parameter, the two new values for the `state` parameter (`in_progress` and `queued`), and use `auto_inactive` on production deployments during the public beta period, you must provide the following custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.flash-preview+json -``` - -{% endnote %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/gambit-preview.md b/translations/pt-BR/data/reusables/pre-release-program/gambit-preview.md deleted file mode 100644 index ae67b941174b..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/gambit-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.21" %} -{% note %} - -**Note:** Uninstalling {% data variables.product.prodname_github_app %}s and revoking an app's installation token are currently available for developers to preview. To access the new endpoint during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.gambit-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/giant-sentry-fist-pre-release.md b/translations/pt-BR/data/reusables/pre-release-program/giant-sentry-fist-pre-release.md deleted file mode 100644 index 6ea06379025f..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/giant-sentry-fist-pre-release.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "2.8" %} -{% note %} - -**Note:** {% data variables.giant-sentry-fist.product_name_long %} on {% data variables.product.product_name %} is currently available for developers to preview. To access the API, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.giant-sentry-fist-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/github-actions-public-beta.md b/translations/pt-BR/data/reusables/pre-release-program/github-actions-public-beta.md deleted file mode 100644 index ff0a4b80f712..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/github-actions-public-beta.md +++ /dev/null @@ -1,11 +0,0 @@ -{% warning %} - -**New release:** {% data variables.product.prodname_actions %} is now available in a new limited public beta. This version offers a new workflow configuration and built-in continuous integration and continuous deployment capabilities. We strongly recommend you avoid using it for high-value workflows and content during this public beta period. To request to join the limited public beta, see the [GitHub Actions page](https://github.com/features/actions). For more information, see "[About GitHub Actions](/articles/about-github-actions)". - -GitHub Support will only provide support for the YAML syntax and no longer provides support for the HCL syntax. - -If you participated in the limited public beta and created workflows with the HCL syntax {% data variables.product.prodname_actions %}, you will need to upgrade to the new limited public beta that uses YAML syntax. When your repository is eligible to upgrade, you'll see an invitation in your repository. You must accept the invitation before you can use the new limited public beta. - -Once you've upgraded, any workflows that you created with the HCL syntax will need to be updated to the new YAML syntax. To automatically convert your workflows, see "[Migrating {% data variables.product.prodname_actions %} from HCL syntax to YAML syntax](/articles/migrating-github-actions-from-hcl-syntax-to-yaml-syntax)". - -{% endwarning %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/github-components-public-beta.md b/translations/pt-BR/data/reusables/pre-release-program/github-components-public-beta.md deleted file mode 100644 index 2c242acbc08b..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/github-components-public-beta.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -{% note %} - -**Note:** The {% data variables.product.prodname_component_kit %} API is currently in private beta and subject to change. - -{% endnote %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/groot-preview.md b/translations/pt-BR/data/reusables/pre-release-program/groot-preview.md deleted file mode 100644 index 944243de7c52..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/groot-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Note:** Listing branches or pull requests for a commit in the Commits API is currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2019-04-11-pulls-branches-for-commit/) for more details. To access the new endpoints during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.groot-preview+json -``` - -{% endnote %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/hagar-preview.md b/translations/pt-BR/data/reusables/pre-release-program/hagar-preview.md deleted file mode 100644 index e1cf318f3cc3..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/hagar-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -{% note %} - -**Note:** You can now retrieve someone's hovercard information in different contexts using the Hovercard API. This feature is currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2018-03-21-hovercard-api-preview) for full details. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.hagar-preview+json -``` -{% endnote %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/hellcat-preview.md b/translations/pt-BR/data/reusables/pre-release-program/hellcat-preview.md deleted file mode 100644 index b2268faa5418..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/hellcat-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.20" %} -{% note %} - -**Note:** The Nested Teams API is currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2017-08-30-preview-nested-teams) for full details. To access the API, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.hellcat-preview+json -``` -{% endnote %} - -{% endif %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/inertia-preview.md b/translations/pt-BR/data/reusables/pre-release-program/inertia-preview.md deleted file mode 100644 index ac92f6ce6b53..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/inertia-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The Projects API is currently available for developers to preview. During the preview period, the API may change without advance notice. Veja o post do [blogue](https://developer.github.com/changes/2016-10-27-changes-to-projects-api) para obter informações completas. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.inertia-preview+json -``` - -{% endnote %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/london-preview.md b/translations/pt-BR/data/reusables/pre-release-program/london-preview.md deleted file mode 100644 index 4fa608045abb..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/london-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** Enabling or disabling automated security fixes is currently available for developers to preview. To access this new endpoint during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.london-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/luke-cage-preview.md b/translations/pt-BR/data/reusables/pre-release-program/luke-cage-preview.md deleted file mode 100644 index a4a7cfe32bbb..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/luke-cage-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The Protected Branches API now has a setting for requiring a specified number of approving pull request reviews before merging. This feature is currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2018-03-16-protected-branches-required-approving-reviews) for full details. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.luke-cage-preview+json -``` - -{% endnote %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/lydian-preview.md b/translations/pt-BR/data/reusables/pre-release-program/lydian-preview.md deleted file mode 100644 index fa5a34527bea..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/lydian-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Note:** Updating the pull request branch with latest upstream changes is currently available for developers to preview. To access this new endpoint during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.lydian-preview+json -``` - -{% endnote %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/mercy-pre-release-replace.md b/translations/pt-BR/data/reusables/pre-release-program/mercy-pre-release-replace.md deleted file mode 100644 index c49f66c4dba1..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/mercy-pre-release-replace.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** Repository topics on {% data variables.product.product_name %} are currently available for developers to preview. To use this endpoint, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.mercy-preview+json -``` - -{% endnote %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/mercy-pre-release.md b/translations/pt-BR/data/reusables/pre-release-program/mercy-pre-release.md deleted file mode 100644 index fa26dc8969ed..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/mercy-pre-release.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** {% data variables.mercy.product_name_long %} on {% data variables.product.product_name %} is currently available for developers to preview. To view the `topics` property in calls that return repository results, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.mercy-preview+json -``` - -{% endnote %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/mister-fantastic-pre-release.md b/translations/pt-BR/data/reusables/pre-release-program/mister-fantastic-pre-release.md deleted file mode 100644 index 4918b1477ee0..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/mister-fantastic-pre-release.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -{% note %} - -**Note:** {% data variables.mister-fantastic.product_name_long %} contains two additional fields in responses, which developers can preview: `html_url` and `source`. To see these two new fields, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.mister-fantastic-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/mockingbird-preview.md b/translations/pt-BR/data/reusables/pre-release-program/mockingbird-preview.md deleted file mode 100644 index abc16872cb1e..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/mockingbird-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The API to get issue timeline events is currently available for developers to preview. During the preview period, the APIs may change without advance notice. Veja o post do [blogue](https://developer.github.com/changes/2016-05-23-timeline-preview-api/) para obter informações completas. To access the API you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.mockingbird-preview -``` - -{% endnote %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/multi-line-comments-public-beta.md b/translations/pt-BR/data/reusables/pre-release-program/multi-line-comments-public-beta.md deleted file mode 100644 index 5aeea167477b..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/multi-line-comments-public-beta.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** Multi-line comments on pull requests are currently in public beta and subject to change. - -{% endnote %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/nebula-preview.md b/translations/pt-BR/data/reusables/pre-release-program/nebula-preview.md deleted file mode 100644 index 6a2ad6065e20..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/nebula-preview.md +++ /dev/null @@ -1,14 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} - -{% note %} - -**Note:** You can set the visibility of a repository using the new `visibility` parameter in the [Repositories API](/v3/repos/), and get a repository's visibility with a new response key. Para obter mais informações, consulte o [blog post](https://developer.github.com/changes/2019-12-03-internal-visibility-changes/) (postagem de blog). - -To access repository visibility during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.nebula-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/nightshade-preview.md b/translations/pt-BR/data/reusables/pre-release-program/nightshade-preview.md deleted file mode 100644 index 22172eba6443..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/nightshade-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.20" %} -{% note %} - -**Note:** The [Repository Transfer API](https://developer.github.com/changes/2017-11-09-repository-transfer-api-preview) is currently available for developers to preview. To access the API, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.nightshade-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/org-self-hosted-runner-beta.md b/translations/pt-BR/data/reusables/pre-release-program/org-self-hosted-runner-beta.md deleted file mode 100644 index 19b16aaa4842..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/org-self-hosted-runner-beta.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% warning %} - -**Aviso:** A API dos executores auto-hospedados para organizações está atualmente no beta público e sujeita a alterações. - -{% endwarning %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/performed-by-integration-deployment.md b/translations/pt-BR/data/reusables/pre-release-program/performed-by-integration-deployment.md deleted file mode 100644 index 6a888df13e51..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/performed-by-integration-deployment.md +++ /dev/null @@ -1,13 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** If a deployment is created via a {% data variables.product.prodname_github_app %}, the response will include the `performed_via_github_app` object with information about the {% data variables.product.prodname_github_app %}. For more information, see the [related blog post](https://developer.github.com/changes/2016-09-14-Integrations-Early-Access). - -To receive the `performed_via_github_app` object in the response, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.machine-man-preview -``` - -{% endnote %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/performed-by-integration-issue-comment.md b/translations/pt-BR/data/reusables/pre-release-program/performed-by-integration-issue-comment.md deleted file mode 100644 index ad67d849dd85..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/performed-by-integration-issue-comment.md +++ /dev/null @@ -1,13 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** If an issue comment is created via a {% data variables.product.prodname_github_app %}, the response will include the `performed_via_github_app` object with information about the {% data variables.product.prodname_github_app %}. For more information, see the [related blog post](https://developer.github.com/changes/2016-09-14-Integrations-Early-Access). - -To receive the `performed_via_github_app` object in the response, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.machine-man-preview -``` - -{% endnote %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/performed-by-integration-issue-event.md b/translations/pt-BR/data/reusables/pre-release-program/performed-by-integration-issue-event.md deleted file mode 100644 index 54e004859064..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/performed-by-integration-issue-event.md +++ /dev/null @@ -1,13 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** If an issue event is created via a {% data variables.product.prodname_github_app %}, the response will include the `performed_via_github_app` object with information about the {% data variables.product.prodname_github_app %}. For more information, see the [related blog post](https://developer.github.com/changes/2016-09-14-Integrations-Early-Access). - -To receive the `performed_via_github_app` object in the response, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.machine-man-preview -``` - -{% endnote %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/performed-by-integration-issue.md b/translations/pt-BR/data/reusables/pre-release-program/performed-by-integration-issue.md deleted file mode 100644 index ee0240792f4a..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/performed-by-integration-issue.md +++ /dev/null @@ -1,13 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** If an issue is opened via a {% data variables.product.prodname_github_app %}, the response will include the `performed_via_github_app` object with information about the {% data variables.product.prodname_github_app %}. For more information, see the [related blog post](https://developer.github.com/changes/2016-09-14-Integrations-Early-Access). - -To receive the `performed_via_github_app` object in the response, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.machine-man-preview -``` - -{% endnote %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/scarlet-witch-key-preview.md b/translations/pt-BR/data/reusables/pre-release-program/scarlet-witch-key-preview.md deleted file mode 100644 index a82019b82319..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/scarlet-witch-key-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** Developers can preview a new `code_of_conduct` key in responses. For more information, see [Codes of Conduct API](/v3/codes_of_conduct/). - -To access this new response key during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.scarlet-witch-preview+json -``` -{% endnote %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/scarlet-witch-preview.md b/translations/pt-BR/data/reusables/pre-release-program/scarlet-witch-preview.md deleted file mode 100644 index 860b30d517dc..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/scarlet-witch-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The Codes of Conduct API is currently available for developers to preview. - -To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.scarlet-witch-preview+json -``` -{% endnote %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/shadow-cat-preview.md b/translations/pt-BR/data/reusables/pre-release-program/shadow-cat-preview.md deleted file mode 100644 index 3d95ab9ccae5..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/shadow-cat-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.21" %} -{% note %} - -**Note:** The Draft Pull Request API is currently available for developers to preview. You can use this API to create a draft pull request or see whether a pull request is in draft state. See the [blog post](https://developer.github.com/changes/2019-02-14-draft-pull-requests) preview for more details. To access the new `draft` parameter during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.shadow-cat-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/sombra-preview.md b/translations/pt-BR/data/reusables/pre-release-program/sombra-preview.md deleted file mode 100644 index 9298dfa844f5..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/sombra-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** The Interactions API is currently in public preview. See the [blog post](https://developer.github.com/changes/2018-12-18-interactions-preview) preview for more details. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.sombra-preview -``` - -{% endnote %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/squirrel-girl-preview.md b/translations/pt-BR/data/reusables/pre-release-program/squirrel-girl-preview.md deleted file mode 100644 index 52bd9558fc3b..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/squirrel-girl-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Note:** APIs for managing reactions are currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - - ``` - application/vnd.github.squirrel-girl-preview+json - ``` - {% endnote %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/squirrel-girl-response-preview.md b/translations/pt-BR/data/reusables/pre-release-program/squirrel-girl-response-preview.md deleted file mode 100644 index 18d162292a2d..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/squirrel-girl-response-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The [reactions API](/v3/reactions/) is available for developers to preview. The `url` can be used to construct the API location for [listing and creating](/v3/reactions) reactions. See the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details. To receive the `reactions` object in the response for this endpoint you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.squirrel-girl-preview -``` - -{% endnote %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/superpro-preview.md b/translations/pt-BR/data/reusables/pre-release-program/superpro-preview.md deleted file mode 100644 index f0878ed234c6..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/superpro-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The [Global Webhooks API](/rest/reference/enterprise-admin#global-webhooks) is currently available for developers to preview. To access the API during the preview period, you must provide a custom [media type](/rest/overview/media-types) in the `Accept` header: - -``` -application/vnd.github.superpro-preview+json -``` - -{% endnote %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/surtur-preview.md b/translations/pt-BR/data/reusables/pre-release-program/surtur-preview.md deleted file mode 100644 index 9cfdfe8ad8dc..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/surtur-preview.md +++ /dev/null @@ -1,21 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -{% note %} - -**Note:** New repository creation permissions are available to preview. You can now use `members_can_create_public_repositories`, `members_can_create_private_repositories`, and `members_can_create_internal_repositories`. You can only allow members to create internal repositories if your organization is associated with an enterprise account using {% data variables.product.prodname_ghe_cloud %} or {% data variables.product.prodname_ghe_server %} 2.20+. These parameters provide more granular permissions to configure the type of repositories organization members can create. - -To access these new parameters during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.surtur-preview+json -``` -{% endnote %} -{% else %} -{% note %} - -**Note:** New repository creation permissions are available to preview. You can now set the `members_allowed_repository_creation_type` parameter to configure whether organization members can create repositories and the type of repositories they can create. - -To access this new parameter during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.surtur-preview+json -``` -{% endnote %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/switcheroo-preview.md b/translations/pt-BR/data/reusables/pre-release-program/switcheroo-preview.md deleted file mode 100644 index fbbbe3817bd9..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/switcheroo-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Note:** Enabling and disabling Pages in the Pages API is currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2019-03-14-enabling-disabling-pages/) preview for more details. To access the new endpoints during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.switcheroo-preview+json -``` - -{% endnote %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/symmetra-preview.md b/translations/pt-BR/data/reusables/pre-release-program/symmetra-preview.md deleted file mode 100644 index c578f33898be..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/symmetra-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% if currentVersion != ‘dotcom’ and currentVersion ver_lt "enterprise-server@2.20" %} -{% note %} - -**Note:** You can add or edit descriptions in labels. See the [blog post](https://developer.github.com/changes/2018-02-22-label-description-search-preview) for full details. To access this feature during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.symmetra-preview+json -``` -{% endnote %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/thor-pre-release.md b/translations/pt-BR/data/reusables/pre-release-program/thor-pre-release.md deleted file mode 100644 index e034ce622e48..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/thor-pre-release.md +++ /dev/null @@ -1,13 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.13" %} -{% note %} - -**Note:** Team-based review requests in the Review Requests API on {% data variables.product.product_name %} are currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2017-07-26-team-review-request-thor-preview) for full details. - -To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.thor-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/usage-api-beta.md b/translations/pt-BR/data/reusables/pre-release-program/usage-api-beta.md deleted file mode 100644 index 0fb7989fc11c..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/usage-api-beta.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% warning %} - -**Warning:** This {% data variables.product.prodname_actions %} usage endpoint is currently in public beta and subject to change. For more information, see "[GitHub Actions API workflow usage](https://developer.github.com/changes/2020-05-15-actions-api-workflow-usage)." - -{% endwarning %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/wyandotte-preview.md b/translations/pt-BR/data/reusables/pre-release-program/wyandotte-preview.md deleted file mode 100644 index 2d5c90f982c3..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/wyandotte-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** To access the Migrations API, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.wyandotte-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/x-ray-preview.md b/translations/pt-BR/data/reusables/pre-release-program/x-ray-preview.md deleted file mode 100644 index c09b481483ca..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/x-ray-preview.md +++ /dev/null @@ -1,13 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" %} -{% note %} - -**Note:** When a GitHub Enterprise instance is in private mode, site and repository administrators can enable anonymous Git access for a public repository. This feature is currently available for developers to preview. See the [blog post](https://blog.github.com/2018-07-12-introducing-enterprise-2-14/) for full details. - -To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.x-ray-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/pre-release-program/zzzax-preview.md b/translations/pt-BR/data/reusables/pre-release-program/zzzax-preview.md deleted file mode 100644 index 1614b2e1532d..000000000000 --- a/translations/pt-BR/data/reusables/pre-release-program/zzzax-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.12" %} -{% note %} - -**Note:** Protected Branches API can now manage a setting for requiring signed commits. This feature is currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2018-02-22-protected-branches-required-signatures) for full details. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.zzzax-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/pulls/diff_location.md b/translations/pt-BR/data/reusables/pulls/diff_location.md deleted file mode 100644 index 1176a8613265..000000000000 --- a/translations/pt-BR/data/reusables/pulls/diff_location.md +++ /dev/null @@ -1,7 +0,0 @@ -{% note %} - -**Note:** To comment on a specific line in a file, you need to first determine the _position_ of that line in the diff. The GitHub REST API offers the `application/vnd.github.v3.diff` [media type](/v3/media/#commits-commit-comparison-and-pull-requests). Para ver um diff do pull request, adicione este tipo de mídia ao cabeçalho `Aceitar` de uma chamada para o ponto de extremidade do [pull request único](/v3/pulls/#get-a-pull-request). - -O valor da `posição` é igual ao número de linhas abaixo da primeira parte "@@@" do cabeçalho no arquivo ao qual você deseja adicionar um comentário. A linha logo abaixo da linha "@@" é a posição 1, a próxima linha é a posição 2, e assim por diante. A posição no diff continua a aumentar por meio das linhas de linhas dos espaços em branco e das partes adicionais até o início de um novo arquivo. - -{% endnote %} diff --git a/translations/pt-BR/data/reusables/pulls/multiline_comments_summary_for_responses.md b/translations/pt-BR/data/reusables/pulls/multiline_comments_summary_for_responses.md deleted file mode 100644 index 1af24654d7ba..000000000000 --- a/translations/pt-BR/data/reusables/pulls/multiline_comments_summary_for_responses.md +++ /dev/null @@ -1,21 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} - -##### Resumo de comentários de linha múltipla - -{% note %} - -**Observação:** Novos parâmetros e campos de resposta estão disponíveis para os desenvolvedores visualizarem. Durante o período de visualização, esses campos de resposta podem mudar sem aviso prévio. Veja o post do [blogue](https://developer.github.com/changes/2019-10-03-multi-line-comments) para obter informações completas. - -{% endnote %} - -Use o cabeçalho de visualização `comfort-fade` e o parâmetro de `linha` para mostrar campos compatíveis com o comentário de linha múltipla na resposta. - -Se você usar o cabeçalho de visualização `comfort-fade` sua resposta mostrará: -- Para comentários de linha múltipla, valores para `start_line`, `original_start_line,` `start_side`, `linha`, `original_line` e `lado`. -- Para comentários de linha única, valores para `linha`, `original_line` e `lado` e um valor `nulo` para `start_line`, `original_start_line` e `start_side`. - -Se você não usar o cabeçalho de visualização `comfort-fade` serão exibidos comentários de linha múltipla e de linha única da mesma maneira na resposta com um único atributo `de posição`. Sua resposta exibirá: -- Para comentários linha múltipla, a última linha do intervalo de comentários para o atributo de `posição`. -- For single-line comments, the diff-positioned way of referencing comments for the `position` attribute. Para obter mais informações, consulte a `posição` na tabela [de parâmetros de entrada](/v3/pulls/comments/#parameters-2). - -{% endif %} diff --git a/translations/pt-BR/data/reusables/pulls/pull_request_access.md b/translations/pt-BR/data/reusables/pulls/pull_request_access.md deleted file mode 100644 index 49efc9f92096..000000000000 --- a/translations/pt-BR/data/reusables/pulls/pull_request_access.md +++ /dev/null @@ -1,5 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} - -Para abrir ou atualizar um pull request em um repositório público, você deve ter acesso ao branch principal ou ao branch original. Para repositórios de propriedade da organização, você deve ser um integrante da organização que possui o repositório para abrir ou atualizar um pull request. - -{% endif %} diff --git a/translations/pt-BR/data/reusables/pulls/pull_request_mergeability.md b/translations/pt-BR/data/reusables/pulls/pull_request_mergeability.md deleted file mode 100644 index 8b31478a8c2e..000000000000 --- a/translations/pt-BR/data/reusables/pulls/pull_request_mergeability.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Observação:** Você precisa [solicitar um pull request](/v3/pulls/#get-a-pull-request) explicitamente para acionar um commit de teste de merge, verifica a mesclabilidade dos pull requests. Para obter mais informações, consulte "[Verificar a mesclabilidade dos pull requests](/v3/git/#checking-mergeability-of-pull-requests)". - -{% endnote %} diff --git a/translations/pt-BR/data/reusables/pulls/pullrequests_as_issues.md b/translations/pt-BR/data/reusables/pulls/pullrequests_as_issues.md deleted file mode 100644 index 6d67689cc3ca..000000000000 --- a/translations/pt-BR/data/reusables/pulls/pullrequests_as_issues.md +++ /dev/null @@ -1,7 +0,0 @@ -{% note %} - -**Note**: GitHub's REST API considers every pull request an issue, but not every issue is a pull request. Por esse motivo, os pontos de extremidade dos "Problemas" podem retornar problemas e pull requests na resposta. Você pode identificar pull requests pela chave `pull_request`. - -Esteja ciente de que o `id` de um pull request retornado dos pontos de extremidade de "Problemas" será um _id de problema_. Para descobrir o id do pull request, use o ponto de extremidade "[List pull requests](/v3/pulls/#list-pull-requests)". - -{% endnote %} diff --git a/translations/pt-BR/data/reusables/reminders/install-slack.md b/translations/pt-BR/data/reusables/reminders/install-slack.md deleted file mode 100644 index 33d6c69d6bba..000000000000 --- a/translations/pt-BR/data/reusables/reminders/install-slack.md +++ /dev/null @@ -1 +0,0 @@ -If you'd like to install Slack on all of your repositories, select **All repositories**. If you'd like to only install Slack on select repositories, select **Only select repositories**. Then, read the list of permissions you're allowing Slack to access and click **Install**. ![Install Slack button](/assets/images/help/settings/scheduled-reminders-install-slack.png) diff --git a/translations/pt-BR/data/reusables/reminders/scheduled-reminders-beta.md b/translations/pt-BR/data/reusables/reminders/scheduled-reminders-beta.md deleted file mode 100644 index 05ae894babe1..000000000000 --- a/translations/pt-BR/data/reusables/reminders/scheduled-reminders-beta.md +++ /dev/null @@ -1 +0,0 @@ -Scheduled reminders for pull requests are currently in beta and subject to change. To request access to the next beta phase for scheduled reminders, join the waitlist at [GitHub Scheduled Reminders](https://github.com/features/reminders/signup). diff --git a/translations/pt-BR/data/reusables/repositories/actions-new-workflow.md b/translations/pt-BR/data/reusables/repositories/actions-new-workflow.md deleted file mode 100644 index 6af36a64692a..000000000000 --- a/translations/pt-BR/data/reusables/repositories/actions-new-workflow.md +++ /dev/null @@ -1,2 +0,0 @@ -1. In the upper-left corner, click **New workflow**. ![Criar um novo fluxo de trabalho](/assets/images/help/repository/actions-new-workflow.png) - \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/repositories/actions-set-up-workflow-template.md b/translations/pt-BR/data/reusables/repositories/actions-set-up-workflow-template.md deleted file mode 100644 index 39f55061e6c1..000000000000 --- a/translations/pt-BR/data/reusables/repositories/actions-set-up-workflow-template.md +++ /dev/null @@ -1 +0,0 @@ -1. Sob, nome do template que você gostaria de usar, clique em **Configurar este fluxo de trabalho**. ![Node.js template recommendations](/assets/images/help/repository/actions-recommended-workflow-template.png) diff --git a/translations/pt-BR/data/reusables/repositories/opt-out-automated-security-updates.md b/translations/pt-BR/data/reusables/repositories/opt-out-automated-security-updates.md deleted file mode 100644 index b1379e869de4..000000000000 --- a/translations/pt-BR/data/reusables/repositories/opt-out-automated-security-updates.md +++ /dev/null @@ -1,2 +0,0 @@ -1. Under "Automated security updates", select or deselect **Opt out of automated security updates**. ![Checkbox to opt out of automated security updates](/assets/images/help/repository/opt-out-automated-security-updates.png) -2. Clique em **Save** (Salvar). diff --git a/translations/pt-BR/data/reusables/repositories/opt-out-dependabot-security-updates.md b/translations/pt-BR/data/reusables/repositories/opt-out-dependabot-security-updates.md deleted file mode 100644 index 3a68c3c20731..000000000000 --- a/translations/pt-BR/data/reusables/repositories/opt-out-dependabot-security-updates.md +++ /dev/null @@ -1 +0,0 @@ -1. To the right of "{% data variables.product.prodname_dependabot_short %} security updates", click **Disable all** or **Enable all**. !["Disable all" or "Enable all" button for {% data variables.product.prodname_dependabot_short %} security updates](/assets/images/help/repository/opt-out-dependabot-security-updates.png) diff --git a/translations/pt-BR/data/reusables/repositories/settings-security-and-analysis-tab-beta.md b/translations/pt-BR/data/reusables/repositories/settings-security-and-analysis-tab-beta.md deleted file mode 100644 index a3664b8fbce9..000000000000 --- a/translations/pt-BR/data/reusables/repositories/settings-security-and-analysis-tab-beta.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Note**: The new experience for managing security and analysis settings is in beta and subject to change. - -{% endnote %} diff --git a/translations/pt-BR/data/reusables/repositories/sidebar-integrations-and-services.md b/translations/pt-BR/data/reusables/repositories/sidebar-integrations-and-services.md deleted file mode 100644 index a9ec167dd2d0..000000000000 --- a/translations/pt-BR/data/reusables/repositories/sidebar-integrations-and-services.md +++ /dev/null @@ -1 +0,0 @@ -1. Click **Integrations & Services**. ![Integrations and services selection](/assets/images/help/settings/integrations_and_services_menu.png) diff --git a/translations/pt-BR/data/reusables/repositories/troubleshooting-dependency-graph.md b/translations/pt-BR/data/reusables/repositories/troubleshooting-dependency-graph.md deleted file mode 100644 index 187ae99b2b9f..000000000000 --- a/translations/pt-BR/data/reusables/repositories/troubleshooting-dependency-graph.md +++ /dev/null @@ -1 +0,0 @@ -If your project has dependencies, but no dependencies are detected in your graph, there may be a problem with the file containing your dependencies. Check your project's file to ensure that it's correctly formatted for the file type. diff --git a/translations/pt-BR/data/reusables/repositories/you-can-enable-or-disable-security-features.md b/translations/pt-BR/data/reusables/repositories/you-can-enable-or-disable-security-features.md deleted file mode 100644 index ce70639e21b6..000000000000 --- a/translations/pt-BR/data/reusables/repositories/you-can-enable-or-disable-security-features.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Note**: The code scanning and secret scanning beta includes a new experience for managing security and analysis settings. If you're participating in the beta, skip the following steps and see "[Managing security and analysis settings for your repository](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository)." - -{% endnote %} diff --git a/translations/pt-BR/data/reusables/repositories/you-can-manage-access-to-security-alerts.md b/translations/pt-BR/data/reusables/repositories/you-can-manage-access-to-security-alerts.md deleted file mode 100644 index f96057061471..000000000000 --- a/translations/pt-BR/data/reusables/repositories/you-can-manage-access-to-security-alerts.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Note**: The code scanning and secret scanning beta includes a new experience for managing people and teams with access to security alerts. If you're participating in the beta, skip the following steps and see "[Managing security and analysis settings for your repository](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository#granting-access-to-github-dependabot-alerts)." - -{% endnote %} diff --git a/translations/pt-BR/data/reusables/saml/scim-unavailable-for-enterprise-accounts.md b/translations/pt-BR/data/reusables/saml/scim-unavailable-for-enterprise-accounts.md deleted file mode 100644 index 91565a694a5d..000000000000 --- a/translations/pt-BR/data/reusables/saml/scim-unavailable-for-enterprise-accounts.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Note**: SCIM support is not available for enterprise accounts on {% data variables.product.prodname_dotcom %} at this time. - -{% endnote %} diff --git a/translations/pt-BR/data/reusables/scim/complete_user_example.md b/translations/pt-BR/data/reusables/scim/complete_user_example.md deleted file mode 100644 index e444e167ecc8..000000000000 --- a/translations/pt-BR/data/reusables/scim/complete_user_example.md +++ /dev/null @@ -1,7 +0,0 @@ -<%= json \ "schemas":["urn:ietf:params:scim:schemas:core:2.0:User"], "userName":"mona.octocat@okta.example.com", "name":{ "familyName":"Octocat", "givenName":"Mona" }, "emails":[ - { - "value":"mona.octocat@okta.example.com", - "type":"work", - "primary": true - } - ] %> diff --git a/translations/pt-BR/data/reusables/scim/user_required_values.md b/translations/pt-BR/data/reusables/scim/user_required_values.md deleted file mode 100644 index ac21f8bdd71f..000000000000 --- a/translations/pt-BR/data/reusables/scim/user_required_values.md +++ /dev/null @@ -1 +0,0 @@ -Conforme mostrado no exemplo a seguir, você deve fornecer pelo menos os valores necessários para o usuário: `userName,` `nome` e `e-mails`. diff --git a/translations/pt-BR/data/reusables/search/exact-match-beta.md b/translations/pt-BR/data/reusables/search/exact-match-beta.md deleted file mode 100644 index b30a551b39f9..000000000000 --- a/translations/pt-BR/data/reusables/search/exact-match-beta.md +++ /dev/null @@ -1 +0,0 @@ -Exact matches in code search is in beta for a limited number of users and repositories on {% data variables.product.prodname_dotcom %}, and is subject to change. diff --git a/translations/pt-BR/data/reusables/search/exact-match.md b/translations/pt-BR/data/reusables/search/exact-match.md deleted file mode 100644 index d3563a1ef5db..000000000000 --- a/translations/pt-BR/data/reusables/search/exact-match.md +++ /dev/null @@ -1 +0,0 @@ -You can search code for exact matches that include any combination of letters, numbers, and symbols. diff --git a/translations/pt-BR/data/reusables/shortdesc/2fa.md b/translations/pt-BR/data/reusables/shortdesc/2fa.md deleted file mode 100644 index 6dd5d06a9ab1..000000000000 --- a/translations/pt-BR/data/reusables/shortdesc/2fa.md +++ /dev/null @@ -1 +0,0 @@ -Se você tiver configuração de autenticação de dois fatores, a autenticação básica para este ponto de extremidade exigirá que você use uma senha única (OTP) e seu nome de usuário e senha em vez de tokens. Para obter mais informações, consulte "[Trabalhando com autenticação de dois fatores](/v3/auth/#working-with-two-factor-authentication)". \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/shortdesc/content_reference_body.md b/translations/pt-BR/data/reusables/shortdesc/content_reference_body.md deleted file mode 100644 index 4b89190d30bf..000000000000 --- a/translations/pt-BR/data/reusables/shortdesc/content_reference_body.md +++ /dev/null @@ -1 +0,0 @@ -You have used an email that already exists for the user_email_uniq field.\n \## DETAILS:\n\nThe (email)=(Octocat@github.com) already exists.\n\n The error was found in core/models.py in get_or_create_user at line 62.\n\n\ self.save() \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/shortdesc/content_reference_title.md b/translations/pt-BR/data/reusables/shortdesc/content_reference_title.md deleted file mode 100644 index 531d7aabf6de..000000000000 --- a/translations/pt-BR/data/reusables/shortdesc/content_reference_title.md +++ /dev/null @@ -1 +0,0 @@ -[A-1234] Error found in core/models.py file \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/sponsors/email-submit-bank-info.md b/translations/pt-BR/data/reusables/sponsors/email-submit-bank-info.md deleted file mode 100644 index 8174c6976a84..000000000000 --- a/translations/pt-BR/data/reusables/sponsors/email-submit-bank-info.md +++ /dev/null @@ -1 +0,0 @@ -Depois de ingressar no {% data variables.product.prodname_sponsors %}, você receberá um e-mail com instruções para enviar suas informações bancárias e fiscais. diff --git a/translations/pt-BR/data/reusables/sponsors/matching-period.md b/translations/pt-BR/data/reusables/sponsors/matching-period.md deleted file mode 100644 index 885abc6217cc..000000000000 --- a/translations/pt-BR/data/reusables/sponsors/matching-period.md +++ /dev/null @@ -1 +0,0 @@ -Sponsorships may be eligible for matching within the limitations stated here for the first year that an individual is a participant in {% data variables.product.prodname_sponsors %}. Eligibility for matching begins after {% data variables.product.company_short %} admits an account to {% data variables.product.prodname_sponsors %}, which publishes the sponsorship profile for the account. O período de correspondência não pode ser prorrogado por nenhum motivo. If you leave {% data variables.product.prodname_sponsors %} and rejoin later, the gap between your participation periods may count toward your matching period or your matching period may expire. diff --git a/translations/pt-BR/data/reusables/sponsors/org-sponsorship-dashboard.md b/translations/pt-BR/data/reusables/sponsors/org-sponsorship-dashboard.md deleted file mode 100644 index dba6f85d626d..000000000000 --- a/translations/pt-BR/data/reusables/sponsors/org-sponsorship-dashboard.md +++ /dev/null @@ -1 +0,0 @@ -1. To the right of your organization, click **Sponsorship dashboard**. ![Sponsorship dashboard button](/assets/images/help/sponsors/org-sponsorship-dashboard.png) diff --git a/translations/pt-BR/data/reusables/support/advanced-security-support-terms-differ.md b/translations/pt-BR/data/reusables/support/advanced-security-support-terms-differ.md deleted file mode 100644 index 641a9b9bfa0b..000000000000 --- a/translations/pt-BR/data/reusables/support/advanced-security-support-terms-differ.md +++ /dev/null @@ -1 +0,0 @@ -The terms of this article do not apply to support for {% data variables.product.prodname_advanced_security %}. For more information, see "[About support for {% data variables.product.prodname_advanced_security %}](/enterprise/admin/enterprise-support/about-support-for-advanced-security)." diff --git a/translations/pt-BR/data/reusables/support/ghec-premium-priority-high-description.md b/translations/pt-BR/data/reusables/support/ghec-premium-priority-high-description.md deleted file mode 100644 index 2fb6383ca5f0..000000000000 --- a/translations/pt-BR/data/reusables/support/ghec-premium-priority-high-description.md +++ /dev/null @@ -1 +0,0 @@ -Account or security issues with your organization or enterprise on {% data variables.product.prodname_ghe_cloud %} are causing limited impact to your business. \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/support/ghec-premium-priority-high-examples.md b/translations/pt-BR/data/reusables/support/ghec-premium-priority-high-examples.md deleted file mode 100644 index 84787e3af0ab..000000000000 --- a/translations/pt-BR/data/reusables/support/ghec-premium-priority-high-examples.md +++ /dev/null @@ -1 +0,0 @@ -

    • An organization or enterprise owner has unintentionally deleted an organization
    • An organization or enterprise member has uploaded sensitive data in a commit, issue, pull request, or issue attachment
    \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/support/ghec-premium-priority-low-description.md b/translations/pt-BR/data/reusables/support/ghec-premium-priority-low-description.md deleted file mode 100644 index bc2c96abf597..000000000000 --- a/translations/pt-BR/data/reusables/support/ghec-premium-priority-low-description.md +++ /dev/null @@ -1 +0,0 @@ -You have a question or suggestion about your organization or enterprise on {% data variables.product.prodname_ghe_cloud %} that is not time-sensitive, or does not otherwise block the productivity of your team. \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/support/ghec-premium-priority-low-examples.md b/translations/pt-BR/data/reusables/support/ghec-premium-priority-low-examples.md deleted file mode 100644 index 7d322090b60a..000000000000 --- a/translations/pt-BR/data/reusables/support/ghec-premium-priority-low-examples.md +++ /dev/null @@ -1 +0,0 @@ -
    • Excessive resource usage for your organization or enterprise
    • Requests for health checks
    • Help with using Gists, notifications, wikis, {% data variables.product.prodname_pages %}, {% data variables.product.prodname_desktop %}, Atom, or other peripheral services or features with your organization or enterprise
    • Feature requests
    • Product feedback
    \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/support/ghec-premium-priority-normal-description.md b/translations/pt-BR/data/reusables/support/ghec-premium-priority-normal-description.md deleted file mode 100644 index 6d9c3cf6cdd1..000000000000 --- a/translations/pt-BR/data/reusables/support/ghec-premium-priority-normal-description.md +++ /dev/null @@ -1 +0,0 @@ -Members of your organization or enterprise on {% data variables.product.prodname_ghe_cloud %} are experiencing limited or moderate issues with {% data variables.product.prodname_dotcom_the_website %}, or you have general concerns or questions about your organization or enterprise. \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/support/ghec-premium-priority-normal-examples.md b/translations/pt-BR/data/reusables/support/ghec-premium-priority-normal-examples.md deleted file mode 100644 index c3e8a6d79611..000000000000 --- a/translations/pt-BR/data/reusables/support/ghec-premium-priority-normal-examples.md +++ /dev/null @@ -1 +0,0 @@ -
    • Questions about using APIs and features for your organization or enterprise
    • Issues with tools for organization data migration that {% data variables.product.company_short %} provides
    • Features related to your organization or enterprise not working as expected
    • General security questions about your organization or enterprise
    \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/support/ghec-premium-priority-urgent-description.md b/translations/pt-BR/data/reusables/support/ghec-premium-priority-urgent-description.md deleted file mode 100644 index 73fccecb886c..000000000000 --- a/translations/pt-BR/data/reusables/support/ghec-premium-priority-urgent-description.md +++ /dev/null @@ -1 +0,0 @@ -Production workflows for your organization or enterprise on {% data variables.product.prodname_ghe_cloud %} are failing due to critical service errors or outages, and the failure directly impacts the operation of your business. \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/support/ghec-premium-priority-urgent-examples.md b/translations/pt-BR/data/reusables/support/ghec-premium-priority-urgent-examples.md deleted file mode 100644 index e9eee27296cb..000000000000 --- a/translations/pt-BR/data/reusables/support/ghec-premium-priority-urgent-examples.md +++ /dev/null @@ -1 +0,0 @@ -
    • Errors or outages on {% data variables.product.prodname_dotcom_the_website %} affect core Git or web application functionality for all members of your organization or enterprise
    \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/support/github-one-premium-plus-response-times-differ.md b/translations/pt-BR/data/reusables/support/github-one-premium-plus-response-times-differ.md deleted file mode 100644 index 2d2f85fe5300..000000000000 --- a/translations/pt-BR/data/reusables/support/github-one-premium-plus-response-times-differ.md +++ /dev/null @@ -1 +0,0 @@ -For customers who purchase {% data variables.product.prodname_ghe_one %}, support for {% data variables.product.prodname_actions %}, {% data variables.product.prodname_insights %}, {% data variables.product.prodname_learning %}, and {% data variables.product.prodname_registry %} is available 24 hours a day, 5 days per week, excluding weekends and national U.S. holidays. The standard response time is 1 business day. diff --git a/translations/pt-BR/data/reusables/support/github-one-premium-plus-sla-differs.md b/translations/pt-BR/data/reusables/support/github-one-premium-plus-sla-differs.md deleted file mode 100644 index 19e43b397b04..000000000000 --- a/translations/pt-BR/data/reusables/support/github-one-premium-plus-sla-differs.md +++ /dev/null @@ -1 +0,0 @@ -For customers who purchase {% data variables.product.prodname_ghe_one %}, the SLA for initial response time by {% data variables.contact.premium_support %} does not apply to tickets for {% data variables.product.prodname_actions %}, {% data variables.product.prodname_insights %}, {% data variables.product.prodname_learning %}, or {% data variables.product.prodname_registry %}. \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/support/github-one-premium-plus-support-terms-differ.md b/translations/pt-BR/data/reusables/support/github-one-premium-plus-support-terms-differ.md deleted file mode 100644 index c0712065ee8f..000000000000 --- a/translations/pt-BR/data/reusables/support/github-one-premium-plus-support-terms-differ.md +++ /dev/null @@ -1 +0,0 @@ -For customers who purchase {% data variables.product.prodname_ghe_one %}, support terms for the {% data variables.product.premium_plus_support_plan %} differ for {% data variables.product.prodname_actions %}, {% data variables.product.prodname_insights %}, {% data variables.product.prodname_learning %}, and {% data variables.product.prodname_registry %}. \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/teams/team-sync.md b/translations/pt-BR/data/reusables/teams/team-sync.md deleted file mode 100644 index 88da0da1d1bd..000000000000 --- a/translations/pt-BR/data/reusables/teams/team-sync.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - - **Observação:** Quando você tiver configurado a sincronização da equipe para uma equipe com o provedor de identidade (IdP) da sua organização, você receberá uma mensagem de erro se tentar usar a API para fazer alterações na associação da equipe. Se você tiver acesso para administrar a associação do grupo em seu IdP, você pode administrar a associação da equipe do GitHub através do seu provedor de identidade, que adiciona e remove automaticamente os integrantes da equipe em uma organização. Para obter mais informações, consulte "[Sincronizar equipes entre seu provedor de identidade e o GitHub](/articles/synchronizing-teams-between-your-identity-provider-and-github/)". - -{% endnote %} -{% endif %} diff --git a/translations/pt-BR/data/reusables/user-settings/throttling-notice.md b/translations/pt-BR/data/reusables/user-settings/throttling-notice.md deleted file mode 100644 index 5c6c03b83b26..000000000000 --- a/translations/pt-BR/data/reusables/user-settings/throttling-notice.md +++ /dev/null @@ -1 +0,0 @@ -Este ponto de extremidade aciona [notificações](/articles/about-notifications/). A criação muito rápida de conteúdo usando esse ponto final pode resultar em abuso do limite de taxa. See "[Abuse rate limits](/v3/#abuse-rate-limits)"{% if currentVersion == "free-pro-team@latest" %} and "[Dealing with abuse rate limits](/v3/guides/best-practices-for-integrators/#dealing-with-abuse-rate-limits)"{% endif %} for details. diff --git a/translations/pt-BR/data/reusables/webhooks/interactive_component_short_desc.md b/translations/pt-BR/data/reusables/webhooks/interactive_component_short_desc.md deleted file mode 100644 index 6ec63523f5cd..000000000000 --- a/translations/pt-BR/data/reusables/webhooks/interactive_component_short_desc.md +++ /dev/null @@ -1 +0,0 @@ -Triggered when a user clicks an interactive element that was created using the {% data variables.product.prodname_component_kit %}. {% data variables.product.prodname_github_app %}s are automatically subscribed to the `interactive_component` event so there's no need to manually subscribe to this event. Unlike other webhook events, the `interactive_component` event is only sent to the {% data variables.product.prodname_github_app %} that a user interacted with through an interactive component, such as in a composable comment. {% data variables.product.prodname_oauth_app %}s cannot subscribe to the `interactive_component` event and other installed {% data variables.product.prodname_github_app %}s will not receive the webhook event even if they subscribed to `interactive_component`. \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/webhooks/issue_comment_event_api_properties.md b/translations/pt-BR/data/reusables/webhooks/issue_comment_event_api_properties.md deleted file mode 100644 index f9b7830f5b75..000000000000 --- a/translations/pt-BR/data/reusables/webhooks/issue_comment_event_api_properties.md +++ /dev/null @@ -1,3 +0,0 @@ -| Tecla | Tipo | Descrição | -| ------ | -------- | ---------------------------------------------------------------------- | -| `Ação` | `string` | The action that was performed on the comment. Can be one of `created`. | \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/webhooks/package_short_desc.md b/translations/pt-BR/data/reusables/webhooks/package_short_desc.md deleted file mode 100644 index 9b2e7ed32efb..000000000000 --- a/translations/pt-BR/data/reusables/webhooks/package_short_desc.md +++ /dev/null @@ -1 +0,0 @@ -Activity related to GitHub Packages. {% data reusables.webhooks.action_type_desc %} For more information, see "[GitHub Packages](/packages)". \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/webhooks/pull_request_forked_repos_link.md b/translations/pt-BR/data/reusables/webhooks/pull_request_forked_repos_link.md deleted file mode 100644 index 0fad1bebc3a1..000000000000 --- a/translations/pt-BR/data/reusables/webhooks/pull_request_forked_repos_link.md +++ /dev/null @@ -1 +0,0 @@ -See [below](#pull-request-events-for-forked-repositories) to learn how this event works with forked repositories. \ No newline at end of file diff --git a/translations/pt-BR/data/variables/ant-man.yml b/translations/pt-BR/data/variables/ant-man.yml deleted file mode 100644 index fd9020681ae1..000000000000 --- a/translations/pt-BR/data/variables/ant-man.yml +++ /dev/null @@ -1,3 +0,0 @@ ---- -deployments-ant-man-parameter-note: >- - {% if currentVersion == "free-pro-team@latest" %}**Note:** This parameter requires you to use the [`application/vnd.github.ant-man-preview+json`](/v3/previews/#enhanced-deployments) custom media type.{% endif %} diff --git a/translations/pt-BR/data/variables/cloud-9.yml b/translations/pt-BR/data/variables/cloud-9.yml deleted file mode 100644 index 514cc607691b..000000000000 --- a/translations/pt-BR/data/variables/cloud-9.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: The SCIM API diff --git a/translations/pt-BR/data/variables/giant-sentry-fist.yml b/translations/pt-BR/data/variables/giant-sentry-fist.yml deleted file mode 100644 index ae3a16bbeb72..000000000000 --- a/translations/pt-BR/data/variables/giant-sentry-fist.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: The User Blocking API diff --git a/translations/pt-BR/data/variables/korra.yml b/translations/pt-BR/data/variables/korra.yml deleted file mode 100644 index a0e37a535b50..000000000000 --- a/translations/pt-BR/data/variables/korra.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: The Organization Membership API diff --git a/translations/pt-BR/data/variables/mercy.yml b/translations/pt-BR/data/variables/mercy.yml deleted file mode 100644 index 0076f284e63b..000000000000 --- a/translations/pt-BR/data/variables/mercy.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: The `topics` property for repositories diff --git a/translations/pt-BR/data/variables/mister-fantastic.yml b/translations/pt-BR/data/variables/mister-fantastic.yml deleted file mode 100644 index 5040343f790d..000000000000 --- a/translations/pt-BR/data/variables/mister-fantastic.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: The GitHub Pages API diff --git a/translations/pt-BR/data/variables/performed-via-integration.yml b/translations/pt-BR/data/variables/performed-via-integration.yml deleted file mode 100644 index c2d523e86a75..000000000000 --- a/translations/pt-BR/data/variables/performed-via-integration.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: An additional `performed_via_github_app` object in the issue payload diff --git a/translations/pt-BR/data/variables/valkyrie.yml b/translations/pt-BR/data/variables/valkyrie.yml deleted file mode 100644 index 7b921d5113e1..000000000000 --- a/translations/pt-BR/data/variables/valkyrie.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: The GitHub Marketplace API diff --git a/translations/zh-CN/content/actions/building-and-testing-code-with-continuous-integration/about-continuous-integration.md b/translations/zh-CN/content/actions/building-and-testing-code-with-continuous-integration/about-continuous-integration.md deleted file mode 100644 index 95f632767337..000000000000 --- a/translations/zh-CN/content/actions/building-and-testing-code-with-continuous-integration/about-continuous-integration.md +++ /dev/null @@ -1,62 +0,0 @@ ---- -title: 关于持续集成 -intro: '您可以直接在 {% data variables.product.prodname_dotcom %} 仓库中通过 {% data variables.product.prodname_actions %} 创建自定义持续集成 (CI) 和持续部署 (CD) 工作流程。' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/about-continuous-integration - - /github/automating-your-workflow-with-github-actions/about-continuous-integration - - /actions/automating-your-workflow-with-github-actions/about-continuous-integration -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### 关于持续集成 - -持续集成 (CI) 是一种需要频繁提交代码到共享仓库的软件实践。 频繁提交代码能较早检测到错误，减少在查找错误来源时开发者需要调试的代码量。 频繁的代码更新也更便于从软件开发团队的不同成员合并更改。 这对开发者非常有益，他们可以将更多时间用于编写代码，而减少在调试错误或解决合并冲突上所花的时间。 - -提交代码到仓库时，可以持续创建并测试代码，以确保提交未引入错误。 您的测试可以包括代码语法检查（检查样式格式）、安全性检查、代码覆盖率、功能测试及其他自定义检查。 - -创建和测试代码需要服务器。 您可以在推送代码到仓库之前在本地创建并测试更新，也可以使用 CI 服务器检查仓库中的新代码提交。 - -### 关于使用 {% data variables.product.prodname_actions %} 的持续集成 - -使用 {% data variables.product.prodname_actions %} 的 CI 提供可以在仓库中构建代码并运行测试的工作流程。 工作流程可在 {% data variables.product.prodname_dotcom %} 托管的虚拟机或您自行托管的机器上运行。 更多信息请参阅“[{% data variables.product.prodname_dotcom %} 托管的运行器的虚拟环境](/actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)”和“[关于自托管运行器](/actions/automating-your-workflow-with-github-actions/about-self-hosted-runners)”。 - -您可以配置 CI 工作流程在 {% data variables.product.product_name %} 事件发生时运行（例如，当新代码推送到您的仓库时）、按设定的时间表运行，或者在使用仓库分发 web 挂钩的外部事件发生时运行。 - -{% data variables.product.product_name %} 运行 CI 测试并在拉取请求中提供每次测试的结果，因此您可以查看分支中的更改是否引入错误。 如果工作流程中的所有 CI 测试通过，您推送的更改可供团队成员审查或合并 如果测试失败，则是其中某项更改导致了失败。 - -如果在仓库中设置了 CI，{% data variables.product.product_name %} 会分析仓库中的代码，并根据仓库中的语言和框架推荐 CI 工作流程。 例如，如果您使用 [Node.js](https://nodejs.org/en/)，{% data variables.product.product_name %} 将提议使用模板文件来安装 Node.js 包和运行测试。 您可以使用 {% data variables.product.product_name %} 提议的 CI 工作流程模板，自定义提议的模板，或者创建自定义工作流程文件来运行 CI 测试。 - -![提议的持续集成模板截屏](/assets/images/help/repository/ci-with-actions-template-picker.png) - -除了帮助设置项目的 CI 工作流程之外，您还可以使用 {% data variables.product.prodname_actions %} 创建跨整个软件开发生命周期的工作流程。 例如，您可以使用操作来部署、封装或发行项目。 更多信息请参阅“[关于 {% data variables.product.prodname_actions %}](/articles/about-github-actions)”。 - -有关常用术语的定义，请参阅“[{% data variables.product.prodname_actions %} 的核心概念](/github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)”。 - -### 支持的语言 - -{% data variables.product.product_name %} 提供各种不同语言和框架的 CI 工作流程模板。 - -更多信息请参阅“[配置工作流程](/articles/configuring-a-workflow)。 - -### 工作流程运行通知 - -{% data reusables.repositories.workflow-notifications %} - -### 工作流程运行的状态徽章 - -{% data reusables.repositories.actions-workflow-status-badge-into %} - -更多信息请参阅“[配置工作流程](/articles/configuring-a-workflow)。 - -### 延伸阅读 - -- "[使用 {% data variables.product.prodname_actions %} 设置持续集成](/articles/setting-up-continuous-integration-using-github-actions)" -{% if currentVersion == "free-pro-team@latest" %} -- "[管理 {% data variables.product.prodname_actions %} 的计费](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)" -{% endif %} diff --git a/translations/zh-CN/content/actions/building-and-testing-code-with-continuous-integration/index.md b/translations/zh-CN/content/actions/building-and-testing-code-with-continuous-integration/index.md deleted file mode 100644 index bf6140c3f151..000000000000 --- a/translations/zh-CN/content/actions/building-and-testing-code-with-continuous-integration/index.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: 通过持续集成构建和测试代码 -shortTitle: 持续集成 -intro: '您可以使用 {% data variables.product.prodname_actions %} 在仓库中创建自定义持续集成 (CI) 和持续部署 (CD) 工作流程。' -redirect_from: - - /articles/setting-up-continuous-integration-on-github - - /github/automating-your-workflow-with-github-actions/setting-up-continuous-integration-on-github - - /github/automating-your-workflow-with-github-actions/creating-continuous-integration-workflows - - /actions/automating-your-workflow-with-github-actions/creating-continuous-integration-workflows -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -{% link_in_list /about-continuous-integration %} -{% link_in_list /setting-up-continuous-integration-using-github-actions %} diff --git a/translations/zh-CN/content/actions/building-and-testing-code-with-continuous-integration/setting-up-continuous-integration-using-github-actions.md b/translations/zh-CN/content/actions/building-and-testing-code-with-continuous-integration/setting-up-continuous-integration-using-github-actions.md deleted file mode 100644 index 327a3556c7c3..000000000000 --- a/translations/zh-CN/content/actions/building-and-testing-code-with-continuous-integration/setting-up-continuous-integration-using-github-actions.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: 使用 GitHub 操作设置持续集成 -intro: 您可以使用与您要用的语言和工具匹配的工作流程模板为项目设置持续集成。 -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/setting-up-continuous-integration-using-github-actions - - /github/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions - - /actions/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -对仓库具有写入权限的任何人都可以使用 {% data variables.product.prodname_actions %} 设置持续集成 (CI)。 - -在设置 CI 后，可以根据您的需求自定义工作流程。 - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -3. 找到与您要用的语言和工具匹配的模板，然后单击 **Set up this workflow（设置此工作流程）**。 ![设置工作流程按钮](/assets/images/help/repository/setup-workflow-button.png) -5. 单击 **Start commit（开始提交）**。 ![开始提交按钮](/assets/images/help/repository/start-commit.png) -{% data reusables.files.write_commit_message %} -{% data reusables.files.choose_commit_branch %} -{% data reusables.files.propose_new_file %} - -在推送到仓库后，您可以在 {% data variables.product.prodname_dotcom %} 上跟踪持续集成工作流程运行的状态和详细日志，并接收自定义的通知。 更多信息请参阅“[配置通知](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)”和“[管理工作流程运行](/articles/managing-a-workflow-run)”。 - -{% data reusables.repositories.actions-workflow-status-badge-into %} - -更多信息请参阅“[配置工作流程](/articles/configuring-a-workflow)。 - -### 延伸阅读 - -- "[关于持续集成](/articles/about-continuous-integration)" -- "[管理工作流程运行](/articles/managing-a-workflow-run)" -{% if currentVersion == "free-pro-team@latest" %} -- "[管理 {% data variables.product.prodname_actions %} 的计费](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)" -{% endif %} diff --git a/translations/zh-CN/content/actions/configuring-and-managing-workflows/about-service-containers.md b/translations/zh-CN/content/actions/configuring-and-managing-workflows/about-service-containers.md deleted file mode 100644 index fe902cc99dac..000000000000 --- a/translations/zh-CN/content/actions/configuring-and-managing-workflows/about-service-containers.md +++ /dev/null @@ -1,116 +0,0 @@ ---- -title: 关于服务容器 -intro: 您可以使用服务容器将数据库、网络服务、内存缓存及其他工具连接到您的工作流程。 -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/about-service-containers -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### 关于服务容器 - -服务容器是 Docker 容器，以简便、可携带的方式托管您可能需要在工作流程中测试或操作应用程序的服务。 例如，您的工作流程可能必须运行需要访问数据库和内存缓存的集成测试。 - -您可以为工作流程中的每个作业配置服务容器。 {% data variables.product.prodname_dotcom %} 为工作流中配置的每个服务创建一个新的 Docker 容器，并在作业完成后销毁该服务容器。 作业中的步骤可与属于同一作业的所有服务容器通信。 - -{% data reusables.github-actions.docker-container-os-support %} - -### 与服务容器通信 - -您可以在工作流程中配置作业直接在运行器机器或 Docker 容器上运行。 作业与其服务容器之间的通信根据作业是直接在运行器上运行还是在容器中运行而有所不同。 - -#### 在容器中运行作业 - -在容器中运行作业时，{% data variables.product.prodname_dotcom %} 使用 Docker 的用户定义桥接网络将服务容器连接到作业。 更多信息请参阅 Docker 文档中的“[使用桥接网络](https://docs.docker.com/network/bridge/)”。 - -在容器中运行作业和服务可简化网络访问。 您可以使用工作流程中配置的标签访问服务容器。 服务容器的主机名自动映射到标签名称。 例如，如果您创建带有标签 `redis` 的服务容器 ，则该服务容器的主机名是 `redis`。 - -您无需为服务容器配置任何端口。 默认情况下，属于同一 Docker 网络的所有容器会相互显示所有端口，但在 Docker 网络外部不会显示任何端口。 - -#### 在运行器机器上运行作业 - -直接在运行器机器上运行作业时，您可以使用 `localhost:` 或 `127.0.0.1:` 访问服务容器。 {% data variables.product.prodname_dotcom %} 配置容器网络以启用从服务容器到 Docker 主机的通信。 - -当作业直接在运行器机器上运行时， Docker 容器中运行的服务默认情况下不会向运行器上的作业显示其端口。 您需要将服务容器上的端口映射到 Docker 主机。 更多信息请参阅“[映射 Docker 主机和服务容器端口](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)”。 - -### 创建服务容器 - -您可以使用 `services` 关键字创建服务容器作为工作流程中作业的一部分。 更多信息请参阅 [`jobs..services`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idservices)。 - -本例在作业 `container-job` 中创建一个名为 `redis` 的服务。 本例中的 Docker 主机是 `node:10.18-jessie` 容器。 - -{% raw %} -```yaml -name: Redis container example -on: push - -jobs: - # Label of the container job - container-job: - # Containers must run in Linux based operating systems - runs-on: ubuntu-latest - # Docker Hub image that `container-job` executes in - container: node:10.18-jessie - - # Service containers to run with `container-job` - services: - # Label used to access the service container - redis: - # Docker Hub image - image: redis -``` -{% endraw %} - -### 映射 Docker 主机和服务容器端口 - -如果作业在 Docker 容器中运行，则不需要映射主机或服务容器上的端口。 如果作业直接在运行器机器上运行，则需要将任何必需的服务容器端口映射到主机运行器机器上的端口。 - -您可以使用 `ports` 关键字将服务容器端口映射到 Docker 主机。 更多信息请参阅 [`jobs..services`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idservices)。 - -| `ports` 的值 | 描述 | -| ------------- | -------------------------------------------- | -| `8080:80` | 将容器中的 TCP 端口 80 映射到 Docker 主机上的端口 8080。 | -| `8080:80/udp` | 将容器中的 UDP 端口 80 映射到 Docker 主机上的端口 8080。 | -| `8080/udp` | 将容器中随机选择的 UDP 端口映射到 Docker 主机上的 UDP 端口 8080。 | - -使用 `ports` 关键字映射端口时，{% data variables.product.prodname_dotcom %} 使用 `--publish` 命令将容器的端口发布到 Docker 主机。 更多信息请参阅 Docker 文档中的“[Docker 容器网络](https://docs.docker.com/config/containers/container-networking/)”。 - -指定 Docker 主机端口但不指定容器端口时，容器端口将随机分配给空闲端口。 {% data variables.product.prodname_dotcom %} 在服务容器上下文中设置分配的容器端口。 例如，对于 `redis` 服务容器，如果您配置了 Docker 主机端口 5432，则您可以使用 `job.services.redis.ports[5432]` 上下文访问对应的容器端口。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的上下文和表达式语法](/actions/reference/context-and-expression-syntax-for-github-actions#job-context)”。 - -#### 映射 Redis 端口的示例 - -此示例映射服务容器 `redis` 端口 6379 到 Docker 主机端口 6379。 - -{% raw %} -```yaml -name: Redis Service Example -on: push - -jobs: - # Label of the container job - runner-job: - # You must use a Linux environment when using service containers or container jobs - runs-on: ubuntu-latest - - # Service containers to run with `runner-job` - services: - # Label used to access the service container - redis: - # Docker Hub image - image: redis - # - ports: - # Opens tcp port 6379 on the host and service container - - 6379:6379 -``` -{% endraw %} - -### 延伸阅读 - -- "[创建 Redis 服务容器](/actions/automating-your-workflow-with-github-actions/creating-redis-service-containers)" -- "[创建 PostgreSQL 服务容器](/actions/automating-your-workflow-with-github-actions/creating-postgresql-service-containers)" diff --git a/translations/zh-CN/content/actions/configuring-and-managing-workflows/authenticating-with-the-github_token.md b/translations/zh-CN/content/actions/configuring-and-managing-workflows/authenticating-with-the-github_token.md deleted file mode 100644 index 6fd6bfc808fc..000000000000 --- a/translations/zh-CN/content/actions/configuring-and-managing-workflows/authenticating-with-the-github_token.md +++ /dev/null @@ -1,99 +0,0 @@ ---- -title: 使用 `GITHUB_TOKEN` 进行身份验证 -intro: '{% data variables.product.prodname_dotcom %} 提供一个令牌，可用于代表 {% data variables.product.prodname_actions %} 进行身份验证。' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /github/automating-your-workflow-with-github-actions/authenticating-with-the-github_token - - /actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -对仓库具有 `write` 权限的任何人都可以创建、读取和使用密码。 - -### 关于 `GITHUB_TOKEN` 密码 - -{% data variables.product.prodname_dotcom %} 会自动创建 `GITHUB_TOKEN` 密码以在工作流程中使用。 您可以使用 `GITHUB_TOKEN` 在工作流程运行中进行身份验证。 - -当您启用 {% data variables.product.prodname_actions %} 时，{% data variables.product.prodname_dotcom %} 在您的仓库中安装 {% data variables.product.prodname_github_app %}。 `GITHUB_TOKEN` 密码是一种 {% data variables.product.prodname_github_app %} 安装访问令牌。 您可以使用安装访问令牌代表仓库中安装的 {% data variables.product.prodname_github_app %} 进行身份验证。 令牌的权限仅限于包含您的工作流程的仓库。 更多信息请参阅“[`GITHUB_TOKEN`](#permissions-for-the-github_token) 的权限”。 - -在每个作业开始之前， {% data variables.product.prodname_dotcom %} 将为作业提取安装访问令牌。 令牌在作业完成后过期。 - -令牌在 `github.token` 上下文中也可用。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的上下文和表达式语法](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)”。 - -### 在工作流程中使用 `GITHUB_TOKEN` - -要使用 `GITHUB_TOKEN` 密码，必须在工作流程文件中引用它。 使用令牌可能包括将令牌作为输入传递给需要该令牌的操作，或进行经过身份验证的 {% data variables.product.prodname_dotcom %} API 调用。 - -{% data reusables.github-actions.actions-do-not-trigger-workflows %} - -#### 将 `GITHUB_TOKEN` 作为输入传递的示例 - -此示例工作流程使用[贴标器操作](https://github.com/actions/labeler)，需要 `GITHUB_TOKEN` 作为 `repo-token` 输入参数的值： - - {% raw %} - ```yaml - name: Pull request labeler - on: - - pull_request - jobs: - triage: - runs-on: ubuntu-latest - steps: - - uses: actions/labeler@v2 - with: - repo-token: ${{ secrets.GITHUB_TOKEN }} - ``` - {% endraw %} - -#### 调用 REST API 的示例 - -您可以使用 `GITHUB_TOKEN` 进行经过验证的 API 调用。 此示例工作流程使用 {% data variables.product.prodname_dotcom %} REST API 创建议题： - - {% raw %} - ```yaml - name: Create issue on commit - on: - - push - jobs: - create_commit: - runs-on: ubuntu-latest - steps: - - name: Create issue using REST API - run: | - curl --request POST \ - --url https://api.github.com/repos/${{ github.repository }}/issues \ - --header 'authorization: Bearer ${{ secrets.GITHUB_TOKEN }}' \ - --header 'content-type: application/json' \ - --data '{ - "title": "Automated issue for commit: ${{ github.sha }}", - "body": "This issue was automatically created by the GitHub Action workflow **${{ github.workflow }}**. \n\n 提交哈希是： _${{ github.sha }}_" - }' - ``` - {% endraw %} - -### `GITHUB_TOKEN` 的权限 - -有关 {% data variables.product.prodname_github_apps %} 可通过各种权限访问的 API 端点的信息，请参阅“[{% data variables.product.prodname_github_app %} 权限](/v3/apps/permissions/)”。 - -| 权限 | 访问类型 | 通过复刻的仓库访问 | -| -------- | ---- | --------- | -| 操作 | 读/写 | 读取 | -| 检查 | 读/写 | 读取 | -| 内容 | 读/写 | 读取 | -| 部署 | 读/写 | 读取 | -| issues | 读/写 | 读取 | -| 元数据 | 读取 | 读取 | -| 包 | 读/写 | 读取 | -| 拉取请求 | 读/写 | 读取 | -| 仓库项目 | 读/写 | 读取 | -| statuses | 读/写 | 读取 | - -如果您需要的令牌需要 `GITHUB_TOKEN` 中未提供的权限，您可以创建个人访问令牌并将其设置为仓库中的密码： - -1. 使用或创建具有该仓库适当权限的令牌。 更多信息请参阅“[创建个人访问令牌](/github/authenticating-to-github/creating-a-personal-access-token)”。 -1. 添加令牌作为工作流程仓库中的密码，然后使用 {%raw%}`${{ secrets.SECRET_NAME }}`{% endraw %} 语法进行引用。 更多信息请参阅“[创建和使用加密密码](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。 diff --git a/translations/zh-CN/content/actions/configuring-and-managing-workflows/caching-and-storing-workflow-data.md b/translations/zh-CN/content/actions/configuring-and-managing-workflows/caching-and-storing-workflow-data.md deleted file mode 100644 index 75e7feb0763b..000000000000 --- a/translations/zh-CN/content/actions/configuring-and-managing-workflows/caching-and-storing-workflow-data.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: 缓存和存储工作流程数据 -intro: 缓存依赖项和存储构件以提高工作流程运行效率。 -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/zh-CN/content/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows.md b/translations/zh-CN/content/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows.md deleted file mode 100644 index b1fbc5c5174b..000000000000 --- a/translations/zh-CN/content/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows.md +++ /dev/null @@ -1,190 +0,0 @@ ---- -title: 缓存依赖项以加快工作流程 -intro: 为了使工作流程更快、更高效，可以为依赖项及其他经常重复使用的文件创建和使用缓存。 -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /github/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows - - /actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows -versions: - free-pro-team: '*' ---- - -### 关于缓存工作流程依赖项 - -工作流程运行通常在不同运行之间重新使用相同的输出或下载的依赖项。 例如，Maven、Gradle、npm 和 Yarn 等软件包和依赖项管理工具都会对下载的依赖项保留本地缓存。 - -{% data variables.product.prodname_dotcom %} 托管的运行器在一个干净的虚拟环境中启动，每次都必须下载依赖项，造成网络利用率提高、运行时间延长和成本增加。 为帮助加快重新创建这些文件，{% data variables.product.prodname_dotcom %} 可以缓存您在工作流程中经常使用的依赖项。 - -要缓存作业的依赖项，您需要使用 {% data variables.product.prodname_dotcom %} 的 `cache` 操作。 该操作检索由唯一键标识的缓存。 更多信息请参阅 [`actions/cache`](https://github.com/actions/cache)。 - -{% warning %} - -**警告**：建议不要在公共仓库缓存中存储任何敏感信息。 例如，敏感信息可以包括存储在缓存路径的文件中的访问令牌或登录凭据。 此外，命令行接口 (CLI) 程序，例如 `docker login`，可以在配置文件中保存访问凭据。 具有读取访问权限的任何人都可以在仓库上创建拉取请求并访问缓存的内容。 仓库的复刻也可在基本分支上创建拉取请求，并在基本分支上访问缓存。 - -{% endwarning %} - -### 比较构件和依赖项缓存 - -构件与缓存类似，因为它们能够在 {% data variables.product.prodname_dotcom %} 上存储文件，但每项功能都提供不同的用例，不能互换使用。 - -- 如果要在作业或工作流程运行之间重复使用不经常更改的文件，请使用缓存。 -- 如果要保存作业生成的文件，以便在工作流程结束后查看，则使用构件。 更多信息请参阅“[使用构件持久化工作流程](/github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)”。 - -### 访问缓存的限制 - -使用 `cache` 操作的 `v2`，可以访问具有 `GITHUB_REF` 的任何事件所触发的工作流程中的缓存。 如果使用 `cache` 操作的 `v1`，您只能访问由 `push` 和 `pull_request` 事件触发的工作流程中的缓存，`pull_request` `closed` 事件除外。 更多信息请参阅“[触发工作流程的事件](/actions/reference/events-that-trigger-workflows)”。 - -工作流程可以访问和还原当前分支、基础分支（包括复刻的仓库的基本分支）或默认分支（通常是 `master`）中创建的缓存 例如，在默认分支 `master` 上创建的缓存可从任何拉取请求访问。 另外，如果分支 `feature-b` 具有基础分支 `feature-a`，则触发于 `feature-b` 的工作流程可以访问默认分支 (`master`)、`feature-a` 和 `feature-b` 中创建的缓存。 - -访问限制通过在不同工作流程和分支之间创建逻辑边界来提供缓存隔离和安全。 例如， 为分支 `feature-a`（具有基础分支 `master`）创建的缓存将无法访问分支 `feature-b`（具有基础分支 `master`）的拉取请求。 - -### 使用 `cache` 操作 - -`cache` 操作将尝试恢复基于您提供的 `key` 的缓存。 当操作找到缓存时，该操作会将缓存的文件还原到您配置的 `path`。 - -如果没有精确匹配，操作在作业成功完成时将创建一个新的缓存条目。 新缓存将使用您提供的 `key` 并包含 `path` 目录中的文件。 - -当 `key` 与现有缓存不匹配时，您可以选择性提供要使用的 `restore-keys` 列表。 `restore-keys` 列表很有用，因为 `restore-keys` 可以部分匹配缓存密钥。 有关匹配 `restore-keys` 的更多信息，请参阅“[匹配缓存密钥](#matching-a-cache-key)”。 - -更多信息请参阅 [`actions/cache`](https://github.com/actions/cache)。 - -#### `cache` 操作的输入参数 - -- `key`：**必要** 保存缓存时创建的键，以及用于搜索缓存的键。 可以是变量、上下文值、静态字符串和函数的任何组合。 密钥最大长度为 512 个字符，密钥长度超过最大长度将导致操作失败。 -- `path`：**必要** 运行器上缓存或还原的文件路径。 路径可以是绝对路径或相对于工作目录的路径。 - - 使用 `cache` 操作的 `v2`，可以指定单个路径，或将多个路径指定为列表。 路径可以是目录或单个文件，并且支持 glob 模式。 - - 对于 `cache` 操作的 `v1`，仅支持单个路径，它必须是一个目录。 您不能缓存单个文件。 -- `restore-keys`：**可选** `key` 没有发生缓存命中时用于查找缓存的其他密钥顺序列表。 - -#### `cache` 操作的输出参数 - -- `cache-hit`：表示找到了密钥的精确匹配项的布尔值。 - -#### `cache` 操作使用示例 - -此示例在 `package-lock.json` 文件中的包更改时，或运行器的操作系统更改时，创建一个新的缓存。 缓存键使用上下文和表达式生成一个键值，其中包括运行器的操作系统和 `package-lock.json` 文件的 SHA-256 哈希。 - -{% raw %} -```yaml -name: Caching with npm - -on: push - -jobs: - build: - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - - name: Cache node modules - uses: actions/cache@v2 - env: - cache-name: cache-node-modules - with: - # npm cache files are stored in `~/.npm` on Linux/macOS - path: ~/.npm - key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('**/package-lock.json') }} - restore-keys: | - ${{ runner.os }}-build-${{ env.cache-name }}- - ${{ runner.os }}-build- - ${{ runner.os }}- - - - name: Install Dependencies - run: npm install - - - name: Build - run: npm build - - - name: Test - run: npm test - -``` -{% endraw %} - -当 `key` 匹配现有缓存时，被称为缓存命中，并且操作会将缓存的文件还原到 `path` 目录。 - -当 `key` 不匹配现有缓存时，则被称为缓存错过，在作业成功完成时将创建一个新缓存。 发生缓存错过时，操作将搜索称为 `restore-keys` 的替代键值。 - -1. 如果您提供 `restore-keys`，`cache` 操作将按顺序搜索与 `restore-keys` 列表匹配的任何缓存。 - - 当精确匹配时，操作会将缓存中的文件恢复至 `path` 目录。 - - 如果没有精确匹配，操作将会搜索恢复键值的部分匹配。 当操作找到部分匹配时，最近的缓存将恢复到 `path` 目录。 -1. `cache` 操作完成，作业中的下一个工作流程步骤运行。 -1. 如果作业成功完成，则操作将创建一个包含 `path` 目录内容的新缓存。 - -要在多个目录中缓存文件，您需要一个对每个目录使用 [`cache`](https://github.com/actions/cache) 操作的步骤。 创建缓存后，无法更改现有缓存的内容，但可以使用新键创建新缓存。 - -#### 使用上下文创建缓存键 - -缓存键可以包括 {% data variables.product.prodname_actions %} 支持的任何上下文、函数、文本和运算符。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的上下文和表达式语法](/actions/reference/context-and-expression-syntax-for-github-actions)”。 - -使用表达式创建 `key` 允许您在依赖项更改时自动创建新缓存。 例如，您可以使用计算 npm `package-lock.json` 文件哈希的表达式创建 `key`。 - -{% raw %} -``` -npm-${{ hashFiles('package-lock.json') }} -``` -{% endraw %} - -{% data variables.product.prodname_dotcom %} 评估表达式 `hash "package-lock.json"` 以派生最终 `key`。 - -``` -npm-d5ea0750 -``` - -### 匹配缓存键 - -`cache` 操作会先在包含工作流程运行的分支中搜索 `key` 和 `restore-key` 的缓存命中。 如果当前分支中没有命中，`cache` 操作将在父分支和上游分支中搜索 `key` 和 `restore-keys`。 - -您可以提供一个出现 `key` 缓存错过时使用的恢复键列表。 您可以创建从最具体到最不具体的多个恢复键。 `cache` 操作按顺序搜索 `restore-keys`。 当键不直接匹配时，操作将搜索以恢复键为前缀的键。 如果恢复键值有多个部分匹配项，操作将返回最近创建的缓存。 - -#### 使用多个恢复键值的示例 - -{% raw %} -``` -restore-keys: | - npm-foobar-${{ hashFiles('package-lock.json') }} - npm-foobar- - npm- -``` -{% endraw %} - -运行器将评估表达式，解析为以下 `restore-keys`： - -{% raw %} -``` -restore-keys: | - npm-foobar-d5ea0750 - npm-foobar- - npm- -``` -{% endraw %} - -恢复键值 `npm-foobar-` 与任何以字符串 `npm-foobar-` 开头的键值匹配。 例如，键值 `npm-foobar-fd3052de` 和 `npm-foobar-a9b253ff` 都与恢复键值匹配。 将使用创建日期最新的缓存。 此示例中的键值按以下顺序搜索： - -1. **`npm-foobar-d5ea0750`** 匹配特定的哈希。 -1. **`npm-foobar-`** 匹配前缀为 `npm-foobar-` 的缓存键值。 -1. **`npm-`** 匹配前缀为 `npm-` 的任何键值。 - -##### 搜索优先级示例 - -```yaml -key: - npm-feature-d5ea0750 -restore-keys: | - npm-feature- - npm- -``` - -例如，如果拉取请求包含 `feature` 分支（当前范围）并针对默认分支 (`master`)，操作将按以下顺序搜索 `key` 和 `restore-keys`： - -1. `feature` 分支范围中的键值 `npm-feature-d5ea0750` -1. `feature` 分支范围中的键值 `npm-feature-` -2. `feature` 分支范围中的键值 `npm-` -1. `master` 分支范围中的键值 `npm-feature-d5ea0750` -3. `master` 分支范围中的键值 `npm-d5ea0750` -4. `master` 分支范围中的键值 `npm` - -### 使用限制和收回政策 - -{% data variables.product.prodname_dotcom %} 将删除 7 天内未被访问的任何缓存条目。 可以存储的缓存数没有限制，但存储库中所有缓存的总大小限制为 5 GB。 如果超过此限制，{% data variables.product.prodname_dotcom %} 将保存缓存，但会开始收回缓存，直到总大小小于 5 GB。 diff --git a/translations/zh-CN/content/actions/configuring-and-managing-workflows/configuring-a-workflow.md b/translations/zh-CN/content/actions/configuring-and-managing-workflows/configuring-a-workflow.md deleted file mode 100644 index 485d35edcdeb..000000000000 --- a/translations/zh-CN/content/actions/configuring-and-managing-workflows/configuring-a-workflow.md +++ /dev/null @@ -1,382 +0,0 @@ ---- -title: 配置工作流 -intro: 您可以创建自定义工作流来自动化项目的软件开发生命周期过程。 -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /文章/创建 github 行动/ - - /文章/创建工作流-与 github 操作/ - - /文章/配置工作流 - - /github/自动化工作流-使用 github 操作/配置工作流 - - /操作/自动化工作流-使用 github 操作/配置工作流 - - /操作/创建工作流/工作流配置选项 -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -具有对存储库具有写入或管理员权限的用户可以创建、编辑或查看工作流。 - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### 关于工作流 - -工作流是自定义的自动化流程，您可以在存储库中设置这些流程，以便生成、测试、打包、发布或部署任何 {% data variables.product.prodname_dotcom %}。 借助工作流，您可以使用各种工具和服务实现软件开发生命周期的自动化。 有关详细信息，请参阅"[" {% data variables.product.prodname_actions %}](/articles/about-github-actions)。 - -您可以在存储库中创建多个工作流。 您必须将工作流存储在 `.github/工作流` 存储库根目录中。 - -工作流必须至少有一个作业，并且作业包含一组执行单个任务的步骤。 步骤可以运行命令或使用操作。 您可以创建自己的操作或使用社区共享的操作 {% data variables.product.prodname_dotcom %} 根据需要自定义它们。 - -您可以将工作流配置为在发生 {% data variables.product.prodname_dotcom %} 、计划或外部事件时启动。 - -您需要使用 YAML 语法配置工作流，并将其保存为存储库中的工作流文件。 成功创建 YAML 工作流文件并触发工作流后，将看到工作流的每个步骤的生成日志、测试结果、工件和状态。 有关详细信息，请参阅"[运行工作流](/articles/managing-a-workflow-run)。 - - ![注释的工作流运行映像](/assets/images/help/repository/annotated-workflow.png) - -您还可以接收工作流状态更新的通知。 有关通知选项的详细信息，请参阅"[通知](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)。 - -使用限制适用于各个工作流。 有关详细信息，请参阅"[工作流的使用](/articles/workflow-syntax-for-github-actions#usage-limits)。 - -### 创建工作流文件 - -在高级别上，这些是添加工作流文件的步骤。 您可以在以下各节中找到特定的配置示例。 - -1. 在存储库的根目录，创建一个名为 `.github/工作流` 以存储工作流文件。 - -1. 在 `.github/工作流`中， `为` 添加 `.yaml` 文件。 例如， `.github/工作流/连续集成工作流.yml`。 - -1. 使用"[工作流语法 {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions)"参考文档来选择事件以触发操作、添加操作和自定义工作流。 - -1. 将工作流文件中的更改提交到希望工作流运行的分支。 - -#### 工作流文件示例 - -{% raw %} -```yaml -名称： 问候 -@ 此工作流在推送到存储库时触发。 -上： [push] - -工作： - 生成： - = 作业名称是问候 - 名称： 问候 - = 此作业在 Linux - 上运行： ubuntu 最新 - 步骤： - = 此步骤使用 Github 的 hello 世界 javascript 操作： https://github.com/actions/hello-world-javascript-action - https://github.com/actions/hello-world-javascript-action 名称： 你好世界 - 使用： 动作 / hello 世界 javascript - action@v1.1 - 与： - 谁问候： '蒙娜的八角猫' - id： hello - = 此步骤打印输出 （时间） 从上一步的操作。 - - 名字： 回音问候的时间 - 运行： 回声 '时间是 ${{ steps.hello.outputs.time }}。 -``` -{% endraw %} - -{% data reusables.github-actions.invalid-workflow-files %} - -### 使用事件触发工作流 - -您可以将工作流配置为启动一次： -- 发生一 {% data variables.product.prodname_dotcom %} 事件，例如，当某人将提交推送到存储库时，或者当创建问题或拉取请求时。 -- 计划的事件开始。 -- 发生外部事件。 - -若要在发生事件后触发工作流 {% data variables.product.prodname_dotcom %}，请 `：` 和工作流名称后的事件值。 例如，当将更改推送到存储库中的任何分支时，将触发此工作流。 - -```yaml -名称：描述性工作流名称 -：推送 -``` - -若要安排工作流，可以在工作流文件中使用 POSIX cron 语法。 可以运行计划工作流的最短间隔是每 5 分钟一次。 例如，此工作流每小时触发一次。 - -```yaml -上： - 时间表： - - cron： '0]' -``` - -#### 手动运行工作流 - -若要手动运行工作流，必须首先配置工作流以使用 `workflow_dispatch` 事件。 您可以直接在工作流中配置自定义的输入属性、默认输入值和所需输入。 当工作流运行时，您可以在 github.event.输入 `中访问输入` 值。 有关详细信息，请参阅"[工作流的"](/actions/reference/events-that-trigger-workflows/#workflow_dispatch)"和"[ {% data variables.product.prodname_dotcom %} 操作的上下文](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)"。 - -此示例定义 `和` `` 输入 `github.event.inputs.name` 和 `github.event.inputs.home` 上下文。 如果未 `提供` 名称，则打印默认值"Octocat Mona"。 - -{% raw %} -```yaml -名称： 手动触发的工作流 -： - workflow_dispatch： - 输入： - 名称： - 描述： "问候的人" - ： - 默认： "Mona Octocat" - "蒙娜 回家： - ： 需要 "位置 - ： 假作业： - - - say_hello： - 运行： ubuntu 最新 - 步骤： - - 运行： - 回音"你好 ${{ github.event.inputs.name }}！ - 回声 "- 在 ${{ github.event.inputs.home }}！ -``` -{% endraw %} - -您可以使用 REST API `workflow_dispatch` "操作"选项卡 {% data variables.product.prodname_dotcom %} 触发事件。 有关使用 REST API 的信息，请参阅"[创建工作流调度事件](/rest/reference/actions/#create-a-workflow-dispatch-event)。 使用 REST API 时，应配置 `输入` `引用` 作为请求正文参数。 如果省略输入，则使用工作流文件中定义的默认值。 - -若要在 `workflow_dispatch` 上 {% data variables.product.prodname_dotcom %}，工作流必须处于默认分支中。 按照以下步骤手动触发工作流运行。 - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -1. 在左侧栏中，单击要运行的工作流。 ![操作选择工作流](/assets/images/actions-select-workflow.png) -1. 在工作流运行列表的上方，选择 **运行工作流**。 ![操作工作流调度](/assets/images/actions-workflow-dispatch.png) -1. 选择工作流将运行的分支，并键入工作流使用的输入参数。 单击 **运行工作流**。 ![操作手动运行工作流](/assets/images/actions-manually-run-workflow.png) - -#### 从外部事件触发工作流 - -若要在发生外部事件后触发工作流，可以通过调用"创建存储库调度事件"REST API 终结点来调用 `repository_dispatch` hook 事件。 有关详细信息，请参阅"[创建存储库调度事件](/v3/repos/#create-a-repository-dispatch-event)。 - -有关详细信息和示例，请参阅"[工作流的](/articles/events-that-trigger-workflows#webhook-events)。 - -### 筛选特定分支、标记和路径 - -您可以将工作流设置为仅在某些分支上运行。 - -例如，当在 `master` 分支上推送包含 测试 目录中的文件 `或推送到 v1` 标记时， 工作流将运行。 - -```yaml -上： - ： - 分支： - - 主 - 标记： - - v1 - _ 文件路径， 在事件中要考虑。 可选;默认值。 - 路径： - - "测试/*" -``` - -有关分支、标记和路径筛选器语法的信息，请参阅"[`。.`](/articles/workflow-syntax-for-github-actions#onpushpull_requestbranchestags)" 和 "[`继续。.路径`](/articles/workflow-syntax-for-github-actions#onpushpull_requestpaths)。 - -### 选择跑步者 - -您可以在由托管的 {% data variables.product.prodname_dotcom %}运行程序或自托管运行程序上运行工作流。 作业可以直接在计算机或 Docker 容器中运行。 - -您可以使用运行或运行的运行 `中为每个作业`。 有关运行 `运行`有关[，请参阅" {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idruns-on)工作流 " - -{% data reusables.actions.enterprise-github-hosted-runners %} - -#### 使用 {% data variables.product.prodname_dotcom %}托管的运行程序 - -您可以选择不同类型和版本的虚拟主机，包括 Linux、Windows 和 macOS。 工作流中的每个作业在虚拟环境的新实例中执行，作业中的步骤可以使用文件系统共享信息。 有关详细信息，请参阅"[托管跑步者 {% data variables.product.prodname_actions %}的虚拟](/articles/virtual-environments-for-github-actions)。 - -例如，您可以使用 ubuntu `的最新` 指定由托管运行程序 {% data variables.product.prodname_dotcom %}的最新版本。 - -```yaml -运行： ubuntu 最新 -``` - -#### 使用自托管的运行程序 - -您可以使用标签将作业路由到特定类型的自托管流道。 所有自托管跑步者都 `自托管` 标签，每个自托管运行程序都有其操作系统和系统体系结构的标签。 有关详细信息，请参阅"[工作流中的自托管运行程序](/actions/automating-your-workflow-with-github-actions/using-self-hosted-runners-in-a-workflow)。 - -例如，如果添加了具有 Linux 操作系统和 ARM32 体系结构的自托管运行程序，可以使用 `自托管`、 `linux`和 `ARM32` 标签选择该运行程序。 - -```yaml -运行： [自托管， linux， ARM32] -``` - -### 配置生成矩阵 - -若要同时跨多个操作系统、平台和语言版本进行测试，可以配置生成矩阵。 - -生成矩阵允许您使用不同的软件和操作系统配置测试代码。 例如，工作流可以运行语言、操作系统或工具的多个受支持版本的作业。 对于每个配置，作业的副本将运行并报告状态。 - -您可以在工作流文件中指定生成矩阵，其中数组在"配置"策略 `：`。 例如，此生成矩阵将运行具有不同版本的 Node.js 和 Ubuntu（Linux 操作系统）的作业。 - -{% data reusables.repositories.actions-matrix-builds-os %} - -{% raw %} -```yaml -运行： ${{ matrix.os }} -： - 矩阵： - os： [ubuntu-16.04， ubuntu-18.04] - 节点： [6， 8， 10] -``` -{% endraw %} - -有关详细信息，请参阅"[的工作流 {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix)。 - -### 使用签出操作 - -可以在工作流中使用多个标准操作。 签出操作是一个标准操作，在以下时间之前，您必须在工作流中包括该操作， 然后再执行其他操作： -- 您的工作流需要存储库代码的副本，例如在构建和测试存储库或使用持续集成时。 -- 工作流中至少有一个操作在同一存储库中定义。 有关详细信息，请参阅"[工作流中的"引用操作](#referencing-actions-in-your-workflow)。 - -若要在没有进一步规范的情况下使用标准签出操作，请包括以下步骤： -```yaml -- 使用：操作/checkout@v2 -``` -在此示例中 `使用` v2，可确保使用签出操作的稳定版本。 有关详细信息，请参阅 [结帐操作](https://github.com/actions/checkout)。 - -### 选择工作流的操作类型 - -工作流中可以使用不同类型的操作来满足项目的需求： -- 码头容器操作 -- JavaScript 操作 -- 复合运行步骤操作 - -有关详细信息，请参阅"[操作](/articles/about-actions#types-of-actions)"。 - -在选择要在工作流中使用的操作类型时，我们建议在公共存储库或 Docker 中心上探索现有操作，并可能为项目自定义这些操作。 - -您可以浏览和使用由用户在 {% data variables.product.prodname_dotcom %} 中构建 [github.com/actions](https://github.com/actions) 操作。 若要访问 Docker 中心，请参阅 Docker[站点上的](https://www.docker.com/products/docker-hub)"。" - -### 引用工作流中的操作 - -若要使用正确的语法引用工作流文件中的操作，必须考虑操作的定义位置。 - -工作流可以使用在以下项中定义的操作： -- 公共存储库 -- 工作流文件引用操作的同一存储库 -- Docker 集线器上已发布的 Docker 容器映像 - -若要使用在专用存储库中定义的操作，工作流文件和操作必须在同一个存储库中。 您的工作流不能使用在其他私有存储库中定义的操作，即使其他私有存储库位于同一组织中。 - -若要对操作进行更新时保持工作流稳定，可以通过在工作流文件中指定 Git ref 或 Docker 标记编号来引用正在使用的操作的版本。 有关示例，请参阅"[的工作流 {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idstepsuses)。 - -{% if currentVersion == "free-pro-team@latest" %} -{% data reusables.dependabot.version-updates-for-actions %} -{% endif %} - -有关更详细的配置选项，请参阅"[的工作流 {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)。 - -#### 从公共存储库引用操作 - -如果在公共存储库中定义了操作，则必须使用语法 `{owner}/{repo}_{ref}` 或 `{owner}/{repo}/{path}@{ref}`引用操作。 - -```yaml -作业： - my_first_job： - 名称： 我的作业名称 - 步骤： - - 使用： 操作 / 设置 - node@v1 - ： - 版本： 10.x -``` - -若要查看完整的工作流示例，请参阅 [模板存储库](https://github.com/actions/setup-node) 设置节点。 - -#### 引用工作流文件使用操作的同一存储库中的操作 - -如果在工作流文件使用该操作的同一存储库中定义了操作，则可以使用工作流文件中的`{owner}/{repo}@{ref}` 或 `./path/to/dir` 语法引用该操作。 - -存储库文件结构示例： - -``` -[- - 你好世界 （存储库） -] [__. github -] └ • 工作流 -| └ [我的第一工作流. yml -] └[行动 -] [你好世界行动 -] └ = 行动. yml -``` - -工作流文件示例： - -```yaml -作业： - ： - 运行： ubuntu 最新 - 步骤： - # 此步骤签出存储库的副本。 - - 使用：操作/checkout@v2 - # 此步骤引用包含操作的目录。 - - 使用：..github/行动/你好世界行动 -``` - -#### 在 Docker 集线器上引用容器 - -如果在 Docker Hub 上的已发布 Docker 容器映像中定义了操作，则必须在工作流文件中使用 `docker://{image}：{tag}` 语法引用该操作。 为了保护您的代码和数据，我们强烈建议您先在工作流中使用 Docker Hub 来验证 Docker 容器映像的完整性。 - -```yaml -工作： - my_first_job： - 步： - - 名称： 我的第一步 - 使用： docker：： 3.8 -``` - -有关 Docker 操作的一些示例，请参阅 [Docker-image.yml 工作流](https://github.com/actions/starter-workflows/blob/master/ci/docker-image.yml) "[创建 Docker 容器操作](/articles/creating-a-docker-container-action)。 - -有关详细信息，请参阅"[的工作流 {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idstepsuses)。 - -### 向存储库添加工作流状态徽章 - -{% data reusables.repositories.actions-workflow-status-badge-into %} - -如果工作流使用 `关键字` ，则必须按名称引用工作流。 如果工作流的名称包含空格，则需要将该空格替换为 URL 编码的字符串 `%20`。 有关关键字名称 `有关` ，请参阅"[的工作流 {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#name)。 - -``` -https://github.com/// 工作流 // badge. svg -``` - -或者，如果您的工作流没有 `名称`，则必须使用相对于存储库的根目录的文件路径引用工作流文件。 - -{% note %} - -**注意：** 如果工作流具有一个包含名称的配置文件，则使用文件路径 `工作流`。 - -{% endnote %} - -``` -https://github.com/// 工作流 // badge. svg -``` - -#### 使用工作流名称的示例 - -此标记示例为工作流添加状态徽章，名称为"问候所有人"。 存储库 `所有者` 是 `组织` ， `名称` 是 `hello world`。 - -``` -![示例工作流名称]（https://github.com/actions/hello-world/workflows/Greet%20E非常一/badge.svg） -``` - -#### 使用工作流文件路径的示例 - -此 Markdown 示例为具有文件路径的工作流添加了状态徽章 `.github/工作流/main.yml`。 存储库 `所有者` 是 `组织` ， `名称` 是 `hello world`。 - -``` -![示例工作流文件路径]（https://github.com/actions/hello-world/workflows/.github/workflows/main.yml/badge.svg） -``` - -#### 使用分支 `` 示例 - -此标记示例为名称为功能-1 的分支添加 `标记`。 - -``` -![示例分支参数]（https://github.com/actions/hello-world/workflows/Greet%20E非常一/badge.svg？branch=功能-1） -``` - -#### 使用事件 `` 示例 - -此 Markdown 示例添加了一个徽章，显示由事件触发的工作流 `pull_request` 状态。 - -``` -![示例事件参数]（https://github.com/actions/hello-world/workflows/Greet%20E非常一/badge.svg？事件=pull_request） -``` - -{% if currentVersion == "free-pro-team@latest" %} -### 延伸阅读 - -- [[管理帐户的 {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)" -{% endif %} diff --git a/translations/zh-CN/content/actions/configuring-and-managing-workflows/configuring-and-managing-workflow-files-and-runs.md b/translations/zh-CN/content/actions/configuring-and-managing-workflows/configuring-and-managing-workflow-files-and-runs.md deleted file mode 100644 index 83562972b657..000000000000 --- a/translations/zh-CN/content/actions/configuring-and-managing-workflows/configuring-and-managing-workflow-files-and-runs.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: 配置和管理工作流程文件和运行 -intro: 创建和配置工作流程以实现部分项目开发的自动化。 -mapTopic: true -redirect_from: - - /articles/configuring-workflows - - /github/automating-your-workflow-with-github-actions/configuring-workflows - - /actions/automating-your-workflow-with-github-actions/configuring-workflows -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/zh-CN/content/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets.md b/translations/zh-CN/content/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets.md deleted file mode 100644 index d2c4a9ab3340..000000000000 --- a/translations/zh-CN/content/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets.md +++ /dev/null @@ -1,220 +0,0 @@ ---- -title: 创建和存储加密密码 -intro: 加密密码允许您在仓库或组织中存储敏感信息。 -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets - - /actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### 关于加密密码 - -密码是在仓库或组织中创建的加密环境变量。 您创建的密码可用于 {% data variables.product.prodname_actions %} 工作流程。 在密码到达 {% data variables.product.prodname_dotcom %} 之前，{% data variables.product.prodname_dotcom %} 使用 [libsodium 密封盒](https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes)对密码加密，并且在您于工作流程中使用它们之前一直保持加密状态。 - -{% data reusables.github-actions.secrets-org-level-overview %} - -#### 命名您的密码 - -以下规则适用于密码名称： - -* 密码名称只能包含字母数字字符（`[a-z]`、`[A-Z]`、`[0-9]`）或下划线 (`_`)。 不允许空格。 -* 密码名称不能以 `GITHUB_` 前缀开头。 -* 密码名称不能以数字开头。 -* 密码名称在所创建的级别上必须是唯一的。 例如，在组织级别创建的密码必须在该级别具有唯一名称，而在仓库级别创建的密码必须在该仓库具有唯一名称。 如果组织级别密码的名称与仓库级别的密码相同，则仓库级别的密码优先。 - -为帮助确保 {% data variables.product.prodname_dotcom %} 在日志中编写密码，请勿将结构化数据用作密码的值。 例如，避免创建包含 JSON 或编码 Git blob 的密码。 - -#### 访问您的密码 - -为使密码用于操作，必须将密码设置为工作流程文件中的输入或环境变量。 查看操作的自述文件以了解操作预期的输入和环境变量。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepsenv)”。 - -如果您拥有编辑文件的权限，便可在工作流程文件中使用和读取加密密码。 更多信息请参阅“[{% data variables.product.prodname_dotcom %} 上的访问权限](/github/getting-started-with-github/access-permissions-on-github)”。 - -{% warning %} - -**警告：**{% data variables.product.prodname_dotcom %} 自动将密码编写到日志，但您应避免有意将密码打印到日志。 - -{% endwarning %} - -您还可以使用 REST API 管理密码。 更多信息请参阅“[密码](/v3/actions/secrets/)”。 - -#### 限制凭据权限 - -生成凭据时，建议尽可能授予最低的权限。 例如，不使用个人凭据，而使用[部署密钥](/v3/guides/managing-deploy-keys/#deploy-keys)或服务帐户。 请考虑授予只读权限（如果这是所需的全部权限）并尽可能限制访问。 生成个人访问令牌 (PAT) 时，选择所需的最小范围。 - -### 为仓库创建加密密码 - -{% data reusables.github-actions.permissions-statement-secrets-repository %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -{% data reusables.github-actions.sidebar-secret %} -1. 单击 **Add a new secret（添加新机密）**。 -1. 在 **Name（名称）**输入框中键入密码的名称。 -1. 输入密码的值。 -1. 单击 **Add secret（添加密码）**。 - -如果您的仓库可以从父级组织访问密码，则此页上也会列出这些密码。 - -### 为组织创建加密密码 - -在组织中创建密码时，可以使用策略来限制可以访问该密码的仓库。 例如，您可以将访问权限授予所有仓库，也可以限制仅私有仓库或指定的仓库列表拥有访问权限。 - -{% data reusables.github-actions.permissions-statement-secrets-organization %} - -{% data reusables.organizations.navigate-to-org %} -{% data reusables.organizations.org_settings %} -{% data reusables.github-actions.sidebar-secret %} -1. 单击 **New secret（新建密码）**。 -1. 在 **Name（名称）**输入框中键入密码的名称。 -1. 输入密码的 **Value（值）**。 -1. 从 **Repository access（仓库访问权限）**下拉列表，选择访问策略。 -1. 单击 **Add secret（添加密码）**。 - -### 审查对组织级别密码的访问权限 - -您可以检查哪些访问策略正被应用于组织中的密码。 - -{% data reusables.organizations.navigate-to-org %} -{% data reusables.organizations.org_settings %} -{% data reusables.github-actions.sidebar-secret %} -1. 密码列表包括任何已配置的权限和策略。 例如： ![密码列表](/assets/images/help/settings/actions-org-secrets-list.png) -1. 有关已为每个密码配置的权限的更多信息，请单击 **Update（更新）**。 - -### 在工作流程中使用加密密码 - -除了 `GITHUB_TOKEN` 以外，从复刻的仓库触发工作流程时密码不会传递给运行程序。 - -要提供以密码作为输入或环境变量的操作，可以使用 `secrets` 上下文访问您在仓库中创建的密码。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的上下文和表达式语法](/actions/reference/context-and-expression-syntax-for-github-actions)”和“[{% data variables.product.prodname_actions %} 的工作流程语法](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)”。 - -{% raw %} -```yaml -steps: - - name: Hello world action - with: # Set the secret as an input - super_secret: ${{ secrets.SuperSecret }} - env: # Or as an environment variable - super_secret: ${{ secrets.SuperSecret }} -``` -{% endraw %} - -尽可能避免使用命令行在进程之间传递密码。 命令行进程可能对其他用户可见（使用 `ps` 命令）或通过[安全审计事件](https://docs.microsoft.com/en-us/windows-server/identity/ad-ds/manage/component-updates/command-line-process-auditing)获取。 为帮助保护密码，请考虑使用环境变量 `STDIN` 或目标进程支持的其他机制。 - -如果必须在命令行中传递密码，则将它们包含在适当的引用规则中。 密码通常包含可能意外影响 shell 的特殊字符。 要转义这些特殊字符，请引用环境变量。 例如： - -#### 使用 Bash 的示例 - -{% raw %} -```yaml -steps: - - shell: bash - env: - SUPER_SECRET: ${{ secrets.SuperSecret }} - run: | - example-command "$SUPER_SECRET" -``` -{% endraw %} - -#### 使用 PowerShell 的示例 - -{% raw %} -```yaml -steps: - - shell: pwsh - env: - SUPER_SECRET: ${{ secrets.SuperSecret }} - run: | - example-command "$env:SUPER_SECRET" -``` -{% endraw %} - -#### 使用 Cmd.exe 的示例 - -{% raw %} -```yaml -steps: - - shell: cmd - env: - SUPER_SECRET: ${{ secrets.SuperSecret }} - run: | - example-command "%SUPER_SECRET%" -``` -{% endraw %} - -### 密码的限制 - -您的工作流程最多可以有 100 个密码。 密码环境变量的名称在仓库中必须是唯一的。 - -密码大小限于 64 KB。 要使用大于 64 KB 的密码，可以将加密的密码存储在仓库中，并将解密短语在 {% data variables.product.prodname_dotcom %} 上存储为密码。 例如，在将文件检入您在 {% data variables.product.prodname_dotcom %} 上的仓库之前，可以使用 `gpg` 在本地对您的凭据加密。 更多信息请参阅“[gpg manpage](https://www.gnupg.org/gph/de/manual/r1023.html)”。 - -{% warning %} - -**警告**：请注意，您的密码在操作运行时不会印出。 使用此解决方法时，{% data variables.product.prodname_dotcom %} 不会编写日志中印出的密码。 - -{% endwarning %} - -1. 从终端运行以下命令，以使用 `gpg` 和 AES256 密码算法对 `my_secret.json` 文件加密。 - - ``` shell - $ gpg --symmetric --cipher-algo AES256 my_secret.json - ``` - -1. 将会提示您输入密码短语。 请记住该密码短语，因为需要在使用该密码短语作为值的 {% data variables.product.prodname_dotcom %} 上创建新密码。 - -1. 创建包含密码短语的新密码。 例如，使用名称 `LARGE_SECRET_PASSPHRASE` 创建新密码，并将密码的值设为上一步所选的密码短语。 - -1. 将加密的文件复制到仓库并提交。 在本例中，加密的文件是 `my_secret.json.gpg`。 - -1. 创建 shell 脚本对密码解密。 将此文件另存为 `decrypt_secret.sh`。 - - ``` shell - #!/bin/sh - - # 解密文件 - mkdir $HOME/secrets - # --批处理以防止交互式命令 - # --是以假定问题的回答是“是” - gpg --quiet --batch --yes --decrypt --passphrase="$LARGE_SECRET_PASSPHRASE" \ - --output $HOME/secrets/my_secret.json my_secret.json.gpg - ``` - -1. 确保 shell 脚本在检入仓库之前可执行。 - - ``` shell - $ chmod +x decrypt_secret.sh - $ git add decrypt_secret.sh - $ git commit -m "Add new decryption script" - $ git push - ``` - -1. 从工作流程使用 `step` 调用 shell 脚本并对密码解密。 要在工作流程运行的环境中创建仓库的副本，需要使用 [`actions/checkout`](https://github.com/actions/checkout) 操作。 使用与仓库根目录相关的 `run` 命令引用 shell 脚本。 - -{% raw %} - ```yaml - 名称： 具有大机密的工作流 - - ： 推送 - - 作业： - 我的工作： - 名称： 我的工作 - 运行： ubuntu 最新 - 步骤： - - 使用： 操作 / checkout@v2 - - 名称： 解密大机密 - 运行：..github/脚本/decrypt_secret.sh - env： - LARGE_SECRET_PASSPHRASE： ${{ secrets.LARGE_SECRET_PASSPHRASE }} - = 此命令只是显示您的机密被打印的示例 - # 确保删除机密的任何打印语句。 GitHub does - # not hide secrets that use this workaround. - - name: Test printing your secret (Remove this step in production) - run: cat $HOME/secrets/my_secret.json - ``` -{% endraw %} diff --git a/translations/zh-CN/content/actions/configuring-and-managing-workflows/creating-postgresql-service-containers.md b/translations/zh-CN/content/actions/configuring-and-managing-workflows/creating-postgresql-service-containers.md deleted file mode 100644 index cf573867c58c..000000000000 --- a/translations/zh-CN/content/actions/configuring-and-managing-workflows/creating-postgresql-service-containers.md +++ /dev/null @@ -1,335 +0,0 @@ ---- -title: 创建 PostgreSQL 服务容器 -intro: 您可以创建 PostgreSQL 服务容器用于您的工作流程。 本指南举例说明如何为容器中运行或直接在运行器机器上运行的作业创建 PostgreSQL 服务。 -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/creating-postgresql-service-containers -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### 简介 - -本指南演示了使用 Docker Hub `postgres` 映像配置服务容器的工作流程示例。 工作流程运行脚本来创建 PostgreSQL 客户端并使用数据填充客户端。 要测试工作流程是否创建并填充 PostgreSQL 客户端，脚本会将客户端数据打印到控制台。 - -{% data reusables.github-actions.docker-container-os-support %} - -### 基本要求 - -{% data reusables.github-actions.service-container-prereqs %} - -你可能还会发现它也有助于基本了解 YAML、{% data variables.product.prodname_actions %} 的语法和 PostgreSQL。 更多信息请参阅： - -- "[配置工作流程](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)" -- PostgreSQL 文档中的“[PostgreSQL 教程](https://www.postgresqltutorial.com/)” -- "[{% data variables.product.prodname_actions %} 的核心概念](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)" -- "[使用环境变量](/actions/automating-your-workflow-with-github-actions/using-environment-variables)" - -### 在容器中运行作业 - -{% data reusables.github-actions.container-jobs-intro %} - -{% data reusables.github-actions.copy-workflow-file %} - -{% raw %} -```yaml -name: PostgreSQL service example -on: push - -jobs: - # Label of the container job - container-job: - # Containers must run in Linux based operating systems - runs-on: ubuntu-latest - # Docker Hub image that `container-job` executes in - container: node:10.18-jessie - - # Service containers to run with `container-job` - services: - # Label used to access the service container - postgres: - # Docker Hub image - image: postgres - # Provide the password for postgres - env: - POSTGRES_PASSWORD: postgres - # Set health checks to wait until postgres has started - options: >- - --health-cmd pg_isready - --health-interval 10s - --health-timeout 5s - --health-retries 5 - - steps: - # Downloads a copy of the code in your repository before running CI tests - - name: Check out repository code - uses: actions/checkout@v2 - - # Performs a clean installation of all dependencies in the `package.json` file - # For more information, see https://docs.npmjs.com/cli/ci.html - - name: Install dependencies - run: npm ci - - - name: Connect to PostgreSQL - # Runs a script that creates a PostgreSQL client, populates - # the client with data, and retrieves data - run: node client.js - # Environment variable used by the `client.js` script to create a new PostgreSQL client. - env: - # The hostname used to communicate with the PostgreSQL service container - POSTGRES_HOST: postgres - # The default PostgreSQL port - POSTGRES_PORT: 5432 -``` -{% endraw %} - -#### 配置运行器作业 - -{% data reusables.github-actions.service-container-host %} - -{% data reusables.github-actions.postgres-label-description %} - -```yaml -jobs: - # Label of the container job - container-job: - # Containers must run in Linux based operating systems - runs-on: ubuntu-latest - # Docker Hub image that `container-job` executes in - container: node:10.18-jessie - - # Service containers to run with `container-job` - services: - # Label used to access the service container - postgres: - # Docker Hub image - image: postgres - # Provide the password for postgres - env: - POSTGRES_PASSWORD: postgres - # Set health checks to wait until postgres has started - options: >- - --health-cmd pg_isready - --health-interval 10s - --health-timeout 5s - --health-retries 5 -``` - -#### 配置步骤 - -{% data reusables.github-actions.service-template-steps %} - -```yaml -steps: - # Downloads a copy of the code in your repository before running CI tests - - name: Check out repository code - uses: actions/checkout@v2 - - # Performs a clean installation of all dependencies in the `package.json` file - # For more information, see https://docs.npmjs.com/cli/ci.html - - name: Install dependencies - run: npm ci - - - name: Connect to PostgreSQL - # Runs a script that creates a PostgreSQL client, populates - # the client with data, and retrieves data - run: node client.js - # Environment variable used by the `client.js` script to create - # a new PostgreSQL client. - env: - # The hostname used to communicate with the PostgreSQL service container - POSTGRES_HOST: postgres - # The default PostgreSQL port - POSTGRES_PORT: 5432 -``` - -{% data reusables.github-actions.postgres-environment-variables %} - -PostgreSQL 文档中的服务的主机名是您在工作流程中配置的标签，本例中为 `postgres`。 由于同一用户定义的网桥网络上的 Docker 容器默认打开所有端口，因此您将能够访问默认 PostgreSQL 端口 5432 上的服务容器。 - -### 直接在运行器机器上运行作业 - -直接在运行器机器上运行作业时，需要将服务容器上的端口映射到 Docker 主机上的端口。 您可以使用 `localhost` 和 Docker 主机端口号从 Docker 主机访问服务容器。 - -{% data reusables.github-actions.copy-workflow-file %} - -{% raw %} -```yaml -name: PostgreSQL Service Example -on: push - -jobs: - # Label of the runner job - runner-job: - # You must use a Linux environment when using service containers or container jobs - runs-on: ubuntu-latest - - # Service containers to run with `runner-job` - services: - # Label used to access the service container - postgres: - # Docker Hub image - image: postgres - # Provide the password for postgres - env: - POSTGRES_PASSWORD: postgres - # Set health checks to wait until postgres has started - options: >- - --health-cmd pg_isready - --health-interval 10s - --health-timeout 5s - --health-retries 5 - ports: - # Maps tcp port 5432 on service container to the host - - 5432:5432 - - steps: - # Downloads a copy of the code in your repository before running CI tests - - name: Check out repository code - uses: actions/checkout@v2 - - # Performs a clean installation of all dependencies in the `package.json` file - # For more information, see https://docs.npmjs.com/cli/ci.html - - name: Install dependencies - run: npm ci - - - name: Connect to PostgreSQL - # Runs a script that creates a PostgreSQL client, populates - # the client with data, and retrieves data - run: node client.js - # Environment variable used by the `client.js` script to create - # a new PostgreSQL client. - env: - # The hostname used to communicate with the PostgreSQL service container - POSTGRES_HOST: localhost - # The default PostgreSQL port - POSTGRES_PORT: 5432 -``` -{% endraw %} - -#### 配置运行器作业 - -{% data reusables.github-actions.service-container-host-runner %} - -{% data reusables.github-actions.postgres-label-description %} - -工作流程将 PostgreSQL 服务容器上的端口 5432 映射到 Docker 主机。 有关 `ports` 关键字的更多信息，请参阅“[关于服务容器](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)”。 - -```yaml -jobs: - # Label of the runner job - runner-job: - # You must use a Linux environment when using service containers or container jobs - runs-on: ubuntu-latest - - # Service containers to run with `runner-job` - services: - # Label used to access the service container - postgres: - # Docker Hub image - image: postgres - # Provide the password for postgres - env: - POSTGRES_PASSWORD: postgres - # Set health checks to wait until postgres has started - options: >- - --health-cmd pg_isready - --health-interval 10s - --health-timeout 5s - --health-retries 5 - ports: - # Maps tcp port 5432 on service container to the host - - 5432:5432 -``` - -#### 配置步骤 - -{% data reusables.github-actions.service-template-steps %} - -```yaml -steps: - # Downloads a copy of the code in your repository before running CI tests - - name: Check out repository code - uses: actions/checkout@v2 - - # Performs a clean installation of all dependencies in the `package.json` file - # For more information, see https://docs.npmjs.com/cli/ci.html - - name: Install dependencies - run: npm ci - - - name: Connect to PostgreSQL - # Runs a script that creates a PostgreSQL client, populates - # the client with data, and retrieves data - run: node client.js - # Environment variable used by the `client.js` script to create - # a new PostgreSQL client. - env: - # The hostname used to communicate with the PostgreSQL service container - POSTGRES_HOST: localhost - # The default PostgreSQL port - POSTGRES_PORT: 5432 -``` - -{% data reusables.github-actions.postgres-environment-variables %} - -{% data reusables.github-actions.service-container-localhost %} - -### 测试 PostgreSQL 服务容器 - -您可以使用以下脚本测试工作流程，该脚本将创建 PostgreSQL 客户端，并添加包含某些占位符数据的新表。 然后，脚本将存储在 PostgreSQL 客户端中的值打印到终端。 您的脚本可以使用任何您喜欢的语言，但此示例使用 Node.js 和 `Pg` npm 模块。 更多信息请参阅 [npm pg 模块](https://www.npmjs.com/package/pg)。 - -您可以修改 *client.js* 以包含工作流程需要的任何 PostgreSQL 操作。 在此示例中，脚本创建 PostgreSQL 客户端实例、创建表、添加占位符数据，然后检索数据。 - -{% data reusables.github-actions.service-container-add-script %} - -```javascript -const { Client } = require('pg'); - -const pgclient = new Client({ - host: process.env.POSTGRES_HOST, - port: process.env.POSTGRES_PORT, - user: 'postgres', - password: 'postgres', - database: 'postgres' -}); - -pgclient.connect(); - -const table = 'CREATE TABLE student(id SERIAL PRIMARY KEY, firstName VARCHAR(40) NOT NULL, lastName VARCHAR(40) NOT NULL, age INT, address VARCHAR(80), email VARCHAR(40))' -const text = 'INSERT INTO student(firstname, lastname, age, address, email) VALUES($1, $2, $3, $4, $5) RETURNING *' -const values = ['Mona the', 'Octocat', 9, '88 Colin P Kelly Jr St, San Francisco, CA 94107, United States', 'octocat@github.com'] - -pgclient.query(table, (err, res) => { - if (err) throw err -}); - -pgclient.query(text, values, (err, res) => { - if (err) throw err -}); - -pgclient.query('SELECT * FROM student', (err, res) => { - if (err) throw err - console.log(err, res.rows) // Print the data in student table - pgclient.end() -}); -``` - -该脚本创建新的 PostgreSQLL `Client`，接受 `host` 和 `port` 参数。 该脚本使用 `POSTGRES_HOST` 和 `POSTGRES_PORT` 环境变量来设置客户端的 IP 地址和端口。 如果未定义 `host` 和 `port`，则默认主机为 `localhost`，默认端口为 5432。 - -脚本创建一个表并将用占位符数据添加。 要测试 PostgreSQL 数据库是否包含数据，脚本将会表的内容打印到控制台日志。 - -运行此工作流程时，应会在“连接到 PostgreSQL”步骤中看到以下输出，确认您创建了 PostgreSQL 客户端并添加了数据： - -``` -null [ { id: 1, - firstname: 'Mona the', - lastname: 'Octocat', - age: 9, - address: - '88 Colin P Kelly Jr St, San Francisco, CA 94107, United States', - email: 'octocat@github.com' } ] -``` diff --git a/translations/zh-CN/content/actions/configuring-and-managing-workflows/creating-redis-service-containers.md b/translations/zh-CN/content/actions/configuring-and-managing-workflows/creating-redis-service-containers.md deleted file mode 100644 index 722e5ba67bf5..000000000000 --- a/translations/zh-CN/content/actions/configuring-and-managing-workflows/creating-redis-service-containers.md +++ /dev/null @@ -1,325 +0,0 @@ ---- -title: 创建 Redis 服务容器 -intro: 您可以使用服务容器在工作流程中创建 Redis 客户端。 本指南举例说明如何为容器中运行或直接在运行器机器上运行的作业创建 Redis 服务。 -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/creating-redis-service-containers -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### 简介 - -本指南演示了使用 Docker Hub `redis` 映像配置服务容器的工作流程示例。 工作流程运行脚本来创建 Redis 客户端并使用数据填充客户端。 要测试工作流程是否创建并填充 Redis 客户端，脚本会将客户端数据打印到控制台。 - -{% data reusables.github-actions.docker-container-os-support %} - -### 基本要求 - -{% data reusables.github-actions.service-container-prereqs %} - -你可能还会发现它也有助于基本了解 YAML、{% data variables.product.prodname_actions %} 的语法和 Redis。 更多信息请参阅： - -- "[配置工作流程](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)" -- Redis 文档中的“[Redis 使用入门](https://redislabs.com/get-started-with-redis/)” -- "[{% data variables.product.prodname_actions %} 的核心概念](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)" -- "[使用环境变量](/actions/automating-your-workflow-with-github-actions/using-environment-variables)" - -### 在容器中运行作业 - -{% data reusables.github-actions.container-jobs-intro %} - -{% data reusables.github-actions.copy-workflow-file %} - -{% raw %} -```yaml -name: Redis container example -on: push - -jobs: - # Label of the container job - container-job: - # Containers must run in Linux based operating systems - runs-on: ubuntu-latest - # Docker Hub image that `container-job` executes in - container: node:10.18-jessie - - # Service containers to run with `container-job` - services: - # Label used to access the service container - redis: - # Docker Hub image - image: redis - # Set health checks to wait until redis has started - options: >- - --health-cmd "redis-cli ping" - --health-interval 10s - --health-timeout 5s - --health-retries 5 - - steps: - # Downloads a copy of the code in your repository before running CI tests - - name: Check out repository code - uses: actions/checkout@v2 - - # Performs a clean installation of all dependencies in the `package.json` file - # For more information, see https://docs.npmjs.com/cli/ci.html - - name: Install dependencies - run: npm ci - - - name: Connect to Redis - # Runs a script that creates a Redis client, populates - # the client with data, and retrieves data - run: node client.js - # Environment variable used by the `client.js` script to create a new Redis client. - env: - # The hostname used to communicate with the Redis service container - REDIS_HOST: redis - # The default Redis port - REDIS_PORT: 6379 -``` -{% endraw %} - -#### 配置容器作业 - -{% data reusables.github-actions.service-container-host %} - -{% data reusables.github-actions.redis-label-description %} - -```yaml -jobs: - # Label of the container job - container-job: - # Containers must run in Linux based operating systems - runs-on: ubuntu-latest - # Docker Hub image that `container-job` executes in - container: node:10.18-jessie - - # Service containers to run with `container-job` - services: - # Label used to access the service container - redis: - # Docker Hub image - image: redis - # Set health checks to wait until redis has started - options: >- - --health-cmd "redis-cli ping" - --health-interval 10s - --health-timeout 5s - --health-retries 5 -``` - -#### 配置步骤 - -{% data reusables.github-actions.service-template-steps %} - -```yaml -steps: - # Downloads a copy of the code in your repository before running CI tests - - name: Check out repository code - uses: actions/checkout@v2 - - # Performs a clean installation of all dependencies in the `package.json` file - # For more information, see https://docs.npmjs.com/cli/ci.html - - name: Install dependencies - run: npm ci - - - name: Connect to Redis - # Runs a script that creates a Redis client, populates - # the client with data, and retrieves data - run: node client.js - # Environment variable used by the `client.js` script to create a new Redis client. - env: - # The hostname used to communicate with the Redis service container - REDIS_HOST: redis - # The default Redis port - REDIS_PORT: 6379 -``` - -{% data reusables.github-actions.redis-environment-variables %} - -Redis 服务的主机名是您在工作流程中配置的标签，本例中为 `redis`。 由于同一用户定义的网桥网络上的 Docker 容器默认打开所有端口，因此您将能够访问默认 Redis 端口 6379 上的服务容器。 - -### 直接在运行器机器上运行作业 - -直接在运行器机器上运行作业时，需要将服务容器上的端口映射到 Docker 主机上的端口。 您可以使用 `localhost` 和 Docker 主机端口号从 Docker 主机访问服务容器。 - -{% data reusables.github-actions.copy-workflow-file %} - -{% raw %} -```yaml -name: Redis runner example -on: push - -jobs: - # Label of the runner job - runner-job: - # You must use a Linux environment when using service containers or container jobs - runs-on: ubuntu-latest - - # Service containers to run with `runner-job` - services: - # Label used to access the service container - redis: - # Docker Hub image - image: redis - # Set health checks to wait until redis has started - options: >- - --health-cmd "redis-cli ping" - --health-interval 10s - --health-timeout 5s - --health-retries 5 - ports: - # Maps port 6379 on service container to the host - - 6379:6379 - - steps: - # Downloads a copy of the code in your repository before running CI tests - - name: Check out repository code - uses: actions/checkout@v2 - - # Performs a clean installation of all dependencies in the `package.json` file - # For more information, see https://docs.npmjs.com/cli/ci.html - - name: Install dependencies - run: npm ci - - - name: Connect to Redis - # Runs a script that creates a Redis client, populates - # the client with data, and retrieves data - run: node client.js - # Environment variable used by the `client.js` script to create - # a new Redis client. - env: - # The hostname used to communicate with the Redis service container - REDIS_HOST: localhost - # The default Redis port - REDIS_PORT: 6379 -``` -{% endraw %} - -#### 配置运行器作业 - -{% data reusables.github-actions.service-container-host-runner %} - -{% data reusables.github-actions.redis-label-description %} - -工作流程将 Redis 服务容器上的端口 6379 映射到 Docker 主机。 有关 `ports` 关键字的更多信息，请参阅“[关于服务容器](/actions/automating-your-workflow-with-github-actions/about-service-containers#mapping-docker-host-and-service-container-ports)”。 - -```yaml -jobs: - # Label of the runner job - runner-job: - # You must use a Linux environment when using service containers or container jobs - runs-on: ubuntu-latest - - # Service containers to run with `runner-job` - services: - # Label used to access the service container - redis: - # Docker Hub image - image: redis - # Set health checks to wait until redis has started - options: >- - --health-cmd "redis-cli ping" - --health-interval 10s - --health-timeout 5s - --health-retries 5 - ports: - # Maps port 6379 on service container to the host - - 6379:6379 -``` - -#### 配置步骤 - -{% data reusables.github-actions.service-template-steps %} - -```yaml -steps: - # Downloads a copy of the code in your repository before running CI tests - - name: Check out repository code - uses: actions/checkout@v2 - - # Performs a clean installation of all dependencies in the `package.json` file - # For more information, see https://docs.npmjs.com/cli/ci.html - - name: Install dependencies - run: npm ci - - - name: Connect to Redis - # Runs a script that creates a Redis client, populates - # the client with data, and retrieves data - run: node client.js - # Environment variable used by the `client.js` script to create - # a new Redis client. - env: - # The hostname used to communicate with the Redis service container - REDIS_HOST: localhost - # The default Redis port - REDIS_PORT: 6379 -``` - -{% data reusables.github-actions.redis-environment-variables %} - -{% data reusables.github-actions.service-container-localhost %} - -### 测试 Redis 服务容器 - -您可以使用以下脚本测试工作流程，该脚本将创建 Redis 客户端，并使用某些占位符数据填充客户端。 然后，脚本将存储在 Redis 客户端中的值打印到终端。 您的脚本可以使用任何您喜欢的语言，但此示例使用 Node.js 和 `redis` npm 模块。 更多信息请参阅 [npm redis 模块](https://www.npmjs.com/package/redis)。 - -您可以修改 *client.js* 以包含工作流程需要的任何 Redis 操作。 在此示例中，脚本创建 Redis 客户端实例、添加占位符数据，然后检索数据。 - -{% data reusables.github-actions.service-container-add-script %} - -```javascript -const redis = require("redis"); - -// Creates a new Redis client -// If REDIS_HOST is not set, the default host is localhost -// If REDIS_PORT is not set, the default port is 6379 -const redisClient = redis.createClient({ - host: process.env.REDIS_HOST, - port: process.env.REDIS_PORT -}); - -redisClient.on("error", function(err) { - console.log("Error " + err); -}); - -// Sets the key "octocat" to a value of "Mona the octocat" -redisClient.set("octocat", "Mona the Octocat", redis.print); -// Sets a key to "octocat", field to "species", and "value" to "Cat and Octopus" -redisClient.hset("species", "octocat", "Cat and Octopus", redis.print); -// Sets a key to "octocat", field to "species", and "value" to "Dinosaur and Octopus" -redisClient.hset("species", "dinotocat", "Dinosaur and Octopus", redis.print); -// Sets a key to "octocat", field to "species", and "value" to "Cat and Robot" -redisClient.hset(["species", "robotocat", "Cat and Robot"], redis.print); -// Gets all fields in "species" key - -redisClient.hkeys("species", function (err, replies) { - console.log(replies.length + " replies:"); - replies.forEach(function (reply, i) { - console.log(" " + i + ": " + reply); - }); - redisClient.quit(); -}); -``` - -该脚本使用 `createClient` 方法创建新的 Redis 客户端，接受 `host` 和 `port` 参数。 该脚本使用 `REDIS_HOST` 和 `REDIS_PORT` 环境变量来设置客户端的 IP 地址和端口。 如果未定义 `host` 和 `port`，则默认主机为 `localhost`，默认端口为 6379。 - -该脚本使用 `set` 和 `hset` 方法，以一些键值、字段和值来填充数据库。 要确认 Redis 客户端是否包含数据，脚本会将数据库的内容打印到控制台日志。 - -运行此工作流程时，应会在“连接到 Redis”步骤中看到以下输出，确认您创建了 Redis 客户端并添加了数据： - -``` -Reply: OK -Reply: 1 -Reply: 1 -Reply: 1 -3 replies: - 0: octocat - 1: dinotocat - 2: robotocat -``` diff --git a/translations/zh-CN/content/actions/configuring-and-managing-workflows/index.md b/translations/zh-CN/content/actions/configuring-and-managing-workflows/index.md deleted file mode 100644 index 68abfdef305b..000000000000 --- a/translations/zh-CN/content/actions/configuring-and-managing-workflows/index.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: 配置和管理工作流程 -shortTitle: 工作流程 -intro: 您可以创建自定义工作流程并管理运行，以控制项目软件开发周期流程。 -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -{% topic_link_in_list /configuring-and-managing-workflow-files-and-runs %} - {% link_in_list /configuring-a-workflow %} - {% link_in_list /managing-a-workflow-run %} - {% link_in_list /sharing-workflow-templates-within-your-organization %} -{% topic_link_in_list /using-variables-and-secrets-in-a-workflow %} - {% link_in_list /creating-and-storing-encrypted-secrets %} - {% link_in_list /using-environment-variables %} - {% link_in_list /authenticating-with-the-github_token %} -{% topic_link_in_list /caching-and-storing-workflow-data %} - {% link_in_list /persisting-workflow-data-using-artifacts %} - {% link_in_list /caching-dependencies-to-speed-up-workflows %} -{% topic_link_in_list /using-databases-and-service-containers %} - {% link_in_list /about-service-containers %} - {% link_in_list /creating-redis-service-containers %} - {% link_in_list /creating-postgresql-service-containers %} diff --git a/translations/zh-CN/content/actions/configuring-and-managing-workflows/managing-a-workflow-run.md b/translations/zh-CN/content/actions/configuring-and-managing-workflows/managing-a-workflow-run.md deleted file mode 100644 index c003c88b162f..000000000000 --- a/translations/zh-CN/content/actions/configuring-and-managing-workflows/managing-a-workflow-run.md +++ /dev/null @@ -1,186 +0,0 @@ ---- -title: 管理工作流程运行 -intro: 您可以查看工作流程中每个步骤的状态和结果，取消待定的工作流程，查看可计费作业执行分钟数，调试并重新运行失败的工作流程，搜索并下载日志，以及下载构件。 -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/viewing-your-repository-s-workflows - - /articles/viewing-your-repositorys-workflows - - /articles/managing-a-workflow-run - - /github/automating-your-workflow-with-github-actions/managing-a-workflow-run - - /actions/automating-your-workflow-with-github-actions/managing-a-workflow-run -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### 关于工作流程管理 - -您可以从工作流程运行页面查看工作流程运行是在进行中，还是已完成。 如果运行正在进行中，您可以取消运行。 您必须登录到 {% data variables.product.prodname_dotcom %} 帐户才能查看工作流程运行信息，包括公共仓库。 更多信息请参阅“[GitHub 上的访问权限](/articles/access-permissions-on-github)”。 - -如果运行已完成，则可查看运行结果是成功、失败、已取消还是中性。 如果运行失败，您可以查看并搜索构建日志，来诊断失败原因并重新运行工作流程。 您也可以查看可计费作业执行分钟数，或下载日志和创建构件。 - - ![注释的工作流运行映像](/assets/images/help/repository/annotated-workflow.png) - -{% data variables.product.prodname_actions %} 使用 Checks API 来输出工作流程的状态、结果和日志。 {% data variables.product.prodname_dotcom %} 对每个工作流程创建新检查套件。 检查套件包含检查工作流程中每项作业的运行，而每项作业包含步骤。 {% data variables.product.prodname_actions %} 作为工作流程中的一个步骤运行。 有关检查 API 的详细信息，请参阅“[检查](/v3/checks/)”。 - -{% data reusables.github-actions.invalid-workflow-files %} - -### 查看工作流程历史记录 - -您可以查看工作流程运行中的每项作业以及作业中的每个步骤。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的核心概念](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions#job)”。 {% data reusables.repositories.permissions-statement-read %} - -除了工作流程文件中配置的步骤外，每个作业还包括用于启动和完成作业执行的其他任务。 这些步骤工作流程运行中记录为"设置作业"和"完成作业"。 - -对于在 {% data variables.product.prodname_dotcom %} 托管的运行器上运行的作业，“设置作业”记录运行器虚拟环境的详细信息。 并包含一个链接，可链接到运行器机器上的预安装工具列表。 - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -6. （可选）如果运行失败，要重新运行工作流程，请使用工作流程右上角的 **Re-run checks（重新运行检查）**下拉菜单，然后选择 **Re-run all checks（重新运行所有检查）**。 ![重新运行检查下拉菜单](/assets/images/help/repository/rerun-checks-drop-down.png) - -### 取消工作流程运行 - -当您取消工作流程运行时，{% data variables.product.prodname_dotcom %} 会取消属于该工作流程的所有作业和步骤。 {% data reusables.repositories.permissions-statement-write %} - -取消工作流程运行时，您可能正在运行使用与工作流程运行相关的资源的其他软件。 为了帮助您释放与工作流程运行相关的资源，它可能有助于了解 {% data variables.product.prodname_dotcom %} 为取消工作流程运行而执行的步骤。 更多信息请参阅“[{% data variables.product.prodname_dotcom %} 取消工作流程运行所执行的步骤](#steps-github-takes-to-cancel-a-workflow-run)”。 - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -1. 在工作流程右上角单击 **Cancel check suite（取消检查套件）**。 ![取消检查套件按钮](/assets/images/help/repository/cancel-check-suite.png) -1. 单击 **Cancel check suite（取消检查套件）**后。 - -#### {% data variables.product.prodname_dotcom %} 取消工作流程运行所执行的步骤 - -1. 要取消工作流程运行，服务器将重新评估所有正在运行的作业的 `if` 条件。 如果条件评估为 `true`，作业将不会取消。 例如，条件 `if: always()` 将评估为 true，并且作业继续运行。 没有条件时，则等同于条件 `if: success()`，仅在上一步已成功完成时才会运行。 -2. 对于需要取消的作业，服务器向包含需取消作业的所有运行器机器发送取消消息。 -3. 对于继续运行的作业，服务器将对未完成的步骤重新评估 `if` 条件。 如果条件评估为 `true`，则步骤继续运行。 -4. 对于需要取消的步骤，运行器机器发送 `SIGINT/Ctrl-C` 到该步骤的输入进程（`node` 用于 javascript 操作，`docker` 用于容器操作，`bash/cmd/pwd` 则在步骤中使用 `run` 时发送）。 如果进程未在 7500 毫秒内退出，运行器将发送 `SIGTERM/Ctrl-Break` 到此进程，然后等待 2500 毫秒让进程退出。 如果该进程仍在运行，运行器会停止进程树。 -5. 在 5 分钟取消超时期后，服务器将强制终止未完成运行或无法完成取消进程的所有作业和步骤。 - -### 删除工作流程运行 - -您可以删除已完成或超过 2 周的工作流程运行。 {% data reusables.repositories.permissions-statement-write %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -1. 要删除工作流程运行，请使用 {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} 下拉菜单并选择 **Delete workflow run（删除工作流程运行）**。 - - ![删除工作流程运行](/assets/images/help/settings/workflow-delete-run.png) -1. 查看确认提示并单击 **Yes, permanently delete this workflow run（是，永久删除此工作流程运行）**。 - - ![删除工作流程运行确认](/assets/images/help/settings/workflow-delete-run-confirmation.png) - -{% if currentVersion == "free-pro-team@latest" %} - -### 查看可计费作业执行分钟数 - -您可以查看作业的执行时间，包括某个作业累积的可计费分钟数。 - -仅为在私有仓库上运行，使用 {% data variables.product.prodname_dotcom %}- 托管的运行器的作业显示可计费作业执行分钟数。 如果在公共仓库中使用 {% data variables.product.prodname_actions %}，或在自托管的运行器中运行作业时，将没有可计费分钟数。 - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -1. 在作业摘要下，单击 **Run and billable time details（运行和可计费时间详细信息）**。 ![运行和可计费时间详细信息链接](/assets/images/help/repository/view-run-billable-time.png) - - {% note %} - - **注意：**显示的可计费时间不包括任何四舍五入或分钟乘数。 要查看您的 {% data variables.product.prodname_actions %} 总使用情况，包括四舍五入和分钟乘法，请参阅"[查看您的 {% data variables.product.prodname_actions %} 使用情况](/github/setting-up-and-managing-billing-and-payments-on-github/viewing-your-github-actions-usage)。" - - {% endnote %} - -{% endif %} - -### 查看日志以诊断故障 - -如果工作流程运行失败，您可以查看是哪个步骤导致了失败，然后审查失败步骤的创建日志进行故障排除。 您可以查看每个步骤运行的时长。 也可以将永久链接复制到日志文件中的特定行，与您的团队分享。 {% data reusables.repositories.permissions-statement-read %} - -{% data variables.product.product_name %} 会将整个创建日志和构件存储 90 天。 - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -{% data reusables.repositories.navigate-to-job %} -6. 要展开失败步骤的日志，请单击该步骤。 ![失败的步骤名称](/assets/images/help/repository/failed-check-step.png) -7. （可选）要获取指向日志中特定行的链接，请单击该步骤的行号。 您可以从 web 浏览器的地址栏中复制链接。 ![复制链接的按钮](/assets/images/help/repository/copy-link-button.png) - -### 搜索日志 - -您可以搜索特定步骤的创建日志。 在搜索日志时，只有展开的步骤会包含在结果中。 {% data reusables.repositories.permissions-statement-read %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -{% data reusables.repositories.navigate-to-job %} -6. 要展开想包含在搜索中的每个步骤，请单击该步骤。 ![步骤名称](/assets/images/help/repository/failed-check-step.png) -7. 在日志输出的右上角，在 **Search logs（搜索日志）**搜索框中输入搜索查询。 ![搜索日志的搜索框](/assets/images/help/repository/search-log-box.png) - -### 下载日志 - -您可以从工作流程运行中下载日志文件。 您也可以下载工作流程的构件。 更多信息请参阅“[使用构件持久化工作流程](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)”。 {% data reusables.repositories.permissions-statement-read %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -5. 要下载日志，请使用 **Download logs（下载日志）**下拉菜单，然后选择要下载的日志。 ![下载日志下拉菜单](/assets/images/help/repository/download-logs-drop-down.png) - -### 删除日志 - -您可以从工作流程运行中删除日志文件。 {% data reusables.repositories.permissions-statement-write %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -5. 要删除日志文件，单击 **Delete all logs（删除所有日志）**按钮并审查确认提示。 ![删除所有日志](/assets/images/help/repository/delete-all-logs.png) 删除日志后，**Delete all logs（删除所有日志）**按钮将被删除，以表明工作流程运行中未剩下任何日志文件。 - -### 启用调试日志 - -如果工作流程日志没有提供足够的详细信息来诊断工作流程、作业或步骤未按预期工作的原因，您可以启用额外的调试日志。 - -这些额外的日志将通过在包含工作流程的仓库中设置密码来启用，因此将应用相同的权限要求： - -- {% data reusables.github-actions.permissions-statement-secrets-organization %} -- {% data reusables.github-actions.permissions-statement-secrets-repository %} -- {% data reusables.github-actions.permissions-statement-secrets-api %} - -有关设置密码的更多信息，请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。 - -#### 启用运行程序诊断日志 - -Runner diagnostic logging provides additional log files that contain information about how a runner is executing a job. 两个额外的日志文件被添加到日志存档中： - -* 运行程序进程日志，其中包含关于如何协调和设置运行程序执行作业的信息。 -* 工作程序进程日志，用于记录作业执行情况。 - -1. 要启用运行程序诊断日志，请在包含工作流程的仓库中设置以下密码：将 `ACTIONS_RUNNER_DEBUG` 设置为 `true`。 - -1. 要下载运行程序诊断日志，请下载工作流程运行情况的日志存档。 运行程序诊断日志包含在 `runner-diagnostic-logs` 文件夹中。 关于下载日志的更多信息，请参阅“[下载日志](#downloading-logs)”。 - -#### 启用步骤调试日志 - -步骤调试日志增加了作业执行期间和执行之后的作业日志的详细程度。 - -1. 要启用步骤调试日志，必须在包含工作流程的仓库中设置以下密码：将 `ACTIONS_STEP_DEBUG` 设置为 `true`。 - -1. 设置密码后，步骤日志中会显示更多调试事件。 更多信息请参阅[“查看日志以诊断故障”](#viewing-logs-to-diagnose-failures)。 - - -### 延伸阅读 - -- “[关于 {% data variables.product.prodname_actions %}](/articles/about-github-actions)” -- "[配置工作流程](/articles/configuring-a-workflow)" -- "[{% data variables.product.prodname_actions %} 的工作流程语法](/articles/workflow-syntax-for-github-actions)" -- "[触发工作流程的事件](/articles/events-that-trigger-workflows)" -- "[{% data variables.product.prodname_dotcom %} 托管的运行器的虚拟环境](/actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)" diff --git a/translations/zh-CN/content/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts.md b/translations/zh-CN/content/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts.md deleted file mode 100644 index 5a5ecc8aec29..000000000000 --- a/translations/zh-CN/content/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts.md +++ /dev/null @@ -1,249 +0,0 @@ ---- -title: 使用构件持久化工作流程数据 -intro: 构件允许您在工作流程完成后，分享工作流程中作业之间的数据并存储数据。 -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/persisting-workflow-data-using-artifacts - - /github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts - - /actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### 关于工作流程构件 - -构件允许您在作业完成后保留数据，并与同一工作流程中的另一个作业共享该数据。 构件是指在工作流程运行过程中产生的文件或文件集。 例如，在工作流程运行结束后，您可以使用构件保存您的构建和测试输出。 对于推送和拉取请求， {% data variables.product.product_name %} 会将构件存储 90 天。 每当有人推送新提交到拉取请求时，拉取请求的保存期就会重新开始计算。 - -以下是您可以上传的一些常见构件： - -- 日志文件和核心转储文件 -- 测试结果、失败和屏幕截图 -- 二进制或压缩文件 -- 压力测试性能输出和代码覆盖结果 - -{% if currentVersion == "free-pro-team@latest" %} - -存储构件时使用存储空间 {% data variables.product.product_name %}。 {% data reusables.github-actions.actions-billing %} 更多信息请参阅“[管理 {% data variables.product.prodname_actions %} 的计费](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)”。 - -{% else %} - -项目会占用外部 Blob 存储上的存储空间，该存储为 {% data variables.product.prodname_actions %} 配置 {% data variables.product.product_location %}。 - -{% endif %} - -构件会在工作流程运行过程中上传，您可以在 UI 中查看构件的名称和大小。 当构件使用 {% data variables.product.product_name %} UI 下载时， 作为构件一部分单独上传的所有文件都会压缩到一个 zip 文件中。 这意味着计费是根据上传的构件大小而不是 zip 文件的大小计算的。 - -{% data variables.product.product_name %} 提供两项可用于上传和下载构建构件的操作。 更多信息请参阅 [action/upload-artifact](https://github.com/actions/upload-artifact) 和 [download-artifact](https://github.com/actions/download-artifact) 操作。 - -要在作业之间共享数据： - -* **上传文件**：为上传的文件提供名称并在作业结束前上传数据。 -* **下载文件**：您只能下载在同一工作流程运行过程中上传的构件。 下载文件时，您可以通过名称引用该文件。 - -作业步骤共享运行器机器的相同环境，但在其各自的进程中运行。 要在作业的步骤之间传递数据，您可以使用输入和输出。 有关输入和输出的更多信息，请参阅“[{% data variables.product.prodname_actions %} 的元数据语法](/articles/metadata-syntax-for-github-actions)”。 - -### 在工作流程中作业之间传递数据 - -您可以使用 `upload-artifact` 和 `download-artifact` 操作在工作流程中的作业之间共享数据。 此示例工作流程说明如何在相同工作流程中的任务之间传递数据。 更多信息请参阅 [action/upload-artifact](https://github.com/actions/upload-artifact) 和 [download-artifact](https://github.com/actions/download-artifact) 操作。 - -依赖于以前作业构件的作业必须等待依赖项成功完成。 此工作流程使用 `needs` 关键词确保 `job_1`、 `job_2` 和 `job_3` 按顺序运行。 例如， `job_2` 需要 `job_1` 使用 `needs: job_1` 语法。 - -作业1执行以下步骤： -- 执行数学计算并将结果保存到名为 `math-home-work.txt` 的文本文件。 -- 使用 `upload-artifact` 操作上传名为 `homework` 的 `math-homework.txt` 文件。 该操作将文件置于一个名为 `homework` 的目录中。 - -作业 2 使用上一个作业的结果： -- 下载上一个作业中上传的 `homework` 构件。 默认情况下， `download-artifact` 操作会将构件下载到该步骤执行的工作区目录中。 您可以使用 `path` 输入参数指定不同的下载目录。 -- 读取 `homework/math-homework.txt` 文件中的值，进行数学计算，并将结果保存到 `math-homework.txt`。 -- 更新 `math-homework.txt` 文件。 此上传会覆盖之前的上传，因为两次上传共用同一名称。 - -作业 3 显示上一个作业中上传的结果： -- 下载 `homework` 构件。 -- 将数学方程式的结果打印到日志中。 - -此工作流程示例中执行的完整数学运算为 `(3 + 7) x 9 = 90`。 - -```yaml -name: Share data between jobs - -on: [push] - -jobs: - job_1: - name: Add 3 and 7 - runs-on: ubuntu-latest - steps: - - shell: bash - run: | - expr 3 + 7 > math-homework.txt - - name: Upload math result for job 1 - uses: actions/upload-artifact@v2 - with: - name: homework - path: math-homework.txt - - job_2: - name: Multiply by 9 - needs: job_1 - runs-on: windows-latest - steps: - - name: Download math result for job 1 - uses: actions/download-artifact@v2 - with: - name: homework - - shell: bash - run: | - value=`cat math-homework.txt` - expr $value \* 9 > math-homework.txt - - name: Upload math result for job 2 - uses: actions/upload-artifact@v2 - with: - name: homework - path: math-homework.txt - - job_3: - name: Display results - needs: job_2 - runs-on: macOS-latest - steps: - - name: Download math result for job 2 - uses: actions/download-artifact@v2 - with: - name: homework - - name: Print the final result - shell: bash - run: | - value=`cat math-homework.txt` - echo The result is $value -``` - -![要在作业之间传递数据以执行数学工作流程](/assets/images/help/repository/passing-data-between-jobs-in-a-workflow.png) - -### 在工作流程运行之间共享数据 - -一个工作流程结束后，您可以通过在 **Actions（操作）**选项卡中找到工作流程运行，下载 {% data variables.product.product_name %} 上已上传构件的压缩文件。 您还可以使用 {% data variables.product.prodname_dotcom %} REST API 来下载构件。 更多信息请参阅“[构件](/v3/actions/artifacts/)”。 - -如果需要从以前的工作流运行访问项目，可以使用 REST API {% data variables.product.product_name %} 检索工件。 有关详细信息，请参阅"获取[项](/rest/reference/actions#artifacts)。 - -### 上传构建和测试构件 - -您可以创建持续集成 (CI) 工作流程来构建和测试您的代码。 关于使用 {% data variables.product.prodname_actions %} 执行 CI 的更多信息，请参阅“[关于持续集成](/articles/about-continuous-integration)”。 - -构建和测试代码的输出通常会生成可用于调试测试失败的文件和可部署的生产代码。 您可以配置一个工作流程来构建和测试推送到仓库中的代码，并报告成功或失败状态。 您可以上传构建和测试输出，以用于部署、调试失败的测试或崩溃以及查看测试套件范围。 - -您可以使用 `upload-artifact` 操作上传构件。 上传构件时，您可以指定单个文件或目录，或多个文件或目录。 您还可以排除某些文件或目录，以及使用通配符模式。 我们建议您为构件提供名称，但如果未提供名称，则会使用 `artifact` 作为默认名称。 有关语法的信息，请参阅 {% if currentVersion == "free-pro-team@latest" %}[操作/上传](https://github.com/actions/upload-artifact) 执行{% else %} `/上传项目` 操作 {% data variables.product.product_location %}{% endif %}。 - -#### 示例 - -例如，您的仓库或 Web 应用程序可能包含必须转换为 CSS 和 JavaScript 的 SASS 和 TypeScript 文件。 假设您的构建配置输出 `dist` 目录中已编译的文件，如果所有测试均已成功完成，则可将 `dist` 目录中的文件部署到您的 Web 应用程序服务器。 - -``` -|-- hello-world (repository) -| └── dist -| └── tests -| └── src -| └── sass/app.scss -| └── app.ts -| └── output -| └── test -| -``` - -本例向您展示如何创建 Node.js 项目的工作流程，该项目在 `src` 目录中 `builds` 代码，并在 `tests` 目录中运行测试。 您可以假设运行 `npm test` 会产生名为 `code-coverage.html`、存储在 `output/test/` 目录中的代码覆盖报告。 - -工作流程上传 `dist` 目录中的生产构件，但不包括任何 markdown 文件。 它还会上传 `code-coverage.html` 报告作为另一个构件。 - -```yaml -name: Node CI - -on: [push] - -jobs: - build_and_test: - runs-on: ubuntu-latest - steps: - - name: Checkout repository - uses: actions/checkout@v2 - - name: npm install, build, and test - run: | - npm install - npm run build --if-present - npm test - - name: Archive production artifacts - uses: actions/upload-artifact@v2 - with: - name: dist-without-markdown - path: | - dist - !dist/**/*.md - - name: Archive code coverage results - uses: actions/upload-artifact@v2 - with: - name: code-coverage-report - path: output/test/code-coverage.html -``` - -![工作流程上传构件工作流程运行的图像](/assets/images/help/repository/upload-build-test-artifact.png) - -### 下载或删除构件 - -在工作流程运行期间，您可以下载以前在同一工作流程运行中上传的构件。 在工作流程运行完成后，您可以使用工作流程运行历史记录在 GitHub 上下载或删除构件。 - -#### 在工作流程运行期间下载构件 - -[actions/download-artifact](https://github.com/actions/download-artifact) 操作可用于下载工作流程运行期间之前上传的构件。 - -{% note %} - -**注**：您只能下载在同一工作流程运行过程中上传的构件。 - -{% endnote %} - -指定构件的名称以下载单个构件。 如果在未指定名称的情况下上传构件目，则使用默认名称 `artifact`。 - -```yaml -- name: Download a single artifact - uses: actions/download-artifact@v2 - with: - name: my-artifact -``` - -您还可以不指定名称而下载工作流程运行中的所有构件。 如果您在处理大量构件，此功能非常有用。 - -```yaml -- name: Download all workflow run artifacts - uses: actions/download-artifact@v2 -``` - -如果下载所有工作流程运行的构件，则每个构件使用其名称目创建目录。 - -For more information on syntax, see the [actions/download-artifact](https://github.com/actions/download-artifact) action. - -#### 工作流程运行完成后下载和删除构件 - -构件在 90 天后自动过期，但您始终可以在构件于 {% data variables.product.product_name %} 上过期之前删除它们，回收已经使用的 {% data variables.product.prodname_actions %} 存储。 - -{% warning %} - -**警告：** 构件一旦删除，便无法恢复。 - -{% endwarning %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.navigate-to-workflow %} -{% data reusables.repositories.view-run %} -1. 要下载构件，请使用 **Artifacts（构件）**下拉菜单，然后选择要下载的构件。 ![下载构件下拉菜单](/assets/images/help/repository/artifact-drop-down.png) -1. 要删除构件，请使用 **Artifacts（构件）**下拉菜单，然后单击 {% octicon "trashcan" aria-label="The trashcan icon" %}。 ![删除构件下拉菜单](/assets/images/help/repository/actions-delete-artifact.png) - -{% if currentVersion == "free-pro-team@latest" %} - -### 延伸阅读 - -- "[管理 {% data variables.product.prodname_actions %} 的计费](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)". - -{% endif %} diff --git a/translations/zh-CN/content/actions/configuring-and-managing-workflows/sharing-workflow-templates-within-your-organization.md b/translations/zh-CN/content/actions/configuring-and-managing-workflows/sharing-workflow-templates-within-your-organization.md deleted file mode 100644 index e0b080ad77f5..000000000000 --- a/translations/zh-CN/content/actions/configuring-and-managing-workflows/sharing-workflow-templates-within-your-organization.md +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: 在组织内共享工作流程模板 -intro: 您可以专门为您的组织创建一组标准化的工作流程模板。 然后，组织成员在组织仓库中创建新的工作流程时可以使用模板。 -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -对组织的 `.github` 仓库具有写入权限的用户可以创建工作流程模板。 然后，有权限创建工作流程的组织成员便可使用这些模板。 - -工作流程模板可用于在组织的公共仓库中创建新的工作流程；要使用模板在私有仓库中创建工作流程，该组织必须是企业或 GitHub One 计划的一部分。 - -### 创建工作流程模板 - -此过程展示如何创建工作流程模板和元数据文件。 元数据文件描述在用户新建工作流程时如何向其显示模板。 - -1. 如果组织中没有名为 `.github` 的公共仓库，请新建一个。 -1. 创建一个名为 `workflow-templates` 的目录。 -1. 在 `workflow-templates` 目录中创建新的工作流程文件。 - - 如果需要引用仓库的默认分支，可以使用 `$default-branch` 占位符。 使用模板创建工作流程时，占位符将自动替换为仓库默认分支的名称。 - - 例如，下面这个名为 `octo-organization-ci.yml` 的文件展示了一个基本的工作流程。 - - ```yaml - name: Octo Organization CI - - on: - push: - branches: [ $default-branch ] - pull_request: - branches: [ $default-branch ] - - jobs: - build: - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - - name: Run a one-line script - run: echo Hello from Octo Organization - ``` -1. 在 `workflow-templates` 目录中创建元数据文件。 元数据文件必须与工作流程文件同名，但扩展名不是 `.yml`，而必须附加 `.properties.json`。 例如，下面这个名为 `octo-organization-ci.properties.json` 的文件包含名为 `octo-organization-ci.yml` 的工作流程文件的元数据： - ```yaml - { - "name": "Octo Organization Workflow", - "description": "Octo Organization CI workflow template.", - "iconName": "example-icon", - "categories": [ - "Go" - ], - "filePatterns": [ - "package.json$", - "^Dockerfile", - ".*\\.md$" - ] - } - ``` - * `name` - **必要。**工作流程模板的名称。 这会显示在可用模板列表中。 - * `description` - **必要。**工作流程模板的描述。 这会显示在可用模板列表中。 - * `iconName` - **必要。**定义模板列表中工作流程项目的图标。 `iconName` 必须是同名的 SVG 图标，且必须存储在 `workflow-templates` 目录中。 例如，名为 `example-icon.svg` 的 SVG 文件被引用为 `example-icon`。 - * `categories` - **可选。**定义工作流程的语言类别。 当用户查看可用模板时，匹配相同语言的模板将更加突出。 有关可用语言类别的信息，请参阅https://github.com/github/linguist/blob/master/lib/linguist/languages.yml。 - * `filePatterns` - **可选。**如果用户仓库在其根目录中有符合定义的正则表达式的文件，则允许使用模板。 - -要添加另一个工作流模板，请将您的文件添加到同一 `workflow-templates` 目录中。 例如： - -![工作流程模板文件](/assets/images/help/images/workflow-template-files.png) - -### 使用工作流程模板 - -此程序展示组织成员如何查找并使用工作流程模板来创建新的工作流程。 只要是组织成员，都可以使用组织的工作流程模板。 - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -1. 如果您的仓库已经有工作流程：在左上角单击 **New workflow（新工作流程）**。 ![创建新工作流程](/assets/images/help/repository/actions-new-workflow.png) -1. 组织的工作流程模板位于其自己名为“_组织名称_创建的工作流程”的区域中。 在您想要使用的模板名称下，单击 **Set up this workflow（设置此工作流程）**。 ![设置此工作流程](/assets/images/help/settings/actions-create-starter-workflow.png) diff --git a/translations/zh-CN/content/actions/configuring-and-managing-workflows/using-databases-and-service-containers.md b/translations/zh-CN/content/actions/configuring-and-managing-workflows/using-databases-and-service-containers.md deleted file mode 100644 index 6193de6fbad0..000000000000 --- a/translations/zh-CN/content/actions/configuring-and-managing-workflows/using-databases-and-service-containers.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: 使用数据库和服务容器 -intro: 连接数据库和服务容器来管理工作流程工具。 -mapTopic: true -redirect_from: - - /actions/automating-your-workflow-with-github-actions/using-databases-and-services -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/zh-CN/content/actions/configuring-and-managing-workflows/using-environment-variables.md b/translations/zh-CN/content/actions/configuring-and-managing-workflows/using-environment-variables.md deleted file mode 100644 index 43570a75f41e..000000000000 --- a/translations/zh-CN/content/actions/configuring-and-managing-workflows/using-environment-variables.md +++ /dev/null @@ -1,68 +0,0 @@ ---- -title: 使用环境变量 -intro: '{% data variables.product.prodname_dotcom %} 为每个 {% data variables.product.prodname_actions %} 工作流程运行设置默认环境变量。 您也可以在工作流程文件中设置自定义环境变量。' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /github/automating-your-workflow-with-github-actions/using-environment-variables - - /actions/automating-your-workflow-with-github-actions/using-environment-variables -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### 关于环境变量 - -{% data variables.product.prodname_dotcom %} 设置适用于工作流程运行中每个步骤的默认环境变量。 环境变量区分大小写。 在操作或步骤中运行的命令可以创建、读取和修改环境变量。 - -要设置自定义环境变量，您需要在工作流程文件中指定变量。 您可以使用 [`jobs..steps.env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsenv)、[`jobs..env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idenv) 和 [`env`](/github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#env) 关键字定义步骤、作业或整个工作流程的环境变量。 有关详细信息，请参阅"[的工作流 {% data variables.product.prodname_dotcom %}](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepsenv)。 - -```yaml -步骤： - - 名称： 你好世界 - 运行： 回声你好世界 $FIRST_NAME $middle_name $Last_Name！ - env: - FIRST_NAME: Mona - middle_name: The - Last_Name: Octocat -``` - -您也可以使用 `set-env` 工作流程命令来设置工作流程中以下步骤可以使用的环境变量。 `set-env` 命令可直接供操作使用，或使用 `run` 关键字作为工作流程文件中的 shell 命令。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的工作流程命令](/actions/reference/workflow-commands-for-github-actions/#setting-an-environment-variable)”。 - -### 默认环境变量 - -强烈建议操作使用环境变量访问文件系统，而非使用硬编码的文件路径。 {% data variables.product.prodname_dotcom %} 设置供操作用于所有运行器环境中的环境变量。 - -| 环境变量 | 描述 | -| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `CI` | 始终设置为 `true`。 | -| `HOME` | 用于存储用户数据的 {% data variables.product.prodname_dotcom %} 主目录路径。 例如 `/github/home`。 | -| `GITHUB_WORKFLOW` | 工作流程的名称。 | -| `GITHUB_RUN_ID` | {% data reusables.github-actions.run_id_description %} | -| `GITHUB_RUN_NUMBER` | {% data reusables.github-actions.run_number_description %} | -| `GITHUB_ACTION` | 操作唯一的标识符 (`id`)。 | -| `GITHUB_ACTIONS` | 当 {% data variables.product.prodname_actions %} 运行工作流程时，始终设置为 `true`。 您可以使用此变量来区分测试是在本地运行还是通过 {% data variables.product.prodname_actions %} 运行。 | -| `GITHUB_ACTOR` | 发起工作流程的个人或应用程序的名称。 例如 `octocat`。 | -| `GITHUB_REPOSITORY` | 所有者和仓库名称。 例如 `octocat/Hello-World`。 | -| `GITHUB_EVENT_NAME` | 触发工作流程的 web 挂钩事件的名称。 | -| `GITHUB_EVENT_PATH` | 具有完整 web 挂钩事件有效负载的文件路径。 例如 `/github/workflow/event.json`。 | -| `GITHUB_WORKSPACE` | {% data variables.product.prodname_dotcom %} 工作空间目录路径。 如果您的工作流程使用 [actions/checkout](https://github.com/actions/checkout) 操作，工作空间目录将包含存储仓库副本的子目录。 如果不使用 `actions/checkout` 操作，该目录将为空。 例如 `/home/runner/work/my-repo-name/my-repo-name`。 | -| `GITHUB_SHA` | 触发工作流程的提交 SHA。 例如 `ffac537e6cbbf934b08745a378932722df287a53`。 | -| `GITHUB_REF` | 触发工作流程的分支或标记参考。 例如 `refs/heads/feature-branch-1`。 如果分支或标记都不适用于事件类型，则变量不会存在。 | -| `GITHUB_HEAD_REF` | 仅为复刻的仓库设置。 头部仓库的分支。 | -| `GITHUB_BASE_REF` | 仅为复刻的仓库设置。 基础仓库的分支。 | -| `GITHUB_SERVER_URL` | 返回 {% data variables.product.product_name %} 服务器的 URL。 当 {% data variables.product.prodname_actions %} 运行工作流程时，始终设置为 `true`。 | -| `GITHUB_API_URL` | 返回 API URL。 返回 {% data variables.product.product_name %} 服务器的 URL。 例如：`https://github.com`。 | -| `GITHUB_GRAPHQL_URL` | 返回 GraphQL API URL。 例如：`https://api.github.com/graphql`。 | - -### 环境变量命名约定 - -{% note %} - -**注：** {% data variables.product.prodname_dotcom %} 会保留 `GITHUB_` 环境变量前缀供 {% data variables.product.prodname_dotcom %} 内部使用。 设置有 `GITHUB_` 前缀的环境变量或密码将导致错误。 - -{% endnote %} - -您设置的指向文件系统上某个位置的任何新环境变量都应该有 `_PATH` 后缀。 `HOME` 和 `GITHUB_WORKSPACE` 默认变量例外于此约定，因为 "home" 和 "workspace" 一词已经暗示位置。 diff --git a/translations/zh-CN/content/actions/configuring-and-managing-workflows/using-variables-and-secrets-in-a-workflow.md b/translations/zh-CN/content/actions/configuring-and-managing-workflows/using-variables-and-secrets-in-a-workflow.md deleted file mode 100644 index 1358ade7654e..000000000000 --- a/translations/zh-CN/content/actions/configuring-and-managing-workflows/using-variables-and-secrets-in-a-workflow.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: 在工作流程中使用变量和密码 -intro: 在工作流中使用加密密码、变量和令牌保护仓库。 -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/zh-CN/content/actions/getting-started-with-github-actions/about-github-actions.md b/translations/zh-CN/content/actions/getting-started-with-github-actions/about-github-actions.md deleted file mode 100644 index df91a68a4d17..000000000000 --- a/translations/zh-CN/content/actions/getting-started-with-github-actions/about-github-actions.md +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: 关于 GitHub 操作 -intro: '{% data variables.product.prodname_actions %} 可让您直接在 {% data variables.product.prodname_dotcom %} 仓库中创建自定义软件开发生命周期 (SDLC) 工作流程。' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/migrating-github-actions-from-hcl-syntax-to-yaml-syntax/ - - /articles/about-github-actions - - /github/automating-your-workflow-with-github-actions/about-github-actions - - /actions/automating-your-workflow-with-github-actions/about-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### 关于 {% data variables.product.prodname_actions %} - -{% data reusables.repositories.about-github-actions %} 工作流程是您可以在仓库中创建的自定义自动化流程，用于在 {% data variables.product.prodname_dotcom %} 上构建、测试、封装、发行或部署任何代码项目。 - -{% data reusables.repositories.actions-ci-cd %} {% data variables.product.prodname_actions %} 支持 {% data variables.product.prodname_dotcom %} 的内置持续集成服务。 更多信息请参阅“[关于持续集成](/articles/about-continuous-integration)”。 - -工作流程在 {% data variables.product.prodname_dotcom %} 托管的计算机（称为“运行器”）上的 Linux、macOS、Windows 和容器中运行。 或者，您也可以托管自己的运行器，以在您拥有或管理的计算机上运行工作流程。 更多信息请参阅“[关于自托管运行器](/actions/automating-your-workflow-with-github-actions/about-self-hosted-runners)”。 - -您可以使用仓库中定义的操作、{% data variables.product.prodname_dotcom %} 上公共仓库中的开源操作或者发布的 Docker 容器图像来创建工作流程。 复刻仓库中的工作流程默认不运行。 - -您可以在 {% data variables.product.prodname_dotcom %} 上发现要用于工作流程的操作，以及创建要与 {% data variables.product.prodname_dotcom %} 社区共享的操作。 有关创建自定义操作的更多信息，请参阅“[创建操作](/actions/creating-actions)”。 - -您可以创建配置为对特定事件运行的工作流程文件。 更多信息请参阅“[配置工作流程](/articles/configuring-a-workflow)”和“[{% data variables.product.prodname_actions %} 的工作流程语法](/articles/workflow-syntax-for-github-actions)”。 - -有关常用术语的定义，请参阅“[{% data variables.product.prodname_actions %} 的核心概念](/github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)”。 - -### 发现 {% data variables.product.prodname_dotcom %} 社区中的操作 - -{% data variables.product.prodname_marketplace %} 是一个中心位置，您可以查找、分享和使用由 {% data variables.product.prodname_dotcom %} 社区构建的操作。 更多信息请参阅“[在工作流程中使用 {% data variables.product.prodname_marketplace %} 中的操作](/actions/automating-your-workflow-with-github-actions/using-actions-from-github-marketplace-in-your-workflow)”。 - -您也可以使用 {% data variables.product.prodname_dotcom %} 的公共仓库中分享的开源操作自定义项目，以及使用 [actions](https://github.com/actions) 组织中 {% data variables.product.prodname_dotcom %} 构建的操作。 - -### 禁用或限制仓库或组织的 {% data variables.product.prodname_actions %} - -{% data reusables.github-actions.disabling-github-actions %} - -更多信息请参阅“[禁用或限制仓库的 {% data variables.product.prodname_actions %}](/github/administering-a-repository/disabling-or-limiting-github-actions-for-a-repository)”或“[禁用或限制组织的 {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-organizations-and-teams/disabling-or-limiting-github-actions-for-your-organization)”。 - -### 工作流程运行通知 - -{% data reusables.repositories.workflow-notifications %} - -### 使用限制 - -{% data reusables.github-actions.github-actions-usage-limits %} - -{% if currentVersion == "free-pro-team@latest" %} - -### 使用策略 - -除了使用限制外，还必须确保使用 [GitHub 服务条款](/articles/github-terms-of-service/) 中的 {% data variables.product.prodname_actions %}。 有关 {% data variables.product.prodname_actions %} 特定条款的更多信息，请参阅 [GitHub 附加产品条款](/github/site-policy/github-additional-product-terms#a-actions-usage)。 - -### 关于 {% data variables.product.prodname_actions %} 的计费 - -{% data reusables.github-actions.actions-billing %} 更多信息请参阅“[关于 {% data variables.product.prodname_actions %} 的计费](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions)”。 - -### 联系支持 - -{% data reusables.github-actions.contacting-support %} - -{% endif %} - -### 延伸阅读 - -- "[管理工作流程运行](/articles/managing-a-workflow-run)" -- "[触发工作流程的事件](/articles/events-that-trigger-workflows)" -- "[{% data variables.product.prodname_dotcom %} 托管的运行器的虚拟环境](/actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)" -"[管理 {% data variables.product.prodname_actions %} 的计费](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)" diff --git a/translations/zh-CN/content/actions/getting-started-with-github-actions/core-concepts-for-github-actions.md b/translations/zh-CN/content/actions/getting-started-with-github-actions/core-concepts-for-github-actions.md deleted file mode 100644 index a9ec407177b2..000000000000 --- a/translations/zh-CN/content/actions/getting-started-with-github-actions/core-concepts-for-github-actions.md +++ /dev/null @@ -1,76 +0,0 @@ ---- -title: GitHub 操作的核心概念 -shortTitle: 核心概念 -intro: '下面是我们在网站和 {% data variables.product.prodname_actions %} 文档中使用的常见 {% data variables.product.prodname_actions %} 术语列表。' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions - - /actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### 操作 - -合并为作业创建步骤的个别任务。 操作是工作流程最小的便携式构建块。 您可以创建自己的操作，使用 {% data variables.product.prodname_dotcom %} 社区共享的操作，以及自定义公共操作。 要在工作流程中使用操作，必须将其作为一个步骤。 - -### 构件 - -构件是创建并测试代码时所创建的文件。 例如，构件可能包含二进制或包文件、测试结果、屏幕截图或日志文件。 工件与其创建时所在的工作流程运行相关，可被另一个作业使用，也可以部署。 - -### 持续集成 (CI) - -经常提交小代码更改到共享仓库的软件开发实践。 通过 {% data variables.product.prodname_actions %} 可以创建自定义 CI 工作流程，以自动构建和测试您的代码。 从您的仓库，您可以在工作流程中查看代码更改的状态和每个操作的详细日志。 CI 对代码更改提供即时反馈以便更快地检测并解决错误，从而节省开发者的时间。 - -### 持续部署 (CD) - -持续部署建立在持续集成的基础上。 当新代码提交并通过您的 CI 测试时，该代码将自动部署到生产中。 通过 {% data variables.product.prodname_actions %} 可以创建自定义 CD 工作流程，以将您的代码自动从仓库部署到任何云、自托管服务或平台。 CD 通过自动执行部署过程来节省开发者的时间，并且将经过测试的稳定代码更快地部署到您的客户。 - -### Event - -触发工作流程运行的特定活动。 例如，当有推送提交到仓库或者创建议题或拉取请求时，{% data variables.product.prodname_dotcom %} 就可能产生活动。 您也可以使用仓库分发 web 挂钩配置一个工作流程在外部事件发生时运行。 - -### {% data variables.product.prodname_dotcom %} 托管的运行器 -{% data variables.product.prodname_dotcom %} 可托管 Linux、Windows 和 macOS 运行器。 作业在包含常用、预安装的软件的全新虚拟机实例中运行。 {% data variables.product.prodname_dotcom %} 对 {% data variables.product.prodname_dotcom %} 托管的运行器执行所有升级和维护。 您不能自定义 {% data variables.product.prodname_dotcom %} 托管的运行器的硬件配置。 更多信息请参阅“[{% data variables.product.prodname_dotcom %} 托管的运行器的虚拟环境](/github/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)”。 - -### 作业 - -在同一运行服务器上执行的一组步骤。 您可以定义作业在工作流程文件中运行的依赖规则。 作业可以同时并行运行，也可以根据上一个作业的状态按顺序运行。 例如，工作流程可以有两个连续的任务来构建和测试代码，其中测试作业取决于构建作业的状态。 如果构建作业失败，测试作业将不会运行。 对于 {% data variables.product.prodname_dotcom %} 托管的运行器，工作流程中的每项作业都会在一个新的虚拟环境实例中运行。 - -### 运行器 - -已安装 {% data variables.product.prodname_actions %} 运行器应用程序的任何机器。 您可以使用 {% data variables.product.prodname_dotcom %} 托管的运行器或托管您自己的运行器。 运行器等待可用的作业。 当运行器选择作业时，它会运行该作业的操作 ，并将进度、日志和最终结果报告回 {% data variables.product.prodname_dotcom %}。 运行器一次运行一个作业。 更多信息请参阅“[{% data variables.product.prodname_dotcom %} 托管的运行器](#github-hosted-runner)”和“[自托管运行器](#self-hosted-runner)”。 - -{% note %} - -**注意：** {% data reusables.github-actions.runner-app-open-source %} - -{% endnote %} - -### 自托管运行器 - -您管理和维护并且安装了自托管运行器应用程序的机器。 {% data reusables.github-actions.self-hosted-runner-description %} 更多信息请参阅“[托管您自己的运行器](/github/automating-your-workflow-with-github-actions/hosting-your-own-runners)”。 - -### 步骤 - -步骤是可以运行命令或操作的单个任务。 作业配置一个或多个步骤。 作业中的每个步骤在同一运行器中执行，让该作业中的操作使用文件系统共享信息。 - -### 虚拟环境 - -{% data variables.product.prodname_dotcom %} 托管的运行器的虚拟环境包括虚拟机器的硬件配置、操作系统和已安装的软件。 更多信息请参阅“[{% data variables.product.prodname_dotcom %} 托管的运行器的虚拟环境](/github/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners)”。 - -### 工作流程 - -您可以在仓库中创建的可配置自动化流程，用于在 {% data variables.product.prodname_dotcom %} 上构建、测试、封装、发行或部署任何项目。 工作流程由一项或多项作业组成，可以计划或由事件激活。 - -### 工作流程文件 - -定义至少有一项作业的工作流程配置的 YAML 文件。 此文件位于 {% data variables.product.prodname_dotcom %} 仓库根目录的 `.github/workflows` 目录下。 - -### 工作流程运行 - -当预配置的事件发生时运行的工作流程实例。 您可以查看每个工作流程运行的作业、操作、日志和状态。 diff --git a/translations/zh-CN/content/actions/getting-started-with-github-actions/index.md b/translations/zh-CN/content/actions/getting-started-with-github-actions/index.md deleted file mode 100644 index 87ceaddb35c2..000000000000 --- a/translations/zh-CN/content/actions/getting-started-with-github-actions/index.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: GitHub 操作使用入门 -shortTitle: 入门指南 -intro: '{% data variables.product.prodname_actions %} 具有融入工作流程每个步骤的强大执行环境。 您可以发现、创建和分享 {% data variables.product.prodname_actions %} 以执行您喜欢的任何工作。' -redirect_from: - - /articles/getting-started-with-github-actions - - /github/automating-your-workflow-with-github-actions/getting-started-with-github-actions - - /actions/automating-your-workflow-with-github-actions/getting-started-with-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -{% topic_link_in_list /overview %} - {% link_in_list /about-github-actions %} - {% link_in_list /core-concepts-for-github-actions %} - {% link_in_list /security-hardening-for-github-actions %} -{% topic_link_in_list /using-community-workflows-and-actions %} - {% link_in_list /starting-with-preconfigured-workflow-templates %} - {% link_in_list /using-actions-from-github-marketplace %} diff --git a/translations/zh-CN/content/actions/getting-started-with-github-actions/overview.md b/translations/zh-CN/content/actions/getting-started-with-github-actions/overview.md deleted file mode 100644 index 09a1e130c8c5..000000000000 --- a/translations/zh-CN/content/actions/getting-started-with-github-actions/overview.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: 概览 -intro: '了解 {% data variables.product.prodname_actions %} 概念和术语。' -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/zh-CN/content/actions/getting-started-with-github-actions/security-hardening-for-github-actions.md b/translations/zh-CN/content/actions/getting-started-with-github-actions/security-hardening-for-github-actions.md deleted file mode 100644 index 3da29637a21d..000000000000 --- a/translations/zh-CN/content/actions/getting-started-with-github-actions/security-hardening-for-github-actions.md +++ /dev/null @@ -1,93 +0,0 @@ ---- -title: GitHub 操作的安全强化 -shortTitle: 安全强化 -intro: '使用 {% data variables.product.prodname_actions %} 功能的良好安全实践。' -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -本指南介绍如何为某些 {% data variables.product.prodname_actions %} 功能配置安全强化。 如果不熟悉 {% data variables.product.prodname_actions %} 概念，请参阅“[GitHub 操作的核心概念](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)”。 - -### 使用密码 - -敏感值绝不能以明文存储在工作流程文件中，而应存储为密码。 [密码](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)可在组织或仓库级配置，可用于在 {% data variables.product.product_name %} 中存储敏感信息。 - -密码使用 [Libsodium 密封箱](https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes)，以使它们在到达 {% data variables.product.product_name %} 前被加密处理。 [使用 UI](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets#creating-encrypted-secrets-for-a-repository) 或通过 [REST API](/rest/reference/actions#secrets) 提交密码时就会发生这种情况。 此客户端加密有助于最大程度地减少与 {% data variables.product.product_name %}基础架构中的意外日志记录相关的风险（例如，异常日志和请求日志等）。 密钥在上传后，{% data variables.product.product_name %} 可对其进行解密，以便它能够被注入工作流程运行时。 - -为了帮助防止意外泄露，{% data variables.product.product_name %} 使用一种机制尝试对运行日志中显示的任何密码进行编校。 此编校会寻找任何已配置密码的精确匹配项，以及值的常见编码，如 Base64。 但是，由于密码值可以通过多种方式转换，因此不能保证此编校。 因此，你应该采取某些积极主动的步骤和良好的做法，以帮助确保密码得到编校， 并限制与密码相关的其他风险： - -- **切勿将结构化数据用作密码** - - 非结构化数据可能导致日志中的密码编校失败，因为编校很大程度上取决于查找特定密码值的完全匹配项。 例如，不要使用 JSON、XML 或 YAML（或类似）的 Blob 来封装密码值，否则会显著降低密码被正确编校的可能性。 而应为每个敏感值创建单独的密码。 -- **注册工作流程中使用的所有密码** - - 如果密码用于生成工作流程中的另一个敏感值，则该生成的值应正式[注册为密码](https://github.com/actions/toolkit/tree/master/packages/core#setting-a-secret)，使其出现在日志中时将会得到编校。 例如，如果使用私钥生成签名的 JWT 来访问 Web API，请确保将该 JWT 注册为密码，否则，如果它进入日志输出，则不会得到编校。 - - 注册密码也适用于任何类型的转换/编码。 如果以某种方式（如 Base64 或 URL 编码）转换您的密码，请确保将新值也注册为密码。 -- **审核如何处理密码** - - 审核密码的使用方式，以帮助确保按预期方式处理密码。 您可以通过检查执行工作流程的仓库的源代码并检查工作流程中使用的任何操作来进行审核。 例如，确认它们未发送到非预期主机，或明确打印到日志输出。 - - 在测试有效/无效输入后查看工作流程的运行日志，并确认密码已正确编校或未显示。 您调用的命令或工具如何向 `STDOUT` 和 `STDERR` 发送错误并不总是很明显，密码随后可能会在错误日志中生成错误。 因此，在测试有效和无效的输入后，最好是手动查看工作流程日志。 -- **使用最小范围的凭据** - - 确保工作流程中使用的凭据具有所需的最小权限，并请注意，任何对仓库具有写入权限的用户都可访问仓库中配置的所有密码。 -- **审核并轮换注册密码** - - 定期查查已注册的密码，以确认它们仍是必需的。 删除不再需要的密码。 - - 定期轮换密码，以减小泄露的密码有效的时间窗。 - -### 使用第三方操作 - -工作流程中的个别作业可以与其他作业相互作用（和妥协）。 例如，查询以后作业使用的环境变量，将文件写入以后作业处理的共享目录，或者更直接地与 Docker 套接字接交互，以及检查其他正在运行的容器并执行其中的命令。 - -这意味着工作流程中单一操作的泄露可能很严重，因为这个泄露的操作可以访问您仓库中配置的所有密码， 并且可以使用 `GITHUB_TOKENN` 写入仓库。 因此，从 {% data variables.product.prodname_dotcom %} 上的第三方仓库获取操作的风险很大。 您可以遵循以下良好做法来帮助降低此风险： - -* **将操作固定到全长提交 SHA** - - 将操作固定到全长提交 SHA 是当前将操作用作不可变版本的唯一方法。 固定到特定 SHA 有助于降低恶意执行者向操作仓库添加后门的风险，因为他们需要为有效的 Git 对象负载生成 SHA-1 冲突。 - - {% warning %} - - **警告** 提交 SHA 的简短版本不安全，绝不可用于指定操作的 Git 引用。 由于仓库网络的工作方式，任何用户都可以复刻仓库，将精心编写的提交推送到与短 SHA 冲突的仓库。 这会导致该 SHA 上的后续克隆失败，因为它成为不明确的提交。 因此，使用缩短的 SHA 的任何工作流程将立即失败。 - - {% endwarning %} -* **审核操作的源代码** - - 确保操作按照预期处理仓库和密码的内容。 例如，确认密码未发送到非预期主机，或者没有被无意中记录。 - -* **仅当您信任创建者时，才将操作固定到标记** - - 尽管固定到提交 SHA 是最安全的选项，但指定标记更方便，而且被广泛使用。 如果要指定标记，请确保信任该操作的创建者。 {% data variables.product.prodname_marketplace %} 上的“已验证创建者”徽章是一个有用的信号，因为它表示该操作是由其身份已被 {% data variables.product.prodname_dotcom %} 验证的团队编写的。 请注意，即使您信任作者，这种方法也存在风险，因为如果恶意执行者获得对存储操作的仓库的访问权限，便可移动或删除标记。 - -### 考虑跨仓库访问 - -{% data variables.product.product_name %} 的范围有意设为每次一个仓库。 工作流程环境中使用的 `GITHUB_TOKEN` 授予与具有写入权限的用户相同的访问级别，因为任何具有写入权限的用户都可通过创建或修改工作流程文件来访问此令牌。 用户对每个仓库都有特定权限，因此，如果不谨慎实施，一个仓库的 `GITHUB_TOKEN` 库授予对另一个仓库的访问权限将会影响 {% data variables.product.prodname_dotcom %} 权限模型。 同样，在向工作流程环境添加 {% data variables.product.prodname_dotcom %} 授权令牌时也必须谨慎，因为这也会因无意中向协作者授予一般权限而影响 {% data variables.product.prodname_dotcom %} 权限模型。 - -我们已经[制定 {% data variables.product.prodname_dotcom %} 路线图](https://github.com/github/roadmap/issues/74)，以支持允许在 {% data variables.product.product_name %} 内跨仓库访问的流程，但这还不是一项受支持的功能。 目前，执行特权跨仓库交互的唯一方法就是将 {% data variables.product.prodname_dotcom %} 身份验证令牌或 SSH 密钥作为工作流程环境中的密码。 由于许多身份验证令牌类型不允许对特定资源进行细致的访问，因此使用错误的令牌类型存在很大风险，因为它可以授予比预期范围更广泛的访问。 - -此列表描述建议用于在工作流程中访问仓库数据的方法，按优先顺序降序排列： - -1. **工作流程环境中的 `GITHUB_TOKEN`** - - 此令牌的范围有意设为调用工作流程的单个仓库，并且具有与仓库具有写入权限的用户的访问级别相同。 令牌在每个作业开始之前创建，在作业完成时过期。 更多信息请参阅“[使用 GITHUB_TOKEN 验证身份](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)”。 - - 应尽可能使用 `GITHUB_TOKEN`。 -2. **仓库部署密钥** - - 部署密钥是唯一授予对单个存储库的读取或写入访问权限的凭据类型之一，可用于与工作流程中的另一个仓库进行交互。 更多信息请参阅“[管理部署密钥](/developers/overview/managing-deploy-keys#deploy-keys)”。 - - 请注意，部署密钥只能使用 Git 克隆和推送到仓库，不能用于与 REST 或 GraphQL API 进行交互，因此它们可能不适合您的要求。 -3. **{% data variables.product.prodname_github_app %} 令牌** - - {% data variables.product.prodname_github_apps %} 可以安装在选择的仓库上，甚至可以对其中的资源设置细致的访问权限。 您可以创建组织内部的 {% data variables.product.prodname_github_app %}，将其安装在工作流程中您需要访问的仓库上，并在工作流程中验证为安装以访问这些仓库。 -4. **个人访问令牌** - - 切勿使用您自己帐户的个人访问令牌。 这些令牌授予您访问组织中您有权访问的所有仓库，以及您的用户帐户中的所有个人仓库。 这间接地向所有能写入工作流程所在仓库的用户授予广泛访问权限。 此外，如果您以后离开组织，使用此令牌的工作流程将立即中断，而且调试此问题可能具有挑战性。 - - 如果使用个人访问令牌，应是为新帐户生成的令牌，该帐户仅被授予对工作流程所需的特定仓库的访问权限。 请注意，此方法不可扩展，应避免采用其他方法，例如部署密钥。 -5. **用户帐户上的 SSH 密钥** - - 工作流程不应使用用户帐户上的 SSH 密钥。 与个人访问令牌类似，它们授予对所有个人仓库以及通过组织成员资格访问的所有仓库的读/写权限。 这间接地向所有能写入工作流程所在仓库的用户授予广泛访问权限。 如果您打算使用 SSH 密钥，因为您只需要执行仓库克隆或推送，并且不需要与公共 API 交互，则应该使用单独的部署密钥。 - -### 自托管运行器的强化 - -**{% data variables.product.prodname_dotcom %} 托管的**运行程序在临时和干净的隔离虚拟机中执行代码，这意味着无法持续破坏此环境，可以访问的信息不会超过引导过程中此环境中存在的信息。 - -{% data variables.product.product_name %} 上**自托管**的运行器不能保证在临时干净的虚拟机中运行，并且可能会持续受到工作流程中不受信任的代码的损害。 - -因此，自托管的运行器几乎[永远不能用于 {% data variables.product.product_name %} 上的公共仓库](/actions/hosting-your-own-runners/about-self-hosted-runners#self-hosted-runner-security-with-public-repositories)，因为任何用户都可以打开针对仓库的拉取请求并破坏环境。 同样，在私有仓库上使用自托管运行器时也要小心，因为任何可以复刻仓库并打开 PR 的人（通常是对仓库具有读取权限的人）都能够破坏自托管运行器环境，包括访问密码以及可授予仓库写入权限的特权 `GITHUB_TOKEN` 。 - -您还应考虑自托管运行器机器的环境： -- 配置为自托管运行器的计算机上存储哪些敏感信息？ 例如，私有 SSH 密钥、API 访问令牌等。 -- 计算机是否可通过网络访问敏感服务？ 例如，Azure 或 AWS 元数据服务。 此环境中的敏感信息量应保持在最低水平，您应该始终注意，任何能够调用工作流程的用户都有权访问此环境。 diff --git a/translations/zh-CN/content/actions/getting-started-with-github-actions/starting-with-preconfigured-workflow-templates.md b/translations/zh-CN/content/actions/getting-started-with-github-actions/starting-with-preconfigured-workflow-templates.md deleted file mode 100644 index 579f101581bd..000000000000 --- a/translations/zh-CN/content/actions/getting-started-with-github-actions/starting-with-preconfigured-workflow-templates.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: 从预配置的工作流程模板开始 -intro: '{% data variables.product.prodname_dotcom %} 提供预配置的工作流程模板以自动化工作流程或为特定语言和框架创建 CI 工作流程。' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/starting-with-preconfigured-workflow-templates -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### 关于工作流程模板 - -{% data variables.product.product_name %} 分析代码并显示最适合仓库的 CI 模板。 例如，如果仓库包含 Node.js 代码，您就会看到 Node.js 项目的建议。 您可以使用工作流程模板作为基础来构建自定义工作流程，或按原样使用模板。 - -您可以在 [actions/starter-workflows](https://github.com/actions/starter-workflows/tree/master/ci) 仓库中浏览 CI 模板的完整列表。 您还可以查找用于自动化工作流程的模板。 您还可以查找用于自动化工作流程的模板。 - -### 添加第一个工作流程模板 - -如果尚未将工作流程添加到仓库，您将看到可供选择的工作流程模板列表。 - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.actions-set-up-workflow-template %} - -### 添加附加工作流程模板 - -如果您已有工作流程并希望添加新的模板工作流程，则可以导航到工作流程模板。 - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -{% data reusables.repositories.actions-new-workflow %} -{% data reusables.repositories.actions-set-up-workflow-template %} diff --git a/translations/zh-CN/content/actions/getting-started-with-github-actions/using-actions-from-github-marketplace.md b/translations/zh-CN/content/actions/getting-started-with-github-actions/using-actions-from-github-marketplace.md deleted file mode 100644 index 88389e5bc657..000000000000 --- a/translations/zh-CN/content/actions/getting-started-with-github-actions/using-actions-from-github-marketplace.md +++ /dev/null @@ -1,51 +0,0 @@ ---- -title: 使用 GitHub Marketplace 中的操作 -intro: '您可以在 {% data variables.product.prodname_marketplace %} 中浏览和搜索要用于工作流程的操作。' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/using-github-marketplace-actions - - /actions/automating-your-workflow-with-github-actions/using-actions-from-github-marketplace-in-your-workflow -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### 关于 {% data variables.product.prodname_marketplace %} 中的操作 - -{% data variables.product.prodname_marketplace %} 是一个中心位置，可供查找由 {% data variables.product.prodname_dotcom %} 社区构建的操作。 带有徽章的操作表示 {% data variables.product.prodname_dotcom %} 已验证操作的创建者为合作伙伴组织。 - -{% data reusables.actions.enterprise-marketplace-actions %} - -您可以从 {% data variables.product.prodname_dotcom %} 上的工作流程编辑器以及从 [{% data variables.product.prodname_marketplace %} 页面发现新的操作](https://github.com/marketplace/actions/)。 - -直接在工作流程编辑器中查看操作可以快速访问 {% data variables.product.prodname_marketplace %} 中的所有操作。 {% data variables.product.prodname_marketplace %} 操作页面提供了更大的灵活性，可以按类别过滤操作。 - -### 在工作流程编辑器中浏览操作 - -您可以直接在仓库的工作流程编辑器中搜索和浏览操作。 从边栏可以搜索特定的操作、查看特色操作和浏览特色类别。 您也可以查看操作从 {% data variables.product.prodname_dotcom %} 社区获得的星标数。 - -1. 在仓库中，浏览至要编辑的工作流程文件。 -1. 要打开工作流程编辑器，在文件视图右上角单击 {% octicon "pencil" aria-label="The edit icon" %}。 ![编辑工作流程文件按钮](/assets/images/help/repository/actions-edit-workflow-file.png) -1. 在编辑器右侧，使用 {% data variables.product.prodname_marketplace %} 边栏浏览操作。 ![Marketplace 工作流程边栏](/assets/images/help/repository/actions-marketplace-sidebar.png) - -### 浏览 {% data variables.product.prodname_marketplace %} 中的操作 - -您可以在 [{% data variables.product.prodname_marketplace %} 操作页面](https://github.com/marketplace/actions/)找到相同的操作。 在 {% data variables.product.prodname_marketplace %} 页面上，您有更大的灵活性按类别和验证过滤操作。 - -### 从工作流程编辑器添加操作到您的工作流程 - -操作的列表页包括操作的版本以及使用操作所需的工作流程语法。 - -1. 导航到要在工作流程中使用的操作。 -1. 在“Installation（安装）”下，单击 {% octicon "clippy" aria-label="The edit icon" %} 复制工作流程语法。 ![查看操作列表](/assets/images/help/repository/actions-sidebar-detailed-view.png) -1. 将语法粘贴为工作流程中的新步骤。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idsteps)”。 -1. 如果操作要求您提供变量，请将其设置在工作流程中。 有关操作可能需要哪些变量的信息，请参阅 {% data variables.product.prodname_marketplace %} 中的操作完整列表。 - -{% if currentVersion == "free-pro-team@latest" %} - -{% data reusables.dependabot.version-updates-for-actions %} - -{% endif %} diff --git a/translations/zh-CN/content/actions/getting-started-with-github-actions/using-community-workflows-and-actions.md b/translations/zh-CN/content/actions/getting-started-with-github-actions/using-community-workflows-and-actions.md deleted file mode 100644 index 25d6a1907413..000000000000 --- a/translations/zh-CN/content/actions/getting-started-with-github-actions/using-community-workflows-and-actions.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: 使用社区工作流程和操作 -intro: '使用其他人和组织构建的操作和工作流程，包括 {% data variables.product.prodname_dotcom %}。' -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/zh-CN/content/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners.md b/translations/zh-CN/content/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners.md deleted file mode 100644 index f8e3e9639af3..000000000000 --- a/translations/zh-CN/content/actions/hosting-your-own-runners/managing-access-to-self-hosted-runners.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: 管理自托管运行器的访问权限 -intro: 您可以控制哪些仓库可以将作业发送给组织的自托管运行器。 -versions: - free-pro-team: '*' ---- - -在组织级别添加的自托管运行器可以处理组织中所有仓库的作业。 如果需要限制对自托管运行器的访问权限，可以将策略配置为仅处理私有仓库的作业，或者定义允许的仓库列表。 - -### 控制哪些存储库可以访问组织的运行器 - -{% data reusables.organizations.navigate-to-org %} -{% data reusables.organizations.org_settings %} -{% data reusables.organizations.settings-sidebar-actions %} -1. 在“Self-hosted runners（自托管运行器）”旁边，单击 **Manage repository permissions（管理仓库权限）**。 ![管理仓库权限](/assets/images/help/settings/actions-runner-manage-permissions.png) - -1. 从下拉菜单中选择以下选项之一： - - * **All repositories（所有仓库）** - 组织中的所有公共和私有仓库都可以向组织的自托管运行器发送作业。 - * **Private repositories（私有仓库）** - 只有组织中的私有仓库才能向组织的自托管运行器发送作业。 - * **Selected repositories（选定的仓库）** - 使用仓库选择菜单选择组织中的哪些仓库可以向组织的自托管运行器发送作业。 diff --git a/translations/zh-CN/content/actions/language-and-framework-guides/building-and-testing-java-with-ant.md b/translations/zh-CN/content/actions/language-and-framework-guides/building-and-testing-java-with-ant.md deleted file mode 100644 index e11e40baf9f0..000000000000 --- a/translations/zh-CN/content/actions/language-and-framework-guides/building-and-testing-java-with-ant.md +++ /dev/null @@ -1,107 +0,0 @@ ---- -title: 使用 Ant 构建和测试 Java -intro: 您可以在 GitHub 操作中创建持续集成 (CI) 工作流程，以使用 Ant 构建和测试 Java 项目。 -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### 简介 - -本指南介绍如何使用 Ant 构建系统为 Java 项目创建执行持续集成 (CI) 的工作流程。 您创建的工作流程将允许您查看拉取请求提交何时会在默认分支上导致构建或测试失败； 这个方法可帮助确保您的代码始终是健康的。 您可以扩展 CI 工作流程以从工作流程运行上传构件。 - -{% data variables.product.prodname_dotcom %} 托管的运行器有工具缓存预安装的软件，包括 Java Development Kits (JDKs) 和 Ant。 有关软件以及 JDK 和 Ant 预安装版本的列表，请参阅 [{% data variables.product.prodname_dotcom %} 自托管运行器上安装的软件](/actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners)。 - -### 基本要求 - -您应该熟悉 YAML 和 {% data variables.product.prodname_actions %} 的语法。 更多信息请参阅： -- "[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)" -- "[配置工作流程](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)" - -建议您对 Java 和 Ant 框架有个基本的了解。 更多信息请参阅“[Apache Ant 手册](https://ant.apache.org/manual/)”。 - -{% data reusables.actions.enterprise-setup-prereq %} - -### 从 Ant 工作流程模板开始 - -{% data variables.product.prodname_dotcom %} 提供有 Ant 工作流程模板，应该适用于大多数基于 Ant 的 Java 项目。 更多信息请参阅 [Ant 工作流程模板](https://github.com/actions/starter-workflows/blob/master/ci/ant.yml)。 - -要快速开始，您可以在创建新工作流程时选择预配置的 Ant 模板。 更多信息请参阅“[从预配置的工作流程模板开始](/actions/automating-your-workflow-with-github-actions/starting-with-preconfigured-workflow-templates)”。 - -您也可以通过在仓库的 `.github/workflow` 目录中创建新文件来手动添加此工作流程。 - -{% raw %} -```yaml -name: Java CI - -on: [push] - -jobs: - build: - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - name: Set up JDK 1.8 - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Build with Ant - run: ant -noinput -buildfile build.xml -``` -{% endraw %} - -此工作流程执行以下步骤： - -1. `checkout` 步骤在运行器上下载仓库的副本。 -2. `setup-java` 步骤配置 Java 1.8 JDK。 -3. “使用 Ant 构建”步骤以非交互模式运行 `build.xml` 中的默认目标。 - -在创建构建和测试工作流程时，默认工作流模板是很好的起点，然后您可以自定义模板以满足项目的需求。 - -{% data reusables.github-actions.example-github-runner %} - -{% data reusables.github-actions.java-jvm-architecture %} - -### 构建和测试代码 - -您可以使用与本地相同的命令来构建和测试代码。 - -初学者工作流程将运行 _build.xml_ 文件中指定的默认目标。 默认目标通常设置为将类、运行测试和包类设置为其可分发格式，例如 JAR 文件。 - -如果使用不同的命令来构建项目，或者想要运行不同的目标，则可以指定这些命令。 例如，您可能想要运行在 _build-ci.xml_ 文件中配置的 `jar` 目标。 - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Run the Ant jar target - run: ant -noinput -buildfile build-ci.xml jar -``` -{% endraw %} - -### 将工作流数据打包为构件 - -构建成功且测试通过后，您可能想要上传生成的 Java 包作为构件。 这会将构建的包存储为工作流程运行的一部分，并允许您下载它们。 构件可帮助您在拉取请求合并之前在本地环境中测试并调试它们。 更多信息请参阅“[使用构件持久化工作流程](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)”。 - -Ant 通常会在 `build/jar` 目录中创建 JAR、EAR 或 WAR 等输出文件。 您可以使用 `upload-artifact` 操作上传该目录的内容。 - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - - run: ant -noinput -buildfile build.xml - - uses: actions/upload-artifact@v2 - with: - name: Package - path: build/jar -``` -{% endraw %} diff --git a/translations/zh-CN/content/actions/language-and-framework-guides/building-and-testing-java-with-gradle.md b/translations/zh-CN/content/actions/language-and-framework-guides/building-and-testing-java-with-gradle.md deleted file mode 100644 index 40069ba014bc..000000000000 --- a/translations/zh-CN/content/actions/language-and-framework-guides/building-and-testing-java-with-gradle.md +++ /dev/null @@ -1,132 +0,0 @@ ---- -title: 使用 Gradle 构建和测试 Java -intro: 您可以在 GitHub 操作中创建持续集成 (CI) 工作流程，以使用 Gradle 构建和测试 Java 项目。 -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### 简介 - -本指南介绍如何使用 Gradle 构建系统为 Java 项目创建执行持续集成 (CI) 的工作流程。 您创建的工作流程将允许您查看拉取请求提交何时会在默认分支上导致构建或测试失败； 这个方法可帮助确保您的代码始终是健康的。 您可以扩展 CI 工作流程以缓存文件并且从工作流程运行上传构件。 - -{% data variables.product.prodname_dotcom %} 托管的运行器有工具缓存预安装的软件，包括 Java Development Kits (JDKs) 和 Gradle。 有关软件以及 JDK 和 Gradle 预安装版本的列表，请参阅 [{% data variables.product.prodname_dotcom %} 自托管运行器上安装的软件](/actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners)。 - -### 基本要求 - -您应该熟悉 YAML 和 {% data variables.product.prodname_actions %} 的语法。 更多信息请参阅： -- "[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)" -- "[配置工作流程](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)" - -建议您对 Java 和 Gradle 框架有个基本的了解。 更多信息请参阅 Gradle 文档中的[入门指南](https://docs.gradle.org/current/userguide/getting_started.html)。 - -{% data reusables.actions.enterprise-setup-prereq %} - -### 从 Gradle 工作流程模板开始 - -{% data variables.product.prodname_dotcom %} 提供有 Gradle 工作流程模板，应该适用于大多数基于 Gradle 的 Java 项目。 更多信息请参阅 [Gradle 工作流程模板](https://github.com/actions/starter-workflows/blob/master/ci/gradle.yml)。 - -要快速开始，您可以在创建新工作流程时选择预配置的 Gradle 模板。 更多信息请参阅“[从预配置的工作流程模板开始](/actions/automating-your-workflow-with-github-actions/starting-with-preconfigured-workflow-templates)”。 - -您也可以通过在仓库的 `.github/workflow` 目录中创建新文件来手动添加此工作流程。 - -{% raw %} -```yaml -name: Java CI - -on: [push] - -jobs: - build: - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - name: Set up JDK 1.8 - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Build with Gradle - run: ./gradlew build -``` -{% endraw %} - -此工作流程执行以下步骤： - -1. `checkout` 步骤在运行器上下载仓库的副本。 -2. `setup-java` 步骤配置 Java 1.8 JDK。 -3. “使用 Gradle 构建”步骤运行 `gradlew` wrapper 脚本以确保可以创建您的代码构建、测试通过和包。 - -在创建构建和测试工作流程时，默认工作流模板是很好的起点，然后您可以自定义模板以满足项目的需求。 - -{% data reusables.github-actions.example-github-runner %} - -{% data reusables.github-actions.java-jvm-architecture %} - -### 构建和测试代码 - -您可以使用与本地相同的命令来构建和测试代码。 - -初学者工作流程默认将运行 `build` 任务。 在默认的 Gradle 配置中，此命令将下载依赖项、构建类别、运行测试并将类别打包为可分发格式，如 JAR 文件。 - -如果使用不同的命令来构建项目，或者想要使用不同的任务，则可以指定这些命令。 例如，您可能想要运行在 _ci.gradle_ 文件中配置的 `package` 任务。 - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Run the Gradle package task - run: ./gradlew -b ci.gradle package -``` -{% endraw %} - -### 缓存依赖项 - -您可以缓存依赖项来加快工作流程运行。 运行成功后，您的本地 Gradle 缓存将存储在 GitHub 操作基础架构中。 在未来的工作流程运行中，缓存将会恢复，因此不需要从远程包仓库下载依赖项。 更多信息请参阅“[缓存依赖项以加快工作流程](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)”和 [`cache` 操作](https://github.com/marketplace/actions/cache)。 - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - name: Set up JDK 1.8 - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Cache Gradle packages - uses: actions/cache@v2 - with: - path: ~/.gradle/caches - key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle') }} - restore-keys: ${{ runner.os }}-gradle - - name: Build with Gradle - run: ./gradlew build -``` -{% endraw %} - -此工作流程将保存本地 Gradle 缓存的内容，位于运行器主目录的 `.gradle/caches` 目录中。 缓存密钥将是 gradle 构建文件的哈希内容，因此更改它们将使缓存失效。 - -### 将工作流数据打包为构件 - -构建成功且测试通过后，您可能想要上传生成的 Java 包作为构件。 这会将构建的包存储为工作流程运行的一部分，并允许您下载它们。 构件可帮助您在拉取请求合并之前在本地环境中测试并调试它们。 更多信息请参阅“[使用构件持久化工作流程](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)”。 - -Gradle 通常会在 `build/libs` 目录中创建 JAR、EAR 或 WAR 等输出文件。 您可以使用 `upload-artifact` 操作上传该目录的内容。 - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - - run: ./gradlew build - - uses: actions/upload-artifact@v2 - with: - name: Package - path: build/libs -``` -{% endraw %} diff --git a/translations/zh-CN/content/actions/language-and-framework-guides/building-and-testing-java-with-maven.md b/translations/zh-CN/content/actions/language-and-framework-guides/building-and-testing-java-with-maven.md deleted file mode 100644 index a97ec3a2477d..000000000000 --- a/translations/zh-CN/content/actions/language-and-framework-guides/building-and-testing-java-with-maven.md +++ /dev/null @@ -1,133 +0,0 @@ ---- -title: 使用 Maven 构建和测试 Java -intro: 您可以在 GitHub 操作中创建持续集成 (CI) 工作流程，以使用 Maven 构建和测试 Java 项目。 -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### 简介 - -本指南介绍如何使用 Maven 软件项目管理工具为 Java 项目创建执行持续集成 (CI) 的工作流程。 您创建的工作流程将允许您查看拉取请求提交何时会在默认分支上导致构建或测试失败； 这个方法可帮助确保您的代码始终是健康的。 您可以扩展 CI 工作流程以缓存文件并且从工作流程运行上传构件。 - -{% data variables.product.prodname_dotcom %} 托管的运行器有工具缓存预安装的软件，包括 Java Development Kits (JDKs) 和 Maven。 有关软件以及 JDK 和 Maven 预安装版本的列表，请参阅 [{% data variables.product.prodname_dotcom %} 自托管运行器上安装的软件](/actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners)。 - -### 基本要求 - -您应该熟悉 YAML 和 {% data variables.product.prodname_actions %} 的语法。 更多信息请参阅： -- "[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)" -- "[配置工作流程](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)" - -建议您对 Java 和 Maven 框架有个基本的了解。 更多信息请参阅 Maven 文档中的 [Maven 入门指南](http://maven.apache.org/guides/getting-started/index.html)。 - -{% data reusables.actions.enterprise-setup-prereq %} - -### 从 Maven 工作流程模板开始 - -{% data variables.product.prodname_dotcom %} 提供有 Maven 工作流程模板，应该适用于大多数基于 Maven 的 Java 项目。 更多信息请参阅 [Maven 工作流程模板](https://github.com/actions/starter-workflows/blob/master/ci/maven.yml)。 - -要快速开始，您可以在创建新工作流程时选择预配置的 Maven 模板。 更多信息请参阅“[从预配置的工作流程模板开始](/actions/automating-your-workflow-with-github-actions/starting-with-preconfigured-workflow-templates)”。 - -您也可以通过在仓库的 `.github/workflow` 目录中创建新文件来手动添加此工作流程。 - -{% raw %} -```yaml -name: Java CI - -on: [push] - -jobs: - build: - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - name: Set up JDK 1.8 - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Build with Maven - run: mvn -B package --file pom.xml -``` -{% endraw %} - -此工作流程执行以下步骤： - -1. `checkout` 步骤在运行器上下载仓库的副本。 -2. `setup-java` 步骤配置 Java 1.8 JDK。 -3. “使用 Maven 构建”步骤以非交互模式运行 Maven `package` 目标，以确保创建代码版本、测试通行证和软件包。 - -在创建构建和测试工作流程时，默认工作流模板是很好的起点，然后您可以自定义模板以满足项目的需求。 - -{% data reusables.github-actions.example-github-runner %} - -{% data reusables.github-actions.java-jvm-architecture %} - -### 构建和测试代码 - -您可以使用与本地相同的命令来构建和测试代码。 - -初学者工作流程默认将运行 `package` 目标。 在默认的 Maven 配置中，此命令将下载依赖项、构建类别、运行测试并将类别打包为可分发格式，如 JAR 文件。 - -如果使用不同的命令来构建项目，或者想要使用不同的目标，则可以指定这些命令。 例如，您可能想要运行在 _pom-ci.xml_ 文件中配置的 `verify` 目标。 - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Run the Maven verify phase - run: mvn -B verify --file pom-ci.xml -``` -{% endraw %} - -### 缓存依赖项 - -您可以缓存依赖项来加快工作流程运行。 运行成功后，您的本地 Maven 仓库将存储在 GitHub 操作基础架构中。 在未来的工作流程运行中，缓存将会恢复，因此不需要从远程 Maven 仓库下载依赖项。 更多信息请参阅“[缓存依赖项以加快工作流程](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)”和 [`cache` 操作](https://github.com/marketplace/actions/cache)。 - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - name: Set up JDK 1.8 - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Cache Maven packages - uses: actions/cache@v2 - with: - path: ~/.m2 - key: ${{ runner.os }}-m2-${{ hashFiles('**/pom.xml') }} - restore-keys: ${{ runner.os }}-m2 - - name: Build with Maven - run: mvn -B package --file pom.xml -``` -{% endraw %} - -此工作流程将保存本地 Maven 存储库的内容，位于运行器主目录的 `.m2` 目录。 缓存密钥是 _pom.xml_ 的哈希内容，因此更改 _pom.xml_ 将使缓存失效。 - -### 将工作流数据打包为构件 - -构建成功且测试通过后，您可能想要上传生成的 Java 包作为构件。 这会将构建的包存储为工作流程运行的一部分，并允许您下载它们。 构件可帮助您在拉取请求合并之前在本地环境中测试并调试它们。 更多信息请参阅“[使用构件持久化工作流程](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)”。 - -Maven 通常会在 `target` 目录中创建 JAR、EAR 或 WAR 等输出文件。 要将这些项目上传为构件，可以将它们复制到包含要上传的构件的新目录中。 例如，您可以创建一个名为 `staging` 的目录。 然后您可以使用 `upload-artifact` 操作上传该目录的内容。 - -{% raw %} -```yaml -steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - - run: mvn -B package --file pom.xml - - run: mkdir staging && cp target/*.jar staging - - uses: actions/upload-artifact@v2 - with: - name: Package - path: staging -``` -{% endraw %} diff --git a/translations/zh-CN/content/actions/language-and-framework-guides/github-actions-for-docker.md b/translations/zh-CN/content/actions/language-and-framework-guides/github-actions-for-docker.md deleted file mode 100644 index 4005123d29f8..000000000000 --- a/translations/zh-CN/content/actions/language-and-framework-guides/github-actions-for-docker.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: 用于 Docker 的 GitHub 操作 -intro: 创建用于构建和发布 Docker 项目的工作流程。 -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/zh-CN/content/actions/language-and-framework-guides/github-actions-for-java.md b/translations/zh-CN/content/actions/language-and-framework-guides/github-actions-for-java.md deleted file mode 100644 index 924386562828..000000000000 --- a/translations/zh-CN/content/actions/language-and-framework-guides/github-actions-for-java.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: 用于 Java 的 GitHub 操作 -intro: 创建工作流程以构建和测试以 Java 编写的项目。 -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/zh-CN/content/actions/language-and-framework-guides/github-actions-for-javascript-and-typescript.md b/translations/zh-CN/content/actions/language-and-framework-guides/github-actions-for-javascript-and-typescript.md deleted file mode 100644 index 6ca98a402598..000000000000 --- a/translations/zh-CN/content/actions/language-and-framework-guides/github-actions-for-javascript-and-typescript.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: 用于 JavaScript 和 TypeScript 的 GitHub 操作 -intro: 创建工作流程以构建和测试在 JavaScript 和 TypeScript 库中写入的项目。 -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/zh-CN/content/actions/language-and-framework-guides/github-actions-for-python.md b/translations/zh-CN/content/actions/language-and-framework-guides/github-actions-for-python.md deleted file mode 100644 index c6c6ea16f31e..000000000000 --- a/translations/zh-CN/content/actions/language-and-framework-guides/github-actions-for-python.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: 用于 Python 的 GitHub 操作 -intro: 创建工作流程以构建和测试以 Python 编写的项目。 -mapTopic: true -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - diff --git a/translations/zh-CN/content/actions/language-and-framework-guides/index.md b/translations/zh-CN/content/actions/language-and-framework-guides/index.md deleted file mode 100644 index 2ffd23f9ab01..000000000000 --- a/translations/zh-CN/content/actions/language-and-framework-guides/index.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: 语言和框架指南 -intro: 您可以创建持续集成 (CI) 工作流程，以构建和测试以不同编程语言编写的项目。 -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -{% topic_link_in_list /github-actions-for-javascript-and-typescript %} - {% link_in_list /using-nodejs-with-github-actions %} - {% link_in_list /publishing-nodejs-packages %} -{% topic_link_in_list /github-actions-for-python %} - {% link_in_list /using-python-with-github-actions %} -{% topic_link_in_list /github-actions-for-java %} - {% link_in_list /building-and-testing-java-with-maven %} - {% link_in_list /building-and-testing-java-with-gradle %} - {% link_in_list /building-and-testing-java-with-ant %} - {% link_in_list /publishing-java-packages-with-maven %} - {% link_in_list /publishing-java-packages-with-gradle %} -{% topic_link_in_list /github-actions-for-docker %} - {% link_in_list /publishing-docker-images %} diff --git a/translations/zh-CN/content/actions/language-and-framework-guides/publishing-docker-images.md b/translations/zh-CN/content/actions/language-and-framework-guides/publishing-docker-images.md deleted file mode 100644 index e313ba374635..000000000000 --- a/translations/zh-CN/content/actions/language-and-framework-guides/publishing-docker-images.md +++ /dev/null @@ -1,157 +0,0 @@ ---- -title: 发布 Docker 映像 -intro: '您可以将 Docker 映像发布到注册表，例如 Docker Hub 或 {% data variables.product.prodname_registry %}，作为持续集成 (CI) 工作流程的一部分。' -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### 简介 - -本指南介绍如何创建执行 Docker 构建的工作流程，然后将 Docker 映像发布到 Docker Hub 或 {% data variables.product.prodname_registry %}。 通过单个工作流程，您可以将映像发布到单一注册表或多个注册表。 - -{% note %} - -**注意：**如果要推送到另一个第三方 Docker 注册表，则“[发布映像到 {% data variables.product.prodname_registry %}](#publishing-images-to-github-packages)”部分可作为一个很好的模板。 - -{% endnote %} - -### 基本要求 - -建议基本了解工作流程配置选项和如何创建工作流程文件。 更多信息请参阅“[配置工作流程](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)。 - -您可能还发现基本了解以下内容是有帮助的： - -- "[{% data variables.product.prodname_actions %} 的核心概念](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)" -- "[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)" -- "[使用 GITHUB_TOKEN 验证身份](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)" -- "[配置 Docker 用于 {% data variables.product.prodname_registry %}](/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages)" - -### 关于映像配置 - -本指南假定您对存储在 {% data variables.product.prodname_dotcom %} 仓库的 Docker 映像有完整的定义。 例如，仓库必须包含 _Dockerfile_ 以及执行 Docker 构建所需的任何其他文件才可创建映像。 - -在本指南中，我们将使用 Docker `build-push-action` 操作来构建 Docker 映像并将其推送到一个或多个 Docker 注册表。 更多信息请参阅 [`build-push-action`](https://github.com/marketplace/actions/build-and-push-docker-images)。 - -{% data reusables.actions.enterprise-marketplace-actions %} - -### 将映像发布到 Docker Hub - -{% data reusables.github-actions.release-trigger-workflow %} - -在下面的示例工作流程中，我们使用 Docker `build-push-action` 操作构建 Docker 映像，如果构建成功，则将构建映像推送到 Docker Hub。 - -要推送到 Docker Hub，您需要有一个 Docker Hub 帐户，并创建一个 Docker Hub 仓库。 更多信息请参阅 Docker 文档中的“[在 Docker Hub 上共享映像](https://docs.docker.com/get-started/part3/)”。 - -Docker Hub 需要的 `build-push-action` 选项包括： - -* `username` 和 `password`：这是您的 Docker Hub 用户名和密码。 建议将 Docker Hub 用户名和密码在 {% data variables.product.prodname_dotcom %} 仓库中存储为加密密码，以免它们暴露在工作流程文件中。 更多信息请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。 -* `repository`：`DOCKER-HUB-NAMESPACE/DOCKER-HUB-REPOSITORY` 格式的 Docker Hub 仓库。 - -{% raw %} -```yaml -name: Publish Docker image -on: - release: - types: [published] -jobs: - push_to_registry: - name: Push Docker image to Docker Hub - runs-on: ubuntu-latest - steps: - - name: Check out the repo - uses: actions/checkout@v2 - - name: Push to Docker Hub - uses: docker/build-push-action@v1 - with: - username: ${{ secrets.DOCKER_USERNAME }} - password: ${{ secrets.DOCKER_PASSWORD }} - repository: my-docker-hub-namespace/my-docker-hub-repository - tag_with_ref: true -``` -{% endraw %} - -{% data reusables.github-actions.docker-tag-with-ref %} - -### 发布映像到 {% data variables.product.prodname_registry %} - -{% data reusables.github-actions.release-trigger-workflow %} - -在下面的示例工作流程中，我们使用 Docker `build-push-action` 操作构建 Docker 映像，如果构建成功，则将构建映像推送到 {% data variables.product.prodname_registry %}。 - -{% data variables.product.prodname_registry %} 需要的 `build-push-action` 选项包括： - -* `username`：您可以使用 {% raw %}`${{ github.actor }}`{% endraw %} 上下文自动使用触发工作流程运行的用户的用户名。 更多信息请参阅“[GitHub 操作的上下文和表达式语法](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)”。 -* `password`：您可以使用自动生成的 `GITHUB_TOKEN` 密码作为密码。 更多信息请参阅“[使用 GITHUB_TOKEN 验证身份](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)”。 -* `registry`：必须设置为 `docker.pkg.github.com`。 -* `repository`：必须以 `OWNER/REPOSITORY/IMAGE_NAME` 格式设置。 例如，对于 `http://github.com/octo-org/octo-repo` 上名为 `octo-image` stored on {% data variables.product.prodname_dotcom %} 的映像，`repository` 选项应设置为 `octo-org/octo-repo/octo-image`。 - -{% raw %} -```yaml -name: Publish Docker image -on: - release: - types: [published] -jobs: - push_to_registry: - name: Push Docker image to GitHub Packages - runs-on: ubuntu-latest - steps: - - name: Check out the repo - uses: actions/checkout@v2 - - name: Push to GitHub Packages - uses: docker/build-push-action@v1 - with: - username: ${{ github.actor }} - password: ${{ secrets.GITHUB_TOKEN }} - registry: docker.pkg.github.com - repository: my-org/my-repo/my-image - tag_with_ref: true - -``` -{% endraw %} - -{% data reusables.github-actions.docker-tag-with-ref %} - -### 发布映像到 Docker Hub 和 {% data variables.product.prodname_registry %} - -在单一工作流程中，您可以对每个注册表使用 `build-push-action` 操作，以将 Docker 映像发布到多个注册表。 - -下面的示例工作流程使用前面章节中的 `build-push-action` 步骤（“[发布映像到 Docker Hub](#publishing-images-to-docker-hub)”和“[发布映像到 {% data variables.product.prodname_registry %}](#publishing-images-to-github-packages)”）来创建同时推送到两个注册表的单一工作流程。 - -{% raw %} -```yaml -name: Publish Docker image -on: - release: - types: [published] -jobs: - push_to_registries: - name: Push Docker image to multiple registries - runs-on: ubuntu-latest - steps: - - name: Check out the repo - uses: actions/checkout@v2 - - name: Push to Docker Hub - uses: docker/build-push-action@v1 - with: - username: ${{ secrets.DOCKER_USERNAME }} - password: ${{ secrets.DOCKER_PASSWORD }} - repository: my-docker-hub-namespace/my-docker-hub-repository - tag_with_ref: true - - name: Push to GitHub Packages - uses: docker/build-push-action@v1 - with: - username: ${{ github.actor }} - password: ${{ secrets.GITHUB_TOKEN }} - registry: docker.pkg.github.com - repository: my-org/my-repo/my-image - tag_with_ref: true -``` -{% endraw %} - -上面的工作流程检出 {% data variables.product.prodname_dotcom %} 仓库，并且使用两次 `build-push-action` 操作构建并推送 Docker 映像到 Docker Hub 和 {% data variables.product.prodname_registry %}。 对于这两个步骤， 它设置 `build-pow-action` 选项 [`tag_with_ref`](https://github.com/marketplace/actions/build-and-push-docker-images#tag_with_ref) 自动使用工作流程事件的 Git 引用标记构建的 Docker 映像。 此工作流程在发布 {% data variables.product.prodname_dotcom %} 版本时触发，因此对两个注册表的引用将是该版本的 Git 标记。 diff --git a/translations/zh-CN/content/actions/language-and-framework-guides/publishing-java-packages-with-gradle.md b/translations/zh-CN/content/actions/language-and-framework-guides/publishing-java-packages-with-gradle.md deleted file mode 100644 index c64d12ebd715..000000000000 --- a/translations/zh-CN/content/actions/language-and-framework-guides/publishing-java-packages-with-gradle.md +++ /dev/null @@ -1,218 +0,0 @@ ---- -title: 使用 Gradle 发布 Java 包 -intro: 您可以使用 Gradle 将 Java 包发布到注册表，作为持续集成 (CI) 工作流程的一部分。 -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### 简介 - -{% data reusables.github-actions.publishing-java-packages-intro %} - -### 基本要求 - -建议对工作流程文件和配置选项有一个基本了解。 更多信息请参阅“[配置工作流程](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)。 - -有关使用 Gradle 为 Java 项目创建 CI 工作流程的详细信息，请参阅“[使用 Gradle 构建和测试用 Java](/actions/language-and-framework-guides/building-and-testing-java-with-gradle)”。 - -您可能还发现基本了解以下内容是有帮助的： - -- "[{% data variables.product.prodname_actions %} 的核心概念](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)" -- "[配置 npm 用于 {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)" -- "[使用环境变量](/actions/automating-your-workflow-with-github-actions/using-environment-variables)" -- "[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)" -- "[使用 GITHUB_TOKEN 验证身份](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)" - -### 关于包配置 - -_build.gradle_ 文件 `MavenPublication` 部分的 `groupId` 和 `artifactId` 字段为包创建唯一标识符，供注册表用来将包链接到注册表。 这类似于 Maven _pom.xml_ 文件的 `groupId` 和 `artifactId` 字段。 更多信息请参阅 Gradle 文档中的“[Maven 发布插件](https://docs.gradle.org/current/userguide/publishing_maven.html)”。 - -_build.gradle_ 文件还包含 Gradle 将在其中部署包的分发管理仓库的配置。 每个仓库必须有名称、部署 URL 和验证凭据。 - -### 将包发布到 Maven 中心仓库 - -每次创建新版本时，都可以触发工作流程来发布包。 以下示例中的工作流程在类型为 `created` 的 `release` 事件触发时运行。 如果 CI 测试通过，工作流程将包发布到 Maven 中心仓库。 有关 `release` 事件的更多信息，请参阅“[触发工作流程的事件](/actions/reference/events-that-trigger-workflows#release)”。 - -您可以在 _build.gradle_ 文件的发布块中定义指向包仓库的新 Maven 仓库。 例如，如果您通过 OSSRH 托管项目部署到 Maven 中心仓库，则 _build.gradle_ 可以指定名称为 `"OSSRH"` 的仓库。 - -{% raw %} -```groovy -publishing { - ... - - repositories { - maven { - name = "OSSRH" - url = "https://oss.sonatype.org/service/local/staging/deploy/maven2/" - credentials { - username = System.getenv("MAVEN_USERNAME") - password = System.getenv("MAVEN_PASSWORD") - } - } - } -} -``` -{% endraw %} - -使用此配置可创建一个工作流程，以通过运行 `gradle publish` 命令将包发布到 Maven 中心仓库。 您还需要提供包含用户名和密码的环境变量向仓库验证。 - -在部署步骤中，您需要为用于向 Maven 仓库验证身份的用户名和密码或令牌设置环境变量。 更多信息请参阅“[创建和使用加密密码](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。 - - -{% raw %} -```yaml -name: Publish package to the Maven Central Repository -on: - release: - types: [created] -jobs: - publish: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - - name: Set up Java - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Publish package - run: gradle publish - env: - MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }} - MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }} -``` -{% endraw %} - -{% data reusables.github-actions.gradle-workflow-steps %} -1. 运行 `gradle published` 命令以发布到 `OSSRH` Maven 仓库。 `MAVEN_USERNAME` 环境变量将使用 `OSSRH_USERNAME` 密码的内容设置，而 `MAVEN_PASSWORD` 环境变量将使用 `OSSRH_TOKEN` 密码的内容设置。 - - 有关在工作流程中使用密码的更多信息，请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。 - -### 发布包到 {% data variables.product.prodname_registry %} - -每次创建新版本时，都可以触发工作流程来发布包。 以下示例中的工作流程在类型为 `created` 的 `release` 事件触发时运行。 如果 CI 测试通过，工作流程会将包发布到 {% data variables.product.prodname_registry %}。 有关 `release` 事件的更多信息，请参阅“[触发工作流程的事件](/actions/reference/events-that-trigger-workflows#release)”。 - -您可以在 _build.gradle_ 文件的发布块中定义指向 {% data variables.product.prodname_registry %} 的新 Maven 仓库。 在仓库配置中，您也可以利用在 CI 工作流程运行中设置的环境变量。 您可以使用 `GITHUB_ACTOR` 环境变量作为用户名，并且可以使用 `GITHUB_TOKENN` 密码设置 `GITHUB_TOKEN` 环境变量。 - -`GITHUB_TOKEN` 默认存在于您的仓库中，并且对工作流程运行的仓库中的包具有读取和写入权限。 更多信息请参阅“[使用 GITHUB_TOKEN 验证身份](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)”。 - -例如，如果组织名为“octocat”且仓库名为“hello-world”，则 _build.gradle_ 中的 {% data variables.product.prodname_registry %} 配置看起来类似于以下示例。 - -{% raw %} -```groovy -publishing { - ... - - repositories { - maven { - name = "GitHubPackages" - url = "https://maven.pkg.github.com/octocat/hello-world" - credentials { - username = System.getenv("GITHUB_ACTOR") - password = System.getenv("GITHUB_TOKEN") - } - } - } -} -``` -{% endraw %} - -使用此配置可创建一个工作流程，以通过运行 `gradle publish` 命令将包发布到 Maven 中心仓库。 - -{% raw %} -```yaml -name: Publish package to GitHub Packages -on: - release: - types: [created] -jobs: - publish: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Publish package - run: gradle publish - env: - GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} - -{% data reusables.github-actions.gradle-workflow-steps %} -1. 运行 `gradle published` 命令以发布到 {% data variables.product.prodname_registry %}。 `GITHUB_TOKEN` 环境变量将使用 `GITHUB_TOKEN` 密码的内容设置。 - - 有关在工作流程中使用密码的更多信息，请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。 - -### 发布包到 Maven 中心仓库和 {% data variables.product.prodname_registry %} - -您可以通过在 _build.gradle_ 文件中配置每项设置，将包发布到 Maven 中心仓库和 {% data variables.product.prodname_registry %}。 - -确保 _build.gradle_ 文件包含用于 {% data variables.product.prodname_dotcom %} 仓库和 Maven 中心仓库提供商的仓库。 - -例如，如果您通过 OSSRH 托管项目部署到 Maven 中心仓库，您可能想要在分发管理仓库中指定它，并将 `name` 设置为 `OSSRH`。 如果您部署到 {% data variables.product.prodname_registry %}，您可能想要在分发管理仓库中指定它，并将 `name` 设置为 `GitHubPackages`。 - -如果组织名为“octocat”且仓库名为“hello-world”，则 _build.gradle_ 中的 {% data variables.product.prodname_registry %} 配置看起来类似于以下示例。 - -{% raw %} -```groovy -publishing { - ... - - repositories { - maven { - name = "OSSRH" - url = "https://oss.sonatype.org/service/local/staging/deploy/maven2/" - credentials { - username = System.getenv("MAVEN_USERNAME") - password = System.getenv("MAVEN_PASSWORD") - } - } - maven { - name = "GitHubPackages" - url = "https://maven.pkg.github.com/octocat/hello-world" - credentials { - username = System.getenv("GITHUB_ACTOR") - password = System.getenv("GITHUB_TOKEN") - } - } - } -} -``` -{% endraw %} - -使用此配置可创建一个工作流程，以通过运行 `gradle publish` 命令将包发布到 Maven 中心仓库和 {% data variables.product.prodname_registry %}。 - -{% raw %} -```yaml -name: Publish package to the Maven Central Repository and GitHub Packages -on: - release: - types: [created] -jobs: - publish: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - - name: Set up Java - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Publish to the Maven Central Repository - run: gradle publish - env: - MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }} - MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }} - GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} - -{% data reusables.github-actions.gradle-workflow-steps %} -1. 运行 `gradle published` 命令以发布到 `OSSRH` Maven 仓库和 {% data variables.product.prodname_registry %}。 `MAVEN_USERNAME` 环境变量将使用 `OSSRH_USERNAME` 密码的内容设置，而 `MAVEN_PASSWORD` 环境变量将使用 `OSSRH_TOKEN` 密码的内容设置。 `GITHUB_TOKEN` 环境变量将使用 `GITHUB_TOKEN` 密码的内容设置。 - - 有关在工作流程中使用密码的更多信息，请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。 diff --git a/translations/zh-CN/content/actions/language-and-framework-guides/publishing-java-packages-with-maven.md b/translations/zh-CN/content/actions/language-and-framework-guides/publishing-java-packages-with-maven.md deleted file mode 100644 index 637a0a5609c4..000000000000 --- a/translations/zh-CN/content/actions/language-and-framework-guides/publishing-java-packages-with-maven.md +++ /dev/null @@ -1,209 +0,0 @@ ---- -title: 使用 Maven 发布 Java 包 -intro: 您可以使用 Maven 将 Java 包发布到注册表，作为持续集成 (CI) 工作流程的一部分。 -product: '{% data reusables.gated-features.actions %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### 简介 - -{% data reusables.github-actions.publishing-java-packages-intro %} - -### 基本要求 - -建议对工作流程文件和配置选项有一个基本了解。 更多信息请参阅“[配置工作流程](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)。 - -有关为使用 Maven 为 Java 项目创建 CI 工作流程的详细信息，请参阅“[使用 Maven 构建和测试用 Java](/actions/language-and-framework-guides/building-and-testing-java-with-maven)”。 - -您可能还发现基本了解以下内容是有帮助的： - -- "[{% data variables.product.prodname_actions %} 的核心概念](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)" -- "[配置 npm 用于 {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)" -- "[使用环境变量](/actions/automating-your-workflow-with-github-actions/using-environment-variables)" -- "[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)" -- "[使用 GITHUB_TOKEN 验证身份](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)" - -### 关于包配置 - -_pom.xml_ 文件中的 `groupId` 和 `artifactId` 字段为包创建唯一标识符，供注册表用来将包链接到注册表。 更多信息请参阅 Apache Maven 文档中的[将构件上传到中心仓库的指南](http://maven.apache.org/repository/guide-central-repository-upload.html)。 - -_pom.xml_ 文件还包含 Maven 将在其中部署包的分配管理仓库的配置。 每个仓库都必须有名称和部署 URL。 这些仓库的身份验证可在运行 Maven 的用户主目录下的 _.m2/settings.xml_ 文件中配置。 - -您可以使用 `setup-java` 操作配置部署仓库以及该仓库的身份验证。 更多信息请参阅 [`setup-java`](https://github.com/actions/setup-java)。 - -### 将包发布到 Maven 中心仓库 - -每次创建新版本时，都可以触发工作流程来发布包。 以下示例中的工作流程在类型为 `created` 的 `release` 事件触发时运行。 如果 CI 测试通过，工作流程将包发布到 Maven 中心仓库。 有关 `release` 事件的更多信息，请参阅“[触发工作流程的事件](/actions/reference/events-that-trigger-workflows#release)”。 - -在此工作流程中，您可以使用 `setup-java` 操作。 此操作将 JDK 的给定版本安装到 `PATH`，但同时会配置 Maven _settings.xml_ 以发布包。 默认情况下，设置文件将配置用于 {% data variables.product.prodname_registry %}，但可以将其配置为部署到另一个包注册表，如 Maven 中心仓库。 如果您已经在 _pom.xml_ 配置分配管理仓库，则可在 `setup-java` 操作调用期间指定该 `id`。 - -例如，如果您通过 OSSRH 托管项目部署到 Maven 中心仓库，则 _pom.xml_ 可以指定 `id` 为 `ossrh` 的分发管理仓库。 - -{% raw %} -```xml - - ... - - - ossrh - Central Repository OSSRH - https://oss.sonatype.org/service/local/staging/deploy/maven2/ - - - -``` -{% endraw %} - -使用此配置，可通过将仓库管理 `id` 指定到 `setup-java` 操作，创建一个将包发布到 Maven 中心仓库的工作流程。 您还需要提供包含用户名和密码的环境变量向仓库验证。 - -在部署步骤中，您需要将环境变量设置为向仓库验证的用户名，以及用密码或令牌配置为进行身份验证的密钥。 更多信息请参阅“[创建和使用加密密码](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。 - - -{% raw %} -```yaml -name: Publish package to the Maven Central Repository -on: - release: - types: [created] -jobs: - publish: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - - name: Set up Maven Central Repository - uses: actions/setup-java@v1 - with: - java-version: 1.8 - server-id: ossrh - server-username: MAVEN_USERNAME - server-password: MAVEN_PASSWORD - - name: Publish package - run: mvn -B deploy - env: - MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }} - MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }} -``` -{% endraw %} - -此工作流程执行以下步骤： - -1. 检出项目仓库的副本。 -1. 设置 Java JDK，同时使用 `MAVEN_USERNAME` 和 `MAVEN_PASSWORD` 环境变量配置 Maven _settings.xml_ 文件为 `ossrh` 仓库添加身份验证。 -1. {% data reusables.github-actions.publish-to-maven-workflow-step %} - - 有关在工作流程中使用密码的更多信息，请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。 - -### 发布包到 {% data variables.product.prodname_registry %} - -每次创建新版本时，都可以触发工作流程来发布包。 以下示例中的工作流程在类型为 `created` 的 `release` 事件触发时运行。 如果 CI 测试通过，工作流程会将包发布到 {% data variables.product.prodname_registry %}。 有关 `release` 事件的更多信息，请参阅“[触发工作流程的事件](/actions/reference/events-that-trigger-workflows#release)”。 - -在此工作流程中，您可以使用 `setup-java` 操作。 此操作将给定版本的 JDK 安装到 `PATH`，并且设置 Maven _settings.xml_ 以将包发布到 {% data variables.product.prodname_registry %}。 生成的 _settings.xml_ 定义使用 `github` 的 `id` 向服务器验证，使用 `GITHUB_ACTOR` 环境变量作为用户名，`GITHUB_TOKEN` 环境变量作为密码。 - -`GITHUB_TOKEN` 默认存在于您的仓库中，并且对工作流程运行的仓库中的包具有读取和写入权限。 更多信息请参阅“[使用 GITHUB_TOKEN 验证身份](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)”。 - -对于基于 Maven的项目，您可以通过在 _pom.xml_ 文件中创建分发仓库来使用这些设置，该文件以 `github` 的 `id` 指向 {% data variables.product.prodname_registry %} 端点。 - -例如，如果组织名为“octocat”且仓库名为“hello-world”，则 _pom.xml_ 中的 {% data variables.product.prodname_registry %} 配置看起来类似于以下示例。 - -{% raw %} -```xml - - ... - - - github - GitHub Packages - https://maven.pkg.github.com/octocat/hello-world - - - -``` -{% endraw %} - -通过此配置，您可以创建一个工作流程，以使用自动生成的 _settings.xml_ 将包发布到 {% data variables.product.prodname_registry %}。 - -{% raw %} -```yaml -name: Publish package to GitHub Packages -on: - release: - types: [created] -jobs: - publish: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Publish package - run: mvn -B deploy - env: - GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} - -此工作流程执行以下步骤： - -1. 检出项目仓库的副本。 -1. 设置 Java JDK，同时自动配置 Maven _settings.xml_ 文件为 `github` Maven 仓库添加身份验证，以使用 `GITHUB_TOKEN` 环境变量。 -1. {% data reusables.github-actions.publish-to-packages-workflow-step %} - - 有关在工作流程中使用密码的更多信息，请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。 - -### 发布包到 Maven 中心仓库和 {% data variables.product.prodname_registry %} - -您可以使用每个注册表的 `setup-node` 操作将包发布到 Maven 中心仓库和 {% data variables.product.prodname_registry %}。 - -确保 _pom.xml_ 文件包含用于 {% data variables.product.prodname_dotcom %} 仓库和 Maven 中心仓库提供商的分发管理仓库。 例如，如果您通过 OSSRH 托管项目部署到中心仓库，您可能想通过将 `id` 设置为 `ossrh` 在分发管理仓库中指定它，并且想通过将 `id` 设置为 `github` 在分发管理仓库中指定 {% data variables.product.prodname_registry %}。 - -{% raw %} -```yaml -name: Publish package to the Maven Central Repository and GitHub Packages -on: - release: - types: [created] -jobs: - publish: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - - name: Set up Java for publishing to Maven Central Repository - uses: actions/setup-java@v1 - with: - java-version: 1.8 - server-id: ossrh - server-username: MAVEN_USERNAME - server-password: MAVEN_PASSWORD - - name: Publish to the Maven Central Repository - run: mvn -B deploy - env: - MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }} - MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }} - - name: Set up Java for publishing to GitHub Packages - uses: actions/setup-java@v1 - with: - java-version: 1.8 - - name: Publish to GitHub Packages - run: mvn -B deploy - env: - GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} - -此工作流程将调用 `setup-java` 操作两次。 每次运行 `setup-java` 操作时，都会覆盖 Maven _settings.xml_ 文件以发布包。 为向仓库验证，_settings.xml_ 文件引用分发管理仓库 `id` 以及用户名和密码。 - -此工作流程执行以下步骤： - -1. 检出项目仓库的副本。 -1. 第一次调用 `setup-java`。 这将为 `ossrh` 仓库配置 Maven _settings.xml_ 文件，并将身份验证选项设置为下一步定义的环境变量。 -1. {% data reusables.github-actions.publish-to-maven-workflow-step %} -1. 第二次调用 `setup-java`。 这将自动为 {% data variables.product.prodname_registry %} 配置 Maven _settings.xml_ 文件。 -1. {% data reusables.github-actions.publish-to-packages-workflow-step %} - - 有关在工作流程中使用密码的更多信息，请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。 diff --git a/translations/zh-CN/content/actions/language-and-framework-guides/publishing-nodejs-packages.md b/translations/zh-CN/content/actions/language-and-framework-guides/publishing-nodejs-packages.md deleted file mode 100644 index 2589b65bc449..000000000000 --- a/translations/zh-CN/content/actions/language-and-framework-guides/publishing-nodejs-packages.md +++ /dev/null @@ -1,210 +0,0 @@ ---- -title: 发布 Node.js 包 -intro: 您可以将 Node.js 包发布到注册表，作为持续集成 (CI) 工作流程的一部分。 -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### 简介 - -本指南介绍如何创建一个工作流程，以在持续集成 (CI) 测试通过后将 Node.js 包发布到 {% data variables.product.prodname_registry %} 和 npm 注册表。 通过单个工作流程，您可以将包发布到单个注册表或多个注册表。 - -### 基本要求 - -建议基本了解工作流程配置选项和如何创建工作流程文件。 更多信息请参阅“[配置工作流程](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)。 - -有关为 Node.js 项目创建 CI 工作流程的更多信息，请参阅“[将 Node.js 与 {% data variables.product.prodname_actions %} 一起使用](/actions/automating-your-workflow-with-github-actions/using-nodejs-with-github-actions)。” - -您可能还发现基本了解以下内容是有帮助的： - -- "[{% data variables.product.prodname_actions %} 的核心概念](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)" -- "[配置 npm 用于 {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)" -- "[使用环境变量](/actions/automating-your-workflow-with-github-actions/using-environment-variables)" -- "[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)" -- "[使用 GITHUB_TOKEN 验证身份](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)" - -### 关于包配置 - - *package.json* 文件中的 `name` 和 `version` 字段创建唯一标识符，供注册表用来将包链接到注册表。 您可以在 *package.json* 文件中添加 `description` 字段，从而为包列表页面添加一个摘要。 更多信息请参阅 npm 文档中的“[创建 package.json 文件](https://docs.npmjs.com/creating-a-package-json-file)”和“[创建 Node.js 模块](https://docs.npmjs.com/creating-node-js-modules)”。 - -当本地 *.npmrc* 文件存在且指定了 `registry` 值时，`npm publish` 命令将使用 *.npmrc* 文件中配置的注册表。 {% data reusables.github-actions.setup-node-intro %} - -您可以使用 `setup-node` 操作指定运行器上安装的 Node.js 版本。 - -如果在工作流程中添加步骤来配置 *package.json* 文件中的 `publishConfig` 字段，则无需使用 `setup-node` 操作指定注册表 url，但软件包仅限于发布到一个注册表。 更多信息请参阅 npm 文档中的“[publishConfig](https://docs.npmjs.com/files/package.json#publishconfig)”。 - -### 发布包到 npm 注册表 - -每次创建新版本时，都可以触发工作流程来发布包。 以下示例中的工作流程在类型为 `created` 的 `release` 事件触发时运行。 如果 CI 测试通过，工作流程将包发布到 npm 注册表。 - -要根据工作流程中的 npm 注册表执行经过身份验证的操作，您需要在仓库设置中将 npm 身份验证令牌作存储为密码。 例如，创建名为 `NPM_TOKEN` 的密码。 更多信息请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。 - -默认情况下，npm 使用 *package.json* 文件的 `name` 字段来确定 npm 注册表。 当发布到全局命名空间时，您只需要包含包名称。 例如，您要发布一个名为 `npm-hello-world-test` 的包到 `https://www.npmjs.com/package/npm-hello-world-test`。 - -如果发布一个包含范围前缀的包，请将范围包含在 *package.json* 文件的名称中。 例如，如果 npm 范围前缀是 octocat 并且包名是 hello-world，则 *package.json* 文件中的 `name` 应为 `@octocat/hello-world`。 如果 npm 包使用范围前缀且包是公开的，则需使用选项 `npm publish --access public`。 这是 npm 需要用来防止有人无意中发布私有包的选项。 - -此示例将 `NPM_TOKEN` 密码存储在 `NODE_AUTH_TOKEN` 环境变量中。 当 `setup-node` 操作创建 *.npmrc* 文件时，会引用 `NODE_AUTH_TOKEN` 环境变量中的令牌。 - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # Setup .npmrc file to publish to npm - - uses: actions/setup-node@v1 - with: - node-version: '12.x' - registry-url: 'https://registry.npmjs.org' - - run: npm install - - run: npm publish - env: - NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} -``` -{% endraw %} - -在上面的示例中，`setup-node` 操作在运行器上创建一个包含以下内容的 *.npmrc* 文件： - -``` -//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN} -registry=https://registry.npmjs.org/ -always-auth=true -``` - -### 发布包到 {% data variables.product.prodname_registry %} - -每次创建新版本时，都可以触发工作流程来发布包。 以下示例中的工作流程在类型为 `created` 的 `release` 事件发生时运行。 如果 CI 测试通过，工作流程会将包发布到 {% data variables.product.prodname_registry %}。 - -默认情况下，{% data variables.product.prodname_registry %} 将包发布到您在 *package.json* 文件的 `name` 字段中指定的 {% data variables.product.prodname_dotcom %} 仓库。 例如，您要发布一个名为 `@my-org/test` 的包到 `my-org/test` {% data variables.product.prodname_dotcom %} 仓库。 更多信息请参阅 npm 文档中的 [`npm-scope`](https://docs.npmjs.com/misc/scope)。 - -要根据 {% data variables.product.prodname_registry %} 注册表在工作流程中执行经验证的操作，可以使用 `GITHUB_TOKEN`。 `GITHUB_TOKEN` 默认存在于您的仓库中，并且对工作流程运行的仓库中的包具有读取和写入权限。 更多信息请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。 - -此示例将 `GITHUB_TOKEN` 密码存储在 `NODE_AUTH_TOKEN` 环境变量中。 当 `setup-node` 操作创建 *.npmrc* 文件时，会引用 `NODE_AUTH_TOKEN` 环境变量中的令牌。 - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # 设置 .npmrc 文件以发布到 GitHub 包 - - uses: actions/setup-node@v1 - with: - node-version: '12.x' - registry-url: 'https://npm.pkg.github.com' - # 默认为拥有工作流程文件的用户或组织 - scope: '@octocat' - - run: npm install - - run: npm publish - env: - NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} - -`setup-node` 操作在运行器上创建 *.npmrc* 文件。 使用 `scope` 输入到 `setup-node` 操作时，*.npmrc* 文件包含作用域前缀。 默认情况下，`setup-node` 操作在 *.npmrc* 文件中将作用域设置为包含该工作流程文件的帐户。 - -``` -//npm.pkg.github.com/:_authToken=${NODE_AUTH_TOKEN} -@octocat:registry=https://npm.pkg.github.com -always-auth=true -``` - -### 使用 yarn 发布包 - -如果您使用 Yarn 包管理器，可以使用 Yarn 安装和发布包。 - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # 设置 .npmrc 文件以发布到 npm - - uses: actions/setup-node@v1 - with: - node-version: '12.x' - registry-url: 'https://registry.npmjs.org' - # 默认为拥有工作流程文件的用户或组织 - scope: '@octocat' - - run: yarn - - run: yarn publish - env: - NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} -``` -{% endraw %} - -### 发布包到 npm 和 {% data variables.product.prodname_registry %} - -{% note %} - -**注意：**如果需要发布到具有不同作用域前缀的注册表，则需修改运行器上的 *package.json* 文件以更改作用域前缀。 例如，如果将包发布到 npm 的 `@mona` 作用域和 {% data variables.product.prodname_registry %} 的 `@octocat` 作用域，则可在发布到 npm 之后和发布到 {% data variables.product.prodname_registry %} 之前，在运行器的 *package.json* 文件中将 `@mona` 作用域替换成 `@octocat`。 - -{% endnote %} - -您可以使用每个注册表的 `setup-node` 操作将包发布到 npm 注册表和 {% data variables.product.prodname_registry %}。 - -如果将包发布到两个注册表，则需要确保 npm 上的作用域前缀与 {% data variables.product.prodname_dotcom %} 用户或组织名称匹配。 要将包发布到具有作用域前缀的公共注册表，可以使用 `npm publish --access public`。 更多信息请参阅 [`npm-scope`](https://docs.npmjs.com/misc/scope) 和 npm 文档中的“[创建和发布作用域的公共包](https://docs.npmjs.com/creating-and-publishing-scoped-public-packages)”。 - -确认 *package.json* 文件包含 {% data variables.product.prodname_dotcom %} 仓库和 npm 注册表的作用域。 例如，如果您计划将 `octocat/npm-hello-world-test` 仓库中的包发布到 {% data variables.product.prodname_dotcom %} 和 https://www.npmjs.com/package/@octocat/npm-hello-world-test，则 *package.json* 文件中的名称将是 `"name": "@octocat/npm-hello-world-test"`。 - -要根据 {% data variables.product.prodname_registry %} 注册表在工作流程中执行经验证的操作，可以使用 `GITHUB_TOKEN`。 `GITHUB_TOKEN` 默认存在于您的仓库中，并且对工作流程运行的仓库中的包具有读取和写入权限。 更多信息请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。 - -使用 `scope` 输入到 `setup-node` 操作时，操作将创建包含作用域前缀的 *.npmrc* 文件。 默认情况下，`setup-node` 操作在 *.npmrc* 文件中将作用域设置为拥有该工作流程文件的用户或组织。 - -此工作流程将调用 `setup-node` 操作两次。 每当 `setup-node` 操作运行时，都会覆盖 *.npmrc* 文件。 *.npmrc* 文件引用的令牌允许您对 `NODE_AUTH_TOKEN` 环境变量中的包注册表执行验证的操作。 工作流程在 `npm publish` 命令每次运行时设置 `NODE_AUTH_TOKEN` 环境变量，先通过令牌发布到 npm (`NPM_TOKEN`)，然后通过令牌发布到 {% data variables.product.prodname_registry %} (`GITHUB_TOKEN`)。 - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # 设置 .npmrc 文件以发布到 npm - - uses: actions/setup-node@v1 - with: - node-version: '10.x' - registry-url: 'https://registry.npmjs.org' - - run: npm install - # 发布到 npm - - run: npm publish --access public - env: - NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} - # 设置 .npmrc 文件以发布到 GitHub 包 - - uses: actions/setup-node@v1 - with: - registry-url: 'https://npm.pkg.github.com' - # 默认为拥有工作流程文件的用户或组织 - scope: '@octocat' - # 发布到 GitHub 包 - - run: npm publish - env: - NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} diff --git a/translations/zh-CN/content/actions/language-and-framework-guides/using-nodejs-with-github-actions.md b/translations/zh-CN/content/actions/language-and-framework-guides/using-nodejs-with-github-actions.md deleted file mode 100644 index 3e161c934173..000000000000 --- a/translations/zh-CN/content/actions/language-and-framework-guides/using-nodejs-with-github-actions.md +++ /dev/null @@ -1,277 +0,0 @@ ---- -title: 将 Node.js 与 GitHub 操作一起使用 -intro: 您可以创建持续集成 (CI) 工作流程来构建和测试您的 Node.js 项目。 -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/using-nodejs-with-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### 简介 - -本指南介绍如何创建用来生成和测试 Node.js 代码的持续集成 (CI) 工作流程。 如果 CI 测试通过，您可能想要部署代码或发布包。 - -### 基本要求 - -建议基本了解 Node.js、YAML、工作流程配置选项以及如何创建工作流程文件。 更多信息请参阅“[配置工作流程](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)”和“[Node.js 使用入门](https://nodejs.org/en/docs/guides/getting-started-guide/)”。 - -您可能还发现基本了解以下内容是有帮助的： - -- "[{% data variables.product.prodname_actions %} 的核心概念](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)" -- "[使用环境变量](/actions/automating-your-workflow-with-github-actions/using-environment-variables)" - -{% data reusables.actions.enterprise-setup-prereq %} - -### 从 Node.js 工作流程模板开始 - -{% data variables.product.prodname_dotcom %} 提供 Node.js 适用于大多数 Node.js 项目的工作流程模板。 本指南包含可用于自定义模板的 npm 和 Yarn 示例。 更多信息请参阅 [Node.js 工作流程模板](https://github.com/actions/starter-workflows/blob/master/ci/node.js.yml)。 - -要快速开始，请将模板添加到仓库的 `.github/workflows` 目录中。 - -{% raw %} -```yaml -name: Node.js CI - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - - strategy: - matrix: - node-version: [8.x, 10.x, 12.x] - - steps: - - uses: actions/checkout@v2 - - name: Use Node.js ${{ matrix.node-version }} - uses: actions/setup-node@v1 - with: - node-version: ${{ matrix.node-version }} - - run: npm install - - run: npm run build --if-present - - run: npm test - env: - CI: true -``` -{% endraw %} - -{% data reusables.github-actions.example-github-runner %} - -### 指定 Node.js 版本 - -指定 Node.js 版本的最简单方法是使用由 {% data variables.product.prodname_dotcom %} 提供的 `setup-node` 操作。 更多信息请参阅 [`setup-node`](https://github.com/actions/setup-node/)。 - -`setup-node` 操作采用 Node.js 版本作为输入，并在运行器上配置该版本。 `setup-node` 操作从每个运行器上的工具缓存中查找特定版本的 Node.js，并将必要的二进制文件添加到 `PATH`，这可继续用于作业的其余部分。 使用 `setup-node` 操作是 Node.js 与 {% data variables.product.prodname_actions %} 结合使用时的推荐方式，因为它能确保不同运行器和不同版本的 Node.js 行为一致。 如果使用自托管运行器，则必须安装 Node.js 并将其添加到 `PATH`。 - -模板包含一个矩阵策略：用三个 Node.js 版本 8.x、10.x 和 12.x 构建和测试代码，其中“x”是通配符，匹配可用于版本的最新次要版和补丁版。 The 'x' is a wildcard character that matches the latest minor and patch release available for a version. `node-version` 阵列中指定的每个 Node.js 版本都会创建一个运行相同步骤的作业。 - -每个作业都可以使用 `matrix` 上下文访问矩阵 `node-version` 阵列中定义的值。 `setup-node` 操作使用上下文作为 `node-version` 输入。 `setup-node` 操作在构建和测试代码之前使用不同的 Node.js 版本配置每个作业。 有关矩阵策略和上下文的更多信息，请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix)”和“[{% data variables.product.prodname_actions %} 的上下文和表达式语法](/actions/reference/context-and-expression-syntax-for-github-actions)”。 - -{% raw %} -```yaml -strategy: - matrix: - node-version: [8.x, 10.x, 12.x] - -steps: -- uses: actions/checkout@v2 -- name: Use Node.js ${{ matrix.node-version }} - uses: actions/setup-node@v1 - with: - node-version: ${{ matrix.node-version }} -``` -{% endraw %} - -您也可以构建和测试精确的 Node.js 版本。 - -```yaml -strategy: - matrix: - node-version: [8.16.2, 10.17.0] -``` - -或者，您也可以使用单个版本的 Node.js 构建和测试。 - -{% raw %} -```yaml -name: Node.js CI - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - name: Use Node.js - uses: actions/setup-node@v1 - with: - node-version: '12.x' - - run: npm install - - run: npm run build --if-present - - run: npm test - env: - CI: true -``` -{% endraw %} - -如果不指定 Node.js 版本，{% data variables.product.prodname_dotcom %} 将使用环境的默认 Node.js 版本。 更多信息请参阅“[{% data variables.product.prodname_dotcom %} 托管的运行器上安装的软件](/actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners)”。 - -### 安装依赖项 - -{% data variables.product.prodname_dotcom %} 托管的运行器安装了 npm 和 Yarn 依赖项管理器。 在构建和测试代码之前，可以使用 npm 和 Yarn 在工作流程中安装依赖项。 Windows 和 Linux {% data variables.product.prodname_dotcom %} 托管的运行器也安装了 Grunt、Gulp 和 Bower。 - -您也可以缓存依赖项来加快工作流程。 更多信息请参阅“[缓存依赖项以加快工作流程](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)”。 - -#### 使用 npm 的示例 - -此示例安装 *package.json* 文件中定义的依赖项。 更多信息请参阅 [`npm install`](https://docs.npmjs.com/cli/install)。 - -```yaml -steps: -- uses: actions/checkout@v2 -- name: Use Node.js - uses: actions/setup-node@v1 - with: - node-version: '12.x' -- name: Install dependencies - run: npm install -``` - -使用 `npm ci` 将版本安装到 *package-lock.json* 或 *npm-shrinkwraw.json* 文件并阻止更新锁定文件。 使用 `npm ci` 通常比运行 `npm install` 更快。 更多信息请参阅 [`npm ci`](https://docs.npmjs.com/cli/ci.html) 和“[引入 `npm ci` 以进行更快、更可靠的构建](https://blog.npmjs.org/post/171556855892/introducing-npm-ci-for-faster-more-reliable)”。 - -{% raw %} -```yaml -steps: -- uses: actions/checkout@v2 -- name: Use Node.js - uses: actions/setup-node@v1 - with: - node-version: '12.x' -- name: Install dependencies - run: npm ci -``` -{% endraw %} - -#### 使用 Yarn 的示例 - -此示例安装 *package.json* 文件中定义的依赖项。 更多信息请参阅 [`yarn install`](https://yarnpkg.com/en/docs/cli/install)。 - -```yaml -steps: -- uses: actions/checkout@v2 -- name: Use Node.js - uses: actions/setup-node@v1 - with: - node-version: '12.x' -- name: Install dependencies - run: yarn -``` - -或者，您可以传递 `--frozen-lockfile` 来安装 *yarn.lock* 文件中的版本，并阻止更新 *yarn.lock* 文件。 - -```yaml -steps: -- uses: actions/checkout@v2 -- name: Use Node.js - uses: actions/setup-node@v1 - with: - node-version: '12.x' -- name: Install dependencies - run: yarn --frozen-lockfile -``` - -#### 使用私有注册表并创建 .npmrc 文件的示例 - -{% data reusables.github-actions.setup-node-intro %} - -要验证您的私有注册表，需要将 npm 身份验证令牌在仓库设置中存储为密码。 例如，创建名为 `NPM_TOKEN` 的密码。 更多信息请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。 - -在下面的示例中，密码 `NPM_TOKEN` 用于存储 npm 身份验证令牌。 `setup-node` 操作配置 *.npmrc* 文件从 `NODE_AUTH_TOKEN` 环境变量读取 npm 身份验证令牌。 使用 `setup-node` 操作创建 *.npmrc* 文件时，必须使用包含 npm 身份验证令牌的密码设置 `NPM_AUTH_TOKEN` 环境变量。 - -在安装依赖项之前，使用 `setup-node` 操作创建 *.npmrc* 文件。 该操作有两个输入参数。 `node-version` 参数设置 Node.js 版本，`registry-url` 参数设置默认注册表。 如果包注册表使用作用域，您必须使用 `scope` 参数。 更多信息请参阅 [`npm-scope`](https://docs.npmjs.com/misc/scope)。 - -{% raw %} -```yaml -steps: -- uses: actions/checkout@v2 -- name: Use Node.js - uses: actions/setup-node@v1 - with: - always-auth: true - node-version: '12.x' - registry-url: https://registry.npmjs.org - scope: '@octocat' -- name: Install dependencies - run: npm ci - env: - NODE_AUTH_TOKEN: ${{secrets.NPM_TOKEN}} -``` -{% endraw %} - -上面的示例创建了一个包含以下内容的 *.npmrc* 文件： - -``` -//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN} -@octocat:registry=https://registry.npmjs.org/ -always-auth=true -``` - -#### 缓存依赖项示例 - -您可以使用唯一的密钥缓存依赖项，并在使用 `cache` 操作运行未来的工作流程时恢复依赖项。 更多信息请参阅“[缓存依赖项以加快工作流程](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)”和 [`cache` 操作](https://github.com/marketplace/actions/cache)。 - -{% raw %} -```yaml -steps: -- uses: actions/checkout@v2 -- name: Use Node.js - uses: actions/setup-node@v1 - with: - node-version: '12.x' -- name: Cache Node.js modules - uses: actions/cache@v2 - with: - # npm cache files are stored in `~/.npm` on Linux/macOS - path: ~/.npm - key: ${{ runner.OS }}-node-${{ hashFiles('**/package-lock.json') }} - restore-keys: | - ${{ runner.OS }}-node- - ${{ runner.OS }}- -- name: Install dependencies - run: npm ci -``` -{% endraw %} - -### 构建和测试代码 - -您可以使用与本地相同的命令来构建和测试代码。 例如，如果您运行 `npm run build` 来运行 *package.json* 文件中定义的构建步骤，运行 `npm test` 来运行测试套件，则要在工作流程文件中添加以下命令。 - -```yaml -steps: -- uses: actions/checkout@v2 -- name: Use Node.js - uses: actions/setup-node@v1 - with: - node-version: '12.x' -- run: npm install -- run: npm run build --if-present -- run: npm test -``` - -### 将工作流数据打包为构件 - -您可以保存构建和测试步骤中的构件以在作业完成后查看。 例如，您可能需要保存日志文件、核心转储、测试结果或屏幕截图。 更多信息请参阅“[使用构件持久化工作流程](/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)”。 - -### 发布到包注册表 - -您可以配置工作流程在 CI 测试通过后将 Node.js 包发布到包注册表。 有关发布到 npm 和 {% data variables.product.prodname_registry %} 的更多信息，请参阅“[发布 Node.js 包](/actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages)”。 diff --git a/translations/zh-CN/content/actions/language-and-framework-guides/using-python-with-github-actions.md b/translations/zh-CN/content/actions/language-and-framework-guides/using-python-with-github-actions.md deleted file mode 100644 index 27cd8d86fb43..000000000000 --- a/translations/zh-CN/content/actions/language-and-framework-guides/using-python-with-github-actions.md +++ /dev/null @@ -1,499 +0,0 @@ ---- -title: 将 Python 与 GitHub 操作一起使用 -intro: 您可以创建持续集成 (CI) 工作流程来构建和测试您的 Python 项目。 -redirect_from: - - /actions/automating-your-workflow-with-github-actions/using-python-with-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### 简介 - -本指南介绍如何构建、测试和发布 Python 包。 - -{% data variables.product.prodname_dotcom %} 托管的运行器有工具缓存预安装的软件，包括 Python 和 PyPy。 您无需安装任何项目！ 有关最新版软件以及 Python 和 PyPy 预安装版本的完整列表，请参阅 [{% data variables.product.prodname_dotcom %} 自托管运行器上安装的软件](/actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners)。 - -### 基本要求 - -您应该熟悉 YAML 和 {% data variables.product.prodname_actions %} 的语法。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions)”。 - -建议您对 Python、PyPy 和 pip 有个基本的了解。 更多信息请参阅： -- [开始使用 Python](https://www.python.org/about/gettingstarted/) -- [PyPy](https://pypy.org/) -- [Pip 包管理器](https://pypi.org/project/pip/) - -{% data reusables.actions.enterprise-setup-prereq %} - -### 从 Python 工作流程模板开始 - -{% data variables.product.prodname_dotcom %} 提供有 Python 工作流程模板，应该适用于大多数 Python 项目。 本指南包含可用于自定义模板的示例。 更多信息请参阅 [Python 工作流程模板](https://github.com/actions/starter-workflows/blob/master/ci/python-package.yml)。 - -要快速开始，请将模板添加到仓库的 `.github/workflows` 目录中。 - -{% raw %} -```yaml -name: Python package - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - strategy: - matrix: - python-version: [2.7, 3.5, 3.6, 3.7, 3.8] - - steps: - - uses: actions/checkout@v2 - - name: Set up Python ${{ matrix.python-version }} - uses: actions/setup-python@v2 - with: - python-version: ${{ matrix.python-version }} - - name: Install dependencies - run: | - python -m pip install --upgrade pip - pip install flake8 pytest - if [ -f requirements.txt ]; then pip install -r requirements.txt; fi - - name: Lint with flake8 - run: | - # 如果有任何 Python 语法错误或未定义的名称，停止构建 - flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics - # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide - flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics - - name: Test with pytest - run: | - pytest -``` -{% endraw %} - -### 指定 Python 版本 - -要在 {% data variables.product.prodname_dotcom %} 托管的运行器上使用预安装的 Python 或 PyPy 版本，请使用 `setup-python` 操作。 此操作从每个运行器上的工具缓存中查找特定版本的 Python 或 PyPy，并将必要的二进制文件添加到 `PATH`，这可继续用于作业的其余部分。 如果工具缓存中未安装特定版本的 Python，`setup-python` 操作将从 [`python-versions`](https://github.com/actions/python-versions) 仓库下载并设置适当的版本。 - -使用 `setup-action` 是 Python 与 {% data variables.product.prodname_actions %} 结合使用时的推荐方式，因为它能确保不同运行器和不同版本的 Python 行为一致。 如果使用自托管运行器，则必须安装 Python 并将其添加到 `PATH`。 更多信息请参阅 [`setup-python` 操作](https://github.com/marketplace/actions/setup-python)。 - -下表描述了每个 {% data variables.product.prodname_dotcom %} 托管的运行器中工具缓存的位置。 - -| | Ubuntu | Mac | Windows | -| --------------- | ------------------------------- | ---------------------------------------- | ------------------------------------------ | -| **工具缓存目录** | `/opt/hostedtoolcache/*` | `/Users/runner/hostedtoolcache/*` | `C:\hostedtoolcache\windows\*` | -| **Python 工具缓存** | `/opt/hostedtoolcache/Python/*` | `/Users/runner/hostedtoolcache/Python/*` | `C:\hostedtoolcache\windows\Python\*` | -| **PyPy 工具缓存** | `/opt/hostedtoolcache/PyPy/*` | `/Users/runner/hostedtoolcache/PyPy/*` | `C:\hostedtoolcache\windows\PyPy\*` | - -如果您正在使用自托管的运行器，则可以配置运行器使用 `setup-python` 操作来管理您的依赖项。 更多信息请参阅 `setup-python` 自述文件中的 - -将 setup-python 与自托管运行器一起使用    。

    - -{% data variables.product.prodname_dotcom %} 支持语义版本控制语法。 更多信息请参阅“[使用语义版本控制](https://docs.npmjs.com/about-semantic-versioning#using-semantic-versioning-to-specify-update-types-your-package-can-accept)”和“[语义版本控制规范](https://semver.org/)”。 - - - -#### 使用多个 Python 版本 - -{% raw %} - - -```yaml -name: Python package - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - strategy: - # You can use PyPy versions in python-version. - # 例如，pypy2 和 pypy3 - matrix: - python-version: [2.7, 3.5, 3.6, 3.7, 3.8] - - steps: - - uses: actions/checkout@v2 - - name: Set up Python ${{ matrix.python-version }} - uses: actions/setup-python@v2 - with: - python-version: ${{ matrix.python-version }} - # 您可以打印当前 Python 版本以测试矩阵 - - name: Display Python version - run: python -c "import sys; print(sys.version)" -``` - - -{% endraw %} - - - -#### 使用特定的 Python 版本 - -您可以配置 python 的特定版本。 例如，3.8。 或者，您也可以通过语义版本语法来获得最新的次要版本。 此示例使用 Python 3 最新的次要版本。 - -{% raw %} - - -```yaml -name: Python package - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - name: Set up Python 3.x - uses: actions/setup-python@v2 - with: - # Python 版本的语义版本范围矩阵或准确的版本 - python-version: '3.x' - # 可选 - x64 或 x86 架构，默认为 x64 - architecture: 'x64' - # 您可以打印当前 Python 版本以测试矩阵 - - name: Display Python version - run: python -c "import sys; print(sys.version)" -``` - - -{% endraw %} - - - -#### 排除版本 - -如果指定不可用的 Python 版本，`setup-python` 将会失败，且显示如下错误：`##[error]Version 3.4 with arch x64 not found`。 错误消息包含可用的版本。 - -如果存在您不想运行的 Python 配置，您也可以在工作流程中使用 `exclude` 关键字。 For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategy)." - -{% raw %} - - -```yaml -name: Python package - -on: [push] - -jobs: - build: - - runs-on: ${{ matrix.os }} - strategy: - matrix: - os: [ubuntu-latest, macos-latest, windows-latest] - python-version: [2.7, 3.6, 3.7, 3.8, pypy2, pypy3] - exclude: - - os: macos-latest - python-version: 3.6 - - os: windows-latest - python-version: 3.6 -``` - - -{% endraw %} - - - -#### 使用默认 Python 版本 - -建议使用 `setup-python` 配置工作流程中使用的 Python 版本，因为它有助于使您的依赖关系变得明朗。 如果不使用 `setup-python`，调用 `python` 时将在任何 shell 中使用 `PATH` 中设置的 Python 默认版本。 {% data variables.product.prodname_dotcom %} 托管的运行器之间有不同的 Python 默认版本，这可能导致非预期的更改或使用的版本比预期更旧。 - -| {% data variables.product.prodname_dotcom %} 托管的运行器 | 描述 | -| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Ubuntu | Ubuntu 运行器有多个版本的系统 Python 安装在 `/usr/bin/python` 和 `/usr/bin/python3` 下。 {% data variables.product.prodname_dotcom %} 除了安装在工具缓存中的版本，还有与 Ubuntu 一起打包的 Python 版本。 | -| Windows | 不包括工具缓存中的 Python 版本，Windows 未随附同等版本的系统 Python。 为保持与其他运行器一致的行为，并允许 Python 在没有 `setup-python` 操作的情况下开箱即用，{% data variables.product.prodname_dotcom %} 将从工具缓存中添加几个版本到 `PATH`。 | -| macOS | 除了作为工具缓存一部分的版本外，macOS 运行器还安装了多个版本的系统 Python。 系统 Python 版本位于 `/usr/local/Cellar/python/*` 目录中。 | - - - - -### 安装依赖项 - -{% data variables.product.prodname_dotcom %} 托管的运行器安装了 pip 软件包管理器。 在构建和测试代码之前，您可以使用 pip 从 PyPI 软件包注册表安装依赖项。 例如，下面的 YAML 安装或升级 `pip` 软件包安装程序以及 `setuptools` 和 `wheel` 软件包。 - -您也可以缓存依赖项来加快工作流程。 更多信息请参阅“[缓存依赖项以加快工作流程](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)”。 - -{% raw %} - - -```yaml -steps: -- uses: actions/checkout@v2 -- name: Set up Python - uses: actions/setup-python@v2 - with: - python-version: '3.x' -- name: Install dependencies - run: python -m pip install --upgrade pip setuptools wheel -``` - - -{% endraw %} - - - -#### 要求文件 - -在更新 `pip` 后，下一步通常是从 *requires.txt* 安装依赖项。 - -{% raw %} - - -```yaml -steps: -- uses: actions/checkout@v2 -- name: Set up Python - uses: actions/setup-python@v2 - with: - python-version: '3.x' -- name: Install dependencies - run: | - python -m pip install --upgrade pip - pip install -r requirements.txt -``` - - -{% endraw %} - - - -#### 缓存依赖项 - -您可以使用唯一密钥缓存 pip 依赖项，并在使用 [`cache`](https://github.com/marketplace/actions/cache) 操作运行未来的工作流程时恢复依赖项。 更多信息请参阅“[缓存依赖项以加快工作流程](/actions/automating-your-workflow-with-github-actions/caching-dependencies-to-speed-up-workflows)”。 - -Pip 根据运行器的操作系统将依赖项缓存在不同的位置。 您需要缓存的路径可能不同于下面的 Ubuntu 示例，具体取决于您使用的操作系统。 更多信息请参阅 [Python 缓存示例](https://github.com/actions/cache/blob/master/examples.md#python---pip)。 - -{% raw %} - - -```yaml -steps: -- uses: actions/checkout@v2 -- name: Setup Python - uses: actions/setup-python@v2 - with: - python-version: '3.x' -- name: Cache pip - uses: actions/cache@v2 - with: - # This path is specific to Ubuntu - path: ~/.cache/pip - # Look to see if there is a cache hit for the corresponding requirements file - key: ${{ runner.os }}-pip-${{ hashFiles('requirements.txt') }} - restore-keys: | - ${{ runner.os }}-pip- - ${{ runner.os }}- -- name: Install dependencies - run: pip install -r requirements.txt -``` - - -{% endraw %} - -{% note %} - -**注意：**取决于依赖项的数量，使用依赖项缓存可能会更快。 有很多大型依赖项的项目应该能看到性能明显提升，因为下载所需的时间会缩短。 依赖项较少的项目可能看不到明显的性提升，甚至可能由于pip 安装缓存依赖项的方式而看到性能略有下降。 性能因项目而异。 - -{% endnote %} - - - -### 测试代码 - -您可以使用与本地相同的命令来构建和测试代码。 - - - -#### 使用 pytest 和 pytest-cov 测试 - -此示例安装或升级 `pytest` 和 `pest-cov`。 然后进行测试并以 JUnit 格式输出，而代码覆盖结果则以 Cobertura 输出。 更多信息请参阅 [JUnit](https://junit.org/junit5/) 和 [Cobertura](https://cobertura.github.io/cobertura/)。 - -{% raw %} - - -```yaml -steps: -- uses: actions/checkout@v2 -- name: Set up Python - uses: actions/setup-python@v2 - with: - python-version: '3.x' -- name: Install dependencies - run: | - python -m pip install --upgrade pip - pip install -r requirements.txt -- name: Test with pytest - run: | - pip install pytest - pip install pytest-cov - pytest tests.py --doctest-modules --junitxml=junit/test-results.xml --cov=com --cov-report=xml --cov-report=html -``` - - -{% endraw %} - - - -#### 使用 Flake8 嵌入代码 - -下面的示例安装或升级 `flake8` 并用它来嵌入所有文件。 更多信息请参阅 [Flake8](http://flake8.pycqa.org/en/latest/)。 - -{% raw %} - - -```yaml -steps: -- uses: actions/checkout@v2 -- name: Set up Python - uses: actions/setup-python@v2 - with: - python-version: '3.x' -- name: Install dependencies - run: | - python -m pip install --upgrade pip - pip install -r requirements.txt -- name: Lint with flake8 - run: | - pip install flake8 - flake8 . -``` - - -{% endraw %} - - - -#### 使用 tox 运行测试 - -通过 {% data variables.product.prodname_actions %}，您可以使用 tox 运行测试并将工作分散到多个作业。 您需要使用 `-e py` 选项调用 tox，以在 `PATH` 中选择 Python 版本，而不是指定特定版本。 更多信息请参阅 [tox](https://tox.readthedocs.io/en/latest/)。 - -{% raw %} - - -```yaml -name: Python package - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - strategy: - matrix: - python: [2.7, 3.7, 3.8] - - steps: - - uses: actions/checkout@v2 - - name: Setup Python - uses: actions/setup-python@v2 - with: - python-version: ${{ matrix.python }} - - name: Install Tox and any other packages - run: pip install tox - - name: Run Tox - # 使用 `PATH` 中的 Python 版本运行 tox - run: tox -e py -``` - - -{% endraw %} - - - -### 将工作流数据打包为构件 - -您可以在工作流程完成后上传构件以查看。 例如，您可能需要保存日志文件、核心转储、测试结果或屏幕截图。 更多信息请参阅“[使用构件持久化工作流程](/github/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts)”。 - -下面的示例演示如何使用 `upload-artifact` 操作来存档运行 `pytest` 的测试结果。 更多信息请参阅 [`upload-artifact` 操作](https://github.com/actions/upload-artifact)。 - -{% raw %} - - -```yaml -name: Python package - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - strategy: - matrix: - python-version: [2.7, 3.5, 3.6, 3.7, 3.8] - - steps: - - uses: actions/checkout@v2 - - name: Setup Python # Set Python version - uses: actions/setup-python@v2 - with: - python-version: ${{ matrix.python-version }} - # Install pip and pytest - - name: Install dependencies - run: | - python -m pip install --upgrade pip - pip install pytest - - name: Test with pytest - run: pytest tests.py --doctest-modules --junitxml=junit/test-results-${{ matrix.python-version }}.xml - - name: Upload pytest test results - uses: actions/upload-artifact@v2 - with: - name: pytest-results-${{ matrix.python-version }} - path: junit/test-results-${{ matrix.python-version }}.xml - # Use always() to always run this step to publish test results when there are test failures - if: ${{ always() }} -``` - - -{% endraw %} - - - -### 发布到包注册表 - -您可以配置工作流程在 CI 测试通过时将 Python 包发布到您想要的任何包注册表。 - -您可以使用仓库密码存储发布软件包所需的访问令牌或凭据。 下面的示例使用 `twine` 和 `dist` 创建包并发布到 PyPI。 更多信息请参阅“[创建和使用加密密码](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。 - -{% raw %} - - -```yaml -name: Upload Python Package - -on: - release: - types: [created] - -jobs: - deploy: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - - name: Set up Python - uses: actions/setup-python@v2 - with: - python-version: '3.x' - - name: Install dependencies - run: | - python -m pip install --upgrade pip - pip install setuptools wheel twine - - name: Build and publish - env: - TWINE_USERNAME: ${{ secrets.PYPI_USERNAME }} - TWINE_PASSWORD: ${{ secrets.PYPI_PASSWORD }} - run: | - python setup.py sdist bdist_wheel - twine upload dist/* -``` - - -{% endraw %} - -有关模板工作流程的更多信息，请参阅 [`python-published`](https://github.com/actions/starter-workflows/blob/master/ci/python-publish.yml)。 diff --git a/translations/zh-CN/content/actions/migrating-to-github-actions/index.md b/translations/zh-CN/content/actions/migrating-to-github-actions/index.md deleted file mode 100644 index 8fe3703ac50c..000000000000 --- a/translations/zh-CN/content/actions/migrating-to-github-actions/index.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: 迁移到 GitHub 操作 -intro: '从其他持续集成 (CI) 提供程序迁移到 {% data variables.product.prodname_actions %}。' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -{% link_in_list /migrating-from-circleci-to-github-actions %} -{% link_in_list /migrating-from-azure-pipelines-to-github-actions %} -{% link_in_list /migrating-from-jenkins-to-github-actions %} diff --git a/translations/zh-CN/content/actions/migrating-to-github-actions/migrating-from-azure-pipelines-to-github-actions.md b/translations/zh-CN/content/actions/migrating-to-github-actions/migrating-from-azure-pipelines-to-github-actions.md deleted file mode 100644 index fec437c6131b..000000000000 --- a/translations/zh-CN/content/actions/migrating-to-github-actions/migrating-from-azure-pipelines-to-github-actions.md +++ /dev/null @@ -1,366 +0,0 @@ ---- -title: 从 Azure Pelines 迁移到 GitHub 操作 -intro: '{% data variables.product.prodname_actions %} 和 Azure Pipelines 具有一些相似的配置，这使得迁移到 {% data variables.product.prodname_actions %} 很简单。' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### 简介 - -Azure Pipelines 和 {% data variables.product.prodname_actions %} 都允许您创建能自动构建、测试、发布、发行和部署代码的工作流程。 Azure Pelines 和 {% data variables.product.prodname_actions %} 的工作流程配置有一些相似之处： - -- 工作流程配置文件以 YAML 编写并存储在代码仓库中。 -- 工作流程包括一项或多项作业。 -- 作业包括一个或多个步骤或单个命令。 -- 步骤或任务可以重复使用并与社区共享。 - -更多信息请参阅“[{% data variables.product.prodname_actions %} 的核心概念](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)”。 - -### 主要差异 - -从 Azure Pipelines 迁移时，考虑以下差异： - -- Azure Pelines 支持传统的_经典编辑器_，可让您在 GUI 编辑器中定义 CI 配置，而不是在 YAML 文件中创建管道定义。 {% data variables.product.prodname_actions %} 使用 YAML 文件来定义工作流程，不支持图形编辑器。 -- Azure Pelines 允许您在作业定义中省略一些结构。 例如，如果您只有一个作业，则无需定义作业，只需要定义其步骤。 {% data variables.product.prodname_actions %} 需要明确的配置，且不能省略 YAML 结构。 -- Azure Pipelines 支持 YAML 文件中定义的_阶段_，可用于创建部署工作流程。 {% data variables.product.prodname_actions %} 要求您将阶段分成单独的 YAML 工作流程文件。 -- 可以使用功能选择本地 Azure Pipelines 构建代理。 通过标签可以选择 {% data variables.product.prodname_actions %} 自托管的运行器。 - -### 迁移作业和步骤 - -Azure Pelines 中的作业和步骤非常类似于 {% data variables.product.prodname_actions %} 中的作业和步骤。 在这两个系统中，作业具有以下特征： - -* 作业包含一系列按顺序运行的步骤。 -* 作业在单独的虚拟机或单独的容器中运行。 -* 默认情况下作业并行运行，但可以配置为按顺序运行。 - -### 迁移脚本步骤 - -可以将脚本或 shell 命令作为工作流程中的步骤运行。 在 Azure Pipelines 中，脚本步骤可以使用 `script` 键指定，或者使用 `bash`、`powershell` 或 `pwsh` 键指定。 脚本也可以指定为 [Bash 任务](https://docs.microsoft.com/en-us/azure/devops/pipelines/tasks/utility/bash?view=azure-devops)或 [PowerShell 任务](https://docs.microsoft.com/en-us/azure/devops/pipelines/tasks/utility/powershell?view=azure-devops)的输入。 - -在 {% data variables.product.prodname_actions %} 中，所有脚本都使用 `run` 键来指定。 要选择特定的 shell，您可以在提供脚本时指定 `shell` 键。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)”。 - -下面是每个系统的语法示例： - - - - - - - - - - -
    -Azure Pipelines - -{% data variables.product.prodname_actions %} -
    -{% raw %} -```yaml -jobs: -- job: scripts - pool: - vmImage: 'windows-latest' - steps: - - script: echo "This step runs in the default shell" - - bash: echo "This step runs in bash" - - pwsh: Write-Host "This step runs in PowerShell Core" - - task: PowerShell@2 - inputs: - script: Write-Host "This step runs in PowerShell" -``` -{% endraw %} - -{% raw %} -```yaml -jobs: - scripts: - runs-on: windows-latest - steps: - - run: echo "This step runs in the default shell" - - run: echo "This step runs in bash" - shell: bash - - run: Write-Host "This step runs in PowerShell Core" - shell: pwsh - - run: Write-Host "This step runs in PowerShell" - shell: powershell -``` -{% endraw %} -
    - -### 脚本错误处理中的差异 - -在 Azure Pipelines 中，脚本可配置为有任何输出发送到 `stderr` 时出错。 {% data variables.product.prodname_actions %} 不支持此配置。 - -{% data variables.product.prodname_actions %} 尽可能将 shell 配置为“快速失败”，如果脚本中的一个命令退出并有错误代码，则会立即停止脚本。 相反，Azure Pipelines 需要明确配置为在出错时立即退出。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/reference/workflow-syntax-for-github-actions#exit-codes-and-error-action-preference)”。 - -### Windows 上默认 shell 的差异 - -在 Azure Pelines 中，Windows 平台上脚本的默认 shell 是命令 shell (_cmd.exe_)。 在 {% data variables.product.prodname_actions %} 中，Windows 平台上脚本的默认 shell 是 PowerShell 。 PowerShell 在内置命令、变量扩展和流控制方面存在若干差异。 - -如果您运行的是简单的命令，则可以在 PowerShell 中运行命令 shell 脚本，而无需进行任何更改。 但在大多数情况下，您需要使用 PowerShell 语法更新脚本，或者指示 {% data variables.product.prodname_actions %} 使用命令 shell 而不是 PowerShell 来运行脚本。 您可以通过将 `shell` 指定为 `Cmd` 来完成。 - -下面是每个系统的语法示例： - - - - - - - - - - -
    -Azure Pipelines - -{% data variables.product.prodname_actions %} -
    -{% raw %} -```yaml -jobs: -- job: run_command - pool: - vmImage: 'windows-latest' - steps: - - script: echo "This step runs in CMD on Windows by default" -``` -{% endraw %} - -{% raw %} -```yaml -jobs: - run_command: - runs-on: windows-latest - steps: - - run: echo "This step runs in PowerShell on Windows by default" - - run: echo "This step runs in CMD on Windows explicitly" - shell: cmd -``` -{% endraw %} -
    - -更多信息请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/reference/workflow-syntax-for-github-actions#using-a-specific-shell)”。 - -### 迁移条件和表达式语法 - -Azure Pipelines 和 {% data variables.product.prodname_actions %} 可以有条件地运行步骤。 在 Azure Pipelines 中，使用 `condition` 键指定条件表达式。 在 {% data variables.product.prodname_actions %} 中，条件表达式使用 `if` 键来指定。 - -Azure Pelines 使用表达式中的函数来有条件地执行步骤。 相反，{% data variables.product.prodname_actions %} 使用 infix 表示法。 例如，必须将 Azure Pipelines 中的 `eq` 函数替换为 {% data variables.product.prodname_actions %} 中的 `==` 运算符。 - -下面是每个系统的语法示例： - - - - - - - - - - -
    -Azure Pipelines - -{% data variables.product.prodname_actions %} -
    -{% raw %} -```yaml -jobs: -- job: conditional - pool: - vmImage: 'ubuntu-latest' - steps: - - script: echo "This step runs with str equals 'ABC' and num equals 123" - condition: and(eq(variables.str, 'ABC'), eq(variables.num, 123)) -``` -{% endraw %} - -{% raw %} -```yaml -jobs: - conditional: - runs-on: ubuntu-latest - steps: - - run: echo "This step runs with str equals 'ABC' and num equals 123" - if: ${{ env.str == 'ABC' && env.num == 123 }} -``` -{% endraw %} -
    - -更多信息请参阅“[{% data variables.product.prodname_actions %} 的上下文和表达式语法](/actions/reference/context-and-expression-syntax-for-github-actions)”。 - -### 作业之间的依赖关系 - -Azure Pipelines 和 {% data variables.product.prodname_actions %} 允许您为作业设置依赖项。 在这两个系统中，默认情况下作业并行运行，但可以明确指定作业依赖项。 在 Azure Pipelines 中，这通过 `dependsOn` 键来完成。 在 {% data variables.product.prodname_actions %} 中，这通过 `needs` 键来完成。 - -下面是每个系统的语法示例： 工作流程启动第一个名为 `initial` 的作业，当该作业完成时，两个分别名为 `fanout1` 和 `fanout2` 的作业将会运行。 最后，当这些作业完成后，作业 `fanin` 将会运行。 - - - - - - - - - - -
    -Azure Pipelines - -{% data variables.product.prodname_actions %} -
    -{% raw %} -```yaml -jobs: -- job: initial - pool: - vmImage: 'ubuntu-latest' - steps: - - script: echo "This job will be run first." -- job: fanout1 - pool: - vmImage: 'ubuntu-latest' - dependsOn: initial - steps: - - script: echo "This job will run after the initial job, in parallel with fanout2." -{% raw %} -```yaml -jobs: -- job: initial - pool: - vmImage: 'ubuntu-latest' - steps: - - script: echo "This job will be run first." -- job: fanout1 - pool: - vmImage: 'ubuntu-latest' - dependsOn: initial - steps: - - script: echo "This job will run after the initial job, in parallel with fanout2." -- job: fanout2 - pool: - vmImage: 'ubuntu-latest' - dependsOn: initial - steps: - - script: echo "This job will run after the initial job, in parallel with fanout1." -- job: fanin: - pool: - vmImage: 'ubuntu-latest' - dependsOn: [fanout1, fanout2] - steps: - - script: echo "This job will run after fanout1 and fanout2 have finished." -``` -{% endraw %} -- job: fanin: - pool: - vmImage: 'ubuntu-latest' - dependsOn: [fanout1, fanout2] - steps: - - script: echo "This job will run after fanout1 and fanout2 have finished." -``` -{% endraw %} - -{% raw %} -```yaml -jobs: - initial: - runs-on: ubuntu-latest - steps: - - run: echo "This job will be run first." - fanout1: - runs-on: ubuntu-latest - needs: initial - steps: - - run: echo "This job will run after the initial job, in parallel with fanout2." - {% raw %} -```yaml -jobs: - initial: - runs-on: ubuntu-latest - steps: - - run: echo "This job will be run first." - fanout1: - runs-on: ubuntu-latest - needs: initial - steps: - - run: echo "This job will run after the initial job, in parallel with fanout2." - fanout2: - runs-on: ubuntu-latest - needs: initial - steps: - - run: echo "This job will run after the initial job, in parallel with fanout1." - fanin: - runs-on: ubuntu-latest - needs: [fanout1, fanout2] - steps: - - run: echo "This job will run after fanout1 and fanout2 have finished." -``` -{% endraw %} - fanin: - runs-on: ubuntu-latest - needs: [fanout1, fanout2] - steps: - - run: echo "This job will run after fanout1 and fanout2 have finished." -``` -{% endraw %} -
    - -更多信息请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)”。 - -### 将任务迁移到操作 - -Azure Pipelines 使用_任务_，这是可在多个工作流程中重复使用的应用程序组件。 {% data variables.product.prodname_actions %} 使用 _操作_，这可用于执行任务和自定义工作流程。 在这两个系统中，您可以指定要运行的任务或操作的名称，以及任何必需的输入作为键/值对。 - -下面是每个系统的语法示例： - - - - - - - - - - -
    -Azure Pipelines - -{% data variables.product.prodname_actions %} -
    -{% raw %} -```yaml -jobs: -- job: run_python - pool: - vmImage: 'ubuntu-latest' - steps: - - task: UsePythonVersion@0 - inputs: - versionSpec: '3.7' - architecture: 'x64' - - script: python script.py -``` -{% endraw %} - -{% raw %} -```yaml -jobs: - run_python: - runs-on: ubuntu-latest - steps: - - uses: actions/setup-python@v2 - with: - python-version: '3.7' - architecture: 'x64' - - run: python script.py -``` -{% endraw %} -
    - -您可以在 [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace?type=actions) 中找到可用于工作流程的操作，也可以创建自己的操作。 更多信息请参阅“[创建操作](/actions/creating-actions)”。 - diff --git a/translations/zh-CN/content/actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions.md b/translations/zh-CN/content/actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions.md deleted file mode 100644 index 740c992870ca..000000000000 --- a/translations/zh-CN/content/actions/migrating-to-github-actions/migrating-from-circleci-to-github-actions.md +++ /dev/null @@ -1,445 +0,0 @@ ---- -title: 从 CircleCI 迁移到 GitHub 操作 -intro: GitHub 操作和 CircleCI 在配置上具有若干相似之处，这使得迁移到 GitHub 操作相对简单。 -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### 简介 - -CircleCI 和 {% data variables.product.prodname_actions %} 都允许您创建能自动构建、测试、发布、发行和部署代码的工作流程。 CircleCI 和 {% data variables.product.prodname_actions %} 的工作流程配置有一些相似之处： - -- 工作流程配置文件以 YAML 编写并存储在仓库中。 -- 工作流程包括一项或多项作业。 -- 作业包括一个或多个步骤或单个命令。 -- 步骤或任务可以重复使用并与社区共享。 - -更多信息请参阅“[{% data variables.product.prodname_actions %} 的核心概念](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)”。 - -### 主要差异 - -从 CircleCI 迁移时，考虑以下差异： - -- CircleCI 的自动测试并行性根据用户指定的规则或历史计时信息自动对测试进行分组。 此功能未内置于 {% data variables.product.prodname_actions %}。 -- 在 Docker 容器中执行的操作对权限问题很敏感，因为容器具有不同的用户映射。 您可以通过在 *Dockerfile* 中不使用 `USER` 指令来避免这些问题。 有关 Docker 文件系统的更多信息，请参阅“[ {% data variables.product.product_name %} 托管运行器的虚拟环境](/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem)”。 - -### 迁移工作流程和作业 - -CircleCI 在 *config.yml* 文件中定义 `workflows`，允许您配置多个工作流程。 {% data variables.product.product_name %} 对每个工作流程需要一个工作流程文件，因此不要求您声明 `workflows`。 您需要为 *config.yml* 中配置的每个工作流程创建一个新的工作流程文件。 - -CircleCI 和 {% data variables.product.prodname_actions %} 在配置文件中使用相似的语法配置 `jobs`。 如果在 CircleCI 工作流程中使用 `requires` 配置作业之间的任何依赖项，您可以使用等效的 {% data variables.product.prodname_actions %} `needs` 语法。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idneeds)”。 - -### 将 orbs 迁移到操作 - -CircleCI 和 {% data variables.product.prodname_actions %} 都提供在工作流程中重复使用和共享任务的机制。 CircleCI 使用以 YAML 编写的概念 orbs 来提供人们可以在工作流程中重复使用的任务。 {% data variables.product.prodname_actions %} 具有强大而灵活的可重复使用的组件，称为“操作”，您可以使用 JavaScript 文件或 Docker 映像来构建操作。 您可以编写自定义代码来创建操作，以您喜欢的方式与仓库交互，包括使用 {% data variables.product.product_name %} 的 API 以及任何公开的第三方 API 进行交互。 例如，操作可以发布 npm 模块、在创建紧急议题时发送短信提醒，或者部署可用于生产的代码。 更多信息请参阅“[创建操作](/actions/creating-actions)”。 - -CircleCI 可以使用 YAML 锚点和别名来重复使用工作流程的组件。 {% data variables.product.prodname_actions %} 支持对于重复使用构建矩阵的最常见需求。 有关构建矩阵的更多信息，请参阅“[配置工作流程](/actions/configuring-and-managing-workflows/configuring-a-workflow#configuring-a-build-matrix)。 - -### 使用 Docker 映像 - - -CircleCI 和 {% data variables.product.prodname_actions %} 都支持在 Docker 映像中运行步骤。 - -CircleCI 提供一套具有共同依赖项的预建映像。 这些映像的 `USER` 设置为 `circleci`，会导致权限与 {% data variables.product.prodname_actions %} 冲突。 - -建议在迁移到 {% data variables.product.prodname_actions %} 时不使用 CircleCI 的预建映像。 在许多情况下，您可以使用操作来安装需要的附加依赖项。 - -有关 Docker 文件系统的更多信息，请参阅“[ {% data variables.product.product_name %} 托管运行器的虚拟环境](/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem)”。 - -有关 {% data variables.product.prodname_dotcom %} 托管的虚拟环境中可用的工具和软件包的更多信息，请参阅“[GitHub 托管的运行器上安装的软件](/actions/reference/software-installed-on-github-hosted-runners)”。 - -### 使用变量和密码 - -CircleCI 和 {% data variables.product.prodname_actions %} 支持在配置文件中设置环境变量，并使用 CircleCI 或 {% data variables.product.product_name %} UI 创建密码。 - -更多信息请参阅“[使用环境变量](/actions/configuring-and-managing-workflows/using-environment-variables)”和“[创建和使用加密密码](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)”。 - -### 缓存 - -CircleCI 和 {% data variables.product.prodname_actions %} 提供在配置文件中手动缓存文件的方法。 - -下面是每个系统的语法示例： - - - - - - - - - - -
    -CircleCI - -GitHub Actions -
    -{% raw %} -```yaml -- restore_cache: - keys: - - v1-npm-deps-{{ checksum "package-lock.json" }} - - v1-npm-deps- -``` -{% endraw %} - -{% raw %} -```yaml -- name: Cache node modules - uses: actions/cache@v2 - with: - path: ~/.npm - key: v1-npm-deps-${{ hashFiles('**/package-lock.json') }} - restore-keys: v1-npm-deps- -``` -{% endraw %} -
    - -更多信息请参阅“[缓存依赖项以加快工作流程](/actions/configuring-and-managing-workflows/caching-dependencies-to-speed-up-workflows)”。 - -{% data variables.product.prodname_actions %} 没有 CircleCI 的 Docker 层缓存（或 DLC）的等效项。 - -### 在作业之间保持数据 - -CircleCI 和 {% data variables.product.prodname_actions %} 提供在作业之间保持数据的机制。 - -下面是 CircleCI 和 {% data variables.product.prodname_actions %} 配置语法中的示例。 - - - - - - - - - - -
    -CircleCI - -GitHub Actions -
    -{% raw %} -```yaml -- persist_to_workspace: - root: workspace - paths: - - math-homework.txt - -... - -- attach_workspace: - at: /tmp/workspace -``` -{% endraw %} - -{% raw %} -```yaml -- name: Upload math result for job 1 - uses: actions/upload-artifact@v2 - with: - name: homework - path: math-homework.txt - -... - -- name: Download math result for job 1 - uses: actions/download-artifact@v2 - with: - name: homework -``` -{% endraw %} -
    - -更多信息请参阅“[使用构件持久化工作流程](/actions/configuring-and-managing-workflows/persisting-workflow-data-using-artifacts)”。 - -### 使用数据库和服务容器 - -这两个系统都允许您包括用于数据库、缓存或其他依赖项的其他容器。 - -在 CircleCI 中，*config.yaml* 中列出的第一个映像是用于运行命令的主要映像。 {% data variables.product.prodname_actions %} 使用明确的区域： `container` 用于主容器，并在 `services` 中列出附加容器。 - -下面是 CircleCI 和 {% data variables.product.prodname_actions %} 配置语法中的示例。 - - - - - - - - - - -
    -CircleCI - -GitHub Actions -
    -{% raw %} -```yaml ---- -version: 2.1 - -jobs: - - ruby-26: - docker: - - image: circleci/ruby:2.6.3-node-browsers-legacy - environment: - PGHOST: localhost - PGUSER: administrate - RAILS_ENV: test - - image: postgres:10.1-alpine - environment: - POSTGRES_USER: administrate - POSTGRES_DB: ruby26 - POSTGRES_PASSWORD: "" - - working_directory: ~/administrate - - steps: - - checkout - - # Bundle install dependencies - - run: bundle install --path vendor/bundle - - # Wait for DB - - run: dockerize -wait tcp://localhost:5432 -timeout 1m - - # Setup the environment - - run: cp .sample.env .env - - # Setup the database - - run: bundle exec rake db:setup - - # Run the tests - - run: bundle exec rake - - -workflows: - version: 2 - build: - jobs: - - ruby-26 -... - -- attach_workspace: - at: /tmp/workspace -``` -{% endraw %} - -{% raw %} -```yaml -name: Containers - -on: [push] - -jobs: - build: - - runs-on: ubuntu-latest - container: circleci/ruby:2.6.3-node-browsers-legacy - - env: - PGHOST: postgres - PGUSER: administrate - RAILS_ENV: test - - services: - postgres: - image: postgres:10.1-alpine - env: - POSTGRES_USER: administrate - POSTGRES_DB: ruby25 - POSTGRES_PASSWORD: "" - ports: - - 5432:5432 - # Add a health check - options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 5 - - steps: - # This Docker file changes sets USER to circleci instead of using the default user, so we need to update file permissions for this image to work on GH Actions. - # See https://docs.github.com/actions/reference/virtual-environments-for-github-hosted-runners#docker-container-filesystem - - name: Setup file system permissions - run: sudo chmod -R 777 $GITHUB_WORKSPACE /github /__w/_temp - - uses: actions/checkout@v2 - - name: Install dependencies - run: bundle install --path vendor/bundle - - name: Setup environment configuration - run: cp .sample.env .env - - name: Setup database - run: bundle exec rake db:setup - - name: Run tests - run: bundle exec rake -``` -{% endraw %} -
    - -更多信息请参阅“[关于服务容器](/actions/configuring-and-managing-workflows/about-service-containers)”。 - -### 完整示例 - -下面是一个真实的示例。 左边显示用于 [thoughtbot/administrator](https://github.com/thoughtbot/administrate) 仓库的实际 CircleCI *config.yml*。 右边显示 {% data variables.product.prodname_actions %} 等效项。 - - - - - - - - - - -
    -CircleCI - -GitHub Actions -
    -{% raw %} -```yaml ---- -version: 2.1 - -commands: - shared_steps: - steps: - - checkout - - # Restore Cached Dependencies - - restore_cache: - name: Restore bundle cache - key: administrate-{{ checksum "Gemfile.lock" }} - - # Bundle install dependencies - - run: bundle install --path vendor/bundle - - # Cache Dependencies - - save_cache: - name: Store bundle cache - key: administrate-{{ checksum "Gemfile.lock" }} - paths: - - vendor/bundle - - # Wait for DB - - run: dockerize -wait tcp://localhost:5432 -timeout 1m - - # Setup the environment - - run: cp .sample.env .env - - # Setup the database - - run: bundle exec rake db:setup - - # Run the tests - - run: bundle exec rake - -default_job: &default_job - working_directory: ~/administrate - steps: - - shared_steps - # Run the tests against multiple versions of Rails - - run: bundle exec appraisal install - - run: bundle exec appraisal rake - -jobs: - ruby-25: - <<: *default_job - docker: - - image: circleci/ruby:2.5.0-node-browsers - environment: - PGHOST: localhost - PGUSER: administrate - RAILS_ENV: test - - image: postgres:10.1-alpine - environment: - POSTGRES_USER: administrate - POSTGRES_DB: ruby25 - POSTGRES_PASSWORD: "" - - ruby-26: - <<: *default_job - docker: - - image: circleci/ruby:2.6.3-node-browsers-legacy - environment: - PGHOST: localhost - PGUSER: administrate - RAILS_ENV: test - - image: postgres:10.1-alpine - environment: - POSTGRES_USER: administrate - POSTGRES_DB: ruby26 - POSTGRES_PASSWORD: "" - - -workflows: - version: 2 - multiple-rubies: - jobs: - - ruby-26 - - ruby-25 -``` -{% endraw %} - -{% raw %} -```yaml -name: Containers - -on: [push] - -jobs: - build: - - strategy: - matrix: - ruby: [2.5, 2.6.3] - - runs-on: ubuntu-latest - - env: - PGHOST: localhost - PGUSER: administrate - RAILS_ENV: test - - services: - postgres: - image: postgres:10.1-alpine - env: - POSTGRES_USER: administrate - POSTGRES_DB: ruby25 - POSTGRES_PASSWORD: "" - ports: - - 5432:5432 - # Add a health check - options: --health-cmd pg_isready --health-interval 10s --health-timeout 5s --health-retries 5 - - steps: - - uses: actions/checkout@v2 - - name: Setup Ruby - uses: eregon/use-ruby-action@master - with: - ruby-version: ${{ matrix.ruby }} - - name: Cache dependencies - uses: actions/cache@v2 - with: - path: vendor/bundle - key: administrate-${{ matrix.image }}-${{ hashFiles('Gemfile.lock') }} - - name: Install postgres headers - run: sudo apt-get install libpq-dev - - name: Install dependencies - run: bundle install --path vendor/bundle - - name: Setup environment configuration - run: cp .sample.env .env - - name: Setup database - run: bundle exec rake db:setup - - name: Run tests - run: bundle exec rake - - name: Install appraisal - run: bundle exec appraisal install - - name: Run appraisal - run: bundle exec appraisal rake -``` -{% endraw %} -
    diff --git a/translations/zh-CN/content/actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions.md b/translations/zh-CN/content/actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions.md deleted file mode 100644 index f380208e6fa0..000000000000 --- a/translations/zh-CN/content/actions/migrating-to-github-actions/migrating-from-jenkins-to-github-actions.md +++ /dev/null @@ -1,291 +0,0 @@ ---- -title: 从 Jenkins 迁移到 GitHub 操作 -intro: '{% data variables.product.prodname_actions %} 和 Jenkins 有多种相似之处，这使得迁移到 {% data variables.product.prodname_actions %} 相对简单。' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### 简介 - -Jenkins 和 {% data variables.product.prodname_actions %} 都允许您创建能自动构建、测试、发布、发行和部署代码的工作流程。 Jenkins 和 {% data variables.product.prodname_actions %} 的工作流程配置有一些相似之处： - -- Jenkins 使用 _Declarative Pelines_ 创建工作流程，这些工作流程类似于 {% data variables.product.prodname_actions %} 工作流程文件。 -- Jenkins 使用_阶段_运行步骤集合，而 {% data variables.product.prodname_actions %} 则使用作业来分组一个或多个步骤或单个命令。 -- Jenkins 和 {% data variables.product.prodname_actions %} 支持基于容器的构建。 更多信息请参阅“[创建 Docker 容器操作](/articles/creating-a-docker-container-action)”。 -- 步骤或任务可以重复使用并与社区共享。 - -更多信息请参阅“[{% data variables.product.prodname_actions %} 的核心概念](/actions/getting-started-with-github-actions/core-concepts-for-github-actions)”。 - -### 主要差异 - -- Jenkins 有两种类型的语法用来创建管道：Declarative Pipeline 和 Scripted Pipeline。 {% data variables.product.prodname_actions %} 使用 YAML 创建工作流程和配置文件。 更多信息请参阅“[GitHub 操作的工作流程语法](/actions/reference/workflow-syntax-for-github-actions)”。 -- Jenkins 部署通常是自托管的，用户在自己的数据中心维护服务器。 {% data variables.product.prodname_actions %} 通过托管自己可用于运行作业的运行器提供混合云方法，同时也支持自托管运行器。 更多信息请参阅“[关于自托管运行器](/actions/hosting-your-own-runners/about-self-hosted-runners)”。 - -### 比较功能 - -#### 分发版本 - -Jenkins 可让您发送版本到单个构建代理，或者您可以在多个代理之间进行分发。 您也可以根据不同的属性（例如操作系统类型）对这些代理进行分类。 - -同样， {% data variables.product.prodname_actions %} 可以向 {% data variables.product.prodname_dotcom %} 托管或自托管的运行器发送作业，您可以根据不同的属性使用标签对运行器分类。 下表比较了如何对 Jenkins 和 {% data variables.product.prodname_actions %} 实施分布式构建概念。 - -| Jenkins | {% data variables.product.prodname_actions %} | -| ---------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [`agents`](https://wiki.jenkins.io/display/JENKINS/Distributed+builds) | [`runners`](/actions/getting-started-with-github-actions/core-concepts-for-github-actions#runner)
    [`self-hosted runners`](/actions/hosting-your-own-runners/about-self-hosted-runners) | - -#### 使用区段组织管道 - -Jenkins 将其 Declarative Pipelines 分为多个区段。 同样，{% data variables.product.prodname_actions %} 也将其工作流程分成单独的部分。 下表比较了Jenkins 区段与 {% data variables.product.prodname_actions %} 工作流程。 - -| Jenkins 指令 | {% data variables.product.prodname_actions %} | -| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| [`agent`](https://jenkins.io/doc/book/pipeline/syntax/#agent) | [`jobs..runs-on`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idruns-on)
    [`jobs..container`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idcontainer) | -| [`post`](https://jenkins.io/doc/book/pipeline/syntax/#post) | | -| [`stages`](https://jenkins.io/doc/book/pipeline/syntax/#stages) | [`jobs`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobs) | -| [`steps`](https://jenkins.io/doc/book/pipeline/syntax/#steps) | [`jobs..steps`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idsteps) | - - -### 使用指令 - -Jenkins 使用指令来管理 _Declarative Pipelines_。 这些指令定义工作流程的特性及其执行方式。 下表演示这些指令如何映射到 {% data variables.product.prodname_actions %} 中的概念。 - -| Jenkins 指令 | {% data variables.product.prodname_actions %} | -| ------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [`environment`](https://jenkins.io/doc/book/pipeline/syntax/#environment) | [`jobs..env`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#env)
    [`jobs..steps.env`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsenv) | -| [`options`](https://jenkins.io/doc/book/pipeline/syntax/#parameters) | [`jobs..strategy`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategy)
    [`jobs..strategy.fail-fast`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategyfail-fast)
    [`jobs..timeout-minutes`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idtimeout-minutes) | -| [`parameters`](https://jenkins.io/doc/book/pipeline/syntax/#parameters) | [`inputs`](/actions/creating-actions/metadata-syntax-for-github-actions#inputs)
    [`outputs`](/actions/creating-actions/metadata-syntax-for-github-actions#outputs) | -| [`triggers`](https://jenkins.io/doc/book/pipeline/syntax/#triggers) | [`on`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#on)
    [`on..types`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onevent_nametypes)
    [on..](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onpushpull_requestbranchestags)
    [on..paths](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onpushpull_requestpaths) | -| [`triggers { upstreamprojects() }`](https://jenkins.io/doc/book/pipeline/syntax/#triggers) | [`jobs..needs`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idneeds) | -| [Jenkins cron syntax](https://jenkins.io/doc/book/pipeline/syntax/#cron-syntax) | [`on.schedule`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#onschedule) | -| [`阶段，暂存`](https://jenkins.io/doc/book/pipeline/syntax/#stage) | [`jobs.`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_id)
    [`jobs..name`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idname) | -| [`tools`](https://jenkins.io/doc/book/pipeline/syntax/#tools) | [在 GitHub 托管的运行器上安装的软件](/actions/reference/software-installed-on-github-hosted-runners) | -| [`input`](https://jenkins.io/doc/book/pipeline/syntax/#input) | [`inputs`](/actions/automating-your-workflow-with-github-actions/metadata-syntax-for-github-actions#inputs) | -| [`when`](https://jenkins.io/doc/book/pipeline/syntax/#when) | [`jobs..if`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idif) | - - -### 使用连续阶段 - -#### 并行作业处理 - -Jenkins 可以并行运行 `stages` 和 `steps`，而 {% data variables.product.prodname_actions %} 目前只能并行运行作业。 - -| Jenkins Parallel | {% data variables.product.prodname_actions %} | -| ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [`parallel`](https://jenkins.io/doc/book/pipeline/syntax/#parallel) | [`jobs..strategy.max-parallel`](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymax-parallel) | - -#### 构建矩阵 - -{% data variables.product.prodname_actions %} 和 Jenkins 都允许您使用构建矩阵来定义各种系统组合。 - -| Jenkins | {% data variables.product.prodname_actions %} | -| ------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [`axis`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-axes) | [`strategy/matrix`](/actions/configuring-and-managing-workflows/configuring-a-workflow#configuring-a-build-matrix)
    [`context`](/actions/reference/context-and-expression-syntax-for-github-actions) | -| [`stages`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-stages) | [`steps-context`](/actions/reference/context-and-expression-syntax-for-github-actions#steps-context) | -| [`excludes`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-stages) | | - -#### 使用步骤执行任务 - -Jenkins 将 `steps` 组织在 `stages`。 每个步骤都可以是脚本、函数或命令等。 同样， {% data variables.product.prodname_actions %} 使用 `job` 来执行特定的 `steps` 组。 - -| Jenkins 步骤 | {% data variables.product.prodname_actions %} | -| --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | -| [`script`](https://jenkins.io/doc/book/pipeline/syntax/#script) | [`jobs..steps`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idsteps) | - -### 常见任务示例 - -#### 计划与 `cron` 一起运行的管道 - - - - - - - - - - -
    -Jenkins Pipeline - -{% data variables.product.prodname_actions %} 工作流程 -
    - - ```yaml - pipeline { - agent any - triggers { - cron('H/15 * * * 1-5') - } - } - ``` - - - - ```yaml - on: - schedule: - - cron: '*/15 * * * 1-5' - ``` - -
    - -#### 配置管道中的环境变量 - - - - - - - - - - -
    -Jenkins Pipeline - -{% data variables.product.prodname_actions %} 工作流程 -
    - - ```yaml - pipeline { - agent any - environment { - MAVEN_PATH = '/usr/local/maven' - } - } - ``` - - - - ```yaml - jobs: - maven-build: - env: - MAVEN_PATH: '/usr/local/maven' - - ``` - -
    - -#### 从上游项目构建 - - - - - - - - - - -
    -Jenkins Pipeline - -{% data variables.product.prodname_actions %} 工作流程 -
    - - ```yaml - pipeline { - triggers { - upstream( - upstreamProjects: 'job1,job2', - threshold: hudson.model.Result.SUCCESS) - } - } - } - - ``` - - - - ```yaml - jobs: - job1: - job2: - needs: job1 - job3: - needs: [job1, job2] - - ``` - -
    - -#### 使用多个操作系统构建 - - - - - - - - - - -
    -Jenkins Pipeline - -{% data variables.product.prodname_actions %} 工作流程 -
    - - ```yaml -pipeline { - agent none - stages { - stage('Run Tests') { - parallel { - stage('Test On MacOS') { - agent { label "macos" } - tools { nodejs "node-12" } - steps { - dir("scripts/myapp") { - sh(script: "npm install -g bats") - sh(script: "bats tests") - } - } - } - stage('Test On Linux') { - agent { label "linux" } - tools { nodejs "node-12" } - steps { - dir("script/myapp") { - sh(script: "npm install -g bats") - sh(script: "bats tests") - } - } - } - } - } - } -} - ``` - - - -{% raw %} - ```yaml - name: demo-workflow - on: - push: - jobs: - test: - runs-on: ${{ matrix.os }} - strategy: - fail-fast: false - matrix: - os: [macos-latest, ubuntu-latest] - steps: - - uses: actions/checkout@v1 - - uses: actions/setup-node@v1 - with: - node-version: 12 - - run: npm install -g bats - - run: bats tests - working-directory: scripts/myapp - ``` -{% endraw %} - -
    diff --git a/translations/zh-CN/content/actions/publishing-packages-with-github-actions/about-packaging-with-github-actions.md b/translations/zh-CN/content/actions/publishing-packages-with-github-actions/about-packaging-with-github-actions.md deleted file mode 100644 index 0dcf0c0e5345..000000000000 --- a/translations/zh-CN/content/actions/publishing-packages-with-github-actions/about-packaging-with-github-actions.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: 关于使用 GitHub 操作进行打包 -intro: '您可以在 {% data variables.product.prodname_actions %} 中设置工作流程生成包并将其上传到 {% data variables.product.prodname_registry %} 或其他包托管提供程序。' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/about-packaging-with-github-actions -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### 关于打包步骤 - -打包步骤是持续集成或持续交付工作流程的常见部分。 构建并测试应用程序后，将以包的形式生成可运行或可部署的构件。 例如，Java 项目的连续集成工作流程可能运行 `mvn package` 来生成 JAR 文件。 或者，Node.js 应用程序的 CI 工作流程可能会创建 Docker 容器。 - -根据您构建的应用程序类型，此包可本地下载以进行手动测试、可供用户下载或部署到暂存或生产环境。 - -### 持续集成工作流程中的打包 - -在持续集成工作流程结束时创建包有助于拉取请求的代码审查。 构建并测试代码后，打包步骤可以生成可运行或可部署的构件。 然后，您的工作流程可提取该构件并将其上传为工作流程的一部分。 - -现在，在审查拉取请求时，您将能够查看工作流程运行并下载生成的构件。 - -![下载构件下拉菜单](/assets/images/help/repository/artifact-drop-down.png) - -这将允许您在计算机上运行拉取请求中的代码，有助于调试或测试拉取请求。 - -### 发布包的工作流程 - -除了上传打包构件以测试持续集成工作流程之外， 您还可以创建工作流程来构建项目并发布包到软件包注册表。 - -* **将包发布到 {% data variables.product.prodname_registry %}** - {% data variables.product.prodname_registry %} 可以充当多类软件包的软件包托管服务。 您可以选择与所有 {% data variables.product.prodname_dotcom %} 共享您的软件包，或者与合作者或组织共享私有软件包。 更多信息请参阅“[关于 {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/about-github-packages)”。 - - 每次推送到主分支，您可能想将软件包发布到 {% data variables.product.prodname_registry %}。 这可让项目开发者始终能够通过从 {% data variables.product.prodname_registry %} 安装，很容易地运行和测试主版本中的最新构建版本。 - -* **将软件包发布到软件包注册表** 对于许多项目，每当发布项目的新版本时，都会执行发布到软件包注册表。 例如，生成 JAR 文件的项目可能会将新版本上传到 Maven Central 仓库。 或者，.NET 项目可能会生成一个微件包并上传到 Nuget Gallery。 - - 您可以创建一个工作流程来自动执行此操作，在每次创建版本时将软件包发布到软件包注册表。 更多信息请参阅“[创建发行版](/github/administering-a-repository/creating-releases)”。 - -### 延伸阅读 - -- "[发布 Node.js 包](/actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages)" diff --git a/translations/zh-CN/content/actions/publishing-packages-with-github-actions/index.md b/translations/zh-CN/content/actions/publishing-packages-with-github-actions/index.md deleted file mode 100644 index 1fea544042ee..000000000000 --- a/translations/zh-CN/content/actions/publishing-packages-with-github-actions/index.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: 使用 GitHub 操作发布包 -shortTitle: 发布包 -intro: '创建包并将其发布到 {% data variables.product.prodname_registry %} 或其他包托管提供程序。' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -{% link_in_list /about-packaging-with-github-actions %} diff --git a/translations/zh-CN/content/actions/reference/software-installed-on-github-hosted-runners.md b/translations/zh-CN/content/actions/reference/software-installed-on-github-hosted-runners.md deleted file mode 100644 index e418a6345a85..000000000000 --- a/translations/zh-CN/content/actions/reference/software-installed-on-github-hosted-runners.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: 在 GitHub 托管的运行器上安装的软件 -intro: '本文链接到 {% data variables.product.prodname_dotcom %} 托管的虚拟环境中可用包和工具的参考。' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/software-in-virtual-environments-for-github-actions - - /github/automating-your-workflow-with-github-actions/software-in-virtual-environments-for-github-actions - - /github/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners - - /actions/automating-your-workflow-with-github-actions/software-installed-on-github-hosted-runners -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -{% data variables.product.prodname_dotcom %} 托管的运行器中包含的工具每周更新。 有关每个运行器操作系统包含的工具最新列表，请参阅以下链接： - -* [Ubuntu 20.04 LTS](https://github.com/actions/virtual-environments/blob/master/images/linux/Ubuntu2004-README.md) -* [Ubuntu 18.04 LTS](https://github.com/actions/virtual-environments/blob/master/images/linux/Ubuntu1804-README.md) -* [Ubuntu 16.04 LTS](https://github.com/actions/virtual-environments/blob/master/images/linux/Ubuntu1604-README.md) -* [Windows Server 2019](https://github.com/actions/virtual-environments/blob/master/images/win/Windows2019-Readme.md) -* [Windows Server 2016](https://github.com/actions/virtual-environments/blob/master/images/win/Windows2016-Readme.md) -* [MacOS 10.15](https://github.com/actions/virtual-environments/blob/master/images/macos/macos-10.15-Readme.md) - -{% data reusables.github-actions.ubuntu-runner-preview %} - -{% data variables.product.prodname_dotcom %} 托管的运行器除了上述参考中列出的包之外，还包括操作系统的默认内置工具。 例如，Ubuntu 和 macOS 运行器除了其他默认工具之外，还包括 `grep`、`find` 和 `which`。 - -如果有您想要请求的工具，请在 [actions/virtual-environments](https://github.com/actions/virtual-environments) 打开一个议题。 diff --git a/translations/zh-CN/content/actions/reference/virtual-environments-for-github-hosted-runners.md b/translations/zh-CN/content/actions/reference/virtual-environments-for-github-hosted-runners.md deleted file mode 100644 index 515852e746e0..000000000000 --- a/translations/zh-CN/content/actions/reference/virtual-environments-for-github-hosted-runners.md +++ /dev/null @@ -1,131 +0,0 @@ ---- -title: GitHub 托管的运行器的虚拟环境 -intro: '{% data variables.product.prodname_dotcom %} 提供托管的虚拟机来运行工作流程。 虚拟机包含可供 {% data variables.product.prodname_actions %} 使用的工具、包和设置。' -product: '{% data reusables.gated-features.actions %}' -redirect_from: - - /articles/virtual-environments-for-github-actions - - /github/automating-your-workflow-with-github-actions/virtual-environments-for-github-actions - - /github/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners - - /actions/automating-your-workflow-with-github-actions/virtual-environments-for-github-hosted-runners -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -### 关于 {% data variables.product.prodname_dotcom %} 托管的运行器 - -{% data variables.product.prodname_dotcom %} 托管的运行器是由安装了 {% data variables.product.prodname_actions %} 运行器应用程序的 {% data variables.product.prodname_dotcom %} 托管的虚拟机。 {% data variables.product.prodname_dotcom %} 提供使用 Linux、Windows 和 macOS 操作系统的运行器。 - -使用 {% data variables.product.prodname_dotcom %} 托管的运行器时，设备维护和升级由您负责。 您可以直接在虚拟机上或 Docker 容器中运行工作流程。 - -可以为工作流程中的每项作业指定运行器类型。 工作流程中的每项作业都在全新的虚拟机实例中执行。 作业中的所有步骤在同一虚拟机实例中执行，让该作业中的操作使用文件系统共享信息。 - -{% data reusables.github-actions.runner-app-open-source %} - -#### {% data variables.product.prodname_dotcom %} 托管的运行器的云主机 - -{% data variables.product.prodname_dotcom %} 在 Microsoft Azure 中安装了 {% data variables.product.prodname_actions %} 运行器应用程序的 Standard_DS2_v2 虚拟机上托管 Linux 和 Windows 运行器。 {% data variables.product.prodname_dotcom %} 托管的运行器应用程序是 Azure Pipelines Agent 的复刻。 入站 ICMP 数据包被阻止用于所有 Azure 虚拟机，因此 ping 或 traceroute 命令可能无效。 有关 Standard_DS2_v2 机器资源的更多信息，请参阅 Microsoft Azure 文档中的“[Dv2 和 DSv2 系列](https://docs.microsoft.com/en-us/azure/virtual-machines/dv2-dsv2-series#dsv2-series)”。 - -{% data variables.product.prodname_dotcom %} 使用 [MacStadium](https://www.macstadium.com/) 托管 macOS 运行器。 - -#### {% data variables.product.prodname_dotcom %} 托管的运行器的管理权限 - -Linux 和 macOS 虚拟机都使用无密码的 `sudo` 运行。 在需要比当前用户更多的权限才能执行命令或安装工具时，您可以使用无需提供密码的 `sudo`。 更多信息请参阅“[Sudo 手册](https://www.sudo.ws/man/1.8.27/sudo.man.html)”。 - -Windows 虚拟机配置为以禁用了用户帐户控制 (UAC) 的管理员身份运行。 更多信息请参阅 Windows 文档中的“[用户帐户控制工作原理](https://docs.microsoft.com/en-us/windows/security/identity-protection/user-account-control/how-user-account-control-works)”。 - -### 支持的运行器和硬件资源 - -每台虚拟机都有相同的硬件资源。 - -- 2 核 CPU -- 7 GB RAM 内存 -- 14 GB SSD 硬盘空间 - -{% data reusables.github-actions.supported-github-runners %} - -{% data reusables.github-actions.ubuntu-runner-preview %} - -有关各运行器支持的软件、工具和包的列表，请参阅“[{% data variables.product.prodname_dotcom %} 托管的运行器上安装的软件](/actions/reference/software-installed-on-github-hosted-runners)”。 - -您可以查看工作流程运行的日志，以查看用于作业的确切运行器环境， 以及连接到运行器上预安装工具的链接。 更多信息请参阅“[管理工作流程运行](/actions/configuring-and-managing-workflows/managing-a-workflow-run#viewing-your-workflow-history)”。 - - -#### {% data variables.product.prodname_dotcom %} 托管的运行器的 IP 地址 - -{% note %} - -**注意：**如果使用 {% data variables.product.prodname_dotcom %} 组织或企业帐户的 IP 地址允许列表，则无法使用 {% data variables.product.prodname_dotcom %} 托管的运行器，而必须使用自托管的运行器。 更多信息请参阅“[关于自托管运行器](/actions/hosting-your-own-runners/about-self-hosted-runners)”。 - -{% endnote %} - -Windows 和 Ubuntu 运行程序托管在 Azure 中，具有与 Azure 数据中心相同的 IP 地址范围。 目前，所有 Windows 和 Ubuntu {% data variables.product.prodname_dotcom %} 托管的运行器都在以下 Azure 地区： - -- 美国东部 (`eastus`) -- 美国东部 2 (`eastus2`) -- 美国西部 2 (`westus2`) -- 美国中部 (`centralus`) -- 美国中南部 (`southcentralus`) - -Microsoft 每周通过 JSON 文件更新 Azure IP 地址范围，您可以从 [Azure IP 范围和服务标签 - 公共云](https://www.microsoft.com/en-us/download/details.aspx?id=56519)网站下载该文件。 如果需要一个允许列表来阻止未经授权访问您的内部资源，您可以使用此 IP 地址范围。 - -JSON 文件包含一个名为 `values` 的数组。 例如，在该数组内，您可以通过包含 `"AzureCloud.eastus2"` 的 `name` 和 `id` 的对象找到支持的 IP 地址。 - -您可以在 `"addressPrefixes"` 对象中找到支持的 IP 地址范围。 这是 JSON 文件的精简示例。 - -```json -{ - "changeNumber": 84, - "cloud": "Public", - "values": [ - { - "name": "AzureCloud.eastus2", - "id": "AzureCloud.eastus2", - "properties": { - "changeNumber": 33, - "region": "eastus2", - "platform": "Azure", - "systemService": "", - "addressPrefixes": [ - "13.68.0.0/17", - "13.77.64.0/18", - "13.104.147.0/25", - ... - ] - } - } - ] -} -``` - -### {% data variables.product.prodname_dotcom %} 托管的运行器上的文件系统 - -{% data variables.product.prodname_dotcom %} 在虚拟机上的特定目录中执行操作和 shell 命令。 虚拟机上的文件路径不是静态的。 使用环境变量 {% data variables.product.prodname_dotcom %} 提供 `home`、`workspace` 和 `workflow` 目录的构建文件路径。 - -| 目录 | 环境变量 | 描述 | -| --------------------- | ------------------- | -------------------------------------------------------------------------------------------------------------- | -| `home` | `HOME` | 包含用户相关的数据。 例如，此目录可能包含登录凭据。 | -| `workspace` | `GITHUB_WORKSPACE` | 在此目录中执行操作和 shell 命令。 操作可以修改此目录的内容，后续操作可以访问这些修改。 | -| `workflow/event.json` | `GITHUB_EVENT_PATH` | 触发工作流程的 web 挂钩事件的 `POST` 有效负载。 每当操作执行时，{% data variables.product.prodname_dotcom %} 都会重写此变量，以隔离操作之间的文件内容。 | - -有关 {% data variables.product.prodname_dotcom %} 为每个操作创建的环境变量列表，请参阅“[使用环境变量](/github/automating-your-workflow-with-github-actions/using-environment-variables)”。 - -#### Docker 容器文件系统 - -在 Docker 容器中运行的操作在 `/github` 路径下有静态目录。 但强烈建议使用默认环境变量在 Docker 容器中构建文件路径。 - -{% data variables.product.prodname_dotcom %} 保留 `/github` 路径前缀，并为操作创建三个目录。 - -- `/github/home` -- `/github/workspace` - {% data reusables.repositories.action-root-user-required %} -- `/github/workflow` - -{% if currentVersion == "free-pro-team@latest" %} - -### 延伸阅读 -- [[管理帐户的 {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)" - -{% endif %} diff --git a/translations/zh-CN/content/admin/articles/README.md b/translations/zh-CN/content/admin/articles/README.md deleted file mode 100644 index 249222e41fbc..000000000000 --- a/translations/zh-CN/content/admin/articles/README.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -redirect_from: - - /enterprise/admin/articles/README ---- -# 隐藏的企业管理文章 - -含 `hidden: true` 前页的企业管理文章位于此目录中。 - -有关隐藏页面的更多信息，请参阅[`内容/自述文件`](../../README.md#hidden-pages)。 diff --git a/translations/zh-CN/content/admin/articles/configuring-unified-contributions-between-github-enterprise-and-githubcom.md b/translations/zh-CN/content/admin/articles/configuring-unified-contributions-between-github-enterprise-and-githubcom.md deleted file mode 100644 index 315803417d96..000000000000 --- a/translations/zh-CN/content/admin/articles/configuring-unified-contributions-between-github-enterprise-and-githubcom.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: 在 GitHub Enterprise 和 GitHub.com 之间配置统一贡献 -intro: '作为站点管理员，如果您启用了 {% data variables.product.prodname_github_connect %}，则可以允许最终用户在他们的 {% data variables.product.prodname_dotcom_the_website %} 贡献图上查看 {% data variables.product.prodname_enterprise %} 工作的匿名贡献计数。' -hidden: true -redirect_from: - - /enterprise/admin/articles/configuring-unified-contributions-between-github-enterprise-and-github-com - - /enterprise/admin/articles/configuring-unified-contributions-between-github-enterprise-and-githubcom -versions: - enterprise-server: '*' ---- - - -在两个环境中启用 {% data variables.product.prodname_github_connect %} 和 {% data variables.product.prodname_unified_contributions %} 后，实例上的最终用户可以连接到他们的 {% data variables.product.prodname_dotcom_the_website %} 帐户，并将贡献计数从 {% data variables.product.prodname_enterprise %} 发送到 {% data variables.product.prodname_dotcom_the_website %}。 更多信息请参阅“[在 {% data variables.product.prodname_enterprise %} 和 {% data variables.product.prodname_dotcom_the_website %} 之间启用 {% data variables.product.prodname_unified_contributions %}](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/enabling-unified-contributions-between-github-enterprise-server-and-github-com)”和“[将您的 {% data variables.product.prodname_ghe_server %} 贡献发送到您的 {% data variables.product.prodname_dotcom_the_website %} 个人资料](/articles/sending-your-github-enterprise-server-contributions-to-your-github-com-profile/)”。 - -如果站点管理员禁用了该功能或开发者决定退出连接，则将删除 {% data variables.product.prodname_dotcom_the_website %} 上的 {% data variables.product.prodname_enterprise %} 贡献计数。 如果开发者在禁用它们后重新连接其个人资料，则会恢复过去 90 天的贡献计数。 - -1. 在管理 shell 中，启用 {% data variables.product.product_location_enterprise %} 上的 {% data variables.product.prodname_unified_contributions %} 配置： - ```shell - $ ghe-config 'app.github.dotcom-contributions-configurable' 'true' - $ ghe-config-apply - ``` -2. 返回到 {% data variables.product.prodname_enterprise %}。 -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.business-settings %} -{% data reusables.enterprise-accounts.github-connect-tab %} -7. 在“Users can share contribution counts to {% data variables.product.prodname_dotcom_the_website %}（用户可将贡献计数分享到 {% data variables.product.prodname_dotcom_the_website %}）”下，使用下拉菜单并单击 **Enabled（已启用）**。 -8. 重定向到 {% data variables.product.prodname_dotcom_the_website %} 之后，要将 {% data variables.product.prodname_enterprise %} 贡献帐户写入所连接的用户帐户，您必须升级 {% data variables.product.prodname_github_app %}。 {% data variables.product.prodname_dotcom_the_website %} 组织的组织管理员必须批准使用 `external_contributions` 权限来升级 {% data variables.product.prodname_github_app %}。 - diff --git a/translations/zh-CN/content/admin/articles/including-github-enterprise-contributions-in-your-githubcom-profile.md b/translations/zh-CN/content/admin/articles/including-github-enterprise-contributions-in-your-githubcom-profile.md deleted file mode 100644 index 2066485a8c92..000000000000 --- a/translations/zh-CN/content/admin/articles/including-github-enterprise-contributions-in-your-githubcom-profile.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: 在您的 GitHub.com 个人资料中包含 GitHub Enterprise 贡献 -redirect_from: - - /enterprise/admin/articles/including-github-enterprise-contributions-in-your-github-com-profile - - /enterprise/admin/articles/including-github-enterprise-contributions-in-your-githubcom-profile -intro: '您可以将 {% data variables.product.product_location_enterprise %} 连接到 {% data variables.product.prodname_dotcom_the_website %}，并使最终用户能够将贡献作为已关闭的早期使用计划的一部分从 {% data variables.product.product_location_enterprise %} 发送到他们的 {% data variables.product.prodname_dotcom_the_website %} 个人资料。' -hidden: true -versions: - enterprise-server: '*' ---- - -在您的 {% data variables.product.prodname_dotcom_the_website %} 个人资料中包含 {% data variables.product.prodname_enterprise %} 贡献是 {% data variables.product.prodname_enterprise %} 2.14 的已关闭早期使用计划的一部分。 更多信息请参阅“[在您的 {% data variables.product.prodname_dotcom_the_website %} 个人资料中包含 {% data variables.product.prodname_enterprise %}](/enterprise/2.14/admin/hidden/including-github-enterprise-contributions-in-your-github-com-profile/)”。 diff --git a/translations/zh-CN/content/admin/articles/using-github-task-runner.md b/translations/zh-CN/content/admin/articles/using-github-task-runner.md deleted file mode 100644 index 6a7eceddf771..000000000000 --- a/translations/zh-CN/content/admin/articles/using-github-task-runner.md +++ /dev/null @@ -1,109 +0,0 @@ ---- -title: 使用 GitHub Task Runner -intro: '您可以将 {% data variables.product.prodname_dotcom %} Task Runner 用作 CI/CD 集成系统，作为已关闭的早期使用计划的一部分。 {% data variables.product.product_name %} Task Runner 允许您根据仓库中的配置文件从 {% data variables.product.prodname_github_app %} 自动构建、测试和部署代码。' -hidden: true -redirect_from: - - /enterprise/admin/articles/using-github-task-runner -versions: - enterprise-server: '*' ---- - - -{% note %} - -**注：**在请求访问 {% data variables.product.prodname_dotcom %} Task Runner 前，您必须在 `EARLY ACCESS LINK` 中阅读并接受我们适用于 {% data variables.product.product_location_enterprise %} 的早期使用计划免责声明和责任限制。 此文档受这些条款管辖。 - -{% endnote %} - -### 本文内容 -- [关于 {% data variables.product.prodname_dotcom %} Task Runner](#about-github-task-runner) -- [下载 {% data variables.product.prodname_dotcom %} Task Runner 二进制文件](#downloading-the-github-task-runner-binary) -- [在您的设备上创建 {% data variables.product.prodname_dotcom %} Task Runner {% data variables.product.prodname_github_app %}](#creating-the-github-task-runner-github-app-on-your-appliance) -- [安装 {% data variables.product.prodname_dotcom %} Task Runner 应用程序](#installing-the-github-task-runner-app) -- [为项目运行任务](#running-tasks-for-a-project) - -### 关于 {% data variables.product.prodname_dotcom %} Task Runner - -{% data variables.product.product_name %} Task Runner 负责运行由 Dispatcher 排队的任务，Dispatcher 是一个处理 web 挂钩推送事件和排队任务的独立服务。 - -尽管 Dispatcher 已随 {% data variables.product.product_location_enterprise %} 提供，但您必须在设备上手动安装 {% data variables.product.product_name %} Task Runner。 要设置 {% data variables.product.product_name %} Task Runner，您必须下载 Runner 二进制文件，在设备上创建一个 {% data variables.product.prodname_github_app %}，并设置服务器以与 Dispatcher 交互。 - -### 下载 {% data variables.product.prodname_dotcom %} Task Runner 二进制文件 - -您的 {% data variables.product.product_location_enterprise %} 上必须具有 {% data variables.product.product_name %} Task Runner 应用程序二进制文件。 要下载所选平台的二进制文件，请访问 `https://HOSTNAME/_dispatcher/downloads/`，将 `hostname` 替换为 {% data variables.product.product_location_enterprise %} 主机名或 IP 地址： - -使用 `chmod` 命令更改在命令行上使用 {% data variables.product.product_name %} Task Runner 的权限。 - -{% mac %} - -```shell -$ chmod +x task-runner_darwin_amd64 -``` - -{% endmac %} - -{% windows %} - -```shell -$ move task-runner_windows_amd64 task-runner_windows_amd64.exe -``` - -{% endwindows %} - -{% linux %} - -```shell -$ chmod +x task-runner_linux_amd64 -``` - -{% endlinux %} - -### 在您的设备上创建 {% data variables.product.prodname_dotcom %} Task Runner {% data variables.product.prodname_github_app %} - -1. 在当前目录中创建 `.task-runner.yaml` 配置文件。 您可以使用 `--config` 标志将文件移动到不同目录。 - -```shell -task-runner 设置 -``` - -2. 输入 {% data variables.product.product_location_enterprise %} 的主机名。 -3. 输入使用专门权限配置的个人访问令牌。 更多信息请参阅[为命令行创建个人访问令牌](/articles/creating-a-personal-access-token-for-the-command-line/)。 如果您正在为您的帐户创建 {% data variables.product.prodname_github_app %}，则可以使用 `user` 权限；或者，如果您正在为组织创建 {% data variables.product.prodname_github_app %}，则可以使用 `admin:org` 权限。 -4. 为 {% data variables.product.prodname_github_app %} 输入一个名称，例如 `Octocat Task Runner`。 -5. 如果您正在为组织创建 {% data variables.product.prodname_github_app %}，则输入组织的名称。 -6. 启动 Task Runner。 - -```shell -task-runner 启动 -``` - -### 安装 {% data variables.product.prodname_dotcom %} Task Runner 应用程序 - -1. 在任一页面的右上角，单击您的个人资料照片，然后单击 Settings。 ![用户栏中的 Settings 图标](/assets/images/help/images/userbar-account-settings.png) -2. 在左侧边栏中，单击 **Developer settings**。 ![Developer settings 部分](/assets/images/help/images/developer_settings.png) -3. 在左侧边栏中，单击 **{% data variables.product.prodname_dotcom %} Apps**。 ![GitHub Apps 部分](/assets/images/help/images/github_apps.png) -4. 单击您想要安装的应用程序。 -5. 在左侧边栏中，单击 **Public page**。 ![Public page 部分](/assets/images/help/images/public-page-tab.png) -6. 单击 **Install**。 ![GitHub 应用程序公共页面上的 Install 按钮](/assets/images/help/images/install-runner-public-page.png) -7. 选择 **Only select repositories** 并键入要安装 {% data variables.product.prodname_dotcom %} Task Runner 的仓库名称。 ![选择要安装到的仓库](/assets/images/help/images/repositories-install-task-runner.png) -8. 单击 **Install**。 ![GitHub 应用程序安装页面上的 Install 按钮](/assets/images/help/images/install-runner-installation-page.png) -9. 导航到安装应用程序的仓库。 -10. 创建一个 `github/tasks.gf` 文件，类似于： - - ``` -task "my task" { -command = "command-to-run" -runnerType = "Shell" -env = { - FOO="bar", - BAR="baz" -} -} - ``` -12. 打开拉取请求以将文件添加到仓库。 -13. 推送更改以查看 CI 任务是否已运行。 - -### 为项目运行任务 - -创建拉取请求后，{% data variables.product.prodname_github_app %} 会将事件推送到 Dispatcher，其中任务会排队发送到 {% data variables.product.prodname_dotcom %} Task Runner。 {% data variables.product.prodname_dotcom %} Task Runner 首先接收和执行任务，然后将它们报告给 Dispatcher，之后 Dispatcher 将使用结果更新拉取请求。 - -![拉取请求 CI 测试结果](/assets/images/help/images/task-results.png) diff --git a/translations/zh-CN/content/admin/clustering/about-cluster-nodes.md b/translations/zh-CN/content/admin/clustering/about-cluster-nodes.md deleted file mode 100644 index a01a230719d9..000000000000 --- a/translations/zh-CN/content/admin/clustering/about-cluster-nodes.md +++ /dev/null @@ -1,69 +0,0 @@ ---- -title: 关于集群节点 -intro: '*节点* 是在集群里运行的 {% data variables.product.prodname_ghe_server %} 实例。 每个节点都运行一组服务，这些服务将提供给集群，最终提供给用户。' -redirect_from: - - /enterprise/admin/clustering/about-cluster-nodes -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_clustering.clustering-requires-https %} - -### 最低硬件建议 -每个节点都必须具有根卷以及单独的数据卷。 这些是最低限度的建议。 根据您的使用情况（例如用户活动和选定的集成），可能需要更多资源。 - -| 服务 | 需要的最小内存 | 需要的最小数据卷可用空间 | -|:----------------------------------------------------------------------------:|:-------:|:------------:| -| `job-server`,
    `memcache-server`,
    `web-server` | 14 GB | 1 GB | -| `consul-server`,
    `mysql-server`,
    `redis-server` | 14 GB | 10 GB | -| `git-server`,
    `metrics-server`,
    `pages-server`,
    `storage-server` | 7 GB | 10 GB | -| `elasticsearch-server` | 14 GB | 10 GB | - -### 集群需要的服务 -为获得足够的冗余，请使用下面列出的最少节点来运行每个服务。 - -{% tip %} - -**注：**组织对可扩展性的需求取决于多种因素，包括仓库的大小和数量、用户数量以及总体利用率。 - -{% endtip %} - -| 服务 | 需要的最少节点 | -|:---------------------------------------------------------------------------:|:-------:| -| `job-server`,
    `memcache-server`,
    `metrics-server`,
    `web-server` | 2 | -| `mysql-server`,
    `redis-server` | 2 | -| `consul-server` | 3 | -| `git-server`,
    `pages-server`,
    `storage-server` | 3 | -| `elasticsearch-server` | 3 | - -### 集群设计建议 - -集群允许组成 {% data variables.product.prodname_ghe_server %} 的服务彼此独立地进行扩展。 这种灵活性可用于设计和实现适合具有不同可扩展性要求的组织的集群。 例如，某些组织可能需要更多的存储吞吐量来进行大量或频繁的获取，但 Web 服务器的利用率可能相对较低。 其他组织可能具有较高的性能和较少的存储资源，但需要许多节点来运行 `pages-server` 或 `elasticsearch-server`。 可以实现许多不同的组合。 与您的客户代表合作，确定满足您特定需求的最佳集群配置。 - -- 在独立硬件上扩展冗余节点。 如果共享 CPU、内存或存储设备，则会降低性能并引发单点故障。 此外，共享网络组件还会降低吞吐量并增加在发生中断时丢失连接的风险。 -- 使用快速存储。 通常经过优化存储区域网络 (SAN)，可实现最大的空间利用率、可用性和容错能力，而不是绝对的吞吐量。 {% data variables.product.prodname_ghe_server %} 集群提供冗余和可用性，可在最快的可用存储上发挥最佳性能。 建议使用本地 SSD 存储。 -- 建立对您的组织有意义的节点层。 配置示例： - - 具有两个节点和以下服务的前端层： - - `web-server` - - `jobs-server` - - `memcache-server` - - 具有三个节点和以下服务的数据库层： - - `consul-server` - - `mysql-server` - - `redis-server` - - 具有三个节点和以下服务的搜索层： - - `elasticsearch-server` - - 具有三个节点和以下服务的存储层： - - `git-server` - - `pages-server` - - `storage-server` - - `metrics-server` - -#### 示例集群图 -{% note %} - -**注：这只是一个示例。**您组织的最佳集群设计将取决于您的独特需求。 与您的专业代表或 {% data variables.contact.contact_enterprise_sales %} 探讨，以便我们能帮您确定最佳集群配置。 - -{% endnote %} - -示例集群 diff --git a/translations/zh-CN/content/admin/clustering/about-clustering.md b/translations/zh-CN/content/admin/clustering/about-clustering.md deleted file mode 100644 index 82c459828ba9..000000000000 --- a/translations/zh-CN/content/admin/clustering/about-clustering.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: 关于集群 -intro: '{% data variables.product.prodname_ghe_server %} 集群允许组成 {% data variables.product.prodname_ghe_server %} 的服务跨多个节点进行扩展。' -redirect_from: - - /enterprise/admin/clustering/clustering-overview/ - - /enterprise/admin/clustering/about-clustering -versions: - enterprise-server: '*' ---- - -### 集群架构 - -{% data variables.product.prodname_ghe_server %} 由一组服务组成。 在集群中，这些服务跨多个节点运行，请求在它们之间进行负载均衡。 更改会与冗余副本一起自动存储在到单独的节点上。 大多数服务与相同服务的其他实例是对等的。 这种情况的例外是 `mysql-server` 和 `redis-server` 服务。 它们使用具有一个或多个_副本_节点的单个_主_节点来操作。 - -详细了解[集群所需的服务](/enterprise/{{ currentVersion }}/admin/guides/clustering/about-cluster-nodes#services-required-for-clustering)。 - -### 集群是否适合我的组织？ - -{% data reusables.enterprise_clustering.clustering-scalability %} 但是，设置冗余和可扩展的集群可能很复杂，需要仔细规划。 在安装、灾难恢复场景和升级期间，需要计划这种额外的复杂性。 - -{% data variables.product.prodname_ghe_server %} 要求节点之间保持较低的延迟，不适用于跨地理位置的冗余。 - -集群提供了冗余功能，但不适用于替换高可用性配置。 更多信息请参阅[高可用性配置](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-github-enterprise-server-for-high-availability)。 主设备/辅助设备故障切换配置远比集群简单，可以满足许多组织的需求。 更多信息请参阅[集群与高可用性之间的差异](/enterprise/{{ currentVersion }}/admin/guides/clustering/differences-between-clustering-and-high-availability-ha/)。 - -### 如何获得集群？ - -集群针对特定扩展情况而设计，并不一定适用于每个组织。 如果想要考虑集群，请联系您的专业代表或 {% data variables.contact.contact_enterprise_sales %}。 diff --git a/translations/zh-CN/content/admin/clustering/cluster-network-configuration.md b/translations/zh-CN/content/admin/clustering/cluster-network-configuration.md deleted file mode 100644 index 5fd36f4fad92..000000000000 --- a/translations/zh-CN/content/admin/clustering/cluster-network-configuration.md +++ /dev/null @@ -1,122 +0,0 @@ ---- -title: 群集网络配置 -intro: '{% data variables.product.prodname_ghe_server %} 集群依靠正确的 DNS 名称解析、负载均衡以及节点之间的通信来正常运行。' -redirect_from: - - /enterprise/admin/clustering/network-configuration - - /enterprise/admin/clustering/cluster-network-configuration -versions: - enterprise-server: '*' ---- - -### 网络考虑因素 - -对于集群而言，最简单的网络设计是将节点置于单个 LAN 上。 如果冗余集群必须跨越子网，则子网之间应该提供适当的路由，延迟应短于 1 毫秒。 - -#### 最终用户的应用程序端口 - -应用程序端口为最终用户提供 Web 应用程序和 Git 访问。 - -| 端口 | 描述 | 加密 | -|:-------- |:-------------------------- |:----------------------------- | -| 22/TCP | 通过 SSH 访问 Git | 是 | -| 25/TCP | SMTP | 需要 STARTTLS | -| 80/TCP | HTTP | 否
    （启用 SSL 时，此端口重定向到 HTTPS） | -| 443/TCP | HTTPS | 是 | -| 9418/TCP | 简单的 Git 协议端口
    （在私有模式下禁用） | 否 | - -#### 管理端口 - -最终用户在使用基本应用程序时不需要管理端口。 - -| 端口 | Description | 加密 | -|:-------- |:------------------------ |:----------------------------- | -| ICMP | ICMP Ping | 否 | -| 122/TCP | 管理 SSH | 是 | -| 161/UDP | SNMP | 否 | -| 8080/TCP | Management Console HTTP | 否
    （启用 SSL 时，此端口重定向到 HTTPS） | -| 8443/TCP | Management Console HTTPS | 是 | - -#### 集群通信端口 - -如果节点之间存在网络级防火墙，则需要访问这些端口。 节点之间的通信未加密。 这些端口不应从外部访问。 - -| 端口 | 描述 | -|:--------- |:-------------- | -| 1336/TCP | 内部 API | -| 3033/TCP | 内部 SVN 访问 | -| 3037/TCP | 内部 SVN 访问 | -| 3306/TCP | MySQL | -| 4486/TCP | 管理者访问 | -| 5115/TCP | 存储后端 | -| 5208/TCP | 内部 SVN 访问 | -| 6379/TCP | Redis | -| 8001/TCP | Grafana | -| 8090/TCP | 内部 GPG 访问 | -| 8149/TCP | GitRPC 文件服务器访问 | -| 8300/TCP | Consul | -| 8301/TCP | Consul | -| 8302/TCP | Consul | -| 9000/TCP | Git Daemon | -| 9102/TCP | 页面文件服务器 | -| 9105/TCP | LFS 服务器 | -| 9200/TCP | Elasticsearch | -| 9203/TCP | 语义代码服务 | -| 9300/TCP | Elasticsearch | -| 11211/TCP | Memcache | -| 161/UDP | SNMP | -| 8125/UDP | Statsd | -| 8301/UDP | Consul | -| 8302/UDP | Consul | -| 25827/UDP | Collectd | - - -### 配置负载均衡器 - - 我们建议使用基于 TCP 的外部负载均衡器，它支持 PROXY 协议来跨节点分配流量。 请考虑以下负载均衡器配置： - - - 应将 TCP 端口（如下所示）转发到运行 `web-server` 服务的节点。 这些是提供外部客户端请求的唯一节点。 - - 不应启用粘性会话。 - -{% data reusables.enterprise_installation.terminating-tls %} - -### 处理客户端连接信息 - -由于客户端与集群的连接来自负载均衡器，因此客户端 IP 地址可能会丢失。 要正确捕获客户端连接信息，需要考虑其他因素。 - -{% data reusables.enterprise_clustering.proxy_preference %} - -{% data reusables.enterprise_clustering.proxy_xff_firewall_warning %} - -#### 在 {% data variables.product.prodname_ghe_server %} 上启用 PROXY 支持 - -我们强烈建议您为实例和负载均衡器启用 PROXY 支持。 - - - 对于您的实例，请使用以下命令： - ```shell - $ ghe-config 'loadbalancer.proxy-protocol' 'true' && ghe-cluster-config-apply - ``` - - 对于负载均衡器，请使用供应商提供的说明。 - - {% data reusables.enterprise_clustering.proxy_protocol_ports %} - -#### 在 {% data variables.product.prodname_ghe_server %} 上启用 X-Forwarded-For 支持 - -{% data reusables.enterprise_clustering.x-forwarded-for %} - -要启用 `X-Fowarded-For` 标头，请使用以下命令： - -```shell -$ ghe-config 'loadbalancer.http-forward' 'true' && ghe-cluster-config-apply -``` - -{% data reusables.enterprise_clustering.without_proxy_protocol_ports %} - -#### 配置状态检查 -如果预配置的检查在该节点上失败，则状态检查允许负载均衡器停止向未响应的节点发送流量。 如果集群节点出现故障，则与冗余节点配对的状态检查可提供高可用性。 - -{% data reusables.enterprise_clustering.health_checks %} -{% data reusables.enterprise_site_admin_settings.maintenance-mode-status %} - -### DNS 要求 - -{% data reusables.enterprise_clustering.load_balancer_dns %} diff --git a/translations/zh-CN/content/admin/clustering/differences-between-clustering-and-high-availability-ha.md b/translations/zh-CN/content/admin/clustering/differences-between-clustering-and-high-availability-ha.md deleted file mode 100644 index 1916e8b1a3d3..000000000000 --- a/translations/zh-CN/content/admin/clustering/differences-between-clustering-and-high-availability-ha.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: 集群与高可用性 (HA) 之间的差异 -intro: '{% data variables.product.prodname_ghe_server %} 高可用性配置 (HA) 是一种可提供冗余功能的主设备/辅助设备故障切换配置，而集群则通过在多个节点之间分配读写负载来提供冗余和可扩展性。' -redirect_from: - - /enterprise/admin/clustering/differences-between-clustering-and-high-availability-ha -versions: - enterprise-server: '*' ---- - -### 故障场景 - -高可用性 (HA) 和集群都通过消除作为故障点的单个节点来提供冗余。 它们能够在这些场景中提供可用性： - -{% data reusables.enterprise_installation.ha-and-clustering-failure-scenarios %} - -### 可扩展性 - -{% data reusables.enterprise_clustering.clustering-scalability %} 在 HA 中，设备的规模完全取决于主节点，并且负载不会分发到副本服务器。 - -### 故障切换方法和配置方面的差异 - -| 功能 | 故障切换配置 | 故障切换方法 | -|:------ |:-------------------------- |:----------------------------------- | -| 高可用性配置 | TTL 较低的 DNS 记录指向主设备或负载均衡器。 | 您必须在 DNS 故障切换和负载均衡器配置中手动升级副本设备。 | -| 集群 | DNS 记录必须指向负载均衡器。 | 如果负载均衡器后面的节点发生故障，流量将自动发送到其他正常运行的节点。 | - -### 备份和灾难恢复 - -HA 或集群都不应被视为常规备份的替代品。 更多信息请参阅“[在设备上配置备份](/enterprise/admin/guides/installation/configuring-backups-on-your-appliance)”。 - -### 监视 - -可用性功能，尤其是具有自动故障切换的功能（如集群）可以屏蔽故障，因为在发生故障时通常不会中断服务。 无论您使用的是 HA 还是集群，监视每个实例的状态都十分重要，这样您就可以了解何时发生了故障。 有关监视的更多信息，请参阅“[建议的警报阈值](/enterprise/{{ currentVersion }}/admin/guides/installation/recommended-alert-thresholds/)”和“[监视集群节点](/enterprise/{{ currentVersion}}/admin/guides/clustering/monitoring-cluster-nodes/)”。 - -### 延伸阅读 -- 有关 {% data variables.product.prodname_ghe_server %} 集群的更多信息，请参阅“[关于集群](/enterprise/{{ currentVersion}}/admin/guides/clustering/about-clustering/)”。 -- 有关 HA 的更多信息，请参阅“[配置 {% data variables.product.prodname_ghe_server %} 以实现高可用性](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-github-enterprise-server-for-high-availability/)”。 diff --git a/translations/zh-CN/content/admin/clustering/evacuating-a-cluster-node.md b/translations/zh-CN/content/admin/clustering/evacuating-a-cluster-node.md deleted file mode 100644 index 50e1cb33d30a..000000000000 --- a/translations/zh-CN/content/admin/clustering/evacuating-a-cluster-node.md +++ /dev/null @@ -1,52 +0,0 @@ ---- -title: 撤出集群节点 -intro: 您可以撤出集群节点上的数据服务。 -redirect_from: - - /enterprise/admin/clustering/evacuating-a-cluster-node -versions: - enterprise-server: '*' ---- - -如果数据服务集群中只有三个节点，则无法撤出节点，因为 `ghe-spoke` 没有其他位置可以进行复制。 如果您有四个或更多节点，则 `ghe-spoke ` 会将所有仓库移出已撤出的节点。 - -如果您正在使具有任何数据服务（如 git、页面或存储）的某个节点离线，请在使节点离线之前撤出每个节点。 - -1. 用 `ghe-config` 命令查找节点的 `uuid`。 - - ``` - $ ghe-config cluster._hostname_.uuid - ``` - -2. 在复制数据时，您需要监视节点的状态。 理想情况下，在复制完成之前，不应使该节点离线。 要监视节点的状态，请运行以下任意命令： - - 对于 Git - ``` - ghe-spokes evac-status - ``` - 对于 {% data variables.product.prodname_pages %} - ``` - echo "select count(*) from pages_replicas where host = 'pages-server-'" | ghe-dbconsole -y - ``` - 对于存储 - ``` - ghe-storage evacuation-status - ``` - -3. 复制完成后，您可以撤出存储服务。 运行以下任意命令： - - 对于 Git - ``` - ghe-spokes server evacuate git-server- - ``` - 对于 {% data variables.product.prodname_pages %} - ``` - ghe-dpages evacuate pages-server- - ``` - 对于存储，请使节点离线 - ``` - ghe-storage offline storage-server- - ``` - 然后撤出 - ``` - ghe-storage evacuate storage-server- - ``` diff --git a/translations/zh-CN/content/admin/clustering/index.md b/translations/zh-CN/content/admin/clustering/index.md deleted file mode 100644 index 7a580c6f7f52..000000000000 --- a/translations/zh-CN/content/admin/clustering/index.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: 设置和管理 GitHub Enterprise Server 的集群 -shortTitle: 集群 -intro: '本指南介绍了如何与您的客户代表确定 {% data variables.product.prodname_enterprise %} 集群是否适合您的组织以及如何设置集群。' -redirect_from: - - /enterprise/admin/clustering -versions: - enterprise-server: '*' ---- - -### 目录 - -{% topic_link_in_list /overview %} - {% link_in_list /about-clustering %} - {% link_in_list /differences-between-clustering-and-high-availability-ha %} -{% topic_link_in_list /setting-up-the-cluster-instances %} - {% link_in_list /about-cluster-nodes %} - {% link_in_list /cluster-network-configuration %} - {% link_in_list /initializing-the-cluster %} -{% topic_link_in_list /managing-a-github-enterprise-server-cluster %} - {% link_in_list /upgrading-a-cluster %} - {% link_in_list /replacing-a-cluster-node %} - {% link_in_list /evacuating-a-cluster-node %} - {% link_in_list /monitoring-cluster-nodes %} diff --git a/translations/zh-CN/content/admin/clustering/initializing-the-cluster.md b/translations/zh-CN/content/admin/clustering/initializing-the-cluster.md deleted file mode 100644 index 8e10cb3b39fb..000000000000 --- a/translations/zh-CN/content/admin/clustering/initializing-the-cluster.md +++ /dev/null @@ -1,113 +0,0 @@ ---- -title: 初始化集群 -intro: '{% data variables.product.prodname_ghe_server %} 集群必须使用许可进行设置，并使用管理 shell (SSH) 进行初始化。' -redirect_from: - - /enterprise/admin/clustering/initializing-the-cluster -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_clustering.clustering-requires-https %} - -### 安装 {% data variables.product.prodname_ghe_server %} - -1. 在每个集群节点上，提供并安装 {% data variables.product.prodname_ghe_server %}。 更多信息请参阅“[设置 {% data variables.product.prodname_ghe_server %} 实例](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-github-enterprise-server-instance)”。 -2. 使用管理 shell 或 DHCP，**仅**配置每个节点的 IP 地址。 不要配置任何其他设置。 - -### 配置第一个节点 - -1. 连接到将在 `cluster.conf` 中被指定为 `mysql-master` 的节点。 更多信息请参阅“[关于集群配置文件](/enterprise/{{ currentVersion }}/admin/guides/clustering/initializing-the-cluster/#about-the-cluster-configuration-file)”。 -2. 在 Web 浏览器中，访问 `https://:8443/setup/`。 -{% data reusables.enterprise_installation.upload-a-license-file %} -{% data reusables.enterprise_installation.save-settings-in-web-based-mgmt-console %} -{% data reusables.enterprise_installation.instance-will-restart-automatically %} - -### 初始化集群 - -要初始化集群，您需要一个集群配置文件 (`cluster.conf`)。 更多信息请参阅“[关于集群配置文件](/enterprise/{{ currentVersion }}/admin/guides/clustering/initializing-the-cluster/#about-the-cluster-configuration-file)”。 - -1. 从配置的第一个节点开始，运行 `ghe-cluster-config-init`。 如果集群配置文件中存在未配置的节点，此操作会初始化集群。 -2. 运行 `ghe-cluster-config-apply`。 这将验证 `cluster.conf` 文件，将配置应用于每个节点文件，并在每个节点上显示已配置的服务。 - -要检查正在运行的集群的状态，使用 `ghe-cluster-status` 命令。 - -### 关于集群配置文件 - -集群配置文件 (`cluster.conf`) 会定义集群中的节点以及它们运行的​​服务。 更多信息请参阅“[关于集群节点](/enterprise/{{ currentVersion }}/admin/guides/clustering/about-cluster-nodes)”。 - -此示例 `cluster.conf` 定义了一个包含五个节点的集群。 - - - 两个节点（称为 `ghe-app-node-\*`）运行负责响应客户端请求的 `web-server` 和 `job-server` 服务。 - - 三个节点（称为 `ghe-data-node-\*`）运行负责存储和检索 {% data variables.product.prodname_ghe_server %} 数据的服务。 - -节点的名称可以是您选择的任何有效主机名。 名称被设置为每个节点的主机名，并且还将添加到每个节点上的 `/etc/hosts` 中，以便节点可以在本地相互解析。 - -通过 `mysql-server` 和 `mysql-master` 指定您配置为 MySQL master 的第一个集群节点。 - -``` -[cluster] - mysql-master = ghe-data-node-1 - redis-master = ghe-data-node-1 - primary-datacenter = default -[cluster "ghe-app-node-1"] - hostname = ghe-app-node-1 - ipv4 = 192.168.0.2 - # ipv6 = fd12:3456:789a:1::2 - web-server = true - job-server = true -[cluster "ghe-app-node-2"] - hostname = ghe-app-node-2 - ipv4 = 192.168.0.3 - # ipv6 = fd12:3456:789a:1::3 - web-server = true - job-server = true -[cluster "ghe-data-node-1"] - hostname = ghe-data-node-1 - ipv4 = 192.168.0.4 - # ipv6 = fd12:3456:789a:1::4 - consul-server = true - consul-datacenter = default - git-server = true - pages-server = true - mysql-server = true - elasticsearch-server = true - redis-server = true - memcache-server = true - metrics-server = true - storage-server = true -[cluster "ghe-data-node-2"] - hostname = ghe-data-node-2 - ipv4 = 192.168.0.5 - # ipv6 = fd12:3456:789a:1::5 - consul-server = true - consul-datacenter = default - git-server = true - pages-server = true - mysql-server = true - elasticsearch-server = true - redis-server = true - memcache-server = true - metrics-server = true - storage-server = true -[cluster "ghe-data-node-3"] - hostname = ghe-data-node-3 - ipv4 = 192.168.0.6 - # ipv6 = fd12:3456:789a:1::6 - consul-server = true - consul-datacenter = default - git-server = true - pages-server = true - mysql-server = true - elasticsearch-server = true - redis-server = true - memcache-server = true - metrics-server = true - storage-server = true -``` - -在配置的第一个节点上创建文件 `/data/user/common/cluster.conf`。 例如，使用 `vim`： - - ```shell - ghe-data-node-1:~$ sudo vim /data/user/common/cluster.conf - ``` - diff --git a/translations/zh-CN/content/admin/clustering/managing-a-github-enterprise-server-cluster.md b/translations/zh-CN/content/admin/clustering/managing-a-github-enterprise-server-cluster.md deleted file mode 100644 index 946b427f13b5..000000000000 --- a/translations/zh-CN/content/admin/clustering/managing-a-github-enterprise-server-cluster.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: 管理 GitHub Enterprise Server 集群 -intro: '为 {% data variables.product.prodname_ghe_server %} 集群规划维护操作，例如升级、增加容量和替换故障节点。' -redirect_from: - - /enterprise/admin/guides/clustering/managing-a-github-enterprise-cluster/ - - /enterprise/admin/clustering/managing-a-github-enterprise-server-cluster -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/zh-CN/content/admin/clustering/monitoring-cluster-nodes.md b/translations/zh-CN/content/admin/clustering/monitoring-cluster-nodes.md deleted file mode 100644 index 77e7040949df..000000000000 --- a/translations/zh-CN/content/admin/clustering/monitoring-cluster-nodes.md +++ /dev/null @@ -1,105 +0,0 @@ ---- -title: 监视集群节点 -intro: '{% data variables.product.prodname_ghe_server %} 集群由分布在两个或多个节点上的冗余服务组成。 如果单个服务或整个节点将要发生故障，这种情况不应立即展示给集群的用户。 但是，由于性能和冗余受到影响，因此监视 {% data variables.product.prodname_ghe_server %} 集群的状态非常重要。' -redirect_from: - - /enterprise/admin/clustering/monitoring-cluster-nodes -versions: - enterprise-server: '*' ---- - -### 手动检查集群状态 - -{% data variables.product.prodname_ghe_server %} 有一个内置的命令行实用程序，用于监视集群的状态。 在管理 shell 中，运行 `ghe-cluster-status` 命令会对每个节点执行一系列状态检查，包括验证连接和服务状态。 输出会显示所有测试结果，包括文本 `ok` 或 `error`。 例如，要仅显示失败的测试，请运行： - -```shell -admin@ghe-data-node-0:~$ ghe-cluster-status | grep error -> mysql-replication ghe-data-node-0: error Stopped -> mysql cluster: error -``` -{% note %} - -**注：**如果没有失败的测试，则此命令不会产生任何输出。 这表明集群的状态是健康的。 - -{% endnote %} - -### 使用 Nagios 监视集群状态 - -您可以配置 [Nagios](https://www.nagios.org/) 来监视 {% data variables.product.prodname_ghe_server %}。 除了监视每个集群节点的基本连接以外，还可以通过将 Nagios 配置为使用 `ghe-cluster-status -n` 命令来检查集群状态。 这将以 Nagios 理解的格式返回输出。 - -#### 基本要求 -* 运行 Nagios 的 Linux 主机。 -* 对 {% data variables.product.prodname_ghe_server %} 集群的网络访问。 - -#### 配置 Nagios 主机 -1. 使用空白密码生成 SSH 密钥。 Nagios 使用此密钥来对 {% data variables.product.prodname_ghe_server %} 集群进行身份验证。 - ```shell - nagiosuser@nagios:~$ ssh-keygen -t rsa -b 4096 - > Generating public/private rsa key pair. - > Enter file in which to save the key (/home/nagiosuser/.ssh/id_rsa): - > Enter passphrase (empty for no passphrase): leave blank by pressing enter - > Enter same passphrase again: press enter again - > Your identification has been saved in /home/nagiosuser/.ssh/id_rsa. - > Your public key has been saved in /home/nagiosuser/.ssh/id_rsa.pub. - ``` - {% danger %} - - **安全警告：**如果授权完全访问主机，则没有密码的 SSH 密钥可能会构成安全风险。 将此密钥的授权限制为单个只读命令。 - - {% enddanger %} -2. 将私钥 (`id_rsa`) 复制到 `nagios` 主文件夹并设置适当的所有权。 - ```shell - nagiosuser@nagios:~$ sudo cp .ssh/id_rsa /var/lib/nagios/.ssh/ - nagiosuser@nagios:~$ sudo chown nagios:nagios /var/lib/nagios/.ssh/id_rsa - ``` - -3. 要授权公钥*仅*运行 `ghe-cluster-status -n` 命令，请在 `/data/user/common/authorized_keys` 文件中使用 `command=` 前缀。 从任何节点上的管理 shell，修改此文件以添加在步骤 1 中生成的公钥。 例如：`command="/usr/local/bin/ghe-cluster-status -n" ssh-rsa AAAA....` - -4. 通过在修改了 `/data/user/common/authorized_keys` 文件的节点上运行 `ghe-cluster-config-apply`，验证配置并将其复制到集群中的每个节点。 - - ```shell - admin@ghe-data-node-0:~$ ghe-cluster-config-apply - > Validating configuration - > ... - > Finished cluster configuration - ``` - -5. 要测试 Nagios 插件能否成功执行命令，请从 Nagios 主机以交互方式运行此命令。 - ```shell - nagiosuser@nagios:~$ /usr/lib/nagios/plugins/check_by_ssh -l admin -p 122 -H hostname -C "ghe-cluster-status -n" -t 30 - > OK - No errors detected - ``` - -6. 在 Nagios 配置中创建命令定义。 - - ###### 示例定义 - - ``` - define command { - command_name check_ssh_ghe_cluster - command_line $USER1$/check_by_ssh -H $HOSTADDRESS$ -C "ghe-cluster-status -n" -l admin -p 122 -t 30 - } - ``` -7. 将此命令添加到 {% data variables.product.prodname_ghe_server %} 集群中节点的服务定义。 - - - ###### 示例定义 - - ``` - define host{ - use generic-host - host_name ghe-data-node-0 - alias ghe-data-node-0 - address 10.11.17.180 - } - - define service{ - use generic-service - host_name ghe-data-node-0 - service_description GitHub Cluster Status - check_command check_ssh_ghe_cluster - } - ``` - -将定义添加到 Nagios 后，将根据您的配置执行服务检查。 您应该能够在 Nagios Web 界面中看到新配置的服务。 - -![Nagios 示例](/assets/images/enterprise/cluster/nagios-example.png) diff --git a/translations/zh-CN/content/admin/clustering/overview.md b/translations/zh-CN/content/admin/clustering/overview.md deleted file mode 100644 index 08369b0eb9ca..000000000000 --- a/translations/zh-CN/content/admin/clustering/overview.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: 概览 -intro: 了解具有高可用性的集群和差异。 -mapTopic: true -redirect_from: - - /enterprise/admin/clustering/overview -versions: - enterprise-server: '*' ---- - diff --git a/translations/zh-CN/content/admin/clustering/replacing-a-cluster-node.md b/translations/zh-CN/content/admin/clustering/replacing-a-cluster-node.md deleted file mode 100644 index a61bab8ac02c..000000000000 --- a/translations/zh-CN/content/admin/clustering/replacing-a-cluster-node.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: 替换集群节点 -intro: '要替换 {% data variables.product.prodname_ghe_server %} 节点，必须在集群配置文件 (cluster.conf) 中将受影响的节点标记为离线，然后添加替换节点。 如果节点发生故障，或者添加具有更多资源的节点以提高性能，则可能需要执行此操作。' -redirect_from: - - /enterprise/admin/clustering/replacing-a-cluster-node -versions: - enterprise-server: '*' ---- - -{% warning %} - -**警告：**替换节点必须使用先前未在集群中使用的主机名以避免冲突。 - -{% endwarning %} - -### 替换功能节点 -{% data reusables.enterprise_clustering.replacing-a-cluster-node-provision %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-admin-configure-ip %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-modify-cluster-conf %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-initialize-new-node %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-config-node %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-need-three-nodes %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-mark-offline %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-validate-config %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-replacement-name %} - -### 在紧急情况下替换节点 -{% data reusables.enterprise_clustering.replacing-a-cluster-node-provision %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-admin-configure-ip %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-mark-offline %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-validate-config %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-modify-cluster-conf %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-replacement-name %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-initialize-new-node %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-config-node %} -{% data reusables.enterprise_clustering.replacing-a-cluster-node-need-three-nodes %} diff --git a/translations/zh-CN/content/admin/clustering/setting-up-the-cluster-instances.md b/translations/zh-CN/content/admin/clustering/setting-up-the-cluster-instances.md deleted file mode 100644 index b1b69347c0f9..000000000000 --- a/translations/zh-CN/content/admin/clustering/setting-up-the-cluster-instances.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: 设置集群实例 -intro: '{% data variables.product.prodname_ghe_server %} 集群需要设置多个实例并配置为运行 {% data variables.product.prodname_ghe_server %} 服务。' -mapTopic: true -redirect_from: - - /enterprise/admin/clustering/setting-up-the-cluster-instances -versions: - enterprise-server: '*' ---- - diff --git a/translations/zh-CN/content/admin/clustering/upgrading-a-cluster.md b/translations/zh-CN/content/admin/clustering/upgrading-a-cluster.md deleted file mode 100644 index c1608fdb708b..000000000000 --- a/translations/zh-CN/content/admin/clustering/upgrading-a-cluster.md +++ /dev/null @@ -1,76 +0,0 @@ ---- -title: 升级集群 -intro: '使用管理 shell (SSH) 将 {% data variables.product.prodname_ghe_server %} 集群升级到最新版本。' -redirect_from: - - /enterprise/admin/clustering/upgrading-a-cluster -versions: - enterprise-server: '*' ---- - -### 使用热补丁升级 -{% data reusables.enterprise_installation.hotpatching-explanation %} 热补丁安装脚本可在集群中的每个节点上安装热补丁，并按正确顺序重新启动服务以避免停机。 - -1. 使用 [{% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils#readme) 备份数据。 -2. 在任何节点的管理 shell 中，使用 `ghe-cluster-hotpatch` 命令安装最新的热补丁。 您可以为热补丁提供 URL，也可以手动下载该热补丁并指定本地文件名。 - ```shell - $ ghe-cluster-hotpatch https://HOTPATCH-URL/FILENAME.hpkg - ``` - -### 使用升级包升级 -使用升级包将 {% data variables.product.prodname_ghe_server %} 集群升级到最新功能版本。 例如，您可以从 `2.11` 升级到 `2.13`。 - -#### 准备升级 - -1. 查看要升级到的版本的[集群网络配置](/enterprise/admin/guides/clustering/cluster-network-configuration)，并根据需要更新配置。 -2. 使用 [{% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils#readme) 备份数据。 -3. 为 {% data variables.product.prodname_ghe_server %} 集群的最终用户排定维护窗口，因为它在升级期间无法正常使用。 在群集群升级过程中，维护模式会阻止用户访问并防止数据更改。 -4. 在 [{% data variables.product.prodname_ghe_server %} 下载页面](https://enterprise.github.com/download)上，将 *.pkg* 升级文件的 URL 复制到剪贴板。 -5. 在任何节点的管理 shell 中，将 `ghe-cluster-each` 命令与 `curl` 结合使用，只需一步即可将发布包下载到每个节点。 使用您在上一步中复制的 URL 作为参数。 - ```shell - $ ghe-cluster-each -- "cd /home/admin && curl -L -O https://PACKAGE-URL.pkg" - > ghe-app-node-1: % Total % Received % Xferd Average Speed Time Time Time Current - > ghe-app-node-1: Dload Upload Total Spent Left Speed - > 100 496M 100 496M 0 0 24.2M 0 0:00:20 0:00:20 --:--:-- 27.4M - > ghe-data-node-2: % Total % Received % Xferd Average Speed Time Time Time Current - > ghe-data-node-2: Dload Upload Total Spent Left Speed - > 100 496M 100 496M 0 0 21.3M 0 0:00:23 0:00:23 --:--:-- 25.8M - > ghe-data-node-1: % Total % Received % Xferd Average Speed Time Time Time Current - > ghe-data-node-1: Dload Upload Total Spent Left Speed - > 100 496M 100 496M 0 0 19.7M 0 0:00:25 0:00:25 --:--:-- 25.6M - > ghe-app-node-2: % Total % Received % Xferd Average Speed Time Time Time Current - > ghe-app-node-2: Dload Upload Total Spent Left Speed - > 100 496M 100 496M 0 0 19.8M 0 0:00:25 0:00:25 --:--:-- 17.6M - > ghe-data-node-3: % Total % Received % Xferd Average Speed Time Time Time Current - > ghe-data-node-3: Dload Upload Total Spent Left Speed - > 100 496M 100 496M 0 0 19.7M 0 0:00:25 0:00:25 --:--:-- 25.5M - ``` -6. 确定主 MySQL 节点，此节点在 `cluster.conf` 中定义为 `mysql-master = `。 此节点将最后升级。 - -#### 升级集群节点 - -1. 通过连接到任何集群节点的管理 shell 并运行 `ghe-cluster-maintenance -s`，根据排定的窗口启用维护模式。 -2. **除了主 MySQL 节点之外**，连接到每个 {% data variables.product.prodname_ghe_server %} 节点的管理 shell。 运行 `ghe-upgrade` 命令，提供在[准备升级](#preparing-to-upgrade)的步骤 4 中下载的包文件名： - ```shell - $ ghe-upgrade PACKAGE-FILENAME.pkg - > *** verifying upgrade package signature... - > 497MB 0:00:04 [ 117MB/s] [==========================================>] 100% - > gpg: Signature made Fri 19 Feb 2016 02:33:50 PM UTC using RSA key ID 0D65D57A - > gpg: checking the trustdb - > gpg: 3 marginal(s) needed, 1 complete(s) needed, PGP trust model - > gpg: depth: 0 valid: 1 signed: 0 trust: 0-, 0q, 0n, 0m, 0f, 1u - > gpg: Good signature from "GitHub Enterprise (Upgrade Package Key) > " - ``` -3. 升级过程将在完成后重启节点。 验证您可以在其重启后 `ping` 每个节点。 -4. 连接到主 MySQL 节点的管理 shell。 运行 `ghe-upgrade` 命令，提供在[准备升级](#preparing-to-upgrade)的步骤 4 中下载的包文件名： - ```shell - $ ghe-upgrade PACKAGE-FILENAME.pkg - > *** verifying upgrade package signature... - > 497MB 0:00:04 [ 117MB/s] [==========================================>] 100% - > gpg: Signature made Fri 19 Feb 2016 02:33:50 PM UTC using RSA key ID 0D65D57A - > gpg: checking the trustdb - > gpg: 3 marginal(s) needed, 1 complete(s) needed, PGP trust model - > gpg: depth: 0 valid: 1 signed: 0 trust: 0-, 0q, 0n, 0m, 0f, 1u - > gpg: Good signature from "GitHub Enterprise (Upgrade Package Key) > " - ``` -5. 升级过程将在完成后重启主 MySQL 节点。 验证您可以在其重启后 `ping` 每个节点。 -6. 通过运行 `ghe-cluster-maintenance -u`，从任何节点的管理 shell 退出维护模式。 diff --git a/translations/zh-CN/content/admin/configuration/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md b/translations/zh-CN/content/admin/configuration/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md deleted file mode 100644 index c3dfb660da9c..000000000000 --- a/translations/zh-CN/content/admin/configuration/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: 为 GitHub Enterprise Server 上易受攻击的依赖项启用安全警报 -intro: '您可以将 {% data variables.product.product_location_enterprise %} 连接到 {% data variables.product.prodname_ghe_cloud %}，并为实例仓库中易受攻击的依赖项启用安全警报。' -redirect_from: - - /enterprise/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server - - /enterprise/admin/configuration/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server -permissions: '{% data variables.product.prodname_ghe_server %} 的站点管理员（同时也是已连接 {% data variables.product.prodname_ghe_cloud %} 组织或企业帐户的所有者）可以为 {% data variables.product.prodname_ghe_server %} 上的漏洞依赖项启用安全警报。' -versions: - enterprise-server: '*' ---- - -### 关于 {% data variables.product.prodname_ghe_server %} 上易受攻击的依赖项的警报 - -{% data reusables.repositories.tracks-vulnerabilities %} 更多信息请参阅“[关于易受攻击的依赖项的警报](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)”。 - -您可以将 {% data variables.product.product_location_enterprise %} 连接到 {% data variables.product.prodname_dotcom_the_website %}，然后将漏洞数据同步到实例，并在包含易受攻击的依赖项的仓库中生成安全警报。 - -将 {% data variables.product.product_location_enterprise %} 连接到 {% data variables.product.prodname_dotcom_the_website %} 并为易受攻击的依赖项启用安全警报后，每个小时都会将漏洞数据从 {% data variables.product.prodname_dotcom_the_website %} 同步到您的实例一次。 您还可以随时选择手动同步漏洞数据。 代码和关于代码的信息不会从 {% data variables.product.product_location_enterprise %} 上传到 {% data variables.product.prodname_dotcom_the_website %}。 - -当 {% data variables.product.product_location_enterprise %} 接收到有关漏洞的信息时，它将识别实例中使用受影响版本依赖项的仓库，并向这些仓库中具有管理员访问权限的所有者和人员发送安全警报。 您可以自定义接收安全警报的方式。 更多信息请参阅“[关于易受攻击的依赖项的警报](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies/#configuring-notifications-for-security-alerts)”。 - -### 为 {% data variables.product.prodname_ghe_server %} 上易受攻击的依赖项启用安全警报 - -为 {% data variables.product.product_location_enterprise %} 上易受攻击的依赖项启用安全警报前，必须将 {% data variables.product.product_location_enterprise %} 连接到 {% data variables.product.prodname_dotcom_the_website %}。 更多信息请参阅“[将 {% data variables.product.prodname_ghe_server %} 连接到 {% data variables.product.prodname_ghe_cloud %}](/enterprise/{{ currentVersion }}/admin/guides/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)”。 - -{% if currentVersion ver_gt "enterprise-server@2.20" %} 我们建议配置前几天的安全警报不发通知，以避免电子邮件过载。 几天后，您可以启用通知，像平常一样接收安全警报。{% endif %} - -{% data reusables.enterprise_site_admin_settings.sign-in %} -2. 在管理 shell 中，为 {% data variables.product.product_location_enterprise %} 上易受攻击的依赖项启用安全警报： - ``` shell -$ ghe-dep-graph-enable -``` -3. 返回到 {% data variables.product.prodname_ghe_server %}。 -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %}{% if currentVersion ver_gt "enterprise-server@2.20" %} -5. 在“Repositories can be scanned for vulnerabilities（可扫描仓库漏洞）”下，使用下拉菜单，并选择 **Enabled without notifications（启用但不发通知）**。 （可选）要启用包含通知的警报，请选择 **Enabled with notifications（启用并发通知）**。{% else %} -5. 在“Repositories can be scanned for vulnerabilities”下，使用下拉菜单，然后选择 **Enabled**。 -{% endif %} - ![用于启用扫描仓库有无漏洞的下拉菜单](/assets/images/enterprise/site-admin-settings/enable-vulnerability-scanning-in-repositories.png) - -### 查看 {% data variables.product.prodname_ghe_server %} 上易受攻击的依赖项 - -您可以查看 {% data variables.product.product_location_enterprise %} 中的所有漏洞，然后手动同步 {% data variables.product.prodname_dotcom_the_website %} 中的漏洞数据，以更新列表。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -2. 在左侧边栏中，单击 **Vulnerabilities**。 ![站点管理员边栏中的 Vulnerabilities 选项卡](/assets/images/enterprise/business-accounts/vulnerabilities-tab.png) -3. 要同步漏洞数据，请单击 **Sync Vulnerabilities now**。 ![Sync vulnerabilities now 按钮](/assets/images/enterprise/site-admin-settings/sync-vulnerabilities-button.png) diff --git a/translations/zh-CN/content/admin/developer-workflow/about-pre-receive-hooks.md b/translations/zh-CN/content/admin/developer-workflow/about-pre-receive-hooks.md deleted file mode 100644 index 953911b3dd66..000000000000 --- a/translations/zh-CN/content/admin/developer-workflow/about-pre-receive-hooks.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: 关于预接收挂钩 -intro: '*预接收挂钩*是在 {% data variables.product.prodname_ghe_server %} 设备上运行的脚本，可用于实施质量检查。' -redirect_from: - - /enterprise/admin/developer-workflow/about-pre-receive-hooks -versions: - enterprise-server: '*' ---- - -当发生推送时，每个脚本都在隔离的环境中运行，并且可以对推送的内容执行检查。 如果 exit status 为 0，脚本将导致接受推送，如果 exit status 不为零，则会拒绝接受推送。 - -### 使用场景 -使用预接收挂钩来满足业务规则、强制执行法规遵从性，并防止出现某些常见错误。 - -如何使用预接收挂钩的示例： - -- 需要提交消息来遵循特定的模式或格式，例如包括有效的事件单号或超过一定长度。 -- 通过拒绝所有推送来锁定分支或仓库。 -- 通过阻止关键词、模式或文件类型来防止将敏感数据添加到仓库。 -- 防止 PR 作者合并他们自己的更改。 - -### 对性能和工作流程的影响 -对开发者及其工作流程的影响可能很大，因此必须谨慎考虑。 基于业务需求并经过深思熟虑实施的预接收挂钩将为整个组织带来最大好处。 - -预接收挂钩可能会对 {% data variables.product.product_location_enterprise %} 的性能产生意外影响，因此应谨慎实施和审查。 diff --git a/translations/zh-CN/content/admin/developer-workflow/about-protected-branches-and-required-status-checks.md b/translations/zh-CN/content/admin/developer-workflow/about-protected-branches-and-required-status-checks.md deleted file mode 100644 index 2b5bcafe9fec..000000000000 --- a/translations/zh-CN/content/admin/developer-workflow/about-protected-branches-and-required-status-checks.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: 关于受保护分支和必需状态检查 -intro: '受保护分支确保仓库的协作者无法对分支进行不可撤销的更改。 必需状态检查确保在协作者可以对受保护分支进行更改前，所有必需的 CI 测试都已通过。 属于组织的仓库内的分支可配置为只允许特定用户{% if currentVersion ver_gt "enterprise-server@2.18" %},{% else %}或{% endif %}团队{% if currentVersion ver_gt "enterprise-server@2.18" %}或应用{% endif %}推送到该分支。' -redirect_from: - - /enterprise/admin/developer-workflow/about-protected-branches-and-required-status-checks -versions: - enterprise-server: '*' ---- - -*受保护分支*在仓库管理员选择保护的分支上阻止 Git 的多个功能。 受保护分支： - -* 无法被强制推送 -* 无法被删除 -* 在[必需状态检查](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/configuring-protected-branches-and-required-status-checks#enabling-required-status-checks)通过前，无法将更改合并到其中 - -对仓库具有管理员权限的任何人始终能够推送到受保护分支。 如果启用*分支限制*，则只有被授予权限的用户{% if currentVersion ver_gt "enterprise-server@2.18" %},{% else %}或{% endif %}团队{% if currentVersion ver_gt "enterprise-server@2.18" %}或应用{% endif %}才能推送到受保护分支。 更多信息请参阅”[配置受保护分支和必需状态检查](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/configuring-protected-branches-and-required-status-checks)“。 - -![限制的分支权限](/assets/images/help/repository/restrict-branch-users.png). - -{% tip %} - -**注：**如果选中“Include administrators（包括管理员）”，并且您对分支[启用了必需状态检查](/articles/enabling-required-status-checks)，但状态检查失败，则即使是具有管理员权限的人员{% if currentVersion ver_gt "enterprise-server@2.18" %}和应用{% endif %}，将更改推送到受保护分支的任何尝试也会失败。 - -{% endtip %} diff --git a/translations/zh-CN/content/admin/developer-workflow/blocking-force-pushes-on-your-appliance.md b/translations/zh-CN/content/admin/developer-workflow/blocking-force-pushes-on-your-appliance.md deleted file mode 100644 index 56571972f3a2..000000000000 --- a/translations/zh-CN/content/admin/developer-workflow/blocking-force-pushes-on-your-appliance.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: 阻止您设备上的强制推送 -redirect_from: - - /enterprise/admin/articles/blocking-force-pushes-on-your-appliance/ - - /enterprise/admin/developer-workflow/blocking-force-pushes-on-your-appliance -intro: '任何站点管理员都可以阻止 {% data variables.product.prodname_ghe_server %} 设备上的所有强制推送 (git push --force)' -versions: - enterprise-server: '*' ---- - -每个仓库都从其所属的用户帐户或组织的设置继承了默认强制推送设置。 同样，每个组织和用户帐户都会从整个设备的强制推送设置继承默认强制推送设置。 如果更改设备的强制推送设置，则会更改任何用户或组织拥有的所有仓库。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -4. 在“Force pushes（强制推送）”下，使用下拉菜单，然后单击 **Allow（允许）**、**Block（阻止）**或 **Block to the default branch（阻止到默认分支）**。 ![强制推送下拉菜单](/assets/images/enterprise/site-admin-settings/force-pushes-dropdown.png) -5. 可以视情况选择 **Enforce on all repositories**，这将覆盖强制推送的组织和仓库级别设置。 - -### 延伸阅读 - -- “[阻止对用户帐户或组织拥有的仓库进行强制推送](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization)” -- “[阻止对仓库进行强制推送](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository)” diff --git a/translations/zh-CN/content/admin/developer-workflow/blocking-force-pushes-to-a-repository.md b/translations/zh-CN/content/admin/developer-workflow/blocking-force-pushes-to-a-repository.md deleted file mode 100644 index 69104ffe2155..000000000000 --- a/translations/zh-CN/content/admin/developer-workflow/blocking-force-pushes-to-a-repository.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: 阻止对仓库进行强制推送 -redirect_from: - - /enterprise/admin/articles/blocking-force-pushes-to-a-repository/ - - /enterprise/admin/articles/block-force-pushes/ - - /enterprise/admin/developer-workflow/blocking-force-pushes-to-a-repository -intro: 您可以阻止所有分支上的强制推送（“git push --force”）— 或者仅阻止仓库默认分支上的强制推送。 -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_site_admin_settings.override-policy %} - -{% data reusables.enterprise_site_admin_settings.sign-in %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -4. 在 **Push and Pull（推送和拉取）**下，选择 **Block（阻止）**或 **Block to the default branch（阻止到默认分支）**。 ![阻止强制推送](/assets/images/enterprise/site-admin-settings/repo/repo-block-force-pushes.png) - -变更立即生效。 如果您以后改变主意，可以轻松重新允许强制推送。 - -## 延伸阅读 - -- “[阻止对用户帐户或组织拥有的仓库进行强制推送](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization)” -- “[阻止设备上的强制推送](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-on-your-appliance)” diff --git a/translations/zh-CN/content/admin/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization.md b/translations/zh-CN/content/admin/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization.md deleted file mode 100644 index 4a4f3e9feacf..000000000000 --- a/translations/zh-CN/content/admin/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: 阻止对用户帐户或组织拥有的仓库进行强制推送 -redirect_from: - - /enterprise/admin/articles/blocking-force-pushes-for-a-user-account/ - - /enterprise/admin/articles/blocking-force-pushes-for-an-organization/ - - /enterprise/admin/articles/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization/ - - /enterprise/admin/developer-workflow/blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization -intro: 您可以阻止所有分支上的强制推送（“git push --force”）或仅阻止用户帐户或组织拥有的仓库的默认分支上的强制推送。 -versions: - enterprise-server: '*' ---- - -仓库从它们所属的用户帐户或组织继承强制推送设置。 反过来，用户帐户和组织从整个设备的强制推送设置继承其强制推送设置。 - -您可以通过配置用户帐户或组织的设置来覆盖默认的继承设置。 - -{% data reusables.enterprise_site_admin_settings.sign-in %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.search-user-or-org %} -{% data reusables.enterprise_site_admin_settings.click-user-or-org %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -5. 在“Force pushes”部分的“Repository default settings”下，选择 - - **Block** 来阻止对所有分支进行强制推送。 - - **Block to the default branch** 来仅阻止对默认分支进行强制推送。 ![阻止强制推送](/assets/images/enterprise/site-admin-settings/user/user-block-force-pushes.png) -6. 可以视情况选择 **Enforce on all repositories** 来覆盖仓库特定的设置。 注意，这**不**会覆盖设备范围的策略。 ![阻止强制推送](/assets/images/enterprise/site-admin-settings/user/user-block-all-force-pushes.png) 变更立即生效。 如果您以后改变主意，可以重新允许强制推送。 - -### 延伸阅读 - -- “[阻止对仓库进行强制推送](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository)” -- “[阻止设备上的强制推送](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-on-your-appliance)” diff --git a/translations/zh-CN/content/admin/developer-workflow/blocking-force-pushes.md b/translations/zh-CN/content/admin/developer-workflow/blocking-force-pushes.md deleted file mode 100644 index f37c83ab99c4..000000000000 --- a/translations/zh-CN/content/admin/developer-workflow/blocking-force-pushes.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: 阻止强制推送 -intro: '您可以阻止 {% data variables.product.prodname_ghe_server %} 设备的所有仓库上、组织拥有的所有仓库上或特定仓库上的强制推送。' -mapTopic: true -redirect_from: - - /enterprise/admin/developer-workflow/blocking-force-pushes -versions: - enterprise-server: '*' ---- - diff --git a/translations/zh-CN/content/admin/developer-workflow/configuring-protected-branches-and-required-status-checks.md b/translations/zh-CN/content/admin/developer-workflow/configuring-protected-branches-and-required-status-checks.md deleted file mode 100644 index d519afe6cdbd..000000000000 --- a/translations/zh-CN/content/admin/developer-workflow/configuring-protected-branches-and-required-status-checks.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: 配置受保护分支和必需状态检查 -intro: 您可以启用受保护分支来限制分支操作，以及在分支合并到拉取请求中之前或在将本地分支上的提交推送到受保护远程分支之前强制执行必需状态检查。 -redirect_from: - - /enterprise/admin/developer-workflow/configuring-protected-branches-and-required-status-checks -versions: - enterprise-server: '*' ---- - -任何对仓库有管理员权限的人都可以启用分支限制。 - -### 为仓库启用受保护分支 - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -{% data reusables.repositories.repository-branches %} -{% data reusables.repositories.add-branch-protection-rules %} -5. 单击 **Create（创建）**。 - -### 必需状态检查的类型 - -| 必需状态检查的类型 | 设置 | 合并要求 | 考虑因素 | -| --------- | ------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------------------------------- | -| **严格** | 选中 **Require branches to be up-to-date before merging（合并前需要分支保持最新状态）**复选框。 | 在合并之前，**必须**使用基础分支使分支保持最新状态。 | 这是必需状态检查的默认行为。 可能需要更多构建，因为在其他协作者将拉取请求合并到受保护基础分支后，您需要使头部分支保持最新状态。 | -| **宽松** | **不**选中 **Require branches to be up-to-date before merging（合并前需要分支保持最新状态）**复选框。 | 在合并之前，**不**必使用基础分支使分支保持最新状态。 | 您将需要更少的构建，因为在其他协作者合并拉取请求后，您不需要使头部分支保持最新状态。 如果存在与基础分支不兼容的变更，则在合并分支后，状态检查可能会失败。 | -| **已禁用** | **不**选中 **Require status checks to pass before merging（合并前需要状态检查通过）**复选框。 | 分支没有合并限制。 | 如果未启用必需状态检查，协作者可以随时合并分支，无论它是否使用基础分支保持最新状态。 这增加了不兼容变更的可能性。 | - -### 启用必需状态检查 - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -{% data reusables.repositories.repository-branches %} -{% data reusables.repositories.add-branch-protection-rules %} -5. 选中 **Require status checks to pass before merging（合并前必需状态检查通过）**。 ![必需状态检查选项](/assets/images/help/repository/required-status-checks.png) -6. 从可用状态检查列表中，选择您想要设为必需的状态检查。 ![可用状态检查列表](/assets/images/help/repository/required-statuses-list.png) -{% data reusables.repositories.include-administrators %} -8. 视情况可以取消选中 **Require branches to be up to date before merging（在合并前要求分支保持最新状态）**。 如果选中，则可确保使用基础分支上的最新代码来测试分支。 ![宽松或严格的必需状态复选框](/assets/images/help/repository/protecting-branch-loose-status-new.png) -9. （可选）选择 {% if currentVersion ver_gt "enterprise-server@2.18" %}**Restrict who can push to matching branches（限制谁可以推送到匹配的分支）**{% else %}**Restrict who can push to this branch（限制谁可以推送到此分支）**{% endif %}。 ![分支限制复选框]{% if currentVersion ver_gt "enterprise-server@2.18" %}(/assets/images/help/repository/restrict-branch.png){% else %}(/assets/images/help/repository/restrict-branch-push.png){% endif %} -10. 搜索并选择将有权推送到受保护分支的人员{% if currentVersion ver_gt "enterprise-server@2.18" %}、{% else %}或{% endif %}团队{% if currentVersion ver_gt "enterprise-server@2.18" %}或应用{% endif %}。 ![分支限制搜索](/assets/images/help/repository/restrict-branch-search.png) -11. 单击 **Create（创建）**。 - -{% data reusables.repositories.required-status-merge-tip %} diff --git a/translations/zh-CN/content/admin/developer-workflow/continuous-integration-using-jenkins.md b/translations/zh-CN/content/admin/developer-workflow/continuous-integration-using-jenkins.md deleted file mode 100644 index 55832c4fe66c..000000000000 --- a/translations/zh-CN/content/admin/developer-workflow/continuous-integration-using-jenkins.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: 使用 Jenkins 的持续集成 -intro: '当向 {% data variables.product.product_location_enterprise %} 中的仓库进行推送时，您可以在 Jenkins 服务器上自动触发构建作业。' -redirect_from: - - /enterprise/admin/developer-workflow/continuous-integration-using-jenkins -versions: - enterprise-server: '*' ---- - -### 要求 - -- 按照我们的白皮书“[使用 Jenkins 和 GitHub 实现 CI 的实用指南](https://resources.github.com/whitepapers/practical-guide-to-CI-with-Jenkins-and-GitHub/)”，逐步了解如何在向 {% data variables.product.product_location_enterprise %} 中的仓库进行推送时在 Jenkins 服务器上自动触发构建作业。 diff --git a/translations/zh-CN/content/admin/developer-workflow/creating-a-pre-receive-hook-environment.md b/translations/zh-CN/content/admin/developer-workflow/creating-a-pre-receive-hook-environment.md deleted file mode 100644 index 3897e7ea48b4..000000000000 --- a/translations/zh-CN/content/admin/developer-workflow/creating-a-pre-receive-hook-environment.md +++ /dev/null @@ -1,92 +0,0 @@ ---- -title: 创建预接收挂钩环境 -intro: 要执行预接收挂钩，请使用默认的预接收环境，或者创建自定义环境。 -redirect_from: - - /enterprise/admin/developer-workflow/creating-a-pre-receive-hook-environment -versions: - enterprise-server: '*' ---- - -{% data variables.product.prodname_ghe_server %} 的预接收环境是 Linux [`chroot`](https://en.wikipedia.org/wiki/Chroot) 环境。 由于预接收挂钩会在每个推送事件上执行，因此它们应该快速且轻量化。 这类检查需要的环境通常极少。 - -{% data variables.product.prodname_ghe_server %} 提供了一个默认环境，其中包括以下包：`awk`、`bash`、`coreutils`、`curl`、`find`、`gnupg`、`grep`、`jq`、`sed`。 - -如果您具有此环境未满足的特定要求（例如对特定语言的支持），则可以创建并上传您自己的 64 位 Linux `chroot` 环境。 - -### 使用 Docker 创建预接收挂钩环境 - -您可以使用 Linux 容器管理工具来构建预接收挂钩环境。 此示例使用 [Alpine Linux](http://www.alpinelinux.org/) 和 [Docker](https://www.docker.com/)。 - -{% data reusables.linux.ensure-docker %} -2. 创建包含此信息的文件 `Dockerfile.alpine-3.3`： - - ``` - FROM gliderlabs/alpine:3.3 - RUN apk add --no-cache git bash - ``` -3. 从包含 `Dockerfile.dev` 的工作目录中，构建一个镜像： - - ```shell - $ docker build -f Dockerfile.alpine-3.3 -t pre-receive.alpine-3.3 . - > Sending build context to Docker daemon 12.29 kB - > Step 1 : FROM gliderlabs/alpine:3.3 - > ---> 8944964f99f4 - > Step 2 : RUN apk add --no-cache git bash - > ---> Using cache - > ---> 0250ab3be9c5 - > Successfully built 0250ab3be9c5 - ``` -4. 创建一个容器： - - ```shell - $ docker create --name pre-receive.alpine-3.3 pre-receive.alpine-3.3 /bin/true - ``` -5. 将 Docker 容器导出到 `gzip` 压缩的 `tar` 文件： - - ```shell - $ docker export pre-receive.alpine-3.3 | gzip > alpine-3.3.tar.gz - ``` - - 此文件 `alpine-3.3.tar.gz` 已准备好上传到 {% data variables.product.prodname_ghe_server %} 设备。 - -### 使用 chroot 创建预接收挂钩环境 - -1. 创建 Linux `chroot` 环境。 -2. 创建 `chroot` 目录的 `gzip` 压缩 `tar` 文件： - ```shell - $ cd /path/to/chroot - $ tar -czf /path/to/pre-receive-environment.tar.gz . - ``` - - {% note %} - - **注：** - - 不要在 tar 存档中包含文件的主目录路径，如 `/path/to/chroot`。 - - `/bin/sh` 必须存在并且可执行，作为 chroot 环境的入口点。 - - 与传统的 chroot 不同，预接收挂钩的 chroot 环境不需要 `dev` 目录。 - - {% endnote %} - -关于创建 chroot 环境的更多信息，请参阅 *Debian Wiki* 中的“[Chroot](https://wiki.debian.org/chroot)”、*Ubuntu 社区帮助 Wiki* 中的“[BasicChroot](https://help.ubuntu.com/community/BasicChroot)”，或者 *Alpine Linux Wiki* 中的“[在 chroot 中安装 Alpine Linux](http://wiki.alpinelinux.org/wiki/Installing_Alpine_Linux_in_a_chroot)”。 - -### 在 {% data variables.product.prodname_ghe_server %} 上上传预接收挂钩环境 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.hooks-tab %} -5. 单击 **Manage environments**。 ![管理环境](/assets/images/enterprise/site-admin-settings/manage-pre-receive-environments.png) -6. 单击 **Add environment**。 ![添加环境](/assets/images/enterprise/site-admin-settings/add-pre-receive-environment.png) -7. 在 **Environment name** 字段中输入所需的名称。 ![环境名称](/assets/images/enterprise/site-admin-settings/pre-receive-environment-name.png) -8. 输入包含您的环境的 `* .tar.gz` 文件的 URL。 ![从 URL 上传环境](/assets/images/enterprise/site-admin-settings/upload-environment-from-url.png) -9. 单击 **Add environment**。 ![Add environment 按钮](/assets/images/enterprise/site-admin-settings/add-environment-button.png) - -### 通过管理 shell 上传预接收挂钩环境 -1. 将包含您的环境的可读 `* .tar.gz` 文件上传到 web 主机并复制 URL 或通过 `scp` 将文件传送到 {% data variables.product.prodname_ghe_server %} 设备。 使用 `scp` 时，您可能需要调整 `* .tar.gz` 文件权限，以使该文件全局可读。 -1. 连接到管理 shell。 -2. 使用 `ghe-hook-env-create` 命令并输入所需的环境名称作为第一个参数，然后将包含环境的 `* .tar.gz` 文件的完整本地路径或 URL 作为第二个参数。 - - ```shell - admin@ghe-host:~$ ghe-hook-env-create AlpineTestEnv /home/admin/alpine-3.3.tar.gz - > Pre-receive hook environment 'AlpineTestEnv' (2) has been created. - ``` diff --git a/translations/zh-CN/content/admin/developer-workflow/creating-a-pre-receive-hook-script.md b/translations/zh-CN/content/admin/developer-workflow/creating-a-pre-receive-hook-script.md deleted file mode 100644 index 35588a631bf7..000000000000 --- a/translations/zh-CN/content/admin/developer-workflow/creating-a-pre-receive-hook-script.md +++ /dev/null @@ -1,199 +0,0 @@ ---- -title: 创建预接收挂钩脚本 -intro: 使用预接收挂钩脚本创建基于内容来接受或拒绝推送的要求。 -redirect_from: - - /enterprise/admin/developer-workflow/creating-a-pre-receive-hook-script -versions: - enterprise-server: '*' ---- - -您可以在 [`github/platform-samples` 仓库](https://github.com/github/platform-samples/tree/master/pre-receive-hooks)中查看 {% data variables.product.prodname_ghe_server %} 的预接收挂钩示例。 - -### 编写预接收挂钩脚本 -预接收挂钩脚本在 {% data variables.product.prodname_ghe_server %} 设备上的预接收挂钩环境中执行。 创建预接收挂钩脚本时，请考虑可用的输入、输出、exit-status 和环境变量。 - -#### 输入 (stdin) -在推送发生之后以及在远程仓库上更新任何 ref 之前，`git-receive-pack` 进程会调用预接收挂钩脚本，其中要更新的每个 ref 使用一行标准输入： - -` SP SP LF` - -此字符串表示以下参数： - -| 参数 | 描述 | -|:------------------- |:------------------------------------------------- | -| `` | 存储在 `ref` 中的旧对象名称。
    当您*创建*新的 `ref` 时，这等于 40 个零。 | -| `` | 要存储在 `ref` 中的新对象名称。
    当您*删除* `ref` 时，这等于 40 个零。 | -| `` | `ref` 的全名。 | - -关于 `git-receive-pack` 的更多信息，请参阅 Git 文档中的“[git-receive-pack](https://git-scm.com/docs/git-receive-pack)”。 关于 `ref` 的更多信息，请参阅 *Pro Git* 中的“[Git 引用](https://git-scm.com/book/en/v2/Git-Internals-Git-References)”。 - -#### 输出 (stdout) - -脚本输出 (`stdout`) 将传递回客户端，因此用户可以在命令行或用户界面中看到任意 `echo` 语句。 - -#### Exit-status - -预接收脚本的 `exit-status` 决定是否接受推送。 - -| Exit-status 值 | 操作 | -|:-------------:|:------:| -| 0 | 将接受推送。 | -| 非零 | 将拒绝推送。 | - -#### 环境变量 -除了提供给 `stdin` 的值以外，还有一些其他变量可用于在 {% data variables.product.prodname_ghe_server %} 上运行的预接收挂钩脚本。 - -| 变量 | 描述 | -|:------------------------------------- |:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| $GITHUB_USER_LOGIN | 创建 `ref` 的用户 ID。 | -| $GIT_DIR | 设备上远程仓库的路径。 | -| $GITHUB_USER_IP | 执行推送的用户的 IP 地址。 | -| $GITHUB_REPO_NAME | 正在更新的仓库的 `owner`/`repo` 格式的名称。 | -| $GITHUB_PULL_REQUEST_AUTHOR_LOGIN | 在您的实例上打开的拉取请求的作者的用户 ID。 | -| $GITHUB_REPO_PUBLIC | 一个布尔值，为 `true` 时表示公共仓库，为 `false` 时表示私有仓库。 | -| $GITHUB_PUBLIC_KEY_FINGERPRINT | 用户的公钥指纹。 | -| $GITHUB_PULL_REQUEST_HEAD | 格式中的字符串：`user:branch`，适用于 PR 的 HEAD。
    示例：`octocat:fix-bug` | -| $GITHUB_PULL_REQUEST_BASE | 格式中的字符串：`user:branch`，适用于 PR 的 BASE。
    示例：`octocat:master` | -| $GITHUB_VIA | 用于创建 ref 的方法。
    **可选值：**
    - `auto-merge deployment api`
    - `blob edit`
    - `branch merge api`
    - `branches page delete button`
    - `git refs create api`
    - `git refs delete api`
    - `git refs update api`
    - `merge api`
    - `pull request branch delete button`
    - `pull request branch undo button`
    - `pull request merge api`
    - `pull request merge button`
    - `pull request revert button`
    - `releases delete button`
    - `stafftools branch restore`
    - `slumlord (#{sha})` | -| $GIT_PUSH_OPTION_COUNT | 客户端发送的推送选项数。 关于推送选项的更多信息，请参阅 Git 文档中的“[git-push](https://git-scm.com/docs/git-push#git-push---push-optionltoptiongt)”。 | -| $GIT_PUSH_OPTION_N | 其中 N 是一个从 0 开始的整数，此变量包含客户端发送的推送选项字符串。 发送的第一个选项存储在 GIT_PUSH_OPTION_0 中，发送的第二个选项存储在 GIT_PUSH_OPTION_1 中，依此类推。 关于推送选项的更多信息，请参阅 Git 文档中的“[git-push](https://git-scm.com/docs/git-push#git-push---push-optionltoptiongt)”。 | - -### 设置权限并将预接收挂钩推送到 {% data variables.product.prodname_ghe_server %} - -{% data variables.product.prodname_ghe_server %} 设备上的仓库中包含预接收挂钩脚本。 站点管理员必须考虑仓库权限，确保只有适当的用户才能访问。 - -我们建议将挂钩合并到单个仓库。 如果统一的挂钩仓库是公共的，则可以使用 `README.md` 来解释策略强制实施。 此外，也可以通过拉取请求接受贡献。 但是，只能从默认分支添加预接收挂钩。 对于测试工作流程，应使用具有配置的仓库的分支。 - -1. 对于 Mac 用户，确保脚本具有执行权限： - - ```shell - $ sudo chmod +x SCRIPT_FILE.sh - ``` - 对于 Windows 用户，确保脚本具有执行权限： - - ```shell - git update-index --chmod=+x SCRIPT_FILE.sh - ``` - -2. 提交并推送到 {% data variables.product.prodname_ghe_server %} 实例上指定的预接收挂钩仓库。 - - ```shell - $ git commit -m "YOUR COMMIT MESSAGE" - $ git push - ``` - -3. 在 {% data variables.product.prodname_ghe_server %} 实例上[创建预接收挂钩](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance/#creating-pre-receive-hooks)。 - -### 在本地测试预接收脚本 -在 {% data variables.product.prodname_ghe_server %} 设备上创建或更新预接收挂钩脚本之前，您可以在本地对其进行测试。 一种方法是创建本地 Docker 环境以充当可以执行预接收挂钩的远程仓库。 - -{% data reusables.linux.ensure-docker %} - -2. 创建一个名为 `Dockerfile.dev` 的文件，其中包含： - - ``` - FROM gliderlabs/alpine:3.3 - RUN \ - apk add --no-cache git openssh bash && \ - ssh-keygen -A && \ - sed -i "s/#AuthorizedKeysFile/AuthorizedKeysFile/g" /etc/ssh/sshd_config && \ - adduser git -D -G root -h /home/git -s /bin/bash && \ - passwd -d git && \ - su git -c "mkdir /home/git/.ssh && \ - ssh-keygen -t rsa -b 4096 -f /home/git/.ssh/id_rsa -P '' && \ - mv /home/git/.ssh/id_rsa.pub /home/git/.ssh/authorized_keys && \ - mkdir /home/git/test.git && \ - git --bare init /home/git/test.git" - - VOLUME ["/home/git/.ssh", "/home/git/test.git/hooks"] - WORKDIR /home/git - - CMD ["/usr/sbin/sshd", "-D"] - ``` - -3. 创建一个名为 `always_reject.sh` 的测试预接收脚本。 此示例脚本将拒绝所有推送，这对于锁定仓库非常有用： - - ``` - #!/usr/bin/env bash - - echo "error: rejecting all pushes" - exit 1 - ``` - -4. 确保 `always_reject.sh` 脚本具有执行权限： - - ```shell - $ chmod +x always_reject.sh - ``` - -5. 从包含 `Dockerfile.dev` 的目录中，构建一个镜像： - - ```shell - $ docker build -f Dockerfile.dev -t pre-receive.dev . - > Sending build context to Docker daemon 3.584 kB - > Step 1 : FROM gliderlabs/alpine:3.3 - > ---> 8944964f99f4 - > Step 2 : RUN apk add --no-cache git openssh bash && ssh-keygen -A && sed -i "s/#AuthorizedKeysFile/AuthorizedKeysFile/g" /etc/ssh/sshd_config && adduser git -D -G root -h /home/git -s /bin/bash && passwd -d git && su git -c "mkdir /home/git/.ssh && ssh-keygen -t rsa -b 4096 -f /home/git/.ssh/id_rsa -P ' && mv /home/git/.ssh/id_rsa.pub /home/git/.ssh/authorized_keys && mkdir /home/git/test.git && git --bare init /home/git/test.git" - > ---> Running in e9d79ab3b92c - > fetch http://alpine.gliderlabs.com/alpine/v3.3/main/x86_64/APKINDEX.tar.gz - > fetch http://alpine.gliderlabs.com/alpine/v3.3/community/x86_64/APKINDEX.tar.gz - ....truncated output.... - > OK: 34 MiB in 26 packages - > ssh-keygen: generating new host keys: RSA DSA ECDSA ED25519 - > Password for git changed by root - > Generating public/private rsa key pair. - > Your identification has been saved in /home/git/.ssh/id_rsa. - > Your public key has been saved in /home/git/.ssh/id_rsa.pub. - ....truncated output.... - > Initialized empty Git repository in /home/git/test.git/ - > Successfully built dd8610c24f82 - ``` - -6. 运行包含生成的 SSH 密钥的数据容器： - - ```shell - $ docker run --name data pre-receive.dev /bin/true - ``` - -7. 将测试预接收挂钩 `always_reject.sh` 复制到数据容器中： - - ```shell - $ docker cp always_reject.sh data:/home/git/test.git/hooks/pre-receive - ``` - -8. 启动一个运行 `sshd` 的应用程序容器并执行挂钩。 记下返回的容器 ID： - - ```shell - $ docker run -d -p 52311:22 --volumes-from data pre-receive.dev - > 7f888bc700b8d23405dbcaf039e6c71d486793cad7d8ae4dd184f4a47000bc58 - ``` - -9. 将生成的 SSH 密钥从数据容器复制到本地计算机： - - ```shell - $ docker cp data:/home/git/.ssh/id_rsa . - ``` - -10. 修改远程测试仓库并将其推送到 Docker 容器中的 `test.git` 仓库。 此示例使用了 `git@github.com:octocat/Hello-World.git`，但您可以使用想要的任何仓库。 此示例假定您的本地计算机 (127.0.0.1) 绑定了端口 52311，但如果 docker 在远程计算机上运行，则可以使用不同的 IP 地址。 - - ```shell - $ git clone git@github.com:octocat/Hello-World.git - $ cd Hello-World - $ git remote add test git@127.0.0.1:test.git - $ GIT_SSH_COMMAND="ssh -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no -p 52311 -i ../id_rsa" git push -u test master - > Warning: Permanently added '[192.168.99.100]:52311' (ECDSA) to the list of known hosts. - > Counting objects: 7, done. - > Delta compression using up to 4 threads. - > Compressing objects: 100% (3/3), done. - > Writing objects: 100% (7/7), 700 bytes | 0 bytes/s, done. - > Total 7 (delta 0), reused 7 (delta 0) - > remote: error: rejecting all pushes - > To git@192.168.99.100:test.git - > ! [remote rejected] master -> master (pre-receive hook declined) - > error: failed to push some refs to 'git@192.168.99.100:test.git' - ``` - - 请注意，在执行预接收挂钩并回显脚本中的输出后，将拒绝推送。 - -### 延伸阅读 - - 来自 *Pro Git 网站*的“[自定义 Git - Git 强制实施策略示例](https://git-scm.com/book/en/v2/Customizing-Git-An-Example-Git-Enforced-Policy)” diff --git a/translations/zh-CN/content/admin/developer-workflow/customizing-your-instance-with-integrations.md b/translations/zh-CN/content/admin/developer-workflow/customizing-your-instance-with-integrations.md deleted file mode 100644 index ce884e2997da..000000000000 --- a/translations/zh-CN/content/admin/developer-workflow/customizing-your-instance-with-integrations.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: 使用集成自定义您的实例 -intro: '您可以将第三方应用程序与 {% data variables.product.product_location_enterprise %} 集成。' -mapTopic: true -redirect_from: - - /enterprise/admin/developer-workflow/customizing-your-instance-with-integrations -versions: - enterprise-server: '*' ---- - diff --git a/translations/zh-CN/content/admin/developer-workflow/establishing-pull-request-merge-conditions.md b/translations/zh-CN/content/admin/developer-workflow/establishing-pull-request-merge-conditions.md deleted file mode 100644 index d47f687f237d..000000000000 --- a/translations/zh-CN/content/admin/developer-workflow/establishing-pull-request-merge-conditions.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: 建立拉取请求合并条件 -intro: 您可以要求拉取请求在可以合并之前先通过一组检查。 例如，您可以阻止未通过状态检查的拉取请求。 -mapTopic: true -redirect_from: - - /enterprise/admin/developer-workflow/establishing-pull-request-merge-conditions -versions: - enterprise-server: '*' ---- - diff --git a/translations/zh-CN/content/admin/developer-workflow/index.md b/translations/zh-CN/content/admin/developer-workflow/index.md deleted file mode 100644 index d0c186037b4c..000000000000 --- a/translations/zh-CN/content/admin/developer-workflow/index.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: 实施策略和定制开发者工作流程 -redirect_from: - - /enterprise/admin/guides/installation/integrations/ - - /enterprise/admin/categories/integration/ - - /enterprise/admin/developer-workflow -intro: '本指南介绍了 {% data variables.product.prodname_enterprise %} 上的可用工具，这些工具有助于实现开发者工作流程和强制实施组织策略以降低风险和提升质量。' -versions: - enterprise-server: '*' ---- - - -### 目录 - -{% topic_link_in_list /blocking-force-pushes %} - {% link_in_list /blocking-force-pushes-on-your-appliance %} - {% link_in_list /blocking-force-pushes-to-repositories-owned-by-a-user-account-or-organization %} - {% link_in_list /blocking-force-pushes-to-a-repository %} -{% topic_link_in_list /using-webhooks-for-continuous-integration %} - {% link_in_list /continuous-integration-using-jenkins %} - {% link_in_list /troubleshooting-service-hooks %} -{% topic_link_in_list /using-pre-receive-hooks-to-enforce-policy %} - {% link_in_list /about-pre-receive-hooks %} - {% link_in_list /creating-a-pre-receive-hook-environment %} - {% link_in_list /creating-a-pre-receive-hook-script %} - {% link_in_list /managing-pre-receive-hooks-on-the-github-enterprise-server-appliance %} -{% topic_link_in_list /establishing-pull-request-merge-conditions %} - {% link_in_list /about-protected-branches-and-required-status-checks %} - {% link_in_list /configuring-protected-branches-and-required-status-checks %} -{% topic_link_in_list /customizing-your-instance-with-integrations %} - {% link_in_list /managing-projects-using-jira %} diff --git a/translations/zh-CN/content/admin/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance.md b/translations/zh-CN/content/admin/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance.md deleted file mode 100644 index e1e10632bae5..000000000000 --- a/translations/zh-CN/content/admin/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance.md +++ /dev/null @@ -1,59 +0,0 @@ ---- -title: 管理 GitHub Enterprise Server 设备上的预接收挂钩 -intro: '配置如何在 {% data variables.product.prodname_ghe_server %} 设备中使用预接收挂钩。' -redirect_from: - - /enterprise/admin/guides/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-appliance/ - - /enterprise/admin/developer-workflow/managing-pre-receive-hooks-on-the-github-enterprise-server-appliance -versions: - enterprise-server: '*' ---- - -### 创建预接收挂钩 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.hooks-tab %} -4. 单击 **Add pre-receive hook**。 ![添加预接收挂钩](/assets/images/enterprise/site-admin-settings/add-pre-receive-hook.png) -5. 在 **Hook name** 字段中，输入要创建的挂钩的名称。 ![为预接收挂钩命名](/assets/images/enterprise/site-admin-settings/hook-name.png) -6. 从 **Environment** 下拉菜单中，选择要在其上运行挂钩的环境。 ![挂钩环境](/assets/images/enterprise/site-admin-settings/environment.png) -7. 在 **Script（脚本）**下，从 **Select hook repository（选择挂钩仓库）**下拉菜单中，选择包含预接收挂钩脚本的仓库。 从 **Select file** 下拉菜单中，选择预接收挂钩脚本的文件名。 ![挂钩脚本](/assets/images/enterprise/site-admin-settings/hook-script.png) -8. 选择 **Use the exit-status to accept or reject pushes** 以强制执行脚本。 取消选中此选项可以在忽略 exit-status 值时测试脚本。 在此模式下，脚本的输出将在命令行中对用户可见，但在 web 界面上不可见。 ![使用 exit-status](/assets/images/enterprise/site-admin-settings/use-exit-status.png) -9. 如果希望预接收挂钩在所有仓库上运行，请选择 **Enable this pre-receive hook on all repositories by default**。 ![为所有仓库启用挂钩](/assets/images/enterprise/site-admin-settings/enable-hook-all-repos.png) -10. 选择 **Administrators can enable and disable this hook（管理员可以启用和禁用此挂钩）**，以允许具有管理员或所有者权限的组织成员选择要启用还是禁用此预接收挂钩。 ![管理员启用或禁用挂钩](/assets/images/enterprise/site-admin-settings/admins-enable-hook.png) - -### 编辑预接收挂钩 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.hooks-tab %} -1. 在要编辑的预接收挂钩旁边，单击 {% octicon "pencil" aria-label="The edit icon" %}。 ![编辑预接收挂钩](/assets/images/enterprise/site-admin-settings/edit-pre-receive-hook.png) - -### 删除预接收挂钩 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.hooks-tab %} -2. 在要删除的预接收挂钩旁边，单击 {% octicon "x" aria-label="X symbol" %}。 ![编辑预接收挂钩](/assets/images/enterprise/site-admin-settings/delete-pre-receive-hook.png) - -### 为组织配置预接收挂钩 - -仅当站点管理员在创建预接收挂钩时选择了 **Administrators can enable or disable this hook** 选项，组织管理员才能为组织配置挂钩权限。 要为仓库配置预接收挂钩，您必须是组织管理员或所有者。 - -{% data reusables.profile.enterprise_access_profile %} -{% data reusables.profile.access_org %} -{% data reusables.organizations.org_settings %} -4. 在左侧侧边栏中，单击 **Hooks**。 ![挂钩侧边栏](/assets/images/enterprise/orgs-and-teams/hooks-sidebar.png) -5. 在要配置的预接收挂钩旁边，单击 **Hook permissions** 下拉菜单。 选择要启用还是禁用预接收挂钩，或者允许仓库管理员对其进行配置。 ![挂钩权限](/assets/images/enterprise/orgs-and-teams/hook-permissions.png) - -### 为仓库配置预接收挂钩 - -仅当站点管理员在创建预接收挂钩时选择了 **Administrators can enable or disable this hook** 选项，仓库所有者才能配置挂钩。 在组织中，组织所​​有者还必须选择 **Configurable** 挂钩权限。 要为仓库配置预接收挂钩，您必须是仓库所有者。 - -{% data reusables.profile.enterprise_access_profile %} -2. 单击 **Repositories**，然后选择要为其配置预接收挂钩的仓库。 ![仓库](/assets/images/enterprise/repos/repositories.png) -{% data reusables.repositories.sidebar-settings %} -4. 在左侧边栏中，单击 **Hooks & Services**。 ![挂钩和服务](/assets/images/enterprise/repos/hooks-services.png) -5. 在要配置的预接收挂钩旁边，单击 **Hook permissions** 下拉菜单。 选择要启用还是禁用预接收挂钩。 ![仓库挂钩权限](/assets/images/enterprise/repos/repo-hook-permissions.png) diff --git a/translations/zh-CN/content/admin/developer-workflow/managing-projects-using-jira.md b/translations/zh-CN/content/admin/developer-workflow/managing-projects-using-jira.md deleted file mode 100644 index 13e610f93467..000000000000 --- a/translations/zh-CN/content/admin/developer-workflow/managing-projects-using-jira.md +++ /dev/null @@ -1,55 +0,0 @@ ---- -title: 使用 JIRA 管理项目 -intro: '您可以将 JIRA 与 {% data variables.product.prodname_enterprise %} 集成以进行项目管理。' -redirect_from: - - /enterprise/admin/guides/installation/project-management-using-jira/ - - /enterprise/admin/articles/project-management-using-jira/ - - /enterprise/admin/developer-workflow/managing-projects-using-jira -versions: - enterprise-server: '*' ---- - -### 将 JIRA 连接到 {% data variables.product.prodname_enterprise %} 组织 - -1. 在 http[s]://[hostname]/login 上登录您的 {% data variables.product.prodname_enterprise %} 帐户。 -1. 在任意页面的右上角，单击帐户设置（齿轮）图标。 -1. 在左侧边栏中，单击您组织的名称。 -1. 在左侧边栏中，单击 **Applications**。 -1. 在 **Organization applications** 框的右上角，单击 **Register new application**。 -1. 填写应用程序设置： - - 在 **Application name** 字段中，输入“JIRA”。 - - 在 **Homepage URL** 字段中，输入 JIRA 实例的完整 URL。 - - 在 **Authorization callback URL** 字段中，输入 JIRA 实例的完整 URL。 -1. 单击 **Register application（注册应用程序）**。 -1. 在页面顶部，记下 **Client ID** 和 **Client Secret**。 您将需要这些信息来配置 JIRA 实例。 - -### 将 JIRA 连接到 {% data variables.product.prodname_enterprise %} 个人帐户 - -1. 在 http[s]://[hostname]/login 上登录您的 {% data variables.product.prodname_enterprise %} 帐户。 -1. 在任意页面的右上角，单击帐户设置（齿轮）图标。 -1. 在左侧边栏中，单击 **Applications**。 -1. 在 **Developer applications** 框的右上角，单击 **Register new application**。 -1. 填写应用程序设置： - - 在 **Application name** 字段中，输入“JIRA”。 - - 在 **Homepage URL** 字段中，输入 JIRA 实例的完整 URL。 - - 在 **Authorization callback URL** 字段中，输入 JIRA 实例的完整 URL。 -1. 单击 **Register application（注册应用程序）**。 -1. 在页面顶部，记下 **Client ID** 和 **Client Secret**。 您将需要这些信息来配置 JIRA 实例。 - -### JIRA 实例配置 - -1. 在 JIRA 实例上，登录具有管理访问权限的帐户。 -1. 在页面顶部，单击设置（齿轮）图标。 -1. 在设置下拉列表中，选择 **Add-ons**。 -1. 在左侧边栏的 **Source control** 下，单击 **DVCS accounts**。 -1. 单击 **Link Bitbucket or GitHub account**。 -1. 在 **Add New Account** 模态中，填写您的 {% data variables.product.prodname_enterprise %} 设置： - - 从 **Host** 下拉菜单中，选择 **GitHub Enterprise**。 - - 在 **Team or User Account** 字段中，输入 {% data variables.product.prodname_enterprise %} 组织或个人帐户的名称。 - - 在 **OAuth Key** 字段中，输入 {% data variables.product.prodname_enterprise %} 开发者应用程序的客户端 ID。 - - 在 **OAuth Secret** 字段中，输入 {% data variables.product.prodname_enterprise %} 开发者应用程序的客户端密钥。 - - 如果您不想链接 {% data variables.product.prodname_enterprise %} 组织或个人帐户拥有的新仓库，请取消选择 **Auto Link New Repositories**。 - - 如果您不想启用智能提交，请取消选择 **Enable Smart Commits**。 - - 单击 **Add（添加）**。 -1. 查看您要授予 {% data variables.product.prodname_enterprise %} 帐户的权限，然后单击 **Authorize application**。 -1. 如有必要，请输入密码以继续。 diff --git a/translations/zh-CN/content/admin/developer-workflow/troubleshooting-service-hooks.md b/translations/zh-CN/content/admin/developer-workflow/troubleshooting-service-hooks.md deleted file mode 100644 index 3ebab29b5fea..000000000000 --- a/translations/zh-CN/content/admin/developer-workflow/troubleshooting-service-hooks.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: 排查服务挂钩问题 -intro: 如果没有交付有效负载，请检查这些常见问题。 -redirect_from: - - /enterprise/admin/articles/troubleshooting-service-hooks/ - - /enterprise/admin/developer-workflow/troubleshooting-service-hooks -versions: - enterprise-server: '*' ---- - -### 获取有关交付的信息 - -您可以在任意仓库中找到有关所有服务挂钩交付的最后响应的信息。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -2. 浏览到您要调查的仓库。 -3. 单击导航侧栏中的 **Hooks** 链接。 ![挂钩侧边栏](/assets/images/enterprise/settings/Enterprise-Hooks-Sidebar.png) -4. 单击有问题的服务挂钩下的 **Latest Delivery** 链接。 ![挂钩详情](/assets/images/enterprise/settings/Enterprise-Hooks-Details.png) -5. 在 **Remote Calls** 下，您将看到发布到远程服务器时使用的标头以及远程服务器发送回安装的响应。 - -### 查看有效负载 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -2. 浏览到您要调查的仓库。 -3. 单击导航侧栏中的 **Hooks** 链接。 ![挂钩侧边栏](/assets/images/enterprise/settings/Enterprise-Hooks-Sidebar.png) -4. 单击有问题的服务挂钩下的 **Latest Delivery** 链接。 -5. 单击 **Delivery**。 ![查看有效负载](/assets/images/enterprise/settings/Enterprise-Hooks-Payload.png) - -### 查看过去的交付 - -交付存储 15 天。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -2. 浏览到您要调查的仓库。 -3. 单击导航侧栏中的 **Hooks** 链接。 ![挂钩侧边栏](/assets/images/enterprise/settings/Enterprise-Hooks-Sidebar.png) -4. 单击有问题的服务挂钩下的 **Latest Delivery** 链接。 -5. 要查看针对该特定挂钩的其他交付，请单击 **More for this Hook ID**： ![查看更多交付](/assets/images/enterprise/settings/Enterprise-Hooks-More-Deliveries.png) diff --git a/translations/zh-CN/content/admin/developer-workflow/using-pre-receive-hooks-to-enforce-policy.md b/translations/zh-CN/content/admin/developer-workflow/using-pre-receive-hooks-to-enforce-policy.md deleted file mode 100644 index 5efac751dbf5..000000000000 --- a/translations/zh-CN/content/admin/developer-workflow/using-pre-receive-hooks-to-enforce-policy.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: 使用预接收挂钩来强制实施策略 -intro: 使用预接收挂钩在您的组织内强制实施工作流程标准。 预接收挂钩需要代码在推送被送入仓库之前传递一组预定义的质量检查。 -mapTopic: true -redirect_from: - - /enterprise/admin/developer-workflow/using-pre-receive-hooks-to-enforce-policy -versions: - enterprise-server: '*' ---- - diff --git a/translations/zh-CN/content/admin/developer-workflow/using-webhooks-for-continuous-integration.md b/translations/zh-CN/content/admin/developer-workflow/using-webhooks-for-continuous-integration.md deleted file mode 100644 index a6c23fe34211..000000000000 --- a/translations/zh-CN/content/admin/developer-workflow/using-webhooks-for-continuous-integration.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: 使用 web 挂钩进行持续集成 -intro: '如果您已经拥有开发和部署生态系统，则可以使用 web 挂钩将其与 {% data variables.product.prodname_ghe_server %} 集成。' -mapTopic: true -redirect_from: - - /enterprise/admin/developer-workflow/continuous-integration-using-travis-ci - - /enterprise/admin/developer-workflow/using-webhooks-for-continuous-integration -versions: - enterprise-server: '*' ---- - diff --git a/translations/zh-CN/content/admin/enterprise-management/monitoring-using-analytics.md b/translations/zh-CN/content/admin/enterprise-management/monitoring-using-analytics.md deleted file mode 100644 index d8c8045d9104..000000000000 --- a/translations/zh-CN/content/admin/enterprise-management/monitoring-using-analytics.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: Monitoring using analytics -intro: 'You can enable web analytics tools to track and analyze traffic for your {% data variables.product.prodname_ghe_server %} instance.' -redirect_from: - - /enterprise/admin/enterprise-management/monitoring-using-analytics -versions: - enterprise-server: '>2.21' ---- - -### Configuring Google Analytics - -To configure Google Analytics, you must have a [Google Analytics ID](https://analytics.google.com/) and authenticate to your {% data variables.product.prodname_ghe_server %} instance with SSH. 更多信息请参阅“[访问管理 shell (SSH)](/enterprise/admin/configuration/accessing-the-administrative-shell-ssh)。” - -```shell -$ ghe-config website-analytics.enabled true -$ ghe-config website-analytics.google-analytics-id GOOGLE-ANALYTICS-ID -$ ghe-config-apply -``` diff --git a/translations/zh-CN/content/admin/installation/about-enterprise-accounts.md b/translations/zh-CN/content/admin/installation/about-enterprise-accounts.md deleted file mode 100644 index 75c5f0f67a23..000000000000 --- a/translations/zh-CN/content/admin/installation/about-enterprise-accounts.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: 关于企业帐户 -intro: '使用 {% data variables.product.prodname_ghe_server %}，可以创建企业帐户，为管理员的帐单和许可使用情况提供单一的可见点和管理点。' -redirect_from: - - /enterprise/admin/installation/about-enterprise-accounts -versions: - enterprise-server: '*' ---- - -### 关于 {% data variables.product.prodname_ghe_server %} 上的企业账户 - -企业帐户可用于管理多个 {% data variables.product.prodname_dotcom %} 组织和 {% data variables.product.prodname_ghe_server %} 实例。 您的企业帐户必须有操作点，如 {% data variables.product.prodname_dotcom %} 上的组织或个人帐户。 企业管理员可以管理设置和首选项，如： - -- 成员访问和管理（组织成员、外部协作者） -- 帐单和使用（{% data variables.product.prodname_ghe_server %} 实例、用户许可、{% data variables.large_files.product_name_short %} 包） -- 安全性（单点登录、双重身份验证） -- 与 {% data variables.contact.enterprise_support %} 共享的请求和支持包 - -{% data reusables.enterprise-accounts.enterprise-accounts-billing %} - -有关 {% data variables.product.prodname_ghe_cloud %} 与 {% data variables.product.prodname_ghe_server %} 之间差异的更多信息，请参阅“[{% data variables.product.prodname_dotcom %} 的产品](/articles/githubs-products)”。 要升级至 {% data variables.product.prodname_enterprise %} 或开始使用企业帐户，请联系 {% data variables.contact.contact_enterprise_sales %}。 - -### 管理链接至企业帐户的 {% data variables.product.prodname_ghe_server %} 许可 - -{% data reusables.enterprise-accounts.admin-managing-licenses %} diff --git a/translations/zh-CN/content/admin/installation/about-geo-replication.md b/translations/zh-CN/content/admin/installation/about-geo-replication.md deleted file mode 100644 index 3d33092b73e4..000000000000 --- a/translations/zh-CN/content/admin/installation/about-geo-replication.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: 关于 Geo-replication -intro: '{% data variables.product.prodname_ghe_server %} 上的 Geo-replication 使用多个活动副本满足从异地分布式数据中心发出的请求。' -redirect_from: - - /enterprise/admin/installation/about-geo-replication -versions: - enterprise-server: '*' ---- - -多个活动副本可以提供到达最近副本的较短距离。 举例来说，一个在旧金山、纽约和伦敦均设有办事处的组织可以在靠近纽约的数据中心运行主设备，在靠近旧金山和伦敦的数据中心运行两个副本。 利用地理位置感知 DNS，用户可以转到距离最近的可用服务器，并更快地访问仓库数据。 如果将靠近旧金山的设备指定为主设备，则与伦敦的延迟会比较大，相比而言，将靠近纽约的设备指定为主设备有助于减小主机之间的延迟。 - -活动副本会将自身无法处理的请求委托主实例代为处理。 副本用作终止所有 SSL 连接的入口点。 与没有 Geo-replication 功能的双节点高可用性配置类似，主机之间的流量通过加密 VPN 连接发送。 - -Git 请求和特定的文件服务器请求（例如 LFS 和文件上传）可直接通过副本完成，无需从主设备加载任何数据。 Web 请求会始终传送到主设备，但在副本距离用户较近的情况下，由于 SSL 端接距离更近，请求速度更快。 - -为了让 Geo-replication 无缝运行，需要使用 Geo DNS，例如 [Amazon 的 Route 53 服务](http://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-policy.html#routing-policy-geo)。 实例的主机名应解析到距离用户最近的副本。 - -### 限制 - -将请求写入副本需要将数据发送到主设备和所有副本。 这意味着所有写入操作的性能都受限于最慢的副本{% if currentVersion ver_gt "enterprise-server@2.17" %}，虽然新的地理副本可以从现有共同位置地理副本（而不是从主设备）播种大部分数据{% endif %}。 Geo-replication 不会增大 {% data variables.product.prodname_ghe_server %} 实例的容量，也不会解决与 CPU 或内存资源不足相关的性能问题。 如果主设备处于脱机状态，则活动副本将无法满足任何读取或写入请求。 - -### 监视 Geo-replication 配置 - -{% data reusables.enterprise_installation.monitoring-replicas %} - -### 延伸阅读 -- “[创建 Geo-replication 副本](/enterprise/{{ currentVersion }}/admin/guides/installation/creating-a-high-availability-replica/#creating-geo-replication-replicas)” diff --git a/translations/zh-CN/content/admin/installation/about-high-availability-configuration.md b/translations/zh-CN/content/admin/installation/about-high-availability-configuration.md deleted file mode 100644 index 88bf3e7b6691..000000000000 --- a/translations/zh-CN/content/admin/installation/about-high-availability-configuration.md +++ /dev/null @@ -1,181 +0,0 @@ ---- -title: 关于高可用性配置 -intro: '在高性能配置中，完全冗余的次级 {% data variables.product.prodname_ghe_server %} 设备通过复制所有主要数据存储与主设备保持同步。' -redirect_from: - - /enterprise/admin/installation/about-high-availability-configuration -versions: - enterprise-server: '*' ---- - -配置高可用性时，会自动设置将所有数据存储（Git 仓库、MySQL、Redis 和 Elasticsearch）单向、异步地从主设备复制到副本。 - -{% data variables.product.prodname_ghe_server %} 支持主动/被动配置，在这些配置下，副本作为备用设备运行，并且数据库服务在复制模式下运行，但应用程序服务将停止。 - -### 有针对性的故障场景 - -使用高可用性配置防护以下问题： - -{% data reusables.enterprise_installation.ha-and-clustering-failure-scenarios %} - -高可用性配置不适用于： - - - **扩展**。 虽然可以使用 Geo-replication 将流量分布在不同地理位置，但写入性能受限于主设备的速度和可用性。 更多信息请参阅“[关于 Geo-replication](/enterprise/{{ currentVersion }}/admin/guides/installation/about-geo-replication/)”。 - - **备份主设备**。 高可用性副本不会替代灾难恢复计划中的非现场备份。 某些形式的数据损坏或数据丢失可能会立即从主设备复制到副本。 为确保安全回滚到稳定的过去状态，必须通过历史快照执行定期备份。 - - **零停机时间升级**。 为避免受控升级场景下出现数据丢失和裂脑的状况，请先将主设备置于维护模式并等待所有写入操作完成，然后再对副本进行升级。 - -### 网络流量故障转移策略 - -在故障转移期间，您必须单独配置和管理从主设备到副本的网络流量的重定向。 - -#### DNS 故障转移 - -对于 DNS 故障转移，请使用 DNS 记录中指向主 {% data variables.product.prodname_ghe_server %} 设备的短 TTL 值。 建议的 TTL 值范围为 60 秒到 5 分钟。 - -在故障转移期间，必须将主设备置于维护模式，并将其 DNS 记录重定向到副本的 IP 地址。 将流量从主设备重新定向到副本所需的时间将取决于 TTL 配置以及更新 DNS 记录所需的时间。 - -如果您要使用 Geo-replication，则必须配置 Geo DNS，将流量定向到距离最近的副本。 更多信息请参阅“[关于 Geo-replication](/enterprise/{{ currentVersion }}/admin/guides/installation/about-geo-replication/)”。 - -#### 负载均衡器 - -{% data reusables.enterprise_clustering.load_balancer_intro %} {% data reusables.enterprise_clustering.load_balancer_dns %} - -在故障转移期间，您必须将主设备置于维护模式。 您可以将负载均衡器配置为自动检测副本何时已升级为主设备，或者可能需要手动更改配置。 您必须先将副本手动升级为主设备，随后副本才能对用户流量作出响应。 更多信息请参阅“[结合使用 {% data variables.product.prodname_ghe_server %} 和负载均衡器](/enterprise/{{ currentVersion }}/admin/guides/installation/using-github-enterprise-server-with-a-load-balancer/)”。 - -{% data reusables.enterprise_installation.monitoring-replicas %} - -### 用于复制管理的实用程序 - -要管理 {% data variables.product.prodname_ghe_server %} 上的复制，请使用 SSH 连接到副本，以使用以下命令行实用程序。 - -#### ghe-repl-setup - -`ghe-repl-setup` 命令可将 {% data variables.product.prodname_ghe_server %} 设备置于副本备用模式。 - - - 为两个设备之间的通信配置加密的 {% if currentVersion ver_gt "enterprise-server@2.17" %}WireGuard VPN{% else %}OpenVPN{% endif %} 隧道。 - - 配置用于复制的数据库服务并启动。 - - 禁用应用程序服务。 尝试通过 HTTP、Git 或其他受支持协议访问副本将出现“设备处于副本模式”维护页面或显示错误消息。 - -```shell -admin@169-254-1-2:~$ ghe-repl-setup 169.254.1.1 -Verifying ssh connectivity with 169.254.1.1 ... -Connection check succeeded. -Configuring database replication against primary ... -Success: Replica mode is configured against 169.254.1.1. -To disable replica mode and undo these changes, run `ghe-repl-teardown'. -Run `ghe-repl-start' to start replicating against the newly configured primary. -``` - -#### ghe-repl-start - -`ghe-repl-start` 命令可以启用所有数据存储的主动复制。 - -```shell -admin@169-254-1-2:~$ ghe-repl-start{% if currentVersion ver_lt "enterprise-server@2.18" %} -Starting OpenVPN tunnel ... {% endif %} -Starting MySQL replication ... -Starting Redis replication ... -Starting Elasticsearch replication ... -Starting Pages replication ... -Starting Git replication ... -Success: replication is running for all services. -Use `ghe-repl-status' to monitor replication health and progress. -``` - -#### ghe-repl-status - -`ghe-repl-status` 命令可以返回各数据存储复制流的 `OK`、`WARNING` 或 `CRITICAL` 状态。 如果有任何复制通道处于 `WARNING` 状态，命令将停止执行并显示代码 `1`。 同样，如果有任何通道处于 `CRITICAL` 状态，命令将停止执行并显示代码 `2`。 - -```shell -admin@169-254-1-2:~$ ghe-repl-status -OK: mysql replication in sync -OK: redis replication is in sync -OK: elasticsearch cluster is in sync -OK: git data is in sync (10 repos, 2 wikis, 5 gists) -OK: pages data is in sync -``` - -`-v` 和 `-vv` 选项可以提供关于各数据存储复制状态的详细信息： - -```shell -$ ghe-repl-status -v -OK: mysql replication in sync - | IO running: Yes, SQL running: Yes, Delay: 0 - -OK: redis replication is in sync - | master_host:169.254.1.1 - | master_port:6379 - | master_link_status:up - | master_last_io_seconds_ago:3 - | master_sync_in_progress:0 - -OK: elasticsearch cluster is in sync - | { - | "cluster_name" : "github-enterprise", - | "status" : "green", - | "timed_out" : false, - | "number_of_nodes" : 2, - | "number_of_data_nodes" : 2, - | "active_primary_shards" : 12, - | "active_shards" : 24, - | "relocating_shards" : 0, - | "initializing_shards" : 0, - | "unassigned_shards" : 0 - | } - -OK: git data is in sync (366 repos, 31 wikis, 851 gists) - | TOTAL OK FAULT PENDING DELAY - | repositories 366 366 0 0 0.0 - | wikis 31 31 0 0 0.0 - | gists 851 851 0 0 0.0 - | total 1248 1248 0 0 0.0 - -OK: pages data is in sync - | Pages are in sync -``` - -#### ghe-repl-stop - -`ghe-repl-stop` 命令可以暂时禁用所有数据存储的复制并停止复制服务。 要恢复复制，请使用 [ghe-repl-start](#ghe-repl-start) 命令。 - -```shell -admin@168-254-1-2:~$ ghe-repl-stop -Stopping Pages replication ... -Stopping Git replication ... -Stopping MySQL replication ... -Stopping Redis replication ... -Stopping Elasticsearch replication ...{% if currentVersion ver_lt "enterprise-server@2.18" %} -Stopping OpenVPN tunnel ...{% endif %} -Success: replication was stopped for all services. -``` - -#### ghe-repl-promote - -`ghe-repl-promote` 命令可以禁用复制并将副本转换为主设备。 设备会配置为使用与原主设备相同的设置，并启用所有服务。 - -{% data reusables.enterprise_installation.promoting-a-replica %} - -```shell -admin@168-254-1-2:~$ ghe-repl-promote -Enabling maintenance mode on the primary to prevent writes ... -Stopping replication ... - | Stopping Pages replication ... - | Stopping Git replication ... - | Stopping MySQL replication ... - | Stopping Redis replication ... - | Stopping Elasticsearch replication ...{% if currentVersion ver_lt "enterprise-server@2.18" %} - | Stopping OpenVPN tunnel ...{% endif %} - | Success: replication was stopped for all services. -Switching out of replica mode ... - | Success: Replication configuration has been removed. - | Run `ghe-repl-setup' to re-enable replica mode. -Applying configuration and starting services ... -Success: Replica has been promoted to primary and is now accepting requests. -``` - -#### ghe-repl-teardown - -`ghe-repl-teardown` 命令可以完全禁用复制模式，并移除副本配置。 - -### 延伸阅读 - -- “[创建高可用性副本](/enterprise/{{ currentVersion }}/admin/guides/installation/creating-a-high-availability-replica)” diff --git a/translations/zh-CN/content/admin/installation/about-the-github-enterprise-server-api.md b/translations/zh-CN/content/admin/installation/about-the-github-enterprise-server-api.md deleted file mode 100644 index d478338fcdd4..000000000000 --- a/translations/zh-CN/content/admin/installation/about-the-github-enterprise-server-api.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: 关于 GitHub Enterprise Server API -intro: '{% data variables.product.prodname_ghe_server %} 支持 {% data variables.product.prodname_dotcom_the_website %} 提供的强大 API 及其自身的 API 端点集合。' -redirect_from: - - /enterprise/admin/articles/about-the-enterprise-api/ - - /enterprise/admin/articles/using-the-api/ - - /enterprise/admin/categories/api/ - - /enterprise/admin/installation/about-the-github-enterprise-server-api -versions: - enterprise-server: '*' ---- - -The complete documentation for the {% data variables.product.prodname_enterprise_api %} is available at . 利用 API，您可以自动处理多种管理任务。 包含以下例子： - -- 对 {% data variables.enterprise.management_console %} 进行更改。 For more information, see "[{% data variables.enterprise.management_console %}](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#management-console)." -- 收集关于实例的统计信息。 For more information, see "[Admin stats](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#admin-stats)." -- 配置 LDAP 同步。 For more information, see "[LDAP](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#ldap)."{% if currentVersion ver_gt "enterprise-server@2.18" %} -- 管理企业帐户。 更多信息请参阅“[企业帐户](/v4/guides/managing-enterprise-accounts)”。{% endif %} diff --git a/translations/zh-CN/content/admin/installation/accessing-the-administrative-shell-ssh.md b/translations/zh-CN/content/admin/installation/accessing-the-administrative-shell-ssh.md deleted file mode 100644 index aaf92104ae16..000000000000 --- a/translations/zh-CN/content/admin/installation/accessing-the-administrative-shell-ssh.md +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: 访问管理 shell (SSH) -redirect_from: - - /enterprise/admin/articles/ssh-access/ - - /enterprise/admin/articles/adding-an-ssh-key-for-shell-access/ - - /enterprise/admin/guides/installation/administrative-shell-ssh-access/ - - /enterprise/admin/articles/troubleshooting-ssh-permission-denied-publickey/ - - /enterprise/admin/2.13/articles/troubleshooting-ssh-permission-denied-publickey/ - - /enterprise/admin/2.14/articles/troubleshooting-ssh-permission-denied-publickey/ - - /enterprise/admin/2.15/articles/troubleshooting-ssh-permission-denied-publickey/ - - /enterprise/admin/installation/accessing-the-administrative-shell-ssh -intro: 'SSH 访问允许用户运行 {% data variables.product.prodname_ghe_server %} 命令行实用程序，可用于故障排查、运行备份和配置复制。' -versions: - enterprise-server: '*' ---- - -### 关于管理 shell 访问 - -如果您有权限通过 SSH 访问管理 shell，可运行 {% data variables.product.prodname_ghe_server %} 的命令行实用程序。 SSH 访问也可用于故障排查、运行备份和配置复制。 管理 SSH 访问与 Git SSH 访问分开管理，仅可通过端口 122 访问。 - -### 允许通过 SSH 访问管理 shell - -要启用管理 SSH 访问，您必须向授权密钥的实例列表添加 SSH 公钥。 - -{% tip %} - -**提示**：对授权 SSH 密钥进行的变更会立即生效。 - -{% endtip %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -3. 在“SSH access”下，将密钥粘贴到文本框中，然后单击 **Add key**。 ![添加 SSH 密钥的文本框和按钮](/assets/images/enterprise/settings/add-authorized-ssh-key-admin-shell.png) -{% data reusables.enterprise_management_console.save-settings %} - -### 通过 SSH 连接到管理 shell - -将 SSH 密钥添加到列表后，以 `admin` 用户的身份在端口 122 上通过 SSH 连接到实例。 - -```shell -$ ssh -p 122 admin@github.example.com -Last login: Sun Nov 9 07:53:29 2014 from 169.254.1.1 -admin@github-example-com:~$ █ -``` - -#### 排查 SSH 连接问题 - -如果在尝试通过 SSH 连接到 {% data variables.product.product_location_enterprise %} 时发生 `Permission denied (publickey)` 错误，请确认您是否是通过端口 122 连接的。 您可能需要明确指定要使用的 SSH 私钥。 - -要使用命令行指定 SSH 私钥，请运行包含 `-i` 参数的 `ssh`。 - -```shell -ssh -i /path/to/ghe_private_key -p 122 admin@hostname -``` - -您也可以使用 SSH 配置文件 (`~/.ssh/config`) 指定 SSH 私钥。 - -```shell -Host hostname - IdentityFile /path/to/ghe_private_key - User admin - Port 122 -``` - -### 使用本地控制台访问管理 shell - -在 SSH 不可用等紧急情况下，您可以在本地访问管理 shell。 以 `admin` 用户身份登录，并使用在 {% data variables.product.prodname_ghe_server %} 初始设置期间确定的密码。 - -### 管理 shell 的访问限制 - -管理 shell 访问仅可用于故障排查和执行记录的操作程序。 修改系统和应用程序文件、运行程序或安装不受支持的软件包可能导致支持合约失效。 如果您对支持合约允许的活动有任何疑问，请联系 {% data variables.contact.contact_ent_support %}。 diff --git a/translations/zh-CN/content/admin/installation/accessing-the-management-console.md b/translations/zh-CN/content/admin/installation/accessing-the-management-console.md deleted file mode 100644 index f2d1654a7bf7..000000000000 --- a/translations/zh-CN/content/admin/installation/accessing-the-management-console.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: 访问 Management Console -intro: '使用 {% data variables.enterprise.management_console %} 可以设置和配置 {% data variables.product.product_location %}、排定维护窗口、排查问题以及管理许可。' -redirect_from: - - /enterprise/admin/articles/about-the-management-console/ - - /enterprise/admin/articles/management-console-for-emergency-recovery/ - - /enterprise/admin/articles/web-based-management-console/ - - /enterprise/admin/categories/management-console/ - - /enterprise/admin/articles/accessing-the-management-console/ - - /enterprise/admin/guides/installation/web-based-management-console/ - - /enterprise/admin/installation/accessing-the-management-console -versions: - enterprise-server: '*' ---- - -### 关于 {% data variables.enterprise.management_console %} - -使用 {% data variables.enterprise.management_console %} 执行基本管理活动： -- **初始设置**：首次启动 {% data variables.product.product_location_enterprise %} 时，在浏览器中访问 {% data variables.product.product_location_enterprise %} 的 IP 地址，简单了解初始设置流程。 -- **配置实例的基本设置**：在“Settings”页面上配置 DNS、主机名、SSL、用户身份验证、电子邮件、监视服务和日志转发。 -- **排定维护窗口**：使用 {% data variables.enterprise.management_console %} 或管理 shell 执行维护时，使 {% data variables.product.product_location_enterprise %} 进入脱机状态。 -- **排查问题**：生成支持包或查看高级诊断信息。 -- **许可管理**：查看或更新 {% data variables.product.prodname_enterprise %} 许可。 - -即使在实例处于维护模式，存在重大应用程序故障或者主机名或 SSL 错误配置的情况下，您也始终可以通过 {% data variables.product.product_location_enterprise %} 的 IP 地址访问 {% data variables.enterprise.management_console %}。 - -要访问 {% data variables.enterprise.management_console %}，您必须使用在 {% data variables.product.product_location_enterprise %} 初始设置期间确定的管理员密码。 您还必须能够连接到端口 8443 上的虚拟机主机。 如果无法访问 {% data variables.enterprise.management_console %}，请检查中间防火墙和安全组配置。 - -### 以站点管理员身份访问 {% data variables.enterprise.management_console %} - -首次以站点管理员身份访问 {% data variables.enterprise.management_console %} 时，必须上传 {% data variables.product.prodname_enterprise %} 许可文件，以便在应用程序中进行身份验证。更多信息请参阅“[管理您的 {% data variables.product.prodname_enterprise %} 许可](/enterprise/{{ currentVersion }}/admin/guides/installation/managing-your-github-enterprise-license)。” - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.type-management-console-password %} - -### 以未验证用户身份访问 {% data variables.enterprise.management_console %} - -1. 在浏览器中访问此 URL，用您的实际 {% data variables.product.prodname_ghe_server %} 主机名或 IP 地址替换 `hostname`： - ```shell - http(s)://HOSTNAME/setup - ``` -{% data reusables.enterprise_management_console.type-management-console-password %} - -### 登录尝试失败后解锁 {% data variables.enterprise.management_console %} - -如果十分钟内登录尝试失败十次，{% data variables.enterprise.management_console %} 将锁定。 您必须等待登录屏幕自动解锁，然后才能再次尝试登录。 一旦前十分钟内登录尝试失败次数不足十次，登录屏幕便会自动解锁。 成功登录后，计数器会复位。 - -要立即解锁 {% data variables.enterprise.management_console %}，请通过管理 shell 使用 `ghe-reactivate-admin-login` 命令。 更多信息请参阅“[命令行实用程序](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities#ghe-reactivate-admin-login)”和“[访问管理 shell (SSH)](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-administrative-shell-ssh/)”。 diff --git a/translations/zh-CN/content/admin/installation/accessing-the-monitor-dashboard.md b/translations/zh-CN/content/admin/installation/accessing-the-monitor-dashboard.md deleted file mode 100644 index 7070fb845268..000000000000 --- a/translations/zh-CN/content/admin/installation/accessing-the-monitor-dashboard.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: 访问监视仪表板 -intro: '{% data variables.product.prodname_ghe_server %} 中基于 Web 的监视仪表板可以显示关于 {% data variables.product.prodname_ghe_server %} 设备的历史数据，例如 CPU 和内存使用情况、应用程序和身份验证响应时间以及整体系统健康状况。' -redirect_from: - - /enterprise/admin/installation/accessing-the-monitor-dashboard -versions: - enterprise-server: '*' ---- - -### 访问监视仪表板 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -2. 在页面顶部，单击 **Monitor**。 ![监视仪表板链接](/assets/images/enterprise/management-console/monitor-dash-link.png) - -### 排查设备上的常见资源分配问题 - -{% note %} - -**注**：由于通过持续集成 (CI) 或构建服务器定期轮询 {% data variables.product.product_location_enterprise %} 会引发拒绝服务攻击，从而导致问题的出现，因此，建议使用 web 挂钩推送更新。 更多信息请参阅“[关于 web 挂钩](/enterprise/{{ currentVersion }}/user/articles/about-webhooks/)”。 - -{% endnote %} - -使用监视仪表板实时了解设备资源健康状况并确定如何解决高利用率问题。 - -| 问题 | 可能原因 | 建议 | -| ---------- | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| CPU 利用率高 | 在同一主机上运行的其他服务或程序争用 VM | 如有可能，请将其他服务或程序重新配置为占用较少的 CPU 资源。 要增加 VM 的总 CPU 资源，请参阅“[增加 CPU 或内存资源](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)”。 | -| 内存使用量高 | 在同一主机上运行的其他服务或程序争用 VM | 如有可能，请将其他服务或程序重新配置为占用较少内存。 要增加 VM 上可用的总内存大小，请参阅“[增加 CPU 或内存资源](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-cpu-or-memory-resources/)”。 | -| 可用磁盘空间小 | 较大的二进制或日志文件占用磁盘空间 | 如有可能，请在独立服务器上托管较大的二进制文件，并压缩或存档日志文件。 如有必要，请按“[增加存储容量](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-storage-capacity/)”中的步骤操作，为您的平台增加 VM 的磁盘空间。 | -| 响应时间较正常时间长 | 通常是上述问题之一造成的 | 确定并解决根本问题。 如果响应时间仍较长，请联系 {% data variables.contact.contact_ent_support %}。 | -| 错误率提高 | 软件问题 | 联系 {% data variables.contact.contact_ent_support %} 并附上支持包。 更多信息请参阅“[向 {% data variables.product.prodname_enterprise %} Support 提供数据](/enterprise/{{ currentVersion}}/admin/guides/enterprise-support/providing-data-to-github-support#creating-and-sharing-support-bundles)”。 | diff --git a/translations/zh-CN/content/admin/installation/activity-dashboard.md b/translations/zh-CN/content/admin/installation/activity-dashboard.md deleted file mode 100644 index 3440c627ad3c..000000000000 --- a/translations/zh-CN/content/admin/installation/activity-dashboard.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: 活动仪表板 -intro: '活动仪表板提供 {% data variables.product.product_location_enterprise %} 上所有活动的概览。' -redirect_from: - - /enterprise/admin/articles/activity-dashboard/ - - /enterprise/admin/installation/activity-dashboard -versions: - enterprise-server: '*' ---- - -活动仪表板提供以下活动数量的周图、月度图和年度图表： -- 新拉取请求 -- 已合并拉取请求 -- 新问题 -- 已关闭问题 -- 新问题评论 -- 新仓库 -- 新用户帐户 -- 新组织 -- 新团队 - -![活动仪表板](/assets/images/enterprise/activity/activity-dashboard-yearly.png) - -为获取基于 {% data variables.product.prodname_enterprise %} 中数据的更多分析，可以购买 {% data variables.product.prodname_insights %}。 更多信息请参阅“[关于 {% data variables.product.prodname_insights %}](/insights/installing-and-configuring-github-insights/about-github-insights)”。 - -### 访问活动仪表板 - -1. 在任一页面顶部，单击 **Explore**。 ![Explore 选项卡](/assets/images/enterprise/settings/ent-new-explore.png) -2. 在右上角单击 **Activity**。 ![Activity 按钮](/assets/images/enterprise/activity/activity-button.png) diff --git a/translations/zh-CN/content/admin/installation/audit-logging.md b/translations/zh-CN/content/admin/installation/audit-logging.md deleted file mode 100644 index 4ed9fcdcb089..000000000000 --- a/translations/zh-CN/content/admin/installation/audit-logging.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: 审核日志 -intro: '{% data variables.product.prodname_enterprise %} 会保留已审核的用户、组织、仓库和系统事件的日志。 日志可用于调试以及内部和外部合规。' -redirect_from: - - /enterprise/admin/articles/audit-logging/ - - /enterprise/admin/installation/audit-logging -versions: - enterprise-server: '*' ---- - -要获取完整列表，请参阅“[审核的操作](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions)”。有关查找特定操作的详细信息，请参阅“[搜索审核日志](/enterprise/{{ currentVersion }}/admin/guides/installation/searching-the-audit-log)”。 - -### 推送日志 - -会记录每个 Git 推送操作。 更多信息请参阅“[查看推送日志](/enterprise/{{ currentVersion }}/admin/guides/installation/viewing-push-logs)”。 - -### 系统事件 - -所有经过审核的系统事件（包括所有推送和拉取）都会记录到 `/var/log/github/audit.log` 中。 日志每 24 小时自动轮换一次，并会保留七天。 - -支持包中包含系统日志。 更多信息请参阅“[向 {% data variables.product.prodname_dotcom %} Support 提供数据](/enterprise/{{ currentVersion }}/admin/guides/enterprise-support/providing-data-to-github-support)”。 - -### 支持包 - -所有审核信息均会记录到任何支持包 `github-logs` 目录的 `audit.log` 文件中。 如果已启用日志转发，您可以将此数据传输到外部 syslog 流使用者，例如 [Splunk](http://www.splunk.com/) 或 [Logstash](http://logstash.net/)。 此日志中的所有条目均使用 `github_audit` 关键词，并且可以通过该关键词进行筛选。 更多信息请参阅“[日志转发](/enterprise/{{ currentVersion }}/admin/guides/installation/log-forwarding)”。 - -例如，此条目显示已创建的新仓库。 - -``` -Oct 26 01:42:08 github-ent github_audit: {:created_at=>1351215728326, :actor_ip=>"10.0.0.51", :data=>{}, :user=>"some-user", :repo=>"some-user/some-repository", :actor=>"some-user", :actor_id=>2, :user_id=>2, :action=>"repo.create", :repo_id=>1, :from=>"repositories#create"} -``` - -此示例显示提交已推送到仓库。 - -``` -Oct 26 02:19:31 github-ent github_audit: { "pid":22860, "ppid":22859, "program":"receive-pack", "git_dir":"/data/repositories/some-user/some-repository.git", "hostname":"github-ent", "pusher":"some-user", "real_ip":"10.0.0.51", "user_agent":"git/1.7.10.4", "repo_id":1, "repo_name":"some-user/some-repository", "transaction_id":"b031b7dc7043c87323a75f7a92092ef1456e5fbaef995c68", "frontend_ppid":1, "repo_public":true, "user_name":"some-user", "user_login":"some-user", "frontend_pid":18238, "frontend":"github-ent", "user_email":"some-user@github.example.com", "user_id":2, "pgroup":"github-ent_22860", "status":"post_receive_hook", "features":" report-status side-band-64k", "received_objects":3, "receive_pack_size":243, "non_fast_forward":false, "current_ref":"refs/heads/master" } -``` diff --git a/translations/zh-CN/content/admin/installation/audited-actions.md b/translations/zh-CN/content/admin/installation/audited-actions.md deleted file mode 100644 index 5b5ef3b692d2..000000000000 --- a/translations/zh-CN/content/admin/installation/audited-actions.md +++ /dev/null @@ -1,133 +0,0 @@ ---- -title: 审核的操作 -intro: 您可以在审核日志中搜索各种操作。 -redirect_from: - - /enterprise/admin/articles/audited-actions/ - - /enterprise/admin/installation/audited-actions -versions: - enterprise-server: '*' ---- - -#### 身份验证 - -| 名称 | 描述 | -| ------------------------------------:| --------------------------------------------------------------------------------------------------------------------------------------- | -| `oauth_access.create` | 已为用户帐户[生成>](/articles/creating-an-access-token-for-command-line-use) [OAuth 访问令牌](/v3/oauth/)。 | -| `oauth_access.destroy` | 已从用户帐户中删除 [OAuth 访问令牌](/v3/oauth/)。 | -| `oauth_application.destroy` | 已从用户或组织帐户中删除 [OAuth 应用程序](/guides/basics-of-authentication/#registering-your-app)。 | -| `oauth_application.reset_secret` | 已重置 [OAuth 应用程序](/guides/basics-of-authentication/#registering-your-app)的密钥。 | -| `oauth_application.transfer` | 已将 [OAuth 应用程序](/guides/basics-of-authentication/#registering-your-app)从一个用户或组织帐户传送到另一个用户或组织帐户。 | -| `public_key.create` | 已将 SSH 密钥[添加](/articles/adding-a-new-ssh-key-to-your-github-account)到用户帐户中，或者已将[部署密钥](/guides/managing-deploy-keys/#deploy-keys)添加到仓库中。 | -| `public_key.delete` | 已从用户帐户中移除 SSH 密钥，或已从仓库中移除[部署密钥](/guides/managing-deploy-keys/#deploy-keys)。 | -| `public_key.update` | 已更新用户帐户的 SSH 密钥或仓库的[部署密钥](/guides/managing-deploy-keys/#deploy-keys)。 | -| `two_factor_authentication.enabled` | 已为用户帐户启用[双重身份验证](/articles/about-two-factor-authentication)。 | -| `two_factor_authentication.disabled` | 已为用户帐户禁用[双重身份验证](/articles/about-two-factor-authentication)。 | - -#### 挂钩 - -| 名称 | Description | -| ---------------------:| ----------- | -| `hook.create` | 已向仓库添加新挂钩。 | -| `hook.config_changed` | 已更改挂钩的配置。 | -| `hook.destroy` | 已删除挂钩。 | -| `hook.events_changed` | 已更改挂钩的配置事件。 | - -#### 实例配置设置 - -| 名称 | 描述 | -| -------------------------------------------------------:| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `business.update_member_repository_creation_permission` | 站点管理员限制在实例上的组织中创建仓库。 更多信息请参阅“[限制在实例中创建仓库](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)”。 | -| `business.clear_members_can_create_repos` | 站点管理员取消了对在实例上的组织中创建仓库的限制。 更多信息请参阅“[限制在实例中创建仓库](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)”。 | -| `enterprise.config.lock_anonymous_git_access` | 站点管理员锁定匿名 Git 读取权限，以防止仓库管理员更改该实例上仓库的现有匿名 Git 读取权限设置。 更多信息请参阅“[阻止用户更改匿名 Git 读取权限](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)”。 | -| `enterprise.config.unlock_anonymous_git_access` | 站点管理员解锁匿名 Git 读取权限，以允许仓库管理员更改该实例上仓库的现有匿名 Git 读取权限设置。 更多信息请参阅“[阻止用户更改匿名 Git 读取权限](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)”。 | - -#### 议题和拉取请求 - -| 名称 | 描述 | -| ------------------------------------:| -------------------------------------------------------------------------------------------- | -| `issue.update` | 问题的正文文本（初始注释）已更改。 | -| `issue_comment.update` | 已更改问题的正文文本（初始注释）。 | -| `pull_request_review_comment.delete` | 已删除对拉取请求的评论。 | -| `issue.destroy` | 已从仓库中删除问题。 更多信息请参阅“[删除问题](/enterprise/{{ currentVersion }}/user/articles/deleting-an-issue)"。” | - -#### 组织 - -| 名称 | 描述 | -| ------------------:| ---------------------------------------------------------------------------------------------------------------------- | -| `org.async_delete` | 用户发起了删除组织的后台作业。 | -| `org.delete` | 组织已由用户发起的后台作业删除。 | -| `org.transform` | 已将用户帐户转换为组织。 更多信息请参阅“[将用户转换为组织](/enterprise/{{ currentVersion}}/user/articles/converting-a-user-into-an-organization/)”。 | - -#### 受保护分支 - -| 名称 | 描述 | -| ------------------------------------------------------------------:| ---------------------- | -| `protected_branch.create` | 已在分支上启用分支保护。 | -| `protected_branch.destroy` | 已在分支上禁用分支保护。 | -| `protected_branch.update_admin_enforced` | 已为仓库管理员强制执行分支保护。 | -| `protected_branch.update_require_code_owner_review` | 已在分支上更新必需代码所有者审查的强制执行。 | -| `protected_branch.dismiss_stale_reviews` | 已在分支上更新忽略旧拉取请求的强制执行。 | -| `protected_branch.update_signature_requirement_enforcement_level` | 已在分支上更新必需提交签名的强制执行。 | -| `protected_branch.update_pull_request_reviews_enforcement_level` | 已在分支上更新必需拉取请求审查的强制执行。 | -| `protected_branch.update_required_status_checks_enforcement_level` | 已在分支上更新必需状态检查的强制执行。 | -| `protected_branch.rejected_ref_update` | 分支更新尝试被拒。 | -| `protected_branch.policy_override` | 分支保护要求被仓库管理员覆盖。 | - -#### 仓库 - -| 名称 | 描述 | -| ------------------------------------------:| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `repo.access` | 已将私有仓库设为公共，或者已将公共仓库设为私有。 | -| `repo.archive` | 已存档仓库。 更多信息请参阅“[存档和取消存档仓库](/enterprise/{{ currentVersion }}/admin/guides/user-management/archiving-and-unarchiving-repositories/)”。 | -| `repo.add_member` | 已向仓库添加协作者。 | -| `repo.config` | 站点管理员已阻止强制推送。 更多信息请参阅“[阻止对仓库进行强制推送](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository/)”。 | -| `repo.create` | 已创建仓库。 | -| `repo.destroy` | 已删除仓库。 | -| `repo.remove_member` | 已从仓库中移除协作者。 | -| `repo.rename` | 已重命名仓库。 | -| `repo.transfer` | 用户已接受接收传输仓库的请求。 | -| `repo.transfer_start` | 用户已发送向另一用户或组织传输仓库的请求。 | -| `repo.unarchive` | 已取消存档仓库。 更多信息请参阅“[存档和取消存档仓库](/enterprise/{{ currentVersion }}/admin/guides/user-management/archiving-and-unarchiving-repositories/)”。 | -| `repo.config.disable_anonymous_git_access` | 已为公共仓库禁用匿名 Git 读取权限。 更多信息请参阅“[为仓库启用匿名 Git 读取权限](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)。” | -| `repo.config.enable_anonymous_git_access` | 已为公共仓库启用匿名 Git 读取权限。 更多信息请参阅“[为仓库启用匿名 Git 读取权限](/enterprise/{{ currentVersion }}/user/articles/enabling-anonymous-git-read-access-for-a-repository)。” | -| `repo.config.lock_anonymous_git_access` | 已锁定仓库的匿名 Git 读取权限设置，阻止仓库管理员更改（启用或禁用）此设置。 更多信息请参阅“[阻止用户更改匿名 Git 读取权限](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)”。 | -| `repo.config.unlock_anonymous_git_access` | 已解锁仓库的匿名 Git 读取权限设置，允许仓库管理员更改（启用或禁用）此设置。 更多信息请参阅“[阻止用户更改匿名 Git 读取权限](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)”。 | - -#### 站点管理员工具 - -| 名称 | 描述 | -| --------------------:| ---------------------------------------------------------------------- | -| `staff.disable_repo` | 站点管理员已禁用对仓库及其所有复刻的访问。 | -| `staff.enable_repo` | 站点管理员已重新启用对仓库及其所有复刻的访问。 | -| `staff.fake_login` | 站点管理员以另一用户的身份登录 {% data variables.product.prodname_enterprise %}。 | -| `staff.repo_unlock` | 站点管理员已解锁（临时获得完全访问权限）用户的一个私有仓库。 | -| `staff.unlock` | 站点管理员已解锁（临时获得完全访问权限）用户的所有私有仓库。 | - -#### 团队 - -| 名称 | 描述 | -| --------------:| --------------- | -| `team.create` | 已向团队添加用户帐户或仓库。 | -| `team.delete` | 已从团队中移除用户帐户或仓库。 | -| `team.destroy` | 已删除团队。 | - -#### 用户 - -| 名称 | 描述 | -| ---------------------------:| ------------------------------------ | -| `user.add_email` | 已向用户帐户添加电子邮件地址。 | -| `user.async_delete` | 已启动异步作业，用于销毁用户帐户，最终触发 `user.delete`。 | -| `user.change_password` | 用户已更改其密码。 | -| `user.create` | 已创建新的用户帐户。 | -| `user.delete` | 已通过异步作业销毁用户帐户。 | -| `user.demote` | 已将站点管理员降级为普通用户帐户。 | -| `user.destroy` | 用户已删除其帐户，进而触发 `user.async_delete`。 | -| `user.failed_login` | 用户尝试登录时使用的用户名、密码或双重身份验证码不正确。 | -| `user.forgot_password` | 用户通过登录页面请求了密码重置。 | -| `user.login` | 用户已登录。 | -| `user.promote` | 已将普通用户帐户升级为站点管理员。 | -| `user.remove_email` | 已从用户帐户中移除电子邮件地址。 | -| `user.rename` | 已更改用户名。 | -| `user.suspend` | 站点管理员已挂起用户帐户。 | -| `user.two_factor_requested` | 已提示用户输入双重身份验证码。 | -| `user.unsuspend` | 站点管理员已取消挂起用户帐户。 | diff --git a/translations/zh-CN/content/admin/installation/command-line-utilities.md b/translations/zh-CN/content/admin/installation/command-line-utilities.md deleted file mode 100644 index 904f855cc8d2..000000000000 --- a/translations/zh-CN/content/admin/installation/command-line-utilities.md +++ /dev/null @@ -1,787 +0,0 @@ ---- -title: 命令行实用程序 -intro: '{% data variables.product.prodname_ghe_server %} 包含的各种实用程序可以帮助解决特殊问题或执行特定任务。' -redirect_from: - - /enterprise/admin/articles/viewing-all-services/ - - /enterprise/admin/articles/command-line-utilities/ - - /enterprise/admin/installation/command-line-utilities -miniTocMaxHeadingLevel: 4 -versions: - enterprise-server: '*' ---- - -以 SSH 管理员用户身份登录后，您可以在虚拟机上的任何位置执行这些命令。 更多信息请参阅“[访问管理 shell (SSH)](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-administrative-shell-ssh/)”。 - -### 常规 - -#### ghe-announce - -此实用程序会在每个 {% data variables.product.prodname_enterprise %} 页面顶部设置横幅， 您可以使用横幅向用户广播消息。 - -```shell -# Sets a message that's visible to everyone -$ ghe-announce -s MESSAGE -> Announcement message set. -# Removes a previously set message -$ ghe-announce -u -> Removed the announcement message -``` - -#### ghe-check-disk-usage - -此实用程序会检查磁盘中的大文件或已删除但文件句柄仍保持打开的文件。 如果尝试释放根分区中的空间，应运行此实用程序。 - -```shell -ghe-check-disk-usage -``` - -#### ghe-cleanup-caches - -此实用程序会清理各种有可能占用根卷上的额外磁盘空间的缓存。 如果您发现一段时间内根卷磁盘空间的使用量显著升高，最好运行此应用程序，查看是否可以帮助降低整体使用量 。 - -```shell -ghe-cleanup-caches -``` -#### ghe-cleanup-settings - -此实用程序会擦除所有现有的 {% data variables.enterprise.management_console %} 设置。 - -{% tip %} - -**提示**：{% data reusables.enterprise_enterprise_support.support_will_ask_you_to_run_command %} - -{% endtip %} - -```shell -ghe-cleanup-settings -``` - -#### ghe-config - -此实用程序可用于检索和修改 {% data variables.product.product_location_enterprise %} 的配置设置。 - -```shell -$ ghe-config core.github-hostname -# Gets the configuration value of `core.github-hostname` -$ ghe-config core.github-hostname 'example.com' -# Sets the configuration value of `core.github-hostname` to `example.com` -$ ghe-config -l -# Lists all the configuration values -``` -允许您在 `cluster.conf` 中查找节点的 uuid。 - -``` shell - $ ghe-config _hostname_.uuid -``` - -#### ghe-config-apply - -此实用程序会应用 {% data variables.enterprise.management_console %} 设置，重新加载系统服务，准备存储设备，重新加载应用程序服务并运行任何待处理的数据库迁移。 It is equivalent to clicking **Save settings** in the {% data variables.enterprise.management_console %}'s web UI or to sending a POST request to [the `/setup/api/configure` endpoint](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#management-console). - -您有可能永远不需要手动运行此实用程序，但如果希望通过 SSH 自动完成设置保存过程，也可以使用此实用程序。 - -```shell -ghe-config-apply -``` - -#### ghe-console - -此实用程序会在您的 {% data variables.product.prodname_enterprise %} 设备上打开 GitHub Rails 控制台。 {% data reusables.command_line.use_with_support_only %} - -```shell -ghe-console -``` - -#### ghe-dbconsole - -此实用程序会在您的 {% data variables.product.prodname_enterprise %} 设备上打开 MySQL 数据库会话。 {% data reusables.command_line.use_with_support_only %} - -```shell -ghe-dbconsole -``` - -#### ghe-es-index-status -此实用程序会以 CSV 格式返回 ElasticSearch 索引的摘要。 - -将包含标头行的索引摘要打印到 `STDOUT`： -```shell -$ ghe-es-index-status -do -> warning: parser/current is loading parser/ruby23, which recognizes -> warning: 2.3.3-compliant syntax, but you are running 2.3.4. -> warning: please see https://github.com/whitequark/parser#compatibility-with-ruby-mri. -> Name,Primary,Searchable,Writable,UpToDate,RepairProgress,Version -> code-search-1,true,true,true,true,100.0,72e27df7c631b45e026b42bfef059328fa040e17 -> commits-5,true,true,true,true,100.0,7ed28813100c47813ef654c0ee2bb9abf21ab744 -> gists-4,true,true,true,true,100.0,cf8e7d04fcf2564c902e2873c424a279cc41079d -> issues-4,false,false,false,true,100.0,d0bb08f71eebf6e7b070572aa399b185dbdc8a76 -> issues-5,true,true,true,true,100.0,d0bb08f71eebf6e7b070572aa399b185dbdc8a76 -> projects-2,true,true,true,true,100.0,c5cac1c4b3c66d42e609d088d174dbc3dd44469a -> pull-requests-6,true,true,true,true,100.0,6a466ad6b896a3499509990979bf9a18d7d41de3 -> repos-6,true,true,true,true,100.0,6c8b5fbba0fc1e409558db411d05e092c1387082 -> users-5,true,true,true,true,100.0,38984875552bb826c9ec42999f409cb2e95556eb -> wikis-4,true,true,true,true,100.0,2613dec44bd14e14577803ac1f9e4b7e07a7c234 -``` - -将索引摘要和管道结果打印到 `column`，以供读取： - -```shell -$ ghe-es-index-status -do | column -ts, -> warning: parser/current is loading parser/ruby23, which recognizes -> warning: 2.3.3-compliant syntax, but you are running 2.3.4. -> warning: please see https://github.com/whitequark/parser#compatibility-with-ruby-mri. -> Name Primary Searchable Writable UpToDate RepairProgress Version -> code-search-1 true true true true 100.0 72e27df7c631b45e026b42bfef059328fa040e17 -> commits-5 true true true true 100.0 7ed28813100c47813ef654c0ee2bb9abf21ab744 -> gists-4 true true true true 100.0 cf8e7d04fcf2564c902e2873c424a279cc41079d -> issues-4 false false false true 100.0 d0bb08f71eebf6e7b070572aa399b185dbdc8a76 -> issues-5 true true true true 100.0 d0bb08f71eebf6e7b070572aa399b185dbdc8a76 -> projects-2 true true true true 100.0 c5cac1c4b3c66d42e609d088d174dbc3dd44469a -> pull-requests-6 true true true true 100.0 6a466ad6b896a3499509990979bf9a18d7d41de3 -> repos-6 true true true true 100.0 6c8b5fbba0fc1e409558db411d05e092c1387082 -> users-5 true true true true 100.0 38984875552bb826c9ec42999f409cb2e95556eb -> wikis-4 true true true true 100.0 2613dec44bd14e14577803ac1f9e4b7e07a7c234 -``` - -#### ghe-legacy-github-services-report - -此实用程序会列出您的设备中使用 {% data variables.product.prodname_dotcom %} Services 的仓库，作为一种集成方法，此服务将于 2018 年 10 月 1 日停用。 您的设备上的用户可能已设置 {% data variables.product.prodname_dotcom %} Services，为发往某些仓库的推送创建通知。 For more information, see "[Announcing the deprecation of {% data variables.product.prodname_dotcom %} Services](https://developer.github.com/changes/2018-04-25-github-services-deprecation/)" on {% data variables.product.prodname_blog %} or "[Replacing {% data variables.product.prodname_dotcom %} Services](/v3/guides/replacing-github-services/)." For more information about this command or for additional options, use the `-h` flag. - -```shell -ghe-legacy-github-services-report - -``` - -#### ghe-logs-tail - -此实用程序允许跟踪记录安装中的所有相关日志文件。 您可以传入选项，将日志限制为特定集合。 使用 -h 标志表示附加选项。 - -```shell -ghe-logs-tail -``` - -#### ghe-maintenance - -此实用程序允许您控制安装维护模式的状态， 其设计为主要由 {% data variables.enterprise.management_console %} 在后台使用，但也可以直接使用。 - -```shell -ghe-maintenance -h -``` - -{% if currentVersion ver_gt "enterprise-server@2.17" %} -#### ghe-motd - -此实用程序重新显示管理员通过管理 shell 访问实例时看到的当天消息 (MOTD)。 输出包含实例状态的概述。 - -```shell -ghe-motd -``` -{% endif %} - -#### ghe-nwo - -此实用程序会根据仓库 ID 返回仓库名称和所有者。 - -```shell -ghe-nwo REPOSITORY_ID -``` - -#### ghe-org-admin-promote - -使用此命令可为设备上具有站点管理员权限的用户提供组织所有者权限，或者为组织中的任何用户提供组织所有者权限。 您必须指定用户和/或组织。 `ghe-org-admin-promote` 命令始终会在运行前要求确认，除非您使用 `-y` 标志绕过确认过程。 - -您可将以下选项与实用程序配合使用： - -- `-u` 标志指定用户名。 使用此标志可为特定用户提供组织所有者权限。 省略 `-u` 标志会将所有站点管理员升级为指定组织的所有者。 -- `-o` 标志指定组织。 使用此标志可提供特定组织中的所有者权限。 省略 `-o` 标志会将所有组织中的所有者权限授予指定的站点管理员。 -- `-a` 标志会将所有组织中的所有者权限授予所有站点管理员。 -- `-y` 标志可绕过手动确认。 - -此实用程序无法将非站点管理员升级为所有组织的所有者。 您可以使用 [ghe-user-promote](#ghe-user-promote) 将普通用户帐户升级为站点管理员。 - -将特定组织中的组织所有者权限授予一个用户 - -```shell -ghe-org-admin-promote -u USERNAME -o ORGANIZATION -``` - -将所有组织中的组织所有者权限授予特定的站点管理员 - -```shell -ghe-org-admin-promote -u USERNAME -``` - -将特定组织中的组织所有者权限授予所有站点管理员 - -```shell -ghe-org-admin-promote -o ORGANIZATION -``` - -将所有组织中的组织所有者权限授予所有站点管理员 - -```shell -ghe-org-admin-promote -a -``` - -#### ghe-reactivate-admin-login - -在 10 分钟内登录尝试失败 10 次后，使用此命令可立即解锁 {% data variables.enterprise.management_console %}。 - -```shell -$ ghe-reactivate-admin-login -``` - -#### ghe-resque-info - -此实用程序会显示关于后台作业（活动作业和队列中的作业）的信息， 它提供的作业计数与每个页面顶部管理员统计信息栏中的计数相同。 - -此实用程序可以帮助确定 Resque 服务器在处理后台作业时是否会出现问题。 下列任一场景均可能指示 Resque 存在问题： - -* 后台作业数增加，而活动作业数保持不变。 -* 事件源未更新。 -* Webhooks are not being triggered. -* Web 界面在 Git 推送后未更新。 - -如果怀疑 Resque 出现故障，请联系 {% data variables.contact.contact_ent_support %} 获取帮助。 - -使用此命令，您还可以暂停或恢复队列中的作业。 - -```shell -$ ghe-resque-info -# lists queues and the number of currently queued jobs -$ ghe-resque-info -p QUEUE -# pauses the specified queue -$ ghe-resque-info -r QUEUE -# resumes the specified queue -``` - -#### ghe-saml-mapping-csv - -此实用程序可帮助映射 SAML 记录。 - -为 {% data variables.product.product_name %} 用户创建包含所有 SAML 映射的 CSV 文件： -```shell -$ ghe-saml-mapping-csv -d -``` - -要使用新值执行更新 SAML 映射的排演： -```shell -$ ghe-saml-mapping-csv -u -n -f /path/to/file -``` - -要使用新值更新 SAML 映射： -```shell -$ ghe-saml-mapping-csv -u -f /path/to/file -``` - -#### ghe-service-list - -此实用程序会列出您的设备上已启动或停止（正在运行或等待）的服务。 - -```shell -$ ghe-service-list -start/running - - github-resqued, process 12711 - - github-unicorn, process 12726 - - github-gitauth, process 12743 - - git-daemon, process 12755 - - babeld, process 12771 - - github-svn-proxy, process 12802 - - gist-unicorn, process 12832 - - gist-resqued, process 12881 - - render-unicorn, process 12939 - - hookshot-unicorn, process 13076 - - nodeload2, process 13192 - - slumlord-unicorn, process 13304 - - ghe-storage, process 2012 - - enterprise-manage-unicorn, process 2024 - - enterprise-manage-resque, process 2053 - -stop/waiting - - ghe-replica-mode -``` - -{% tip %} - -如有需要，可将此命令返回的服务名称与 [`systemctl`](https://www.freedesktop.org/software/systemd/man/systemctl.html) 命令结合使用，以手动停止、启动或重启这些服务。 例如： - -```shell -$ sudo systemctl restart github-resqued -``` - -停止服务会导致安装停机，因此建议您在停止或重启任何服务之前联系 {% data variables.contact.contact_ent_support %}。 - -{% endtip %} - -#### ghe-set-password - -使用 `ghe-set-password`，您可以设置新密码，在 [{% data variables.enterprise.management_console %}](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-management-console) 中进行身份验证。 - -```shell -ghe-set-password -``` - -#### ghe-ssh-check-host-keys - -此实用程序会对照已知泄露的 SSH 主机密钥检查现有的 SSH 主机密钥。 - -```shell -$ ghe-ssh-check-host-keys -``` - -如果发现主机密钥泄露，实用程序会以状态 `1` 退出并显示以下消息： -```shell -> One or more of your SSH host keys were found in the blacklist. -> Please reset your host keys using ghe-ssh-roll-host-keys. -``` - -如果未发现主机密钥泄露，实用程序会以状态 `0` 退出并显示以下消息： -```shell -> The SSH host keys were not found in the SSH host key blacklist. -> No additional steps are needed/recommended at this time. -``` - -#### ghe-ssh-roll-host-keys - -此实用程序会滚动 SSH 主机密钥并将其替换为新生成的密钥。 - -```shell -$ sudo ghe-ssh-roll-host-keys -Proceed with rolling SSH host keys? This will delete the -existing keys in /etc/ssh/ssh_host_* and generate new ones. [y/N] - -# Press 'Y' to confirm deleting, or use the -y switch to bypass this prompt - -> SSH host keys have successfully been rolled. -``` - -#### ghe-ssh-weak-fingerprints - -此实用程序会返回存储在 {% data variables.product.prodname_enterprise %} 设备上的已知弱 SSH 密钥的报告。 您可以选择批量撤销用户密钥。 此实用程序将报告弱系统密钥，您必须在 [{% data variables.enterprise.management_console %}](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-management-console) 中手动撤销这些密钥。 - -```shell -# Print a report of weak user and system SSH keys -$ ghe-ssh-weak-fingerprints - -# Revoke all weak user keys -$ ghe-ssh-weak-fingerprints --revoke -``` - -#### ghe-ssl-acme - -此实用程序允许您在 {% data variables.product.prodname_enterprise %} 设备上安装 Let's Encrypt 证书。 更多信息请参阅“[配置 TLS](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-tls)”。 - -您可以使用 `-x` 标志来删除 ACME 配置。 - -```shell -ghe-ssl-acme -e -``` - -#### ghe-ssl-ca-certificate-install - -此实用程序允许您在 {% data variables.product.prodname_enterprise %} 服务器上安装自定义根 CA 证书。 证书必须采用 PEM 格式。 此外，如果您的证书提供者在一个文件中包含多个 CA 证书，则必须将其拆分到多个单独文件中，随后再将这些文件逐个传递到 `ghe-ssl-ca-certificate-install`。 - -运行此实用程序可添加证书链进行 S/MIME 提交签名验证。 更多信息请参阅“[关于提交签名验证](/enterprise/{{ currentVersion }}/user/articles/about-commit-signature-verification/)”。 - -如果 {% data variables.product.product_location_enterprise %} 无法连接到另一台服务器的原因是后者使用自签名 SSL 证书或没有为其提供必要 CA 包的 SSL 证书，请运行此实用程序。 确认这种情况的一种方法是通过 {% data variables.product.product_location_enterprise %} 运行 `openssl s_client -connect host:port -verify 0 -CApath /etc/ssl/certs`。 如果可以验证远程服务器的 SSL 证书，`SSL-Session` 的返回代码应为 0，如下所示。 - -``` -SSL-Session: - Protocol : TLSv1 - Cipher : AES128-SHA - Session-ID: C794EBCC3CBC10F747C9AFC029C03C1048FC99CFC34D13D7444E0F267C58DF4C - Session-ID-ctx: - Master-Key: 02A7C47CFD6EEC87D3C710E9DD87390E04EF82DDD7514AE03127D5DC1945FC0CAEFB5395791AEA598667EFA61B9EA8C5 - Key-Arg : None - Start Time: 1394581597 - Timeout : 300 (sec) - Verify return code: 0 (ok) -``` - -另一方面，如果*无法<0>验证远程服务器的 SSL 证书，`SSL-Session` 的返回代码应为非零值：

    - -``` -SSL-Session: - Protocol : TLSv1 - Cipher : AES128-SHA - Session-ID: 82CB288051A6DB66094C50A69CF1292AEE7E54C6B01B659B98AB336F8C33863E - Session-ID-ctx: - Master-Key: 01B025B2F764043A27919A8D1355AAECD8844FF0831B1D664042334790574A6F4025BAB085D4ED71D71AAB3091B849E5 - Key-Arg : None - Start Time: 1394581782 - Timeout : 300 (sec) - Verify return code: 27 (certificate not trusted) -``` - -您可以将以下附加选项与实用程序结合使用： -- `-r` 标志允许您卸载 CA 证书。 -- `-h` 标志可显示更多用法信息。 - -```shell -ghe-ssl-ca-certificate-install -c /path/to/certificate -``` - -#### ghe-ssl-generate-csr - -此实用程序允许您生成可与商业或私有证书颁发机构共享的私钥和证书签名请求 (CSR)，以获取可与您的实例配合使用的有效证书。 更多信息请参阅“[配置 TLS](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-tls)”。 - -如需获取关于此命令的更多信息或附加选项，请使用 `-h` 标志。 - -```shell -ghe-ssl-generate-csr -``` - -#### ghe-storage-extend - -某些平台需要使用此脚本扩展用户量。 更多信息请参阅“[增加存储容量](/enterprise/admin/guides/installation/increasing-storage-capacity/)”。 - -```shell -$ ghe-storage-extend -``` - -#### ghe-version - -此实用程序会打印 {% data variables.product.product_location_enterprise %} 的版本、平台和内部版本号。 - -```shell -$ ghe-version -``` - -#### ghe-webhook-logs - -此实用程序会返回 web 挂钩交付日志，供管理员审查和确定任何问题。 - -```shell -ghe-webhook-logs -``` - -要显示过去一天所有失败的挂钩交付： -```shell -ghe-webhook-logs -f -a YYYYMMDD -``` - -要显示交付的完整挂钩有效负载、结果以及任何异常： -```shell -ghe-webhook-logs -g delivery-guid -v -``` - -要显示全局 web 挂钩交付： -```shell -ghe-webhook-logs --global -``` - -### 集群 - -#### ghe-cluster-support-bundle - -此实用程序创建的支持包 tarball 包含采用 Geo-replication 或集群配置的各个节点中的重要日志。 - -默认情况下，此命令会在 */tmp* 中创建 tarball，但为了便于通过 SSH 进行传输，您也可以通过 `cat` 将打包文件创建到 `STDOUT` 中。 在 Web UI 未响应或从 */setup/support* 下载支持包失败的情况下，您可以使用此方法。 如果要生成包含旧日志的*扩展*包，则必须使用此命令。 您还可以使用此命令将集群支持包直接上传到 {% data variables.product.prodname_enterprise %} Support。 - -要创建标准捆绑包： -```shell -$ ssh -p 122 admin@hostname -- 'ghe-cluster-support-bundle -o' > cluster-support-bundle.tgz -``` - -要创建扩展捆绑包： -```shell -$ ssh -p 122 admin@hostname -- 'ghe-cluster-support-bundle -x -o' > cluster-support-bundle.tgz -``` - -要将捆绑包发送至 {% data variables.contact.github_support %}： -```shell -$ ssh -p 122 admin@hostname -- 'ghe-cluster-support-bundle -u' -``` - -要将捆绑包发送至 {% data variables.contact.github_support %} 并关联捆绑包与事件单： -```shell -$ ssh -p 122 admin@hostname -- 'ghe-cluster-support-bundle -t ticket-id' -``` - -#### ghe-dpages - -此实用程序可用于管理分配的 {% data variables.product.prodname_pages %} 服务器。 - -```shell -ghe-dpages -``` - -要显示仓库位置和健康状态摘要： -```shell -ghe-dpages status -``` - -要在撤出集群节点之前撤出 {% data variables.product.prodname_pages %} 存储服务： -``` shell -ghe-dpages evacuate pages-server- -``` - -#### ghe-spokes - -此实用程序允许您管理分布式 git 服务器上各仓库的三个副本。 - -```shell -ghe-spokes -``` - -要显示仓库位置和健康状态摘要： - -```shell -ghe-spokes status -``` - -要显示存储仓库的服务器： - -```shell -ghe-spokes route -``` - -要撤出集群节点上的存储服务： - -``` shell -ghe-spokes server evacuate git-server- -``` - -#### ghe-storage - -此实用程序允许您在撤出集群节点之前撤出所有存储服务。 - -``` shell -ghe-storage evacuate storage-server- -``` - -### Git - -#### ghe-btop - -当前 Git 操作的类 `top` 接口。 - -```shell -ghe-btop [ | --help | --usage ] -``` - -#### ghe-repo - -此实用程序允许您切换到仓库的目录并以 `git` 用户身份打开交互式 shell。 您可以通过 `git-*` 或 `git-nw-*` 等命令对仓库执行手动检查或维护。 - -```shell -ghe-repo username/reponame -``` - -#### ghe-repo-gc - -此实用程序会手动重新打包仓库网络，以优化包存储。 如果仓库较大，运行此命令有助于减小其整体大小。 {% data variables.product.prodname_enterprise %} 会在与仓库网络交互的过程中自动运行此命令。 - -您可以添加可选的 `--prune` 参数来移除不是从分支、标记或其他任何 ref 引用的不可达 Git 对象。 此方法特别适用于立即移除[之前泄露的敏感信息](/enterprise/user/articles/remove-sensitive-data/)。 - -```shell -ghe-repo-gc username/reponame -``` - -### 导入和导出 - -#### ghe-migrator - -`ghe-migrator` 属于高保真工具，可帮助用户从一个 GitHub 实例迁移到另一个实例。 您可以整合实例或将组织、用户、团队和仓库从 GitHub.com 移至 {% data variables.product.prodname_enterprise %}。 - -更多信息请参阅[迁移用户、组织和仓库数据](/enterprise/admin/guides/migrations/)上的指南。 - -#### git-import-detect - -给定一个 URL，检测哪种类型的源控制管理系统位于另一端。 在手动导入过程中，此信息很可能是已知的，但在自动执行的脚本中非常有用。 -```shell -git-import-detect -``` - -#### git-import-hg-raw - -此实用程序可将 Mercurial 仓库导入至此 Git 仓库。 更多信息请参阅“[从第三方版本控制系统导入数据](/enterprise/admin/guides/migrations/importing-data-from-third-party-version-control-systems/)。” -```shell -git-import-hg-raw -``` - -#### git-import-svn-raw - -此实用程序可将 Subversion 历史记录和文件数据导入至 Git 分支。 这属于直接复制树，会忽略任何主干或分支差异。 更多信息请参阅“[从第三方版本控制系统导入数据](/enterprise/admin/guides/migrations/importing-data-from-third-party-version-control-systems/)。” -```shell -git-import-svn-raw -``` - -#### git-import-tfs-raw - -此实用程序可从 Team Foundation Version Control 导入。 更多信息请参阅“[从第三方版本控制系统导入数据](/enterprise/admin/guides/migrations/importing-data-from-third-party-version-control-systems/)。” -```shell -git-import-tfs-raw -``` - -#### git-import-rewrite - -此实用程序可重写导入的仓库。 这样，您将有机会重命名作者，对于 Subversion 和 TFS，可基于文件夹生成 Git 分支。 更多信息请参阅“[从第三方版本控制系统导入数据](/enterprise/admin/guides/migrations/importing-data-from-third-party-version-control-systems/)。” -```shell -git-import-rewrite -``` - -### 支持 - -#### ghe-diagnostics - -此实用程序会执行各项检查并收集关于安装的信息，您可以将此类信息发送给支持团队，以帮助诊断您遇到的问题。 - -目前，此实用程序的输出与下载 {% data variables.enterprise.management_console %} 中的诊断信息类似，但会逐渐增加一些 Web UI 中未提供的其他改进。 更多信息请参阅“[创建和共享诊断文件](/enterprise/admin/guides/enterprise-support/providing-data-to-github-support#creating-and-sharing-diagnostic-files)”。 - -```shell -ghe-diagnostics -``` - -#### ghe-support-bundle - -{% data reusables.enterprise_enterprise_support.use_ghe_cluster_support_bundle %} -此实用程序会创建一个支持包 tarball，其中包含实例中的重要日志。 - -默认情况下，此命令会在 */tmp* 中创建 tarball，但为了便于通过 SSH 进行传输，您也可以通过 `cat` 将打包文件创建到 `STDOUT` 中。 在 Web UI 未响应或从 */setup/support* 下载支持包失败的情况下，您可以使用此方法。 如果要生成包含旧日志的*扩展*包，则必须使用此命令。 您还可以使用此命令将支持包直接上传到 {% data variables.product.prodname_enterprise %} Support。 - -要创建标准捆绑包： -```shell -$ ssh -p 122 admin@hostname -- 'ghe-support-bundle -o' > support-bundle.tgz -``` - -要创建扩展捆绑包： -```shell -$ ssh -p 122 admin@hostname -- 'ghe-support-bundle -x -o' > support-bundle.tgz -``` - -要将捆绑包发送至 {% data variables.contact.github_support %}： -```shell -$ ssh -p 122 admin@hostname -- 'ghe-support-bundle -u' -``` - -要将捆绑包发送至 {% data variables.contact.github_support %} 并关联捆绑包与事件单： - -```shell -$ ssh -p 122 admin@hostname -- 'ghe-support-bundle -t ticket-id' -``` - -#### ghe-support-upload - -此实用程序会将您的设备中的信息发送到 {% data variables.product.prodname_enterprise %} Support。 您可以指定本地文件，或通过 `STDIN` 提供最大 100MB 的数据流。 可以选择将上传的数据与支持事件单相关联。 - -要将文件发送至 {% data variables.contact.github_support %} 并关联文件与事件单： -```shell -ghe-support-upload -f path/to/your/file -t ticket-id -``` - -要通过 `STDIN` 上传数据并关联数据与事件单： -```shell -ghe-repl-status -vv | ghe-support-upload -t ticket-id -d "Verbose Replication Status" -``` - -在本例中，`ghe-repl-status -vv` 会发送副本设备中的 verbose 状态信息。 您应将 `ghe-repl-status -vv` 替换为要传输到 `STDIN` 的特定数据，并将 `Verbose Replication Status` 替换为数据的简单说明。 {% data reusables.enterprise_enterprise_support.support_will_ask_you_to_run_command %} - -### 升级 {% data variables.product.prodname_ghe_server %} - -#### ghe-upgrade - -此实用程序会安装或验证升级包。 如果升级失败或中断，您还可以使用此实用程序回滚补丁版本。 更多信息请参阅“[升级 {% data variables.product.prodname_ghe_server %}”](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-github-enterprise-server/)。 - -要验证升级包： -```shell -ghe-upgrade --verify UPGRADE-PACKAGE-FILENAME -``` - -要安装升级包： -```shell -ghe-upgrade UPGRADE-PACKAGE-FILENAME -``` - -{% data reusables.enterprise_installation.command-line-utilities-ghe-upgrade-rollback %} - -#### ghe-upgrade-scheduler - -此实用程序可以管理已排定的升级包安装。 您可以显示、新建或移除已排定的安装。 您必须使用 cron 表达式创建日程。 更多信息请参阅 [Cron 维基百科词条](https://en.wikipedia.org/wiki/Cron#Overview)。 - -要安排新的包安装： -```shell -$ ghe-upgrade-scheduler -c "0 2 15 12 *" UPGRADE-PACKAGE-FILENAME -``` - -要显示已安排的包安装： -```shell -$ ghe-upgrade-scheduler -s UPGRADE PACKAGE FILENAME -> 0 2 15 12 * /usr/local/bin/ghe-upgrade -y -s UPGRADE-PACKAGE-FILENAME > /data/user/common/UPGRADE-PACKAGE-FILENAME.log 2>&1 -``` - -要删除已安排的包安装： -```shell -$ ghe-upgrade-scheduler -r UPGRADE PACKAGE FILENAME -``` - -#### ghe-update-check - -此实用程序将检查 {% data variables.product.prodname_enterprise %} 是否有新的补丁版本可用。 如果有新的补丁版本，并且实例中有可用空间，系统将下载此包。 默认情况下，包会保存到 */var/lib/ghe-updates*。 管理员随后可[执行升级](/enterprise/admin/guides/installation/updating-the-virtual-machine-and-physical-resources/)。 - -包含下载状态的文件位于 */var/lib/ghe-updates/ghe-update-check.status*。 - -要查看最新的 {% data variables.product.prodname_enterprise %} 版本，请使用 `-i` 开关。 - -```shell -$ ssh -p 122 admin@hostname -- 'ghe-update-check' -``` - -### 用户管理 - -#### ghe-license-usage - -此实用程序可按 JSON 格式导出安装用户列表。 如果您的实例连接至 {% data variables.product.prodname_ghe_cloud %}，{% data variables.product.prodname_ghe_server %} 将使用此信息向 {% data variables.product.prodname_ghe_cloud %} 报告许可信息。 更多信息请参阅“[将 {% data variables.product.prodname_ghe_server %} 连接至 {% data variables.product.prodname_ghe_cloud %} ](/enterprise/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)。” - -默认情况下，生成的 JSON 文件中的用户列表为加密格式。 使用 `-h` 标志可获取更多选项。 - -```shell -ghe-license-usage -``` - -#### ghe-org-membership-update - -此实用程序将对您的实例中的所有成员强制实施默认的组织成员关系可见性设置。 更多信息请参阅“[配置组织成员关系的可见性](/enterprise/{{ currentVersion }}/admin/guides/user-management/configuring-visibility-for-organization-membership)”。设置选项为 `public` 或 `private`。 - -```shell -ghe-org-membership-update --visibility=SETTING -``` - -#### ghe-user-csv - -此实用程序可将所有安装用户列表导出为 CSV 格式。 CSV 文件包含电子邮件地址、用户所属类型（例如管理员、用户）、用户拥有的仓库数量、SSH 密钥数量、组织成员关系数量、上次登录的 IP 地址等。 使用 `-h` 标志可获取更多选项。 - -```shell -ghe-user-csv -o > users.csv -``` - -#### ghe-user-demote - -此实用程序会将指定用户从管理员状态降级为普通用户状态。 建议使用 Web UI 执行此操作，但会在 `ghe-user-promote` 实用程序运行出错并且需要再次通过 CLI 将用户降级的情况下提供此实用程序。 - -```shell -ghe-user-demote some-user-name -``` - -#### ghe-user-promote - -此实用程序会将指定用户帐户升级为站点管理员。 - -```shell -ghe-user-promote some-user-name -``` - -#### ghe-user-suspend - -此实用程序会挂起指定用户，避免他们登录、推送或从仓库拉取。 - -```shell -ghe-user-suspend some-user-name -``` - -#### ghe-user-unsuspend - -此实用程序会取消挂起指定用户，向他们授予登录、推送以及从仓库拉取的权限。 - -```shell -ghe-user-unsuspend some-user-name -``` diff --git a/translations/zh-CN/content/admin/installation/configuring-a-hostname.md b/translations/zh-CN/content/admin/installation/configuring-a-hostname.md deleted file mode 100644 index d552b3040f3c..000000000000 --- a/translations/zh-CN/content/admin/installation/configuring-a-hostname.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: 配置主机名 -intro: 我们建议为您的设备设置主机名，不建议使用硬编码 IP 地址。 -redirect_from: - - /enterprise/admin/guides/installation/configuring-hostnames/ - - /enterprise/admin/installation/configuring-a-hostname -versions: - enterprise-server: '*' ---- - -如果配置的是主机名，而不是硬编码 IP 地址，您将能够更改运行 {% data variables.product.product_location_enterprise %} 的物理硬件，而不会影响用户或客户端软件。 - -{% data variables.enterprise.management_console %} 中的主机名设置应设置为合适的完全限定域名 (FQDN)，此域名可在互联网上或您的内部网络内解析。 例如，您的主机名设置可以是 `github.companyname.com`。我们还建议为选定的主机名启用子域隔离，以缓解多种跨站点脚本样式漏洞。 更多关于主机名设置的信息，请参阅 [HTTP RFC 的第 2.1 节](https://tools.ietf.org/html/rfc1123#section-2)。 - -{% data reusables.enterprise_installation.changing-hostname-not-supported %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.hostname-menu-item %} -4. 输入想要为 {% data variables.product.product_location_enterprise %} 设置的主机名。 ![用于设置主机名的字段](/assets/images/enterprise/management-console/hostname-field.png) -5. 要测试新主机名的 DNS 和 SSL 设置，请单击 **Test domain settings**。 ![测试域设置按钮](/assets/images/enterprise/management-console/test-domain-settings.png) -{% data reusables.enterprise_management_console.test-domain-settings-failure %} -{% data reusables.enterprise_management_console.save-settings %} - -配置完主机名后，建议为 {% data variables.product.product_location_enterprise %} 启用子域隔离。 更多信息请参阅“[启用子域隔离](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-subdomain-isolation/)”。 diff --git a/translations/zh-CN/content/admin/installation/configuring-an-outbound-web-proxy-server.md b/translations/zh-CN/content/admin/installation/configuring-an-outbound-web-proxy-server.md deleted file mode 100644 index 58a31b7c475c..000000000000 --- a/translations/zh-CN/content/admin/installation/configuring-an-outbound-web-proxy-server.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: 配置出站 Web 代理服务器 -intro: '代理服务器为 {% data variables.product.product_location_enterprise %} 额外提供了一级安全性。' -redirect_from: - - /enterprise/admin/guides/installation/configuring-a-proxy-server/ - - /enterprise/admin/installation/configuring-an-outbound-web-proxy-server -versions: - enterprise-server: '*' ---- - -为 {% data variables.product.product_location_enterprise %} 启用代理服务器后，除非已将目标主机添加为 HTTP 代理排除项，否则会先通过代理服务器发送由 {% data variables.product.prodname_ghe_server %} 发送的出站消息。 出站消息类型包括传出 web 挂钩、上传包和提取旧头像。 代理服务器的 URL 为协议、域或 IP 地址外加端口号，例如 `http://127.0.0.1:8123`。 - -{% note %} - -**注**：要将 {% data variables.product.product_location_enterprise %} 连接到 {% data variables.product.prodname_dotcom_the_website %}，您的代理配置必须允许连接到 `github.com` 和 `api.github.com`。 更多信息请参阅“[将 {% data variables.product.prodname_ghe_server %} 连接到 {% data variables.product.prodname_dotcom_the_website %}](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/connecting-github-enterprise-server-to-github-com)”。 - -{% endnote %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -4. 在 **HTTP Proxy Server** 下，输入代理服务器的 URL。 ![用于输入 HTTP 代理服务器 URL 的字段](/assets/images/enterprise/management-console/http-proxy-field.png) -5. 或者在 **HTTP Proxy Exclusion** 下输入不需要进行代理访问的任意主机，并以逗号分隔主机。 ![输入任何 HTTP 代理排除项的字段](/assets/images/enterprise/management-console/http-proxy-exclusion-field.png) -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/zh-CN/content/admin/installation/configuring-applications.md b/translations/zh-CN/content/admin/installation/configuring-applications.md deleted file mode 100644 index 6b0fbc5a0856..000000000000 --- a/translations/zh-CN/content/admin/installation/configuring-applications.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: 配置应用程序 -intro: '您可以为 {% data variables.product.product_location_enterprise %} 配置内部应用程序设置。' -redirect_from: - - /enterprise/admin/installation/configuring-applications -versions: - enterprise-server: '*' ---- - -### 调整图像缓存 - -您可以选择 {% data variables.product.product_location_enterprise %} 缓存头像的时长。 如果您增加缓存时间，则会增加加载用户头像所需的时长。 将缓存时间值配置为过小的值会导致 {% data variables.product.product_location_enterprise %} 工作进程过载。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -3. 在左侧边栏中，单击 **Applications**。 ![设置侧边栏中的 Applications 选项卡](/assets/images/enterprise/management-console/sidebar-applications.png) -4. 在“Avatar image cache time (seconds)（头像图像缓存时间（秒））”下，输入希望 {% data variables.product.product_location_enterprise %} 缓存头像图像的秒数。 ![头像图像缓存表单字段](/assets/images/enterprise/management-console/add-image-caching-value-field.png) -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/zh-CN/content/admin/installation/configuring-backups-on-your-appliance.md b/translations/zh-CN/content/admin/installation/configuring-backups-on-your-appliance.md deleted file mode 100644 index 97e5d18b21d9..000000000000 --- a/translations/zh-CN/content/admin/installation/configuring-backups-on-your-appliance.md +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: 在设备上配置备份 -redirect_from: - - /enterprise/admin/categories/backups-and-restores/ - - /enterprise/admin/articles/backup-and-recovery/ - - /enterprise/admin/articles/backing-up-github-enterprise/ - - /enterprise/admin/articles/restoring-github-enterprise/ - - /enterprise/admin/articles/backing-up-repository-data/ - - /enterprise/admin/articles/restoring-enterprise-data/ - - /enterprise/admin/articles/restoring-repository-data/ - - /enterprise/admin/articles/backing-up-enterprise-data/ - - /enterprise/admin/guides/installation/backups-and-disaster-recovery/ - - /enterprise/admin/installation/configuring-backups-on-your-appliance -intro: '作为灾难恢复计划的一部分，您可以通过配置自动备份的方式保护 {% data variables.product.product_location_enterprise %} 中的生产数据。' -versions: - enterprise-server: '*' ---- - -### 关于 {% data variables.product.prodname_enterprise_backup_utilities %} - -{% data variables.product.prodname_enterprise_backup_utilities %} 是在单独主机上安装的备份系统，会通过安全的 SSH 网络连接定期生成 {% data variables.product.product_location_enterprise %} 的备份快照。 您可以使用快照将现有的 {% data variables.product.prodname_ghe_server %} 实例从备份主机还原为上一个状态。 - -只有自上一个快照之后添加的数据将通过网络传输并占用额外的物理存储空间。 要最大限度地减小对性能的影响，会以最低 CPU/IO 优先级在线执行备份。 您不需要排定维护窗口来执行备份。 - -更多关于功能、要求和高级用法的详细信息，请参阅 [{% data variables.product.prodname_enterprise_backup_utilities %} 自述文件](https://github.com/github/backup-utils#readme)。 - -### 基本要求 - -要使用 {% data variables.product.prodname_enterprise_backup_utilities %}，您必须将 Linux 或 Unix 主机系统与 {% data variables.product.product_location_enterprise %} 分开。 - -您还可以将 {% data variables.product.prodname_enterprise_backup_utilities %} 集成到现有环境中，以便长期、永久地存储重要数据。 - -建议将备份主机和 {% data variables.product.product_location_enterprise %} 放置在相距较远的位置。 这样可以确保在主要站点发生重大事故或网络故障的情况下通过备份进行还原。 - -物理存储要求将因 Git 仓库磁盘使用情况以及预计的增长情况而异： - -| 硬件 | 建议 | -| -------- | ----------------- | -| **vCPU** | 2 | -| **内存** | 2 GB | -| **存储器** | 等于为主要实例分配的存储空间的五倍 | - -根据您的使用情况（例如用户活动和选定的集成），可能需要更多资源。 - -### 安装 {% data variables.product.prodname_enterprise_backup_utilities %} - -{% note %} - -**注**：为确保还原的设备立即可用，即使采用 Geo-replication 配置，也应针对主要实例执行备份。 - -{% endnote %} - -1. 下载最新的 [{% data variables.product.prodname_enterprise_backup_utilities %} 版本](https://github.com/github/backup-utils/releases)并使用 `tar` 命令解压文件。 - ```shell - $ tar -xzvf /path/to/github-backup-utils-vMAJOR.MINOR.PATCH.tar.gz - ``` -2. 将包含的 `backup.config-example` 文件复制到 `backup.config`，并在编辑器中打开。 -3. 将 `GHE_HOSTNAME` 值设为主要 {% data variables.product.prodname_ghe_server %} 实例的主机名或 IP 地址。 -4. 将 `GHE_DATA_DIR` 值设为您希望存储备份快照的文件系统位置。 -5. 打开主要实例的设置页面（网址为 `https://HOSTNAME/setup/settings`），并将备份主机的 SSH 密钥添加到已授权 SSH 密钥列表中。 更多信息请参阅[访问管理 shell (SSH)](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-administrative-shell-ssh/)。 -5. 使用 `ghe-host-chec` 命令确认与 {% data variables.product.product_location_enterprise %} 的 SSH 连接。 - ```shell - $ bin/ghe-host-check - ``` - 6. 要创建初次完整备份，请运行 `ghe-backup` 命令。 - ```shell - $ bin/ghe-backup - ``` - -有关高级用法的更多信息，请参阅 [{% data variables.product.prodname_enterprise_backup_utilities %} 自述文件](https://github.com/github/backup-utils#readme)。 - -### 排定备份 - -您可以使用 `cron(8)` 命令或类似的命令排定服务在备份主机上排定定期备份。 配置的备份频率将决定您的恢复计划中的最坏情况恢复点目标 (RPO)。 例如，如果您已排定在每天午夜运行备份，则在发生灾难的情况下，可能丢失长达 24 小时的数据。 建议在开始时采用每小时备份日程，从而确保在主要站点数据受到破坏时，最坏情况下最多会丢失一小时的数据。 - -如果备份尝试重复，`ghe-backup` 命令将中止并显示错误消息，指示存在同时备份。 如果出现这种情况，建议降低已排定的备份的频率。 更多信息请参阅 [{% data variables.product.prodname_enterprise_backup_utilities %} 自述文件](https://github.com/github/backup-utils#scheduling-backups)的“排定备份”部分。 - -### 还原备份 - -如果主要站点发生的故障或灾难性事件的时间较长，要还原 {% data variables.product.product_location_enterprise %}，请提供另一个 {% data variables.product.prodname_enterprise %} 设备并从备份主机执行还原。 在还原设备之前，您必须将备份主机的 SSH 密钥作为已授权 SSH 密钥添加到目标 {% data variables.product.prodname_enterprise %} 设备。 - -要通过上一个成功快照还原 {% data variables.product.product_location_enterprise %}，请使用 `ghe-restore` 命令。 您看到的输出应类似于： - -```shell -$ ghe-restore -c 169.154.1.1 -> Checking for leaked keys in the backup snapshot that is being restored ... -> * No leaked keys found -> Connect 169.154.1.1:122 OK (v2.9.0) - -> WARNING: All data on GitHub Enterprise appliance 169.154.1.1 (v2.9.0) -> will be overwritten with data from snapshot 20170329T150710. -> Please verify that this is the correct restore host before continuing. -> Type 'yes' to continue: yes - -> Starting restore of 169.154.1.1:122 from snapshot 20170329T150710 -# ...output truncated -> Completed restore of 169.154.1.1:122 from snapshot 20170329T150710 -> Visit https://169.154.1.1/setup/settings to review appliance configuration. -``` - -{% note %} - -**注**：网络设置不包含在备份快照中。 您必须根据环境的要求在目标 {% data variables.product.prodname_ghe_server %} 设备上手动配置网络。 - -{% endnote %} - -您可以将以下附加选项与 `ghe-restore` 命令结合使用： -- `-c` 标志会重写目标主机上的设置、证书和许可数据，即使已配置也不例外。 如果您要为测试设置暂存实例，并且希望在目标设备上保留现有配置，请省略此标志。 更多信息请参阅 [{% data variables.product.prodname_enterprise_backup_utilities %} 自述文件](https://github.com/github/backup-utils#using-the-backup-and-restore-commands)的“使用备份和还原命令”部分。 -- `-s` 标志允许您选择其他备份快照。 - diff --git a/translations/zh-CN/content/admin/installation/configuring-built-in-firewall-rules.md b/translations/zh-CN/content/admin/installation/configuring-built-in-firewall-rules.md deleted file mode 100644 index 074b60347978..000000000000 --- a/translations/zh-CN/content/admin/installation/configuring-built-in-firewall-rules.md +++ /dev/null @@ -1,115 +0,0 @@ ---- -title: 配置内置防火墙规则 -intro: '您可以查看默认防火墙规则并自定义 {% data variables.product.product_location_enterprise %} 的规则。' -redirect_from: - - /enterprise/admin/guides/installation/configuring-firewall-settings/ - - /enterprise/admin/installation/configuring-built-in-firewall-rules -versions: - enterprise-server: '*' ---- - -### 关于 {% data variables.product.product_location_enterprise %} 的防火墙 - -{% data variables.product.prodname_ghe_server %} 在虚拟设备上使用 Ubuntu 的简单防火墙 (UFW)。 更多信息请参阅 Ubuntu 文档中的“[UFW](https://help.ubuntu.com/community/UFW)”。 {% data variables.product.prodname_ghe_server %} automatically updates the firewall allowlist of allowed services with each release. - -安装 {% data variables.product.prodname_ghe_server %} 之后，所有必要的网络端口都会自动打开，以接受连接。 每个非必要的端口都会自动配置为 `deny`，默认传出策略会配置为 `allow`。 会为任何新连接启用状态跟踪；这些连接通常是 `SYN` 位置 1 的网络数据包。 更多信息请参阅“[网络端口](/enterprise/admin/guides/installation/network-ports)”。 - -UFW 防火墙还会打开 {% data variables.product.prodname_ghe_server %} 所需的其他多个端口才能正常运行。 更多关于 UFW 规则集的信息，请参阅 [UFW 自述文件](https://bazaar.launchpad.net/~jdstrand/ufw/0.30-oneiric/view/head:/README#L213)。 - -### 查看默认防火墙规则 - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. 要查看默认防火墙规则，请使用 `sudo ufw status` 命令。 您看到的输出应类似于： - ```shell - $ sudo ufw status - > Status: active - > To Action From - > -- ------ ---- - > ghe-1194 ALLOW Anywhere - > ghe-122 ALLOW Anywhere - > ghe-161 ALLOW Anywhere - > ghe-22 ALLOW Anywhere - > ghe-25 ALLOW Anywhere - > ghe-443 ALLOW Anywhere - > ghe-80 ALLOW Anywhere - > ghe-8080 ALLOW Anywhere - > ghe-8443 ALLOW Anywhere - > ghe-9418 ALLOW Anywhere - > ghe-1194 (v6) ALLOW Anywhere (v6) - > ghe-122 (v6) ALLOW Anywhere (v6) - > ghe-161 (v6) ALLOW Anywhere (v6) - > ghe-22 (v6) ALLOW Anywhere (v6) - > ghe-25 (v6) ALLOW Anywhere (v6) - > ghe-443 (v6) ALLOW Anywhere (v6) - > ghe-80 (v6) ALLOW Anywhere (v6) - > ghe-8080 (v6) ALLOW Anywhere (v6) - > ghe-8443 (v6) ALLOW Anywhere (v6) - > ghe-9418 (v6) ALLOW Anywhere (v6) - ``` - -### 添加自定义防火墙规则 - -{% warning %} - -**警告：** 在添加自定义防火墙规则之前，请备份当前规则，以便在需要时可以重置为已知的工作状态。 如果您被锁定在服务器之外，请与 {% data variables.contact.contact_ent_support %} 联系，以重新配置原始防火墙规则。 恢复原始防火墙规则会导致服务器停机。 - -{% endwarning %} - -1. 配置自定义防火墙规则。 -2. 使用`状态编号`命令检查每个新规则的状态。 - ```shell - $ sudo ufw status numbered - ``` -3. 要备份自定义防火墙规则，请使用 `cp` 命令将规则移至新文件。 - ```shell - $ sudo cp -r /lib/ufw ~/ufw.backup - ``` - -升级 {% data variables.product.product_location_enterprise %} 后，您必须重新应用自定义防火墙规则。 我们建议您创建脚本来重新应用防火墙自定义规则。 - -### 恢复默认防火墙规则 - -如果更改防火墙规则后出现问题，您可以通过原始备份重置规则。 - -{% warning %} - -**警告**：如果您对防火墙进行更改之前未备份原始规则，请联系 {% data variables.contact.contact_ent_support %} 获取更多帮助。 - -{% endwarning %} - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. 要恢复之前的备份规则，请使用 `cp` 命令将规则复制到防火墙。 - ```shell - $ sudo cp -f ~/ufw.backup/*rules /lib/ufw - ``` -3. 使用 `systemctl` 命令重新启动防火墙。 - ```shell - $ sudo systemctl restart ufw - ``` -4. 使用 `ufw status` 命令确认规则已恢复为默认状态。 - ```shell - $ sudo ufw status - > Status: active - > To Action From - > -- ------ ---- - > ghe-1194 ALLOW Anywhere - > ghe-122 ALLOW Anywhere - > ghe-161 ALLOW Anywhere - > ghe-22 ALLOW Anywhere - > ghe-25 ALLOW Anywhere - > ghe-443 ALLOW Anywhere - > ghe-80 ALLOW Anywhere - > ghe-8080 ALLOW Anywhere - > ghe-8443 ALLOW Anywhere - > ghe-9418 ALLOW Anywhere - > ghe-1194 (v6) ALLOW Anywhere (v6) - > ghe-122 (v6) ALLOW Anywhere (v6) - > ghe-161 (v6) ALLOW Anywhere (v6) - > ghe-22 (v6) ALLOW Anywhere (v6) - > ghe-25 (v6) ALLOW Anywhere (v6) - > ghe-443 (v6) ALLOW Anywhere (v6) - > ghe-80 (v6) ALLOW Anywhere (v6) - > ghe-8080 (v6) ALLOW Anywhere (v6) - > ghe-8443 (v6) ALLOW Anywhere (v6) - > ghe-9418 (v6) ALLOW Anywhere (v6) - ``` diff --git a/translations/zh-CN/content/admin/installation/configuring-collectd.md b/translations/zh-CN/content/admin/installation/configuring-collectd.md deleted file mode 100644 index 66643fb4129c..000000000000 --- a/translations/zh-CN/content/admin/installation/configuring-collectd.md +++ /dev/null @@ -1,57 +0,0 @@ ---- -title: 配置 collectd -intro: '{% data variables.product.prodname_enterprise %} 可以通过“collectd”收集数据并将数据发送到外部“collectd”服务器。 除了其他指标外，我们还会收集标准数据集，例如 CPU 利用率、内存与磁盘使用量、网络接口流量与错误，以及 VM 的总负荷。' -redirect_from: - - /enterprise/admin/articles/configuring-collectd/ - - /enterprise/admin/installation/configuring-collectd -versions: - enterprise-server: '*' ---- - -### 设置外部 `collectd` 服务器 - -如果您尚未设置外部 `collectd` 服务器，则需要首先进行设置，然后才能在 {% data variables.product.product_location_enterprise %} 上启用 `collectd` 转发。 您的 `collectd` 服务器运行的 `collectd` 版本不得低于 5.x。 - -1. 登录 `collectd` 服务器。 -2. 创建或编辑 `collectd` 配置文件，以加载网络插件并为服务器和端口指令填入适当的值。 在大多数分发中，此文件位于 `/etc/collectd/collectd.conf` 中 - -用于运行 `collectd` 服务器的示例 *collectd.conf*： - - LoadPlugin network - ... - ... - - Listen "0.0.0.0" "25826" - - -### 在 {% data variables.product.prodname_enterprise %} 上启用 collectd 转发 - -默认情况下，`collectd` 转发在 {% data variables.product.prodname_enterprise %} 上处于禁用状态。 请按照以下操作步骤启用并配置 `collectd` 转发： - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -1. 在日志转发设置下，选择 **Enable collectd forwarding**。 -1. 在 **Server address** 字段中，输入要将 {% data variables.product.prodname_enterprise %} 设备统计信息转发到的 `collectd` 服务器的地址。 -1. 在 **Port** 字段中，输入用于连接到 `collectd` 服务器的端口。 （默认为 25826） -1. 在 **Cryptographic setup** 下拉菜单中，选择与 `collectd` 服务器通信的安全等级。 （无、签名数据包或加密数据包。） -{% data reusables.enterprise_management_console.save-settings %} - -### 使用 `ghe-export-graphs` 导出 collectd 数据 - -命令行工具 `ghe-export-graphs` 将导出 `collectd` 存储在 RRD 数据库中的数据。 此命令会将数据转换为 XML 格式并导出到一个 tarball (.tgz) 中。 - -此文件的主要用途是为 {% data variables.contact.contact_ent_support %} 团队提供关于 VM 性能的数据（无需下载整个支持包）， 不应包含在常规备份导出范围中，也没有对应的导入文件。 如果您联系 {% data variables.contact.contact_ent_support %}，我们可能会要求您提供此数据，以便协助故障排查。 - -#### 用法 - -```shell -ssh -p 122 admin@[hostname] -- 'ghe-export-graphs' && scp -P 122 admin@[hostname]:~/graphs.tar.gz . -``` - -### 疑难解答 - -#### 中央 collectd 服务器未收到数据 - -{% data variables.product.prodname_enterprise %} 随附的 `collectd` 的版本为 5.x。`collectd` 5.x 不向后兼容 V4.x 版本系列。 中央 `collectd` 服务器的版本至少需要是 5.x 才能接受从 {% data variables.product.product_location_enterprise %} 发送的数据。 - -要获取其他问题的帮助，请联系 {% data variables.contact.contact_ent_support %}。 diff --git a/translations/zh-CN/content/admin/installation/configuring-dns-nameservers.md b/translations/zh-CN/content/admin/installation/configuring-dns-nameservers.md deleted file mode 100644 index 7153fae575ae..000000000000 --- a/translations/zh-CN/content/admin/installation/configuring-dns-nameservers.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: 配置 DNS 域名服务器 -intro: '在 DHCP 租约提供域名服务器时，{% data variables.product.prodname_ghe_server %} 将为 DNS 设置使用动态主机配置协议 (DHCP)。 如果域名服务器不是由动态主机配置协议 (DHCP) 租约提供，或者您需要使用特定的 DNS 设置，可以手动指定域名服务器。' -redirect_from: - - /enterprise/admin/guides/installation/about-dns-nameservers/ - - /enterprise/admin/installation/configuring-dns-nameservers -versions: - enterprise-server: '*' ---- - -指定的域名服务器必须解析 {% data variables.product.product_location_enterprise %} 的主机名。 - -{% data reusables.enterprise_installation.changing-hostname-not-supported %} - -### 使用虚拟机控制台配置域名服务器 - -{% data reusables.enterprise_installation.open-vm-console-start %} -2. 为实例配置域名服务器。 -{% data reusables.enterprise_installation.vm-console-done %} - -### 使用管理 shell 配置域名服务器 - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. 要编辑域名服务器，请输入： - ```shell - $ sudo vim /etc/resolvconf/resolv.conf.d/head - ``` -3. 附加任何 `nameserver` 条目，然后保存文件。 -4. 验证变更后，请保存文件。 -5. 要向 {% data variables.product.product_location_enterprise %} 添加新的域名服务器条目，请输入： - ```shell - $ sudo service resolvconf restart - ``` diff --git a/translations/zh-CN/content/admin/installation/configuring-git-large-file-storage-on-github-enterprise-server.md b/translations/zh-CN/content/admin/installation/configuring-git-large-file-storage-on-github-enterprise-server.md deleted file mode 100644 index a952457d656e..000000000000 --- a/translations/zh-CN/content/admin/installation/configuring-git-large-file-storage-on-github-enterprise-server.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: 在 GitHub Enterprise Server 上配置 Git Large File Storage -intro: '{% data reusables.enterprise_site_admin_settings.configuring-large-file-storage-short-description %}' -redirect_from: - - /enterprise/admin/guides/installation/configuring-git-large-file-storage-on-github-enterprise/ - - /enterprise/admin/installation/configuring-git-large-file-storage-on-github-enterprise-server -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/zh-CN/content/admin/installation/configuring-git-large-file-storage-to-use-a-third-party-server.md b/translations/zh-CN/content/admin/installation/configuring-git-large-file-storage-to-use-a-third-party-server.md deleted file mode 100644 index 61a87bfe2624..000000000000 --- a/translations/zh-CN/content/admin/installation/configuring-git-large-file-storage-to-use-a-third-party-server.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: 将 Git Large File Storage 配置为使用第三方服务器 -intro: '在 {% data variables.product.prodname_ghe_server %} 设备上禁用 {% data variables.large_files.product_name_short %} 并使用要存储大型资源的服务器 URL 配置 {% data variables.large_files.product_name_short %} 客户端，即可在第三方服务器上使用 {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %})。' -redirect_from: - - /enterprise/admin/installation/configuring-git-large-file-storage-to-use-a-third-party-server -versions: - enterprise-server: '*' ---- - -{% data reusables.large_files.storage_assets_location %} -{% data reusables.large_files.rejected_pushes %} - -1. 在 {% data variables.product.prodname_ghe_server %} 设备上禁用 {% data variables.large_files.product_name_short %}。 更多信息请参阅“[配置 {% data variables.large_files.product_name_long %}](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-git-large-file-storage#configuring-git-large-file-storage-for-your-appliance)”。 - -2. 创建指向第三方服务器的 {% data variables.large_files.product_name_short %} 配置文件。 - ```shell - # Show default configuration - $ git lfs env - > git-lfs/1.1.0 (GitHub; darwin amd64; go 1.5.1; git 94d356c) - > git version 2.7.4 (Apple Git-66) -   - > Endpoint=https://GITHUB-ENTERPRISE-HOST/path/to/repo/info/lfs (auth=basic) -   - # Create .lfsconfig that points to third party server. - $ git config -f .lfsconfig remote.origin.lfsurl https://THIRD-PARTY-LFS-SERVER/path/to/repo - $ git lfs env - > git-lfs/1.1.0 (GitHub; darwin amd64; go 1.5.1; git 94d356c) - > git version 2.7.4 (Apple Git-66) -   - > Endpoint=https://THIRD-PARTY-LFS-SERVER/path/to/repo/info/lfs (auth=none) -   - # Show the contents of .lfsconfig - $ cat .lfsconfig - [remote "origin"] - lfsurl = https://THIRD-PARTY-LFS-SERVER/path/to/repo - ``` - -3. 为使各用户的 {% data variables.large_files.product_name_short %} 配置相同，请向仓库提交自定义 `.lfsconfig` 文件。 - ```shell - $ git add .lfsconfig - $ git commit -m "Adding LFS config file" - ``` -3. 迁移任何现有的 {% data variables.large_files.product_name_short %} 资源。 更多信息请参阅“[迁移到其他 {% data variables.large_files.product_name_long %} 服务器](/enterprise/{{ currentVersion }}/admin/guides/installation/migrating-to-a-different-git-large-file-storage-server)”。 - -### 延伸阅读 - -- "[关于 {% data variables.large_files.product_name_long %}](/articles/about-git-large-file-storage/)" -- "[配置 {% data variables.large_files.product_name_long %}](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-git-large-file-storage)" -- "[迁移到其他 {% data variables.large_files.product_name_long %} 服务器](/enterprise/{{ currentVersion }}/admin/guides/installation/migrating-to-a-different-git-large-file-storage-server)" -- [{% data variables.large_files.product_name_long %} 项目站点](https://git-lfs.github.com/) diff --git a/translations/zh-CN/content/admin/installation/configuring-git-large-file-storage.md b/translations/zh-CN/content/admin/installation/configuring-git-large-file-storage.md deleted file mode 100644 index ab2ac9400105..000000000000 --- a/translations/zh-CN/content/admin/installation/configuring-git-large-file-storage.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: 配置 Git Large File Storage -intro: '安装 [{% data variables.large_files.product_name_short %}] 后 (/articles/installing-git-large-file-storage/)，需要将其与仓库中的大文件相关联。' -redirect_from: - - /enterprise/admin/articles/configuring-git-large-file-storage-for-a-repository/ - - /enterprise/admin/articles/configuring-git-large-file-storage-for-every-repository-owned-by-a-user-account-or-organization/ - - /enterprise/admin/articles/configuring-git-large-file-storage-for-your-appliance/ - - /enterprise/admin/installation/configuring-git-large-file-storage -versions: - enterprise-server: '*' ---- - -### 关于 {% data variables.large_files.product_name_long %} - -{% data reusables.enterprise_site_admin_settings.configuring-large-file-storage-short-description %} 您可以将 {% data variables.large_files.product_name_long %} 与单一仓库、所有个人或组织仓库、{% data variables.product.product_location_enterprise %} 中的每一个仓库结合使用。 您需要先为设备启用 {% data variables.large_files.product_name_short %}，然后才能为特定仓库或组织启用 {% data variables.large_files.product_name_short %}。 - -{% data reusables.large_files.storage_assets_location %} -{% data reusables.large_files.rejected_pushes %} - -更多信息请参阅“[关于 {% data variables.large_files.product_name_long %}](/articles/about-git-large-file-storage)”、“[大文件版本管理](/enterprise/user/articles/versioning-large-files/)”以及 [{% data variables.large_files.product_name_long %} 项目站点](https://git-lfs.github.com/)。 - -### 为设备配置 {% data variables.large_files.product_name_long %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -4. 在“{% data variables.large_files.product_name_short %} 访问权限”下，使用下拉菜单，然后单击 **Enabled（已启用）**或 **Disabled（已禁用）**。 ![Git LFS access](/assets/images/enterprise/site-admin-settings/git-lfs-admin-center.png) - -### 为各个仓库配置 {% data variables.large_files.product_name_long %} - -{% data reusables.enterprise_site_admin_settings.override-policy %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -{% data reusables.enterprise_site_admin_settings.git-lfs-toggle %} - -### 为用户帐户或组织拥有的每个仓库配置 {% data variables.large_files.product_name_long %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.search-user-or-org %} -{% data reusables.enterprise_site_admin_settings.click-user-or-org %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -{% data reusables.enterprise_site_admin_settings.git-lfs-toggle %} diff --git a/translations/zh-CN/content/admin/installation/configuring-github-enterprise-server-for-high-availability.md b/translations/zh-CN/content/admin/installation/configuring-github-enterprise-server-for-high-availability.md deleted file mode 100644 index 47c96c15d673..000000000000 --- a/translations/zh-CN/content/admin/installation/configuring-github-enterprise-server-for-high-availability.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: 配置 GitHub Enterprise Server 以实现高可用性 -redirect_from: - - /enterprise/admin/guides/installation/high-availability-cluster-configuration/ - - /enterprise/admin/guides/installation/high-availability-configuration/ - - /enterprise/admin/guides/installation/configuring-github-enterprise-for-high-availability/ - - /enterprise/admin/installation/configuring-github-enterprise-server-for-high-availability -intro: '{% data variables.product.prodname_ghe_server %} 支持高可用性操作模式，此模式设计为可在发生影响主设备的硬件故障或重大网络中断的情况下最大限度地减少服务中断。' -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/zh-CN/content/admin/installation/configuring-github-pages-on-your-appliance.md b/translations/zh-CN/content/admin/installation/configuring-github-pages-on-your-appliance.md deleted file mode 100644 index a02a019a032d..000000000000 --- a/translations/zh-CN/content/admin/installation/configuring-github-pages-on-your-appliance.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: 在设备上配置 GitHub Pages -intro: '您可以在实例上启用或禁用 {% data variables.product.prodname_pages %}。 还可以选择将 {% data variables.product.prodname_pages %} 站点设为可公开访问。' -redirect_from: - - /enterprise/admin/guides/installation/disabling-github-enterprise-pages/ - - /enterprise/admin/guides/installation/configuring-github-enterprise-pages/ - - /enterprise/admin/installation/configuring-github-pages-on-your-appliance -versions: - enterprise-server: '*' ---- - -### 将 {% data variables.product.prodname_pages %} 设为可公开访问 - -如果已在实例上启用私有模式，则公众无法访问在 {% data variables.product.product_location_enterprise %} 上托管的 {% data variables.product.prodname_pages %} 站点。 - -{% warning %} - -**警告**：如果启用公共 {% data variables.product.prodname_pages %} 站点，则实例上每个仓库中的每一个 {% data variables.product.prodname_pages %} 站点均可由公众访问。 - -{% endwarning %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.pages-tab %} -4. 选择 **Public Pages**。 ![启用公共页面复选框](/assets/images/enterprise/management-console/public-pages-checkbox.png) -{% data reusables.enterprise_management_console.save-settings %} - -### 在 {% data variables.product.product_location_enterprise %} 上禁用 {% data variables.product.prodname_pages %} - -如果为 {% data variables.product.product_location_enterprise %} 禁用了子域隔离，则还应禁用 {% data variables.product.prodname_pages %}，以免遭受潜在安全漏洞的攻击。 更多信息请参阅“[启用子域隔离](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-subdomain-isolation)”。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.pages-tab %} -4. 取消选择 **Enable Pages**。 ![禁用 {% data variables.product.prodname_pages %} 复选框](/assets/images/enterprise/management-console/pages-select-button.png) -{% data reusables.enterprise_management_console.save-settings %} - -### 延伸阅读 - -- "[启用私有模式](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-private-mode)" diff --git a/translations/zh-CN/content/admin/installation/configuring-rate-limits.md b/translations/zh-CN/content/admin/installation/configuring-rate-limits.md deleted file mode 100644 index b289699312c8..000000000000 --- a/translations/zh-CN/content/admin/installation/configuring-rate-limits.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: 配置速率限制 -intro: '您可以使用 {% data variables.enterprise.management_console %} 为 {% data variables.product.prodname_ghe_server %} 配置速率限制。' -redirect_from: - - /enterprise/admin/installation/configuring-rate-limits -versions: - enterprise-server: '*' ---- - -### 为 {% data variables.product.prodname_enterprise_api %} 启用速率限制 - -在 {% data variables.product.prodname_enterprise_api %} 上启用速率限制可以防止个别用户或未通过身份验证的用户过度使用资源。 For more information, see "[Rate Limiting](/enterprise/{{ currentVersion }}/v3/#rate-limiting)." - -{% note %} - -**注**：{% data variables.enterprise.management_console %} 列出了每种速率限制的时限（按分钟或按小时）。 - -{% endnote %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -2. 在“Rate Limiting”下，选择 **Enable API Rate Limiting**。 ![用于启用 API 速率限制的复选框](/assets/images/enterprise/management-console/api-rate-limits-checkbox.png) -3. 输入对每个 API 的已验证和未验证请求的限制，或者接受预先填入的默认限制。 -{% data reusables.enterprise_management_console.save-settings %} - -### 启用滥用率限制 - -设置滥用率限制可保护 {% data variables.product.product_location_enterprise %} 上的整体服务等级。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -2. 在“Rate Limiting”下，选择 **Enable Abuse Rate Limiting**。 ![用于启用滥用率限制的复选框](/assets/images/enterprise/management-console/abuse-rate-limits-checkbox.png) -3. 输入总请求限制、CPU 限制或对搜索的 CPU 限制，或接受预先填入的默认限制。 -{% data reusables.enterprise_management_console.save-settings %} - -### 启用 Git 速率限制 - -您可以按仓库网络或用户 ID 应用 Git 速率限制。 Git 速率限制以每分钟并行操作数表示，不过会根据当前 CPU 负荷进行调整。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -2. 在“Rate Limiting”下，选择 **Enable Git Rate Limiting**。 ![用于启用 Git 速率限制的复选框](/assets/images/enterprise/management-console/git-rate-limits-checkbox.png) -3. 输入对每个仓库网络或用户 ID 的限制。 ![仓库网络和用户 ID 限制的字段](/assets/images/enterprise/management-console/example-git-rate-limits.png) -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/zh-CN/content/admin/installation/configuring-the-default-visibility-of-new-repositories-on-your-appliance.md b/translations/zh-CN/content/admin/installation/configuring-the-default-visibility-of-new-repositories-on-your-appliance.md deleted file mode 100644 index 2be6d682c3f7..000000000000 --- a/translations/zh-CN/content/admin/installation/configuring-the-default-visibility-of-new-repositories-on-your-appliance.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: 在设备上配置新仓库的默认可见性 -intro: '您可以将通过 {% data variables.product.prodname_ghe_server %} 设备上的 Web 界面创建的所有新仓库的默认可见性设为私有或公共。' -redirect_from: - - /enterprise/admin/installation/configuring-the-default-visibility-of-new-repositories-on-your-appliance -versions: - enterprise-server: '*' ---- - -每次有人在 {% data variables.product.product_location_enterprise %} 上创建新仓库时，此人必须为仓库选择可见性。 当您为实例配置默认可见性设置时，需要选择默认可见性。 有关仓库可见性的更多信息，请参阅“[关于仓库可见性](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)。” - -如果站点管理员不允许成员创建某种类型的仓库，成员将无法创建此类仓库，即使可见性设置默认为此类型。 更多信息请参阅“[限制在实例中创建仓库](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)”。 - -{% tip %} - -**提示**：您可以将更改仓库可见性的权限仅分配给站点管理员。 更多信息请参阅“[阻止用户更改仓库可见性](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-a-repository-s-visibility)”。 - -{% endnote %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -1. 在“默认仓库可见性”下，使用下拉菜单并选择默认可见性。 ![用于为实例选择默认仓库可见性的下拉菜单](/assets/images/enterprise/site-admin-settings/default-repository-visibility-settings.png) - -{% data reusables.enterprise_installation.image-urls-viewable-warning %} diff --git a/translations/zh-CN/content/admin/installation/configuring-the-github-enterprise-server-appliance.md b/translations/zh-CN/content/admin/installation/configuring-the-github-enterprise-server-appliance.md deleted file mode 100644 index 6e7e112342fe..000000000000 --- a/translations/zh-CN/content/admin/installation/configuring-the-github-enterprise-server-appliance.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: 配置 GitHub Enterprise Server 设备 -intro: '在 {% data variables.product.prodname_ghe_server %} 启动并运行后，您可以根据组织的需求对设备进行配置。' -redirect_from: - - /enterprise/admin/guides/installation/basic-configuration/ - - /enterprise/admin/guides/installation/administrative-tools/ - - /enterprise/admin/articles/restricting-ssh-access-to-specific-hosts/ - - /enterprise/admin/guides/installation/configuring-the-github-enterprise-appliance/ - - /enterprise/admin/installation/configuring-the-github-enterprise-server-appliance -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/zh-CN/content/admin/installation/configuring-the-ip-address-using-the-virtual-machine-console.md b/translations/zh-CN/content/admin/installation/configuring-the-ip-address-using-the-virtual-machine-console.md deleted file mode 100644 index 1d7f0b060406..000000000000 --- a/translations/zh-CN/content/admin/installation/configuring-the-ip-address-using-the-virtual-machine-console.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: 使用虚拟机控制台配置 IP 地址 -intro: '默认情况下，{% data variables.product.prodname_ghe_server %} 通过动态主机配置协议 (DHCP) 检索网络设置。 如果您的平台不支持该协议，或者 DHCP 不可用，您也可以使用虚拟机控制台配置网络设置。' -redirect_from: - - /enterprise/admin/installation/configuring-the-ip-address-using-the-virtual-machine-console -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_installation.open-vm-console-start %} -3. 选择配置 `IPv4` 或 `IPv6` 协议。 ![用于选择 IPv4 或 IPv6 协议的选项](/assets/images/enterprise/network-configuration/IPv4-or-IPv6-protocol.png) -4. 配置所选协议的选项。 ![含 IP 协议选项的菜单](/assets/images/enterprise/network-configuration/network-settings-selection.png) -{% data reusables.enterprise_installation.vm-console-done %} diff --git a/translations/zh-CN/content/admin/installation/configuring-time-synchronization.md b/translations/zh-CN/content/admin/installation/configuring-time-synchronization.md deleted file mode 100644 index 554697d7dbb0..000000000000 --- a/translations/zh-CN/content/admin/installation/configuring-time-synchronization.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: 配置时间同步 -intro: '{% data variables.product.prodname_ghe_server %} 通过连接到 NTP 服务器自动同步其时钟。 您可以设置用于同步时钟的 NTP 服务器，也可以使用默认 NTP 服务器。' -redirect_from: - - /enterprise/admin/articles/adjusting-the-clock/ - - /enterprise/admin/articles/configuring-time-zone-and-ntp-settings/ - - /enterprise/admin/articles/setting-ntp-servers/ - - /enterprise/admin/categories/time/ - - /enterprise/admin/installation/configuring-time-synchronization -versions: - enterprise-server: '*' ---- - -### 更改默认 NTP 服务器 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -2. 在左侧边栏中，单击 **Time**。 ![{% data variables.enterprise.management_console %} 边栏中的 Time 按钮](/assets/images/enterprise/management-console/sidebar-time.png) -3. 在“Primary NTP server”下，输入主 NTP 服务器的主机名。 在“Secondary NTP server”下，输入辅助 NTP 服务器的主机名。 ![{% data variables.enterprise.management_console %} 中用于主 NTP 服务器和辅助 NTP 服务器的字段](/assets/images/enterprise/management-console/ntp-servers.png) -4. 在页面底部，单击 **Save settings**。 ![{% data variables.enterprise.management_console %} 中的 Save settings 按钮](/assets/images/enterprise/management-console/save-settings.png) -5. 等待配置运行完毕。 - -### 更正较大的时间偏差 - -NTP 协议会持续更正较小的时间同步偏差。 您可以使用管理 shell 立即同步时间。 - -{% note %} - -**注意：** - - 您无法修改协调世界时 (UTC) 时区。 - - 您应阻止虚拟机监控程序设置虚拟机时钟。 更多信息请参阅虚拟化提供商提供的文档。 - -{% endnote %} - -- 使用 `chronyc` 命令将服务器与配置的 NTP 服务器同步。 例如： - -```shell -$ sudo chronyc -a makestep -``` diff --git a/translations/zh-CN/content/admin/installation/configuring-tls.md b/translations/zh-CN/content/admin/installation/configuring-tls.md deleted file mode 100644 index f672e10641c9..000000000000 --- a/translations/zh-CN/content/admin/installation/configuring-tls.md +++ /dev/null @@ -1,69 +0,0 @@ ---- -title: 配置 TLS -intro: '您可以在 {% data variables.product.product_location_enterprise %} 上配置传输层安全 (TLS)，以便使用由可信证书颁发机构签名的证书。' -redirect_from: - - /enterprise/admin/articles/ssl-configuration/ - - /enterprise/admin/guides/installation/about-tls/ - - /enterprise/admin/installation/configuring-tls -versions: - enterprise-server: '*' ---- - -### 关于传输层安全 - -当 {% data variables.product.prodname_ghe_server %} 首次启动时，会启用 TLS（替代了 SSL）并通过自签名证书进行配置。 由于自签名证书不受 Web 浏览器和 Git 客户端的信任，因此这些客户端将报告证书警告，直至您禁用 TLS 或上传由 Let's Encrypt 等可信颁发机构签名的证书。 - -{% data variables.product.prodname_ghe_server %} 设备将在 SSL 启用时发送 HTTP 严格传输安全标头。 禁用 TLS 会导致用户无法访问设备，因为用户的浏览器将不允许协议降级为 HTTP。 更多信息请参阅 Wikipedia 上的“[HTTP 严格传输安全 (HSTS)](https://en.wikipedia.org/wiki/HTTP_Strict_Transport_Security)”。 - -{% data reusables.enterprise_installation.terminating-tls %} - -要允许用户使用 FIDO U2F 进行双重身份验证，您必须为实例启用 TLS。 更多信息请参阅“[配置双重身份验证](/articles/configuring-two-factor-authentication)”。 - -### 基本要求 - -要在生产中使用 TLS，您必须具有由可信证书颁发机构签名的未加密 PEM 格式的证书。 - -您的证书还需要为“[启用子域隔离](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-subdomain-isolation#about-subdomain-isolation)”中列出的子域配置使用者可选名称，如果证书已由中间证书颁发机构签名，将需要包含完整的证书链。 更多信息请参阅 Wikipedia 上的“[使用者可选名称](http://en.wikipedia.org/wiki/SubjectAltName)”。 - -您可以使用 `ghe-ssl-generate-csr` 命令为实例生成证书签名请求 (CSR)。 更多信息请参阅“[命令行实用程序](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities/#ghe-ssl-generate-csr)”。 - -### 上传自定义 TLS 证书 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -{% data reusables.enterprise_management_console.select-tls-only %} -4. 在“TLS Protocol support”下，选择您想要允许的协议。 ![包含用于选择 TLS 协议的选项的单选按钮](/assets/images/enterprise/management-console/tls-protocol-support.png) -5. 在“Certificate”下，单击 **Choose File**，选择要安装的 TLS 证书或证书链（PEM 格式）。 此文件通常采用 *.pem*、*.crt* 或 *.cer* 扩展名。 ![用于查找 TLS 证书文件的按钮](/assets/images/enterprise/management-console/install-tls-certificate.png) -6. 在“Unencrypted key”下，单击 **Choose File**，选择要安装的 TLS 密钥（PEM 格式）。 此文件通常采用 *.key* 扩展名。 ![用于查找 TLS 密钥文件的按钮](/assets/images/enterprise/management-console/install-tls-key.png) - - {% warning %} - - **警告**：您的 TLS 密钥不得包含密码。 更多信息请参阅“[将密码从密钥文件中移除](/enterprise/{{ currentVersion }}/admin/guides/installation/troubleshooting-ssl-errors#removing-the-passphrase-from-your-key-file)”。 - - {% endwarning %} -{% data reusables.enterprise_management_console.save-settings %} - -### 关于 Let's Encrypt 支持 - -Let's Encrypt 是公共证书颁发机构，他们使用 ACME 协议颁发受浏览器信任的免费、自动化 TLS 证书。 您可以在设备上自动获取并续订 Let's Encrypt 证书，无需手动维护。 - -{% data reusables.enterprise_installation.lets-encrypt-prerequisites %} - -在您启用通过 Let's Encrypt 自动进行 TLS 证书管理后，{% data variables.product.product_location_enterprise %} 将与 Let's Encrypt 服务器通信，以获取证书。 要续订证书，Let's Encrypt 服务器必须通过入站 HTTP 请求验证已配置域名的控制。 - -您还可以在 {% data variables.product.product_location_enterprise %} 上使用 `ghe-ssl-acme` 命令行实用程序自动生成 Let's Encrypt 证书。 更多信息请参阅“[命令行实用程序](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities#ghe-ssl-acme)”。 - -### 使用 Let's Encrypt 配置 TLS - -{% data reusables.enterprise_installation.lets-encrypt-prerequisites %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -{% data reusables.enterprise_management_console.select-tls-only %} -5. 选择 **Enable automation of TLS certificate management using Let's Encrypt**。 ![启用 Let's Encrypt 复选框](/assets/images/enterprise/management-console/lets-encrypt-checkbox.png) -{% data reusables.enterprise_management_console.save-settings %} -{% data reusables.enterprise_management_console.privacy %} -7. 单击 **Request TLS certificate**。 ![Request TLS Certificate 按钮](/assets/images/enterprise/management-console/request-tls-button.png) -8. 单击 **Save configuration**。 diff --git a/translations/zh-CN/content/admin/installation/configuring-your-github-enterprise-server-network-settings.md b/translations/zh-CN/content/admin/installation/configuring-your-github-enterprise-server-network-settings.md deleted file mode 100644 index b99e0752029c..000000000000 --- a/translations/zh-CN/content/admin/installation/configuring-your-github-enterprise-server-network-settings.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: 配置 GitHub Enterprise Server 网络设置 -redirect_from: - - /enterprise/admin/guides/installation/dns-hostname-subdomain-isolation-and-ssl/ - - /enterprise/admin/articles/about-dns-ssl-and-subdomain-settings/ - - /enterprise/admin/articles/configuring-dns-ssl-and-subdomain-settings/ - - /enterprise/admin/guides/installation/configuring-your-github-enterprise-network-settings/ - - /enterprise/admin/installation/configuring-your-github-enterprise-server-network-settings -intro: '使用网络所需的 DNS 域名服务器和主机名配置 {% data variables.product.prodname_ghe_server %}。 您还可以配置代理服务器或防火墙规则。 为实现管理和用户目的，您必须允许访问某些端口。' -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/zh-CN/content/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud.md b/translations/zh-CN/content/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud.md deleted file mode 100644 index 6e06ec183b1f..000000000000 --- a/translations/zh-CN/content/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud.md +++ /dev/null @@ -1,62 +0,0 @@ ---- -title: 将 GitHub Enterprise Server 连接到 GitHub Enterprise Cloud -intro: '启用 {% data variables.product.prodname_github_connect %} 后，您可以在 {% data variables.product.product_location_enterprise %} 与 {% data variables.product.prodname_ghe_cloud %} 之间共用特定的功能和工作流程。' -redirect_from: - - /enterprise/admin/guides/developer-workflow/connecting-github-enterprise-to-github-com/ - - /enterprise/admin/guides/developer-workflow/connecting-github-enterprise-server-to-github-com - - /enterprise/admin/developer-workflow/connecting-github-enterprise-server-to-githubcom/ - - /enterprise/admin/installation/connecting-github-enterprise-server-to-github-enterprise-cloud -permissions: '{% data variables.product.prodname_ghe_server %} 的站点管理员（同时也是 {% data variables.product.prodname_ghe_cloud %} 组织或企业帐户的所有者）可以启用 {% data variables.product.prodname_github_connect %}。' -versions: - enterprise-server: '*' ---- - -### 关于 {% data variables.product.prodname_github_connect %} - -要启用 {% data variables.product.prodname_github_connect %}，必须在 {% data variables.product.product_location_enterprise %} 和 {% data variables.product.prodname_ghe_cloud %} 组织或企业帐户中配置连接。 - -要配置连接，您的代理配置必须允许连接到 `github.com` 和 `api.github.com`。 更多信息请参阅“[配置出站 Web 代理服务器](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-an-outbound-web-proxy-server)”。 - -启用 {% data variables.product.prodname_github_connect %} 后，您将能够启用统一搜索和统一贡献等功能。 有关所有可用功能的更多信息，请参阅“[管理 {% data variables.product.prodname_ghe_server %} 与 {% data variables.product.prodname_ghe_cloud %} 之间的连接](/enterprise/{{ currentVersion }}/admin/installation/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud)”。 - -将 {% data variables.product.product_location_enterprise %} 连接到 {% data variables.product.prodname_ghe_cloud %} 时，{% data variables.product.prodname_dotcom_the_website %} 上会有一条记录存储连接的相关信息： -- {% data variables.product.prodname_ghe_server %} 许可的公钥部分 -- {% data variables.product.prodname_ghe_server %} 许可的哈希 -- {% data variables.product.prodname_ghe_server %} 许可上的客户名称 -- {% data variables.product.product_location_enterprise %} 的主机名 -- {% data variables.product.product_location_enterprise %} 的版本 -- 连接至 {% data variables.product.product_location_enterprise %} 的 {% data variables.product.prodname_dotcom_the_website %} 上的组织或企业帐户 -- {% data variables.product.product_location_enterprise %} 用于向 {% data variables.product.prodname_dotcom_the_website %} 发送请求的身份验证令牌 - -启用 {% data variables.product.prodname_github_connect %} 也可以创建由您的 {% data variables.product.prodname_ghe_cloud %} 组织或企业帐户所拥有的 {% data variables.product.prodname_github_app %}。 {% data variables.product.prodname_ghe_server %} 使用 {% data variables.product.prodname_github_app %} 的凭据向 {% data variables.product.prodname_dotcom_the_website %} 发送请求。 - -{% data variables.product.prodname_ghe_server %} 会存储来自 {% data variables.product.prodname_github_app %} 的凭据。 这些凭据将复制到任何高可用性或集群环境，并存储在任何备份中，包括由 {% data variables.product.prodname_enterprise_backup_utilities %} 创建的快照。 -- 有效期为一小时的身份验证令牌 -- 用于生成新的身份验证令牌的私钥 - -启用 {% data variables.product.prodname_github_connect %} 将不允许 {% data variables.product.prodname_dotcom_the_website %} 用户对 {% data variables.product.prodname_ghe_server %} 进行更改。 - -{% if currentVersion ver_gt "enterprise-server@2.18" %} -For more information about managing enterprise accounts using the GraphQL API, see "[Enterprise accounts](/v4/guides/managing-enterprise-accounts)." -{% endif %} -### 启用 {% data variables.product.prodname_github_connect %} - -1. 登录到 {% data variables.product.product_location_enterprise %} 和 {% data variables.product.prodname_dotcom_the_website %}。 -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %} -5. 在“{% data variables.product.prodname_dotcom_the_website %} is not enabled yet”下，单击 **Enable {% data variables.product.prodname_github_connect %}**。 单击 **Enable {% data variables.product.prodname_github_connect %}**，即表明您同意 {% data variables.product.prodname_enterprise %} 许可协议的 {% data variables.product.prodname_github_connect %} 附录。 ![Enable GitHub Connect 按钮](/assets/images/enterprise/business-accounts/enable-github-connect-button.png) -6. 在要连接的企业帐户或组织旁，单击 **Connect**。 ![企业帐户或企业旁边的连接按钮](/assets/images/enterprise/business-accounts/choose-enterprise-or-org-connect.png) - -### 断开 {% data variables.product.prodname_ghe_cloud %} 组织或企业帐户与 {% data variables.product.product_location_enterprise %} 的连接 - -与 {% data variables.product.prodname_ghe_cloud %} 断开连接后，{% data variables.product.prodname_github_connect %} {% data variables.product.prodname_github_app %} 会从企业帐户或组织中删除，{% data variables.product.product_location_enterprise %} 上存储的凭据也会删除。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %} -5. 在要断开连接的企业帐户或组织旁，单击 **Disable {% data variables.product.prodname_github_connect %}**。 ![企业帐户或组织名称旁的 Disable GitHub Connect 按钮](/assets/images/enterprise/business-accounts/disable-github-connect-button.png) -6. 阅读有关断开连接的信息，并单击 **Disable {% data variables.product.prodname_github_connect %}**。 ![包含关于断开连接的警告信息和确认按钮的模式窗口](/assets/images/enterprise/business-accounts/confirm-disable-github-connect.png) - diff --git a/translations/zh-CN/content/admin/installation/creating-a-high-availability-replica.md b/translations/zh-CN/content/admin/installation/creating-a-high-availability-replica.md deleted file mode 100644 index 452346c89c99..000000000000 --- a/translations/zh-CN/content/admin/installation/creating-a-high-availability-replica.md +++ /dev/null @@ -1,101 +0,0 @@ ---- -title: 创建高可用性副本 -intro: 在主动/被动配置中，副本设备是主设备的冗余副本。 如果主设备发生故障，高可用性模式允许副本作为主设备运行，从而最大限度地减少服务中断。 -redirect_from: - - /enterprise/admin/installation/creating-a-high-availability-replica -versions: - enterprise-server: '*' ---- - -### 创建高可用性副本 - -1. 在所需平台上设置新的 {% data variables.product.prodname_ghe_server %} 设备。 副本设备应镜像主设备的 CPU、RAM 和存储设置。 建议您在独立环境中安装副本设备。 底层硬件、软件和网络组件应与主设备的相应部分隔离。 如果要使用云提供商，请使用单独的区域或分区。 更多信息请参阅“[设置 {% data variables.product.prodname_ghe_server %} 实例](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-github-enterprise-server-instance)”。 -2. 在浏览器中，导航到新副本设备的 IP 地址并上传您的 {% data variables.product.prodname_enterprise %} 许可。 -3. 设置与主设备密码匹配的管理员密码，然后继续。 -4. 单击 **Configure as Replica**。 ![包含用于将新实例配置为副本的链接的安装选项](/assets/images/enterprise/management-console/configure-as-replica.png) -5. 在“Add new SSH key”下，输入 SSH 密钥。 ![添加 SSH 密钥](/assets/images/enterprise/management-console/add-ssh-key.png) -6. 单击 **Add key**，然后单击 **Continue**。 -6. 使用 SSH 连接到副本设备的 IP 地址。 - ```shell - $ ssh -p 122 admin@REPLICA IP - ``` -7. 要为副本生成密钥对，请使用包含主设备 IP 地址的 `ghe-repl-setup` 命令，并复制该命令返回的公钥。 - ```shell - $ ghe-repl-setup PRIMARY IP - ``` -{% data reusables.enterprise_installation.add-ssh-key-to-primary %} -9. 要验证与主设备的连接并为新副本启用副本模式，请再次运行 `ghe-repl-setup`。 - ```shell - $ ghe-repl-setup PRIMARY IP - ``` -{% data reusables.enterprise_installation.replication-command %} -11. 要验证各个数据存储复制通道的状态，请使用 `ghe-repl-status` 命令。 - ```shell - $ ghe-repl-status - ``` - -### 创建 Geo-replication 副本 - -此示例配置使用一个主设备和两个副本，它们位于三个不同的地理区域。 由于三个节点可以位于不同网络中，要求所有节点均可从其他所有节点到达。 必需的管理端口至少应向其他所有节点开放。 有关端口要求的更多信息，请参阅“[网络端口](/enterprise/{{ currentVersion }}/admin/guides/installation/network-ports/#administrative-ports)”。 - -1. 在第一个副本上运行 `ghe-repl-setup`，采用与创建标准双节点配置相同的方式创建第一个副本。 - ```shell - (replica1)$ ghe-repl-setup PRIMARY IP - (replica1)$ ghe-repl-start - ``` -2. 创建第二个副本并使用 `ghe-repl-setup --add` 命令。 `--add` 标志可防止其覆盖现有的复制配置，并将新副本添加到配置中。 - ```shell - (replica2)$ ghe-repl-setup --add PRIMARY IP - (replica2)$ ghe-repl-start - ``` -3. 默认情况下，副本被配置到同一个数据中心{% if currentVersion ver_gt "enterprise-server@2.17" %}，现在将尝试从同一个数据中心中的现有节点播种{% endif %}。 为数据中心选项设置不同的值，通过这种方式为不同的数据中心配置副本。 可以随意设定特定值，只要数值彼此不同即可。 在每个节点上运行 `ghe-repl-node` 命令并指定数据中心。 - - 在主设备上： - ```shell - (primary)$ ghe-repl-node --datacenter [PRIMARY DC NAME] - ``` - 在第一个副本上： - ```shell - (replica1)$ ghe-repl-node --datacenter [FIRST REPLICA DC NAME] - ``` - 在第二个副本上： - ```shell - (replica2)$ ghe-repl-node --datacenter [SECOND REPLICA DC NAME] - ``` - {% tip %} - - **提示：**您可以同时设置 `--datacenter` 和 `--activity` 选项。 - - {% endtip %} -4. 活动副本节点将存储设备数据的副本并为最终用户请求提供服务。 非活动节点将存储设备数据的副本，但无法为最终用户请求提供服务。 使用 `--active` 标志启用活动模式，或使用 `--inactive` 标志启用非活动模式。 - - 在第一个副本上： - ```shell - (replica1)$ ghe-repl-node --active - ``` - 在第二个副本上： - ```shell - (replica2)$ ghe-repl-node --active - ``` -5. 要应用配置，请在主设备上使用 `ghe-config-apply` 命令。 - ```shell - (primary)$ ghe-config-apply - ``` - -### 为 Geo-replication 配置 DNS - -使用主节点和副本节点的 IP 地址配置 Geo DNS。 您还可以为主节点（例如 `primary.github.example.com`）创建 DNS CNAME，以通过 SSH 访问主节点或通过 `backup-utils` 备份主节点。 - -要进行测试，您可以将条目添加到本地工作站的 `hosts` 文件（如 `/etc/hosts`）。 这些示例条目会将 `HOSTNAME` 的请求解析到 `replica2`。 您可以注释不同的行，以特定主机为目标。 - -``` -# HOSTNAME -# HOSTNAME - HOSTNAME -``` - -### 延伸阅读 - -- "[关于高可用性配置](/enterprise/{{ currentVersion }}/admin/guides/installation/about-high-availability-configuration)" -- "[用于复制管理的实用程序](/enterprise/{{ currentVersion }}/admin/guides/installation/about-high-availability-configuration/#utilities-for-replication-management)" -- “[关于 Geo-replication](/enterprise/{{ currentVersion }}/admin/guides/installation/about-geo-replication/)” diff --git a/translations/zh-CN/content/admin/installation/disabling-git-ssh-access-on-github-enterprise-server.md b/translations/zh-CN/content/admin/installation/disabling-git-ssh-access-on-github-enterprise-server.md deleted file mode 100644 index 48203fa351fd..000000000000 --- a/translations/zh-CN/content/admin/installation/disabling-git-ssh-access-on-github-enterprise-server.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: 在 GitHub Enterprise Server 上禁用 Git SSH 访问 -redirect_from: - - /enterprise/admin/hidden/disabling-ssh-access-for-a-user-account/ - - /enterprise/admin/articles/disabling-ssh-access-for-a-user-account/ - - /enterprise/admin/hidden/disabling-ssh-access-for-your-appliance/ - - /enterprise/admin/articles/disabling-ssh-access-for-your-appliance/ - - /enterprise/admin/hidden/disabling-ssh-access-for-an-organization/ - - /enterprise/admin/articles/disabling-ssh-access-for-an-organization/ - - /enterprise/admin/hidden/disabling-ssh-access-to-a-repository/ - - /enterprise/admin/articles/disabling-ssh-access-to-a-repository/ - - /enterprise/admin/guides/installation/disabling-git-ssh-access-on-github-enterprise/ - - /enterprise/admin/installation/disabling-git-ssh-access-on-github-enterprise-server -intro: '您可以阻止用户为 {% data variables.product.product_location_enterprise %} 上的某些仓库或所有仓库使用 Git over SSH。' -versions: - enterprise-server: '*' ---- - -### 禁止对特定仓库进行 Git SSH 访问 - -{% data reusables.enterprise_site_admin_settings.override-policy %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -1. 在“Git SSH access”下，使用下拉菜单，然后单击 **Disabled**。 ![选择了禁用选项的 Git SSH access 下拉菜单](/assets/images/enterprise/site-admin-settings/git-ssh-access-repository-setting.png) - -### 禁止对用户或组织拥有的所有仓库进行 Git SSH 访问 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.search-user-or-org %} -{% data reusables.enterprise_site_admin_settings.click-user-or-org %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -7. 在“Git SSH access”下，使用下拉菜单，然后单击 **Disabled**。 然后选择 **Enforce on all repositories**。 ![选择了禁用选项的 Git SSH access 下拉菜单](/assets/images/enterprise/site-admin-settings/git-ssh-access-organization-setting.png) - -### 禁止对设备上的所有仓库进行 Git SSH 访问 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -7. 在“Git SSH access”下，使用下拉菜单，然后单击 **Disabled**。 然后选择 **Enforce on all repositories**。 ![选择了禁用选项的 Git SSH access 下拉菜单](/assets/images/enterprise/site-admin-settings/git-ssh-access-appliance-setting.png) diff --git a/translations/zh-CN/content/admin/installation/disabling-the-merge-conflict-editor-for-pull-requests-between-repositories.md b/translations/zh-CN/content/admin/installation/disabling-the-merge-conflict-editor-for-pull-requests-between-repositories.md deleted file mode 100644 index 9dfec915f87d..000000000000 --- a/translations/zh-CN/content/admin/installation/disabling-the-merge-conflict-editor-for-pull-requests-between-repositories.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: 为仓库之间的拉取请求禁用合并冲突编辑器 -intro: '您可以在 {% data variables.product.prodname_ghe_server %} 上为基础分支和头分支位于不同仓库的拉取请求禁用合并冲突编辑器，要求用户在本地解决合并冲突。' -redirect_from: - - /enterprise/admin/installation/disabling-the-merge-conflict-editor-for-pull-requests-between-repositories -versions: - enterprise-server: '*' ---- - -要求用户在其计算机上本地解决合并冲突可以避免用户因疏忽而从分叉写入到上游仓库。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -1. 在“Conflict editor for pull requests between repositories”下，使用下拉菜单，然后单击 **Disabled**。 ![包含用于禁用合并冲突编辑器的选项的下拉菜单](/assets/images/enterprise/settings/conflict-editor-settings.png) diff --git a/translations/zh-CN/content/admin/installation/enabling-and-scheduling-maintenance-mode.md b/translations/zh-CN/content/admin/installation/enabling-and-scheduling-maintenance-mode.md deleted file mode 100644 index ab4a356da3bc..000000000000 --- a/translations/zh-CN/content/admin/installation/enabling-and-scheduling-maintenance-mode.md +++ /dev/null @@ -1,61 +0,0 @@ ---- -title: 启用和排定维护模式 -intro: '一些标准维护程序（例如升级 {% data variables.product.product_location_enterprise %} 或还原备份）要求实例进入脱机状态才能正常使用。' -redirect_from: - - /enterprise/admin/maintenance-mode/ - - /enterprise/admin/categories/maintenance-mode/ - - /enterprise/admin/articles/maintenance-mode/ - - /enterprise/admin/articles/enabling-maintenance-mode/ - - /enterprise/admin/articles/disabling-maintenance-mode/ - - /enterprise/admin/guides/installation/maintenance-mode/ - - /enterprise/admin/installation/enabling-and-scheduling-maintenance-mode -versions: - enterprise-server: '*' ---- - -### 关于维护模式 - -某些操作类型要求您让 {% data variables.product.product_location_enterprise %} 进入脱机状态并将其置于维护模式： -- 升级到新版本的 {% data variables.product.prodname_ghe_server %} -- 增加分配给虚拟机的 CPU、内存或存储资源 -- 将数据从一台虚拟机迁移到另一台虚拟机 -- 通过 {% data variables.product.prodname_enterprise_backup_utilities %} 快照还原数据 -- 排查某些类型的关键应用程序问题 - -我们建议您至少将维护窗口排定在 30 分钟后，以便用户提前作好准备。 排定维护窗口后，所有用户在访问站点时都会看到横幅。 - -![关于已排定维护的最终用户横幅](/assets/images/enterprise/maintenance/maintenance-scheduled.png) - -在实例进入维护模式后，所有正常 HTTP 和 Git 访问都会遭到拒绝。 Git 提取、克隆和推送操作也会被拒绝，并显示一条错误消息，指示站点暂时不可用。 在浏览器中访问该站点会显示维护页面。 - -![维护模式启动屏幕](/assets/images/enterprise/maintenance/maintenance-mode-maintenance-page.png) - -### 立即启用维护模式或排定在未来的某个时间进行维护 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -2. 在 {% data variables.enterprise.management_console %} 顶部，单击 **Maintenance**。 ![Maintenance 选项卡](/assets/images/enterprise/management-console/maintenance-tab.png) -3. 在“Enable and schedule”下，决定立即启用维护模式还是排定在未来的某个时间进行维护。 - - 要立即启用维护模式，请使用下拉菜单，然后单击 **now**。 ![包含已选择立即启用维护模式的选项的下拉菜单](/assets/images/enterprise/maintenance/enable-maintenance-mode-now.png) - - 要排定在未来的某个时间进行维护，请使用下拉菜单，然后单击开始时间。 ![包含已选择排定在两小时后进行维护的选项的下拉菜单](/assets/images/enterprise/maintenance/schedule-maintenance-mode-two-hours.png) -4. 选择 **Enable maintenance mode**。 ![启用或排定维护模式的复选框](/assets/images/enterprise/maintenance/enable-maintenance-mode-checkbox.png) -{% data reusables.enterprise_management_console.save-settings %} - -### 通过 {% data variables.product.prodname_enterprise_api %} 排定维护模式 - -您可以通过 {% data variables.product.prodname_enterprise_api %} 排定在其他时间或日期进行维护。 For more information, see "[Management Console](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#enable-or-disable-maintenance-mode)." - -### 为集群中的所有节点启用或禁用维护模式 - -您可以通过 `ghe-cluster-maintenance` 实用程序为集群中的每个节点设置或取消设置维护模式。 - -```shell -$ ghe-cluster-maintenance -h -# Shows options -$ ghe-cluster-maintenance -q -# Queries the current mode -$ ghe-cluster-maintenance -s -# Sets maintenance mode -$ ghe-cluster-maintenance -u -# Unsets maintenance mode -``` diff --git a/translations/zh-CN/content/admin/installation/enabling-automatic-update-checks.md b/translations/zh-CN/content/admin/installation/enabling-automatic-update-checks.md deleted file mode 100644 index 0f0ed14329b6..000000000000 --- a/translations/zh-CN/content/admin/installation/enabling-automatic-update-checks.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: 启用自动更新检查 -intro: '您可以启用自动更新检查，使 {% data variables.product.product_location_enterprise %} 检查和下载最新的 {% data variables.product.prodname_ghe_server %} 版本。' -redirect_from: - - /enterprise/admin/installation/enabling-automatic-update-checks -versions: - enterprise-server: '*' ---- - -在 {% data variables.product.product_location_enterprise %} 的升级包自动下载后，您将收到一条消息，通知您可以升级 {% data variables.product.prodname_ghe_server %}。 升级包会下载到 {% data variables.product.product_location_enterprise %} 上的 `/var/lib/ghe-updates` 目录中。 更多信息请参阅“[升级 {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-github-enterprise-server)”。 - -如果升级存在可用的热补丁，将自动下载 `.hpkg`。 在 Management Console 中，您可以选择立即安装热补丁或排定稍后安装。 更多信息请参阅“[通过热补丁升级](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-github-enterprise-server#upgrading-with-a-hotpatch)”。 - -{% tip %} - -**提示**：要启用自动更新检查，{% data variables.product.product_location_enterprise %} 必须能够连接到 `https://github-enterprise.s3.amazonaws.com`。 - -{% endtip %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.updates-tab %} -4. 单击 **Yes, automatically check for updates**。 ![启用自动更新的按钮](/assets/images/enterprise/management-console/enable_updates_button.png) -{% data reusables.enterprise_management_console.save-settings %} - -要查看您的实例是否处于最新状态，请检查 Updates 选项卡上的横幅。 - -![指示您的 GitHub Enterprise Server 版本的横幅](/assets/images/enterprise/management-console/up-to-date-banner.png) - -在 **Logs** 下，您可以看到最近的更新检查的状态。 - -![更新日志](/assets/images/enterprise/management-console/update-log.png) diff --git a/translations/zh-CN/content/admin/installation/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud.md b/translations/zh-CN/content/admin/installation/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud.md deleted file mode 100644 index aadae973d2e1..000000000000 --- a/translations/zh-CN/content/admin/installation/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: 在 GitHub Enterprise Server 与 GitHub Enterprise Cloud 之间启用自动用户许可同步 -intro: '您可以将 {% data variables.product.product_location_enterprise %} 连接到 {% data variables.product.prodname_ghe_cloud %}，并允许 {% data variables.product.prodname_ghe_server %} 将用户许可信息上传到 {% data variables.product.prodname_dotcom_the_website %} 上的企业帐户。' -permissions: '{% data variables.product.prodname_ghe_server %} 的站点管理员（同时也是已连接 {% data variables.product.prodname_ghe_cloud %} 组织或企业帐户的所有者）可以启用自动用户许可同步。' -redirect_from: - - /enterprise/admin/installation/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud -versions: - enterprise-server: '*' ---- - -### 关于许可同步 - -After you enable license synchronization, you'll be able to view license usage for your entire enterprise account, across {% data variables.product.prodname_ghe_server %} and {% data variables.product.prodname_ghe_cloud %}. {% data variables.product.prodname_github_connect %} syncs license between {% data variables.product.prodname_ghe_server %} and {% data variables.product.prodname_ghe_cloud %} weekly. 更多信息请参阅“[管理您的 {% data variables.product.prodname_enterprise %} 许可](/enterprise/{{currentVersion}}/admin/installation/managing-your-github-enterprise-license)。” - -您还可以手动将 {% data variables.product.prodname_ghe_server %} 用户许可信息上传到 {% data variables.product.prodname_ghe_cloud %}。 更多信息请参阅“[将 {% data variables.product.prodname_ghe_server %} 连接到 {% data variables.product.prodname_ghe_cloud %}](/enterprise/{{ currentVersion }}/admin/guides/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)”。 - -### 启用许可同步 - -在 {% data variables.product.product_location_enterprise %} 上启用许可同步之前，您必须将 {% data variables.product.product_location_enterprise %} 连接到 {% data variables.product.prodname_dotcom_the_website %}。 更多信息请参阅“[将 {% data variables.product.prodname_ghe_server %} 连接到 {% data variables.product.prodname_ghe_cloud %}](/enterprise/{{ currentVersion }}/admin/guides/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)”。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %} -5. 在“Server can sync user license count and usage”下，使用下拉菜单，然后选择 **Enabled**。 ![用于启用自动用户许可同步的下拉菜单](/assets/images/enterprise/site-admin-settings/enable-user-license-drop-down.png) diff --git a/translations/zh-CN/content/admin/installation/enabling-private-mode.md b/translations/zh-CN/content/admin/installation/enabling-private-mode.md deleted file mode 100644 index b056deb61569..000000000000 --- a/translations/zh-CN/content/admin/installation/enabling-private-mode.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: 启用私有模式 -intro: '在私有模式下，{% data variables.product.prodname_ghe_server %} 要求每个用户必须登录才能访问安装。' -redirect_from: - - /enterprise/admin/articles/private-mode/ - - /enterprise/admin/guides/installation/security/ - - /enterprise/admin/guides/installation/securing-your-instance/ - - /enterprise/admin/installation/enabling-private-mode -versions: - enterprise-server: '*' ---- - -如果 {% data variables.product.product_location_enterprise %} 可通过 Internet 公开访问，您必须启用私有模式。 在私有模式下，用户不能通过 `git://` 匿名克隆仓库。 如果还启用了内置身份验证，管理员必须邀请新用户在实例上创建帐户。 更多信息请参阅“[使用内置身份验证](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-built-in-authentication)”。 - -{% data reusables.enterprise_installation.image-urls-viewable-warning %} - -启用私有模式后，您可以允许未验证的 Git 操作（以及对 {% data variables.product.product_location_enterprise %} 具有网络访问权限的任何人）读取已启用匿名 Git 读取权限的实例上的公共仓库代码。 更多信息请参阅“[允许管理员启用对公共仓库的匿名 Git 读取权限](/enterprise/{{ currentVersion }}/admin/guides/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories)”。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -4. 选择 **Private mode**。 ![启用私有模式的复选框](/assets/images/enterprise/management-console/private-mode-checkbox.png) -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/zh-CN/content/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md b/translations/zh-CN/content/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md deleted file mode 100644 index f057a669ba89..000000000000 --- a/translations/zh-CN/content/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: 为 GitHub Enterprise Server 上易受攻击的依赖项启用安全警报 -intro: '您可以将 {% data variables.product.product_location_enterprise %} 连接到 {% data variables.product.prodname_ghe_cloud %}，并为实例仓库中易受攻击的依赖项启用安全警报。' -permissions: '{% data variables.product.prodname_ghe_server %} 的站点管理员（同时也是已连接 {% data variables.product.prodname_ghe_cloud %} 组织或企业帐户的所有者）可以为 {% data variables.product.prodname_ghe_server %} 上的漏洞依赖项启用安全警报。' -redirect_from: - - /enterprise/admin/installation/enabling-security-alerts-for-vulnerable-dependencies-on-github-enterprise-server -versions: - enterprise-server: '*' ---- - -### About alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %} - -{% data reusables.repositories.tracks-vulnerabilities %} For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)." - -您可以将 {% data variables.product.product_location_enterprise %} 连接到 {% data variables.product.prodname_dotcom_the_website %}，然后将漏洞数据同步到实例，并在包含易受攻击的依赖项的仓库中生成安全警报。 - -将 {% data variables.product.product_location_enterprise %} 连接到 {% data variables.product.prodname_dotcom_the_website %} 并为易受攻击的依赖项启用安全警报后，每个小时都会将漏洞数据从 {% data variables.product.prodname_dotcom_the_website %} 同步到您的实例一次。 您还可以随时选择手动同步漏洞数据。 代码和关于代码的信息不会从 {% data variables.product.product_location_enterprise %} 上传到 {% data variables.product.prodname_dotcom_the_website %}。 - -当 {% data variables.product.product_location_enterprise %} 接收到有关漏洞的信息时，它将识别实例中使用受影响版本依赖项的仓库，并向这些仓库中具有管理员访问权限的所有者和人员发送安全警报。 您可以自定义接收安全警报的方式。 For more information, see "[About alerts for vulnerable dependencies](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies/#configuring-notifications-for-security-alerts)." - -### 为 {% data variables.product.prodname_ghe_server %} 上易受攻击的依赖项启用安全警报 - -为 {% data variables.product.product_location_enterprise %} 上易受攻击的依赖项启用安全警报前，必须将 {% data variables.product.product_location_enterprise %} 连接到 {% data variables.product.prodname_dotcom_the_website %}。 更多信息请参阅“[将 {% data variables.product.prodname_ghe_server %} 连接到 {% data variables.product.prodname_ghe_cloud %}](/enterprise/{{ currentVersion }}/admin/guides/installation/connecting-github-enterprise-server-to-github-enterprise-cloud)”。 - -{% if currentVersion ver_gt "enterprise-server@2.20" %} We recommend configuring security alerts without notifications for the first few days to avoid an overload of emails. After a few days, you can enable notifications to receive security alerts as usual.{% endif %} - -{% data reusables.enterprise_site_admin_settings.sign-in %} -2. 在管理 shell 中，为 {% data variables.product.product_location_enterprise %} 上易受攻击的依赖项启用安全警报： - ``` shell -$ ghe-dep-graph-enable -``` -3. 返回到 {% data variables.product.prodname_ghe_server %}。 -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %}{% if currentVersion ver_gt "enterprise-server@2.20" %} -5. Under "Repositories can be scanned for vulnerabilities", use the drop-down menu and select **Enabled without notifications**. Optionally, to enable alerts with notifications, select **Enabled with notifications**.{% else %} -5. 在“Repositories can be scanned for vulnerabilities”下，使用下拉菜单，然后选择 **Enabled**。 -{% endif %} - ![用于启用扫描仓库有无漏洞的下拉菜单](/assets/images/enterprise/site-admin-settings/enable-vulnerability-scanning-in-repositories.png) - -### 查看 {% data variables.product.prodname_ghe_server %} 上易受攻击的依赖项 - -您可以查看 {% data variables.product.product_location_enterprise %} 中的所有漏洞，然后手动同步 {% data variables.product.prodname_dotcom_the_website %} 中的漏洞数据，以更新列表。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -2. 在左侧边栏中，单击 **Vulnerabilities**。 ![站点管理员边栏中的 Vulnerabilities 选项卡](/assets/images/enterprise/business-accounts/vulnerabilities-tab.png) -3. 要同步漏洞数据，请单击 **Sync Vulnerabilities now**。 ![Sync vulnerabilities now 按钮](/assets/images/enterprise/site-admin-settings/sync-vulnerabilities-button.png) diff --git a/translations/zh-CN/content/admin/installation/enabling-subdomain-isolation.md b/translations/zh-CN/content/admin/installation/enabling-subdomain-isolation.md deleted file mode 100644 index a549d0bfcd59..000000000000 --- a/translations/zh-CN/content/admin/installation/enabling-subdomain-isolation.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: 启用子域隔离 -intro: '您可以设置子域隔离，将用户提供的内容与 {% data variables.product.prodname_ghe_server %} 设备的其他部分安全地隔离。' -redirect_from: - - /enterprise/admin/guides/installation/about-subdomain-isolation/ - - /enterprise/admin/installation/enabling-subdomain-isolation -versions: - enterprise-server: '*' ---- - -### 关于子域隔离 - -子域隔离可以减少跨站脚本和其他相关漏洞。 更多信息请参阅 Wikipedia 上的“[跨站脚本](http://en.wikipedia.org/wiki/Cross-site_scripting)”。 我们强烈建议在 {% data variables.product.product_location_enterprise %} 上启用子域隔离。 - -启用子域隔离后，{% data variables.product.prodname_ghe_server %} 会以子域替代多个路径。 - -| 未使用子域隔离的路径 | 使用子域隔离的路径 | -| ------------------------------ | ------------------------------ | -| `http(s)://HOSTNAME/assets/` | `http(s)://assets.HOSTNAME/` | -| `http(s)://HOSTNAME/avatars/` | `http(s)://avatars.HOSTNAME/` | -| `http(s)://HOSTNAME/codeload/` | `http(s)://codeload.HOSTNAME/` | -| `http(s)://HOSTNAME/gist/` | `http(s)://gist.HOSTNAME/` | -| `http(s)://HOSTNAME/media/` | `http(s)://media.HOSTNAME/` | -| `http(s)://HOSTNAME/pages/` | `http(s)://pages.HOSTNAME/` | -| `http(s)://HOSTNAME/raw/` | `http(s)://raw.HOSTNAME/` | -| `http(s)://HOSTNAME/render/` | `http(s)://render.HOSTNAME/` | -| `http(s)://HOSTNAME/reply/` | `http(s)://reply.HOSTNAME/` | -| `http(s)://HOSTNAME/uploads/` | `http(s)://uploads.HOSTNAME/` | - -### 基本要求 - -{% data reusables.enterprise_installation.disable-github-pages-warning %} - -启用子域隔离之前，您必须为新域配置网络设置。 - -- 指定有效域名作为主机名，而不是指定 IP 地址。 更多信息请参阅“[配置主机名](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-a-hostname)。” - -{% data reusables.enterprise_installation.changing-hostname-not-supported %} - -- 为上文列出的子域设置通配符域名系统 (DNS) 记录或单独的 DNS 记录。 建议为指向您的服务器 IP 地址的 `*.HOSTNAME` 创建一条 A 记录，从而无需为各个子域创建多条记录。 -- 为 `*.HOSTNAME` 获取一个使用者可选名称 (SAN) 同时适用于 `HOSTNAME` 和通配符域 `*.HOSTNAME` 的通配符传输层安全 (TLS) 证书。 例如，如果您的主机名为 `github.octoinc.com`，则获取一个通用名值设为 `*.github.octoinc.com`、SAN 值同时设为 `github.octoinc.com` 和 `*.github.octoinc.com` 的证书。 -- 在设备上启用 TLS。 更多信息请参阅“[配置 TLS](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-tls/)”。 - -### 启用子域隔离 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.hostname-menu-item %} -4. 选择 **Subdomain isolation (recommended)**。 ![启用子域隔离的复选框](/assets/images/enterprise/management-console/subdomain-isolation.png) -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/zh-CN/content/admin/installation/enabling-unified-contributions-between-github-enterprise-server-and-githubcom.md b/translations/zh-CN/content/admin/installation/enabling-unified-contributions-between-github-enterprise-server-and-githubcom.md deleted file mode 100644 index 006896fa3595..000000000000 --- a/translations/zh-CN/content/admin/installation/enabling-unified-contributions-between-github-enterprise-server-and-githubcom.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: 在 GitHub Enterprise Server 与 GitHub.com 之间启用统一贡献 -intro: '启用 {% data variables.product.prodname_github_connect %} 后，您可以允许 {% data variables.product.prodname_ghe_cloud %} 成员向其 {% data variables.product.prodname_dotcom_the_website %} 个人资料发送贡献计数，以突出显示他们在 {% data variables.product.prodname_ghe_server %} 上的工作。' -redirect_from: - - /enterprise/admin/guides/developer-workflow/enabling-unified-contributions-between-github-enterprise-and-github-com/ - - /enterprise/admin/guides/developer-workflow/enabling-unified-contributions-between-github-enterprise-server-and-github-com/ - - /enterprise/admin/developer-workflow/enabling-unified-contributions-between-github-enterprise-server-and-githubcom/ - - /enterprise/admin/installation/enabling-unified-contributions-between-github-enterprise-server-and-githubcom -permissions: '{% data variables.product.prodname_ghe_server %} 的站点管理员（同时也是已连接 {% data variables.product.prodname_ghe_cloud %} 组织或企业帐户的所有者）可以在 {% data variables.product.prodname_ghe_server %} 与 {% data variables.product.prodname_dotcom_the_website %} 之间启用统一贡献。' -versions: - enterprise-server: '*' ---- - -作为站点管理员，您可以允许最终用户将进行过匿名处理的工作贡献计数从 {% data variables.product.prodname_ghe_server %} 发送到其 {% data variables.product.prodname_dotcom_the_website %} 贡献图。 - -启用 {% data variables.product.prodname_github_connect %} 并在两个环境中启用 {% data variables.product.prodname_unified_contributions %} 后，实例上的最终用户可以连接到其 {% data variables.product.prodname_dotcom_the_website %} 帐户并将贡献计数从 {% data variables.product.prodname_ghe_server %} 发送至 {% data variables.product.prodname_dotcom_the_website %}。 {% data reusables.github-connect.sync-frequency %} 更多信息请参阅“[将 {% data variables.product.prodname_ghe_server %} 贡献发送至 {% data variables.product.prodname_dotcom_the_website %} 个人资料](/articles/sending-your-github-enterprise-server-contributions-to-your-github-com-profile/)”。 - -如果站点管理员禁用功能或开发者选择退出连接，{% data variables.product.prodname_ghe_server %} 贡献计数将从 {% data variables.product.prodname_dotcom_the_website %} 上删除。 如果开发者在禁用它们后重新连接其个人资料，则会恢复过去 90 天的贡献计数。 - -{% data variables.product.prodname_ghe_server %} **仅会**发送已连接用户的贡献计数和来源 ({% data variables.product.prodname_ghe_server %})， 它不会发送有关贡献或做出该贡献的方式的任何信息。 - -在 {% data variables.product.product_location_enterprise %} 上启用 {% data variables.product.prodname_unified_contributions %} 前，必须将 {% data variables.product.product_location_enterprise %} 连接到 {% data variables.product.prodname_dotcom_the_website %}。 更多信息请参阅“[将 {% data variables.product.prodname_ghe_server %} 连接到 {% data variables.product.prodname_dotcom_the_website %}](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/connecting-github-enterprise-server-to-github-com)”。 - -{% data reusables.github-connect.access-dotcom-and-enterprise %} -{% data reusables.enterprise_site_admin_settings.access-settings %}{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %} -4. 在“Users can share contribution counts to {% data variables.product.prodname_dotcom_the_website %}”下，单击 **Request access**。 ![请求访问统一贡献选项](/assets/images/enterprise/site-admin-settings/dotcom-ghe-connection-request-access.png) -5. [登录](https://enterprise.github.com/login) {% data variables.product.prodname_ghe_server %} 站点以接收其他说明。 - -请求访问时，我们会将您重定向到 {% data variables.product.prodname_ghe_server %} 站点，以查看当前服务条款。 如果 {% data variables.product.product_location_enterprise %} 使用标准服务条款，请求会自动将您重定向到关于启用 {% data variables.product.prodname_unified_contributions %} 的说明。 如果您要使用自定义服务条款，我们会记录您的请求并联系您来设置访问权限。 diff --git a/translations/zh-CN/content/admin/installation/enabling-unified-search-between-github-enterprise-server-and-githubcom.md b/translations/zh-CN/content/admin/installation/enabling-unified-search-between-github-enterprise-server-and-githubcom.md deleted file mode 100644 index 75ef6ebfb048..000000000000 --- a/translations/zh-CN/content/admin/installation/enabling-unified-search-between-github-enterprise-server-and-githubcom.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: 在 GitHub Enterprise Server 与 GitHub.com 之间启用统一搜索 -intro: '启用 {% data variables.product.prodname_github_connect %} 后，您可以允许从 {% data variables.product.product_location_enterprise %} 搜索 {% data variables.product.prodname_dotcom_the_website %}。' -redirect_from: - - /enterprise/admin/guides/developer-workflow/enabling-unified-search-between-github-enterprise-and-github-com/ - - /enterprise/admin/guides/developer-workflow/enabling-unified-search-between-github-enterprise-server-and-github-com/ - - /enterprise/admin/developer-workflow/enabling-unified-search-between-github-enterprise-server-and-githubcom/ - - /enterprise/admin/installation/enabling-unified-search-between-github-enterprise-server-and-githubcom -permissions: '{% data variables.product.prodname_ghe_server %} 的站点管理员（同时也是已连接 {% data variables.product.prodname_ghe_cloud %} 组织或企业帐户的所有者）可以在 {% data variables.product.prodname_ghe_server %} 与 {% data variables.product.prodname_dotcom_the_website %} 之间启用统一搜索。' -versions: - enterprise-server: '*' ---- - -启用统一搜索后，用户可在从 {% data variables.product.product_location_enterprise %} 进行搜索时查看 {% data variables.product.prodname_dotcom_the_website %} 上公共和私有内容的搜索结果。 - -用户将无法从 {% data variables.product.prodname_dotcom_the_website %} 搜索 {% data variables.product.product_location_enterprise %}，即使他们对这两个环境都具有访问权限。 用户只能搜索您已启用 {% data variables.product.prodname_unified_search %} 的私有仓库，并且他们可以在连接的 {% data variables.product.prodname_ghe_cloud %} 组织中访问。 更多信息请参阅“[关于在 {% data variables.product.prodname_dotcom %} 上搜索](/articles/about-searching-on-github/#searching-across-github-enterprise-and-githubcom-simultaneously)”和“[在 {% data variables.product.prodname_ghe_server %} 帐户中启用私有 {% data variables.product.prodname_dotcom_the_website %} 仓库搜索](/articles/enabling-private-github-com-repository-search-in-your-github-enterprise-server-account)”。 - -通过 REST 和 GraphQL API 进行搜索不包含 {% data variables.product.prodname_dotcom_the_website %} 搜索结果。 不支持在 {% data variables.product.prodname_dotcom_the_website %} 中进行高级搜索和搜索 Wiki。 - -{% data reusables.github-connect.access-dotcom-and-enterprise %} -{% data reusables.enterprise_site_admin_settings.access-settings %}{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.github-connect-tab %} -5. 在“Users can search {% data variables.product.prodname_dotcom_the_website %}”下，使用下拉菜单，然后单击 **Enabled**。 ![在搜索 GitHub.com 下拉菜单中启用搜索选项](/assets/images/enterprise/site-admin-settings/github-dotcom-enable-search.png) -6. （可选）在“用户可以在 {% data variables.product.prodname_dotcom_the_website %} 上搜索私有仓库”下，使用下拉菜单并单击 **Enabled（启用）**。 ![在搜索 GitHub.com 下拉菜单中启用私有仓库搜索选项](/assets/images/enterprise/site-admin-settings/enable-private-search.png) - -### 延伸阅读 - -- "[将 {% data variables.product.prodname_ghe_server %} 连接到 {% data variables.product.prodname_dotcom_the_website %}](/enterprise/admin/guides/developer-workflow/connecting-github-enterprise-server-to-github-com)" diff --git a/translations/zh-CN/content/admin/installation/getting-started-with-github-enterprise-server.md b/translations/zh-CN/content/admin/installation/getting-started-with-github-enterprise-server.md deleted file mode 100644 index 6ae0da445cd3..000000000000 --- a/translations/zh-CN/content/admin/installation/getting-started-with-github-enterprise-server.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: 开始使用 GitHub Enterprise Server -shortTitle: 入门指南 -intro: '了解 {% data variables.product.prodname_ghe_server %} 及如何管理您的许可。' -mapTopic: true -redirect_from: - - /enterprise/admin/installation/getting-started-with-github-enterprise-server -versions: - enterprise-server: '*' ---- - diff --git a/translations/zh-CN/content/admin/installation/increasing-cpu-or-memory-resources.md b/translations/zh-CN/content/admin/installation/increasing-cpu-or-memory-resources.md deleted file mode 100644 index 53844cba287d..000000000000 --- a/translations/zh-CN/content/admin/installation/increasing-cpu-or-memory-resources.md +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: 增加 CPU 或内存资源 -intro: '要将 CPU 或内存资源添加到现有的 {% data variables.product.prodname_ghe_server %} 实例，请关闭实例并使用底层虚拟平台工具为虚拟机分配资源。 新分配的资源会在启动时自动识别，无需使用其他配置。' -redirect_from: - - /enterprise/admin/installation/increasing-cpu-or-memory-resources -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_installation.warning-on-upgrading-physical-resources %} - -### 为 AWS 增加 CPU 或内存资源 - -{% note %} - -**注**：要为 AWS 增加 CPU 或内存资源，您必须能够熟练使用 AWS 管理控制台或 `aws ec2` 命令行接口管理 EC2 实例。 有关使用您所选 AWS 工具执行调整的背景和详细信息，请参阅关于[调整 Amazon EBS 支持的实例](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-resize.html)的 AWS 文档。 - -{% endnote %} - -#### 调整的考量因素 - -在为 {% data variables.product.product_location_enterprise %} 增加 CPU 或内存资源之前： -{% if currentVersion != "free-pro-team@latest" %} -- **通过 CPU 扩大内存** - {% data reusables.enterprise_installation.increasing-cpus-max %}{% endif %} -- **验证已为实例分配弹性 IP** - - 如果未分配弹性 IP，则在重启后您必须调整 {% data variables.product.prodname_ghe_server %} 主机的 DNS A 记录，以反映公共 IP 地址的变更。 在实例重新启动后，如果它启动到 VPC 中，会自动保留弹性 IP (EIP)。 如果实例启动到 EC2-Classic 中，则必须手动重新关联弹性 IP。 - -#### 支持的 AWS 实例类型 - -您需要根据 CPU/内存规范确定升级的目标实例类型。 -{% data reusables.enterprise_installation.aws-supported-instance-types %} - -#### 建议的 AWS 实例类型 - -{% data reusables.enterprise_installation.aws-recommended-instance-types %} - -{% data reusables.enterprise_installation.warning-on-scaling %} - -#### 针对 AWS 进行调整 - -{% note %} - -**注**：对于启动到 EC2-Classic 中的实例，请记下与实例关联的弹性 IP 地址以及实例的 ID。 重启实例后，请重新关联弹性 IP 地址。 - -{% endnote %} - -无法将 CPU 或内存资源添加到现有的 AWS/EC2 实例。 相反，您必须执行以下操作： - -1. 停止实例。 -2. 更改实例类型。 -3. 启动实例。 -{% data reusables.enterprise_installation.configuration-recognized %} - -### 为 OpenStack KVM 增加 CPU 或内存资源 - -无法将 CPU 或内存资源添加到现有的 OpenStack KVM 实例。 相反，您必须执行以下操作： - -1. 生成当前实例的快照。 -2. 停止实例。 -3. 选择包含所需 CPU 和/或内存资源的新实例。 - -### 为 VMWare 增加 CPU 或内存资源 - -如果 {% data variables.product.product_location_enterprise %} 上的操作速度较慢，您可能需要增加 CPU 或内存资源。 - -{% data reusables.enterprise_installation.increasing-cpus-max %} - -1. 使用 vSphere Client 连接到 VMware ESXi 主机。 -2. 关闭 {% data variables.product.product_location_enterprise %}。 -3. 选择虚拟机，然后单击 **Edit Settings**。 -4. 在“Hardware”下，根据需要调整分配给虚拟机的 CPU 和/或内存资源。 ![VMware 设置资源](/assets/images/enterprise/vmware/vsphere-hardware-tab.png) -5. 要启动虚拟机，请单击 **OK**。 -{% data reusables.enterprise_installation.configuration-recognized %} diff --git a/translations/zh-CN/content/admin/installation/increasing-storage-capacity.md b/translations/zh-CN/content/admin/installation/increasing-storage-capacity.md deleted file mode 100644 index 4e330891c1a0..000000000000 --- a/translations/zh-CN/content/admin/installation/increasing-storage-capacity.md +++ /dev/null @@ -1,57 +0,0 @@ ---- -title: 增加存储容量 -intro: 您可以增加或更改可供 Git 仓库、数据库、搜索索引和其他持久应用程序数据使用的存储容量。 -redirect_from: - - /enterprise/admin/installation/increasing-storage-capacity -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_installation.warning-on-upgrading-physical-resources %} - -随着更多的用户加入 {% data variables.product.product_location_enterprise %}，您可能需要调整存储卷大小。 有关调整存储容量的信息，请参阅虚拟平台的相关文档。 - -### 要求与建议 - -{% note %} - -**注**：调整用户存储卷之前，请将实例置于维护模式。 更多信息请参阅“[启用和排定维护模式](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)”。 - -{% endnote %} - -{% data reusables.enterprise_installation.hardware-rec-table %} - -### 增加数据分区大小 - -1. 使用虚拟平台工具调整现有用户卷磁盘大小。 -{% data reusables.enterprise_installation.ssh-into-instance %} -3. 将设备置于维护模式。 更多信息请参阅“[启用和排定维护模式](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)”。 -4. 重启设备，以检测新存储分配。 -5. 运行 `ghe-storage-extend` 命令以展开 `/data` 文件系统： - ```shell - $ ghe-storage-extend - ``` - -### 使用新设备增加根分区大小 - -1. 使用版本与当前设备相同的较大根磁盘来设置新的 {% data variables.product.prodname_ghe_server %} 实例。 更多信息请参阅“[设置 {% data variables.product.prodname_ghe_server %} 实例](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-github-enterprise-server-instance)”。 -2. 关闭当前设备。 -3. 使用虚拟平台工具将数据磁盘从当前设备中拆下。 -4. 将数据磁盘安装到根磁盘较大的新设备上。 - -### 使用现有设备增加根分区大小 - -1. 将新磁盘连接到 {% data variables.product.prodname_ghe_server %} 设备。 -2. 运行 `parted` 命令，将磁盘格式化： - ```shell - $ sudo parted /dev/xvdg mklabel msdos - $ sudo parted /dev/xvdg mkpart primary ext4 0% 50% - $ sudo parted /dev/xvdg mkpart primary ext4 50% 100% - ``` -3. 运行 `ghe-upgrade` 命令，将完整的平台特定包安装到新分区的磁盘中。 `github-enterprise-2.11.9.hpkg` 等通用热补丁升级包将无法按预期运行。 - ```shell - $ ghe-upgrade PACKAGE-NAME.pkg -s -t /dev/xvdg1 - ``` -4. 关闭设备。 -5. 在虚拟机监控程序中，移除旧的根磁盘，并将新的根磁盘连接到旧的根磁盘的位置。 -6. 启动设备。 diff --git a/translations/zh-CN/content/admin/installation/initiating-a-failover-to-your-replica-appliance.md b/translations/zh-CN/content/admin/installation/initiating-a-failover-to-your-replica-appliance.md deleted file mode 100644 index a656f96355af..000000000000 --- a/translations/zh-CN/content/admin/installation/initiating-a-failover-to-your-replica-appliance.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: 发起到副本设备的故障转移 -intro: '您可以使用命令行故障转移到 {% data variables.product.prodname_ghe_server %} 副本设备以进行维护和测试，也可以在主设备发生故障时进行故障转移。' -redirect_from: - - /enterprise/admin/installation/initiating-a-failover-to-your-replica-appliance -versions: - enterprise-server: '*' ---- - -故障转移所需的时间取决于手动升级副本和重定向流量所需的时长。 平均时间范围为 2-10 分钟。 - -{% data reusables.enterprise_installation.promoting-a-replica %} - -1. 要允许复制在切换设备之前完成，请将主设备置于维护模式： - - 要使用 Management Console，请参阅“[启用和排定维护模式](/enterprise/admin/guides/installation/enabling-and-scheduling-maintenance-mode/)”。 - - 您也可以使用 `ghe-maintenance -s` 命令。 - ```shell - $ ghe-maintenance -s - ``` -2. 当活动 Git 操作的数量达到零时，请等待 30 秒。 -3. 要验证所有复制通道均报告 `OK`，请使用 `ghe-repl-status -vv` 命令。 - ```shell - $ ghe-repl-status -vv - ``` -4. 要停止复制并将副本设备升级为主设备，请使用 `ghe-repl-promote` 命令。 此操作还会自动将主节点（若可到达）置于维护模式。 - ```shell - $ ghe-repl-promote - ``` -5. 将 DNS 记录更新为指向副本的 IP 地址。 流量会在经过 TTL 周期后定向到副本。 如果您要使用负载均衡器，请务必将其配置为向副本发送流量。 -6. 通知用户他们可以恢复正常操作。 -7. 如有需要，请设置从新的主设备复制到现有设备和之前的主设备。 更多信息请参阅“[关于高可用性配置](/enterprise/{{ currentVersion }}/admin/guides/installation/about-high-availability-configuration/#utilities-for-replication-management)”。 - -### 延伸阅读 - -- "[用于复制管理的实用程序](/enterprise/{{ currentVersion }}/admin/guides/installation/about-high-availability-configuration/#utilities-for-replication-management)" diff --git a/translations/zh-CN/content/admin/installation/log-forwarding.md b/translations/zh-CN/content/admin/installation/log-forwarding.md deleted file mode 100644 index af814ae49d2c..000000000000 --- a/translations/zh-CN/content/admin/installation/log-forwarding.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: 日志转发 -intro: '{% data variables.product.prodname_enterprise %} 使用“syslog-ng”将系统和应用程序日志转发到您在 {% data variables.enterprise.management_console %} 设置中指定的服务器。' -redirect_from: - - /enterprise/admin/articles/log-forwarding/ - - /enterprise/admin/installation/log-forwarding -versions: - enterprise-server: '*' ---- - -支持使用任何支持 syslog-style 日志流的日志收集系统（例如 [Logstash](http://logstash.net/) 和 [Splunk](http://docs.splunk.com/Documentation/Splunk/latest/Data/Monitornetworkports)）。 - -### 启用日志转发 - -1. 在 {% data variables.enterprise.management_console %} 设置页面的左侧边栏中，单击 **Monitoring**。 -1. 选择 **Enable log forwarding**。 -1. 在 **Server address** 字段中，输入要将日志转发到的服务器的地址。 您可以在以逗号分隔的列表中指定多个地址。 -1. 在 Protocol 下拉菜单中，选择用于与日志服务器通信的协议。 该协议将应用到所有指定的日志目标。 -1. 选择 **Enable TLS**。 -1. 单击 **Choose File** 并选择用于加密 syslog 端点间通信的 CA 证书。 将对整个证书链进行验证，且证书链必须以根证书结束。 更多信息请参阅 [syslog-ng 文档中的 TLS 选项](https://support.oneidentity.com/technical-documents/syslog-ng-open-source-edition/3.16/administration-guide/56#TOPIC-956599)。 - -### 疑难解答 - -如果您遇到日志转发方面的问题，请联系 {% data variables.contact.contact_ent_support %} 并在您的电子邮件中附上 `http(s)://[hostname]/setup/diagnostics` 的输出文件。 diff --git a/translations/zh-CN/content/admin/installation/managing-billing-for-github-enterprise.md b/translations/zh-CN/content/admin/installation/managing-billing-for-github-enterprise.md deleted file mode 100644 index 26eac155271b..000000000000 --- a/translations/zh-CN/content/admin/installation/managing-billing-for-github-enterprise.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: 管理 GitHub Enterprise 帐单 -intro: '您可以查看企业帐户和 {% data variables.product.prodname_ghe_server %} 实例的许可使用情况、发票、付款历史记录及其他帐单信息。' -product: '{% data reusables.gated-features.enterprise-accounts %}' -redirect_from: - - /enterprise/admin/installation/managing-billing-for-github-enterprise -versions: - enterprise-server: '*' ---- - -### 关于企业帐户的计费 - -企业帐户目前适用于通过发票付款的 {% data variables.product.prodname_enterprise %} 客户。 对于所有付费 {% data variables.product.prodname_dotcom_the_website %} 服务（包括组织中的付费许可、{% data variables.large_files.product_name_long %} 数据包和 {% data variables.product.prodname_marketplace %} 应用程序订阅），连接至企业帐户的所有组织和 {% data variables.product.prodname_ghe_server %} 实例的帐单都将汇总为一个计费帐单。 - -企业所有者和帐单管理员均可访问和管理企业帐户的所有帐单设置。 有关企业帐户的更多信息，请参阅“[企业帐户的角色](/github/setting-up-and-managing-your-enterprise-account/roles-for-an-enterprise-account)”。 有关管理帐单管理员的更多信息，请参阅“[邀请人员管理企业帐户](/github/setting-up-and-managing-your-enterprise-account/inviting-people-to-manage-your-enterprise-account)”。 - -### 查看当前发票 - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.billing-tab %} -4. 在“Quick Actions（快速操作）”下，单击 **View invoice（查看发票）**。 ![查看发票链接](/assets/images/help/business-accounts/view-invoice-link.png) - -### 支付当前发票 - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.billing-tab %} -4. 在“Quick Actions（快速操作）”下，单击 **Pay invoice（支付发票）**。 ![支付发票链接](/assets/images/help/business-accounts/pay-invoice-link.png) -5. 在“Pay invoice（支付发票）”下，以安全形式输入您的信用卡信息，然后单击 **Pay Invoice（支付发票）**。 ![确认和支付发票](/assets/images/help/business-accounts/pay-invoice.png) - -### 下载当前发票 - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.billing-tab %} -4. 在“Quick Actions（快速操作）”下，单击 **Download current invoice（下载当前发票）**。 ![下载当前发票链接](/assets/images/help/business-accounts/download-current-invoice.png) - -### 查看付款历史记录 - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.billing-tab %} -4. 在“"Billing（帐单）”下，单击 **Past Invoices（过去的发票）**选项卡，查看过去的帐单活动摘要。 ![查看付款历史记录选项卡](/assets/images/help/business-accounts/view-payment-history.png) diff --git a/translations/zh-CN/content/admin/installation/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud.md b/translations/zh-CN/content/admin/installation/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud.md deleted file mode 100644 index 009c7c945146..000000000000 --- a/translations/zh-CN/content/admin/installation/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: 管理 GitHub Enterprise Server 与 GitHub Enterprise Cloud 之间的连接 -intro: '利用 {% data variables.product.prodname_github_connect %}，您可以在 {% data variables.product.product_location_enterprise %} 与 {% data variables.product.prodname_dotcom_the_website %} 上的 {% data variables.product.prodname_ghe_cloud %} 组织或企业帐户之间共享某些功能和数据。' -mapTopic: true -redirect_from: - - /enterprise/admin/developer-workflow/connecting-github-enterprise-to-github-com - - /enterprise/admin/guides/developer-workflow/connecting-github-enterprise-and-github-com/ - - /enterprise/admin/guides/developer-workflow/connecting-github-enterprise-server-and-github-com/ - - /enterprise/admin/developer-workflow/connecting-github-enterprise-server-and-githubcom/ - - /enterprise/admin/installation/managing-connections-between-github-enterprise-server-and-github-enterprise-cloud -versions: - enterprise-server: '*' ---- - diff --git a/translations/zh-CN/content/admin/installation/managing-your-github-enterprise-license.md b/translations/zh-CN/content/admin/installation/managing-your-github-enterprise-license.md deleted file mode 100644 index 3d176d466755..000000000000 --- a/translations/zh-CN/content/admin/installation/managing-your-github-enterprise-license.md +++ /dev/null @@ -1,70 +0,0 @@ ---- -title: 管理 GitHub Enterprise 许可 -intro: '您可以查看、管理和更新 {% data variables.product.prodname_enterprise %} 许可。' -redirect_from: - - /enterprise/admin/categories/licenses/ - - /enterprise/admin/articles/license-files/ - - /enterprise/admin/installation/about-license-files/ - - /enterprise/admin/articles/downloading-your-license/ - - /enterprise/admin/installation/downloading-your-license/ - - /enterprise/admin/articles/upgrading-your-license/ - - /enterprise/admin/installation/updating-your-license/ - - /enterprise/admin/installation/managing-your-github-enterprise-server-license - - /enterprise/admin/installation/managing-your-github-enterprise-license -versions: - enterprise-server: '*' ---- - -### 关于 {% data variables.product.prodname_enterprise %} 许可 - -购买或续订 {% data variables.product.prodname_enterprise %} 时，您会收到用于验证应用程序的许可文件。 许可文件有到期日期，而且可以控制您添加至 {% data variables.product.prodname_enterprise %} 的用户许可数量。 下载并安装 {% data variables.product.prodname_enterprise %} 后，上传许可文件会解锁应用程序供您使用。 - -您可以将 {% data variables.product.prodname_enterprise %} 许可中包含的用户许可分配给 {% data variables.product.product_location_enterprise %} 中的用户和 {% data variables.product.prodname_ghe_cloud %} 企业帐户。 将用户添加到任一环境时，他们都会占用一个许可。 如果用户在两种环境中都有帐户，要想仅使用一个许可，其主 {% data variables.product.prodname_enterprise %} 电子邮件地址必须与经过验证的 {% data variables.product.prodname_ghe_cloud %} 电子邮件地址相同。 您可以在两种环境之间同步许可数和使用情况。 - -如果您的 {% data variables.product.prodname_ghe_server %} 许可到期，您将无法通过 Web 浏览器或 Git 访问 {% data variables.product.product_location_enterprise %}。 需要时，您可以使用命令行实用程序备份所有数据。 更多信息请参阅“[在设备上配置备份](/enterprise/admin/guides/installation/configuring-backups-on-your-appliance)”。 如对续订许可有任何疑问，请联系 {% data variables.contact.contact_enterprise_sales %}。 - -### 将新许可上传到 {% data variables.product.prodname_ghe_server %} - -从 {% data variables.contact.contact_enterprise_sales %} 购买新许可或更新现有许可后，必须下载新许可文件，然后将此文件上传至 {% data variables.product.prodname_ghe_server %}，以解锁新的用户许可。 - -如果您想续订用户许可或将其添加至 {% data variables.product.prodname_enterprise %}，请联系 {% data variables.contact.contact_enterprise_sales %}。 完成订单后，您可以立即下载新的许可文件。 - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.enterprise-licensing-tab %} -4. Under "Enterprise Server Instances", click {% octicon "download" aria-label="The download icon" %} to download your license file. ![下载 GitHub Enterprise Server 许可](/assets/images/help/business-accounts/download-ghes-license.png) -5. Log into your {% data variables.product.prodname_ghe_server %} instance as a site administrator. -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.license-tab %} -12. 在“Quick links”下，单击 **Update license**。 ![更新许可链接](/assets/images/enterprise/business-accounts/update-license-link.png) -13. 要选择许可，请单击 **License file（许可文件）**，或将许可文件拖到 **License file（许可文件）**上。 ![上传许可文件](/assets/images/enterprise/management-console/upload-license.png) -14. 单击 **Upload（上传）**。 ![开始升级](/assets/images/enterprise/management-console/begin-upload.png) - -### 查看许可使用情况 - -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.enterprise-licensing-tab %} -4. 检查您当前的 {% data variables.product.prodname_enterprise %} 许可，以及已使用和可用的用户许可。 - -### 自动将用户许可使用情况同步到 {% data variables.product.prodname_ghe_cloud %} - -您可以使用 {% data variables.product.prodname_github_connect %} 在 {% data variables.product.prodname_ghe_server %} 和 {% data variables.product.prodname_ghe_cloud %} 之间自动同步用户许可数量和使用情况。 更多信息请参阅“[在 {% data variables.product.prodname_ghe_server %} 与 {% data variables.product.prodname_ghe_cloud %} 之间启用自动用户许可同步](/enterprise/{{currentVersion}}/admin/installation/enabling-automatic-user-license-sync-between-github-enterprise-server-and-github-enterprise-cloud)”。 - -### 手动同步 {% data variables.product.prodname_ghe_server %} 与 {% data variables.product.prodname_ghe_cloud %} 之间的用户许可使用情况。 - -您可以从 {% data variables.product.prodname_ghe_server %} 下载 JSON 文件并将文件上传到 {% data variables.product.prodname_ghe_cloud %}，在两个部署之间手动同步用户许可使用情况。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.license-tab %} -5. 在“Quick links”下，要下载包含 {% data variables.product.prodname_ghe_server %} 上当前许可使用情况的文件，请单击 **Export license usage**。 ![Export license usage 链接](/assets/images/enterprise/business-accounts/export-license-usage-link.png) -6. 导航至 {% data variables.product.prodname_ghe_cloud %}。 -{% data reusables.enterprise-accounts.access-enterprise %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.enterprise-licensing-tab %} -10. 在“Enterprise Server Instances（Enterprise Server 实例）”下，单击 **Add server usage（添加服务器使用情况）**。 ![Upload GitHub Enterprise Servers usage 链接](/assets/images/help/business-accounts/upload-ghe-server-usage-link.png) -11. 上传从 {% data variables.product.prodname_ghe_server %} 下载的 JSON 文件。 ![拖放或选择要上传的文件](/assets/images/help/business-accounts/upload-ghe-server-usage-file.png) diff --git a/translations/zh-CN/content/admin/installation/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later.md b/translations/zh-CN/content/admin/installation/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later.md deleted file mode 100644 index 986a7e88e86c..000000000000 --- a/translations/zh-CN/content/admin/installation/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later.md +++ /dev/null @@ -1,128 +0,0 @@ ---- -title: 将 Elasticsearch 索引迁移到 GitHub Enterprise Server 2.14 或更高版本 -intro: '要准备升级到 {% data variables.product.prodname_ghe_server %} 2.14，您需要通过迁移脚本将索引迁移到 Elasticsearch 5.6。' -redirect_from: - - /enterprise/admin/guides/installation/migrating-elasticsearch-indices-to-github-enterprise-2-14-or-later/ - - /enterprise/admin/guides/installation/migrating-elasticsearch-indices-to-github-enterprise-server-2-14-or-later - - /enterprise/admin/installation/migrating-elasticsearch-indices-to-github-enterprise-server-214-or-later -versions: - enterprise-server: '*' ---- - -{% data variables.product.prodname_ghe_server %} 2.14 包含 Elasticsearch 5.6 升级。从 {% data variables.product.prodname_ghe_server %} 2.12 或 2.13 升级到 2.14 或更高版本之前，我们建议您建议下载、安装并运行 Elasticsearch 迁移工具，以便在设备仍具有在线访问权限时在线迁移最大的索引。 - -### 搜索索引 - -迁移脚本会在设备在线时先检查任何 `search` 索引。 迁移 `search` 索引可能需要几分钟到几天，具体时长视其大小而定。 以大索引为例，需要几天的时间才能将这类索引迁移到测试环境。 - -``` -admin@ip-172-31-2-141:~$ curl -s http://localhost:9200/_cat/indices?v | sort -n -k 6 -green open blog-1 1 0 0 0 144b 144b -green open projects-1 1 0 0 0 144b 144b -green open registry-packages-1 1 0 0 0 144b 144b -green open showcases-1 1 0 0 0 144b 144b -health status index pri rep docs.count docs.deleted store.size pri.store.size -green open pull-requests-1 1 0 1 0 9.3kb 9.3kb -green open wikis-1 1 0 2 0 5kb 5kb -green open hookshot-logs-2018-05-29 5 0 25 0 124.2kb 124.2kb -green open repos-1 1 0 1638 1 1.4mb 1.4mb -green open gists-1 1 0 3531 64 291.9kb 291.9kb -green open audit_log-1-2018-06-1 1 0 11108 0 3mb 3mb -green open users-1 1 0 19866 56 2.7mb 2.7mb -green open hookshot-logs-2018-05-31 5 0 20000 0 33.4mb 33.4mb -green open hookshot-logs-2018-06-04 5 0 20000 0 32.6mb 32.6mb -green open issues-1 1 0 26405 6 82.8mb 82.8mb -green open hookshot-logs-2018-05-30 5 0 119744 0 196.8mb 196.8mb -green open audit_log-1-2018-05-1 1 0 191664 0 50mb 50mb -green open code-search-1 1 0 6932626 44 42.9gb 42.9gb -green open commits-1 1 0 63753587 1485 45.4gb 45.4gb -``` - -`search` 索引开头为： - -- blog- -- code-search- -- commits- -- gists- -- issues- -- labels- -- marketplace-listings- -- non-marketplace-listings- -- projects- -- pull-requests- -- registry-packages- -- repos- -- showcases- -- topics- -- users- - -### Web 挂钩索引 - -在迁移脚本在线重建必要的 `search` 索引后，脚本将检查是否需要重建 `webhook` 索引。 如果运行使用 {% data variables.product.prodname_ghe_server %} 2.12 或 2.13 的设备已达到 14 天或更久，那么您很可能不需要重建 `webhook` 索引，因为 `webhook` 索引的默认保留政策为七天。 如果您要从 {% data variables.product.prodname_enterprise %} 2.11 或更早版本更新设备，则可能需要重建 `webhook` 索引。 - -如果需要重建任何 `webhook` 索引，则系统会先提示您启用维护模式，然后脚本才能重建 `webhook` 索引。 尽管迁移 `webhook` 索引需要一定的停机时间，但不需要较长的维护窗口或停机时间。 - -`webhook` 索引以 `hookshot-logs-` 开头。 - -### 可用索引 - -您可以使用 curl 查看设备上的可用索引。 - -``` -admin@ip-172-31-2-141:~$ curl -s http://localhost:9200/_cat/indices?v | sort -n -k 6 -green open blog-1 1 0 0 0 144b 144b -green open projects-1 1 0 0 0 144b 144b -green open registry-packages-1 1 0 0 0 144b 144b -green open showcases-1 1 0 0 0 144b 144b -health status index pri rep docs.count docs.deleted store.size pri.store.size -green open pull-requests-1 1 0 1 0 9.3kb 9.3kb -green open wikis-1 1 0 2 0 5kb 5kb -green open hookshot-logs-2018-05-29 5 0 25 0 124.2kb 124.2kb -green open repos-1 1 0 1638 1 1.4mb 1.4mb -green open gists-1 1 0 3531 64 291.9kb 291.9kb -green open audit_log-1-2018-06-1 1 0 11108 0 3mb 3mb -green open users-1 1 0 19866 56 2.7mb 2.7mb -green open hookshot-logs-2018-05-31 5 0 20000 0 33.4mb 33.4mb -green open hookshot-logs-2018-06-04 5 0 20000 0 32.6mb 32.6mb -green open issues-1 1 0 26405 6 82.8mb 82.8mb -green open hookshot-logs-2018-05-30 5 0 119744 0 196.8mb 196.8mb -green open audit_log-1-2018-05-1 1 0 191664 0 50mb 50mb -green open code-search-1 1 0 6932626 44 42.9gb 42.9gb -green open commits-1 1 0 63753587 1485 45.4gb 45.4gb -``` - -### 准备 {% data variables.product.prodname_ghe_server %} 2.12 或 2.13 设备 - -如果您在不运行迁移工具的情况下升级到 {% data variables.product.prodname_ghe_server %} 2.14 或更高版本，现有的 Elasticsearch 索引可能无效并无法正常使用。 要运行 Elasticsearch 迁移脚本，您的 {% data variables.product.prodname_ghe_server %} 设备必须运行 {% data variables.product.prodname_enterprise %} 2.12 或 2.13。 - -{% warning %} - -**警告：** -- 使用 {% data variables.product.prodname_enterprise_backup_utilities %} 将在恢复后销毁不兼容 5.X 的旧 Elasticsearch 索引。 在这种情况下，可能需要手动重新编制索引。 -- 如果 {% data variables.product.prodname_ghe_server %} 配置为高可用性，迁移脚本**必须**在复制仍在进行时运行。 开始升级之前，必须允许更改才能完全复制到其他设备。 如果迁移脚本运行时复制未运行，ElasticSearch 索引可能失效。 - -{% endwarning %} - -1. 使用 SSH 向启用了高可用性的主设备进行身份验证。 -2. 将迁移脚本下载到设备并进行安装： - ```shell - $ wget https://github-enterprise.s3.amazonaws.com/util/es-5x-transition-tools.tar.gz - $ sudo tar -C / -xvf es-5x-transition-tools.tar.gz - ``` - 如果您管理 {% data variables.product.prodname_ghe_server %} 集群，则使用 SSH 向其中一个 ElasticSearch 服务器节点进行身份验证，并在该节点上安装迁移工具。 节点定位方法如下： - ```shell - $ ghe-cluster-each -r elasticsearch -p - ghe-test-data-0 - ghe-test-data-1 - ghe-test-data-2 - ``` -2. 运行迁移脚本： - ```shell - $ /usr/local/share/enterprise/ghe-es-5x-migration -r - ``` - {% note %} - - **注**：如果您有要迁移的 `webhook` 索引，运行在线迁移后，系统将提示您启用维护模式。 - - {% endnote %} -3. 如果您要运行 {% data variables.product.prodname_ghe_server %} 集群，请遵循单 VM 或高可用性环境的官方升级文档或集群升级指南。 更多信息请参阅“[升级 {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-github-enterprise-server/)”或“[升级集群](/enterprise/{{ currentVersion }}/admin/guides/clustering/upgrading-a-cluster/)”。 diff --git a/translations/zh-CN/content/admin/installation/migrating-from-github-enterprise-1110x-to-2123.md b/translations/zh-CN/content/admin/installation/migrating-from-github-enterprise-1110x-to-2123.md deleted file mode 100644 index dd4869d22b15..000000000000 --- a/translations/zh-CN/content/admin/installation/migrating-from-github-enterprise-1110x-to-2123.md +++ /dev/null @@ -1,90 +0,0 @@ ---- -title: 从 GitHub Enterprise 11.10.x 迁移到 2.1.23 -redirect_from: - - /enterprise/admin-guide/migrating/ - - /enterprise/admin/articles/migrating-github-enterprise/ - - /enterprise/admin/guides/installation/migrating-from-github-enterprise-v11-10-34x/ - - /enterprise/admin/articles/upgrading-to-a-newer-release/ - - /enterprise/admin/guides/installation/migrating-to-a-different-platform-or-from-github-enterprise-11-10-34x/ - - /enterprise/admin/guides/installation/migrating-from-github-enterprise-11-10-x-to-2-1-23 - - /enterprise/admin/installation/migrating-from-github-enterprise-1110x-to-2123 -intro: '要从 {% data variables.product.prodname_enterprise %} 11.10.x 迁移到 2.1.23，您需要设置新的设备实例并迁移之前实例中的数据。' -versions: - enterprise-server: '*' ---- - -支持从 {% data variables.product.prodname_enterprise %} 11.10.348 及更高版本进行迁移。 不支持从 {% data variables.product.prodname_enterprise %} 11.10.348 及更低版本进行迁移。 您必须先通过多次升级过程升级到 11.10.348。 更多信息请参阅 11.10.348 升级程序“[升级到最新版本](/enterprise/11.10.340/admin/articles/upgrading-to-the-latest-release/)”。 - -要升级到最新版 {% data variables.product.prodname_enterprise %}，您必须先迁移到 {% data variables.product.prodname_ghe_server %} 2.1，然后才能执行正常升级过程。 更多信息请参阅“[升级 {% data variables.product.prodname_enterprise %}](/enterprise/admin/guides/installation/upgrading-github-enterprise-server/)”。 - -### 准备迁移 - -1. 查看配置和安装指南，并检查在您的环境中配置 {% data variables.product.prodname_enterprise %} 2.1.23 的所有基本要求是否已得到满足。 更多信息请参阅“[配置和安装](/enterprise/2.1/admin/guides/installation/provisioning-and-installation/)”。 -2. 验证当前实例正在运行受支持的升级版本。 -3. 设置最新版本的 {% data variables.product.prodname_enterprise_backup_utilities %}。 更多信息请参阅“[{% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils)”。 - - 如果已使用 {% data variables.product.prodname_enterprise_backup_utilities %} 配置排定的备份，请确保您已更新为最新版本。 - - 如果您当前未运行排定的备份，请设置 {% data variables.product.prodname_enterprise_backup_utilities %}。 -4. 使用 `ghe-backup` 命令生成当前实例的初始完整备份快照。 如果您已为当前实例配置排定的备份，则不需要生成实例快照。 - - {% tip %} - - **提示**：在快照生成期间，您可以使实例保持在线激活状态。 您将在迁移的维护过程中生成另一个快照。 由于备份的递增，此初始快照会减少在最终快照中传输的数据量，从而可能缩短维护窗口。 - - {% endtip %} - -5. 确定用于将用户网络流量切换到新实例的方法。 迁移完毕后，所有 HTTP 和 Git 网络流量都将定向到新实例。 - - **DNS** - 建议为所有环境使用此方法，因为此方法简单易用，即使在从一个数据中心迁移到另一个数据中心的情况下也能正常使用。 开始迁移之前，请将现有 DNS 记录的 TTL 缩减为 5 分钟或更短时间，并允许更改传播。 迁移完成后，将 DNS 记录更新为指向新实例的 IP 地址。 - - **IP 地址分配** - 此方法仅适用于 VMware 到 VMware 的迁移，除非 DNS 方法不可用，否则不建议使用此方法。 开始迁移之前，您需要关闭旧实例并将其 IP 地址分配给新实例。 -6. 排定维护窗口。 维护窗口的时间应足够长，以便将数据从备份主机传输到新实例，并根据备份快照的大小和可用网络带宽而变化。 在此期间，如果要迁移到新实例，当前实例将不可用，且处于维护模式。 - -### 执行迁移 - -1. 配置新的 {% data variables.product.prodname_enterprise %} 2.1 实例。 更多信息请参阅您的目标平台的“[配置和安装](/enterprise/2.1/admin/guides/installation/provisioning-and-installation/)”指南。 -2. 在浏览器中，导航到新副本设备的 IP 地址并上传您的 {% data variables.product.prodname_enterprise %} 许可。 -3. 设置管理员密码。 -5. 单击 **Migrate**。 ![选择安装类型](/assets/images/enterprise/migration/migration-choose-install-type.png) -6. 将备份主机访问 SSH 密钥粘贴到“Add new SSH key”中。 ![授权备份](/assets/images/enterprise/migration/migration-authorize-backup-host.png) -7. 单击 **Add key**，然后单击 **Continue**。 -8. 复制您将在备份主机上运行的 `ghe-restore` 命令，将数据迁移到新实例。 ![开始迁移](/assets/images/enterprise/migration/migration-restore-start.png) -9. 在旧实例上启用维护模式，并等待所有活动进程完成。 更多信息请参阅“[启用和排定维护模式](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)”。 - - {% note %} - - **注**：从现在开始，此实例将无法正常使用。 - - {% endnote %} - -10. 在备份主机上，运行 `ghe-backup` 命令以生成最终的备份快照。 这样可以确保捕获来自旧实例的所有数据。 -11. 在备份主机上，运行您在新实例的恢复状态屏幕上复制的 `ghe-restore` 命令以恢复最新快照。 - ```shell - $ ghe-restore 169.254.1.1 - The authenticity of host '169.254.1.1:122' can't be established. - RSA key fingerprint is fe:96:9e:ac:d0:22:7c:cf:22:68:f2:c3:c9:81:53:d1. - Are you sure you want to continue connecting (yes/no)? yes - Connect 169.254.1.1:122 OK (v2.0.0) - Starting restore of 169.254.1.1:122 from snapshot 20141014T141425 - Restoring Git repositories ... - Restoring GitHub Pages ... - Restoring asset attachments ... - Restoring hook deliveries ... - Restoring MySQL database ... - Restoring Redis database ... - Restoring SSH authorized keys ... - Restoring Elasticsearch indices ... - Restoring SSH host keys ... - Completed restore of 169.254.1.1:122 from snapshot 20141014T141425 - Visit https://169.254.1.1/setup/settings to review appliance configuration. - ``` - -12. 返回到新实例的恢复状态屏幕，查看恢复是否已完成。 ![恢复整个屏幕](/assets/images/enterprise/migration/restore-complete-screen.png) -13. 单击 **Continue to settings**，检查并调整从之前的实例中导入的配置信息和设置。 ![检查导入的设置](/assets/images/enterprise/migration/migration-status-complete.png) -14. 单击 **Save settings（保存设置）**。 - - {% note %} - - **注**：您可以在应用配置设置并重新启动服务器后使用新实例。 - - {% endnote %} - -15. 使用 DNS 或 IP 地址分配将用户网络流量从旧实例切换到新实例。 -16. 升级到 {{ currentVersion }} 的最新补丁版本。 更多信息请参阅“[升级 {% data variables.product.prodname_ghe_server %}](/enterprise/admin/guides/installation/upgrading-github-enterprise-server/)。” diff --git a/translations/zh-CN/content/admin/installation/migrating-to-a-different-git-large-file-storage-server.md b/translations/zh-CN/content/admin/installation/migrating-to-a-different-git-large-file-storage-server.md deleted file mode 100644 index 71d7d284e610..000000000000 --- a/translations/zh-CN/content/admin/installation/migrating-to-a-different-git-large-file-storage-server.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: 迁移到其他 Git Large File Storage 服务器 -intro: '您可以使用 {% data variables.large_files.product_name_short %} 客户端从现有服务器提取资产并将它们推送到新位置，通过这种方式迁移到新的 {% data variables.large_files.product_name_long %} ({% data variables.large_files.product_name_short %}) 服务器。' -redirect_from: - - /enterprise/admin/guides/installation/migrating-to-different-large-file-storage-server/ - - /enterprise/admin/installation/migrating-to-a-different-git-large-file-storage-server -versions: - enterprise-server: '*' ---- - -迁移到其他 {% data variables.large_files.product_name_long %} 服务器之前，您必须将 {% data variables.large_files.product_name_short %} 配置为使用第三方服务器。 更多信息请参阅“[将 {% data variables.large_files.product_name_long %} 配置为使用第三方服务器](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-git-large-file-storage-to-use-a-third-party-server)”。 - -1. 使用第二个远端配置仓库。 - ```shell - $ git remote add NEW-REMOTE https://NEW-REMOTE-HOSTNAME/path/to/repo -   - $ git lfs env - > git-lfs/1.1.0 (GitHub; darwin amd64; go 1.5.1; git 94d356c) - > git version 2.7.4 (Apple Git-66) -   - > Endpoint=https://GITHUB-ENTERPRISE-HOST/path/to/repo/info/lfs (auth=basic) - > Endpoint (NEW-REMOTE)=https://NEW-REMOTE-HOSTNAME/path/to/repo/info/lfs (auth=none) - ``` - -2. 从旧远端提取所有对象。 - ```shell - $ git lfs fetch origin --all - > Scanning for all objects ever referenced... - > ✔ 16 objects found - > Fetching objects... - > Git LFS: (16 of 16 files) 48.71 MB / 48.85 MB - ``` - -3. 将所有对象推送到新远端。 - ```shell - $ git lfs push NEW-REMOTE --all - > Scanning for all objects ever referenced... - > ✔ 16 objects found - > Pushing objects... - > Git LFS: (16 of 16 files) 48.00 MB / 48.85 MB, 879.10 KB skipped - ``` diff --git a/translations/zh-CN/content/admin/installation/migrating-to-internal-repositories.md b/translations/zh-CN/content/admin/installation/migrating-to-internal-repositories.md deleted file mode 100644 index 959cb4dcf131..000000000000 --- a/translations/zh-CN/content/admin/installation/migrating-to-internal-repositories.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: 迁移到内部仓库 -intro: '您可以迁移到内部仓库，以便为同时使用 {% data variables.product.prodname_ghe_server %} 和 {% data variables.product.prodname_ghe_cloud %} 的开发者统一内源体验。' -permissions: 站点 administrator 可以迁移到内部仓库。 -redirect_from: - - /enterprise/admin/installation/migrating-to-internal-repositories -versions: - enterprise-server: '>=2.20' ---- - -### 关于内部仓库 - -内部仓库适用于 {% data variables.product.prodname_ghe_server %} 2.20+。 {% data reusables.repositories.about-internal-repos %} 更多信息请参阅“[关于仓库可见性](/github/creating-cloning-and-archiving-repositories/about-repository-visibility#about-internal-repositories)。” - -在未来版本的 {% data variables.product.prodname_ghe_server %} 中，我们将调整仓库可见性的工作方式，以便公共、内部和私有术语对 {% data variables.product.prodname_ghe_server %} 和 {% data variables.product.prodname_ghe_cloud %} 上的开发者具有统一的含义。 - -要为这些变更做准备，如果您已启用私有模式，可在实例上运行迁移，将公共仓库转换为内部仓库。 此迁移目前是可选操作，可用于测试非生产实例的变更。 此迁移未来将变成强制操作。 - -运行迁移时，实例上的组织拥有的所有公共仓库都将变成内部仓库。 如果其中任何仓库有分支，分支将变为私有。 私有仓库依然保持私有。 - -实例上的用户帐户拥有的所有公共仓库都将变成私有仓库。 如果其中任何仓库有分支，分支也将变为私有。 每个分支的所有者将得到对分支父项的读取权限。 - -每个变为内部或私有仓库的公共仓库都将禁用匿名 Git 读取权限。 - -如果仓库当前的默认可见性为公共，默认值将变为内部。 如果当前默认值为私有，默认值将保持不变。 您可以随时更改默认值。 更多信息请参阅“[为设备上的新仓库配置默认可见性](/enterprise/admin/installation/configuring-the-default-visibility-of-new-repositories-on-your-appliance)。” - -实例的仓库创建策略将更改为禁用公共仓库，允许私有和内部仓库。 您可以随时更新此策略。 更多信息请参阅“[限制在实例中创建仓库](/enterprise/admin/user-management/restricting-repository-creation-in-your-instance)。” - -如果您未启用私有模式，迁移脚本将无效。 - -### 运行迁移 - -1. 连接到管理 shell。 更多信息请参阅“[访问管理 shell (SSH)](/enterprise/admin/installation/accessing-the-administrative-shell-ssh)。” -2. 导航至 `/data/github/current` 目录。 - ``` - cd /data/github/current - ``` -3. 运行迁移命令。 - ``` - sudo bin/safe-ruby lib/github/transitions/20191210220630_convert_public_ghes_repos_to_internal.rb -v -w | tee -a /tmp/convert_public_ghes_repos_to_internal.log - ``` - -日志输出将显示在终端和 `/tmp/convert_public_ghes_repos_to_internal.log` 中。 - -### 延伸阅读 - -- "[启用私人模式](/enterprise/admin/installation/enabling-private-mode)" diff --git a/translations/zh-CN/content/admin/installation/monitoring-activity-on-your-github-enterprise-server-instance.md b/translations/zh-CN/content/admin/installation/monitoring-activity-on-your-github-enterprise-server-instance.md deleted file mode 100644 index 2be7b3bd4a90..000000000000 --- a/translations/zh-CN/content/admin/installation/monitoring-activity-on-your-github-enterprise-server-instance.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: 监视 GitHub Enterprise Server 实例上的活动 -mapTopic: true -redirect_from: - - /enterprise/admin/installation/monitoring-activity-on-your-github-enterprise-server-instance -versions: - enterprise-server: '*' ---- - diff --git a/translations/zh-CN/content/admin/installation/monitoring-using-snmp.md b/translations/zh-CN/content/admin/installation/monitoring-using-snmp.md deleted file mode 100644 index 56370a4b0149..000000000000 --- a/translations/zh-CN/content/admin/installation/monitoring-using-snmp.md +++ /dev/null @@ -1,107 +0,0 @@ ---- -title: 使用 SNMP 进行监视 -intro: '{% data variables.product.prodname_enterprise %} 通过 SNMP 提供关于磁盘使用情况、CPU 利用率和内存使用情况等方面的数据。' -redirect_from: - - /enterprise/admin/articles/monitoring-using-snmp/ - - /enterprise/admin/installation/monitoring-using-snmp -versions: - enterprise-server: '*' ---- - -SNMP 是一种用于通过网络监视设备的公共标准。 强烈建议启用 SNMP，以便监视 {% data variables.product.product_location_enterprise %} 的健康状态并了解何时向主机增加更多内存、存储空间或处理器能力。 - -{% data variables.product.prodname_enterprise %} 采用标准 SNMP 安装，因此您可以充分利用 Nagios 或其他任何监视系统可用的[多种插件](http://www.monitoring-plugins.org/doc/man/check_snmp.html)。 - -### 配置 SNMP v2c - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.access-monitoring %} -{% data reusables.enterprise_management_console.enable-snmp %} -4. 在 **Community string** 字段中，输入新的社区字符串。 如果留空，此字段将默认为 `public`。 ![添加社区字符串的字段](/assets/images/enterprise/management-console/community-string.png) -{% data reusables.enterprise_management_console.save-settings %} -5. 要测试 SNMP 配置，请在网络中支持 SNMP 的单独工作站上运行以下命令： - ```shell - # community-string is your community string - # hostname is the IP or domain of your Enterprise instance - $ snmpget -v 2c -c community-string -O e hostname hrSystemDate.0 - ``` - -这应该返回 {% data variables.product.product_location_enterprise %} 主机上的系统时间。 - -### 基于用户的安全性 - -如果您启用 SNMP v3，则可以通过用户安全模型 (USM) 充分利用提升的基于用户的安全性。 对于每个唯一的用户，您可以指定一个安全等级： -- `noAuthNoPriv`: 此安全等级不提供任何身份验证和隐私保护。 -- `authNoPriv`: 此安全等级提供身份验证，但不提供隐私保护。 要查询设备，您需要用户名和密码（长度必须至少为八个字符）。 与 SNMPv2 相似，发送的信息不会进行加密。 身份验证协议可以是 MD5 或 SHA，默认为 SHA。 -- `authPriv`: 这个安全等级提供身份验证和隐私保护。 要求进行身份验证（包含一个长度至少为八个字符的身份验证密码），并且会对响应进行加密。 不需要隐私密码，但如果提供隐私密码，其长度必须至少为八个字符。 如果不提供隐私密码，将使用身份验证密码。 隐私协议可以是 DES 或 AES，默认为 AES。 - -### 配置 SNMP v3 的用户 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.access-monitoring %} -{% data reusables.enterprise_management_console.enable-snmp %} -4. 选择 **SNMP v3**。 ![启用 SNMP v3 的按钮](/assets/images/enterprise/management-console/enable-snmpv3.png) -5. 在“Username（用户名）”中，输入 SNMP v3 用户的唯一用户名。 ![SNMP v3 用户名输入字段](/assets/images/enterprise/management-console/snmpv3-username.png) -6. 在 **Security Level（安全等级）**下拉菜单中，单击 SNMP v3 用户的安全等级。 ![SNMP v3 用户安全等级下拉菜单](/assets/images/enterprise/management-console/snmpv3-securitylevel.png) -7. 对于拥有 `authnopriv` 安全等级的 SNMP v3 用户： ![Authnopriv 安全等级设置](/assets/images/enterprise/management-console/snmpv3-authnopriv.png) - - {% data reusables.enterprise_management_console.authentication-password %} - - {% data reusables.enterprise_management_console.authentication-protocol %} -8. 对于拥有 `authpriv` 安全等级的 SNMP v3 用户： ![Authpriv 安全等级设置](/assets/images/enterprise/management-console/snmpv3-authpriv.png) - - {% data reusables.enterprise_management_console.authentication-password %} - - {% data reusables.enterprise_management_console.authentication-protocol %} - - （可选）在“Privacy password（隐私密码）”中输入隐私保护密码。 - - 在“Privacy password（隐私密码）”右侧，在 **Protocol（协议）** 下拉菜单中，单击您要使用的隐私协议方法。 -9. 单击 **Add user（添加用户）**。 ![用于添加 SNMP v3 用户的按钮](/assets/images/enterprise/management-console/snmpv3-adduser.png) -{% data reusables.enterprise_management_console.save-settings %} - -##### 查询 SNMP 数据 - -关于您的设备的硬件和软件级信息都适用于 SNMP v3。 由于 `noAuthNoPriv` 和 `authNoPriv` 安全等级缺乏加密和隐私，因此我们的结果 SNMP 报告中不包括 `hrSWRun` 表 (1.1.3.6.1.2.1.25.41)。 如果您使用的是 `authPriv` 安全等级，我们将包括此表。 - -如果使用 SNMP v2c，则仅会提供关于您的设备的硬件级信息。 {% data variables.product.prodname_enterprise %} 中的应用程序和服务未配置 OID 来报告指标。 有多个 MIB 可用，在网络中 SNMP 的支持下，在单独的工作站上运行 `smpwaste` 可以看到： - -```shell -# community-string is your community string -# hostname is the IP or domain of your Enterprise instance -$ snmpwalk -v 2c -c community-string -O e hostname -``` - -在 SNMP 的可用 MIB 中，最有用的是 `HOST-RESOURCES-MIB` (.1.3.6.1.2.1.25)。 请参见下表，了解此 MIB 中的一些重要对象： - -| 名称 | OID | 描述 | -| -------------------------- | ------------------------- | -------------------------------------------- | -| hrSystemDate.2 | .1.3.6.1.2.1.25.1.2 | 本地日期和时间的主机标记。 | -| hrSystemUptime.0 | .1.3.6.1.2.1.25.1.1.0 | 自主机上次初始化以来的时间。 | -| hrMemorySize.0 | .1.3.6.1.2.1.25.2.2.0 | 主机上 RAM 的大小。 | -| hrSystemProcesses.0 | .1.3.6.1.2.1.25.1.6.0 | 主机上当前加载或运行的进程上下文数。 | -| hrStorageUsed.1 | .1.3.6.1.2.1.25.2.3.1.6.1 | 主机上已占用的存储空间大小（单位为 hrStorageAllocationUnits）。 | -| hrStorageAllocationUnits.1 | .1.3.6.1.2.1.25.2.3.1.4.1 | hrStorageAllocationUnit 的大小（单位为字节） | - -例如，要通过 SNMP v3 查询 `hrMemorySize`，请在您的网络中支持 SNMP 的单独工作站上运行以下命令： -```shell -# username is the unique username of your SNMP v3 user -# auth password is the authentication password -# privacy password is the privacy password -# hostname is the IP or domain of your Enterprise instance -$ snmpget -v 3 -u username -l authPriv \ - -A "auth password" -a SHA \ - -X "privacy password" -x AES \ - -O e hostname HOST-RESOURCES-MIB::hrMemorySize.0 -``` - -如果使用 SNMP v2c，要查询 `hrMemorySize`，请在您的网络中支持 SNMP 的单独工作站上运行以下命令： -```shell -# community-string is your community string -# hostname is the IP or domain of your Enterprise instance -snmpget -v 2c -c community-string hostname HOST-RESOURCES-MIB::hrMemorySize.0 -``` - -{% tip %} - -**注**：为避免泄漏关于设备上所运行服务的信息，我们会将 `hrSWRun` 表 (1.1.3.6.1.2.1.25.41) 从生成的 SNMP 报告中排除，除非您对 SNMP v3 使用的是 `authPriv` 安全级别。 如果您使用的安全级别为 `authPriv`，我们将包含 `hrSWRun` 表。 - -{% endtip %} - -更多关于 SNMP 中常用系统属性的 OID 映射的信息，请参阅“[CPU、内存和磁盘统计信息的 Linux SNMP OID](http://www.linux-admins.net/2012/02/linux-snmp-oids-for-cpumemory-and-disk.html)”。 diff --git a/translations/zh-CN/content/admin/installation/monitoring-your-github-enterprise-server-appliance.md b/translations/zh-CN/content/admin/installation/monitoring-your-github-enterprise-server-appliance.md deleted file mode 100644 index a4272752f4ca..000000000000 --- a/translations/zh-CN/content/admin/installation/monitoring-your-github-enterprise-server-appliance.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: 监视 GitHub Enterprise Server 设备 -intro: '随着 {% data variables.product.product_location_enterprise %} 使用量的逐渐增加，系统资源（例如 CPU、内存和存储空间）的利用率也会提高。 您可以配置监视和警报来提示潜在问题，以免这些问题对应用程序性能或可用性造成严重的负面影响。' -redirect_from: - - /enterprise/admin/guides/installation/system-resource-monitoring-and-alerting/ - - /enterprise/admin/guides/installation/monitoring-your-github-enterprise-appliance/ - - /enterprise/admin/installation/monitoring-your-github-enterprise-server-appliance -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/zh-CN/content/admin/installation/network-ports.md b/translations/zh-CN/content/admin/installation/network-ports.md deleted file mode 100644 index ee9b10a7a3a2..000000000000 --- a/translations/zh-CN/content/admin/installation/network-ports.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: 网络端口 -redirect_from: - - /enterprise/admin/articles/configuring-firewalls/ - - /enterprise/admin/articles/firewall/ - - /enterprise/admin/guides/installation/network-configuration/ - - /enterprise/admin/guides/installation/network-ports-to-open/ - - /enterprise/admin/installation/network-ports -intro: 根据您需要为管理员、最终用户和电子邮件支持显示的网络服务有选择地打开网络端口。 -versions: - enterprise-server: '*' ---- - -### 管理端口 - -需要使用一些管理端口来配置 {% data variables.product.product_location_enterprise %} 和运行某些功能。 最终用户在使用基本应用程序时不需要管理端口。 - -| 端口 | 服务 | 描述 | -| -------- | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------- | -| 8443 | HTTPS | 基于安全 Web 的 {% data variables.enterprise.management_console %}。 进行基本安装和配置时需要。 | -| 8080 | HTTP | 基于纯文本 Web 的 {% data variables.enterprise.management_console %}。 除非手动禁用 SSL，否则不需要。 | -| 122 | SSH | 对 {% data variables.product.product_location_enterprise %} 进行 Shell 访问。 对来自高可用性配置中的其他所有节点的传入连接开放时需要。 默认 SSH 端口 (22) 专用于 Git 和 SSH 应用程序网络流量。 | -| 1194/UDP | VPN | 采用高可用性配置的安全复制网络隧道。 对配置中的其他所有节点开放时需要。 | -| 123/UDP | NTP | 为时间协议操作所需。 | -| 161/UDP | SNMP | 为网络监视协议操作所需。 | - -### 最终用户的应用程序端口 - -应用程序端口为最终用户提供 Web 应用程序和 Git 访问。 - -| 端口 | 服务 | 描述 | -| ---- | ----- | ------------------------------------------- | -| 443 | HTTPS | 通过 HTTPS 访问 Web 应用程序和 Git。 | -| 80 | HTTP | 访问 Web 应用程序。 当 SSL 启用时，所有请求都会重定向到 HTTPS 端口。 | -| 22 | SSH | 通过 SSH 访问 Git。 支持对公共和私有仓库执行克隆、提取和推送操作。 | -| 9418 | Git | Git 协议端口支持通过未加密网络通信对公共仓库执行克隆和提取操作。 | - -{% data reusables.enterprise_installation.terminating-tls %} - -### 电子邮件端口 - -电子邮件端口必须可直接访问或通过中继访问，以便为最终用户提供入站电子邮件支持。 - -| 端口 | 服务 | 描述 | -| -- | ---- | ------------------------ | -| 25 | SMTP | 支持采用加密的 SMTP (STARTTLS)。 | diff --git a/translations/zh-CN/content/admin/installation/recommended-alert-thresholds.md b/translations/zh-CN/content/admin/installation/recommended-alert-thresholds.md deleted file mode 100644 index 6d977e28a9db..000000000000 --- a/translations/zh-CN/content/admin/installation/recommended-alert-thresholds.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: 建议的警报阈值 -intro: '您可以配置警报来提前通知系统资源问题，以免它们影响您的 {% data variables.product.prodname_ghe_server %} 设备的性能。' -redirect_from: - - /enterprise/admin/guides/installation/about-recommended-alert-thresholds/ - - /enterprise/admin/installation/recommended-alert-thresholds -versions: - enterprise-server: '*' ---- - -### 监视存储 - -建议您同时对根存储设备和用户存储设备进行监视，并为警报配置合适的值，在可用磁盘空间不足时提供足够长的响应时间。 - -| 严重程度 | 阈值 | -| ------ | ---------------- | -| **警告** | 已用磁盘空间超出总大小的 70% | -| **关键** | 已用磁盘空间超出总大小的 85% | - -您可以根据分配的总存储空间、历史增长模式和预期响应时间调整这些值。 我们建议多分配一些存储资源，以便考虑增长情况并避免因分配额外存储空间而需要停机。 - -### 监视 CPU 和平均负载使用情况 - -虽然 CPU 利用率随资源密集型 Git 操作上下波动属于正常情况，但我们建议配置警报来监视异常增高的 CPU 利用率，因为 CPU 利用率长时间处于高水平可能说明实例配置不足。 建议监视 15 分钟系统平均负载，以获取接近或超过分配给虚拟机的 CPU 核心数的值。 - -| 严重程度 | 阈值 | -| ------ | ---------------------- | -| **警告** | 十五分钟平均负载超出 1 倍的 CPU 核心 | -| **关键** | 十五分钟平均负载超出 2 倍的 CPU 核心 | - -我们还建议监视虚拟化“盗取”时间，以确保在同一主机系统上运行的虚拟机不会用掉所有实例资源。 - -### 监视内存使用情况 - -分配给 {% data variables.product.product_location_enterprise %} 的物理内存大小对整体性能和应用程序响应能力有着极大的影响。 系统设计为通过大量使用内核磁盘缓存来加快 Git 操作速度。 建议将正常 RSS 工作使用量设置在最高使用量时总可用 RAM 的 50% 之内。 - -| 严重程度 | 阈值 | -| ------ | ------------------------ | -| **警告** | 持续 RSS 使用量超出总可用内存大小的 50% | -| **关键** | 持续 RSS 使用量超出总可用内存大小的 70% | - -如果内存已耗尽，内核 OOM 终止程序将尝试终止占用 RAM 较多的应用程序进程以释放内存资源，这样可能导致服务中断。 建议为虚拟机分配的内存大小应大于正常操作过程所需的内存。 diff --git a/translations/zh-CN/content/admin/installation/recovering-a-high-availability-configuration.md b/translations/zh-CN/content/admin/installation/recovering-a-high-availability-configuration.md deleted file mode 100644 index a0a32157a667..000000000000 --- a/translations/zh-CN/content/admin/installation/recovering-a-high-availability-configuration.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: 恢复高可用性配置 -intro: '在故障转移到 {% data variables.product.prodname_ghe_server %} 设备后，您应尽快恢复冗余，而不应依赖于一台设备。' -redirect_from: - - /enterprise/admin/installation/recovering-a-high-availability-configuration -versions: - enterprise-server: '*' ---- - -如果故障转移是在计划内进行的，或者与设备的健康状态无关，则可以将之前的主设备用作新的副本设备。 如果故障转移与主设备的问题相关，则最好创建新的副本设备。 更多信息请参阅“[创建高可用性副本](/enterprise/{{ currentVersion }}/admin/guides/installation/creating-a-high-availability-replica/)”。 - -### 将之前的主设备配置为新副本 - -1. 使用 SSH 连接到之前的主设备的 IP 地址。 - ```shell - $ ssh -p 122 admin@FORMER PRIMARY IP - ``` -2. 在之前的主设备上，使用之前副本的 IP 地址运行 `ghe-repl-setup`。 - ```shell - $ ghe-repl-setup FORMER REPLICA IP - ``` -{% data reusables.enterprise_installation.add-ssh-key-to-primary %} -4. 要验证与新的主设备的连接并为新副本启用副本模式，请再次运行 `ghe-repl-setup`。 - ```shell - $ ghe-repl-setup FORMER REPLICA IP - ``` -{% data reusables.enterprise_installation.replication-command %} diff --git a/translations/zh-CN/content/admin/installation/removing-a-high-availability-replica.md b/translations/zh-CN/content/admin/installation/removing-a-high-availability-replica.md deleted file mode 100644 index 3a2481af9fe3..000000000000 --- a/translations/zh-CN/content/admin/installation/removing-a-high-availability-replica.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: 移除高可用性副本 -intro: '您可以暂时停止对 {% data variables.product.prodname_ghe_server %} 副本的复制，也可以永久地移除复制。' -redirect_from: - - /enterprise/admin/installation/removing-a-high-availability-replica -versions: - enterprise-server: '*' ---- - -### 暂时停止复制 - -1. 如有必要，移除副本的 Geo DNS 条目，使 Geo-replication 副本停止提供用户流量。 -2. 在您希望暂时停止复制的副本上，运行 ghe-repl-stop。 - ```shell - $ ghe-repl-stop - ``` -3. 要再次开始复制，请运行 `ghe-repl-start`。 - ```shell - $ ghe-repl-start - ``` - -### 永久移除复制 - -1. 如有必要，移除副本的 Geo DNS 条目，使 Geo-replication 副本停止提供用户流量。 -2. 在您希望移除复制的副本上，运行 `ghe-repl-stop`。 - ```shell - $ ghe-repl-stop - ``` -3. 在副本上，要移除复制状态，请运行 `ghe-repl-teardown`。 - ```shell - $ ghe-repl-teardown - ``` diff --git a/translations/zh-CN/content/admin/installation/searching-the-audit-log.md b/translations/zh-CN/content/admin/installation/searching-the-audit-log.md deleted file mode 100644 index e57145dca7e4..000000000000 --- a/translations/zh-CN/content/admin/installation/searching-the-audit-log.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: 搜索审核日志 -intro: '站点管理员可以在 {% data variables.product.product_location_enterprise %} 上搜索[审核的操作](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions) 的完整列表。' -redirect_from: - - /enterprise/admin/articles/searching-the-audit-log/ - - /enterprise/admin/installation/searching-the-audit-log -versions: - enterprise-server: '*' ---- - -### 搜索查询语法 - -由一个或多个键值对（以 AND/OR 逻辑运算符分隔）构成一个搜索查询。 - -| 键 | 值 | -| --------------:| ------------------------------------------------------------------------------------ | -| `actor_id` | 发起操作的用户帐户的 ID | -| `actor` | 发起操作的用户帐户的名称 | -| `oauth_app_id` | 与操作相关联的 OAuth 应用程序的 ID | -| `action` | [审核的操作](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions)的名称 | -| `user_id` | 受操作影响的用户的 ID | -| `用户` | 受操作影响的用户的名称 | -| `repo_id` | 受操作影响的仓库的 ID（若适用） | -| `repo` | 受操作影响的仓库的名称（若适用） | -| `actor_ip` | 发起操作的 IP 地址 | -| `created_at` | 操作发生的时间 | -| `from` | 发起操作的视图 | -| `note` | 事件特定的其他信息（采用纯文本或 JSON 格式） | -| `org` | 受操作影响的组织的名称（若适用） | -| `org_id` | 受操作影响的组织的 ID（若适用） | - -例如，要查看自 2017 年初开始影响仓库 `octocat/Spoon-Knife` 的所有操作： - - `repo:"octocat/Spoon-Knife" AND created_at:[2017-01-01 TO *]` - -有关操作的完整列表，请参阅“[审核的操作](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions)”。 - -### 搜索审核日志 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.audit-log-tab %} -4. 输入搜索查询。 ![搜索查询](/assets/images/enterprise/site-admin-settings/search-query.png) diff --git a/translations/zh-CN/content/admin/installation/setting-git-push-limits.md b/translations/zh-CN/content/admin/installation/setting-git-push-limits.md deleted file mode 100644 index 38265e6776b9..000000000000 --- a/translations/zh-CN/content/admin/installation/setting-git-push-limits.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: 设置 Git 推送限制 -intro: 您可以对仓库中的 Git 对象强制执行最大大小限制。 -redirect_from: - - /enterprise/admin/guides/installation/git-server-settings/ - - /enterprise/admin/articles/setting-git-push-limits/ - - /enterprise/admin/installation/setting-git-push-limits -versions: - enterprise-server: '*' ---- - -要使仓库大小保持可管理并防止发生性能问题，可以为实例上的仓库配置文件大小限制。 - -默认情况下，强制执行仓库上传限制时，无法添加或上传超过 100 MB 的文件。 - -{% if currentVersion ver_lt "enterprise-server@2.20" %} -{% tip %} - -**注**：仅会根据 Git 推送限制检查大于 {% data variables.large_files.warning_size %} 的文件。 如果需要设置较低的推送限制，请联系 {% data variables.contact.contact_ent_support %} 获得帮助。 - -{% endtip %} -{% endif %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -4. 在“Repository upload limit”下，使用下拉菜单，然后单击最大对象大小。 ![包含最大对象大小选项的下拉菜单](/assets/images/enterprise/site-admin-settings/repo-upload-limit-dropdown.png) -5. 或者，要对 {% data variables.product.product_location_enterprise %} 上的所有仓库执行最大上传限制，请选择 select **Enforce on all repositories（对所有仓库强制执行）** ![对所有仓库选项强制执行最大对象限制](/assets/images/enterprise/site-admin-settings/all-repo-upload-limit-option.png) diff --git a/translations/zh-CN/content/admin/installation/setting-up-external-monitoring.md b/translations/zh-CN/content/admin/installation/setting-up-external-monitoring.md deleted file mode 100644 index 2ad7c09972ae..000000000000 --- a/translations/zh-CN/content/admin/installation/setting-up-external-monitoring.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: 设置外部监视 -intro: '您可以使用 SNMP 或 collectd 统计信息收集协议监视 {% data variables.product.prodname_ghe_server %} 设备上的基本系统资源。' -redirect_from: - - /enterprise/admin/installation/setting-up-external-monitoring -versions: - enterprise-server: '*' ---- - -### 关于 SNMP - -简单网络管理协议 (SNMP) 是一种受到广泛支持的网络设备和服务器监视方法。 SNMP 默认禁用，但可以通过 {% data variables.product.prodname_enterprise %} 监视仪表板进行配置。 UDP 端口 161 必须打开，并且可以通过您的网络管理站到达。 更多信息请参阅“[使用 SNMP 进行监视](/enterprise/{{ currentVersion }}/admin/guides/installation/monitoring-using-snmp/)”。 - -### 关于 collectd - -collectd 属于开源统计信息收集和报告守护程序，内置对写入 RRD 文件的支持。 可以将关于 CPU 利用率、内存与磁盘占用量、网络接口流量与错误以及系统负荷的统计信息转发到外部 collectd 服务器，可在该服务器中使用各种可用工具和插件配置图表、分析和警报。 要配置 `collectd` 转发，请参阅“[配置 collectd](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-collectd/)”。 - -此外，也可以使用内置到底层虚拟化平台的监视工具对系统资源进行基本监视和警报。 更多信息请参阅 [Amazon CloudWatch](http://aws.amazon.com/cloudwatch/) 和 [VMware vSphere 监视](http://pubs.vmware.com/vsphere-50/topic/com.vmware.ICbase/PDF/vsphere-esxi-vcenter-server-50-monitoring-performance-guide.pdf)文档。 diff --git a/translations/zh-CN/content/admin/installation/site-admin-dashboard.md b/translations/zh-CN/content/admin/installation/site-admin-dashboard.md deleted file mode 100644 index 908cb4d76bd6..000000000000 --- a/translations/zh-CN/content/admin/installation/site-admin-dashboard.md +++ /dev/null @@ -1,178 +0,0 @@ ---- -title: 站点管理员仪表板 -intro: '站点管理员仪表板提供了多种工具，这些工具可以帮助您管理 {% data variables.product.product_location_enterprise %}。' -redirect_from: - - /enterprise/admin/articles/site-admin-dashboard/ - - /enterprise/admin/installation/site-admin-dashboard -versions: - enterprise-server: '*' ---- - -要访问仪表板，请在任意页面的右上角中单击 {% octicon "rocket" aria-label="The rocket ship" %}。 ![用于访问站点管理员设置的火箭图标](/assets/images/enterprise/site-admin-settings/access-new-settings.png) - -### 许可信息与搜索 - -请参照站点管理员仪表板的此部分检查您当前的 {% data variables.product.prodname_enterprise %} 许可；搜索用户和仓库；查询[审核日志](#audit-log)。 - -### {% data variables.enterprise.management_console %} - -您可以在此处启动 {% data variables.enterprise.management_console %}，以管理域、身份验证和 SSL 等虚拟设备设置。 - -### 探索 - - GitHub [趋势页面](https://github.com/blog/1585-explore-what-is-trending-on-github)中的数据按每天、每周和每月的时间跨度为仓库和开发者计算。 在 **Explore** 部分中，您可以看到此数据的最后缓存时间，并将新的趋势计算作业加入队列。 - -### 审核日志 - -{% data variables.product.prodname_enterprise %} 会实时记录您可以查询的审核操作。 - -默认情况下，审核日志会按时间倒序显示所有已审核操作的列表。 要对此列表进行筛选，您可以在 **Query** 文本框中输入键值对，然后单击 **Search**，如“[搜索审核日志](/enterprise/{{ currentVersion }}/admin/guides/installation/searching-the-audit-log)”所述。 - -更多关于审核日志的信息，请参阅“[审核日志](/enterprise/{{ currentVersion }}/admin/guides/installation/audit-logging)”。有关审核操作的完整列表，请参阅“[审核的操作](/enterprise/{{ currentVersion }}/admin/guides/installation/audited-actions)”。 - -### 报告 - -如果您需要获取关于 {% data variables.product.product_location_enterprise %} 中用户、组织和仓库的信息，正常些情况下，您将通过 [GitHub API](http://developer.github.com/v3/) 提取 JSON 数据。 但遗憾的是，此 API 可能无法提供您需要的所有数据，并且需要一定的专业技术知识才能使用。 因此，站点管理员仪表板提供 **Reports** 部分代替 API 方法，您可以通过仪表板轻松下载 CSV 报告，其中包含大部分您有可能需要的用户、组织和仓库信息。 - -具体来讲，您可以下载列出以下信息的 CSV 报告： - -- 所有用户 -- 在上个月内曾处于活动状态的所有用户 -- 一个月或更长时间未活动的所有用户 -- 曾被挂起的所有用户 -- 所有组织 -- 所有仓库 - -您还可以通过向站点管理员帐户进行标准 HTTP 身份验证，以编程方式访问这些报告。 必须使用 `site_admin` 范围的个人访问令牌。 For more information, see "[Creating a personal access token](/github/authenticating-to-github/creating-a-personal-access-token)." - -下面是如何使用 cURL 下载“所有用户”报告的示例： - -```shell -curl -L -u username:token http(s)://hostname/stafftools/reports/all_users.csv -``` - -要以编程方式访问其他报告，请将 `all_users` 替换为 `active_users`、`dormant_users`、`suspended_users`、`all_organizations` 或 `all_repositories`。 - -{% note %} - -**注**：如果没有可用的缓存报告，最初的 `curl` 请求会返回 202 HTTP 响应；将在后台生成报告。 您可以发送另一个请求来下载报告。 您可以使用具有 `site_admin` 作用域的密码或 OAuth 令牌代替密码。 - -{% endnote %} - -#### 用户报告 - -| 键 | 描述 | -| -----------------:| ------------------------- | -| `created_at` | 用户帐户的创建时间（ISO 8601 时间戳形式） | -| `id` | 用户或组织的帐户 ID | -| `login` | 帐户的登录名称 | -| `电子邮件` | 帐户的主电子邮件地址 | -| `角色` | 帐户属于管理员还是普通用户 | -| `suspended?` | 帐户是否已挂起 | -| `last_logged_ip` | 最近登录帐户的 IP 地址 | -| `repos` | 帐户拥有的仓库数量 | -| `ssh_keys` | 注册到帐户的 SSH 密钥数量 | -| `org_memberships` | 帐户所属的组织数量 | -| `dormant?` | 帐户是否休眠 | -| `last_active` | 帐户上次活动时间（ISO 8601 时间戳形式） | -| `raw_login` | 原始登录信息（JSON 格式） | -| `2fa_enabled?` | 用户是否已启用双重身份验证 | - -#### 组织报告 - -| 键 | Description | -| ---------------:| ------------ | -| `id` | 组织 ID | -| `created_at` | 组织创建时间 | -| `login` | 组织的登录名称 | -| `电子邮件` | 组织的主电子邮件地址 | -| `owners` | 组织所有者数量 | -| `members` | 组织成员数量 | -| `团队` | 组织团队数量 | -| `repos` | 组织仓库数量 | -| `2fa_required?` | 组织是否需要双重身份验证 | - -#### 仓库报告 - -| 键 | 描述 | -| ---------------:| -------------- | -| `created_at` | 仓库创建时间 | -| `owner_id` | 仓库所有者的 ID | -| `owner_type` | 仓库由用户所有还是由组织所有 | -| `owner_name` | 仓库所有者的名称 | -| `id` | 仓库 ID | -| `name` | 仓库名称 | -| `可见性` | 仓库是公共还是私有 | -| `readable_size` | 以人类可读格式表示的仓库大小 | -| `raw_size` | 以数字形式表示的仓库大小 | -| `collaborators` | 仓库协作者数量 | -| `fork?` | 仓库是否为分叉 | -| `deleted?` | 仓库是否已删除 | - -### 索引 - - GitHub 的[代码搜索](https://github.com/blog/1381-a-whole-new-code-search)功能由 [ElasticSearch](http://www.elasticsearch.org/) 提供支持。 站点管理员仪表板的这一部分会显示 ElasticSearch 集群的当前状态，并提供多种工具来控制搜索和索引行为。 这些工具分为以下三类。 - -#### 代码搜索 - -此类允许您启用或禁用对源代码进行的搜索和索引操作。 - -#### 代码搜索索引修复 - -此类控制着代码搜索索引的修复方式。 您可以 - -- 启用或禁用索引修复作业 -- 开始新的索引修复作业 -- 重置所有索引修复状态 - -{% data variables.product.prodname_enterprise %} 使用修复作业协调搜索索引的状态与数据库中存储的数据（问题、拉取请求、仓库和用户）以及 Git 仓库中存储的数据（源代码）。 以下情况下会进行此操作： - -- 创建新的搜索索引； -- 需要重新填入缺失的数据；或者 -- 需要更新旧的搜索数据。 - -也就是说，修复作业是根据需要启动的，并在后台运行，而不是站点管理员通过任何方式排定的。 - -此外，修复作业还使用“修复偏移”实现并行化。 偏移是指协调的记录在数据库表中的偏移。 多个后台作业可以基于此偏移同步工作。 - -进度条会在所有后台工作进程中显示修复作业的当前状态。 此值是修复偏移与数据中最高记录 ID 的百分比差异。 不用担心修复作业完成后在进度条中显示的值：因为它表示的是修复偏移与数据库中最高记录 ID 之差，随着更多的仓库添加到 {% data variables.product.product_location_enterprise %} 中，即使这些仓库实际上已编制索引，此值也会减小。 - -您可以随时启动新的代码搜索索引修复作业。 在协调搜索索引与数据库和 Git 仓库数据时，它将使用单个 CPU。 为了最大限度地减小对 I/O 性能的影响并减小操作超时的几率，请先尝试在非高峰期运行修复作业。 使用 `top` 等实用程序监视系统的平均负载和 CPU 利用率；如果您没有注意到任何显著的变化，那么在高峰期运行索引修复作业也应当是安全的。 - -#### 问题索引修复 - - 此类控制着[问题](https://github.com/blog/831-issues-2-0-the-next-generation)索引的修复方式。 您可以 - -- 启用或禁用索引修复作业 -- 开始新的索引修复作业 -- 重置所有索引修复状态 - -### 仓库 - -这是 {% data variables.product.product_location_enterprise %} 上的仓库列表。 您可以单击仓库名称，然后访问各项功能，对仓库进行管理。 - -- [阻止对仓库进行强制推送](/enterprise/{{ currentVersion }}/admin/guides/developer-workflow/blocking-force-pushes-to-a-repository/) -- [配置 {% data variables.large_files.product_name_long %}](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-git-large-file-storage/#configuring-git-large-file-storage-for-an-individual-repository) -- [存档和取消存档仓库](/enterprise/{{ currentVersion }}/admin/guides/user-management/archiving-and-unarchiving-repositories/) - -### 所有用户 - -您可以在此查看 {% data variables.product.product_location_enterprise %} 上的所有用户，并[发起 SSH 密钥审核](/enterprise/{{ currentVersion }}/admin/guides/user-management/auditing-ssh-keys)。 - -### 站点管理员 - -您可以在此查看 {% data variables.product.product_location_enterprise %} 上的所有管理员，并[发起 SSH 密钥审核](/enterprise/{{ currentVersion }}/admin/guides/user-management/auditing-ssh-keys)。 - -### 休眠用户 - -您可以在此查看并[挂起](/enterprise/{{ currentVersion }}/admin/guides/user-management/suspending-and-unsuspending-users) {% data variables.product.product_location_enterprise %} 上的所有非活动用户。 以下情况下，会认定用户帐户处于非活动状态（“休眠”）： - -- 存在时间长于为 {% data variables.product.product_location_enterprise %} 设置的休眠阈值。 -- 在该时间段内没有发生任何活动。 -- 不是站点管理员。 - -{% data reusables.enterprise_site_admin_settings.dormancy-threshold %} 更多信息请参阅“[管理休眠用户](/enterprise/{{ currentVersion }}/admin/guides/user-management/managing-dormant-users/#configuring-the-dormancy-threshold)”。 - -### 已挂起的用户 - -您可以在此查看 {% data variables.product.product_location_enterprise %} 上所有已被挂起的用户，并[发起 SSH 密钥审核](/enterprise/{{ currentVersion }}/admin/guides/user-management/auditing-ssh-keys)。 diff --git a/translations/zh-CN/content/admin/installation/system-overview.md b/translations/zh-CN/content/admin/installation/system-overview.md deleted file mode 100644 index 4113d5067bc1..000000000000 --- a/translations/zh-CN/content/admin/installation/system-overview.md +++ /dev/null @@ -1,140 +0,0 @@ ---- -title: 系统概述 -intro: '{% data variables.product.prodname_ghe_server %} 是包含在虚拟设备中属于您的组织的 {% data variables.product.prodname_dotcom %} 私有副本，此虚拟设备托管在您配置和控制的本地或云中。' -redirect_from: - - /enterprise/admin/installation/system-overview -versions: - enterprise-server: '*' ---- - -### 存储架构 - -{% data variables.product.prodname_ghe_server %} 需要两个存储卷，一个安装在*根文件系统*路径下 (`/`)，另一个安装在*用户文件系统*路径下 (`/data/user`)。 这种架构将运行软件环境与持久应用程序数据分离，从而可以简化升级、回滚和恢复程序。 - -根文件系统包含在分布式机器映像中。 它包含基本操作系统和 {% data variables.product.prodname_ghe_server %} 应用程序环境。 根文件系统应被视为临时性的。 升级到今后的 {% data variables.product.prodname_ghe_server %} 版本时，根文件系统中的所有数据都将被替代。 - -根文件系统包含： - - 自定义证书颁发机构 (CA) 证书（*/usr/local/share/ca-certificates* 中） - - 自定义网络配置 - - 自定义防火墙配置 - - 复制状态 - -用户文件系统包含用户配置和数据，例如： - - Git 仓库 - - 数据库 - - 搜索索引 - - 在 {% data variables.product.prodname_pages %} 站点上发布的内容 - - {% data variables.large_files.product_name_long %} 中的大文件 - - 预接收挂钩环境 - -### 部署选项 - -您可以将 {% data variables.product.prodname_ghe_server %} 部署为一个虚拟设备，也可采用高可用性配置。 更多信息请参阅“[配置 {% data variables.product.prodname_ghe_server %} 以实现高可用性](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-github-enterprise-server-for-high-availability/)”。 - -某些拥有成千上万名开发者的组织还会从使用 {% data variables.product.prodname_ghe_server %} 集群中受益。 更多信息请参阅“[关于集群](/enterprise/{{ currentVersion }}/admin/guides/clustering/about-clustering)。” - -### 数据保留和数据中心冗余 - -{% danger %} - -在生产环境中使用 {% data variables.product.prodname_ghe_server %} 之前，我们强烈建议您设置备份和灾难恢复计划。 更多信息请参阅“[在设备上配置备份](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-backups-on-your-appliance)”。 - -{% enddanger %} - -{% data variables.product.prodname_ghe_server %} 支持通过 [{% data variables.product.prodname_enterprise_backup_utilities %}](https://github.com/github/backup-utils) 进行在线和增量备份。 您可以通过安全网络链接（SSH 管理端口）远距离为场外或地理上分散的存储生成增量快照。 在主数据中心发生灾难时，您可以在恢复时通过网络将快照恢复到新配置的设备中。 - -除网络备份外，在设备处于离线或维护模式时，还支持用户存储卷的 AWS (EBS) 和 VMware 磁盘快照。 如果您的服务级别要求允许定期离线维护，可以将定期卷快照用作低成本、低复杂性的方案，代替通过 {% data variables.product.prodname_enterprise_backup_utilities %} 进行网络备份。 - -更多信息请参阅“[在设备上配置备份](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-backups-on-your-appliance)”。 - -### 安全 - -{% data variables.product.prodname_ghe_server %} 是一个在基础设施上运行的虚拟设备，受您现有的信息安全控制（如防火墙、IAM、监控和 VPN）所管辖。 使用 {% data variables.product.prodname_ghe_server %} 可以帮助您避免因云解决方案而产生的管理合规问题。 - -{% data variables.product.prodname_ghe_server %} 还包含额外的安全功能。 - -- [操作系统、软件和补丁](#operating-system-software-and-patches) -- [网络安全性](#network-security) -- [应用程序安全性](#application-security) -- [外部服务和支持](#external-services-and-support-access) -- [加密通信](#encrypted-communication) -- [用户和访问权限](#users-and-access-permissions) -- [身份验证](#authentication) -- [审核和访问日志记录](#audit-and-access-logging) - -#### 操作系统、软件和补丁 - -{% data variables.product.prodname_ghe_server %} 运行自定义的 Linux 操作系统，其中只包含必要的应用程序和服务。 {% data variables.product.prodname_dotcom %} 将管理设备核心操作系统的补丁作为其标准产品发布周期的一部分。 补丁可解决 {% data variables.product.prodname_dotcom %} 应用程序的功能、稳定性和非关键性安全问题。 {% data variables.product.prodname_dotcom %} 还根据需要在常规发布周期之外提供重要的安全补丁。 - -#### 网络安全性 - -{% data variables.product.prodname_ghe_server %} 的内部防火墙限制对设备服务的网络访问。 网络上仅提供设备正常运行所需的服务。 更多信息请参阅“[网络端口](/enterprise/{{ currentVersion }}/admin/guides/installation/network-ports)”。 - -#### 应用程序安全性 - -{% data variables.product.prodname_dotcom %} 的应用程序安全团队全时关注 {% data variables.product.prodname_dotcom %} 产品（包括 {% data variables.product.prodname_ghe_server %}）的漏洞评估、渗透测试和代码审查。 {% data variables.product.prodname_dotcom %} 还与外部安全公司签约，要求他们对 {% data variables.product.prodname_dotcom %} 产品定期进行安全性评估。 - -#### 外部服务和支持 - -{% data variables.product.prodname_ghe_server %} 无需从网络访问外部服务也可以正常运行。 您可以选择集成外部服务，以提供电子邮件传送、外部监控和日志转发等功能。 更多信息请参阅“[配置电子邮件通知](/enterprise/{{ currentVersion }}/admin/user-management/configuring-email-for-notifications)”、“[设置外部监控](/enterprise/{{ currentVersion }}/admin/installation/setting-up-external-monitoring)”和“[日志转发](/enterprise/{{ currentVersion }}/admin/installation/log-forwarding)”。 - -您可以手动收集故障排除数据并发送至 {% data variables.contact.github_support %}。 更多信息请参阅“[向 {% data variables.contact.github_support %} 提供数据](/enterprise/{{ currentVersion }}/admin/enterprise-support/providing-data-to-github-support)”。 - -#### 加密通信 - -{% data variables.product.prodname_dotcom %} 将 {% data variables.product.prodname_ghe_server %} 设计为在公司防火墙后面运行。 为确保线路通信安全，我们建议您启用传输层安全协议 (TLS)。 {% data variables.product.prodname_ghe_server %} 在 HTTPS 流量方面支持 2048 位和更高的商业 TLS 证书。 更多信息请参阅“[配置 TLS](/enterprise/{{ currentVersion }}/admin/installation/configuring-tls)”。 - -默认情况下，该设备还为使用 Git 的仓库访问和管理目的提供安全 Shell (SSH) 访问。 更多信息请参阅“[关于 SSH](/enterprise/user/articles/about-ssh)”和“[访问管理 shell (SSH)](/enterprise/{{ currentVersion }}/admin/installation/accessing-the-administrative-shell-ssh)“。 - -#### 用户和访问权限 - -{% data variables.product.prodname_ghe_server %} 提供三种类型的帐户。 - -- `管理员` Linux 用户帐户已控制对基础操作系统的访问，包括对直接文件系统和数据库的访问。 一小部分受信任的管理员应该有权访问此帐户，他们可以通过 SSH 访问。 更多信息请参阅“[访问管理 shell (SSH)](/enterprise/{{ currentVersion }}/admin/installation/accessing-the-administrative-shell-ssh)”。 -- 设备 Web 应用程序中的用户帐户对自己的数据以及其他用户或组织明确授予权限的任何数据具有完全访问权限。 -- 设备 Web 应用程序中的站点管理员是可以管理高级 Web 应用程序和设备设置、用户和组织帐户设置以及仓库数据的用户帐户。 - -关于 {% data variables.product.prodname_ghe_server %} 用户权限的更多信息，请参阅“[GitHub 上的访问权限](/enterprise/user/articles/access-permissions-on-github) ”。 - -#### 身份验证 - -{% data variables.product.prodname_ghe_server %} 提供四种身份验证方法。 - -- SSH 公钥身份验证提供使用 Git 的仓库访问权限和管理 shell 的访问权限。 更多信息请参阅“[关于 SSH](/enterprise/user/articles/about-ssh)”和“[访问管理 shell (SSH)](/enterprise/{{ currentVersion }}/admin/installation/accessing-the-administrative-shell-ssh)“。 -- 使用 HTTP cookie 的用户名和密码身份验证提供 Web 应用程序访问和会话管理权限，可选择双重身份验证 (2FA)。 更多信息请参阅“[使用内置身份验证](/enterprise/{{ currentVersion }}/admin/user-management/using-built-in-authentication)”。 -- 使用 LDAP 服务、SAML 身份提供程序 (IdP) 或其他兼容服务的外部 LDAP、SAML 或 CAS 身份验证提供对 Web 应用程序的访问权限。 更多信息请参阅“[为您的 GitHub Enterprise Server 实例验证用户身份](/enterprise/{{ currentVersion }}/admin/user-management/authenticating-users-for-your-github-enterprise-server-instance)“。 -- OAuth 和个人访问令牌为外部客户端和服务提供对 Git 仓库数据和 API 的访问权限。 For more information, see "[Creating a personal access token](/github/authenticating-to-github/creating-a-personal-access-token)." - -#### 审核和访问日志记录 - -{% data variables.product.prodname_ghe_server %} 存储传统的操作系统日志和应用程序日志。 应用程序还会编写详细的审核和安全日志，永久存储在 {% data variables.product.prodname_ghe_server %} 上。 您可以通过 `syslog-ng` 协议将两种类型的日志实时转发到多个目标。 更多信息请参阅“[日志转发](/enterprise/{{ currentVersion }}/admin/installation/log-forwarding)”。 - -访问和审核日志包括如下信息。 - -##### 访问日志 - -- 关于浏览器和 API 访问的完整 web 服务器日志 -- 通过 Git、HTTP 和 SSH 协议访问仓库数据的完整日志 -- 通过 HTTPS 和 SSH 的管理访问日志 - -##### 审核日志 - -- 用户登录、密码重置、2FA 请求、电子邮件设置更改，以及对授权应用程序和 API 的更改 -- 站点管理员操作，例如解锁用户帐户和仓库 -- 仓库推送事件、访问授权、转让和重命名 -- 组织成员变更，包括团队创建和删除 - -### {% data variables.product.prodname_ghe_server %} 的开源依赖项 - -要查看您的设备 {% data variables.product.prodname_ghe_server %} 版本中依赖项的完整列表以及每个项目的许可，请访问 `http(s)://HOSTNAME/site/credits`。 - -您的设备上提供包含依赖项和关联元数据完整列表的 tarball： -- 要查看所有平台通用的依赖项，请访问 `/usr/local/share/enterprise/dependencies--base.tar.gz` -- 要查看平台特有的依赖项，请访问 `/usr/local/share/enterprise/dependencies--.tar.gz` - -还提供包含依赖项和元数据完整列表的 tarball，地址为 `https://enterprise.github.com/releases//download.html`。 - -### 延伸阅读 - -- “[设置 {% data variables.product.prodname_ghe_server %} 的试用版](/articles/setting-up-a-trial-of-github-enterprise-server)” -- “[设置 {% data variables.product.prodname_ghe_server %} 实例](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-github-enterprise-server-instance)” diff --git a/translations/zh-CN/content/admin/installation/troubleshooting-ssl-errors.md b/translations/zh-CN/content/admin/installation/troubleshooting-ssl-errors.md deleted file mode 100644 index a4a1a58d6a2d..000000000000 --- a/translations/zh-CN/content/admin/installation/troubleshooting-ssl-errors.md +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: 排查 SSL 错误 -intro: 如果您的设备遇到 SSL 问题，可以采取相应措施加以解决。 -redirect_from: - - /enterprise/admin/articles/troubleshooting-ssl-errors/ - - /enterprise/admin/categories/dns-ssl-and-subdomain-configuration/ - - /enterprise/admin/installation/troubleshooting-ssl-errors -versions: - enterprise-server: '*' ---- - -### 将密码从密钥文件中移除 - -如果您的 Linux 机器上安装了 OpenSSL，可以移除密码。 - -1. 重命名原始密钥文件。 - ```shell - $ mv yourdomain.key yourdomain.key.orig - ``` -2. 生成不含密码的新密钥。 - ```shell - $ openssl rsa -in yourdomain.key.orig -out yourdomain.key - ``` - -运行此命令时系统会提示您输入密钥的密码。 - -关于 OpenSSL 的更多信息，请参阅 [OpenSSL 的文档](https://www.openssl.org/docs/)。 - -### 将 SSL 证书或密钥转换为 PEM 格式 - -如果安装了 OpenSSL，您可以使用 `openssl` 命令将密钥转换为 PEM 格式。 例如，您可以将密钥从 DER 格式转换为 PEM 格式。 - -```shell -$ openssl rsa -in yourdomain.der -inform DER -out yourdomain.key -outform PEM -``` - -否则，可以使用 SSL Converter 工具将证书转换为 PEM 格式。 更多信息请参阅 [SSL Converter 工具文档](https://www.sslshopper.com/ssl-converter.html)。 - -### 上传密钥后安装无响应 - -如果上传 SSL 密钥后 {% data variables.product.product_location_enterprise %} 无响应，请[联系 {% data variables.product.prodname_enterprise %} Support](https://enterprise.github.com/support) 并提供具体的详细信息，并附上您的 SSL 证书的副本。 - -### 证书有效性错误 - -如果 Web 浏览器和命令行 Git 等客户端无法验证 SSL 证书的有效性，则会显示错误消息。 这种情况通常发生在自签名证书以及由不被客户端承认的中间根证书颁发的“链式根”证书上。 - -如果您要使用由证书颁发机构 (CA) 签名的证书，那么您上传到 {% data variables.product.prodname_ghe_server %} 的证书文件必须包含具有该 CA 的根证书的证书链。 要创建此类文件，请将整个证书链（“或证书包”）连接到证书末端，确保包含主机名的主要证书在前。 在大多数系统中，您可以使用与下列命令相似的命令来执行此操作： - -```shell -$ cat yourdomain.com.crt bundle-certificates.crt > yourdomain.combined.crt -``` - -您可以从证书颁发机构或 SSL 供应商处下载证书包（例如 `bundle-certificates.crt`）。 - -### 安装自签名或不受信任的证书颁发机构 (CA) 根证书 - -如果您的 {% data variables.product.prodname_ghe_server %} 设备与网络中使用自签名或不受信证书的其他机器进行交互，您需要将签名 CA 的根证书导入到系统范围的证书库中，以通过 HTTPS 访问这些系统。 - -1. 从本地证书颁发机构获取 CA 的根证书并确保其为 PEM 格式。 -2. 以“admin”用户身份在端口 122 上通过 SSH 将文件复制到您的 {% data variables.product.prodname_ghe_server %} 设备。 - ```shell - $ scp -P 122 rootCA.crt admin@HOSTNAME:/home/admin - ``` -3. 以“admin”用户身份在端口 122 上通过 SSH 连接到 {% data variables.product.prodname_ghe_server %} 管理 shell。 - ```shell - $ ssh -p 122 admin@HOSTNAME - ``` -4. 将证书导入到系统范围的证书库中。 - ```shell - $ ghe-ssl-ca-certificate-install -c rootCA.crt - ``` diff --git a/translations/zh-CN/content/admin/installation/updating-the-virtual-machine-and-physical-resources.md b/translations/zh-CN/content/admin/installation/updating-the-virtual-machine-and-physical-resources.md deleted file mode 100644 index 620ec98033b6..000000000000 --- a/translations/zh-CN/content/admin/installation/updating-the-virtual-machine-and-physical-resources.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: 更新虚拟机和物理资源 -intro: 升级虚拟软件和虚拟硬件需要您的实例停机一段时间，因此，请务必提前规划升级。 -redirect_from: - - '/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-the-vm/' - - '/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-physical-resources/' - - /enterprise/admin/installation/updating-the-virtual-machine-and-physical-resources -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/zh-CN/content/admin/installation/upgrade-requirements.md b/translations/zh-CN/content/admin/installation/upgrade-requirements.md deleted file mode 100644 index cb650e3de324..000000000000 --- a/translations/zh-CN/content/admin/installation/upgrade-requirements.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: 升级要求 -intro: '对 {% data variables.product.prodname_ghe_server %} 进行升级之前，请查阅升级策略规划的建议和要求。' -redirect_from: - - /enterprise/admin/guides/installation/finding-the-current-github-enterprise-release/ - - /enterprise/admin/installation/upgrade-requirements -versions: - enterprise-server: '*' ---- - -{% note %} - -**注：** -- 要由 {% data variables.product.prodname_enterprise %} 11.10.348 升级到 {% data variables.product.current-340-version %}，您必须先迁移到 {% data variables.product.prodname_enterprise %} 2.1.23。 更多信息请参阅“[从 {% data variables.product.prodname_enterprise %} 11.10.x 迁移到 2.1.23](/enterprise/{{ currentVersion }}/admin/guides/installation/migrating-from-github-enterprise-11-10-x-to-2-1-23)”。 -- 为受支持版本提供的升级包位于 [enterprise.github.com](https://enterprise.github.com/releases)。 验证完成升级所需的升级包的可用性。 如果升级包不可用，请联系 {% data variables.contact.contact_ent_support %} 获得帮助。 -- 如果您使用 {% data variables.product.prodname_ghe_server %} 集群，请参阅 {% data variables.product.prodname_ghe_server %} 集群指南中的“[升级集群](/enterprise/{{ currentVersion }}/admin/guides/clustering/upgrading-a-cluster/)”，了解集群特有的说明。 -- {% data variables.product.prodname_ghe_server %} 版本说明提供了 {% data variables.product.prodname_ghe_server %} 每一版本的新功能一览表。 更多信息请参阅[版本页面](https://enterprise.github.com/releases)。 - -{% endnote %} - -### 建议 - -- 尽量减少升级过程中的升级次数。 例如，不要从 {% data variables.product.prodname_enterprise %} {{ enterpriseVersions.supported[2] }} 升级到 {{ enterpriseVersions.supported[1] }} 再升级到 {{ enterpriseVersions.latest }}，而应从 {% data variables.product.prodname_enterprise %} {{ enterpriseVersions.supported[2] }} 升级到 {{ enterpriseVersions.latest }}。 -- 如果您的版本比最新版本低几个版本，请通过升级过程的每一步骤尽量将 {% data variables.product.product_location_enterprise %} 升级为更高版本。 在每次升级时尽可能使用最新版本，这样一来您可以充分利用性能改进和错误修复。 例如，您可以从 {% data variables.product.prodname_enterprise %} 2.7 升级到 2.8 再升级到 2.10，但从 {% data variables.product.prodname_enterprise %} 2.7 升级到 2.9 再升级到 2.10 会在第二步中使用更高版本。 -- 升级时使用最新补丁版本。 {% data reusables.enterprise_installation.enterprise-download-upgrade-pkg %} -- 使用暂存实例测试升级步骤。 更多信息请参阅“[设置暂存实例](/enterprise/{{ currentVersion }}/admin/guides/installation/setting-up-a-staging-instance/)”。 -- 如果运行多次升级，两次功能升级之间至少应间隔 24 小时，以便使数据迁移和后台升级任务能够彻底完成。 - -### 要求 - -- 您必须从**最近**两个版本的功能版本开始升级。 例如，要升级到 {% data variables.product.prodname_enterprise %} {{ enterpriseVersions.latest }}，您必须使用 {% data variables.product.prodname_enterprise %} {{ enterpriseVersions.supported[1] }} 或 {{ enterpriseVersions.supported[2] }}。 -- {% data reusables.enterprise_installation.hotpatching-explanation %} -- 如果受影响的服务（例如内核、MySQL 或 Elasticsearch）需要重启 VM 或服务，热补丁可能需要停机一段时间。 需要重启时，系统会通知您。 您可以在稍后完成重启。 -- 通过热补丁升级时，必须提供额外的根存储，因为热补丁会安装某些服务的多个版本，直至升级完成。 如果根磁盘存储空间不足，运行前检查将发出通知。 -- 通过热补丁进行升级时，您的实例负荷不能过大，否则可能影响热补丁过程。 运行前检查将考虑平均负载，如果平均负载过高，升级将失败。- 升级至 {% data variables.product.prodname_ghe_server %} 2.17 可将您的审核日志从 Elasticsearch 迁移到 MySQL. 这种迁移还会增加恢复快照所需的时长和磁盘空间大小。 迁移之前，请使用此命令检查 ElasticSearch 审核日志索引中的字节数： -``` shell -curl -s http://localhost:9201/audit_log/_stats/store | jq ._all.primaries.store.size_in_bytes -``` -使用此数字估算 MySQL 审核日志将需要的磁盘空间大小。 该脚本还会在导入过程中监视可用磁盘空间大小。 在可用磁盘空间大小接近于迁移必需的磁盘空间大小时，监视此数字尤为重要。 - -查看这些建议和要求后，您可以对 {% data variables.product.prodname_ghe_server %} 进行升级。 更多信息请参阅“[升级 {% data variables.product.prodname_ghe_server %}”](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrading-github-enterprise-server/)。 diff --git a/translations/zh-CN/content/admin/installation/upgrading-github-enterprise-server.md b/translations/zh-CN/content/admin/installation/upgrading-github-enterprise-server.md deleted file mode 100644 index 4bb06cded0a8..000000000000 --- a/translations/zh-CN/content/admin/installation/upgrading-github-enterprise-server.md +++ /dev/null @@ -1,219 +0,0 @@ ---- -title: 升级 GitHub Enterprise Server -intro: '升级 {% data variables.product.prodname_ghe_server %}，以获取最新功能和安全更新。' -redirect_from: - - /enterprise/admin/articles/upgrading-to-the-latest-release/ - - /enterprise/admin/articles/migrations-and-upgrades/ - - /enterprise/admin/guides/installation/upgrading-the-github-enterprise-virtual-machine/ - - /enterprise/admin/guides/installation/upgrade-packages-for-older-releases/ - - /enterprise/admin/articles/upgrading-older-installations/ - - /enterprise/admin/hidden/upgrading-older-installations/ - - /enterprise/admin/hidden/upgrading-github-enterprise-using-a-hotpatch-early-access-program/ - - /enterprise/admin/hidden/upgrading-github-enterprise-using-a-hotpatch/ - - /enterprise/admin/guides/installation/upgrading-github-enterprise/ - - /enterprise/admin/installation/upgrading-github-enterprise-server -versions: - enterprise-server: '*' ---- - -### 准备升级 - -1. 确定升级策略并选择要升级到的版本。 更多信息请参阅“[升级要求](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)”。 -3. 使用 {% data variables.product.prodname_enterprise_backup_utilities %} 创建全新的主实例备份。 更多信息请参阅 [{% data variables.product.prodname_enterprise_backup_utilities %} README.md 文件](https://github.com/github/backup-utils#readme)。 -4. 如果您要使用升级包进行升级，请为 {% data variables.product.prodname_ghe_server %} 最终用户排定维护窗口。 如果您要使用热补丁，则不需要使用维护模式。 - - {% note %} - - **注**：维护窗口取决于所执行升级的类型。 使用热补丁进行升级通常不需要维护窗口。 有时需要重启，不过您可以在之后的某个时间重启。 按照 MAJOR.FEATURE.PATCH 的版本控制方案，使用升级包的补丁版本通常需要不到 5 分钟的停机时间。 包含数据迁移的功能版本需要的时间更长，具体视存储性能以及迁移的数据量而定。 更多信息请参阅“[启用和排定维护模式](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)”。 - - {% endnote %} - -### 生成快照 - -快照是虚拟机 (VM) 在某一时间点的检查点。 强烈建议在升级虚拟机之前生成快照，这样一来，如果升级失败，您可以将 VM 还原到快照状态。 如果您要升级到新的功能版本，则必须生成 VM 快照。 如果您要升级到补丁版本，可以连接现有数据磁盘。 - -有两种类型的快照： - -- **VM 快照**会保存整个 VM 状态，包括用户数据和配置数据。 此快照方法需要占用大量磁盘空间，且比较耗时。 -- **数据磁盘快照**仅会保存您的用户数据。 - - {% note %} - - **注：** - - 某些平台不允许您只生成数据磁盘的快照。 对于此类平台，您需要生成整个 VM 的快照。 - - 如果您的虚拟机监控程序不支持完整的 VM 快照，您应连续、快速地生成根磁盘和数据磁盘的快照。 - - {% endnote %} - -| 平台 | 快照方法 | 快照文档 URL | -| --------------------- | ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| Amazon AWS | 磁盘 | | -| Azure | VM | | -| Hyper-V | VM | | -| Google Compute Engine | 磁盘 | | -| VMware | VM | [https://pubs.vmware.com/vsphere-50/topic/com.vmware.wssdk.pg.doc_50/PG_Ch11_VM_Manage.13.3.html](https://pubs.vmware.com/vsphere-50/topic/com.vmware.wssdk.pg.doc_50/PG_Ch11_VM_Manage.13.3.html) | -| XenServer | VM | | - -### 使用热补丁升级 - -{% data reusables.enterprise_installation.hotpatching-explanation %} 利用 {% data variables.enterprise.management_console %}，您可以立即安装热补丁，也可以排定稍后安装热补丁。 您可以使用管理 shell 的 `ghe-upgrade` 实用程序安装热补丁。 更多信息请参阅“[升级要求](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)”。 - -{% note %} - -**注**：无法在集群环境中使用 {% data variables.enterprise.management_console %} 安装热补丁。 要在集群环境中安装热补丁，请参阅“[升级集群](/enterprise/{{ currentVersion }}/admin/clustering/upgrading-a-cluster#upgrading-with-a-hotpatch)”。 - -{% endnote %} - -#### 使用热补丁升级单个设备 - -##### 使用 {% data variables.enterprise.management_console %} 安装热补丁 - -1. 启用自动更新。 更多信息请参阅“[启用自动更新](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-automatic-update-checks/)”。 -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.updates-tab %} -4. 在新的热补丁下载完毕后，请使用 Install package 下拉菜单： - - 要立即安装，请选择 **Now**： - - 要稍后安装，请选择以后的日期。 ![热补丁安装日期下拉菜单](/assets/images/enterprise/management-console/hotpatch-installation-date-dropdown.png) -5. 单击 **Install**。 ![热补丁安装按钮](/assets/images/enterprise/management-console/hotpatch-installation-install-button.png) - -##### 使用管理 shell 安装热补丁 - -{% data reusables.enterprise_installation.download-note %} - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. {% data reusables.enterprise_installation.enterprise-download-upgrade-pkg %} 复制升级热补丁包（*.hpkg* 文件）的 URL。 -{% data reusables.enterprise_installation.download-package %} -4. 使用包文件名运行 `ghe-upgrade` 命令： - ```shell - admin@HOSTNAME:~$ ghe-upgrade GITHUB-UPGRADE.hpkg - *** verifying upgrade package signature... - ``` -5. 如果更新内核、MySQL、Elasticsearch 或其他程序时需要重启，热补丁升级脚本会通知您。 - -#### 使用热补丁升级包含副本实例的设备 - -{% note %} - -**注**：如果要安装热补丁，则无需进入维护模式或停止复制。 - -{% endnote %} - -配置为高可用性和 Geo-replication 的设备除了会使用主实例之外，还会使用副本实例。 要升级此类设备，您需要逐个升级主实例和所有副本实例。 - -##### 升级主实例 - -1. 请按照“[使用管理 shell 安装热补丁](#installing-a-hotpatch-using-the-administrative-shell)”中的说明升级主实例。 - -##### 升级副本实例 - -{% note %} - -**注**：如果您要将多个副本实例作为 Geo-replication 的一部分运行，请逐一为每个副本实例重复此步骤。 - -{% endnote %} - -1. 请按照“[使用管理 shell 安装热补丁](#installing-a-hotpatch-using-the-administrative-shell)”中的说明升级副本实例。如果您为 Geo-replication 使用多个副本，则必须重复此步骤，逐一升级每个副本。 -{% data reusables.enterprise_installation.replica-ssh %} -{% data reusables.enterprise_installation.replica-verify %} - -### 使用升级包升级 - -虽然您可以使用热补丁升级到功能系列中的最新补丁版本，但必须使用升级包升级到更新的功能版本。 例如，要从 `2.11.10` 升级到 `2.12.4`，您必须使用升级包，因为两者在不同的功能系列中。 更多信息请参阅“[升级要求](/enterprise/{{ currentVersion }}/admin/guides/installation/upgrade-requirements/)”。 - -#### 使用升级包升级单个设备 - -{% data reusables.enterprise_installation.download-note %} - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. {% data reusables.enterprise_installation.enterprise-download-upgrade-pkg %} 选择适当的平台并复制升级包（*.pkg* 文件）的 URL。 -{% data reusables.enterprise_installation.download-package %} -4. 启用维护模式并等待 {% data variables.product.prodname_ghe_server %} 实例上的所有活动进程完成。 更多信息请参阅“[启用和排定维护模式](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode)”。 - - {% note %} - - **注**：升级采用高可用性配置的主设备时，如果您按照“[升级主实例](#upgrading-the-primary-instance)”中的说明操作，设备应当已处于维护模式。 - - {% endnote %} - -5. 使用包文件名运行 `ghe-upgrade` 命令： - ```shell - admin@HOSTNAME:~$ ghe-upgrade GITHUB-UPGRADE.pkg - *** verifying upgrade package signature... - ``` -6. 确认您要继续升级，并在包签名得到验证后重新启动。 新的根文件系统会写入辅助分区，实例会在维护模式下自动重启： - ```shell - *** 正在应用更新... - This package will upgrade your installation to version version-number - Current root partition: /dev/xvda1 [version-number] - Target root partition: /dev/xvda2 - Proceed with installation? [y/N] - ``` -7. 对于单个设备升级，请禁用维护模式，以便用户能够使用 {% data variables.product.product_location_enterprise %}。 - - {% note %} - - **注**：升级采用高可用性配置的主设备时，您应当一直处于维护模式，直至已升级所有副本，复制是最新版本。 更多信息请参阅“[升级副本实例](#upgrading-a-replica-instance)”。 - - {% endnote %} - -#### 使用升级包升级包含副本实例的设备 - -配置为高可用性和 Geo-replication 的设备除了会使用主实例之外，还会使用副本实例。 要升级此类设备，您需要逐个升级主实例和所有副本实例。 - -##### 升级主实例 - -{% warning %} - -**警告**：复制停止时，如果主实例发生故障，副本升级和复制再次开始之前执行的任何操作都将丢失。 - -{% endwarning %} - -1. 在主实例上，启用维护模式并等待所有活动进程完成。 更多信息请参阅“[启用维护模式](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-and-scheduling-maintenance-mode/)”。 -{% data reusables.enterprise_installation.replica-ssh %} -3. 在副本实例或者所有副本实例（如果您将多个副本实例作为 Geo-replication 的一部分运行）上，运行 `ghe-repl-stop` 以停止复制。 -4. 按照“[使用升级包升级单个设备](#upgrading-a-single-appliance-with-an-upgrade-package)”中的说明升级主实例。 - -##### 升级副本实例 - -{% note %} - -**注**：如果您要将多个副本实例作为 Geo-replication 的一部分运行，请逐一为每个副本实例重复此步骤。 - -{% endnote %} - -1. 按照“[使用升级包升级单个设备](#upgrading-a-single-appliance-with-an-upgrade-package)”中的说明升级副本实例。如果您为 Geo-replication 使用多个副本，则必须重复此步骤，逐一升级每个副本。 -{% data reusables.enterprise_installation.replica-ssh %} -{% data reusables.enterprise_installation.replica-verify %} - -{% data reusables.enterprise_installation.start-replication %} - -{% data reusables.enterprise_installation.replication-status %} 如果命令返回 `Replication is not running`，说明复制可能仍在启动。 等待 1 分钟左右，然后再次运行 `ghe-repl-status`。 - - {% note %} - - **注**：在重新同步过程中，`ghe-repl-status` 可能返回预期消息，提示复制落后。 - 例如：`CRITICAL: git replication is behind the primary by more than 1007 repositories and/or gists` - - {% endnote %} - - 如果 `ghe-repl-status` 未返回 `OK`，请执行以下步骤手动启动复制。 - - 1. 在副本实例上，再次运行 `ghe-repl-setup `。 - {% data reusables.enterprise_installation.start-replication %} - {% data reusables.enterprise_installation.replication-status %} -6. 最后一个副本升级完毕且重新同步完成后，请禁用维护模式，以便用户能够使用 {% data variables.product.product_location_enterprise %}。 - -### 从失败的升级中恢复 - -如果升级失败或中断，您应将实例还原为其之前的状态。 完成此操作的过程取决于升级类型。 - -#### 回滚补丁版本 - -要回滚补丁版本，请使用带 `--allow-patch-rollback` 开关的 `ghe-upgrade` 命令。 {% data reusables.enterprise_installation.command-line-utilities-ghe-upgrade-rollback %} - -更多信息请参阅“[命令行实用程序](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities/#ghe-upgrade)”。 - -#### 回滚功能版本 - -要从功能版本回滚，请从 VM 快照恢复，以确保根分区和数据分区处于一致的状态。 更多信息请参阅“[生成快照](#taking-a-snapshot)”。 diff --git a/translations/zh-CN/content/admin/installation/using-github-enterprise-server-with-a-load-balancer.md b/translations/zh-CN/content/admin/installation/using-github-enterprise-server-with-a-load-balancer.md deleted file mode 100644 index ccbcc46d117f..000000000000 --- a/translations/zh-CN/content/admin/installation/using-github-enterprise-server-with-a-load-balancer.md +++ /dev/null @@ -1,54 +0,0 @@ ---- -title: 结合使用 GitHub Enterprise Server 和负载均衡器 -intro: '在单个 {% data variables.product.prodname_ghe_server %} 设备或一对采用高可用性配置的设备前方使用负载均衡器。' -redirect_from: - - /enterprise/admin/guides/installation/using-github-enterprise-with-a-load-balancer/ - - /enterprise/admin/installation/using-github-enterprise-server-with-a-load-balancer -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_clustering.load_balancer_intro %} - -{% data reusables.enterprise_clustering.load_balancer_dns %} - -### 处理客户端连接信息 - -由于与 {% data variables.product.prodname_ghe_server %} 的客户端连接来自负载均衡器，因此客户端 IP 可丢失。 - -{% data reusables.enterprise_clustering.proxy_preference %} - -{% data reusables.enterprise_clustering.proxy_xff_firewall_warning %} - -#### 在 {% data variables.product.product_location_enterprise %} 上启用 PROXY 协议支持 - -强烈建议同时为您的设备和负载均衡器启用 PROXY 协议支持。 按照您的供应商提供的说明操作，在负载均衡器上启用 PROXY 协议。 更多信息请参阅 [PROXY 协议文档](http://www.haproxy.org/download/1.6/doc/proxy-protocol.txt)。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -3. 在 **External load balancers** 下，选择 **Enable support for PROXY protocol**。 ![启用 PROXY 协议支持的复选框](/assets/images/enterprise/management-console/enable-proxy.png) -{% data reusables.enterprise_management_console.save-settings %} - -{% data reusables.enterprise_clustering.proxy_protocol_ports %} - -#### 在 {% data variables.product.product_location_enterprise %} 上启用 X-Forwarded-For 支持 - -{% data reusables.enterprise_clustering.x-forwarded-for %} - -{% data reusables.enterprise_installation.terminating-tls %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -3. 在 **External load balancers** 下，选择 **Allow HTTP X-Forwarded-For header**。 ![允许 HTTP X-Forwarded-For 标头的复选框](/assets/images/enterprise/management-console/allow-xff.png) -{% data reusables.enterprise_management_console.save-settings %} - -{% data reusables.enterprise_clustering.without_proxy_protocol_ports %} - -### 配置健康状态检查 - -如果预配置的检查在该节点上失败，则状态检查允许负载均衡器停止向未响应的节点发送流量。 如果设备因维护或计划外的故障而离线，负载均衡器可以显示状态页面。 在高可用性 (HA) 配置下，负载均衡器可用作故障转移策略的组成部分。 不过，不支持 HA 对的自动故障转移。 在副本设备开始为请求提供服务之前，您必须手动升级副本设备。 更多信息请参阅“[配置 {% data variables.product.prodname_ghe_server %} 以实现高可用性](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-github-enterprise-server-for-high-availability/)”。 - -{% data reusables.enterprise_clustering.health_checks %} -{% data reusables.enterprise_site_admin_settings.maintenance-mode-status %} diff --git a/translations/zh-CN/content/admin/installation/validating-your-domain-settings.md b/translations/zh-CN/content/admin/installation/validating-your-domain-settings.md deleted file mode 100644 index 31152455b3c8..000000000000 --- a/translations/zh-CN/content/admin/installation/validating-your-domain-settings.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: 验证域设置 -intro: '首次启动 {% data variables.product.product_location_enterprise %} 之前，请确保域设置已正确配置。' -redirect_from: - - /enterprise/admin/installation/validating-your-domain-settings -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.hostname-menu-item %} -4. 要测试设备的 DNS 和 SSL 设置，请单击 **Test domain settings**。 ![测试域设置按钮](/assets/images/enterprise/management-console/test-domain-settings.png) -{% data reusables.enterprise_management_console.test-domain-settings-failure %} -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/zh-CN/content/admin/installation/viewing-push-logs.md b/translations/zh-CN/content/admin/installation/viewing-push-logs.md deleted file mode 100644 index c2179771beb4..000000000000 --- a/translations/zh-CN/content/admin/installation/viewing-push-logs.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: 查看推送日志 -intro: '站点管理员可以查看 {% data variables.product.product_location_enterprise %} 上任何仓库的 Git 推送操作列表。' -redirect_from: - - /enterprise/admin/articles/viewing-push-logs/ - - /enterprise/admin/installation/viewing-push-logs -versions: - enterprise-server: '*' ---- - -推送日志条目会显示： - -- 推送发起人 -- 是否为强制推送 -- 某人推送到的分支 -- 推送所使用的协议 -- 发起的 IP 地址 -- 推送所使用的 Git 客户端 -- 操作前后的 SHA 哈希 - -### 查看仓库的推送日志 - -1. 导航到仓库。 -{% data reusables.enterprise_site_admin_settings.access-settings %} -3. 在页面右上角，单击 {% octicon "shield" aria-label="The shield" %} **Security**。 ![Security 选项卡](/assets/images/enterprise/site-admin-settings/repo/repo-security-top-tab.png) -4. 在左侧边栏中，单击 **Push Log**。 ![Push Log 选项卡](/assets/images/enterprise/site-admin-settings/push-log-tab.png) - -### 在命令行上查看仓库的推送日志 - -1. 通过 SSH 登录您的设备。 更多信息请参阅“[访问管理 shell (SSH)](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-administrative-shell-ssh/)”。 -2. 在相应的 Git 仓库中，打开审核日志文件： - ```shell - ghe-repo owner/repository -c "less audit_log" - ``` diff --git a/translations/zh-CN/content/admin/migrations/about-migrations.md b/translations/zh-CN/content/admin/migrations/about-migrations.md deleted file mode 100644 index 9096bae878af..000000000000 --- a/translations/zh-CN/content/admin/migrations/about-migrations.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: 关于迁移 -intro: '迁移是将数据从*源*位置（{% data variables.product.prodname_dotcom_the_website %} 组织或 {% data variables.product.prodname_ghe_server %} 实例）转移到*目标* {% data variables.product.prodname_ghe_server %} 实例的过程。 在更换平台或或升级实例上的硬件时，可以使用迁移转移数据。' -redirect_from: - - /enterprise/admin/migrations/about-migrations -versions: - enterprise-server: '*' ---- - -### 迁移类型 - -您可以执行三种类型的迁移： - -- 从 {% data variables.product.prodname_ghe_server %} 实例迁移到另一个 {% data variables.product.prodname_ghe_server %} 实例。 您可以迁移实例上由任何用户或组织拥有的任意数量的仓库。 在执行迁移之前，您必须具有两个实例的站点管理员访问权限。 -- 从 {% data variables.product.prodname_dotcom_the_website %} 组织迁移到 {% data variables.product.prodname_ghe_server %} 实例。 您可以迁移由组织拥有的任意数量的仓库。 在执行迁移前，您必须拥有 {% data variables.product.prodname_dotcom_the_website %} 组织的[管理访问权限](/enterprise/user/articles/permission-levels-for-an-organization/)和目标实例的站点管理员访问权限。 -- *试运行*是将数据导入[暂存实例](/enterprise/admin/guides/installation/setting-up-a-staging-instance/)的迁移。 这些试运行非常有用，可用于查看在向 {% data variables.product.product_location_enterprise %} 应用迁移后*将要*发生的变化。 **我们强烈建议您先在暂存实例上执行试运行，然后再将数据导入生产实例。** - -### 迁移的数据 - -在迁移中，一切都围绕仓库进行。 与仓库关联的大多数数据都可以迁移。 例如，组织内的仓库将迁移仓库*和*组织，以及与该仓库关联的任何用户、团队、问题和拉取请求。 - -下表中的项可随仓库一起迁移。 迁移的数据列表中未显示的任何项都无法迁移。 - -{% data reusables.enterprise_migrations.fork-persistence %} - -| 与迁移的仓库关联的数据 | 注： | -| -------------- | --------------------------------------------------------------------------------------------- | -| 用户 | 用户的 **@提及**将重写以匹配目标。 | -| 组织 | 将迁移组织的名称和详细信息。 | -| 仓库 | Git 树、blob、提交和行的链接将重写以匹配目标。 迁移程序将遵循三个仓库重定向的最大值。 | -| Wikis | 将迁移所有 wiki 数据。 | -| 团队 | 团队的 **@提及**将重写以匹配目标。 | -| 里程碑 | 将保留时间戳。 | -| 项目板 | 将迁移与仓库和拥有仓库的组织关联的项目板。 | -| 议题 | 将保留问题引用和时间戳。 | -| 问题评论 | 将针对目标实例重写评论的交叉引用。 | -| 拉取请求 | 将重写拉取请求的交叉引用以匹配目标。 将保留时间戳。 | -| 拉取请求审查 | 将迁移拉取请求审查和关联的数据。 | -| 拉取请求审查评论 | 将针对目标实例重写评论的交叉引用。 将保留时间戳。 | -| 提交注释 | 将针对目标实例重写评论的交叉引用。 将保留时间戳。 | -| 版本发布 | 将迁移所有版本数据。 | -| 在拉取请求或问题上进行的操作 | 将保留对拉取请求或问题的所有修改（例如，分配用户、重命名标题和修改标签）以及每个操作的时间戳。 | -| 文件附件 | 将迁移[问题和拉取请求上的文件附件](/articles/file-attachments-on-issues-and-pull-requests)。 在迁移过程中，您可以选择将此禁用。 | -| Web 挂钩 | 仅迁移有效的 web 挂钩。 | -| 仓库部署密钥 | 将迁移仓库部署密钥。 | -| 受保护分支 | 将迁移受保护分支设置和关联的数据。 | diff --git a/translations/zh-CN/content/admin/migrations/applying-the-imported-data-on-github-enterprise-server.md b/translations/zh-CN/content/admin/migrations/applying-the-imported-data-on-github-enterprise-server.md deleted file mode 100644 index 9f2ba5cd4512..000000000000 --- a/translations/zh-CN/content/admin/migrations/applying-the-imported-data-on-github-enterprise-server.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: 在 GitHub Enterprise Server 上应用导入的数据 -intro: 审查完迁移数据后，您可以向目标实例永久应用变更。 -redirect_from: - - /enterprise/admin/guides/migrations/applying-the-imported-data-on-github-enterprise/ - - /enterprise/admin/migrations/applying-the-imported-data-on-github-enterprise-server -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_installation.ssh-into-target-instance %} - -2. 使用 `ghe-migrator import` 命令启动导入过程。 您需要： - * 迁移 GUID. - * 用于身份验证的个人访问令牌。 您使用的个人访问令牌仅用于站点管理员身份验证，不需要任何特定范围。 For more information, see "[Creating a personal access token](/github/authenticating-to-github/creating-a-personal-access-token)." - - ```shell - $ ghe-migrator import /home/admin/MIGRATION_GUID.tar.gz -g MIGRATION_GUID -u username -p TOKEN - - > Starting GitHub::Migrator - > Import 100% complete / - ``` - - * {% data reusables.enterprise_migrations.specify-staging-path %} diff --git a/translations/zh-CN/content/admin/migrations/completing-the-import-on-github-enterprise-server.md b/translations/zh-CN/content/admin/migrations/completing-the-import-on-github-enterprise-server.md deleted file mode 100644 index 3d152b33a410..000000000000 --- a/translations/zh-CN/content/admin/migrations/completing-the-import-on-github-enterprise-server.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: 在 GitHub Enterprise Server 上完成导入 -intro: 在迁移应用到目标实例并且您已审查迁移后，您需要解锁仓库并将其从源中删除。 我们建议等待两周再删除您的源数据，以便确保所有数据都能按预期运行。 -redirect_from: - - /enterprise/admin/guides/migrations/completing-the-import-on-github-enterprise/ - - /enterprise/admin/migrations/completing-the-import-on-github-enterprise-server -versions: - enterprise-server: '*' ---- - -### 在目标实例上解锁仓库 - -{% data reusables.enterprise_installation.ssh-into-instance %} -{% data reusables.enterprise_migrations.unlocking-on-instances %} - -### 在源上解锁仓库 - -#### 从 {% data variables.product.prodname_dotcom_the_website %} 组织解锁仓库 - -要在 {% data variables.product.prodname_dotcom_the_website %} 组织中解锁仓库，您需要向迁移解锁端点发送 `DELETE` 请求。 您需要： - * 身份验证的访问令牌 - * 迁移的唯一 `id` - * 要解锁的仓库的名称 -```shell -curl -H "Authorization: token GITHUB_ACCESS_TOKEN" -X DELETE \ - -H "Accept: application/vnd.github.wyandotte-preview+json" \ - https://api.github.com/orgs/orgname/migrations/id/repos/repo_name/lock -``` - -#### 从 {% data variables.product.prodname_dotcom_the_website %} 组织删除仓库 - -After unlocking the {% data variables.product.prodname_dotcom_the_website %} organization's repositories, you should delete every repository you previously migrated using [the repository delete endpoint](/enterprise/{{ currentVersion }}/v3/repos/#delete-a-repository). 您需要身份验证的访问令牌： -```shell -curl -H "Authorization: token GITHUB_ACCESS_TOKEN" -X DELETE \ - https://api.github.com/repos/orgname/repo_name -``` - -#### 从 {% data variables.product.prodname_ghe_server %} 实例解锁仓库 - -{% data reusables.enterprise_installation.ssh-into-instance %} -{% data reusables.enterprise_migrations.unlocking-on-instances %} diff --git a/translations/zh-CN/content/admin/migrations/exporting-migration-data-from-github-enterprise-server.md b/translations/zh-CN/content/admin/migrations/exporting-migration-data-from-github-enterprise-server.md deleted file mode 100644 index 95e0f536bc30..000000000000 --- a/translations/zh-CN/content/admin/migrations/exporting-migration-data-from-github-enterprise-server.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: 从 GitHub Enterprise Server 导出迁移数据 -intro: '要从 {% data variables.product.prodname_ghe_server %} 实例导出迁移数据，您需要准备实例，锁定仓库，并生成迁移存档。 如果您计划更换平台或已准备好从试用实例转到生产实例，则应从 {% data variables.product.prodname_ghe_server %} 实例导出数据。' -redirect_from: - - /enterprise/admin/guides/migrations/exporting-migration-data-from-github-enterprise/ - - /enterprise/admin/migrations/exporting-migration-data-from-github-enterprise-server -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/zh-CN/content/admin/migrations/exporting-migration-data-from-githubcom.md b/translations/zh-CN/content/admin/migrations/exporting-migration-data-from-githubcom.md deleted file mode 100644 index 899ccad92922..000000000000 --- a/translations/zh-CN/content/admin/migrations/exporting-migration-data-from-githubcom.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: 从 GitHub.com 导出迁移数据 -intro: '要从 {% data variables.product.prodname_dotcom_the_website %} 组织导出迁移数据，您需要使用 API 选择要迁移的仓库。 之后，您将生成一个可以导入 {% data variables.product.prodname_ghe_server %} 实例的迁移存档。' -redirect_from: - - /enterprise/admin/guides/migrations/exporting-migration-data-from-github-com - - /enterprise/admin/migrations/exporting-migration-data-from-githubcom -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/zh-CN/content/admin/migrations/exporting-the-github-enterprise-server-source-repositories.md b/translations/zh-CN/content/admin/migrations/exporting-the-github-enterprise-server-source-repositories.md deleted file mode 100644 index 216b51cd1ad2..000000000000 --- a/translations/zh-CN/content/admin/migrations/exporting-the-github-enterprise-server-source-repositories.md +++ /dev/null @@ -1,84 +0,0 @@ ---- -title: 导出 GitHub Enterprise Server 源仓库 -intro: 在锁定源仓库后，您可以一次导出一个，或者使用文本文件格式的仓库 URL 列表批量导出。 随后，您可以创建一个迁移存档，用于导入。 -redirect_from: - - /enterprise/admin/guides/migrations/exporting-the-github-enterprise-source-repositories/ - - /enterprise/admin/migrations/exporting-the-github-enterprise-server-source-repositories -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_migrations.locking-repositories %} - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. 要准备需要导出的仓库，请使用 `ghe-migrator add` 命令和仓库的 URL： - * 如果您要锁定仓库，请在命令后附加 `--lock`。 如果您执行的是试运行，则不需要 `--lock`。 - ```shell - $ ghe-migrator add https://hostname/username/reponame --lock - ``` - * 您可以将 `--exclude_attachments` 附加到命令，排除文件附件。 {% data reusables.enterprise_migrations.exclude-file-attachments %} - * 要一次准备多个将导出的仓库，请创建一个文本文件并在单独的行中列出每个仓库 URL，然后运行包含 `-i` 标志和您的文本文件路径的 `ghe-migrator add` 命令。 - ```shell - $ ghe-migrator add -i PATH/TO/YOUR/REPOSITORY_URLS.txt - ``` - -3. 出现提示时，请输入您的 {% data variables.product.prodname_ghe_server %} 用户名： - ```shell - Enter username authorized for migration: admin - ``` -4. 出现输入个人访问令牌的提示时，请输入您在“[准备 {% data variables.product.prodname_ghe_server %} 源实例](/enterprise/admin/guides/migrations/preparing-the-github-enterprise-server-source-instance/)”中创建的访问令牌： - ```shell - Enter personal access token: ************** - ``` -5. 在 `ghe-migrator add` 完成后，它将打印自身生成并用于标识此导出的唯一的“迁移 GUID”以及添加到导出中的资源列表。 在后续的 `ghe-migrator add` 和 `ghe-migrator export` 步骤中，您将使用它生成的迁移 GUID 指示 `ghe-migrator` 继续在同一个导出上操作。 - ```shell - > 101 models added to export - > Migration GUID: example-migration-guid - > Number of records in this migration: - > users | 5 - > organizations | 1 - > repositories | 1 - > teams | 3 - > protected_branches | 1 - > pull_request_reviews | 1 - > milestones | 1 - > issues | 3 - > pull_requests | 5 - > pull_request_review_comments | 4 - > commit_comments | 2 - > issue_comments | 10 - > issue_events | 63 - > releases | 3 - > attachments | 4 - > projects | 2 - ``` - 每次您添加包含现有迁移 GUID 的新仓库时，它都会更新现有导出。 如果您在没有迁移 GUID的情况下再次运行 `ghe-migrator add`，将会启动新的导出并生成新的迁移 GUID。 **开始准备要导入的迁移时，不要再次使用在导出过程中生成的迁移 GUID**。 - -3. 如果您锁定了源仓库，则可以使用 `ghe-migrator target_url` 命令，在链接到仓库新位置的仓库页面上设置自定义锁定消息。 传递源仓库 URL、目标仓库 URL 和第 5 步中的迁移 GUID： - - ```shell - $ ghe-migrator target_url https://hostname/username/reponame https://target_hostname/target_username/target_reponame -g MIGRATION_GUID - ``` - -6. 要向同一个导出添加更多仓库，请使用包含 `-g` 标志的 `ghe-migrator add` 命令。 您需要传入新仓库 URL 和第 5 步中的迁移 GUID： - ```shell - $ ghe-migrator add https://hostname/username/other_reponame -g MIGRATION_GUID --lock - ``` -7. 添加完仓库后，请使用包含 `-g` 标志和第 5 步中的迁移 GUID 的 `ghe-migrator export` 命令生成迁移存档： - ```shell - $ ghe-migrator export -g MIGRATION_GUID - > Archive saved to: /data/github/current/tmp/MIGRATION_GUID.tar.gz - ``` - * {% data reusables.enterprise_migrations.specify-staging-path %} - -8. 关闭与 {% data variables.product.product_location_enterprise %} 的连接： - ```shell - $ exit - > logout - > Connection to hostname closed. - ``` -9. 使用 [`scp`](https://linuxacademy.com/blog/linux/ssh-and-scp-howto-tips-tricks#scp) 命令将迁移存档复制到您的计算机。 存档文件将使用迁移 GUID 命名： - ```shell - $ scp -P 122 admin@hostname:/data/github/current/tmp/MIGRATION_GUID.tar.gz ~/Desktop - ``` -{% data reusables.enterprise_migrations.ready-to-import-migrations %} diff --git a/translations/zh-CN/content/admin/migrations/exporting-the-githubcom-organizations-repositories.md b/translations/zh-CN/content/admin/migrations/exporting-the-githubcom-organizations-repositories.md deleted file mode 100644 index c784e3f996af..000000000000 --- a/translations/zh-CN/content/admin/migrations/exporting-the-githubcom-organizations-repositories.md +++ /dev/null @@ -1,70 +0,0 @@ ---- -title: 导出 GitHub.com 组织的仓库 -intro: 使用 Migrations API，您可以导出组织的仓库。 在导出仓库后，您可以下载能够用于导入过程的迁移存档。 -redirect_from: - - /enterprise/admin/guides/migrations/exporting-the-github-com-organization-s-repositories - - /enterprise/admin/migrations/exporting-the-githubcom-organizations-repositories -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_migrations.fork-persistence %} - -要从 {% data variables.product.prodname_dotcom_the_website %} 导出仓库数据，请使用 Migrations API。 - -Migrations API 目前正处于预览阶段，这意味着端点和参数未来可能发生变化。 要访问 Migrations API，您必须在 `Accept` 标头中提供自定义[媒体类型](/v3/media)：`application/vnd.github.wyandotte-preview+json`。 以下示例包括自定义媒体类型。 - -### 生成迁移存档 - -{% data reusables.enterprise_migrations.locking-repositories %} - -1. 向您的组织的成员发送通知，告诉他们您将执行迁移。 导出可能需要数分钟的时间，具体取决于要导出的仓库数量。 包括导入的完整迁移可能需要数小时的时间，因此我们建议执行试运行，以便确定完整过程所需的时间。 更多信息请参阅“[关于迁移](/enterprise/admin/migrations/about-migrations#types-of-migrations)”。 - -2. 向迁移端点发送 `POST` 请求，开始迁移。 您需要： - * 身份验证的访问令牌。 - * 想要迁移的[仓库列表](/v3/repos/#list-organization-repositories)： - ```shell - curl -H "Authorization: token GITHUB_ACCESS_TOKEN" -X POST \ - -H "Accept: application/vnd.github.wyandotte-preview+json" \ - -d'{"lock_repositories":true,"repositories":["orgname/reponame", "orgname/reponame"]}' \ - https://api.github.com/orgs/orgname/migrations - ``` - * 如果您想在迁移仓库之前先将其锁定，请确保 `lock_repositories` 设为 `true`。 强烈建议执行此操作。 - * 您可以向端点传递 `exclude_attachments: true`，排除文件附件。 {% data reusables.enterprise_migrations.exclude-file-attachments %}存档的最终大小必须小于 20 GB。 - - 此请求将返回一个独一无二的 `id`，用于表示您的迁移。 后续调用 Migrations API 时需要使用此 id。 - -3. 向迁移状态端点发送 `GET` 请求以提取迁移的状态。 您需要： - * 身份验证的访问令牌。 - * 迁移的唯一 `id`： - ```shell - curl -H "Authorization: token GITHUB_ACCESS_TOKEN" \ - -H "Accept: application/vnd.github.wyandotte-preview+json" \ - https://api.github.com/orgs/orgname/migrations/id - ``` - - 迁移可能处于以下状态之一： - * `pending`，表示迁移尚未开始。 - * `exporting`，表示迁移正在进行。 - * `exported`，表示迁移已成功完成。 - * `failed`，表示迁移失败。 - -4. 在导出您的迁移后，请向迁移下载端点发送 `GET` 请求，下载迁移存档。 您需要： - * 身份验证的访问令牌。 - * 迁移的唯一 `id`： - ```shell - curl -H "Accept: application/vnd.github.wyandotte-preview+json" \ - -u GITHUB_USERNAME:GITHUB_ACCESS_TOKEN \ - -L -o migration_archive.tar.gz \ - https://api.github.com/orgs/orgname/migrations/id/archive - ``` - -5. 迁移存档将在七天后自动删除。 如果您更喜欢提前删除，可以向迁移存档删除端点发送 `DELETE` 请求。 您需要： - * 身份验证的访问令牌。 - * 迁移的唯一 `id`： - ```shell - curl -H "Authorization: token GITHUB_ACCESS_TOKEN" -X DELETE \ - -H "Accept: application/vnd.github.wyandotte-preview+json" \ - https://api.github.com/orgs/orgname/migrations/id/archive - ``` -{% data reusables.enterprise_migrations.ready-to-import-migrations %} diff --git a/translations/zh-CN/content/admin/migrations/generating-a-list-of-migration-conflicts.md b/translations/zh-CN/content/admin/migrations/generating-a-list-of-migration-conflicts.md deleted file mode 100644 index 9fe23d6bc3e7..000000000000 --- a/translations/zh-CN/content/admin/migrations/generating-a-list-of-migration-conflicts.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: 生成迁移冲突列表 -intro: 如果 `ghe-migrator` 在准备要导入的数据时报告冲突，您必须先生成这些冲突的列表，然后再准备使用自定义映射加以解决。 -redirect_from: - - /enterprise/admin/migrations/generating-a-list-of-migration-conflicts -versions: - enterprise-server: '*' ---- - -1. 使用包含迁移 GUID 的 `ghe-migrator conflicts` 命令生成一个 *conflicts.csv* 文件： - ```shell - $ ghe-migrator conflicts -g MIGRATION_GUID > conflicts.csv - ``` - - 如果未报告冲突，您可以按照“[在 {% data variables.product.prodname_ghe_server %} 上应用导入的数据](/enterprise/admin/guides/migrations/applying-the-imported-data-on-github-enterprise-server/)”中的步骤操作，安全地导入数据。 -2. 如果存在冲突，请使用 [`scp`](https://linuxacademy.com/blog/linux/ssh-and-scp-howto-tips-tricks#scp) 命令将 *conflicts.csv* 复制到您的本地计算机： - ```shell - $ scp -P 122 admin@hostname:conflicts.csv ~/Desktop - ``` -3. 继续“[解决迁移冲突或设置自定义映射](/enterprise/admin/guides/migrations/resolving-migration-conflicts-or-setting-up-custom-mappings/)”。 diff --git a/translations/zh-CN/content/admin/migrations/importing-data-from-third-party-version-control-systems.md b/translations/zh-CN/content/admin/migrations/importing-data-from-third-party-version-control-systems.md deleted file mode 100644 index d030fd1022c4..000000000000 --- a/translations/zh-CN/content/admin/migrations/importing-data-from-third-party-version-control-systems.md +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: 从第三方版本控制系统导入数据 -intro: '使用工具的 git-import 套件，您可以将数据从 Subversion、Mercurial 和 Team Foundation Version Control 导入 {% data variables.product.prodname_ghe_server %} 上的 Git 仓库。' -redirect_from: - - /enterprise/admin/migrations/importing-data-from-third-party-version-control-systems -versions: - enterprise-server: '*' ---- - -### 从 Mercurial 导入项目 - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. 使用以下命令对项目进行原始克隆，并指定源项目的 URL 和临时仓库的路径： - ```shell - $ git-import-hg-raw HG-CLONE-URL /PATH/REPO-NAME.git - # Creates a new repository with one or more Git refs in "refs/import/" in the specified path. - ``` -{% data reusables.enterprise_migrations.review-the-import-csv %} -4. 使用 CSV 文件重写作者和分支： - ```shell - $ git-import-rewrite --flavor hg --authors /PATH/AUTHORS-MAP-FILE.csv /PATH/REPO-NAME.git - ``` -5. 如果您还没有创建，请[在 {% data variables.product.prodname_ghe_server %} 上创建新的空仓库](/enterprise/{{ currentVersion }}/user/articles/creating-a-new-repository)。 -{% data reusables.command_line.switching_directories_procedural %} -7. 将导入的仓库推送到 {% data variables.product.prodname_ghe_server %}： - ```shell - $ git push --mirror PUSH-URL-ON-GITHUB-ENTERPRISE - ``` - -### 从 Subversion 导入项目 - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. 使用以下命令对项目进行原始克隆，并指定源项目的 URL 和临时仓库的路径： - ```shell - $ git-import-svn-raw SVN-CLONE-URL /PATH/REPO-NAME.git - # Creates a new repository with one or more Git refs in "refs/import/" in the specified path. - ``` -{% data reusables.enterprise_migrations.review-the-import-csv %} -4. 使用 CSV 文件重写作者和分支： - ```shell - $ git-import-rewrite --flavor svn --authors /PATH/AUTHORS-MAP-FILE.csv /PATH/REPO-NAME.git - ``` -5. 如果您还没有创建，请[在 {% data variables.product.prodname_ghe_server %} 上创建新的空仓库](/enterprise/{{ currentVersion }}/user/articles/creating-a-new-repository)。 -{% data reusables.command_line.switching_directories_procedural %} -7. 将导入的仓库推送到 {% data variables.product.prodname_ghe_server %}： - ```shell - $ git push --mirror PUSH-URL-ON-GITHUB-ENTERPRISE - ``` - -### 从 Team Foundation Version Control 导入项目 - -{% data reusables.enterprise_installation.ssh-into-instance %} -2. 使用以下命令对项目进行原始克隆，并指定源项目的 URL 和临时仓库的路径： - ```shell - $ git-import-tfs-raw TEAM-FOUNDATION-CLONE-URL /PATH/REPO-NAME.git - # Creates a new repository with one or more Git refs in "refs/import/" in the specified path. - ``` -{% data reusables.enterprise_migrations.review-the-import-csv %} -4. 使用 CSV 文件重写作者和分支： - ```shell - $ git-import-rewrite --flavor tfs --authors /PATH/AUTHORS-MAP-FILE.csv /PATH/REPO-NAME.git - ``` -5. 如果您还没有创建，请[在 {% data variables.product.prodname_ghe_server %} 上创建新的空仓库](/enterprise/{{ currentVersion }}/user/articles/creating-a-new-repository)。 -{% data reusables.command_line.switching_directories_procedural %} -7. 将导入的仓库推送到 {% data variables.product.prodname_ghe_server %}： - ```shell - $ git push --mirror PUSH-URL-ON-GITHUB-ENTERPRISE - ``` - -### 延伸阅读 - -- "[Command-line-utilities](/enterprise/{{ currentVersion }}/admin/guides/installation/command-line-utilities/#import-and-export)" diff --git a/translations/zh-CN/content/admin/migrations/importing-migration-data-to-github-enterprise-server.md b/translations/zh-CN/content/admin/migrations/importing-migration-data-to-github-enterprise-server.md deleted file mode 100644 index b0cad855dfc7..000000000000 --- a/translations/zh-CN/content/admin/migrations/importing-migration-data-to-github-enterprise-server.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: 将迁移数据导入 GitHub Enterprise Server -intro: '生成迁移存档后，您可以将数据导入目标 {% data variables.product.prodname_ghe_server %} 实例。 在将变更永久应用到目标实例之前，您需要检查变更，查看有无潜在的冲突。' -redirect_from: - - /enterprise/admin/guides/migrations/importing-migration-data-to-github-enterprise/ - - /enterprise/admin/migrations/importing-migration-data-to-github-enterprise-server -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/zh-CN/content/admin/migrations/index.md b/translations/zh-CN/content/admin/migrations/index.md deleted file mode 100644 index 389a0d710a97..000000000000 --- a/translations/zh-CN/content/admin/migrations/index.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: 迁移用户、组织和仓库数据 -shortTitle: 迁移数据 -intro: '您可以从 {% data variables.product.prodname_ghe_server %} 或 {% data variables.product.prodname_dotcom_the_website %} 导出用户、组织和仓库数据，然后将此数据导入至 {% data variables.product.product_location_enterprise %}。' -redirect_from: - - /enterprise/admin/articles/moving-a-repository-from-github-com-to-github-enterprise/ - - /enterprise/admin/categories/migrations-and-upgrades/ - - /enterprise/admin/migrations -versions: - enterprise-server: '*' ---- - - -### 目录 - -{% topic_link_in_list /overview %} - {% link_in_list /about-migrations %} -{% topic_link_in_list /exporting-migration-data-from-github-enterprise-server %} - {% link_in_list /preparing-the-github-enterprise-server-source-instance %} - {% link_in_list /exporting-the-github-enterprise-server-source-repositories %} -{% topic_link_in_list /exporting-migration-data-from-githubcom %} - {% link_in_list /preparing-the-githubcom-source-organization %} - {% link_in_list /exporting-the-githubcom-organizations-repositories %} -{% topic_link_in_list /importing-migration-data-to-github-enterprise-server %} - {% link_in_list /preparing-the-migrated-data-for-import-to-github-enterprise-server %} - {% link_in_list /generating-a-list-of-migration-conflicts %} - {% link_in_list /reviewing-migration-conflicts %} - {% link_in_list /resolving-migration-conflicts-or-setting-up-custom-mappings %} - {% link_in_list /applying-the-imported-data-on-github-enterprise-server %} - {% link_in_list /reviewing-migration-data %} - {% link_in_list /completing-the-import-on-github-enterprise-server %} - {% link_in_list /importing-data-from-third-party-version-control-systems %} diff --git a/translations/zh-CN/content/admin/migrations/overview.md b/translations/zh-CN/content/admin/migrations/overview.md deleted file mode 100644 index aa56e8065744..000000000000 --- a/translations/zh-CN/content/admin/migrations/overview.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: 概览 -intro: '了解如何将数据迁移至 {% data variables.product.product_location_enterprise %}。' -mapTopic: true -redirect_from: - - /enterprise/admin/migrations/overview -versions: - enterprise-server: '*' ---- - diff --git a/translations/zh-CN/content/admin/migrations/preparing-the-github-enterprise-server-source-instance.md b/translations/zh-CN/content/admin/migrations/preparing-the-github-enterprise-server-source-instance.md deleted file mode 100644 index d810e780202e..000000000000 --- a/translations/zh-CN/content/admin/migrations/preparing-the-github-enterprise-server-source-instance.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: 准备 GitHub Enterprise Server 源实例 -intro: '在从 {% data variables.product.prodname_ghe_server %} 迁移数据之前，请确保您具有实例的适当身份验证和管理权限。' -redirect_from: - - /enterprise/admin/guides/migrations/preparing-the-github-enterprise-source-instance/ - - /enterprise/admin/migrations/preparing-the-github-enterprise-server-source-instance -versions: - enterprise-server: '*' ---- - -1. 验证您在 {% data variables.product.prodname_ghe_server %} 源上是站点管理员。 最好的方式是验证您可以[通过 SSH 访问实例](/enterprise/admin/guides/installation/accessing-the-administrative-shell-ssh/)。 - -2. 在 {% data variables.product.prodname_ghe_server %} 源实例上{% data reusables.enterprise_migrations.token-generation %}。 - -{% data reusables.enterprise_migrations.make-a-list %} diff --git a/translations/zh-CN/content/admin/migrations/preparing-the-githubcom-source-organization.md b/translations/zh-CN/content/admin/migrations/preparing-the-githubcom-source-organization.md deleted file mode 100644 index d5933c3eb47d..000000000000 --- a/translations/zh-CN/content/admin/migrations/preparing-the-githubcom-source-organization.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: 准备 GitHub.com 源组织 -intro: '在从 {% data variables.product.prodname_dotcom_the_website %} 组织迁移仓库之前，请确保您有适当的身份验证和管理权限。' -redirect_from: - - /enterprise/admin/guides/migrations/preparing-the-github-com-source-organization - - /enterprise/admin/migrations/preparing-the-githubcom-source-organization -versions: - enterprise-server: '*' ---- - -1. 确保您在源组织的仓库上具有[所有者权限](/articles/permission-levels-for-an-organization/)。 - -2. 在 {% data variables.product.prodname_dotcom_the_website %} 上{% data reusables.enterprise_migrations.token-generation %} - -{% data reusables.enterprise_migrations.make-a-list %} diff --git a/translations/zh-CN/content/admin/migrations/preparing-the-migrated-data-for-import-to-github-enterprise-server.md b/translations/zh-CN/content/admin/migrations/preparing-the-migrated-data-for-import-to-github-enterprise-server.md deleted file mode 100644 index 91b97c289a61..000000000000 --- a/translations/zh-CN/content/admin/migrations/preparing-the-migrated-data-for-import-to-github-enterprise-server.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: 准备要导入 GitHub Enterprise Server 的迁移数据 -intro: 在将迁移的数据应用到您的目标实例之前，您需要将迁移存档复制到目标实例，并针对导入进行准备。 -redirect_from: - - /enterprise/admin/guides/migrations/preparing-the-migrated-data-for-import-to-github-enterprise/ - - /enterprise/admin/migrations/preparing-the-migrated-data-for-import-to-github-enterprise-server -versions: - enterprise-server: '*' ---- - -1. 使用 [`scp`](https://linuxacademy.com/blog/linux/ssh-and-scp-howto-tips-tricks#scp) 命令将从源实例或组织生成的迁移存档复制到 {% data variables.product.prodname_ghe_server %} 目标： - - ```shell - $ scp -P 122 /path/to/archive/MIGRATION_GUID.tar.gz admin@hostname:/home/admin/ - ``` - -{% data reusables.enterprise_installation.ssh-into-target-instance %} - -3. 使用 `ghe-migrator prepare` 命令准备要在目标实例上导入的存档，并生成新的迁移 GUID 供您在后续步骤中使用： - - ```shell - ghe-migrator prepare /home/admin/MIGRATION_GUID.tar.gz - ``` - - * 要开始新的导入尝试，请再次运行 `ghe-migrator prepare` 并获取新的迁移 GUID。 - * {% data reusables.enterprise_migrations.specify-staging-path %} diff --git a/translations/zh-CN/content/admin/migrations/resolving-migration-conflicts-or-setting-up-custom-mappings.md b/translations/zh-CN/content/admin/migrations/resolving-migration-conflicts-or-setting-up-custom-mappings.md deleted file mode 100644 index 71cb6b158d23..000000000000 --- a/translations/zh-CN/content/admin/migrations/resolving-migration-conflicts-or-setting-up-custom-mappings.md +++ /dev/null @@ -1,70 +0,0 @@ ---- -title: 解决迁移冲突或设置自定义映射 -intro: 在导入迁移数据之前，您可以进行修改以解决冲突、重命名传入的记录或将传入的记录映射到现有记录。 -redirect_from: - - /enterprise/admin/migrations/resolving-migration-conflicts-or-setting-up-custom-mappings -versions: - enterprise-server: '*' ---- - -以下步骤可用于解决冲突或向迁移添加自定义映射。 - -### 解决冲突 - -如果您认为 `ghe-migrator` 将执行不正确的变更，可以更改 *conflicts.csv* 中的数据，进行修改。 您可以更改 *conflicts.csv* 中的任意行。 - -例如，我们假设您注意到源中的 `octocat` 用户正在被映射到目标上的 `octocat`： - -| `model_name` | `source_url` | `target_url` | `recommended_action` | -| ------------ | ----------------------------------- | ----------------------------------- | -------------------- | -| `用户` | `https://example-gh.source/octocat` | `https://example-gh.target/octocat` | `map` | - -您可以选择将用户映射到目标上的其他用户。 假设您知道 `octocat` 在目标上应当是 `monalisa`。 您可以更改 *conflicts.csv* 中的 `target_url` 列以指代 `monalisa`： - -| `model_name` | `source_url` | `target_url` | `recommended_action` | -| ------------ | ----------------------------------- | ------------------------------------ | -------------------- | -| `用户` | `https://example-gh.source/octocat` | `https://example-gh.target/monalisa` | `map` | - -另外，如果您想在目标实例上将 `octo-org/widgets` 仓库重命名为 `octo-org/amazing-widgets`，请将 `target_url` 更改为 `octo-org/amazing-widgets`，以及将 `recommend_action` 更改为 `rename`： - -| `model_name` | `source_url` | `target_url` | `recommended_action` | -| ------------ | -------------------------------------------- | ---------------------------------------------------- | -------------------- | -| `仓库` | `https://example-gh.source/octo-org/widgets` | `https://example-gh.target/octo-org/amazing-widgets` | `rename` | - -### 添加自定义映射 - -迁移过程中一个常见的情况是，迁移用户的用户名在目标上与在源上不同。 - -如果拥有源中的用户名列表和目标上的用户名列表，您可以通过自定义映射构建一个 CSV 文件，然后应用此文件，确保迁移结束时每个用户的用户名和内容都有正确的映射。 - -您可以使用 [`ghe-migrator audit`](/enterprise/admin/guides/migrations/reviewing-migration-data) 命令，快速生成应用自定义映射所需的迁移用户的 CSV 文件： - -```shell -$ ghe-migrator audit -m user -g MIGRATION_GUID > users.csv -``` - -现在，您可以编辑该 CSV，并为您想要映射或重命名的每个用户输入新的 URL，然后根据需要将第四列更新为 `map` 或 `rename`。 - -例如，要在目标 `https://example-gh.target` 上将用户 `octocat` 重命名为 `monalisa`，您需要创建一个包含以下内容的行： - -| `model_name` | `source_url` | `target_url` | `state` | -| ------------ | ----------------------------------- | ------------------------------------ | -------- | -| `用户` | `https://example-gh.source/octocat` | `https://example-gh.target/monalisa` | `rename` | - -可以使用相同的流程为支持自定义映射的每个记录创建映射。 更多信息请参见[记录的可能映射表](/enterprise/admin/guides/migrations/reviewing-migration-conflicts#possible-mappings-for-each-record-type)。 - -### 应用修改的迁移数据 - -1. 进行更改后，请使用 [`scp`](https://linuxacademy.com/blog/linux/ssh-and-scp-howto-tips-tricks#scp) 命令将修改后的 *conflicts.csv*（或格式正确的任何其他映射 csv）应用到目标实例： - - ```shell - $ scp -P 122 ~/Desktop/conflicts.csv admin@hostname:/home/admin/ - ``` - -2. 使用 `ghe-migrator map` 命令重新映射迁移数据，并传入修改后的 csv 文件的路径和迁移 GUID： - - ```shell - $ ghe-migrator map -i conflicts.csv -g MIGRATION_GUID - ``` - -3. 如果 `ghe-migrator map -i conflicts.csv -g MIGRATION_GUID` 命令报告冲突仍然存在，请重新运行迁移冲突解决流程。 diff --git a/translations/zh-CN/content/admin/migrations/reviewing-migration-conflicts.md b/translations/zh-CN/content/admin/migrations/reviewing-migration-conflicts.md deleted file mode 100644 index 3135b823831c..000000000000 --- a/translations/zh-CN/content/admin/migrations/reviewing-migration-conflicts.md +++ /dev/null @@ -1,43 +0,0 @@ ---- -title: 检查迁移冲突 -intro: 在生成迁移冲突列表后，您应当进行检查，以确保您同意解决冲突时将发生默认操作 `ghe-migrator`。 -redirect_from: - - /enterprise/admin/migrations/reviewing-migration-conflicts -versions: - enterprise-server: '*' ---- - -1. 使用文本编辑器或[与 CSV 兼容的电子表格软件](https://en.wikipedia.org/wiki/Comma-separated_values#Application_support)打开 *conflicts.csv*。 -2. 按照示例中的指导和下面的参考表检查 *conflicts.csv* 文件，确保导入时将发生正确的操作。 - -*conflicts.csv* 文件包含冲突的*迁移映射*和建议操作。 迁移映射列出了数据的迁移来源和数据应用到目标的方式。 - -| `model_name` | `source_url` | `target_url` | `recommended_action` | -| ------------ | ------------------------------------------------------ | ------------------------------------------------------ | -------------------- | -| `用户` | `https://example-gh.source/octocat` | `https://example-gh.target/octocat` | `map` | -| `组织` | `https://example-gh.source/octo-org` | `https://example-gh.target/octo-org` | `map` | -| `仓库` | `https://example-gh.source/octo-org/widgets` | `https://example-gh.target/octo-org/widgets` | `rename` | -| `团队` | `https://example-gh.source/orgs/octo-org/teams/admins` | `https://example-gh.target/orgs/octo-org/teams/admins` | `合并` | - -*conflicts.csv* 中的每一行都提供了以下信息： - -| 名称 | Description | -| -------------------- | ----------------------------- | -| `model_name` | 正在更改的数据的类型。 | -| `source_url` | 数据的源 URL。 | -| `target_url` | 数据的预期目标 URL。 | -| `recommended_action` | 导入数据时，将发生首选操作 `ghe-migrator`。 | - -### 每个记录类型的可能映射 - -转移数据时，`ghe-migrator` 可以进行多种不同的映射操作： - -| `action` | 描述 | 适用的模型 | -| --------------- | ----------------------------- | -------- | -| `import` | （默认）源中的数据将导入目标。 | 所有记录类型 | -| `map` | 源中的数据将被目标上的现有数据替换。 | 用户、组织和仓库 | -| `rename` | 源中的数据将重命名，然后复制到目标。 | 用户、组织和仓库 | -| `map_or_rename` | 如果存在目标，请映射到该目标。 否则，请重命名导入的模型。 | 用户 | -| `合并` | 源中的数据将与目标中的现有数据合并。 | 团队 | - -**我们强烈建议您检查 *conflicts.csv* 文件并使用 [`ghe-migrator audit`](/enterprise/admin/guides/migrations/reviewing-migration-data)，以便确保进行正确的操作。**如果一切正常，您可以继续“[在 {% data variables.product.prodname_ghe_server %} 上应用导入的数据](/enterprise/admin/guides/migrations/applying-the-imported-data-on-github-enterprise-server)”。 diff --git a/translations/zh-CN/content/admin/migrations/reviewing-migration-data.md b/translations/zh-CN/content/admin/migrations/reviewing-migration-data.md deleted file mode 100644 index 324e1c7b188d..000000000000 --- a/translations/zh-CN/content/admin/migrations/reviewing-migration-data.md +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: 检查迁移数据 -intro: 在迁移的每一步后，您都可以检查迁移数据的状态。 您将能够确保记录正确映射或重命名，在导入步骤后为记录获取新的 url，以及列出迁移失败的任何记录。 -redirect_from: - - '/enterprise/{{ currentVersion }}/admin/guides/migrations/reviewing-the-imported-data/' - - /enterprise/admin/migrations/reviewing-migration-data -versions: - enterprise-server: '*' ---- - -默认情况下，`ghe-migrator audit` 将返回每一条记录。 它还可以让您按以下方式筛选记录： - - * 记录的类型。 - * 记录的状态。 - -记录类型与[迁移的数据](/enterprise/admin/guides/migrations/about-migrations/#migrated-data)中的类型匹配。 - -### 记录类型筛选器 - -| 记录类型 | 筛选器名称 | -| -------------- | ----------------------------- | -| 用户 | `用户` | -| 组织 | `组织` | -| 仓库 | `仓库` | -| 团队 | `团队` | -| 里程碑 | `里程碑` | -| 项目板 | `project` | -| 议题 | `议题` | -| 问题评论 | `issue_comment` | -| 拉取请求 | `pull_request` | -| 拉取请求审查 | `pull_request_review` | -| 提交注释 | `commit_comment` | -| 拉取请求审查评论 | `pull_request_review_comment` | -| 版本发布 | `发行版` | -| 在拉取请求或问题上进行的操作 | `issue_event` | -| 受保护分支 | `protected_branch` | - -### 记录状态筛选器 - -| 记录状态 | Description | -| --------------- | ----------- | -| `export` | 将导出记录。 | -| `import` | 将导入记录。 | -| `map` | 将映射记录。 | -| `rename` | 将重命名记录。 | -| `合并` | 将合并记录。 | -| `exported` | 已成功导出记录。 | -| `imported` | 已成功导入记录。 | -| `mapped` | 已成功映射记录。 | -| `renamed` | 已成功重命名记录。 | -| `merged` | 已成功合并记录。 | -| `failed_export` | 记录导出失败。 | -| `failed_import` | 记录导入失败。 | -| `failed_map` | 记录映射失败。 | -| `failed_rename` | 记录重命名失败。 | -| `failed_merge` | 记录合并失败。 | - -### 筛选审核的记录 - -借助 `ghe-migrator audit` 命令，您可以使用 `-m` 标志基于记录类型进行筛选。 类似地，您可以使用 `-s` 标志基于导入状态进行筛选。 命令如下所示： - -```shell -$ ghe-migrator audit -m RECORD_TYPE -s STATE -g MIGRATION_GUID -``` - -例如，要查看每个成功导入的组织和团队，您可以输入： -```shell -$ ghe-migrator audit -m organization,team -s mapped,renamed -g MIGRATION_GUID -> model_name,source_url,target_url,state -> organization,https://gh.source/octo-org/,https://ghe.target/octo-org/,renamed -``` - -**我们强烈建议您检查失败的每个导入。**要进行检查，您可以输入： -```shell -$ ghe-migrator audit -s failed_import,failed_map,failed_rename,failed_merge -g MIGRATION_GUID -> model_name,source_url,target_url,state -> user,https://gh.source/octocat,https://gh.target/octocat,failed -> repository,https://gh.source/octo-org/octo-project,https://ghe.target/octo-org/octo-project,failed -``` - -如果您对失败的导入有任何疑问，请联系 {% data variables.contact.contact_ent_support %}。 diff --git a/translations/zh-CN/content/admin/user-management/about-global-webhooks.md b/translations/zh-CN/content/admin/user-management/about-global-webhooks.md deleted file mode 100644 index 3c5a4484c156..000000000000 --- a/translations/zh-CN/content/admin/user-management/about-global-webhooks.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: 关于全局 web 挂钩 -intro: 全局 web 挂钩会通知您实例级别的事件。 -redirect_from: - - /enterprise/admin/user-management/about-global-webhooks -versions: - enterprise-server: '*' ---- - -您可以使用全局 web 挂钩自动监视、响应或者为实例上的用户和组织管理强制执行规则。 例如，您可以将 web 挂钩配置为在以下情况下执行： -- 创建或删除用户帐户 -- 创建或删除组织 -- 向仓库添加协作者或从仓库中移除协作者 -- 分叉仓库 - -![全局 web 挂钩列表](/assets/images/enterprise/site-admin-settings/list-of-global-webhooks.png) - -有关配置 web 挂钩的更多信息，请参阅“[管理全局 web 挂钩](/enterprise/{{ currentVersion }}/admin/guides/user-management/managing-global-webhooks)”。 - -{% data reusables.enterprise_user_management.manage-global-webhooks-api %} diff --git a/translations/zh-CN/content/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories.md b/translations/zh-CN/content/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories.md deleted file mode 100644 index 96cd72033b9e..000000000000 --- a/translations/zh-CN/content/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: 允许管理员启用对公共仓库的匿名 Git 读取权限 -intro: '为了简化自定义工具在您的实例上的使用和绕过身份验证要求，您可以允许仓库管理员启用对 {% data variables.product.product_location_enterprise %} 上公共仓库的匿名 Git 读取权限。' -redirect_from: - - /enterprise/admin/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_user_management.disclaimer-for-git-read-access %} - -如果已启用私有模式，您可以允许仓库管理员启用对 {% data variables.product.product_location_enterprise %} 上公共仓库的匿名 Git 读取权限。 有关私有模式的更多信息，请参阅“[启用私有模式](/enterprise/{{ currentVersion }}/admin/guides/installation/enabling-private-mode/)”。 - -允许匿名 Git 读取权限使您能够在实例上为自定义工具绕过身份验证。 当您或仓库管理员为仓库启用此权限设置时，未经过身份验证的 Git 操作（和具有 {% data variables.product.prodname_ghe_server %} 的网络访问权限的任何人）将获得仓库的读取权限（无需身份验证）。 - -您还可以阻止仓库管理员更改 {% data variables.product.product_location_enterprise %} 上所有仓库或特定仓库的匿名 Git 访问设置。 更多信息请参阅“[阻止用户更改匿名 Git 读取权限](/enterprise/{{ currentVersion }}/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access)”。 - -{% data reusables.enterprise_site_admin_settings.list-of-repos-with-anonymous-git-read-access-enabled %} - -{% data reusables.enterprise_user_management.exceptions-for-enabling-anonymous-git-read-access %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -4. 在“Anonymous Git read access”下，使用下列菜单并单击 **Enabled**。 ![匿名 Git 读取权限下拉菜单显示菜单选项"Enabled（已启用）"和"Disabled（已禁用）"](/assets/images/enterprise/site-admin-settings/enable-anonymous-git-read-access.png) -3. 或者，如果要阻止仓库管理员为实例上的所有仓库更改匿名 Git 读取权限设置，请选择 **Prevent repository admins from changing anonymous Git read access**。 ![选中复选框可阻止仓库管理员更改实例上所有仓库的匿名 Git 读取权限设置。](/assets/images/enterprise/site-admin-settings/globally-lock-repos-from-changing-anonymous-git-read-access.png) - -### 为特定仓库启用匿名 Git 读取权限 - -{% data reusables.enterprise_user_management.exceptions-for-enabling-anonymous-git-read-access %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -6. 在“Danger Zone”下的“Enable Anonymous Git read access”旁，请单击 **Enable**。 ![仓库站点管理员设置的危险区域中“Enable anonymous Git read access”下的“Enabled”按钮 ](/assets/images/enterprise/site-admin-settings/site-admin-enable-anonymous-git-read-access.png) -7. 审查更改。 要确认，请单击 **Yes, enable anonymous Git read access（是，启用匿名 Git 读取权限）**。 ![在弹出窗口中确认匿名 Git 读取权限设置](/assets/images/enterprise/site-admin-settings/confirm-anonymous-git-read-access-for-specific-repo-as-site-admin.png) -8. 或者，如果要阻止仓库管理员为此仓库更改设置，请选择 **Prevent repository admins from changing anonymous Git read access**。 ![选中复选框可阻止仓库管理员更改此仓库的匿名 Git 读取权限。](/assets/images/enterprise/site-admin-settings/lock_anonymous_git_access_for_specific_repo.png) diff --git a/translations/zh-CN/content/admin/user-management/allowing-built-in-authentication-for-users-outside-your-identity-provider.md b/translations/zh-CN/content/admin/user-management/allowing-built-in-authentication-for-users-outside-your-identity-provider.md deleted file mode 100644 index 48d67cb2f187..000000000000 --- a/translations/zh-CN/content/admin/user-management/allowing-built-in-authentication-for-users-outside-your-identity-provider.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: 允许对身份提供程序覆盖范围以外的用户进行内置身份验证 -intro: 您可以配置内置身份验证，为无法访问使用 LDAP、SAML 或 CAS 的身份提供程序的用户验证身份。 -redirect_from: - - /enterprise/admin/user-management/allowing-built-in-authentication-for-users-outside-your-identity-provider -versions: - enterprise-server: '*' ---- - -### 关于对您的身份提供程序覆盖范围外的用户进行内置身份验证 - -在无法将特定帐户（例如，合同工或计算机用户的帐户）添加到身份提供程序 (IdP) 时，您可以为外部用户使用内置身份验证。 如果无法使用身份提供程序，您还可以使用内置身份验证来访问回退帐户。 - -内置身份验证配置完成且用户使用 SAML 或 CAS 成功地进行身份验证后，他们将无法使用用户名和密码进行身份验证。 如果用户使用 LDAP 成功地完成身份验证，凭据将不再被视为内部凭据。 - -在默认情况下，特定 IdP 的内置身份验证处于禁用状态。 - -{% warning %} - -**警告**：如果您禁用内置身份验证，则必须单独挂起不应具有实例访问权限的任何用户。 更多信息请参阅“[挂起和取消挂起用户](/enterprise/{{ currentVersion }}/admin/guides/user-management/suspending-and-unsuspending-users)”。 - -{% endwarning %} - -### 为您的身份提供程序覆盖范围外的用户配置内置身份验证 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.authentication %} -4. 选择身份提供程序。![选择身份提供程序选项](/assets/images/enterprise/management-console/identity-provider-select.gif) -5. 选择 **Allow creation of accounts with built-in authentication**。 ![选择内置身份验证选项](/assets/images/enterprise/management-console/built-in-auth-identity-provider-select.png) -6. 阅读警告，然后单击 **Ok**。 - -{% data reusables.enterprise_user_management.two_factor_auth_header %} -{% data reusables.enterprise_user_management.2fa_is_available %} - -### 邀请您的身份提供程序覆盖范围外的用户在您的实例上进行身份验证 - -在用户接受邀请后，他们可以使用用户名和密码登录，无需通过 IdP。 - -{% data reusables.enterprise_site_admin_settings.sign-in %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.invite-user-sidebar-tab %} -{% data reusables.enterprise_site_admin_settings.invite-user-reset-link %} - -### 延伸阅读 - -- "[使用 LDAP](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-ldap)" -- "[使用 SAML](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-saml)" -- "[使用 CAS](/enterprise/{{ currentVersion }}/admin/guides/user-management/using-cas)" diff --git a/translations/zh-CN/content/admin/user-management/archiving-and-unarchiving-repositories.md b/translations/zh-CN/content/admin/user-management/archiving-and-unarchiving-repositories.md deleted file mode 100644 index c042c68c0f44..000000000000 --- a/translations/zh-CN/content/admin/user-management/archiving-and-unarchiving-repositories.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: 存档和取消存档仓库 -intro: 作为站点管理员，您可以在站点管理员仪表板中存档或取消存档仓库。 -redirect_from: - - /enterprise/admin/articles/archiving-and-unarchiving-repositories/ - - /enterprise/admin/user-management/archiving-and-unarchiving-repositories -versions: - enterprise-server: '*' ---- - -### 存档仓库 -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -5. 在 Danger Zone 下，单击 **Archive**。 ![Archive 按钮](/assets/images/enterprise/site-admin-settings/repo-archive.png) -6. 单击 **Archive repository** ![Archive repository 按钮](/assets/images/enterprise/site-admin-settings/repo-archive-confirm.png) - -### 取消存档仓库 -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -5. 在 Danger Zone 下，单击 **Unarchive**。 ![Archive 按钮](/assets/images/enterprise/site-admin-settings/repo-unarchive.png) -6. 单击 **Unarchive repository** ![Archive repository 按钮](/assets/images/enterprise/site-admin-settings/repo-unarchive-confirm.png) - -### 延伸阅读 -- "[关于存档仓库](/enterprise/{{ currentVersion }}/user/articles/about-archiving-repositories)" diff --git a/translations/zh-CN/content/admin/user-management/authenticating-users-for-your-github-enterprise-server-instance.md b/translations/zh-CN/content/admin/user-management/authenticating-users-for-your-github-enterprise-server-instance.md deleted file mode 100644 index 581f6d185cfa..000000000000 --- a/translations/zh-CN/content/admin/user-management/authenticating-users-for-your-github-enterprise-server-instance.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: 为您的 GitHub Enterprise Server 实例验证用户身份 -intro: '您可以使用 {% data variables.product.prodname_ghe_server %} 的内置身份验证，或者在 CAS、LDAP 或 SAML 中选择来集成您的现有帐户并集中管理 {% data variables.product.product_location_enterprise %} 的用户访问权限。' -redirect_from: - - /enterprise/admin/categories/authentication/ - - /enterprise/admin/guides/installation/user-authentication/ - - /enterprise/admin/articles/inviting-users/ - - /enterprise/admin/guides/migrations/authenticating-users-for-your-github-enterprise-instance/ - - /enterprise/admin/user-management/authenticating-users-for-your-github-enterprise-server-instance -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/zh-CN/content/admin/user-management/basic-account-settings.md b/translations/zh-CN/content/admin/user-management/basic-account-settings.md deleted file mode 100644 index 435edd5d8b44..000000000000 --- a/translations/zh-CN/content/admin/user-management/basic-account-settings.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: 基本帐户设置 -intro: '在用户能够在 {% data variables.product.product_location_enterprise %} 上进行身份验证后，他们会想要设置几项基本的自定义个人资料，例如头像和电子邮件通知。' -redirect_from: - - /enterprise/admin/guides/user-management/enabling-avatars-and-identicons/ - - /enterprise/admin/user-management/basic-account-settings -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/zh-CN/content/admin/user-management/changing-authentication-methods.md b/translations/zh-CN/content/admin/user-management/changing-authentication-methods.md deleted file mode 100644 index 205fcf4a63b9..000000000000 --- a/translations/zh-CN/content/admin/user-management/changing-authentication-methods.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: 更改身份验证方法 -intro: '您可以随时更改 {% data variables.product.prodname_ghe_server %} 对您现有的帐户进行身份验证的方法。' -redirect_from: - - /enterprise/admin/user-management/changing-authentication-methods -versions: - enterprise-server: '*' ---- - -在您更改身份验证方法时，{% data variables.product.product_location_enterprise %} 上的用户帐户将保留，只要他们的用户名没有发生变化，用户就可以继续登录原来的帐户。 - -如果新的身份验证方法更改了用户名，将创建新帐户。 As an administrator, you can rename users through the site admin settings or by using [the User Administration API](/enterprise/{{currentVersion}}/v3/enterprise-admin/users/#rename-an-existing-user). - -您应当考虑的其他问题包括： - -* **密码**：如果您为实例改为使用内置身份验证方法，则在更改完成后，用户必须[设置密码](/enterprise/user/articles/how-can-i-reset-my-password/)。 - -* **站点管理员**：管理权限[在您使用 SAML 时由您的身份提供程序控制](/enterprise/admin/guides/user-management/using-saml/#saml-attributes)，而[在您使用 LDAP 时则通过组成员关系进行控制](/enterprise/admin/guides/user-management/using-ldap/#configuring-ldap-with-your-github-enterprise-server-instance)。 - -* **团队成员关系**：只有 LDAP 可以让您从目录服务器[控制团队成员关系](/enterprise/admin/guides/user-management/using-ldap/#configuring-ldap-with-your-github-enterprise-server-instance)。 - -* **用户挂起**：当您使用 LDAP 进行身份验证时，可以通过_受限制的组_控制 {% data variables.product.prodname_ghe_server %} 的访问权限。 在切换到 LDAP 后，如果配置受限制的组，那么不属于其中任何一个组的现有用户将被挂起。 在用户登录或下一次 LDAP 同步期间将发生挂起。 - -* **组成员关系**：当您使用 LDAP 进行身份验证时，系统将根据受限制组的成员关系和 Active Directory 中的帐户状态自动[挂起和取消挂起](/enterprise/admin/guides/user-management/suspending-and-unsuspending-users)用户。 - -* **Git 身份验证**：SAML 和 CAS 仅支持使用[个人访问令牌](/articles/creating-an-access-token-for-command-line-use)通过 HTTP 或 HTTPS 进行的 Git 身份验证。 不支持通过 HTTP 或 HTTPS 进行的密码身份验证。 LDAP 默认支持基于密码的 Git 身份验证，不过，我们建议您[禁用这种方法](/enterprise/admin/guides/user-management/using-ldap/#disabling-password-authentication-for-git-operations)，并强制通过个人访问令牌或 SSH 密钥进行身份验证。 - -* **API 身份验证**：SAML 和 CAS 仅支持使用[个人访问令牌](/articles/creating-an-access-token-for-command-line-use)进行的 API 身份验证。 不支持基本身份验证。 - -* **双重身份验证**：{% data reusables.enterprise_user_management.external_auth_disables_2fa %} - -* **对您的身份提供程序覆盖范围外的用户进行内置身份验证**：您可以邀请用户在 {% data variables.product.product_location_enterprise %} 中进行身份验证，无需将他们添加到您的身份提供程序中。 更多信息请参阅“[允许对身份提供程序覆盖范围以外的用户进行内置身份验证](/enterprise/{{ currentVersion }}/admin/guides/user-management/allowing-built-in-authentication-for-users-outside-your-identity-provider)”。 diff --git a/translations/zh-CN/content/admin/user-management/disabling-unauthenticated-sign-ups.md b/translations/zh-CN/content/admin/user-management/disabling-unauthenticated-sign-ups.md deleted file mode 100644 index a486e345a877..000000000000 --- a/translations/zh-CN/content/admin/user-management/disabling-unauthenticated-sign-ups.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: 禁用未经身份验证的注册 -redirect_from: - - /enterprise/admin/articles/disabling-sign-ups/ - - /enterprise/admin/user-management/disabling-unauthenticated-sign-ups -intro: 如果您使用的是内置身份验证，可以阻止未经身份验证的人创建帐户。 -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.privacy %} -3. 取消选中 **Enable sign-up**。 ![启用注册复选框](/assets/images/enterprise/management-console/enable-sign-up.png) -{% data reusables.enterprise_management_console.save-settings %} diff --git a/translations/zh-CN/content/admin/user-management/organizations-and-teams.md b/translations/zh-CN/content/admin/user-management/organizations-and-teams.md deleted file mode 100644 index df76c023b9cf..000000000000 --- a/translations/zh-CN/content/admin/user-management/organizations-and-teams.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: 组织和团队 -redirect_from: - - /enterprise/admin/articles/adding-users-and-teams/ - - /enterprise/admin/categories/admin-bootcamp/ - - /enterprise/admin/user-management/organizations-and-teams -intro: 组织适合在您的公司内创建不同的用户组，例如部门或参与相似项目的组。 属于某个组织的公共仓库也可供其他组织的用户使用，但私有仓库仅供该组织的成员使用。 -mapTopic: true -versions: - enterprise-server: '*' ---- - diff --git a/translations/zh-CN/content/admin/user-management/preventing-users-from-changing-a-repositorys-visibility.md b/translations/zh-CN/content/admin/user-management/preventing-users-from-changing-a-repositorys-visibility.md deleted file mode 100644 index 88a1b276c54e..000000000000 --- a/translations/zh-CN/content/admin/user-management/preventing-users-from-changing-a-repositorys-visibility.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: 阻止用户更改仓库可见性 -intro: '您可以阻止成员在 {% data variables.product.prodname_ghe_server %} 设备上更改组织拥有的仓库的可见性。' -redirect_from: - - /enterprise/admin/guides/user-management/preventing-users-from-changing-a-repository-s-visibility - - /enterprise/admin/user-management/preventing-users-from-changing-a-repositorys-visibility -versions: - enterprise-server: '*' ---- - -当您阻止成员更改仓库可见性时，只有站点管理员可以将公共仓库设置为私有或者将私有仓库设置为公共。 - -如果站点管理员仅允许组织所有者创建仓库，成员将无法更改仓库可见性。 如果站点管理员只允许成员创建私有仓库，则成员只能将仓库从公共更改为私有。 更多信息请参阅“[限制在实例中创建仓库](/enterprise/{{ currentVersion }}/admin/guides/user-management/restricting-repository-creation-in-your-instance)”。 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.policies-tab %} -{% data reusables.enterprise-accounts.repositories-tab %} -5. 在“Repository visibility change”下，检查有关更改设置的信息。 {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} - -{% data reusables.enterprise-accounts.repository-visibility-policy %} diff --git a/translations/zh-CN/content/admin/user-management/preventing-users-from-changing-anonymous-git-read-access.md b/translations/zh-CN/content/admin/user-management/preventing-users-from-changing-anonymous-git-read-access.md deleted file mode 100644 index 2fc3766624a8..000000000000 --- a/translations/zh-CN/content/admin/user-management/preventing-users-from-changing-anonymous-git-read-access.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: 阻止用户更改匿名 Git 读取权限 -intro: '您可以阻止仓库管理员更改一个仓库{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.14" %}或所有仓库{% endif %}的匿名 Git 读取权限。' -redirect_from: - - /enterprise/admin/guides/user-management/preventing-users-from-changing-anonymous-git-read-access-to-a-repository/ - - /enterprise/admin/user-management/preventing-users-from-changing-anonymous-git-read-access -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_user_management.disclaimer-for-git-read-access %} - -要阻止仓库管理员为特定仓库更改匿名 Git 读取权限设置，您可以锁定仓库的权限设置。 在您锁定仓库的 Git 读取权限设置后，只有站点管理员可以更改设置。 - -仓库管理员可为公共仓库（如果不是分叉）更改匿名 Git 读取权限。 更多信息请参阅“[允许管理员启用对公共仓库的匿名 Git 读取权限](/enterprise/{{ currentVersion }}/admin/guides/user-management/allowing-admins-to-enable-anonymous-git-read-access-to-public-repositories)”。 - -{% data reusables.enterprise_site_admin_settings.list-of-repos-with-anonymous-git-read-access-enabled %} - -### 阻止用户更改仓库的匿名 Git 读取权限 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.repository-search %} -{% data reusables.enterprise_site_admin_settings.click-repo %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -6. 在“Danger Zone”下，选择 **Prevent repository admins from enabling anonymous Git read access**。 ![选中复选框，锁定仓库以阻止更改其匿名 Git 读取权限设置](/assets/images/enterprise/site-admin-settings/lock-repo-from-changing-anonymous-git-read-access.png) - -### 阻止用户为所有仓库更改匿名 Git 读取权限 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.settings-tab %} -{% data reusables.enterprise-accounts.options-tab %} -3. 在“Anonymous Git read access”下，确认已启用此设置，然后选择 **Prevent repository admins from changing anonymous Git read access**。 ![选中复选框，全局锁定仓库以阻止更改其匿名 Git 读取权限设置](/assets/images/enterprise/site-admin-settings/globally-lock-repos-from-changing-anonymous-git-read-access.png) - diff --git a/translations/zh-CN/content/admin/user-management/preventing-users-from-deleting-organization-repositories.md b/translations/zh-CN/content/admin/user-management/preventing-users-from-deleting-organization-repositories.md deleted file mode 100644 index a31e6058dcf2..000000000000 --- a/translations/zh-CN/content/admin/user-management/preventing-users-from-deleting-organization-repositories.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: 阻止用户删除组织仓库 -intro: '您可以阻止成员在您的 {% data variables.product.prodname_ghe_server %} 设备上删除或转让组织中的仓库。' -redirect_from: - - /enterprise/admin/user-management/preventing-users-from-deleting-organization-repositories -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.policies-tab %} -{% data reusables.enterprise-accounts.repositories-tab %} -5. 在“Repository deletion and transfer”下，检查有关更改设置的信息。 {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} - -{% data reusables.enterprise-accounts.repository-deletion-policy %} diff --git a/translations/zh-CN/content/admin/user-management/repositories.md b/translations/zh-CN/content/admin/user-management/repositories.md deleted file mode 100644 index 25befb7520b4..000000000000 --- a/translations/zh-CN/content/admin/user-management/repositories.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: 仓库 -intro: '您可以管理您的 {% data variables.product.prodname_ghe_server %} 设备上可供仓库管理员使用的设置。' -mapTopic: true -redirect_from: - - /enterprise/admin/user-management/repositories -versions: - enterprise-server: '*' ---- - diff --git a/translations/zh-CN/content/admin/user-management/restricting-repository-creation-in-your-instance.md b/translations/zh-CN/content/admin/user-management/restricting-repository-creation-in-your-instance.md deleted file mode 100644 index 1f082480ce0f..000000000000 --- a/translations/zh-CN/content/admin/user-management/restricting-repository-creation-in-your-instance.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: 限制在实例中创建仓库 -intro: '您可以选择 {% data variables.product.prodname_ghe_server %} 设备上的组织成员是否可以创建仓库，以及这些成员可以创建哪种仓库。' -redirect_from: - - /enterprise/admin/user-management/restricting-repository-creation-in-your-instance -versions: - enterprise-server: '*' ---- - -{% data reusables.organizations.repo-creation-constants %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.business %} -{% data reusables.enterprise-accounts.policies-tab %} -{% data reusables.enterprise-accounts.repositories-tab %} -5. 在“Repository creation”下，检查有关更改设置的信息。 {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} -{% if currentVersion ver_gt "enterprise-server@2.19" %} -{% data reusables.enterprise-accounts.repo-creation-policy %} -{% data reusables.enterprise-accounts.repo-creation-types %} -{% else %} -6. 在“Repository creation（仓库创建）”下，使用下拉菜单并选择策略。 ![包含仓库创建策略的下拉菜单](/assets/images/enterprise/site-admin-settings/repository-creation-drop-down.png) -{% endif %} diff --git a/translations/zh-CN/content/admin/user-management/user-security.md b/translations/zh-CN/content/admin/user-management/user-security.md deleted file mode 100644 index 8ef103423c71..000000000000 --- a/translations/zh-CN/content/admin/user-management/user-security.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: 用户安全 -intro: '确保您的 {% data variables.product.prodname_ghe_server %} 用户安全。 您可以审核他们的安全设置或在实例内强制执行最佳实践。' -mapTopic: true -redirect_from: - - /enterprise/admin/user-management/user-security -versions: - enterprise-server: '*' ---- - diff --git a/translations/zh-CN/content/admin/user-management/using-built-in-authentication.md b/translations/zh-CN/content/admin/user-management/using-built-in-authentication.md deleted file mode 100644 index 3a665801bfba..000000000000 --- a/translations/zh-CN/content/admin/user-management/using-built-in-authentication.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: 使用内置身份验证 -intro: '当您使用默认身份验证方法时，所有身份验证详细信息都将存储在 {% data variables.product.product_location_enterprise %} 中。 如果您尚未建立身份验证提供程序（例如 LDAP、SAML 或 CAS），内置身份验证将是默认方法。' -redirect_from: - - /enterprise/admin/user-management/using-built-in-authentication -versions: - enterprise-server: '*' ---- - -您可以创建用户将在登录和注销页面上看到的自定义消息。 更多信息请参阅“[自定义您的实例上的用户消息](/enterprise/admin/user-management/customizing-user-messages-on-your-instance)”。 - -### 配置内置身份验证 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.authentication %} -4. 选择 **Built in authentication**。 ![选择内置身份验证选项](/assets/images/enterprise/management-console/built-in-auth-select.png) - -{% data reusables.enterprise_user_management.two_factor_auth_header %} -{% data reusables.enterprise_user_management.2fa_is_available %} - -### 创建帐户并添加用户 - -在实例创建完成后，您需要创建自己的管理员帐户并使用它配置用户。 - -1. 在 `http(s)://[hostname]/join` 的“Create Admin Account”页面下，选择您的用户名、密码和电子邮件地址，然后单击 **Create an account**。 ![创建管理员帐户](/assets/images/enterprise/site-admin-settings/create-first-admin-acct.png) -{% data reusables.enterprise_site_admin_settings.sign-in %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.invite-user-sidebar-tab %} -{% data reusables.enterprise_site_admin_settings.invite-user-reset-link %} diff --git a/translations/zh-CN/content/admin/user-management/using-cas.md b/translations/zh-CN/content/admin/user-management/using-cas.md deleted file mode 100644 index 6abea360a3bd..000000000000 --- a/translations/zh-CN/content/admin/user-management/using-cas.md +++ /dev/null @@ -1,43 +0,0 @@ ---- -title: 使用 CAS -redirect_from: - - /enterprise/admin/articles/configuring-cas-authentication/ - - /enterprise/admin/articles/about-cas-authentication/ - - /enterprise/admin/user-management/using-cas -intro: 'CAS 是一种适用于多种网络应用程序的单点登录 (SSO) 协议。 在登录之前，CAS 用户帐户不会占用{% if currentVersion ver_gt "enterprise-server@2.16" %}用户许可{% else %}席位{% endif %}。' -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_user_management.built-in-authentication %} - -### 使用 CAS 时的用户名考量因素 - -{% data reusables.enterprise_management_console.username_normalization %} - -{% data reusables.enterprise_management_console.username_normalization_sample %} - -{% data reusables.enterprise_user_management.two_factor_auth_header %} -{% data reusables.enterprise_user_management.external_auth_disables_2fa %} - -### CAS 属性 - -以下属性可用。 - -| 属性名称 | 类型 | 描述 | -| ----- | -- | ------------------------------------------------------------ | -| `用户名` | 必选 | {% data variables.product.prodname_ghe_server %} 用户名。 | - -### 配置 CAS -{% warning %} - -**警告**：请注意，在 {% data variables.product.product_location_enterprise %} 上配置 CAS 之前，用户将无法使用他们的 CAS 用户名和密码通过 HTTP/HTTPS 对 API 请求或 Git 操作进行身份验证。 相反，他们将需要[创建访问令牌](/enterprise/{{ currentVersion }}/user/articles/creating-an-access-token-for-command-line-use)。 - -{% endwarning %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.authentication %} -3. 选择 **CAS**。 ![选择 CAS](/assets/images/enterprise/management-console/cas-select.png) -4. {% data reusables.enterprise_user_management.built-in-authentication-option %} ![选中 CAS 内置身份验证复选框](/assets/images/enterprise/management-console/cas-built-in-authentication.png) -5. 在 **Server URL** 字段中，输入您的 CAS 服务器的完整 URL。 如果您的 CAS 服务器使用无法由 {% data variables.product.prodname_ghe_server %} 验证的证书，您可以使用 `ghe-ssl-ca-certificate-install` 命令将其作为可信证书安装。 diff --git a/translations/zh-CN/content/admin/user-management/using-ldap.md b/translations/zh-CN/content/admin/user-management/using-ldap.md deleted file mode 100644 index 36632dc1fcff..000000000000 --- a/translations/zh-CN/content/admin/user-management/using-ldap.md +++ /dev/null @@ -1,190 +0,0 @@ ---- -title: 使用 LDAP -redirect_from: - - /enterprise/admin/articles/configuring-ldap-authentication/ - - /enterprise/admin/articles/about-ldap-authentication/ - - /enterprise/admin/articles/viewing-ldap-users/ - - /enterprise/admin/hidden/enabling-ldap-sync/ - - /enterprise/admin/hidden/ldap-sync/ - - /enterprise/admin/user-management/using-ldap -intro: '使用 LDAP，您可以向 {% data variables.product.prodname_ghe_server %} 验证现有帐户的身份和集中管理仓库权限。 LDAP 是一种用于访问和维护目录信息服务的流行应用程序协议，是将第三方软件与大型公司用户目录相集成时使用的最常见协议之一。' -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_user_management.built-in-authentication %} - -### 支持的 LDAP 服务 - -{% data variables.product.prodname_ghe_server %} 可与下列 LDAP 服务集成： - -* Active Directory -* FreeIPA -* Oracle Directory Server Enterprise Edition -* OpenLDAP -* Open Directory -* 389-ds - -### 使用 LDAP 时的用户名考量因素 - -{% data reusables.enterprise_management_console.username_normalization %} - -{% data reusables.enterprise_management_console.username_normalization_sample %} - -{% data reusables.enterprise_user_management.two_factor_auth_header %} -{% data reusables.enterprise_user_management.2fa_is_available %} - -### 在 {% data variables.product.product_location_enterprise %} 上配置 LDAP - -在您配置 LDAP 后，用户将能够使用他们的 LDAP 凭据登录您的实例。 在用户首次登录时，他们个人资料中的姓名、电子邮件地址和 SSH 密钥将使用您的目录中的 LDAP 属性进行设置。 - -当您通过 {% data variables.enterprise.management_console %} 为用户配置 LDAP 访问权限时，在用户首次登录您的实例前，用户许可不可用。 但是，如果您使用站点管理员设置手动创建帐户，用户许可将立即可用。 - -{% warning %} - -**警告**：在 {% data variables.product.product_location_enterprise %} 上配置 LDAP 之前，请确保您的 LDAP 服务支持分页结果。 - -{% endwarning %} - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.authentication %} -3. 在“Authentication”下，选择 **LDAP**。 ![选择 LDAP](/assets/images/enterprise/management-console/ldap-select.png) -4. {% data reusables.enterprise_user_management.built-in-authentication-option %} ![选中 LDAP 内置身份验证复选框](/assets/images/enterprise/management-console/ldap-built-in-authentication.png) -5. 添加您的配置设置。 - -### LDAP 属性 -使用以下属性完成 {% data variables.product.product_location_enterprise %} 的 LDAP 配置。 - -| 属性名称 | 类型 | 描述 | -| ------------------------------------------------ | -- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `Host` | 必选 | LDAP 主机，例如 `ldap.example.com` 或 `10.0.0.30`。 如果主机名只能在您的内部网络中使用，您需要先配置 {% data variables.product.product_location_enterprise %} 的 DNS，以便它可以使用您的内部域名服务器解析主机名。 | -| `端口` | 必选 | 主机的 LDAP 服务侦听的端口。 示例包括：389 和 636（适用于 LDAPS）。 | -| `Encryption` | 必选 | 用于确保与 LDAP 服务器之间的通信安全的加密方法。 示例包括明文（无加密）、SSL/LDAPS（从一开始就加密）和 StartTLS（在连接后升级为加密通信）。 | -| `Domain search user` | 可选 | 执行用户查询，在其他用户登录时对其进行身份验证的 LDAP 用户。 这一般是一个专为第三方集成创建的服务帐户。 使用完全限定名称，例如 `cn=Administrator,cn=Users,dc=Example,dc=com`。 对于 Active Directory，您还可为域搜索用户使用 `[DOMAIN]\[USERNAME]` 语法（例如 `WINDOWS\Administrator`）。 | -| `Domain search password` | 可选 | 域搜索用户的密码。 | -| `Administrators group` | 可选 | 登录您的设备后，此组中的用户将被升级为站点管理员。 如果您不配置 LDAP 管理员组，则登录您的设备的第一个 LDAP 用户帐户将被自动升级为站点管理员。 | -| `Domain base` | 必选 | 您想要搜索用户和组的 LDAP 子树的完全限定 `Distinguished Name` (DN)。 您可以添加任意数量的组；不过，每个组和它所包含的用户都必须在相同的基础域中定义。 如果您指定受限的用户组，那么只有属于这些组的用户将在作用域内。 我们建议您将 LDAP 目录树的顶级指定为您的基础域，并使用受限的用户组来控制权限。 | -| `Restricted user groups` | 可选 | 如果指定，将仅允许这些组中的用户登录。 您只需要指定组的常用名 (CN)，您可以添加任意数量的组。 如果未指定组，则指定基础域作用域中的*所有*用户都将可以登录您的 {% data variables.product.prodname_ghe_server %} 实例。 | -| `User ID` | 必选 | 标识尝试身份验证的 LDAP 用户的 LDAP 属性。 建立映射后，用户可以更改他们的 {% data variables.product.prodname_ghe_server %} 用户名。 对于大多数 Active Directory 安装来说，此字段应为 `sAMAccountName`，但对其他 LDAP 解决方案（例如 OpenLDAP）来说，可能是 `uid`。 默认值为 `uid`。 | -| `Profile name` | 可选 | 将在用户的 {% data variables.product.prodname_ghe_server %} 个人资料页面上显示的姓名。 除非启用 LDAP 同步，否则用户可以更改他们的个人资料姓名。 | -| `Emails` | 可选 | 用户的 {% data variables.product.prodname_ghe_server %} 帐户的电子邮件地址。 | -| `SSH keys` | 可选 | 连接到用户的 {% data variables.product.prodname_ghe_server %} 帐户的 SSH 公钥。 密钥必须采用 OpenSSH 格式。 | -| `GPG keys` | 可选 | 连接到用户的 {% data variables.product.prodname_ghe_server %} 帐户的 GPG 密钥。 | -| `Disable LDAP authentication for Git operations` | 可选 | 如果选择，将[禁止](#disabling-password-authentication-for-git-operations)用户使用 LDAP 密码对 Git 操作进行身份验证。 | -| `Enable LDAP certificate verification` | 可选 | 如果选择，将[启用](#enabling-ldap-certificate-verification) LDAP 证书验证。 | -| `Synchronization` | 可选 | 如果选择，将[启用](#enabling-ldap-sync) LDAP 同步。 | - -#### 为 Git 操作禁用密码身份验证 - -在您的 LDAP 设置中选择 **Disable username and password authentication for Git operations**，为 Git 权限强制使用个人访问令牌或 SSH 密钥，这样有助于防止您的服务器被 LDAP 身份验证请求过载。 我们建议使用此设置，因为响应慢的 LDAP 服务器是性能问题和故障的常见来源，尤其是在遇到轮询导致的大量请求时。 - -![为 Git 禁用 LDAP 密码身份验证的复选框](/assets/images/enterprise/management-console/ldap-disable-password-auth-for-git.png) - -选择此选项时，如果用户通过命令行尝试为 Git 操作使用密码，他们将收到一条错误消息，内容为 `Password authentication is not allowed for Git operations. You must use a personal access token.` - -#### 启用 LDAP 证书验证 - -在您的 LDAP 设置中选择 **Enable LDAP certificate verification**，验证您用于 TLS 的 LDAP 服务器证书。 - -![LDAP 证书验证复选框](/assets/images/enterprise/management-console/ldap-enable-certificate-verification.png) - -选择此选项时，将对证书进行验证，以确保： -- 如果证书至少包含一个使用者可选名称 (SAN)，则其中的一个 SAN 将匹配 LDAP 主机名。 否则，常用名 (CN) 将匹配 LDAP 主机名。 -- 证书不会过期。 -- 证书由受信任的证书颁发机构 (CA) 签名。 - -#### 启用 LDAP 同步 - -借助 LDAP 同步，您可以将 {% data variables.product.prodname_ghe_server %} 用户和团队成员关系与建立的 LDAP 组同步。 这样，您可以在 LDAP 服务器中为用户建立基于角色的权限控制，而不用在 {% data variables.product.prodname_ghe_server %} 中手动建立。 更多信息请参阅“[创建团队](/enterprise/{{ currentVersion }}/admin/guides/user-management/creating-teams#creating-teams-with-ldap-sync-enabled)”。 - -要启用 LDAP 同步，请在您的 LDAP 设置中选择 **Synchronize Emails（同步电子邮件）**、**Synchronize SSH Keys（同步 SSH 密钥）**或 **Synchronize GPG Keys（同步 GPG 密钥）**。 - -![Synchronization 复选框](/assets/images/enterprise/management-console/ldap-synchronize.png) - -启用 LDAP 同步后，某个同步作业将以指定的时间间隔运行，在每个用户帐户上执行以下操作： - -- 如果您已允许对您的身份提供程序覆盖范围以外的用户进行内置身份验证，并且该用户使用内置身份验证，请前进到下一个用户。 -- 如果用户没有 LDAP 映射，请尝试将用户映射到目录中的 LDAP 条目。 如果用户无法映射到 LDAP 条目，请挂起该用户并前进到下一个用户。 -- 如果存在 LDAP 映射但目录中相应的 LDAP 条目缺失，请挂起该用户并前进到下一个用户。 -- 如果相应的 LDAP 条目已被标记为禁用并且该用户尚未被挂起，请挂起该用户并前进到下一个用户。 -- 如果相应的 LDAP 条目未被标记为禁用，用户已被挂起，并且已在 Admin Center 中启用 _Reactivate suspended users_，请取消挂起该用户。 -- 如果相应的 LDAP 条目包括 `name` 属性，请更新用户的个人资料姓名。 -- 如果相应的 LDAP 条目位于管理员组中，请将该用户升级为站点管理员。 -- 如果相应的 LDAP 条目不位于管理员组中，请将该用户降级为普通帐户。 -- 如果为电子邮件定义了一个 LDAP 用户字段，请将该用户的电子邮件设置与 LDAP 条目同步。 将第一个 LDAP `mail` 条目设为主电子邮件。 -- 如果为 SSH 公钥定义了一个 LDAP 用户字段，请将该用户的 SSH 公钥与 LDAP 条目同步。 -- 如果为 GPG 密钥定义了一个 LDAP 用户字段，请将该用户的 GPG 密钥与 LDAP 条目同步。 - -{% note %} - -**注**：只有您使用 Active Directory，`userAccountControl` 属性显示并使用 `ACCOUNTDISABLE` 标记时，才可以将 LDAP 条目标记为禁用。 - -{% endnote %} - -某个同步作业也将以指定的时间间隔运行，在已经映射到 LDAP 组的每个团队上执行以下操作： - -- 如果已移除团队的相应 LDAP 组，请移除团队中的所有成员。 -- 如果已从 LDAP 组中移除 LDAP 成员条目，请从团队中移除相应的用户。 如果用户因此失去了任何仓库的访问权限，请删除用户在这些仓库中的任何私有分叉。 -- 如果已向 LDAP 组中添加 LDAP 成员条目，请将相应的用户添加到团队中。 如果用户因此重新获得了任何仓库的访问权限，请恢复过去 90 天内因为用户失去访问权限而被删除的仓库中的任何私有分叉。 - -{% data reusables.enterprise_user_management.ldap-sync-nested-teams %} - -{% warning %} - -**安全警告：** - -启用 LDAP 同步后，站点管理员和组织所有者可以搜索要映射团队的目标组的 LDAP 目录。 - -这样有可能将敏感的组织信息披露给合同工或其他没有权限的用户，包括： - -- 对*域搜索用户*可见的特定 LDAP 组的存在性。 -- 具有 {% data variables.product.prodname_ghe_server %} 用户帐户的 LDAP 组的成员，如果创建与该 LDAP 组同步的团队，此信息将被披露。 - -如果不需要披露此类信息，您的公司或组织应在管理员控制台中限制配置的*域搜索用户*的权限。 如果无法进行此类限制，请联系 {% data variables.contact.contact_ent_support %}。 - -{% endwarning %} - -#### 支持的 LDAP 组对象类 - -{% data variables.product.prodname_ghe_server %} 支持下列 LDAP 组对象类。 可以嵌套组。 - -- `组` -- `groupOfNames` -- `groupOfUniqueNames` -- `posixGroup` - -### 查看和创建 LDAP 用户 - -您可以查看具有您的实例访问权限的 LDAP 用户的完整列表和配置新用户。 - -{% data reusables.enterprise_site_admin_settings.sign-in %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -3. 在左侧边栏中，单击 **LDAP users**。 ![LDAP users 选项卡](/assets/images/enterprise/site-admin-settings/ldap-users-tab.png) -4. 要搜索用户，请输入完整或部分用户名，然后单击 **Search**。 现有用户将显示在搜索结果中。 如果用户不存在，请单击 **Create** 以配置新用户帐户。 ![LDAP 搜索](/assets/images/enterprise/site-admin-settings/ldap-users-search.png) - -### 更新 LDAP 帐户 - -除非[启用 LDAP 同步](#enabling-ldap-sync)，否则 LDAP 帐户的变更将不会自动与 {% data variables.product.prodname_ghe_server %} 同步。 - -* 要使用新的 LDAP 管理员组，必须在 {% data variables.product.prodname_ghe_server %} 上手动升级和降级用户，以反映 LDAP 中的变更。 -* 要在 LDAP 管理员组中添加或移除 LDAP 帐户，请[在 {% data variables.product.prodname_ghe_server %} 上升级或降级帐户](/enterprise/{{ currentVersion }}/admin/guides/user-management/promoting-or-demoting-a-site-administrator)。 -* 要移除 LDAP 帐户，请[挂起 {% data variables.product.prodname_ghe_server %} 帐户](/enterprise/{{ currentVersion }}/admin/guides/user-management/suspending-and-unsuspending-users)。 - -#### 手动同步 LDAP 帐户 - -{% data reusables.enterprise_site_admin_settings.sign-in %} -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.search-user %} -{% data reusables.enterprise_site_admin_settings.click-user %} -{% data reusables.enterprise_site_admin_settings.admin-top-tab %} -{% data reusables.enterprise_site_admin_settings.admin-tab %} -5. 在“LDAP”下，单击 **Sync now**，使用您的 LDAP 服务器中的数据手动更新帐户。 ![LDAP Sync now 按钮](/assets/images/enterprise/site-admin-settings/ldap-sync-now-button.png) - -You can also [use the API to trigger a manual sync](/enterprise/{{ currentVersion }}/user/rest/reference/enterprise-admin#ldap). - -### 撤销 {% data variables.product.product_location_enterprise %} 的权限 - -如果[启用 LDAP 同步](#enabling-ldap-sync)，移除用户的 LDAP 凭据将在下一次同步操作后挂起他们的帐户。 - -如果**未**启用 LDAP 同步，您必须在移除 LDAP 凭据后手动挂起 {% data variables.product.prodname_ghe_server %} 帐户。 更多信息请参阅“[挂起和取消挂起用户](/enterprise/{{ currentVersion }}/admin/guides/user-management/suspending-and-unsuspending-users)”。 diff --git a/translations/zh-CN/content/admin/user-management/using-saml.md b/translations/zh-CN/content/admin/user-management/using-saml.md deleted file mode 100644 index b9e5159c2093..000000000000 --- a/translations/zh-CN/content/admin/user-management/using-saml.md +++ /dev/null @@ -1,137 +0,0 @@ ---- -title: 使用 SAML -redirect_from: - - /enterprise/admin/articles/configuring-saml-authentication/ - - /enterprise/admin/articles/about-saml-authentication/ - - /enterprise/admin/user-management/using-saml -intro: 'SAML 是一种基于 XML 的身份验证和授权标准。 {% data variables.product.prodname_ghe_server %} 可以作为您的内部 SAML 身份提供程序 (IdP) 的服务提供程序 (SP)。' -versions: - enterprise-server: '*' ---- - -{% data reusables.enterprise_user_management.built-in-authentication %} - -### 支持的 SAML 服务 - -{% data reusables.saml.saml-supported-idps %} - -{% data reusables.saml.saml-single-logout-not-supported %} - -### 使用 SAML 时的用户名考量因素 - -每个 {% data variables.product.prodname_ghe_server %} 用户名都由 SAML 响应中的以下断言之一决定，这些断言按优先级从高到低排列的顺序为： - -- 自定义用户名属性（如果定义且存在） -- `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name` 断言（如果存在） -- `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress` 断言（如果存在） -- `NameID` 元素 - -即使其他属性存在，也需要 `NameID` 元素。 - -将在 `NameID` 与 {% data variables.product.prodname_ghe_server %} 用户名之间创建映射，`NameID` 应持久、唯一，并且在用户生命周期内不会发生变化。 - -{% data reusables.enterprise_management_console.username_normalization %} - -{% data reusables.enterprise_management_console.username_normalization_sample %} - -{% data reusables.enterprise_user_management.two_factor_auth_header %} -{% data reusables.enterprise_user_management.external_auth_disables_2fa %} - -### SAML 元数据 - -您的 {% data variables.product.prodname_ghe_server %} 实例的服务提供程序元数据位于 `http(s)://[hostname]/saml/metadata` 下。 - -要手动配置您的身份提供程序，断言使用者服务 (ACS) URL 为 `http(s)://[hostname]/saml/consume`。 它使用 `urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST` 绑定。 - -### SAML 属性 - -以下属性可用。 您可以在 [Management Console](/enterprise/{{ currentVersion }}/admin/guides/installation/accessing-the-management-console/) 中更改属性名称，但 `administrator` 属性除外。 - -| 默认属性名称 | 类型 | 描述 | -| --------------- | -- | -------------------------------------------------------------------------------------------------------------------- | -| `NameID` | 必选 | 持久用户标识符。 可以使用任意持久名称标识符格式。 除非提供备用断言之一，否则将为 {% data variables.product.prodname_ghe_server %} 用户名使用 `NameID` 元素。 | -| `administrator` | 可选 | 如果值为“true”，用户将被自动升级为管理员。 任何其他值或不存在的值会将用户降级为普通用户帐户。 | -| `用户名` | 可选 | {% data variables.product.prodname_ghe_server %} 用户名。 | -| `full_name` | 可选 | 用户的个人资料页面上显示的姓名。 用户可以在配置后更改他们的姓名。 | -| `emails` | 可选 | 用户的电子邮件地址。 可以指定多个。 | -| `public_keys` | 可选 | 用户的 SSH 公钥。 可以指定多个。 | -| `gpg_keys` | 可选 | 用户的 GPG 密钥。 可以指定多个。 | - -### 配置 SAML 设置 - -{% data reusables.enterprise_site_admin_settings.access-settings %} -{% data reusables.enterprise_site_admin_settings.management-console %} -{% data reusables.enterprise_management_console.authentication %} -3. 选择 **SAML**。 ![SAML 身份验证](/assets/images/enterprise/management-console/auth-select-saml.png) -4. {% data reusables.enterprise_user_management.built-in-authentication-option %} ![选中 SAML 内置身份验证复选框](/assets/images/enterprise/management-console/saml-built-in-authentication.png) -5. 或者，要启用非请求响应 SSO，请选择 **IdP initiated SSO**。 默认情况下，{% data variables.product.prodname_ghe_server %} 将向 IdP 发回 `AuthnRequest`，回复非请求身份提供程序 (IdP) 发起的请求。 ![SAML idP SSO](/assets/images/enterprise/management-console/saml-idp-sso.png) - - {% tip %} - - **注**：我们建议保留此值处于**未选择**状态。 您**只**应在罕见的情况下启用此功能，即您的 SAML 实现不支持服务提供程序发起的 SSO，并且 {% data variables.contact.enterprise_support %} 建议执行此操作。 - - {% endtip %} - -5. 如果您**不**希望 SAML 提供程序为 {% data variables.product.product_location_enterprise %} 上的用户确定管理员权限，请选择 **Disable administrator demotion/promotion（禁用管理员降级/升级）**。 ![SAML 禁用管理员配置](/assets/images/enterprise/management-console/disable-admin-demotion-promotion.png) -6. 在 **Single sign-on URL** 字段中，为单点登录请求输入您的 IdP 上的 HTTP 或 HTTPS 端点。 此值由您的 IdP 配置提供。 如果主机只能在您的内部网络中使用，您需要先[将 {% data variables.product.product_location_enterprise %} 配置为使用内部域名服务器](/enterprise/{{ currentVersion }}/admin/guides/installation/configuring-dns-nameservers/)。 ![SAML 身份验证](/assets/images/enterprise/management-console/saml-single-sign-url.png) -7. （可选）在 **Issuer（签发者）** 字段中，输入您的 SAML 签发者的姓名。 这将验证发送到 {% data variables.product.product_location_enterprise %} 的消息的真实性。 ![SAML 颁发者](/assets/images/enterprise/management-console/saml-issuer.png) -8. 在 **Signature Method（签名方法）** 和 **Digest Method（摘要方法）** 下拉菜单中，选择您的 SAML 颁发者用于验证 {% data variables.product.product_location_enterprise %} 请求完整性的哈希算法。 使用 **Name Identifier Format** 下拉菜单指定格式。 ![SAML 方法](/assets/images/enterprise/management-console/saml-method.png) -9. 在 **Verification certificate（验证证书）**下，单击 **Choose File（选择文件）**并选择用于验证 IdP 的 SAML 响应的证书。 ![SAML 身份验证](/assets/images/enterprise/management-console/saml-verification-cert.png) -10. 如果需要，请修改 SAML 属性名称以匹配您的 IdP，或者接受默认名称。![SAML 属性名称](/assets/images/enterprise/management-console/saml-attributes.png) - -### 撤销 {% data variables.product.product_location_enterprise %} 的权限 - -如果您将某个用户从您的身份提供程序中移除，还必须手动挂起他们。 否则，他们仍可以继续使用访问令牌或 SSH 密钥进行身份验证。 更多信息请参阅“[挂起和取消挂起用户](/enterprise/admin/guides/user-management/suspending-and-unsuspending-users)”。 - -### 响应消息的要求 - -响应消息必须满足以下要求： - -- `` 元素必须在根响应文档上提供，而且只有在根响应文档签署后才匹配 ACS URL。 如果断言已签名，此元素将遭到忽略）。 -- `` 元素必须始终作为 `` 元素的一部分提供。 此元素必须匹配 {% data variables.product.prodname_ghe_server %} 实体 ID。 这是 {% data variables.product.prodname_ghe_server %} 实例的 URL，如 `https://ghe.corp.example.com`。 -- 响应中的每一个断言都**必须**由数字签名加以保护。 签署各个 `` 元素或签署 `` 元素可以实现此操作。 -- `` 元素必须作为 `` 元素的一部分提供。 可以使用任意持久名称标识符格式。 -- `Recipient` 属性必须存在并设为 ACS URL。 例如： - -```xml - - - - ... - - - - - - - monalisa - - - - -``` - -### 错误消息 - -如果 `Recipient` 与 ACS URL 不匹配，身份验证日志中将显示以下错误消息： - -``` -Recipient in the SAML response was not valid. -``` - -如果 `Recipient` 不是响应消息的一部分，身份验证日志中将显示以下错误消息： - -``` -Recipient in the SAML response must not be blank. -``` - -如果 SAML 响应未签名，或者签名与内容不匹配，身份验证日志中将显示以下错误消息： - -``` -SAML Response is not signed or has been modified. -``` -如果 `Audience` 缺失或者与 {% data variables.product.prodname_ghe_server %} 实体 Id 不匹配，身份验证日志中将显示以下错误消息： - -``` -Audience is invalid. Audience attribute does not match your_instance_url -``` diff --git a/translations/zh-CN/content/desktop/contributing-and-collaborating-using-github-desktop/accessing-a-pull-request-locally.md b/translations/zh-CN/content/desktop/contributing-and-collaborating-using-github-desktop/accessing-a-pull-request-locally.md deleted file mode 100644 index 60d8490edf13..000000000000 --- a/translations/zh-CN/content/desktop/contributing-and-collaborating-using-github-desktop/accessing-a-pull-request-locally.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: 本地访问拉取请求 -intro: '您可以在 {% data variables.product.prodname_desktop %} 上打开的拉取请求中查看提议的更改。' -redirect_from: - - /desktop/contributing-to-projects/accessing-a-pull-request-locally -versions: - free-pro-team: '*' ---- - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.click-pull-requests %} - ![Current Branch（当前分支）下拉菜单中的 Pull Requests（拉取请求）选项卡](/assets/images/help/desktop/branch-drop-down-pull-request-tab.png) -{% data reusables.desktop.choose-pr-from-list %} - ![仓库中打开的拉取请求列表](/assets/images/help/desktop/click-pull-request.png) -4. （可选）要刷新拉取请求列表，请单击 {% octicon "sync" aria-label="The sync icon" %}。 ![用于刷新的同步按钮](/assets/images/help/desktop/pull-request-list-sync.png) diff --git a/translations/zh-CN/content/desktop/contributing-to-projects/accessing-a-pull-request-locally.md b/translations/zh-CN/content/desktop/contributing-to-projects/accessing-a-pull-request-locally.md deleted file mode 100644 index 469b1c39e3d0..000000000000 --- a/translations/zh-CN/content/desktop/contributing-to-projects/accessing-a-pull-request-locally.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: 本地访问拉取请求 -intro: '您可以在 {% data variables.product.prodname_desktop %} 上打开的拉取请求中查看提议的更改。' -versions: - free-pro-team: '*' ---- - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.click-pull-requests %} - ![Current Branch（当前分支）下拉菜单中的 Pull Requests（拉取请求）选项卡](/assets/images/help/desktop/branch-drop-down-pull-request-tab.png) -{% data reusables.desktop.choose-pr-from-list %} - ![仓库中打开的拉取请求列表](/assets/images/help/desktop/click-pull-request.png) -4. （可选）要刷新拉取请求列表，请单击 {% octicon "sync" aria-label="The sync icon" %}。 ![用于刷新的同步按钮](/assets/images/help/desktop/pull-request-list-sync.png) diff --git a/translations/zh-CN/content/desktop/contributing-to-projects/adding-a-repository-from-your-local-computer-to-github-desktop.md b/translations/zh-CN/content/desktop/contributing-to-projects/adding-a-repository-from-your-local-computer-to-github-desktop.md deleted file mode 100644 index b0d23275546f..000000000000 --- a/translations/zh-CN/content/desktop/contributing-to-projects/adding-a-repository-from-your-local-computer-to-github-desktop.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: 将仓库从本地计算机添加到 GitHub Desktop -intro: '您可以将任何 Git 仓库添加到 {% data variables.product.prodname_desktop %} 中，即使不是 {% data variables.product.prodname_dotcom %} 仓库也可以。' -versions: - free-pro-team: '*' ---- - -{% tip %} - -**提示：**您可以通过拖放文件夹到 {% data variables.product.prodname_desktop %} 的方式，将 Git 仓库从本地计算机添加到 GitHub Desktop。 如果同时将多个 Git 文件夹拖入 {% data variables.product.prodname_desktop %}，则每个文件夹将添加为一个单独的 Git 仓库。 - -{% endtip %} - -{% mac %} - -1. 在 **File（文件）**菜单中，单击 **Add Local Repository（添加本地仓库）**。 ![添加本地仓库菜单选项](/assets/images/help/desktop/add-local-repository-mac.png) -2. 单击 **Choose...（选择...）**，并使用 Finder 窗口找到要添加的本地仓库。 ![Mac 应用程序中的“本地路径”字段](/assets/images/help/desktop/add-repo-choose-button-mac.png) -4. 单击 **Add Repository（添加仓库）**。 ![Mac 应用程序中的“添加仓库”按钮](/assets/images/help/desktop/add-repository-button-mac.png) - -{% endmac %} - -{% windows %} - -1. 在 **File（文件）**菜单中，单击 **Add Local Repository（添加本地仓库）**。 ![添加本地仓库菜单选项](/assets/images/help/desktop/add-local-repository-windows.png) -2. 单击 **Choose...（选择...）**，并使用 Windows 资源管理器找到要添加的本地仓库。 ![Windows 应用程序中的“本地路径”字段](/assets/images/help/desktop/add-repo-choose-button-win.png) -4. 单击 **Add Repository（添加仓库）**。 ![Windows 应用程序中的“添加仓库”按钮](/assets/images/help/desktop/add-repository-button-windows.png) - -{% endwindows %} diff --git a/translations/zh-CN/content/desktop/contributing-to-projects/adding-an-existing-project-to-github-using-github-desktop.md b/translations/zh-CN/content/desktop/contributing-to-projects/adding-an-existing-project-to-github-using-github-desktop.md deleted file mode 100644 index 1075897f2c9d..000000000000 --- a/translations/zh-CN/content/desktop/contributing-to-projects/adding-an-existing-project-to-github-using-github-desktop.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: 使用 GitHub Desktop 添加现有项目到 GitHub -intro: '您可以使用 {% data variables.product.prodname_desktop %} 将现有 Git 仓库添加到 {% data variables.product.prodname_dotcom %}。' -versions: - free-pro-team: '*' ---- - -{% mac %} - -{% data reusables.git.remove-git-remote %} -2. [添加仓库到 GitHub Desktop](/desktop/guides/contributing-to-projects/adding-a-repository-from-your-local-computer-to-github-desktop/). -{% data reusables.desktop.publish-repository %} -4. 在 **Name（名称）**字段中键入所需的仓库名称，或者使用默认的当前本地仓库名称。 ![名称字段](/assets/images/help/desktop/publish-repository-name-mac.png) -5. 要发布公共仓库，请取消选择 **Keep this code private（保留此代码为私有）**。 ![保留此代码为私有复选框](/assets/images/help/desktop/publish-repository-private-checkbox-mac.png) -6. 从 **Organization（组织）**下拉菜单中选择要发布仓库到其中的组织，或者选择 **None（无）**以将仓库发布到您的个人帐户。 ![组织下拉菜单](/assets/images/help/desktop/publish-repository-org-dropdown-mac.png) -7. 单击 **Publish Repository（发布仓库）**按钮。 ![“发布仓库”对话框中的“发布仓库”按钮](/assets/images/help/desktop/publish-repository-dialog-button-mac.png) - -{% endmac %} - -{% windows %} - -{% data reusables.git.remove-git-remote %} -2. [添加仓库到 GitHub Desktop](/desktop/guides/contributing-to-projects/adding-a-repository-from-your-local-computer-to-github-desktop/). -{% data reusables.desktop.publish-repository %} -4. 在 **Name（名称）**字段中键入所需的仓库名称，或者使用默认的当前本地仓库名称。 ![名称字段](/assets/images/help/desktop/publish-repository-name-win.png) -5. 要发布公共仓库，请取消选择 **Keep this code private（保留此代码为私有）**。 ![保留此代码为私有复选框](/assets/images/help/desktop/publish-repository-private-checkbox-win.png) -6. 从 **Organization（组织）**下拉菜单中选择要发布仓库到其中的组织，或者选择 **None（无）**以将仓库发布到您的个人帐户。 ![组织下拉菜单](/assets/images/help/desktop/publish-repository-org-dropdown-win.png) -7. 单击 **Publish Repository（发布仓库）**按钮。 ![“发布仓库”对话框中的“发布仓库”按钮](/assets/images/help/desktop/publish-repository-dialog-button-win.png) - -{% endwindows %} diff --git a/translations/zh-CN/content/desktop/contributing-to-projects/adding-and-cloning-repositories.md b/translations/zh-CN/content/desktop/contributing-to-projects/adding-and-cloning-repositories.md deleted file mode 100644 index 42caad7a7c63..000000000000 --- a/translations/zh-CN/content/desktop/contributing-to-projects/adding-and-cloning-repositories.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: 添加和克隆仓库 -intro: '将现有仓库从本地计算机添加至 {% data variables.product.prodname_desktop %}，或从 {% data variables.product.product_name %} 克隆仓库。' -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/zh-CN/content/desktop/contributing-to-projects/changing-a-remotes-url-from-github-desktop.md b/translations/zh-CN/content/desktop/contributing-to-projects/changing-a-remotes-url-from-github-desktop.md deleted file mode 100644 index 844445bcbc6c..000000000000 --- a/translations/zh-CN/content/desktop/contributing-to-projects/changing-a-remotes-url-from-github-desktop.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: 从 GitHub Desktop 更改远程的 URL -intro: '可在 {% data variables.product.prodname_desktop %} 中更改您操作的仓库的远程 URL。 如果仓库已经更名，或者拥有仓库的用户或组织已经改变，您便可执行此操作。' -redirect_from: - - /desktop/contributing-to-projects/changing-a-remote-s-url-from-github-desktop -versions: - free-pro-team: '*' ---- - -{% mac %} - -1. 在 **Repository（仓库）**菜单中，单击 **Repository Settings...（仓库设置...）**。 ![仓库设置菜单选项](/assets/images/help/desktop/repository-settings-mac.png) -2. 在 **Primary remote repository（主要远程仓库）**字段中，键入所需的 URL。 ![主要远程仓库字段](/assets/images/help/desktop/repository-settings-remote-mac.png) -3. 单击 **Save（保存）**。 ![保存按钮](/assets/images/help/desktop/repository-settings-save-mac.png) - -{% endmac %} - -{% windows %} - -1. 在 **Repository（仓库）**菜单中，单击 **Repository Settings...（仓库设置...）**。 ![仓库设置菜单选项](/assets/images/help/desktop/repository-settings-win.png) -2. 在 **Primary remote repository（主要远程仓库）**字段中，键入所需的 URL。 ![主要远程仓库字段](/assets/images/help/desktop/repository-settings-remote-win.png) -3. 单击 **Save（保存）**。 ![保存按钮](/assets/images/help/desktop/repository-settings-save-win.png) - -{% endwindows %} diff --git a/translations/zh-CN/content/desktop/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop.md b/translations/zh-CN/content/desktop/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop.md deleted file mode 100644 index fcd2ecbbbfb9..000000000000 --- a/translations/zh-CN/content/desktop/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: 将仓库从 GitHub 克隆到 GitHub Desktop -intro: '您可以使用 {% data variables.product.prodname_dotcom %} 将远程仓库克隆到 {% data variables.product.prodname_desktop %}。' -versions: - free-pro-team: '*' ---- - -{% tip %} - -**提示：**您也可以使用 {% data variables.product.prodname_desktop %} 克隆 {% data variables.product.prodname_dotcom %} 上的仓库。 更多信息请参阅“[从 {% data variables.product.prodname_desktop %} 克隆仓库](/desktop/guides/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop/)”。 - -{% endtip %} - -{% mac %} - -1. 开始克隆前，请先登录到 {% data variables.product.product_location %} 和 {% data variables.product.prodname_desktop %}。 -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.open-with-github-desktop %} -5. 单击 **Choose...（选择...）**，并使用 Finder 窗口找到要克隆仓库的本地路径。 ![URL 选项卡中的选择按钮](/assets/images/help/desktop/clone-choose-button-url-mac.png) - - {% note %} - - **注：**如果仓库配置为使用 LFS，将会提示您初始化 {% data variables.large_files.product_name_short %}。 - - {% endnote %} - -5. 单击 **Clone（克隆）**。 ![URL 选项卡中的克隆按钮](/assets/images/help/desktop/clone-button-url-mac.png) - -{% endmac %} - -{% windows %} - -1. 开始克隆前，请先登录到 {% data variables.product.product_location %} 和 {% data variables.product.prodname_desktop %}。 -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.open-with-github-desktop %} -5. 单击 **Choose...（选择...）**，并使用 Windows 资源管理器找到要克隆仓库的本地路径。 ![选择按钮](/assets/images/help/desktop/clone-choose-button-url-win.png) - - {% note %} - - **注：**如果仓库配置为使用 LFS，将会提示您初始化 {% data variables.large_files.product_name_short %}。 - - {% endnote %} - -5. 单击 **Clone（克隆）**。 ![克隆按钮](/assets/images/help/desktop/clone-button-url-win.png) - -{% endwindows %} diff --git a/translations/zh-CN/content/desktop/contributing-to-projects/cloning-and-forking-repositories-from-github-desktop.md b/translations/zh-CN/content/desktop/contributing-to-projects/cloning-and-forking-repositories-from-github-desktop.md deleted file mode 100644 index 42b3544c1118..000000000000 --- a/translations/zh-CN/content/desktop/contributing-to-projects/cloning-and-forking-repositories-from-github-desktop.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: 从 GitHub Desktop 克隆和复刻仓库 -intro: '您可以使用 {% data variables.product.prodname_desktop %} 克隆和复刻 {% data variables.product.prodname_dotcom %} 上的仓库。' -redirect_from: - - /desktop/contributing-to-projects/cloning-a-repository-from-github-desktop -versions: - free-pro-team: '*' ---- - -### 克隆仓库 -{% data variables.product.prodname_dotcom %} 上的仓库作为远程仓库存在。 您可以克隆其他人拥有的公共仓库。 您可以克隆自己的仓库，从而在计算机上创建本地副本，并在两个本地位置之间实现同步。 - -也可以直接从 {% data variables.product.prodname_dotcom %} 或 {% data variables.product.prodname_enterprise %} 克隆仓库。 更多信息请参阅“[将仓库从 {% data variables.product.prodname_dotcom %} 克隆至 {% data variables.product.prodname_desktop %}](/desktop/guides/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop/)。” - -{% mac %} - -{% data reusables.desktop.choose-clone-repository %} - ![Mac 应用程序中的克隆菜单选项](/assets/images/help/desktop/clone-file-menu-mac.png) -{% data reusables.desktop.cloning-location-tab %} - ![克隆仓库菜单中的 Location（位置）选项卡](/assets/images/help/desktop/choose-repository-location-mac.png) -{% data reusables.desktop.cloning-repository-list %} - ![克隆仓库列表](/assets/images/help/desktop/clone-a-repository-list-mac.png) -4. 单击 **Choose...（选择...）**，并使用 Finder 窗口找到要克隆仓库的本地路径。 ![选择按钮](/assets/images/help/desktop/clone-choose-button-mac.png) -5. 单击 **Clone（克隆）**。 ![克隆按钮](/assets/images/help/desktop/clone-button-mac.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.choose-clone-repository %} - ![Windows 应用程序中的克隆菜单选项](/assets/images/help/desktop/clone-file-menu-windows.png) -{% data reusables.desktop.cloning-location-tab %} - ![克隆仓库菜单中的 Location（位置）选项卡](/assets/images/help/desktop/choose-repository-location-win.png) -{% data reusables.desktop.cloning-repository-list %} - ![克隆仓库列表](/assets/images/help/desktop/clone-a-repository-list-win.png) -4. 单击 **Choose...（选择...）**，并使用 Windows 资源管理器找到要克隆仓库的本地路径。 ![选择按钮](/assets/images/help/desktop/clone-choose-button-win.png) -5. 单击 **Clone（克隆）**。 ![克隆按钮](/assets/images/help/desktop/clone-button-win.png) - -{% endwindows %} - -### 复刻仓库 -要对您没有写入权限的项目做出贡献，可以使用 {% data variables.product.prodname_desktop %} 创建仓库分支。 分支上的变更不会影响原始仓库。 您可以提交分支上的变更，然后将拉取请求对含有提议变更的原始仓库开放。 更多信息请参阅“[关于分支](/github/collaborating-with-issues-and-pull-requests/about-forks)。” - -1. 如果您克隆了自己没有写入权限的仓库，并查实提交变更。{% data variables.product.prodname_desktop %} 将警告您“您对 **REPOSITORY（仓库）**没有写入权限。 单击 **create a fork（创建分支）**。 ![创建分支链接](/assets/images/help/desktop/create-a-fork.png) -3. 单击 **Fork this repository（复刻此仓库）**。 ![复刻此仓库按钮](/assets/images/help/desktop/fork-this-repo-button.png) -4. 要查看 {% data variables.product.prodname_dotcom %} 上的分支，请在 {% data variables.product.prodname_dotcom %} 右上角单击个人资料照片，然后再单击 **Your repositories（您的仓库）**。 ![您的仓库链接](/assets/images/help/profile/your-repositories.png) diff --git a/translations/zh-CN/content/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project.md b/translations/zh-CN/content/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project.md deleted file mode 100644 index 4edefef0f879..000000000000 --- a/translations/zh-CN/content/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project.md +++ /dev/null @@ -1,99 +0,0 @@ ---- -title: 提交并审查对项目的更改 -intro: '{% data variables.product.prodname_desktop %} 可在您编辑时跟踪对所有文件的所有更改。 您可以决定如何对更改分组以创建有意义的提交。' -versions: - free-pro-team: '*' ---- - -### 关于提交 - -类似于保存文件，提交是对分支中一个或多个文件的更改。 Git 将为每个提交分配唯一的 ID，称为 SHA 或哈希，用于跟踪： - -- 具体的更改 -- 进行更改的时间 -- 更改创建者 - -在进行提交时，必须包含简要描述更改的提交消息。 您也可以对协作处理的任何提交添加合作作者。 - -### 1. 选择一个分支并进行更改 - -1. [创建新分支](/desktop/guides/contributing-to-projects/managing-branches)，或者单击工具栏中的 {% octicon "git-branch" aria-label="The branch icon" %} **Current Branch（当前分支）**并从列表中选择现有分支。 ![用于切换当前分支的下拉菜单](/assets/images/help/desktop/click-branch-in-drop-down.png) -{% data reusables.desktop.make-changes %} - -### 2. 选择要包含在提交中的更改 - -在文本编辑器中更改文件并本地保存后，您会在 {% data variables.product.prodname_desktop %} 中看到更改。 - -* 红色的 {% octicon "diff-removed" aria-label="The diff removed icon color-red" %} 图标表示删除的文件。 -* 黄色的 {% octicon "diff-modified" aria-label="The diff modified icon color-yellow" %} 图标表示修改的文件。 -* 绿色的 {% octicon "diff-added" aria-label="The diff added icon color-green" %} 图标表示添加的文件。 -* 要访问隐藏的更改，请单击 **Stashed Changes（隐藏的更改）**。 ![隐藏的更改选项](/assets/images/help/desktop/stashed-changes.png) -* {% data reusables.desktop.commit-all-desc %} -![选中复选框以提交所有更改的文件](/assets/images/help/desktop/commit-all.png) -* {% data reusables.desktop.commit-some-desc %} -![选中要提交的文件旁边的复选框](/assets/images/help/desktop/commit-some.png) - -#### 创建部分提交 - -如果一个文件包含多处更改，但只有*部分*更改要包含在提交中，则可创建部分提交。 其余更改会保持不动，以便您进行其他修改和提交。 这允许您进行单独、有意义的提交，例如使提交中的换行符更改区别于代码或文字更改。 - -在审查文件的差异时，包含在提交中的行将以蓝色高亮显示。 要排除更改，请单击更改的行让蓝色消失。 - -![文件中取消选择的行](/assets/images/help/desktop/partial-commit.png) - -#### 放弃更改 - -您可以放弃一个文件、一系列文件中所有未提交的更改，或者放弃上次提交后所有文件中的所有更改。 - -{% mac %} - -{% data reusables.desktop.select-discard-files %} -{% data reusables.desktop.click-discard-files %} - ![上下文菜单中的 Discard Changes（放弃更改）选项](/assets/images/help/desktop/discard-changes-mac.png) -{% data reusables.desktop.confirm-discard-files %} - ![确认对话框中的放弃更改按钮](/assets/images/help/desktop/discard-changes-confirm-mac.png) - -{% tip %} - -**提示：**您放弃的更改保存在垃圾桶的日期文件中，在垃圾桶清空之前可以恢复。 - -{% endtip %} - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.select-discard-files %}{% data reusables.desktop.click-discard-files %} - ![上下文菜单中的 Discard Changes（放弃更改）选项](/assets/images/help/desktop/discard-changes-win.png) -{% data reusables.desktop.confirm-discard-files %} - ![确认对话框中的放弃更改按钮](/assets/images/help/desktop/discard-changes-confirm-win.png) - -{% tip %} - -**提示：**您放弃的更改保存在垃圾桶的文件中，在垃圾桶清空之前可以恢复。 - -{% endtip %} - -{% endwindows %} - -### 3. 编写提交消息并推送更改 - -对选择要包含在提交中的更改感到满意后，编写提交消息并推送更改。 如果协作处理了某个提交，也可以将提交归于多个作者。 - -{% note %} - -**注**：{% data reusables.desktop.tags-push-with-commits %} 更多信息请参阅“[管理标记](/desktop/contributing-to-projects/managing-tags)。” - -{% endnote %} - -{% data reusables.desktop.commit-message %} - ![提交消息字段](/assets/images/help/desktop/commit-message.png) -2. （可选）要将某个提交归于另一个作者，请单击合作作者图标并输入要包含的用户名。 ![添加合作作者到提交消息](/assets/images/help/desktop/add-co-author-commit.png) -{% data reusables.desktop.commit-button %} - ![提交按钮](/assets/images/help/desktop/commit-button.png) -4. 如果您尝试提交的分支受保护，Desktop 将警告您。 - - 要移动变更，请单击 **switch branches（切换分支）**。 - - 要将变更提交至受保护分支，请单击 **Commit to（提交至） _BRANCH（分支）_**。 - - 有关受保护分支的更多信息，请参阅“[关于受保护分支](/github/administering-a-repository/about-protected-branches)”。 ![受保护分支警告](/assets/images/help/desktop/protected-branch-warning.png) -{% data reusables.desktop.push-origin %} diff --git a/translations/zh-CN/content/desktop/contributing-to-projects/creating-a-branch-for-your-work.md b/translations/zh-CN/content/desktop/contributing-to-projects/creating-a-branch-for-your-work.md deleted file mode 100644 index 1b85c97f915f..000000000000 --- a/translations/zh-CN/content/desktop/contributing-to-projects/creating-a-branch-for-your-work.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: 为您的工作创建分支 -intro: 如果您对仓库具有协作者权限，便可创建仓库默认分支以外的分支，以安全地试验更改。 -versions: - free-pro-team: '*' ---- - -### 创建分支 - -{% tip %} - -**提示：**您创建的第一个新分支将基于默认分支，通常是 `master`。 如果有多个分支，您可以选择新分支是以当前检出的分支还是默认分支为基础。 - -{% endtip %} - -{% mac %} - -{% data reusables.desktop.click-base-branch-in-drop-down %} - ![用于切换当前分支的下拉菜单](/assets/images/help/desktop/click-branch-in-drop-down-mac.png) -{% data reusables.desktop.create-new-branch %} - ![Branch（分支）菜单中的 New Branch（新分支）选项](/assets/images/help/desktop/new-branch-button-mac.png) -{% data reusables.desktop.name-branch %} - ![用于创建新分支名称的字段](/assets/images/help/desktop/create-branch-name-mac.png) -{% data reusables.desktop.select-base-branch %} - ![基础分支选项](/assets/images/help/desktop/create-branch-choose-branch-mac.png) -{% data reusables.desktop.confirm-new-branch-button %} - ![创建分支按钮](/assets/images/help/desktop/create-branch-button-mac.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.click-base-branch-in-drop-down %} - ![用于切换当前分支的下拉菜单](/assets/images/help/desktop/click-branch-in-drop-down-win.png) -{% data reusables.desktop.create-new-branch %} - ![Branch（分支）菜单中的 New Branch（新分支）选项](/assets/images/help/desktop/new-branch-button-win.png) -{% data reusables.desktop.name-branch %} - ![用于创建新分支名称的字段](/assets/images/help/desktop/create-branch-name-win.png) -{% data reusables.desktop.select-base-branch %} - ![基础分支选项](/assets/images/help/desktop/create-branch-choose-branch-win.png) -{% data reusables.desktop.confirm-new-branch-button %} - ![创建分支按钮](/assets/images/help/desktop/create-branch-button-win.png) - -{% endwindows %} - -### 延伸阅读 - -- "[从 {% data variables.product.prodname_desktop %} 克隆仓库](/desktop/guides/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop)" diff --git a/translations/zh-CN/content/desktop/contributing-to-projects/creating-an-issue-or-pull-request.md b/translations/zh-CN/content/desktop/contributing-to-projects/creating-an-issue-or-pull-request.md deleted file mode 100644 index 29fefb037dac..000000000000 --- a/translations/zh-CN/content/desktop/contributing-to-projects/creating-an-issue-or-pull-request.md +++ /dev/null @@ -1,56 +0,0 @@ ---- -title: 创建议题或拉取请求 -intro: 您可以创建议题或拉取请求，以提议并协作更改仓库。 -redirect_from: - - /desktop/contributing-to-projects/creating-a-pull-request -versions: - free-pro-team: '*' ---- - -### 打开新议题 -当您在本地处理 {% data variables.product.prodname_desktop %} 时发现漏洞或想要建议增强时，可以打开仓库中的新议题（如果议题已启用）。 有关处理议题的更多信息，请参阅“[关于议题](/github/managing-your-work-on-github/about-issues)。” - -{% mac %} - -1. 在屏幕的左上角，选择 **Repository（仓库）**菜单。 ![Mac 菜单栏中的 GitHub Desktop 菜单](/assets/images/help/desktop/select-repository-menu-mac.png) -2. 单击**在 {% data variables.product.prodname_dotcom %} 上创建议题**。 ![分支菜单中的仓库值](/assets/images/help/desktop/create-issue-mac.png) -3. 在 {% data variables.product.prodname_dotcom %} 上，单击 **Get started（开始使用）**打开议题模板，或单击 **Open a blank issue（打开空白议题）**。 ![创建新议题选项](/assets/images/help/desktop/create-new-issue.png) - -{% endmac %} - -{% windows %} - -1. 在窗口的左上角，选择 **Repository（仓库）**菜单。 ![Mac 菜单栏中的 GitHub Desktop 菜单](/assets/images/help/desktop/select-repository-menu-windows.png) -2. 单击**在 {% data variables.product.prodname_dotcom %} 上创建议题**。 ![分支菜单中的仓库值](/assets/images/help/desktop/create-issue-windows.png) -3. 在 {% data variables.product.prodname_dotcom %} 上，单击 **Get started（开始使用）**打开议题模板，或单击 **Open a blank issue（打开空白议题）**。 ![创建新议题选项](/assets/images/help/desktop/create-new-issue.png) - -{% endwindows %} - -{% note %} - -**注**：如果您当前的仓库中未启用议题模板，{% data variables.product.prodname_desktop %} 会将您指引到 {% data variables.product.prodname_dotcom %} 上的空白议题。 - -{% endnote %} - -### 创建新拉取请求 -在[创建分支](/desktop/guides/contributing-to-projects/managing-branches)和[提交一些更改](/desktop/guides/contributing-to-projects/committing-and-reviewing-changes-to-your-project)后，您可以打开拉取请求以获取对提议的更改的反馈。 - -{% mac %} - -1. 在屏幕的左上角，选择 **Branch（分支）**菜单。 ![Mac 菜单栏中的 GitHub Desktop 菜单](/assets/images/help/desktop/mac-select-branch-menu.png) -2. 单击 **Create pull request（创建拉取请求）**。 ![“分支”菜单中的“创建拉取请求”值](/assets/images/help/desktop/create-pull-request-mac.png) -3. 在 {% data variables.product.prodname_dotcom %} 上，验证下拉菜单中的默认_基_分支和_比较_分支，并在必要时进行更改。 ![用于选择基础和比较分支的下拉菜单](/assets/images/help/pull_requests/choose-base-and-compare-branches.png) -{% data reusables.repositories.pr-title-description %} -{% data reusables.repositories.create-pull-request %} - -{% endmac %} - -{% windows %} - -1. 在窗口的左上角，选择 **Branch（分支）**菜单。 ![Windows 菜单栏中的 GitHub Desktop 菜单](/assets/images/help/desktop/windows-select-branch-menu.png) -2. 单击 **Create pull request（创建拉取请求）**。 ![“分支”菜单中的“创建拉取请求”值](/assets/images/help/desktop/create-pull-request-win.png) -3. 在 {% data variables.product.prodname_dotcom %} 上，验证下拉菜单中的默认_基_分支和_比较_分支，并在必要时进行更改。 ![用于选择基础和比较分支的下拉菜单](/assets/images/help/pull_requests/choose-base-and-compare-branches.png) -{% data reusables.repositories.pr-title-description %} -{% data reusables.repositories.create-pull-request %} - -{% endwindows %} diff --git a/translations/zh-CN/content/desktop/contributing-to-projects/index.md b/translations/zh-CN/content/desktop/contributing-to-projects/index.md deleted file mode 100644 index 1fc25fc2a0d9..000000000000 --- a/translations/zh-CN/content/desktop/contributing-to-projects/index.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: 通过 GitHub Desktop 参与项目 -shortTitle: 参与项目 -intro: 使用 GitHub Desktop 管理项目，创建有意义的提交，并在应用程序（而非命令行）中跟踪项目的历史记录。 -versions: - free-pro-team: '*' ---- - - -### 目录 - -{% topic_link_in_list /adding-and-cloning-repositories %} - {% link_in_list /adding-a-repository-from-your-local-computer-to-github-desktop %} - {% link_in_list /adding-an-existing-project-to-github-using-github-desktop %} - {% link_in_list /cloning-and-forking-repositories-from-github-desktop %} - {% link_in_list /cloning-a-repository-from-github-to-github-desktop %} -{% topic_link_in_list /making-changes-in-a-branch %} - {% link_in_list /managing-branches %} - {% link_in_list /committing-and-reviewing-changes-to-your-project %} - {% link_in_list /pushing-changes-to-github %} - {% link_in_list /reverting-a-commit %} - {% link_in_list /managing-tags %} - {% link_in_list /viewing-the-branch-history %} -{% topic_link_in_list /working-with-your-remote-repository-on-github-or-github-enterprise %} - {% link_in_list /syncing-your-branch %} - {% link_in_list /creating-an-issue-or-pull-request %} - {% link_in_list /accessing-a-pull-request-locally %} - {% link_in_list /changing-a-remotes-url-from-github-desktop %} diff --git a/translations/zh-CN/content/desktop/contributing-to-projects/making-changes-in-a-branch.md b/translations/zh-CN/content/desktop/contributing-to-projects/making-changes-in-a-branch.md deleted file mode 100644 index c002e9628277..000000000000 --- a/translations/zh-CN/content/desktop/contributing-to-projects/making-changes-in-a-branch.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: 在分支中更改 -intro: '使用您常用的文本编辑器，如 [Atom](https://atom.io/)，更改您的项目，然后使用 {% data variables.product.prodname_desktop %} 可视化有用的提交。' -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/zh-CN/content/desktop/contributing-to-projects/managing-branches.md b/translations/zh-CN/content/desktop/contributing-to-projects/managing-branches.md deleted file mode 100644 index ea6c318fdcd4..000000000000 --- a/translations/zh-CN/content/desktop/contributing-to-projects/managing-branches.md +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: Managing branches -intro: You can create a branch off of a repository's default branch so you can safely experiment with changes. -redirect_from: - - /desktop/contributing-to-projects/creating-a-branch-for-your-work - - /desktop/contributing-to-projects/switching-between-branches -versions: - free-pro-team: '*' ---- - -### About managing branches -You can use branches to safely experiment with changes to your project. Branches isolate your development work from other branches in the repository. For example, you could use a branch to develop a new feature or fix a bug. - -始终可以从现有分支创建分支。 通常，您可能从仓库的 `master` 分支创建分支。 然后，您可以单独处理这个新分支，不受其他人对仓库所做更改的影响。 - -Once you're satisfied with your work, you can [open a pull request](/desktop/contributing-to-projects/creating-an-issue-or-pull-request) to merge the changes in the current branch into another branch. 更多信息请参阅“[关于拉取请求](/articles/about-pull-requests)”。 - -You can always create a branch in {% data variables.product.prodname_desktop %} if you have read access to a repository, but you can only push the branch to {% data variables.product.prodname_dotcom %} if you have write access to the repository. - -{% data reusables.desktop.protected-branches %} - -### 创建分支 - -{% tip %} - -**提示：**您创建的第一个新分支将基于默认分支，通常是 `master`。 If you have more than one branch, you can choose to base the new branch on the currently checked out branch or the default branch. - -{% endtip %} - -{% mac %} - -{% data reusables.desktop.click-base-branch-in-drop-down %} - ![用于切换当前分支的下拉菜单](/assets/images/help/desktop/click-branch-in-drop-down-mac.png) -{% data reusables.desktop.create-new-branch %} - ![Branch（分支）菜单中的 New Branch（新分支）选项](/assets/images/help/desktop/new-branch-button-mac.png) -{% data reusables.desktop.name-branch %} - ![用于创建新分支名称的字段](/assets/images/help/desktop/create-branch-name-mac.png) -{% data reusables.desktop.select-base-branch %} - ![基础分支选项](/assets/images/help/desktop/create-branch-choose-branch-mac.png) -{% data reusables.desktop.confirm-new-branch-button %} - ![创建分支按钮](/assets/images/help/desktop/create-branch-button-mac.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.click-base-branch-in-drop-down %} - ![用于切换当前分支的下拉菜单](/assets/images/help/desktop/click-branch-in-drop-down-win.png) -{% data reusables.desktop.create-new-branch %} - ![Branch（分支）菜单中的 New Branch（新分支）选项](/assets/images/help/desktop/new-branch-button-win.png) -{% data reusables.desktop.name-branch %} - ![用于创建新分支名称的字段](/assets/images/help/desktop/create-branch-name-win.png) -{% data reusables.desktop.select-base-branch %} - ![基础分支选项](/assets/images/help/desktop/create-branch-choose-branch-win.png) -{% data reusables.desktop.confirm-new-branch-button %} - ![创建分支按钮](/assets/images/help/desktop/create-branch-button-win.png) - -{% endwindows %} - -### 在分支间切换 -您可以查看并提交到任何仓库的分支。 如有未提交但已保存的更改，您需要决定如何处理更改，然后才可切换分支。 您可以在当前分支上提交更改、在当前分支上隐藏更改，或者将更改传送到新分支。 如果要在当前分支上提交更改，请在切换分支之前执行“[提交并审查对项目的更改](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project)”中的步骤。 - -{% tip %} - -**提示**：您可以在 **Advanced（高级）**设置中设置切换分支的默认行为。 For more information, see "[Configuring basic settings](/desktop/getting-started-with-github-desktop/configuring-basic-settings)." - -{% endtip %} - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.switching-between-branches %} - ![仓库中的分支列表](/assets/images/help/desktop/click-branch-in-drop-down-mac.png) -3. 如有已保存但未提交的更改，请选择 **Leave my changes（留下我的更改）**或 **Bring my changes（带上我的更改）**，然后单击 **Switch Branch（切换分支）**。 ![通过更改选项切换分支](/assets/images/help/desktop/stash-changes-options.png) - -### 检索隐藏的更改 -要访问在另一个分支中隐藏的更改，请切换回隐藏更改的分支。 - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.switching-between-branches %} - ![仓库中的分支列表](/assets/images/help/desktop/click-branch-in-drop-down-mac.png) -3. 在左侧边栏中，单击 **Stashed Changes（隐藏的更改）**。 ![隐藏的更改选项](/assets/images/help/desktop/stashed-changes.png) -4. 要删除隐藏的更改，请单击 **Discard（放弃）**，或者，要使用隐藏的更改，则单击 **Restore（恢复）**。 ![放弃或恢复隐藏的更改](/assets/images/help/desktop/discard-restore-stash-buttons.png) - -### 删除分支 - -无法删除目前与打开的拉取请求关联的分支。 You cannot undo deleting a branch. - -{% mac %} - -{% data reusables.desktop.select-branch-to-delete %} - ![Drop-down menu to select which branch to delete](/assets/images/help/desktop/select-branch-to-delete.png) -{% data reusables.desktop.delete-branch-mac %} - ![Delete... option in the Branch menu](/assets/images/help/desktop/delete-branch-mac.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.select-branch-to-delete %} - ![Drop-down menu to select which branch to delete](/assets/images/help/desktop/select-branch-to-delete.png) -{% data reusables.desktop.delete-branch-win %} - ![Delete... option in the Branch menu](/assets/images/help/desktop/delete-branch-win.png) - -{% endwindows %} - -### 延伸阅读 - -- "[从 {% data variables.product.prodname_desktop %} 克隆仓库](/desktop/guides/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop)" -- {% data variables.product.prodname_dotcom %} 词汇中的“[分支](/articles/github-glossary/#branch)” -- "[关于分支](/articles/about-branches)" -- Git 文档中的“[Nutshell 中的分支](https://git-scm.com/book/en/v2/Git-Branching-Branches-in-a-Nutshell)” diff --git a/translations/zh-CN/content/desktop/contributing-to-projects/managing-tags.md b/translations/zh-CN/content/desktop/contributing-to-projects/managing-tags.md deleted file mode 100644 index aba976ca4ad9..000000000000 --- a/translations/zh-CN/content/desktop/contributing-to-projects/managing-tags.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: 管理标记 -intro: '您可以使用 {% data variables.product.prodname_desktop %} 创建、推送和查看标记。' -versions: - free-pro-team: '*' ---- - -### 关于 {% data variables.product.prodname_desktop %} 中的标记 - -{% data variables.product.prodname_desktop %} 可用于创建带注释的标记。 您可以使用标记在仓库的历史记录中标记单独的点，包括发行版的版本号。 有关发行版标记的更多信息，请参阅“[关于发行版](https://help.github.com/en/github/administering-a-repository/about-releases)。” - -{% data reusables.desktop.tags-push-with-commits %} - -### 创建标记 - -{% data reusables.desktop.history-tab %} -{% data reusables.desktop.create-tag %} -{% data reusables.desktop.name-tag %} -{% data reusables.desktop.confirm-tag %} - -### 查看标记 - -{% data reusables.desktop.history-tab %} -2. 单击提交。 - {% note %} - - **注**：如果标记未被推送至远程仓库，{% data variables.product.prodname_desktop %} 将显示箭头 {% octicon "arrow-up" aria-label="The up arrow icon" %}。 - - {% endnote %} - - ![查看历史记录中的标记](/assets/images/help/desktop/viewing-tags-in-history.png) - -3. 与提交相关的所有标记均在提交元数据中可见。 ![查看提交中的标记](/assets/images/help/desktop/viewing-tags-in-commit.png) diff --git a/translations/zh-CN/content/desktop/contributing-to-projects/pushing-changes-to-github.md b/translations/zh-CN/content/desktop/contributing-to-projects/pushing-changes-to-github.md deleted file mode 100644 index 70843cb8b782..000000000000 --- a/translations/zh-CN/content/desktop/contributing-to-projects/pushing-changes-to-github.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Pushing changes to GitHub -shortTitle: Pushing changes -intro: 'As you commit changes to your project locally, you can push those changes to {% data variables.product.prodname_dotcom %} so that others may access them from the remote repository.' -permissions: People with write permissions can push changes to a repository. -versions: - free-pro-team: '*' ---- - -### About pushing changes to {% data variables.product.prodname_dotcom %} - -When you push changes, you send the committed changes in your local repository to the remote repository on {% data variables.product.prodname_dotcom %}. If you change your project locally and want other people to have access to the changes, you must push the changes to {% data variables.product.prodname_dotcom %}. - -Before pushing changes, you should update your local branch to include any commits that have been added to the remote repository. If someone has made commits on the remote that are not on your local branch, {% data variables.product.prodname_desktop %} will prompt you to fetch the new commits before pushing your changes to avoid merge conflicts. For more information, see "[Syncing your branch](/desktop/contributing-to-projects/syncing-your-branch)." - -{% data reusables.desktop.protected-branches %} - -### Pushing changes to {% data variables.product.prodname_dotcom %} - -{% note %} - -**Note:** {% data variables.product.prodname_desktop %} will reject a push if it exceeds certain limits. - -- A push contains a large file over 100MB in size. -- A push is over 2GB in total size. - -{% endnote %} - -{% data reusables.desktop.push-origin %} -2. If {% data variables.product.prodname_desktop %} prompts you to fetch new commits from the remote, click **Fetch**. ![The Fetch button](/assets/images/help/desktop/fetch-newer-commits.png) -3. Optionally, click **Create Pull Request** to open a pull request and collaborate on your changes. For more information, see "[Creating an issue or pull request](/desktop/contributing-to-projects/creating-an-issue-or-pull-request)" ![The Create Pull Request button](/assets/images/help/desktop/create-pull-request.png) - -### 延伸阅读 -- "[Push](/github/getting-started-with-github/github-glossary/#push)" in the {% data variables.product.prodname_dotcom %} glossary -- "[Committing and reviewing changes to your project](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project)" diff --git a/translations/zh-CN/content/desktop/contributing-to-projects/reverting-a-commit.md b/translations/zh-CN/content/desktop/contributing-to-projects/reverting-a-commit.md deleted file mode 100644 index 32a573fe9040..000000000000 --- a/translations/zh-CN/content/desktop/contributing-to-projects/reverting-a-commit.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: 还原提交 -intro: 您可以还原特定提交，以从分支中删除其变更。 -versions: - free-pro-team: '*' ---- - -在还原到上一个提交时，还原本身也是提交。 原提交仍会保留在仓库的历史记录中。 - -{% tip %} - -**提示：**在还原多个提交时，最好按照从最新到最旧的顺序还原。 如果以其他顺序还原提交，可能会出现合并冲突。 - -{% endtip %} - -{% mac %} - -{% data reusables.desktop.history-tab %} -{% data reusables.desktop.revert-commit %} - ![差异视图上方的还原选项](/assets/images/help/desktop/commit-revert-mac.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.history-tab %} -{% data reusables.desktop.revert-commit %} - ![差异视图上方的还原选项](/assets/images/help/desktop/commit-revert-win.png) - -{% endwindows %} diff --git a/translations/zh-CN/content/desktop/contributing-to-projects/switching-between-branches.md b/translations/zh-CN/content/desktop/contributing-to-projects/switching-between-branches.md deleted file mode 100644 index f4f4290cdfc9..000000000000 --- a/translations/zh-CN/content/desktop/contributing-to-projects/switching-between-branches.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: 在分支间切换 -intro: 您可以查看并提交到任何仓库的分支。 -versions: - free-pro-team: '*' ---- - -### 在分支间切换 -如有未提交但已保存的更改，您需要决定如何处理更改，然后才可切换分支。 您可以在当前分支上提交更改、在当前分支上隐藏更改，或者将更改传送到新分支。 如果要在当前分支上提交更改，请在切换分支之前执行“[提交并审查对项目的更改](/desktop/contributing-to-projects/committing-and-reviewing-changes-to-your-project)”中的步骤。 - -{% tip %} - -**提示**：您可以在 **Advanced（高级）**设置中设置切换分支的默认行为。 更多信息请参阅“[配置基本设置](/desktop/getting-started-with-github-desktop/configuring-basic-settings)。” - -{% endtip %} - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.switching-between-branches %} - ![仓库中的分支列表](/assets/images/help/desktop/click-branch-in-drop-down-mac.png) -3. 如有已保存但未提交的更改，请选择 **Leave my changes（留下我的更改）**或 **Bring my changes（带上我的更改）**，然后单击 **Switch Branch（切换分支）**。 ![通过更改选项切换分支](/assets/images/help/desktop/stash-changes-options.png) - -### 检索隐藏的更改 -要访问在另一个分支中隐藏的更改，请切换回隐藏更改的分支。 - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.switching-between-branches %} - ![仓库中的分支列表](/assets/images/help/desktop/click-branch-in-drop-down-mac.png) -3. 在左侧边栏中，单击 **Stashed Changes（隐藏的更改）**。 ![隐藏的更改选项](/assets/images/help/desktop/stashed-changes.png) -4. 要删除隐藏的更改，请单击 **Discard（放弃）**，或者，要使用隐藏的更改，则单击 **Restore（恢复）**。 ![放弃或恢复隐藏的更改](/assets/images/help/desktop/discard-restore-stash-buttons.png) diff --git a/translations/zh-CN/content/desktop/contributing-to-projects/syncing-your-branch.md b/translations/zh-CN/content/desktop/contributing-to-projects/syncing-your-branch.md deleted file mode 100644 index 73a3b2ebf85b..000000000000 --- a/translations/zh-CN/content/desktop/contributing-to-projects/syncing-your-branch.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: 同步分支 -intro: '当提交推送到您在 {% data variables.product.prodname_dotcom %} 上的项目时，可与远程仓库同步保留项目的本地副本。' -versions: - free-pro-team: '*' ---- - -必须将本地分支与远程仓库同步才可获得最初[创建分支](/desktop/guides/contributing-to-projects/managing-branches)后添加到上游分支的所有其他提交。 - -### 更新本地分支 - -1. 在 {% data variables.product.prodname_desktop %} 中，单击 {% octicon "git-branch" aria-label="The branch icon" %} **当前分支**并从列表中选择分支，以切换到要更新的本地分支。 -2. 单击 **Fetch origin（提取原点）**以更新分支。 ![提取源按钮](/assets/images/help/desktop/fetch-button.png) -3. 如果远程分支上有提交，您可以单击 **Pull origin（拉取源）**或 **Pull origin with rebase（通过变基拉取源）**来拉取这些提交。 ![拉取源按钮](/assets/images/help/desktop/pull-button.png) -{% data reusables.desktop.resolve-merge-conflicts %} - -### 将另一个分支合并到项目分支 - -{% data reusables.desktop.current-branch-menu %} -{% data reusables.desktop.choose-a-branch-to-merge %} -{% data reusables.desktop.confirm-merging-branch %} - - {% note %} - - **注：**如果存在合并冲突，{% data variables.product.prodname_desktop %} 会在 **Merge BRANCH into BRANCH（合并 [分支] 到 [分支 ]）**按钮上方提醒您。 在解决所有冲突之前无法合并分支。 - - {% endnote %} - - ![合并按钮](/assets/images/help/desktop/merge-branch-button.png) -{% data reusables.desktop.push-origin %} - -### 将项目分支变基到另一个分支 -有些工作流程需要或受益于变基而不是合并。 通过变基，可以重新排序、编辑提交或将其压缩到一起。 更多信息请参阅“[关于 Git 变基](/articles/about-git-rebase)”。 - -1. 使用 **Branch（分支）**下拉菜单，并单击 **Rebase Current Branch（变基当前分支）**。 ![在分支中重新变基当前分支下拉菜单](/assets/images/help/desktop/rebase-current-branch.png) -2. 单击要变基到当前分支的分支，然后单击 **Start rebase（开始变基）**。 ![开始变基按钮](/assets/images/help/desktop/start-rebase-button.png) -3. 如果确定要变基，请单击 **Begin rebase（开始变基）**。 ![开始变基按钮](/assets/images/help/desktop/begin-rebase-button.png) -{% data reusables.desktop.resolve-merge-conflicts %} -4. 要上推本地更改，请单击 **Force push origin（强制推送源）**。 ![强制推送源](/assets/images/help/desktop/force-push-origin.png) diff --git a/translations/zh-CN/content/desktop/contributing-to-projects/viewing-the-branch-history.md b/translations/zh-CN/content/desktop/contributing-to-projects/viewing-the-branch-history.md deleted file mode 100644 index 3a72134d94e5..000000000000 --- a/translations/zh-CN/content/desktop/contributing-to-projects/viewing-the-branch-history.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: 查看分支历史记录 -intro: '您可以在 {% data variables.product.prodname_desktop %} 中查看关于任何提交的详细信息，包括提交引入的变更差异。' -versions: - free-pro-team: '*' ---- - -每个提交会显示： - - - 提交消息 - - 提交创建的时间 - - 提交者的用户名和头像（如果有） - - 提交的 SHA-1 哈希（唯一 ID） - -{% data reusables.desktop.history-tab %} -2. 在 **History（历史记录）**选项卡中，单击要审查的提交。 ![历史记录选项卡中的提交](/assets/images/help/desktop/branch-history-commit.png) -3. 如果提交中有多个文件，单击个别文件可查看提交中对该文件的更改。 ![提交中的文件](/assets/images/help/desktop/branch-history-file.png) - -### 延伸阅读 - -- "[同步分支](/desktop/guides/contributing-to-projects/syncing-your-branch/)" diff --git a/translations/zh-CN/content/desktop/contributing-to-projects/working-with-your-remote-repository-on-github-or-github-enterprise.md b/translations/zh-CN/content/desktop/contributing-to-projects/working-with-your-remote-repository-on-github-or-github-enterprise.md deleted file mode 100644 index 2cdc332fadf3..000000000000 --- a/translations/zh-CN/content/desktop/contributing-to-projects/working-with-your-remote-repository-on-github-or-github-enterprise.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: 在 GitHub 或 GitHub Enterprise 上使用远程仓库 -intro: '在本地更改项目时，可以通过远程仓库持续更新它们。 在 Git 中，*远程*是存储代码的服务器。 在您的情况中，该服务器是 {% data variables.product.prodname_dotcom %} 或 {% data variables.product.prodname_enterprise %} 上的仓库。' -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/about-the-github-desktop-windows-installer-package.md b/translations/zh-CN/content/desktop/getting-started-with-github-desktop/about-the-github-desktop-windows-installer-package.md deleted file mode 100644 index 862473d7a2b2..000000000000 --- a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/about-the-github-desktop-windows-installer-package.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: 关于 GitHub Desktop Windows Installer 包 -intro: '作为网络管理员，可以使用 Windows Installer 包文件 (`.msi`) 结合组策略或其他远程安装系统，将 {% data variables.product.prodname_desktop %} 部署到 Active Directory 管理的网络中的 Microsoft Windows 计算机。' -versions: - free-pro-team: '*' ---- - -当用户下次登录其工作站时，Windows Installer 包将解压缩独立的安装程序 (`.exe`) 并配置 Windows 安装 {% data variables.product.prodname_desktop %}。 用户必须具有在其用户目录中安装 {% data variables.product.prodname_desktop %} 的权限。 - -如果用户直接运行 {% data variables.product.prodname_desktop %} Windows Installer 包，他们将需要注销并再次登录到其工作站，才可完成安装。 diff --git a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/authenticating-to-github.md b/translations/zh-CN/content/desktop/getting-started-with-github-desktop/authenticating-to-github.md deleted file mode 100644 index 401db3750e42..000000000000 --- a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/authenticating-to-github.md +++ /dev/null @@ -1,65 +0,0 @@ ---- -title: 向 GitHub 验证 -intro: '将您的 {% data variables.product.product_name %} 帐户连接至 {% data variables.product.prodname_desktop %}。' -redirect_from: - - /desktop/getting-started-with-github-desktop/authenticating-to-github-using-the-browser -versions: - free-pro-team: '*' ---- - -在进行身份验证之前，{% data reusables.desktop.get-an-account %} - -{% mac %} - -### 使用浏览器向 {% data variables.product.prodname_dotcom %} 验证 - -{% data reusables.desktop.mac-select-desktop-menu %} -{% data reusables.desktop.mac-select-accounts %} -4. 在“{% data variables.product.prodname_dotcom %}”右边单击 **Sign In（登录）**。 ![GitHub 的登录按钮](/assets/images/help/desktop/mac-sign-in-github.png) -5. 在 Sign in（登录）窗格中，单击 **Sign in using your browser（使用浏览器登录）**。 ![使用浏览器链接登录](/assets/images/help/desktop/mac-sign-in-browser.png) -{% data reusables.desktop.authenticate-in-browser %} -{% data reusables.desktop.retrieve-2fa-in-browser %} -{% data reusables.desktop.enter-2fa-in-browser %} -9. 在 {% data variables.product.prodname_dotcom %} 验证帐户后，返回到 {% data variables.product.prodname_desktop %}。 - -### 使用您的用户名和密码向 {% data variables.product.prodname_dotcom %} 验证 - -{% data reusables.user_settings.password-authentication-deprecation-desktop %} - -{% data reusables.desktop.mac-select-desktop-menu %} -{% data reusables.desktop.mac-select-accounts %} -{% data reusables.desktop.choose-product-authenticate %} -5. 要添加 GitHub Enterprise 帐户，请在“Enterprise server address（企业服务器地址）”下键入您的凭据，然后单击 **Continue（继续）**。 ![GitHub Enterprise 的登录按钮](/assets/images/help/desktop/mac-sign-in-button-enterprise.png) -6. 要添加 GitHub 帐户，请键入 GitHub.com 凭据，然后单击 **Sign in（登录）**。 ![GitHub 的登录按钮](/assets/images/help/desktop/mac-sign-in-button.png) -{% data reusables.desktop.retrieve-2fa %} -{% data reusables.desktop.return-to-desktop %} 在提示时，输入您的 2FA 代码，然后单击 **Sign in（登录）**。 ![2FA 代码提示](/assets/images/help/desktop/mac-2fa-code-prompt.png) - -{% endmac %} - -{% windows %} - -### 使用浏览器向 {% data variables.product.prodname_dotcom %} 验证 - -{% data reusables.desktop.windows-choose-options %} -{% data reusables.desktop.windows-select-accounts %} -4. 在 "GitHub.com" 右边单击 **Sign in（登录）**。 ![GitHub 的登录按钮](/assets/images/help/desktop/windows-sign-in-github.png) -5. 在 Sign in（登录）窗格中，单击 **Sign in using your browser（使用浏览器登录）**。 ![使用浏览器链接登录](/assets/images/help/desktop/windows-sign-in-browser.png) -{% data reusables.desktop.authenticate-in-browser %} -{% data reusables.desktop.retrieve-2fa-in-browser %} -{% data reusables.desktop.enter-2fa-in-browser %} -9. 在 {% data variables.product.prodname_dotcom %} 验证帐户后，返回到 {% data variables.product.prodname_desktop %}。 - -### 使用您的用户名和密码向 {% data variables.product.prodname_dotcom %} 验证 - - -{% data reusables.user_settings.password-authentication-deprecation-desktop %} - -{% data reusables.desktop.windows-choose-options %} -{% data reusables.desktop.windows-select-accounts %} -{% data reusables.desktop.choose-product-authenticate %} -5. 要添加 GitHub Enterprise 帐户，请在“Enterprise server address（企业服务器地址）”下键入您的凭据，然后单击 **Continue（继续）**。 ![GitHub Enterprise 的登录按钮](/assets/images/help/desktop/windows-sign-in-button-enterprise.png) -6. 要添加 GitHub 帐户，请键入 GitHub.com 凭据，然后单击 **Sign in（登录）**。 ![GitHub 的登录按钮](/assets/images/help/desktop/windows-sign-in-button.png) -{% data reusables.desktop.retrieve-2fa %} -{% data reusables.desktop.return-to-desktop %} 在提示时，输入您的 2FA 代码，然后单击 **Sign in（登录）**。 ![2FA 代码提示](/assets/images/help/desktop/windows-2fa-code-prompt.png) - -{% endwindows %} diff --git a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/configuring-a-default-editor.md b/translations/zh-CN/content/desktop/getting-started-with-github-desktop/configuring-a-default-editor.md deleted file mode 100644 index 48617751412c..000000000000 --- a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/configuring-a-default-editor.md +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: 配置默认编辑器 -intro: 您可以配置 GitHub Desktop 在项目中使用您首选的文本编辑器或集成开发环境 (IDE) 打开文件。 -versions: - free-pro-team: '*' ---- - -### 支持的编辑器 - -{% data variables.product.prodname_desktop %} 支持以下编辑器。 - -{% mac %} - -- [Atom](https://atom.io/) -- [MacVim](https://macvim-dev.github.io/macvim/) -- [Visual Studio Code](https://code.visualstudio.com/) -- [Visual Studio Codium](https://vscodium.com/) -- [Sublime Text](https://www.sublimetext.com/) -- [BBEdit](http://www.barebones.com/products/bbedit/) -- [JetBrains WebStorm](https://www.jetbrains.com/webstorm/) -- [JetBrains PhpStorm](https://www.jetbrains.com/phpstorm/) -- [JetBrains Rider](https://www.jetbrains.com/rider/) -- [JetBrains PyCharm](https://www.jetbrains.com/pycharm/) -- [JetBrains RubyMine](https://www.jetbrains.com/rubymine/) -- [JetBrains IntelliJ IDEA](https://www.jetbrains.com/idea/) -- [JetBrains GoLand](https://www.jetbrains.com/go/) -- [TextMate](https://macromates.com/) -- [Brackets](http://brackets.io/) - - 要将 Brackets 与 {% data variables.product.prodname_desktop %} 一起使用，您必须安装命令行快捷方式。 要安装快捷方式，请在菜单栏中单击 **File（文件）**，然后单击 **Install Command Line Shortcut（安装命令行快捷方式）**。 -- [Typora](https://typora.io/) -- [CodeRunner](https://coderunnerapp.com/) -- [SlickEdit](https://www.slickedit.com/) -- [Xcode](https://developer.apple.com/xcode/) -- [Android Studio](https://developer.android.com/studio) - -{% endmac %} - -{% windows %} - -- [Atom](https://atom.io/) -- [Visual Studio Code](https://code.visualstudio.com/) -- [Visual Studio Codium](https://vscodium.com/) -- [Sublime Text](https://www.sublimetext.com/) -- [ColdFusion Builder](https://www.adobe.com/products/coldfusion-builder.html) -- [Typora](https://typora.io/) -- [SlickEdit](https://www.slickedit.com/) -- [JetBrains WebStorm](https://www.jetbrains.com/webstorm/) -- [JetBrains PhpStorm](https://www.jetbrains.com/phpstorm/) -- [JetBrains Rider](https://www.jetbrains.com/rider/) -- [Notepad++](https://notepad-plus-plus.org/) - -{% endwindows %} - -### 配置默认编辑器 - -{% mac %} - -{% data reusables.desktop.mac-select-desktop-menu %} -3. 在 Preferences（首选项）窗口中，选择 **Integrations（集成）**。 ![“首选项”窗口中的“集成”窗格](/assets/images/help/desktop/mac-select-integrations-pane.png) -4. 使用“External Editor（外部编辑器）”下拉菜单，选择要设为默认的编辑器。 ![“首选项”菜单栏中的“外部编辑器”菜单](/assets/images/help/desktop/mac-editor-menu.png) -5. 单击 **Save（保存）**。 - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.windows-choose-options %} -3. 在 Options（选项）窗口中，选择 **Integrations（集成）**。 ![“选项”窗口中的“集成”窗格](/assets/images/help/desktop/windows-select-integrations-pane.png) -4. 使用“External Editor（外部编辑器）”下拉菜单，选择要设为默认的编辑器。 ![“选项”菜单栏中的“外部编辑器”菜单](/assets/images/help/desktop/windows-editor-menu.png) -5. 单击 **Save（保存）**。 - -{% endwindows %} diff --git a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/configuring-and-customizing-github-desktop.md b/translations/zh-CN/content/desktop/getting-started-with-github-desktop/configuring-and-customizing-github-desktop.md deleted file mode 100644 index 441815ebcc6e..000000000000 --- a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/configuring-and-customizing-github-desktop.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: 配置和自定义 GitHub Desktop -intro: 设置 Git，连接默认编辑器并自定义设置，使 GitHub Desktop 与您的工作流程保持一致。 -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/configuring-basic-settings.md b/translations/zh-CN/content/desktop/getting-started-with-github-desktop/configuring-basic-settings.md deleted file mode 100644 index 3677197d8cc0..000000000000 --- a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/configuring-basic-settings.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: 配置基本设置 -intro: 您可以访问隐私保护设置，将帐户连接到 GitHub Desktop，以及配置 Git。 -versions: - free-pro-team: '*' ---- - -{% mac %} - -{% data reusables.desktop.mac-select-desktop-menu %} -3. 要查看或更改设置，请在这些窗格之间切换： ![首选项菜单导航](/assets/images/help/desktop/mac-select-accounts-pane.png) -{% data reusables.desktop.preferences-options-tabs %} - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.windows-choose-options %} -2. 要查看或更改设置，请在这些窗格之间切换： ![选项菜单导航](/assets/images/help/desktop/windows-select-accounts-pane.png) -{% data reusables.desktop.preferences-options-tabs %} - -{% endwindows %} - -### 延伸阅读 - -- "[设置 {% data variables.product.prodname_desktop %} 的主题](/desktop/guides/getting-started-with-github-desktop/setting-a-theme-for-github-desktop)" diff --git a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/configuring-git-for-github-desktop.md b/translations/zh-CN/content/desktop/getting-started-with-github-desktop/configuring-git-for-github-desktop.md deleted file mode 100644 index 2623338f19ed..000000000000 --- a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/configuring-git-for-github-desktop.md +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: 配置 Git 用于 GitHub Desktop -shortTitle: Configuring Git -intro: 如果尚未安装 Git，在使用 GitHub Desktop 前必须先配置。 -versions: - free-pro-team: '*' ---- - -{% data variables.product.prodname_desktop %} uses the email address you set in your local Git configuration to connect commits with your account on {% data variables.product.product_name %}. - -{% data reusables.desktop.update-email-address %} - -{% tip %} - -**提示**：如果您执行公开提交，任何人都可以在您在的 Git 配置中查看电子邮件地址。 更多信息请参阅“[设置提交电子邮件地址](/articles/setting-your-commit-email-address/)”。 - -{% endtip %} - -{% mac %} - -{% data reusables.desktop.sign-in-choose-product %} -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.emails %} -{% data reusables.desktop.copy-email-git-config %} -{% data reusables.desktop.return-to-desktop %} -{% data reusables.desktop.mac-select-desktop-menu %} -7. In the Preferences window, click **Git**. ![Preferences（首选项）菜单中的 Git 窗格](/assets/images/help/desktop/mac-select-git-pane.png) -{% data reusables.desktop.name-field-git-config %} - ![Git 配置的名称字段](/assets/images/help/desktop/mac-name-git-config.png) -{% data reusables.desktop.paste-email-git-config %} - ![Git 配置字段中粘贴的电子邮件地址](/assets/images/help/desktop/mac-email-git-config.png) -{% data reusables.desktop.click-save-git-config %} - ![Save button in Git configuration field](/assets/images/help/desktop/mac-save-git-config.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.sign-in-choose-product %} -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.emails %} -{% data reusables.desktop.copy-email-git-config %} -{% data reusables.desktop.return-to-desktop %} -{% data reusables.desktop.windows-choose-options %} -8. In the Options window, click **Git**. ![Options（选项）菜单中的 Git 窗格](/assets/images/help/desktop/windows-select-git-pane.png) -{% data reusables.desktop.name-field-git-config %} - ![Git 配置的名称字段](/assets/images/help/desktop/windows-name-git-config.png) -{% data reusables.desktop.paste-email-git-config %} - ![Git 配置字段中粘贴的电子邮件地址](/assets/images/help/desktop/windows-email-git-config.png) -{% data reusables.desktop.click-save-git-config %} - ![Save button in Git configuration field](/assets/images/help/desktop/windows-save-git-config.png) - -{% endwindows %} - -### 延伸阅读 - -- “[将电子邮件地址添加到您的 GitHub 帐户](/articles/adding-an-email-address-to-your-github-account/)” -- "[设置提交电子邮件地址](/articles/setting-your-commit-email-address/)" diff --git a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/creating-your-first-repository-using-github-desktop.md b/translations/zh-CN/content/desktop/getting-started-with-github-desktop/creating-your-first-repository-using-github-desktop.md deleted file mode 100644 index 1dc5a117a524..000000000000 --- a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/creating-your-first-repository-using-github-desktop.md +++ /dev/null @@ -1,98 +0,0 @@ ---- -title: 使用 GitHub Desktop 创建第一个仓库 -intro: '您可以使用 {% data variables.product.prodname_desktop %} 快速处理 Git 仓库，而无需使用命令行。' -versions: - free-pro-team: '*' ---- - -### 简介 - -本指南将引导您使用 {% data variables.product.prodname_desktop %} 操作 Git 仓库。 {% data variables.product.prodname_desktop %} 可扩展并简化您的 {% data variables.product.prodname_dotcom_the_website %} 工作流程，它使用可视界面，而不是在命令行上使用命令文本。 在本指南结束时，您已经使用 {% data variables.product.prodname_desktop %} 创建仓库，更改仓库，并将更改推送到 {% data variables.product.prodname_dotcom_the_website %} 或 {% data variables.product.prodname_ghe_server %}。 - -下载 {% data variables.product.prodname_desktop %} 并登录 {% data variables.product.prodname_dotcom %} 或 {% data variables.product.prodname_enterprise %} 之后，您可以创建和克隆教程仓库。 本教程将介绍使用 Git 和 {% data variables.product.prodname_dotcom %} 的基础知识，包括安装编辑器、创建分支、进行提交、推送到 {% data variables.product.prodname_dotcom_the_website %}，以及创建拉取请求。 只要您在 {% data variables.product.prodname_desktop %} 上还没有任何仓库，就可以使用本教程。 - -### 步骤 1. 安装并登录到 {% data variables.product.prodname_desktop %} - -1. 从 {% data variables.product.desktop_link %} 下载 {% data variables.product.prodname_desktop %}。 {% data variables.product.prodname_desktop %} 支持 Windows 和 macOS 的最新版本。 有关特定于操作系统的安装说明，请参阅“[安装 {% data variables.product.prodname_desktop %}](/desktop/getting-started-with-github-desktop/installing-github-desktop)”。 - -2. 启动 {% data variables.product.prodname_desktop %} 并遵循初始欢迎屏幕上的流程登录到 {% data variables.product.product_name %} 帐户。 您将会看到“Configure Git（配置 Git）”步骤，用于设置名称和电子邮件地址。 为确保提交正确归因于您的 {% data variables.product.product_name %} 帐户，请使用与 {% data variables.product.product_name %} 帐户关联的电子邮件地址。 有关提交归属的更多信息，请参阅“[设置提交电子邮件地址](/articles/setting-your-commit-email-address)”。 - -### 步骤 2. 创建新仓库 - -您会看到“Let's get started!（开始使用吧！）”视图，从中可以选择创建和克隆教程仓库、克隆现有仓库、新建仓库或添加现有仓库。 - -#### 创建和克隆教程仓库 - -1. 单击 **Create a tutorial repository and clone it（创建教程仓库并克隆它）**。 ![“创建和克隆教程仓库”按钮](/assets/images/help/desktop/getting-started-guide/create-and-clone-a-tutorial-repository.png) -2. 按照教程中的提示进行操作。 - -#### 创建新仓库 - -1. 单击 **Create a New Repository on your Hard Drive...（在硬盘上创建新仓库...）**。 ![创建新仓库](/assets/images/help/desktop/getting-started-guide/creating-a-repository.png) -2. 要创建新仓库，请填写以下字段： ![创建仓库选项](/assets/images/help/desktop/getting-started-guide/create-a-new-repository-options.png) - - “Name（名称）”定义仓库在本地以及 {% data variables.product.product_name %} 上的名称。 - - “Description（说明）”是一个可选字段，可用于提供有关仓库目的的更多信息。 - - “Local path（本地路径）”设置仓库在计算机上的位置。 默认情况下，{% data variables.product.prodname_desktop %} 会在 _Documents_ 文件夹内创建 _GitHub_ 文件夹，用于存储仓库，但您也可以选择计算机上的任何位置。 您的新仓库将是所选位置内的文件夹。 例如，如果将仓库命名为 `Tutorial`，则会在为本地路径选择的文件夹内创建一个名为 _Tutorial_ 的文件夹。 下次创建或克隆新仓库时，{% data variables.product.prodname_desktop %} 会记住您选择的位置。 - - **Initialize this repository with a README（使用自述文件初始化此仓库）**创建包含 _README.md_ 文件的初始提交。 自述文件帮助人们了解项目的目的，因此建议选择此选项并加入有用的信息。 当有人访问您在 {% data variables.product.product_name %} 上的仓库时，自述文件是他们了解您的项目时看到的第一项内容。 更多信息请参阅“[关于自述文件](/articles/about-readmes)”。 - - **Git ignore（Git 忽略）**下拉菜单可让您添加自定义文件，以忽略本地仓库中您不想存储在版本控制中的特定文件。 如有您要使用的特定语言或框架，您可以从可用的列表中选择选项。 如果刚刚开始，尽请跳过此选择。 更多信息请参阅“[忽略文件](/articles/ignoring-files)”。 - - **License（许可证）**下拉菜单可让您将开源许可证添加到仓库中的 _LICENSE_ 文件。 您无需担心要立即添加许可证。 有关可用开源许可证以及如何将它们添加到仓库的更多信息，请参阅“[许可仓库](/articles/licensing-a-repository)”。 -3. 单击 **Create repository（创建仓库）**。 - -### 步骤 3. 探索 {% data variables.product.prodname_desktop %} - -现在您已选择仓库，将会在屏幕顶部看到文件菜单。 在这里可以访问设置以及能在 {% data variables.product.prodname_desktop %} 中执行的操作。 大多数操作也有快捷键来帮助您提高工作效率。 有关键盘快捷键的完整列表，请参阅“[键盘快捷键](/desktop/getting-started-with-github-desktop/keyboard-shortcuts)”。 - -1. 菜单下方的栏显示 {% data variables.product.prodname_desktop %} 中仓库的当前状态： - - **Current repository（当前仓库）**显示您处理的仓库的名称。 您可以单击 **Current repository（当前仓库）**切换到 {% data variables.product.prodname_desktop %} 中的不同仓库。 - - **Current branch（当前分支）**显示您处理的分支的名称。 您可以单击 **Current branch（当前分支）**来查看仓库中的所有分支、切换到不同的分支或者创建新分支。 在仓库中创建拉取请求后，也可单击 **Current branch（当前分支）**查看它们。 - - **Publish repository（发布仓库）**会出现，因为您尚未将仓库发布到 {% data variables.product.product_name %}，下一个步骤才发布。 - - ![探索 GitHub Desktop](/assets/images/help/desktop/getting-started-guide/explore-github-desktop.png) - -2. 在左侧边栏中，您会看到 **Changes（更改）**和 **History（历史记录）**视图。 - - - **Changes（更改）**视图显示您对当前分支中的文件已经做出但尚未提交到本地仓库的更改。 在底部，您还会看到“Summary（摘要）”框和“Description（说明）”文本框，以及 **Commit to master（提交到 master）**按钮。 这是提交新更改的位置。 **Commit（提交）**按钮指示您要将更改提交到哪个分支。 ![提交区域](/assets/images/help/desktop/getting-started-guide/commit-area.png) - - - **History（历史记录）**视图显示仓库当前分支上以前的提交。 您应会看到在创建仓库时 {% data variables.product.prodname_desktop %} 所创建的“初始提交”。 在提交的右侧，根据您在创建仓库时选择的选项，可能会看到 _.gitattributes_、_.gitignore_、_LICENSE_ 或 _README_ 文件。 您可以单击每个文件以查看该文件的差异，也就是提交中对该文件的更改。 差异只显示文件已更改的部分，而不显示文件的全部内容。 ![历史记录视图](/assets/images/help/desktop/getting-started-guide/history-view.png) - -### 步骤 4. 将仓库推送到 {% data variables.product.product_name %} - -目前，您的仓库只存在于您的计算机中，您是唯一能访问该仓库的人。 将仓库发布到 {% data variables.product.product_name %} 可使其在多个处理同一项目的计算机和团队成员之间保持同步。 要发布仓库，需先将其推送到 {% data variables.product.product_name %}，这样它也会出现在 {% data variables.product.prodname_dotcom_the_website %} 上。 - -1. 单击 **Publish repository（发布仓库）**。 ![发布仓库](/assets/images/help/desktop/getting-started-guide/publish-repository.png) - - 您会看到几个熟悉的字段。 “Name（名称）”和“Description（说明）”与您创建仓库时完成的字段匹配。 - - 您会看到选项 **Keep this code private（保留此代码为私有）**。 如果不想与 {% data variables.product.product_name %} 的其他用户公开分享您的代码，请选择此选项。 - - **Organization（组织）**下拉菜单，如果有，可让您将仓库发布到 {% data variables.product.product_name %} 上您所属的特定组织。 如果您还不是组织的成员，没关系！ ![发布仓库步骤](/assets/images/help/desktop/getting-started-guide/publish-repository-steps.png) -2. 单击 **Publish repository（发布仓库）**。 -3. 您可以从 {% data variables.product.prodname_desktop %} 访问 {% data variables.product.prodname_dotcom_the_website %} 上的仓库。 在文件菜单中，单击 **Repository（仓库）**，然后单击 **View on GitHub（在 GitHub 上查看）**。 这会直接在默认浏览器中打开仓库。 - -现在您的仓库已发布，我们回到 {% data variables.product.prodname_desktop %} 对本地仓库做其他更改。 首先，我们要设置默认文本编辑器。 - -### 步骤 5. 设置文本编辑器 - -为减少设置开发环境的时间，您可以直接从 {% data variables.product.prodname_desktop %} 启动多个文本编辑器和集成的开发环境 (IDE)。 从 {% data variables.product.prodname_desktop %} 中的仓库可以在常用文本编辑器中无缝打开项目文件夹。 - -1. 依次单击 **File（文件）**、**Options（选项）**和 **Advanced（高级）**。 -2. 使用 **External editor（外部编辑器）**下拉菜单并从列表中选择编辑器。 您应该会在列表中看到所有已安装的编辑器。 如果没有看到任何编辑器，请安装支持的编辑器，如 [Atom](https://atom.io)。 有关支持的编辑器列表，请参阅 {% data variables.product.prodname_desktop %} 仓库中的[“打开外部编辑器”集成](https://github.com/desktop/desktop/blob/development/docs/technical/editor-integration.md#windows)。 ![外部编辑器](/assets/images/help/desktop/mac-editor-menu.png) -3. 如果安装了新编辑器，请重新启动 {% data variables.product.prodname_desktop %} 以使该编辑器在 **External editor（外部编辑器）**下拉菜单中可用。 - -### 步骤 6. 进行、提交和推送更改 - -现在您已配置默认编辑器，可以更改项目并开始构建您自己对仓库的第一个提交。 - -1. 要从 {% data variables.product.prodname_desktop %} 启动外部编辑器，请单击 **Repository（仓库）**，然后单击 **Open in EDITOR（在 [编辑器] 中打开）**。 ![在编辑器中打开](/assets/images/help/desktop/getting-started-guide/open-in-editor.png) - -2. 首先对以前创建的 _README.md_ 文件做一些更改。 添加描述项目的信息，比如它做什么，以及为什么有用。 请记住，这是人们与您的项目的第一次互动。 现在您可以进行第一次提交！ -3. 从文本编辑器切换回 {% data variables.product.prodname_desktop %}，并找到 **Changes（更改）**选项卡。 在文件列表中，您应该会看到 _README.md_。 _README.md_ 文件旁边的勾选标记表示您对文件的更改将成为提交的一部分。 以后您可能会更改多个文件，但只想提交对其中部分文件所做的更改。 {% data variables.product.prodname_desktop %} 可让您选择要提交的特定更改。 ![查看更改](/assets/images/help/desktop/getting-started-guide/viewing-changes.png) - -4. 在 **Changes（更改）**列表底部，输入提交消息。 在头像右侧，键入提交的简短描述。 由于我们在更改 _README.md_ 文件，因此“添加关于项目目的的信息”将是比较好的提交摘要。 在摘要下方，您会看到“Description（说明）”文本字段，在其中可以键入较长的提交更改描述，这有助于回顾项目的历史记录和了解更改的原因。 由于您是对 _README.md_ 文件做基本的更新，因此可跳过描述。 ![提交消息](/assets/images/help/desktop/getting-started-guide/commit-message.png) -5. 单击 **Commit to master（提交至 master）**。 提交按钮显示当前分支，本例中是 `master`，因此您可以确保提交到所需的分支。 ![提交到 master](/assets/images/help/desktop/getting-started-guide/click-commit-to-master.png) -6. 要将更改推送到 {% data variables.product.product_name %} 上的远程仓库，请单击 **Push origin（推送源）**。 ![推送源](/assets/images/help/desktop/getting-started-guide/push-to-origin.png) - - 还记得用于将仓库发布到 {% data variables.product.product_name %} 的 **Publish（发布）**按钮吗？ 现在改为 `Push origin（推送源）`了，其旁边的 `1` 表示有一个提交尚未推送到 {% data variables.product.product_name %}。 - - **Push origin（推送源）**中的“源”表示我们将更改推送到名为 `origin` 的远程，在本例中是 {% data variables.product.prodname_dotcom_the_website %} 上的项目仓库。 在推送任何新提交到 {% data variables.product.product_name %} 之前，您的计算机上的项目仓库与 {% data variables.product.prodname_dotcom_the_website %} 上的项目仓库之间存在差异。 这可让您在本地工作，并且仅在准备好后才将工作推送到 {% data variables.product.prodname_dotcom_the_website %}。 -7. 在 **Changes（更改）**选项卡旁边打开的区域中，您会看到接下来可以执行的操作提示。 要在浏览器中打开 {% data variables.product.product_name %} 上的仓库，请单击 **View on GitHub（在 GitHub 中查看）**。 ![在 GitHub 上查看](/assets/images/help/desktop/getting-started-guide/view-on-github.png) -8. 在浏览器中，单击 **2 commits（2 次提交）**。 您会看到 {% data variables.product.product_name %} 上此仓库中的提交列表。 第一个提交应是您刚才在 {% data variables.product.prodname_desktop %} 中的提交！ ![单击两个提交](/assets/images/help/desktop/getting-started-guide/click-two-commits.png) - -### 结论 - -恭喜！ 您现已创建一个仓库，并且已将仓库发布到 {% data variables.product.product_name %}，进行了提交，并且发布了更改。 我们只粗略介绍您通过 {% data variables.product.product_name %} 和 {% data variables.product.prodname_desktop %} 可以执行的操作。 希望此练习能激发您进一步探索的兴趣！ diff --git a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/index.md b/translations/zh-CN/content/desktop/getting-started-with-github-desktop/index.md deleted file mode 100644 index 6a0530b6be42..000000000000 --- a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/index.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: GitHub Desktop 使用入门 -shortTitle: 入门指南 -intro: 设置 GitHub Desktop 来管理项目工作。 通过身份验证登录到 GitHub.com 或 GitHub Enterprise Server，确保应用程序为最新版本，然后审查您的偏好设置。 -redirect_from: - - /desktop/getting-started-with-github-desktop/setting-up-github-desktop/ -versions: - free-pro-team: '*' ---- - - -### 目录 - -{% topic_link_in_list /overview %} - {% link_in_list /creating-your-first-repository-using-github-desktop %} - {% link_in_list /keyboard-shortcuts %} - {% link_in_list /launching-github-desktop-from-the-command-line %} -{% topic_link_in_list /installing-and-authenticating-to-github-desktop %} - {% link_in_list /installing-github-desktop %} - {% link_in_list /authenticating-to-github %} - {% link_in_list /about-the-github-desktop-windows-installer-package %} - {% link_in_list /updating-github-desktop %} - {% link_in_list /uninstalling-github-desktop %} -{% topic_link_in_list /configuring-and-customizing-github-desktop %} - {% link_in_list /configuring-basic-settings %} - {% link_in_list /configuring-git-for-github-desktop %} - {% link_in_list /configuring-a-default-editor %} - {% link_in_list /setting-a-theme-for-github-desktop %} diff --git a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/installing-and-authenticating-to-github-desktop.md b/translations/zh-CN/content/desktop/getting-started-with-github-desktop/installing-and-authenticating-to-github-desktop.md deleted file mode 100644 index 90a7c61b254a..000000000000 --- a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/installing-and-authenticating-to-github-desktop.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: 安装 GitHub Desktop 并进行身份验证 -intro: 安装 GitHub Desktop，并连接您的 GitHub 或 GitHub Enterprise 帐户。 -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/installing-github-desktop.md b/translations/zh-CN/content/desktop/getting-started-with-github-desktop/installing-github-desktop.md deleted file mode 100644 index f8f8244b1109..000000000000 --- a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/installing-github-desktop.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: 安装 GitHub Desktop -intro: 您可以在受支持的 Microsoft Windows 或 macOS 操作系统上安装 GitHub Desktop。 -versions: - free-pro-team: '*' ---- - -在设置 {% data variables.product.prodname_desktop %}、{% data reusables.desktop.get-an-account %} 之前 - -### 下载并安装 {% data variables.product.prodname_desktop %} - -{% mac %} - -您可以在 {% data variables.desktop.mac-osx-versions %} 上安装 {% data variables.product.prodname_desktop %}。 - -{% data reusables.desktop.download-desktop-page %} -2. 选择 **Download for Mac（为 Mac 下载）**。 -3. 在计算机的 **Downloads** 文件夹中，双击 **{% data variables.product.prodname_desktop %}** zip 文件。 -4. 在文件解压缩之后，双击 **{% data variables.product.prodname_desktop %}**。 - -{% endmac %} - -{% windows %} - -您可以在 {% data variables.desktop.windows-versions %} 上安装 {% data variables.product.prodname_desktop %}。 - -{% warning %} - -**警告**：必须有 64 位操作系统才可运行 {% data variables.product.prodname_desktop %}。 - -{% endwarning %} - -{% data reusables.desktop.download-desktop-page %} -2. 选择 **Download for Windows（为 Windows 下载）**。 - - {% note %} - - **注：**如果您是网络管理员，便可使用 [{% data variables.product.prodname_desktop %} Windows 安装程序包](/desktop/guides/getting-started-with-github-desktop/about-the-github-desktop-windows-installer-package/)部署 {% data variables.product.prodname_desktop %}。 - - {% endnote %} - -3. 在计算机的 **Downloads** 文件夹中，双击 **{% data variables.product.prodname_desktop %}**。 -4. 在弹出窗口中，单击 **Install（安装）**。 -5. 在程序安装后，单击 **Run（运行）**。 - -{% endwindows %} - -### 设置 {% data variables.product.prodname_desktop %} - -在启动 {% data variables.product.prodname_desktop %} 后，可以选择立即设置 {% data variables.product.prodname_desktop %}，也可以跳过设置过程。 diff --git a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/keyboard-shortcuts-in-github-desktop.md b/translations/zh-CN/content/desktop/getting-started-with-github-desktop/keyboard-shortcuts-in-github-desktop.md deleted file mode 100644 index d24f491a5307..000000000000 --- a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/keyboard-shortcuts-in-github-desktop.md +++ /dev/null @@ -1,115 +0,0 @@ ---- -title: GitHub Desktop 中的键盘快捷键 -intro: '您可以在 {% data variables.product.prodname_desktop %} 中使用键盘快捷键。' -versions: - free-pro-team: '*' ---- - -{% mac %} - -MacOS 上的 GitHub Desktop 快捷键 - -### 站点快捷键 - -| 键盘快捷键 | 描述 | -| ------------------------------------ | ---------------------------------------------------------- | -| ⌘, | 进入 Preferences（首选项） | -| ⌘H | 隐藏 {% data variables.product.prodname_desktop %} 应用程序 | -| ⌥⌘H | 隐藏所有其他应用程序 | -| ⌘Q | 退出 {% data variables.product.prodname_desktop %} | -| ⌃⌘F | 切换全屏视图 | -| ⌘0 | 将缩放比例重置为默认的文本大小 | -| ⌘= | 放大文本和图形 | -| ⌘- | 缩小文本和图形 | -| ⌥⌘I | 切换开发者工具 | - -### 仓库 - -| 键盘快捷键 | Description | -| ------------------------------------ | ---------------------------------------------------------- | -| ⌘N | 新增仓库 | -| ⌘O | 添加本地仓库 | -| ⇧⌘O | 从 {% data variables.product.prodname_dotcom %} 克隆仓库 | -| ⌘T | 显示仓库列表 | -| ⌘P | 将最新提交推送到 {% data variables.product.prodname_dotcom %} | -| ⇧⌘P | 从 {% data variables.product.prodname_dotcom %} 拉取最新更改 | -| ⌘⌫ | 删除现有仓库 | -| ⇧⌘G | 在 {% data variables.product.prodname_dotcom %} 上查看仓库 | -| ⌃` | 在首选的终端工具中打开仓库 | -| ⇧⌘F | 在 Finder 中显示仓库 | -| ⇧⌘A | 在首选的编辑器工具中打开仓库 | -| ⌘I | 在 {% data variables.product.prodname_dotcom %} 上创建议题 | - -### 分支 - -| 键盘快捷键 | 描述 | -| ------------------------------------ | ------------------------------------------------------------- | -| ⌘1 | 在提交前显示所有更改 | -| ⌘2 | 显示提交历史记录 | -| ⌘B | 显示所有分支 | -| ⌘G | 转到提交摘要字段 | -| space | Select or deselect all highlighted files | -| ⇧⌘N | 创建新分支 | -| ⇧⌘R | 重命名当前分支 | -| ⇧⌘D | 删除当前分支 | -| ⇧⌘U | 从默认分支更新 | -| ⇧⌘B | 与现有分支比较 | -| ⇧⌘M | 合并到当前分支 | -| ⌃H | 显示或隐藏储存的更改 | -| ⇧⌘C | 比较 {% data variables.product.prodname_dotcom %} 上的分支 | -| ⌘R | 在 {% data variables.product.prodname_dotcom %} 上显示当前拉取请求 | - -{% endmac %} - -{% windows %} - -Windows 上的 GitHub Desktop 键盘快捷键 - -### 站点快捷键 - -| 键盘快捷键 | 描述 | -| ------------------------------------------- | --------------- | -| Ctrl, | 转到 Options（选项） | -| F11 | 切换全屏视图 | -| Ctrl0 | 将缩放比例重置为默认的文本大小 | -| Ctrl= | 放大文本和图形 | -| Ctrl- | 缩小文本和图形 | -| CtrlShiftI | 切换开发者工具 | - -### 仓库 - -| 键盘快捷键 | 描述 | -| ------------------------------------------- | ---------------------------------------------------------- | -| CtrlN | 新增仓库 | -| CtrlO | 添加本地仓库 | -| CtrlShiftO | 从 {% data variables.product.prodname_dotcom %} 克隆仓库 | -| CtrlT | 显示仓库列表 | -| CtrlP | 将最新提交推送到 {% data variables.product.prodname_dotcom %} | -| CtrlShiftP | 从 {% data variables.product.prodname_dotcom %} 拉取最新更改 | -| CtrlDelete | 删除现有仓库 | -| CtrlShiftG | 在 {% data variables.product.prodname_dotcom %} 上查看仓库 | -| Ctrl` | 在首选的命令行工具中打开仓库 | -| CtrlShiftF | 在 Explorer 中显示仓库 | -| CtrlShiftA | 在首选的编辑器工具中打开仓库 | -| CtrlI | 在 {% data variables.product.prodname_dotcom %} 上创建议题 | - -### 分支 - -| 键盘快捷键 | 描述 | -| ------------------------------------------- | ------------------------------------------------------------- | -| Ctrl1 | 在提交前显示所有更改 | -| Ctrl2 | 显示提交历史记录 | -| CtrlB | 显示所有分支 | -| CtrlG | 转到提交摘要字段 | -| space | Select or deselect all highlighted files | -| CtrlShiftN | 创建新分支 | -| CtrlShiftR | 重命名当前分支 | -| CtrlShiftD | 删除当前分支 | -| CtrlShiftU | 从默认分支更新 | -| CtrlShiftB | 与现有分支比较 | -| CtrlShiftM | 合并到当前分支 | -| CtrlH | 显示或隐藏储存的更改 | -| CtrlShiftC | 比较 {% data variables.product.prodname_dotcom %} 上的分支 | -| CtrlR | 在 {% data variables.product.prodname_dotcom %} 上显示当前拉取请求 | - -{% endwindows %} diff --git a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/keyboard-shortcuts.md b/translations/zh-CN/content/desktop/getting-started-with-github-desktop/keyboard-shortcuts.md deleted file mode 100644 index a16e5b9e83b9..000000000000 --- a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/keyboard-shortcuts.md +++ /dev/null @@ -1,117 +0,0 @@ ---- -title: 键盘快捷键 -redirect_from: - - /desktop/getting-started-with-github-desktop/keyboard-shortcuts-in-github-desktop/ -intro: '您可以在 {% data variables.product.prodname_desktop %} 中使用键盘快捷键。' -versions: - free-pro-team: '*' ---- - -{% mac %} - -MacOS 上的 GitHub Desktop 快捷键 - -### 站点快捷键 - -| 键盘快捷键 | 描述 | -| ------------------------------------ | ---------------------------------------------------------- | -| ⌘, | 进入 Preferences（首选项） | -| ⌘H | 隐藏 {% data variables.product.prodname_desktop %} 应用程序 | -| ⌥⌘H | 隐藏所有其他应用程序 | -| ⌘Q | 退出 {% data variables.product.prodname_desktop %} | -| ⌃⌘F | 切换全屏视图 | -| ⌘0 | 将缩放比例重置为默认的文本大小 | -| ⌘= | 放大文本和图形 | -| ⌘- | 缩小文本和图形 | -| ⌥⌘I | 切换开发者工具 | - -### 仓库 - -| 键盘快捷键 | Description | -| ------------------------------------ | ---------------------------------------------------------- | -| ⌘N | 新增仓库 | -| ⌘O | 添加本地仓库 | -| ⇧⌘O | 从 {% data variables.product.prodname_dotcom %} 克隆仓库 | -| ⌘T | 显示仓库列表 | -| ⌘P | 将最新提交推送到 {% data variables.product.prodname_dotcom %} | -| ⇧⌘P | 从 {% data variables.product.prodname_dotcom %} 拉取最新更改 | -| ⌘⌫ | 删除现有仓库 | -| ⇧⌘G | 在 {% data variables.product.prodname_dotcom %} 上查看仓库 | -| ⌃` | 在首选的终端工具中打开仓库 | -| ⇧⌘F | 在 Finder 中显示仓库 | -| ⇧⌘A | 在首选的编辑器工具中打开仓库 | -| ⌘I | 在 {% data variables.product.prodname_dotcom %} 上创建议题 | - -### 分支 - -| 键盘快捷键 | 描述 | -| ------------------------------------ | ------------------------------------------------------------- | -| ⌘1 | 在提交前显示所有更改 | -| ⌘2 | 显示提交历史记录 | -| ⌘B | 显示所有分支 | -| ⌘G | 转到提交摘要字段 | -| space | 选择或取消选择所有突出显示的文件 | -| ⇧⌘N | 创建新分支 | -| ⇧⌘R | 重命名当前分支 | -| ⇧⌘D | 删除当前分支 | -| ⇧⌘U | 从默认分支更新 | -| ⇧⌘B | 与现有分支比较 | -| ⇧⌘M | 合并到当前分支 | -| ⌃H | 显示或隐藏储存的更改 | -| ⇧⌘C | 比较 {% data variables.product.prodname_dotcom %} 上的分支 | -| ⌘R | 在 {% data variables.product.prodname_dotcom %} 上显示当前拉取请求 | - -{% endmac %} - -{% windows %} - -Windows 上的 GitHub Desktop 键盘快捷键 - -### 站点快捷键 - -| 键盘快捷键 | 描述 | -| ------------------------------------------- | --------------- | -| Ctrl, | 转到 Options（选项） | -| F11 | 切换全屏视图 | -| Ctrl0 | 将缩放比例重置为默认的文本大小 | -| Ctrl= | 放大文本和图形 | -| Ctrl- | 缩小文本和图形 | -| CtrlShiftI | 切换开发者工具 | - -### 仓库 - -| 键盘快捷键 | 描述 | -| ------------------------------------------- | ---------------------------------------------------------- | -| CtrlN | 新增仓库 | -| CtrlO | 添加本地仓库 | -| CtrlShiftO | 从 {% data variables.product.prodname_dotcom %} 克隆仓库 | -| CtrlT | 显示仓库列表 | -| CtrlP | 将最新提交推送到 {% data variables.product.prodname_dotcom %} | -| CtrlShiftP | 从 {% data variables.product.prodname_dotcom %} 拉取最新更改 | -| CtrlDelete | 删除现有仓库 | -| CtrlShiftG | 在 {% data variables.product.prodname_dotcom %} 上查看仓库 | -| Ctrl` | 在首选的命令行工具中打开仓库 | -| CtrlShiftF | 在 Explorer 中显示仓库 | -| CtrlShiftA | 在首选的编辑器工具中打开仓库 | -| CtrlI | 在 {% data variables.product.prodname_dotcom %} 上创建议题 | - -### 分支 - -| 键盘快捷键 | 描述 | -| ------------------------------------------- | ------------------------------------------------------------- | -| Ctrl1 | 在提交前显示所有更改 | -| Ctrl2 | 显示提交历史记录 | -| CtrlB | 显示所有分支 | -| CtrlG | 转到提交摘要字段 | -| space | 选择或取消选择所有突出显示的文件 | -| CtrlShiftN | 创建新分支 | -| CtrlShiftR | 重命名当前分支 | -| CtrlShiftD | 删除当前分支 | -| CtrlShiftU | 从默认分支更新 | -| CtrlShiftB | 与现有分支比较 | -| CtrlShiftM | 合并到当前分支 | -| CtrlH | 显示或隐藏储存的更改 | -| CtrlShiftC | 比较 {% data variables.product.prodname_dotcom %} 上的分支 | -| CtrlR | 在 {% data variables.product.prodname_dotcom %} 上显示当前拉取请求 | - -{% endwindows %} diff --git a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/launching-github-desktop-from-the-command-line.md b/translations/zh-CN/content/desktop/getting-started-with-github-desktop/launching-github-desktop-from-the-command-line.md deleted file mode 100644 index bddb3f7e7959..000000000000 --- a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/launching-github-desktop-from-the-command-line.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: 从命令行启动 GitHub Desktop -shortTitle: 从命令行启动 -intro: 您可以从命令行启动 GitHub Desktop。 -versions: - free-pro-team: '*' ---- - -{% mac %} - -1. 在菜单栏中，选择 **{% data variables.product.prodname_desktop %}** 菜单，然后单击 **Install Command Line Tool（安装命令行工具）**。 ![在 {% data variables.product.prodname_desktop %} 下拉菜单中安装命令行工具选项](/assets/images/help/desktop/mac-install-command-line-tool.png) -2. 打开终端。 -3. {% data reusables.desktop.launch-desktop-from-command-line %} - - ```shell - $ github /path/to/repo - ``` - - 您还可以更改为仓库路径，然后键入 `github .` 以打开该仓库。 - - ```shell - $ cd /path/to/repo - [repo]$ github . - ``` - -{% endmac %} - -{% windows %} - -1. 打开命令提示。 -2. {% data reusables.desktop.launch-desktop-from-command-line %} - - ```shell - C:\Users\octocat> github path\to\repo - ``` - - 您还可以更改为仓库路径，然后键入 `github .` 以打开该仓库。 - - ```shell - C:\Users\octocat> cd repo\myrepo - C:\Users\octocat\repo\myrepo> github . - ``` - -{% endwindows %} diff --git a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/overview.md b/translations/zh-CN/content/desktop/getting-started-with-github-desktop/overview.md deleted file mode 100644 index aba96a70fcf5..000000000000 --- a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/overview.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: 概览 -intro: 了解 GitHub Desktop 并快速创建您的第一个仓库。 -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/setting-a-theme-for-github-desktop.md b/translations/zh-CN/content/desktop/getting-started-with-github-desktop/setting-a-theme-for-github-desktop.md deleted file mode 100644 index fab20912b4f3..000000000000 --- a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/setting-a-theme-for-github-desktop.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: 设置 GitHub Desktop 的主题 -intro: 您可以设置主题以自定义 GitHub Desktop 的外观。 -versions: - free-pro-team: '*' ---- - -{% mac %} - -{% data reusables.desktop.mac-select-desktop-menu %} -{% data reusables.desktop.choose-a-theme %} - ![Mac 外观选项卡上的主题选项](/assets/images/help/desktop/mac-appearance-tab-themes.png) - -{% endmac %} - -{% windows %} - -{% data reusables.desktop.windows-choose-options %} -{% data reusables.desktop.choose-a-theme %} - ![Windows 外观选项卡上的主题选项](/assets/images/help/desktop/windows-appearance-tab-themes.png) - -{% endwindows %} diff --git a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/uninstalling-github-desktop.md b/translations/zh-CN/content/desktop/getting-started-with-github-desktop/uninstalling-github-desktop.md deleted file mode 100644 index 261659b6b5c4..000000000000 --- a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/uninstalling-github-desktop.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: 卸载 GitHub Desktop -intro: You can uninstall GitHub Desktop from your computer at any time. -versions: - free-pro-team: '*' ---- - -{% mac %} - -1. In a Finder window, navigate to the Applications folder. ![Applications folder in the Finder window](/assets/images/help/desktop/applications-folder.png) -2. While pressing the **Control** button on your keyboard, click **{% data variables.product.prodname_desktop %}**. -3. 选择 **Move to Trash（移至垃圾桶）**。 ![The Move to Trash option](/assets/images/help/desktop/mac-move-to-trash.png) -4. In the menu bar, use the **Finder** drop-down menu, then click **Empty Trash**. ![The Empty Trash option in the menu bar](/assets/images/help/desktop/mac-empty-trash-menu.png) -5. 阅读弹出框中的警告，并单击 **Empty Trash（清空垃圾桶）**。 ![The Empty Trash button](/assets/images/help/desktop/mac-empty-trash-button.png) - -{% endmac %} - -{% windows %} - -1. Open Control Panel. For more information, see [Where is Control Panel?](https://support.microsoft.com/en-us/help/13764/windows-where-is-control-panel) in Windows Help. -2. Under "Programs", click **Uninstall a program**. ![The Uninstall a Program option in Control Panel](/assets/images/help/desktop/windows-uninstall-a-program.png) -3. Right-click the entry named **{% data variables.product.prodname_desktop %}**, then click **Uninstall**. ![The Uninstall option](/assets/images/help/desktop/windows-click-uninstall.png) - -{% endwindows %} diff --git a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/updating-github-desktop.md b/translations/zh-CN/content/desktop/getting-started-with-github-desktop/updating-github-desktop.md deleted file mode 100644 index 290fae22f681..000000000000 --- a/translations/zh-CN/content/desktop/getting-started-with-github-desktop/updating-github-desktop.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: 更新 GitHub Desktop -intro: GitHub Desktop 在您重新启动时自动下载并安装更新。 您也可以手动检查更新。 -versions: - free-pro-team: '*' ---- - -{% mac %} - -1. 在 **GitHub Desktop** 菜单中，单击 **About GitHub Desktop（关于 GitHub Desktop）**。 ![关于 GitHub Desktop 菜单选项](/assets/images/help/desktop/desktop-menu-about-desktop-mac.png) -2. 单击 **Check for Updates（检查更新）**。 ![检查更新按钮](/assets/images/help/desktop/check-for-updates.png) -3. 如果更新可用，请退出并重新启动 {% data variables.product.prodname_desktop %} 以安装更新。 - -{% endmac %} - -{% windows %} - -1. 在 **Help（帮助）** 菜单中，单击 **About GitHub Desktop（关于 GitHub Desktop）**。 ![关于 GitHub Desktop 菜单选项](/assets/images/help/desktop/help-about-desktop-win.png) -2. 单击 **Check for Updates（检查更新）**。 ![检查更新按钮](/assets/images/help/desktop/check-for-updates.png) -3. 如果更新可用，请退出并重新启动 {% data variables.product.prodname_desktop %} 以安装更新。 - -{% endwindows %} diff --git a/translations/zh-CN/content/github/administering-a-repository/about-github-dependabot.md b/translations/zh-CN/content/github/administering-a-repository/about-github-dependabot.md deleted file mode 100644 index efc74912373f..000000000000 --- a/translations/zh-CN/content/github/administering-a-repository/about-github-dependabot.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: 关于 GitHub Dependabot -intro: '您可以使用 {% data variables.product.prodname_dependabot %} 来确保您使用的包更新到最新版本。' -versions: - free-pro-team: '*' ---- - -{% data reusables.dependabot.beta-note %} - -### 关于 {% data variables.product.prodname_dependabot %} - -{% data variables.product.prodname_dependabot %} 是一款 {% data variables.product.prodname_dotcom %} 应用程序，它负责维护您的依赖项。 您可以使用它来确保仓库自动跟上它所依赖的包和应用程序的最新版本。 - -通过将配置文件检入仓库，可启用 {% data variables.product.prodname_dependabot_version_updates %}。 配置文件指定存储在仓库中的清单或其他包定义文件的位置。 该应用程序使用此信息来检查过时的包和应用程序。 The {% data variables.product.prodname_dependabot_short %} app determines if there is a new version of a dependency by looking at the semantic versioning ([semver](https://semver.org/)) of the dependency to decide whether it should update to that version. 当应用程序发现过时的依赖项时，它会发起拉取请求以将清单更新到依赖项的最新版本。 检查测试是否通过，查看拉取请求摘要中包含的更改日志和发行说明，然后合并它。 更多信息请参阅“[启用和禁用版本更新](/github/administering-a-repository/enabling-and-disabling-version-updates)”。 - -如果启用安全更新，{% data variables.product.prodname_dependabot %} 还会发起拉取请求以更新易受攻击依赖项。 更多信息请参阅“[配置 {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-github-dependabot-security-updates)。” - -{% data reusables.dependabot.dependabot-tos %} - -### {% data variables.product.prodname_dependabot %} 拉取请求的频率 - -在配置文件中指定检查每个生态系统的新版本的频率：每日、每周或每月。 - -{% data reusables.dependabot.initial-updates %} - -如果您启用了安全更新，有时会看到额外的安全更新拉取请求。 这些由针对默认分支上依赖项的 Dependabot 警报触发。 {% data variables.product.prodname_dependabot %} 自动提出拉取请求以更新有漏洞的依赖项。 - -### 支持的仓库和生态系统 - -您可以为包含其中一个受支持包管理器的依赖项清单或锁定文件的仓库配置版本更新。 - -{% data reusables.dependabot.supported-package-managers %} - -如果您的仓库已使用集成进行依赖项管理，则在启用 {% data variables.product.prodname_dependabot %} 前需要禁用此集成。 更多信息请参阅“[关于集成](/github/customizing-your-github-workflow/about-integrations)”。 diff --git a/translations/zh-CN/content/github/administering-a-repository/setting-the-default-branch.md b/translations/zh-CN/content/github/administering-a-repository/setting-the-default-branch.md deleted file mode 100644 index 5017a55a3f2c..000000000000 --- a/translations/zh-CN/content/github/administering-a-repository/setting-the-default-branch.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: 设置默认分支 -intro: 'If you have more than one branch in your repository, you can choose another branch to be the default branch.' -redirect_from: - - /articles/setting-the-default-branch -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -### About the default branch - -{% data reusables.branches.new-repo-default-branch %} {% data reusables.branches.default-branch-automatically-base-branch %} If you have more than one branch in your repository, anyone with admin rights over a repository can select one of these existing branches as the default branch on the repository. - -### 设置默认分支 - -{% note %} - -**Note:** To set the default branch you must have more than one branch in your repository. - -{% endnote %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -{% data reusables.repositories.repository-branches %} -4. In the default branch drop-down, choose the new default branch. ![默认分支下拉选择器](/assets/images/help/repository/repository-options-defaultbranch.png) -5. Click **Update**. - -您只能在 {% data variables.product.product_location %} 上已存在的分支之间切换。 要通过 UI 创建新分支，请参阅“[创建和删除仓库中的分支](/articles/creating-and-deleting-branches-within-your-repository)”。 - -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} - -You can also set the default branch name for any newly created repositories owned by your user account, organization, or enterprise account. For more information, see "[Managing the default branch for your repositories](/github/setting-up-and-managing-your-github-user-account/managing-the-default-branch-name-for-your-repositories)", "[Managing the default branch name for repositories in your organization](/github/setting-up-and-managing-organizations-and-teams/managing-the-default-branch-name-for-repositories-in-your-organization), or "[Enforcing a policy on the default branch name](/github/setting-up-and-managing-your-enterprise-account/enforcing-repository-management-policies-in-your-enterprise-account#enforcing-a-policy-on-the-default-branch-name)." - -{% endif %} - -{% warning %} - -**Warning**: Setting a different default branch affects your `trunk` branch contents on the [Git-Subversion bridge](https://github.com/blog/1178-collaborating-on-github-with-subversion) and the `HEAD` you'd see when you `git ls-remote` this [repository's upstream URL](https://git-scm.com/docs/git-ls-remote.html). - -{% endwarning %} diff --git a/translations/zh-CN/content/github/articles/README.md b/translations/zh-CN/content/github/articles/README.md deleted file mode 100644 index 1eaef8c78676..000000000000 --- a/translations/zh-CN/content/github/articles/README.md +++ /dev/null @@ -1,5 +0,0 @@ -# Hidden GitHub.com articles - -GitHub.com/Enterprise User articles that have `hidden: true` frontmatter live in this directory. - -See [`content/README`](../README.md#hidden-pages) for more about hidden pages. diff --git a/translations/zh-CN/content/github/articles/about-the-github-and-visual-studio-bundle.md b/translations/zh-CN/content/github/articles/about-the-github-and-visual-studio-bundle.md deleted file mode 100644 index 8d8be0e31af8..000000000000 --- a/translations/zh-CN/content/github/articles/about-the-github-and-visual-studio-bundle.md +++ /dev/null @@ -1,54 +0,0 @@ ---- -title: 关于 GitHub 和 Visual Studio 包 -hidden: true -redirect_from: - - /articles/about-the-github-and-visual-studio-bundle -versions: - free-pro-team: '*' ---- - -{% tip %} - -**提示**： -- 仅组织所有者才可邀请用户加入组织。 更多信息请参阅“[组织的权限级别](/articles/permission-levels-for-an-organization)”。 - -{% endtip %} - - -### 本文内容 -- [关于 {% data variables.product.prodname_enterprise %} 和 Visual Studio 包许可](#about-github-enterprise-and-visual-studio-bundle-licenses) -- [分配 {% data variables.product.prodname_enterprise %} 用户许可](#assigning-a-github-enterprise-user-license) -- [用户许可过度分配](#overallocation-of-user-licenses) - - -### 关于 {% data variables.product.prodname_enterprise %} 和 Visual Studio 包许可 - -已经购买 {% data variables.product.prodname_dotcom %}-Visual Studio 包的客户有资格获得 {% data variables.product.prodname_enterprise %} 用户许可。 这些许可在 {% data variables.product.prodname_dotcom %} 企业帐户中配置，与 Microsoft 企业协议关联，可分配给组织成员。 - -当企业中的组织所有者邀请新用户加入组织时，他们可选择是否从 {% data variables.product.prodname_enterprise %} 或订阅了 Visual Studio 的 {% data variables.product.prodname_enterprise %} 分配新用户许可。 - -### 分配 {% data variables.product.prodname_enterprise %} 用户许可 - -{% data reusables.profile.access_profile %} -{% data reusables.profile.access_org %} -{% data reusables.organizations.people %} -{% data reusables.organizations.invite_member_from_people_tab %} -{% data reusables.organizations.invite_to_org %} -{% data reusables.organizations.choose-to-restore-privileges %} -{% data reusables.organizations.choose-user-role %} -{% data reusables.organizations.choose-user-license %} -{% data reusables.organizations.add-user-to-teams %} -{% data reusables.organizations.send-invitation %} -{% data reusables.organizations.user_must_accept_invite_email %} {% data reusables.organizations.cancel_org_invite %} - -### 用户许可过度分配 - -您可以在企业帐户的帐单设置中查看已经用于 {% data variables.product.prodname_enterprise %} 和订阅了 Visual Studio 的 {% data variables.product.prodname_enterprise %} 的许可总数。 - -如果组织和企业所有者分配给用户的 {% data variables.product.prodname_enterprise %} (Visual Studio) 订阅许可超过订阅中包含的许可，则您的下一张调整发票将包含超过订阅允许数量的用户数所对应的费用。 - -更多信息请参阅"[查看企业帐户的订阅和使用](/articles/viewing-the-subscription-and-usage-for-your-enterprise-account)"。 - -### 延伸阅读 -- "[向团队添加组织成员](/articles/adding-organization-members-to-a-team)" -- 如果您的组织[需要成员使用双重身份验证](/articles/requiring-two-factor-authentication-in-your-organization)，则您邀请的用户必须[启用双重身份验证](/articles/securing-your-account-with-two-factor-authentication-2fa)，然后才可接受邀请。 diff --git a/translations/zh-CN/content/github/articles/managing-your-disabled-github-pages-site.md b/translations/zh-CN/content/github/articles/managing-your-disabled-github-pages-site.md deleted file mode 100644 index 3ee52ae9a538..000000000000 --- a/translations/zh-CN/content/github/articles/managing-your-disabled-github-pages-site.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: 管理禁用的 GitHub 页面站点 -intro: '{% data variables.product.prodname_free_user %} 上的私有仓库不支持 {% data variables.product.prodname_pages %}，但少量连接到免费私有仓库的 {% data variables.product.prodname_pages %} 站点被误保留为活动。 这些站点不再更新，将在 2019 年 5 月 10 日被 {% data variables.product.prodname_dotcom %} 取消发布。' -hidden: true -redirect_from: - - /articles/managing-your-disabled-github-pages-site -versions: - free-pro-team: '*' ---- - -{% note %} - -{% data variables.product.prodname_pages %} 仅可用于具有 {% data variables.product.prodname_free_user %} 的公共仓库，以及具有 {% data variables.product.prodname_pro %}、{% data variables.product.prodname_team %}、{% data variables.product.prodname_ghe_cloud %} 和 {% data variables.product.prodname_ghe_server %} 的公共和私有仓库。 {% data reusables.gated-features.more-info %} - -{% endnote %} - -如果您在免费私有仓库中发布了 {% data variables.product.prodname_pages %} 站点，将有几个选项可用于继续发布和更新站点，或者手动取消发布站点。 如果您不执行操作，{% data variables.product.prodname_dotcom %} 将在 2019 年 5 月 10 日为您取消发布站点。 - -- **要继续发布和更新 {% data variables.product.prodname_pages %} 站点**，您可以将仓库设为公共，或者将帐户升级到 {% data variables.product.prodname_pro %}。 有关如何将私有仓库设为公共的更多信息，请参阅“[设置仓库可见性](/articles/setting-repository-visibility#making-a-private-repository-public)”。有关升级帐户的信息，请参阅“[升级 GitHub 订阅](/articles/upgrading-your-github-subscription)”。 - -- **要停止发布 {% data variables.product.prodname_pages %} 站点**，您可以[手动取消发布](#manually-unpublishing-your-github-pages-site)，或者不采取任何措施，等到 2019 年 5 月 10 日，{% data variables.product.prodname_dotcom %} 将为您取消发布站点。 如果您的 {% data variables.product.prodname_pages %} 站点设置了自定义域，您应尽快通过 DNS 提供商更新或删除 DNS 记录，以避免域接管的风险。 在 {% data variables.product.prodname_pages %} 站点禁用时通过 DNS 提供商配置自定义域，可能导致其他人在您的一个子域上托管站点。 更多信息请参阅“[对 {% data variables.product.prodname_pages %} 使用自定义域](/articles/using-a-custom-domain-with-github-pages)”。 - -### 手动取消发布 {% data variables.product.prodname_pages %} 站点 - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -3. 在左侧边栏中，单击 **Unpublish {% data variables.product.prodname_pages %}（取消发布站点）**。 ![用于取消发布 {% data variables.product.prodname_pages %} 站点的 Repo 设置](/assets/images/help/pages/unpublish-pages-button-sidebar.png) -4. 单击 **Unpublish this site（取消发布此站点）**。 ![用于取消发布 {% data variables.product.prodname_pages %} 站点的按钮](/assets/images/help/pages/unpublish-pages-button.png) - -### 延伸阅读 - -- "[取消发布用户页面站点](articles/unpublishing-a-user-pages-site)" -- "[取消发布项目页面站点](/articles/unpublishing-a-project-pages-site)" -- "[转让仓库](/articles/transferring-a-repository)" -- "[关于存档仓库](/articles/about-archiving-repositories)" -- "[删除仓库](/articles/deleting-a-repository)" diff --git a/translations/zh-CN/content/github/articles/searching-and-navigating-code.md b/translations/zh-CN/content/github/articles/searching-and-navigating-code.md deleted file mode 100644 index 1429712693d8..000000000000 --- a/translations/zh-CN/content/github/articles/searching-and-navigating-code.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: 搜索和导航代码 -intro: 搜索和导航代码是开发工作流程的重要组成部分，GitHub 正不断改进这些领域： 如果您是选择采用代码搜索和导航专用测试版的组织的成员，将可以访问功能强大的新搜索和导航工具。 有关此专用测试版的其他问题，请发送电子邮件至 search-beta@github.com。 -hidden: true -redirect_from: - - /articles/searching-and-navigating-code -versions: - free-pro-team: '*' ---- - - -### 本文内容 - -- [文字代码搜索](#literal-code-search) -- [相关性](#relevancy) -- [跳至导航](#jump-to-navigation) - -### 文字代码搜索 - -在此专用测试版之前，从搜索索引中删除了许多符号，这意味着如 `>>` 之类的惯用内容不可搜索。 例如，在仓库中搜索 `>>` 时，将返回零结果。 使用专用测试版时，您可以将符号包含在双引号中，然后便可查看正确的结果。 此功能并非仅限于符号，可让您搜索引号内的完整短语，如 `"return [] unless"`。 此功能适用于所有语言的代码搜索。 - -### 相关性 - -对于语言的子集（Go、JavaScript、Python、Ruby 和 TypeScript），代码搜索现在可调节声明的相关性。 方法、函数、类或其他实体的声明将在包含相同搜索词的调用或注释之前返回。 - -### 跳至导航 - -对于语言的子集（Go、JavaScript、Python、Ruby 和 TypeScript），GitHub 现在支持单击符号时的其他信息和导航。 此导航包括跳至仓库内资源的定义导航，从而能够更快地导航和提高洞察力。 - -### 反馈 - -当前选择采用代码搜索和导航专用测试版的所有用户均可通过进行[此调查](https://www.research.net/r/CodeSearch-Navigation)提供反馈。 有关其他反馈和问题，请发送电子邮件至 search-beta@github.com。 - -### 延伸阅读 -- [关于在 GitHub 上搜索](/articles/about-searching-on-github/) -- [在拉取请求中查找已更改的方法和函数](/articles/finding-changed-methods-and-functions-in-a-pull-request/) diff --git a/translations/zh-CN/content/github/articles/using-gist-playground.md b/translations/zh-CN/content/github/articles/using-gist-playground.md deleted file mode 100644 index 4f45922ea535..000000000000 --- a/translations/zh-CN/content/github/articles/using-gist-playground.md +++ /dev/null @@ -1,45 +0,0 @@ ---- -title: 使用 Gist Playground -intro: '' -hidden: true -redirect_from: - - /articles/articles/using-gist-playground -versions: - free-pro-team: '*' ---- - -{% note %} - -**注：**Gist Playground 可作为受限的专用测试版程序提供，受早期访问协议约束。 - -{% endnote %} - -### 本文内容 -- [关于 Gist Playground](#about-gist-playground) -- [创建新 gist](#creating-new-gists) -- [保存更改](#saving-your-changes) -- [与其他人协作](#collaborating-with-others) -- [报告漏洞和反馈](#reporting-bugs-and-feedback) - -### 关于 Gist Playground -Gist Playground 是 [Gist](https://gist.github.com/) 的实验性迭代。 当您与好友及同事一起协作时，您的更改将自动保存。 - -### 创建新 gist -访问 Gist Playground 时将自动创建新草稿或显示最近的草稿。 准备好创建和共享 gist 后，单击标题中的 **Create gist（创建 gist）**。 - -Gist Playground 中创建的所有 gist 均为*机密*。 目前没有任何途径可从 Gist Playground 内将 gist 设为公开。 如果想要将 gist 设为公开，您可以使用现有的 [Gist](https://gist.github.com/) 进行此操作。 - -### 保存更改 -您的更改随着输入自动保存。 您可以随时关闭选项卡，然后返回而不丢失任何工作。 - -位于检查点后，您可以单击标题中的 **Update gist（更新 gist）**更新带有这些更改的 gist。 - -### 与其他人协作 -您可以与加入 Gist Playground 专用测试版的任何其他人协作。 在“Invite to collaborate（邀请协作）”下，单击协作 URL 进行复制，将该 URL 发送给好友，然后便可一起进行更改。 - -位于检查点后，gist 的所有者可通过单击 **Update gist（更新 gist）**保留更改。 - -如果想要与未加入 Gist Playground 专用测试版的人员协作，请发送电子邮件至 [gist-playground@github.com](mailto:gist-playground@github.com) 联系我们，看看能否添加这些人员。 - -### 报告漏洞和反馈 -我们很乐意聆听您关于 Gist Playground 以及如何让它变得更好的想法！ 发送电子邮件至 [gist-playground@github.com](mailto:gist-playground@github.com)，告诉我们您的任何想法、反馈或漏洞。 diff --git a/translations/zh-CN/content/github/committing-changes-to-your-project/why-are-my-commits-in-the-wrong-order.md b/translations/zh-CN/content/github/committing-changes-to-your-project/why-are-my-commits-in-the-wrong-order.md deleted file mode 100644 index a55813559c61..000000000000 --- a/translations/zh-CN/content/github/committing-changes-to-your-project/why-are-my-commits-in-the-wrong-order.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: 为什么我的提交顺序不正确？ -intro: 如果您通过 `git rebase` 或强制推送来重写提交历史记录，可能会发现打开拉取请求时提交顺序不正确。 -redirect_from: - - /articles/why-are-my-commits-in-the-wrong-order -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -GitHub 强调将拉取请求视为讨论的空间。 其所有方面（评论、引用和提交）均按时间顺序显示。 [执行变基时](/articles/about-git-rebase)重写 Git 提交历史记录会更改时空连续体，这意味着提交可能不会按您预期的方式在 GitHub 界面中显示。 - -如果想要按顺序查看提交，我们建议不要使用 `git rebase`。 不过请放心，尽管您看到的内容没有按时间顺序排列，但不会破坏任何内容！ diff --git a/translations/zh-CN/content/github/developing-online-with-codespaces/connecting-to-your-codespace-from-visual-studio-code.md b/translations/zh-CN/content/github/developing-online-with-codespaces/connecting-to-your-codespace-from-visual-studio-code.md deleted file mode 100644 index 5c0ac9cbe1cc..000000000000 --- a/translations/zh-CN/content/github/developing-online-with-codespaces/connecting-to-your-codespace-from-visual-studio-code.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: 从 Visual Studio Code 连接到代码空间 -intro: '您可以将 {% data variables.product.prodname_vs_codespaces %} 扩展连接到您在 {% data variables.product.product_name %} 上的帐户，直接在 {% data variables.product.prodname_vscode %} 代码空间中开发。' -product: '{% data reusables.gated-features.codespaces %}' -versions: - free-pro-team: '*' ---- - -{% data reusables.codespaces.release-stage %} - -### 将 {% data variables.product.prodname_vs_codespaces %} 扩展连接到您的 {% data variables.product.prodname_dotcom %} 帐户 - -直接在 {% data variables.product.prodname_vscode %} 的代码空间中开发之前，您必须配置 {% data variables.product.prodname_vs_codespaces %} 扩展连接到您的 {% data variables.product.product_name %} 帐户。 - -1. 使用 {% data variables.product.prodname_vs %} Marketplace 安装 [{% data variables.product.prodname_vs_codespaces %}](https://marketplace.visualstudio.com/items?itemName=ms-vsonline.vsonline) 扩展。 更多信息请参阅 {% data variables.product.prodname_vscode %} 文档中的[扩展 Marketplace](https://code.visualstudio.com/docs/editor/extension-gallery)。 -2. 在 {% data variables.product.prodname_vscode %} 中，从左侧边栏单击 Extensions（扩展）图标。 ![{% data variables.product.prodname_vscode %} 中的 Extensions（扩展）图标](/assets/images/help/codespaces/click-extensions-icon-vscode.png) -3. 在 {% data variables.product.prodname_vs_codespaces %} 下面，单击 Manage（管理）图标，然后单击 **Extension Settings（扩展设置）**。 ![Extension Settings（扩展设置）选项](/assets/images/help/codespaces/select-extension-settings.png) -4. 使用“Vsonline: Account Provider（Vsonline：帐户提供商）”下拉菜单，选择 {% data variables.product.prodname_dotcom %}。 ![设置帐户提供者为 {% data variables.product.prodname_dotcom %}](/assets/images/help/codespaces/select-account-provider-vscode.png) -{% data reusables.codespaces.click-remote-explorer-icon-vscode %} -6. 如果尚未在标题中选择 {% data variables.product.prodname_codespaces %}，请单击 **{% data variables.product.prodname_codespaces %}**。 ![{% data variables.product.prodname_codespaces %} 标头](/assets/images/help/codespaces/codespaces-header-vscode.png) -7. 单击 **Sign in to view {% data variables.product.prodname_codespaces %}...（登录以查看 Codespaces...）**。 ![登录以查看 {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/sign-in-to-view-codespaces-vscode.png) -8. 要授权 {% data variables.product.prodname_vscode %} 访问您在 {% data variables.product.product_name %} 上的帐户，请单击 **Allow（允许）**。 -9. 登录 {% data variables.product.product_name %} 以审批扩展。 - -### 在 {% data variables.product.prodname_vscode %} 中打开代码空间 - -将 {% data variables.product.product_name %} 帐户连接到 {% data variables.product.prodname_vs_codespaces %} 扩展后，您可以在 {% data variables.product.prodname_vscode %} 中的 {% data variables.product.product_name %} 上直接创建的代码空间中进行开发。 - -{% data reusables.codespaces.click-remote-explorer-icon-vscode %} -2. 在 Codespaces（代码空间）下，单击您要在其中开发的代码空间。 -3. 单击 Connect to Codespace（连接到代码空间）图标。 ![{% data variables.product.prodname_vscode %} 中的连接到代码空间图标](/assets/images/help/codespaces/click-connect-to-codespace-icon-vscode.png) diff --git a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-for-compiled-languages.md b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-for-compiled-languages.md deleted file mode 100644 index 6dcad5283d3b..000000000000 --- a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-for-compiled-languages.md +++ /dev/null @@ -1,137 +0,0 @@ ---- -title: Configuring code scanning for compiled languages -shortTitle: Configuring for compiled languages -intro: 'You can configure how {% data variables.product.prodname_dotcom %} scans code written in compiled languages for vulnerabilities and errors.' -product: '{% data reusables.gated-features.code-scanning %}' -permissions: '拥有仓库写入权限的人可配置仓库的 {% data variables.product.prodname_code_scanning %}。' -versions: - free-pro-team: '*' ---- - -{% data reusables.code-scanning.beta %} - -{% note %} - -**Note**: This article refers to {% data variables.product.prodname_code_scanning %} powered by {% data variables.product.prodname_codeql %}, not to {% data variables.product.prodname_code_scanning %} resulting from the upload of third-party static analysis tools. - -{% endnote %} - -### About {% data variables.product.prodname_code_scanning %} and compiled languages - -To enable {% data variables.product.prodname_code_scanning %} for your repository, you add to the repository a {% data variables.product.prodname_actions %} workflow which includes {% data variables.product.prodname_codeql %} analysis. 更多信息请参阅“[启用 {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning)”。 - -{% data reusables.code-scanning.edit-workflow %} -For more information about configuring {% data variables.product.prodname_code_scanning %} and editing workflow files, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)" and "[Configuring a workflow](/actions/configuring-and-managing-workflows/configuring-a-workflow)." - -### About autobuild for {% data variables.product.prodname_codeql %} - -{% data reusables.code-scanning.autobuild-compiled-languages %} - -{% note %} - -**Note**: If you use self-hosted runners for {% data variables.product.prodname_actions %}, you may need to install additional software to use the `autobuild` process. Additionally, if your repository requires a specific version of a build tool, you may need to install it manually. 更多信息请参阅“[GitHub-hosted 运行器上安装的软件](/actions/reference/software-installed-on-github-hosted-runners)”。 - -{% endnote %} - -#### C/C++ - -| Supported system type | System name | -| --------------------- | ----------------------------------------------------------- | -| 操作系统 | Windows and Linux | -| Build system | Autoconf, CMake, qmake, Meson, Waf, SCons, and Linux Kbuild | - -The behavior of the `autobuild` step varies according to the operating system that the extraction runs on. On Windows, the step has no default actions. On Linux, this step reviews the files present in the repository to determine the build system used: - -1. Look for a build system in the root directory. -2. If none are found, search subdirectories for a unique directory with a build system for C/C++. -3. Run an appropriate command to configure the system. - -#### C - -| Supported system type | System name | -| --------------------- | ------------------------------------------ | -| 操作系统 | Windows and Linux | -| Build system | .NET and MSbuild, as well as build scripts | - -The `autobuild` process attempts to autodetect a suitable build method for C# using the following approach: - -1. Invoke `dotnet build` on the solution (`.sln`) or project (`.csproj`) file closest to the root. -2. Invoke `MSbuild` (Linux) or `MSBuild.exe` (Windows) on the solution or project file closest to the root. If `autobuild` detects multiple solution or project files at the same (shortest) depth from the top level directory, it will attempt to build all of them. -3. Invoke a script that looks like a build script—_build_ and _build.sh_ (in that order, for Linux) or _build.bat_, _build.cmd_, _and build.exe_ (in that order, for Windows). - - -#### Java - -| Supported system type | System name | -| --------------------- | ----------------------------------------- | -| 操作系统 | Windows, macOS and Linux (no restriction) | -| Build system | Gradle, Maven and Ant | - -The `autobuild` process tries to determine the build system for Java codebases by applying this strategy: - -1. Search for a build file in the root directory. Check for Gradle then Maven then Ant build files. -2. Run the first build file found. If both Gradle and Maven files are present, the Gradle file is used. -3. Otherwise, search for build files in direct subdirectories of the root directory. If only one subdirectory contains build files, run the first file identified in that subdirectory (using the same preference as for 1). If more than one subdirectory contains build files, report an error. - -### 添加编译语言的构建步骤 - -{% data reusables.code-scanning.autobuild-add-build-steps %} For information about editing the workflow, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#editing-a-code-scanning-workflow)." - -After removing the `autobuild` step, uncomment the `run` step and add build commands that are suitable for your repository. The workflow `run` step runs command-line programs using the operating system's shell. 您可以修改这些命令并添加更多命令来自定义构建过程。 - -``` yaml -- run: | - make bootstrap - make release -``` - -有关 `run` 关键词的更多信息，请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)”。 - -You can also use a build matrix to update the workflow to build more than one compiled language, if this is the appropriate approach for your system and doesn't cause conflicts. For more information, see "[Configuring a build matrix](/actions/configuring-and-managing-workflows/configuring-a-workflow#configuring-a-build-matrix)." - - -For example, the workflow below runs one job for C/C++ analysis, and another job for Java analysis. - -```yaml - -name: "Code Scanning - Action" - -on: - pull_request: - branches: [master] - push: - branches: [master] - -jobs: - CodeQL-Build: - - strategy: - fail-fast: false - matrix: - language: [ 'cpp', 'java'] - - # CodeQL runs on ubuntu-latest, windows-latest, and macos-latest - runs-on: ubuntu-latest - - steps: - - name: Checkout repository - uses: actions/checkout@v2 - - # Initializes the CodeQL tools for scanning. - - name: Initialize CodeQL - uses: github/codeql-action/init@v1 - with: - languages: ${{ matrix.language }} - - # Autobuild attempts to build any compiled languages (C/C++, C#, or Java). - # If this step fails, then you should remove it and run the build manually. - - name: Autobuild - uses: github/codeql-action/autobuild@v1 - - - name: Perform CodeQL Analysis - uses: github/codeql-action/analyze@v1 -``` - -For more tips and tricks about why `autobuild` won't build your code, see "[Troubleshooting {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning)". - -If you added manual build steps for compiled languages or used a build matrix and {% data variables.product.prodname_code_scanning %} is still not working on your repository, contact {% data variables.contact.contact_support %}. diff --git a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages.md b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages.md deleted file mode 100644 index c40d58784eb1..000000000000 --- a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages.md +++ /dev/null @@ -1,146 +0,0 @@ ---- -title: Configuring the CodeQL action for compiled languages -shortTitle: Configuring for compiled languages -intro: 'You can configure how {% data variables.product.prodname_dotcom %} uses the {% data variables.product.prodname_codeql_workflow %} to scan code written in compiled languages for vulnerabilities and errors.' -product: '{% data reusables.gated-features.code-scanning %}' -permissions: '拥有仓库写入权限的人可配置仓库的 {% data variables.product.prodname_code_scanning %}。' -redirect_from: - - /github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning-for-compiled-languages -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.code-scanning.beta %} -{% data reusables.code-scanning.enterprise-enable-code-scanning-actions %} - -### About the {% data variables.product.prodname_codeql_workflow %} and compiled languages - -To enable {% data variables.product.prodname_code_scanning %} for your repository, you add to the repository a {% data variables.product.prodname_actions %} workflow which includes {% data variables.product.prodname_codeql %} analysis. 更多信息请参阅“[启用 {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning)”。 For {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %}, you add the {% data variables.product.prodname_codeql_workflow %}. 默认 {% data variables.product.prodname_code_scanning %} 工作流程使用 `on.push` 事件触发代码扫描 - 每次推送到任何包含工作流程文件的分支时触发。 - -{% data reusables.code-scanning.edit-workflow %} -For general information about configuring {% data variables.product.prodname_code_scanning %} and editing workflow files, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)" and "[Configuring a workflow](/actions/configuring-and-managing-workflows/configuring-a-workflow)." - -### About autobuild for {% data variables.product.prodname_codeql %} - -{% data reusables.code-scanning.autobuild-compiled-languages %} - -{% note %} - -**Note**: If you use self-hosted runners for {% data variables.product.prodname_actions %}, you may need to install additional software to use the `autobuild` process. Additionally, if your repository requires a specific version of a build tool, you may need to install it manually. 更多信息请参阅“[GitHub-hosted 运行器上安装的软件](/actions/reference/software-installed-on-github-hosted-runners)”。 - -{% endnote %} - -#### C/C++ - -| Supported system type | System name | -| --------------------- | ----------------------------------------------------------- | -| 操作系统 | Windows and Linux | -| Build system | Autoconf, CMake, qmake, Meson, Waf, SCons, and Linux Kbuild | - -The behavior of the `autobuild` step varies according to the operating system that the extraction runs on. On Windows, the step has no default actions. On Linux, this step reviews the files present in the repository to determine the build system used: - -1. Look for a build system in the root directory. -2. If none are found, search subdirectories for a unique directory with a build system for C/C++. -3. Run an appropriate command to configure the system. - -#### C - -| Supported system type | System name | -| --------------------- | ------------------------------------------ | -| 操作系统 | Windows and Linux | -| Build system | .NET and MSbuild, as well as build scripts | - -The `autobuild` process attempts to autodetect a suitable build method for C# using the following approach: - -1. Invoke `dotnet build` on the solution (`.sln`) or project (`.csproj`) file closest to the root. -2. Invoke `MSbuild` (Linux) or `MSBuild.exe` (Windows) on the solution or project file closest to the root. If `autobuild` detects multiple solution or project files at the same (shortest) depth from the top level directory, it will attempt to build all of them. -3. Invoke a script that looks like a build script—_build_ and _build.sh_ (in that order, for Linux) or _build.bat_, _build.cmd_, _and build.exe_ (in that order, for Windows). - -#### Java - -| Supported system type | System name | -| --------------------- | ----------------------------------------- | -| 操作系统 | Windows, macOS and Linux (no restriction) | -| Build system | Gradle, Maven and Ant | - -The `autobuild` process tries to determine the build system for Java codebases by applying this strategy: - -1. Search for a build file in the root directory. Check for Gradle then Maven then Ant build files. -2. Run the first build file found. If both Gradle and Maven files are present, the Gradle file is used. -3. Otherwise, search for build files in direct subdirectories of the root directory. If only one subdirectory contains build files, run the first file identified in that subdirectory (using the same preference as for 1). If more than one subdirectory contains build files, report an error. - -### 添加编译语言的构建步骤 - -{% data reusables.code-scanning.autobuild-add-build-steps %} For information about editing the workflow, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#editing-a-code-scanning-workflow)." - -After removing the `autobuild` step, uncomment the `run` step and add build commands that are suitable for your repository. The workflow `run` step runs command-line programs using the operating system's shell. 您可以修改这些命令并添加更多命令来自定义构建过程。 - -``` yaml -- run: | - make bootstrap - make release -``` - -有关 `run` 关键词的更多信息，请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepsrun)”。 - -You can also use a build matrix to update the workflow to build more than one compiled language, if this is the appropriate approach for your system and doesn't cause conflicts. For more information, see "[Configuring a build matrix](/actions/configuring-and-managing-workflows/configuring-a-workflow#configuring-a-build-matrix)." - - -For example, the workflow below runs one job for C/C++ analysis, and another job for Java analysis. - -```yaml - -name: "Code Scanning - Action" - -on: - pull_request: - branches: [master] - push: - branches: [master] - -jobs: - CodeQL-Build: - - strategy: - fail-fast: false - matrix: - language: [ 'cpp', 'java'] - - # CodeQL runs on ubuntu-latest, windows-latest, and macos-latest - runs-on: ubuntu-latest - - steps: - - name: Checkout repository - uses: actions/checkout@v2 - - # Initializes the CodeQL tools for scanning. - - name: Initialize CodeQL - uses: github/codeql-action/init@v1 - with: - languages: ${{ matrix.language }} - - # Autobuild attempts to build any compiled languages (C/C++, C#, or Java). - # If this step fails, then you should remove it and run the build manually. - - name: Autobuild - uses: github/codeql-action/autobuild@v1 - - - name: Perform CodeQL Analysis - uses: github/codeql-action/analyze@v1 - - name: Initialize CodeQL - uses: github/codeql-action/init@v1 - with: - languages: ${% raw %}{{ matrix.language }}{% endraw %} - - # Autobuild attempts to build any compiled languages (C/C++, C#, or Java). - # If this step fails, then you should remove it and run the build manually. - - name: Autobuild - uses: github/codeql-action/autobuild@v1 - - - name: Perform CodeQL Analysis - uses: github/codeql-action/analyze@v1 -``` - -For more tips and tricks about why `autobuild` won't build your code, see "[Troubleshooting {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning)". - -If you added manual build steps for compiled languages or used a build matrix and {% data variables.product.prodname_code_scanning %} is still not working on your repository, contact {% data variables.contact.contact_support %}. diff --git a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning.md b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning.md deleted file mode 100644 index c6030619e94b..000000000000 --- a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/enabling-code-scanning.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: 启用代码扫描 -intro: '您可以对项目的仓库启用 {% data variables.product.prodname_code_scanning %}。' -product: '{% data reusables.gated-features.code-scanning %}' -permissions: '拥有仓库写入权限的人可启用仓库的 {% data variables.product.prodname_code_scanning %}。' -redirect_from: - - /github/managing-security-vulnerabilities/configuring-automated-code-scanning -versions: - free-pro-team: '*' ---- - -{% data reusables.code-scanning.beta %} - -### 启用 {% data variables.product.prodname_code_scanning %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-security %} -3. 在“Code scanning（代码扫描）”右侧，单击 **Set up code scanning（设置代码扫描）**。 ![Security Overview（安全性概述）中"Code scanning（代码扫描）"右侧的"Set up code scanning（设置代码扫描）"按钮](/assets/images/help/security/overview-set-up-code-scanning.png) -4. 在“Get started with code scanning（开始代码扫描）”下，单击 **Set up this workflow（设置此工作流程）**。 !["Get started with code scanning（开始代码扫描）"标题下的"Set up this workflow（设置此工作流程）"按钮](/assets/images/help/repository/code-scanning-set-up-this-workflow.png) -5. （可选）自定义 {% data variables.product.prodname_code_scanning %} 如何扫描您的代码，编辑工作流程。 更多信息请参阅“[配置 {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)。” -6. 使用 **Start commit（开始提交）**下拉菜单，并键入提交消息。 ![开始提交](/assets/images/help/repository/start-commit-commit-new-file.png) -7. 选择您是想直接提交到默认分支，还是创建新分支并启动拉取请求。 ![选择提交位置](/assets/images/help/repository/start-commit-choose-where-to-commit.png) -8. 单击 **Commit new file（提交新文件）**或 **Propose new file（提议新文件）**。 - -在提交工作流程文件或创建拉取请求后，{% data variables.product.prodname_code_scanning %} 将根据您在工作流程文件中指定的频率分析代码。 如果您创建了拉取请求，则在您将拉取请求合并到仓库的默认分支之前，{% data variables.product.prodname_code_scanning %} 只会分析拉取请求主题分支上的代码。 - -### 后续步骤 - -在启用 {% data variables.product.prodname_code_scanning %} 后，您可以监控分析，查看结果，并进一步自定义如何扫描您的代码。 - -- 您可以查看 {% data variables.product.prodname_code_scanning %} 的运行状态并获取已完成运行的通知。 更多信息请参阅“[管理工作流程运行](/actions/configuring-and-managing-workflows/managing-a-workflow-run)”和“[配置通知](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#github-actions-notification-options)”。 -- 扫描完成后，您可以查看已完成扫描的警报。 更多信息请参阅“[管理来自 {% data variables.product.prodname_code_scanning %} 的警报](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning)”。 -- 您可以自定义 {% data variables.product.prodname_code_scanning %} 如何扫描您的仓库中的代码。 更多信息请参阅“[配置代码扫描](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning)”。 diff --git a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning.md b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning.md deleted file mode 100644 index 3c4acd7777a9..000000000000 --- a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-alerts-from-code-scanning.md +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: 管理来自代码扫描的警报 -shortTitle: 管理警报 -intro: 您可以查看、修复和关闭项目代码中潜在漏洞或错误的警报。 -product: '{% data reusables.gated-features.code-scanning %}' -permissions: '拥有仓库写入权限的人可管理仓库的 {% data variables.product.prodname_code_scanning %} 警报。' -redirect_from: - - /github/managing-security-vulnerabilities/managing-alerts-from-automated-code-scanning -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.code-scanning.beta %} -{% data reusables.code-scanning.enterprise-enable-code-scanning %} - -### 关于 {% data variables.product.prodname_code_scanning %} 中的警报 - -After you enable {% data variables.product.prodname_code_scanning %}, {% data variables.product.prodname_dotcom %} displays {% data variables.product.prodname_code_scanning %} alerts in your repository. 默认 {% data variables.product.prodname_code_scanning %} 工作流程使用 `on.push` 事件触发代码扫描 - 每次推送到任何包含工作流程文件的分支时触发。 - -Each alert highlights a problem with the code and the name of the tool that identified it. 您可以看到触发警报的代码行以及警报的属性，例如问题的严重程度和性质。 警报还会告知该问题第一次被引入的时间。 For alerts identified by {% data variables.product.prodname_codeql %} analysis, you will also see information on how to fix the problem. - -![来自 {% data variables.product.prodname_code_scanning %} 的警报示例](/assets/images/help/repository/code-scanning-alert.png) - -如果不执行警报建议的操作，可以手动关闭警报。 例如，您可以关闭用于测试的代码的警报，或者您认为是误报的警报。 如果修复编码错误的成本大于改进代码的潜在利益，您可能还希望关闭警报。 - -默认情况下，{% data variables.product.prodname_dotcom %} 显示默认分支和任何受保护分支的警报。 您可以对警报列表进行排序和过滤，只查看您感兴趣的警报。 - -您可以查看拉取请求中引入的警报，并立即采取措施。 当 {% data variables.product.prodname_code_scanning %} 在拉取请求中找到漏洞或错误时，{% data variables.product.prodname_dotcom %} 会在时间线中显示注释，并显示拉取请求的差异视图。 - -If you enable {% data variables.product.prodname_code_scanning %} using {% data variables.product.prodname_codeql %}, this can also detect data-flow problems in your code. Data-flow analysis finds potential security issues in code, such as: using data insecurely, passing dangerous arguments to functions, and leaking sensitive information. - -当 {% data variables.product.prodname_code_scanning %} 报告数据流警报时，{% data variables.product.prodname_dotcom %} 将显示数据在代码中如何移动。 {% data variables.product.prodname_code_scanning_capc %} allows you to identify the areas of your code that leak sensitive information, and that could be the entry point for attacks by malicious users. - -{% data reusables.code-scanning.you-can-upload-third-party-analysis %} {% data reusables.code-scanning.get-started-uploading-third-party-data %} - -If you scan your code using a third-party tool or scan your code with custom {% data variables.product.prodname_codeql %} queries, {% data variables.product.prodname_dotcom %} will only use the supported SARIF 2.1.0 properties to display alerts. 第三方工具或自定义查询的结果可能不包括在使用 {% data variables.product.company_short %} 默认 {% data variables.product.prodname_codeql %} 查询扫描代码时看到的所有属性。 更多信息请参阅“[{% data variables.product.prodname_code_scanning %} 的 SARIF 支持](/github/finding-security-vulnerabilities-and-errors-in-your-code/sarif-support-for-code-scanning)”。 - -### 查看警报 - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-security %} -{% data reusables.repositories.sidebar-code-scanning-alerts %} -{% data reusables.code-scanning.click-alert-in-list %} -5. （可选）如果警报突出显示数据流的问题，单击 **Show paths（显示路径）**可查看数据的路径。 ![数据流警报示例](/assets/images/help/repository/code-scanning-show-paths.png) - -### 关闭警报 - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-security %} -{% data reusables.repositories.sidebar-code-scanning-alerts %} -{% data reusables.code-scanning.click-alert-in-list %} -5. 使用“Close（关闭）”下拉菜单，单击关闭警报的原因。 ![选择通过 "Close（关闭）"下拉菜单关闭警报的原因](/assets/images/help/repository/code-scanning-alert-close-drop-down.png) - -### 延伸阅读 - -- "[{% data variables.product.prodname_code_scanning_capc %}](http://developer.github.com/v3/code-scanning)" -- "[{% data variables.product.prodname_code_scanning_capc %} API](/v3/code-scanning)" diff --git a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-results-from-code-scanning.md b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-results-from-code-scanning.md deleted file mode 100644 index ba0f31a05cf0..000000000000 --- a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-results-from-code-scanning.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: 管理代码扫描的结果 -shortTitle: 管理结果 -intro: '您可以查看、分类、理解和解决 {% data variables.product.prodname_code_scanning %} 找到的漏洞和错误。' -mapTopic: true -versions: - free-pro-team: '*' ---- - diff --git a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning.md b/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning.md deleted file mode 100644 index 36819579483d..000000000000 --- a/translations/zh-CN/content/github/finding-security-vulnerabilities-and-errors-in-your-code/troubleshooting-code-scanning.md +++ /dev/null @@ -1,130 +0,0 @@ ---- -title: Troubleshooting code scanning -shortTitle: Troubleshooting -intro: 'You can see tips to resolve common issues with {% data variables.product.prodname_code_scanning %}.' -product: '{% data reusables.gated-features.code-scanning %}' -versions: - free-pro-team: '*' - enterprise-server: '>=2.22' ---- - -{% data reusables.code-scanning.beta %} -{% data reusables.code-scanning.enterprise-enable-code-scanning %} - -### Automatic build for a compiled language fails - -If an automatic build of code for a compiled language within your project fails, try the following troubleshooting steps. - -- Remove the `autobuild` step from your {% data variables.product.prodname_code_scanning %} workflow and add specific build steps. For information about editing the workflow, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#editing-a-code-scanning-workflow)." For more information about replacing the `autobuild` step, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." -- If the repository for your project contains code in a specific language that does not build, disable automatic language detection in your {% data variables.product.prodname_code_scanning %} workflow and specify only the languages you want to build. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#overriding-automatic-language-detection)." - -### No code found during the build - -If your workflow fails with an error `No source code was seen during the build` or `The process '/opt/hostedtoolcache/CodeQL/0.0.0-20200630/x64/codeql/codeql' failed with exit code 32`, this indicates that {% data variables.product.prodname_codeql %} was unable to trace your code. Several reasons can explain such a failure: - -1. Automatic language detection identified a supported language, but there is no analyzable code of that language in the repository. A typical example is when our language detection service finds a file associated with a particular programming language like a `.h`, or `.gyp` file, but no corresponding executable code is present in the repository. To solve the problem, you can manually define the languages you want to analyze by updating the `init` step to specify the supported languages that are present in your repository. For example, the following configuration will analyze only Go, and JavaScript. - - ```yaml - - name: Initialize CodeQL - uses: github/codeql-action/init@v1 - with: - languages: go, javascript # Other options are csharp, python, cpp, java - ``` -2. Your {% data variables.product.prodname_code_scanning %} workflow is analyzing a compiled language (C, C++, C#, or Java), but the code was not compiled. By default, the {% data variables.product.prodname_codeql %} analysis workflow contains an `autobuild` step, however, this step represents a best effort process, and may not succeed in building your code, depending on your specific build environment. Compilation may also fail if you have removed the `autobuild` step and did not include build steps manually. For more information about specifying build steps, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." -3. Your workflow is analyzing a compiled language (C, C++, C#, or Java), but portions of your build are cached to improve performance (most likely to occur with build systems like Gradle or Bazel). Since {% data variables.product.prodname_codeql %} observes the activity of the compiler to understand the data flows in a repository, {% data variables.product.prodname_codeql %} requires a complete build to take place in order to perform analysis. -4. Your workflow is analyzing a compiled language (C, C++, C#, or Java), but compilation does not occur between the `init` and `analyze` steps in the workflow. {% data variables.product.prodname_codeql %} requires that your build happens in between these two steps in order to observe the activity of the compiler and perform analysis. -5. Your compiled code (in C, C++, C#, or Java) was compiled successfully, but {% data variables.product.prodname_codeql %} was unable to detect the compiler invocations. The most common causes are certain configuration options like running your build process in a container, if you're building using a distributed build system external to {% data variables.product.prodname_actions %} using a daemon process, or if {% data variables.product.prodname_codeql %} isn't aware of the specific compiler you are using. - 1. For C# projects using either `dotnet build` or `msbuild` which target .NET Core 2, you should specify `/p:UseSharedCompilation=false` in your workflow's `run` step, when you build your code. The `UseSharedCompilation` flag isn't necessary for .NET Core 3.0 and later. - - For example, the following configuration will pass the flag during the first build step. - - ```yaml - - run: | - dotnet build /p:UseSharedCompilation=false - ``` - 2. If you encounter another problem with your specific compiler or configuration, contact {% data variables.contact.contact_support %}. - -For more information about specifying build steps, see "[Configuring the {% data variables.product.prodname_codeql %} workflow for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)." - -### Portions of my repository were not analyzed using `autobuild` - -The {% data variables.product.prodname_codeql %} `autobuild` feature uses heuristics to build the code in a repository, however, sometimes this approach results in incomplete analysis of a repository. For example, when multiple `build.sh` commands exist in a single repository, the analysis may not complete since the `autobuild` step will only execute one of the commands. The solution is to replace the `autobuild` step with build steps which build all of the source code which you wish to analyze. Alternatively, if more than one compiled language is present in your repository and you want {% data variables.product.prodname_code_scanning %} to analyze all these compiled languages, you can use a build matrix in your workflow. {% if currentVersion ver_gt "enterprise-server@2.21" %}To use a build matrix, you should make sure that {% data variables.product.prodname_actions %} is enabled on {% data variables.product.product_location_enterprise %}. {% endif %}For more information, see "[Managing complex workflows](/actions/learn-github-actions/managing-complex-workflows/#using-a-build-matrix)" and -"[Configuring the {% data variables.product.prodname_codeql %} action for compiled languages](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-action-for-compiled-languages#adding-build-steps-for-a-compiled-language)." - -### Error: "Server error" - -If the run of a workflow for {% data variables.product.prodname_code_scanning %} fails due to a server error, try running the workflow again. If the problem persists, contact {% data variables.contact.contact_support %}. - -### Error: "Out of disk" or "Out of memory" - -On very large projects, {% data variables.product.prodname_codeql %} may run out of disk or memory on the runner. -{% if currentVersion == "free-pro-team@latest" %}If you encounter this issue on a hosted {% data variables.product.prodname_actions %} runner, contact {% data variables.contact.contact_support %} so that we can investigate the problem. -{% else %}If you encounter this issue, try increasing the memory on the runner.{% endif %} - -### The build takes too long - -If your build with {% data variables.product.prodname_codeql %} analysis takes too long to run, there are several approaches you can try to reduce the build time. - -#### Increase the memory or cores - -If you use self-hosted runners to run {% data variables.product.prodname_codeql %} analysis, you can increase the memory or the number of cores on those runners. - -#### Use matrix builds to parallelize the analysis - -By default, {% data variables.product.prodname_codeql %} performs analysis of each language sequentially, which can impact performance, especially for repositories with more than one language. You can speed analysis up by using a build matrix that splits the analysis by language. {% if currentVersion ver_gt "enterprise-server@2.21" %}To use a build matrix, you should make sure that {% data variables.product.prodname_actions %} is enabled on {% data variables.product.product_location_enterprise %}. {% endif %}For more information, see "[Managing complex workflows](/actions/learn-github-actions/managing-complex-workflows/#using-a-build-matrix)." - -For example, the workflow below will be run with one job for JavaScript analysis, and another job for Go analysis. - -```yaml - -name: "Code Scanning - Action" - -on: - pull_request: - branches: [main] - push: - branches: [main] - -jobs: - CodeQL-Build: - - strategy: - fail-fast: false - matrix: - language: [ 'go', 'javascript'] - - # CodeQL runs on ubuntu-latest, windows-latest, and macos-latest - runs-on: ubuntu-latest - - steps: - - name: Checkout repository - uses: actions/checkout@v2 - - # Initializes the CodeQL tools for scanning. - - name: Initialize CodeQL - uses: github/codeql-action/init@v1 - with: - languages: ${{ matrix.language }} - - # Autobuild attempts to build any compiled languages (C/C++, C#, or Java). - # If this step fails, then you should remove it and run the build manually (see below). - - name: Autobuild - uses: github/codeql-action/autobuild@v1 - - - name: Perform CodeQL Analysis - uses: github/codeql-action/analyze@v1 -``` - -#### Reduce the amount of code being analyzed in a single workflow - -Analysis time is typically proportional to the amount of code being analyzed. You can reduce the analysis time by reducing the amount of code being analyzed at once, for example, by excluding test code, or breaking analysis into multiple workflows that analyze only a subset of your code at a time. - -For compiled languages like Java, C, C++, and C#, {% data variables.product.prodname_codeql %} analyzes all of the code which was built during the workflow run. To limit the amount of code being analyzed, build only the code which you wish to analyze by specifying your own build steps in a `run` block. You can combine specifying your own build steps with using the `paths` or `paths-ignore` filters on the `pull_request` and `push` events to ensure that your workflow only runs when specific code is changed. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)." - -For interpreted languages like Go, JavaScript, Python, and TypeScript, that {% data variables.product.prodname_codeql %} analyzes without a specific build, you can specify additional configuration options to limit the amount of code to analyze. For more information, see "[Specifying directories to scan](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#specifying-directories-to-scan)." - -If you split your analysis into multiple workflows as described above, we still recommend that you have at least one workflow which runs on a `schedule` which analyzes all of the code in your repository. Because {% data variables.product.prodname_codeql %} analyzes data flows between components, some complex security behaviors may only be detected on a complete build. - -#### Run only during a `schedule` event - -If your analysis is still too slow to be run during `push` or `pull_request` events, then you may want to only trigger analysis on the `schedule` event. For more information, see "[Events](/actions/learn-github-actions/introduction-to-github-actions#events)." diff --git a/translations/zh-CN/content/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies.md b/translations/zh-CN/content/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies.md deleted file mode 100644 index 75806f63761e..000000000000 --- a/translations/zh-CN/content/github/managing-security-vulnerabilities/about-security-alerts-for-vulnerable-dependencies.md +++ /dev/null @@ -1,57 +0,0 @@ ---- -title: 关于对有漏洞的依赖项发出安全警报 -intro: '当我们检测到影响到您的仓库的漏洞时，{% data variables.product.product_name %} 会发出安全警报。' -redirect_from: - - /articles/about-security-alerts-for-vulnerable-dependencies -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -### 关于安全漏洞 - -{% data reusables.repositories.a-vulnerability-is %}根据漏洞的严重性和项目使用依赖项的方式，漏洞可能对项目或者使用项目的人员造成一系列问题。 您可以跟踪并解决 {% data variables.product.product_name %} 仓库中某些依赖项类型的漏洞。 - -如果 {% data variables.product.prodname_dotcom %} 从您的仓库依赖关系图中某个依赖项的 {% data variables.product.prodname_advisory_database %} 或 [WhiteSource](https://www.whitesourcesoftware.com/GitHubSecurityAlerts) 中检测到漏洞，我们会向您发送安全警报。 有关 {% data variables.product.prodname_advisory_database %} 的更多信息，请参阅“浏览 {% data variables.product.prodname_advisory_database %} 中的安全漏洞”。 - -{% if currentVersion == "free-pro-team@latest" %} -### 漏洞依赖项的警报和自动安全更新 -{% else %} -### 对有漏洞的依赖项发出安全警报 -{% endif %} - -当 GitHub Advisory Database 中加入新的漏洞时，我们会识别使用受影响依赖项版本的{% if currentVersion == "free-pro-team@latest" %}公共{% endif %}仓库{% if currentVersion == "free-pro-team@latest" %}（和已经选择加入漏洞检测的私有仓库）{% endif %}{% if currentVersion == "free-pro-team@latest" %}，发送安全警报给仓库维护员，然后生成自动安全更新{% else %}并发送安全警报给仓库维护员{% endif %}。 - -每个安全警报都包含严重等级{% if currentVersion == "free-pro-team@latest" %}、项目中受影响文件的链接、其中包含可解决漏洞的自动安全更新的拉取请求链接{% else %}，以及项目中受影响文件的链接{% endif %}。 可用时，警报会包含有关漏洞的更多详细信息。 - -您可以在{% if currentVersion == "free-pro-team@latest" %}仓库的 Alerts（警报）选项卡或{% endif %}仓库的依赖项图表{% if currentVersion == "free-pro-team@latest" %}中查看影响特定项目的所有警报。更多信息请参阅“[查看和更新仓库中的漏洞依赖项](/articles/viewing-and-updating-vulnerable-dependencies-in-your-repository)”。{% endif %} - -默认情况下，我们会向具有受影响仓库管理员权限的人员发送安全警报。 {% data variables.product.product_name %} 从不公开披露在任何仓库中发现的漏洞。{% if currentVersion == "free-pro-team@latest" %} 您也可以对操作组织拥有的仓库的其他人或团队启用安全警报。 更多信息请参阅“[管理组织仓库中漏洞依赖项的警报](/articles/managing-alerts-for-vulnerable-dependencies-in-your-organization-s-repositories)”。{% endif %} - -{% data reusables.repositories.enable-security-alerts %} -{% if currentVersion == "free-pro-team@latest" %} -自动安全更新将有漏洞的依赖项更新为可解决该漏洞的最低版本。 自动安全更新会在使用依赖项图表和安全警报的仓库中自动启用，但您可以选择禁用自动拉取请求，改为手动生成安全更新。 更多信息请参阅“[配置自动安全更新](/github/managing-security-vulnerabilities/configuring-automated-security-updates)”。 - -{% data variables.product.prodname_dotcom %} 默认会检查_公共_仓库中有漏洞的依赖项并发出警报。 要接收_私有_仓库中漏洞依赖项的安全警报，该仓库的所有者或具有管理员权限的人员必须在仓库中启用依赖项图表和安全警报。 更多信息请参阅“[选择加入或退出私有仓库的数据使用](/articles/opting-into-or-out-of-data-use-for-your-private-repository)”。 -{% endif %} - -有关 {% data variables.product.product_name %} 可以检测漏洞和依赖项的受支持语言列表，请参阅“[列出仓库所依赖的包](/articles/listing-the-packages-that-a-repository-depends-on)”。 - -{% warning %} - -**注**：{% data variables.product.product_name %} 的安全功能（如安全警报）并不要求捕获所有漏洞。 虽然我们一直在努力更新漏洞数据库，向您提醒最新的信息，但我们无法捕获一切或在保证的时间范围内向您警示已知的漏洞。 这些功能不是要替代人工检查每个依赖项的潜在漏洞或任何其他问题，并且我们建议在必要时咨询安全服务或全面检查漏洞。 - -{% endwarning %} - -### 配置安全警报通知 - -默认情况下，您将通过电子邮件收到安全警报{% if currentVersion == "free-pro-team@latest" %}，这些警报将按特定漏洞分组{% endif %}。 您也可以选择在每周电子邮件（摘要列出最多 10 个仓库的警报）、web 通知或 {% data variables.product.product_name %} 用户界面中接收安全警报。 更多信息请参阅{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}“[配置通知](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#security-alert-options){% else %}“[选择通知递送方式](/github/receiving-notifications-about-activity-on-github/choosing-the-delivery-method-for-your-notifications){% endif %}”。 - -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" % %}{% data reusables.repositories.security-alerts-x-github-severity %}更多信息请参阅{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}“[配置通知](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#filtering-email-notifications){% else %}“[关于电子邮件通知](/github/receiving-notifications-about-activity-on-github/about-email-notifications){% endif %}”。{% endif %} - -### 延伸阅读 - -{% if currentVersion == "free-pro-team@latest" %}- "[配置自动安全更新](/github/managing-security-vulnerabilities/configuring-automated-security-updates)" -- "[查看和更新仓库中的漏洞依赖项](/articles/viewing-and-updating-vulnerable-dependencies-in-your-repository)" -- "[了解 {% data variables.product.product_name %} 如何使用和保护数据](/categories/understanding-how-github-uses-and-protects-your-data)"{% endif %} -- MITRE 的[“漏洞”定义](https://cve.mitre.org/about/terminology.html#vulnerability) diff --git a/translations/zh-CN/content/github/managing-security-vulnerabilities/configuring-automated-security-updates.md b/translations/zh-CN/content/github/managing-security-vulnerabilities/configuring-automated-security-updates.md deleted file mode 100644 index 0d20644a887b..000000000000 --- a/translations/zh-CN/content/github/managing-security-vulnerabilities/configuring-automated-security-updates.md +++ /dev/null @@ -1,92 +0,0 @@ ---- -title: 配置自动安全更新 -intro: 您可以使用自动或手动拉取请求轻松更新易受攻击的依赖项。 -redirect_from: - - /articles/configuring-automated-security-fixes - - /github/managing-security-vulnerabilities/configuring-automated-security-fixes -versions: - free-pro-team: '*' ---- - -### 关于自动安全更新 - -您可以为任何使用安全警报和依赖关系图的仓库启用自动安全更新。 您可以对个别仓库或所有由您的用户帐户或组织拥有的仓库禁用自动安全更新。 - -收到有关仓库中易受攻击依赖项的安全警报时，您可以使用与安全警报对应的拉取请求中的自动安全更新来解决漏洞。 使用依赖关系图的仓库中提供自动安全更新功能。 默认情况下，{% data variables.product.prodname_dotcom %} 会自动在您的仓库中创建拉取请求，以将易受攻击的依赖项升级到避免漏洞所需的最低安全版本。 如果您愿意，可以禁用自动拉取请求，只在需要时选择手动创建拉取请求以升级依赖项。 - -自动安全请求包含快速安全地审查并将提议的修复合并到项目中所需的一切，包括有关漏洞的信息，如版本说明、更改日志条目和提交详细信息。 - -自动安全更新由 Dependabot 代表 {% data variables.product.prodname_dotcom %} 开启。 Dependabot {% data variables.product.prodname_github_app %} 会自动安装在每个启用了自动安全更新的仓库中。 - -有权访问仓库安全警报的人可以看到指向相关安全警报的链接，但有权访问拉取请求的其他人无法看到拉取请求要解决的漏洞。 - -当您合并包含自动安全更新的拉取请求时，仓库的相应安全警报将被标记为已解决。 - -{% note %} - -**注：**自动安全更新只解决安全漏洞。 自动安全更新的目标不是解决托管在私有仓库中的私有注册表或包中的漏洞。 - -{% endnote %} - -### 支持的仓库 - -{% data variables.product.prodname_dotcom %} 自动为符合这些要求的每个仓库启用自动安全更新。 - -{% note %} - -**注**：对于 2019 年 11 月之前创建的仓库，如果仓库满足以下条件，并且自 2019 年 5 月 23 日以来至少收到过一次推送，{% data variables.product.prodname_dotcom %} 已自动启用自动安全更新。 - -{% endnote %} - -| 要求 | 更多信息 | -| ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| 存储库不是复刻 | "[关于复刻](/github/collaborating-with-issues-and-pull-requests/about-forks)" | -| 仓库未存档 | "[存档仓库](/github/creating-cloning-and-archiving-repositories/archiving-repositories)" | -| 仓库是公共的，或者仓库是私有的但您在仓库的设置中启用了 {% data variables.product.prodname_dotcom %} 只读分析、依赖关系图和漏洞警报。 | "[选择加入私有仓库的数据使用](/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-data-use-for-your-private-repository#opting-into-data-use-for-your-private-repository)" | -| 仓库包含软件包生态系统中 {% data variables.product.prodname_dotcom %} 支持的依赖项清单文件 | "[支持的软件包生态系统](/github/visualizing-repository-data-with-graphs/listing-the-packages-that-a-repository-depends-on#supported-package-ecosystems)" | -| 未对仓库禁用自动安全更新 | "[管理仓库的自动安全更新](#managing-automated-security-updates-for-your-repository)" | -| 仓库尚未使用集成进行依赖项管理 | “[关于集成](/github/customizing-your-github-workflow/about-integrations)” | - -如果未为存储库启用自动安全更新，而您不知道原因，您可以 [联系支持](https://support.github.com/contact)。 - -### 关于兼容性分数 - -自动安全更新还包括兼容性分数，以便您了解更新漏洞是否可能导致对项目的重大更改。 我们从已生成特定自动安全更新的公共仓库中查看此前通过的 CI 测试，以了解更新是否会导致测试失败。 更新的兼容性分数是在依赖项的相关版本之间进行更新时，CI 运行被视为通过的百分比。 - -### 管理仓库的自动安全更新 - -您可以对个别仓库启用或禁用自动安全更新。 - -自动更新安全需要特定的仓库设置。 更多信息请参阅“[支持的仓库](#supported-repositories)”。 - -{% data reusables.repositories.you-can-enable-or-disable-security-features %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-security %} -4. 在警报列表的上方，使用下拉菜单并选择或取消选择 **Automated security updates（自动安全更新）**。 ![包含启用自动安全更新的选项的下拉菜单](/assets/images/help/repository/enable-automated-security-updates-drop-down.png) - -### 管理用户帐户的自动安全更新 - -You can disable automated security updates for all repositories owned by your user account. If you do, you can still enable automated security updates for individual repositories owned by your user account. - -{% data reusables.user_settings.access_settings %} -{% data reusables.user_settings.security %} -{% data reusables.repositories.opt-out-automated-security-updates %} - -### 管理组织的自动安全更新 - -Organization owners can disable automated security updates for all repositories owned by the organization. If you do, anyone with admin permissions to an individual repository owned by the organization can still enable automated security updates on that repository. - -{% data reusables.repositories.you-can-enable-or-disable-security-features %} - -{% data reusables.profile.access_profile %} -{% data reusables.profile.access_org %} -{% data reusables.organizations.org_settings %} -{% data reusables.organizations.security %} -{% data reusables.repositories.opt-out-automated-security-updates %} - -### 延伸阅读 - -- “[关于易受攻击依赖项的安全警报](/articles/about-security-alerts-for-vulnerable-dependencies)” -- "[选择加入私有仓库的数据使用](/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-data-use-for-your-private-repository#opting-into-data-use-for-your-private-repository)" -- "[支持的软件包生态系统](/github/visualizing-repository-data-with-graphs/listing-the-packages-that-a-repository-depends-on#supported-package-ecosystems)" diff --git a/translations/zh-CN/content/github/managing-security-vulnerabilities/managing-alerts-for-vulnerable-dependencies-in-your-organization.md b/translations/zh-CN/content/github/managing-security-vulnerabilities/managing-alerts-for-vulnerable-dependencies-in-your-organization.md deleted file mode 100644 index bf021b08add1..000000000000 --- a/translations/zh-CN/content/github/managing-security-vulnerabilities/managing-alerts-for-vulnerable-dependencies-in-your-organization.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: 管理组织中漏洞依赖项的警报 -intro: '当我们检测到组织仓库中有漏洞的依赖项时，组织所有者和仓库管理员会收到 {% data variables.product.prodname_dependabot_alerts %}。 您可以指定其他具有写入权限的组织成员或团队也接收漏洞依赖项的警报。' -redirect_from: - - /articles/managing-alerts-for-vulnerable-dependencies-in-your-organization-s-repositories/ - - /articles/managing-alerts-for-vulnerable-dependencies-in-your-organizations-repositories/ - - /articles/managing-alerts-for-vulnerable-dependencies-in-your-organization -versions: - free-pro-team: '*' ---- - -{% if currentVersion == "free-pro-team@latest" %} -{% data reusables.repositories.you-can-manage-access-to-security-alerts %} -{% endif %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -3. 在左侧边栏中，单击 **Dependabot alerts（Dependabot 警报）**。 ![设置侧边栏中的 Dependabot 警报选项卡](/assets/images/help/settings/settings-sidebar-dependabot-alerts.png) -4. 输入您希望在 {% data variables.product.product_name %} 检测到漏洞依赖项时接收 {% data variables.product.prodname_dependabot_alerts %}的个人或团队名称，然后单击其用户名或团队名称以选中。 -5. 在选择您希望接收 {% data variables.product.prodname_dependabot_alerts %}的所有人员或团队后，单击 **Save changes（保存更改）**。 - -### 延伸阅读 - -- “[关于有易受攻击依赖项的警报](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)” -- "[查看和更新仓库中的漏洞依赖项](/articles/viewing-and-updating-vulnerable-dependencies-in-your-repository)" -- “[管理组织的安全性和分析设置](/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization)” diff --git a/translations/zh-CN/content/github/searching-for-information-on-github/searching-code-for-exact-matches.md b/translations/zh-CN/content/github/searching-for-information-on-github/searching-code-for-exact-matches.md deleted file mode 100644 index 2df2614aec99..000000000000 --- a/translations/zh-CN/content/github/searching-for-information-on-github/searching-code-for-exact-matches.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: 搜索精确匹配的代码 -intro: '您可以在 {% data variables.product.prodname_dotcom %} 上搜索仓库中精确匹配的代码。' -redirect_from: - - /github/searching-for-information-on-github/searching-files-in-a-repository-for-exact-matches -permissions: People with read permissions to a repository can search the repository's files for exact matches. -versions: - free-pro-team: '*' ---- - -{% note %} - -{% data reusables.search.exact-match-beta %}要申请访问测试版，请[加入等待列表](https://github.com/features/code-search-exact-match/signup)。 - -{% endnote %} - -### 关于搜索精确匹配的代码 - -{% data reusables.search.exact-match %} - -默认情况下，搜索精确匹配项区分大小写和符号，不包括部分匹配或规范化语法。 例如，搜索 `let ReactDOM*` 只会返回 `let ReactDOM*`。 - -### 搜索精确匹配的代码 - -{% note %} - -对于测试版，在仓库中搜索精确匹配的文件只支持编制了索引的仓库。 - -{% endnote %} - -{% data reusables.repositories.navigate-to-repo %} -2. In the search field, type the string you'd like to find. ![Exact match search string](/assets/images/help/search/exact-match-search-string.png) -3. Optionally, click the **Options** drop-down to narrow your search. ![Exact match search Options drop-down](/assets/images/help/search/exact-match-options.png) -4. Press Enter or Return on your keyboard. -5. 在结果列表中，单击文件。 - -### 延伸阅读 - -- “[搜索代码](/github/searching-for-information-on-github/searching-code)” -- "[在 {% data variables.product.product_name %} 上导航代码](/github/managing-files-in-a-repository/navigating-code-on-github)" diff --git a/translations/zh-CN/content/github/site-policy/github-enterprise-cloud-addendum.md b/translations/zh-CN/content/github/site-policy/github-enterprise-cloud-addendum.md deleted file mode 100644 index 0a0f029bc6db..000000000000 --- a/translations/zh-CN/content/github/site-policy/github-enterprise-cloud-addendum.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: GitHub 企业云附录 -redirect_from: - - /github-business-cloud-addendum/ - - /articles/github-enterprise-cloud-addendum -versions: - free-pro-team: '*' ---- - -这些条款是 GitHub Enterprise Cloud 的附加条款（“Enterprise Cloud 条款）。 在这些 Enterprise Cloud 中未定义的任何大写术语将采用[服务条款](/articles/github-terms-of-service/)或[公司服务条款](/articles/github-corporate-terms-of-service/)中的定义。 同意这些 Enterprise Cloud 条款，即表示您也同意服务条款，具体取决于您拥有的帐户类型。 - -Enterprise Cloud 包括一个组织帐户、SAML 单点登录、访问权限配置以及 8 小时响应时间的 24/5 支持。 此功能和服务列表并不详尽，可能会不时更新。 更多信息请参阅 [GitHub 定价页面](https://github.com/pricing)。 - -### 定义: -- 活跃用户：在中断时尝试访问我们服务的用户。 -- 客户：从 GitHub 购买 Enterprise Cloud 的个人或实体。 -- 合格用户：通过将其个人 GitHub 帐户与客户 Enterprise Cloud 帐户相关联，指定为客户 Enterprise Cloud 组织之成员的个人。 -- 基本服务：GitHub 核心版本控制功能必要的服务，这些功能和服务包括创建、复刻和克隆仓库；创建、提交和合并分支；创建、审查和合并拉取请求；以及 web、API 和 Git 客户端连接到核心 Git 工作流程。 下面是未包含的外围功能和服务示例：web 挂钩、Gist、页面和电子邮件通知。 -- 中断：影响 50% 以上活跃用户的基本服务中断。 -- 服务积分：我们可能返还给合格帐户的美元信用，计算方式如下所述。 - -### Enterprise Cloud 正常运行时间 SLA - -计划的优势： -- 我们保证该服务的季度正常运行时间达到 99.95%。 这表示断电对 GitHub 基本服务的中断不会影响超过 50% 的活跃用户，且时间不超过季度的 .05%。 -- 如果未达到我们保证的 99.95% 的季度正常运行时间，我们可能会向客户发放服务积分。 - -我们如何计算正常运行时间？ -- 我们的正常运行时间计算基于通过 web、API 和 Git 客户端接口成功送达服务请求的百分比。 - -我们的正常运行时间保证不包括哪些情况？ 因以下原因造成的中断： -- 客户的行为、疏忽或滥用服务，包括违反服务条款。 -- 您的互联网连接故障 -- 超出我们合理控制范围的因素，包括互联网接入问题、不可抗力事件和第三方服务或技术问题 -- 您的设备、服务或其他技术问题 - -什么是正常运行时间服务积分，如何确定我是否有积分，以及如何兑换积分？ -- 如果 GitHub 的季度正常运行时间百分比掉到我们保证的 99.95% 以下，则客户有权获得服务积分，该积分等于超过季度正常运行时间保证的中断时间之付费金额的 25 倍。 正常运行时间服务积分在每个季度结束时计算，只能在申请后授予。 -- 要了解 GitHub 的正常运行时间百分比，您可在每个季度结束时索取正常运行时间报告。 -- 要获得正常运行时间服务积分，帐户所有者或帐单管理员必须在每个季度结束后三十 (30) 天内代表客户发送书面申请。 正常运行时间服务积分不能积攒。 正常运行时间服务积分被授予后，会自动应用到客户的下一张帐单。 书面申请应发送至 {% data variables.contact.contact_support %}。 - -**免责声明和责任限制：**GitHub 的[状态页面](https://www.githubstatus.com/)未连接到此正常运行时间 SLA，不能出于计算正常运行时间服务积分的目的准确呈现 GitHub 的正常运行时间。 每个季度的服务积分最高限额为 30 天的付费服务金额。 如果 GitHub 未能履行本附录所规定的任何正常运行时间义务，服务积分是对客户唯一的补救措施。 diff --git a/translations/zh-CN/content/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-data-use-for-your-private-repository.md b/translations/zh-CN/content/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-data-use-for-your-private-repository.md deleted file mode 100644 index cb8eebbac1b6..000000000000 --- a/translations/zh-CN/content/github/understanding-how-github-uses-and-protects-your-data/opting-into-or-out-of-data-use-for-your-private-repository.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: 选择加入或退出私有仓库的数据使用 -intro: '为帮助 {% data variables.product.product_name %} 连接到相关的工具、人员、项目和信息，您可以选择加入私有仓库的数据使用。 如已选择加入私有仓库的数据使用，但不再希望 {% data variables.product.product_name %} 使用您的数据，您可以选择退出。' -redirect_from: - - /articles/opting-into-or-out-of-data-use-for-your-private-repository -versions: - free-pro-team: '*' ---- - -### About data use for your private repository - -选择加入私有仓库的数据使用后，您可以访问依赖项图，从中可以跟踪仓库的依赖项，在 {% data variables.product.product_name %} 检测到漏洞依赖项时接收安全警报。 更多信息请参阅“[关于依赖项漏洞的安全警报](/articles/about-security-alerts-for-vulnerable-dependencies)”。 - -{% data reusables.repositories.you-can-enable-or-disable-security-features %} - -### 选择加入私有仓库的数据使用 - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -3. 在 "Data services"（数据服务）下，选中 **Allow {% data variables.product.prodname_dotcom %} to perform read-only analysis of this repository（允许站点执行此仓库的只读分析）**。 ![允许 {% data variables.product.prodname_dotcom %} 对此仓库执行只读分析的复选框](/assets/images/help/repository/private-repo-data-use-opt-in.png) -4. （可选）选中要为其启用数据使用的任何其他服务旁边的复选框。 ![自带复选框的其他服务列表](/assets/images/help/repository/private-repo-data-use-additional-services.png) - -### 选择退出私有仓库的数据使用 - -{% tip %} - -**提示：**要选择退出特定服务的数据使用，请取消选中服务旁边的复选框。 - -{% endtip %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -3. 在 "Data services"（数据服务）下，取消选中 **Allow {% data variables.product.prodname_dotcom %} to perform read-only analysis of this repository（允许站点执行此仓库的只读分析）**。 ![禁止 {% data variables.product.prodname_dotcom %} 对此仓库执行只读分析的复选框](/assets/images/help/repository/private-repo-data-use-opt-out.png) - -### 延伸阅读 - -- "[关于 {% data variables.product.prodname_dotcom %} 对数据的使用](/articles/about-github-s-use-of-your-data)" -- "[查看并更新仓库中有漏洞的依赖项](/articles/viewing-and-updating-vulnerable-dependencies-in-your-repository) -- "[管理组织仓库中漏洞依赖项的警报](/articles/managing-alerts-for-vulnerable-dependencies-in-your-organization-s-repositories)" diff --git a/translations/zh-CN/content/github/using-git/changing-author-info.md b/translations/zh-CN/content/github/using-git/changing-author-info.md deleted file mode 100644 index 8e144ec750a6..000000000000 --- a/translations/zh-CN/content/github/using-git/changing-author-info.md +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: 更改作者信息 -redirect_from: - - /change-author-info/ - - /changing-author-info/ - - /articles/changing-author-info -intro: 要更改现有提交中记录的名称和/或电子邮件地址，您必须重写 Git 仓库的整个历史记录。 -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -{% warning %} - -**警告**：此操作对仓库的历史记录具有破坏性。 如果您正与其他人在仓库上协作，重写已发布的历史记录被视为不良做法。 应该只在紧急情况下才这样做。 - -{% endwarning %} - -### 使用脚本更改仓库的 Git 历史记录 - -我们创建了一个用于更改任何提交的脚本，可将此前在作者或提交者字段中填写的旧电子邮件地址更改为正确的名称和电子邮件地址。 - -{% tip %} - -**注**：运行此脚本会重写所有仓库协作者的历史记录。 完成这些步骤后，任何拥有复刻或克隆的人都必须获取重写的历史记录，并将任何本地更改变基为重写的历史记录。 - -{% endtip %} - -运行此脚本之前，您需要： - -* 显示在要更改的作者/提交者字段中的旧电子邮件地址 -* 要将此类提交归因于的正确名称和电子邮件地址 - -{% data reusables.command_line.open_the_multi_os_terminal %} -2. 为仓库创建一个全新的裸克隆： - ```shell - git clone --bare https://{% data variables.command_line.codeblock %}/user/repo.git - cd repo.git - ``` -3. 复制并粘贴脚本，根据您收集的信息替换以下变量： - * `OLD_EMAIL` - * `CORRECT_NAME` - * `CORRECT_EMAIL` - - ```shell - #!/bin/sh - - git filter-branch --env-filter ' - - OLD_EMAIL="your-old-email@example.com" - CORRECT_NAME="Your Correct Name" - CORRECT_EMAIL="your-correct-email@example.com" - - if [ "$GIT_COMMITTER_EMAIL" = "$OLD_EMAIL" ] - then - export GIT_COMMITTER_NAME="$CORRECT_NAME" - export GIT_COMMITTER_EMAIL="$CORRECT_EMAIL" - fi - if [ "$GIT_AUTHOR_EMAIL" = "$OLD_EMAIL" ] - then - export GIT_AUTHOR_NAME="$CORRECT_NAME" - export GIT_AUTHOR_EMAIL="$CORRECT_EMAIL" - fi - ' --tag-name-filter cat -- --branches --tags - ``` - -4. 按 **Enter** 键以运行脚本。 -5. 审查新的 Git 历史记录以查找错误。 -6. 将更正的历史记录推送到 {% data variables.product.product_name %}： - ```shell - git push --force --tags origin 'refs/heads/*' - ``` -7. 清理临时克隆： - ```shell - cd .. - rm -rf repo.git - ``` diff --git a/translations/zh-CN/content/github/using-git/updating-credentials-from-the-osx-keychain.md b/translations/zh-CN/content/github/using-git/updating-credentials-from-the-osx-keychain.md deleted file mode 100644 index 7a94324612e3..000000000000 --- a/translations/zh-CN/content/github/using-git/updating-credentials-from-the-osx-keychain.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: 更新 OSX 密钥链中的凭据 -intro: '如果在 {% data variables.product.product_name %} 上更改您的用户名、密码或个人访问令牌，您需要在 "git-credit al-osxkeychain" 小助手中更新您保存的凭据。' -redirect_from: - - /articles/updating-credentials-from-the-osx-keychain -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -{% data reusables.user_settings.password-authentication-deprecation %} - -### 通过 Keychain Access 更新凭据 - -1. 在 Finder 中，搜索 **Keychain Access** 应用程序。 ![Spotlight 搜索栏](/assets/images/help/setup/keychain-access.png) -2. 在 Keychain Access 中，搜索 **{% data variables.command_line.backticks %}**。 -3. 查找 `{% data variables.command_line.backticks %}` 的“互联网密码”条目。 ![密钥链中的 GitHub 密码条目](/assets/images/help/setup/keychain-entry.png) -4. 相应地编辑或删除该条目。 - -### 通过命令行删除凭据 - -通过命令行，您可以使用凭据小助手直接擦除密钥链条目。 - -为此，请输入以下命令： - -```shell -$ git credential-osxkeychain erase -host={% data variables.command_line.codeblock %} -protocol=https -> [Press Return] -``` - -如果成功，则不会打印出任何内容。 要测试其是否有效，请尝试并克隆 {% data variables.product.product_location %} 仓库。 如果提示您输入密码，则该密钥链条目已删除。 - -### 延伸阅读 - -- “[在 Git 中缓存您的 {% data variables.product.prodname_dotcom %} 凭据](/github/using-git/caching-your-github-credentials-in-git/)” diff --git a/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository.md b/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository.md deleted file mode 100644 index f9e8dc3a9ffc..000000000000 --- a/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-and-dependents-of-a-repository.md +++ /dev/null @@ -1,65 +0,0 @@ ---- -title: Exploring the dependencies and dependents of a repository -intro: 'Using the dependency graph, you can see the packages your project depends on and the repositories that depend on it. In addition, you can see any vulnerabilities detected in its dependencies.' -redirect_from: - - /articles/listing-the-packages-that-a-repository-depends-on - - /github/visualizing-repository-data-with-graphs/listing-the-packages-that-a-repository-depends-on - - /articles/listing-the-projects-that-depend-on-a-repository - - /github/visualizing-repository-data-with-graphs/listing-the-projects-that-depend-on-a-repository -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -### Viewing the dependency graph - -{% data reusables.repositories.enable-security-alerts %} - -The dependency graph has tabs that show the dependencies and dependents of your repository. For information about how these views are populated and which ecosystems are supported, see "[About the dependency graph](about-the-dependency-graph)." - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.accessing-repository-graphs %} -{% data reusables.repositories.click-dependency-graph %} -4. Optionally, under "Dependency graph", click **Dependents**. ![依赖项图中的依赖项选项卡](/assets/images/help/graphs/dependency-graph-dependents-tab.png) - -#### Dependencies view - -Dependencies are grouped by ecosystem. You can expand a dependency to view its dependencies. For dependencies hosted on {% data variables.product.product_name %}, you can also click a dependency to view the repository. If vulnerabilities have been detected in the repository, these are shown at the top of the view for users with access to {% if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %}. - -![依赖关系图](/assets/images/help/graphs/dependencies_graph.png) - -#### Dependents view - -For public repositories, the dependents view shows how the repository is used by other repositories. To show only the repositories that contain a library in a package manager, click **NUMBER Packages** immediately above the list of dependent repositories. The dependent counts are approximate and may not always match the dependents listed. - -![从属者图](/assets/images/help/graphs/dependents_graph.png) - -{% if currentVersion == "free-pro-team@latest" %} -### Enabling and disabling the dependency graph for a private repository - -Repository administrators can enable or disable the dependency graph for private repositories. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -{% data reusables.repositories.navigate-to-security-and-analysis %} -4. Read the message about granting {% data variables.product.product_name %} read-only access to the repository data to enable the dependency graph, then next to "Dependency Graph", click **Enable**. !["Enable" button for the dependency graph](/assets/images/help/repository/dependency-graph-enable-button.png) - -You can disable the dependency graph at any time by clicking **Disable** next to "Dependency Graph" on the Security & analysis tab. -{% endif %} - -### 依赖项图疑难排解 - -If your dependency graph is empty, there may be a problem with the file containing your dependencies. Check the file to ensure that it's correctly formatted for the file type. - -{% if currentVersion == "free-pro-team@latest" %} -If the file is correctly formatted, then check its size. The dependency graph ignores individual manifest and lock files that are over 0.5 Mb, unless you are a {% data variables.product.prodname_enterprise %} user. It processes up to 20 manifest or lock files per repository by default, so you can split dependencies into smaller files in subdirectories of the repository.{% endif %} - -If a manifest or lock file is not processed, its dependencies are omitted from the dependency graph and they can't be checked for vulnerable dependencies. - -### 延伸阅读 - -- "[About the dependency graph](about-the-dependency-graph)"{% if currentVersion == "free-pro-team@latest" %} -- "[查看用于组织的洞见](/github/setting-up-and-managing-organizations-and-teams/viewing-insights-for-your-organization)" -- "[查看和更新仓库中的漏洞依赖项](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository)" -- "[了解 {% data variables.product.product_name %} 如何使用和保护数据](/github/understanding-how-github-uses-and-protects-your-data)" -{% endif %} diff --git a/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/listing-the-packages-that-a-repository-depends-on.md b/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/listing-the-packages-that-a-repository-depends-on.md deleted file mode 100644 index 8908fd42e1ad..000000000000 --- a/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/listing-the-packages-that-a-repository-depends-on.md +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: 列出仓库所依赖的包 -intro: 您可以在仓库图中查看项目的依赖项以及检测到的所有漏洞。 -redirect_from: - - /articles/listing-the-packages-that-a-repository-depends-on -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -### 关于依赖项图 - -依赖关系图适用于使用支持的文件格式、以支持的包生态系统定义依赖项的每个{% if currentVersion == "free-pro-team@latest" %}公共{% endif %}仓库。{% if currentVersion == "free-pro-team@latest" %} 仓库管理员也可对私有仓库设置依赖项图。{% endif %} - -{% data reusables.repositories.enable-security-alerts %} - -您可以在仓库的依赖项图中查看和更新有漏洞的依赖项。 依赖项图将有漏洞的依赖项列在其他依赖项前面。 更多信息请参阅“[关于依赖项漏洞的安全警报](/articles/about-security-alerts-for-vulnerable-dependencies)”。 - -{% if currentVersion == "free-pro-team@latest" %} -您可以在一个仪表板中查看组织仓库中使用的依赖项。 更多信息请参阅“[查看用于组织的洞见](/articles/viewing-insights-for-your-organization#viewing-organization-dependency-insights)”。{% endif %} - -### 支持的包生态系统 - -| 包管理器 | 语言 | 建议的格式 | 支持的格式 | -| ------------ | --------------------- | -------------------------------------------------- | -------------------------------------------------------------------- | -| Maven | Java、Scala | `pom.xml` | `pom.xml` | -| npm | JavaScript | `package-lock.json` | `package-lock.json`、`package.json` | -| Yarn | JavaScript | `yarn.lock` | `package.json`、`yarn.lock` | -| `dotnet` CLI | .NET 语言（C#、C++、F#、VB） | `.csproj`、`.vbproj`、`.nuspec`、`.vcxproj`、`.fsproj` | `.csproj`、`.vbproj`、`.nuspec`、`.vcxproj`、`.fsproj`、`packages.config` | -| Python PIP | Python | `requirements.txt`、`pipfile.lock` | `requirements.txt`、`pipfile.lock`、`setup.py`* | -| RubyGems | Ruby | `Gemfile.lock` | `Gemfile.lock`、`Gemfile`、`*.gemspec` | -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}| Composer | PHP | `composer.lock` | `composer.json`, `composer.lock` |{% endif %} - -{% note %} - -**注：**如果在 `setup.py` 文件中列出 Python 依赖项，我们可能无法剖析、列出和提醒项目中的每个依赖项。 - -{% endnote %} - -### 为启用了依赖项图的仓库列出依赖项 - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.accessing-repository-graphs %} -{% data reusables.repositories.click-dependency-graph %} - -{% if currentVersion == "free-pro-team@latest" %} -### 为私有仓库启用依赖项图 - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.accessing-repository-graphs %} -{% data reusables.repositories.click-dependency-graph %} -4. 阅读关于授予 {% data variables.product.product_name %} 访问仓库数据的消息，以启用依赖项图，然后单击 **Allow access（允许访问）**。 ![允许访问仓库数据以启用依赖项图的按钮](/assets/images/help/repository/dependency-graph-allow-access-button.png) - -更多信息请参阅“[了解 {% data variables.product.product_name %} 如何使用和保护数据](/categories/understanding-how-github-uses-and-protects-your-data)”。 - -### 为私有仓库禁用依赖项图 - -{% data reusables.repositories.you-can-enable-or-disable-security-features %} - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.sidebar-settings %} -3. 在 "Data services"（数据服务）下，取消选中 **Dependency graph（依赖项图）**。 ![禁用依赖项图的复选框](/assets/images/help/repository/private-repo-data-use-dependency-graph-disabled.png) - -To opt out of data use for your repository, see "[Opting into or out of data use for your private repository](/articles/opting-into-or-out-of-data-use-for-your-private-repository)." -{% endif %} - -### 依赖项图疑难排解 - -{% data reusables.repositories.troubleshooting-dependency-graph %} - -### 延伸阅读 - -- "[列出依赖仓库的项目](/articles/listing-the-projects-that-depend-on-a-repository)"{% if currentVersion == "free-pro-team@latest" %} -- "[了解 {% data variables.product.product_name %} 如何使用和保护数据](/categories/understanding-how-github-uses-and-protects-your-data)" -- "[查看和更新仓库中的漏洞依赖项](/articles/viewing-and-updating-vulnerable-dependencies-in-your-repository)"{% endif %} diff --git a/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/listing-the-projects-that-depend-on-a-repository.md b/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/listing-the-projects-that-depend-on-a-repository.md deleted file mode 100644 index 5c092e5aa3dc..000000000000 --- a/translations/zh-CN/content/github/visualizing-repository-data-with-graphs/listing-the-projects-that-depend-on-a-repository.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: 列出依赖仓库的项目 -intro: 您可以在依赖项图中查看依赖仓库的包和项目。 -redirect_from: - - /articles/listing-the-projects-that-depend-on-a-repository -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -### 关于依赖项图 -依赖项图包含包和应用程序的数据。 包是在包管理器中包含存储库的仓库，而应用程序是依赖所选仓库的仓库。 依赖项图中的应用程序列表按依赖仓库的最近项目排序。 - -依赖项图包含以下语言的数据： - -- RubyGems -- NPM -- PyPI -- Maven（仅 pom.xml） -- Nuget - -{% data reusables.repositories.enable-security-alerts %} - -{% note %} - -**注：**依赖项计数是近似值，可能与列出的依赖项不匹配。 - -{% endnote %} - -![从属者图](/assets/images/help/graphs/dependents_graph.png) - -### 访问依赖项图 - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.accessing-repository-graphs %} -{% data reusables.repositories.click-dependency-graph %} -4. 在 "Dependency graph"（依赖项图）下，单击 **Dependents（依赖项）**。 ![依赖项图中的依赖项选项卡](/assets/images/help/graphs/dependency-graph-dependents-tab.png) - -### 延伸阅读 - -- "[列出仓库所依赖的包](/articles/listing-the-packages-that-a-repository-depends-on)"{% if currentVersion == "free-pro-team@latest" %} -- "[查看用于组织的洞见](/articles/viewing-insights-for-your-organization)"{% endif %} diff --git a/translations/zh-CN/content/rest/reference/endpoints-available-for-github-apps.md b/translations/zh-CN/content/rest/reference/endpoints-available-for-github-apps.md deleted file mode 100644 index 3e17fbfa0894..000000000000 --- a/translations/zh-CN/content/rest/reference/endpoints-available-for-github-apps.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: 可用于 GitHub 应用程序的端点 -intro: 您的应用程序可以向以下 REST 端点发出请求。 -redirect_from: - - /v3/apps/available-endpoints -versions: - free-pro-team: '*' - enterprise-server: '*' ---- - -您必须使用安装访问令牌通过 {% data variables.product.prodname_github_app %} 访问端点。 更多信息请参阅“[向 {% data variables.product.prodname_github_apps %} 验证](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)”。 - -{% include rest_enabled_for_github_apps_in_current_version %} diff --git a/translations/zh-CN/data/reusables/actions/actions-app-read-permissions-sh-org.md b/translations/zh-CN/data/reusables/actions/actions-app-read-permissions-sh-org.md deleted file mode 100644 index 89cc846f3e23..000000000000 --- a/translations/zh-CN/data/reusables/actions/actions-app-read-permissions-sh-org.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_github_app %}s must have the `self-hosted runners:read` organization permission to use this endpoint. \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/actions/actions-app-secrets-org-permissions.md b/translations/zh-CN/data/reusables/actions/actions-app-secrets-org-permissions.md deleted file mode 100644 index 4f41e05ae20e..000000000000 --- a/translations/zh-CN/data/reusables/actions/actions-app-secrets-org-permissions.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_github_app %}s must have the `secrets` organization permission to use this endpoint. \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/actions/actions-app-secrets-permissions.md b/translations/zh-CN/data/reusables/actions/actions-app-secrets-permissions.md deleted file mode 100644 index 7709eb5b2e53..000000000000 --- a/translations/zh-CN/data/reusables/actions/actions-app-secrets-permissions.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_github_app %}s must have the `secrets` repository permission to use this endpoint. \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/actions/actions-app-write-permissions-sh-org.md b/translations/zh-CN/data/reusables/actions/actions-app-write-permissions-sh-org.md deleted file mode 100644 index f330c2358998..000000000000 --- a/translations/zh-CN/data/reusables/actions/actions-app-write-permissions-sh-org.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_github_app %}s must have the `self-hosted runners:write` organization permission to use this endpoint. \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/actions/actions-downloads.md b/translations/zh-CN/data/reusables/actions/actions-downloads.md deleted file mode 100644 index ac085b746d74..000000000000 --- a/translations/zh-CN/data/reusables/actions/actions-downloads.md +++ /dev/null @@ -1 +0,0 @@ -使用 `-v` 旗标调用此端点，以启用详细输出，并允许您在标头中查看下载 URL。 要将文件下载到当前工作目录中，请使用 `-o` 指定文件名。 \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/actions/actions-secret-encyption-examples.md b/translations/zh-CN/data/reusables/actions/actions-secret-encyption-examples.md deleted file mode 100644 index 3a0d000bd9f3..000000000000 --- a/translations/zh-CN/data/reusables/actions/actions-secret-encyption-examples.md +++ /dev/null @@ -1,69 +0,0 @@ -#### Example encrypting a secret using Node.js - -使用 [tweetsodium](https://github.com/github/tweetsodium) 库对密码进行加密。 - -```js -const sodium = require('tweetsodium'); - -const key = "base64-encoded-public-key"; -const value = "plain-text-secret"; - -// Convert the message and key to Uint8Array's (Buffer implements that interface) -const messageBytes = Buffer.from(value); -const keyBytes = Buffer.from(key, 'base64'); - -// Encrypt using LibSodium. -const encryptedBytes = sodium.seal(messageBytes, keyBytes); - -// Base64 the encrypted secret -const encrypted = Buffer.from(encryptedBytes).toString('base64'); - -console.log(encrypted); -``` - -#### Example encrypting a secret using Python - -使用 [pynacl](https://pynacl.readthedocs.io/en/stable/public/#nacl-public-sealedbox) 和 Python 3 对密码进行加密。 - -```py -from base64 import b64encode -from nacl import encoding, public - -def encrypt(public_key: str, secret_value: str) -> str: - """Encrypt a Unicode string using the public key.""" - public_key = public.PublicKey(public_key.encode("utf-8"), encoding.Base64Encoder()) - sealed_box = public.SealedBox(public_key) - encrypted = sealed_box.encrypt(secret_value.encode("utf-8")) - return b64encode(encrypted).decode("utf-8") -``` - -#### Example encrypting a secret using C\# - -Encrypt your secret using the [Sodium.Core](https://www.nuget.org/packages/Sodium.Core/) package. - -```csharp -var secretValue = System.Text.Encoding.UTF8.GetBytes("mySecret"); -var publicKey = Convert.FromBase64String("2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvvcCU="); - -var sealedPublicKeyBox = Sodium.SealedPublicKeyBox.Create(secretValue, publicKey); - -Console.WriteLine(Convert.ToBase64String(sealedPublicKeyBox)); -``` - -#### Example encrypting a secret using Ruby - -使用 [rbnacl](https://github.com/RubyCrypto/rbnacl) gem 对密码进行加密。 - -```ruby -require "rbnacl" -require "base64" - -key = Base64.decode64("+ZYvJDZMHUfBkJdyq5Zm9SKqeuBQ4sj+6sfjlH4CgG0=") -public_key = RbNaCl::PublicKey.new(key) - -box = RbNaCl::Boxes::Sealed.from_public_key(public_key) -encrypted_secret = box.encrypt("my_secret") - -# Print the base64 encoded secret -puts Base64.strict_encode64(encrypted_secret) -``` diff --git a/translations/zh-CN/data/reusables/actions/gh-app-actions-read-permissions.md b/translations/zh-CN/data/reusables/actions/gh-app-actions-read-permissions.md deleted file mode 100644 index 08998b6efb12..000000000000 --- a/translations/zh-CN/data/reusables/actions/gh-app-actions-read-permissions.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_github_app %}s must have the `actions:read` permission to use this endpoint. \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/actions/gh-app-actions-write-permissions.md b/translations/zh-CN/data/reusables/actions/gh-app-actions-write-permissions.md deleted file mode 100644 index c7c714441f31..000000000000 --- a/translations/zh-CN/data/reusables/actions/gh-app-actions-write-permissions.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_github_app %}s must have the `actions:write` permission to use this endpoint. \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/actions/workflow-route-param-by-name.md b/translations/zh-CN/data/reusables/actions/workflow-route-param-by-name.md deleted file mode 100644 index 697b1a078ad1..000000000000 --- a/translations/zh-CN/data/reusables/actions/workflow-route-param-by-name.md +++ /dev/null @@ -1 +0,0 @@ -您也可以将 `:workflow_id` 替换为 `:workflow_file_name`。 例如，您可以使用 `main.yml`。 \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/actions/workflow-usage.md b/translations/zh-CN/data/reusables/actions/workflow-usage.md deleted file mode 100644 index 90836167de81..000000000000 --- a/translations/zh-CN/data/reusables/actions/workflow-usage.md +++ /dev/null @@ -1 +0,0 @@ -Billable minutes only apply to workflows in private repositories that use {% data variables.product.prodname_dotcom %}-hosted runners. Usage is listed for each {% data variables.product.prodname_dotcom %}-hosted runner operating system in milliseconds. Any job re-runs are also included in the usage. The usage does not include the multiplier for macOS and Windows runners and is not rounded up to the nearest whole minute. For more information, see "[Managing billing for {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)". \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/actions/workflow_runs_parameters_table.md b/translations/zh-CN/data/reusables/actions/workflow_runs_parameters_table.md deleted file mode 100644 index ac4cb844fe4f..000000000000 --- a/translations/zh-CN/data/reusables/actions/workflow_runs_parameters_table.md +++ /dev/null @@ -1,8 +0,0 @@ -#### 参数 - -| 名称 | 类型 | 描述 | -| ------- | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `actor` | `字符串` | Returns someone's workflow runs. Use the login for the user who created the `push` associated with the check suite or workflow run. | -| `分支` | `字符串` | Returns workflow runs associated with a branch. Use the name of the branch of the `push`. | -| `event` | `字符串` | Returns workflow run triggered by the event you specify. For example, `push`, `pull_request` or `issue`. For more information, see "[Events that trigger workflows](/actions/automating-your-workflow-with-github-actions/events-that-trigger-workflows)". | -| `状态` | `字符串` | Returns workflow runs associated with the check run `status` or `conclusion` you specify. For example, a conclusion can be `success` or a status can be `completed`. For more information, see the `status` and `conclusion` options available in "[Create a check run](/v3/checks/runs/#create-a-check-run)." | diff --git a/translations/zh-CN/data/reusables/apps/access_token_parameters_table_and_example.md b/translations/zh-CN/data/reusables/apps/access_token_parameters_table_and_example.md deleted file mode 100644 index 167aaa920510..000000000000 --- a/translations/zh-CN/data/reusables/apps/access_token_parameters_table_and_example.md +++ /dev/null @@ -1,13 +0,0 @@ -#### 参数 - -| 名称 | 类型 | 描述 | -| -------------- | ----- | ------------------------------ | -| `access_token` | `字符串` | 用于向 GitHub API 验证的 OAuth 访问令牌。 | - -#### 示例 - -```json -{ - "access_token": "e72e16c7e42f292c6912e7710c838347ae178b4a" -} -``` diff --git a/translations/zh-CN/data/reusables/apps/app_req_account_deletion.md b/translations/zh-CN/data/reusables/apps/app_req_account_deletion.md deleted file mode 100644 index fc8f7cc458bd..000000000000 --- a/translations/zh-CN/data/reusables/apps/app_req_account_deletion.md +++ /dev/null @@ -1 +0,0 @@ -Apps must provide customers with a way to delete their account, without having to email or call a support person. diff --git a/translations/zh-CN/data/reusables/apps/authenticated_user_access.md b/translations/zh-CN/data/reusables/apps/authenticated_user_access.md deleted file mode 100644 index 1e4977d57512..000000000000 --- a/translations/zh-CN/data/reusables/apps/authenticated_user_access.md +++ /dev/null @@ -1 +0,0 @@ -经过身份验证的用户对其拥有的仓库、他们作为协作者的仓库以及他们可通过组织成员资格访问的仓库具有明确的访问权限。 diff --git a/translations/zh-CN/data/reusables/apps/authorizations_oauth_tokens_SAML.md b/translations/zh-CN/data/reusables/apps/authorizations_oauth_tokens_SAML.md deleted file mode 100644 index 04c8f7f4dbfc..000000000000 --- a/translations/zh-CN/data/reusables/apps/authorizations_oauth_tokens_SAML.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -{% warning %} - -**警告：**应用程序必须使用 [web 应用程序流程](/apps/building-oauth-apps/authorizing-oauth-apps/#web-application-flow)来获取适用于 GitHub SAML 组织的 OAuth 令牌。 使用授权 API 创建的 OAuth 令牌将无法访问 GitHub SAML 组织。 更多信息请参阅[博客帖子](https://developer.github.com/changes/2019-11-05-deprecated-passwords-and-authorizations-api)。 - -{% endwarning %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/apps/deprecating_applications_api_endpoints.md b/translations/zh-CN/data/reusables/apps/deprecating_applications_api_endpoints.md deleted file mode 100644 index d9a22f21ade8..000000000000 --- a/translations/zh-CN/data/reusables/apps/deprecating_applications_api_endpoints.md +++ /dev/null @@ -1,9 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -{% warning %} - -**Deprecation Notice:** {% data variables.product.prodname_dotcom %} will replace and discontinue OAuth endpoints containing `access_token` in the path parameter. We are introducing new endpoints that allow you to securely manage tokens for OAuth Apps by using `access_token` as an input parameter.{% if currentVersion == "free-pro-team@latest" %} The OAuth Application API will be removed on May 5, 2021.{% endif %} For more information,{% if currentVersion == "free-pro-team@latest" %} including scheduled brownouts,{% endif %} see the [blog post](https://developer.github.com/changes/2020-02-14-deprecating-oauth-app-endpoint/). - -{% if currentVersion != "free-pro-team@latest" %} OAuth endpoints using an `access_token` in the path parameter are currently available and not yet deprecated in {% data variables.product.prodname_ghe_server %}. {% data variables.product.prodname_dotcom %} will announce the deprecation and provide advanced notice before removing support for this feature.{% endif %} - -{% endwarning %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/apps/deprecating_github_services_ghe_compact.md b/translations/zh-CN/data/reusables/apps/deprecating_github_services_ghe_compact.md deleted file mode 100644 index 6ffb0325d760..000000000000 --- a/translations/zh-CN/data/reusables/apps/deprecating_github_services_ghe_compact.md +++ /dev/null @@ -1 +0,0 @@ -GitHub Enterprise release 2.17 and higher no longer allows admins to install GitHub Services. Please see the [Replacing GitHub Services guide](/v3/guides/replacing-github-services) for details. \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/apps/deprecating_oauth_authorizations.md b/translations/zh-CN/data/reusables/apps/deprecating_oauth_authorizations.md deleted file mode 100644 index 1ba5d7242e26..000000000000 --- a/translations/zh-CN/data/reusables/apps/deprecating_oauth_authorizations.md +++ /dev/null @@ -1,9 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -{% warning %} - -**Deprecation Notice:** {% data variables.product.prodname_dotcom %} will discontinue the OAuth Authorizations API, which is used by integrations to create personal access tokens and OAuth tokens, and you must now create these tokens using our [web application flow](/apps/building-oauth-apps/authorizing-oauth-apps/#web-application-flow).{% if currentVersion == "free-pro-team@latest" %} The OAuth Authorizations API will be removed on November, 13, 2020.{% endif %} For more information,{% if currentVersion == "free-pro-team@latest" %} including scheduled brownouts,{% endif %} see the [blog post](https://developer.github.com/changes/2020-02-14-deprecating-oauth-auth-endpoint/). - -{% if currentVersion != "free-pro-team@latest" %} The OAuth Authorizations API is currently available and not yet deprecated in {% data variables.product.prodname_ghe_server %}. {% data variables.product.prodname_dotcom %} will announce the deprecation and provide advanced notice before removing support for this feature.{% endif %} - -{% endwarning %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/apps/iat_required.md b/translations/zh-CN/data/reusables/apps/iat_required.md deleted file mode 100644 index c15c5042f1d1..000000000000 --- a/translations/zh-CN/data/reusables/apps/iat_required.md +++ /dev/null @@ -1 +0,0 @@ -您必须使用[安装设施访问令牌](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)才能访问此端点。 diff --git a/translations/zh-CN/data/reusables/apps/iat_required_multiple_endpoints.md b/translations/zh-CN/data/reusables/apps/iat_required_multiple_endpoints.md deleted file mode 100644 index 2147de3e7766..000000000000 --- a/translations/zh-CN/data/reusables/apps/iat_required_multiple_endpoints.md +++ /dev/null @@ -1 +0,0 @@ -You must use an [installation access token](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation) to access these endpoints. diff --git a/translations/zh-CN/data/reusables/apps/jwt_or_client_secret_required.md b/translations/zh-CN/data/reusables/apps/jwt_or_client_secret_required.md deleted file mode 100644 index 7d5a916ec3cd..000000000000 --- a/translations/zh-CN/data/reusables/apps/jwt_or_client_secret_required.md +++ /dev/null @@ -1 +0,0 @@ -GitHub 应用程序必须使用 [JWT](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) 才能访问此端点。 OAuth 应用程序必须使用[基本身份验证](/v3/auth/#basic-authentication)及其客户端 ID 和客户端密钥才能访问此端点。 diff --git a/translations/zh-CN/data/reusables/apps/jwt_required.md b/translations/zh-CN/data/reusables/apps/jwt_required.md deleted file mode 100644 index 16bc911537e0..000000000000 --- a/translations/zh-CN/data/reusables/apps/jwt_required.md +++ /dev/null @@ -1 +0,0 @@ -您必须使用 [JWT](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) 才能访问此端点。 diff --git a/translations/zh-CN/data/reusables/apps/null-headbranch.md b/translations/zh-CN/data/reusables/apps/null-headbranch.md deleted file mode 100644 index 9909557ac600..000000000000 --- a/translations/zh-CN/data/reusables/apps/null-headbranch.md +++ /dev/null @@ -1 +0,0 @@ -The Checks API only looks for pushes in the repository where the check suite or check run were created. 未检测到向复刻的仓库中分支的推送，为 `head_branch` 返回空的 `pull_requests` 数组和 `null` 值。 diff --git a/translations/zh-CN/data/reusables/apps/pat_or_ba_required.md b/translations/zh-CN/data/reusables/apps/pat_or_ba_required.md deleted file mode 100644 index a595ba312649..000000000000 --- a/translations/zh-CN/data/reusables/apps/pat_or_ba_required.md +++ /dev/null @@ -1 +0,0 @@ -必须使用个人访问令牌（您可以通过[命令行](/articles/creating-a-personal-access-token-for-the-command-line/)或[OAuth 授权 API](/v3/oauth_authorizations/#create-a-new-authorization) 来创建）或[基本身份验证](/v3/auth/#basic-authentication)才能访问此端点。 diff --git a/translations/zh-CN/data/reusables/apps/u2s_required.md b/translations/zh-CN/data/reusables/apps/u2s_required.md deleted file mode 100644 index 5a72c38bf14c..000000000000 --- a/translations/zh-CN/data/reusables/apps/u2s_required.md +++ /dev/null @@ -1 +0,0 @@ -必须使用为授权 GitHub 应用程序的用户而创建的 [user-to-server OAuth 访问令牌](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/#identifying-users-on-your-site)，才能访问此端点。 diff --git a/translations/zh-CN/data/reusables/apps/undetected-pushes-to-a-forked-repository-for-check-runs.md b/translations/zh-CN/data/reusables/apps/undetected-pushes-to-a-forked-repository-for-check-runs.md deleted file mode 100644 index f6ba9c704203..000000000000 --- a/translations/zh-CN/data/reusables/apps/undetected-pushes-to-a-forked-repository-for-check-runs.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**注：**检查 API 仅在创建检查套件或检查运行的仓库中搜索推送。 未检测到向复刻的仓库中分支的推送，返回一个空的 `pull_requests` 数组。 - -{% endnote %} diff --git a/translations/zh-CN/data/reusables/blog/affected_users.md b/translations/zh-CN/data/reusables/blog/affected_users.md deleted file mode 100644 index a390a81ab553..000000000000 --- a/translations/zh-CN/data/reusables/blog/affected_users.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Note**: This update only affects users of GitHub.com and future versions of GitHub Enterprise. - -{% endnote %} diff --git a/translations/zh-CN/data/reusables/branches/apps-permissions.md b/translations/zh-CN/data/reusables/branches/apps-permissions.md deleted file mode 100644 index a549fc7d28dd..000000000000 --- a/translations/zh-CN/data/reusables/branches/apps-permissions.md +++ /dev/null @@ -1 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}Only installed {% data variables.product.prodname_github_app %}s with `write` access to the `contents` permission can be added as authorized actors on a protected branch.{% endif %} diff --git a/translations/zh-CN/data/reusables/branches/limits.md b/translations/zh-CN/data/reusables/branches/limits.md deleted file mode 100644 index 1242d37342d9..000000000000 --- a/translations/zh-CN/data/reusables/branches/limits.md +++ /dev/null @@ -1 +0,0 @@ -**Note**: The list of users{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %}, apps,{% endif %} and teams in total is limited to 100 items. diff --git a/translations/zh-CN/data/reusables/branches/rename-existing-branch.md b/translations/zh-CN/data/reusables/branches/rename-existing-branch.md deleted file mode 100644 index 174a317ddc65..000000000000 --- a/translations/zh-CN/data/reusables/branches/rename-existing-branch.md +++ /dev/null @@ -1,3 +0,0 @@ -While you can rename your repository's existing default branch, {% data variables.product.company_short %} plans to provide tools to simplify the process of renaming the default branch. For more information on these plans, see [`github/renaming`](https://github.com/github/renaming). - -If you have already renamed the default branch, {% data variables.product.prodname_dotcom %} will automatically redirect links on {% if currentVersion ver_gt "enterprise-server@2.22" %} {% data variables.product.product_location_enterprise %}{% else %}{% data variables.product.prodname_dotcom_the_website %}{% endif %} that contain a deleted `master` branch name to the equivalent link on the repository's default branch. diff --git a/translations/zh-CN/data/reusables/checks/conclusion_values.md b/translations/zh-CN/data/reusables/checks/conclusion_values.md deleted file mode 100644 index 5d19b1ca702c..000000000000 --- a/translations/zh-CN/data/reusables/checks/conclusion_values.md +++ /dev/null @@ -1 +0,0 @@ -**在提供 `completed_at` 或 `completed` 的 `status` 时需要**。 检查的最后结论。 Can be one of `success`, `failure`, `neutral`, `cancelled`, {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" %}`skipped`, {% endif %}`timed_out`, or `action_required`. \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/checks/requested_actions.md b/translations/zh-CN/data/reusables/checks/requested_actions.md deleted file mode 100644 index 1c040984c463..000000000000 --- a/translations/zh-CN/data/reusables/checks/requested_actions.md +++ /dev/null @@ -1 +0,0 @@ -要了解有关检查运行和请的求操作的详细信息，请参阅“[检查运行和请求的操作](/v3/checks/runs/#check-runs-and-requested-actions)”。 diff --git a/translations/zh-CN/data/reusables/cli/beta.md b/translations/zh-CN/data/reusables/cli/beta.md deleted file mode 100644 index 43174757dd1d..000000000000 --- a/translations/zh-CN/data/reusables/cli/beta.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_cli %} 目前处于测试阶段，可能会有变化。 diff --git a/translations/zh-CN/data/reusables/collaborators/collaborator-definition.md b/translations/zh-CN/data/reusables/collaborators/collaborator-definition.md deleted file mode 100644 index af37fe0d3162..000000000000 --- a/translations/zh-CN/data/reusables/collaborators/collaborator-definition.md +++ /dev/null @@ -1 +0,0 @@ -the list of collaborators includes outside collaborators, organization members that are direct collaborators, organization members with access through team memberships, organization members with access through default organization permissions, and organization owners. diff --git a/translations/zh-CN/data/reusables/command_line/parameters_filters.md b/translations/zh-CN/data/reusables/command_line/parameters_filters.md deleted file mode 100644 index 39cfa8cc3a31..000000000000 --- a/translations/zh-CN/data/reusables/command_line/parameters_filters.md +++ /dev/null @@ -1 +0,0 @@ -您可以使用参数缩小结果列表。 有关使用参数的更多信息，请参阅 [参数](/v3/#parameters)。 \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/commits/verification-object-definition.md b/translations/zh-CN/data/reusables/commits/verification-object-definition.md deleted file mode 100644 index d9b31285cf7f..000000000000 --- a/translations/zh-CN/data/reusables/commits/verification-object-definition.md +++ /dev/null @@ -1,28 +0,0 @@ -##### 签名验证对象 - -响应将包含一个 `verification` 对象，以描述验证提交签名的结果。 以下字段包含在 `verification` 对象中： - -| 名称 | 类型 | 描述 | -| ----------- | ----- | -------------------------------------------------------------------------------------------------- | -| `已验证` | `布尔值` | Indicates whether GitHub considers the signature in this commit to be verified. | -| `原因` | `字符串` | The reason for `verified` value. Possible values and their meanings are enumerated in table below. | -| `signature` | `字符串` | The signature that was extracted from the commit. | -| `payload` | `字符串` | The value that was signed. | - -以下是 `verification` 对象中 `reason` 的可能值： - -| 值 | 描述 | -| ------------------------ | ------------------------------------------------- | -| `expired_key` | 表示签名过期的键。 | -| `not_signing_key` | “签名”标志不在生成签名的 GPG 密钥的使用标志中。 | -| `gpgverify_error` | 与签名验证服务通信时出错。 | -| `gpgverify_unavailable` | 签名验证服务当前不可用。 | -| `unsigned` | 对象不包括签名。 | -| `unknown_signature_type` | 在提交中发现非 PGP 签名。 | -| `no_user` | 没有用户与提交中的 `committer` 电子邮件地址相关联。 | -| `unverified_email` | 提交中的 `committer` 电子邮件地址与某个用户相关联，但未在其帐户中验证该电子邮件地址。 | -| `bad_email` | 提交中的 `committer` 电子邮件地址未包含在生成签名的 PGP 密钥的标识中。 | -| `unknown_key` | 进行签名的密钥尚未向任何用户帐户注册。 | -| `malformed_signature` | 解析签名时出错。 | -| `invalid` | 无法使用在签名中找到密钥 ID 的密钥进行加密验证签名。 | -| `有效` | 未出现上述任何错误，因此该签名被视为已验证。 | diff --git a/translations/zh-CN/data/reusables/desktop/commit-history-list.md b/translations/zh-CN/data/reusables/desktop/commit-history-list.md deleted file mode 100644 index 5de60e700713..000000000000 --- a/translations/zh-CN/data/reusables/desktop/commit-history-list.md +++ /dev/null @@ -1 +0,0 @@ -1. 在提交历史记录列表中，单击要还原的提交。 diff --git a/translations/zh-CN/data/reusables/desktop/enter-2fa-in-browser.md b/translations/zh-CN/data/reusables/desktop/enter-2fa-in-browser.md deleted file mode 100644 index 7e98e9551a27..000000000000 --- a/translations/zh-CN/data/reusables/desktop/enter-2fa-in-browser.md +++ /dev/null @@ -1 +0,0 @@ -1. 返回到 {% data variables.product.prodname_dotcom %}。 在提示符中，输入 2FA 代码，然后单击**Verify（验证）**。 ![2FA 验证码字段](/assets/images/help/desktop/2fa-code-field.png) diff --git a/translations/zh-CN/data/reusables/desktop/retrieve-2fa-in-browser.md b/translations/zh-CN/data/reusables/desktop/retrieve-2fa-in-browser.md deleted file mode 100644 index ec706b49887b..000000000000 --- a/translations/zh-CN/data/reusables/desktop/retrieve-2fa-in-browser.md +++ /dev/null @@ -1,3 +0,0 @@ -1. 如果已为 {% data variables.product.prodname_dotcom %} 配置双重身份验证，请执行以下操作之一： - - 如果通过 SMS 设置 2FA，则从 SMS 消息检索 2FA 代码 。 - - 如果使用 TOTP 应用程序设置 2FA，则生成 2FA 代码。 diff --git a/translations/zh-CN/data/reusables/desktop/windows-select-file-menu.md b/translations/zh-CN/data/reusables/desktop/windows-select-file-menu.md deleted file mode 100644 index 69a41cebf73b..000000000000 --- a/translations/zh-CN/data/reusables/desktop/windows-select-file-menu.md +++ /dev/null @@ -1 +0,0 @@ -1. 在窗口的左上角，选择 **File（文件）** 菜单。 ![Windows 菜单栏中的 {% data variables.product.prodname_desktop %} 菜单](/assets/images/help/desktop/windows-select-file-menu.png) diff --git a/translations/zh-CN/data/reusables/dotcom_billing/cost-management-tab.md b/translations/zh-CN/data/reusables/dotcom_billing/cost-management-tab.md deleted file mode 100644 index dcea12c5035d..000000000000 --- a/translations/zh-CN/data/reusables/dotcom_billing/cost-management-tab.md +++ /dev/null @@ -1 +0,0 @@ -1. 在“Billing（帐单）”下，单击 **Cost management（成本管理）**。 ![成本管理选项卡](/assets/images/help/settings/cost-management-tab.png) diff --git a/translations/zh-CN/data/reusables/dotcom_billing/publishing-nodejs-packages.md b/translations/zh-CN/data/reusables/dotcom_billing/publishing-nodejs-packages.md deleted file mode 100644 index ee10b383281d..000000000000 --- a/translations/zh-CN/data/reusables/dotcom_billing/publishing-nodejs-packages.md +++ /dev/null @@ -1,203 +0,0 @@ ---- -title: 发布 Node.js 包 -intro: 您可以将 Node.js 包发布到注册表，作为持续集成 (CI) 工作流程的一部分。 -product: '{% data reusables.gated-features.actions %}' -productVersions: - dotcom: '*' -redirect_from: - - /actions/automating-your-workflow-with-github-actions/publishing-nodejs-packages ---- - -### 简介 - -本指南介绍如何创建一个工作流程，以在持续集成 (CI) 测试通过后将 Node.js 包发布到 {% data variables.product.prodname_registry %} 和 npm 注册表。 通过单个工作流程，您可以将包发布到单个注册表或多个注册表。 - -### 基本要求 - -建议基本了解工作流程配置选项和如何创建工作流程文件。 更多信息请参阅“[配置工作流程](/actions/automating-your-workflow-with-github-actions/configuring-a-workflow)。 - -有关为 Node.js 项目创建 CI 工作流程的更多信息，请参阅“[将 Node.js 与 {% data variables.product.prodname_actions %} 一起使用](/actions/automating-your-workflow-with-github-actions/using-nodejs-with-github-actions)。” - -您可能还发现基本了解以下内容是有帮助的： - -- "[{% data variables.product.prodname_actions %} 的核心概念](/actions/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)" -- "[配置 npm 用于 {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages/configuring-npm-for-use-with-github-packages)" -- "[使用环境变量](/actions/automating-your-workflow-with-github-actions/using-environment-variables)" -- "[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)" -- "[使用 GITHUB_TOKEN 验证身份](/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token)" - -### 关于包配置 - - *package.json* 文件中的 `name` 和 `version` 字段创建唯一标识符，供注册表用来将包链接到注册表。 您可以在 *package.json* 文件中添加 `description` 字段，从而为包列表页面添加一个摘要。 更多信息请参阅 npm 文档中的“[创建 package.json 文件](https://docs.npmjs.com/creating-a-package-json-file)”和“[创建 Node.js 模块](https://docs.npmjs.com/creating-node-js-modules)”。 - -当本地 *.npmrc* 文件存在且指定了 `registry` 值时，`npm publish` 命令将使用 *.npmrc* 文件中配置的注册表。 {% data reusables.github-actions.setup-node-intro %} - -您可以使用 `setup-node` 操作指定运行器上安装的 Node.js 版本。 - -如果在工作流程中添加步骤来配置 *package.json* 文件中的 `publishConfig` 字段，则无需使用 `setup-node` 操作指定注册表 url，但软件包仅限于发布到一个注册表。 更多信息请参阅 npm 文档中的“[publishConfig](https://docs.npmjs.com/files/package.json#publishconfig)”。 - -### 发布包到 npm 注册表 - -每次创建新版本时，都可以触发工作流程来发布包。 以下示例中的工作流程在类型为 `created` 的 `release` 事件触发时运行。 如果 CI 测试通过，工作流程将包发布到 npm 注册表。 - -要根据工作流程中的 npm 注册表执行经过身份验证的操作，您需要在仓库设置中将 npm 身份验证令牌作存储为密码。 例如，创建名为 `NPM_TOKEN` 的密码。 更多信息请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。 - -默认情况下，npm 使用 *package.json* 文件的 `name` 字段来确定 npm 注册表。 当发布到全局命名空间时，您只需要包含包名称。 例如，您要发布一个名为 `npm-hello-world-test` 的包到 `https://www.npmjs.com/package/npm-hello-world-test`。 - -如果发布一个包含范围前缀的包，请将范围包含在 *package.json* 文件的名称中。 例如，如果 npm 范围前缀是 octocat 并且包名是 hello-world，则 *package.json* 文件中的 `name` 应为 `@octocat/hello-world`。 如果 npm 包使用范围前缀且包是公开的，则需使用选项 `npm publish --access public`。 这是 npm 需要用来防止有人无意中发布私有包的选项。 - -此示例将 `NPM_TOKEN` 密码存储在 `NODE_AUTH_TOKEN` 环境变量中。 当 `setup-node` 操作创建 *.npmrc* 文件时，会引用 `NODE_AUTH_TOKEN` 环境变量中的令牌。 - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # Setup .npmrc file to publish to npm - - uses: actions/setup-node@v1 - with: - node-version: '12.x' - registry-url: 'https://registry.npmjs.org' - - run: npm install - - run: npm publish - env: - NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} -``` -{% endraw %} - -在上面的示例中，`setup-node` 操作在运行器上创建一个包含以下内容的 *.npmrc* 文件： - -``` -//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN} -registry=https://registry.npmjs.org/ -always-auth=true -``` - -### 发布包到 {% data variables.product.prodname_registry %} - -每次创建新版本时，都可以触发工作流程来发布包。 以下示例中的工作流程在类型为 `created` 的 `release` 事件发生时运行。 如果 CI 测试通过，工作流程会将包发布到 {% data variables.product.prodname_registry %}。 - -默认情况下，{% data variables.product.prodname_registry %} 将包发布到您在 *package.json* 文件的 `name` 字段中指定的 {% data variables.product.prodname_dotcom %} 仓库。 例如，您要发布一个名为 `@my-org/test` 的包到 `my-org/test` {% data variables.product.prodname_dotcom %} 仓库。 更多信息请参阅 npm 文档中的 [`npm-scope`](https://docs.npmjs.com/misc/scope)。 - -要根据 {% data variables.product.prodname_registry %} 注册表在工作流程中执行经验证的操作，可以使用 `GITHUB_TOKEN`。 `GITHUB_TOKEN` 默认存在于您的仓库中，并且对工作流程运行的仓库中的包具有读取和写入权限。 更多信息请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。 - -此示例将 `GITHUB_TOKEN` 密码存储在 `NODE_AUTH_TOKEN` 环境变量中。 当 `setup-node` 操作创建 *.npmrc* 文件时，会引用 `NODE_AUTH_TOKEN` 环境变量中的令牌。 - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # Setup .npmrc file to publish to GitHub Packages - - uses: actions/setup-node@v1 - with: - node-version: '12.x' - registry-url: 'https://npm.pkg.github.com' - scope: '@octocat' # Defaults to the user or organization that owns the workflow file - - run: npm install - - run: npm publish - env: - NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} - -`setup-node` 操作在运行器上创建 *.npmrc* 文件。 使用 `scope` 输入到 `setup-node` 操作时，*.npmrc* 文件包含作用域前缀。 默认情况下，`setup-node` 操作在 *.npmrc* 文件中将作用域设置为包含该工作流程文件的帐户。 - -``` -//npm.pkg.github.com/:_authToken=${NODE_AUTH_TOKEN} -@octocat:registry=https://npm.pkg.github.com -always-auth=true -``` - -### 使用 yarn 发布包 - -如果您使用 Yarn 包管理器，可以使用 Yarn 安装和发布包。 - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # Setup .npmrc file to publish to npm - - uses: actions/setup-node@v1 - with: - node-version: '12.x' - registry-url: 'https://registry.npmjs.org' - scope: '@octocat' # Defaults to the user or organization that owns the workflow file - - run: yarn - - run: yarn publish - env: - NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} -``` -{% endraw %} - -### 发布包到 npm 和 {% data variables.product.prodname_registry %} - -{% note %} - -**注意：**如果需要发布到具有不同作用域前缀的注册表，则需修改运行器上的 *package.json* 文件以更改作用域前缀。 例如，如果将包发布到 npm 的 `@mona` 作用域和 {% data variables.product.prodname_registry %} 的 `@octocat` 作用域，则可在发布到 npm 之后和发布到 {% data variables.product.prodname_registry %} 之前，在运行器的 *package.json* 文件中将 `@mona` 作用域替换成 `@octocat`。 - -{% endnote %} - -您可以使用每个注册表的 `setup-node` 操作将包发布到 npm 注册表和 {% data variables.product.prodname_registry %}。 - -如果将包发布到两个注册表，则需要确保 npm 上的作用域前缀与 {% data variables.product.prodname_dotcom %} 用户或组织名称匹配。 要将包发布到具有作用域前缀的公共注册表，可以使用 `npm publish --access public`。 更多信息请参阅 [`npm-scope`](https://docs.npmjs.com/misc/scope) 和 npm 文档中的“[创建和发布作用域的公共包](https://docs.npmjs.com/creating-and-publishing-scoped-public-packages)”。 - -确认 *package.json* 文件包含 {% data variables.product.prodname_dotcom %} 仓库和 npm 注册表的作用域。 例如，如果您计划将 `octocat/npm-hello-world-test` 仓库中的包发布到 {% data variables.product.prodname_dotcom %} 和 https://www.npmjs.com/package/@octocat/npm-hello-world-test，则 *package.json* 文件中的名称将是 `"name": "@octocat/npm-hello-world-test"`。 - -要根据 {% data variables.product.prodname_registry %} 注册表在工作流程中执行经验证的操作，可以使用 `GITHUB_TOKEN`。 `GITHUB_TOKEN` 默认存在于您的仓库中，并且对工作流程运行的仓库中的包具有读取和写入权限。 更多信息请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。 - -使用 `scope` 输入到 `setup-node` 操作时，操作将创建包含作用域前缀的 *.npmrc* 文件。 默认情况下，`setup-node` 操作在 *.npmrc* 文件中将作用域设置为拥有该工作流程文件的用户或组织。 - -此工作流程将调用 `setup-node` 操作两次。 每当 `setup-node` 操作运行时，都会覆盖 *.npmrc* 文件。 *.npmrc* 文件引用的令牌允许您对 `NODE_AUTH_TOKEN` 环境变量中的包注册表执行验证的操作。 工作流程在 `npm publish` 命令每次运行时设置 `NODE_AUTH_TOKEN` 环境变量，先通过令牌发布到 npm (`NPM_TOKEN`)，然后通过令牌发布到 {% data variables.product.prodname_registry %} (`GITHUB_TOKEN`)。 - -{% raw %} -```yaml -name: Node.js Package -on: - release: - types: [created] -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v2 - # Setup .npmrc file to publish to npm - - uses: actions/setup-node@v1 - with: - node-version: '10.x' - registry-url: 'https://registry.npmjs.org' - - run: npm install - # Publish to npm - - run: npm publish --access public - env: - NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} - # Setup .npmrc file to publish to GitHub Packages - - uses: actions/setup-node@v1 - with: - registry-url: 'https://npm.pkg.github.com' - scope: '@octocat' # Defaults to the user or organization that owns the workflow file - # Publish to GitHub Packages - - run: npm publish - env: - NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }} -``` -{% endraw %} diff --git a/translations/zh-CN/data/reusables/enterprise-accounts/business-settings.md b/translations/zh-CN/data/reusables/enterprise-accounts/business-settings.md deleted file mode 100644 index 4a140dfc6780..000000000000 --- a/translations/zh-CN/data/reusables/enterprise-accounts/business-settings.md +++ /dev/null @@ -1 +0,0 @@ -1. 在企业帐户名称下，单击 {% octicon "gear" aria-label="The Settings gear" %} **Settings（设置）**。 ![企业帐户资料页面上的“设置”选项卡](/assets/images/help/business-accounts/business-account-settings-tab.png) diff --git a/translations/zh-CN/data/reusables/enterprise-accounts/github-dotcom-connection-tab.md b/translations/zh-CN/data/reusables/enterprise-accounts/github-dotcom-connection-tab.md deleted file mode 100644 index 273437af2dfe..000000000000 --- a/translations/zh-CN/data/reusables/enterprise-accounts/github-dotcom-connection-tab.md +++ /dev/null @@ -1 +0,0 @@ -1. 在左侧边栏中，单击 **{% data variables.product.prodname_dotcom_the_website %} connection（连接）**。 ![企业帐户设置侧边栏中的“GitHub.com 连接”选项卡](/assets/images/enterprise/business-accounts/settings-github-dotcom-connection-tab.png) diff --git a/translations/zh-CN/data/reusables/enterprise-accounts/member-privileges-tab.md b/translations/zh-CN/data/reusables/enterprise-accounts/member-privileges-tab.md deleted file mode 100644 index 4bd05ae51151..000000000000 --- a/translations/zh-CN/data/reusables/enterprise-accounts/member-privileges-tab.md +++ /dev/null @@ -1 +0,0 @@ -1. 在企业设置侧边栏中，单击 **Member privileges（成员权限）**。 ![企业帐户设置侧边栏中的“成员权限”选项卡](/assets/images/help/business-accounts/settings-member-privileges-tab.png) diff --git a/translations/zh-CN/data/reusables/enterprise/ldap_sync_warning.md b/translations/zh-CN/data/reusables/enterprise/ldap_sync_warning.md deleted file mode 100644 index d3e1470f9bce..000000000000 --- a/translations/zh-CN/data/reusables/enterprise/ldap_sync_warning.md +++ /dev/null @@ -1,9 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" %} - -{% warning %} - -If your {% data variables.product.prodname_ghe_server %} instance has [LDAP Sync enabled and the option to synchronize emails enabled](/enterprise/admin/guides/user-management/using-ldap/#enabling-ldap-sync), this API is disabled and will return a `403` response. Users managed in LDAP won't be able to add or delete an email address via the API with these options enabled. 在启用了这些选项的情况下，在 LDAP 中管理的用户将无法通过 API 添加或删除电子邮件地址。 - -{% endwarning %} - -{% endif %} diff --git a/translations/zh-CN/data/reusables/enterprise_enterprise_support/sign-in-to-enterprise-portal.md b/translations/zh-CN/data/reusables/enterprise_enterprise_support/sign-in-to-enterprise-portal.md deleted file mode 100644 index f177a262e5bb..000000000000 --- a/translations/zh-CN/data/reusables/enterprise_enterprise_support/sign-in-to-enterprise-portal.md +++ /dev/null @@ -1 +0,0 @@ -1. 要登录支持门户，请在页面的右上角单击 **Sign in（登录）**。 ![登录 {% data variables.contact.enterprise_portal %}](/assets/images/enterprise/support/sign-in-support-portal.png) diff --git a/translations/zh-CN/data/reusables/enterprise_installation/increasing-cpus-max.md b/translations/zh-CN/data/reusables/enterprise_installation/increasing-cpus-max.md deleted file mode 100644 index e35e4f01e316..000000000000 --- a/translations/zh-CN/data/reusables/enterprise_installation/increasing-cpus-max.md +++ /dev/null @@ -1,3 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" %} - {% data reusables.enterprise_installation.increasing-cpus-req %} 如果您使用的 CPU 超过 16 个，则无需为每个 CPU 添加 6.5 GB 内存，但应监控您的实例以确保其有足够的内存。 -{% endif %} diff --git a/translations/zh-CN/data/reusables/enterprise_installation/resizing-root-disk.md b/translations/zh-CN/data/reusables/enterprise_installation/resizing-root-disk.md deleted file mode 100644 index 7ff95a5dfb1f..000000000000 --- a/translations/zh-CN/data/reusables/enterprise_installation/resizing-root-disk.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**注意：** 可以构建新设备或使用现有设备来调整根磁盘的大小。 更多信息请参阅“[增加存储容量](/enterprise/{{ currentVersion }}/admin/guides/installation/increasing-storage-capacity)”。 - -{% endnote %} diff --git a/translations/zh-CN/data/reusables/enterprise_installation/root-and-data-disk-requirement.md b/translations/zh-CN/data/reusables/enterprise_installation/root-and-data-disk-requirement.md deleted file mode 100644 index 43adc8197342..000000000000 --- a/translations/zh-CN/data/reusables/enterprise_installation/root-and-data-disk-requirement.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_ghe_server %} 需要一个与根磁盘分开的持久性数据磁盘。 更多信息请参阅“[系统概述](/enterprise/admin/guides/installation/system-overview)”。 diff --git a/translations/zh-CN/data/reusables/enterprise_installation/storage-disk-requirements.md b/translations/zh-CN/data/reusables/enterprise_installation/storage-disk-requirements.md deleted file mode 100644 index 1d5d0b2aa63b..000000000000 --- a/translations/zh-CN/data/reusables/enterprise_installation/storage-disk-requirements.md +++ /dev/null @@ -1 +0,0 @@ -对于存储设备，我们建议您使用直接附加的或来自存储区域网络 (SAN) 的高性能 SSD。 diff --git a/translations/zh-CN/data/reusables/enterprise_installation/warning-on-polling.md b/translations/zh-CN/data/reusables/enterprise_installation/warning-on-polling.md deleted file mode 100644 index a51e0236970c..000000000000 --- a/translations/zh-CN/data/reusables/enterprise_installation/warning-on-polling.md +++ /dev/null @@ -1,5 +0,0 @@ -{% warning %} - -**警告：**建议使用 web 挂钩获取用于持续集成 (CI) 或类似系统的仓库更改。 定期自动检查或*投票*将大大降低实例的可扩展性。 更多信息请参阅“[关于 web 挂钩](/enterprise/{{ currentVersion }}/user/articles/about-webhooks/)”。 - -{% endwarning %} diff --git a/translations/zh-CN/data/reusables/gated-features/actions-api-gated.md b/translations/zh-CN/data/reusables/gated-features/actions-api-gated.md deleted file mode 100644 index 7adac77883df..000000000000 --- a/translations/zh-CN/data/reusables/gated-features/actions-api-gated.md +++ /dev/null @@ -1,5 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} - -{% data variables.product.prodname_actions %} 可用于 {% data variables.product.prodname_free_user %}、{% data variables.product.prodname_pro %}、组织的 {% data variables.product.prodname_free_team %}、{% data variables.product.prodname_team %}、{% data variables.product.prodname_ghe_cloud %} 和 {% data variables.product.prodname_ghe_one %}。 {% data variables.product.prodname_actions %} 不适用于使用旧版按仓库计划的帐户所拥有的私有仓库。 {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %} - -{% endif %} diff --git a/translations/zh-CN/data/reusables/gated-features/credential-authorizations-org.md b/translations/zh-CN/data/reusables/gated-features/credential-authorizations-org.md deleted file mode 100644 index e095cbb82136..000000000000 --- a/translations/zh-CN/data/reusables/gated-features/credential-authorizations-org.md +++ /dev/null @@ -1,5 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} - -Listing and deleting credential authorizations is available to organizations with {% data variables.product.prodname_ghe_cloud %}. {% data reusables.gated-features.more-info %} - -{% endif %} diff --git a/translations/zh-CN/data/reusables/gated-features/draft-pull-requests.md b/translations/zh-CN/data/reusables/gated-features/draft-pull-requests.md deleted file mode 100644 index 6d54a6cdd3a6..000000000000 --- a/translations/zh-CN/data/reusables/gated-features/draft-pull-requests.md +++ /dev/null @@ -1,2 +0,0 @@ - -拉取请求草稿可用于具有 {% data variables.product.prodname_free_user %} 和组织的 {% data variables.product.prodname_free_team %}、{% data variables.product.prodname_pro %} 及传统按仓库结算方案的公共仓库，以及具有 {% data variables.product.prodname_team %}{% if currentVersion != "free-pro-team@latest" %}、{% data variables.product.prodname_ghe_server %} 2.17+、{% endif %} 和 {% data variables.product.prodname_ghe_cloud %} 的公共和私有仓库。 {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %} diff --git a/translations/zh-CN/data/reusables/gated-features/policies.md b/translations/zh-CN/data/reusables/gated-features/policies.md deleted file mode 100644 index f826eda65ff1..000000000000 --- a/translations/zh-CN/data/reusables/gated-features/policies.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Note:** {% data variables.product.prodname_policies %} is currently in alpha. This documentation is confidential and made available under NDA. Do not distribute. - -{% endnote %} \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/gated-features/sponsors-beta.md b/translations/zh-CN/data/reusables/gated-features/sponsors-beta.md deleted file mode 100644 index 8836f21641dd..000000000000 --- a/translations/zh-CN/data/reusables/gated-features/sponsors-beta.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**注意：**用于组织的 {% data variables.product.prodname_sponsors %} 目前处于测试阶段，可能会更改。 - -{% endnote %} diff --git a/translations/zh-CN/data/reusables/gated-features/team-sync-gated.md b/translations/zh-CN/data/reusables/gated-features/team-sync-gated.md deleted file mode 100644 index a09ca7594688..000000000000 --- a/translations/zh-CN/data/reusables/gated-features/team-sync-gated.md +++ /dev/null @@ -1,5 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} - -团队同步可用于使用 {% data variables.product.prodname_ghe_cloud %} 的组织。 {% data reusables.gated-features.more-info %} - -{% endif %} diff --git a/translations/zh-CN/data/reusables/github-actions/explains-hello-world-example.md b/translations/zh-CN/data/reusables/github-actions/explains-hello-world-example.md deleted file mode 100644 index 0e3f4f264ed3..000000000000 --- a/translations/zh-CN/data/reusables/github-actions/explains-hello-world-example.md +++ /dev/null @@ -1 +0,0 @@ -仓库的 `OWNER` 为 `octocat` 组织，`REPOSITORY` 名称为 `hello-world`。 diff --git a/translations/zh-CN/data/reusables/github-actions/github-actions-minutes-change.md b/translations/zh-CN/data/reusables/github-actions/github-actions-minutes-change.md deleted file mode 100644 index 231564765711..000000000000 --- a/translations/zh-CN/data/reusables/github-actions/github-actions-minutes-change.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**注：**2020 年 5 月 14 日之后，{% data variables.product.prodname_team %} 将每月自带 3,000 {% data variables.product.prodname_actions %} 分钟。 - -{% endnote %} diff --git a/translations/zh-CN/data/reusables/github-actions/github-actions-usage-limits.md b/translations/zh-CN/data/reusables/github-actions/github-actions-usage-limits.md deleted file mode 100644 index 2ee4dcde704d..000000000000 --- a/translations/zh-CN/data/reusables/github-actions/github-actions-usage-limits.md +++ /dev/null @@ -1,15 +0,0 @@ -{% data variables.product.prodname_actions %} 的使用受到一些不同限制，具体取决于您使用的是 {% data variables.product.prodname_dotcom %} 托管的运行器还是自托管的运行器。 这些限制可能会有变动。 - -- **作业执行时间** - 工作流程中的每个作业最多可以运行 6 个小时。 如果作业达到此限制，该作业将会终止而无法完成。 此限制不适用于自托管运行器。 -- **工作流程运行时间** - 每个工作流程的运行时限为 72 小时。 如果工作流程运行时间达到此限制，其运行将被取消。 此限制也适用于自托管运行器。 -- **作业排队时间** - 自托管运行器的每个作业最多可排队 24 小时。 如果自托管运行器在此限制内没有开始执行作业，则作业将被终止，并且无法完成。 此限制不适用于 {% data variables.product.prodname_dotcom %} 托管的运行器。 -- **API 请求** - 在一个仓库的所有操作中，一个小时内最多可执行 1000 个 API 请求。 如果超出，额外的 API 调用将失败，这可能导致作业失败。 此限制也适用于自托管运行器。 -- **并发作业** - 您的帐户中可并发运行的作业数量，具体取决于您的 GitHub 计划，如下表所示。 如果超出，任何额外的作业都会排队。 对于自托管运行器没有并发限制。 - - | GitHub 计划 | 同时运行的作业总数 | MacOS 作业同时运行的最大数量 | - | --------- | --------- | ----------------- | - | 免费 | 20 | 5 | - | Pro | 40 | 5 | - | 团队 | 60 | 5 | - | 企业 | 180 | 50 | -- **作业矩阵** - {% data reusables.github-actions.matrix-limits %} diff --git a/translations/zh-CN/data/reusables/github-actions/matrix-limits.md b/translations/zh-CN/data/reusables/github-actions/matrix-limits.md deleted file mode 100644 index 4516fbd36512..000000000000 --- a/translations/zh-CN/data/reusables/github-actions/matrix-limits.md +++ /dev/null @@ -1 +0,0 @@ -作业矩阵在每次工作流程运行时最多可生成 256 个作业。 此限制也适用于自托管运行器。 \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-add-new-runner.md b/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-add-new-runner.md deleted file mode 100644 index 2aadab0e5954..000000000000 --- a/translations/zh-CN/data/reusables/github-actions/self-hosted-runner-add-new-runner.md +++ /dev/null @@ -1,20 +0,0 @@ -1. 在“Self-hosted runners（自托管运行器）”下，单击 **Add runner（添加运行器）**。 - -1. 选择自托管运行器机器的操作系统和架构。 ![选择自托管运行器操作系统](/assets/images/help/settings/actions-runner-architecture-os.png) - - -1. 您将看到指示您如何下载运行器应用程序并安装到自托管运行器机器上的说明。 - - 在自托管运行器机器上打开 shell，并按显示的顺序运行每个 shell 命令。 - - {% note %} - - **注意：** 在 Windows上，如果要将自托管运行器应用程序安装为服务，必须打开具有管理员权限的 shell。 我们还建议您使用 `C:\actions-runner` 作为自托管运行器应用程序的目录，以便 Windows 系统帐户可以访问运行器目录。 - - {% endnote %} - - 这些说明将指导您完成以下任务： - - 下载并提取自托管运行器应用程序。 - - 运行 `config` 脚本配置自托管运行器应用程序，并向 {% data variables.product.prodname_actions %} 注册。 `config` 脚本需要目标 URL 和自动生成的时间限制令牌来验证请求。 - - 在 Windows上，`config` 脚本还会询问您是否想将自托管运行器应用程序安装为服务。 对于 Linux 和 macOS，您可以在完成添加运行器后安装服务。 更多信息请参阅“[将自托管运行器应用程序配置为服务](/actions/automating-your-workflow-with-github-actions/configuring-the-self-hosted-runner-application-as-a-service)”。 - - 运行自托管运行器应用程序以将机器连接到 {% data variables.product.prodname_actions %}。 diff --git a/translations/zh-CN/data/reusables/github-component-kit/intro-for-component-kit.md b/translations/zh-CN/data/reusables/github-component-kit/intro-for-component-kit.md deleted file mode 100644 index d58b67db5962..000000000000 --- a/translations/zh-CN/data/reusables/github-component-kit/intro-for-component-kit.md +++ /dev/null @@ -1 +0,0 @@ -The {% data variables.product.prodname_component_kit %} uses {% data variables.product.prodname_github_app %}s and {% data variables.product.prodname_actions %} to power interactive elements within the {% data variables.product.prodname_dotcom %} UI. For example, you can guide repository users with next steps or prompt them to accept license agreements. diff --git a/translations/zh-CN/data/reusables/github-component-kit/opening-explanation-for-component-kit.md b/translations/zh-CN/data/reusables/github-component-kit/opening-explanation-for-component-kit.md deleted file mode 100644 index 9e7d48686861..000000000000 --- a/translations/zh-CN/data/reusables/github-component-kit/opening-explanation-for-component-kit.md +++ /dev/null @@ -1,3 +0,0 @@ -The {% data variables.product.prodname_component_kit %} enables you to configure an interactive component to appear in a pull request or issue. Interactive components enable people to trigger and manage tasks that appear in the {% data variables.product.prodname_dotcom %} UI while a {% data variables.product.prodname_github_app %} or action performs the requested tasks and shares updates. - -Using the "[Create composable comment](/hidden/github-component-kit/composable-comments#create-composable-comment)" endpoint, a {% data variables.product.prodname_github_app %} or action can create a composable comment in an issue or pull request. The composable comment can include an interactive component, such as a custom button. When someone interacts with the comment, the {% data variables.product.prodname_github_app %} will receive the `interactive_component` webhook event. diff --git a/translations/zh-CN/data/reusables/github-insights/no-configuration-file.md b/translations/zh-CN/data/reusables/github-insights/no-configuration-file.md deleted file mode 100644 index b2a5e8dc9955..000000000000 --- a/translations/zh-CN/data/reusables/github-insights/no-configuration-file.md +++ /dev/null @@ -1 +0,0 @@ -如果没有配置文件，请按照首次安装 {% data variables.product.prodname_insights %} 的说明进行操作。 更多信息请参阅“[安装 {% data variables.product.prodname_insights %}](/insights/installing-and-configuring-github-insights/installing-github-insights#installing-github-insights)。” diff --git a/translations/zh-CN/data/reusables/identity-and-permissions/about-connected-teams.md b/translations/zh-CN/data/reusables/identity-and-permissions/about-connected-teams.md deleted file mode 100644 index 654d522dffa8..000000000000 --- a/translations/zh-CN/data/reusables/identity-and-permissions/about-connected-teams.md +++ /dev/null @@ -1,7 +0,0 @@ -{% data variables.product.prodname_dotcom %} 团队连接到 IdP 组后，您的 IdP 管理员必须通过身份提供程序进行团队成员资格更改。 如果团队连接至 IdP 组，则无法在 {% data variables.product.product_name %} 上或使用 API 管理团队成员。 - -要管理任何 {% data variables.product.prodname_dotcom %} 团队的仓库访问权限，包括连接至 IdP 组的团队，必须在 {% data variables.product.product_name %} 上进行变更。 更多信息请参阅“[关于团队](/articles/about-teams)”和“[管理团队对组织仓库的访问](/articles/managing-team-access-to-an-organization-repository)”。 - -默认情况下，您可以选择想要团队成员访问的仓库。 连接的 IdP 组将自动拥有这些仓库的访问权限。 更多信息请参阅“[管理团队的组织仓库访问权限](/articles/managing-team-access-to-an-organization-repository)”。 - -通过 IdP 进行的所有团队成员资格更改都将在 {% data variables.product.product_name %} 审核日志中显示为团队同步自动程序所进行的更改。 您的 IdP 会将团队成员数据发送至 {% data variables.product.prodname_dotcom %}，每小时一次。 \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/marketplace/marketplace_RFP_deadline.md b/translations/zh-CN/data/reusables/marketplace/marketplace_RFP_deadline.md deleted file mode 100644 index bd557da1572d..000000000000 --- a/translations/zh-CN/data/reusables/marketplace/marketplace_RFP_deadline.md +++ /dev/null @@ -1 +0,0 @@ -10年4月 \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/marketplace/unverified-req.md b/translations/zh-CN/data/reusables/marketplace/unverified-req.md deleted file mode 100644 index f7e6e688b552..000000000000 --- a/translations/zh-CN/data/reusables/marketplace/unverified-req.md +++ /dev/null @@ -1 +0,0 @@ -Unverified apps do not need to meet the "[Requirements for listing an app on GitHub Marketplace](/marketplace/getting-started/requirements-for-listing-an-app-on-github-marketplace/)" or go through the "[Security review process](/marketplace/getting-started/security-review-process/)." \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/nested-teams/include-child-team-members.md b/translations/zh-CN/data/reusables/nested-teams/include-child-team-members.md deleted file mode 100644 index 6813efb68e75..000000000000 --- a/translations/zh-CN/data/reusables/nested-teams/include-child-team-members.md +++ /dev/null @@ -1,5 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.20" %} -如果您传递 `hellcat-preview` 媒体类型，团队成员将包含子团队的成员。 -{% else %} -团队成员将包括子团队的成员。 -{% endif %} diff --git a/translations/zh-CN/data/reusables/organizations/org-settings-repository-roles.md b/translations/zh-CN/data/reusables/organizations/org-settings-repository-roles.md deleted file mode 100644 index f5e6c3cb09eb..000000000000 --- a/translations/zh-CN/data/reusables/organizations/org-settings-repository-roles.md +++ /dev/null @@ -1 +0,0 @@ -4. In the left sidebar, click **Repository roles**. ![Repository roles tab in organization settings](/assets/images/help/organizations/org-settings-repository-roles.png) diff --git a/translations/zh-CN/data/reusables/orgs/deprecating_creation_type.md b/translations/zh-CN/data/reusables/orgs/deprecating_creation_type.md deleted file mode 100644 index 9a0c49442825..000000000000 --- a/translations/zh-CN/data/reusables/orgs/deprecating_creation_type.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -{% warning %} - -**Parameter Deprecation Notice:** {% data variables.product.prodname_dotcom %} will replace and discontinue `members_allowed_repository_creation_type` in favor of more granular permissions. The new input parameters are `members_can_create_public_repositories`, `members_can_create_private_repositories` for all organizations and `members_can_create_internal_repositories` for organizations associated with an enterprise account using {% data variables.product.prodname_ghe_cloud %} or {% data variables.product.prodname_ghe_server %} 2.20+. 更多信息请参阅[博客帖子](https://developer.github.com/changes/2019-12-03-internal-visibility-changes)。 - -{% endwarning %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/orgs/internal_repos.md b/translations/zh-CN/data/reusables/orgs/internal_repos.md deleted file mode 100644 index e432538b3738..000000000000 --- a/translations/zh-CN/data/reusables/orgs/internal_repos.md +++ /dev/null @@ -1 +0,0 @@ -If your organization is associated with an enterprise account using {% data variables.product.prodname_ghe_cloud %} or {% data variables.product.prodname_ghe_server %} 2.20+, `visibility` can also be `internal`. \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/package_registry/about-spending-limits.md b/translations/zh-CN/data/reusables/package_registry/about-spending-limits.md deleted file mode 100644 index 156bd181ff42..000000000000 --- a/translations/zh-CN/data/reusables/package_registry/about-spending-limits.md +++ /dev/null @@ -1 +0,0 @@ -默认情况下，您帐户对 {% data variables.product.prodname_registry %} 和 {% data variables.product.prodname_actions %} 综合使用支出限额为 0 美元。 若要允许超支，可以提高支出限额或允许无限支出。 diff --git a/translations/zh-CN/data/reusables/package_registry/accessing-packages.md b/translations/zh-CN/data/reusables/package_registry/accessing-packages.md deleted file mode 100644 index c4ac2d7d5548..000000000000 --- a/translations/zh-CN/data/reusables/package_registry/accessing-packages.md +++ /dev/null @@ -1,4 +0,0 @@ -您可以通过以下 URL 访问您的包（使用您的 {% data variables.product.prodname_dotcom %} 用户或组织名称替换 `OWNER`，使用您的仓库名称替换 `REPOSITORY`）： - ``` - https://github.com/OWNER/REPOSITORY/packages - ``` diff --git a/translations/zh-CN/data/reusables/package_registry/authenticate-to-container-registry.md b/translations/zh-CN/data/reusables/package_registry/authenticate-to-container-registry.md deleted file mode 100644 index 8f890e99b499..000000000000 --- a/translations/zh-CN/data/reusables/package_registry/authenticate-to-container-registry.md +++ /dev/null @@ -1,18 +0,0 @@ -1. Create a new personal access token (PAT) with the appropriate scopes for the tasks you want to accomplish. If your organization requires SSO, you must enable SSO for your new token. - - Select the `read:packages` scope to download container images and read their metadata. - - Select the `write:packages` scope to download and upload container images and read and write their metadata. - - Select the `delete:packages` scope to delete container images. - - 更多信息请参阅“[创建用于命令行的个人访问令牌](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)。” - -2. Save your PAT. We recommend saving your PAT as an environment variable. - ```shell - $ export CR_PAT=YOUR_TOKEN - ``` -3. Using the CLI for your container type, sign in to the {% data variables.product.prodname_github_container_registry %} service at `ghcr.io`. - {% raw %} - ```shell - $ echo $CR_PAT | docker login ghcr.io -u USERNAME --password-stdin - > Login Succeeded - ``` - {% endraw %} diff --git a/translations/zh-CN/data/reusables/permissions/admin-access-org.md b/translations/zh-CN/data/reusables/permissions/admin-access-org.md deleted file mode 100644 index b4f934126644..000000000000 --- a/translations/zh-CN/data/reusables/permissions/admin-access-org.md +++ /dev/null @@ -1 +0,0 @@ -You must authenticate using an access token with the `admin:org` scope to use this endpoint. \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/permissions/admin-access.md b/translations/zh-CN/data/reusables/permissions/admin-access.md deleted file mode 100644 index d35e7e24173c..000000000000 --- a/translations/zh-CN/data/reusables/permissions/admin-access.md +++ /dev/null @@ -1 +0,0 @@ -You must authenticate using an access token with the `repo` scope to use this endpoint. \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/permissions/code-scanning-app-read-permissions.md b/translations/zh-CN/data/reusables/permissions/code-scanning-app-read-permissions.md deleted file mode 100644 index cbee5c312771..000000000000 --- a/translations/zh-CN/data/reusables/permissions/code-scanning-app-read-permissions.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_github_app %}s must have the `security_events` read permission to use this endpoint. \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/permissions/read-access.md b/translations/zh-CN/data/reusables/permissions/read-access.md deleted file mode 100644 index b6226713702c..000000000000 --- a/translations/zh-CN/data/reusables/permissions/read-access.md +++ /dev/null @@ -1 +0,0 @@ -对仓库具有读取权限的任何人都可以使用此端点。 如果是私有仓库，您的必须使用具有 `repo` 作用域的访问令牌。 \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/permissions/security-events-scope.md b/translations/zh-CN/data/reusables/permissions/security-events-scope.md deleted file mode 100644 index a208a8e98059..000000000000 --- a/translations/zh-CN/data/reusables/permissions/security-events-scope.md +++ /dev/null @@ -1 +0,0 @@ -您必须使用具有 `security_events` 作用域的访问令牌才能使用此端点。 \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/permissions/write-access.md b/translations/zh-CN/data/reusables/permissions/write-access.md deleted file mode 100644 index d35e7e24173c..000000000000 --- a/translations/zh-CN/data/reusables/permissions/write-access.md +++ /dev/null @@ -1 +0,0 @@ -You must authenticate using an access token with the `repo` scope to use this endpoint. \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/pre-release-program/ant-man-preview-deployments.md b/translations/zh-CN/data/reusables/pre-release-program/ant-man-preview-deployments.md deleted file mode 100644 index c94ec3ff8af4..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/ant-man-preview-deployments.md +++ /dev/null @@ -1,11 +0,0 @@ -{% note %} - -**Note:** The `transient_environment` and `production_environment` parameters are currently available for developers to preview. During the preview period, the API may change without advance notice. 有关完整详情，请参阅[博客文章](https://developer.github.com/changes/2016-04-06-deployment-and-deployment-status-enhancements)。 - -To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.ant-man-preview+json -``` - -{% endnote %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/ant-man-preview-statuses.md b/translations/zh-CN/data/reusables/pre-release-program/ant-man-preview-statuses.md deleted file mode 100644 index edadedc237e1..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/ant-man-preview-statuses.md +++ /dev/null @@ -1,11 +0,0 @@ -{% note %} - -**Note:** The `inactive` state and the `log_url`, `environment_url`, and `auto_inactive` parameters are currently available for developers to preview. 有关完整详情，请参阅[博客文章](https://developer.github.com/changes/2016-04-06-deployment-and-deployment-status-enhancements)。 - -To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.ant-man-preview+json -``` - -{% endnote %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/antiope-preview.md b/translations/zh-CN/data/reusables/pre-release-program/antiope-preview.md deleted file mode 100644 index 4c0be72ee067..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/antiope-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The Checks API is currently available for developers to preview. During the preview period, the API may change without advance notice. 有关完整详情，请参阅[博客文章](https://developer.github.com/changes/2018-05-07-new-checks-api-public-beta/)。 To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.antiope-preview+json -``` - -{% endnote %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/baptiste-keys-preview.md b/translations/zh-CN/data/reusables/pre-release-program/baptiste-keys-preview.md deleted file mode 100644 index 1a309066ba06..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/baptiste-keys-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Note:** The `is_template` and `template_repository` keys are currently available for developer to preview. See [Create a repository using a template](/v3/repos/#create-a-repository-using-a-template) to learn how to create template repositories. To access these new response keys during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.baptiste-preview+json -``` - -{% endnote %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/baptiste-preview.md b/translations/zh-CN/data/reusables/pre-release-program/baptiste-preview.md deleted file mode 100644 index 850b3f271bb4..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/baptiste-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Note:** Creating and using repository templates is currently available for developers to preview. To access this new endpoint during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.baptiste-preview+json -``` - -{% endnote %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/batman-preview.md b/translations/zh-CN/data/reusables/pre-release-program/batman-preview.md deleted file mode 100644 index 079a5b57c932..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/batman-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -{% note %} - -**Note:** Using the {% data variables.product.prodname_component_kit %} API is currently available for developers to preview. To access these endpoints during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.batman-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/checks-public-beta.md b/translations/zh-CN/data/reusables/pre-release-program/checks-public-beta.md deleted file mode 100644 index 9220bede6270..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/checks-public-beta.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**Note:** The Checks API is currently in public beta and only available for use with GitHub Apps. - -{% endnote %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/cloak-preview.md b/translations/zh-CN/data/reusables/pre-release-program/cloak-preview.md deleted file mode 100644 index 53e95b0793c8..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/cloak-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The Commit Search API is currently available for developers to preview. During the preview period, the APIs may change without advance notice. 有关完整详情，请参阅[博客文章](https://developer.github.com/changes/2017-01-05-commit-search-api/)。 - -To access the API you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.cloak-preview -``` -{% endnote %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/code-scanning-beta.md b/translations/zh-CN/data/reusables/pre-release-program/code-scanning-beta.md deleted file mode 100644 index f9be785c151b..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/code-scanning-beta.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** {% data variables.product.prodname_code_scanning_capc %} for open source repositories and private repositories is currently in beta and subject to change. To sign up, see [Advanced Security beta](https://github.com/features/security/advanced-security/signup). - -{% endnote %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/comfort-fade-preview.md b/translations/zh-CN/data/reusables/pre-release-program/comfort-fade-preview.md deleted file mode 100644 index 17e2464a7d19..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/comfort-fade-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** Multi-line comments in a pull request diff is currently available for developers to preview. To access the new response fields during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.comfort-fade-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/doctor-strange-preview.md b/translations/zh-CN/data/reusables/pre-release-program/doctor-strange-preview.md deleted file mode 100644 index 488fa5418a94..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/doctor-strange-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion == "enterprise-server@2.20" %} -{% note %} - -**Note:** New endpoints using OAuth tokens as input parameters instead of path parameters are available for developers to preview in the [OAuth Applications API](/v3/apps/oauth_applications/). To access these endpoints during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.doctor-strange-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/dorian-preview.md b/translations/zh-CN/data/reusables/pre-release-program/dorian-preview.md deleted file mode 100644 index d4141e00a5ab..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/dorian-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Note:** Enabling and disabling dependency alerts for a repository using the REST API is currently available for developers to preview. To access these new endpoints during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.dorian-preview+json -``` - -{% endnote %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/drax-preview.md b/translations/zh-CN/data/reusables/pre-release-program/drax-preview.md deleted file mode 100644 index 720c942e5f60..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/drax-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.13" %} -{% note %} - -**Note:** The [Licenses API](https://developer.github.com/changes/2015-03-09-licenses-api/) is currently available for developers to preview. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.drax-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/echo-preview.md b/translations/zh-CN/data/reusables/pre-release-program/echo-preview.md deleted file mode 100644 index d6897f7f1d82..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/echo-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -{% note %} - -**Note:** The team discussions API is currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2018-02-07-team-discussions-api) for full details. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.echo-preview+json -``` -{% endnote %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/flash-preview.md b/translations/zh-CN/data/reusables/pre-release-program/flash-preview.md deleted file mode 100644 index b19c0fb7321a..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/flash-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% note %} - -**Note:** New features in the Deployments API on {% data variables.product.product_name %} are currently available during a public beta. 有关完整详情，请参阅[博客文章](https://developer.github.com/changes/2018-10-16-deployments-environments-states-and-auto-inactive-updates/)。 - -To access the new `environment` parameter, the two new values for the `state` parameter (`in_progress` and `queued`), and use `auto_inactive` on production deployments during the public beta period, you must provide the following custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.flash-preview+json -``` - -{% endnote %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/gambit-preview.md b/translations/zh-CN/data/reusables/pre-release-program/gambit-preview.md deleted file mode 100644 index ae67b941174b..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/gambit-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.21" %} -{% note %} - -**Note:** Uninstalling {% data variables.product.prodname_github_app %}s and revoking an app's installation token are currently available for developers to preview. To access the new endpoint during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.gambit-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/giant-sentry-fist-pre-release.md b/translations/zh-CN/data/reusables/pre-release-program/giant-sentry-fist-pre-release.md deleted file mode 100644 index 6ea06379025f..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/giant-sentry-fist-pre-release.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "2.8" %} -{% note %} - -**Note:** {% data variables.giant-sentry-fist.product_name_long %} on {% data variables.product.product_name %} is currently available for developers to preview. To access the API, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.giant-sentry-fist-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/github-actions-public-beta.md b/translations/zh-CN/data/reusables/pre-release-program/github-actions-public-beta.md deleted file mode 100644 index ff0a4b80f712..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/github-actions-public-beta.md +++ /dev/null @@ -1,11 +0,0 @@ -{% warning %} - -**New release:** {% data variables.product.prodname_actions %} is now available in a new limited public beta. This version offers a new workflow configuration and built-in continuous integration and continuous deployment capabilities. We strongly recommend you avoid using it for high-value workflows and content during this public beta period. To request to join the limited public beta, see the [GitHub Actions page](https://github.com/features/actions). For more information, see "[About GitHub Actions](/articles/about-github-actions)". - -GitHub Support will only provide support for the YAML syntax and no longer provides support for the HCL syntax. - -If you participated in the limited public beta and created workflows with the HCL syntax {% data variables.product.prodname_actions %}, you will need to upgrade to the new limited public beta that uses YAML syntax. When your repository is eligible to upgrade, you'll see an invitation in your repository. You must accept the invitation before you can use the new limited public beta. - -Once you've upgraded, any workflows that you created with the HCL syntax will need to be updated to the new YAML syntax. To automatically convert your workflows, see "[Migrating {% data variables.product.prodname_actions %} from HCL syntax to YAML syntax](/articles/migrating-github-actions-from-hcl-syntax-to-yaml-syntax)". - -{% endwarning %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/github-components-public-beta.md b/translations/zh-CN/data/reusables/pre-release-program/github-components-public-beta.md deleted file mode 100644 index 2c242acbc08b..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/github-components-public-beta.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.18" %} -{% note %} - -**Note:** The {% data variables.product.prodname_component_kit %} API is currently in private beta and subject to change. - -{% endnote %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/groot-preview.md b/translations/zh-CN/data/reusables/pre-release-program/groot-preview.md deleted file mode 100644 index 944243de7c52..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/groot-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Note:** Listing branches or pull requests for a commit in the Commits API is currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2019-04-11-pulls-branches-for-commit/) for more details. To access the new endpoints during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.groot-preview+json -``` - -{% endnote %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/hagar-preview.md b/translations/zh-CN/data/reusables/pre-release-program/hagar-preview.md deleted file mode 100644 index e1cf318f3cc3..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/hagar-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -{% note %} - -**Note:** You can now retrieve someone's hovercard information in different contexts using the Hovercard API. This feature is currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2018-03-21-hovercard-api-preview) for full details. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.hagar-preview+json -``` -{% endnote %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/hellcat-preview.md b/translations/zh-CN/data/reusables/pre-release-program/hellcat-preview.md deleted file mode 100644 index b2268faa5418..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/hellcat-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.20" %} -{% note %} - -**Note:** The Nested Teams API is currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2017-08-30-preview-nested-teams) for full details. To access the API, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.hellcat-preview+json -``` -{% endnote %} - -{% endif %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/inertia-preview.md b/translations/zh-CN/data/reusables/pre-release-program/inertia-preview.md deleted file mode 100644 index 2953c8de442f..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/inertia-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The Projects API is currently available for developers to preview. During the preview period, the API may change without advance notice. 有关完整详情，请参阅[博客文章](https://developer.github.com/changes/2016-10-27-changes-to-projects-api)。 To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.inertia-preview+json -``` - -{% endnote %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/london-preview.md b/translations/zh-CN/data/reusables/pre-release-program/london-preview.md deleted file mode 100644 index 4fa608045abb..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/london-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** Enabling or disabling automated security fixes is currently available for developers to preview. To access this new endpoint during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.london-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/luke-cage-preview.md b/translations/zh-CN/data/reusables/pre-release-program/luke-cage-preview.md deleted file mode 100644 index a4a7cfe32bbb..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/luke-cage-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The Protected Branches API now has a setting for requiring a specified number of approving pull request reviews before merging. This feature is currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2018-03-16-protected-branches-required-approving-reviews) for full details. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.luke-cage-preview+json -``` - -{% endnote %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/lydian-preview.md b/translations/zh-CN/data/reusables/pre-release-program/lydian-preview.md deleted file mode 100644 index fa5a34527bea..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/lydian-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Note:** Updating the pull request branch with latest upstream changes is currently available for developers to preview. To access this new endpoint during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.lydian-preview+json -``` - -{% endnote %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/mercy-pre-release-replace.md b/translations/zh-CN/data/reusables/pre-release-program/mercy-pre-release-replace.md deleted file mode 100644 index c49f66c4dba1..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/mercy-pre-release-replace.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** Repository topics on {% data variables.product.product_name %} are currently available for developers to preview. To use this endpoint, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.mercy-preview+json -``` - -{% endnote %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/mercy-pre-release.md b/translations/zh-CN/data/reusables/pre-release-program/mercy-pre-release.md deleted file mode 100644 index fa26dc8969ed..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/mercy-pre-release.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** {% data variables.mercy.product_name_long %} on {% data variables.product.product_name %} is currently available for developers to preview. To view the `topics` property in calls that return repository results, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.mercy-preview+json -``` - -{% endnote %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/mister-fantastic-pre-release.md b/translations/zh-CN/data/reusables/pre-release-program/mister-fantastic-pre-release.md deleted file mode 100644 index 4918b1477ee0..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/mister-fantastic-pre-release.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.19" %} -{% note %} - -**Note:** {% data variables.mister-fantastic.product_name_long %} contains two additional fields in responses, which developers can preview: `html_url` and `source`. To see these two new fields, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.mister-fantastic-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/mockingbird-preview.md b/translations/zh-CN/data/reusables/pre-release-program/mockingbird-preview.md deleted file mode 100644 index 7d0dd736932d..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/mockingbird-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The API to get issue timeline events is currently available for developers to preview. During the preview period, the APIs may change without advance notice. 有关完整详情，请参阅[博客文章](https://developer.github.com/changes/2016-05-23-timeline-preview-api/)。 To access the API you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.mockingbird-preview -``` - -{% endnote %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/multi-line-comments-public-beta.md b/translations/zh-CN/data/reusables/pre-release-program/multi-line-comments-public-beta.md deleted file mode 100644 index 5aeea167477b..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/multi-line-comments-public-beta.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** Multi-line comments on pull requests are currently in public beta and subject to change. - -{% endnote %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/nebula-preview.md b/translations/zh-CN/data/reusables/pre-release-program/nebula-preview.md deleted file mode 100644 index a3f822e627dd..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/nebula-preview.md +++ /dev/null @@ -1,14 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} - -{% note %} - -**Note:** You can set the visibility of a repository using the new `visibility` parameter in the [Repositories API](/v3/repos/), and get a repository's visibility with a new response key. 更多信息请参阅[博客帖子](https://developer.github.com/changes/2019-12-03-internal-visibility-changes/)。 - -To access repository visibility during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.nebula-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/nightshade-preview.md b/translations/zh-CN/data/reusables/pre-release-program/nightshade-preview.md deleted file mode 100644 index 22172eba6443..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/nightshade-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.20" %} -{% note %} - -**Note:** The [Repository Transfer API](https://developer.github.com/changes/2017-11-09-repository-transfer-api-preview) is currently available for developers to preview. To access the API, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.nightshade-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/org-self-hosted-runner-beta.md b/translations/zh-CN/data/reusables/pre-release-program/org-self-hosted-runner-beta.md deleted file mode 100644 index ad73731c18b6..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/org-self-hosted-runner-beta.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% warning %} - -**警告：** 组织的自托管运行器 API 当前处于公开测试阶段，可能会发生变化。 - -{% endwarning %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/performed-by-integration-deployment.md b/translations/zh-CN/data/reusables/pre-release-program/performed-by-integration-deployment.md deleted file mode 100644 index 6a888df13e51..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/performed-by-integration-deployment.md +++ /dev/null @@ -1,13 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** If a deployment is created via a {% data variables.product.prodname_github_app %}, the response will include the `performed_via_github_app` object with information about the {% data variables.product.prodname_github_app %}. For more information, see the [related blog post](https://developer.github.com/changes/2016-09-14-Integrations-Early-Access). - -To receive the `performed_via_github_app` object in the response, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.machine-man-preview -``` - -{% endnote %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/performed-by-integration-issue-comment.md b/translations/zh-CN/data/reusables/pre-release-program/performed-by-integration-issue-comment.md deleted file mode 100644 index ad67d849dd85..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/performed-by-integration-issue-comment.md +++ /dev/null @@ -1,13 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** If an issue comment is created via a {% data variables.product.prodname_github_app %}, the response will include the `performed_via_github_app` object with information about the {% data variables.product.prodname_github_app %}. For more information, see the [related blog post](https://developer.github.com/changes/2016-09-14-Integrations-Early-Access). - -To receive the `performed_via_github_app` object in the response, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.machine-man-preview -``` - -{% endnote %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/performed-by-integration-issue-event.md b/translations/zh-CN/data/reusables/pre-release-program/performed-by-integration-issue-event.md deleted file mode 100644 index 54e004859064..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/performed-by-integration-issue-event.md +++ /dev/null @@ -1,13 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** If an issue event is created via a {% data variables.product.prodname_github_app %}, the response will include the `performed_via_github_app` object with information about the {% data variables.product.prodname_github_app %}. For more information, see the [related blog post](https://developer.github.com/changes/2016-09-14-Integrations-Early-Access). - -To receive the `performed_via_github_app` object in the response, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.machine-man-preview -``` - -{% endnote %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/performed-by-integration-issue.md b/translations/zh-CN/data/reusables/pre-release-program/performed-by-integration-issue.md deleted file mode 100644 index ee0240792f4a..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/performed-by-integration-issue.md +++ /dev/null @@ -1,13 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** If an issue is opened via a {% data variables.product.prodname_github_app %}, the response will include the `performed_via_github_app` object with information about the {% data variables.product.prodname_github_app %}. For more information, see the [related blog post](https://developer.github.com/changes/2016-09-14-Integrations-Early-Access). - -To receive the `performed_via_github_app` object in the response, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.machine-man-preview -``` - -{% endnote %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/scarlet-witch-key-preview.md b/translations/zh-CN/data/reusables/pre-release-program/scarlet-witch-key-preview.md deleted file mode 100644 index a82019b82319..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/scarlet-witch-key-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** Developers can preview a new `code_of_conduct` key in responses. For more information, see [Codes of Conduct API](/v3/codes_of_conduct/). - -To access this new response key during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.scarlet-witch-preview+json -``` -{% endnote %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/scarlet-witch-preview.md b/translations/zh-CN/data/reusables/pre-release-program/scarlet-witch-preview.md deleted file mode 100644 index 860b30d517dc..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/scarlet-witch-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The Codes of Conduct API is currently available for developers to preview. - -To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.scarlet-witch-preview+json -``` -{% endnote %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/shadow-cat-preview.md b/translations/zh-CN/data/reusables/pre-release-program/shadow-cat-preview.md deleted file mode 100644 index 3d95ab9ccae5..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/shadow-cat-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.21" %} -{% note %} - -**Note:** The Draft Pull Request API is currently available for developers to preview. You can use this API to create a draft pull request or see whether a pull request is in draft state. See the [blog post](https://developer.github.com/changes/2019-02-14-draft-pull-requests) preview for more details. To access the new `draft` parameter during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.shadow-cat-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/sombra-preview.md b/translations/zh-CN/data/reusables/pre-release-program/sombra-preview.md deleted file mode 100644 index 9298dfa844f5..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/sombra-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** The Interactions API is currently in public preview. See the [blog post](https://developer.github.com/changes/2018-12-18-interactions-preview) preview for more details. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.sombra-preview -``` - -{% endnote %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/squirrel-girl-preview.md b/translations/zh-CN/data/reusables/pre-release-program/squirrel-girl-preview.md deleted file mode 100644 index 52bd9558fc3b..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/squirrel-girl-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Note:** APIs for managing reactions are currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - - ``` - application/vnd.github.squirrel-girl-preview+json - ``` - {% endnote %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/squirrel-girl-response-preview.md b/translations/zh-CN/data/reusables/pre-release-program/squirrel-girl-response-preview.md deleted file mode 100644 index 18d162292a2d..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/squirrel-girl-response-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The [reactions API](/v3/reactions/) is available for developers to preview. The `url` can be used to construct the API location for [listing and creating](/v3/reactions) reactions. See the [blog post](https://developer.github.com/changes/2016-05-12-reactions-api-preview) for full details. To receive the `reactions` object in the response for this endpoint you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.squirrel-girl-preview -``` - -{% endnote %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/superpro-preview.md b/translations/zh-CN/data/reusables/pre-release-program/superpro-preview.md deleted file mode 100644 index f0878ed234c6..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/superpro-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% note %} - -**Note:** The [Global Webhooks API](/rest/reference/enterprise-admin#global-webhooks) is currently available for developers to preview. To access the API during the preview period, you must provide a custom [media type](/rest/overview/media-types) in the `Accept` header: - -``` -application/vnd.github.superpro-preview+json -``` - -{% endnote %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/surtur-preview.md b/translations/zh-CN/data/reusables/pre-release-program/surtur-preview.md deleted file mode 100644 index 9cfdfe8ad8dc..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/surtur-preview.md +++ /dev/null @@ -1,21 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -{% note %} - -**Note:** New repository creation permissions are available to preview. You can now use `members_can_create_public_repositories`, `members_can_create_private_repositories`, and `members_can_create_internal_repositories`. You can only allow members to create internal repositories if your organization is associated with an enterprise account using {% data variables.product.prodname_ghe_cloud %} or {% data variables.product.prodname_ghe_server %} 2.20+. These parameters provide more granular permissions to configure the type of repositories organization members can create. - -To access these new parameters during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.surtur-preview+json -``` -{% endnote %} -{% else %} -{% note %} - -**Note:** New repository creation permissions are available to preview. You can now set the `members_allowed_repository_creation_type` parameter to configure whether organization members can create repositories and the type of repositories they can create. - -To access this new parameter during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.surtur-preview+json -``` -{% endnote %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/switcheroo-preview.md b/translations/zh-CN/data/reusables/pre-release-program/switcheroo-preview.md deleted file mode 100644 index fbbbe3817bd9..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/switcheroo-preview.md +++ /dev/null @@ -1,8 +0,0 @@ -{% note %} - -**Note:** Enabling and disabling Pages in the Pages API is currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2019-03-14-enabling-disabling-pages/) preview for more details. To access the new endpoints during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.switcheroo-preview+json -``` - -{% endnote %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/symmetra-preview.md b/translations/zh-CN/data/reusables/pre-release-program/symmetra-preview.md deleted file mode 100644 index c578f33898be..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/symmetra-preview.md +++ /dev/null @@ -1,9 +0,0 @@ -{% if currentVersion != ‘dotcom’ and currentVersion ver_lt "enterprise-server@2.20" %} -{% note %} - -**Note:** You can add or edit descriptions in labels. See the [blog post](https://developer.github.com/changes/2018-02-22-label-description-search-preview) for full details. To access this feature during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.symmetra-preview+json -``` -{% endnote %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/thor-pre-release.md b/translations/zh-CN/data/reusables/pre-release-program/thor-pre-release.md deleted file mode 100644 index e034ce622e48..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/thor-pre-release.md +++ /dev/null @@ -1,13 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" and currentVersion ver_lt "enterprise-server@2.13" %} -{% note %} - -**Note:** Team-based review requests in the Review Requests API on {% data variables.product.product_name %} are currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2017-07-26-team-review-request-thor-preview) for full details. - -To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.thor-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/usage-api-beta.md b/translations/zh-CN/data/reusables/pre-release-program/usage-api-beta.md deleted file mode 100644 index 0fb7989fc11c..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/usage-api-beta.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% warning %} - -**Warning:** This {% data variables.product.prodname_actions %} usage endpoint is currently in public beta and subject to change. For more information, see "[GitHub Actions API workflow usage](https://developer.github.com/changes/2020-05-15-actions-api-workflow-usage)." - -{% endwarning %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/wyandotte-preview.md b/translations/zh-CN/data/reusables/pre-release-program/wyandotte-preview.md deleted file mode 100644 index 2d5c90f982c3..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/wyandotte-preview.md +++ /dev/null @@ -1,10 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - -**Note:** To access the Migrations API, you must provide a custom [media type](/v3/media) in the `Accept` header: -``` -application/vnd.github.wyandotte-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/x-ray-preview.md b/translations/zh-CN/data/reusables/pre-release-program/x-ray-preview.md deleted file mode 100644 index c09b481483ca..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/x-ray-preview.md +++ /dev/null @@ -1,13 +0,0 @@ -{% if currentVersion != "free-pro-team@latest" %} -{% note %} - -**Note:** When a GitHub Enterprise instance is in private mode, site and repository administrators can enable anonymous Git access for a public repository. This feature is currently available for developers to preview. See the [blog post](https://blog.github.com/2018-07-12-introducing-enterprise-2-14/) for full details. - -To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.x-ray-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/pre-release-program/zzzax-preview.md b/translations/zh-CN/data/reusables/pre-release-program/zzzax-preview.md deleted file mode 100644 index 1614b2e1532d..000000000000 --- a/translations/zh-CN/data/reusables/pre-release-program/zzzax-preview.md +++ /dev/null @@ -1,11 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.12" %} -{% note %} - -**Note:** Protected Branches API can now manage a setting for requiring signed commits. This feature is currently available for developers to preview. See the [blog post](https://developer.github.com/changes/2018-02-22-protected-branches-required-signatures) for full details. To access the API during the preview period, you must provide a custom [media type](/v3/media) in the `Accept` header: - -``` -application/vnd.github.zzzax-preview+json -``` - -{% endnote %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/pulls/diff_location.md b/translations/zh-CN/data/reusables/pulls/diff_location.md deleted file mode 100644 index 18c8c130d5dc..000000000000 --- a/translations/zh-CN/data/reusables/pulls/diff_location.md +++ /dev/null @@ -1,7 +0,0 @@ -{% note %} - -**Note:** To comment on a specific line in a file, you need to first determine the _position_ of that line in the diff. The GitHub REST API offers the `application/vnd.github.v3.diff` [media type](/v3/media/#commits-commit-comparison-and-pull-requests). 要查看拉取请求差异，请将此媒体类型添加到[单一拉取请求](/v3/pulls/#get-a-pull-request)端点的 `Accept` 标头。 - -`position` 值等于要添加注释的文件中从第一个 "@@" 块标头向下的行数。 "@@" 行正下方的行是位置 1，下一行是位置 2，依此类推。 差异中的位置继续通过空白行和附加块继续增加，直到新文件开始。 - -{% endnote %} diff --git a/translations/zh-CN/data/reusables/pulls/multiline_comments_summary_for_responses.md b/translations/zh-CN/data/reusables/pulls/multiline_comments_summary_for_responses.md deleted file mode 100644 index bafcecefc018..000000000000 --- a/translations/zh-CN/data/reusables/pulls/multiline_comments_summary_for_responses.md +++ /dev/null @@ -1,21 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} - -##### 多行评论摘要 - -{% note %} - -**注：**开发人员可以预览新的参数和响应字段。 在预览期间，这些响应字段可能会更改，恕不提前通知。 有关完整详情，请参阅[博客文章](https://developer.github.com/changes/2019-10-03-multi-line-comments)。 - -{% endnote %} - -使用 `comfort-fade` 预览标头和 `line` 参数在响应中显示多行评论支持的字段。 - -如果使用 `comfort-fade` 预览标头，您的响应将显示： -- 对于多行评论，显示 `start_line`、`original_start_line`、`start_side`、`line`、`original_line` 和 `side` 的值。 -- 对于单行评论，显示 `line`、`original_line` 和 `side` 的值，以及 `start_line`、`original_start_line` 和 `start_side` 的 `null` 值。 - -如果不使用 `comfort-fade` 预览标头，多行和单行评论将在具有单个 `position` 属性的响应中以相同的方式显示。 您的响应将会显示： -- 对于多行评论，显示 `position` 属性的评论范围的最后一行。 -- For single-line comments, the diff-positioned way of referencing comments for the `position` attribute. 更多信息请参阅[输入参数](/v3/pulls/comments/#parameters-2)表中的 `position`。 - -{% endif %} diff --git a/translations/zh-CN/data/reusables/pulls/pull_request_access.md b/translations/zh-CN/data/reusables/pulls/pull_request_access.md deleted file mode 100644 index 7938d686c5bd..000000000000 --- a/translations/zh-CN/data/reusables/pulls/pull_request_access.md +++ /dev/null @@ -1,5 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} - -要在公共仓库中打开或更新拉取请求，您必须对头部或源分支具有写入访问权限。 对于组织拥有的仓库，您必须是拥有该仓库的组织的成员才能打开或更新拉取请求。 - -{% endif %} diff --git a/translations/zh-CN/data/reusables/pulls/pull_request_mergeability.md b/translations/zh-CN/data/reusables/pulls/pull_request_mergeability.md deleted file mode 100644 index 1ce16ace0c7c..000000000000 --- a/translations/zh-CN/data/reusables/pulls/pull_request_mergeability.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**注：**您需要明确[请求拉取请求](/v3/pulls/#get-a-pull-request)以触发测试合并提交，检查拉取请求的可合并性。 更多信息请参阅“[检查拉取请求的可合并性](/v3/git/#checking-mergeability-of-pull-requests)”。 - -{% endnote %} diff --git a/translations/zh-CN/data/reusables/pulls/pullrequests_as_issues.md b/translations/zh-CN/data/reusables/pulls/pullrequests_as_issues.md deleted file mode 100644 index ccc51e284311..000000000000 --- a/translations/zh-CN/data/reusables/pulls/pullrequests_as_issues.md +++ /dev/null @@ -1,7 +0,0 @@ -{% note %} - -**Note**: GitHub's REST API considers every pull request an issue, but not every issue is a pull request. 因此，“议题”端点可能返回响应中的议题和拉取请求。 您可以通过 `pull_request` 键识别拉取请求。 - -请注意，从“议题”端点返回的拉取请求的 `id` 将是 _issue id_。 要查找拉取请求 id，请使用“[列出拉取请求](/v3/pulls/#list-pull-requests)”端点。 - -{% endnote %} diff --git a/translations/zh-CN/data/reusables/reminders/install-slack.md b/translations/zh-CN/data/reusables/reminders/install-slack.md deleted file mode 100644 index 0b6f1c886cc6..000000000000 --- a/translations/zh-CN/data/reusables/reminders/install-slack.md +++ /dev/null @@ -1 +0,0 @@ -如果要在所有仓库安装 Slack，请选择 **All repositories（所有仓库）**。 如果只想在选择的仓库中安装 Slack，则选择 **Only select repositories（仅选定仓库）**。 然后，查看您允许 Slack 访问的权限列表并单击 **Install（安装）**。 ![安装 Slack 按钮](/assets/images/help/settings/scheduled-reminders-install-slack.png) diff --git a/translations/zh-CN/data/reusables/reminders/scheduled-reminders-beta.md b/translations/zh-CN/data/reusables/reminders/scheduled-reminders-beta.md deleted file mode 100644 index 700ce5808414..000000000000 --- a/translations/zh-CN/data/reusables/reminders/scheduled-reminders-beta.md +++ /dev/null @@ -1 +0,0 @@ -拉取请求的预定提醒正在测试中，可能会有更改。 要申请参加预定提醒的下一个测试阶段，请在 [GitHub 预定提醒](https://github.com/features/reminders/signup)加入等待列表。 diff --git a/translations/zh-CN/data/reusables/repositories/actions-new-workflow.md b/translations/zh-CN/data/reusables/repositories/actions-new-workflow.md deleted file mode 100644 index 0489b25a781b..000000000000 --- a/translations/zh-CN/data/reusables/repositories/actions-new-workflow.md +++ /dev/null @@ -1,2 +0,0 @@ -1. 在左上角单击 **New workflow（新建工作流程）**。 ![创建新工作流程](/assets/images/help/repository/actions-new-workflow.png) - \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/repositories/actions-set-up-workflow-template.md b/translations/zh-CN/data/reusables/repositories/actions-set-up-workflow-template.md deleted file mode 100644 index e83050d31324..000000000000 --- a/translations/zh-CN/data/reusables/repositories/actions-set-up-workflow-template.md +++ /dev/null @@ -1 +0,0 @@ -1. 在您想要使用的模板名称下，单击 **Set up this workflow（设置此工作流程）**。 ![Node.js 模板建议](/assets/images/help/repository/actions-recommended-workflow-template.png) diff --git a/translations/zh-CN/data/reusables/repositories/opt-out-automated-security-updates.md b/translations/zh-CN/data/reusables/repositories/opt-out-automated-security-updates.md deleted file mode 100644 index 3256fd9eeb0a..000000000000 --- a/translations/zh-CN/data/reusables/repositories/opt-out-automated-security-updates.md +++ /dev/null @@ -1,2 +0,0 @@ -1. 在“Automated security updates（自动安全更新）”下，选择或取消选择 **Opt out of automated security updates（退出自动安全更新）**。 ![选择退出自动安全更新复选框](/assets/images/help/repository/opt-out-automated-security-updates.png) -2. 单击 **Save（保存）**。 diff --git a/translations/zh-CN/data/reusables/repositories/opt-out-dependabot-security-updates.md b/translations/zh-CN/data/reusables/repositories/opt-out-dependabot-security-updates.md deleted file mode 100644 index 3a68c3c20731..000000000000 --- a/translations/zh-CN/data/reusables/repositories/opt-out-dependabot-security-updates.md +++ /dev/null @@ -1 +0,0 @@ -1. To the right of "{% data variables.product.prodname_dependabot_short %} security updates", click **Disable all** or **Enable all**. !["Disable all" or "Enable all" button for {% data variables.product.prodname_dependabot_short %} security updates](/assets/images/help/repository/opt-out-dependabot-security-updates.png) diff --git a/translations/zh-CN/data/reusables/repositories/settings-security-and-analysis-tab-beta.md b/translations/zh-CN/data/reusables/repositories/settings-security-and-analysis-tab-beta.md deleted file mode 100644 index a87278175cef..000000000000 --- a/translations/zh-CN/data/reusables/repositories/settings-security-and-analysis-tab-beta.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**注**：管理安全和分析设置的新功能处于测试阶段，可能会有变动。 - -{% endnote %} diff --git a/translations/zh-CN/data/reusables/repositories/sidebar-integrations-and-services.md b/translations/zh-CN/data/reusables/repositories/sidebar-integrations-and-services.md deleted file mode 100644 index b76bd9f19176..000000000000 --- a/translations/zh-CN/data/reusables/repositories/sidebar-integrations-and-services.md +++ /dev/null @@ -1 +0,0 @@ -1. 单击 **Integrations & Services（集成和服务）**。 ![集成和服务选择](/assets/images/help/settings/integrations_and_services_menu.png) diff --git a/translations/zh-CN/data/reusables/repositories/troubleshooting-dependency-graph.md b/translations/zh-CN/data/reusables/repositories/troubleshooting-dependency-graph.md deleted file mode 100644 index 6607b47d2b06..000000000000 --- a/translations/zh-CN/data/reusables/repositories/troubleshooting-dependency-graph.md +++ /dev/null @@ -1 +0,0 @@ -如果您的项目有依赖关系，但在图表中未检测到依赖关系，则可能是包含依赖关系的文件有问题。 检查项目的文件以确保其格式对文件类型是正确的。 diff --git a/translations/zh-CN/data/reusables/repositories/you-can-enable-or-disable-security-features.md b/translations/zh-CN/data/reusables/repositories/you-can-enable-or-disable-security-features.md deleted file mode 100644 index 7380459e1916..000000000000 --- a/translations/zh-CN/data/reusables/repositories/you-can-enable-or-disable-security-features.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**注**：代码扫描和密码扫描测试版新增了管理安全和分析设置的功能。 如果您正在参与测试，请跳过以下步骤，并参阅“[管理仓库的安全和分析设置](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository)”。 - -{% endnote %} diff --git a/translations/zh-CN/data/reusables/repositories/you-can-manage-access-to-security-alerts.md b/translations/zh-CN/data/reusables/repositories/you-can-manage-access-to-security-alerts.md deleted file mode 100644 index 60ccfc3c01fb..000000000000 --- a/translations/zh-CN/data/reusables/repositories/you-can-manage-access-to-security-alerts.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**注**：代码扫描和密码扫描测试版新增了管理具有安全警报访问权限的人员及团队的功能。 如果您正在参与测试，请跳过以下步骤，并参阅“[管理仓库的安全和分析设置](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository#granting-access-to-github-dependabot-alerts)”。 - -{% endnote %} diff --git a/translations/zh-CN/data/reusables/saml/scim-unavailable-for-enterprise-accounts.md b/translations/zh-CN/data/reusables/saml/scim-unavailable-for-enterprise-accounts.md deleted file mode 100644 index f5af0d8ed5cb..000000000000 --- a/translations/zh-CN/data/reusables/saml/scim-unavailable-for-enterprise-accounts.md +++ /dev/null @@ -1,5 +0,0 @@ -{% note %} - -**注**：SCIM 支持目前不适用于 {% data variables.product.prodname_dotcom %} 上的企业帐户。 - -{% endnote %} diff --git a/translations/zh-CN/data/reusables/scim/complete_user_example.md b/translations/zh-CN/data/reusables/scim/complete_user_example.md deleted file mode 100644 index e444e167ecc8..000000000000 --- a/translations/zh-CN/data/reusables/scim/complete_user_example.md +++ /dev/null @@ -1,7 +0,0 @@ -<%= json \ "schemas":["urn:ietf:params:scim:schemas:core:2.0:User"], "userName":"mona.octocat@okta.example.com", "name":{ "familyName":"Octocat", "givenName":"Mona" }, "emails":[ - { - "value":"mona.octocat@okta.example.com", - "type":"work", - "primary": true - } - ] %> diff --git a/translations/zh-CN/data/reusables/scim/user_required_values.md b/translations/zh-CN/data/reusables/scim/user_required_values.md deleted file mode 100644 index 06e7fd92a8ca..000000000000 --- a/translations/zh-CN/data/reusables/scim/user_required_values.md +++ /dev/null @@ -1 +0,0 @@ -如以下示例所示，您必须至少提供用户的必要值：`userName`、`name` 和 `emails`。 diff --git a/translations/zh-CN/data/reusables/search/exact-match-beta.md b/translations/zh-CN/data/reusables/search/exact-match-beta.md deleted file mode 100644 index 369be0d54947..000000000000 --- a/translations/zh-CN/data/reusables/search/exact-match-beta.md +++ /dev/null @@ -1 +0,0 @@ -代码搜索中的精确匹配在测试阶段，只面向 {% data variables.product.prodname_dotcom %} 上有限的用户和仓库，可能会有更改。 diff --git a/translations/zh-CN/data/reusables/search/exact-match.md b/translations/zh-CN/data/reusables/search/exact-match.md deleted file mode 100644 index 5b193e43efc1..000000000000 --- a/translations/zh-CN/data/reusables/search/exact-match.md +++ /dev/null @@ -1 +0,0 @@ -您可以搜索包含任何字母、数字和符号组合的精确匹配代码。 diff --git a/translations/zh-CN/data/reusables/shortdesc/2fa.md b/translations/zh-CN/data/reusables/shortdesc/2fa.md deleted file mode 100644 index ebe6b6b59371..000000000000 --- a/translations/zh-CN/data/reusables/shortdesc/2fa.md +++ /dev/null @@ -1 +0,0 @@ -如果您设置了双重身份验证，则此端点的基本身份验证会要求您使用一次性密码 (OTP) 以及您的用户名和密码，而不是令牌。 更多信息请参阅“[使用双重身份验证](/v3/auth/#working-with-two-factor-authentication)”。 \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/shortdesc/content_reference_body.md b/translations/zh-CN/data/reusables/shortdesc/content_reference_body.md deleted file mode 100644 index 4b89190d30bf..000000000000 --- a/translations/zh-CN/data/reusables/shortdesc/content_reference_body.md +++ /dev/null @@ -1 +0,0 @@ -You have used an email that already exists for the user_email_uniq field.\n \## DETAILS:\n\nThe (email)=(Octocat@github.com) already exists.\n\n The error was found in core/models.py in get_or_create_user at line 62.\n\n\ self.save() \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/shortdesc/content_reference_title.md b/translations/zh-CN/data/reusables/shortdesc/content_reference_title.md deleted file mode 100644 index 531d7aabf6de..000000000000 --- a/translations/zh-CN/data/reusables/shortdesc/content_reference_title.md +++ /dev/null @@ -1 +0,0 @@ -[A-1234] Error found in core/models.py file \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/sponsors/email-submit-bank-info.md b/translations/zh-CN/data/reusables/sponsors/email-submit-bank-info.md deleted file mode 100644 index 8824d6656e00..000000000000 --- a/translations/zh-CN/data/reusables/sponsors/email-submit-bank-info.md +++ /dev/null @@ -1 +0,0 @@ -加入 {% data variables.product.prodname_sponsors %} 后，您会收到一封电子邮件，其中包含有关提交您的银行和税务信息的说明。 diff --git a/translations/zh-CN/data/reusables/sponsors/matching-period.md b/translations/zh-CN/data/reusables/sponsors/matching-period.md deleted file mode 100644 index b32073fb0dac..000000000000 --- a/translations/zh-CN/data/reusables/sponsors/matching-period.md +++ /dev/null @@ -1 +0,0 @@ -在个人参与 {% data variables.product.prodname_sponsors %} 的第一年，赞助资格匹配可能受限于此处规定的限制。 在 {% data variables.product.company_short %} 许可帐户使用 {% data variables.product.prodname_sponsors %}（可发布帐户的赞助个人资料）之后开始资格匹配。 匹配期不能因任何原因而延长。 如果您离开 {% data variables.product.prodname_sponsors %} 后重新加入，参与期与匹配期之间可能有差距，或者您的匹配期可能过期。 diff --git a/translations/zh-CN/data/reusables/sponsors/org-sponsorship-dashboard.md b/translations/zh-CN/data/reusables/sponsors/org-sponsorship-dashboard.md deleted file mode 100644 index aaaa68a03301..000000000000 --- a/translations/zh-CN/data/reusables/sponsors/org-sponsorship-dashboard.md +++ /dev/null @@ -1 +0,0 @@ -1. 在组织的右侧，单击 **Sponsorship dashboard（赞助仪表板）**。 ![赞助仪表板按钮](/assets/images/help/sponsors/org-sponsorship-dashboard.png) diff --git a/translations/zh-CN/data/reusables/support/advanced-security-support-terms-differ.md b/translations/zh-CN/data/reusables/support/advanced-security-support-terms-differ.md deleted file mode 100644 index 27879d29e768..000000000000 --- a/translations/zh-CN/data/reusables/support/advanced-security-support-terms-differ.md +++ /dev/null @@ -1 +0,0 @@ -本文的条款不适用于 {% data variables.product.prodname_advanced_security %} 的支持服务。 更多信息请参阅“[关于 {% data variables.product.prodname_advanced_security %} 的支持](/enterprise/admin/enterprise-support/about-support-for-advanced-security)”。 diff --git a/translations/zh-CN/data/reusables/support/ghec-premium-priority-high-description.md b/translations/zh-CN/data/reusables/support/ghec-premium-priority-high-description.md deleted file mode 100644 index 7833873a9167..000000000000 --- a/translations/zh-CN/data/reusables/support/ghec-premium-priority-high-description.md +++ /dev/null @@ -1 +0,0 @@ -在 {% data variables.product.prodname_ghe_cloud %} 上的组织或企业的帐户或安全问题对您的业务产生了有限的影响。 \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/support/ghec-premium-priority-high-examples.md b/translations/zh-CN/data/reusables/support/ghec-premium-priority-high-examples.md deleted file mode 100644 index e82374be2180..000000000000 --- a/translations/zh-CN/data/reusables/support/ghec-premium-priority-high-examples.md +++ /dev/null @@ -1 +0,0 @@ -
    • 组织或企业所有者无意中删除了组织
    • 组织或企业成员在提交、议题、拉取请求或议题附件中上传了敏感数据
    \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/support/ghec-premium-priority-low-description.md b/translations/zh-CN/data/reusables/support/ghec-premium-priority-low-description.md deleted file mode 100644 index 44ceb3fc3033..000000000000 --- a/translations/zh-CN/data/reusables/support/ghec-premium-priority-low-description.md +++ /dev/null @@ -1 +0,0 @@ -您对于 {% data variables.product.prodname_ghe_cloud %} 上的组织或企业有问题或建议，但并不紧迫，或者该问题不影响团队的生产力。 \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/support/ghec-premium-priority-low-examples.md b/translations/zh-CN/data/reusables/support/ghec-premium-priority-low-examples.md deleted file mode 100644 index 746049c6218e..000000000000 --- a/translations/zh-CN/data/reusables/support/ghec-premium-priority-low-examples.md +++ /dev/null @@ -1 +0,0 @@ -
    • 您的组织或企业过度使用资源
    • 请求状态检查
    • 您的组织或企业在使用 Gist、通知、wiki、{% data variables.product.prodname_pages %}、{% data variables.product.prodname_desktop %}、Atom 或其他外围服务或功能方面需要帮助
    • 功能请求
    • 产品反馈
    \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/support/ghec-premium-priority-normal-description.md b/translations/zh-CN/data/reusables/support/ghec-premium-priority-normal-description.md deleted file mode 100644 index 6be8fa03365d..000000000000 --- a/translations/zh-CN/data/reusables/support/ghec-premium-priority-normal-description.md +++ /dev/null @@ -1 +0,0 @@ -在 {% data variables.product.prodname_ghe_cloud %} 上的组织或企业成员使用 {% data variables.product.prodname_dotcom_the_website %} 时遇到了有限或普通问题，或者您对于自己的组织或企业有一般性疑虑或问题。 \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/support/ghec-premium-priority-normal-examples.md b/translations/zh-CN/data/reusables/support/ghec-premium-priority-normal-examples.md deleted file mode 100644 index 5b858db82417..000000000000 --- a/translations/zh-CN/data/reusables/support/ghec-premium-priority-normal-examples.md +++ /dev/null @@ -1 +0,0 @@ -
    • 有关为组织或企业使用 API 和功能的问题
    • 有关 {% data variables.product.company_short %} 提供的组织数据迁移工具的问题
    • 组织或企业的相关功能未按预期工作
    • 有关组织或企业的一般安全问题
    \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/support/ghec-premium-priority-urgent-description.md b/translations/zh-CN/data/reusables/support/ghec-premium-priority-urgent-description.md deleted file mode 100644 index 26dafe1cc986..000000000000 --- a/translations/zh-CN/data/reusables/support/ghec-premium-priority-urgent-description.md +++ /dev/null @@ -1 +0,0 @@ -在 {% data variables.product.prodname_ghe_cloud %} 上的组织或企业的生产工作流程由于严重服务错误或中断而失败，并且该失败直接影响您的业务运营。 \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/support/ghec-premium-priority-urgent-examples.md b/translations/zh-CN/data/reusables/support/ghec-premium-priority-urgent-examples.md deleted file mode 100644 index 1758586a3e9f..000000000000 --- a/translations/zh-CN/data/reusables/support/ghec-premium-priority-urgent-examples.md +++ /dev/null @@ -1 +0,0 @@ -
    • {% data variables.product.prodname_dotcom_the_website %} 上的错误或中断影响您组织或企业所有成员的核心 Git 或 web 应用程序功能
    \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/support/github-one-premium-plus-response-times-differ.md b/translations/zh-CN/data/reusables/support/github-one-premium-plus-response-times-differ.md deleted file mode 100644 index 63a153624d38..000000000000 --- a/translations/zh-CN/data/reusables/support/github-one-premium-plus-response-times-differ.md +++ /dev/null @@ -1 +0,0 @@ -对于购买 {% data variables.product.prodname_ghe_one %} 的客户，对 {% data variables.product.prodname_actions %}、{% data variables.product.prodname_insights %}、{% data variables.product.prodname_learning %} 和 {% data variables.product.prodname_registry %} 的支持服务为每周 5 天，每天 24 小时，不包括周末和美国国家法定节假日。 标准响应时间为 1 个工作日 diff --git a/translations/zh-CN/data/reusables/support/github-one-premium-plus-sla-differs.md b/translations/zh-CN/data/reusables/support/github-one-premium-plus-sla-differs.md deleted file mode 100644 index cba18a090a6d..000000000000 --- a/translations/zh-CN/data/reusables/support/github-one-premium-plus-sla-differs.md +++ /dev/null @@ -1 +0,0 @@ -对于购买 {% data variables.product.prodname_ghe_one %} 的客户，{% data variables.contact.premium_support %} 的初始响应时间 SLA 不适用于 {% data variables.product.prodname_actions %}、{% data variables.product.prodname_insights %}、{% data variables.product.prodname_learning %} 或 {% data variables.product.prodname_registry %} 事件单。 \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/support/github-one-premium-plus-support-terms-differ.md b/translations/zh-CN/data/reusables/support/github-one-premium-plus-support-terms-differ.md deleted file mode 100644 index fb4e6cab9349..000000000000 --- a/translations/zh-CN/data/reusables/support/github-one-premium-plus-support-terms-differ.md +++ /dev/null @@ -1 +0,0 @@ -对于购买 {% data variables.product.prodname_ghe_one %} 的客户，{% data variables.product.premium_plus_support_plan %} 的支持条款不同于 {% data variables.product.prodname_actions %}、{% data variables.product.prodname_insights %}、{% data variables.product.prodname_learning %} 和 {% data variables.product.prodname_registry %} 的支持条款。 \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/teams/team-sync.md b/translations/zh-CN/data/reusables/teams/team-sync.md deleted file mode 100644 index be08a6112626..000000000000 --- a/translations/zh-CN/data/reusables/teams/team-sync.md +++ /dev/null @@ -1,7 +0,0 @@ -{% if currentVersion == "free-pro-team@latest" %} -{% note %} - - **注：**当您为具有组织身份提供程序 (IdP) 的团队设置了团队同步时，如果尝试使用 API 更改团队的成员身份，则会看到错误。 如果您有权访问 IdP 中的组成员身份，可以通过身份提供程序管理 GitHub 团队成员身份，该提供程序会自动添加和删除组织的成员。 更多信息请参阅“[在身份提供程序与 GitHub 之间同步团队](/articles/synchronizing-teams-between-your-identity-provider-and-github/)”。 - -{% endnote %} -{% endif %} diff --git a/translations/zh-CN/data/reusables/user-settings/throttling-notice.md b/translations/zh-CN/data/reusables/user-settings/throttling-notice.md deleted file mode 100644 index f858b00d9bfa..000000000000 --- a/translations/zh-CN/data/reusables/user-settings/throttling-notice.md +++ /dev/null @@ -1 +0,0 @@ -此端点触发[通知](/articles/about-notifications/)。 使用此端点创建内容过快可能会导致滥用率限制。 See "[Abuse rate limits](/v3/#abuse-rate-limits)"{% if currentVersion == "free-pro-team@latest" %} and "[Dealing with abuse rate limits](/v3/guides/best-practices-for-integrators/#dealing-with-abuse-rate-limits)"{% endif %} for details. diff --git a/translations/zh-CN/data/reusables/webhooks/interactive_component_short_desc.md b/translations/zh-CN/data/reusables/webhooks/interactive_component_short_desc.md deleted file mode 100644 index 6ec63523f5cd..000000000000 --- a/translations/zh-CN/data/reusables/webhooks/interactive_component_short_desc.md +++ /dev/null @@ -1 +0,0 @@ -Triggered when a user clicks an interactive element that was created using the {% data variables.product.prodname_component_kit %}. {% data variables.product.prodname_github_app %}s are automatically subscribed to the `interactive_component` event so there's no need to manually subscribe to this event. Unlike other webhook events, the `interactive_component` event is only sent to the {% data variables.product.prodname_github_app %} that a user interacted with through an interactive component, such as in a composable comment. {% data variables.product.prodname_oauth_app %}s cannot subscribe to the `interactive_component` event and other installed {% data variables.product.prodname_github_app %}s will not receive the webhook event even if they subscribed to `interactive_component`. \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/webhooks/issue_comment_event_api_properties.md b/translations/zh-CN/data/reusables/webhooks/issue_comment_event_api_properties.md deleted file mode 100644 index a1ba5e394e0f..000000000000 --- a/translations/zh-CN/data/reusables/webhooks/issue_comment_event_api_properties.md +++ /dev/null @@ -1,3 +0,0 @@ -| 键 | 类型 | 描述 | -| -------- | ----- | ---------------------------------------------------------------------- | -| `action` | `字符串` | The action that was performed on the comment. Can be one of `created`. | \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/webhooks/package_short_desc.md b/translations/zh-CN/data/reusables/webhooks/package_short_desc.md deleted file mode 100644 index 9b2e7ed32efb..000000000000 --- a/translations/zh-CN/data/reusables/webhooks/package_short_desc.md +++ /dev/null @@ -1 +0,0 @@ -Activity related to GitHub Packages. {% data reusables.webhooks.action_type_desc %} For more information, see "[GitHub Packages](/packages)". \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/webhooks/pull_request_forked_repos_link.md b/translations/zh-CN/data/reusables/webhooks/pull_request_forked_repos_link.md deleted file mode 100644 index 0fad1bebc3a1..000000000000 --- a/translations/zh-CN/data/reusables/webhooks/pull_request_forked_repos_link.md +++ /dev/null @@ -1 +0,0 @@ -See [below](#pull-request-events-for-forked-repositories) to learn how this event works with forked repositories. \ No newline at end of file diff --git a/translations/zh-CN/data/variables/ant-man.yml b/translations/zh-CN/data/variables/ant-man.yml deleted file mode 100644 index fd9020681ae1..000000000000 --- a/translations/zh-CN/data/variables/ant-man.yml +++ /dev/null @@ -1,3 +0,0 @@ ---- -deployments-ant-man-parameter-note: >- - {% if currentVersion == "free-pro-team@latest" %}**Note:** This parameter requires you to use the [`application/vnd.github.ant-man-preview+json`](/v3/previews/#enhanced-deployments) custom media type.{% endif %} diff --git a/translations/zh-CN/data/variables/cloud-9.yml b/translations/zh-CN/data/variables/cloud-9.yml deleted file mode 100644 index 514cc607691b..000000000000 --- a/translations/zh-CN/data/variables/cloud-9.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: The SCIM API diff --git a/translations/zh-CN/data/variables/giant-sentry-fist.yml b/translations/zh-CN/data/variables/giant-sentry-fist.yml deleted file mode 100644 index ae3a16bbeb72..000000000000 --- a/translations/zh-CN/data/variables/giant-sentry-fist.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: The User Blocking API diff --git a/translations/zh-CN/data/variables/korra.yml b/translations/zh-CN/data/variables/korra.yml deleted file mode 100644 index a0e37a535b50..000000000000 --- a/translations/zh-CN/data/variables/korra.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: The Organization Membership API diff --git a/translations/zh-CN/data/variables/mercy.yml b/translations/zh-CN/data/variables/mercy.yml deleted file mode 100644 index 0076f284e63b..000000000000 --- a/translations/zh-CN/data/variables/mercy.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: The `topics` property for repositories diff --git a/translations/zh-CN/data/variables/mister-fantastic.yml b/translations/zh-CN/data/variables/mister-fantastic.yml deleted file mode 100644 index 5040343f790d..000000000000 --- a/translations/zh-CN/data/variables/mister-fantastic.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: The GitHub Pages API diff --git a/translations/zh-CN/data/variables/performed-via-integration.yml b/translations/zh-CN/data/variables/performed-via-integration.yml deleted file mode 100644 index c2d523e86a75..000000000000 --- a/translations/zh-CN/data/variables/performed-via-integration.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: An additional `performed_via_github_app` object in the issue payload diff --git a/translations/zh-CN/data/variables/valkyrie.yml b/translations/zh-CN/data/variables/valkyrie.yml deleted file mode 100644 index 7b921d5113e1..000000000000 --- a/translations/zh-CN/data/variables/valkyrie.yml +++ /dev/null @@ -1,2 +0,0 @@ ---- -product_name_long: The GitHub Marketplace API