@@ -103,7 +103,7 @@ To help you understand how YAML syntax is used to create a workflow file, this s
```
|
- Optional - The name of the workflow as it will appear in the Actions tab of the {% data variables.product.prodname_dotcom %} repository.
+ オプション - {% data variables.product.prodname_dotcom %} リポジトリの [Actions] タブに表示されるワークフローの名前。
|
@@ -147,7 +147,7 @@ Defines a job named check-bats-version. The child keys will define
```
- Configures the job to run on the latest version of an Ubuntu Linux runner. This means that the job will execute on a fresh virtual machine hosted by GitHub. For syntax examples using other runners, see "Workflow syntax for {% data variables.product.prodname_actions %}."
+ Configures the job to run on the latest version of an Ubuntu Linux runner. これは、ジョブが GitHub によってホストされている新しい仮想マシンで実行されるということです。 他のランナーを使用した構文例については、「{% data variables.product.prodname_actions %} のワークフロー構文」を参照してください。
|
@@ -158,7 +158,7 @@ Defines a job named check-bats-version. The child keys will define
```
- Groups together all the steps that run in the check-bats-version job. Each item nested under this section is a separate action or shell script.
+ check-bats-version ジョブで実行されるすべてのステップをグループ化します。 Each item nested under this section is a separate action or shell script.
|
@@ -193,7 +193,7 @@ The uses keyword specifies that this step will run v2
```
- The run keyword tells the job to execute a command on the runner. In this case, you are using npm to install the bats software testing package.
+ run キーワードは、ランナーでコマンドを実行するようにジョブに指示します。 この場合、npm を使用して bats ソフトウェアテストパッケージをインストールしています。
|
@@ -204,46 +204,39 @@ The uses keyword specifies that this step will run v2
```
- Finally, you'll run the bats command with a parameter that outputs the software version.
+ 最後に、ソフトウェアバージョンを出力するパラメータを指定して bats コマンドを実行します。
|
-### Visualizing the workflow file
+### ワークフローファイルの視覚化
-In this diagram, you can see the workflow file you just created and how the {% data variables.product.prodname_actions %} components are organized in a hierarchy. Each step executes a single action or shell script. Steps 1 and 2 run actions, while steps 3 and 4 run shell scripts. To find more prebuilt actions for your workflows, see "[Finding and customizing actions](/actions/learn-github-actions/finding-and-customizing-actions)."
+この図では、作成したワークフローファイルと、{% data variables.product.prodname_actions %} コンポーネントが階層にどのように整理されているかを確認できます。 Each step executes a single action or shell script. Steps 1 and 2 run actions, while steps 3 and 4 run shell scripts. ワークフローのビルド済みアクションの詳細については、「[アクションの検索とカスタマイズ](/actions/learn-github-actions/finding-and-customizing-actions)」を参照してください。
-
+
## Viewing the workflow's activity
Once your workflow has started running, you can {% ifversion fpt or ghes > 3.0 or ghae or ghec %}see a visualization graph of the run's progress and {% endif %}view each step's activity on {% data variables.product.prodname_dotcom %}.
{% data reusables.repositories.navigate-to-repo %}
-1. Under your repository name, click **Actions**.
- 
-1. In the left sidebar, click the workflow you want to see.
- 
-1. Under "Workflow runs", click the name of the run you want to see.
- 
+1. リポジトリ名の下で**Actions（アクション）**をクリックしてください。 
+1. 左サイドバーで、表示するワークフローをクリックします。 
+1. [Workflow runs] で、表示する実行の名前をクリックします。 
{% ifversion fpt or ghes > 3.0 or ghae or ghec %}
-1. Under **Jobs** or in the visualization graph, click the job you want to see.
- 
+1. [**Jobs**] または視覚化グラフで、表示するジョブをクリックします。 
{% endif %}
{% ifversion fpt or ghes > 3.0 or ghae or ghec %}
-1. View the results of each step.
- 
+1. 各ステップの結果を表示します。 
{% elsif ghes %}
-1. Click on the job name to see the results of each step.
- 
+1. ジョブ名をクリックして、各ステップの結果を確認します。 
{% else %}
-1. Click on the job name to see the results of each step.
- 
+1. ジョブ名をクリックして、各ステップの結果を確認します。 
{% endif %}
-## Next steps
+## 次のステップ
-To continue learning about {% data variables.product.prodname_actions %}, see "[Finding and customizing actions](/actions/learn-github-actions/finding-and-customizing-actions)."
+{% data variables.product.prodname_actions %} について詳しくは、「[アクションの検索とカスタマイズ](/actions/learn-github-actions/finding-and-customizing-actions)」を参照してください。
{% ifversion fpt or ghec or ghes %}
@@ -251,6 +244,6 @@ To understand how billing works for {% data variables.product.prodname_actions %
{% endif %}
-## Contacting support
+## サポートへの連絡
{% data reusables.github-actions.contacting-support %}
diff --git a/translations/ja-JP/content/actions/learn-github-actions/usage-limits-billing-and-administration.md b/translations/ja-JP/content/actions/learn-github-actions/usage-limits-billing-and-administration.md
index 3b2a00be5c..79832db60b 100644
--- a/translations/ja-JP/content/actions/learn-github-actions/usage-limits-billing-and-administration.md
+++ b/translations/ja-JP/content/actions/learn-github-actions/usage-limits-billing-and-administration.md
@@ -1,6 +1,6 @@
---
-title: 'Usage limits, billing, and administration'
-intro: 'There are usage limits for {% data variables.product.prodname_actions %} workflows. Usage charges apply to repositories that go beyond the amount of free minutes and storage for a repository.'
+title: 使用制限、支払い、管理
+intro: '{% data variables.product.prodname_actions %} ワークフローには使用制限があります。 使用料は、リポジトリの無料の時間とストレージの量を超えるリポジトリに適用されます。'
redirect_from:
- /actions/getting-started-with-github-actions/usage-and-billing-information-for-github-actions
- /actions/reference/usage-limits-billing-and-administration
@@ -16,86 +16,86 @@ shortTitle: Workflow billing & limits
{% data reusables.actions.enterprise-beta %}
{% data reusables.actions.enterprise-github-hosted-runners %}
-## About billing for {% data variables.product.prodname_actions %}
+## {% data variables.product.prodname_actions %}の支払いについて
{% ifversion fpt or ghec %}
-{% data reusables.github-actions.actions-billing %} For more information, see "[About billing for {% data variables.product.prodname_actions %}](/billing/managing-billing-for-github-actions/about-billing-for-github-actions)."
+{% data reusables.github-actions.actions-billing %} 詳細は「[{% data variables.product.prodname_actions %} の支払いについて](/billing/managing-billing-for-github-actions/about-billing-for-github-actions)」を参照してください。
{% else %}
GitHub Actions usage is free for {% data variables.product.prodname_ghe_server %}s that use self-hosted runners.
{% endif %}
-## Availability
+## 利用の可否
{% data variables.product.prodname_actions %} is available on all {% data variables.product.prodname_dotcom %} products, but {% data variables.product.prodname_actions %} is not available for private repositories owned by accounts using legacy per-repository plans. {% data reusables.gated-features.more-info %}
-## Usage limits
+## 使用制限
{% ifversion fpt or ghec %}
-There are some limits on {% data variables.product.prodname_actions %} usage when using {% data variables.product.prodname_dotcom %}-hosted runners. These limits are subject to change.
+There are some limits on {% data variables.product.prodname_actions %} usage when using {% data variables.product.prodname_dotcom %}-hosted runners. これらの制限は変更されることがあります。
{% note %}
-**Note:** For self-hosted runners, different usage limits apply. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)."
+**ノート:** セルフホストランナーの場合、さまざまな使用制限が適用されます。 詳しい情報については「[セルフホストランナーについて](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)」を参照してください。
{% endnote %}
-- **Job execution time** - Each job in a workflow can run for up to 6 hours of execution time. If a job reaches this limit, the job is terminated and fails to complete.
+- **ジョブの実行時間** - ワークフロー中のそれぞれのジョブは、最大で6時間の間実行できます。 ジョブがこの制限に達すると、ジョブは終了させられ、完了できずに失敗します。
{% data reusables.github-actions.usage-workflow-run-time %}
{% data reusables.github-actions.usage-api-requests %}
-- **Concurrent jobs** - The number of concurrent jobs you can run in your account depends on your GitHub plan, as indicated in the following table. If exceeded, any additional jobs are queued.
+- **並行ジョブ** - アカウント内で実行できる並行ジョブ数は、以下の表に示すとおり、利用しているGitHubのプランによります。 この制限を超えた場合、超過のジョブはキューイングされます。
- | GitHub plan | Total concurrent jobs | Maximum concurrent macOS jobs |
- |---|---|---|
- | Free | 20 | 5 |
- | Pro | 40 | 5 |
- | Team | 60 | 5 |
- | Enterprise | 180 | 50 |
-- **Job matrix** - {% data reusables.github-actions.usage-matrix-limits %}
+ | GitHubプラン | 最大同時ジョブ | 最大同時macOSジョブ |
+ | ---------- | ------- | ------------ |
+ | 無料 | 20 | 5 |
+ | Pro | 40 | 5 |
+ | Team | 60 | 5 |
+ | Enterprise | 180 | 50 |
+- **ジョブマトリックス** - {% data reusables.github-actions.usage-matrix-limits %}
{% data reusables.github-actions.usage-workflow-queue-limits %}
{% else %}
-Usage limits apply to self-hosted runners. For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)."
+使用制限は、セルフホストランナーに適用されます。 詳しい情報については「[セルフホストランナーについて](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)」を参照してください。
{% endif %}
{% ifversion fpt or ghec %}
-## Usage policy
+## 利用のポリシー
-In addition to the usage limits, you must ensure that you use {% data variables.product.prodname_actions %} within the [GitHub Terms of Service](/free-pro-team@latest/github/site-policy/github-terms-of-service/). For more information on {% data variables.product.prodname_actions %}-specific terms, see the [GitHub Additional Product Terms](/free-pro-team@latest/github/site-policy/github-additional-product-terms#a-actions-usage).
+使用制限に加えて、{% data variables.product.prodname_actions %}を[GitHubの利用規約](/free-pro-team@latest/github/site-policy/github-terms-of-service/)内で使っていることを確認しなければなりません。 {% data variables.product.prodname_actions %}の固有の規約に関する詳しい情報については、[GitHubの追加製品規約](/free-pro-team@latest/github/site-policy/github-additional-product-terms#a-actions-usage)を参照してください。
{% endif %}
{% ifversion fpt or ghes > 3.3 or ghec %}
## Billing for reusable workflows
-If you reuse a workflow, billing is always associated with the caller workflow. Assignment of {% data variables.product.prodname_dotcom %}-hosted runners is always evaluated using only the caller's context. The caller cannot use {% data variables.product.prodname_dotcom %}-hosted runners from the called repository.
+If you reuse a workflow, billing is always associated with the caller workflow. Assignment of {% data variables.product.prodname_dotcom %}-hosted runners is always evaluated using only the caller's context. The caller cannot use {% data variables.product.prodname_dotcom %}-hosted runners from the called repository.
For more information see, "[Reusing workflows](/actions/learn-github-actions/reusing-workflows)."
{% endif %}
-## Artifact and log retention policy
+## 成果物とログの保持ポリシー
-You can configure the artifact and log retention period for your repository, organization, or enterprise account.
+リポジトリ、Organization、または Enterprise アカウントの成果物とログの保持期間を設定できます。
{% data reusables.actions.about-artifact-log-retention %}
-For more information, see:
+詳しい情報については、以下を参照してください。
- "[Managing {% data variables.product.prodname_actions %} settings for a repository](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-repository)"
- "[Configuring the retention period for {% data variables.product.prodname_actions %} for artifacts and logs in your organization](/organizations/managing-organization-settings/configuring-the-retention-period-for-github-actions-artifacts-and-logs-in-your-organization)"
- "[Enforcing policies for {% data variables.product.prodname_actions %} in your enterprise](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise#enforcing-a-policy-for-artifact-and-log-retention-in-your-enterprise)"
-## Disabling or limiting {% data variables.product.prodname_actions %} for your repository or organization
+## リポジトリあるいはOrganizationでの{% data variables.product.prodname_actions %}の無効化もしくは制限
{% data reusables.github-actions.disabling-github-actions %}
-For more information, see:
+詳しい情報については、以下を参照してください。
- "[Managing {% data variables.product.prodname_actions %} settings for a repository](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository)"
-- "[Disabling or limiting {% data variables.product.prodname_actions %} for your organization](/organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization)"
+- 「[Organization の {% data variables.product.prodname_actions %} を無効化または制限する](/organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization)」
- "[Enforcing policies for {% data variables.product.prodname_actions %} in your enterprise](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-github-actions-policies-for-your-enterprise#enforcing-a-policy-for-artifact-and-log-retention-in-your-enterprise)"
-## Disabling and enabling workflows
+## ワークフローの無効化と有効化
-You can enable and disable individual workflows in your repository on {% data variables.product.prodname_dotcom %}.
+{% data variables.product.prodname_dotcom %} のリポジトリで個々のワークフローを有効化または無効化できます。
{% data reusables.actions.scheduled-workflows-disabled %}
-For more information, see "[Disabling and enabling a workflow](/actions/managing-workflow-runs/disabling-and-enabling-a-workflow)."
+詳しい情報については、「[ワークフローの無効化と有効化](/actions/managing-workflow-runs/disabling-and-enabling-a-workflow)」を参照してください。
diff --git a/translations/ja-JP/content/actions/learn-github-actions/using-starter-workflows.md b/translations/ja-JP/content/actions/learn-github-actions/using-starter-workflows.md
index 9af782bd97..73e4d376ae 100644
--- a/translations/ja-JP/content/actions/learn-github-actions/using-starter-workflows.md
+++ b/translations/ja-JP/content/actions/learn-github-actions/using-starter-workflows.md
@@ -40,15 +40,15 @@ Anyone with write permission to a repository can set up {% data variables.produc
1. If the starter workflow contains comments detailing additional setup steps, follow these steps. Many of the starter workflow have corresponding guides. For more information, see [the {% data variables.product.prodname_actions %} guides](/actions/guides)."
1. Some starter workflows use secrets. For example, {% raw %}`${{ secrets.npm_token }}`{% endraw %}. If the starter workflow uses a secret, store the value described in the secret name as a secret in your repository. For more information, see "[Encrypted secrets](/actions/reference/encrypted-secrets)."
1. Optionally, make additional changes. For example, you might want to change the value of `on` to change when the workflow runs.
-1. Click **Start commit**.
+1. [**Start commit**] をクリックします。
1. Write a commit message and decide whether to commit directly to the default branch or to open a pull request.
-## Further reading
+## 参考リンク
-- "[About continuous integration](/articles/about-continuous-integration)"
+- [継続的インテグレーションについて](/articles/about-continuous-integration)
- "[Managing workflow runs](/actions/managing-workflow-runs)"
- "[About monitoring and troubleshooting](/actions/monitoring-and-troubleshooting-workflows/about-monitoring-and-troubleshooting)"
-- "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)"
+- 「[{% data variables.product.prodname_actions %} を学ぶ](/actions/learn-github-actions)」
{% ifversion fpt or ghec %}
-- "[Managing billing for {% data variables.product.prodname_actions %}](/billing/managing-billing-for-github-actions)"
+- 「[{% data variables.product.prodname_actions %} の支払いを管理する](/billing/managing-billing-for-github-actions)」
{% endif %}
diff --git a/translations/ja-JP/content/actions/learn-github-actions/workflow-commands-for-github-actions.md b/translations/ja-JP/content/actions/learn-github-actions/workflow-commands-for-github-actions.md
index 221421424b..c98e8cf61f 100644
--- a/translations/ja-JP/content/actions/learn-github-actions/workflow-commands-for-github-actions.md
+++ b/translations/ja-JP/content/actions/learn-github-actions/workflow-commands-for-github-actions.md
@@ -1,7 +1,7 @@
---
-title: Workflow commands for GitHub Actions
-shortTitle: Workflow commands
-intro: You can use workflow commands when running shell commands in a workflow or in an action's code.
+title: GitHub Actionsのワークフローコマンド
+shortTitle: ワークフロー コマンド
+intro: ワークフロー内あるいはアクションのコード内でシェルコマンドを実行する際には、ワークフローコマンドを利用できます。
redirect_from:
- /articles/development-tools-for-github-actions
- /github/automating-your-workflow-with-github-actions/development-tools-for-github-actions
@@ -19,11 +19,11 @@ versions:
{% data reusables.actions.enterprise-beta %}
{% data reusables.actions.enterprise-github-hosted-runners %}
-## About workflow commands
+## ワークフローコマンドについて
-Actions can communicate with the runner machine to set environment variables, output values used by other actions, add debug messages to the output logs, and other tasks.
+アクションは、 環境変数を設定する、他のアクションに利用される値を出力する、デバッグメッセージを出力ログに追加するなどのタスクを行うため、ランナーマシンとやりとりできます。
-Most workflow commands use the `echo` command in a specific format, while others are invoked by writing to a file. For more information, see ["Environment files".](#environment-files)
+ほとんどのワークフローコマンドは特定の形式で `echo` コマンドを使用しますが、他のワークフローコマンドはファイルへの書き込みによって呼び出されます。 詳しい情報については、「[環境ファイル](#environment-files)」を参照してください。
``` bash
echo "::workflow-command parameter1={data},parameter2={data}::{command value}"
@@ -31,25 +31,25 @@ echo "::workflow-command parameter1={data},parameter2={data}::{command value}"
{% note %}
-**Note:** Workflow command and parameter names are not case-sensitive.
+**ノート:** ワークフローコマンドおよびパラメータ名では、大文字と小文字は区別されません。
{% endnote %}
{% warning %}
-**Warning:** If you are using Command Prompt, omit double quote characters (`"`) when using workflow commands.
+**警告：** コマンドプロンプトを使っているなら、ワークフローコマンドを使う際にダブルクォート文字（`"`）は省いてください。
{% endwarning %}
-## Using workflow commands to access toolkit functions
+## ワークフローコマンドを使ったツールキット関数へのアクセス
-The [actions/toolkit](https://github.com/actions/toolkit) includes a number of functions that can be executed as workflow commands. Use the `::` syntax to run the workflow commands within your YAML file; these commands are then sent to the runner over `stdout`. For example, instead of using code to set an output, as below:
+[actions/toolkit](https://github.com/actions/toolkit)には、ワークフローコマンドとして実行できる多くの関数があります。 `::`構文を使って、YAMLファイル内でワークフローコマンドを実行してください。それらのコマンドは`stdout`を通じてランナーに送信されます。 たとえば、コードを使用して出力を設定する代わりに、以下のようにします。
```javascript
core.setOutput('SELECTED_COLOR', 'green');
```
-You can use the `set-output` command in your workflow to set the same value:
+ワークフローで `set-output` コマンドを使用して、同じ値を設定できます。
{% raw %}
``` yaml
@@ -61,52 +61,53 @@ You can use the `set-output` command in your workflow to set the same value:
```
{% endraw %}
-The following table shows which toolkit functions are available within a workflow:
+以下の表は、ワークフロー内で使えるツールキット関数を示しています。
-| Toolkit function | Equivalent workflow command |
-| ----------------- | ------------- |
-| `core.addPath` | Accessible using environment file `GITHUB_PATH` |
-| `core.debug` | `debug` |{% ifversion fpt or ghes > 3.2 or ghae-issue-4929 or ghec %}
-| `core.notice` | `notice` |{% endif %}
-| `core.error` | `error` |
-| `core.endGroup` | `endgroup` |
-| `core.exportVariable` | Accessible using environment file `GITHUB_ENV` |
-| `core.getInput` | Accessible using environment variable `INPUT_{NAME}` |
-| `core.getState` | Accessible using environment variable `STATE_{NAME}` |
-| `core.isDebug` | Accessible using environment variable `RUNNER_DEBUG` |
-| `core.saveState` | `save-state` |
-| `core.setCommandEcho` | `echo` |
-| `core.setFailed` | Used as a shortcut for `::error` and `exit 1` |
-| `core.setOutput` | `set-output` |
-| `core.setSecret` | `add-mask` |
-| `core.startGroup` | `group` |
-| `core.warning` | `warning` |
+| ツールキット関数 | 等価なワークフローのコマンド |
+| --------------------- | --------------------------------------------------------------------- |
+| `core.addPath` | Accessible using environment file `GITHUB_PATH` |
+| `core.debug` | `debug` |{% ifversion fpt or ghes > 3.2 or ghae-issue-4929 or ghec %}
+| `core.notice` | `notice`
+{% endif %}
+| `core.error` | `error` |
+| `core.endGroup` | `endgroup` |
+| `core.exportVariable` | Accessible using environment file `GITHUB_ENV` |
+| `core.getInput` | 環境変数の`INPUT_{NAME}`を使ってアクセス可能 |
+| `core.getState` | 環境変数の`STATE_{NAME}`を使ってアクセス可能 |
+| `core.isDebug` | 環境変数の`RUNNER_DEBUG`を使ってアクセス可能 |
+| `core.saveState` | `save-state` |
+| `core.setCommandEcho` | `echo` |
+| `core.setFailed` | `::error`及び`exit 1`のショートカットとして使われる |
+| `core.setOutput` | `set-output` |
+| `core.setSecret` | `add-mask` |
+| `core.startGroup` | `group` |
+| `core.warning` | `warning` |
-## Setting an output parameter
+## 出力パラメータの設定
```
::set-output name={name}::{value}
```
-Sets an action's output parameter.
+アクションの出力パラメータを設定します。
-Optionally, you can also declare output parameters in an action's metadata file. For more information, see "[Metadata syntax for {% data variables.product.prodname_actions %}](/articles/metadata-syntax-for-github-actions#outputs)."
+あるいは、出力パラメータをアクションのメタデータファイル中で宣言することもできます。 詳しい情報については、「[{% data variables.product.prodname_actions %} のメタデータ構文](/articles/metadata-syntax-for-github-actions#outputs)」を参照してください。
-### Example
+### サンプル
``` bash
echo "::set-output name=action_fruit::strawberry"
```
-## Setting a debug message
+## デバッグメッセージの設定
```
::debug::{message}
```
-Prints a debug message to the log. You must create a secret named `ACTIONS_STEP_DEBUG` with the value `true` to see the debug messages set by this command in the log. For more information, see "[Enabling debug logging](/actions/managing-workflow-runs/enabling-debug-logging)."
+デバッグメッセージをログに出力します。 ログでこのコマンドにより設定されたデバッグメッセージを表示するには、`ACTIONS_STEP_DEBUG` という名前のシークレットを作成し、値を `true` に設定する必要があります。 詳しい情報については、「[デバッグログの有効化](/actions/managing-workflow-runs/enabling-debug-logging)」を参照してください。
-### Example
+### サンプル
``` bash
echo "::debug::Set the Octocat variable"
@@ -124,7 +125,7 @@ Creates a notice message and prints the message to the log. {% data reusables.ac
{% data reusables.actions.message-parameters %}
-### Example
+### サンプル
``` bash
echo "::notice file=app.js,line=1,col=5,endColumn=7::Missing semicolon"
@@ -132,48 +133,48 @@ echo "::notice file=app.js,line=1,col=5,endColumn=7::Missing semicolon"
{% endif %}
-## Setting a warning message
+## 警告メッセージの設定
```
::warning file={name},line={line},endLine={endLine},title={title}::{message}
```
-Creates a warning message and prints the message to the log. {% data reusables.actions.message-annotation-explanation %}
+警告メッセージを作成し、ログにそのメッセージを出力します。 {% data reusables.actions.message-annotation-explanation %}
{% data reusables.actions.message-parameters %}
-### Example
+### サンプル
``` bash
echo "::warning file=app.js,line=1,col=5,endColumn=7::Missing semicolon"
```
-## Setting an error message
+## エラーメッセージの設定
```
::error file={name},line={line},endLine={endLine},title={title}::{message}
```
-Creates an error message and prints the message to the log. {% data reusables.actions.message-annotation-explanation %}
+エラーメッセージを作成し、ログにそのメッセージを出力します。 {% data reusables.actions.message-annotation-explanation %}
{% data reusables.actions.message-parameters %}
-### Example
+### サンプル
``` bash
echo "::error file=app.js,line=1,col=5,endColumn=7::Missing semicolon"
```
-## Grouping log lines
+## ログの行のグループ化
```
::group::{title}
::endgroup::
```
-Creates an expandable group in the log. To create a group, use the `group` command and specify a `title`. Anything you print to the log between the `group` and `endgroup` commands is nested inside an expandable entry in the log.
+展開可能なグループをログ中に作成します。 グループを作成するには、`group`コマンドを使って`title`を指定してください。 `group`と`endgroup`コマンド間でログに出力したすべての内容は、ログ中の展開可能なエントリ内にネストされます。
-### Example
+### サンプル
```bash
echo "::group::My title"
@@ -181,38 +182,38 @@ echo "Inside group"
echo "::endgroup::"
```
-
+
-## Masking a value in log
+## ログ中での値のマスク
```
::add-mask::{value}
```
-Masking a value prevents a string or variable from being printed in the log. Each masked word separated by whitespace is replaced with the `*` character. You can use an environment variable or string for the mask's `value`.
+値をマスクすることにより、文字列または値がログに出力されることを防ぎます。 空白で分離された、マスクされた各語は "`*`" という文字で置き換えられます。 マスクの `value` には、環境変数または文字列を持ちいることができます。
-### Example masking a string
+### 文字列をマスクするサンプル
-When you print `"Mona The Octocat"` in the log, you'll see `"***"`.
+ログに `"Mona The Octocat"` を出力すると、`"***"` が表示されます。
```bash
echo "::add-mask::Mona The Octocat"
```
-### Example masking an environment variable
+### 環境変数をマスクするサンプル
-When you print the variable `MY_NAME` or the value `"Mona The Octocat"` in the log, you'll see `"***"` instead of `"Mona The Octocat"`.
+変数 `MY_NAME` または値 `"Mona The Octocat"` をログに出力すると。`"Mona The Octocat"` の代わりに `"***"` が表示されます。
```bash
MY_NAME="Mona The Octocat"
echo "::add-mask::$MY_NAME"
```
-## Stopping and starting workflow commands
+## ワークフローコマンドの停止と開始
`::stop-commands::{endtoken}`
-Stops processing any workflow commands. This special command allows you to log anything without accidentally running a workflow command. For example, you could stop logging to output an entire script that has comments.
+ワークフローコマンドの処理を停止します。 この特殊コマンドを使うと、意図せずワークフローコマンドを実行することなくいかなるログも取れます。 たとえば、コメントがあるスクリプト全体を出力するためにログ取得を停止できます。
To stop the processing of workflow commands, pass a unique token to `stop-commands`. To resume processing workflow commands, pass the same token that you used to stop workflow commands.
@@ -286,33 +287,33 @@ The step above prints the following lines to the log:
Only the second `set-output` and `echo` workflow commands are included in the log because command echoing was only enabled when they were run. Even though it is not always echoed, the output parameter is set in all cases.
-## Sending values to the pre and post actions
+## pre及びpostアクションへの値の送信
-You can use the `save-state` command to create environment variables for sharing with your workflow's `pre:` or `post:` actions. For example, you can create a file with the `pre:` action, pass the file location to the `main:` action, and then use the `post:` action to delete the file. Alternatively, you could create a file with the `main:` action, pass the file location to the `post:` action, and also use the `post:` action to delete the file.
+`save-state`コマンドを使って、ワークフローの`pre:`あるいは`post:`アクションと共有するための環境変数を作成できます。 たとえば、`pre:`アクションでファイルを作成し、そのファイルの場所を`main:`アクションに渡し、`post:`アクションを使ってそのファイルを削除できます。 あるいは、ファイルを`main:`アクションで作成し、そのファイルの場所を`post:`アクションに渡し、`post:`アクションを使ってそのファイルを削除することもできます。
-If you have multiple `pre:` or `post:` actions, you can only access the saved value in the action where `save-state` was used. For more information on the `post:` action, see "[Metadata syntax for {% data variables.product.prodname_actions %}](/actions/creating-actions/metadata-syntax-for-github-actions#post)."
+複数の`pre:`あるいは`post:`アクションがある場合、保存された値にアクセスできるのは`save-state`が使われたアクションの中でのみです。 `post:`アクションに関する詳しい情報については「[{% data variables.product.prodname_actions %}のためのメタデータ構文](/actions/creating-actions/metadata-syntax-for-github-actions#post)」を参照してください。
-The `save-state` command can only be run within an action, and is not available to YAML files. The saved value is stored as an environment value with the `STATE_` prefix.
+`save-state`コマンドはアクション内でしか実行できず、YAMLファイルでは利用できません。 保存された値は、`STATE_`プレフィックス付きで環境変数として保存されます。
-This example uses JavaScript to run the `save-state` command. The resulting environment variable is named `STATE_processID` with the value of `12345`:
+以下の例はJavaScriptを使って`save-state`コマンドを実行します。 結果の環境変数は`STATE_processID`という名前になり、`12345`という値を持ちます。
``` javascript
console.log('::save-state name=processID::12345')
```
-The `STATE_processID` variable is then exclusively available to the cleanup script running under the `main` action. This example runs in `main` and uses JavaScript to display the value assigned to the `STATE_processID` environment variable:
+そして、`STATE_processID`変数は`main`アクションの下で実行されるクリーンアップスクリプトからのみ利用できます。 以下の例は`main`を実行し、JavaScriptを使って環境変数`STATE_processID`に割り当てられた値を表示します。
``` javascript
console.log("The running PID from the main action is: " + process.env.STATE_processID);
```
-## Environment Files
+## 環境ファイル
-During the execution of a workflow, the runner generates temporary files that can be used to perform certain actions. The path to these files are exposed via environment variables. You will need to use UTF-8 encoding when writing to these files to ensure proper processing of the commands. Multiple commands can be written to the same file, separated by newlines.
+ワークフローの実行中に、ランナーは特定のアクションを実行する際に使用できる一時ファイルを生成します。 これらのファイルへのパスは、環境変数を介して公開されます。 コマンドを適切に処理するには、これらのファイルに書き込むときに UTF-8 エンコーディングを使用する必要があります。 複数のコマンドを、改行で区切って同じファイルに書き込むことができます。
{% warning %}
-**Warning:** On Windows, legacy PowerShell (`shell: powershell`) does not use UTF-8 by default. Make sure you write files using the correct encoding. For example, you need to set UTF-8 encoding when you set the path:
+**Warning:** On Windows, legacy PowerShell (`shell: powershell`) does not use UTF-8 by default. 正しいエンコーディングを使用してファイルを書き込むようにしてください。 たとえば、パスを設定するときに UTF-8 エンコーディングを設定する必要があります。
```yaml
jobs:
@@ -323,7 +324,7 @@ jobs:
run: echo "mypath" | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8 -Append
```
-Or switch to PowerShell Core, which defaults to UTF-8:
+Or switch to PowerShell Core, which defaults to UTF-8:
```yaml
jobs:
@@ -337,17 +338,18 @@ jobs:
More detail about UTF-8 and PowerShell Core found on this great [Stack Overflow answer](https://stackoverflow.com/a/40098904/162694):
> ### Optional reading: The cross-platform perspective: PowerShell _Core_:
-> [PowerShell is now cross-platform](https://blogs.msdn.microsoft.com/powershell/2016/08/18/powershell-on-linux-and-open-source-2/), via its **[PowerShell _Core_](https://github.com/PowerShell/PowerShell)** edition, whose encoding - sensibly - **defaults to *BOM-less UTF-8***, in line with Unix-like platforms.
+>
+> [PowerShell is now cross-platform](https://blogs.msdn.microsoft.com/powershell/2016/08/18/powershell-on-linux-and-open-source-2/), via its **[PowerShell _Core_](https://github.com/PowerShell/PowerShell)** edition, whose encoding - sensibly - ***defaults to ***BOM-less UTF-8******, in line with Unix-like platforms.
{% endwarning %}
-## Setting an environment variable
+## 環境変数の設定
``` bash
echo "{name}={value}" >> $GITHUB_ENV
```
-Creates or updates an environment variable for any steps running next in a job. The step that creates or updates the environment variable does not have access to the new value, but all subsequent steps in a job will have access. Environment variables are case-sensitive and you can include punctuation.
+Creates or updates an environment variable for any steps running next in a job. The step that creates or updates the environment variable does not have access to the new value, but all subsequent steps in a job will have access. 環境変数では、大文字と小文字が区別され、句読点を含めることができます。
{% note %}
@@ -355,7 +357,7 @@ Creates or updates an environment variable for any steps running next in a job.
{% endnote %}
-### Example
+### サンプル
{% raw %}
```
@@ -371,9 +373,9 @@ steps:
```
{% endraw %}
-### Multiline strings
+### 複数行の文字列
-For multiline strings, you may use a delimiter with the following syntax.
+複数行の文字列の場合、次の構文で区切り文字を使用できます。
```
{name}<<{delimiter}
@@ -381,9 +383,9 @@ For multiline strings, you may use a delimiter with the following syntax.
{delimiter}
```
-#### Example
+#### サンプル
-In this example, we use `EOF` as a delimiter and set the `JSON_RESPONSE` environment variable to the value of the curl response.
+この例では、区切り文字として `EOF` を使用し、`JSON_RESPONSE` 環境変数を cURL レスポンスの値に設定します。
```yaml
steps:
- name: Set the value
@@ -394,17 +396,17 @@ steps:
echo 'EOF' >> $GITHUB_ENV
```
-## Adding a system path
+## システムパスの追加
``` bash
echo "{path}" >> $GITHUB_PATH
```
-Prepends a directory to the system `PATH` variable and automatically makes it available to all subsequent actions in the current job; the currently running action cannot access the updated path variable. To see the currently defined paths for your job, you can use `echo "$PATH"` in a step or an action.
+Prepends a directory to the system `PATH` variable and automatically makes it available to all subsequent actions in the current job; the currently running action cannot access the updated path variable. ジョブに現在定義されているパスを見るには、ステップもしくはアクション中で`echo "$PATH"`を使うことができます。
-### Example
+### サンプル
-This example demonstrates how to add the user `$HOME/.local/bin` directory to `PATH`:
+この例は、ユーザの`$HOME/.local/bin`ディレクトリを`PATH`に追加する方法を示しています。
``` bash
echo "$HOME/.local/bin" >> $GITHUB_PATH
diff --git a/translations/ja-JP/content/actions/learn-github-actions/workflow-syntax-for-github-actions.md b/translations/ja-JP/content/actions/learn-github-actions/workflow-syntax-for-github-actions.md
index f3586ab251..9061c62375 100644
--- a/translations/ja-JP/content/actions/learn-github-actions/workflow-syntax-for-github-actions.md
+++ b/translations/ja-JP/content/actions/learn-github-actions/workflow-syntax-for-github-actions.md
@@ -1,7 +1,7 @@
---
-title: Workflow syntax for GitHub Actions
-shortTitle: Workflow syntax
-intro: A workflow is a configurable automated process made up of one or more jobs. You must create a YAML file to define your workflow configuration.
+title: GitHub Actionsのワークフロー構文
+shortTitle: ワークフロー構文
+intro: ワークフローは、1つ以上のジョブからなる設定可能な自動化プロセスです。 ワークフローの設定を定義するには、YAMLファイルを作成しなければなりません。
redirect_from:
- /articles/workflow-syntax-for-github-actions
- /github/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions
@@ -17,27 +17,27 @@ versions:
{% data reusables.actions.enterprise-beta %}
{% data reusables.actions.enterprise-github-hosted-runners %}
-## About YAML syntax for workflows
+## ワークフロー用のYAML構文について
-Workflow files use YAML syntax, and must have either a `.yml` or `.yaml` file extension. {% data reusables.actions.learn-more-about-yaml %}
+ワークフローファイルはYAML構文を使用し、ファイル拡張子が`.yml`または`.yaml`である必要があります。 {% data reusables.actions.learn-more-about-yaml %}
-You must store workflow files in the `.github/workflows` directory of your repository.
+ワークフローファイルは、リポジトリの`.github/workflows`ディレクトリに保存する必要があります。
## `name`
-The name of your workflow. {% data variables.product.prodname_dotcom %} displays the names of your workflows on your repository's actions page. If you omit `name`, {% data variables.product.prodname_dotcom %} sets it to the workflow file path relative to the root of the repository.
+ワークフローの名前。 {% data variables.product.prodname_dotcom %}では、リポジトリのアクションページにワークフローの名前が表示されます。 `name`を省略すると、{% data variables.product.prodname_dotcom %}はリポジトリのルートに対するワークフローファイルの相対パスをその値に設定します。
## `on`
-**Required**. The name of the {% data variables.product.prodname_dotcom %} event that triggers the workflow. You can provide a single event `string`, `array` of events, `array` of event `types`, or an event configuration `map` that schedules a workflow or restricts the execution of a workflow to specific files, tags, or branch changes. For a list of available events, see "[Events that trigger workflows](/articles/events-that-trigger-workflows)."
+**必須**。 ワークフローをトリガーする{% data variables.product.prodname_dotcom %}イベントの名前。 指定できるのは、1つのイベント`string`、複数イベントの`array`、イベント`types`の`array`です。あるいは、ワークフローをスケジュールする、またはワークフロー実行を特定のファイルやタグ、ブランチ変更に限定するイベント設定`map`も指定できます。 使用可能なイベントの一覧は、「[ワークフローをトリガーするイベント](/articles/events-that-trigger-workflows)」を参照してください。
{% data reusables.github-actions.actions-on-examples %}
## `on.