Merge branch 'main' into patch-2
This commit is contained in:
Courtney Wilson
Binary file not shown.
|
After Width: | Height: | Size: 55 KiB |
@@ -11,7 +11,7 @@ export default function ClientSideRefresh() {
|
||||
useSWR(
|
||||
router.asPath,
|
||||
() => {
|
||||
router.replace(router.asPath)
|
||||
router.replace(router.asPath, undefined, { scroll: false })
|
||||
},
|
||||
{
|
||||
// Implied here is that `revalidateOnFocus: true` which the default
|
||||
|
||||
@@ -256,7 +256,7 @@ To customize these claim formats, organization and repository admins can use the
|
||||
|
||||
By default, the JWT is issued by {% data variables.product.prodname_dotcom %}'s OIDC provider at `https://token.actions.githubusercontent.com`. This path is presented to your cloud provider using the `iss` value in the JWT.
|
||||
|
||||
Enterprise admins can security harden their OIDC configuration by configuring their enterprise to receive tokens from a unique URL at `https://api.github.com/enterprises/<enterpriseSlug>/actions/oidc/customization/issuer`. Replace `<enterpriseSlug>` with the slug value of your enterprise.
|
||||
Enterprise admins can security harden their OIDC configuration by configuring their enterprise to receive tokens from a unique URL at `https://token.actions.githubusercontent.com/<enterpriseSlug>`. Replace `<enterpriseSlug>` with the slug value of your enterprise.
|
||||
|
||||
This configuration means that your enterprise will receive the OIDC token from a unique URL, and you can then configure your cloud provider to only accept tokens from that URL. This helps ensure that only the enterprise's repositories can access your cloud resources using OIDC.
|
||||
|
||||
@@ -270,7 +270,7 @@ After this setting is applied, the JWT will contain the updated `iss` value. In
|
||||
"sub": "repo:octocat-inc/private-server:ref:refs/heads/main"
|
||||
"aud": "http://octocat-inc.example/octocat-inc"
|
||||
"enterprise": "octocat-inc"
|
||||
"iss": "https://api.github.com/enterprises/octocat-inc/actions/oidc/customization/issuer",
|
||||
"iss": "https://token.actions.githubusercontent.com/octocat-inc",
|
||||
"bf": 1755350653,
|
||||
"exp": 1755351553,
|
||||
"iat": 1755351253
|
||||
|
||||
@@ -36,7 +36,7 @@ During the runner deployment process, you can configure the _Max_ option, which
|
||||
|
||||
## Networking for {% data variables.actions.hosted_runner %}s
|
||||
|
||||
By default, {% data variables.actions.hosted_runner %}s receive a dynamic IP address that changes for each job run. Optionally, {% data variables.product.prodname_ghe_cloud %} customers can configure their {% data variables.actions.hosted_runner %}s to receive a static IP address from {% data variables.product.prodname_dotcom %}'s IP address pool. When enabled, instances of the {% data variables.actions.hosted_runner %} will receive an address from a range that is unique to the runner, allowing you to use this range to configure a firewall allowlist. You can use up to 10 static IP address ranges in total across all your {% data variables.actions.hosted_runner %}s.
|
||||
By default, {% data variables.actions.hosted_runner %}s receive a dynamic IP address that changes for each job run. Optionally, {% data variables.product.prodname_ghe_cloud %} customers can configure their {% data variables.actions.hosted_runner %}s to receive a static IP address from {% data variables.product.prodname_dotcom %}'s IP address pool. When enabled, instances of the {% data variables.actions.hosted_runner %} will receive an address from a range that is unique to the runner, allowing you to use this range to configure a firewall allowlist. {% ifversion fpt %}You can use up to 10 static IP address ranges in total across all your {% data variables.actions.hosted_runner %}s{% endif %}{% ifversion ghec %}You can use up to 10 static IP address ranges for the {% data variables.actions.hosted_runner %}s created at the enterprise level. In addition, you can use up to 10 static IP address ranges for the {% data variables.actions.hosted_runner %}s created at the organization level, for each organization in your enterprise{% endif %}.
|
||||
|
||||
{% note %}
|
||||
|
||||
|
||||
@@ -27,12 +27,18 @@ Only repository owners and administrators can edit repository-level security adv
|
||||
## Editing advisories in the GitHub Advisory Database
|
||||
|
||||
1. Navigate to https://github.com/advisories.
|
||||
2. Select the security advisory you would like to contribute to.
|
||||
3. On the right-hand side of the page, click the **Suggest improvements for this vulnerability** link.
|
||||
|
||||
4. In the contribution form, make the desired improvements. You can edit or add any detail.
|
||||
5. When you finish editing the advisory, click **Submit improvements**.
|
||||
6. Once you submit your improvements, a pull request containing your changes will be created for review in [github/advisory-database](https://github.com/github/advisory-database) by the {% data variables.product.prodname_security %} curation team. If the advisory originated from a {% data variables.product.prodname_dotcom %} repository, we will also tag the original publisher for optional commentary. You can view the pull request and get notifications when it is updated or closed.
|
||||
1. Select the security advisory you would like to contribute to.
|
||||
1. On the right-hand side of the page, click the **Suggest improvements for this vulnerability** link.
|
||||
|
||||
|
||||
|
||||
1. In the contribution form, make the desired improvements. You can edit or add any detail.{% ifversion security-advisories-reason-for-change %}
|
||||
1. Under **Reason for change**, explain why you want to make this improvement. If you include links to supporting material this will help our reviewers.
|
||||
|
||||
{% endif %}
|
||||
|
||||
1. When you finish editing the advisory, click **Submit improvements**.
|
||||
1. Once you submit your improvements, a pull request containing your changes will be created for review in [github/advisory-database](https://github.com/github/advisory-database) by the {% data variables.product.prodname_security %} curation team. If the advisory originated from a {% data variables.product.prodname_dotcom %} repository, we will also tag the original publisher for optional commentary. You can view the pull request and get notifications when it is updated or closed.
|
||||
|
||||
You can also open a pull request directly on an advisory file in the [github/advisory-database](https://github.com/github/advisory-database) repository. For more information, see the [contribution guidelines](https://github.com/github/advisory-database/blob/main/CONTRIBUTING.md).
|
||||
|
||||
|
||||
@@ -37,7 +37,7 @@ We'll run all of the cells, in sequence, to perform all phases of building the i
|
||||
|
||||
### Open the image classifier notebook
|
||||
|
||||
The default container image that's used by {% data variables.product.prodname_github_codespaces %} includes a set of machine learning libraries that are preinstalled in your codespace. For example, Numpy, pandas, SciPy, Matplotlib, seaborn, scikit-learn, TensorFlow, Keras, PyTorch, Requests, and Plotly. For more information about the default image, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#using-the-default-dev-container-configuration)" and [the `devcontainers/images` repository](https://github.com/devcontainers/images/tree/main/src/codespaces#github-codespaces-default-linux-universal).
|
||||
The default container image that's used by {% data variables.product.prodname_github_codespaces %} includes a set of machine learning libraries that are preinstalled in your codespace. For example, Numpy, pandas, SciPy, Matplotlib, seaborn, scikit-learn, TensorFlow, Keras, PyTorch, Requests, and Plotly. For more information about the default image, see "[Introduction to dev containers](/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers#using-the-default-dev-container-configuration)" and [the `devcontainers/images` repository](https://github.com/devcontainers/images/tree/main/src/universal).
|
||||
|
||||
1. In the {% data variables.product.prodname_vscode_shortname %} editor, close any "Get Started" tabs that are displayed.
|
||||
1. Open the `image-classifier.ipynb` notebook file.
|
||||
|
||||
@@ -21,7 +21,7 @@ Adding an "Open in {% data variables.product.prodname_github_codespaces %}" badg
|
||||
|
||||
When you create a badge you can choose specific configuration options for the codespace that the badge will create.
|
||||
|
||||
When people click the badge they'll be taken to the advanced options page for codespace creation, with the options you chose preselected. For more information about the advanced options page, see "[Creating a codespace](https://docs-internal-30445-bfc9ce.preview.ghdocs.com/en/codespaces/developing-in-codespaces/creating-a-codespace#creating-a-codespace)."
|
||||
When people click the badge they'll be taken to the advanced options page for codespace creation, with the options you chose preselected. For more information about the advanced options page, see "[Creating a codespace](/codespaces/developing-in-codespaces/creating-a-codespace#creating-a-codespace)."
|
||||
|
||||
From the advanced options page, users can change the preselected settings if required, then click **Create codespace**.
|
||||
|
||||
|
||||
@@ -86,7 +86,7 @@ childGroups:
|
||||
- issues
|
||||
- search-github
|
||||
- name: Developers
|
||||
octicon: MarkGithubIcon
|
||||
octicon: CodeSquareIcon
|
||||
children:
|
||||
- developers
|
||||
- rest
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
---
|
||||
title: 'Viewing insights from your {% data variables.projects.project_v2 %}'
|
||||
shortTitle: 'Viewing insights'
|
||||
intro: '...'
|
||||
intro: 'You can use insights to visualize your projects by creating and sharing charts built from your project''s data.'
|
||||
versions:
|
||||
feature: "projects-v2"
|
||||
topics:
|
||||
@@ -13,4 +13,4 @@ children:
|
||||
- /creating-charts
|
||||
- /configuring-charts
|
||||
allowTitleToDifferFromFilename: true
|
||||
---
|
||||
---
|
||||
@@ -67,7 +67,7 @@ If you decide you don't want the changes in a topic branch to be merged to the u
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** The email selector is not available for rebase merges, which do not create a merge commit, or for squash merges, which credit the user who created the pull request as the author of the squashed commit.
|
||||
**Note:** The email selector is not available for rebase merges, which do not create a merge commit{% ifversion squash-merge-email %}. For squash merges, the email selector is only shown if you are the pull request author and you have more than one email address associated with your account.{% else %}, or for squash merges, which credit the user who created the pull request as the author of the squashed commit.{% endif %}
|
||||
|
||||
{% endnote %}
|
||||
|
||||
|
||||
7
data/features/security-advisories-reason-for-change.yml
Normal file
7
data/features/security-advisories-reason-for-change.yml
Normal file
@@ -0,0 +1,7 @@
|
||||
# Reference: #7792
|
||||
# Documentation for incremental improvements to community contributions
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
ghes: '>=3.8'
|
||||
ghae: 'issue-7792'
|
||||
7
data/features/squash-merge-email.yml
Normal file
7
data/features/squash-merge-email.yml
Normal file
@@ -0,0 +1,7 @@
|
||||
# Reference: #7932
|
||||
# Show/choose commit author email address when squash merging a pull request
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
ghes: '>= 3.8'
|
||||
ghae: 'issue-7932'
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:a8d9fc7734cc783275eefe9ba8c5d6f53662edab595fed279a186ad83ca3056e
|
||||
size 797100
|
||||
oid sha256:0d457104abf8c68146f8587a864971660d6449da5ec680eb2d6d889c6349a9f3
|
||||
size 790223
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:7e67fed63733a589a5bc87fd7965ccb89734cfef0d3e35f873ec75388d8d1b1f
|
||||
size 1378077
|
||||
oid sha256:0caed8301057e4c22160b52febec4522ba643ce66873f0f2fd3fb1a1f4d0d0d1
|
||||
size 1414557
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:ceb4cf672dc070066d42336a39cae610dc6b4ac14c810aa047b0304b012c3995
|
||||
size 1098241
|
||||
oid sha256:34bf512cc8850b046853b7ad6ed8d18699de52ec513a8270c4dfd7f84ddc32d0
|
||||
size 1098941
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:ab744118985ebd782bcf39fcf3599c4c4cda6b6cb3fb0daed0e20429c0a95419
|
||||
size 4453207
|
||||
oid sha256:6455c09cbd64ae32ed6bacb4c9da4db2642762e8d2acd9a18bae9f45f26554d8
|
||||
size 4453154
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:ed8a337390dd2063e3d5fa8804d07be6589bb46ea1f41a9d6cec335b341b2aac
|
||||
size 728033
|
||||
oid sha256:9c40468a093fd62c7dc87bbef16ac9efd506e8260e5ce84ef148123cac26011e
|
||||
size 731845
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:82a29ef009c8f0581c2bffe6b3b395da3ec668a88284b1e37e982963275724c6
|
||||
size 2945781
|
||||
oid sha256:31e37b11fdb49247db7e269a7103db2711f7a0fdbd13e26d7058418ee2daf3d4
|
||||
size 2976487
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:d04a03a6395c65da02df580c75530a3712c888b3e7323d9d9018278a798ba6a1
|
||||
size 839065
|
||||
oid sha256:b3d3d0a9772b34b573ff6542e542594ac5fdb19b79eda68d2868b7649fa5fe68
|
||||
size 835619
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:d31f5d61a8b55b1ad3360b1738aee380c0f742eb7a19797caa81164ada745cee
|
||||
size 4373171
|
||||
oid sha256:212519cd4dacbfce9dcf89632457eb3ddeac2015008cdc872e3d9b00f340d040
|
||||
size 4369355
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:4c3dee47af82a17d4fd6410641e9aefcff899f89d2552dfc280bd9f7bfa6436d
|
||||
size 718234
|
||||
oid sha256:0270a11c7d3706b973d7ed2ffe9564c4f9d09e6ea5d784b3b0057f00db5853b2
|
||||
size 720030
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:998d79c68c73f26d651604f3488e04c8cd67cc7aad1ab6981e13ab33f7c9147a
|
||||
size 2959094
|
||||
oid sha256:b99957356bee9793134f7d8b3c536965490cabc18c54402fcfc64f9f4fda20c9
|
||||
size 2976786
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:be770134e76cf84ac2a8c46aaab0236c56e8aa1461125cb9d53a6975e51cde91
|
||||
size 823060
|
||||
oid sha256:858029023c737c29b090636b0d06471832fd001f93118415a050a93bc3712e14
|
||||
size 816616
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:fa39626a31366c0a19e317d3db4f3ae55f9af87edc5e0d27265bafdfe46ff4d5
|
||||
size 1417811
|
||||
oid sha256:70fd77e1d9e02b2b63c18769094271f6de98590a5d5873e06d8a84d34b1abb0c
|
||||
size 1456638
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:235017fcac2b8a68a950dc4b3ff87d6f21e73273c7bd1b9a6288e2eb13a1c602
|
||||
size 1134290
|
||||
oid sha256:0d1d15a7282de30a0eaa386d5dfdb3209402253f37223fee7669b357db2fe695
|
||||
size 1134320
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:28f9bb3aa6d60050a4bb6c3422096cbe153190a3147a17afc9e03c2bb60eb038
|
||||
size 4554055
|
||||
oid sha256:5bbeddfea0eba4243e86a6291091ef5fcb64e9c1e2412a9aad8fb337aa6a6e52
|
||||
size 4554522
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:b81715a8b77ccd38ef6c0f0378505d2bab61405c9a88882d595761fa89c8495a
|
||||
size 749412
|
||||
oid sha256:2c926b1d9c41f58d8851c0cde6d4ff86fd6033bb1ccb582febfe32f4bcd00865
|
||||
size 753221
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:30e8a358781a8b869402f607fc6d8930a51fbac2ecf551d419b3302eedffcf23
|
||||
size 3030527
|
||||
oid sha256:0250e01126c0339be258ce051d6a9ff818afe5a1a2a7ff289321cf835d4318f8
|
||||
size 3062402
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:199ef875c0207a3da91d5206bf6aa83ee6c1d2a25fc9c8700b2034d465d45422
|
||||
size 865335
|
||||
oid sha256:6ad8ba9905ac680afa6da0d212807fd272c1c63a5b87904788c8e13775c84f7a
|
||||
size 862182
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:f3132734c726d74cadb4b7232f2f6d6966318081c02b6cbc509f851af4f4733a
|
||||
size 4507955
|
||||
oid sha256:6a56a5707399b44b4716ec93adc177cb7f7d340a397225eecbea885db9014ccd
|
||||
size 4504295
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:a903e0fe16a78961270a25e6530ab7407042fb0bb0bf3dc4583b1d9a6113f591
|
||||
size 739273
|
||||
oid sha256:f0291d53e3cf0ca800632c41e34107430a3b5e95946b5a025e2a350fa52d7b98
|
||||
size 741484
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:e8371b312a4af38c84460b9ceece7dda98cbdece6d4b40c5d684d5b1963806c5
|
||||
size 3042401
|
||||
oid sha256:65faf70156d312d3c55da14a264143c1835743081d06149e5c51f1a9acfd3e3d
|
||||
size 3063236
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:ee3ceff7b2498ea9f0ce11b06c2f163d97bee3923dadaad692287d0ea0f37eb8
|
||||
size 825140
|
||||
oid sha256:075e7d4d42b491620e20744465d124e6b05c4130a827ce770a673bae598adacc
|
||||
size 818583
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:0e7368cd9e3d52c03d2a361e3c4e701ca1da6ff360f91c1312a09d5f2ea1e1a6
|
||||
size 1426545
|
||||
oid sha256:6203c6471eed9dd52df4df41dc8c365632695bb79b8b7289440e28f7dd4e8676
|
||||
size 1466813
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:4374c4ee18ef3cfc8e77abd6a55b7f0c52cd5d3798b38a0763b606c024928098
|
||||
size 1145287
|
||||
oid sha256:71022c68adc2b1bacb9952faedf7f01336083513ff400e7672a6b317db38aca3
|
||||
size 1145759
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:123b0bf5cfdff1f37c8822c0b7d3a0f91228b48e17279b4139d1e6ced2cdb9a5
|
||||
size 4615113
|
||||
oid sha256:159c606bdfd220aba6fd3e93105a3b7944aa2a12fda0cc1c162264daed924ee3
|
||||
size 4616066
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:0c69c4304a2cd85ab317020ffb9d6f0f33a3444942986c1bed9550e1bdbbf5d4
|
||||
size 753864
|
||||
oid sha256:1d69e098a5a6f1ae0f0c4f516bb6c6f19eee375d4305485d9d5f5880d8596296
|
||||
size 757820
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:28b0b9bda86ca9641b5f019903410699b97bb11478b55c17bb2ce1b1432abf17
|
||||
size 3055430
|
||||
oid sha256:639bb5b08351583780c3ae154eb877cd0c66382268fe1b1bfc0b2685f51845a0
|
||||
size 3087789
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:de8a56e188c58f365d415da87914f3639e43ee33365400978beeb0bafe5ff384
|
||||
size 868850
|
||||
oid sha256:28350a6560b061e9599e87bf90752edb26eae9f72398e59da416fc4dd800a9c3
|
||||
size 865719
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:e020eed3f4112332175fc58b04932a21738601e9e47fdee97c21e60085fba7fe
|
||||
size 4538948
|
||||
oid sha256:4936583bfa3fdc4f7ec82b8affb7d42e00c05e9a1812439e20f14ee0f024e70d
|
||||
size 4536285
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:07447e9dd4546ce0edbe765bfc651b4b457ab3a6919b340615d84f451a150339
|
||||
size 743499
|
||||
oid sha256:dd32b869a14eae4238c4f6535fcc67831b56392139ccd17f0cb78c1df075e033
|
||||
size 745948
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:afa5b0b3243ea3b4cf09205b7677f5e66bf39ef8377511a7ced8d722bbfd5b16
|
||||
size 3067293
|
||||
oid sha256:9f36f35f0b8099c1d00b744bd246ea536eb4323d785f602121b30c6595bd23ee
|
||||
size 3088205
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:81885a6c957ec69de5c8e077e2117e5f46811f7abf449d25ecebedeb9e1e1fd5
|
||||
size 856531
|
||||
oid sha256:95524184b95c0fffa01b3e83b634b82b4686eee10aaeebc9116533bb367dfbeb
|
||||
size 850394
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:2f527b43577e592ee981de07be9c358a1bb0b35b771c9aebdc1d09da84f2f9d2
|
||||
size 1484256
|
||||
oid sha256:83b93c3f971dec68c83c2bfb81a6e5cdd08406fed4d6978ac502577f4e458e00
|
||||
size 1525861
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:a63b078b112db49abe947039f9c1587695c93481624296d7f305d3445ab4fb2f
|
||||
size 1185254
|
||||
oid sha256:62f0df72602764a60c3a84b092f654184bdf0b20d19b862cfa6253d9015a174b
|
||||
size 1186264
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:cf4122a04e0252ea69a36f1542561f271cc77bf9d6ebd5838efbc19a989763e8
|
||||
size 4781803
|
||||
oid sha256:019035350c29da930cbce4a948da52683e7af8208c00587c7c685414b342417f
|
||||
size 4782243
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:8121bfa6c4cb49265c1d303e8bc2f2716368323b160aacfa9bf8e6bf85399d73
|
||||
size 777945
|
||||
oid sha256:5896160046d11f4df6eb7e2887b1c7a82617458ec8520cdb88c6dab23cd0156a
|
||||
size 782508
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:96834fe3a2566294a983346aaf5089e4d95f5a8e91cfd78d2cffced8b14ddde4
|
||||
size 3161924
|
||||
oid sha256:64595066b32014bc6225004e02f129d3fe7bd87d2ae3ce6d5cbccd43e951c455
|
||||
size 3197085
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:6804816b48f1304f9187a9bda7ab7e42746564958c71d1619920bdddc427ad77
|
||||
size 900197
|
||||
oid sha256:88d31cb46ced340518ec18d79ee948af7d7301b8300887bbbf43b73e28c49e4f
|
||||
size 897580
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:6e78cef21483d8d2ceb8da77229ca81596654bfcfedef32d13e34d2f6534e692
|
||||
size 4705772
|
||||
oid sha256:ab5c93290c2ec2e3ed8f377516b3ec159f641a0c644ffb52ecc45d26409c8dda
|
||||
size 4706415
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:cc9dead7fc5c931931f875a61cad9c332299bc21d83260b115a2a1615a594686
|
||||
size 768496
|
||||
oid sha256:272c78d5c48bac7c55ecb7d2920662ed0ef811f1679f3762dfa11fc0c2a1f536
|
||||
size 771016
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:4eda66338d096cb89b5bef9820b00f4eaacb79e5fb468d70d5baefee398684bf
|
||||
size 3179013
|
||||
oid sha256:c849aa2bf1b283e2e4be9f70df95196c785b4d5460a76713f521e9c2d26336b0
|
||||
size 3200479
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:325a41a76319feb9a2cd55d1cffab1c7c537922b321830020690ac8151a726e9
|
||||
size 877002
|
||||
oid sha256:fe20b4ec7e6f024e443314efb9d65fce9cc7348377d5b5030d8b5991f4990f14
|
||||
size 871373
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:a28d47ad7b52259deed36a52014e66bffe4e975b8eb9e971f7a3b893d5d53f62
|
||||
size 1512826
|
||||
oid sha256:07e2e553b08610604d1805578a327322d9f29bb2d3898984009a50c3ebd27d2e
|
||||
size 1557766
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:7f09d59746794da964bef2e7caa2c6e92fca5cd2a3d63368fe0c82754218d272
|
||||
size 1214552
|
||||
oid sha256:72a69ce59df00450f4575bffdbed751631fec3c2c9eef100d8e854167ce28e00
|
||||
size 1215492
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:59cb1bd0b977375653f6a61d74cf8fe7f7eba8959b29d649dfaf3d2fe6d16086
|
||||
size 4897905
|
||||
oid sha256:b7251884598adcf3f0fe264907d48e697681431fd295c5f32339a164807d30da
|
||||
size 4902601
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:2866f1e7ffc79e11aeb3db1eff82ffd9f25ceaaf3f0aa7c72f2085d68f1c83e6
|
||||
size 798946
|
||||
oid sha256:fd8e14c2cd8e7c00aac79c216338e87c94eb1867efd977fbc0acbce48aef6070
|
||||
size 803789
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:9e4930be6a6a77037213e7b5d0fd69982dba17fad20583757befb9de7a75c0e4
|
||||
size 3252703
|
||||
oid sha256:607454ac2786c313a4c9545236e23d733c72805f0ef28534f63d23e8594a3274
|
||||
size 3289847
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:f6257d73000370102b195468471a7301062783b0c29256eb48871db39659644d
|
||||
size 922769
|
||||
oid sha256:a5da8ea5613260a51b60961ded8a56848dff86dee3a22655a8b6dea945cfee11
|
||||
size 920940
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:2d9ac4102f1f3cb4b973b59f7022f6f5ead8fa0384ccaacf00bb2644a3ea50f0
|
||||
size 4828652
|
||||
oid sha256:6e19c62d29fd8eae277e6c2c067e1f552808054372abf9708862faf4d29024ad
|
||||
size 4835313
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:2d164a08d645f8eb60689312d022df5a310ed7c6191a5d5f04d88ecfc23bd5b3
|
||||
size 788525
|
||||
oid sha256:d9bb132e1155a4d18f9a76ed462445b349db35297df4aa9f6c72f61ee7525085
|
||||
size 791871
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:406fb3bb578ac8398afa5f2ad1b5a835f7f234d2b516349bc5abfb864cd399cb
|
||||
size 3265986
|
||||
oid sha256:f3531f4b1a0ae0cba4d150b1c4a1924281a5d5d67ceefbb9ef3f1789cb45e876
|
||||
size 3289636
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:f1d77366ab0849b532284b1ccaf0e0c5513a72c6b03b8669bdf938a84884b296
|
||||
size 1035416
|
||||
oid sha256:844ab58477b28954cc23690c5879ff1cc911f6078be2480725fd3468e26711d0
|
||||
size 1029003
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:3a32e5cf6e126f01a1fe95fd28f867b7e160c2a093b6a54f3bdab897ea06a164
|
||||
size 1570449
|
||||
oid sha256:c6631d50e7e4b766d011946b23b7b7cce5f34fa929a9343f476bd02a6463ca2f
|
||||
size 1606518
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:8da2f1ed7e34913f35a03daf1b34e51cbdcf90e8ac299f1fe2aa6083619f2936
|
||||
size 1469572
|
||||
oid sha256:648bcbd1969fb64587258eac2ee16b199e2a0d834c2dec1a8ce1a039c8a6e700
|
||||
size 1471513
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:73b85148c3968acc84623437aba8a3420fb0e4d8a44373c78ffd0a800e2bcaa1
|
||||
size 5665542
|
||||
oid sha256:596481ec822d2ce16f46b2e0761f8148ab68f7bcb5ab2c715617c5a2faa938fd
|
||||
size 5670687
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:4369f8e48fcafc08cdac458c9bb0dad89203abc766c0de38ecf86bdccc35c5e3
|
||||
size 932812
|
||||
oid sha256:d136dc713f3febb1bcdfabce1f3c6614997b597bc60cf42352444681b4230a07
|
||||
size 937735
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:b1221549b5f29015a947a0b520fad56a083853182a1f0d334fecbdbb678d9d91
|
||||
size 3700859
|
||||
oid sha256:3d2a56a4704e90bf560836c3ca4719046548d3b063ffd587c17600123c46244f
|
||||
size 3740489
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:4037566a72feb75063abd790dffc889ce065281f517b759957de543e697b60f2
|
||||
size 1086642
|
||||
oid sha256:4ec3454def3064a7c617424633577227b8ba938b52c9ba35ad0c8a34b4d5f3a9
|
||||
size 1083461
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:84787f3dc6818a28566ba7af344029af3c533bba250b3f3a722ffcda29a8fe28
|
||||
size 5530388
|
||||
oid sha256:8ddfcfe86ba18b628abeb0b0ee47d38dd8778d16d4e8b6bd0de9a5e4fdeb5a39
|
||||
size 5526687
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:3c6074fc12612c6bb8c9e871d509c22b2fc6af6001adaa57a5cf0d9808e72303
|
||||
size 919621
|
||||
oid sha256:dd7a02f5d9019443a8893e5594e43eb7c0513432620a1c08011fed6b299253bf
|
||||
size 921949
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:3acf6faa7d423e3b0a598a7a72c0b673be9bf1948689db90d46a1b9b37faf585
|
||||
size 3695405
|
||||
oid sha256:371be531cccb49760f034ece0bf465f307f997e85d92b2fe5eb507b2f305c912
|
||||
size 3714200
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:472d045a1bfbc9ace86f7f21e21cb2854c97580a79934d53e64c135971dbf33b
|
||||
size 660490
|
||||
oid sha256:a7f039cedbd36ddabeb71f86acc914256a77820c2eb48be1128a4dcae7180a01
|
||||
size 654776
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:7e8e89da977728ed2632fb59021b3660f989136960a15e0e46424b8d746e0d6e
|
||||
size 1136758
|
||||
oid sha256:f5e8ae73805291115a8fed5c46104aab3841d3bdbd4c3392a7a4460bc16bcc6d
|
||||
size 1176694
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:75994f5dbefbb376cd9f2c63a490856c4b17f5f3da141581b33d296ddef8b478
|
||||
size 944172
|
||||
oid sha256:d70dc0e68a66a737b3604fdb4ce0e9b7553f6fa8d78bc51f3243995042a67b68
|
||||
size 944617
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:2a1e6e91cddbf66d0d0510d81794f931e55783c49e7d8d354a60e72040f89893
|
||||
size 3741625
|
||||
oid sha256:3438d2353c8e4c35565ea7cca74edbbdd9ff92ff3a6c32da4e7ddd867678dae1
|
||||
size 3744334
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:be3ea72be71c258b15d3466e7c25021b2306b52b5091c3607f68ed3513a8a2cc
|
||||
size 610269
|
||||
oid sha256:19a9ad630571e2b624bb664eeb61aa5517d10ea9d153f7769168ab2dab36a1be
|
||||
size 614053
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:95fad85d2fbf3395b73c66603b3cf4c02ab4e8e40b375724cf6464bbc003c036
|
||||
size 2387313
|
||||
oid sha256:6a5384c276d99635998ae14c68c7a42d8aafc834cd2ffccca7734ed2b824ce79
|
||||
size 2419740
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:69f9a92ba47d71f7dd8b4cf6daa9695b10eab24f4f90b39115b96cd51bdbb00f
|
||||
size 694702
|
||||
oid sha256:a06296ba763bc410bf3aa12e2b03816962f60d7e7e2ee93e724a8864311fb1b9
|
||||
size 691770
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:f09b0aaa1b3beea8f89901c6bd168967548d63df6da8a6746f60d4f55e5c0bcf
|
||||
size 3534530
|
||||
oid sha256:b63aafbf8e350596a11139a4b550f0bce3acfe6855f71ddf37f7c99ba0b2756d
|
||||
size 3534333
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:134db898c2553c1bedea8eedc7afbd4d1ead8a6575c2b1078c367b94178289c2
|
||||
size 602667
|
||||
oid sha256:bf3ed7924b091e76605572f6e73bd101af950e3f000d7d1602354ad896b67467
|
||||
size 605240
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:f0280a6f36f8260867d1631bbb48a96af4412c554713943401cd81569a51f565
|
||||
size 2400406
|
||||
oid sha256:8242781f6bdfee5422e7b887664dcc9ddc512a80a52ba6c3604da08f81ffa570
|
||||
size 2424250
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:2acb69b9e0654c23e7044b68d81d3a8c7c9383f3f649cf2283694af9b5f4492a
|
||||
size 1012594
|
||||
oid sha256:27f1a61fe5a77a408bac9ae0db82aae15213d068c086b84e3c638037813d9018
|
||||
size 1006756
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:84865a53a5134413e30c049094076a76b9fa3e1dc4c44ba6eae67300cff2a604
|
||||
size 1679050
|
||||
oid sha256:ac34b9d3b31c2bea4ea577fa82e54fb49f5f7d7888d1f70a5f37dab9e2213598
|
||||
size 1721921
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:7142a5d790427e21c9d2a10e117cd0451a1242110e23f37b91541c51307bb922
|
||||
size 1401689
|
||||
oid sha256:2bd95d94c379db771fd3c21dc441f3475cc999d0c0a57854d348664d97c11dcf
|
||||
size 1402774
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:1f4fd373cda848374cf9e91bbb76f33c5d8c986385394417d894c4e8a6bcc97c
|
||||
size 5692421
|
||||
oid sha256:8a21e28e30bd251e75693b16ddc56c54b566c1495e24ba5c412fd2644fc32d4f
|
||||
size 5697680
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:ec1b375a5d103702131a0f986d6da9d7366ad55f77c036141f22e11a1e420ed3
|
||||
size 932593
|
||||
oid sha256:74cb1a1650ef548a9297a9265c402342064ec26362f5d6dc3324f3c984b10ef0
|
||||
size 937707
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:04aac88389536f7678b935411d53630eaa22c31b8212bcb028882019bab65c10
|
||||
size 3824270
|
||||
oid sha256:2e4c94fcef89b1697330ab2dc210e19c6c27a4320a7d09d6fb1cf62c2c564400
|
||||
size 3866552
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:7059cfd5f66cbc9a2de8a36ccace6e8936ef7412849273735cb89f08793ff677
|
||||
size 1072759
|
||||
oid sha256:82abed6de0ca24f118abb688b2cd6523e79caff9a8969b4999e503cafd111134
|
||||
size 1070515
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:6420dce8335a904e1607b6da9896cb26bd24ee0f21d864af6ec896c599fad503
|
||||
size 5641974
|
||||
oid sha256:3c99c28402c3231829ed4c6d0b1535578d815926c171faf174328448e6a5465f
|
||||
size 5642883
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:79012efcc525469a9e39bf6d4e070796c21810f90b0d71a7133c16fc6f8e82df
|
||||
size 920184
|
||||
oid sha256:db18900d6317020cbaa5eba8cc4a3fba8ad38b89fc8062bb4db6f7701f06e279
|
||||
size 922818
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
version https://git-lfs.github.com/spec/v1
|
||||
oid sha256:a8f31e753b8d8de047f9578a2e53098c35252b9ac5557f530606342224337aff
|
||||
size 3819371
|
||||
oid sha256:ab5b419b1695c02c74ffdc365860b8a6a81c2f5d14eb3e9190decc5c127396a7
|
||||
size 3842301
|
||||
|
||||
@@ -16,10 +16,10 @@ topics:
|
||||
- Accounts
|
||||
shortTitle: Delete your account
|
||||
ms.openlocfilehash: c26ae9af0266defeaa7d0e15afc22b2edee2b7d2
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.sourcegitcommit: 478f2931167988096ae6478a257f492ecaa11794
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: es-ES
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.lasthandoff: 09/09/2022
|
||||
ms.locfileid: '147687270'
|
||||
---
|
||||
## Acerca de la eliminación de tu cuenta personal
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Publishing actions in GitHub Marketplace
|
||||
intro: 'You can publish actions in {% data variables.product.prodname_marketplace %} and share actions you''ve created with the {% data variables.product.prodname_dotcom %} community.'
|
||||
title: Publicar acciones en GitHub Marketplace
|
||||
intro: 'Puedes publicar acciones en {% data variables.product.prodname_marketplace %} y compartir acciones que has creado con la comunidad de {% data variables.product.prodname_dotcom %}.'
|
||||
redirect_from:
|
||||
- /github/automating-your-workflow-with-github-actions/publishing-actions-in-github-marketplace
|
||||
- /actions/automating-your-workflow-with-github-actions/publishing-actions-in-github-marketplace
|
||||
@@ -10,59 +10,63 @@ versions:
|
||||
ghec: '*'
|
||||
type: how_to
|
||||
shortTitle: Publish in GitHub Marketplace
|
||||
ms.openlocfilehash: e16f65116d7aa7c327e937dc2eba8964195e547d
|
||||
ms.sourcegitcommit: 5f9527483381cfb1e41f2322f67c80554750a47d
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: es-ES
|
||||
ms.lasthandoff: 09/11/2022
|
||||
ms.locfileid: '147884305'
|
||||
---
|
||||
Debes aceptar los términos de servicio para publicar acciones en {% data variables.product.prodname_marketplace %}.
|
||||
|
||||
You must accept the terms of service to publish actions in {% data variables.product.prodname_marketplace %}.
|
||||
## Acerca de la publicación de acciones
|
||||
|
||||
## About publishing actions
|
||||
Antes de que puedas publicar una acción, deberás crear una acción en tu repositorio. Para más información, vea "[Creación de acciones](/actions/creating-actions)".
|
||||
|
||||
Before you can publish an action, you'll need to create an action in your repository. For more information, see "[Creating actions](/actions/creating-actions)."
|
||||
Cuando planeas publicar tu acción en {% data variables.product.prodname_marketplace %}, necesitarás asegurarte de que el repositorio solo incluya el archivo de metadatos, el código y los archivos necesarios para la acción. Crear un repositorio único para la acción te permite etiquetar, lanzar y empaquetar el código en una sola unidad. {% data variables.product.prodname_dotcom %} también usa los metadatos de la acción en tu página de {% data variables.product.prodname_marketplace %}.
|
||||
|
||||
When you plan to publish your action to {% data variables.product.prodname_marketplace %}, you'll need ensure that the repository only includes the metadata file, code, and files necessary for the action. Creating a single repository for the action allows you to tag, release, and package the code in a single unit. {% data variables.product.prodname_dotcom %} also uses the action's metadata on your {% data variables.product.prodname_marketplace %} page.
|
||||
Las acciones se publican en {% data variables.product.prodname_marketplace %} inmediatamente y no son revisadas por {% data variables.product.prodname_dotcom %} siempre que cumplan con estos requisitos:
|
||||
|
||||
Actions are published to {% data variables.product.prodname_marketplace %} immediately and aren't reviewed by {% data variables.product.prodname_dotcom %} as long as they meet these requirements:
|
||||
- La acción debe estar en un repositorio público.
|
||||
- Cada repositorio debe contener una sola acción.
|
||||
- El archivo de metadatos de la acción (`action.yml` o `action.yaml`) debe estar en el directorio raíz del repositorio.
|
||||
- El elemento `name` en el archivo de metadatos de la acción debe ser único.
|
||||
- El elemento `name` no debe coincidir con el nombre de una acción existente publicada en {% data variables.product.prodname_marketplace %}.
|
||||
- El elemento `name` no debe coincidir con un usuario u organización en {% data variables.product.prodname_dotcom %}, a menos que el usuario o el propietario de la organización publique la acción. Por ejemplo, solo la organización {% data variables.product.prodname_dotcom %} puede publicar una acción denominada `github`.
|
||||
- El elemento `name` no debe coincidir con una categoría existente de {% data variables.product.prodname_marketplace %}.
|
||||
- {% data variables.product.prodname_dotcom %} reserva los nombres de las funciones de {% data variables.product.prodname_dotcom %}.
|
||||
|
||||
- The action must be in a public repository.
|
||||
- Each repository must contain a single action.
|
||||
- The action's metadata file (`action.yml` or `action.yaml`) must be in the root directory of the repository.
|
||||
- The `name` in the action's metadata file must be unique.
|
||||
- The `name` cannot match an existing action name published on {% data variables.product.prodname_marketplace %}.
|
||||
- The `name` cannot match a user or organization on {% data variables.product.prodname_dotcom %}, unless the user or organization owner is publishing the action. For example, only the {% data variables.product.prodname_dotcom %} organization can publish an action named `github`.
|
||||
- The `name` cannot match an existing {% data variables.product.prodname_marketplace %} category.
|
||||
- {% data variables.product.prodname_dotcom %} reserves the names of {% data variables.product.prodname_dotcom %} features.
|
||||
## Publicación de una acción
|
||||
|
||||
## Publishing an action
|
||||
Puedes agregar la acción que has creado para {% data variables.product.prodname_marketplace %} etiquetándola como un lanzamiento nuevo y publicándola.
|
||||
|
||||
You can add the action you've created to {% data variables.product.prodname_marketplace %} by tagging it as a new release and publishing it.
|
||||
|
||||
To draft a new release and publish the action to {% data variables.product.prodname_marketplace %}, follow these instructions:
|
||||
Para preparar un nuevo lanzamiento y publicar la acción en {% data variables.product.prodname_marketplace %}, sigue estas instrucciones:
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
1. Navigate to the action metadata file in your repository (`action.yml` or `action.yaml`), and you'll see a banner to publish the action to {% data variables.product.prodname_marketplace %}. Click **Draft a release**.
|
||||
1. Navega al archivo de metadatos de acción en el repositorio (`action.yml` o `action.yaml`), verás un banner para publicar la acción en {% data variables.product.prodname_marketplace %}. Haz clic en **Borrador de una versión**.
|
||||
|
||||
|
||||
1. Under "Release Action", select the checkbox to publish the action to the {% data variables.product.prodname_marketplace %}. If you can't select the checkbox, you must first click the link to read and accept the {% data variables.product.prodname_marketplace %} Developer Agreement.
|
||||
|
||||
1. If the labels in your metadata file contain any problems, you will see an error message.
|
||||
|
||||
1. If you see any on-screen suggestions, address them by updating your metadata file. Once complete, you will see an "Everything looks good!" message.
|
||||
|
||||
1. Choose a "Primary Category" and, optionally, "Another Category" which will help people find your action in {% data variables.product.prodname_marketplace %}.
|
||||
|
||||
1. Tag your Action with a version, and add a release title. This helps people know what changes or features the release includes. People will see the version in the action's dedicated {% data variables.product.prodname_marketplace %} page.
|
||||
|
||||
1. Complete all other fields and click **Publish release**. Publishing requires you to use two-factor authentication. For more information, see "[Configuring two-factor authentication](/articles/configuring-two-factor-authentication/)."
|
||||
|
||||
|
||||
1. En "Acción de lanzamiento", activa la casilla para publicar la acción en {% data variables.product.prodname_marketplace %}. Si no puedes activar la casilla, en primer lugar debes hacer clic en el vínculo para leer y aceptar el Acuerdo para desarrolladores de {% data variables.product.prodname_marketplace %}.
|
||||
|
||||
1. Si las etiquetas en tu archivo de metadatos contienen algún problema, verás un mensaje de error.
|
||||
|
||||
1. Si ves alguna sugerencia en pantalla, la solucionas actualizando tu archivo de metadatos. Una vez que esté completo, verás un mensaje "Everything looks Good!" (Todo se ve bien). "Hola mundo".
|
||||
|
||||
1. Elige una "Primary Category" (Categoría principal) y, de manera opcional, "Another Category" (Otra categoría) que ayudará a las personas a encontrar tu acción en {% data variables.product.prodname_marketplace %}.
|
||||
|
||||
1. Etiqueta tu acción con una versión y agrega un título de lanzamiento. Esto permite que las personas conozcan qué cambios o características incluye el lanzamiento. Las personas verán la versión en la página dedicada a la acción de {% data variables.product.prodname_marketplace %}.
|
||||
|
||||
1. Completa todos los demás campos y haz clic en **Publicar versión**. La publicación requiere que uses la autenticación de dos factores. Para obtener más información, vea "[Configuración de autenticación en dos fases](/articles/configuring-two-factor-authentication/)".
|
||||
|
||||
|
||||
## Removing an action from {% data variables.product.prodname_marketplace %}
|
||||
## Eliminando una acción de {% data variables.product.prodname_marketplace %}
|
||||
|
||||
To remove a published action from {% data variables.product.prodname_marketplace %}, you'll need to update each published release. Perform the following steps for each release of the action you've published to {% data variables.product.prodname_marketplace %}.
|
||||
Para eliminar una acción publicada del {% data variables.product.prodname_marketplace %}, necesitarás actualizar cada lanzamiento publicado. Realiza los siguientes pasos para cada lanzamiento de la acción que has publicado en {% data variables.product.prodname_marketplace %}.
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %}
|
||||
{% data reusables.repositories.releases %}
|
||||
3. On the Releases page, to the right of the release you want to edit, click **Edit**.
|
||||
|
||||
4. Select **Publish this action to the {% data variables.product.prodname_marketplace %}** to remove the check from the box.
|
||||
|
||||
5. Click **Update release** at the bottom of the page.
|
||||
|
||||
{% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.releases %}
|
||||
3. En la página Versiones, a la derecha de la versión que quieres editar, haz clic en **Editar**.
|
||||
|
||||
4. Selecciona **Publicar esta acción en {% data variables.product.prodname_marketplace %}** para quitar la marca del cuadro.
|
||||
|
||||
5. En la parte inferior de la página, haz clic en **Actualizar versión**.
|
||||
|
||||
|
||||
@@ -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: es-ES
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.locfileid: '146171857'
|
||||
ms.lasthandoff: 09/09/2022
|
||||
ms.locfileid: '147878428'
|
||||
---
|
||||
{% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %}
|
||||
|
||||
@@ -42,7 +42,7 @@ Para agregar el proveedor de OIDC de {% data variables.product.prodname_dotcom %
|
||||
|
||||
Para configurar el rol y la confianza en IAM, vea la documentación de AWS sobre ["Asumir un rol"](https://github.com/aws-actions/configure-aws-credentials#assuming-a-role) y ["Creación de un rol para la identidad web o la federación de OpenID Connect"](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-idp_oidc.html).
|
||||
|
||||
Edite la relación de confianza para agregar el campo `sub` a las condiciones de validación. Por ejemplo:
|
||||
Edite la directiva de confianza para agregar el campo `sub` a las condiciones de validación. Por ejemplo:
|
||||
|
||||
```json{:copy}
|
||||
"Condition": {
|
||||
@@ -53,6 +53,33 @@ Edite la relación de confianza para agregar el campo `sub` a las condiciones de
|
||||
}
|
||||
```
|
||||
|
||||
En el ejemplo siguiente, `ForAllValues` se usa para buscar coincidencias en varias claves de condición y `StringLike` se usa para hacer coincidir cualquier referencia en el repositorio especificado. Tenga en cuenta que `ForAllValues` es [excesivamente permisivo](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_multi-value-conditions.html) y no debe usarse por sí mismo en un efecto `Allow`. En este ejemplo, la inclusión de `StringLike` significa que un conjunto vacío en `ForAllValues` seguirá sin pasar la condición:
|
||||
|
||||
```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"
|
||||
}
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
## Actualizar tu flujo de trabajo de {% data variables.product.prodname_actions %}
|
||||
|
||||
Para actualizar tus flujos de trabajo para ODIC, necesitarás hacer dos cambios a tu 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:
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
---
|
||||
title: Contexts
|
||||
title: Contextos
|
||||
shortTitle: Contexts
|
||||
intro: You can access context information in workflows and actions.
|
||||
intro: Puedes acceder a información de contexto en los flujos de trabajo y acciones.
|
||||
redirect_from:
|
||||
- /articles/contexts-and-expression-syntax-for-github-actions
|
||||
- /github/automating-your-workflow-with-github-actions/contexts-and-expression-syntax-for-github-actions
|
||||
@@ -14,65 +14,59 @@ versions:
|
||||
ghae: '*'
|
||||
ghec: '*'
|
||||
miniTocMaxHeadingLevel: 3
|
||||
ms.openlocfilehash: 787b273a9aea102e0226b936d3cd35ef6b5153b6
|
||||
ms.sourcegitcommit: 478f2931167988096ae6478a257f492ecaa11794
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: es-ES
|
||||
ms.lasthandoff: 09/09/2022
|
||||
ms.locfileid: '147782732'
|
||||
---
|
||||
{% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %}
|
||||
|
||||
{% data reusables.actions.enterprise-beta %}
|
||||
{% data reusables.actions.enterprise-github-hosted-runners %}
|
||||
## Acerca de los contextos
|
||||
|
||||
## About contexts
|
||||
Los contextos son una manera de acceder a información acerca de las ejecuciones de flujo de trabajo, los entornos del ejecutor, los trabajos y los pasos. Cada contexto es un objeto que contiene propiedades, las cuales pueden ser secuencias u otros objetos.
|
||||
|
||||
Contexts are a way to access information about workflow runs, runner environments, jobs, and steps. Each context is an object that contains properties, which can be strings or other objects.
|
||||
{% data reusables.actions.context-contents %} Por ejemplo, el contexto `matrix` solo se rellena para los trabajos de una [matriz](/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix).
|
||||
|
||||
{% data reusables.actions.context-contents %} For example, the `matrix` context is only populated for jobs in a [matrix](/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix).
|
||||
Puedes acceder a los contextos utilizando la sintaxis de expresión. Para más información, vea "[Expresiones](/actions/learn-github-actions/expressions)".
|
||||
|
||||
You can access contexts using the expression syntax. For more information, see "[Expressions](/actions/learn-github-actions/expressions)."
|
||||
|
||||
{% raw %}
|
||||
`${{ <context> }}`
|
||||
{% raw %} `${{ <context> }}`
|
||||
{% endraw %}
|
||||
|
||||
{% data reusables.actions.context-injection-warning %}
|
||||
|
||||
| Context name | Type | Description |
|
||||
| Nombre del contexto | Tipo | Descripción |
|
||||
|---------------|------|-------------|
|
||||
| `github` | `object` | Information about the workflow run. For more information, see [`github` context](#github-context). |
|
||||
| `env` | `object` | Contains environment variables set in a workflow, job, or step. For more information, see [`env` context](#env-context). |
|
||||
| `job` | `object` | Information about the currently running job. For more information, see [`job` context](#job-context). |
|
||||
{%- ifversion fpt or ghes > 3.3 or ghae-issue-4757 or ghec %}
|
||||
| `jobs` | `object` | For reusable workflows only, contains outputs of jobs from the reusable workflow. For more information, see [`jobs` context](#jobs-context). |{% endif %}
|
||||
| `steps` | `object` | Information about the steps that have been run in the current job. For more information, see [`steps` context](#steps-context). |
|
||||
| `runner` | `object` | Information about the runner that is running the current job. For more information, see [`runner` context](#runner-context). |
|
||||
| `secrets` | `object` | Contains the names and values of secrets that are available to a workflow run. For more information, see [`secrets` context](#secrets-context). |
|
||||
| `strategy` | `object` | Information about the matrix execution strategy for the current job. For more information, see [`strategy` context](#strategy-context). |
|
||||
| `matrix` | `object` | Contains the matrix properties defined in the workflow that apply to the current job. For more information, see [`matrix` context](#matrix-context). |
|
||||
| `needs` | `object` | Contains the outputs of all jobs that are defined as a dependency of the current job. For more information, see [`needs` context](#needs-context). |
|
||||
{%- ifversion fpt or ghec or ghes > 3.3 or ghae-issue-4757 %}
|
||||
| `inputs` | `object` | Contains the inputs of a reusable {% ifversion actions-unified-inputs %}or manually triggered {% endif %}workflow. For more information, see [`inputs` context](#inputs-context). |{% endif %}
|
||||
| `github` | `object` | Información sobre la ejecución del flujo de trabajo. Para más información, vea [el contexto `github`](#github-context). |
|
||||
| `env` | `object` | Contiene variables de entorno establecidas en un flujo de trabajo, trabajo o paso. Para más información, vea [el contexto `env`](#env-context). |
|
||||
| `job` | `object` | Información acerca del job que se está ejecutando actualmente. Para más información, vea [el contexto `job`](#job-context). |
|
||||
{%- ifversion fpt or ghes > 3.3 or ghae-issue-4757 or ghec %} | `jobs` | `object` | Solo para flujos de trabajo reutilizables, contiene salidas de trabajos del flujo de trabajo reutilizable. Para más información, vea [el contexto `jobs`](#jobs-context). |{% endif %} | `steps` | `object` | Información sobre los pasos que se han ejecutado en el trabajo actual. Para más información, vea [el contexto `steps`](#steps-context). | | `runner` | `object` | Información sobre el ejecutor que está realizando el trabajo actual. Para más información, vea [el contexto `runner`](#runner-context). | | `secrets` | `object` | Contiene los nombres y valores de los secretos que se encuentran disponibles para una ejecución de flujo de trabajo. Para más información, vea [el contexto `secrets`](#secrets-context). | | `strategy` | `object` | Información sobre la estrategia de ejecución de la matriz para el trabajo actual. Para más información, vea [el contexto `strategy`](#strategy-context). | | `matrix` | `object` | Contiene las propiedades de la matriz que se definen en el flujo de trabajo que aplica al trabajo actual. Para más información, vea [el contexto `matrix`](#matrix-context). | | `needs` | `object` | Contiene las salidas de todos los trabajos que se definen como una dependencia del trabajo actual. Para más información, vea [el contexto `needs`](#needs-context). | {%- ifversion fpt or ghec or ghes > 3.3 or ghae-issue-4757 %} | `inputs` | `object` | Contiene las entradas de un flujo de trabajo reutilizable {% ifversion actions-unified-inputs %} o manualmente desencadenado {% endif %}. Para más información, vea [el contexto `inputs`](#inputs-context). |{% endif %}
|
||||
|
||||
As part of an expression, you can access context information using one of two syntaxes.
|
||||
Como parte de una expresión, puedes acceder a la información de contexto utilizando una de dos sintaxis.
|
||||
|
||||
- Index syntax: `github['sha']`
|
||||
- Property dereference syntax: `github.sha`
|
||||
- Sintaxis de índice: `github['sha']`
|
||||
- Sintaxis de desreferenciación de propiedades: `github.sha`
|
||||
|
||||
In order to use property dereference syntax, the property name must start with a letter or `_` and contain only alphanumeric characters, `-`, or `_`.
|
||||
Para usar la sintaxis de desreferencia de propiedades, el nombre de la propiedad debe comenzar con una letra o `_` y solo puede incluir caracteres alfanuméricos, `-` o `_`.
|
||||
|
||||
If you attempt to dereference a non-existent property, it will evaluate to an empty string.
|
||||
Si intentas desreferenciar una propiedad inexistente, se evaluará como cadena vacía.
|
||||
|
||||
### Determining when to use contexts
|
||||
### Determinar cuándo utilizar contextos
|
||||
|
||||
{% data reusables.actions.using-context-or-environment-variables %}
|
||||
|
||||
### Context availability
|
||||
### Disponibilidad de contexto
|
||||
|
||||
Different contexts are available throughout a workflow run. For example, the `secrets` context may only be used at certain places within a job.
|
||||
Hay diferentes contextos disponibles a lo largo de un ejecutor de flujo de trabajo. Por ejemplo, el contexto `secrets` solo se puede usar en determinados puntos de un trabajo.
|
||||
|
||||
In addition, some functions may only be used in certain places. For example, the `hashFiles` function is not available everywhere.
|
||||
Adicionalmente, algunas funcionalidades solo pueden utilizarse en algunos lugares. Por ejemplo, la función `hashFiles` no está disponible en todas partes.
|
||||
|
||||
The following table indicates where each context and special function can be used within a workflow. Unless listed below, a function can be used anywhere.
|
||||
La siguiente tabla indica si cada contexto y fución especial puede utilizarse dentro de un flujo de trabajo. A menos de que se liste a continuación, las funciones se pueden utilizar donde sea.
|
||||
|
||||
{% ifversion fpt or ghes > 3.3 or ghae-issue-4757 or ghec %}
|
||||
|
||||
| Workflow key | Context | Special functions |
|
||||
| Clave de flujo de trabajo | Context | Funciones especiales |
|
||||
| ---- | ------- | ----------------- |
|
||||
| <code>concurrency</code> | <code>github, inputs</code> | |
|
||||
| <code>env</code> | <code>github, secrets, inputs</code> | |
|
||||
@@ -107,7 +101,7 @@ The following table indicates where each context and special function can be use
|
||||
| <code>on.workflow_call.inputs.<inputs_id>.default</code> | <code>github{% ifversion actions-unified-inputs %}, inputs{% endif %}</code> | |
|
||||
| <code>on.workflow_call.outputs.<output_id>.value</code> | <code>github, jobs, inputs</code> | |
|
||||
{% else %}
|
||||
| Path | Context | Special functions |
|
||||
| Ruta de acceso | Context | Funciones especiales |
|
||||
| ---- | ------- | ----------------- |
|
||||
| <code>concurrency</code> | <code>github</code> | |
|
||||
| <code>env</code> | <code>github, secrets</code> | |
|
||||
@@ -139,9 +133,9 @@ The following table indicates where each context and special function can be use
|
||||
| <code>jobs.<job_id>.timeout-minutes</code> | <code>github, needs, strategy, matrix</code> | |
|
||||
{% endif %}
|
||||
|
||||
### Example: printing context information to the log
|
||||
### Ejemplo: imprimir información de contexto a la bitácora
|
||||
|
||||
You can print the contents of contexts to the log for debugging. The [`toJSON` function](/actions/learn-github-actions/expressions#tojson) is required to pretty-print JSON objects to the log.
|
||||
Puedes imprimir el contenido de los contextos a la bitácora para la depuración. La [función `toJSON`](/actions/learn-github-actions/expressions#tojson) es necesaria para imprimir objetos JSON en el registro.
|
||||
|
||||
{% data reusables.actions.github-context-warning %}
|
||||
|
||||
@@ -170,57 +164,36 @@ jobs:
|
||||
```
|
||||
{% endraw %}
|
||||
|
||||
## `github` context
|
||||
## Contexto `github`
|
||||
|
||||
The `github` context contains information about the workflow run and the event that triggered the run. You can also read most of the `github` context data in environment variables. For more information about environment variables, see "[Using environment variables](/actions/automating-your-workflow-with-github-actions/using-environment-variables)."
|
||||
El contexto `github` contiene información sobre la ejecución del flujo de trabajo y el evento que ha desencadenado la ejecución. También puede leer la mayoría de los datos del contexto `github` en variables de entorno. Para más información sobre las variables de entorno, vea "[Uso de variables de entorno](/actions/automating-your-workflow-with-github-actions/using-environment-variables)".
|
||||
|
||||
{% data reusables.actions.github-context-warning %}
|
||||
{% data reusables.actions.context-injection-warning %}
|
||||
{% data reusables.actions.github-context-warning %} {% data reusables.actions.context-injection-warning %}
|
||||
|
||||
| Property name | Type | Description |
|
||||
| Nombre de propiedad | Tipo | Descripción |
|
||||
|---------------|------|-------------|
|
||||
| `github` | `object` | The top-level context available during any job or step in a workflow. This object contains all the properties listed below. |
|
||||
| `github.action` | `string` | The name of the action currently running, or the [`id`](/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsid) of a step. {% data variables.product.prodname_dotcom %} removes special characters, and uses the name `__run` when the current step runs a script without an `id`. If you use the same action more than once in the same job, the name will include a suffix with the sequence number with underscore before it. For example, the first script you run will have the name `__run`, and the second script will be named `__run_2`. Similarly, the second invocation of `actions/checkout` will be `actionscheckout2`. |
|
||||
| `github.action_path` | `string` | The path where an action is located. This property is only supported in composite actions. You can use this path to access files located in the same repository as the action. |
|
||||
| `github.action_ref` | `string` | For a step executing an action, this is the ref of the action being executed. For example, `v2`. |
|
||||
| `github.action_repository` | `string` | For a step executing an action, this is the owner and repository name of the action. For example, `actions/checkout`. |
|
||||
| `github.action_status` | `string` | For a composite action, the current result of the composite action. |
|
||||
| `github.actor` | `string` | {% ifversion actions-stable-actor-ids %}The username of the user that triggered the initial workflow run. If the workflow run is a re-run, this value may differ from `github.triggering_actor`. Any workflow re-runs will use the privileges of `github.actor`, even if the actor initiating the re-run (`github.triggering_actor`) has different privileges.{% else %}The username of the user that initiated the workflow run.{% endif %} |
|
||||
| `github.api_url` | `string` | The URL of the {% data variables.product.prodname_dotcom %} REST API. |
|
||||
| `github.base_ref` | `string` | The `base_ref` or target branch of the pull request in a workflow run. This property is only available when the event that triggers a workflow run is either `pull_request` or `pull_request_target`. |
|
||||
| `github.env` | `string` | Path on the runner to the file that sets environment variables from workflow commands. This file is unique to the current step and is a different file for each step in a job. For more information, see "[Workflow commands for {% data variables.product.prodname_actions %}](/actions/learn-github-actions/workflow-commands-for-github-actions#setting-an-environment-variable)." |
|
||||
| `github.event` | `object` | The full event webhook payload. You can access individual properties of the event using this context. This object is identical to the webhook payload of the event that triggered the workflow run, and is different for each event. The webhooks for each {% data variables.product.prodname_actions %} event is linked in "[Events that trigger workflows](/articles/events-that-trigger-workflows/)." For example, for a workflow run triggered by the [`push` event](/actions/using-workflows/events-that-trigger-workflows#push), this object contains the contents of the [push webhook payload](/developers/webhooks-and-events/webhooks/webhook-events-and-payloads#push). |
|
||||
| `github.event_name` | `string` | The name of the event that triggered the workflow run. |
|
||||
| `github.event_path` | `string` | The path to the file on the runner that contains the full event webhook payload. |
|
||||
| `github.graphql_url` | `string` | The URL of the {% data variables.product.prodname_dotcom %} GraphQL API. |
|
||||
| `github.head_ref` | `string` | The `head_ref` or source branch of the pull request in a workflow run. This property is only available when the event that triggers a workflow run is either `pull_request` or `pull_request_target`. |
|
||||
| `github.job` | `string` | The [`job_id`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_id) of the current job. <br /> Note: This context property is set by the Actions runner, and is only available within the execution `steps` of a job. Otherwise, the value of this property will be `null`. |
|
||||
| `github` | `object` | El contexto de nivel superior disponible durante cualquier trabajo o paso en un flujo de trabajo. Este objeto contiene todas las propiedades que se listan debajo. |
|
||||
| `github.action` | `string` | Nombre de la acción actualmente en ejecución de flujo, o bien el valor [`id`](/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsid) de un paso. {% data variables.product.prodname_dotcom %} quita caracteres especiales y usa el nombre `__run` cuando el paso actual ejecuta un script sin `id`. Si utilizas la misma acción más de una vez en el mismo job, el nombre incluirá un sufijo con el número de secuencia con un guion bajo antes de este. Por ejemplo, el primer script que ejecute tendrá el nombre `__run` y el segundo el nombre `__run_2`. Del mismo modo, la segunda invocación de `actions/checkout` será `actionscheckout2`. |
|
||||
| `github.action_path` | `string` | La ruta donde se ubica una acción. Esta propiedad solo es compatible en las acciones compuestas. Puedes utilizar esta ruta para acceder a los archivos que se ubican en el mismo repositorio que la acción. |
|
||||
| `github.action_ref` | `string` | En el caso de un paso que ejecuta una acción, esta es la ref de la acción que se está ejecutando. Por ejemplo: `v2`. |
|
||||
| `github.action_repository` | `string` | En el caso de un paso que ejecuta una acción, este es el propietario y el nombre de repositorio de la acción. Por ejemplo: `actions/checkout`. |
|
||||
| `github.action_status` | `string` | Para una acción compuesta, el resultado actual de la acción compuesta. |
|
||||
| `github.actor` | `string` | {% ifversion actions-stable-actor-ids %}Nombre del usuario que ha desencadenado la ejecución inicial del flujo de trabajo. Si la ejecución del flujo de trabajo es una repetición, este valor puede ser distinto de `github.triggering_actor`. Cualquier repetición de la ejecución de flujo de trabajo usará los privilegios de `github.actor`, incluso si el actor que inicia la repetición (`github.triggering_actor`) tiene otros privilegios.{% else %}Nombre del usuario que ha iniciado la ejecución del flujo de trabajo.{% endif %} |
|
||||
| `github.api_url` | `string` | La URL de la API de REST de {% data variables.product.prodname_dotcom %}. |
|
||||
| `github.base_ref` | `string` | `base_ref` o rama destino de la solicitud de incorporación de cambios en una ejecución de flujo de trabajo. Esta propiedad solo está disponible cuando el evento que desencadena una ejecución de flujo de trabajo es `pull_request` o `pull_request_target`. |
|
||||
| `github.env` | `string` | La ruta en el ejecutor del archivo que configura las variables de ambiente desde los comandos del flujo de trabajo. Este archivo es único para el paso actual y es un archivo diferente para cada paso en un job. Para más información, vea "[Comandos de flujo de trabajo para {% data variables.product.prodname_actions %}](/actions/learn-github-actions/workflow-commands-for-github-actions#setting-an-environment-variable)". |
|
||||
| `github.event` | `object` | La carga de webhook del evento completo. "Puedes acceder a propiedades individuales del evento que utiliza este contexto. El objeto es idéntico a la carga útil de webhook del evento que activó la ejecución de flujo de trabajo y es diferente para cada evento. Los webhooks de cada evento {% data variables.product.prodname_actions %} están vinculados en "[Eventos que desencadenan flujos de trabajo](/articles/events-that-trigger-workflows/)". Por ejemplo, para una ejecución de flujo de trabajo desencadenada por el [evento `push`](/actions/using-workflows/events-that-trigger-workflows#push), este objeto contiene el contenido de la [carga del webhook de inserción](/developers/webhooks-and-events/webhooks/webhook-events-and-payloads#push). |
|
||||
| `github.event_name` | `string` | El nombre del evento que activó la ejecución del flujo de trabajo. |
|
||||
| `github.event_path` | `string` | La ruta al archivo en el ejecutor que contiene toda la carga útil del webhook del evento. |
|
||||
| `github.graphql_url` | `string` | La URL de la API de GraphQL de {% data variables.product.prodname_dotcom %}. |
|
||||
| `github.head_ref` | `string` | `head_ref` o rama de origen de la solicitud de incorporación de cambios en una ejecución de flujo de trabajo. Esta propiedad solo está disponible cuando el evento que desencadena una ejecución de flujo de trabajo es `pull_request` o `pull_request_target`. |
|
||||
| `github.job` | `string` | El valor [`job_id`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_id) del trabajo actual. <br /> Nota: El ejecutor de acciones establece esta propiedad del contexto, la que solo está disponible dentro de los `steps` de ejecución de un trabajo. De lo contrario, el valor de esta propiedad será `null`. |
|
||||
| `github.ref` | `string` | {% data reusables.actions.ref-description %} |
|
||||
{%- ifversion fpt or ghec or ghes > 3.3 or ghae-issue-5338 %}
|
||||
| `github.ref_name` | `string` | {% data reusables.actions.ref_name-description %} |
|
||||
| `github.ref_protected` | `string` | {% data reusables.actions.ref_protected-description %} |
|
||||
| `github.ref_type` | `string` | {% data reusables.actions.ref_type-description %} |
|
||||
{%- endif %}
|
||||
| `github.path` | `string` | Path on the runner to the file that sets system `PATH` variables from workflow commands. This file is unique to the current step and is a different file for each step in a job. For more information, see "[Workflow commands for {% data variables.product.prodname_actions %}](/actions/learn-github-actions/workflow-commands-for-github-actions#adding-a-system-path)." |
|
||||
| `github.repository` | `string` | The owner and repository name. For example, `Codertocat/Hello-World`. |
|
||||
| `github.repository_owner` | `string` | The repository owner's name. For example, `Codertocat`. |
|
||||
| `github.repositoryUrl` | `string` | The Git URL to the repository. For example, `git://github.com/codertocat/hello-world.git`. |
|
||||
| `github.retention_days` | `string` | The number of days that workflow run logs and artifacts are kept. |
|
||||
| `github.run_id` | `string` | {% data reusables.actions.run_id_description %} |
|
||||
| `github.run_number` | `string` | {% data reusables.actions.run_number_description %} |
|
||||
{%- ifversion fpt or ghec or ghes > 3.5 or ghae-issue-4722 %}
|
||||
| `github.run_attempt` | `string` | A unique number for each attempt of a particular workflow run in a repository. This number begins at 1 for the workflow run's first attempt, and increments with each re-run. |
|
||||
{%- endif %}
|
||||
| `github.server_url` | `string` | The URL of the GitHub server. For example: `https://github.com`. |
|
||||
| `github.sha` | `string` | {% data reusables.actions.github_sha_description %} |
|
||||
| `github.token` | `string` | A token to authenticate on behalf of the GitHub App installed on your repository. This is functionally equivalent to the `GITHUB_TOKEN` secret. For more information, see "[Automatic token authentication](/actions/security-guides/automatic-token-authentication)." <br /> Note: This context property is set by the Actions runner, and is only available within the execution `steps` of a job. Otherwise, the value of this property will be `null`. |{% ifversion actions-stable-actor-ids %}
|
||||
| `github.triggering_actor` | `string` | The username of the user that initiated the workflow run. If the workflow run is a re-run, this value may differ from `github.actor`. Any workflow re-runs will use the privileges of `github.actor`, even if the actor initiating the re-run (`github.triggering_actor`) has different privileges. |{% endif %}
|
||||
| `github.workflow` | `string` | The name of the workflow. If the workflow file doesn't specify a `name`, the value of this property is the full path of the workflow file in the repository. |
|
||||
| `github.workspace` | `string` | The default working directory on the runner for steps, and the default location of your repository when using the [`checkout`](https://github.com/actions/checkout) action. |
|
||||
{%- ifversion fpt or ghec or ghes > 3.3 or ghae-issue-5338 %} | `github.ref_name` | `string` | {% data reusables.actions.ref_name-description %} | | `github.ref_protected` | `string` | {% data reusables.actions.ref_protected-description %} | | `github.ref_type` | `string` | {% data reusables.actions.ref_type-description %} | {%- endif %} | `github.path` | `string` | Ruta en el ejecutor al archivo que establece las variables del sistema `PATH` a partir de comandos de flujo de trabajo. Este archivo es único para el paso actual y es un archivo diferente para cada paso en un job. Para más información, vea "[Comandos de flujo de trabajo para {% data variables.product.prodname_actions %}](/actions/learn-github-actions/workflow-commands-for-github-actions#adding-a-system-path)". | | `github.repository` | `string` | Propietario y nombre del repositorio. Por ejemplo: `Codertocat/Hello-World`. | | `github.repository_owner` | `string` | Nombre del propietario del repositorio. Por ejemplo: `Codertocat`. | | `github.repositoryUrl` | `string` | URL de Git al repositorio. Por ejemplo: `git://github.com/codertocat/hello-world.git`. | | `github.retention_days` | `string` | Número de días que se conservan los registros y artefactos de ejecución del flujo de trabajo. | | `github.run_id` | `string` | {% data reusables.actions.run_id_description %} | | `github.run_number` | `string` | {% data reusables.actions.run_number_description %} | {%- ifversion fpt or ghec or ghes > 3.5 or ghae-issue-4722 %} | `github.run_attempt` | `string` | Número único para cada intento de una ejecución de flujo de trabajo concreta en un repositorio. Este número comienza en 1 para el primer intento de ejecución del flujo de trabajo e incrementa con cada re-ejecución. | {%- endif %} | `github.server_url` | `string` | URL del servidor de GitHub. Por ejemplo: `https://github.com`. | | `github.sha` | `string` | {% data reusables.actions.github_sha_description %} | | `github.token` | `string` | Un token para autenticarse en nombre de la aplicación de GitHub instalada en el repositorio. Esto es funcionalmente equivalente al secreto `GITHUB_TOKEN`. Para más información, vea "[Autenticación de token automática](/actions/security-guides/automatic-token-authentication)". <br /> Nota: El ejecutor de acciones establece esta propiedad del contexto, la que solo está disponible dentro de los `steps` de ejecución de un trabajo. De lo contrario, el valor de esta propiedad será `null`. |{% ifversion actions-stable-actor-ids %} | `github.triggering_actor` | `string` | Nombre del usuario que ha iniciado la ejecución del flujo de trabajo. Si la ejecución del flujo de trabajo es una repetición, este valor puede ser distinto de `github.actor`. Todas las repeticiones de ejecución de flujo de trabajo usarán los privilegios de `github.actor`, incluso si el actor que inicia la repetición de la ejecución (`github.triggering_actor`) tiene otros privilegios. |{% endif %} | `github.workflow` | `string` | Nombre del flujo de trabajo. Si el archivo de flujo de trabajo no especifica `name`, el valor de esta propiedad es la ruta completa del archivo del flujo de trabajo en el repositorio. | | `github.workspace` | `string` | Directorio de trabajo predeterminado en el ejecutor para los pasos y la ubicación predeterminada del repositorio al usar la acción [`checkout`](https://github.com/actions/checkout). |
|
||||
|
||||
### Example contents of the `github` context
|
||||
### Contenido de ejemplo del contexto `github`
|
||||
|
||||
The following example context is from a workflow run triggered by the `push` event. The `event` object in this example has been truncated because it is identical to the contents of the [`push` webhook payload](/developers/webhooks-and-events/webhooks/webhook-events-and-payloads#push).
|
||||
El siguiente contexto de ejemplo procede de una ejecución de flujo de trabajo desencadenada por el evento `push`. El objeto `event` de este ejemplo se ha truncado porque es idéntico al contenido de la [carga del webhook `push`](/developers/webhooks-and-events/webhooks/webhook-events-and-payloads#push).
|
||||
|
||||
{% data reusables.actions.context-example-note %}
|
||||
|
||||
@@ -262,9 +235,9 @@ The following example context is from a workflow run triggered by the `push` eve
|
||||
}
|
||||
```
|
||||
|
||||
### Example usage of the `github` context
|
||||
### Ejemplo de uso del contexto `github`
|
||||
|
||||
This example workflow uses the `github.event_name` context to run a job only if the workflow run was triggered by the `pull_request` event.
|
||||
En este flujo de trabajo de ejemplo se usa el contexto `github.event_name` para ejecutar un trabajo solo si el evento `pull_request` ha desencadenado la ejecución del flujo de trabajo.
|
||||
|
||||
```yaml{:copy}
|
||||
name: Run CI
|
||||
@@ -287,22 +260,22 @@ jobs:
|
||||
run: ./run-additional-pr-ci
|
||||
```
|
||||
|
||||
## `env` context
|
||||
## Contexto `env`
|
||||
|
||||
The `env` context contains environment variables that have been set in a workflow, job, or step. For more information about setting environment variables in your workflow, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#env)."
|
||||
El contexto `env` contiene las variables de entorno que se han establecido en un flujo de trabajo, trabajo o paso. Para más información sobre cómo establecer variables de entorno en el flujo de trabajo, vea "[Sintaxis de flujo de trabajo para {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#env)".
|
||||
|
||||
The `env` context syntax allows you to use the value of an environment variable in your workflow file. You can use the `env` context in the value of any key in a step except for the `id` and `uses` keys. For more information on the step syntax, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idsteps)."
|
||||
La sintaxis del contexto `env` permite usar el valor de una variable de entorno en el archivo de flujo de trabajo. Puede usar el contexto `env` en el valor de cualquier clave de un paso, excepto para las claves `id` y `uses`. Para más información sobre la sintaxis de pasos, vea "[Sintaxis de flujo de trabajo para {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idsteps)".
|
||||
|
||||
If you want to use the value of an environment variable inside a runner, use the runner operating system's normal method for reading environment variables.
|
||||
Si quieres usar el valor de una variable de entorno dentro de un ejecutor, usa el método normal del sistema operativo del ejecutor para leer las variables de entorno.
|
||||
|
||||
| Property name | Type | Description |
|
||||
| Nombre de propiedad | Tipo | Descripción |
|
||||
|---------------|------|-------------|
|
||||
| `env` | `object` | This context changes for each step in a job. You can access this context from any step in a job. This object contains the properties listed below. |
|
||||
| `env.<env_name>` | `string` | The value of a specific environment variable. |
|
||||
| `env` | `object` | Este contexto cambia para cada paso de un trabajo. Puedes acceder a este contexto desde cualquier paso de un trabajo. Este objeto contiene las propiedades que se listan a continuación. |
|
||||
| `env.<env_name>` | `string` | El valor de una variable de entorno específica. |
|
||||
|
||||
### Example contents of the `env` context
|
||||
### Contenido de ejemplo del contexto `env`
|
||||
|
||||
The contents of the `env` context is a mapping of environment variable names to their values. The context's contents can change depending on where it is used in the workflow run.
|
||||
El contenido del contexto `env` es una asignación de nombres de variable de entorno a sus valores. El contenido del contexto puede cambiar dependiendo de dónde se utiliza en la ejecución de flujo de trabajo.
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -311,9 +284,9 @@ The contents of the `env` context is a mapping of environment variable names to
|
||||
}
|
||||
```
|
||||
|
||||
### Example usage of the `env` context
|
||||
### Ejemplo de uso del contexto `env`
|
||||
|
||||
This example workflow shows how the `env` context can be configured at the workflow, job, and step levels, as well as using the context in steps.
|
||||
En este flujo de trabajo de ejemplo se muestra cómo se puede configurar el contexto `env` en los niveles de flujo de trabajo, trabajo y pasos, así como el uso del contexto en los pasos.
|
||||
|
||||
{% data reusables.repositories.actions-env-var-note %}
|
||||
|
||||
@@ -342,25 +315,25 @@ jobs:
|
||||
```
|
||||
{% endraw %}
|
||||
|
||||
## `job` context
|
||||
## Contexto `job`
|
||||
|
||||
The `job` context contains information about the currently running job.
|
||||
El contexto `job` contiene información sobre el trabajo actual en ejecución.
|
||||
|
||||
| Property name | Type | Description |
|
||||
| Nombre de propiedad | Tipo | Descripción |
|
||||
|---------------|------|-------------|
|
||||
| `job` | `object` | This context changes for each job in a workflow run. You can access this context from any step in a job. This object contains all the properties listed below. |
|
||||
| `job.container` | `object` | Information about the job's container. For more information about containers, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idcontainer)." |
|
||||
| `job.container.id` | `string` | The ID of the container. |
|
||||
| `job.container.network` | `string` | The ID of the container network. The runner creates the network used by all containers in a job. |
|
||||
| `job.services` | `object` | The service containers created for a job. For more information about service containers, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idservices)." |
|
||||
| `job.services.<service_id>.id` | `string` | The ID of the service container. |
|
||||
| `job.services.<service_id>.network` | `string` | The ID of the service container network. The runner creates the network used by all containers in a job. |
|
||||
| `job.services.<service_id>.ports` | `object` | The exposed ports of the service container. |
|
||||
| `job.status` | `string` | The current status of the job. Possible values are `success`, `failure`, or `cancelled`. |
|
||||
| `job` | `object` | Este contexto cambia para cada trabajo de una ejecución de flujo de trabajo. Puedes acceder a este contexto desde cualquier paso de un trabajo. Este objeto contiene todas las propiedades que se listan debajo. |
|
||||
| `job.container` | `object` | Información sobre el contenedor del trabajo. Para más información sobre los contenedores, vea "[Sintaxis de flujo de trabajo para {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idcontainer)". |
|
||||
| `job.container.id` | `string` | La ID del contenedor. |
|
||||
| `job.container.network` | `string` | La ID de la red del contenedor. El ejecutor crea la red usada por todos los contenedores en un trabajo. |
|
||||
| `job.services` | `object` | Los contenedores de servicios creados para un trabajo. Para más información sobre los contenedores de servicio, vea "[Sintaxis de flujo de trabajo para {% data variables.product.prodname_actions %}](/articles/workflow-syntax-for-github-actions#jobsjob_idservices)". |
|
||||
| `job.services.<service_id>.id` | `string` | La ID del contenedor de servicio. |
|
||||
| `job.services.<service_id>.network` | `string` | La ID de la red de contenedor de servicio. El ejecutor crea la red usada por todos los contenedores en un trabajo. |
|
||||
| `job.services.<service_id>.ports` | `object` | Los puertos expuestos del contenedor del servicio. |
|
||||
| `job.status` | `string` | Estado actual del trabajo. Los valores posibles son `success`, `failure` o `cancelled`. |
|
||||
|
||||
### Example contents of the `job` context
|
||||
### Contenido de ejemplo del contexto `job`
|
||||
|
||||
This example `job` context uses a PostgreSQL service container with mapped ports. If there are no containers or service containers used in a job, the `job` context only contains the `status` property.
|
||||
En este contexto `job` de ejemplo se usa un contenedor de servicio de PostgreSQL con puertos asignados. Si en un trabajo no se usan contenedores ni contenedores de servicio, el contexto `job` solo contiene la propiedad `status`.
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -380,9 +353,9 @@ This example `job` context uses a PostgreSQL service container with mapped ports
|
||||
}
|
||||
```
|
||||
|
||||
### Example usage of the `job` context
|
||||
### Ejemplo de uso del contexto `job`
|
||||
|
||||
This example workflow configures a PostgreSQL service container, and automatically maps port 5432 in the service container to a randomly chosen available port on the host. The `job` context is used to access the number of the port that was assigned on the host.
|
||||
Este flujo de trabajo de ejemplo configura un contenedor de servicio de PostgreSQL y, automáticamente, mapea el puerto 5432 en el contenedor de servicio a un puerto disponible elegido aleatoriamente en el host. El contexto `job` se usa para acceder al número del puerto que se ha asignado en el host.
|
||||
|
||||
```yaml{:copy}
|
||||
name: PostgreSQL Service Example
|
||||
@@ -408,20 +381,20 @@ jobs:
|
||||
|
||||
{% ifversion fpt or ghes > 3.3 or ghae-issue-4757 or ghec %}
|
||||
|
||||
## `jobs` context
|
||||
## Contexto `jobs`
|
||||
|
||||
The `jobs` context is only available in reusable workflows, and can only be used to set outputs for a reusable workflow. For more information, see "[Reusing workflows](/actions/using-workflows/reusing-workflows#using-outputs-from-a-reusable-workflow)."
|
||||
El `jobs` contexto solo está disponible en flujos de trabajo reutilizables y solo se puede usar para establecer salidas para un flujo de trabajo reutilizable. Para más información, vea "[Reutilización de flujos de trabajo](/actions/using-workflows/reusing-workflows#using-outputs-from-a-reusable-workflow)".
|
||||
|
||||
| Property name | Type | Description |
|
||||
| Nombre de propiedad | Tipo | Descripción |
|
||||
|---------------|------|-------------|
|
||||
| `jobs` | `object` | This is only available in reusable workflows, and can only be used to set outputs for a reusable workflow. This object contains all the properties listed below.
|
||||
| `jobs.<job_id>.result` | `string` | The result of a job in the reusable workflow. Possible values are `success`, `failure`, `cancelled`, or `skipped`. |
|
||||
| `jobs.<job_id>.outputs` | `object` | The set of outputs of a job in a reusable workflow. |
|
||||
| `jobs.<job_id>.outputs.<output_name>` | `string` | The value of a specific output for a job in a reusable workflow. |
|
||||
| `jobs` | `object` | Esto solo está disponible en flujos de trabajo reutilizables y solo se puede usar para establecer salidas para un flujo de trabajo reutilizable. Este objeto contiene todas las propiedades que se listan debajo.
|
||||
| `jobs.<job_id>.result` | `string` | El resultado de un trabajo en el flujo de trabajo reutilizable. Los valores posibles son `success`, `failure`, `cancelled` o `skipped`. |
|
||||
| `jobs.<job_id>.outputs` | `object` | Conjunto de salidas de un trabajo en un flujo de trabajo reutilizable. |
|
||||
| `jobs.<job_id>.outputs.<output_name>` | `string` | El valor de una salida específica para un trabajo en un flujo de trabajo reutilizable. |
|
||||
|
||||
### Example contents of the `jobs` context
|
||||
### Contenido de ejemplo del contexto `jobs`
|
||||
|
||||
This example `jobs` context contains the result and outputs of a job from a reusable workflow run.
|
||||
Este contexto `jobs` de ejemplo contiene el resultado y las salidas de un trabajo a partir de una ejecución de flujo de trabajo reutilizable.
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -435,9 +408,9 @@ This example `jobs` context contains the result and outputs of a job from a reus
|
||||
}
|
||||
```
|
||||
|
||||
### Example usage of the `jobs` context
|
||||
### Ejemplo de uso del contexto `jobs`
|
||||
|
||||
This example reusable workflow uses the `jobs` context to set outputs for the reusable workflow. Note how the outputs flow up from the steps, to the job, then to the `workflow_call` trigger. For more information, see "[Reusing workflows](/actions/using-workflows/reusing-workflows#using-outputs-from-a-reusable-workflow)."
|
||||
Este flujo de trabajo reutilizable de ejemplo usa el contexto `jobs` para establecer salidas para el flujo de trabajo reutilizable. Observa cómo las salidas fluyen desde los pasos hasta el trabajo y, a continuación, al desencadenador `workflow_call`. Para más información, vea "[Reutilización de flujos de trabajo](/actions/using-workflows/reusing-workflows#using-outputs-from-a-reusable-workflow)".
|
||||
|
||||
{% raw %}
|
||||
```yaml{:copy}
|
||||
@@ -472,21 +445,21 @@ jobs:
|
||||
|
||||
{% endif %}
|
||||
|
||||
## `steps` context
|
||||
## Contexto `steps`
|
||||
|
||||
The `steps` context contains information about the steps in the current job that have an [`id`](/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsid) specified and have already run.
|
||||
El contexto `steps` contiene información sobre los pasos del trabajo actual en los que se ha especificado [`id`](/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsid) y ya se han ejecutado.
|
||||
|
||||
| Property name | Type | Description |
|
||||
| Nombre de propiedad | Tipo | Descripción |
|
||||
|---------------|------|-------------|
|
||||
| `steps` | `object` | This context changes for each step in a job. You can access this context from any step in a job. This object contains all the properties listed below. |
|
||||
| `steps.<step_id>.outputs` | `object` | The set of outputs defined for the step. For more information, see "[Metadata syntax for {% data variables.product.prodname_actions %}](/articles/metadata-syntax-for-github-actions#outputs-for-docker-container-and-javascript-actions)." |
|
||||
| `steps.<step_id>.conclusion` | `string` | The result of a completed step after [`continue-on-error`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepscontinue-on-error) is applied. Possible values are `success`, `failure`, `cancelled`, or `skipped`. When a `continue-on-error` step fails, the `outcome` is `failure`, but the final `conclusion` is `success`. |
|
||||
| `steps.<step_id>.outcome` | `string` | The result of a completed step before [`continue-on-error`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepscontinue-on-error) is applied. Possible values are `success`, `failure`, `cancelled`, or `skipped`. When a `continue-on-error` step fails, the `outcome` is `failure`, but the final `conclusion` is `success`. |
|
||||
| `steps.<step_id>.outputs.<output_name>` | `string` | The value of a specific output. |
|
||||
| `steps` | `object` | Este contexto cambia para cada paso de un trabajo. Puedes acceder a este contexto desde cualquier paso de un trabajo. Este objeto contiene todas las propiedades que se listan debajo. |
|
||||
| `steps.<step_id>.outputs` | `object` | El conjunto de salidas definido para el paso. Para más información, vea "[Sintaxis de metadatos para {% data variables.product.prodname_actions %}](/articles/metadata-syntax-for-github-actions#outputs-for-docker-container-and-javascript-actions)". |
|
||||
| `steps.<step_id>.conclusion` | `string` | El resultado de un paso completado después de aplicar [`continue-on-error`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepscontinue-on-error). Los valores posibles son `success`, `failure`, `cancelled` o `skipped`. Cuando se produce un error en un paso `continue-on-error`, `outcome` es `failure`, pero el valor `conclusion` final es `success`. |
|
||||
| `steps.<step_id>.outcome` | `string` | El resultado de un paso completado antes de aplicar [`continue-on-error`](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idstepscontinue-on-error). Los valores posibles son `success`, `failure`, `cancelled` o `skipped`. Cuando se produce un error en un paso `continue-on-error`, `outcome` es `failure`, pero el valor `conclusion` final es `success`. |
|
||||
| `steps.<step_id>.outputs.<output_name>` | `string` | El valor de un resultado específico. |
|
||||
|
||||
### Example contents of the `steps` context
|
||||
### Contenido de ejemplo del contexto `steps`
|
||||
|
||||
This example `steps` context shows two previous steps that had an [`id`](/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsid) specified. The first step had the `id` named `checkout`, the second `generate_number`. The `generate_number` step had an output named `random_number`.
|
||||
En este contexto `steps` de ejemplo se muestran dos pasos anteriores en los que se ha especificado [`id`](/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsid). El primer paso tenía el `id` denominado `checkout`, el segundo `generate_number`. El paso `generate_number` tenía una salida denominada `random_number`.
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -505,9 +478,9 @@ This example `steps` context shows two previous steps that had an [`id`](/action
|
||||
}
|
||||
```
|
||||
|
||||
### Example usage of the `steps` context
|
||||
### Ejemplo de uso del contexto `steps`
|
||||
|
||||
This example workflow generates a random number as an output in one step, and a later step uses the `steps` context to read the value of that output.
|
||||
En este flujo de trabajo de ejemplo se genera un número aleatorio como salida en un paso y, en un paso posterior se usa el contexto `steps` para leer el valor de esa salida.
|
||||
|
||||
```yaml{:copy}
|
||||
name: Generate random failure
|
||||
@@ -526,13 +499,13 @@ jobs:
|
||||
if [[ {% raw %}${{ steps.generate_number.outputs.random_number }}{% endraw %} == 0 ]]; then exit 0; else exit 1; fi
|
||||
```
|
||||
|
||||
## `runner` context
|
||||
## Contexto `runner`
|
||||
|
||||
The `runner` context contains information about the runner that is executing the current job.
|
||||
El contexto `runner` contiene información sobre el ejecutor que ejecuta el trabajo actual.
|
||||
|
||||
| Property name | Type | Description |
|
||||
| Nombre de propiedad | Tipo | Descripción |
|
||||
|---------------|------|-------------|
|
||||
| `runner` | `object` | This context changes for each job in a workflow run. This object contains all the properties listed below. |
|
||||
| `runner` | `object` | Este contexto cambia para cada trabajo de una ejecución de flujo de trabajo. Este objeto contiene todas las propiedades que se listan debajo. |
|
||||
| `runner.name` | `string` | {% data reusables.actions.runner-name-description %} |
|
||||
| `runner.os` | `string` | {% data reusables.actions.runner-os-description %} |{% ifversion actions-runner-arch-envvars %}
|
||||
| `runner.arch` | `string` | {% data reusables.actions.runner-arch-description %} |{% endif %}
|
||||
@@ -540,14 +513,12 @@ The `runner` context contains information about the runner that is executing the
|
||||
| `runner.tool_cache` | `string` | {% ifversion ghae %}{% data reusables.actions.self-hosted-runners-software %} {% else %} {% data reusables.actions.runner-tool-cache-description %} {% endif %}|
|
||||
| `runner.debug` | `string` | {% data reusables.actions.runner-debug-description %} |
|
||||
|
||||
{%- comment %}
|
||||
The `runner.workspace` property is purposefully not documented. It is an early Actions property that now isn't relevant for users, compared to `github.workspace`. It is kept around for compatibility.
|
||||
| `runner.workspace` | `string` | |
|
||||
{%- endcomment %}
|
||||
{%- comment %} La propiedad La `runner.workspace` propiedad no está documentada correctamente no está documentada correctamente. Es una propiedad anterior de Acciones que ahora no es pertinente para los usuarios, en comparación con `github.workspace`. Esta se mantiene por compatibilidad.
|
||||
| `runner.workspace` | `string` | | {%- endcomment %}
|
||||
|
||||
### Example contents of the `runner` context
|
||||
### Contenido de ejemplo del contexto `runner`
|
||||
|
||||
The following example context is from a Linux {% data variables.product.prodname_dotcom %}-hosted runner.
|
||||
El siguiente contexto de ejemplo es de un ejecutor Linux hospedado en {% data variables.product.prodname_dotcom %}.
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -563,9 +534,9 @@ The following example context is from a Linux {% data variables.product.prodname
|
||||
}
|
||||
```
|
||||
|
||||
### Example usage of the `runner` context
|
||||
### Ejemplo de uso del contexto `runner`
|
||||
|
||||
This example workflow uses the `runner` context to set the path to the temporary directory to write logs, and if the workflow fails, it uploads those logs as artifact.
|
||||
En este flujo de trabajo de ejemplo se usa el contexto `runner` a fin de configurar la ruta al directorio temporal para escribir registros y, si se produce un error en el flujo de trabajo, los carga como artefacto.
|
||||
|
||||
```yaml{:copy}
|
||||
name: Build
|
||||
@@ -588,23 +559,23 @@ jobs:
|
||||
path: {% raw %}${{ runner.temp }}{% endraw %}/build_logs
|
||||
```
|
||||
|
||||
## `secrets` context
|
||||
## Contexto `secrets`
|
||||
|
||||
The `secrets` context contains the names and values of secrets that are available to a workflow run. The `secrets` context is not available for composite actions. For more information about secrets, see "[Encrypted secrets](/actions/security-guides/encrypted-secrets)."
|
||||
El contexto `secrets` contiene los nombres y valores de los secretos disponibles para una ejecución de flujo de trabajo. El contexto `secrets` no está disponible para acciones compuestas. Para más información sobre los secretos, vea "[Secretos cifrados](/actions/security-guides/encrypted-secrets)".
|
||||
|
||||
`GITHUB_TOKEN` is a secret that is automatically created for every workflow run, and is always included in the `secrets` context. For more information, see "[Automatic token authentication](/actions/security-guides/automatic-token-authentication)."
|
||||
`GITHUB_TOKEN` es un secreto que se crea automáticamente para cada ejecución de flujo de trabajo y siempre se incluye en el contexto `secrets`. Para más información, vea "[Autenticación de token automática](/actions/security-guides/automatic-token-authentication)".
|
||||
|
||||
{% data reusables.actions.secrets-redaction-warning %}
|
||||
|
||||
| Property name | Type | Description |
|
||||
| Nombre de propiedad | Tipo | Descripción |
|
||||
|---------------|------|-------------|
|
||||
| `secrets` | `object` | This context is the same for each job in a workflow run. You can access this context from any step in a job. This object contains all the properties listed below. |
|
||||
| `secrets.GITHUB_TOKEN` | `string` | Automatically created token for each workflow run. For more information, see "[Automatic token authentication](/actions/security-guides/automatic-token-authentication)." |
|
||||
| `secrets.<secret_name>` | `string` | The value of a specific secret. |
|
||||
| `secrets` | `object` | Este contexto es el mismo para cada job en una ejecución de flujo de trabajo. Puedes acceder a este contexto desde cualquier paso de un trabajo. Este objeto contiene todas las propiedades que se listan debajo. |
|
||||
| `secrets.GITHUB_TOKEN` | `string` | Token creado automáticamente para cada ejecución de flujo de trabajo. Para más información, vea "[Autenticación de token automática](/actions/security-guides/automatic-token-authentication)". |
|
||||
| `secrets.<secret_name>` | `string` | El valor de un secreto específico. |
|
||||
|
||||
### Example contents of the `secrets` context
|
||||
### Contenido de ejemplo del contexto `secrets`
|
||||
|
||||
The following example contents of the `secrets` context shows the automatic `GITHUB_TOKEN`, as well as two other secrets available to the workflow run.
|
||||
En el contenido de ejemplo siguiente del contexto `secrets` se muestra el valor `GITHUB_TOKEN` automático, así como otros dos secretos disponibles para la ejecución del flujo de trabajo.
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -614,25 +585,25 @@ The following example contents of the `secrets` context shows the automatic `GIT
|
||||
}
|
||||
```
|
||||
|
||||
### Example usage of the `secrets` context
|
||||
### Ejemplo de uso del contexto `secrets`
|
||||
|
||||
{% data reusables.actions.github_token-input-example %}
|
||||
|
||||
## `strategy` context
|
||||
## Contexto `strategy`
|
||||
|
||||
For workflows with a matrix, the `strategy` context contains information about the matrix execution strategy for the current job.
|
||||
Para los flujos de trabajo con una matriz, el contexto `strategy` contiene información sobre la estrategia de ejecución de matrices para el trabajo actual.
|
||||
|
||||
| Property name | Type | Description |
|
||||
| Nombre de propiedad | Tipo | Descripción |
|
||||
|---------------|------|-------------|
|
||||
| `strategy` | `object` | This context changes for each job in a workflow run. You can access this context from any job or step in a workflow. This object contains all the properties listed below. |
|
||||
| `strategy.fail-fast` | `string` | When `true`, all in-progress jobs are canceled if any job in a matrix fails. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategyfail-fast)." |
|
||||
| `strategy.job-index` | `string` | The index of the current job in the matrix. **Note:** This number is a zero-based number. The first job's index in the matrix is `0`. |
|
||||
| `strategy.job-total` | `string` | The total number of jobs in the matrix. **Note:** This number **is not** a zero-based number. For example, for a matrix with four jobs, the value of `job-total` is `4`. |
|
||||
| `strategy.max-parallel` | `string` | The maximum number of jobs that can run simultaneously when using a `matrix` job strategy. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymax-parallel)." |
|
||||
| `strategy` | `object` | Este contexto cambia para cada trabajo de una ejecución de flujo de trabajo. Puedes acceder a este contexto desde cualquier job o paso en un flujo de trabajo. Este objeto contiene todas las propiedades que se listan debajo. |
|
||||
| `strategy.fail-fast` | `string` | Cuando es `true`, todos los trabajos en curso se cancelan si se produce un error en algún trabajo de una matriz. Para más información, vea "[Sintaxis de flujo de trabajo para {% data variables.product.prodname_actions %}](/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategyfail-fast)". |
|
||||
| `strategy.job-index` | `string` | El índice del trabajo actual en la matriz. **Nota:** Este número es un número de base cero. El índice del primer trabajo en la matriz es `0`. |
|
||||
| `strategy.job-total` | `string` | El número total de trabajos en la matriz. **Nota:** Este número **no es** un número de base cero. Por ejemplo, para una matriz con cuatro trabajos, el valor de `job-total` es `4`. |
|
||||
| `strategy.max-parallel` | `string` | El número máximo de trabajos que se pueden ejecutar simultáneamente al usar una estrategia de trabajo `matrix`. Para más información, vea "[Sintaxis de flujo de trabajo para {% data variables.product.prodname_actions %}](/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymax-parallel)". |
|
||||
|
||||
### Example contents of the `strategy` context
|
||||
### Contenido de ejemplo del contexto `strategy`
|
||||
|
||||
The following example contents of the `strategy` context is from a matrix with four jobs, and is taken from the final job. Note the difference between the zero-based `job-index` number, and `job-total` which is not zero-based.
|
||||
El contenido de ejemplo siguiente del contexto `strategy` procede de una matriz con cuatro trabajos y se toma del trabajo final. Observe la diferencia entre el número `job-index` de base cero y `job-total`, que no es de base cero.
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -643,9 +614,9 @@ The following example contents of the `strategy` context is from a matrix with f
|
||||
}
|
||||
```
|
||||
|
||||
### Example usage of the `strategy` context
|
||||
### Ejemplo de uso del contexto `strategy`
|
||||
|
||||
This example workflow uses the `strategy.job-index` property to set a unique name for a log file for each job in a matrix.
|
||||
En este flujo de trabajo de ejemplo se usa la propiedad `strategy.job-index` a fin de establecer un nombre único para un archivo de registro para cada trabajo de una matriz.
|
||||
|
||||
```yaml{:copy}
|
||||
name: Test matrix
|
||||
@@ -668,20 +639,20 @@ jobs:
|
||||
path: test-job-{% raw %}${{ strategy.job-index }}{% endraw %}.txt
|
||||
```
|
||||
|
||||
## `matrix` context
|
||||
## Contexto `matrix`
|
||||
|
||||
For workflows with a matrix, the `matrix` context contains the matrix properties defined in the workflow file that apply to the current job. For example, if you configure a matrix with the `os` and `node` keys, the `matrix` context object includes the `os` and `node` properties with the values that are being used for the current job.
|
||||
Para los flujos de trabajo con una matriz, el contexto `matrix` contiene las propiedades de matriz definidas en el archivo de flujo de trabajo que se aplican al trabajo actual. Por ejemplo, si configuras una matriz con las claves `os` y `node`, el objeto de contexto `matrix` incluye las propiedades `os` y `node` con los valores que se usan para el trabajo actual.
|
||||
|
||||
There are no standard properties in the `matrix` context, only those which are defined in the workflow file.
|
||||
No hay propiedades estándar en el contexto `matrix`, solo las definidas en el archivo de flujo de trabajo.
|
||||
|
||||
| Property name | Type | Description |
|
||||
| Nombre de propiedad | Tipo | Descripción |
|
||||
|---------------|------|-------------|
|
||||
| `matrix` | `object` | This context is only available for jobs in a matrix, and changes for each job in a workflow run. You can access this context from any job or step in a workflow. This object contains the properties listed below. |
|
||||
| `matrix.<property_name>` | `string` | The value of a matrix property. |
|
||||
| `matrix` | `object` | Este contexto solo está disponible para los trabajos de una matriz y cambia para cada trabajo en una ejecución de flujo de trabajo. Puedes acceder a este contexto desde cualquier job o paso en un flujo de trabajo. Este objeto contiene las propiedades que se listan a continuación. |
|
||||
| `matrix.<property_name>` | `string` | El valor de una propiedad de matriz. |
|
||||
|
||||
### Example contents of the `matrix` context
|
||||
### Contenido de ejemplo del contexto `matrix`
|
||||
|
||||
The following example contents of the `matrix` context is from a job in a matrix that has the `os` and `node` matrix properties defined in the workflow. The job is executing the matrix combination of an `ubuntu-latest` OS and Node.js version `16`.
|
||||
El contenido de ejemplo siguiente del contexto `matrix` procede de un trabajo de una matriz que tiene las propiedades de matriz `os` y `node` definidas en el flujo de trabajo. El trabajo ejecuta la combinación de matriz de un sistema operativo `ubuntu-latest` y la versión `16` de Node.js.
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -690,9 +661,9 @@ The following example contents of the `matrix` context is from a job in a matrix
|
||||
}
|
||||
```
|
||||
|
||||
### Example usage of the `matrix` context
|
||||
### Ejemplo de uso del contexto `matrix`
|
||||
|
||||
This example workflow creates a matrix with `os` and `node` keys. It uses the `matrix.os` property to set the runner type for each job, and uses the `matrix.node` property to set the Node.js version for each job.
|
||||
Este flujo de trabajo de ejemplo crea una matriz con las claves `os` y `node`. Usa la propiedad `matrix.os` para establecer el tipo de ejecutor para cada trabajo y la propiedad `matrix.node` a fin de establecer la versión de Node.js para cada trabajo.
|
||||
|
||||
```yaml{:copy}
|
||||
name: Test matrix
|
||||
@@ -716,21 +687,21 @@ jobs:
|
||||
run: npm test
|
||||
```
|
||||
|
||||
## `needs` context
|
||||
## Contexto `needs`
|
||||
|
||||
The `needs` context contains outputs from all jobs that are defined as a dependency of the current job. For more information on defining job dependencies, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idneeds)."
|
||||
El contexto `needs` contiene salidas de todos los trabajos que se definen como una dependencia del trabajo actual. Para más información sobre la definición de dependencias de trabajos, vea "[Sintaxis de flujo de trabajo para {% data variables.product.prodname_actions %}](/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idneeds)".
|
||||
|
||||
| Property name | Type | Description |
|
||||
| Nombre de propiedad | Tipo | Descripción |
|
||||
|---------------|------|-------------|
|
||||
| `needs` | `object` | This context is only populated for workflow runs that have dependent jobs, and changes for each job in a workflow run. You can access this context from any job or step in a workflow. This object contains all the properties listed below. |
|
||||
| `needs.<job_id>` | `object` | A single job that the current job depends on. |
|
||||
| `needs.<job_id>.outputs` | `object` | The set of outputs of a job that the current job depends on. |
|
||||
| `needs.<job_id>.outputs.<output name>` | `string` | The value of a specific output for a job that the current job depends on. |
|
||||
| `needs.<job_id>.result` | `string` | The result of a job that the current job depends on. Possible values are `success`, `failure`, `cancelled`, or `skipped`. |
|
||||
| `needs` | `object` | Este contexto solo se llena con ejecuciones de flujo de trabajo que tienen jobs dependientes y cambios para cada job en una ejecución de flujo de trabajo. Puedes acceder a este contexto desde cualquier job o paso en un flujo de trabajo. Este objeto contiene todas las propiedades que se listan debajo. |
|
||||
| `needs.<job_id>` | `object` | Un solo job del cual depende el job actual. |
|
||||
| `needs.<job_id>.outputs` | `object` | El conjunto de resultados de un job del cual depende el job actual. |
|
||||
| `needs.<job_id>.outputs.<output name>` | `string` | El valor de un resultado específico para un job del cual depende el job actual. |
|
||||
| `needs.<job_id>.result` | `string` | El resultado de un job del cual depende el job actual. Los valores posibles son `success`, `failure`, `cancelled` o `skipped`. |
|
||||
|
||||
### Example contents of the `needs` context
|
||||
### Contenido de ejemplo del contexto `needs`
|
||||
|
||||
The following example contents of the `needs` context shows information for two jobs that the current job depends on.
|
||||
En el contenido de ejemplo siguiente del contexto `needs` se muestra información para dos trabajos de los que depende el trabajo actual.
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -747,9 +718,9 @@ The following example contents of the `needs` context shows information for two
|
||||
}
|
||||
```
|
||||
|
||||
### Example usage of the `needs` context
|
||||
### Ejemplo de uso del contexto `needs`
|
||||
|
||||
This example workflow has three jobs: a `build` job that does a build, a `deploy` job that requires the `build` job, and a `debug` job that requires both the `build` and `deploy` jobs and runs only if there is a failure in the workflow. The `deploy` job also uses the `needs` context to access an output from the `build` job.
|
||||
Este flujo de trabajo de ejemplo tiene tres trabajos: un trabajo `build` que realiza una compilación, un trabajo `deploy` que necesita el trabajo `build` y un trabajo `debug` que necesita los trabajos `build` y `deploy`, y que solo se ejecuta si se produce un error en el flujo de trabajo. El trabajo `deploy` también usa el contexto `needs` para acceder a una salida del trabajo `build`.
|
||||
|
||||
```yaml{:copy}
|
||||
name: Build and deploy
|
||||
@@ -783,22 +754,22 @@ jobs:
|
||||
```
|
||||
|
||||
{% ifversion fpt or ghec or ghes > 3.3 or ghae-issue-4757 %}
|
||||
## `inputs` context
|
||||
## Contexto `inputs`
|
||||
|
||||
The `inputs` context contains input properties passed to a reusable workflow{% ifversion actions-unified-inputs %} or to a manually triggered workflow{% endif %}. {% ifversion actions-unified-inputs %}For reusable workflows, the{% else %}The{% endif %} input names and types are defined in the [`workflow_call` event configuration](/actions/learn-github-actions/events-that-trigger-workflows#workflow-reuse-events) of a reusable workflow, and the input values are passed from [`jobs.<job_id>.with`](/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idwith) in an external workflow that calls the reusable workflow. {% ifversion actions-unified-inputs %}For manually triggered workflows, the inputs are defined in the [`workflow_dispatch` event configuration](/actions/learn-github-actions/events-that-trigger-workflows#workflow_dispatch) of a workflow.{% endif %}
|
||||
El contexto `inputs` contiene propiedades de entrada pasadas a un flujo de trabajo reutilizable{% ifversion actions-unified-inputs %} o a un flujo de trabajo manualmente desencadenado{% endif %}. {% ifversion actions-unified-inputs %}En el caso de los flujos de trabajo reutilizables, los{% else %}Los{% endif %} tipos y nombres de entrada están definidos en la [`workflow_call`configuración del evento](/actions/learn-github-actions/events-that-trigger-workflows#workflow-reuse-events) de un flujo de trabajo reutilizable y los valores de entrada se pasan desde [`jobs.<job_id>.with`](/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idwith) en un flujo de trabajo externo que llama al flujo de trabajo reutilizable. {% ifversion actions-unified-inputs %}En el caso de los flujos de trabajo manualmente desencadenados, las entradas se define en la [`workflow_dispatch`configuración del evento](/actions/learn-github-actions/events-that-trigger-workflows#workflow_dispatch) de un flujo de trabajo.{% endif %}
|
||||
|
||||
There are no standard properties in the `inputs` context, only those which are defined in the workflow file.
|
||||
No hay propiedades estándar en el contexto `inputs`, solo las definidas en el archivo de flujo de trabajo.
|
||||
|
||||
{% data reusables.actions.reusable-workflows-ghes-beta %}
|
||||
|
||||
| Property name | Type | Description |
|
||||
| Nombre de propiedad | Tipo | Descripción |
|
||||
|---------------|------|-------------|
|
||||
| `inputs` | `object` | This context is only available in a [reusable workflow](/actions/learn-github-actions/reusing-workflows){% ifversion actions-unified-inputs %} or in a workflow triggered by the [`workflow_dispatch` event](/actions/learn-github-actions/events-that-trigger-workflows#workflow_dispatch){% endif %}. You can access this context from any job or step in a workflow. This object contains the properties listed below. |
|
||||
| `inputs.<name>` | `string` or `number` or `boolean` | Each input value passed from an external workflow. |
|
||||
| `inputs` | `object` | Este contexto solo está disponible en un [flujo de trabajo reutilizable](/actions/learn-github-actions/reusing-workflows){% ifversion actions-unified-inputs %} o en un flujo de trabajo desencadenado por el [`workflow_dispatch`evento](/actions/learn-github-actions/events-that-trigger-workflows#workflow_dispatch) {% endif %}. Puedes acceder a este contexto desde cualquier job o paso en un flujo de trabajo. Este objeto contiene las propiedades que se listan a continuación. |
|
||||
| `inputs.<name>` | `string`, `number` o `boolean` | Cada valor de entrada que pasa desde un flujo de trabajo externo. |
|
||||
|
||||
### Example contents of the `inputs` context
|
||||
### Contenido de ejemplo del contexto `inputs`
|
||||
|
||||
The following example contents of the `inputs` context is from a workflow that has defined the `build_id`, `deploy_target`, and `perform_deploy` inputs.
|
||||
El contenido de ejemplo siguiente del contexto `inputs` proviene de un flujo de trabajo que tiene definidas las entradas `build_id`, `deploy_target` y `perform_deploy`.
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -808,9 +779,9 @@ The following example contents of the `inputs` context is from a workflow that h
|
||||
}
|
||||
```
|
||||
|
||||
### Example usage of the `inputs` context in a reusable workflow
|
||||
### Ejemplo de uso del contexto `inputs` en un flujo de trabajo reutilizable
|
||||
|
||||
This example reusable workflow uses the `inputs` context to get the values of the `build_id`, `deploy_target`, and `perform_deploy` inputs that were passed to the reusable workflow from the caller workflow.
|
||||
En este flujo de trabajo reutilizable de ejemplo, se usa el contexto `inputs` para obtener los valores de las entradas `build_id`, `deploy_target` y `perform_deploy` que se pasaron al flujo de trabajo reutilizable desde el flujo de trabajo del autor de la llamada.
|
||||
|
||||
{% raw %}
|
||||
```yaml{:copy}
|
||||
@@ -839,9 +810,9 @@ jobs:
|
||||
{% endraw %}
|
||||
|
||||
{% ifversion actions-unified-inputs %}
|
||||
### Example usage of the `inputs` context in a manually triggered workflow
|
||||
### Ejemplo del uso del contexto `inputs` en un flujo de trabajo manualmente desencadenado
|
||||
|
||||
This example workflow triggered by a `workflow_dispatch` event uses the `inputs` context to get the values of the `build_id`, `deploy_target`, and `perform_deploy` inputs that were passed to the workflow.
|
||||
En este flujo de trabajo de ejemplo desencadenado por un evento`workflow_dispatch`, se usa el contexto `inputs` para obtener los valores de las entradas `build_id`, `deploy_target` y `perform_deploy` que se pasaron al flujo de trabajo.
|
||||
|
||||
{% raw %}
|
||||
```yaml{:copy}
|
||||
@@ -866,7 +837,6 @@ jobs:
|
||||
- name: Deploy build to target
|
||||
run: deploy --build ${{ inputs.build_id }} --target ${{ inputs.deploy_target }}
|
||||
```
|
||||
{% endraw %}
|
||||
{% endif %}
|
||||
{% endraw %} {% endif %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
@@ -7,17 +7,17 @@ versions:
|
||||
type: tutorial
|
||||
shortTitle: 'Controlling access to {% data variables.actions.hosted_runner %}s'
|
||||
ms.openlocfilehash: 6761f05ef04d18ebba7b9ef8a2894d7effd2622b
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.sourcegitcommit: 478f2931167988096ae6478a257f492ecaa11794
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: es-ES
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.lasthandoff: 09/09/2022
|
||||
ms.locfileid: '147764173'
|
||||
---
|
||||
{% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %}
|
||||
|
||||
## Acerca de grupos de ejecutores
|
||||
|
||||
{% data reusables.actions.about-runner-groups %} {% ifversion fpt %}Para obtener más información, consulta la [documentación de {% data variables.product.prodname_ghe_cloud %}](/enterprise-cloud@latest/actions/using-github-hosted-runners/controlling-access-to-larger-runners).{% endif %}
|
||||
{% data reusables.actions.about-runner-groups %} {% ifversion fpt %}Para obtener más información, consulta la [{% data variables.product.prodname_ghe_cloud %} ](/enterprise-cloud@latest/actions/using-github-hosted-runners/controlling-access-to-larger-runners).{% endif %}
|
||||
|
||||
{% ifversion ghec or ghes or ghae %}
|
||||
|
||||
|
||||
@@ -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.
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -19,10 +19,10 @@ topics:
|
||||
- Notifications
|
||||
shortTitle: Configure email notifications
|
||||
ms.openlocfilehash: d7dd82fa95db462abe8d9d19e8df60a45dab3f0c
|
||||
ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5
|
||||
ms.sourcegitcommit: 478f2931167988096ae6478a257f492ecaa11794
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: es-ES
|
||||
ms.lasthandoff: 09/05/2022
|
||||
ms.lasthandoff: 09/09/2022
|
||||
ms.locfileid: '147718137'
|
||||
---
|
||||
{% ifversion ghae %} Los propietarios de la empresa pueden configurar el correo electrónico para las notificaciones.
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
---
|
||||
title: SAML configuration reference
|
||||
title: Referencia de configuración de SAML
|
||||
shortTitle: SAML reference
|
||||
intro: 'You can see SAML metadata for {% ifversion ghec %}your organization or enterprise on {% data variables.product.product_name %}{% elsif ghes %}{% data variables.product.product_location %}{% elsif ghae %}your enterprise on {% data variables.product.product_name %}{% endif %}, and you can learn more about available SAML attributes and response requirements.'
|
||||
intro: 'Puedes ver los metadatos de SAML para {% ifversion ghec %}tu organización o empresa en {% data variables.product.product_name %}{% elsif ghes %}{% data variables.product.product_location %}{% elsif ghae %}your enterprise on {% data variables.product.product_name %}{% endif %} y puedes obtener más información sobre los atributos SAML disponibles y los requisitos de respuesta.'
|
||||
versions:
|
||||
ghec: '*'
|
||||
ghes: '*'
|
||||
@@ -13,82 +13,80 @@ topics:
|
||||
- Enterprise
|
||||
- Identity
|
||||
- SSO
|
||||
ms.openlocfilehash: 896d1281d28268f669957bfbf0df43d3a1d6a76e
|
||||
ms.sourcegitcommit: 478f2931167988096ae6478a257f492ecaa11794
|
||||
ms.translationtype: HT
|
||||
ms.contentlocale: es-ES
|
||||
ms.lasthandoff: 09/09/2022
|
||||
ms.locfileid: '147683723'
|
||||
---
|
||||
## Acerca de la configuración de SAML
|
||||
|
||||
## About SAML configuration
|
||||
Para utilizar el inicio de sesión único (SSO) de SAML para la autenticación en {% data variables.product.product_name %}, debes configurar tanto el proveedor de identidades (IdP) de SAML externo como {% ifversion ghes %}{% data variables.product.product_location %}{% elsif ghec %}la empresa u organización en {% data variables.product.product_location %}{% elsif ghae %}la empresa en {% data variables.product.product_name %}{% endif %}. En una configuración de SAML, {% data variables.product.product_name %} funciona como un proveedor de servicios (SP) de SAML.
|
||||
|
||||
To use SAML single sign-on (SSO) for authentication to {% data variables.product.product_name %}, you must configure both your external SAML identity provider (IdP) and {% ifversion ghes %}{% data variables.product.product_location %}{% elsif ghec %}your enterprise or organization on {% data variables.product.product_location %}{% elsif ghae %}your enterprise on {% data variables.product.product_name %}{% endif %}. In a SAML configuration, {% data variables.product.product_name %} functions as a SAML service provider (SP).
|
||||
Debes especificar valores únicos para el IdP de SAML al configurar el inicio de sesión único de SAML para {% data variables.product.product_name %}, y también valores únicos de {% data variables.product.product_name %} en el IdP. Para más información sobre la configuración del inicio de sesión único de SAML para {% data variables.product.product_name %}, consulta "[Configuración del inicio de sesión único de SAML para tu empresa](/admin/identity-and-access-management/managing-iam-for-your-enterprise/configuring-saml-single-sign-on-for-your-enterprise){% ifversion ghes or ghae %}{% elsif ghec %}" o "[Habilitación y prueba del inicio de sesión único de SAML para tu organización](/organizations/managing-saml-single-sign-on-for-your-organization/enabling-and-testing-saml-single-sign-on-for-your-organization){% endif %}".
|
||||
|
||||
You must enter unique values from your SAML IdP when configuring SAML SSO for {% data variables.product.product_name %}, and you must also enter unique values from {% data variables.product.product_name %} on your IdP. For more information about the configuration of SAML SSO for {% data variables.product.product_name %}, see "[Configuring SAML single sign-on for your enterprise](/admin/identity-and-access-management/managing-iam-for-your-enterprise/configuring-saml-single-sign-on-for-your-enterprise){% ifversion ghes or ghae %}{% elsif ghec %}" or "[Enabling and testing SAML single sign-on for your organization](/organizations/managing-saml-single-sign-on-for-your-organization/enabling-and-testing-saml-single-sign-on-for-your-organization){% endif %}."
|
||||
|
||||
## SAML metadata
|
||||
## Metadatos SAML
|
||||
|
||||
{% ifversion ghec %}
|
||||
|
||||
The SP metadata for {% data variables.product.product_name %} is available for either organizations or enterprises with SAML SSO. {% data variables.product.product_name %} uses the `urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST` binding.
|
||||
Los metadatos del proveedor de servicios para {% data variables.product.product_name %} están disponibles para organizaciones o empresas con el inicio de sesión único de SAML. {% data variables.product.product_name %} utiliza el enlace `urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST`.
|
||||
|
||||
### Organizations
|
||||
### Las organizaciones
|
||||
|
||||
You can configure SAML SSO for an individual organization in your enterprise. You can also configure SAML SSO for an organization if you use an individual organization on {% data variables.product.product_name %} and do not use an enterprise account. For more information, see "[Managing SAML single sign-on for your organization](/organizations/managing-saml-single-sign-on-for-your-organization)."
|
||||
Puedes configurar el inicio de sesión único de SAML para una organización individual en la empresa. También puedes configurarlo para una organización si usas una organización individual en {% data variables.product.product_name %} y no una cuenta empresarial. Para más información, vea "[Administración del inicio de sesión único de SAML para la organización](/organizations/managing-saml-single-sign-on-for-your-organization)".
|
||||
|
||||
The SP metadata for an organization on {% data variables.product.product_location %} is available at `https://github.com/orgs/ORGANIZATION/saml/metadata`, where **ORGANIZATION** is the name of your organization on {% data variables.product.product_location %}.
|
||||
Los metadatos del proveedor de servicios para una organización en {% data variables.product.product_location %} están disponibles en `https://github.com/orgs/ORGANIZATION/saml/metadata`, donde **ORGANIZATION** es el nombre de la organización en {% data variables.product.product_location %}.
|
||||
|
||||
| Value | Other names | Description | Example |
|
||||
| Value | Otros nombres | Descripción | Ejemplo |
|
||||
| :- | :- | :- | :- |
|
||||
| SP Entity ID | SP URL, audience restriction | The top-level URL for your organization on {% data variables.product.product_location %} | `https://github.com/orgs/ORGANIZATION` |
|
||||
| SP Assertion Consumer Service (ACS) URL | Reply, recipient, or destination URL | URL where IdP sends SAML responses | `https://github.com/orgs/ORGANIZATION/saml/consume` |
|
||||
| SP Single Sign-On (SSO) URL | | URL where IdP begins SSO | `https://github.com/orgs/ORGANIZATION/saml/sso` |
|
||||
| ID de Entidad de SP | URL de SP, restricción de público | URL de nivel superior para la organización en {% data variables.product.product_location %} | `https://github.com/orgs/ORGANIZATION` |
|
||||
| URL del Servicio de Consumidor de Aserciones (ACS) del SP | URL de destino, destinatario o respuesta | URL a la que el IdP enviará respuestas de SAML | `https://github.com/orgs/ORGANIZATION/saml/consume` |
|
||||
| URL de inicio de sesión único (SSO) del SP | | URL en donde el IdP comienza con SSO | `https://github.com/orgs/ORGANIZATION/saml/sso` |
|
||||
|
||||
### Enterprises
|
||||
### Empresas
|
||||
|
||||
The SP metadata for an enterprise on {% data variables.product.product_location %} is available at `https://github.com/enterprises/ENTERPRISE/saml/metadata`, where **ENTERPRISE** is the name of your enterprise on {% data variables.product.product_location %}.
|
||||
Los metadatos del proveedor de servicios para una empresa en {% data variables.product.product_location %} están disponibles en `https://github.com/enterprises/ENTERPRISE/saml/metadata`, donde **ENTERPRISE** es el nombre de la empresa en {% data variables.product.product_location %}.
|
||||
|
||||
| Value | Other names | Description | Example |
|
||||
| Value | Otros nombres | Descripción | Ejemplo |
|
||||
| :- | :- | :- | :- |
|
||||
| SP Entity ID | SP URL, audience restriction | The top-level URL for your enterprise on {% data variables.product.product_location %} | `https://github.com/enterprises/ENTERPRISE` |
|
||||
| SP Assertion Consumer Service (ACS) URL | Reply, recipient, or destination URL | URL where IdP sends SAML responses | `https://github.com/enterprises/ENTERPRISE/saml/consume` |
|
||||
| SP Single Sign-On (SSO) URL | | URL where IdP begins SSO | `https://github.com/enterprises/ENTERPRISE/saml/sso` |
|
||||
| ID de Entidad de SP | URL de SP, restricción de público | URL de nivel superior para la empresa en {% data variables.product.product_location %} | `https://github.com/enterprises/ENTERPRISE` |
|
||||
| URL del Servicio de Consumidor de Aserciones (ACS) del SP | URL de destino, destinatario o respuesta | URL a la que el IdP enviará respuestas de SAML | `https://github.com/enterprises/ENTERPRISE/saml/consume` |
|
||||
| URL de inicio de sesión único (SSO) del SP | | URL en donde el IdP comienza con SSO | `https://github.com/enterprises/ENTERPRISE/saml/sso` |
|
||||
|
||||
{% elsif ghes %}
|
||||
|
||||
The SP metadata for {% data variables.product.product_location %} is available at `http(s)://HOSTNAME/saml/metadata`, where **HOSTNAME** is the hostname for your instance. {% data variables.product.product_name %} uses the `urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST` binding.
|
||||
Los metadatos del proveedor de servicios para {% data variables.product.product_location %} están disponibles en `http(s)://HOSTNAME/saml/metadata`, donde **HOSTNAME** es el nombre de host de la instancia. {% data variables.product.product_name %} utiliza el enlace `urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST`.
|
||||
|
||||
| Value | Other names | Description | Example |
|
||||
| Value | Otros nombres | Descripción | Ejemplo |
|
||||
| :- | :- | :- | :- |
|
||||
| SP Entity ID | SP URL, audience restriction | Your top-level URL for {% data variables.product.product_name %} | `http(s)://HOSTNAME`
|
||||
| SP Assertion Consumer Service (ACS) URL | Reply, recipient, or destination URL | URL where IdP sends SAML responses | `http(s)://HOSTNAME/saml/consume` |
|
||||
| SP Single Sign-On (SSO) URL | | URL where IdP begins SSO | `http(s)://HOSTNAME/sso` |
|
||||
| ID de Entidad de SP | URL de SP, restricción de público | URL de nivel superior para {% data variables.product.product_name %} | `http(s)://HOSTNAME`
|
||||
| URL del Servicio de Consumidor de Aserciones (ACS) del SP | URL de destino, destinatario o respuesta | URL a la que el IdP enviará respuestas de SAML | `http(s)://HOSTNAME/saml/consume` |
|
||||
| URL de inicio de sesión único (SSO) del SP | | URL en donde el IdP comienza con SSO | `http(s)://HOSTNAME/sso` |
|
||||
|
||||
{% elsif ghae %}
|
||||
|
||||
The SP metadata for your enterprise on {% data variables.product.product_name %} is available at `https://HOSTNAME/saml/metadata`, where **HOSTNAME** is the hostname for your enterprise on {% data variables.product.product_name %}. {% data variables.product.product_name %} uses the `urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST` binding.
|
||||
Los metadatos del proveedor de servicios para la empresa {% data variables.product.product_name %} están disponibles en `https://HOSTNAME/saml/metadata`, donde **HOSTNAME** es el nombre de host para la empresa en {% data variables.product.product_name %}. {% data variables.product.product_name %} utiliza el enlace `urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST`.
|
||||
|
||||
| Value | Other names | Description | Example |
|
||||
| Value | Otros nombres | Descripción | Ejemplo |
|
||||
| :- | :- | :- | :- |
|
||||
| SP Entity ID | SP URL, audience restriction | Your top-level URL for {% data variables.product.product_name %} | `https://HOSTNAME` |
|
||||
| SP Assertion Consumer Service (ACS) URL | Reply, recipient, or destination URL | URL where IdP sends SAML responses | `https://HOSTNAME/saml/consume` |
|
||||
| SP Single Sign-On (SSO) URL | | URL where IdP begins SSO | `https://HOSTNAME/sso` |
|
||||
| ID de Entidad de SP | URL de SP, restricción de público | URL de nivel superior para {% data variables.product.product_name %} | `https://HOSTNAME` |
|
||||
| URL del Servicio de Consumidor de Aserciones (ACS) del SP | URL de destino, destinatario o respuesta | URL a la que el IdP enviará respuestas de SAML | `https://HOSTNAME/saml/consume` |
|
||||
| URL de inicio de sesión único (SSO) del SP | | URL en donde el IdP comienza con SSO | `https://HOSTNAME/sso` |
|
||||
|
||||
{% endif %}
|
||||
|
||||
## SAML attributes
|
||||
## Atributos de SAML
|
||||
|
||||
The following SAML attributes are available for {% data variables.product.product_name %}.{% ifversion ghes %} You can change the attribute names in the management console, with the exception of the `administrator` attribute. For more information, see "[Accessing the management console](/admin/configuration/configuring-your-enterprise/accessing-the-management-console)."{% endif %}
|
||||
Los atributos de SAML siguientes están disponibles para {% data variables.product.product_name %}.{% ifversion ghes %} Puedes cambiar los nombres de los atributos en la consola de administración, con la excepción del atributo `administrator`. Para más información, consulta "[Acceso a la consola de administración](/admin/configuration/configuring-your-enterprise/accessing-the-management-console)".{% endif %}
|
||||
|
||||
| Name | Required? | Description |
|
||||
| Nombre | ¿Necesario? | Descripción |
|
||||
| :- | :- | :- |
|
||||
| `NameID` | Yes | A persistent user identifier. Any persistent name identifier format may be used. {% ifversion ghec %}If you use an enterprise with {% data variables.product.prodname_emus %}, {% endif %}{% data variables.product.product_name %} will normalize the `NameID` element to use as a username unless one of the alternative assertions is provided. For more information, see "[Username considerations for external authentication](/admin/identity-and-access-management/managing-iam-for-your-enterprise/username-considerations-for-external-authentication)."<br><br>{% note %}**Note:** It's important to use a human-readable, persistent identifier. Using a transient identifier format like `urn:oasis:names:tc:SAML:2.0:nameid-format:transient` will result in re-linking of accounts on every sign-in, which can be detrimental to authorization management.{% endnote %} |
|
||||
| `SessionNotOnOrAfter` | No | The date that {% data variables.product.product_name %} invalidates the associated session. After invalidation, the person must authenticate once again to access {% ifversion ghec or ghae %}your enterprise's resources{% elsif ghes %}{% data variables.product.product_location %}{% endif %}. For more information, see "[Session duration and timeout](#session-duration-and-timeout)." |
|
||||
{%- ifversion ghes or ghae %}
|
||||
| `administrator` | No | When the value is `true`, {% data variables.product.product_name %} will automatically promote the user to be a {% ifversion ghes %}site administrator{% elsif ghae %}enterprise owner{% endif %}. Setting this attribute to anything but `true` will result in demotion, as long as the value is not blank. Omitting this attribute or leaving the value blank will not change the role of the user. |
|
||||
| `username` | No | The username for {% data variables.product.product_location %}. |
|
||||
{%- endif %}
|
||||
| `full_name` | No | {% ifversion ghec %}If you configure SAML SSO for an enterprise and you use {% data variables.product.prodname_emus %}, the{% else %}The{% endif %} full name of the user to display on the user's profile page. |
|
||||
| `emails` | No | The email addresses for the user.{% ifversion ghes or ghae %} You can specify more than one address.{% endif %}{% ifversion ghec or ghes %} If you sync license usage between {% data variables.product.prodname_ghe_server %} and {% data variables.product.prodname_ghe_cloud %}, {% data variables.product.prodname_github_connect %} uses `emails` to identify unique users across products. For more information, see "[Syncing license usage between {% data variables.product.prodname_ghe_server %} and {% data variables.product.prodname_ghe_cloud %}](/billing/managing-your-license-for-github-enterprise/syncing-license-usage-between-github-enterprise-server-and-github-enterprise-cloud)."{% endif %} |
|
||||
| `public_keys` | No | {% ifversion ghec %}If you configure SAML SSO for an enterprise and you use {% data variables.product.prodname_emus %}, the{% else %}The{% endif %} public SSH keys for the user. You can specify more than one key. |
|
||||
| `gpg_keys` | No | {% ifversion ghec %}If you configure SAML SSO for an enterprise and you use {% data variables.product.prodname_emus %}, the{% else %}The{% endif %} GPG keys for the user. You can specify more than one key. |
|
||||
| `NameID` | Sí | Un identificador de usuario persistente. Se puede usar cualquier formato de identificador de nombre persistente. {% ifversion ghec %}Si usas una empresa con {% data variables.product.prodname_emus %}, {% endif %}{% data variables.product.product_name %} normalizará el elemento `NameID` para utilizarlo como nombre de usuario a menos que se proporcione una de las aserciones alternativas. Para más información, consulta "[Consideraciones sobre el nombre de usuario para la autenticación externa](/admin/identity-and-access-management/managing-iam-for-your-enterprise/username-considerations-for-external-authentication)".<br><br>{% note %} **Nota:** Es importante usar un identificador persistente y legible. El uso de un formato de identificador transitorio, como `urn:oasis:names:tc:SAML:2.0:nameid-format:transient`, volverá a vincular las cuentas en cada inicio de sesión, lo que puede ser perjudicial para la administración de la autorización.{% endnote %} |
|
||||
| `SessionNotOnOrAfter` | No | La fecha en que {% data variables.product.product_name %} invalida la sesión asociada. Después de la invalidación, la persona se debe autenticar nuevamente para acceder a {% ifversion ghec or ghae %}los recursos de la empresa{% elsif ghes %}{% data variables.product.product_location %}{% endif %}. Para más información, consulta "[Duración y tiempo de espera de la sesión](#session-duration-and-timeout)". |
|
||||
{%- ifversion ghes or ghae %} | `administrator` | No | Cuando el valor es `true`, {% data variables.product.product_name %} promoverá automáticamente al usuario para que sea {% ifversion ghes %}administrador del sitio{% elsif ghae %}propietario de la empresa{% endif %}. Establecer este atributo en cualquier valor, excepto `true`, generará una disminución de nivel, siempre que el valor no esté en blanco. Omitir este atributo o dejar el valor en blanco no cambiará el rol del usuario. | | `username` | No | El nombre de usuario para {% data variables.product.product_location %}. | {%- endif %} | `full_name` | No | {% ifversion ghec %}Si configuras el inicio de sesión único de SAML para una empresa y utilizas {% data variables.product.prodname_emus %}, el {% else %}El{% endif %} nombre completo del usuario que se va a mostrar en la página de perfil del usuario. | | `emails` | No | Las direcciones de correo electrónico del usuario.{% ifversion ghes or ghae %} Puedes especificar más de una dirección.{% endif %}{% ifversion ghec or ghes %} Si sincronizas el uso de licencias entre {% data variables.product.prodname_ghe_server %} y {% data variables.product.prodname_ghe_cloud %}, {% data variables.product.prodname_github_connect %} utiliza `emails` para identificar usuarios únicos entre productos. Para más información, consulta "[Sincronización del uso de licencias entre {% data variables.product.prodname_ghe_server %} y {% data variables.product.prodname_ghe_cloud %}](/billing/managing-your-license-for-github-enterprise/syncing-license-usage-between-github-enterprise-server-and-github-enterprise-cloud)".{% endif %} | | `public_keys` | No | {% ifversion ghec %}Si configuras el inicio de sesión único de SAML para una empresa y utilizas {% data variables.product.prodname_emus %}, las{% else %}Las{% endif %} claves SSH públicas para el usuario. Puedes especificar más de una clave. | | `gpg_keys` | No | {% ifversion ghec %}Si configuras el inicio de sesión único de SAML para una empresa y utilizas {% data variables.product.prodname_emus %}, las{% else %}Las{% endif %} claves GPG para el usuario. Puedes especificar más de una clave. |
|
||||
|
||||
To specify more than one value for an attribute, use multiple `<saml2:AttributeValue>` elements.
|
||||
A fin de especificar más de un valor para un atributo, use varios elementos `<saml2:AttributeValue>`.
|
||||
|
||||
```xml
|
||||
<saml2:Attribute FriendlyName="public_keys" Name="urn:oid:1.2.840.113549.1.1.1" NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri">
|
||||
@@ -97,20 +95,20 @@ To specify more than one value for an attribute, use multiple `<saml2:AttributeV
|
||||
</saml2:Attribute>
|
||||
```
|
||||
|
||||
## SAML response requirements
|
||||
## Requisitos de respuesta de SAML
|
||||
|
||||
{% data variables.product.product_name %} requires that the response message from your IdP fulfill the following requirements.
|
||||
{% data variables.product.product_name %} requiere que el mensaje de respuesta del IdP cumpla con los requisitos siguientes.
|
||||
|
||||
- Your IdP must provide the `<Destination>` element on the root response document and match the ACS URL only when the root response document is signed. If your IdP signs the assertion, {% data variables.product.product_name %} will ignore the assertion.
|
||||
- Your IdP must always provide the `<Audience>` element as part of the `<AudienceRestriction>` element. The value must match your `EntityId` for {% data variables.product.product_name %}.{% ifversion ghes or ghae %} This value is the URL where you access {% data variables.product.product_location %}, such as {% ifversion ghes %}`http(s)://HOSTNAME`{% elsif ghae %}`https://SUBDOMAIN.githubenterprise.com`, `https://SUBDOMAIN.github.us`, or `https://SUBDOMAIN.ghe.com`{% endif %}.{% endif %}
|
||||
- El IdP debe proporcionar el elemento `<Destination>` en el documento de respuesta raíz y hacer coincidir la URL de ACS únicamente cuando se firme este documento. Si el IdP firma la aserción, {% data variables.product.product_name %} la omitirá.
|
||||
- El IdP siempre debe proporcionar el elemento `<Audience>` como parte del elemento `<AudienceRestriction>`. El valor debe coincidir con `EntityId` para {% data variables.product.product_name %}.{% ifversion ghes or ghae %} Este valor es la dirección URL en la que accedes a {% data variables.product.product_location %}, como {% ifversion ghes %}`http(s)://HOSTNAME`{% elsif ghae %}`https://SUBDOMAIN.githubenterprise.com`, `https://SUBDOMAIN.github.us` o `https://SUBDOMAIN.ghe.com`{% endif %}.{% endif %}
|
||||
|
||||
{%- ifversion ghec %}
|
||||
- If you configure SAML for an organization, this value is `https://github.com/orgs/ORGANIZATION`.
|
||||
- If you configure SAML for an enterprise, this URL is `https://github.com/enterprises/ENTERPRISE`.
|
||||
- Si configuras SAML para una organización, este valor es `https://github.com/orgs/ORGANIZATION`.
|
||||
- Si configuras SAML para una empresa, esta dirección URL es `https://github.com/enterprises/ENTERPRISE`.
|
||||
{%- endif %}
|
||||
- Your IdP must protect each assertion in the response with a digital signature. You can accomplish this by signing each individual `<Assertion>` element or by signing the `<Response>` element.
|
||||
- Your IdP must provide a `<NameID>` element as part of the `<Subject>` element. You may use any persistent name identifier format.
|
||||
- Your IdP must include the `Recipient` attribute, which must be set to the ACS URL. The following example demonstrates the attribute.
|
||||
- El IdP debe proteger cada aserción de la respuesta con una firma digital. Esto se puede lograr si se firma cada elemento `<Assertion>` individual o si se firma el elemento `<Response>`.
|
||||
- El IdP debe proporcionar un elemento `<NameID>` como parte del elemento `<Subject>`. Puedes utilizar cualquier formato de identificador de nombre persistente.
|
||||
- El IdP debe incluir el atributo `Recipient`, que se debe establecer en la URL de ACS. En el ejemplo siguiente, se muestra el atributo.
|
||||
|
||||
```xml
|
||||
<samlp:Response ...>
|
||||
@@ -130,21 +128,20 @@ To specify more than one value for an attribute, use multiple `<saml2:AttributeV
|
||||
</samlp:Response>
|
||||
```
|
||||
|
||||
## Session duration and timeout
|
||||
## Duración y tiempo de espera de la sesión
|
||||
|
||||
To prevent a person from authenticating with your IdP and staying authorized indefinitely, {% data variables.product.product_name %} periodically invalidates the session for each user account with access to {% ifversion ghec or ghae %}your enterprise's resources{% elsif ghes %}{% data variables.product.product_location %}{% endif %}. After invalidation, the person must authenticate with your IdP once again. By default, if your IdP does not assert a value for the `SessionNotOnOrAfter` attribute, {% data variables.product.product_name %} invalidates a session {% ifversion ghec %}24 hours{% elsif ghes or ghae %}one week{% endif %} after successful authentication with your IdP.
|
||||
Para evitar que una persona se autentique con el IdP y permanezca autorizada indefinidamente, {% data variables.product.product_name %} invalida periódicamente la sesión de cada cuenta de usuario con acceso a {% ifversion ghec or ghae %}los recursos de la empresa{% elsif ghes %}{% data variables.product.product_location %}{% endif %}. Después de la invalidación, la persona se debe volver a autenticar con el IdP. De manera predeterminada, si el IdP no declara un valor para el atributo `SessionNotOnOrAfter`, {% data variables.product.product_name %} invalida una sesión {% ifversion ghec %}24 horas{% elsif ghes or ghae %}una semana{% endif %} después de una autenticación correcta con el IdP.
|
||||
|
||||
To customize the session duration, you may be able to define the value of the `SessionNotOnOrAfter` attribute on your IdP. If you define a value less than 24 hours, {% data variables.product.product_name %} may prompt people to authenticate every time {% data variables.product.product_name %} initiates a redirect.
|
||||
Para personalizar la duración de la sesión, puedes definir el valor del atributo `SessionNotOnOrAfter` en el IdP. Si defines un valor inferior a 24 horas, {% data variables.product.product_name %} puede solicitarle a los usuarios que se autentiquen cada vez que {% data variables.product.product_name %} inicia un redireccionamiento.
|
||||
|
||||
{% ifversion ghec %}
|
||||
To prevent authentication errors, we recommend a minimum session duration of 4 hours. For more information, see "[Troubleshooting SAML authentication](/admin/identity-and-access-management/using-saml-for-enterprise-iam/troubleshooting-saml-authentication#users-are-repeatedly-redirected-to-authenticate)."
|
||||
{% ifversion ghec %} Para evitar errores de autenticación, se recomienda una duración de sesión mínima de 4 horas. Para obtener más información, consulta "[Solución de problemas de autenticación SAML](/admin/identity-and-access-management/using-saml-for-enterprise-iam/troubleshooting-saml-authentication#users-are-repeatedly-redirected-to-authenticate)".
|
||||
{% endif %}
|
||||
|
||||
{% note %}
|
||||
|
||||
**Notes**:
|
||||
**Notas**:
|
||||
|
||||
- For Azure AD, the configurable lifetime policy for SAML tokens does not control session timeout for {% data variables.product.product_name %}.
|
||||
- Okta does not currently send the `SessionNotOnOrAfter` attribute during SAML authentication with {% data variables.product.product_name %}. For more information, contact Okta.
|
||||
- Para Azure AD, la directiva de duración configurable para los tokens SAML no controla el tiempo de espera de sesión para {% data variables.product.product_name %}.
|
||||
- Actualmente, Okta no envía el atributo `SessionNotOnOrAfter` durante la autenticación SAML con {% data variables.product.product_name %}. Para más información, ponte en contacto con Okta.
|
||||
|
||||
{% endnote %}
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user