Octomerger Bot
@@ -54,18 +54,19 @@ On {% data variables.product.product_name %} {% ifversion ghes %}{{ allVersions[
|
||||
|
||||
{% data variables.product.company_short %} experts, security researchers, and community contributors write and maintain the default {% data variables.product.prodname_codeql %} queries used for {% data variables.product.prodname_code_scanning %}. The queries are regularly updated to improve analysis and reduce any false positive results. The queries are open source, so you can view and contribute to the queries in the [`github/codeql`](https://github.com/github/codeql) repository. For more information, see [{% data variables.product.prodname_codeql %}](https://codeql.github.com/) on the {% data variables.product.prodname_codeql %} website. You can also write your own queries. For more information, see "[About {% data variables.product.prodname_codeql %} queries](https://codeql.github.com/docs/writing-codeql-queries/about-codeql-queries/)" in the {% data variables.product.prodname_codeql %} documentation.
|
||||
|
||||
You can run additional queries as part of your code scanning analysis.
|
||||
You can run additional queries as part of your code scanning analysis.
|
||||
|
||||
{%- ifversion codeql-packs %}
|
||||
These queries must belong to a published {% data variables.product.prodname_codeql %} query pack (beta) or a QL pack in a repository. {% data variables.product.prodname_codeql %} packs (beta) provide the following benefits over traditional QL packs:
|
||||
These queries must belong to a published {% data variables.product.prodname_codeql %} query pack (beta) or a {% data variables.product.prodname_codeql %} pack in a repository. {% data variables.product.prodname_codeql %} packs (beta) provide the following benefits over traditional {% data variables.product.prodname_ql %} packs:
|
||||
|
||||
- When a {% data variables.product.prodname_codeql %} query pack (beta) is published to the {% data variables.product.company_short %} {% data variables.product.prodname_container_registry %}, all the transitive dependencies required by the queries and a compilation cache are included in the package. This improves performance and ensures that running the queries in the pack gives identical results every time until you upgrade to a new version of the pack or the CLI.
|
||||
- QL packs do not include transitive dependencies, so queries in the pack can depend only on the standard libraries (that is, the libraries referenced by an `import LANGUAGE` statement in your query), or libraries in the same QL pack as the query.
|
||||
- When a {% data variables.product.prodname_codeql %} query pack (beta) is published to the {% data variables.product.company_short %} {% data variables.product.prodname_container_registry %}, all the transitive dependencies required by the queries and a compilation cache are included in the package. This improves performance and ensures that running the queries in the pack gives identical results every time until you upgrade to a new version of the pack or the CLI.
|
||||
- {% data variables.product.prodname_ql %} packs do not include transitive dependencies, so queries in the pack can depend only on the standard libraries (that is, the libraries referenced by an `import LANGUAGE` statement in your query), or libraries in the same {% data variables.product.prodname_ql %} pack as the query.
|
||||
- {% data variables.product.prodname_codeql %} query packs (beta) can be downloaded from multiple GitHub container registries. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#downloading-codeql-packs-from-github-enterprise-server)."
|
||||
|
||||
For more information, see "[About {% data variables.product.prodname_codeql %} packs](https://codeql.github.com/docs/codeql-cli/about-codeql-packs/)" and "[About {% data variables.product.prodname_ql %} packs](https://codeql.github.com/docs/codeql-cli/about-ql-packs/)" in the {% data variables.product.prodname_codeql %} documentation.
|
||||
For more information, see "[About {% data variables.product.prodname_codeql %} packs](https://codeql.github.com/docs/codeql-cli/about-codeql-packs/)" in the {% data variables.product.prodname_codeql %} documentation.
|
||||
|
||||
{% data reusables.code-scanning.beta-codeql-packs-cli %}
|
||||
|
||||
{%- else %}
|
||||
The queries you want to run must belong to a QL pack in a repository. Queries must only depend on the standard libraries (that is, the libraries referenced by an `import LANGUAGE` statement in your query), or libraries in the same QL pack as the query. For more information, see "[About {% data variables.product.prodname_ql %} packs](https://codeql.github.com/docs/codeql-cli/about-ql-packs/)."
|
||||
The queries you want to run must belong to a {% data variables.product.prodname_ql %} pack in a repository. Queries must only depend on the standard libraries (that is, the libraries referenced by an `import LANGUAGE` statement in your query), or libraries in the same {% data variables.product.prodname_ql %} pack as the query.
|
||||
{% endif %}
|
||||
|
||||
@@ -323,6 +323,38 @@ In the example below, `scope` is the organization or personal account that publi
|
||||
packs: scope/pack1,scope/pack2@1.2.3,scope/pack3@~3.2.1,scope/pack4@4.5.6:path/to/queries
|
||||
```
|
||||
|
||||
### Downloading {% data variables.product.prodname_codeql %} packs from {% data variables.product.prodname_ghe_server %}
|
||||
|
||||
If your workflow uses packs that are published on a {% data variables.product.prodname_ghe_server %} installation, you need to tell your workflow where to find them. You can do this by using the `registries` input of the {% data reusables.actions.action-codeql-action-init %} action. This input accepts a list of `url`, `packages`, and `token` properties as shown below.
|
||||
|
||||
```
|
||||
- uses: {% data reusables.actions.action-codeql-action-init %}
|
||||
with:
|
||||
registries: {% raw %}|
|
||||
# URL to the container registry, usually in this format
|
||||
- url: https://containers.GHEHOSTNAME1/v2/
|
||||
|
||||
# List of package glob patterns to be found at this registry
|
||||
packages:
|
||||
- my-company/*
|
||||
- my-company2/*
|
||||
|
||||
# Token, which should be stored as a secret
|
||||
token: ${{ secrets.GHEHOSTNAME1_TOKEN }}
|
||||
|
||||
# URL to the default container registry
|
||||
- url: https://ghcr.io/v2/
|
||||
# Packages can also be a string
|
||||
packages: "*/*"
|
||||
token: ${{ secrets.GHCR_TOKEN }}
|
||||
|
||||
{% endraw %}
|
||||
```
|
||||
|
||||
The package patterns in the registries list are examined in order, so you should generally place the most specific package patterns first. The values for `token` must be a personal access token generated by the GitHub instance you are downloading from with the `read:packages` permission.
|
||||
|
||||
Notice the `|` after the `registries` property name. This is important since {% data variables.product.prodname_actions %} inputs can only accept strings. Using the `|` converts the subsequent text to a string, which is parsed later by the {% data reusables.actions.action-codeql-action-init %} action.
|
||||
|
||||
### Using queries in QL packs
|
||||
{% endif %}
|
||||
To add one or more queries, add a `with: queries:` entry within the `uses: {% data reusables.actions.action-codeql-action-init %}` section of the workflow. If the queries are in a private repository, use the `external-repository-token` parameter to specify a token that has access to checkout the private repository.
|
||||
|
||||
@@ -55,7 +55,7 @@ You can display the command-line help for any command using the <nobr>`--help`</
|
||||
2. Set up the environment for the codebase, making sure that any dependencies are available. For more information, see [Creating databases for non-compiled languages](https://codeql.github.com/docs/codeql-cli/creating-codeql-databases/#creating-databases-for-non-compiled-languages) and [Creating databases for compiled languages](https://codeql.github.com/docs/codeql-cli/creating-codeql-databases/#creating-databases-for-compiled-languages) in the documentation for the {% data variables.product.prodname_codeql_cli %}.
|
||||
3. Find the build command, if any, for the codebase. Typically this is available in a configuration file in the CI system.
|
||||
4. Run `codeql database create` from the checkout root of your repository and build the codebase.
|
||||
|
||||
|
||||
```shell
|
||||
# Single supported language - create one CodeQL databsae
|
||||
codeql database create <database> --command<build> --language=<language-identifier>
|
||||
@@ -64,7 +64,7 @@ You can display the command-line help for any command using the <nobr>`--help`</
|
||||
codeql database create <database> --command<build> \
|
||||
--db-cluster --language=<language-identifier>,<language-identifier>
|
||||
```
|
||||
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** If you use a containerized build, you need to run the {% data variables.product.prodname_codeql_cli %} inside the container where your build task takes place.
|
||||
@@ -75,9 +75,9 @@ You can display the command-line help for any command using the <nobr>`--help`</
|
||||
|--------|:--------:|-----|
|
||||
| `<database>` | {% octicon "check-circle-fill" aria-label="Required" %} | Specify the name and location of a directory to create for the {% data variables.product.prodname_codeql %} database. The command will fail if you try to overwrite an existing directory. If you also specify `--db-cluster`, this is the parent directory and a subdirectory is created for each language analyzed.|
|
||||
| <nobr>`--language`</nobr> | {% octicon "check-circle-fill" aria-label="Required" %} | Specify the identifier for the language to create a database for, one of: `{% data reusables.code-scanning.codeql-languages-keywords %}` (use `javascript` to analyze TypeScript code). When used with <nobr>`--db-cluster`</nobr>, the option accepts a comma-separated list, or can be specified more than once.
|
||||
| <nobr>`--command`</nobr> | | Recommended. Use to specify the build command or script that invokes the build process for the codebase. Commands are run from the current folder or, where it is defined, from <nobr>`--source-root`</nobr>. Not needed for Python and JavaScript/TypeScript analysis. |
|
||||
| <nobr>`--command`</nobr> | | Recommended. Use to specify the build command or script that invokes the build process for the codebase. Commands are run from the current folder or, where it is defined, from <nobr>`--source-root`</nobr>. Not needed for Python and JavaScript/TypeScript analysis. |
|
||||
| <nobr>`--db-cluster`</nobr> | | Optional. Use in multi-language codebases to generate one database for each language specified by <nobr>`--language`</nobr>.
|
||||
| <nobr>`--no-run-unnecessary-builds`</nobr> | | Recommended. Use to suppress the build command for languages where the {% data variables.product.prodname_codeql_cli %} does not need to monitor the build (for example, Python and JavaScript/TypeScript).
|
||||
| <nobr>`--no-run-unnecessary-builds`</nobr> | | Recommended. Use to suppress the build command for languages where the {% data variables.product.prodname_codeql_cli %} does not need to monitor the build (for example, Python and JavaScript/TypeScript).
|
||||
| <nobr>`--source-root`</nobr> | | Optional. Use if you run the CLI outside the checkout root of the repository. By default, the `database create` command assumes that the current directory is the root directory for the source files, use this option to specify a different location. |{% ifversion fpt or ghec or ghes > 3.2 or ghae %}
|
||||
| <nobr>`--codescanning-config`</nobr> | | Optional (Advanced). Use if you have a configuration file that specifies how to create the {% data variables.product.prodname_codeql %} databases and what queries to run in later steps. For more information, see "[Using a custom configuration file](/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#using-a-custom-configuration-file)" and "[database create](https://codeql.github.com/docs/codeql-cli/manual/database-create/#cmdoption-codeql-database-create-codescanning-config)." |{% endif %}
|
||||
|
||||
@@ -275,6 +275,10 @@ If you want to download a {% data variables.product.prodname_codeql %} pack with
|
||||
```shell
|
||||
echo $OCTO-ORG_ACCESS_TOKEN | codeql pack download <scope/name@version:path> <scope/name@version:path> ...
|
||||
```
|
||||
|
||||
### Downloading {% data variables.product.prodname_codeql %} packs from multiple {% data variables.product.company_short %} container registries
|
||||
|
||||
If your {% data variables.product.prodname_codeql %} packs reside on multiple container registries, then you must instruct the {% data variables.product.prodname_codeql_cli %} where to find each pack. For more information, see "[Configuring {% data variables.product.prodname_code_scanning %}](/code-security/secure-coding/automatically-scanning-your-code-for-vulnerabilities-and-errors#downloading-codeql-packs-from-github-enterprise-server)."
|
||||
{% endif %}
|
||||
|
||||
## Example CI configuration for {% data variables.product.prodname_codeql %} analysis
|
||||
@@ -331,3 +335,4 @@ If you want to upload more than one set of results to the {% data variables.prod
|
||||
|
||||
- [Creating CodeQL databases](https://codeql.github.com/docs/codeql-cli/creating-codeql-databases/)
|
||||
- [Analyzing databases with the CodeQL CLI](https://codeql.github.com/docs/codeql-cli/analyzing-databases-with-the-codeql-cli/)
|
||||
- [Publishing and using CodeQL packs](https://codeql.github.com/docs/codeql-cli/publishing-and-using-codeql-packs/)
|
||||
|
||||
@@ -3,3 +3,4 @@
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
ghes: '>3.6'
|
||||
|
||||
@@ -137,6 +137,7 @@ prodname_github_issues: 'GitHub Issues'
|
||||
# GitHub Packages
|
||||
prodname_registry: 'GitHub Packages'
|
||||
prodname_container_registry: 'Container registry'
|
||||
prodname_container_registries: 'Container registries'
|
||||
prodname_docker_registry_namespace: '{% ifversion fpt or ghec %}`docker.pkg.github.com`{% elsif ghes or ghae %}<code>docker.<em>HOSTNAME</em></code>{% endif %}'
|
||||
prodname_container_registry_namespace: '{% ifversion fpt or ghec %}`ghcr.io`{% elsif ghes or ghae %}<code>containers.<em>HOSTNAME</em></code>{% endif %}'
|
||||
prodname_npm_registry: 'npm registry'
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: 依存関係グラフについて
|
||||
intro: 依存関係グラフを使って、プロジェクトの依存関係をすべて特定できます。 依存関係グラフは、幅広く一般的なパッケージエコシステムをサポートします。
|
||||
title: About the dependency graph
|
||||
intro: You can use the dependency graph to identify all your project's dependencies. The dependency graph supports a range of popular package ecosystems.
|
||||
redirect_from:
|
||||
- /github/visualizing-repository-data-with-graphs/about-the-dependency-graph
|
||||
- /code-security/supply-chain-security/about-the-dependency-graph
|
||||
@@ -15,85 +15,101 @@ topics:
|
||||
- Dependencies
|
||||
- Repositories
|
||||
shortTitle: Dependency graph
|
||||
ms.openlocfilehash: bb8e802210da132d51e4c926ac9085a6790ba683
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: ja-JP
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147578627'
|
||||
---
|
||||
<!--For this article in earlier GHES versions, see /content/github/visualizing-repository-data-with-graphs-->
|
||||
<!--Marketing-LINK: From /features/security and /features/security/software-supply-chain pages "How GitHub's dependency graph is generated".-->
|
||||
|
||||
## 依存関係グラフについて
|
||||
## About the dependency graph
|
||||
|
||||
{% data reusables.dependabot.about-the-dependency-graph %}
|
||||
|
||||
{% data variables.product.product_name %} に、デフォルト ブランチでサポートされているマニフェストもしくはロック ファイルを変更もしくは追加するコミットをプッシュすると、依存関係グラフは自動的に更新されます。{% ifversion fpt or ghec %}加えて、誰かが依存関係のいずれかのリポジトリに変更をプッシュすると、グラフは更新されます。{% endif %}サポートされているエコシステムとマニフェスト ファイルに関する情報については以下の「[サポートされているパッケージエコシステム](#supported-package-ecosystems)」を参照してください。
|
||||
When you push a commit to {% data variables.product.product_name %} that changes or adds a supported manifest or lock file to the default branch, the dependency graph is automatically updated.{% ifversion fpt or ghec %} In addition, the graph is updated when anyone pushes a change to the repository of one of your dependencies.{% endif %} For information on the supported ecosystems and manifest files, see "[Supported package ecosystems](#supported-package-ecosystems)" below.
|
||||
|
||||
{% ifversion dependency-submission-api %} {% data reusables.dependency-submission.dependency-submission-link %} {% endif %}
|
||||
{% ifversion dependency-submission-api %}
|
||||
{% data reusables.dependency-submission.dependency-submission-link %}
|
||||
{% endif %}
|
||||
|
||||
デフォルトブランチをターゲットとする、依存関係の変更を含むPull Requestを作成すると、{% data variables.product.prodname_dotcom %}は依存関係グラフを使ってそのPull Requestに依存関係のレビューを追加します。 それらは、依存関係が脆弱性を含んでいるか、もしそうならその脆弱性が修復されているバージョンを示しています。 詳細については、「[依存関係レビューについて](/code-security/supply-chain-security/about-dependency-review)」を参照してください。
|
||||
When you create a pull request containing changes to dependencies that targets the default branch, {% data variables.product.prodname_dotcom %} uses the dependency graph to add dependency reviews to the pull request. These indicate whether the dependencies contain vulnerabilities and, if so, the version of the dependency in which the vulnerability was fixed. For more information, see "[About dependency review](/code-security/supply-chain-security/about-dependency-review)."
|
||||
|
||||
## 依存関係グラフの利用
|
||||
## Dependency graph availability
|
||||
|
||||
{% ifversion fpt or ghec %}依存関係グラフは、サポートされているファイル形式を使用して、サポートされているパッケージ エコシステムの依存関係を定義するすべてのパブリック リポジトリで利用できます。 リポジトリ管理者は、プライベート リポジトリの依存関係グラフを有効または無効にすることができます。 詳細については、「[依存関係グラフの構成](/code-security/supply-chain-security/understanding-your-software-supply-chain/configuring-the-dependency-graph)」を参照してください。{% endif %}
|
||||
{% ifversion fpt or ghec %}The dependency graph is available for every public repository that defines dependencies in a supported package ecosystem using a supported file format. Repository administrators can also set up the dependency graph for private repositories. For more information, see "[Configuring the dependency graph](/code-security/supply-chain-security/understanding-your-software-supply-chain/configuring-the-dependency-graph)."{% endif %}
|
||||
|
||||
{% data reusables.dependabot.dependabot-alerts-dependency-graph-enterprise %}
|
||||
|
||||
## 含まれる依存関係
|
||||
## Dependencies included
|
||||
|
||||
依存関係グラフには、マニフェストとロック ファイルで詳しく説明されているリポジトリのすべての依存関係、またはサポートされているエコシステム {% ifversion dependency-submission-api %} に関する同等の依存関係と、Dependency Submission API (beta){% endif %} を使用して送信されたすべての依存関係が含まれます。 これには次のものが含まれます
|
||||
The dependency graph includes all the dependencies of a repository that are detailed in the manifest and lock files, or their equivalent, for supported ecosystems{% ifversion dependency-submission-api %}, as well as any dependencies that are submitted using the Dependency submission API (beta){% endif %}. This includes:
|
||||
|
||||
- マニフェストまたはロック ファイルに明示的に定義されている{% ifversion dependency-submission-api %}、または依存関係送信 API (ベータ) を使って送信された{% endif %}直接依存関係
|
||||
- 直接依存関係の間接依存関係。推移的な依存関係、または下位の依存関係とも言う。
|
||||
- Direct dependencies, that are explicitly defined in a manifest or lock file {% ifversion dependency-submission-api %} or have been submitted using the Dependency submission API (beta){% endif %}
|
||||
- Indirect dependencies of these direct dependencies, also known as transitive dependencies or sub-dependencies
|
||||
|
||||
依存関係グラフでは、{% ifversion fpt or ghec %}ロック ファイルから明示的に、または直接的な依存対象の依存関係をチェックして、間接的な依存関係を識別します。 最も信頼性の高いグラフを得るには、ロックファイル (または同等のもの) を使用してください。直接および間接の依存関係のうち現在どのバージョンを使用しているかが正確に定義されているからです。 ロックファイルを使用する場合、リポジトリのすべてのコントリビューターが同じバージョンを使用していることも確認してください。そのほうが、コードのテストとデバッグが容易になります。{% else %}ロックファイルから間接的な依存関係を識別します。{% endif %}
|
||||
The dependency graph identifies indirect dependencies{% ifversion fpt or ghec %} either explicitly from a lock file or by checking the dependencies of your direct dependencies. For the most reliable graph, you should use lock files (or their equivalent) because they define exactly which versions of the direct and indirect dependencies you currently use. If you use lock files, you also ensure that all contributors to the repository are using the same versions, which will make it easier for you to test and debug code{% else %} from the lock files{% endif %}.
|
||||
|
||||
{% data variables.product.product_name %} を使用して環境内の依存関係を理解する方法の詳細については、「[サプライ チェーンのセキュリティについて](/code-security/supply-chain-security/understanding-your-software-supply-chain/about-supply-chain-security)」を参照してください。
|
||||
For more information on how {% data variables.product.product_name %} helps you understand the dependencies in your environment, see "[About supply chain security](/code-security/supply-chain-security/understanding-your-software-supply-chain/about-supply-chain-security)."
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
|
||||
## 含まれる依存物
|
||||
## Dependents included
|
||||
|
||||
パブリックリポジトリでは、そのリポジトリに依存しているパブリックリポジトリ、もしくはそのリポジトリが公開しているパッケージのみが報告されます。 この情報は、プライベートリポジトリについては報告されません。{% endif %}
|
||||
For public repositories, only public repositories that depend on it or on packages that it publishes are reported. This information is not reported for private repositories.{% endif %}
|
||||
|
||||
## 依存関係グラフの使用
|
||||
## Using the dependency graph
|
||||
|
||||
依存関係グラフを使用する目的は、次のとおりです。
|
||||
You can use the dependency graph to:
|
||||
|
||||
- コードが依存しているリポジトリ{% ifversion fpt or ghec %}、そしてそのコードに依存しているリポジトリ{% endif %}を調べること。 詳細については、「[ポジトリの依存関係を調べる](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository)」を参照してください。 {% ifversion ghec %}
|
||||
- Organization のリポジトリで使用されている依存関係のサマリーを 1 つのダッシュボードで確認すること。 詳細については、「[Organization のインサイトを表示する](/articles/viewing-insights-for-your-organization#viewing-organization-dependency-insights)」を参照してください。{% endif %}
|
||||
- リポジトリの脆弱な依存関係を表示・更新すること。 詳細については、「[{% data variables.product.prodname_dependabot_alerts %} について](/code-security/supply-chain-security/about-alerts-for-vulnerable-dependencies)」を参照してください。{% ifversion fpt or ghes or ghec %}
|
||||
- Pull Request中の脆弱性がある依存関係に関する情報を見ること。 詳細については、「[pull request 内の依存関係の変更をレビューする](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-dependency-changes-in-a-pull-request)」を参照してください。{% endif %}
|
||||
- Explore the repositories your code depends on{% ifversion fpt or ghec %}, and those that depend on it{% endif %}. For more information, see "[Exploring the dependencies of a repository](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository)." {% ifversion ghec %}
|
||||
- View a summary of the dependencies used in your organization's repositories in a single dashboard. For more information, see "[Viewing insights for your organization](/articles/viewing-insights-for-your-organization#viewing-organization-dependency-insights)."{% endif %}
|
||||
- View and update vulnerable dependencies for your repository. For more information, see "[About {% data variables.product.prodname_dependabot_alerts %}](/code-security/supply-chain-security/about-alerts-for-vulnerable-dependencies)."{% ifversion fpt or ghes or ghec %}
|
||||
- See information about vulnerable dependencies in pull requests. For more information, see "[Reviewing dependency changes in a pull request](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-dependency-changes-in-a-pull-request)."{% endif %}
|
||||
|
||||
## サポートされているパッケージエコシステム
|
||||
## Supported package ecosystems
|
||||
|
||||
推奨されるフォーマットでは、直接および間接の依存関係すべてに使用されるバージョンを明示的に定義しています。 これらの形式を使う場合、依存関係グラフはより正確になります。 これは、現在のビルドのセットアップも反映し、依存関係グラフが直接および間接の依存関係の両方で脆弱性を報告できるようにしてくれます。{% ifversion fpt or ghec %}マニフェスト ファイル (あるいはそれに相当するもの) から推定される間接的な依存関係は、セキュリティで保護されていない依存関係のチェックから除外されます。{% endif %}
|
||||
The recommended formats explicitly define which versions are used for all direct and all indirect dependencies. If you use these formats, your dependency graph is more accurate. It also reflects the current build set up and enables the dependency graph to report vulnerabilities in both direct and indirect dependencies.{% ifversion fpt or ghec %} Indirect dependencies that are inferred from a manifest file (or equivalent) are excluded from the checks for insecure dependencies.{% endif %}
|
||||
|
||||
| パッケージ マネージャー | 言語 | 推奨される形式 | サポートされているすべての形式 |
|
||||
| Package manager | Languages | Recommended formats | All supported formats |
|
||||
| --- | --- | --- | ---|
|
||||
{%- ifversion dependency-graph-rust-support %} | Cargo{% ifversion ghes = 3.6 or ghae-issue-7563 %}<sup>[*]</sup>{% endif %} | Rust | `Cargo.lock` | `Cargo.toml`、`Cargo.lock` | {%- endif %} | Composer | PHP | `composer.lock` | `composer.json`、`composer.lock` | | NuGet | .NET 言語 (C#、F#、VB)、C++ | `.csproj`、`.vbproj`、`.nuspec`、`.vcxproj`、`.fsproj` | `.csproj`、`.vbproj`、`.nuspec`、`.vcxproj`、`.fsproj`、`packages.config` | {%- ifversion github-actions-in-dependency-graph %} | {% data variables.product.prodname_actions %} ワークフロー<sup>[†]</sup> | YAML | `.yml`、`.yaml` | `.yml`、`.yaml` | {%- endif %} {%- ifversion fpt or ghec or ghes > 3.2 or ghae %} | Go Modules | Go | `go.sum` | `go.mod`、`go.sum` | {%- elsif ghes = 3.2 %} | Go Modules | Go | `go.mod` | `go.mod` | {%- endif %} | Maven | Java、Scala | `pom.xml` | `pom.xml` | | npm | JavaScript | `package-lock.json` | `package-lock.json`、`package.json`| | pip | Python | `requirements.txt`、`pipfile.lock` | `requirements.txt`、`pipfile`、`pipfile.lock`、`setup.py`<sup>[‡]</sup> | {%- ifversion fpt or ghec or ghes > 3.3 or ghae-issue-4752 %} | Python Poetry | Python | `poetry.lock` | `poetry.lock`、`pyproject.toml` | {%- endif %} | RubyGems | Ruby | `Gemfile.lock` | `Gemfile.lock`、`Gemfile`、`*.gemspec` | | Yarn | JavaScript | `yarn.lock` | `package.json`、`yarn.lock` |
|
||||
{%- ifversion dependency-graph-rust-support %}
|
||||
| Cargo | Rust | `Cargo.lock` | `Cargo.toml`, `Cargo.lock` |
|
||||
{%- endif %}
|
||||
| Composer | PHP | `composer.lock` | `composer.json`, `composer.lock` |
|
||||
| NuGet | .NET languages (C#, F#, VB), C++ | `.csproj`, `.vbproj`, `.nuspec`, `.vcxproj`, `.fsproj` | `.csproj`, `.vbproj`, `.nuspec`, `.vcxproj`, `.fsproj`, `packages.config` |
|
||||
{%- ifversion github-actions-in-dependency-graph %}
|
||||
| {% data variables.product.prodname_actions %} workflows<sup>[†]</sup> | YAML | `.yml`, `.yaml` | `.yml`, `.yaml` |
|
||||
{%- endif %}
|
||||
{%- ifversion fpt or ghec or ghes > 3.2 or ghae %}
|
||||
| Go modules | Go | `go.sum` | `go.mod`, `go.sum` |
|
||||
{%- elsif ghes = 3.2 %}
|
||||
| Go modules | Go | `go.mod` | `go.mod` |
|
||||
{%- endif %}
|
||||
| Maven | Java, Scala | `pom.xml` | `pom.xml` |
|
||||
| npm | JavaScript | `package-lock.json` | `package-lock.json`, `package.json`|
|
||||
| pip | Python | `requirements.txt`, `pipfile.lock` | `requirements.txt`, `pipfile`, `pipfile.lock`, `setup.py`<sup>[‡]</sup> |
|
||||
{%- ifversion fpt or ghec or ghes > 3.3 or ghae-issue-4752 %}
|
||||
| Python Poetry | Python | `poetry.lock` | `poetry.lock`, `pyproject.toml` |
|
||||
{%- endif %}
|
||||
| RubyGems | Ruby | `Gemfile.lock` | `Gemfile.lock`, `Gemfile`, `*.gemspec` |
|
||||
| Yarn | JavaScript | `yarn.lock` | `package.json`, `yarn.lock` |
|
||||
|
||||
{% ifversion ghes = 3.6 or ghae-issue-7563 %} [*] Rust をサポートする最初のリリースでは、推移的依存関係を検出するために必要なメタデータとマッピングが依存関係グラフにありません。 `Cargo.lock` ファイルに定義されている場合、依存関係グラフには、1 レベルの深さの推移的依存関係が表示されます。 `Cargo.lock` ファイルに定義されている脆弱な依存関係には、{% data variables.product.prodname_dependabot_alerts %} と {% data variables.product.prodname_dependabot_security_updates %} を使用できます。
|
||||
{% endif %}
|
||||
|
||||
{% ifversion github-actions-in-dependency-graph %} [†] {% data reusables.enterprise.3-5-missing-feature %} マニフェストとして認識するには、{% data variables.product.prodname_actions %} ワークフローをリポジトリの `.github/workflows/` ディレクトリに配置する必要があります。 構文 `jobs[*].steps[*].uses` または `jobs.<job_id>.uses` を使用して参照されるアクションまたはワークフローは、依存関係として解析されます。 詳細については、[{% data variables.product.prodname_actions %} のワークフロー構文](/actions/using-workflows/workflow-syntax-for-github-actions)に関するページを参照してください。
|
||||
{% ifversion github-actions-in-dependency-graph %}
|
||||
[†] {% data reusables.enterprise.3-5-missing-feature %} {% data variables.product.prodname_actions %} workflows must be located in the `.github/workflows/` directory of a repository to be recognized as manifests. Any actions or workflows referenced using the syntax `jobs[*].steps[*].uses` or `jobs.<job_id>.uses` will be parsed as dependencies. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/using-workflows/workflow-syntax-for-github-actions)."
|
||||
|
||||
{% endif %}
|
||||
|
||||
[‡] `setup.py` ファイル内に Python の依存関係を列挙した場合、ユーザーはプロジェクト内のすべての依存関係を解析し、列挙することができない場合があります。
|
||||
[‡] If you list your Python dependencies within a `setup.py` file, we may not be able to parse and list every dependency in your project.
|
||||
|
||||
{% ifversion github-actions-in-dependency-graph %} {% note %}
|
||||
{% ifversion github-actions-in-dependency-graph %}
|
||||
{% note %}
|
||||
|
||||
**注:** {% data variables.product.prodname_actions %} ワークフローの依存関係は、情報提供のために依存関係グラフに表示されます。 Dependabot アラートは、現在、{% data variables.product.prodname_actions %} ワークフローではサポートされていません。
|
||||
**Note:** {% data variables.product.prodname_actions %} workflow dependencies are displayed in the dependency graph for informational purposes. Dependabot alerts are not currently supported for {% data variables.product.prodname_actions %} workflows.
|
||||
|
||||
{% endnote %} {% endif %}
|
||||
{% endnote %}
|
||||
{% endif %}
|
||||
|
||||
{% ifversion dependency-submission-api %}依存関係申請 API (ベータ) を使用すると、上記のサポートされているエコシステム リストにエコシステムがない場合でも、依存関係を任意のパッケージ マネージャーまたはエコシステムから依存関係グラフに追加できます。 依存関係グラフには、送信された依存関係がエコシステム別にグループ化されて表示されますが、マニフェストまたはロック ファイルから解析された依存関係とは別に表示されます。 {% data variables.product.prodname_advisory_database %} の[サポートされているエコシステム](https://github.com/github/advisory-database#supported-ecosystems)のいずれかからの依存関係に対する {% data variables.product.prodname_dependabot_alerts %} のみを受け取ります。 依存関係送信 API の詳細について、「[依存関係送信 API の使用](/code-security/supply-chain-security/understanding-your-software-supply-chain/using-the-dependency-submission-api)」を参照してください。{% endif %}
|
||||
## 参考資料
|
||||
{% ifversion dependency-submission-api %}You can use the Dependency submission API (beta) to add dependencies from the package manager or ecosystem of your choice to the dependency graph, even if the ecosystem is not in the supported ecosystem list above. The dependency graph will display the submitted dependencies grouped by ecosystem, but separately from the dependencies parsed from manifest or lock files. You will only get {% data variables.product.prodname_dependabot_alerts %} for dependencies that are from one of the [supported ecosystems](https://github.com/github/advisory-database#supported-ecosystems) of the {% data variables.product.prodname_advisory_database %}. For more information on the Dependency submission API, see "[Using the Dependency submission API](/code-security/supply-chain-security/understanding-your-software-supply-chain/using-the-dependency-submission-api)."{% endif %}
|
||||
## Further reading
|
||||
|
||||
- Wikipedia の「[依存関係グラフ](https://en.wikipedia.org/wiki/Dependency_graph)」
|
||||
- 「[リポジトリの依存関係を調べる](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository)」
|
||||
- 「[{% data variables.product.prodname_dependabot_alerts %} の表示と更新](/code-security/dependabot/dependabot-alerts/viewing-and-updating-dependabot-alerts)」
|
||||
- [脆弱性のある依存関係の検出のトラブルシューティング](/github/managing-security-vulnerabilities/troubleshooting-the-detection-of-vulnerable-dependencies)
|
||||
- "[Dependency graph](https://en.wikipedia.org/wiki/Dependency_graph)" on Wikipedia
|
||||
- "[Exploring the dependencies of a repository](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository)"
|
||||
- "[Viewing and updating {% data variables.product.prodname_dependabot_alerts %}](/code-security/dependabot/dependabot-alerts/viewing-and-updating-dependabot-alerts)"
|
||||
- "[Troubleshooting the detection of vulnerable dependencies](/github/managing-security-vulnerabilities/troubleshooting-the-detection-of-vulnerable-dependencies)"
|
||||
|
||||
@@ -69,6 +69,8 @@ You can create a codespace for a particular task and then safely delete the code
|
||||
|
||||
If you try to delete a codespace with unpushed git commits, your editor will notify you that you have changes that have not been pushed to a remote branch. You can push any desired changes and then delete your codespace, or continue to delete your codespace and any uncommitted changes. You can also export your code to a new branch without creating a new codespace. For more information, see "[Exporting changes to a branch](/codespaces/troubleshooting/exporting-changes-to-a-branch)."
|
||||
|
||||
Codespaces that have been stopped and remain inactive for a specified period of time will be deleted automatically. By default, inactive codespaces are deleted after 30 days, but you can customize your codespace retention period. For more information, see "[Configuring automatic deletion of your codespaces](/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces)."
|
||||
|
||||
You will be charged for the storage of all your codespaces. When you delete a codespace, you will no longer be charged.
|
||||
|
||||
For more information on deleting a codespace, see "[Deleting a codespace](/codespaces/developing-in-codespaces/deleting-a-codespace)."
|
||||
|
||||
@@ -123,4 +123,5 @@ For more information, click the "{% data variables.product.prodname_cli %}" tab
|
||||
You can also use the REST API to delete codespaces for your organization. For more information, see "[Codespaces organizations](/rest/codespaces/organizations#delete-a-codespace-from-the-organization)."
|
||||
|
||||
## Further reading
|
||||
- "[Codespaces lifecycle](/codespaces/developing-in-codespaces/codespaces-lifecycle)"
|
||||
- "[Codespaces lifecycle](/codespaces/developing-in-codespaces/codespaces-lifecycle)"
|
||||
- "[Configuring automatic deletion of your codespaces](/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces)"
|
||||
@@ -1,7 +1,7 @@
|
||||
---
|
||||
title: デフォルトブランチを変更する
|
||||
intro: リポジトリに複数のブランチがある場合、任意のブランチをデフォルトブランチとして設定できます。
|
||||
permissions: People with admin permissions to a repository can change the default branch for the repository.
|
||||
permissions: People with admin access for a repository can change the default branch for the repository.
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
|
||||
@@ -3,6 +3,7 @@ title: 外部グループ
|
||||
intro: 外部グループ API を使うと、Organization で利用できる外部 ID プロバイダー グループを表示し、外部グループと Organization 内のチームの間の接続を管理できます。
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '>=3.6'
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
|
||||
@@ -292,6 +292,7 @@ translations/ja-JP/content/code-security/dependabot/dependabot-security-updates/
|
||||
translations/ja-JP/content/code-security/dependabot/working-with-dependabot/troubleshooting-dependabot-errors.md,broken liquid tags
|
||||
translations/ja-JP/content/code-security/getting-started/securing-your-organization.md,broken liquid tags
|
||||
translations/ja-JP/content/code-security/secret-scanning/managing-alerts-from-secret-scanning.md,broken liquid tags
|
||||
translations/ja-JP/content/code-security/supply-chain-security/understanding-your-software-supply-chain/about-the-dependency-graph.md,broken liquid tags
|
||||
translations/ja-JP/content/codespaces/codespaces-reference/using-github-copilot-in-github-codespaces.md,broken liquid tags
|
||||
translations/ja-JP/content/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces.md,broken liquid tags
|
||||
translations/ja-JP/content/codespaces/developing-in-codespaces/codespaces-lifecycle.md,broken liquid tags
|
||||
|
||||
|
@@ -305,10 +305,10 @@ translations/pt-BR/content/code-security/dependabot/dependabot-version-updates/c
|
||||
translations/pt-BR/content/code-security/secret-scanning/managing-alerts-from-secret-scanning.md,broken liquid tags
|
||||
translations/pt-BR/content/code-security/secret-scanning/protecting-pushes-with-secret-scanning.md,broken liquid tags
|
||||
translations/pt-BR/content/code-security/secret-scanning/pushing-a-branch-blocked-by-push-protection.md,broken liquid tags
|
||||
translations/pt-BR/content/code-security/supply-chain-security/understanding-your-software-supply-chain/about-the-dependency-graph.md,broken liquid tags
|
||||
translations/pt-BR/content/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry.md,broken liquid tags
|
||||
translations/pt-BR/content/codespaces/codespaces-reference/using-github-copilot-in-github-codespaces.md,broken liquid tags
|
||||
translations/pt-BR/content/codespaces/codespaces-reference/using-the-vs-code-command-palette-in-codespaces.md,broken liquid tags
|
||||
translations/pt-BR/content/codespaces/customizing-your-codespace/personalizing-github-codespaces-for-your-account.md,broken liquid tags
|
||||
translations/pt-BR/content/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces.md,broken liquid tags
|
||||
translations/pt-BR/content/codespaces/developing-in-codespaces/codespaces-lifecycle.md,broken liquid tags
|
||||
translations/pt-BR/content/codespaces/developing-in-codespaces/creating-a-codespace.md,broken liquid tags
|
||||
|
||||
|
@@ -10,12 +10,12 @@ versions:
|
||||
type: tutorial
|
||||
topics:
|
||||
- Security
|
||||
ms.openlocfilehash: 5ac1a902bb9ef397fa6fa157ea58496d57ffd231
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: 6b57dc216c3f2ebc1edb73a8d588edb1967aebcb
|
||||
ms.sourcegitcommit: ac00e2afa6160341c5b258d73539869720b395a4
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: pt-BR
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '146171850'
|
||||
ms.lasthandoff: 09/09/2022
|
||||
ms.locfileid: '147875491'
|
||||
---
|
||||
{% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %}
|
||||
|
||||
@@ -42,7 +42,7 @@ Para adicionar o provedor OIDC do {% data variables.product.prodname_dotcom %} a
|
||||
|
||||
Para configurar a função e a relação de confiança no IAM, confira ["Como assumir uma função"](https://github.com/aws-actions/configure-aws-credentials#assuming-a-role) e ["Como criar uma função para identidade da Web ou federação do OpenID Connect"](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-idp_oidc.html) na documentação da AWS.
|
||||
|
||||
Edite o relacionamento de confiança para adicionar o campo `sub` às condições de validação. Por exemplo:
|
||||
Edite a política de confiança para adicionar o campo `sub` às condições de validação. Por exemplo:
|
||||
|
||||
```json{:copy}
|
||||
"Condition": {
|
||||
@@ -53,6 +53,33 @@ Edite o relacionamento de confiança para adicionar o campo `sub` às condiçõe
|
||||
}
|
||||
```
|
||||
|
||||
No seguinte exemplo, `ForAllValues` é usado para corresponder a várias chaves de condição e `StringLike` é usado para corresponder a qualquer referência no repositório especificado. Observe que `ForAllValues` tem uma [permissividade excessiva](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_multi-value-conditions.html) e não deve ser usado sozinho para efeitos de `Allow`. Para este exemplo, a inclusão de `StringLike` significa que um conjunto vazio `ForAllValues` ainda não será aprovado pela condição:
|
||||
|
||||
```json{:copy}
|
||||
{
|
||||
"Version": "2012-10-17",
|
||||
"Statement": [
|
||||
{
|
||||
"Effect": "Allow",
|
||||
"Principal": {
|
||||
"Federated": "arn:aws:iam::123456123456:oidc-provider/token.actions.githubusercontent.com"
|
||||
},
|
||||
"Action": "sts:AssumeRoleWithWebIdentity",
|
||||
"Condition": {
|
||||
"StringLike": {
|
||||
"token.actions.githubusercontent.com:sub": "repo:octo-org/octo-repo:*"
|
||||
},
|
||||
"ForAllValues:StringEquals": {
|
||||
"token.actions.githubusercontent.com:iss": "https://token.actions.githubusercontent.com",
|
||||
"token.actions.githubusercontent.com:aud": "sts.amazonaws.com"
|
||||
}
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
## Atualizar o seu fluxo de trabalho de {% data variables.product.prodname_actions %}
|
||||
|
||||
Para atualizar seus fluxos de trabalho para o OIDC, você deverá fazer duas alterações no seu YAML:
|
||||
@@ -82,7 +109,7 @@ env:
|
||||
AWS_REGION : "<example-aws-region>"
|
||||
# permission can be added at job level or workflow level
|
||||
permissions:
|
||||
id-token: write
|
||||
id-token: write # This is required for requesting the JWT
|
||||
contents: read # This is required for actions/checkout
|
||||
jobs:
|
||||
S3PackageUpload:
|
||||
|
||||
@@ -25,7 +25,13 @@ Rather than copying and pasting from one workflow to another, you can make workf
|
||||
|
||||
Reusing workflows avoids duplication. This makes workflows easier to maintain and allows you to create new workflows more quickly by building on the work of others, just as you do with actions. Workflow reuse also promotes best practice by helping you to use workflows that are well designed, have already been tested, and have been proven to be effective. Your organization can build up a library of reusable workflows that can be centrally maintained.
|
||||
|
||||
The diagram below shows three build jobs on the left of the diagram. After each of these jobs completes successfully a dependent job called "Deploy" runs. This job calls a reusable workflow that contains three jobs: "Staging", "Review", and "Production." The "Production" deployment job only runs after the "Staging" job has completed successfully. Using a reusable workflow to run deployment jobs allows you to run those jobs for each build without duplicating code in workflows.
|
||||
The diagram below shows an in-progress workflow run that uses a reusable workflow.
|
||||
|
||||
* After each of three build jobs on the left of the diagram completes successfully, a dependent job called "Deploy" is run.
|
||||
* The "Deploy" job calls a reusable workflow that contains three jobs: "Staging", "Review", and "Production."
|
||||
* The "Production" deployment job only runs after the "Staging" job has completed successfully.
|
||||
* When a job targets an environment, the workflow run displays a progress bar that shows the number of steps in the job. In the diagram below, the "Production" job contains 8 steps, with step 6 currently being processed.
|
||||
* Using a reusable workflow to run deployment jobs allows you to run those jobs for each build without duplicating code in workflows.
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Sobre o gráfico de dependências
|
||||
intro: Você pode usar o gráfico de dependências para identificar todas as dependências do seu projeto. O gráfico de dependências é compatível com uma série de ecossistemas de pacotes populares.
|
||||
title: About the dependency graph
|
||||
intro: You can use the dependency graph to identify all your project's dependencies. The dependency graph supports a range of popular package ecosystems.
|
||||
redirect_from:
|
||||
- /github/visualizing-repository-data-with-graphs/about-the-dependency-graph
|
||||
- /code-security/supply-chain-security/about-the-dependency-graph
|
||||
@@ -15,85 +15,101 @@ topics:
|
||||
- Dependencies
|
||||
- Repositories
|
||||
shortTitle: Dependency graph
|
||||
ms.openlocfilehash: bb8e802210da132d51e4c926ac9085a6790ba683
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: pt-BR
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147578623'
|
||||
---
|
||||
<!--For this article in earlier GHES versions, see /content/github/visualizing-repository-data-with-graphs-->
|
||||
<!--Marketing-LINK: From /features/security and /features/security/software-supply-chain pages "How GitHub's dependency graph is generated".-->
|
||||
|
||||
## Sobre o gráfico de dependências
|
||||
## About the dependency graph
|
||||
|
||||
{% data reusables.dependabot.about-the-dependency-graph %}
|
||||
|
||||
Quando você efetua push de um commit para o {% data variables.product.product_name %} que altera ou adiciona um arquivo de manifesto ou de bloqueio compatível para o branch padrão, o grafo de dependência é atualizado automaticamente.{% ifversion fpt or ghec %} Além disso, o grafo é atualizado quando alguém efetua push de uma alteração no repositório de uma das suas dependências.{% endif %} Para obter informações sobre os ecossistemas compatíveis e os arquivos de manifesto, confira "[Ecossistemas de pacotes compatíveis](#supported-package-ecosystems)" abaixo.
|
||||
When you push a commit to {% data variables.product.product_name %} that changes or adds a supported manifest or lock file to the default branch, the dependency graph is automatically updated.{% ifversion fpt or ghec %} In addition, the graph is updated when anyone pushes a change to the repository of one of your dependencies.{% endif %} For information on the supported ecosystems and manifest files, see "[Supported package ecosystems](#supported-package-ecosystems)" below.
|
||||
|
||||
{% ifversion dependency-submission-api %} {% data reusables.dependency-submission.dependency-submission-link %} {% endif %}
|
||||
{% ifversion dependency-submission-api %}
|
||||
{% data reusables.dependency-submission.dependency-submission-link %}
|
||||
{% endif %}
|
||||
|
||||
Ao criar um pull request que contém alterações para dependências direcionadas ao branch padrão, {% data variables.product.prodname_dotcom %} usará o gráfico de dependências para adicionar revisões de dependências ao pull request. Eles indicam se as dependências contêm vulnerabilidades e, em caso afirmativo, a versão da dependência na qual a vulnerabilidade foi corrigida. Para obter mais informações, confira "[Sobre a revisão de dependência](/code-security/supply-chain-security/about-dependency-review)".
|
||||
When you create a pull request containing changes to dependencies that targets the default branch, {% data variables.product.prodname_dotcom %} uses the dependency graph to add dependency reviews to the pull request. These indicate whether the dependencies contain vulnerabilities and, if so, the version of the dependency in which the vulnerability was fixed. For more information, see "[About dependency review](/code-security/supply-chain-security/about-dependency-review)."
|
||||
|
||||
## Disponibilidade do gráfico de dependências
|
||||
## Dependency graph availability
|
||||
|
||||
{% ifversion fpt or ghec %}O grafo de dependência está disponível para todos os repositórios públicos que definem dependências em um ecossistema de pacotes compatível usando um formato de arquivo compatível. Os administradores de repositórios também podem configurar o gráfico de dependências para repositórios privados. Para obter mais informações, confira "[Configurar o grafo de dependência](/code-security/supply-chain-security/understanding-your-software-supply-chain/configuring-the-dependency-graph)”.{% endif %}
|
||||
{% ifversion fpt or ghec %}The dependency graph is available for every public repository that defines dependencies in a supported package ecosystem using a supported file format. Repository administrators can also set up the dependency graph for private repositories. For more information, see "[Configuring the dependency graph](/code-security/supply-chain-security/understanding-your-software-supply-chain/configuring-the-dependency-graph)."{% endif %}
|
||||
|
||||
{% data reusables.dependabot.dependabot-alerts-dependency-graph-enterprise %}
|
||||
|
||||
## Dependências incluídas
|
||||
## Dependencies included
|
||||
|
||||
O grafo de dependência inclui todas as dependências de um repositório detalhadas nos arquivos de manifesto e de bloqueio, ou um equivalente, para ecossistemas com suporte{% ifversion dependency-submission-api %}, bem como todas as dependências enviadas usando a API Envio de dependência (beta){% endif %}. Isso inclui:
|
||||
The dependency graph includes all the dependencies of a repository that are detailed in the manifest and lock files, or their equivalent, for supported ecosystems{% ifversion dependency-submission-api %}, as well as any dependencies that are submitted using the Dependency submission API (beta){% endif %}. This includes:
|
||||
|
||||
- As dependências diretas, que são definidas explicitamente em um arquivo de manifesto ou de bloqueio {% ifversion dependency-submission-api %} ou que foram enviadas usando a API Envio de dependência (beta){% endif %}
|
||||
- Dependências indiretas dessas dependências diretas, também conhecidas como dependências transitórias ou subdependências
|
||||
- Direct dependencies, that are explicitly defined in a manifest or lock file {% ifversion dependency-submission-api %} or have been submitted using the Dependency submission API (beta){% endif %}
|
||||
- Indirect dependencies of these direct dependencies, also known as transitive dependencies or sub-dependencies
|
||||
|
||||
O grafo de dependência identifica as dependências indiretas{% ifversion fpt or ghec %} explicitamente por meio de um arquivo de bloqueio ou verificando as dependências das dependências diretas. Para o gráfico mais confiável, você deve usar os arquivos de bloqueio (ou o equivalente deles), pois definem exatamente quais versões das dependências diretas e indiretas você usa atualmente. Se você usar arquivos de bloqueio, você também terá certeza de que todos os contribuidores do repositório usarão as mesmas versões, o que facilitará para você testar e depurar o código{% else %} dos arquivos de bloqueio{% endif %}.
|
||||
The dependency graph identifies indirect dependencies{% ifversion fpt or ghec %} either explicitly from a lock file or by checking the dependencies of your direct dependencies. For the most reliable graph, you should use lock files (or their equivalent) because they define exactly which versions of the direct and indirect dependencies you currently use. If you use lock files, you also ensure that all contributors to the repository are using the same versions, which will make it easier for you to test and debug code{% else %} from the lock files{% endif %}.
|
||||
|
||||
Para saber mais sobre como {% data variables.product.product_name %} ajuda você a entender as dependências em seu ambiente, confira "[Sobre a segurança da cadeia de suprimentos](/code-security/supply-chain-security/understanding-your-software-supply-chain/about-supply-chain-security)".
|
||||
For more information on how {% data variables.product.product_name %} helps you understand the dependencies in your environment, see "[About supply chain security](/code-security/supply-chain-security/understanding-your-software-supply-chain/about-supply-chain-security)."
|
||||
|
||||
{% ifversion fpt or ghec %}
|
||||
|
||||
## Dependentes incluídos
|
||||
## Dependents included
|
||||
|
||||
Para repositórios públicos, apenas repositórios públicos que dependem dele ou de pacotes que publica são relatados. Essas informações não foram relatadas para repositórios privados.{% endif %}
|
||||
For public repositories, only public repositories that depend on it or on packages that it publishes are reported. This information is not reported for private repositories.{% endif %}
|
||||
|
||||
## Usar o gráfico de dependências
|
||||
## Using the dependency graph
|
||||
|
||||
Você pode usar o gráfico de dependências para:
|
||||
You can use the dependency graph to:
|
||||
|
||||
- Explore os repositórios dos quais o seu código depende{% ifversion fpt or ghec %} e aqueles que dependem dele{% endif %}. Para obter mais informações, confira "[Como explorar as dependências de um repositório](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository)". {% ifversion ghec %}
|
||||
- Visualizar um resumo das dependências usadas nos repositórios da sua organização em um único painel. Para obter mais informações, confira "[Como ver os insights da sua organização](/articles/viewing-insights-for-your-organization#viewing-organization-dependency-insights)".{% endif %}
|
||||
- Ver e atualizar dependências vulneráveis no seu repositório. Para obter mais informações, confira "[Sobre {% data variables.product.prodname_dependabot_alerts %}](/code-security/supply-chain-security/about-alerts-for-vulnerable-dependencies)".{% ifversion fpt or ghes or ghec %}
|
||||
- Veja as informações sobre dependências vulneráveis em pull requests. Para obter mais informações, confira "[Como revisar as alterações de dependência em uma solicitação de pull](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-dependency-changes-in-a-pull-request)".{% endif %}
|
||||
- Explore the repositories your code depends on{% ifversion fpt or ghec %}, and those that depend on it{% endif %}. For more information, see "[Exploring the dependencies of a repository](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository)." {% ifversion ghec %}
|
||||
- View a summary of the dependencies used in your organization's repositories in a single dashboard. For more information, see "[Viewing insights for your organization](/articles/viewing-insights-for-your-organization#viewing-organization-dependency-insights)."{% endif %}
|
||||
- View and update vulnerable dependencies for your repository. For more information, see "[About {% data variables.product.prodname_dependabot_alerts %}](/code-security/supply-chain-security/about-alerts-for-vulnerable-dependencies)."{% ifversion fpt or ghes or ghec %}
|
||||
- See information about vulnerable dependencies in pull requests. For more information, see "[Reviewing dependency changes in a pull request](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-dependency-changes-in-a-pull-request)."{% endif %}
|
||||
|
||||
## Ecossistemas de pacote compatíveis
|
||||
## Supported package ecosystems
|
||||
|
||||
Os formatos recomendados definem explicitamente quais versões são usadas para todas as dependências diretas e indiretas. Se você usar esses formatos, o grafo de dependência será mais preciso. Ele também reflete a configuração de build atual e permite que o grafo de dependência relate as vulnerabilidades em dependências diretas e indiretas.{% ifversion fpt or ghec %} As dependências indiretas que são inferidas por meio de um arquivo de manifesto (ou um equivalente), são excluídas das verificações de dependências não seguras.{% endif %}
|
||||
The recommended formats explicitly define which versions are used for all direct and all indirect dependencies. If you use these formats, your dependency graph is more accurate. It also reflects the current build set up and enables the dependency graph to report vulnerabilities in both direct and indirect dependencies.{% ifversion fpt or ghec %} Indirect dependencies that are inferred from a manifest file (or equivalent) are excluded from the checks for insecure dependencies.{% endif %}
|
||||
|
||||
| Gerenciador de pacotes | Idiomas | Formatos recomendados | Todos os formatos com suporte |
|
||||
| Package manager | Languages | Recommended formats | All supported formats |
|
||||
| --- | --- | --- | ---|
|
||||
{%- ifversion dependency-graph-rust-support %} | Cargo{% ifversion ghes = 3.6 or ghae-issue-7563 %}<sup>[*]</sup>{% endif %} | Rust | `Cargo.lock` | `Cargo.toml`, `Cargo.lock` | {%- endif %} | Composer | PHP | `composer.lock` | `composer.json`, `composer.lock` | | NuGet | Linguagens .NET (C#, F#, VB), C++ | `.csproj`, `.vbproj`, `.nuspec`, `.vcxproj`, `.fsproj` | `.csproj`, `.vbproj`, `.nuspec`, `.vcxproj`, `.fsproj`, `packages.config` | {%- ifversion github-actions-in-dependency-graph %} | Fluxos de trabalho do {% data variables.product.prodname_actions %}<sup>[†]</sup> | YAML | `.yml`, `.yaml` | `.yml`, `.yaml` | {%- endif %} {%- ifversion fpt or ghec or ghes > 3.2 or ghae %} | Módulos Go | Go | `go.sum` | `go.mod`, `go.sum` | {%- elsif ghes = 3.2 %} | Módulos Go | Go | `go.mod` | `go.mod` | {%- endif %} | Maven | Java, Scala | `pom.xml` | `pom.xml` | | npm | JavaScript | `package-lock.json` | `package-lock.json`, `package.json`| | pip | Python | `requirements.txt`, `pipfile.lock` | `requirements.txt`, `pipfile`, `pipfile.lock`, `setup.py`<sup>[‡]</sup> | {%- ifversion fpt or ghec or ghes > 3.3 or ghae-issue-4752 %} | Python Poetry | Python | `poetry.lock` | `poetry.lock`, `pyproject.toml` | {%- endif %} | RubyGems | Ruby | `Gemfile.lock` | `Gemfile.lock`, `Gemfile`, `*.gemspec` | | Yarn | JavaScript | `yarn.lock` | `package.json`, `yarn.lock` |
|
||||
{%- ifversion dependency-graph-rust-support %}
|
||||
| Cargo | Rust | `Cargo.lock` | `Cargo.toml`, `Cargo.lock` |
|
||||
{%- endif %}
|
||||
| Composer | PHP | `composer.lock` | `composer.json`, `composer.lock` |
|
||||
| NuGet | .NET languages (C#, F#, VB), C++ | `.csproj`, `.vbproj`, `.nuspec`, `.vcxproj`, `.fsproj` | `.csproj`, `.vbproj`, `.nuspec`, `.vcxproj`, `.fsproj`, `packages.config` |
|
||||
{%- ifversion github-actions-in-dependency-graph %}
|
||||
| {% data variables.product.prodname_actions %} workflows<sup>[†]</sup> | YAML | `.yml`, `.yaml` | `.yml`, `.yaml` |
|
||||
{%- endif %}
|
||||
{%- ifversion fpt or ghec or ghes > 3.2 or ghae %}
|
||||
| Go modules | Go | `go.sum` | `go.mod`, `go.sum` |
|
||||
{%- elsif ghes = 3.2 %}
|
||||
| Go modules | Go | `go.mod` | `go.mod` |
|
||||
{%- endif %}
|
||||
| Maven | Java, Scala | `pom.xml` | `pom.xml` |
|
||||
| npm | JavaScript | `package-lock.json` | `package-lock.json`, `package.json`|
|
||||
| pip | Python | `requirements.txt`, `pipfile.lock` | `requirements.txt`, `pipfile`, `pipfile.lock`, `setup.py`<sup>[‡]</sup> |
|
||||
{%- ifversion fpt or ghec or ghes > 3.3 or ghae-issue-4752 %}
|
||||
| Python Poetry | Python | `poetry.lock` | `poetry.lock`, `pyproject.toml` |
|
||||
{%- endif %}
|
||||
| RubyGems | Ruby | `Gemfile.lock` | `Gemfile.lock`, `Gemfile`, `*.gemspec` |
|
||||
| Yarn | JavaScript | `yarn.lock` | `package.json`, `yarn.lock` |
|
||||
|
||||
{% ifversion ghes = 3.6 or ghae-issue-7563 %} [*] No caso da versão inicial do suporte ao Rust, o gráfico de dependência não conta com os metadados e os mapeamentos necessários para detectar dependências transitivas. O grafo de dependência exibe as dependências transitivas, com um nível de profundidade, quando elas são definidas em um arquivo `Cargo.lock`. {% data variables.product.prodname_dependabot_alerts %} e {% data variables.product.prodname_dependabot_security_updates %} estão disponíveis para as dependências vulneráveis definidas no arquivo `Cargo.lock`.
|
||||
{% endif %}
|
||||
|
||||
{% ifversion github-actions-in-dependency-graph %} [†] Os fluxos de trabalho do {% data reusables.enterprise.3-5-missing-feature %} {% data variables.product.prodname_actions %} devem estar localizados no diretório `.github/workflows/` de um repositório para serem reconhecidos como manifestos. As ações ou os fluxos de trabalho referenciados com a sintaxe `jobs[*].steps[*].uses` ou `jobs.<job_id>.uses` serão analisados como dependências. Para obter mais informações, confira "[Sintaxe de fluxo de trabalho do {% data variables.product.prodname_actions %}](/actions/using-workflows/workflow-syntax-for-github-actions)".
|
||||
{% ifversion github-actions-in-dependency-graph %}
|
||||
[†] {% data reusables.enterprise.3-5-missing-feature %} {% data variables.product.prodname_actions %} workflows must be located in the `.github/workflows/` directory of a repository to be recognized as manifests. Any actions or workflows referenced using the syntax `jobs[*].steps[*].uses` or `jobs.<job_id>.uses` will be parsed as dependencies. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/using-workflows/workflow-syntax-for-github-actions)."
|
||||
|
||||
{% endif %}
|
||||
|
||||
[‡] Se você listar as dependências Python em um arquivo `setup.py`, talvez não será possível analisar nem listar todas as dependências do projeto.
|
||||
[‡] If you list your Python dependencies within a `setup.py` file, we may not be able to parse and list every dependency in your project.
|
||||
|
||||
{% ifversion github-actions-in-dependency-graph %} {% note %}
|
||||
{% ifversion github-actions-in-dependency-graph %}
|
||||
{% note %}
|
||||
|
||||
**Observação:** as dependências do fluxo de trabalho do {% data variables.product.prodname_actions %} são exibidas no grafo de dependência para fins informativos. Os alertas de dependência não são atualmente compatíveis com os fluxos de trabalho de {% data variables.product.prodname_actions %}.
|
||||
**Note:** {% data variables.product.prodname_actions %} workflow dependencies are displayed in the dependency graph for informational purposes. Dependabot alerts are not currently supported for {% data variables.product.prodname_actions %} workflows.
|
||||
|
||||
{% endnote %} {% endif %}
|
||||
{% endnote %}
|
||||
{% endif %}
|
||||
|
||||
{% ifversion dependency-submission-api %}Você pode usar a API Envio de dependência (beta) para adicionar dependências do gerenciador de pacotes ou do ecossistema de sua escolha ao grafo de dependência, mesmo que o ecossistema não esteja na lista de ecossistemas com suporte acima. O grafo de dependência exibirá as dependências enviadas agrupadas por ecossistema, mas separadamente das dependências analisadas dos arquivos de manifesto ou de bloqueio. Você só obterá {% data variables.product.prodname_dependabot_alerts %} das dependências de um dos [ecossistemas com suporte](https://github.com/github/advisory-database#supported-ecosystems) do {% data variables.product.prodname_advisory_database %}. Para obter mais informações sobre a API Envio de dependência, confira "[Como usar a API Envio de dependência](/code-security/supply-chain-security/understanding-your-software-supply-chain/using-the-dependency-submission-api)".{% endif %}
|
||||
## Leitura adicional
|
||||
{% ifversion dependency-submission-api %}You can use the Dependency submission API (beta) to add dependencies from the package manager or ecosystem of your choice to the dependency graph, even if the ecosystem is not in the supported ecosystem list above. The dependency graph will display the submitted dependencies grouped by ecosystem, but separately from the dependencies parsed from manifest or lock files. You will only get {% data variables.product.prodname_dependabot_alerts %} for dependencies that are from one of the [supported ecosystems](https://github.com/github/advisory-database#supported-ecosystems) of the {% data variables.product.prodname_advisory_database %}. For more information on the Dependency submission API, see "[Using the Dependency submission API](/code-security/supply-chain-security/understanding-your-software-supply-chain/using-the-dependency-submission-api)."{% endif %}
|
||||
## Further reading
|
||||
|
||||
- "[Grafo de dependência](https://en.wikipedia.org/wiki/Dependency_graph)" na Wikipédia
|
||||
- "[Como explorar as dependências de um repositório](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository)"
|
||||
- "[Como ver e atualizar {% data variables.product.prodname_dependabot_alerts %}](/code-security/dependabot/dependabot-alerts/viewing-and-updating-dependabot-alerts)"
|
||||
- "[Solução de problemas de detecção de dependências vulneráveis](/github/managing-security-vulnerabilities/troubleshooting-the-detection-of-vulnerable-dependencies)"
|
||||
- "[Dependency graph](https://en.wikipedia.org/wiki/Dependency_graph)" on Wikipedia
|
||||
- "[Exploring the dependencies of a repository](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository)"
|
||||
- "[Viewing and updating {% data variables.product.prodname_dependabot_alerts %}](/code-security/dependabot/dependabot-alerts/viewing-and-updating-dependabot-alerts)"
|
||||
- "[Troubleshooting the detection of vulnerable dependencies](/github/managing-security-vulnerabilities/troubleshooting-the-detection-of-vulnerable-dependencies)"
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
---
|
||||
title: Personalizing GitHub Codespaces for your account
|
||||
title: Como personalizar o GitHub Codespaces para sua conta
|
||||
shortTitle: Personalize your codespaces
|
||||
intro: 'You can personalize {% data variables.product.prodname_github_codespaces %} by using a `dotfiles` repository on {% data variables.product.product_name %} or by using Settings Sync.'
|
||||
intro: 'Você pode personalizar o {% data variables.product.prodname_github_codespaces %} usando um repositório `dotfiles` em {% data variables.product.product_name %} ou usando Sincronização de Configurações.'
|
||||
redirect_from:
|
||||
- /github/developing-online-with-github-codespaces/personalizing-github-codespaces-for-your-account
|
||||
- /github/developing-online-with-codespaces/personalizing-codespaces-for-your-account
|
||||
@@ -16,39 +16,43 @@ topics:
|
||||
- Set up
|
||||
- Fundamentals
|
||||
product: '{% data reusables.gated-features.codespaces %}'
|
||||
ms.openlocfilehash: 1aec1fc1fdc3d7e49408d3ddfcf94805994c8633
|
||||
ms.sourcegitcommit: 72e1c60459a610944184ca00e3ae60bf1f5fc6db
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: pt-BR
|
||||
ms.lasthandoff: 09/09/2022
|
||||
ms.locfileid: '147875530'
|
||||
---
|
||||
## Sobre a personalização de {% data variables.product.prodname_codespaces %}
|
||||
|
||||
Ao usar qualquer ambiente de desenvolvimento, a personalização das configurações e ferramentas para suas preferências e fluxos de trabalho é uma etapa importante. {% data variables.product.prodname_codespaces %} permite duas formas principais de personalizar seus codespaces.
|
||||
|
||||
## About personalizing {% data variables.product.prodname_codespaces %}
|
||||
- [Configurações de sincronização](#settings-sync) – você pode usar e compartilhar as configurações {% data variables.product.prodname_vscode %} entre {% data variables.product.prodname_codespaces %} e outras instâncias de {% data variables.product.prodname_vscode %}.
|
||||
- [Dotfiles](#dotfiles) – você pode usar um `dotfiles` repositório para especificar scripts, preferências de shell e outras configurações.
|
||||
|
||||
When using any development environment, customizing the settings and tools to your preferences and workflows is an important step. {% data variables.product.prodname_codespaces %} allows for two main ways of personalizing your codespaces.
|
||||
A personalização de {% data variables.product.prodname_codespaces %} aplica-se a qualquer codespace que você criar.
|
||||
|
||||
- [Settings Sync](#settings-sync) - You can use and share {% data variables.product.prodname_vscode %} settings between {% data variables.product.prodname_codespaces %} and other instances of {% data variables.product.prodname_vscode %}.
|
||||
- [Dotfiles](#dotfiles) – You can use a `dotfiles` repository to specify scripts, shell preferences, and other configurations.
|
||||
Os mantenedores do projeto também podem definir uma configuração-padrão que se aplica a todos os codespaces de um repositório, criados por qualquer pessoa. Para obter mais informações, confira "[Como configurar o {% data variables.product.prodname_codespaces %} para seu projeto](/github/developing-online-with-codespaces/configuring-codespaces-for-your-project)".
|
||||
|
||||
{% data variables.product.prodname_codespaces %} personalization applies to any codespace you create.
|
||||
## Configurações de sincronização
|
||||
|
||||
Project maintainers can also define a default configuration that applies to every codespace for a repository, created by anyone. For more information, see "[Configuring {% data variables.product.prodname_codespaces %} for your project](/github/developing-online-with-codespaces/configuring-codespaces-for-your-project)."
|
||||
A sincronização de configurações permite que você compartilhe configurações como configurações, atalhos de teclado, snippets, extensões e estado da interface de usuário entre as máquinas e instâncias de {% data variables.product.prodname_vscode %}.
|
||||
|
||||
## Settings Sync
|
||||
Para habilitar a sincronização de configurações, no canto inferior esquerdo da barra de atividades, selecione {% octicon "gear" aria-label="The gear icon" %} e clique **Habilitar as configurações de sincronização…** . Na caixa de diálogo, selecione as configurações que você deseja sincronizar.
|
||||
|
||||
Settings Sync allows you to share configurations such as settings, keyboard shortcuts, snippets, extensions, and UI state across machines and instances of {% data variables.product.prodname_vscode %}.
|
||||
|
||||
|
||||
To enable Settings Sync, in the bottom-left corner of the Activity Bar, select {% octicon "gear" aria-label="The gear icon" %} and click **Turn on Settings Sync…**. In the dialog box, select the settings you'd like to sync.
|
||||
|
||||
|
||||
|
||||
For more information, see the [Settings Sync guide](https://code.visualstudio.com/docs/editor/settings-sync) in the {% data variables.product.prodname_vscode %} documentation.
|
||||
Para obter mais informações, confira o [guia Sincronização de Configurações](https://code.visualstudio.com/docs/editor/settings-sync) na documentação do {% data variables.product.prodname_vscode %}.
|
||||
|
||||
## Dotfiles
|
||||
|
||||
Dotfiles are files and folders on Unix-like systems starting with `.` that control the configuration of applications and shells on your system. You can store and manage your dotfiles in a repository on {% data variables.product.prodname_dotcom %}. For advice and tutorials about what to include in your dotfiles repository, see [GitHub does dotfiles](https://dotfiles.github.io/).
|
||||
Os Dotfiles são arquivos e pastas de sistemas de tipo Unix, que começam com `.` e controlam a configuração de aplicativos e shells no seu sistema. Você pode armazenar e gerenciar seus dotfiles em um repositório no {% data variables.product.prodname_dotcom %}. Para orientação e tutoriais sobre o que incluir no repositório dotfile, confira [GitHub faz dotfiles](https://dotfiles.github.io/).
|
||||
|
||||
Your dotfiles repository might include your shell aliases and preferences, any tools you want to install, or any other codespace personalization you want to make.
|
||||
O seu repositório dotfiles pode incluir os alias e preferências do seu shell, quaisquer ferramentas que você deseja instalar ou qualquer outra personalização de codespace que desejar fazer.
|
||||
|
||||
You can configure {% data variables.product.prodname_codespaces %} to use dotfiles from any repository you own by selecting that repository in your [personal {% data variables.product.prodname_codespaces %} settings](https://github.com/settings/codespaces).
|
||||
Você pode configurar {% data variables.product.prodname_codespaces %} para usar Dotfiles de qualquer repositório que você tiver, selecionando esse repositório nas suas [Configurações pessoais de {% data variables.product.prodname_codespaces %}](https://github.com/settings/codespaces).
|
||||
|
||||
When you create a new codespace, {% data variables.product.prodname_dotcom %} clones your selected dotfiles repository to the codespace environment, and looks for one of the following files to set up the environment.
|
||||
Ao criar um novo codespace, o {% data variables.product.prodname_dotcom %} clona seu repositório dotfile selecionado para o ambiente do codespace e procura um dos seguintes arquivos para configurar o ambiente.
|
||||
|
||||
* _install.sh_
|
||||
* _install_
|
||||
@@ -59,45 +63,44 @@ When you create a new codespace, {% data variables.product.prodname_dotcom %} cl
|
||||
* _setup_
|
||||
* _script/setup_
|
||||
|
||||
If none of these files are found, then any files or folders in your selected dotfiles repository starting with `.` are symlinked to the codespace's `~` or `$HOME` directory.
|
||||
Se nenhum desses arquivos for encontrado, todos os arquivos ou pastas no repositório de dotfiles selecionados que começam com `.` têm um link simbólico para o `~` do codespace ou `$HOME`.
|
||||
|
||||
Any changes to your selected dotfiles repository will apply only to each new codespace, and do not affect any existing codespace.
|
||||
Quaisquer alterações nos seus dotfiles selecionados serão aplicadas apenas a cada novo codespace e não afetarão nenhum codespace existente.
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** Currently, {% data variables.product.prodname_codespaces %} does not support personalizing the _User_ settings for the {% data variables.product.prodname_vscode %} editor with your `dotfiles` repository. You can set default _Workspace_ and _Remote [Codespaces]_ settings for a specific project in the project's repository. For more information, see "[Introduction to dev containers](/github/developing-online-with-codespaces/configuring-codespaces-for-your-project#creating-a-custom-dev-container-configuration)."
|
||||
**Observação:** Atualmente, o {% data variables.product.prodname_codespaces %} não é compatível com a personalização das configurações do _Usuário_ para o editor de {% data variables.product.prodname_vscode %} com o repositório `dotfiles`. Você pode definir as configurações padrão do _Workspace_ e _Remoto [Codespaces]_ para um projeto específico no repositório do projeto. Para obter mais informações, confira "[Introdução aos contêineres de desenvolvimento](/github/developing-online-with-codespaces/configuring-codespaces-for-your-project#creating-a-custom-dev-container-configuration)".
|
||||
|
||||
{% endnote %}
|
||||
|
||||
### Enabling your dotfiles repository for {% data variables.product.prodname_codespaces %}
|
||||
### Habilitando o repositório de dotfiles para {% data variables.product.prodname_codespaces %}
|
||||
|
||||
You can use your selected dotfiles repository to personalize your {% data variables.product.prodname_codespaces %} environment. Once you choose your dotfiles repository, you can add your scripts, preferences, and configurations to it. You then need to enable your dotfiles from your personal {% data variables.product.prodname_codespaces %} settings page.
|
||||
Você pode usar o repositório de Dotfiles selecionado para personalizar seu ambiente de {% data variables.product.prodname_codespaces %}. Depois de escolher o seu repositório de dotfiles, você poderá adicionar seus scripts, preferências e configurações. Em seguida, você deverá habilitar os seus dotfiles na sua página pessoal de configurações de {% data variables.product.prodname_codespaces %}.
|
||||
|
||||
{% warning %}
|
||||
|
||||
**Warning:** Dotfiles have the ability to run arbitrary scripts, which may contain unexpected or malicious code. Before installing a dotfiles repo, we recommend checking scripts to ensure they don't perform any unexpected actions.
|
||||
**Aviso:** Dotfiles têm a capacidade de executar scripts arbitrários, que podem conter codespace inesperado ou malicioso. Antes de instalar o repositório de um dotfiles, recomendamos verificar os scripts para garantir que eles não executam nenhuma ação inesperada.
|
||||
|
||||
{% endwarning %}
|
||||
|
||||
{% data reusables.user-settings.access_settings %}
|
||||
{% data reusables.user-settings.codespaces-tab %}
|
||||
1. Under "Dotfiles", select **Automatically install dotfiles** so that {% data variables.product.prodname_codespaces %} automatically installs your dotfiles into every new codespace you create.
|
||||
|
||||
2. Choose the repository you want to install dotfiles from.
|
||||
|
||||
{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.codespaces-tab %}
|
||||
1. Em "Dotfiles", selecione **Instalar dotfiles automaticamente** para que {% data variables.product.prodname_codespaces %} instale automaticamente seus dotfiles em cada novo codespace que você criar.
|
||||
|
||||
2. Escolha o repositório no qual você deseja instalar dotfiles.
|
||||
|
||||
|
||||
You can add further script, preferences, configuration files to your dotfiles repository or edit existing files whenever you want. Changes to settings will only be picked up by new codespaces.
|
||||
Você pode adicionar mais script, preferências e arquivos de configuração ao repositório de dotfiles ou editar arquivos existentes sempre que quiser. As alterações nas configurações só serão selecionadas por novos codespaces.
|
||||
|
||||
If your codespace fails to pick up configuration settings from dotfiles, see "[Troubleshooting dotfiles for {% data variables.product.prodname_codespaces %}](/codespaces/troubleshooting/troubleshooting-dotfiles-for-codespaces)."
|
||||
Se o seu codespace não conseguir selecionar as configurações de dotfiles, confira "[Solucionar problemas de arquivos de dados de {% data variables.product.prodname_codespaces %}](/codespaces/troubleshooting/troubleshooting-dotfiles-for-codespaces)".
|
||||
|
||||
You can also personalize {% data variables.product.prodname_codespaces %} using additional [{% data variables.product.prodname_codespaces %} settings](https://github.com/settings/codespaces):
|
||||
Você também pode personalizar {% data variables.product.prodname_codespaces %} usando configurações adicionais de [{% data variables.product.prodname_codespaces %}](https://github.com/settings/codespaces):
|
||||
|
||||
- To enable GPG verification, see "[Managing GPG verification for {% data variables.product.prodname_github_codespaces %}](/codespaces/managing-your-codespaces/managing-gpg-verification-for-github-codespaces)."
|
||||
- To set your editor, see "[Setting your default editor for {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces)."
|
||||
- To set how long a codespace can remain unused before it is automatically stopped, see "[Setting your timeout period for GitHub Codespaces](/codespaces/customizing-your-codespace/setting-your-timeout-period-for-github-codespaces)."
|
||||
- To set the period for which your unused codespaces are retained, see "[Configuring automatic deletion of your codespaces](/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces)."
|
||||
- To set your default region, see "[Setting your default region for {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-default-region-for-github-codespaces)."
|
||||
- Para habilitar a verificação de GPG, confira "[Como gerenciar a verificação de GPG do {% data variables.product.prodname_github_codespaces %}](/codespaces/managing-your-codespaces/managing-gpg-verification-for-github-codespaces)".
|
||||
- Para definir seu editor, confira "[Como configurar o editor padrão do {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-default-editor-for-github-codespaces)".
|
||||
- Para definir quanto tempo um codespace pode permanecer sem uso antes de ser interrompido automaticamente, confira "[Configurando seu período limite para o GitHub Codespaces](/codespaces/customizing-your-codespace/setting-your-timeout-period-for-github-codespaces)".
|
||||
- Para definir o período pelo qual seus codespaces não utilizados são retidos, confira "[Como configurar a exclusão automática dos seus codespaces](/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces)".
|
||||
- Para definir sua região padrão, confira "[Como configurar sua região padrão do {% data variables.product.prodname_github_codespaces %}](/codespaces/customizing-your-codespace/setting-your-default-region-for-github-codespaces)".
|
||||
|
||||
## Further reading
|
||||
## Leitura adicional
|
||||
|
||||
* "[Creating a new repository](/github/creating-cloning-and-archiving-repositories/creating-a-new-repository)"
|
||||
* "[Como criar um repositório](/github/creating-cloning-and-archiving-repositories/creating-a-new-repository)"
|
||||
|
||||
@@ -69,6 +69,8 @@ You can create a codespace for a particular task and then safely delete the code
|
||||
|
||||
If you try to delete a codespace with unpushed git commits, your editor will notify you that you have changes that have not been pushed to a remote branch. You can push any desired changes and then delete your codespace, or continue to delete your codespace and any uncommitted changes. You can also export your code to a new branch without creating a new codespace. For more information, see "[Exporting changes to a branch](/codespaces/troubleshooting/exporting-changes-to-a-branch)."
|
||||
|
||||
Codespaces that have been stopped and remain inactive for a specified period of time will be deleted automatically. By default, inactive codespaces are deleted after 30 days, but you can customize your codespace retention period. For more information, see "[Configuring automatic deletion of your codespaces](/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces)."
|
||||
|
||||
You will be charged for the storage of all your codespaces. When you delete a codespace, you will no longer be charged.
|
||||
|
||||
For more information on deleting a codespace, see "[Deleting a codespace](/codespaces/developing-in-codespaces/deleting-a-codespace)."
|
||||
|
||||
@@ -123,4 +123,5 @@ For more information, click the "{% data variables.product.prodname_cli %}" tab
|
||||
You can also use the REST API to delete codespaces for your organization. For more information, see "[Codespaces organizations](/rest/codespaces/organizations#delete-a-codespace-from-the-organization)."
|
||||
|
||||
## Further reading
|
||||
- "[Codespaces lifecycle](/codespaces/developing-in-codespaces/codespaces-lifecycle)"
|
||||
- "[Codespaces lifecycle](/codespaces/developing-in-codespaces/codespaces-lifecycle)"
|
||||
- "[Configuring automatic deletion of your codespaces](/codespaces/customizing-your-codespace/configuring-automatic-deletion-of-your-codespaces)"
|
||||
@@ -10,16 +10,16 @@ versions:
|
||||
type: quick_start
|
||||
topics:
|
||||
- Codespaces
|
||||
ms.openlocfilehash: 0c6f2aad203bfc11bcf5a9fbeaf3e7a187c4f180
|
||||
ms.sourcegitcommit: 969a4bd906dd5a3366d404cf2fe125f671062397
|
||||
ms.openlocfilehash: d64aa32db633a14c1cc8d36b3204cab2c9982f93
|
||||
ms.sourcegitcommit: 505b84dc7227e8a5d518a71eb5c7eaa65b38ce0e
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: pt-BR
|
||||
ms.lasthandoff: 07/15/2022
|
||||
ms.locfileid: '147145070'
|
||||
ms.lasthandoff: 09/09/2022
|
||||
ms.locfileid: '147875547'
|
||||
---
|
||||
O {% data variables.product.prodname_github_codespaces %} é um ambiente de desenvolvimento instantâneo e baseado na nuvem que usa um contêiner para fornecer linguagens, ferramentas e utilitários de desenvolvimento comuns. {% data variables.product.prodname_codespaces %} também é configurável, o que permite que você crie um ambiente de desenvolvimento personalizado para o seu projeto. Ao configurar um ambiente de desenvolvimento personalizado para seu projeto, você pode ter uma configuração de código reproduzível para todos os usuários do seu projeto.
|
||||
|
||||
## <a name="creating-your-codespace"></a>Criando seu codespace
|
||||
## Criando seu codespace
|
||||
|
||||
Há uma série de pontos de entrada para criar um codespace.
|
||||
|
||||
@@ -34,11 +34,11 @@ Depois de selecionar a opção para criar um novo codespace e, opcionalmente, se
|
||||
|
||||
|
||||
|
||||
### <a name="step-1-vm-and-storage-are-assigned-to-your-codespace"></a>Etapa 1: A VM e o armazenamento são atribuídos ao seu codespace
|
||||
### Etapa 1: A VM e o armazenamento são atribuídos ao seu codespace
|
||||
|
||||
Quando você cria um codespace, um [clone superficial](https://github.blog/2020-12-21-get-up-to-speed-with-partial-clone-and-shallow-clone/) do repositório é feito em uma máquina virtual do Linux dedicada e privada para você. Ter uma VM dedicada garante que você tenha todo o conjunto de recursos de computação daquela máquina disponível para você. Se necessário, isso também permite que você tenha acesso total à raiz do seu contêiner.
|
||||
|
||||
### <a name="step-2-container-is-created"></a>Etapa 2: O contêiner foi criado
|
||||
### Etapa 2: O contêiner foi criado
|
||||
|
||||
{% data variables.product.prodname_codespaces %} usa um contêiner como ambiente de desenvolvimento. Este contêiner foi criado com base nas configurações que você pode definir em um arquivo `devcontainer.json` e/ou em um Dockerfile no seu repositório. Se você não [configurar um contêiner](/codespaces/customizing-your-codespace/configuring-codespaces-for-your-project), o {% data variables.product.prodname_codespaces %} usará uma [imagem padrão](/codespaces/customizing-your-codespace/configuring-codespaces-for-your-project#using-the-default-configuration), que tem uma variedade de linguagens e runtimes disponíveis. Para obter informações sobre o que a imagem padrão contém, confira o repositório [`vscode-dev-containers`](https://github.com/microsoft/vscode-dev-containers/tree/main/containers/codespaces-linux).
|
||||
|
||||
@@ -50,11 +50,11 @@ Como o repositório é clonado na VM do host antes de o contêiner ser criado, q
|
||||
|
||||
{% endnote %}
|
||||
|
||||
### <a name="step-3-connecting-to-the-codespace"></a>Etapa 3: Conectando-se ao codespace
|
||||
### Etapa 3: Conectando-se ao codespace
|
||||
|
||||
Quando seu contêiner for criado e qualquer outra inicialização for executada, você estará conectado ao seu codespace. Você pode se conectar a ele por meio da Web ou por meio do [{% data variables.product.prodname_vscode_shortname %}](/codespaces/developing-in-codespaces/using-codespaces-in-visual-studio-code), ou ambos, se necessário.
|
||||
|
||||
### <a name="step-4-post-creation-setup"></a>Passo 4: Configuração de pós-criação
|
||||
### Passo 4: Configuração de pós-criação
|
||||
|
||||
Depois que você estiver conectado ao codespace, a configuração automatizada poderá continuar sendo compilada com base na configuração que você especificou no arquivo `devcontainer.json`. Você poderá ver `postCreateCommand` e `postAttachCommand` serem executados.
|
||||
|
||||
@@ -65,9 +65,9 @@ Se tiver um repositório público de dotfiles para o {% data variables.product.p
|
||||
Por fim, toda a história do repositório é copiada com um clone completo.
|
||||
|
||||
Durante a configuração de pós-criação, você ainda poderá usar o terminal integrado e fazer edições nos seus arquivos, mas tenha cuidado para evitar quaisquer condições de corrida entre seu trabalho e os comandos que estão sendo executados.
|
||||
## <a name="-data-variablesproductprodname_codespaces--lifecycle"></a>Ciclo de vida de {% data variables.product.prodname_codespaces %}
|
||||
## Ciclo de vida de {% data variables.product.prodname_codespaces %}
|
||||
|
||||
### <a name="saving-files-in-your-codespace"></a>Salvando arquivos no seu codespace
|
||||
### Salvando arquivos no seu codespace
|
||||
|
||||
À medida que você desenvolve no seu codespace, ele salvará todas as alterações nos seus arquivos a cada poucos segundos. Seu codespace continuará em execução por 30 minutos após a última atividade. Depois desse tempo ele irá parar de executar, mas você poderá reiniciá-lo a partir da aba do navegador existente ou da lista de codespaces existentes. As mudanças de arquivo do editor e saída terminal são contadas como atividade. Portanto, o seu código não parará se a saída do terminal continuar.
|
||||
|
||||
@@ -76,14 +76,14 @@ Durante a configuração de pós-criação, você ainda poderá usar o terminal
|
||||
**Observação:** as alterações feitas em um codespace no {% data variables.product.prodname_vscode_shortname %} não serão salvas automaticamente, a menos que você tenha habilitado o [Salvamento Automático](https://code.visualstudio.com/docs/editor/codebasics#_save-auto-save).
|
||||
{% endnote %}
|
||||
|
||||
### <a name="closing-or-stopping-your-codespace"></a>Fechando ou interrompendo seu codespace
|
||||
### Fechando ou interrompendo seu codespace
|
||||
|
||||
Para interromper o codespace, [use a {% data variables.product.prodname_vscode_command_palette %}](/codespaces/codespaces-reference/using-the-vs-code-command-palette-in-codespaces#suspending-or-stopping-a-codespace) [`Shift + Command + P` (Mac)/`Ctrl + Shift + P` (Windows)]. Se você sair do seu codespace sem executar o comando de interrupção (por exemplo, fechando a aba do navegador), ou se você sair do codespace em execução sem interação, o codespace e os seus processos em execução continuarão até que ocorra uma janela de inatividade, após a qual o código será interrompido. Por padrão, a janela de inatividade é de 30 minutos.
|
||||
Para interromper seu codespace, você pode [usar a {% data variables.product.prodname_vscode_command_palette %}](/codespaces/codespaces-reference/using-the-vs-code-command-palette-in-codespaces#suspending-or-stopping-a-codespace) (<kbd>Shift</kbd>+<kbd>Command</kbd>+<kbd>P</kbd> no Mac ou <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> no Windows/Linux). Se você sair do seu codespace sem executar o comando de interrupção (por exemplo, fechando a aba do navegador), ou se você sair do codespace em execução sem interação, o codespace e os seus processos em execução continuarão até que ocorra uma janela de inatividade, após a qual o código será interrompido. Por padrão, a janela de inatividade é de 30 minutos.
|
||||
|
||||
Ao fechar ou interromper o seu codespace, todas as alterações não autorizadas são preservadas até você conectar-se ao codespace novamente.
|
||||
|
||||
|
||||
## <a name="running-your-application"></a>Executando seu aplicativo
|
||||
## Executando seu aplicativo
|
||||
|
||||
O redirecionamento de porta dá acesso a portas TCP que estão em execução no seu codespace. Por exemplo, se você estiver executando um aplicativo web na porta 4000 dentro do seu codespace, você poderá encaminhar automaticamente a porta para tornar o aplicativo acessível a partir do seu navegador.
|
||||
|
||||
@@ -97,13 +97,15 @@ Embora as portas possam ser encaminhadas automaticamente, elas não podem ser ac
|
||||
|
||||
A execução do seu aplicativo ao chegar pela primeira vez no seu codespace pode fazer um loop de desenvolvimento rápido interno. À medida que você edita, as alterações são salvas automaticamente e ficam disponíveis na sua porta encaminhada. Para visualizar as alterações, volte para a aba do aplicativo em execução no seu navegador e atualize-as.
|
||||
|
||||
## <a name="committing-and-pushing-your-changes"></a>Enviando e fazendo push das suas alterações
|
||||
## Enviando e fazendo push das suas alterações
|
||||
|
||||
O Git está disponível por padrão no seu codespace. Portanto, você pode confiar no fluxo de trabalho do Git existente. Você pode trabalhar com o Git em seu codespace por meio do Terminal ou usando a interface do usuário do controle do código-fonte do [{% data variables.product.prodname_vscode_shortname %}](https://code.visualstudio.com/docs/editor/versioncontrol). Para obter mais informações, confira "[Como usar o controle do código-fonte no seu codespace](/codespaces/developing-in-codespaces/using-source-control-in-your-codespace)".
|
||||
|
||||
|
||||
|
||||
Você pode criar um codespace a partir de qualquer branch, commit ou pull request no seu projeto, ou você pode mudar para branch novo branch ou branch existente de dentro do seu codespace ativo. Como o {% data variables.product.prodname_github_codespaces %} foi projetado para ser efêmero, você poderá usá-lo como um ambiente isolado para experimentar, verificar a solicitação de pull de um colega ou corrigir os conflitos de mesclagem. Você pode criar mais de um código de espaço por repositório ou até mesmo por branch. No entanto, cada conta de usuário tem um limite de 10 codespaces. Se você atingiu o limite e deseja criar um novo espaço de código, você deve primeiro excluir um código.
|
||||
Você pode criar um codespace a partir de qualquer branch, commit ou pull request no seu projeto, ou você pode mudar para branch novo branch ou branch existente de dentro do seu codespace ativo. Como o {% data variables.product.prodname_github_codespaces %} foi projetado para ser efêmero, você poderá usá-lo como um ambiente isolado para experimentar, verificar a solicitação de pull de um colega ou corrigir os conflitos de mesclagem.
|
||||
|
||||
Você pode criar mais de um código de espaço por repositório ou até mesmo por branch. No entanto, há limites para o número de codespaces que você pode criar e o que você pode executar ao mesmo tempo. Se você atingir o número máximo de codespaces e tentar criar outro, uma mensagem será exibida informando que você deverá remover um codespace antes de criar um novo.
|
||||
|
||||
{% note %}
|
||||
|
||||
@@ -111,15 +113,15 @@ Você pode criar um codespace a partir de qualquer branch, commit ou pull reques
|
||||
|
||||
{% endnote %}
|
||||
|
||||
## <a name="personalizing-your-codespace-with-extensions"></a>Personalizando seu codespace com extensões
|
||||
## Personalizando seu codespace com extensões
|
||||
|
||||
Usar o {% data variables.product.prodname_vscode_shortname %} no seu codespace dá acesso ao {% data variables.product.prodname_vscode_marketplace %} para que você possa adicionar todas as extensões de que precisa. Para obter informações sobre como as extensões são executadas no {% data variables.product.prodname_codespaces %}, consulte [Suporte ao desenvolvimento remoto e ao GitHub Codespaces](https://code.visualstudio.com/api/advanced-topics/remote-extensions) na documentação do {% data variables.product.prodname_vscode_shortname %}.
|
||||
|
||||
Se você já usa o {% data variables.product.prodname_vscode_shortname %}, use a [Sincronização de Configurações](https://code.visualstudio.com/docs/editor/settings-sync) para sincronizar automaticamente extensões, configurações, temas e atalhos de teclado entre a sua instância local e os {% data variables.product.prodname_codespaces %} que você criar.
|
||||
|
||||
## <a name="further-reading"></a>Leitura adicional
|
||||
## Leitura adicional
|
||||
|
||||
- [Como habilitar o {% data variables.product.prodname_codespaces %} para sua organização](/codespaces/managing-codespaces-for-your-organization/enabling-codespaces-for-your-organization)
|
||||
- [Como gerenciar a cobrança do {% data variables.product.prodname_codespaces %} na sua organização](/codespaces/managing-codespaces-for-your-organization/managing-billing-for-codespaces-in-your-organization)
|
||||
- [Como configurar seu projeto para o Codespaces](/codespaces/setting-up-your-project-for-codespaces)
|
||||
- [Ciclo de vida dos codespaces](/codespaces/developing-in-codespaces/codespaces-lifecycle)
|
||||
- "[Como habilitar {% data variables.product.prodname_codespaces %} para sua organização](/codespaces/managing-codespaces-for-your-organization/enabling-codespaces-for-your-organization)"
|
||||
- "[Como gerenciar a cobrança de {% data variables.product.prodname_codespaces %} na sua organização](/codespaces/managing-codespaces-for-your-organization/managing-billing-for-codespaces-in-your-organization)"
|
||||
- "[Como configurar seu projeto para o Codespaces](/codespaces/setting-up-your-project-for-codespaces)"
|
||||
- "[Ciclo de vida dos codespaces](/codespaces/developing-in-codespaces/codespaces-lifecycle)"
|
||||
|
||||
@@ -13,12 +13,12 @@ topics:
|
||||
- Billing
|
||||
redirect_from:
|
||||
- /codespaces/managing-codespaces-for-your-organization/managing-billing-for-codespaces-in-your-organization
|
||||
ms.openlocfilehash: 752a32ca3af18873e88fab2389beef0262988b28
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: 6cd1396cd0933999a99c334f00416b43f31ae249
|
||||
ms.sourcegitcommit: 478f2931167988096ae6478a257f492ecaa11794
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: pt-BR
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '147676653'
|
||||
ms.lasthandoff: 09/09/2022
|
||||
ms.locfileid: '147865182'
|
||||
---
|
||||
## Visão geral
|
||||
|
||||
@@ -26,8 +26,8 @@ Para saber mais sobre os preços do {% data variables.product.prodname_github_co
|
||||
|
||||
{% data reusables.codespaces.codespaces-billing %}
|
||||
|
||||
- Como proprietário ou gerente de cobrança de uma organização, você pode gerenciar a cobrança do {% data variables.product.prodname_codespaces %} para sua organização: ["Sobre a cobrança do Codespaces"](/billing/managing-billing-for-github-codespaces/about-billing-for-codespaces)
|
||||
|
||||
- Como proprietário ou gerente de faturamento de uma organização, você pode gerenciar a cobrança do {% data variables.product.prodname_codespaces %} de sua organização: ["Sobre a cobrança do Codespaces"](/billing/managing-billing-for-github-codespaces/about-billing-for-codespaces)
|
||||
- Como proprietário de uma organização, você pode listar os codespaces atualmente ativos e interrompidos em sua organização. Além desses codespaces, os custos do mês atual podem incluir custos de codespaces anteriores ao mês atual, mas que já foram excluídos.
|
||||
- Para os usuários, há um guia que explica como funciona a cobrança: ["Noções básicas sobre a cobrança do Codespaces"](/codespaces/codespaces-reference/understanding-billing-for-codespaces)
|
||||
|
||||
## Limites de uso
|
||||
@@ -36,7 +36,7 @@ Você pode definir um limite de uso para os codespaces na sua organização ou r
|
||||
|
||||
- **Minutos de computação:** o uso de computação é calculado pelo número real de minutos usados por todas as instâncias do {% data variables.product.prodname_codespaces %} enquanto elas estão ativas. Estes montantes totais são comunicados diariamente ao serviço de cobrança e são cobrados mensalmente. Você pode definir um limite de gastos para uso de {% data variables.product.prodname_codespaces %} na sua organização. Para obter mais informações, confira "[Como gerenciar limites de gastos do {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces)".
|
||||
|
||||
- **Uso de armazenamento:** para fins de cobrança do {% data variables.product.prodname_codespaces %}, isso inclui todo o armazenamento usado por todos os codespaces na sua conta. Isto inclui todos os codespacess usados pelos repositórios clonados, arquivos de configuração e extensões, entre outros. Estes montantes totais são comunicados diariamente ao serviço de cobrança e são cobrados mensalmente. No final do mês, {% data variables.product.prodname_dotcom %} arredonda seu armazenamento para o MB mais próximo. Para verificar quantos minutos de computação e GB de armazenamento foram usados pelo {% data variables.product.prodname_codespaces %}, confira "[Como exibir o uso do {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage)".
|
||||
- **Uso de armazenamento:** para fins de cobrança do {% data variables.product.prodname_codespaces %}, isso inclui todo o armazenamento usado por todos os codespaces na sua conta. Isso inclui recursos como repositórios clonados, arquivos de configuração, extensões, entre outros. Estes montantes totais são comunicados diariamente ao serviço de cobrança e são cobrados mensalmente. No final do mês, {% data variables.product.prodname_dotcom %} arredonda seu armazenamento para o MB mais próximo. Para verificar quantos minutos de computação e GB de armazenamento foram usados pelo {% data variables.product.prodname_codespaces %}, confira "[Como exibir o uso do {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage)".
|
||||
|
||||
## Desabilitando ou limitando {% data variables.product.prodname_codespaces %}
|
||||
|
||||
@@ -52,10 +52,16 @@ Você também pode restringir quanto tempo um codespace pode permanecer não uti
|
||||
|
||||
## Excluindo codespaces não utilizados
|
||||
|
||||
Seus usuários podem excluir seus codespaces no https://github.com/codespaces e de dentro de {% data variables.product.prodname_vscode %}. Para reduzir o tamanho de um codespace, os usuários podem excluir arquivos manualmente usando o termo ou de dentro de {% data variables.product.prodname_vscode_shortname %}.
|
||||
Seus usuários podem excluir seus próprios codespaces no https://github.com/codespaces e de dentro de {% data variables.product.prodname_vscode %}. Para reduzir o tamanho de um codespace, os usuários podem excluir arquivos manualmente usando o termo ou de dentro de {% data variables.product.prodname_vscode_shortname %}.
|
||||
|
||||
Como proprietário da organização, você pode excluir qualquer codespace em sua organização. Para obter mais informações, confira "[Como excluir um codespace](/codespaces/developing-in-codespaces/deleting-a-codespace#deleting-codespaces-in-your-organization)".
|
||||
|
||||
{% note %}
|
||||
|
||||
**Observação:** os codespaces são excluídos automaticamente depois que são parados e ficam inativos por um número definido de dias. Para obter mais informações, confira "[Como restringir o período de retenção para codespaces](/codespaces/managing-codespaces-for-your-organization/restricting-the-retention-period-for-codespaces)". Um codespace só pode ser excluído manualmente pela pessoa que o criou.
|
||||
|
||||
{% endnote %}
|
||||
|
||||
## Leitura adicional
|
||||
|
||||
- "[Como listar os codespaces na sua organização](/codespaces/managing-codespaces-for-your-organization/listing-the-codespaces-in-your-organization)"
|
||||
|
||||
@@ -14,14 +14,14 @@ topics:
|
||||
- Organizations
|
||||
- Teams
|
||||
shortTitle: Manage team access
|
||||
ms.openlocfilehash: d03c6dcb8f1f386d0545ad99154edaf0991a987e
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: 34f912f4d5c55df30629b7b56200bef25281bf2d
|
||||
ms.sourcegitcommit: 72e1c60459a610944184ca00e3ae60bf1f5fc6db
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: pt-BR
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '145126454'
|
||||
ms.lasthandoff: 09/09/2022
|
||||
ms.locfileid: '147875536'
|
||||
---
|
||||
Pessoas com acesso de administrador a um repositório podem gerenciar o acesso de equipes ao repositório. Mantenedores de equipes podem remover o acesso de uma equipe a um repositório.
|
||||
Pessoas com acesso de administrador a um repositório podem gerenciar o acesso de equipes ao repositório. Os mantenedores de equipe podem remover o acesso a um repositório se a equipe tiver acesso direto a ele. Se o acesso ao repositório for herdado de uma equipe pai, os mantenedores podem optar por redefinir a permissão atual para corresponder à permissão da equipe pai.
|
||||
|
||||
{% warning %}
|
||||
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
---
|
||||
title: Alterar o branch-padrão
|
||||
intro: 'Se você tiver mais de um branch no seu repositório, você poderá configurar qualquer branch como o branch-padrão.'
|
||||
permissions: People with admin permissions to a repository can change the default branch for the repository.
|
||||
permissions: People with admin access for a repository can change the default branch for the repository.
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '*'
|
||||
|
||||
@@ -3,6 +3,7 @@ title: Grupos externos
|
||||
intro: A API de grupos externos permite que você visualize os grupos de provedores de identidade externos que estão disponíveis para sua organização e gerencie a conexão entre grupos externos e equipes na sua organização.
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghes: '>=3.6'
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
|
||||
@@ -1,10 +1,10 @@
|
||||
---
|
||||
ms.openlocfilehash: 9634dbe779ef8c4bf0707adfe45d6e5084d95196
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.openlocfilehash: a314ace9dc0cc07e1119fa2a02c5ea45ef3a90fe
|
||||
ms.sourcegitcommit: ac00e2afa6160341c5b258d73539869720b395a4
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: pt-BR
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: "145065416"
|
||||
ms.lasthandoff: 09/09/2022
|
||||
ms.locfileid: "147875494"
|
||||
---
|
||||
A execução de trabalho ou de fluxo de trabalho exige uma configuração `permissions` com [`id-token: write`](/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token). Você não poderá solicitar o token de ID JWT do OIDC se a configuração `permissions` de `id-token` for definida como `read` ou `none`.
|
||||
|
||||
@@ -13,11 +13,19 @@ A configuração `id-token: write`permite que o JWT seja solicitado do provedor
|
||||
- Usando variáveis de ambiente no executor (`ACTIONS_ID_TOKEN_REQUEST_URL` e `ACTIONS_ID_TOKEN_REQUEST_TOKEN`).
|
||||
- Usando `getIDToken()` por meio do kit de ferramentas do Actions.
|
||||
|
||||
Se você precisar buscar um token OIDC para um fluxo de trabalho, a permissão poderá ser definida no nível do fluxo de trabalho. Por exemplo:
|
||||
|
||||
```yaml{:copy}
|
||||
permissions:
|
||||
id-token: write # This is required for requesting the JWT
|
||||
contents: read # This is required for actions/checkout
|
||||
```
|
||||
|
||||
Se você só precisa obter um token OIDC para um único trabalho, essa permissão poderá ser definida dentro desse trabalho. Por exemplo:
|
||||
|
||||
```yaml{:copy}
|
||||
permissions:
|
||||
id-token: write
|
||||
id-token: write # This is required for requesting the JWT
|
||||
```
|
||||
|
||||
Você pode precisar especificar permissões adicionais aqui, dependendo das necessidades do seu fluxo de trabalho.
|
||||
|
||||
@@ -1,9 +1,9 @@
|
||||
---
|
||||
ms.openlocfilehash: 7e31c324900e21824e8214e6dcd453aa95ee85eb
|
||||
ms.sourcegitcommit: 81faf43a57101e75d40b5f8f77b9b129699e5d41
|
||||
ms.openlocfilehash: f2d4527cb962dc9dc65d1aa1cc150f048814a917
|
||||
ms.sourcegitcommit: 505b84dc7227e8a5d518a71eb5c7eaa65b38ce0e
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: pt-BR
|
||||
ms.lasthandoff: 09/08/2022
|
||||
ms.locfileid: "147865198"
|
||||
ms.lasthandoff: 09/09/2022
|
||||
ms.locfileid: "147875545"
|
||||
---
|
||||
Você pode ter até 10 codespaces por vez. Depois de ter 10 codespaces, você deverá excluir um codespace antes de criar um novo.
|
||||
Há limites para o número de codespaces que você pode criar e o que você pode executar ao mesmo tempo. Esses limites variam de acordo com uma série de fatores. Se você atingir o número máximo de codespaces e tentar criar outro, uma mensagem será exibida informando que você deverá remover um codespace antes de criar um novo.
|
||||
Reference in New Issue
Block a user